@lssm/example.personalization 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/libs/workflow-composer/dist/injector.js

@@ -0,0 +1,72 @@
+import { validateExtension } from "./validator.js";
+
+//#region ../../libs/workflow-composer/dist/injector.js
+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/libs/workflow-composer/dist/validator.js

@@ -0,0 +1,36 @@
+//#region ../../libs/workflow-composer/dist/validator.js
+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/dist/overlay-customization.js

@@ -1 +1,53 @@
-import{LogLevel as e,Logger as t}from"@lssm/lib.logger";import{defineOverlay as n}from"@lssm/lib.overlay-engine/spec";import{signOverlay as r}from"@lssm/lib.overlay-engine/signer";import{OverlayEngine as i,OverlayRegistry as a}from"@lssm/lib.overlay-engine";const o=new t({level:process.env.NODE_ENV===`production`?e.INFO:e.DEBUG,environment:process.env.NODE_ENV||`development`,enableColors:process.env.NODE_ENV!==`production`});async function s(){let e=new a({allowUnsigned:!0}),t=new i({registry:e}),s=await r(n({overlayId:`demo-overlay`,version:`1.0.0`,appliesTo:{capability:`billing.createOrder`,tenantId:`demo`},modifications:[{type:`hideField`,field:`internalNotes`},{type:`renameLabel`,field:`customerReference`,newLabel:`PO Number`}]}),process.env.PRIVATE_KEY_PEM??``);e.register(s);let c=t.apply({target:{fields:[{key:`customerReference`,label:`Customer Reference`,visible:!0},{key:`internalNotes`,label:`Internal Notes`,visible:!0}]},capability:`billing.createOrder`,tenantId:`demo`});o.info(`Overlay applied`,{fields:c.target.fields})}export{s as runOverlayCustomizationExample};
+import { LogLevel } from "./libs/logger/dist/types.js";
+import { Logger } from "./libs/logger/dist/logger.node.js";
+import "./libs/logger/dist/index.js";
+import { defineOverlay } from "./libs/overlay-engine/dist/spec.js";
+import { signOverlay } from "./libs/overlay-engine/dist/signer.js";
+import { OverlayRegistry } from "./libs/overlay-engine/dist/registry.js";
+import { OverlayEngine } from "./libs/overlay-engine/dist/runtime.js";
+import "./libs/overlay-engine/dist/index.js";
+
+//#region src/overlay-customization.ts
+const logger = new Logger({
+	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
+	environment: process.env.NODE_ENV || "development",
+	enableColors: process.env.NODE_ENV !== "production"
+});
+async function runOverlayCustomizationExample() {
+	const registry = new OverlayRegistry({ allowUnsigned: true });
+	const engine = new OverlayEngine({ registry });
+	const signed = await signOverlay(defineOverlay({
+		overlayId: "demo-overlay",
+		version: "1.0.0",
+		appliesTo: {
+			capability: "billing.createOrder",
+			tenantId: "demo"
+		},
+		modifications: [{
+			type: "hideField",
+			field: "internalNotes"
+		}, {
+			type: "renameLabel",
+			field: "customerReference",
+			newLabel: "PO Number"
+		}]
+	}), process.env.PRIVATE_KEY_PEM ?? "");
+	registry.register(signed);
+	const result = engine.apply({
+		target: { fields: [{
+			key: "customerReference",
+			label: "Customer Reference",
+			visible: true
+		}, {
+			key: "internalNotes",
+			label: "Internal Notes",
+			visible: true
+		}] },
+		capability: "billing.createOrder",
+		tenantId: "demo"
+	});
+	logger.info("Overlay applied", { fields: result.target.fields });
+}
+
+//#endregion
+export { runOverlayCustomizationExample };

package/dist/workflow-extension.js

@@ -1 +1,67 @@
-import{LogLevel as e,Logger as t}from"@lssm/lib.logger";import{WorkflowComposer as n}from"@lssm/lib.workflow-composer";const r=new t({level:process.env.NODE_ENV===`production`?e.INFO:e.DEBUG,environment:process.env.NODE_ENV||`development`,enableColors:process.env.NODE_ENV!==`production`}),i={meta:{name:`billing.invoiceApproval`,version:1,title:`Invoice Approval`,owners:[],tags:[],description:``,domain:`billing`,stability:`stable`},definition:{steps:[{id:`validate-invoice`,type:`automation`,label:`Validate Invoice`},{id:`final-approval`,type:`human`,label:`Final Approval`}],transitions:[{from:`validate-invoice`,to:`final-approval`}]}};function a(){let e=new n;return e.register({workflow:`billing.invoiceApproval`,tenantId:`acme`,customSteps:[{after:`validate-invoice`,inject:{id:`acme-legal`,type:`human`,label:`ACME Legal Review`},transitionTo:`final-approval`}]}),e.compose({base:i,tenantId:`acme`})}function o(e){r.info(`Tenant workflow composed`,{workflow:e.meta.name,steps:e.definition.steps.map(e=>e.id)})}export{a as composeTenantWorkflowExample,o as logTenantWorkflowSteps};
+import { LogLevel } from "./libs/logger/dist/types.js";
+import { Logger } from "./libs/logger/dist/logger.node.js";
+import "./libs/logger/dist/index.js";
+import { WorkflowComposer } from "./libs/workflow-composer/dist/composer.js";
+
+//#region src/workflow-extension.ts
+const logger = new Logger({
+	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
+	environment: process.env.NODE_ENV || "development",
+	enableColors: process.env.NODE_ENV !== "production"
+});
+const BaseWorkflow = {
+	meta: {
+		name: "billing.invoiceApproval",
+		version: 1,
+		title: "Invoice Approval",
+		owners: [],
+		tags: [],
+		description: "",
+		domain: "billing",
+		stability: "stable"
+	},
+	definition: {
+		steps: [{
+			id: "validate-invoice",
+			type: "automation",
+			label: "Validate Invoice"
+		}, {
+			id: "final-approval",
+			type: "human",
+			label: "Final Approval"
+		}],
+		transitions: [{
+			from: "validate-invoice",
+			to: "final-approval"
+		}]
+	}
+};
+function composeTenantWorkflowExample() {
+	const composer = new WorkflowComposer();
+	composer.register({
+		workflow: "billing.invoiceApproval",
+		tenantId: "acme",
+		customSteps: [{
+			after: "validate-invoice",
+			inject: {
+				id: "acme-legal",
+				type: "human",
+				label: "ACME Legal Review"
+			},
+			transitionTo: "final-approval"
+		}]
+	});
+	return composer.compose({
+		base: BaseWorkflow,
+		tenantId: "acme"
+	});
+}
+function logTenantWorkflowSteps(workflow) {
+	logger.info("Tenant workflow composed", {
+		workflow: workflow.meta.name,
+		steps: workflow.definition.steps.map((step) => step.id)
+	});
+}
+
+//#endregion
+export { composeTenantWorkflowExample, logTenantWorkflowSteps };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.personalization",
-  "version": "0.0.0-canary-20251217060834",
+  "version": "0.0.0-canary-20251217072406",
   "description": "Personalization examples: behavior tracking, overlay customization, workflow extension.",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,15 +29,16 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.personalization": "0.0.0-canary-20251217060834",
-    "@lssm/lib.overlay-engine": "0.0.0-canary-20251217060834",
-    "@lssm/lib.workflow-composer": "0.0.0-canary-20251217060834",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217060834",
-    "@lssm/lib.logger": "0.0.0-canary-20251217060834"
+    "@lssm/lib.personalization": "0.0.0-canary-20251217072406",
+    "@lssm/lib.overlay-engine": "0.0.0-canary-20251217072406",
+    "@lssm/lib.workflow-composer": "0.0.0-canary-20251217072406",
+    "@lssm/lib.schema": "0.0.0-canary-20251217072406",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217072406",
+    "@lssm/lib.logger": "0.0.0-canary-20251217072406"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217060834",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217060834",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217072406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217072406",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },