@lssm/lib.workflow-composer 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

package/dist/composer.js

@@ -1 +1,28 @@
-import{applyWorkflowExtension as e}from"./injector.js";var t=class{extensions=[];register(e){return this.extensions.push(e),this}registerMany(e){return e.forEach(e=>this.register(e)),this}compose(t){return this.extensions.filter(e=>n(t,e)).sort((e,t)=>(e.priority??0)-(t.priority??0)).reduce((t,n)=>e(t,n),t.base)}};function n(e,t){return!(t.workflow!==e.base.meta.name||t.baseVersion&&t.baseVersion!==e.base.meta.version||t.tenantId&&t.tenantId!==e.tenantId||t.role&&t.role!==e.role||t.device&&t.device!==e.device)}export{t as WorkflowComposer};
+import { applyWorkflowExtension } from "./injector.js";
+
+//#region src/composer.ts
+var WorkflowComposer = class {
+	extensions = [];
+	register(extension) {
+		this.extensions.push(extension);
+		return this;
+	}
+	registerMany(extensions) {
+		extensions.forEach((extension) => this.register(extension));
+		return this;
+	}
+	compose(params) {
+		return this.extensions.filter((extension) => matches(params, extension)).sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0)).reduce((acc, extension) => applyWorkflowExtension(acc, extension), params.base);
+	}
+};
+function matches(params, extension) {
+	if (extension.workflow !== params.base.meta.name) return false;
+	if (extension.baseVersion && extension.baseVersion !== params.base.meta.version) return false;
+	if (extension.tenantId && extension.tenantId !== params.tenantId) return false;
+	if (extension.role && extension.role !== params.role) return false;
+	if (extension.device && extension.device !== params.device) return false;
+	return true;
+}
+
+//#endregion
+export { WorkflowComposer };

package/dist/index.js

@@ -1 +1,7 @@
-import{approvalStepTemplate as e}from"./templates.js";import{validateExtension as t}from"./validator.js";import{applyWorkflowExtension as n}from"./injector.js";import{WorkflowComposer as r}from"./composer.js";import{mergeExtensions as i}from"./merger.js";export{r as WorkflowComposer,n as applyWorkflowExtension,e as approvalStepTemplate,i as mergeExtensions,t as validateExtension};
+import { approvalStepTemplate } from "./templates.js";
+import { validateExtension } from "./validator.js";
+import { applyWorkflowExtension } from "./injector.js";
+import { WorkflowComposer } from "./composer.js";
+import { mergeExtensions } from "./merger.js";
+
+export { WorkflowComposer, applyWorkflowExtension, approvalStepTemplate, mergeExtensions, validateExtension };

package/dist/injector.js

@@ -1 +1,72 @@
-import{validateExtension as e}from"./validator.js";function t(t,r){e(r,t);let s=o(t),c=[...s.definition.steps],l=[...s.definition.transitions],u=new Set(r.hiddenSteps??[]);return u.forEach(e=>{let t=c.findIndex(t=>t.id===e);t!==-1&&c.splice(t,1)}),u.size&&(l=l.filter(e=>!u.has(e.from)&&!u.has(e.to))),r.customSteps?.forEach(e=>{n(c,e),i(l,e)}),s.definition.steps=c,s.definition.transitions=a(l),s.meta={...s.meta,version:s.meta.version},s}function n(e,t){let n=r(e,t);if(n===-1)throw Error(`Unable to place injected step "${t.inject.id}"`);e.splice(n,0,{...t.inject})}function r(e,t){if(t.after){let n=e.findIndex(e=>e.id===t.after);return n===-1?-1:n+1}if(t.before){let n=e.findIndex(e=>e.id===t.before);return n===-1?-1:n}return e.length}function i(e,t){t.inject.id&&(t.transitionFrom&&e.push({from:t.transitionFrom,to:t.inject.id,condition:t.when}),t.transitionTo&&e.push({from:t.inject.id,to:t.transitionTo,condition:t.when}))}function a(e){let t=new Set,n=[];return e.forEach(e=>{let r=`${e.from}->${e.to}:${e.condition??``}`;t.has(r)||(t.add(r),n.push(e))}),n}function o(e){return JSON.parse(JSON.stringify(e))}export{t as applyWorkflowExtension};
+import { validateExtension } from "./validator.js";
+
+//#region src/injector.ts
+function applyWorkflowExtension(base, extension) {
+	validateExtension(extension, base);
+	const spec = cloneWorkflowSpec(base);
+	const steps = [...spec.definition.steps];
+	let transitions = [...spec.definition.transitions];
+	const hiddenSet = new Set(extension.hiddenSteps ?? []);
+	hiddenSet.forEach((stepId) => {
+		const idx = steps.findIndex((step) => step.id === stepId);
+		if (idx !== -1) steps.splice(idx, 1);
+	});
+	if (hiddenSet.size) transitions = transitions.filter((transition) => !hiddenSet.has(transition.from) && !hiddenSet.has(transition.to));
+	extension.customSteps?.forEach((injection) => {
+		insertStep(steps, injection);
+		wireTransitions(transitions, injection);
+	});
+	spec.definition.steps = steps;
+	spec.definition.transitions = dedupeTransitions(transitions);
+	spec.meta = {
+		...spec.meta,
+		version: spec.meta.version
+	};
+	return spec;
+}
+function insertStep(steps, injection) {
+	const anchorIndex = resolveAnchorIndex(steps, injection);
+	if (anchorIndex === -1) throw new Error(`Unable to place injected step "${injection.inject.id}"`);
+	steps.splice(anchorIndex, 0, { ...injection.inject });
+}
+function resolveAnchorIndex(steps, injection) {
+	if (injection.after) {
+		const idx = steps.findIndex((step) => step.id === injection.after);
+		return idx === -1 ? -1 : idx + 1;
+	}
+	if (injection.before) {
+		const idx = steps.findIndex((step) => step.id === injection.before);
+		return idx === -1 ? -1 : idx;
+	}
+	return steps.length;
+}
+function wireTransitions(transitions, injection) {
+	if (!injection.inject.id) return;
+	if (injection.transitionFrom) transitions.push({
+		from: injection.transitionFrom,
+		to: injection.inject.id,
+		condition: injection.when
+	});
+	if (injection.transitionTo) transitions.push({
+		from: injection.inject.id,
+		to: injection.transitionTo,
+		condition: injection.when
+	});
+}
+function dedupeTransitions(transitions) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	transitions.forEach((transition) => {
+		const key = `${transition.from}->${transition.to}:${transition.condition ?? ""}`;
+		if (seen.has(key)) return;
+		seen.add(key);
+		result.push(transition);
+	});
+	return result;
+}
+function cloneWorkflowSpec(spec) {
+	return JSON.parse(JSON.stringify(spec));
+}
+
+//#endregion
+export { applyWorkflowExtension };

package/dist/merger.js

@@ -1 +1,7 @@
-function e(e){return e.sort((e,t)=>(e.priority??0)-(t.priority??0))}export{e as mergeExtensions};
+//#region src/merger.ts
+function mergeExtensions(extensions) {
+	return extensions.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+}
+
+//#endregion
+export { mergeExtensions };

package/dist/templates.js

@@ -1 +1,17 @@
-function e(e){return{id:e.id,label:e.label,type:e.type??`human`,description:e.description??`Tenant-specific approval`,action:e.action,guard:e.guardExpression?{type:`expression`,value:e.guardExpression}:void 0}}export{e as approvalStepTemplate};
+//#region src/templates.ts
+function approvalStepTemplate(options) {
+	return {
+		id: options.id,
+		label: options.label,
+		type: options.type ?? "human",
+		description: options.description ?? "Tenant-specific approval",
+		action: options.action,
+		guard: options.guardExpression ? {
+			type: "expression",
+			value: options.guardExpression
+		} : void 0
+	};
+}
+
+//#endregion
+export { approvalStepTemplate };

package/dist/validator.js

@@ -1 +1,36 @@
-function e(e,t){let n=[],r=new Set(t.definition.steps.map(e=>e.id));if(e.customSteps?.forEach((e,t)=>{e.inject.id||n.push({code:`workflow.extension.step.id`,message:`customSteps[${t}] is missing an id`}),!e.after&&!e.before&&n.push({code:`workflow.extension.step.anchor`,message:`customSteps[${t}] must set after or before`}),e.after&&!r.has(e.after)&&n.push({code:`workflow.extension.step.after`,message:`customSteps[${t}] references unknown step "${e.after}"`}),e.before&&!r.has(e.before)&&n.push({code:`workflow.extension.step.before`,message:`customSteps[${t}] references unknown step "${e.before}"`})}),e.hiddenSteps?.forEach(e=>{r.has(e)||n.push({code:`workflow.extension.hidden-step`,message:`hidden step "${e}" does not exist`})}),n.length){let t=n.map(e=>`${e.code}: ${e.message}`).join(`; `);throw Error(`Invalid workflow extension for ${e.workflow}: ${t}`)}}export{e as validateExtension};
+//#region src/validator.ts
+function validateExtension(extension, base) {
+	const issues = [];
+	const stepIds = new Set(base.definition.steps.map((step) => step.id));
+	extension.customSteps?.forEach((injection, idx) => {
+		if (!injection.inject.id) issues.push({
+			code: "workflow.extension.step.id",
+			message: `customSteps[${idx}] is missing an id`
+		});
+		if (!injection.after && !injection.before) issues.push({
+			code: "workflow.extension.step.anchor",
+			message: `customSteps[${idx}] must set after or before`
+		});
+		if (injection.after && !stepIds.has(injection.after)) issues.push({
+			code: "workflow.extension.step.after",
+			message: `customSteps[${idx}] references unknown step "${injection.after}"`
+		});
+		if (injection.before && !stepIds.has(injection.before)) issues.push({
+			code: "workflow.extension.step.before",
+			message: `customSteps[${idx}] references unknown step "${injection.before}"`
+		});
+	});
+	extension.hiddenSteps?.forEach((stepId) => {
+		if (!stepIds.has(stepId)) issues.push({
+			code: "workflow.extension.hidden-step",
+			message: `hidden step "${stepId}" does not exist`
+		});
+	});
+	if (issues.length) {
+		const reason = issues.map((issue) => `${issue.code}: ${issue.message}`).join("; ");
+		throw new Error(`Invalid workflow extension for ${extension.workflow}: ${reason}`);
+	}
+}
+
+//#endregion
+export { validateExtension };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.workflow-composer",
-  "version": "0.0.0-canary-20251217062943",
+  "version": "0.0.0-canary-20251217072406",
   "description": "Tenant-aware workflow composition helpers for ContractSpec.",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,11 +24,11 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "0.0.0-canary-20251217062943"
+    "@lssm/lib.contracts": "0.0.0-canary-20251217072406"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217062943",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217062943",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217072406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217072406",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },