@lssm/example.workflow-system 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/state-machine/index.js

@@ -1 +1,157 @@
-var e=class{canTransition(e,t,n,r){if(t.status!==`RUNNING`&&t.status!==`WAITING`)return{allowed:!1,reason:`Workflow is ${t.status}, cannot transition`};let i=e.steps[t.currentStepKey];if(!i)return{allowed:!1,reason:`Step ${t.currentStepKey} not found`};let a=i.transitions[n];return a?i.allowedRoles&&i.allowedRoles.length>0&&!i.allowedRoles.some(e=>r.userRoles.includes(e))?{allowed:!1,reason:`User lacks required role for this action`}:typeof a==`object`&&a.allowedRoles&&a.allowedRoles.length>0&&!a.allowedRoles.some(e=>r.userRoles.includes(e))?{allowed:!1,reason:`User lacks required role for action ${n}`}:{allowed:!0}:{allowed:!1,reason:`Action ${n} not available in step ${t.currentStepKey}`}}getAvailableActions(e,t,n){if(t.status!==`RUNNING`&&t.status!==`WAITING`)return[];let r=e.steps[t.currentStepKey];return r?Object.keys(r.transitions).filter(r=>this.canTransition(e,t,r,n).allowed):[]}transition(e,t,n,r){let i=this.canTransition(e,t,n,r);if(!i.allowed)return{success:!1,previousStepKey:t.currentStepKey,currentStepKey:t.currentStepKey,status:t.status,error:i.reason};let a=e.steps[t.currentStepKey];if(!a)return{success:!1,previousStepKey:t.currentStepKey,currentStepKey:t.currentStepKey,status:t.status,error:`Current step ${t.currentStepKey} not found`};let o=a.transitions[n];if(!o)return{success:!1,previousStepKey:t.currentStepKey,currentStepKey:t.currentStepKey,status:t.status,error:`Transition for action ${n} not found`};let s=typeof o==`string`?o:o.targetStepKey,c=e.steps[s];if(!c)return{success:!1,previousStepKey:t.currentStepKey,currentStepKey:t.currentStepKey,status:t.status,error:`Target step ${s} not found`};let l=`RUNNING`;return c.type===`END`?l=`COMPLETED`:(c.type===`APPROVAL`||c.type===`WAIT`)&&(l=`WAITING`),{success:!0,previousStepKey:t.currentStepKey,currentStepKey:s,status:l}}evaluateCondition(e,t){try{let n=e.match(/^(\w+)\s*(>=|<=|>|<|===|!==|==|!=)\s*(.+)$/);if(n){let[,e,r,i]=n;if(!e||!r||i===void 0)return!1;let a=t[e],o=JSON.parse(i);switch(r){case`>`:return Number(a)>Number(o);case`<`:return Number(a)<Number(o);case`>=`:return Number(a)>=Number(o);case`<=`:return Number(a)<=Number(o);case`===`:case`==`:return a===o;case`!==`:case`!=`:return a!==o}}return e in t?!!t[e]:!1}catch{return!1}}};function t(){return new e}function n(e,t){let n={};for(let e of t)n[e.key]={key:e.key,name:e.name,type:e.type,transitions:e.transitions,approvalMode:e.approvalMode,allowedRoles:e.approverRoles,timeoutSeconds:e.timeoutSeconds,conditionExpression:e.conditionExpression};let r=t.find(e=>e.type===`START`)?.key??t[0]?.key??``;return{key:e.key,name:e.name,version:e.version,initialStepKey:r,steps:n}}function r(e,t={}){return{currentStepKey:e.initialStepKey,status:`RUNNING`,contextData:t,history:[]}}export{e as BasicStateMachineEngine,n as buildStateMachineDefinition,r as createInitialState,t as createStateMachineEngine};
+//#region src/state-machine/index.ts
+/**
+* Basic state machine engine implementation.
+* This is a reference implementation for spec validation.
+*/
+var BasicStateMachineEngine = class {
+	canTransition(definition, state, action, context) {
+		if (state.status !== "RUNNING" && state.status !== "WAITING") return {
+			allowed: false,
+			reason: `Workflow is ${state.status}, cannot transition`
+		};
+		const currentStep = definition.steps[state.currentStepKey];
+		if (!currentStep) return {
+			allowed: false,
+			reason: `Step ${state.currentStepKey} not found`
+		};
+		const transition = currentStep.transitions[action];
+		if (!transition) return {
+			allowed: false,
+			reason: `Action ${action} not available in step ${state.currentStepKey}`
+		};
+		if (currentStep.allowedRoles && currentStep.allowedRoles.length > 0) {
+			if (!currentStep.allowedRoles.some((role) => context.userRoles.includes(role))) return {
+				allowed: false,
+				reason: `User lacks required role for this action`
+			};
+		}
+		if (typeof transition === "object" && transition.allowedRoles && transition.allowedRoles.length > 0) {
+			if (!transition.allowedRoles.some((role) => context.userRoles.includes(role))) return {
+				allowed: false,
+				reason: `User lacks required role for action ${action}`
+			};
+		}
+		return { allowed: true };
+	}
+	getAvailableActions(definition, state, context) {
+		if (state.status !== "RUNNING" && state.status !== "WAITING") return [];
+		const currentStep = definition.steps[state.currentStepKey];
+		if (!currentStep) return [];
+		return Object.keys(currentStep.transitions).filter((action) => {
+			return this.canTransition(definition, state, action, context).allowed;
+		});
+	}
+	transition(definition, state, action, context) {
+		const validation = this.canTransition(definition, state, action, context);
+		if (!validation.allowed) return {
+			success: false,
+			previousStepKey: state.currentStepKey,
+			currentStepKey: state.currentStepKey,
+			status: state.status,
+			error: validation.reason
+		};
+		const currentStep = definition.steps[state.currentStepKey];
+		if (!currentStep) return {
+			success: false,
+			previousStepKey: state.currentStepKey,
+			currentStepKey: state.currentStepKey,
+			status: state.status,
+			error: `Current step ${state.currentStepKey} not found`
+		};
+		const transition = currentStep.transitions[action];
+		if (!transition) return {
+			success: false,
+			previousStepKey: state.currentStepKey,
+			currentStepKey: state.currentStepKey,
+			status: state.status,
+			error: `Transition for action ${action} not found`
+		};
+		const targetStepKey = typeof transition === "string" ? transition : transition.targetStepKey;
+		const targetStep = definition.steps[targetStepKey];
+		if (!targetStep) return {
+			success: false,
+			previousStepKey: state.currentStepKey,
+			currentStepKey: state.currentStepKey,
+			status: state.status,
+			error: `Target step ${targetStepKey} not found`
+		};
+		let newStatus = "RUNNING";
+		if (targetStep.type === "END") newStatus = "COMPLETED";
+		else if (targetStep.type === "APPROVAL" || targetStep.type === "WAIT") newStatus = "WAITING";
+		return {
+			success: true,
+			previousStepKey: state.currentStepKey,
+			currentStepKey: targetStepKey,
+			status: newStatus
+		};
+	}
+	evaluateCondition(expression, contextData) {
+		try {
+			const match = expression.match(/^(\w+)\s*(>=|<=|>|<|===|!==|==|!=)\s*(.+)$/);
+			if (match) {
+				const [, prop, operator, value] = match;
+				if (!prop || !operator || value === void 0) return false;
+				const propValue = contextData[prop];
+				const compareValue = JSON.parse(value);
+				switch (operator) {
+					case ">": return Number(propValue) > Number(compareValue);
+					case "<": return Number(propValue) < Number(compareValue);
+					case ">=": return Number(propValue) >= Number(compareValue);
+					case "<=": return Number(propValue) <= Number(compareValue);
+					case "===":
+					case "==": return propValue === compareValue;
+					case "!==":
+					case "!=": return propValue !== compareValue;
+				}
+			}
+			if (expression in contextData) return Boolean(contextData[expression]);
+			return false;
+		} catch {
+			return false;
+		}
+	}
+};
+/**
+* Create a new state machine engine instance.
+*/
+function createStateMachineEngine() {
+	return new BasicStateMachineEngine();
+}
+/**
+* Build a state machine definition from workflow entities.
+*/
+function buildStateMachineDefinition(workflow, steps) {
+	const stepMap = {};
+	for (const step of steps) stepMap[step.key] = {
+		key: step.key,
+		name: step.name,
+		type: step.type,
+		transitions: step.transitions,
+		approvalMode: step.approvalMode,
+		allowedRoles: step.approverRoles,
+		timeoutSeconds: step.timeoutSeconds,
+		conditionExpression: step.conditionExpression
+	};
+	const initialStepKey = steps.find((s) => s.type === "START")?.key ?? steps[0]?.key ?? "";
+	return {
+		key: workflow.key,
+		name: workflow.name,
+		version: workflow.version,
+		initialStepKey,
+		steps: stepMap
+	};
+}
+/**
+* Create initial state for a new workflow instance.
+*/
+function createInitialState(definition, contextData = {}) {
+	return {
+		currentStepKey: definition.initialStepKey,
+		status: "RUNNING",
+		contextData,
+		history: []
+	};
+}
+
+//#endregion
+export { BasicStateMachineEngine, buildStateMachineDefinition, createInitialState, createStateMachineEngine };

package/dist/workflow/index.js

@@ -1 +1,6 @@
-import{ApprovalModeEnum as e,StepTypeEnum as t,TriggerTypeEnum as n,WorkflowStatusEnum as r}from"./workflow.enum.js";import{AddStepInputModel as i,CreateWorkflowInputModel as a,UpdateWorkflowInputModel as o,WorkflowDefinitionModel as s,WorkflowStepModel as c}from"./workflow.schema.js";import{AddStepContract as l,CreateWorkflowContract as u,GetWorkflowContract as d,ListWorkflowsContract as f,PublishWorkflowContract as p,UpdateWorkflowContract as m}from"./workflow.contracts.js";import{StepAddedEvent as h,WorkflowCreatedEvent as g,WorkflowPublishedEvent as _,WorkflowUpdatedEvent as v}from"./workflow.event.js";export{l as AddStepContract,i as AddStepInputModel,e as ApprovalModeEnum,u as CreateWorkflowContract,a as CreateWorkflowInputModel,d as GetWorkflowContract,f as ListWorkflowsContract,p as PublishWorkflowContract,h as StepAddedEvent,t as StepTypeEnum,n as TriggerTypeEnum,m as UpdateWorkflowContract,o as UpdateWorkflowInputModel,g as WorkflowCreatedEvent,s as WorkflowDefinitionModel,_ as WorkflowPublishedEvent,r as WorkflowStatusEnum,c as WorkflowStepModel,v as WorkflowUpdatedEvent};
+import { ApprovalModeEnum, StepTypeEnum, TriggerTypeEnum, WorkflowStatusEnum } from "./workflow.enum.js";
+import { AddStepInputModel, CreateWorkflowInputModel, UpdateWorkflowInputModel, WorkflowDefinitionModel, WorkflowStepModel } from "./workflow.schema.js";
+import { AddStepContract, CreateWorkflowContract, GetWorkflowContract, ListWorkflowsContract, PublishWorkflowContract, UpdateWorkflowContract } from "./workflow.contracts.js";
+import { StepAddedEvent, WorkflowCreatedEvent, WorkflowPublishedEvent, WorkflowUpdatedEvent } from "./workflow.event.js";
+
+export { AddStepContract, AddStepInputModel, ApprovalModeEnum, CreateWorkflowContract, CreateWorkflowInputModel, GetWorkflowContract, ListWorkflowsContract, PublishWorkflowContract, StepAddedEvent, StepTypeEnum, TriggerTypeEnum, UpdateWorkflowContract, UpdateWorkflowInputModel, WorkflowCreatedEvent, WorkflowDefinitionModel, WorkflowPublishedEvent, WorkflowStatusEnum, WorkflowStepModel, WorkflowUpdatedEvent };