@lssm/lib.personalization 1.41.1 → 1.42.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # @lssm/lib.personalization
 
+Website: https://contractspec.lssm.tech/
+
+
 Composable behavior tracking and personalization primitives for ContractSpec applications. The library provides trackers that capture feature usage, analyzers that transform raw events into adaptation hints, and adapters that feed personalized overlays or workflow tweaks.
 
 ## Modules
@@ -15,3 +18,13 @@ See `docs/tech/personalization/behavior-tracking.md` for full usage notes.
 
 
 
+
+
+
+
+
+
+
+
+
+

package/dist/adapter.d.ts

@@ -0,0 +1,22 @@
+import { BehaviorInsights } from "./types.js";
+import { OverlaySpec } from "@lssm/lib.overlay-engine";
+
+//#region src/adapter.d.ts
+interface OverlaySuggestionOptions {
+  overlayId: string;
+  tenantId: string;
+  capability: string;
+  userId?: string;
+  role?: string;
+  version?: string;
+}
+interface WorkflowAdaptation {
+  workflow: string;
+  step: string;
+  note: string;
+}
+declare function insightsToOverlaySuggestion(insights: BehaviorInsights, options: OverlaySuggestionOptions): OverlaySpec | null;
+declare function insightsToWorkflowAdaptations(insights: BehaviorInsights): WorkflowAdaptation[];
+//#endregion
+export { OverlaySuggestionOptions, WorkflowAdaptation, insightsToOverlaySuggestion, insightsToWorkflowAdaptations };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../src/adapter.ts"],"sourcesContent":[],"mappings":";;;;UAMiB,wBAAA;;EAAA,QAAA,EAAA,MAAA;EASA,UAAA,EAAA,MAAA;EAMD,MAAA,CAAA,EAAA,MAAA;EACJ,IAAA,CAAA,EAAA,MAAA;EACD,OAAA,CAAA,EAAA,MAAA;;AACG,UATG,kBAAA,CASH;EAuCE,QAAA,EAAA,MAAA;;;;iBA1CA,2BAAA,WACJ,2BACD,2BACR;iBAuCa,6BAAA,WACJ,mBACT"}

package/dist/adapter.js

@@ -1 +1,42 @@
-function e(e,t){let n=[];return e.suggestedHiddenFields.forEach(e=>{n.push({type:`hideField`,field:e,reason:`Automatically hidden because usage is near zero`})}),e.frequentlyUsedFields.length&&n.push({type:`reorderFields`,fields:e.frequentlyUsedFields}),n.length?{overlayId:t.overlayId,version:t.version??`1.0.0`,appliesTo:{tenantId:t.tenantId,capability:t.capability,userId:t.userId,role:t.role},modifications:n,metadata:{generatedAt:new Date().toISOString(),automated:!0}}:null}function t(e){return e.workflowBottlenecks.map(e=>({workflow:e.workflow,step:e.step,note:`High drop rate (${Math.round(e.dropRate*100)}%) detected`}))}export{e as insightsToOverlaySuggestion,t as insightsToWorkflowAdaptations};
+//#region src/adapter.ts
+function insightsToOverlaySuggestion(insights, options) {
+	const modifications = [];
+	insights.suggestedHiddenFields.forEach((field) => {
+		modifications.push({
+			type: "hideField",
+			field,
+			reason: "Automatically hidden because usage is near zero"
+		});
+	});
+	if (insights.frequentlyUsedFields.length) modifications.push({
+		type: "reorderFields",
+		fields: insights.frequentlyUsedFields
+	});
+	if (!modifications.length) return null;
+	return {
+		overlayId: options.overlayId,
+		version: options.version ?? "1.0.0",
+		appliesTo: {
+			tenantId: options.tenantId,
+			capability: options.capability,
+			userId: options.userId,
+			role: options.role
+		},
+		modifications,
+		metadata: {
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			automated: true
+		}
+	};
+}
+function insightsToWorkflowAdaptations(insights) {
+	return insights.workflowBottlenecks.map((bottleneck) => ({
+		workflow: bottleneck.workflow,
+		step: bottleneck.step,
+		note: `High drop rate (${Math.round(bottleneck.dropRate * 100)}%) detected`
+	}));
+}
+
+//#endregion
+export { insightsToOverlaySuggestion, insightsToWorkflowAdaptations };
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":["modifications: OverlayModification[]"],"sources":["../src/adapter.ts"],"sourcesContent":["import type {\n  OverlayModification,\n  OverlaySpec,\n} from '@lssm/lib.overlay-engine';\nimport type { BehaviorInsights } from './types';\n\nexport interface OverlaySuggestionOptions {\n  overlayId: string;\n  tenantId: string;\n  capability: string;\n  userId?: string;\n  role?: string;\n  version?: string;\n}\n\nexport interface WorkflowAdaptation {\n  workflow: string;\n  step: string;\n  note: string;\n}\n\nexport function insightsToOverlaySuggestion(\n  insights: BehaviorInsights,\n  options: OverlaySuggestionOptions\n): OverlaySpec | null {\n  const modifications: OverlayModification[] = [];\n\n  insights.suggestedHiddenFields.forEach((field) => {\n    modifications.push({\n      type: 'hideField',\n      field,\n      reason: 'Automatically hidden because usage is near zero',\n    });\n  });\n\n  if (insights.frequentlyUsedFields.length) {\n    modifications.push({\n      type: 'reorderFields',\n      fields: insights.frequentlyUsedFields,\n    });\n  }\n\n  if (!modifications.length) {\n    return null;\n  }\n\n  return {\n    overlayId: options.overlayId,\n    version: options.version ?? '1.0.0',\n    appliesTo: {\n      tenantId: options.tenantId,\n      capability: options.capability,\n      userId: options.userId,\n      role: options.role,\n    },\n    modifications,\n    metadata: {\n      generatedAt: new Date().toISOString(),\n      automated: true,\n    },\n  };\n}\n\nexport function insightsToWorkflowAdaptations(\n  insights: BehaviorInsights\n): WorkflowAdaptation[] {\n  return insights.workflowBottlenecks.map((bottleneck) => ({\n    workflow: bottleneck.workflow,\n    step: bottleneck.step,\n    note: `High drop rate (${Math.round(bottleneck.dropRate * 100)}%) detected`,\n  }));\n}\n"],"mappings":";AAqBA,SAAgB,4BACd,UACA,SACoB;CACpB,MAAMA,gBAAuC,EAAE;AAE/C,UAAS,sBAAsB,SAAS,UAAU;AAChD,gBAAc,KAAK;GACjB,MAAM;GACN;GACA,QAAQ;GACT,CAAC;GACF;AAEF,KAAI,SAAS,qBAAqB,OAChC,eAAc,KAAK;EACjB,MAAM;EACN,QAAQ,SAAS;EAClB,CAAC;AAGJ,KAAI,CAAC,cAAc,OACjB,QAAO;AAGT,QAAO;EACL,WAAW,QAAQ;EACnB,SAAS,QAAQ,WAAW;EAC5B,WAAW;GACT,UAAU,QAAQ;GAClB,YAAY,QAAQ;GACpB,QAAQ,QAAQ;GAChB,MAAM,QAAQ;GACf;EACD;EACA,UAAU;GACR,8BAAa,IAAI,MAAM,EAAC,aAAa;GACrC,WAAW;GACZ;EACF;;AAGH,SAAgB,8BACd,UACsB;AACtB,QAAO,SAAS,oBAAoB,KAAK,gBAAgB;EACvD,UAAU,WAAW;EACrB,MAAM,WAAW;EACjB,MAAM,mBAAmB,KAAK,MAAM,WAAW,WAAW,IAAI,CAAC;EAChE,EAAE"}

