@lssm/example.personalization 0.0.0-canary-20251217080011 → 1.41.0

package/.turbo/turbo-build.log

@@ -1,20 +1,18 @@
-
-$ bun build:bundle && bun build:types
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/personalization/tsdown.config.js (unrun)
-ℹ entry: src/behavior-tracking.ts, src/example.ts, src/index.ts, src/overlay-customization.ts, src/workflow-extension.ts, src/docs/index.ts, src/docs/personalization.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 8 files
-ℹ dist/docs/personalization.docblock.js  1.26 kB │ gzip: 0.63 kB
-ℹ dist/overlay-customization.js          1.09 kB │ gzip: 0.56 kB
-ℹ dist/workflow-extension.js             1.09 kB │ gzip: 0.56 kB
-ℹ dist/behavior-tracking.js              1.01 kB │ gzip: 0.52 kB
-ℹ dist/example.js                        0.58 kB │ gzip: 0.34 kB
-ℹ dist/index.js                          0.45 kB │ gzip: 0.21 kB
-ℹ dist/docs/index.js                     0.04 kB │ gzip: 0.06 kB
-ℹ 7 files, total: 5.51 kB
-✔ Build complete in 70ms
-$ tsc --noEmit
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/personalization/tsdown.config.js 
+ℹ entry: src/behavior-tracking.ts, src/example.ts, src/index.ts, src/overlay-customization.ts, src/workflow-extension.ts, src/docs/index.ts, src/docs/personalization.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/docs/personalization.docblock.js  1.26 kB │ gzip: 0.63 kB
+ℹ dist/overlay-customization.js          1.09 kB │ gzip: 0.56 kB
+ℹ dist/workflow-extension.js             1.09 kB │ gzip: 0.56 kB
+ℹ dist/behavior-tracking.js              1.01 kB │ gzip: 0.52 kB
+ℹ dist/example.js                        0.58 kB │ gzip: 0.34 kB
+ℹ dist/index.js                          0.45 kB │ gzip: 0.21 kB
+ℹ dist/docs/index.js                     0.04 kB │ gzip: 0.06 kB
+ℹ 7 files, total: 5.51 kB
+✔ Build complete in 40ms
+$ tsc --noEmit

package/dist/behavior-tracking.js

@@ -1,49 +1 @@
-import { createBehaviorTracker } from "./libs/personalization/dist/tracker.js";
-import { InMemoryBehaviorStore } from "./libs/personalization/dist/store.js";
-import { BehaviorAnalyzer } from "./libs/personalization/dist/analyzer.js";
-import { LogLevel } from "./libs/logger/dist/types.js";
-import { Logger } from "./libs/logger/dist/logger.node.js";
-import "./libs/logger/dist/index.js";
-
-//#region src/behavior-tracking.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 runBehaviorTrackingExample() {
-	const store = new InMemoryBehaviorStore();
-	const tracker = createBehaviorTracker({
-		store,
-		context: {
-			tenantId: "acme",
-			userId: "user-123"
-		}
-	});
-	tracker.trackFieldAccess({
-		operation: "billing.createOrder",
-		field: "internalNotes"
-	});
-	tracker.trackFieldAccess({
-		operation: "billing.createOrder",
-		field: "customerReference"
-	});
-	tracker.trackFeatureUsage({
-		feature: "workflow-editor",
-		action: "opened"
-	});
-	tracker.trackWorkflowStep({
-		workflow: "invoice-approval",
-		step: "review",
-		status: "entered"
-	});
-	await tracker.flush();
-	const insights = await new BehaviorAnalyzer(store).analyze({
-		tenantId: "acme",
-		userId: "user-123"
-	});
-	logger.info("Behavior insights computed", { insights });
-}
-
-//#endregion
-export { runBehaviorTrackingExample };
+import{createBehaviorTracker as e}from"@lssm/lib.personalization/tracker";import{InMemoryBehaviorStore as t}from"@lssm/lib.personalization/store";import{BehaviorAnalyzer as n}from"@lssm/lib.personalization/analyzer";import{LogLevel as r,Logger as i}from"@lssm/lib.logger";const a=new i({level:process.env.NODE_ENV===`production`?r.INFO:r.DEBUG,environment:process.env.NODE_ENV||`development`,enableColors:process.env.NODE_ENV!==`production`});async function o(){let r=new t,i=e({store:r,context:{tenantId:`acme`,userId:`user-123`}});i.trackFieldAccess({operation:`billing.createOrder`,field:`internalNotes`}),i.trackFieldAccess({operation:`billing.createOrder`,field:`customerReference`}),i.trackFeatureUsage({feature:`workflow-editor`,action:`opened`}),i.trackWorkflowStep({workflow:`invoice-approval`,step:`review`,status:`entered`}),await i.flush();let o=await new n(r).analyze({tenantId:`acme`,userId:`user-123`});a.info(`Behavior insights computed`,{insights:o})}export{o as runBehaviorTrackingExample};

