@contractspec/example.workflow-system 1.44.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# @contractspec/example.workflow-system
+
+Website: https://contractspec.io/
+
+
+A comprehensive workflow and approval system example demonstrating ContractSpec principles.
+
+## Features
+
+- **State Machine Engine**: Define workflows as state machines with typed transitions
+- **Role-Based Approvals**: Configure approval chains with multiple modes (ANY, ALL, MAJORITY, SEQUENTIAL)
+- **Delegation**: Allow approvers to delegate to others
+- **Escalation**: Automatic escalation on timeout
+- **Feature Flag Integration**: Control workflow availability via feature flags
+- **Full Audit Trail**: Track all workflow actions and decisions
+- **Multi-Surface Presentations**: React components + Markdown renderers
+
+## Entities
+
+### Workflow Definition
+- `WorkflowDefinition` - Blueprint for a workflow
+- `WorkflowStep` - Steps within a workflow (START, APPROVAL, TASK, CONDITION, PARALLEL, WAIT, ACTION, END)
+
+### Workflow Instance
+- `WorkflowInstance` - Running instance of a workflow
+- `StepExecution` - Execution record for each step
+
+### Approval
+- `ApprovalRequest` - Pending approval request
+- `ApprovalComment` - Comments on approvals
+
+## Contracts
+
+### Workflow Definition Management
+- `workflow.definition.create` - Create a new workflow
+- `workflow.definition.update` - Update workflow
+- `workflow.step.add` - Add step to workflow
+- `workflow.definition.publish` - Activate workflow
+- `workflow.definition.list` - List workflows
+- `workflow.definition.get` - Get workflow details
+
+### Workflow Instance Operations
+- `workflow.instance.start` - Start a new workflow
+- `workflow.instance.transition` - Transition to next step
+- `workflow.instance.pause` - Pause workflow
+- `workflow.instance.resume` - Resume workflow
+- `workflow.instance.cancel` - Cancel workflow
+- `workflow.instance.list` - List instances
+- `workflow.instance.get` - Get instance details
+
+### Approval Operations
+- `workflow.approval.decide` - Submit approval decision
+- `workflow.approval.delegate` - Delegate to another user
+- `workflow.approval.comment.add` - Add comment
+- `workflow.approval.list.mine` - List my pending approvals
+- `workflow.approval.get` - Get approval details
+
+## State Machine
+
+The workflow engine uses a state machine model where:
+
+1. Each step defines available actions and their target steps
+2. Transitions are validated against:
+   - Current workflow status
+   - User roles (role-based access control)
+   - Step-specific conditions
+3. Actions trigger events for audit trail and notifications
+
+Example step definition:
+
+```typescript
+{
+  key: 'manager_approval',
+  type: 'APPROVAL',
+  transitions: {
+    approve: 'finance_review',
+    reject: 'rejected',
+    request_changes: 'revision_needed'
+  },
+  approvalMode: 'ANY',
+  approverRoles: ['manager', 'director'],
+  timeoutSeconds: 86400, // 24 hours
+}
+```
+
+## Events
+
+- `workflow.definition.created/updated/published`
+- `workflow.step.added`
+- `workflow.instance.started/completed/cancelled/paused/resumed/failed/timeout`
+- `workflow.step.entered/exited`
+- `workflow.approval.requested/decided/delegated/escalated`
+
+## Usage
+
+```typescript
+import { 
+  StartWorkflowContract,
+  TransitionWorkflowContract,
+  workflowSystemSchemaContribution 
+} from '@contractspec/example.workflow-system';
+
+// Start a workflow
+const instance = await executeContract(StartWorkflowContract, {
+  workflowKey: 'purchase_approval',
+  contextData: { amount: 5000, vendor: 'ACME Corp' },
+  referenceId: 'PO-12345',
+  referenceType: 'PurchaseOrder',
+});
+
+// Make a transition
+const result = await executeContract(TransitionWorkflowContract, {
+  instanceId: instance.id,
+  action: 'approve',
+  comment: 'Approved for standard purchase',
+});
+```
+
+## Dependencies
+
+- `@contractspec/lib.identity-rbac` - User identity and roles
+- `@contractspec/lib.feature-flags` - Feature flag evaluation
+- `@contractspec/module.audit-trail` - Action auditing
+- `@contractspec/module.notifications` - Approval notifications

package/dist/approval/approval.enum.d.ts

