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 SubmitDecisionContract = defineCommand({
10	meta: {
11		key: 'workflow.approval.decide',
12		version: '1.0.0',
13		stability: 'stable',
14		owners: ['@example.workflow-system'],
15		tags: ['workflow', 'approval', 'decision'],
16		description: 'Submit an approval decision (approve/reject).',
17		goal: 'Allow approvers to make decisions on requests.',
18		context: 'Approval inbox, workflow detail.',
19	},
20	io: {
21		input: defineSchemaModel({
22			name: 'ApproveRejectInput',
23			fields: {
24				requestId: {
25					type: ScalarTypeEnum.String_unsecure(),
26					isOptional: false,
27				},
28				decision: { type: ApprovalDecisionEnum, isOptional: false },
29				comment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
30				data: { type: ScalarTypeEnum.JSON(), isOptional: true },
31			},
32		}),
33		output: ApprovalRequestModel,
34	},
35	policy: { auth: 'user' },
36	sideEffects: {
37		emits: [
38			{
39				key: 'workflow.approval.decided',
40				version: '1.0.0',
41				when: 'Decision is made',
42				payload: ApprovalRequestModel,
43			},
44		],
45		audit: ['workflow.approval.decided'],
46	},
47	acceptance: {
48		scenarios: [
49			{
50				key: 'approve-request-happy-path',
51				given: ['Approval request is pending', 'User is assignee'],
52				when: ['User approves request'],
53				then: ['Request is approved', 'ApprovalDecided event is emitted'],
54			},
55		],
56		examples: [
57			{
58				key: 'approve-basic',
59				input: {
60					requestId: 'req-123',
61					decision: 'approve',
62					comment: 'Looks good',
63				},
64				output: { id: 'req-123', status: 'approved' },
65			},
66		],
67	},
68});