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

package/dist/workflow/workflow.enum.d.ts

@@ -0,0 +1,21 @@
+import * as _lssm_lib_schema861 from "@lssm/lib.schema";
+
+//#region src/workflow/workflow.enum.d.ts
+/**
+ * Workflow status enum.
+ */
+declare const WorkflowStatusEnum: _lssm_lib_schema861.EnumType<[string, string, string, string]>;
+/**
+ * Trigger type enum.
+ */
+declare const TriggerTypeEnum: _lssm_lib_schema861.EnumType<[string, string, string, string]>;
+/**
+ * Step type enum.
+ */
+declare const StepTypeEnum: _lssm_lib_schema861.EnumType<[string, string, string, string, string, string, string, string]>;
+/**
+ * Approval mode enum.
+ */
+declare const ApprovalModeEnum: _lssm_lib_schema861.EnumType<[string, string, string, string]>;
+//#endregion
+export { ApprovalModeEnum, StepTypeEnum, TriggerTypeEnum, WorkflowStatusEnum };

package/dist/workflow/workflow.event.d.ts

@@ -0,0 +1,134 @@
+import * as _lssm_lib_schema1148 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts30 from "@lssm/lib.contracts";
+
+//#region src/workflow/workflow.event.d.ts
+/**
+ * WorkflowCreatedEvent - A new workflow definition has been created.
+ */
+declare const WorkflowCreatedEvent: _lssm_lib_contracts30.EventSpec<_lssm_lib_schema1148.SchemaModel<{
+  workflowId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema1148.FieldType<number, number>;
+    isOptional: false;
+  };
+  organizationId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _lssm_lib_schema1148.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * WorkflowUpdatedEvent - A workflow definition has been updated.
+ */
+declare const WorkflowUpdatedEvent: _lssm_lib_contracts30.EventSpec<_lssm_lib_schema1148.SchemaModel<{
+  workflowId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema1148.FieldType<number, number>;
+    isOptional: false;
+  };
+  organizationId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _lssm_lib_schema1148.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * WorkflowPublishedEvent - A workflow definition has been published.
+ */
+declare const WorkflowPublishedEvent: _lssm_lib_contracts30.EventSpec<_lssm_lib_schema1148.SchemaModel<{
+  workflowId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  version: {
+    type: _lssm_lib_schema1148.FieldType<number, number>;
+    isOptional: false;
+  };
+  organizationId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _lssm_lib_schema1148.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * StepAddedEvent - A step has been added to a workflow definition.
+ */
+declare const StepAddedEvent: _lssm_lib_contracts30.EventSpec<_lssm_lib_schema1148.SchemaModel<{
+  stepId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  workflowId: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  stepKey: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  stepType: {
+    type: _lssm_lib_schema1148.FieldType<string, string>;
+    isOptional: false;
+  };
+  position: {
+    type: _lssm_lib_schema1148.FieldType<number, number>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _lssm_lib_schema1148.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+export { StepAddedEvent, WorkflowCreatedEvent, WorkflowPublishedEvent, WorkflowUpdatedEvent };

package/dist/workflow/workflow.handler.d.ts

@@ -0,0 +1,28 @@
+import { HandlerContext, WorkflowDefinitionRecord, WorkflowStepRecord } from "../shared/types.js";
+
+//#region src/workflow/workflow.handler.d.ts
+
+declare function handleCreateWorkflow(input: {
+  name: string;
+  key: string;
+  description?: string;
+  triggerType?: 'MANUAL' | 'EVENT' | 'SCHEDULED' | 'API';
+  featureFlagKey?: string;
+}, context: HandlerContext): Promise<WorkflowDefinitionRecord>;
+declare function handleAddStep(input: {
+  workflowId: string;
+  key: string;
+  name: string;
+  description?: string;
+  type: 'START' | 'APPROVAL' | 'TASK' | 'CONDITION' | 'PARALLEL' | 'WAIT' | 'ACTION' | 'END';
+  position?: number;
+  transitions: Record<string, string>;
+  approvalMode?: 'ANY' | 'ALL' | 'MAJORITY' | 'SEQUENTIAL';
+  approverRoles?: string[];
+  timeoutSeconds?: number;
+}, _context: HandlerContext): Promise<WorkflowStepRecord>;
+declare function handlePublishWorkflow(input: {
+  workflowId: string;
+}, _context: HandlerContext): Promise<WorkflowDefinitionRecord>;
+//#endregion
+export { handleAddStep, handleCreateWorkflow, handlePublishWorkflow };

package/dist/workflow/workflow.schema.d.ts

@@ -0,0 +1,264 @@
+import * as _lssm_lib_schema216 from "@lssm/lib.schema";
+
+//#region src/workflow/workflow.schema.d.ts
+/**
+ * A step in a workflow definition.
+ */
+declare const WorkflowStepModel: _lssm_lib_schema216.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  type: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  position: {
+    type: _lssm_lib_schema216.FieldType<number, number>;
+    isOptional: false;
+  };
+  transitions: {
+    type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  approvalMode: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  approverRoles: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+}>;
+/**
+ * A workflow definition.
+ */
+declare const WorkflowDefinitionModel: _lssm_lib_schema216.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  version: {
+    type: _lssm_lib_schema216.FieldType<number, number>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  triggerType: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  initialStepId: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  featureFlagKey: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  organizationId: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdAt: {
+    type: _lssm_lib_schema216.FieldType<Date, string>;
+    isOptional: false;
+  };
+  updatedAt: {
+    type: _lssm_lib_schema216.FieldType<Date, string>;
+    isOptional: false;
+  };
+  steps: {
+    type: _lssm_lib_schema216.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema216.FieldType<string, string>;
+        isOptional: false;
+      };
+      key: {
+        type: _lssm_lib_schema216.FieldType<string, string>;
+        isOptional: false;
+      };
+      name: {
+        type: _lssm_lib_schema216.FieldType<string, string>;
+        isOptional: false;
+      };
+      description: {
+        type: _lssm_lib_schema216.FieldType<string, string>;
+        isOptional: true;
+      };
+      type: {
+        type: _lssm_lib_schema216.EnumType<[string, string, string, string, string, string, string, string]>;
+        isOptional: false;
+      };
+      position: {
+        type: _lssm_lib_schema216.FieldType<number, number>;
+        isOptional: false;
+      };
+      transitions: {
+        type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+        isOptional: false;
+      };
+      approvalMode: {
+        type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+        isOptional: true;
+      };
+      approverRoles: {
+        type: _lssm_lib_schema216.FieldType<string, string>;
+        isArray: true;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for creating a workflow definition.
+ */
+declare const CreateWorkflowInputModel: _lssm_lib_schema216.SchemaModel<{
+  name: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  triggerType: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  triggerConfig: {
+    type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  featureFlagKey: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  settings: {
+    type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for updating a workflow definition.
+ */
+declare const UpdateWorkflowInputModel: _lssm_lib_schema216.SchemaModel<{
+  workflowId: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  description: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  triggerType: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  triggerConfig: {
+    type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  featureFlagKey: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  settings: {
+    type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for adding a step to a workflow.
+ */
+declare const AddStepInputModel: _lssm_lib_schema216.SchemaModel<{
+  workflowId: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  key: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isOptional: true;
+  };
+  type: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string, string, string, string, string]>;
+    isOptional: false;
+  };
+  position: {
+    type: _lssm_lib_schema216.FieldType<number, number>;
+    isOptional: true;
+  };
+  transitions: {
+    type: _lssm_lib_schema216.FieldType<unknown, unknown>;
+    isOptional: false;
+  };
+  approvalMode: {
+    type: _lssm_lib_schema216.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  approverRoles: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  approverUserIds: {
+    type: _lssm_lib_schema216.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+  timeoutSeconds: {
+    type: _lssm_lib_schema216.FieldType<number, number>;
+    isOptional: true;
+  };
+  slaSeconds: {
+    type: _lssm_lib_schema216.FieldType<number, number>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { AddStepInputModel, CreateWorkflowInputModel, UpdateWorkflowInputModel, WorkflowDefinitionModel, WorkflowStepModel };

package/dist/workflow-system.feature.d.ts

@@ -0,0 +1,11 @@
+import { FeatureModuleSpec } from "@lssm/lib.contracts";
+
+//#region src/workflow-system.feature.d.ts
+
+/**
+ * Workflow System feature module that bundles workflow definition,
+ * instance management, and approval handling into an installable feature.
+ */
+declare const WorkflowSystemFeature: FeatureModuleSpec;
+//#endregion
+export { WorkflowSystemFeature };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.workflow-system",
-  "version": "0.0.0-canary-20251217052941",
+  "version": "0.0.0-canary-20251217060433",
   "description": "Workflow and approval system example for ContractSpec - State machine with role-based transitions",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,55 +18,55 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217052941",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217052941",
-    "@lssm/lib.bus": "0.0.0-canary-20251217052941",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217052941",
-    "@lssm/lib.feature-flags": "0.0.0-canary-20251217052941",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217052941",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217052941",
-    "@lssm/module.notifications": "0.0.0-canary-20251217052941",
+    "@lssm/lib.schema": "0.0.0-canary-20251217060433",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060433",
+    "@lssm/lib.bus": "0.0.0-canary-20251217060433",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217060433",
+    "@lssm/lib.feature-flags": "0.0.0-canary-20251217060433",
+    "@lssm/lib.jobs": "0.0.0-canary-20251217060433",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251217060433",
+    "@lssm/module.notifications": "0.0.0-canary-20251217060433",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251217052941",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217052941",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060433",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060433",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./approval": "./src/approval/index.ts",
-    "./approval/approval.contracts": "./src/approval/approval.contracts.ts",
-    "./approval/approval.enum": "./src/approval/approval.enum.ts",
-    "./approval/approval.event": "./src/approval/approval.event.ts",
-    "./approval/approval.handler": "./src/approval/approval.handler.ts",
-    "./approval/approval.schema": "./src/approval/approval.schema.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/workflow-system.docblock": "./src/docs/workflow-system.docblock.ts",
-    "./entities": "./src/entities/index.ts",
-    "./entities/approval": "./src/entities/approval.ts",
-    "./entities/instance": "./src/entities/instance.ts",
-    "./entities/step": "./src/entities/step.ts",
-    "./entities/workflow": "./src/entities/workflow.ts",
-    "./example": "./src/example.ts",
-    "./instance": "./src/instance/index.ts",
-    "./instance/instance.contracts": "./src/instance/instance.contracts.ts",
-    "./instance/instance.enum": "./src/instance/instance.enum.ts",
-    "./instance/instance.event": "./src/instance/instance.event.ts",
-    "./instance/instance.handler": "./src/instance/instance.handler.ts",
-    "./instance/instance.schema": "./src/instance/instance.schema.ts",
-    "./presentations": "./src/presentations/index.ts",
-    "./shared": "./src/shared/index.ts",
-    "./shared/mock-data": "./src/shared/mock-data.ts",
-    "./shared/types": "./src/shared/types.ts",
-    "./state-machine": "./src/state-machine/index.ts",
-    "./workflow": "./src/workflow/index.ts",
-    "./workflow-system.feature": "./src/workflow-system.feature.ts",
-    "./workflow/workflow.contracts": "./src/workflow/workflow.contracts.ts",
-    "./workflow/workflow.enum": "./src/workflow/workflow.enum.ts",
-    "./workflow/workflow.event": "./src/workflow/workflow.event.ts",
-    "./workflow/workflow.handler": "./src/workflow/workflow.handler.ts",
-    "./workflow/workflow.schema": "./src/workflow/workflow.schema.ts",
+    ".": "./dist/index.js",
+    "./approval": "./dist/approval/index.js",
+    "./approval/approval.contracts": "./dist/approval/approval.contracts.js",
+    "./approval/approval.enum": "./dist/approval/approval.enum.js",
+    "./approval/approval.event": "./dist/approval/approval.event.js",
+    "./approval/approval.handler": "./dist/approval/approval.handler.js",
+    "./approval/approval.schema": "./dist/approval/approval.schema.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/workflow-system.docblock": "./dist/docs/workflow-system.docblock.js",
+    "./entities": "./dist/entities/index.js",
+    "./entities/approval": "./dist/entities/approval.js",
+    "./entities/instance": "./dist/entities/instance.js",
+    "./entities/step": "./dist/entities/step.js",
+    "./entities/workflow": "./dist/entities/workflow.js",
+    "./example": "./dist/example.js",
+    "./instance": "./dist/instance/index.js",
+    "./instance/instance.contracts": "./dist/instance/instance.contracts.js",
+    "./instance/instance.enum": "./dist/instance/instance.enum.js",
+    "./instance/instance.event": "./dist/instance/instance.event.js",
+    "./instance/instance.handler": "./dist/instance/instance.handler.js",
+    "./instance/instance.schema": "./dist/instance/instance.schema.js",
+    "./presentations": "./dist/presentations/index.js",
+    "./shared": "./dist/shared/index.js",
+    "./shared/mock-data": "./dist/shared/mock-data.js",
+    "./shared/types": "./dist/shared/types.js",
+    "./state-machine": "./dist/state-machine/index.js",
+    "./workflow": "./dist/workflow/index.js",
+    "./workflow-system.feature": "./dist/workflow-system.feature.js",
+    "./workflow/workflow.contracts": "./dist/workflow/workflow.contracts.js",
+    "./workflow/workflow.enum": "./dist/workflow/workflow.enum.js",
+    "./workflow/workflow.event": "./dist/workflow/workflow.event.js",
+    "./workflow/workflow.handler": "./dist/workflow/workflow.handler.js",
+    "./workflow/workflow.schema": "./dist/workflow/workflow.schema.js",
     "./*": "./*"
   },
   "module": "./dist/index.js",