package/dist/analyzer.d.ts

@@ -0,0 +1,23 @@
+import { BehaviorInsights } from "./types.js";
+import { BehaviorStore } from "./store.js";
+
+//#region src/analyzer.d.ts
+interface BehaviorAnalyzerOptions {
+  fieldInactivityThreshold?: number;
+  minSamples?: number;
+}
+interface AnalyzeParams {
+  tenantId: string;
+  userId?: string;
+  role?: string;
+  windowMs?: number;
+}
+declare class BehaviorAnalyzer {
+  private readonly store;
+  private readonly options;
+  constructor(store: BehaviorStore, options?: BehaviorAnalyzerOptions);
+  analyze(params: AnalyzeParams): Promise<BehaviorInsights>;
+}
+//#endregion
+export { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions };
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","names":[],"sources":["../src/analyzer.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uBAAA;;EAAA,UAAA,CAAA,EAAA,MAAA;AAKjB;AASa,UATI,aAAA,CASY;EAED,QAAA,EAAA,MAAA;EACE,MAAA,CAAA,EAAA,MAAA;EAGN,IAAA,CAAA,EAAA,MAAA;EAAwB,QAAA,CAAA,EAAA,MAAA;;AAAD,cANlC,gBAAA,CAMkC;;;qBAJnB,yBACE;kBAGN,gBAAgB,QAAQ"}

package/dist/analyzer.js

@@ -1 +1,55 @@
-var e=class{constructor(e,t={}){this.store=e,this.options=t}async analyze(e){let n={tenantId:e.tenantId,userId:e.userId,role:e.role};return e.windowMs&&(n.since=Date.now()-e.windowMs),t(await this.store.summarize(n),this.options)}};function t(e,t){let r=t.fieldInactivityThreshold??3,i=t.minSamples??10,a=[],o=[];for(let[t,n]of Object.entries(e.fieldCounts))n<=r&&a.push(t),n>=r*4&&o.push(t);let s=Object.entries(e.workflowStepCounts).flatMap(([e,t])=>{let n=Object.values(t).reduce((e,t)=>e+t,0);return!n||n<i?[]:Object.entries(t).filter(([,e])=>e/n<.4).map(([t,r])=>({workflow:e,step:t,dropRate:1-r/n}))}),c=n(e);return{unusedFields:a,suggestedHiddenFields:a.slice(0,5),frequentlyUsedFields:o.slice(0,10),workflowBottlenecks:s,layoutPreference:c}}function n(e){let t=Object.keys(e.fieldCounts).length;if(t)return t>=15?`table`:t>=8?`grid`:`form`}export{e as BehaviorAnalyzer};
+//#region src/analyzer.ts
+const DEFAULT_THRESHOLD = 3;
+var BehaviorAnalyzer = class {
+	constructor(store, options = {}) {
+		this.store = store;
+		this.options = options;
+	}
+	async analyze(params) {
+		const query = {
+			tenantId: params.tenantId,
+			userId: params.userId,
+			role: params.role
+		};
+		if (params.windowMs) query.since = Date.now() - params.windowMs;
+		return buildInsights(await this.store.summarize(query), this.options);
+	}
+};
+function buildInsights(summary, options) {
+	const threshold = options.fieldInactivityThreshold ?? DEFAULT_THRESHOLD;
+	const minSamples = options.minSamples ?? 10;
+	const ignoredFields = [];
+	const frequentlyUsedFields = [];
+	for (const [field, count] of Object.entries(summary.fieldCounts)) {
+		if (count <= threshold) ignoredFields.push(field);
+		if (count >= threshold * 4) frequentlyUsedFields.push(field);
+	}
+	const workflowBottlenecks = Object.entries(summary.workflowStepCounts).flatMap(([workflow, steps]) => {
+		const total = Object.values(steps).reduce((acc, value) => acc + value, 0);
+		if (!total || total < minSamples) return [];
+		return Object.entries(steps).filter(([, count]) => count / total < .4).map(([step, count]) => ({
+			workflow,
+			step,
+			dropRate: 1 - count / total
+		}));
+	});
+	const layoutPreference = detectLayout(summary);
+	return {
+		unusedFields: ignoredFields,
+		suggestedHiddenFields: ignoredFields.slice(0, 5),
+		frequentlyUsedFields: frequentlyUsedFields.slice(0, 10),
+		workflowBottlenecks,
+		layoutPreference
+	};
+}
+function detectLayout(summary) {
+	const fieldCount = Object.keys(summary.fieldCounts).length;
+	if (!fieldCount) return;
+	if (fieldCount >= 15) return "table";
+	if (fieldCount >= 8) return "grid";
+	return "form";
+}
+
+//#endregion
+export { BehaviorAnalyzer };
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":["store: BehaviorStore","options: BehaviorAnalyzerOptions","query: BehaviorQuery","ignoredFields: string[]","frequentlyUsedFields: string[]"],"sources":["../src/analyzer.ts"],"sourcesContent":["import type { BehaviorStore } from './store';\nimport type { BehaviorInsights, BehaviorQuery, BehaviorSummary } from './types';\n\nexport interface BehaviorAnalyzerOptions {\n  fieldInactivityThreshold?: number;\n  minSamples?: number;\n}\n\nexport interface AnalyzeParams {\n  tenantId: string;\n  userId?: string;\n  role?: string;\n  windowMs?: number;\n}\n\nconst DEFAULT_THRESHOLD = 3;\n\nexport class BehaviorAnalyzer {\n  constructor(\n    private readonly store: BehaviorStore,\n    private readonly options: BehaviorAnalyzerOptions = {}\n  ) {}\n\n  async analyze(params: AnalyzeParams): Promise<BehaviorInsights> {\n    const query: BehaviorQuery = {\n      tenantId: params.tenantId,\n      userId: params.userId,\n      role: params.role,\n    };\n\n    if (params.windowMs) {\n      query.since = Date.now() - params.windowMs;\n    }\n\n    const summary = await this.store.summarize(query);\n    return buildInsights(summary, this.options);\n  }\n}\n\nfunction buildInsights(\n  summary: BehaviorSummary,\n  options: BehaviorAnalyzerOptions\n): BehaviorInsights {\n  const threshold = options.fieldInactivityThreshold ?? DEFAULT_THRESHOLD;\n  const minSamples = options.minSamples ?? 10;\n\n  const ignoredFields: string[] = [];\n  const frequentlyUsedFields: string[] = [];\n\n  for (const [field, count] of Object.entries(summary.fieldCounts)) {\n    if (count <= threshold) {\n      ignoredFields.push(field);\n    }\n    if (count >= threshold * 4) {\n      frequentlyUsedFields.push(field);\n    }\n  }\n\n  const workflowBottlenecks = Object.entries(\n    summary.workflowStepCounts\n  ).flatMap(([workflow, steps]) => {\n    const total = Object.values(steps).reduce((acc, value) => acc + value, 0);\n    if (!total || total < minSamples) {\n      return [];\n    }\n    return Object.entries(steps)\n      .filter(([, count]) => count / total < 0.4)\n      .map(([step, count]) => ({\n        workflow,\n        step,\n        dropRate: 1 - count / total,\n      }));\n  });\n\n  const layoutPreference = detectLayout(summary);\n\n  return {\n    unusedFields: ignoredFields,\n    suggestedHiddenFields: ignoredFields.slice(0, 5),\n    frequentlyUsedFields: frequentlyUsedFields.slice(0, 10),\n    workflowBottlenecks,\n    layoutPreference,\n  };\n}\n\nfunction detectLayout(\n  summary: BehaviorSummary\n): BehaviorInsights['layoutPreference'] {\n  const fieldCount = Object.keys(summary.fieldCounts).length;\n  if (!fieldCount) {\n    return undefined;\n  }\n\n  if (fieldCount >= 15) {\n    return 'table';\n  }\n  if (fieldCount >= 8) {\n    return 'grid';\n  }\n  return 'form';\n}\n"],"mappings":";AAeA,MAAM,oBAAoB;AAE1B,IAAa,mBAAb,MAA8B;CAC5B,YACE,AAAiBA,OACjB,AAAiBC,UAAmC,EAAE,EACtD;EAFiB;EACA;;CAGnB,MAAM,QAAQ,QAAkD;EAC9D,MAAMC,QAAuB;GAC3B,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf,MAAM,OAAO;GACd;AAED,MAAI,OAAO,SACT,OAAM,QAAQ,KAAK,KAAK,GAAG,OAAO;AAIpC,SAAO,cADS,MAAM,KAAK,MAAM,UAAU,MAAM,EACnB,KAAK,QAAQ;;;AAI/C,SAAS,cACP,SACA,SACkB;CAClB,MAAM,YAAY,QAAQ,4BAA4B;CACtD,MAAM,aAAa,QAAQ,cAAc;CAEzC,MAAMC,gBAA0B,EAAE;CAClC,MAAMC,uBAAiC,EAAE;AAEzC,MAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,QAAQ,YAAY,EAAE;AAChE,MAAI,SAAS,UACX,eAAc,KAAK,MAAM;AAE3B,MAAI,SAAS,YAAY,EACvB,sBAAqB,KAAK,MAAM;;CAIpC,MAAM,sBAAsB,OAAO,QACjC,QAAQ,mBACT,CAAC,SAAS,CAAC,UAAU,WAAW;EAC/B,MAAM,QAAQ,OAAO,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,MAAM,OAAO,EAAE;AACzE,MAAI,CAAC,SAAS,QAAQ,WACpB,QAAO,EAAE;AAEX,SAAO,OAAO,QAAQ,MAAM,CACzB,QAAQ,GAAG,WAAW,QAAQ,QAAQ,GAAI,CAC1C,KAAK,CAAC,MAAM,YAAY;GACvB;GACA;GACA,UAAU,IAAI,QAAQ;GACvB,EAAE;GACL;CAEF,MAAM,mBAAmB,aAAa,QAAQ;AAE9C,QAAO;EACL,cAAc;EACd,uBAAuB,cAAc,MAAM,GAAG,EAAE;EAChD,sBAAsB,qBAAqB,MAAM,GAAG,GAAG;EACvD;EACA;EACD;;AAGH,SAAS,aACP,SACsC;CACtC,MAAM,aAAa,OAAO,KAAK,QAAQ,YAAY,CAAC;AACpD,KAAI,CAAC,WACH;AAGF,KAAI,cAAc,GAChB,QAAO;AAET,KAAI,cAAc,EAChB,QAAO;AAET,QAAO"}

package/dist/docs/behavior-tracking.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/behavior-tracking.docblock.d.ts
+declare const personalization_behavior_tracking_DocBlocks: DocBlock[];
+//#endregion
+export { personalization_behavior_tracking_DocBlocks };
+//# sourceMappingURL=behavior-tracking.docblock.d.ts.map

package/dist/docs/behavior-tracking.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-tracking.docblock.d.ts","names":[],"sources":["../../src/docs/behavior-tracking.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,6CAA6C"}

package/dist/docs/behavior-tracking.docblock.js

@@ -1,80 +1,18 @@
-import{registerDocBlocks as e}from"../contracts/src/docs/registry.js";import"../contracts/src/docs/index.js";const t=[{id:`docs.personalization.behavior-tracking`,title:`Behavior Tracking`,summary:"`@lssm/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",kind:`reference`,visibility:`public`,route:`/docs/personalization/behavior-tracking`,tags:[`personalization`,`behavior-tracking`],body:`# Behavior Tracking
-
-\`@lssm/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
-
-## Tracker
-
-\`\`\`ts
-import { createBehaviorTracker } from '@lssm/lib.personalization';
-import { InMemoryBehaviorStore } from '@lssm/lib.personalization/store';
-
-const tracker = createBehaviorTracker({
-  store: new InMemoryBehaviorStore(),
-  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },
-  autoFlushIntervalMs: 5000,
-});
-
-tracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });
-tracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });
-tracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });
-\`\`\`
-
-All events are buffered and flushed either when the buffer hits 25 entries or when \`autoFlushIntervalMs\` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.
-
-## Analyzer
-
-\`\`\`ts
-import { BehaviorAnalyzer } from '@lssm/lib.personalization/analyzer';
-
-const analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });
-const insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });
-
-/*
-{
-  unusedFields: ['internalNotes'],
-  suggestedHiddenFields: ['internalNotes'],
-  frequentlyUsedFields: ['customerReference', 'items'],
-  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],
-  layoutPreference: 'table'
-}
-*/
-\`\`\`
-
-Use the analyzer output with the overlay adapter to generate suggestions automatically.
-
-## Adapter
-
-\`\`\`ts
-import { insightsToOverlaySuggestion } from '@lssm/lib.personalization/adapter';
-
-const overlay = insightsToOverlaySuggestion(insights, {
-  overlayId: 'acme-order-form',
-  tenantId: 'acme',
-  capability: 'billing.createOrder',
-});
-\`\`\`
-
-When the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];e(t);export{t as personalization_behavior_tracking_DocBlocks};
+import { registerDocBlocks } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/behavior-tracking.docblock.ts
+const personalization_behavior_tracking_DocBlocks = [{
+	id: "docs.personalization.behavior-tracking",
+	title: "Behavior Tracking",
+	summary: "`@lssm/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/personalization/behavior-tracking",
+	tags: ["personalization", "behavior-tracking"],
+	body: "# Behavior Tracking\n\n`@lssm/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.\n\n## Tracker\n\n```ts\nimport { createBehaviorTracker } from '@lssm/lib.personalization';\nimport { InMemoryBehaviorStore } from '@lssm/lib.personalization/store';\n\nconst tracker = createBehaviorTracker({\n  store: new InMemoryBehaviorStore(),\n  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },\n  autoFlushIntervalMs: 5000,\n});\n\ntracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });\ntracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });\ntracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });\n```\n\nAll events are buffered and flushed either when the buffer hits 25 entries or when `autoFlushIntervalMs` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.\n\n## Analyzer\n\n```ts\nimport { BehaviorAnalyzer } from '@lssm/lib.personalization/analyzer';\n\nconst analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });\nconst insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });\n\n/*\n{\n  unusedFields: ['internalNotes'],\n  suggestedHiddenFields: ['internalNotes'],\n  frequentlyUsedFields: ['customerReference', 'items'],\n  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],\n  layoutPreference: 'table'\n}\n*/\n```\n\nUse the analyzer output with the overlay adapter to generate suggestions automatically.\n\n## Adapter\n\n```ts\nimport { insightsToOverlaySuggestion } from '@lssm/lib.personalization/adapter';\n\nconst overlay = insightsToOverlaySuggestion(insights, {\n  overlayId: 'acme-order-form',\n  tenantId: 'acme',\n  capability: 'billing.createOrder',\n});\n```\n\nWhen the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(personalization_behavior_tracking_DocBlocks);
+
+//#endregion
+export { personalization_behavior_tracking_DocBlocks };
+//# sourceMappingURL=behavior-tracking.docblock.js.map

package/dist/docs/behavior-tracking.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-tracking.docblock.js","names":["personalization_behavior_tracking_DocBlocks: DocBlock[]"],"sources":["../../src/docs/behavior-tracking.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/lib.contracts/docs';\n\nexport const personalization_behavior_tracking_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.personalization.behavior-tracking',\n    title: 'Behavior Tracking',\n    summary:\n      '`@lssm/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/personalization/behavior-tracking',\n    tags: ['personalization', 'behavior-tracking'],\n    body: \"# Behavior Tracking\\n\\n`@lssm/lib.personalization` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.\\n\\n## Tracker\\n\\n```ts\\nimport { createBehaviorTracker } from '@lssm/lib.personalization';\\nimport { InMemoryBehaviorStore } from '@lssm/lib.personalization/store';\\n\\nconst tracker = createBehaviorTracker({\\n  store: new InMemoryBehaviorStore(),\\n  context: { tenantId: ctx.tenant.id, userId: ctx.identity.userId },\\n  autoFlushIntervalMs: 5000,\\n});\\n\\ntracker.trackFieldAccess({ operation: 'billing.createOrder', field: 'internalNotes' });\\ntracker.trackFeatureUsage({ feature: 'workflow-editor', action: 'opened' });\\ntracker.trackWorkflowStep({ workflow: 'invoice-approval', step: 'review', status: 'entered' });\\n```\\n\\nAll events are buffered and flushed either when the buffer hits 25 entries or when `autoFlushIntervalMs` elapses. Tracked metrics flow to OpenTelemetry via the meter/counter built into the tracker.\\n\\n## Analyzer\\n\\n```ts\\nimport { BehaviorAnalyzer } from '@lssm/lib.personalization/analyzer';\\n\\nconst analyzer = new BehaviorAnalyzer(store, { fieldInactivityThreshold: 2 });\\nconst insights = await analyzer.analyze({ tenantId: 'acme', userId: 'manager-42', windowMs: 7 * 24 * 60 * 60 * 1000 });\\n\\n/*\\n{\\n  unusedFields: ['internalNotes'],\\n  suggestedHiddenFields: ['internalNotes'],\\n  frequentlyUsedFields: ['customerReference', 'items'],\\n  workflowBottlenecks: [{ workflow: 'invoice-approval', step: 'finance-review', dropRate: 0.6 }],\\n  layoutPreference: 'table'\\n}\\n*/\\n```\\n\\nUse the analyzer output with the overlay adapter to generate suggestions automatically.\\n\\n## Adapter\\n\\n```ts\\nimport { insightsToOverlaySuggestion } from '@lssm/lib.personalization/adapter';\\n\\nconst overlay = insightsToOverlaySuggestion(insights, {\\n  overlayId: 'acme-order-form',\\n  tenantId: 'acme',\\n  capability: 'billing.createOrder',\\n});\\n```\\n\\nWhen the adapter returns an overlay spec, pass it to the overlay engine to register or sign it.\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\n  },\n];\nregisterDocBlocks(personalization_behavior_tracking_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,8CAA0D,CACrE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,oBAAoB;CAC9C,MAAM;CACP,CACF;AACD,kBAAkB,4CAA4C"}

package/dist/docs/index.d.ts

@@ -0,0 +1,3 @@
+import "./behavior-tracking.docblock.js";
+import "./overlay-engine.docblock.js";
+import "./workflow-composition.docblock.js";

package/dist/docs/index.js

@@ -1 +1,3 @@
-import"./behavior-tracking.docblock.js";import"./overlay-engine.docblock.js";import"./workflow-composition.docblock.js";
+import "./behavior-tracking.docblock.js";
+import "./overlay-engine.docblock.js";
+import "./workflow-composition.docblock.js";

package/dist/docs/overlay-engine.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/overlay-engine.docblock.d.ts
+declare const personalization_overlay_engine_DocBlocks: DocBlock[];
+//#endregion
+export { personalization_overlay_engine_DocBlocks };
+//# sourceMappingURL=overlay-engine.docblock.d.ts.map

package/dist/docs/overlay-engine.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.docblock.d.ts","names":[],"sources":["../../src/docs/overlay-engine.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,0CAA0C"}

package/dist/docs/overlay-engine.docblock.js

@@ -1,81 +1,18 @@
-import{registerDocBlocks as e}from"../contracts/src/docs/registry.js";import"../contracts/src/docs/index.js";const t=[{id:`docs.personalization.overlay-engine`,title:`Overlay Engine`,summary:"`@lssm/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",kind:`reference`,visibility:`public`,route:`/docs/personalization/overlay-engine`,tags:[`personalization`,`overlay-engine`],body:`# Overlay Engine
-
-\`@lssm/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
-
-## Key APIs
-
-- \`defineOverlay(spec)\` – helper to keep specs typed.
-- \`OverlayRegistry\` – register signed overlays and retrieve them per context.
-- \`OverlayEngine\` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.
-- \`signOverlay(spec, privateKey)\` – Ed25519/RSA-PSS signer.
-- \`verifyOverlaySignature(overlay)\` – verify public key signatures.
-- \`useOverlay(engine, params)\` – client hook that returns \`{ target, overlaysApplied }\`.
-
-## Scope Precedence
-
-Registrations are sorted by specificity:
-
-1. Tenant overlays
-2. Role overlays
-3. User overlays
-4. Device overlays
-
-Less specific overlays run first; more specific overlays override later.
-
-## Example
-
-\`\`\`ts
-const registry = new OverlayRegistry();
-const engine = new OverlayEngine({
-  registry,
-  audit: (event) => auditLogService.record(event),
-});
-
-const overlay = defineOverlay({
-  overlayId: 'acme-order-form',
-  version: '1.0.0',
-  appliesTo: {
-    capability: 'billing.createOrder',
-    tenantId: 'acme',
-  },
-  modifications: [
-    { type: 'hideField', field: 'internalNotes' },
-    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },
-  ],
-});
-
-const signedOverlay = await signOverlay(overlay, privateKeyPem);
-registry.register(signedOverlay);
-
-const result = engine.apply({
-  target: { fields: baseFields },
-  capability: 'billing.createOrder',
-  tenantId: 'acme',
-  userId: 'manager-7',
-});
-\`\`\`
-
-\`result.target.fields\` now carries the hidden and renamed outputs ready for rendering.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];e(t);export{t as personalization_overlay_engine_DocBlocks};
+import { registerDocBlocks } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/overlay-engine.docblock.ts
+const personalization_overlay_engine_DocBlocks = [{
+	id: "docs.personalization.overlay-engine",
+	title: "Overlay Engine",
+	summary: "`@lssm/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/personalization/overlay-engine",
+	tags: ["personalization", "overlay-engine"],
+	body: "# Overlay Engine\n\n`@lssm/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.\n\n## Key APIs\n\n- `defineOverlay(spec)` – helper to keep specs typed.\n- `OverlayRegistry` – register signed overlays and retrieve them per context.\n- `OverlayEngine` – apply overlays to renderable targets, emit audit events, and merge modifications deterministically.\n- `signOverlay(spec, privateKey)` – Ed25519/RSA-PSS signer.\n- `verifyOverlaySignature(overlay)` – verify public key signatures.\n- `useOverlay(engine, params)` – client hook that returns `{ target, overlaysApplied }`.\n\n## Scope Precedence\n\nRegistrations are sorted by specificity:\n\n1. Tenant overlays\n2. Role overlays\n3. User overlays\n4. Device overlays\n\nLess specific overlays run first; more specific overlays override later.\n\n## Example\n\n```ts\nconst registry = new OverlayRegistry();\nconst engine = new OverlayEngine({\n  registry,\n  audit: (event) => auditLogService.record(event),\n});\n\nconst overlay = defineOverlay({\n  overlayId: 'acme-order-form',\n  version: '1.0.0',\n  appliesTo: {\n    capability: 'billing.createOrder',\n    tenantId: 'acme',\n  },\n  modifications: [\n    { type: 'hideField', field: 'internalNotes' },\n    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },\n  ],\n});\n\nconst signedOverlay = await signOverlay(overlay, privateKeyPem);\nregistry.register(signedOverlay);\n\nconst result = engine.apply({\n  target: { fields: baseFields },\n  capability: 'billing.createOrder',\n  tenantId: 'acme',\n  userId: 'manager-7',\n});\n```\n\n`result.target.fields` now carries the hidden and renamed outputs ready for rendering.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(personalization_overlay_engine_DocBlocks);
+
+//#endregion
+export { personalization_overlay_engine_DocBlocks };
+//# sourceMappingURL=overlay-engine.docblock.js.map

package/dist/docs/overlay-engine.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.docblock.js","names":["personalization_overlay_engine_DocBlocks: DocBlock[]"],"sources":["../../src/docs/overlay-engine.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/lib.contracts/docs';\n\nexport const personalization_overlay_engine_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.personalization.overlay-engine',\n    title: 'Overlay Engine',\n    summary:\n      '`@lssm/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/personalization/overlay-engine',\n    tags: ['personalization', 'overlay-engine'],\n    body: \"# Overlay Engine\\n\\n`@lssm/lib.overlay-engine` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.\\n\\n## Key APIs\\n\\n- `defineOverlay(spec)` \\u2013 helper to keep specs typed.\\n- `OverlayRegistry` \\u2013 register signed overlays and retrieve them per context.\\n- `OverlayEngine` \\u2013 apply overlays to renderable targets, emit audit events, and merge modifications deterministically.\\n- `signOverlay(spec, privateKey)` \\u2013 Ed25519/RSA-PSS signer.\\n- `verifyOverlaySignature(overlay)` \\u2013 verify public key signatures.\\n- `useOverlay(engine, params)` \\u2013 client hook that returns `{ target, overlaysApplied }`.\\n\\n## Scope Precedence\\n\\nRegistrations are sorted by specificity:\\n\\n1. Tenant overlays\\n2. Role overlays\\n3. User overlays\\n4. Device overlays\\n\\nLess specific overlays run first; more specific overlays override later.\\n\\n## Example\\n\\n```ts\\nconst registry = new OverlayRegistry();\\nconst engine = new OverlayEngine({\\n  registry,\\n  audit: (event) => auditLogService.record(event),\\n});\\n\\nconst overlay = defineOverlay({\\n  overlayId: 'acme-order-form',\\n  version: '1.0.0',\\n  appliesTo: {\\n    capability: 'billing.createOrder',\\n    tenantId: 'acme',\\n  },\\n  modifications: [\\n    { type: 'hideField', field: 'internalNotes' },\\n    { type: 'renameLabel', field: 'customerReference', newLabel: 'PO Number' },\\n  ],\\n});\\n\\nconst signedOverlay = await signOverlay(overlay, privateKeyPem);\\nregistry.register(signedOverlay);\\n\\nconst result = engine.apply({\\n  target: { fields: baseFields },\\n  capability: 'billing.createOrder',\\n  tenantId: 'acme',\\n  userId: 'manager-7',\\n});\\n```\\n\\n`result.target.fields` now carries the hidden and renamed outputs ready for rendering.\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\n  },\n];\nregisterDocBlocks(personalization_overlay_engine_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,2CAAuD,CAClE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,iBAAiB;CAC3C,MAAM;CACP,CACF;AACD,kBAAkB,yCAAyC"}

package/dist/docs/workflow-composition.docblock.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/workflow-composition.docblock.d.ts
+declare const personalization_workflow_composition_DocBlocks: DocBlock[];
+//#endregion
+export { personalization_workflow_composition_DocBlocks };
+//# sourceMappingURL=workflow-composition.docblock.d.ts.map

package/dist/docs/workflow-composition.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-composition.docblock.d.ts","names":[],"sources":["../../src/docs/workflow-composition.docblock.ts"],"sourcesContent":[],"mappings":";;;cAGa,gDAAgD"}

package/dist/docs/workflow-composition.docblock.js

@@ -1,66 +1,18 @@
-import{registerDocBlocks as e}from"../contracts/src/docs/registry.js";import"../contracts/src/docs/index.js";const t=[{id:`docs.personalization.workflow-composition`,title:`Workflow Composition`,summary:"`@lssm/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.",kind:`reference`,visibility:`public`,route:`/docs/personalization/workflow-composition`,tags:[`personalization`,`workflow-composition`],body:`# Workflow Composition
-
-\`@lssm/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
-
-## Extensions
-
-\`\`\`ts
-import { WorkflowComposer } from '@lssm/lib.workflow-composer';
-import { approvalStepTemplate } from '@lssm/lib.workflow-composer/templates';
-
-const composer = new WorkflowComposer();
-
-composer.register({
-  workflow: 'billing.invoiceApproval',
-  tenantId: 'acme',
-  priority: 10,
-  customSteps: [
-    {
-      after: 'validate-invoice',
-      inject: approvalStepTemplate({
-        id: 'acme-legal-review',
-        label: 'Legal Review (ACME)',
-        description: 'Tenant-specific compliance step.',
-      }),
-      transitionTo: 'final-approval',
-    },
-  ],
-  hiddenSteps: ['internal-audit'],
-});
-\`\`\`
-
-## Compose
-
-\`\`\`ts
-const runtimeSpec = composer.compose({
-  base: BaseInvoiceWorkflow,
-  tenantId: 'acme',
-});
-
-workflowRunner.execute(runtimeSpec, ctx);
-\`\`\`
-
-The composer uses anchor references (\`after\`/\`before\`) to place injected steps and cleans up transitions when steps are hidden.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-`}];e(t);export{t as personalization_workflow_composition_DocBlocks};
+import { registerDocBlocks } from "@lssm/lib.contracts/docs";
+
+//#region src/docs/workflow-composition.docblock.ts
+const personalization_workflow_composition_DocBlocks = [{
+	id: "docs.personalization.workflow-composition",
+	title: "Workflow Composition",
+	summary: "`@lssm/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/personalization/workflow-composition",
+	tags: ["personalization", "workflow-composition"],
+	body: "# Workflow Composition\n\n`@lssm/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.\n\n## Extensions\n\n```ts\nimport { WorkflowComposer } from '@lssm/lib.workflow-composer';\nimport { approvalStepTemplate } from '@lssm/lib.workflow-composer/templates';\n\nconst composer = new WorkflowComposer();\n\ncomposer.register({\n  workflow: 'billing.invoiceApproval',\n  tenantId: 'acme',\n  priority: 10,\n  customSteps: [\n    {\n      after: 'validate-invoice',\n      inject: approvalStepTemplate({\n        id: 'acme-legal-review',\n        label: 'Legal Review (ACME)',\n        description: 'Tenant-specific compliance step.',\n      }),\n      transitionTo: 'final-approval',\n    },\n  ],\n  hiddenSteps: ['internal-audit'],\n});\n```\n\n## Compose\n\n```ts\nconst runtimeSpec = composer.compose({\n  base: BaseInvoiceWorkflow,\n  tenantId: 'acme',\n});\n\nworkflowRunner.execute(runtimeSpec, ctx);\n```\n\nThe composer uses anchor references (`after`/`before`) to place injected steps and cleans up transitions when steps are hidden.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
+}];
+registerDocBlocks(personalization_workflow_composition_DocBlocks);
+
+//#endregion
+export { personalization_workflow_composition_DocBlocks };
+//# sourceMappingURL=workflow-composition.docblock.js.map

package/dist/docs/workflow-composition.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-composition.docblock.js","names":["personalization_workflow_composition_DocBlocks: DocBlock[]"],"sources":["../../src/docs/workflow-composition.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/lib.contracts/docs';\n\nexport const personalization_workflow_composition_DocBlocks: DocBlock[] = [\n  {\n    id: 'docs.personalization.workflow-composition',\n    title: 'Workflow Composition',\n    summary:\n      '`@lssm/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/personalization/workflow-composition',\n    tags: ['personalization', 'workflow-composition'],\n    body: \"# Workflow Composition\\n\\n`@lssm/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions.\\n\\n## Extensions\\n\\n```ts\\nimport { WorkflowComposer } from '@lssm/lib.workflow-composer';\\nimport { approvalStepTemplate } from '@lssm/lib.workflow-composer/templates';\\n\\nconst composer = new WorkflowComposer();\\n\\ncomposer.register({\\n  workflow: 'billing.invoiceApproval',\\n  tenantId: 'acme',\\n  priority: 10,\\n  customSteps: [\\n    {\\n      after: 'validate-invoice',\\n      inject: approvalStepTemplate({\\n        id: 'acme-legal-review',\\n        label: 'Legal Review (ACME)',\\n        description: 'Tenant-specific compliance step.',\\n      }),\\n      transitionTo: 'final-approval',\\n    },\\n  ],\\n  hiddenSteps: ['internal-audit'],\\n});\\n```\\n\\n## Compose\\n\\n```ts\\nconst runtimeSpec = composer.compose({\\n  base: BaseInvoiceWorkflow,\\n  tenantId: 'acme',\\n});\\n\\nworkflowRunner.execute(runtimeSpec, ctx);\\n```\\n\\nThe composer uses anchor references (`after`/`before`) to place injected steps and cleans up transitions when steps are hidden.\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\\n\",\n  },\n];\nregisterDocBlocks(personalization_workflow_composition_DocBlocks);\n"],"mappings":";;;AAGA,MAAaA,iDAA6D,CACxE;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,mBAAmB,uBAAuB;CACjD,MAAM;CACP,CACF;AACD,kBAAkB,+CAA+C"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorSummary, FeatureUsageEvent, FieldAccessEvent, WorkflowStepEvent } from "./types.js";
+import { OverlaySuggestionOptions, WorkflowAdaptation, insightsToOverlaySuggestion, insightsToWorkflowAdaptations } from "./adapter.js";
+import { BehaviorStore, InMemoryBehaviorStore } from "./store.js";
+import { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions } from "./analyzer.js";
+import "./docs/index.js";
+import { BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, createBehaviorTracker } from "./tracker.js";
+export { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions, BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorStore, BehaviorSummary, BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, FeatureUsageEvent, FieldAccessEvent, InMemoryBehaviorStore, OverlaySuggestionOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, WorkflowAdaptation, WorkflowStepEvent, createBehaviorTracker, insightsToOverlaySuggestion, insightsToWorkflowAdaptations };

package/dist/index.js

@@ -1 +1,7 @@
-import{insightsToOverlaySuggestion as e,insightsToWorkflowAdaptations as t}from"./adapter.js";import{BehaviorAnalyzer as n}from"./analyzer.js";import{InMemoryBehaviorStore as r}from"./store.js";import{BehaviorTracker as i,createBehaviorTracker as a}from"./tracker.js";import"./docs/index.js";export{n as BehaviorAnalyzer,i as BehaviorTracker,r as InMemoryBehaviorStore,a as createBehaviorTracker,e as insightsToOverlaySuggestion,t as insightsToWorkflowAdaptations};
+import { insightsToOverlaySuggestion, insightsToWorkflowAdaptations } from "./adapter.js";
+import { BehaviorAnalyzer } from "./analyzer.js";
+import { InMemoryBehaviorStore } from "./store.js";
+import { BehaviorTracker, createBehaviorTracker } from "./tracker.js";
+import "./docs/index.js";
+
+export { BehaviorAnalyzer, BehaviorTracker, InMemoryBehaviorStore, createBehaviorTracker, insightsToOverlaySuggestion, insightsToWorkflowAdaptations };

package/dist/store.d.ts

@@ -0,0 +1,21 @@
+import { BehaviorEvent, BehaviorQuery, BehaviorSummary } from "./types.js";
+
+//#region src/store.d.ts
+interface BehaviorStore {
+  record(event: BehaviorEvent): Promise<void> | void;
+  bulkRecord(events: BehaviorEvent[]): Promise<void> | void;
+  query(query: BehaviorQuery): Promise<BehaviorEvent[]>;
+  summarize(query: BehaviorQuery): Promise<BehaviorSummary>;
+  clear?(): Promise<void> | void;
+}
+declare class InMemoryBehaviorStore implements BehaviorStore {
+  private events;
+  record(event: BehaviorEvent): Promise<void>;
+  bulkRecord(events: BehaviorEvent[]): Promise<void>;
+  query(query: BehaviorQuery): Promise<BehaviorEvent[]>;
+  summarize(query: BehaviorQuery): Promise<BehaviorSummary>;
+  clear(): Promise<void>;
+}
+//#endregion
+export { BehaviorStore, InMemoryBehaviorStore };
+//# sourceMappingURL=store.d.ts.map