@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.
- package/LICENSE +21 -0
- package/README.md +124 -0
- package/dist/approval/approval.enum.d.ts +14 -0
- package/dist/approval/approval.enum.d.ts.map +1 -0
- package/dist/approval/approval.enum.js +29 -0
- package/dist/approval/approval.enum.js.map +1 -0
- package/dist/approval/approval.event.d.ts +131 -0
- package/dist/approval/approval.event.d.ts.map +1 -0
- package/dist/approval/approval.event.js +220 -0
- package/dist/approval/approval.event.js.map +1 -0
- package/dist/approval/approval.handler.d.ts +23 -0
- package/dist/approval/approval.handler.d.ts.map +1 -0
- package/dist/approval/approval.handler.js +72 -0
- package/dist/approval/approval.handler.js.map +1 -0
- package/dist/approval/approval.operations.d.ts +535 -0
- package/dist/approval/approval.operations.d.ts.map +1 -0
- package/dist/approval/approval.operations.js +345 -0
- package/dist/approval/approval.operations.js.map +1 -0
- package/dist/approval/approval.schema.d.ts +100 -0
- package/dist/approval/approval.schema.d.ts.map +1 -0
- package/dist/approval/approval.schema.js +110 -0
- package/dist/approval/approval.schema.js.map +1 -0
- package/dist/approval/index.d.ts +5 -0
- package/dist/approval/index.js +6 -0
- package/dist/docs/index.d.ts +1 -0
- package/dist/docs/index.js +1 -0
- package/dist/docs/workflow-system.docblock.d.ts +1 -0
- package/dist/docs/workflow-system.docblock.js +115 -0
- package/dist/docs/workflow-system.docblock.js.map +1 -0
- package/dist/entities/approval.d.ts +58 -0
- package/dist/entities/approval.d.ts.map +1 -0
- package/dist/entities/approval.js +128 -0
- package/dist/entities/approval.js.map +1 -0
- package/dist/entities/index.d.ts +139 -0
- package/dist/entities/index.d.ts.map +1 -0
- package/dist/entities/index.js +32 -0
- package/dist/entities/index.js.map +1 -0
- package/dist/entities/instance.d.ts +69 -0
- package/dist/entities/instance.d.ts.map +1 -0
- package/dist/entities/instance.js +168 -0
- package/dist/entities/instance.js.map +1 -0
- package/dist/entities/step.d.ts +50 -0
- package/dist/entities/step.d.ts.map +1 -0
- package/dist/entities/step.js +135 -0
- package/dist/entities/step.js.map +1 -0
- package/dist/entities/workflow.d.ts +41 -0
- package/dist/entities/workflow.d.ts.map +1 -0
- package/dist/entities/workflow.js +102 -0
- package/dist/entities/workflow.js.map +1 -0
- package/dist/example.d.ts +7 -0
- package/dist/example.d.ts.map +1 -0
- package/dist/example.js +58 -0
- package/dist/example.js.map +1 -0
- package/dist/handlers/index.d.ts +2 -0
- package/dist/handlers/index.js +3 -0
- package/dist/handlers/workflow.handlers.d.ts +122 -0
- package/dist/handlers/workflow.handlers.d.ts.map +1 -0
- package/dist/handlers/workflow.handlers.js +263 -0
- package/dist/handlers/workflow.handlers.js.map +1 -0
- package/dist/index.d.ts +26 -0
- package/dist/index.js +26 -0
- package/dist/instance/index.d.ts +5 -0
- package/dist/instance/index.js +6 -0
- package/dist/instance/instance.enum.d.ts +10 -0
- package/dist/instance/instance.enum.d.ts.map +1 -0
- package/dist/instance/instance.enum.js +20 -0
- package/dist/instance/instance.enum.js.map +1 -0
- package/dist/instance/instance.event.d.ts +356 -0
- package/dist/instance/instance.event.d.ts.map +1 -0
- package/dist/instance/instance.event.js +293 -0
- package/dist/instance/instance.event.js.map +1 -0
- package/dist/instance/instance.handler.d.ts +27 -0
- package/dist/instance/instance.handler.d.ts.map +1 -0
- package/dist/instance/instance.handler.js +94 -0
- package/dist/instance/instance.handler.js.map +1 -0
- package/dist/instance/instance.operations.d.ts +1024 -0
- package/dist/instance/instance.operations.d.ts.map +1 -0
- package/dist/instance/instance.operations.js +464 -0
- package/dist/instance/instance.operations.js.map +1 -0
- package/dist/instance/instance.schema.d.ts +223 -0
- package/dist/instance/instance.schema.d.ts.map +1 -0
- package/dist/instance/instance.schema.js +172 -0
- package/dist/instance/instance.schema.js.map +1 -0
- package/dist/presentations/index.d.ts +63 -0
- package/dist/presentations/index.d.ts.map +1 -0
- package/dist/presentations/index.js +340 -0
- package/dist/presentations/index.js.map +1 -0
- package/dist/seeders/index.d.ts +10 -0
- package/dist/seeders/index.d.ts.map +1 -0
- package/dist/seeders/index.js +19 -0
- package/dist/seeders/index.js.map +1 -0
- package/dist/shared/index.d.ts +3 -0
- package/dist/shared/index.js +3 -0
- package/dist/shared/mock-data.d.ts +19 -0
- package/dist/shared/mock-data.d.ts.map +1 -0
- package/dist/shared/mock-data.js +12 -0
- package/dist/shared/mock-data.js.map +1 -0
- package/dist/shared/types.d.ts +81 -0
- package/dist/shared/types.d.ts.map +1 -0
- package/dist/shared/types.js +0 -0
- package/dist/state-machine/index.d.ts +148 -0
- package/dist/state-machine/index.d.ts.map +1 -0
- package/dist/state-machine/index.js +158 -0
- package/dist/state-machine/index.js.map +1 -0
- package/dist/tests/operations.test-spec.d.ts +10 -0
- package/dist/tests/operations.test-spec.d.ts.map +1 -0
- package/dist/tests/operations.test-spec.js +123 -0
- package/dist/tests/operations.test-spec.js.map +1 -0
- package/dist/ui/WorkflowDashboard.d.ts +7 -0
- package/dist/ui/WorkflowDashboard.d.ts.map +1 -0
- package/dist/ui/WorkflowDashboard.js +223 -0
- package/dist/ui/WorkflowDashboard.js.map +1 -0
- package/dist/ui/hooks/index.d.ts +2 -0
- package/dist/ui/hooks/index.js +5 -0
- package/dist/ui/hooks/useWorkflowList.d.ts +22 -0
- package/dist/ui/hooks/useWorkflowList.d.ts.map +1 -0
- package/dist/ui/hooks/useWorkflowList.js +55 -0
- package/dist/ui/hooks/useWorkflowList.js.map +1 -0
- package/dist/ui/index.d.ts +6 -0
- package/dist/ui/index.js +6 -0
- package/dist/ui/renderers/index.d.ts +2 -0
- package/dist/ui/renderers/index.js +3 -0
- package/dist/ui/renderers/workflow.markdown.d.ts +28 -0
- package/dist/ui/renderers/workflow.markdown.d.ts.map +1 -0
- package/dist/ui/renderers/workflow.markdown.js +234 -0
- package/dist/ui/renderers/workflow.markdown.js.map +1 -0
- package/dist/workflow/index.d.ts +5 -0
- package/dist/workflow/index.js +6 -0
- package/dist/workflow/workflow.enum.d.ts +22 -0
- package/dist/workflow/workflow.enum.d.ts.map +1 -0
- package/dist/workflow/workflow.enum.js +47 -0
- package/dist/workflow/workflow.enum.js.map +1 -0
- package/dist/workflow/workflow.event.d.ts +135 -0
- package/dist/workflow/workflow.event.d.ts.map +1 -0
- package/dist/workflow/workflow.event.js +150 -0
- package/dist/workflow/workflow.event.js.map +1 -0
- package/dist/workflow/workflow.handler.d.ts +29 -0
- package/dist/workflow/workflow.handler.d.ts.map +1 -0
- package/dist/workflow/workflow.handler.js +66 -0
- package/dist/workflow/workflow.handler.js.map +1 -0
- package/dist/workflow/workflow.operations.d.ts +1011 -0
- package/dist/workflow/workflow.operations.d.ts.map +1 -0
- package/dist/workflow/workflow.operations.js +345 -0
- package/dist/workflow/workflow.operations.js.map +1 -0
- package/dist/workflow/workflow.schema.d.ts +265 -0
- package/dist/workflow/workflow.schema.d.ts.map +1 -0
- package/dist/workflow/workflow.schema.js +249 -0
- package/dist/workflow/workflow.schema.js.map +1 -0
- package/dist/workflow-system.capability.d.ts +9 -0
- package/dist/workflow-system.capability.d.ts.map +1 -0
- package/dist/workflow-system.capability.js +34 -0
- package/dist/workflow-system.capability.js.map +1 -0
- package/dist/workflow-system.feature.d.ts +12 -0
- package/dist/workflow-system.feature.d.ts.map +1 -0
- package/dist/workflow-system.feature.js +346 -0
- package/dist/workflow-system.feature.js.map +1 -0
- 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"}
|