package/dist/docs/index.js

@@ -1 +1 @@
-import "./personalization.docblock.js";
+import"./personalization.docblock.js";

package/dist/docs/personalization.docblock.js

@@ -1,30 +1,9 @@
-import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
-import "../libs/contracts/dist/docs/index.js";
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.examples.personalization`,title:`Personalization Patterns (example)`,summary:`Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.`,kind:`reference`,visibility:`public`,route:`/docs/examples/personalization`,tags:[`personalization`,`overlays`,`workflows`,`example`],body:`## Includes
+- Behavior tracking + insight analysis.
+- Overlay customization (hide fields, rename labels).
+- Workflow extension (inject tenant-specific steps).
 
-//#region src/docs/personalization.docblock.ts
-registerDocBlocks([{
-	id: "docs.examples.personalization",
-	title: "Personalization Patterns (example)",
-	summary: "Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/examples/personalization",
-	tags: [
-		"personalization",
-		"overlays",
-		"workflows",
-		"example"
-	],
-	body: `## Includes\n- Behavior tracking + insight analysis.\n- Overlay customization (hide fields, rename labels).\n- Workflow extension (inject tenant-specific steps).\n\n## Guardrails\n- Keep tracking events structured and non-PII.\n- Keep overlays signed and scoped.\n- Keep workflow composition deterministic.`
-}, {
-	id: "docs.examples.personalization.usage",
-	title: "Personalization — Usage",
-	summary: "How to run the small examples and swap adapters.",
-	kind: "usage",
-	visibility: "public",
-	route: "/docs/examples/personalization/usage",
-	tags: ["personalization", "usage"],
-	body: `## Usage\n- Call \`runBehaviorTrackingExample()\` for insights.\n- Call \`runOverlayCustomizationExample()\` to apply overlays.\n- Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs.`
-}]);
-
-//#endregion
+## Guardrails
+- Keep tracking events structured and non-PII.
+- Keep overlays signed and scoped.
+- Keep workflow composition deterministic.`},{id:`docs.examples.personalization.usage`,title:`Personalization — Usage`,summary:`How to run the small examples and swap adapters.`,kind:`usage`,visibility:`public`,route:`/docs/examples/personalization/usage`,tags:[`personalization`,`usage`],body:"## Usage\n- Call `runBehaviorTrackingExample()` for insights.\n- Call `runOverlayCustomizationExample()` to apply overlays.\n- Call `composeTenantWorkflowExample()` and `logTenantWorkflowSteps()` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs."}]);

package/dist/example.js

@@ -1,38 +1 @@
-//#region src/example.ts
-const example = {
-	id: "personalization",
-	title: "Personalization Patterns",
-	summary: "Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.",
-	tags: [
-		"personalization",
-		"overlays",
-		"behavior",
-		"workflows"
-	],
-	kind: "library",
-	visibility: "public",
-	docs: {
-		rootDocId: "docs.examples.personalization",
-		usageDocId: "docs.examples.personalization.usage"
-	},
-	entrypoints: {
-		packageName: "@lssm/example.personalization",
-		docs: "./docs"
-	},
-	surfaces: {
-		templates: true,
-		sandbox: {
-			enabled: true,
-			modes: ["markdown", "specs"]
-		},
-		studio: {
-			enabled: true,
-			installable: true
-		},
-		mcp: { enabled: true }
-	}
-};
-var example_default = example;
-
-//#endregion
-export { example_default as default };
+var e={id:`personalization`,title:`Personalization Patterns`,summary:`Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.`,tags:[`personalization`,`overlays`,`behavior`,`workflows`],kind:`library`,visibility:`public`,docs:{rootDocId:`docs.examples.personalization`,usageDocId:`docs.examples.personalization.usage`},entrypoints:{packageName:`@lssm/example.personalization`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};

package/dist/index.js

@@ -1,7 +1 @@
-import { runBehaviorTrackingExample } from "./behavior-tracking.js";
-import example_default from "./example.js";
-import { runOverlayCustomizationExample } from "./overlay-customization.js";
-import { composeTenantWorkflowExample, logTenantWorkflowSteps } from "./workflow-extension.js";
-import "./docs/index.js";
-
-export { composeTenantWorkflowExample, example_default as example, logTenantWorkflowSteps, runBehaviorTrackingExample, runOverlayCustomizationExample };
+import{runBehaviorTrackingExample as e}from"./behavior-tracking.js";import t from"./example.js";import{runOverlayCustomizationExample as n}from"./overlay-customization.js";import{composeTenantWorkflowExample as r,logTenantWorkflowSteps as i}from"./workflow-extension.js";import"./docs/index.js";export{r as composeTenantWorkflowExample,t as example,i as logTenantWorkflowSteps,e as runBehaviorTrackingExample,n as runOverlayCustomizationExample};

package/dist/overlay-customization.js

@@ -1,53 +1 @@
-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 };
+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};

package/dist/workflow-extension.js

@@ -1,67 +1 @@
-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 };
+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};

package/package.json

@@ -1,23 +1,21 @@
 {
   "name": "@lssm/example.personalization",
-  "version": "0.0.0-canary-20251217080011",
+  "version": "1.41.0",
   "description": "Personalization examples: behavior tracking, overlay customization, workflow extension.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./behavior-tracking": "./dist/behavior-tracking.js",
-    "./docs": "./dist/docs/index.js",
-    "./docs/personalization.docblock": "./dist/docs/personalization.docblock.js",
-    "./example": "./dist/example.js",
-    "./overlay-customization": "./dist/overlay-customization.js",
-    "./workflow-extension": "./dist/workflow-extension.js",
+    ".": "./src/index.ts",
+    "./behavior-tracking": "./src/behavior-tracking.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/personalization.docblock": "./src/docs/personalization.docblock.ts",
+    "./example": "./src/example.ts",
+    "./overlay-customization": "./src/overlay-customization.ts",
+    "./workflow-extension": "./src/workflow-extension.ts",
     "./*": "./*"
   },
   "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:bundle": "tsdown",
     "build:types": "tsc --noEmit",
@@ -29,16 +27,15 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.personalization": "0.0.0-canary-20251217080011",
-    "@lssm/lib.overlay-engine": "0.0.0-canary-20251217080011",
-    "@lssm/lib.workflow-composer": "0.0.0-canary-20251217080011",
-    "@lssm/lib.schema": "0.0.0-canary-20251217080011",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217080011",
-    "@lssm/lib.logger": "0.0.0-canary-20251217080011"
+    "@lssm/lib.personalization": "workspace:*",
+    "@lssm/lib.overlay-engine": "workspace:*",
+    "@lssm/lib.workflow-composer": "workspace:*",
+    "@lssm/lib.contracts": "workspace:*",
+    "@lssm/lib.logger": "workspace:*"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217080011",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217080011",
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },