@lssm/lib.personalization 0.0.0-canary-20251207013726 → 0.0.0-canary-20251207043720

package/README.md

@@ -14,3 +14,4 @@ See `docs/tech/personalization/behavior-tracking.md` for full usage notes.
 
 
 
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.personalization",
-  "version": "0.0.0-canary-20251207013726",
+  "version": "0.0.0-canary-20251207043720",
   "description": "Behavior tracking, analysis, and adaptation helpers for ContractSpec personalization.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,10 +37,14 @@
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./dist/index.js",
+    ".": "./src/index.ts",
     "./*": "./*"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    }
   }
 }

package/dist/adapter.d.ts

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

package/dist/analyzer.d.ts

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

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-import { BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorSummary, FeatureUsageEvent, FieldAccessEvent, WorkflowStepEvent } from "./types.js";
-import { BehaviorStore, InMemoryBehaviorStore } from "./store.js";
-import { BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, createBehaviorTracker } from "./tracker.js";
-import { AnalyzeParams, BehaviorAnalyzer, BehaviorAnalyzerOptions } from "./analyzer.js";
-import { OverlaySuggestionOptions, WorkflowAdaptation, insightsToOverlaySuggestion, insightsToWorkflowAdaptations } from "./adapter.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/store.d.ts

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

package/dist/tracker.d.ts

@@ -1,52 +0,0 @@
-import { BehaviorStore } from "./store.js";
-
-//#region src/tracker.d.ts
-interface BehaviorTrackerContext {
-  tenantId: string;
-  userId?: string;
-  role?: string;
-  device?: string;
-  metadata?: Record<string, unknown>;
-}
-interface BehaviorTrackerOptions {
-  store: BehaviorStore;
-  context: BehaviorTrackerContext;
-  tracerName?: string;
-  autoFlushIntervalMs?: number;
-  bufferSize?: number;
-}
-interface TrackFieldAccessInput {
-  operation: string;
-  field: string;
-  metadata?: Record<string, unknown>;
-}
-interface TrackFeatureUsageInput {
-  feature: string;
-  action: 'opened' | 'completed' | 'dismissed';
-  metadata?: Record<string, unknown>;
-}
-interface TrackWorkflowStepInput {
-  workflow: string;
-  step: string;
-  status: 'entered' | 'completed' | 'skipped' | 'errored';
-  metadata?: Record<string, unknown>;
-}
-declare class BehaviorTracker {
-  private readonly store;
-  private readonly context;
-  private readonly tracer;
-  private readonly counter;
-  private buffer;
-  private readonly bufferSize;
-  private flushTimer?;
-  constructor(options: BehaviorTrackerOptions);
-  trackFieldAccess(input: TrackFieldAccessInput): void;
-  trackFeatureUsage(input: TrackFeatureUsageInput): void;
-  trackWorkflowStep(input: TrackWorkflowStepInput): void;
-  flush(): Promise<void>;
-  dispose(): Promise<void>;
-  private enqueue;
-}
-declare const createBehaviorTracker: (options: BehaviorTrackerOptions) => BehaviorTracker;
-//#endregion
-export { BehaviorTracker, BehaviorTrackerContext, BehaviorTrackerOptions, TrackFeatureUsageInput, TrackFieldAccessInput, TrackWorkflowStepInput, createBehaviorTracker };

package/dist/types.d.ts

@@ -1,58 +0,0 @@
-//#region src/types.d.ts
-type BehaviorEventType = 'field_access' | 'feature_usage' | 'workflow_step';
-interface BehaviorEventBase {
-  id?: string;
-  tenantId: string;
-  userId?: string;
-  role?: string;
-  device?: string;
-  timestamp: number;
-  metadata?: Record<string, unknown>;
-}
-interface FieldAccessEvent extends BehaviorEventBase {
-  type: 'field_access';
-  operation: string;
-  field: string;
-}
-interface FeatureUsageEvent extends BehaviorEventBase {
-  type: 'feature_usage';
-  feature: string;
-  action: 'opened' | 'completed' | 'dismissed';
-}
-interface WorkflowStepEvent extends BehaviorEventBase {
-  type: 'workflow_step';
-  workflow: string;
-  step: string;
-  status: 'entered' | 'completed' | 'skipped' | 'errored';
-}
-type BehaviorEvent = FieldAccessEvent | FeatureUsageEvent | WorkflowStepEvent;
-interface BehaviorQuery {
-  tenantId?: string;
-  userId?: string;
-  role?: string;
-  feature?: string;
-  operation?: string;
-  workflow?: string;
-  since?: number;
-  until?: number;
-  limit?: number;
-}
-interface BehaviorSummary {
-  fieldCounts: Record<string, number>;
-  featureCounts: Record<string, number>;
-  workflowStepCounts: Record<string, Record<string, number>>;
-  totalEvents: number;
-}
-interface BehaviorInsights {
-  unusedFields: string[];
-  frequentlyUsedFields: string[];
-  suggestedHiddenFields: string[];
-  workflowBottlenecks: {
-    workflow: string;
-    step: string;
-    dropRate: number;
-  }[];
-  layoutPreference?: 'form' | 'grid' | 'list' | 'table';
-}
-//#endregion
-export { BehaviorEvent, BehaviorEventBase, BehaviorEventType, BehaviorInsights, BehaviorQuery, BehaviorSummary, FeatureUsageEvent, FieldAccessEvent, WorkflowStepEvent };