1import {
2	defineCommand,
3	defineQuery,
4} from '@lssm-tech/lib.contracts-spec/operations';
5import { defineSchemaModel, ScalarTypeEnum } from '@lssm-tech/lib.schema';
6import { InstanceStatusEnum } from './instance.enum';
7import {
8	StartWorkflowInputModel,
9	TransitionInputModel,
10	TransitionResultModel,
11	WorkflowInstanceModel,
12} from './instance.schema';
13
14export const ListInstancesContract = defineQuery({
15	meta: {
16		key: 'workflow.instance.list',
17		version: '1.0.0',
18		stability: 'stable',
19		owners: ['@example.workflow-system'],
20		tags: ['workflow', 'instance', 'list'],
21		description: 'List workflow instances with filtering.',
22		goal: 'Browse and search running workflows.',
23		context: 'Dashboard, monitoring.',
24	},
25	io: {
26		input: defineSchemaModel({
27			name: 'ListInstancesInput',
28			fields: {
29				workflowKey: {
30					type: ScalarTypeEnum.String_unsecure(),
31					isOptional: true,
32				},
33				status: { type: InstanceStatusEnum, isOptional: true },
34				referenceType: {
35					type: ScalarTypeEnum.String_unsecure(),
36					isOptional: true,
37				},
38				referenceId: {
39					type: ScalarTypeEnum.String_unsecure(),
40					isOptional: true,
41				},
42				triggeredBy: {
43					type: ScalarTypeEnum.String_unsecure(),
44					isOptional: true,
45				},
46				limit: {
47					type: ScalarTypeEnum.Int_unsecure(),
48					isOptional: true,
49					defaultValue: 20,
50				},
51				offset: {
52					type: ScalarTypeEnum.Int_unsecure(),
53					isOptional: true,
54					defaultValue: 0,
55				},
56			},
57		}),
58		output: defineSchemaModel({
59			name: 'ListInstancesOutput',
60			fields: {
61				instances: {
62					type: WorkflowInstanceModel,
63					isArray: true,
64					isOptional: false,
65				},
66				total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
67			},
68		}),
69	},
70	policy: { auth: 'user' },
71	acceptance: {
72		scenarios: [
73			{
74				key: 'list-instances-happy-path',
75				given: ['Workflow instances exist'],
76				when: ['User lists instances'],
77				then: ['List of instances is returned'],
78			},
79		],
80		examples: [
81			{
82				key: 'list-running',
83				input: { status: 'running', limit: 10 },
84				output: { instances: [], total: 5 },
85			},
86		],
87	},
88});