@contractspec/example.workflow-system 0.0.0-canary-20260113170453

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +124 -0
  3. package/dist/approval/approval.enum.d.ts +14 -0
  4. package/dist/approval/approval.enum.d.ts.map +1 -0
  5. package/dist/approval/approval.enum.js +29 -0
  6. package/dist/approval/approval.enum.js.map +1 -0
  7. package/dist/approval/approval.event.d.ts +131 -0
  8. package/dist/approval/approval.event.d.ts.map +1 -0
  9. package/dist/approval/approval.event.js +220 -0
  10. package/dist/approval/approval.event.js.map +1 -0
  11. package/dist/approval/approval.handler.d.ts +23 -0
  12. package/dist/approval/approval.handler.d.ts.map +1 -0
  13. package/dist/approval/approval.handler.js +72 -0
  14. package/dist/approval/approval.handler.js.map +1 -0
  15. package/dist/approval/approval.operations.d.ts +535 -0
  16. package/dist/approval/approval.operations.d.ts.map +1 -0
  17. package/dist/approval/approval.operations.js +345 -0
  18. package/dist/approval/approval.operations.js.map +1 -0
  19. package/dist/approval/approval.schema.d.ts +100 -0
  20. package/dist/approval/approval.schema.d.ts.map +1 -0
  21. package/dist/approval/approval.schema.js +110 -0
  22. package/dist/approval/approval.schema.js.map +1 -0
  23. package/dist/approval/index.d.ts +5 -0
  24. package/dist/approval/index.js +6 -0
  25. package/dist/docs/index.d.ts +1 -0
  26. package/dist/docs/index.js +1 -0
  27. package/dist/docs/workflow-system.docblock.d.ts +1 -0
  28. package/dist/docs/workflow-system.docblock.js +115 -0
  29. package/dist/docs/workflow-system.docblock.js.map +1 -0
  30. package/dist/entities/approval.d.ts +58 -0
  31. package/dist/entities/approval.d.ts.map +1 -0
  32. package/dist/entities/approval.js +128 -0
  33. package/dist/entities/approval.js.map +1 -0
  34. package/dist/entities/index.d.ts +139 -0
  35. package/dist/entities/index.d.ts.map +1 -0
  36. package/dist/entities/index.js +32 -0
  37. package/dist/entities/index.js.map +1 -0
  38. package/dist/entities/instance.d.ts +69 -0
  39. package/dist/entities/instance.d.ts.map +1 -0
  40. package/dist/entities/instance.js +168 -0
  41. package/dist/entities/instance.js.map +1 -0
  42. package/dist/entities/step.d.ts +50 -0
  43. package/dist/entities/step.d.ts.map +1 -0
  44. package/dist/entities/step.js +135 -0
  45. package/dist/entities/step.js.map +1 -0
  46. package/dist/entities/workflow.d.ts +41 -0
  47. package/dist/entities/workflow.d.ts.map +1 -0
  48. package/dist/entities/workflow.js +102 -0
  49. package/dist/entities/workflow.js.map +1 -0
  50. package/dist/example.d.ts +7 -0
  51. package/dist/example.d.ts.map +1 -0
  52. package/dist/example.js +58 -0
  53. package/dist/example.js.map +1 -0
  54. package/dist/handlers/index.d.ts +2 -0
  55. package/dist/handlers/index.js +3 -0
  56. package/dist/handlers/workflow.handlers.d.ts +122 -0
  57. package/dist/handlers/workflow.handlers.d.ts.map +1 -0
  58. package/dist/handlers/workflow.handlers.js +263 -0
  59. package/dist/handlers/workflow.handlers.js.map +1 -0
  60. package/dist/index.d.ts +26 -0
  61. package/dist/index.js +26 -0
  62. package/dist/instance/index.d.ts +5 -0
  63. package/dist/instance/index.js +6 -0
  64. package/dist/instance/instance.enum.d.ts +10 -0
  65. package/dist/instance/instance.enum.d.ts.map +1 -0
  66. package/dist/instance/instance.enum.js +20 -0
  67. package/dist/instance/instance.enum.js.map +1 -0
  68. package/dist/instance/instance.event.d.ts +356 -0
  69. package/dist/instance/instance.event.d.ts.map +1 -0
  70. package/dist/instance/instance.event.js +293 -0
  71. package/dist/instance/instance.event.js.map +1 -0
  72. package/dist/instance/instance.handler.d.ts +27 -0
  73. package/dist/instance/instance.handler.d.ts.map +1 -0
  74. package/dist/instance/instance.handler.js +94 -0
  75. package/dist/instance/instance.handler.js.map +1 -0
  76. package/dist/instance/instance.operations.d.ts +1024 -0
  77. package/dist/instance/instance.operations.d.ts.map +1 -0
  78. package/dist/instance/instance.operations.js +464 -0
  79. package/dist/instance/instance.operations.js.map +1 -0
  80. package/dist/instance/instance.schema.d.ts +223 -0
  81. package/dist/instance/instance.schema.d.ts.map +1 -0
  82. package/dist/instance/instance.schema.js +172 -0
  83. package/dist/instance/instance.schema.js.map +1 -0
  84. package/dist/presentations/index.d.ts +63 -0
  85. package/dist/presentations/index.d.ts.map +1 -0
  86. package/dist/presentations/index.js +340 -0
  87. package/dist/presentations/index.js.map +1 -0
  88. package/dist/seeders/index.d.ts +10 -0
  89. package/dist/seeders/index.d.ts.map +1 -0
  90. package/dist/seeders/index.js +19 -0
  91. package/dist/seeders/index.js.map +1 -0
  92. package/dist/shared/index.d.ts +3 -0
  93. package/dist/shared/index.js +3 -0
  94. package/dist/shared/mock-data.d.ts +19 -0
  95. package/dist/shared/mock-data.d.ts.map +1 -0
  96. package/dist/shared/mock-data.js +12 -0
  97. package/dist/shared/mock-data.js.map +1 -0
  98. package/dist/shared/types.d.ts +81 -0
  99. package/dist/shared/types.d.ts.map +1 -0
  100. package/dist/shared/types.js +0 -0
  101. package/dist/state-machine/index.d.ts +148 -0
  102. package/dist/state-machine/index.d.ts.map +1 -0
  103. package/dist/state-machine/index.js +158 -0
  104. package/dist/state-machine/index.js.map +1 -0
  105. package/dist/tests/operations.test-spec.d.ts +10 -0
  106. package/dist/tests/operations.test-spec.d.ts.map +1 -0
  107. package/dist/tests/operations.test-spec.js +123 -0
  108. package/dist/tests/operations.test-spec.js.map +1 -0
  109. package/dist/ui/WorkflowDashboard.d.ts +7 -0
  110. package/dist/ui/WorkflowDashboard.d.ts.map +1 -0
  111. package/dist/ui/WorkflowDashboard.js +223 -0
  112. package/dist/ui/WorkflowDashboard.js.map +1 -0
  113. package/dist/ui/hooks/index.d.ts +2 -0
  114. package/dist/ui/hooks/index.js +5 -0
  115. package/dist/ui/hooks/useWorkflowList.d.ts +22 -0
  116. package/dist/ui/hooks/useWorkflowList.d.ts.map +1 -0
  117. package/dist/ui/hooks/useWorkflowList.js +55 -0
  118. package/dist/ui/hooks/useWorkflowList.js.map +1 -0
  119. package/dist/ui/index.d.ts +6 -0
  120. package/dist/ui/index.js +6 -0
  121. package/dist/ui/renderers/index.d.ts +2 -0
  122. package/dist/ui/renderers/index.js +3 -0
  123. package/dist/ui/renderers/workflow.markdown.d.ts +28 -0
  124. package/dist/ui/renderers/workflow.markdown.d.ts.map +1 -0
  125. package/dist/ui/renderers/workflow.markdown.js +234 -0
  126. package/dist/ui/renderers/workflow.markdown.js.map +1 -0
  127. package/dist/workflow/index.d.ts +5 -0
  128. package/dist/workflow/index.js +6 -0
  129. package/dist/workflow/workflow.enum.d.ts +22 -0
  130. package/dist/workflow/workflow.enum.d.ts.map +1 -0
  131. package/dist/workflow/workflow.enum.js +47 -0
  132. package/dist/workflow/workflow.enum.js.map +1 -0
  133. package/dist/workflow/workflow.event.d.ts +135 -0
  134. package/dist/workflow/workflow.event.d.ts.map +1 -0
  135. package/dist/workflow/workflow.event.js +150 -0
  136. package/dist/workflow/workflow.event.js.map +1 -0
  137. package/dist/workflow/workflow.handler.d.ts +29 -0
  138. package/dist/workflow/workflow.handler.d.ts.map +1 -0
  139. package/dist/workflow/workflow.handler.js +66 -0
  140. package/dist/workflow/workflow.handler.js.map +1 -0
  141. package/dist/workflow/workflow.operations.d.ts +1011 -0
  142. package/dist/workflow/workflow.operations.d.ts.map +1 -0
  143. package/dist/workflow/workflow.operations.js +345 -0
  144. package/dist/workflow/workflow.operations.js.map +1 -0
  145. package/dist/workflow/workflow.schema.d.ts +265 -0
  146. package/dist/workflow/workflow.schema.d.ts.map +1 -0
  147. package/dist/workflow/workflow.schema.js +249 -0
  148. package/dist/workflow/workflow.schema.js.map +1 -0
  149. package/dist/workflow-system.capability.d.ts +9 -0
  150. package/dist/workflow-system.capability.d.ts.map +1 -0
  151. package/dist/workflow-system.capability.js +34 -0
  152. package/dist/workflow-system.capability.js.map +1 -0
  153. package/dist/workflow-system.feature.d.ts +12 -0
  154. package/dist/workflow-system.feature.d.ts.map +1 -0
  155. package/dist/workflow-system.feature.js +346 -0
  156. package/dist/workflow-system.feature.js.map +1 -0
  157. package/package.json +133 -0
@@ -0,0 +1,94 @@
1
+ import { mockDataStore } from "../shared/mock-data.js";
2
+ import { buildStateMachineDefinition, createStateMachineEngine } from "../state-machine/index.js";
3
+ import { createApprovalRequests } from "../approval/approval.handler.js";
4
+
5
+ //#region src/instance/instance.handler.ts
6
+ async function handleStartWorkflow(input, context) {
7
+ const workflow = Array.from(mockDataStore.workflows.values()).find((w) => w.key === input.workflowKey && w.status === "ACTIVE" && w.organizationId === context.organizationId);
8
+ if (!workflow) throw new Error(`Active workflow ${input.workflowKey} not found`);
9
+ const id = `inst_${Date.now()}`;
10
+ const now = /* @__PURE__ */ new Date();
11
+ const instance = {
12
+ id,
13
+ workflowDefinitionId: workflow.id,
14
+ referenceId: input.referenceId,
15
+ referenceType: input.referenceType,
16
+ status: "RUNNING",
17
+ currentStepId: workflow.initialStepId,
18
+ contextData: input.contextData ?? {},
19
+ triggeredBy: context.userId,
20
+ organizationId: context.organizationId,
21
+ priority: input.priority ?? 0,
22
+ dueAt: input.dueAt,
23
+ createdAt: now,
24
+ updatedAt: now,
25
+ startedAt: now
26
+ };
27
+ mockDataStore.instances.set(id, instance);
28
+ if (workflow.initialStepId) {
29
+ const firstStep = mockDataStore.steps.get(workflow.initialStepId);
30
+ if (firstStep?.type === "APPROVAL") {
31
+ instance.status = "WAITING";
32
+ await createApprovalRequests(instance, firstStep, context);
33
+ }
34
+ }
35
+ return instance;
36
+ }
37
+ async function handleTransitionWorkflow(input, context) {
38
+ const instance = mockDataStore.instances.get(input.instanceId);
39
+ if (!instance) throw new Error(`Instance ${input.instanceId} not found`);
40
+ const workflow = mockDataStore.workflows.get(instance.workflowDefinitionId);
41
+ if (!workflow) throw new Error(`Workflow ${instance.workflowDefinitionId} not found`);
42
+ const steps = Array.from(mockDataStore.steps.values()).filter((s) => s.workflowDefinitionId === workflow.id);
43
+ const definition = buildStateMachineDefinition({
44
+ key: workflow.key,
45
+ name: workflow.name,
46
+ version: workflow.version,
47
+ initialStepId: workflow.initialStepId ?? null
48
+ }, steps);
49
+ const currentStep = steps.find((s) => s.id === instance.currentStepId);
50
+ const state = {
51
+ currentStepKey: currentStep?.key ?? "",
52
+ status: instance.status,
53
+ contextData: instance.contextData,
54
+ history: []
55
+ };
56
+ const transitionContext = {
57
+ userId: context.userId,
58
+ userRoles: context.userRoles,
59
+ data: input.data
60
+ };
61
+ const result = createStateMachineEngine().transition(definition, state, input.action, transitionContext);
62
+ if (!result.success) return {
63
+ success: false,
64
+ instance,
65
+ message: result.error
66
+ };
67
+ const previousStepKey = currentStep?.key;
68
+ const newStep = steps.find((s) => s.key === result.currentStepKey);
69
+ instance.currentStepId = newStep?.id;
70
+ instance.status = result.status;
71
+ instance.contextData = {
72
+ ...instance.contextData,
73
+ ...input.data
74
+ };
75
+ instance.updatedAt = /* @__PURE__ */ new Date();
76
+ if (result.status === "COMPLETED") {
77
+ instance.completedAt = /* @__PURE__ */ new Date();
78
+ instance.outcome = input.action;
79
+ }
80
+ if (newStep?.type === "APPROVAL") {
81
+ instance.status = "WAITING";
82
+ await createApprovalRequests(instance, newStep, context);
83
+ }
84
+ return {
85
+ success: true,
86
+ instance,
87
+ previousStepKey,
88
+ currentStepKey: result.currentStepKey ?? void 0
89
+ };
90
+ }
91
+
92
+ //#endregion
93
+ export { handleStartWorkflow, handleTransitionWorkflow };
94
+ //# sourceMappingURL=instance.handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instance.handler.js","names":[],"sources":["../../src/instance/instance.handler.ts"],"sourcesContent":["/**\n * Workflow instance handlers.\n */\n\nimport type { StateMachineState, TransitionContext } from '../state-machine';\nimport {\n createStateMachineEngine,\n buildStateMachineDefinition,\n} from '../state-machine';\nimport type { WorkflowInstanceRecord, HandlerContext } from '../shared/types';\nimport { mockDataStore } from '../shared/mock-data';\nimport { createApprovalRequests } from '../approval/approval.handler';\n\nexport async function handleStartWorkflow(\n input: {\n workflowKey: string;\n contextData?: Record<string, unknown>;\n referenceId?: string;\n referenceType?: string;\n priority?: number;\n dueAt?: Date;\n },\n context: HandlerContext\n): Promise<WorkflowInstanceRecord> {\n // Find active workflow by key\n const workflow = Array.from(mockDataStore.workflows.values()).find(\n (w) =>\n w.key === input.workflowKey &&\n w.status === 'ACTIVE' &&\n w.organizationId === context.organizationId\n );\n\n if (!workflow) {\n throw new Error(`Active workflow ${input.workflowKey} not found`);\n }\n\n const id = `inst_${Date.now()}`;\n const now = new Date();\n\n const instance: WorkflowInstanceRecord = {\n id,\n workflowDefinitionId: workflow.id,\n referenceId: input.referenceId,\n referenceType: input.referenceType,\n status: 'RUNNING',\n currentStepId: workflow.initialStepId,\n contextData: input.contextData ?? {},\n triggeredBy: context.userId,\n organizationId: context.organizationId,\n priority: input.priority ?? 0,\n dueAt: input.dueAt,\n createdAt: now,\n updatedAt: now,\n startedAt: now,\n };\n\n mockDataStore.instances.set(id, instance);\n\n // Check if first step is an approval step\n if (workflow.initialStepId) {\n const firstStep = mockDataStore.steps.get(workflow.initialStepId);\n if (firstStep?.type === 'APPROVAL') {\n instance.status = 'WAITING';\n await createApprovalRequests(instance, firstStep, context);\n }\n }\n\n return instance;\n}\n\nexport async function handleTransitionWorkflow(\n input: {\n instanceId: string;\n action: string;\n data?: Record<string, unknown>;\n comment?: string;\n },\n context: HandlerContext\n): Promise<{\n success: boolean;\n instance: WorkflowInstanceRecord;\n previousStepKey?: string;\n currentStepKey?: string;\n message?: string;\n}> {\n const instance = mockDataStore.instances.get(input.instanceId);\n if (!instance) {\n throw new Error(`Instance ${input.instanceId} not found`);\n }\n\n const workflow = mockDataStore.workflows.get(instance.workflowDefinitionId);\n if (!workflow) {\n throw new Error(`Workflow ${instance.workflowDefinitionId} not found`);\n }\n\n // Get all steps for this workflow\n const steps = Array.from(mockDataStore.steps.values()).filter(\n (s) => s.workflowDefinitionId === workflow.id\n );\n\n // Build state machine\n const definition = buildStateMachineDefinition(\n {\n key: workflow.key,\n name: workflow.name,\n version: workflow.version,\n initialStepId: workflow.initialStepId ?? null,\n },\n steps\n );\n const currentStep = steps.find((s) => s.id === instance.currentStepId);\n\n const state: StateMachineState = {\n currentStepKey: currentStep?.key ?? '',\n status: instance.status,\n contextData: instance.contextData,\n history: [],\n };\n\n const transitionContext: TransitionContext = {\n userId: context.userId,\n userRoles: context.userRoles,\n data: input.data,\n };\n\n const engine = createStateMachineEngine();\n const result = engine.transition(\n definition,\n state,\n input.action,\n transitionContext\n );\n\n if (!result.success) {\n return {\n success: false,\n instance,\n message: result.error,\n };\n }\n\n // Update instance\n const previousStepKey = currentStep?.key;\n const newStep = steps.find((s) => s.key === result.currentStepKey);\n\n instance.currentStepId = newStep?.id;\n instance.status = result.status;\n instance.contextData = { ...instance.contextData, ...input.data };\n instance.updatedAt = new Date();\n\n if (result.status === 'COMPLETED') {\n instance.completedAt = new Date();\n instance.outcome = input.action;\n }\n\n // Handle approval steps\n if (newStep?.type === 'APPROVAL') {\n instance.status = 'WAITING';\n await createApprovalRequests(instance, newStep, context);\n }\n\n return {\n success: true,\n instance,\n previousStepKey,\n currentStepKey: result.currentStepKey ?? undefined,\n };\n}\n"],"mappings":";;;;;AAaA,eAAsB,oBACpB,OAQA,SACiC;CAEjC,MAAM,WAAW,MAAM,KAAK,cAAc,UAAU,QAAQ,CAAC,CAAC,MAC3D,MACC,EAAE,QAAQ,MAAM,eAChB,EAAE,WAAW,YACb,EAAE,mBAAmB,QAAQ,eAChC;AAED,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,mBAAmB,MAAM,YAAY,YAAY;CAGnE,MAAM,KAAK,QAAQ,KAAK,KAAK;CAC7B,MAAM,sBAAM,IAAI,MAAM;CAEtB,MAAM,WAAmC;EACvC;EACA,sBAAsB,SAAS;EAC/B,aAAa,MAAM;EACnB,eAAe,MAAM;EACrB,QAAQ;EACR,eAAe,SAAS;EACxB,aAAa,MAAM,eAAe,EAAE;EACpC,aAAa,QAAQ;EACrB,gBAAgB,QAAQ;EACxB,UAAU,MAAM,YAAY;EAC5B,OAAO,MAAM;EACb,WAAW;EACX,WAAW;EACX,WAAW;EACZ;AAED,eAAc,UAAU,IAAI,IAAI,SAAS;AAGzC,KAAI,SAAS,eAAe;EAC1B,MAAM,YAAY,cAAc,MAAM,IAAI,SAAS,cAAc;AACjE,MAAI,WAAW,SAAS,YAAY;AAClC,YAAS,SAAS;AAClB,SAAM,uBAAuB,UAAU,WAAW,QAAQ;;;AAI9D,QAAO;;AAGT,eAAsB,yBACpB,OAMA,SAOC;CACD,MAAM,WAAW,cAAc,UAAU,IAAI,MAAM,WAAW;AAC9D,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,YAAY,MAAM,WAAW,YAAY;CAG3D,MAAM,WAAW,cAAc,UAAU,IAAI,SAAS,qBAAqB;AAC3E,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,YAAY,SAAS,qBAAqB,YAAY;CAIxE,MAAM,QAAQ,MAAM,KAAK,cAAc,MAAM,QAAQ,CAAC,CAAC,QACpD,MAAM,EAAE,yBAAyB,SAAS,GAC5C;CAGD,MAAM,aAAa,4BACjB;EACE,KAAK,SAAS;EACd,MAAM,SAAS;EACf,SAAS,SAAS;EAClB,eAAe,SAAS,iBAAiB;EAC1C,EACD,MACD;CACD,MAAM,cAAc,MAAM,MAAM,MAAM,EAAE,OAAO,SAAS,cAAc;CAEtE,MAAM,QAA2B;EAC/B,gBAAgB,aAAa,OAAO;EACpC,QAAQ,SAAS;EACjB,aAAa,SAAS;EACtB,SAAS,EAAE;EACZ;CAED,MAAM,oBAAuC;EAC3C,QAAQ,QAAQ;EAChB,WAAW,QAAQ;EACnB,MAAM,MAAM;EACb;CAGD,MAAM,SADS,0BAA0B,CACnB,WACpB,YACA,OACA,MAAM,QACN,kBACD;AAED,KAAI,CAAC,OAAO,QACV,QAAO;EACL,SAAS;EACT;EACA,SAAS,OAAO;EACjB;CAIH,MAAM,kBAAkB,aAAa;CACrC,MAAM,UAAU,MAAM,MAAM,MAAM,EAAE,QAAQ,OAAO,eAAe;AAElE,UAAS,gBAAgB,SAAS;AAClC,UAAS,SAAS,OAAO;AACzB,UAAS,cAAc;EAAE,GAAG,SAAS;EAAa,GAAG,MAAM;EAAM;AACjE,UAAS,4BAAY,IAAI,MAAM;AAE/B,KAAI,OAAO,WAAW,aAAa;AACjC,WAAS,8BAAc,IAAI,MAAM;AACjC,WAAS,UAAU,MAAM;;AAI3B,KAAI,SAAS,SAAS,YAAY;AAChC,WAAS,SAAS;AAClB,QAAM,uBAAuB,UAAU,SAAS,QAAQ;;AAG1D,QAAO;EACL,SAAS;EACT;EACA;EACA,gBAAgB,OAAO,kBAAkB;EAC1C"}