1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { ApprovalDecisionEnum, ApprovalStatusEnum } from './approval.enum';
7import { ApprovalCommentModel, ApprovalRequestModel } from './approval.schema';
8
9export const DelegateApprovalContract = defineCommand({
10	meta: {
11		key: 'workflow.approval.delegate',
12		version: '1.0.0',
13		stability: 'stable',
14		owners: ['@example.workflow-system'],
15		tags: ['workflow', 'approval', 'delegate'],
16		description: 'Delegate an approval request to another user.',
17		goal: 'Allow approvers to pass approval to others.',
18		context: 'Approval inbox.',
19	},
20	io: {
21		input: defineSchemaModel({
22			name: 'DelegateInput',
23			fields: {
24				requestId: {
25					type: ScalarTypeEnum.String_unsecure(),
26					isOptional: false,
27				},
28				delegateTo: {
29					type: ScalarTypeEnum.String_unsecure(),
30					isOptional: false,
31				},
32				reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
33			},
34		}),
35		output: ApprovalRequestModel,
36	},
37	policy: { auth: 'user' },
38	sideEffects: {
39		emits: [
40			{
41				key: 'workflow.approval.delegated',
42				version: '1.0.0',
43				when: 'Approval is delegated',
44				payload: ApprovalRequestModel,
45			},
46		],
47		audit: ['workflow.approval.delegated'],
48	},
49	acceptance: {
50		scenarios: [
51			{
52				key: 'delegate-approval-happy-path',
53				given: ['Approval request is pending', 'User is assignee'],
54				when: ['User delegates to another user'],
55				then: ['Assignee is updated', 'ApprovalDelegated event is emitted'],
56			},
57		],
58		examples: [
59			{
60				key: 'delegate-to-manager',
61				input: {
62					requestId: 'req-123',
63					delegateTo: 'user-456',
64					reason: 'Out of office',
65				},
66				output: { id: 'req-123', assigneeId: 'user-456' },
67			},
68		],
69	},
70});