@@ -0,0 +1,14 @@
+import * as _contractspec_lib_schema96 from "@contractspec/lib.schema";
+
+//#region src/approval/approval.enum.d.ts
+/**
+ * Approval status enum.
+ */
+declare const ApprovalStatusEnum: _contractspec_lib_schema96.EnumType<[string, string, string, string, string, string, string]>;
+/**
+ * Approval decision enum.
+ */
+declare const ApprovalDecisionEnum: _contractspec_lib_schema96.EnumType<[string, string, string, string, string]>;
+//#endregion
+export { ApprovalDecisionEnum, ApprovalStatusEnum };
+//# sourceMappingURL=approval.enum.d.ts.map

package/dist/approval/approval.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.enum.d.ts","names":[],"sources":["../../src/approval/approval.enum.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,kBAQX,EAAA,0BAAA,CAR6B,QAAA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;AAa/B;;;cAAa,sBAMX,0BAAA,CAN+B"}

package/dist/approval/approval.enum.js

@@ -0,0 +1,29 @@
+import { defineEnum } from "@contractspec/lib.schema";
+
+//#region src/approval/approval.enum.ts
+/**
+* Approval status enum.
+*/
+const ApprovalStatusEnum = defineEnum("ApprovalStatus", [
+	"PENDING",
+	"APPROVED",
+	"REJECTED",
+	"DELEGATED",
+	"ESCALATED",
+	"WITHDRAWN",
+	"EXPIRED"
+]);
+/**
+* Approval decision enum.
+*/
+const ApprovalDecisionEnum = defineEnum("ApprovalDecision", [
+	"APPROVE",
+	"REJECT",
+	"REQUEST_CHANGES",
+	"DELEGATE",
+	"ABSTAIN"
+]);
+
+//#endregion
+export { ApprovalDecisionEnum, ApprovalStatusEnum };
+//# sourceMappingURL=approval.enum.js.map

package/dist/approval/approval.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.enum.js","names":[],"sources":["../../src/approval/approval.enum.ts"],"sourcesContent":["import { defineEnum } from '@contractspec/lib.schema';\n\n/**\n * Approval status enum.\n */\nexport const ApprovalStatusEnum = defineEnum('ApprovalStatus', [\n  'PENDING',\n  'APPROVED',\n  'REJECTED',\n  'DELEGATED',\n  'ESCALATED',\n  'WITHDRAWN',\n  'EXPIRED',\n]);\n\n/**\n * Approval decision enum.\n */\nexport const ApprovalDecisionEnum = defineEnum('ApprovalDecision', [\n  'APPROVE',\n  'REJECT',\n  'REQUEST_CHANGES',\n  'DELEGATE',\n  'ABSTAIN',\n]);\n"],"mappings":";;;;;;AAKA,MAAa,qBAAqB,WAAW,kBAAkB;CAC7D;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;AAKF,MAAa,uBAAuB,WAAW,oBAAoB;CACjE;CACA;CACA;CACA;CACA;CACD,CAAC"}

package/dist/approval/approval.event.d.ts

