@lssm/example.workflow-system 1.41.1 → 1.42.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.workflow-system",
-  "version": "1.41.1",
+  "version": "1.42.2",
   "description": "Workflow and approval system example for ContractSpec - State machine with role-based transitions",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,7 +8,7 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:bundle && bun build:types",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -18,55 +18,55 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "1.41.1",
-    "@lssm/lib.contracts": "1.41.1",
-    "@lssm/lib.bus": "1.41.1",
-    "@lssm/lib.identity-rbac": "1.41.1",
-    "@lssm/lib.feature-flags": "1.41.1",
-    "@lssm/lib.jobs": "1.41.1",
-    "@lssm/module.audit-trail": "1.41.1",
-    "@lssm/module.notifications": "1.41.1",
+    "@lssm/lib.schema": "1.42.2",
+    "@lssm/lib.contracts": "1.42.2",
+    "@lssm/lib.bus": "1.42.2",
+    "@lssm/lib.identity-rbac": "1.42.2",
+    "@lssm/lib.feature-flags": "1.42.2",
+    "@lssm/lib.jobs": "1.42.2",
+    "@lssm/module.audit-trail": "1.42.2",
+    "@lssm/module.notifications": "1.42.2",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "1.41.1",
-    "@lssm/tool.tsdown": "1.41.1",
+    "@lssm/tool.typescript": "1.42.2",
+    "@lssm/tool.tsdown": "1.42.2",
     "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.enum": "./dist/approval/approval.enum.js",
+    "./approval/approval.event": "./dist/approval/approval.event.js",
+    "./approval/approval.handler": "./dist/approval/approval.handler.js",
+    "./approval/approval.operations": "./dist/approval/approval.operations.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.enum": "./dist/instance/instance.enum.js",
+    "./instance/instance.event": "./dist/instance/instance.event.js",
+    "./instance/instance.handler": "./dist/instance/instance.handler.js",
+    "./instance/instance.operations": "./dist/instance/instance.operations.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.enum": "./dist/workflow/workflow.enum.js",
+    "./workflow/workflow.event": "./dist/workflow/workflow.event.js",
+    "./workflow/workflow.handler": "./dist/workflow/workflow.handler.js",
+    "./workflow/workflow.operations": "./dist/workflow/workflow.operations.js",
+    "./workflow/workflow.schema": "./dist/workflow/workflow.schema.js",
     "./*": "./*"
   },
   "module": "./dist/index.js",
@@ -79,7 +79,7 @@
     "exports": {
       ".": "./dist/index.js",
       "./approval": "./dist/approval/index.js",
-      "./approval/approval.contracts": "./dist/approval/approval.contracts.js",
+      "./approval/approval.contracts": "./dist/approval/approval.operations.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",
@@ -93,7 +93,7 @@
       "./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.contracts": "./dist/instance/instance.operations.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",
@@ -105,12 +105,19 @@
       "./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.contracts": "./dist/workflow/workflow.operations.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",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/workflow-system"
   }
 }

package/dist/approval/approval.contracts.js

@@ -1 +0,0 @@
-import{ApprovalDecisionEnum as e,ApprovalStatusEnum as t}from"./approval.enum.js";import{ApprovalCommentModel as n,ApprovalRequestModel as r}from"./approval.schema.js";import{ScalarTypeEnum as i,defineSchemaModel as a}from"@lssm/lib.schema";import{defineCommand as o,defineQuery as s}from"@lssm/lib.contracts/spec";const c=[`@example.workflow-system`],l=o({meta:{name:`workflow.approval.decide`,version:1,stability:`stable`,owners:[...c],tags:[`workflow`,`approval`,`decision`],description:`Submit an approval decision (approve/reject).`,goal:`Allow approvers to make decisions on requests.`,context:`Approval inbox, workflow detail.`},io:{input:a({name:`ApproveRejectInput`,fields:{requestId:{type:i.String_unsecure(),isOptional:!1},decision:{type:e,isOptional:!1},comment:{type:i.String_unsecure(),isOptional:!0},data:{type:i.JSON(),isOptional:!0}}}),output:r},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.approval.decided`,version:1,when:`Decision is made`,payload:r}],audit:[`workflow.approval.decided`]}}),u=o({meta:{name:`workflow.approval.delegate`,version:1,stability:`stable`,owners:[...c],tags:[`workflow`,`approval`,`delegate`],description:`Delegate an approval request to another user.`,goal:`Allow approvers to pass approval to others.`,context:`Approval inbox.`},io:{input:a({name:`DelegateInput`,fields:{requestId:{type:i.String_unsecure(),isOptional:!1},delegateTo:{type:i.String_unsecure(),isOptional:!1},reason:{type:i.String_unsecure(),isOptional:!0}}}),output:r},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.approval.delegated`,version:1,when:`Approval is delegated`,payload:r}],audit:[`workflow.approval.delegated`]}}),d=o({meta:{name:`workflow.approval.comment.add`,version:1,stability:`stable`,owners:[...c],tags:[`workflow`,`approval`,`comment`],description:`Add a comment to an approval request.`,goal:`Allow discussion on approval requests.`,context:`Approval detail view.`},io:{input:a({name:`AddCommentInput`,fields:{requestId:{type:i.String_unsecure(),isOptional:!1},content:{type:i.NonEmptyString(),isOptional:!1},isInternal:{type:i.Boolean(),isOptional:!0}}}),output:n},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.approval.comment.added`,version:1,when:`Comment is added`,payload:n}]}}),f=s({meta:{name:`workflow.approval.list.mine`,version:1,stability:`stable`,owners:[...c],tags:[`workflow`,`approval`,`list`,`inbox`],description:`List approval requests assigned to current user.`,goal:`Show pending approvals in user inbox.`,context:`Approval inbox, dashboard widget.`},io:{input:a({name:`ListMyApprovalsInput`,fields:{status:{type:t,isOptional:!0},limit:{type:i.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:i.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:a({name:`ListMyApprovalsOutput`,fields:{requests:{type:r,isArray:!0,isOptional:!1},total:{type:i.Int_unsecure(),isOptional:!1},pendingCount:{type:i.Int_unsecure(),isOptional:!1}}})},policy:{auth:`user`}}),p=s({meta:{name:`workflow.approval.get`,version:1,stability:`stable`,owners:[...c],tags:[`workflow`,`approval`,`get`],description:`Get an approval request with details.`,goal:`View approval request details.`,context:`Approval detail view.`},io:{input:a({name:`GetApprovalInput`,fields:{requestId:{type:i.String_unsecure(),isOptional:!1}}}),output:r},policy:{auth:`user`}});export{d as AddApprovalCommentContract,u as DelegateApprovalContract,p as GetApprovalContract,f as ListMyApprovalsContract,l as SubmitDecisionContract};

package/dist/instance/instance.contracts.js

@@ -1 +0,0 @@
-import{InstanceStatusEnum as e}from"./instance.enum.js";import{StartWorkflowInputModel as t,TransitionInputModel as n,TransitionResultModel as r,WorkflowInstanceModel as i}from"./instance.schema.js";import{ScalarTypeEnum as a,defineSchemaModel as o}from"@lssm/lib.schema";import{defineCommand as s,defineQuery as c}from"@lssm/lib.contracts/spec";const l=[`@example.workflow-system`],u=s({meta:{name:`workflow.instance.start`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`start`],description:`Start a new workflow instance.`,goal:`Initiate a workflow for a business process.`,context:`Order creation, request submission, etc.`},io:{input:t,output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.instance.started`,version:1,when:`Workflow starts`,payload:i},{name:`workflow.step.entered`,version:1,when:`First step entered`,payload:i}],audit:[`workflow.instance.started`]}}),d=s({meta:{name:`workflow.instance.transition`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`transition`,`state-machine`],description:`Transition a workflow instance to the next step.`,goal:`Move workflow forward based on action.`,context:`Task completion, approval decisions.`},io:{input:n,output:r},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.step.exited`,version:1,when:`Step is exited`,payload:i},{name:`workflow.step.entered`,version:1,when:`New step is entered`,payload:i},{name:`workflow.instance.completed`,version:1,when:`Workflow reaches end`,payload:i}],audit:[`workflow.instance.transitioned`]}}),f=s({meta:{name:`workflow.instance.pause`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`pause`],description:`Pause a running workflow instance.`,goal:`Temporarily halt workflow execution.`,context:`Administrative action, emergency stop.`},io:{input:o({name:`PauseResumeInput`,fields:{instanceId:{type:a.String_unsecure(),isOptional:!1},reason:{type:a.String_unsecure(),isOptional:!0}}}),output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.instance.paused`,version:1,when:`Workflow is paused`,payload:i}],audit:[`workflow.instance.paused`]}}),p=s({meta:{name:`workflow.instance.resume`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`resume`],description:`Resume a paused workflow instance.`,goal:`Continue workflow execution.`,context:`Administrative action.`},io:{input:o({name:`PauseResumeInput`,fields:{instanceId:{type:a.String_unsecure(),isOptional:!1},reason:{type:a.String_unsecure(),isOptional:!0}}}),output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.instance.resumed`,version:1,when:`Workflow is resumed`,payload:i}],audit:[`workflow.instance.resumed`]}}),m=s({meta:{name:`workflow.instance.cancel`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`cancel`],description:`Cancel a workflow instance.`,goal:`Terminate workflow without completion.`,context:`User request, system cancellation.`},io:{input:o({name:`CancelWorkflowInput`,fields:{instanceId:{type:a.String_unsecure(),isOptional:!1},reason:{type:a.String_unsecure(),isOptional:!1}}}),output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.instance.cancelled`,version:1,when:`Workflow is cancelled`,payload:i}],audit:[`workflow.instance.cancelled`]}}),h=c({meta:{name:`workflow.instance.list`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`list`],description:`List workflow instances with filtering.`,goal:`Browse and search running workflows.`,context:`Dashboard, monitoring.`},io:{input:o({name:`ListInstancesInput`,fields:{workflowKey:{type:a.String_unsecure(),isOptional:!0},status:{type:e,isOptional:!0},referenceType:{type:a.String_unsecure(),isOptional:!0},referenceId:{type:a.String_unsecure(),isOptional:!0},triggeredBy:{type:a.String_unsecure(),isOptional:!0},limit:{type:a.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:a.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:o({name:`ListInstancesOutput`,fields:{instances:{type:i,isArray:!0,isOptional:!1},total:{type:a.Int_unsecure(),isOptional:!1}}})},policy:{auth:`user`}}),g=c({meta:{name:`workflow.instance.get`,version:1,stability:`stable`,owners:[...l],tags:[`workflow`,`instance`,`get`],description:`Get a workflow instance with details.`,goal:`View workflow instance details.`,context:`Instance detail view.`},io:{input:o({name:`GetInstanceInput`,fields:{instanceId:{type:a.String_unsecure(),isOptional:!1}}}),output:i},policy:{auth:`user`}});export{m as CancelWorkflowContract,g as GetInstanceContract,h as ListInstancesContract,f as PauseWorkflowContract,p as ResumeWorkflowContract,u as StartWorkflowContract,d as TransitionWorkflowContract};

package/dist/workflow/workflow.contracts.js

@@ -1 +0,0 @@
-import{WorkflowStatusEnum as e}from"./workflow.enum.js";import{AddStepInputModel as t,CreateWorkflowInputModel as n,UpdateWorkflowInputModel as r,WorkflowDefinitionModel as i,WorkflowStepModel as a}from"./workflow.schema.js";import{ScalarTypeEnum as o,defineSchemaModel as s}from"@lssm/lib.schema";import{defineCommand as c,defineQuery as l}from"@lssm/lib.contracts/spec";const u=[`@example.workflow-system`],d=c({meta:{name:`workflow.definition.create`,version:1,stability:`stable`,owners:[...u],tags:[`workflow`,`definition`,`create`],description:`Create a new workflow definition.`,goal:`Allow users to define new workflow blueprints.`,context:`Workflow designer, admin panel.`},io:{input:n,output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.definition.created`,version:1,when:`Workflow is created`,payload:i}],audit:[`workflow.definition.created`]}}),f=c({meta:{name:`workflow.definition.update`,version:1,stability:`stable`,owners:[...u],tags:[`workflow`,`definition`,`update`],description:`Update an existing workflow definition.`,goal:`Allow users to modify workflow blueprints.`,context:`Workflow designer.`},io:{input:r,output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.definition.updated`,version:1,when:`Workflow is updated`,payload:i}],audit:[`workflow.definition.updated`]}}),p=c({meta:{name:`workflow.step.add`,version:1,stability:`stable`,owners:[...u],tags:[`workflow`,`step`,`add`],description:`Add a step to a workflow definition.`,goal:`Build workflow structure step by step.`,context:`Workflow designer.`},io:{input:t,output:a},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.step.added`,version:1,when:`Step is added`,payload:a}],audit:[`workflow.step.added`]}}),m=c({meta:{name:`workflow.definition.publish`,version:1,stability:`stable`,owners:[...u],tags:[`workflow`,`definition`,`publish`],description:`Publish a workflow definition to make it available for use.`,goal:`Activate workflow for production use.`,context:`Workflow designer, deployment.`},io:{input:s({name:`PublishWorkflowInput`,fields:{workflowId:{type:o.String_unsecure(),isOptional:!1}}}),output:i},policy:{auth:`user`},sideEffects:{emits:[{name:`workflow.definition.published`,version:1,when:`Workflow is published`,payload:i}],audit:[`workflow.definition.published`]}}),h=l({meta:{name:`workflow.definition.list`,version:1,stability:`stable`,owners:[...u],tags:[`workflow`,`definition`,`list`],description:`List workflow definitions with filtering.`,goal:`Browse and search available workflows.`,context:`Workflow list, search.`},io:{input:s({name:`ListWorkflowsInput`,fields:{status:{type:e,isOptional:!0},search:{type:o.String_unsecure(),isOptional:!0},limit:{type:o.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:o.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:s({name:`ListWorkflowsOutput`,fields:{workflows:{type:i,isArray:!0,isOptional:!1},total:{type:o.Int_unsecure(),isOptional:!1}}})},policy:{auth:`user`}}),g=l({meta:{name:`workflow.definition.get`,version:1,stability:`stable`,owners:[...u],tags:[`workflow`,`definition`,`get`],description:`Get a workflow definition with all steps.`,goal:`View workflow details.`,context:`Workflow designer, detail view.`},io:{input:s({name:`GetWorkflowInput`,fields:{workflowId:{type:o.String_unsecure(),isOptional:!1}}}),output:i},policy:{auth:`user`}});export{p as AddStepContract,d as CreateWorkflowContract,g as GetWorkflowContract,h as ListWorkflowsContract,m as PublishWorkflowContract,f as UpdateWorkflowContract};