@lssm/example.workflow-system 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

package/dist/approval/approval.contracts.d.ts

@@ -0,0 +1,534 @@
+import * as _lssm_lib_schema84 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts3 from "@lssm/lib.contracts";
+
+//#region src/approval/approval.contracts.d.ts
+/**
+ * Approve or reject an approval request.
+ */
+declare const SubmitDecisionContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema84.SchemaModel<{
+  requestId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  decision: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  comment: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  data: {
+    type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema84.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  workflowInstanceId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  stepExecutionId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverRole: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  title: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  status: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+    isOptional: true;
+  };
+  decisionComment: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: true;
+  };
+  dueAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: true;
+  };
+  contextSnapshot: {
+    type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  sequenceOrder: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, {
+  name: string;
+  version: number;
+  when: string;
+  payload: _lssm_lib_schema84.SchemaModel<{
+    id: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    workflowInstanceId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    stepExecutionId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    approverId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    approverRole: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: true;
+    };
+    title: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    description: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: true;
+    };
+    status: {
+      type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+      isOptional: false;
+    };
+    decision: {
+      type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+      isOptional: true;
+    };
+    decisionComment: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: true;
+    };
+    decidedAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: true;
+    };
+    dueAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: true;
+    };
+    contextSnapshot: {
+      type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+      isOptional: true;
+    };
+    sequenceOrder: {
+      type: _lssm_lib_schema84.FieldType<number, number>;
+      isOptional: false;
+    };
+    createdAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>;
+}[]>;
+/**
+ * Delegate an approval to another user.
+ */
+declare const DelegateApprovalContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema84.SchemaModel<{
+  requestId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  delegateTo: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  reason: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema84.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  workflowInstanceId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  stepExecutionId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverRole: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  title: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  status: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+    isOptional: true;
+  };
+  decisionComment: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: true;
+  };
+  dueAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: true;
+  };
+  contextSnapshot: {
+    type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  sequenceOrder: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, {
+  name: string;
+  version: number;
+  when: string;
+  payload: _lssm_lib_schema84.SchemaModel<{
+    id: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    workflowInstanceId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    stepExecutionId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    approverId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    approverRole: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: true;
+    };
+    title: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    description: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: true;
+    };
+    status: {
+      type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+      isOptional: false;
+    };
+    decision: {
+      type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+      isOptional: true;
+    };
+    decisionComment: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: true;
+    };
+    decidedAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: true;
+    };
+    dueAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: true;
+    };
+    contextSnapshot: {
+      type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+      isOptional: true;
+    };
+    sequenceOrder: {
+      type: _lssm_lib_schema84.FieldType<number, number>;
+      isOptional: false;
+    };
+    createdAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>;
+}[]>;
+/**
+ * Add a comment to an approval request.
+ */
+declare const AddApprovalCommentContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema84.SchemaModel<{
+  requestId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  content: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  isInternal: {
+    type: _lssm_lib_schema84.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema84.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approvalRequestId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  authorId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  content: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  isInternal: {
+    type: _lssm_lib_schema84.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, {
+  name: string;
+  version: number;
+  when: string;
+  payload: _lssm_lib_schema84.SchemaModel<{
+    id: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    approvalRequestId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    authorId: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    content: {
+      type: _lssm_lib_schema84.FieldType<string, string>;
+      isOptional: false;
+    };
+    isInternal: {
+      type: _lssm_lib_schema84.FieldType<boolean, boolean>;
+      isOptional: false;
+    };
+    createdAt: {
+      type: _lssm_lib_schema84.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>;
+}[]>;
+/**
+ * List approvals assigned to the current user.
+ */
+declare const ListMyApprovalsContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema84.SchemaModel<{
+  status: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+    isOptional: true;
+  };
+  limit: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+  offset: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+}>, _lssm_lib_schema84.SchemaModel<{
+  requests: {
+    type: _lssm_lib_schema84.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: false;
+      };
+      workflowInstanceId: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: false;
+      };
+      stepExecutionId: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: false;
+      };
+      approverId: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: false;
+      };
+      approverRole: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: true;
+      };
+      title: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: false;
+      };
+      description: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: true;
+      };
+      status: {
+        type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: false;
+      };
+      decision: {
+        type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+        isOptional: true;
+      };
+      decisionComment: {
+        type: _lssm_lib_schema84.FieldType<string, string>;
+        isOptional: true;
+      };
+      decidedAt: {
+        type: _lssm_lib_schema84.FieldType<Date, string>;
+        isOptional: true;
+      };
+      dueAt: {
+        type: _lssm_lib_schema84.FieldType<Date, string>;
+        isOptional: true;
+      };
+      contextSnapshot: {
+        type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+        isOptional: true;
+      };
+      sequenceOrder: {
+        type: _lssm_lib_schema84.FieldType<number, number>;
+        isOptional: false;
+      };
+      createdAt: {
+        type: _lssm_lib_schema84.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  total: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: false;
+  };
+  pendingCount: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * Get a single approval request.
+ */
+declare const GetApprovalContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema84.SchemaModel<{
+  requestId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _lssm_lib_schema84.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  workflowInstanceId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  stepExecutionId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverId: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  approverRole: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  title: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  status: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _lssm_lib_schema84.EnumType<[string, string, string, string, string]>;
+    isOptional: true;
+  };
+  decisionComment: {
+    type: _lssm_lib_schema84.FieldType<string, string>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: true;
+  };
+  dueAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: true;
+  };
+  contextSnapshot: {
+    type: _lssm_lib_schema84.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  sequenceOrder: {
+    type: _lssm_lib_schema84.FieldType<number, number>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _lssm_lib_schema84.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+//#endregion
+export { AddApprovalCommentContract, DelegateApprovalContract, GetApprovalContract, ListMyApprovalsContract, SubmitDecisionContract };

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

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

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

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

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

@@ -0,0 +1,22 @@
+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 };