@@ -0,0 +1,131 @@
+import * as _contractspec_lib_schema224 from "@contractspec/lib.schema";
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/approval/approval.event.d.ts
+/**
+ * ApprovalRequestedEvent - An approval has been requested.
+ */
+declare const ApprovalRequestedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema224.SchemaModel<{
+  requestId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  instanceId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  workflowKey: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverRole: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: true;
+  };
+  title: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  dueAt: {
+    type: _contractspec_lib_schema224.FieldType<Date, string>;
+    isOptional: true;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema224.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * ApprovalDecidedEvent - An approval decision has been made.
+ */
+declare const ApprovalDecidedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema224.SchemaModel<{
+  requestId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  instanceId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  comment: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: true;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema224.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * ApprovalDelegatedEvent - An approval has been delegated.
+ */
+declare const ApprovalDelegatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema224.SchemaModel<{
+  requestId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  instanceId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  fromUserId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  toUserId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: true;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema224.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * ApprovalEscalatedEvent - An approval has been escalated.
+ */
+declare const ApprovalEscalatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema224.SchemaModel<{
+  requestId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  instanceId: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  escalationLevel: {
+    type: _contractspec_lib_schema224.FieldType<number, number>;
+    isOptional: false;
+  };
+  escalatedTo: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema224.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema224.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+export { ApprovalDecidedEvent, ApprovalDelegatedEvent, ApprovalEscalatedEvent, ApprovalRequestedEvent };
+//# sourceMappingURL=approval.event.d.ts.map

package/dist/approval/approval.event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.event.d.ts","names":[],"sources":["../../src/approval/approval.event.ts"],"sourcesContent":[],"mappings":";;;;;;;cAiFa,wBAAsB,4BAAA,CAAA,sCAAA;EAAtB,SAAA,EAAA;IAUX,IAAA,EAAA,2BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;EAViC,UAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAetB,UAAA,EAAA,KAAA;EAUX,CAAA;;;;;;;;EAV+B,CAAA;EAAA,KAAA,EAAA;IAepB,IAAA,uCAUX,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,IAAA;;;;;;;;;;AAKW,cA9BA,oBAwCX,EAxC+B,4BAAA,CAAA,SAwC/B,6BAxC+B,WAwC/B,CAAA;EAAA,SAAA,EAAA;UA9BA,2BAAA,CAAA;;;;;;;EAoBiC,QAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;cAftB,wBAAsB,4BAAA,CAAA,sCAAA;;UAUjC,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,wBAAsB,4BAAA,CAAA,sCAAA;;UAUjC,2BAAA,CAAA"}

package/dist/approval/approval.event.js

@@ -0,0 +1,220 @@
+import { ScalarTypeEnum } from "@contractspec/lib.schema";
+import { defineEvent, defineSchemaModel as defineSchemaModel$1 } from "@contractspec/lib.contracts";
+
+//#region src/approval/approval.event.ts
+/**
+* Payload when approval is requested.
+*/
+const ApprovalRequestedPayload = defineSchemaModel$1({
+	name: "ApprovalRequestedEventPayload",
+	description: "Payload when approval is requested",
+	fields: {
+		requestId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		approverId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		approverRole: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		title: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		dueAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Payload when approval decision is made.
+*/
+const ApprovalDecidedPayload = defineSchemaModel$1({
+	name: "ApprovalDecidedEventPayload",
+	description: "Payload when approval decision is made",
+	fields: {
+		requestId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		decision: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		decidedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		comment: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Payload when approval is delegated.
+*/
+const ApprovalDelegatedPayload = defineSchemaModel$1({
+	name: "ApprovalDelegatedEventPayload",
+	description: "Payload when approval is delegated",
+	fields: {
+		requestId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		fromUserId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		toUserId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Payload when approval is escalated.
+*/
+const ApprovalEscalatedPayload = defineSchemaModel$1({
+	name: "ApprovalEscalatedEventPayload",
+	description: "Payload when approval is escalated",
+	fields: {
+		requestId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		escalationLevel: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		escalatedTo: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* ApprovalRequestedEvent - An approval has been requested.
+*/
+const ApprovalRequestedEvent = defineEvent({
+	meta: {
+		key: "workflow.approval.requested",
+		version: 1,
+		description: "An approval has been requested.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"approval",
+			"requested"
+		]
+	},
+	payload: ApprovalRequestedPayload
+});
+/**
+* ApprovalDecidedEvent - An approval decision has been made.
+*/
+const ApprovalDecidedEvent = defineEvent({
+	meta: {
+		key: "workflow.approval.decided",
+		version: 1,
+		description: "An approval decision has been made.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"approval",
+			"decided"
+		]
+	},
+	payload: ApprovalDecidedPayload
+});
+/**
+* ApprovalDelegatedEvent - An approval has been delegated.
+*/
+const ApprovalDelegatedEvent = defineEvent({
+	meta: {
+		key: "workflow.approval.delegated",
+		version: 1,
+		description: "An approval has been delegated.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"approval",
+			"delegated"
+		]
+	},
+	payload: ApprovalDelegatedPayload
+});
+/**
+* ApprovalEscalatedEvent - An approval has been escalated.
+*/
+const ApprovalEscalatedEvent = defineEvent({
+	meta: {
+		key: "workflow.approval.escalated",
+		version: 1,
+		description: "An approval has been escalated.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"approval",
+			"escalated"
+		]
+	},
+	payload: ApprovalEscalatedPayload
+});
+
+//#endregion
+export { ApprovalDecidedEvent, ApprovalDelegatedEvent, ApprovalEscalatedEvent, ApprovalRequestedEvent };
+//# sourceMappingURL=approval.event.js.map

package/dist/approval/approval.event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.event.js","names":["defineSchemaModel"],"sources":["../../src/approval/approval.event.ts"],"sourcesContent":["import { defineEvent, defineSchemaModel } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum } from '@contractspec/lib.schema';\n\n/**\n * Payload when approval is requested.\n */\nconst ApprovalRequestedPayload = defineSchemaModel({\n  name: 'ApprovalRequestedEventPayload',\n  description: 'Payload when approval is requested',\n  fields: {\n    requestId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    approverId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    approverRole: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    dueAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload when approval decision is made.\n */\nconst ApprovalDecidedPayload = defineSchemaModel({\n  name: 'ApprovalDecidedEventPayload',\n  description: 'Payload when approval decision is made',\n  fields: {\n    requestId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    decision: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    comment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload when approval is delegated.\n */\nconst ApprovalDelegatedPayload = defineSchemaModel({\n  name: 'ApprovalDelegatedEventPayload',\n  description: 'Payload when approval is delegated',\n  fields: {\n    requestId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fromUserId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    toUserId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload when approval is escalated.\n */\nconst ApprovalEscalatedPayload = defineSchemaModel({\n  name: 'ApprovalEscalatedEventPayload',\n  description: 'Payload when approval is escalated',\n  fields: {\n    requestId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    escalationLevel: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: false,\n    },\n    escalatedTo: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * ApprovalRequestedEvent - An approval has been requested.\n */\nexport const ApprovalRequestedEvent = defineEvent({\n  meta: {\n    key: 'workflow.approval.requested',\n    version: 1,\n    description: 'An approval has been requested.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'approval', 'requested'],\n  },\n  payload: ApprovalRequestedPayload,\n});\n\n/**\n * ApprovalDecidedEvent - An approval decision has been made.\n */\nexport const ApprovalDecidedEvent = defineEvent({\n  meta: {\n    key: 'workflow.approval.decided',\n    version: 1,\n    description: 'An approval decision has been made.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'approval', 'decided'],\n  },\n  payload: ApprovalDecidedPayload,\n});\n\n/**\n * ApprovalDelegatedEvent - An approval has been delegated.\n */\nexport const ApprovalDelegatedEvent = defineEvent({\n  meta: {\n    key: 'workflow.approval.delegated',\n    version: 1,\n    description: 'An approval has been delegated.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'approval', 'delegated'],\n  },\n  payload: ApprovalDelegatedPayload,\n});\n\n/**\n * ApprovalEscalatedEvent - An approval has been escalated.\n */\nexport const ApprovalEscalatedEvent = defineEvent({\n  meta: {\n    key: 'workflow.approval.escalated',\n    version: 1,\n    description: 'An approval has been escalated.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'approval', 'escalated'],\n  },\n  payload: ApprovalEscalatedPayload,\n});\n"],"mappings":"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"}

package/dist/approval/approval.handler.d.ts

@@ -0,0 +1,23 @@
+import { ApprovalRequestRecord, HandlerContext, WorkflowInstanceRecord, WorkflowStepRecord } from "../shared/types.js";
+
+//#region src/approval/approval.handler.d.ts
+
+declare function createApprovalRequests(instance: WorkflowInstanceRecord, step: WorkflowStepRecord, _context: HandlerContext): Promise<void>;
+declare function handleSubmitDecision(input: {
+  requestId: string;
+  decision: 'APPROVE' | 'REJECT' | 'REQUEST_CHANGES' | 'DELEGATE' | 'ABSTAIN';
+  comment?: string;
+  data?: Record<string, unknown>;
+}, context: HandlerContext): Promise<ApprovalRequestRecord>;
+declare function handleListMyApprovals(input: {
+  status?: 'PENDING' | 'APPROVED' | 'REJECTED' | 'DELEGATED' | 'ESCALATED' | 'WITHDRAWN' | 'EXPIRED';
+  limit?: number;
+  offset?: number;
+}, context: HandlerContext): Promise<{
+  requests: ApprovalRequestRecord[];
+  total: number;
+  pendingCount: number;
+}>;
+//#endregion
+export { createApprovalRequests, handleListMyApprovals, handleSubmitDecision };
+//# sourceMappingURL=approval.handler.d.ts.map

package/dist/approval/approval.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.handler.d.ts","names":[],"sources":["../../src/approval/approval.handler.ts"],"sourcesContent":[],"mappings":";;;;AAcY,iBADU,sBAAA,CACV,QAAA,EAAA,sBAAA,EAAA,IAAA,EACJ,kBADI,EAAA,QAAA,EAEA,cAFA,CAAA,EAGT,OAHS,CAAA,IAAA,CAAA;AACJ,iBA8Bc,oBAAA,CA9Bd,KAAA,EAAA;EACI,SAAA,EAAA,MAAA;EACT,QAAA,EAAA,SAAA,GAAA,QAAA,GAAA,iBAAA,GAAA,UAAA,GAAA,SAAA;EAAO,OAAA,CAAA,EAAA,MAAA;EA4BY,IAAA,CAAA,EAKX,MALW,CAAA,MAAA,EAAA,OAAoB,CAAA;CAK/B,EAAA,OAAA,EAEA,cAFA,CAAA,EAGR,OAHQ,CAGA,qBAHA,CAAA;AAEA,iBAiDW,qBAAA,CAjDX,KAAA,EAAA;EACA,MAAA,CAAA,EAAA,SAAA,GAAA,UAAA,GAAA,UAAA,GAAA,WAAA,GAAA,WAAA,GAAA,WAAA,GAAA,SAAA;EAAR,KAAA,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAAA,MAAA;AAgDV,CAAA,EAAA,OAAsB,EAaX,cAbW,CAAA,EAcnB,OAdwC,CAAA;EAahC,QAAA,EAEC,qBAFD,EAAA;EAEC,KAAA,EAAA,MAAA;EADT,YAAA,EAAA,MAAA;CAAO,CAAA"}

package/dist/approval/approval.handler.js

@@ -0,0 +1,72 @@
+import { mockDataStore } from "../shared/mock-data.js";
+import { handleTransitionWorkflow } from "../instance/instance.handler.js";
+
+//#region src/approval/approval.handler.ts
+async function createApprovalRequests(instance, step, _context) {
+	const now = /* @__PURE__ */ new Date();
+	for (let i = 0; i < step.approverRoles.length; i++) {
+		const role = step.approverRoles[i];
+		const id = `approval_${Date.now()}_${i}`;
+		const request = {
+			id,
+			workflowInstanceId: instance.id,
+			stepExecutionId: `exec_${instance.id}_${step.id}`,
+			approverId: `user_${role}`,
+			approverRole: role,
+			title: `Approval required for ${step.name}`,
+			description: step.description,
+			status: "PENDING",
+			contextSnapshot: instance.contextData,
+			sequenceOrder: i,
+			createdAt: now,
+			updatedAt: now
+		};
+		mockDataStore.approvals.set(id, request);
+	}
+}
+async function handleSubmitDecision(input, context) {
+	const request = mockDataStore.approvals.get(input.requestId);
+	if (!request) throw new Error(`Approval request ${input.requestId} not found`);
+	if (request.approverId !== context.userId && !context.userRoles.includes(request.approverRole ?? "")) throw new Error("User is not authorized to make this decision");
+	const now = /* @__PURE__ */ new Date();
+	request.decision = input.decision;
+	request.decisionComment = input.comment;
+	request.decidedAt = now;
+	request.updatedAt = now;
+	if (input.decision === "APPROVE") {
+		request.status = "APPROVED";
+		await handleTransitionWorkflow({
+			instanceId: request.workflowInstanceId,
+			action: "approve",
+			data: input.data,
+			comment: input.comment
+		}, context);
+	} else if (input.decision === "REJECT") {
+		request.status = "REJECTED";
+		await handleTransitionWorkflow({
+			instanceId: request.workflowInstanceId,
+			action: "reject",
+			data: input.data,
+			comment: input.comment
+		}, context);
+	}
+	return request;
+}
+async function handleListMyApprovals(input, context) {
+	let requests = Array.from(mockDataStore.approvals.values()).filter((r) => r.approverId === context.userId || context.userRoles.includes(r.approverRole ?? ""));
+	const pendingCount = requests.filter((r) => r.status === "PENDING").length;
+	if (input.status) requests = requests.filter((r) => r.status === input.status);
+	const total = requests.length;
+	const offset = input.offset ?? 0;
+	const limit = input.limit ?? 20;
+	requests = requests.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime()).slice(offset, offset + limit);
+	return {
+		requests,
+		total,
+		pendingCount
+	};
+}
+
+//#endregion
+export { createApprovalRequests, handleListMyApprovals, handleSubmitDecision };
+//# sourceMappingURL=approval.handler.js.map