@lssm/lib.personalization 0.3.0 → 1.41.0

package/dist/store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.js","names":["summary: BehaviorSummary"],"sources":["../src/store.ts"],"sourcesContent":["import type { BehaviorEvent, BehaviorQuery, BehaviorSummary } from './types';\n\nexport interface BehaviorStore {\n  record(event: BehaviorEvent): Promise<void> | void;\n  bulkRecord(events: BehaviorEvent[]): Promise<void> | void;\n  query(query: BehaviorQuery): Promise<BehaviorEvent[]>;\n  summarize(query: BehaviorQuery): Promise<BehaviorSummary>;\n  clear?(): Promise<void> | void;\n}\n\nexport class InMemoryBehaviorStore implements BehaviorStore {\n  private events: BehaviorEvent[] = [];\n\n  async record(event: BehaviorEvent): Promise<void> {\n    this.events.push(event);\n  }\n\n  async bulkRecord(events: BehaviorEvent[]): Promise<void> {\n    this.events.push(...events);\n  }\n\n  async query(query: BehaviorQuery): Promise<BehaviorEvent[]> {\n    return filterEvents(this.events, query);\n  }\n\n  async summarize(query: BehaviorQuery): Promise<BehaviorSummary> {\n    const events = await this.query(query);\n    const summary: BehaviorSummary = {\n      fieldCounts: {},\n      featureCounts: {},\n      workflowStepCounts: {},\n      totalEvents: events.length,\n    };\n\n    events.forEach((event) => {\n      switch (event.type) {\n        case 'field_access':\n          summary.fieldCounts[event.field] =\n            (summary.fieldCounts[event.field] ?? 0) + 1;\n          break;\n        case 'feature_usage':\n          summary.featureCounts[event.feature] =\n            (summary.featureCounts[event.feature] ?? 0) + 1;\n          break;\n        case 'workflow_step': {\n          const workflow = (summary.workflowStepCounts[event.workflow] ??= {});\n          workflow[event.step] = (workflow[event.step] ?? 0) + 1;\n          break;\n        }\n        default:\n          break;\n      }\n    });\n\n    return summary;\n  }\n\n  async clear(): Promise<void> {\n    this.events = [];\n  }\n}\n\nfunction filterEvents(\n  events: BehaviorEvent[],\n  query: BehaviorQuery\n): BehaviorEvent[] {\n  return events.filter((event) => {\n    if (query.tenantId && event.tenantId !== query.tenantId) {\n      return false;\n    }\n    if (query.userId && event.userId !== query.userId) {\n      return false;\n    }\n    if (query.role && event.role !== query.role) {\n      return false;\n    }\n    if (query.since && event.timestamp < query.since) {\n      return false;\n    }\n    if (query.until && event.timestamp > query.until) {\n      return false;\n    }\n\n    if (\n      query.operation &&\n      event.type === 'field_access' &&\n      event.operation !== query.operation\n    ) {\n      return false;\n    }\n    if (\n      query.feature &&\n      event.type === 'feature_usage' &&\n      event.feature !== query.feature\n    ) {\n      return false;\n    }\n    if (\n      query.workflow &&\n      event.type === 'workflow_step' &&\n      event.workflow !== query.workflow\n    ) {\n      return false;\n    }\n    return true;\n  });\n}\n"],"mappings":"AAUA,IAAa,EAAb,KAA4D,CAC1D,OAAkC,EAAE,CAEpC,MAAM,OAAO,EAAqC,CAChD,KAAK,OAAO,KAAK,EAAM,CAGzB,MAAM,WAAW,EAAwC,CACvD,KAAK,OAAO,KAAK,GAAG,EAAO,CAG7B,MAAM,MAAM,EAAgD,CAC1D,OAAO,EAAa,KAAK,OAAQ,EAAM,CAGzC,MAAM,UAAU,EAAgD,CAC9D,IAAM,EAAS,MAAM,KAAK,MAAM,EAAM,CAChCA,EAA2B,CAC/B,YAAa,EAAE,CACf,cAAe,EAAE,CACjB,mBAAoB,EAAE,CACtB,YAAa,EAAO,OACrB,CAsBD,OApBA,EAAO,QAAS,GAAU,CACxB,OAAQ,EAAM,KAAd,CACE,IAAK,eACH,EAAQ,YAAY,EAAM,QACvB,EAAQ,YAAY,EAAM,QAAU,GAAK,EAC5C,MACF,IAAK,gBACH,EAAQ,cAAc,EAAM,UACzB,EAAQ,cAAc,EAAM,UAAY,GAAK,EAChD,MACF,IAAK,gBAAiB,CACpB,IAAM,EAAY,EAAQ,mBAAmB,EAAM,YAAc,EAAE,CACnE,EAAS,EAAM,OAAS,EAAS,EAAM,OAAS,GAAK,EACrD,MAEF,QACE,QAEJ,CAEK,EAGT,MAAM,OAAuB,CAC3B,KAAK,OAAS,EAAE,GAIpB,SAAS,EACP,EACA,EACiB,CACjB,OAAO,EAAO,OAAQ,GA+BpB,EA9BI,EAAM,UAAY,EAAM,WAAa,EAAM,UAG3C,EAAM,QAAU,EAAM,SAAW,EAAM,QAGvC,EAAM,MAAQ,EAAM,OAAS,EAAM,MAGnC,EAAM,OAAS,EAAM,UAAY,EAAM,OAGvC,EAAM,OAAS,EAAM,UAAY,EAAM,OAKzC,EAAM,WACN,EAAM,OAAS,gBACf,EAAM,YAAc,EAAM,WAK1B,EAAM,SACN,EAAM,OAAS,iBACf,EAAM,UAAY,EAAM,SAKxB,EAAM,UACN,EAAM,OAAS,iBACf,EAAM,WAAa,EAAM,UAK3B"}

package/dist/tracker.d.ts

@@ -1,53 +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 };
-//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracker.d.ts","names":[],"sources":["../src/tracker.ts"],"sourcesContent":[],"mappings":";;;UAIiB,sBAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAQA,IAAA,CAAA,EAAA,MAAA;EAUA,MAAA,CAAA,EAAA,MAAA;EAMA,QAAA,CAAA,EAnBJ,MAmBI,CAAA,MAAA,EAAsB,OAAA,CAAA;AAMvC;AAOa,UA7BI,sBAAA,CA6BW;EAcL,KAAA,EA1Cd,aA0Cc;EAYG,OAAA,EArDf,sBAqDe;EAYC,UAAA,CAAA,EAAA,MAAA;EAYA,mBAAA,CAAA,EAAA,MAAA;EAaV,UAAA,CAAA,EAAA,MAAA;;AAOS,UAzFT,qBAAA,CAyFS;EA4Bb,SAAA,EAAA,MAAA;;aAlHA;;UAGI,sBAAA;;;aAGJ;;UAGI,sBAAA;;;;aAIJ;;cAGA,eAAA;;;;;;;;uBAcU;0BAYG;2BAYC;2BAYA;WAaV;aAOE;;;cA4BN,iCAAkC,2BAAsB"}

package/dist/tracker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracker.js","names":[],"sources":["../src/tracker.ts"],"sourcesContent":["import { trace, metrics } from '@opentelemetry/api';\nimport type { BehaviorEvent } from './types';\nimport type { BehaviorStore } from './store';\n\nexport interface BehaviorTrackerContext {\n  tenantId: string;\n  userId?: string;\n  role?: string;\n  device?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface BehaviorTrackerOptions {\n  store: BehaviorStore;\n  context: BehaviorTrackerContext;\n  tracerName?: string;\n  autoFlushIntervalMs?: number;\n  bufferSize?: number;\n}\n\nconst DEFAULT_BUFFER_SIZE = 25;\n\nexport interface TrackFieldAccessInput {\n  operation: string;\n  field: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TrackFeatureUsageInput {\n  feature: string;\n  action: 'opened' | 'completed' | 'dismissed';\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TrackWorkflowStepInput {\n  workflow: string;\n  step: string;\n  status: 'entered' | 'completed' | 'skipped' | 'errored';\n  metadata?: Record<string, unknown>;\n}\n\nexport class BehaviorTracker {\n  private readonly store: BehaviorStore;\n  private readonly context: BehaviorTrackerContext;\n  private readonly tracer = trace.getTracer('lssm.personalization', '1.0.0');\n  private readonly counter = metrics\n    .getMeter('lssm.personalization', '1.0.0')\n    .createCounter('lssm.personalization.events', {\n      description: 'Behavior events tracked for personalization',\n    });\n\n  private buffer: BehaviorEvent[] = [];\n  private readonly bufferSize: number;\n  private flushTimer?: ReturnType<typeof setInterval>;\n\n  constructor(options: BehaviorTrackerOptions) {\n    this.store = options.store;\n    this.context = options.context;\n    this.bufferSize = options.bufferSize ?? DEFAULT_BUFFER_SIZE;\n\n    if (options.autoFlushIntervalMs) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, options.autoFlushIntervalMs);\n    }\n  }\n\n  trackFieldAccess(input: TrackFieldAccessInput) {\n    const event = {\n      type: 'field_access',\n      operation: input.operation,\n      field: input.field,\n      timestamp: Date.now(),\n      ...this.context,\n      metadata: { ...this.context.metadata, ...input.metadata },\n    } as BehaviorEvent;\n    this.enqueue(event);\n  }\n\n  trackFeatureUsage(input: TrackFeatureUsageInput) {\n    const event = {\n      type: 'feature_usage',\n      feature: input.feature,\n      action: input.action,\n      timestamp: Date.now(),\n      ...this.context,\n      metadata: { ...this.context.metadata, ...input.metadata },\n    } as BehaviorEvent;\n    this.enqueue(event);\n  }\n\n  trackWorkflowStep(input: TrackWorkflowStepInput) {\n    const event = {\n      type: 'workflow_step',\n      workflow: input.workflow,\n      step: input.step,\n      status: input.status,\n      timestamp: Date.now(),\n      ...this.context,\n      metadata: { ...this.context.metadata, ...input.metadata },\n    } as BehaviorEvent;\n    this.enqueue(event);\n  }\n\n  async flush(): Promise<void> {\n    if (!this.buffer.length) return;\n    const events = this.buffer;\n    this.buffer = [];\n    await this.store.bulkRecord(events);\n  }\n\n  async dispose(): Promise<void> {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n    }\n    await this.flush();\n  }\n\n  private enqueue(event: BehaviorEvent) {\n    this.buffer.push(event);\n    this.counter.add(1, {\n      tenantId: this.context.tenantId,\n      type: event.type,\n    });\n\n    this.tracer.startActiveSpan(`personalization.${event.type}`, (span) => {\n      span.setAttribute('tenant.id', this.context.tenantId);\n      if (this.context.userId)\n        span.setAttribute('user.id', this.context.userId);\n      span.setAttribute('personalization.event_type', event.type);\n      span.end();\n    });\n\n    if (this.buffer.length >= this.bufferSize) {\n      void this.flush();\n    }\n  }\n}\n\nexport const createBehaviorTracker = (options: BehaviorTrackerOptions) =>\n  new BehaviorTracker(options);\n"],"mappings":"wDAyCA,IAAa,EAAb,KAA6B,CAC3B,MACA,QACA,OAA0B,EAAM,UAAU,uBAAwB,QAAQ,CAC1E,QAA2B,EACxB,SAAS,uBAAwB,QAAQ,CACzC,cAAc,8BAA+B,CAC5C,YAAa,8CACd,CAAC,CAEJ,OAAkC,EAAE,CACpC,WACA,WAEA,YAAY,EAAiC,CAC3C,KAAK,MAAQ,EAAQ,MACrB,KAAK,QAAU,EAAQ,QACvB,KAAK,WAAa,EAAQ,YAAc,GAEpC,EAAQ,sBACV,KAAK,WAAa,gBAAkB,CAC7B,KAAK,OAAO,EAChB,EAAQ,oBAAoB,EAInC,iBAAiB,EAA8B,CAC7C,IAAM,EAAQ,CACZ,KAAM,eACN,UAAW,EAAM,UACjB,MAAO,EAAM,MACb,UAAW,KAAK,KAAK,CACrB,GAAG,KAAK,QACR,SAAU,CAAE,GAAG,KAAK,QAAQ,SAAU,GAAG,EAAM,SAAU,CAC1D,CACD,KAAK,QAAQ,EAAM,CAGrB,kBAAkB,EAA+B,CAC/C,IAAM,EAAQ,CACZ,KAAM,gBACN,QAAS,EAAM,QACf,OAAQ,EAAM,OACd,UAAW,KAAK,KAAK,CACrB,GAAG,KAAK,QACR,SAAU,CAAE,GAAG,KAAK,QAAQ,SAAU,GAAG,EAAM,SAAU,CAC1D,CACD,KAAK,QAAQ,EAAM,CAGrB,kBAAkB,EAA+B,CAC/C,IAAM,EAAQ,CACZ,KAAM,gBACN,SAAU,EAAM,SAChB,KAAM,EAAM,KACZ,OAAQ,EAAM,OACd,UAAW,KAAK,KAAK,CACrB,GAAG,KAAK,QACR,SAAU,CAAE,GAAG,KAAK,QAAQ,SAAU,GAAG,EAAM,SAAU,CAC1D,CACD,KAAK,QAAQ,EAAM,CAGrB,MAAM,OAAuB,CAC3B,GAAI,CAAC,KAAK,OAAO,OAAQ,OACzB,IAAM,EAAS,KAAK,OACpB,KAAK,OAAS,EAAE,CAChB,MAAM,KAAK,MAAM,WAAW,EAAO,CAGrC,MAAM,SAAyB,CACzB,KAAK,YACP,cAAc,KAAK,WAAW,CAEhC,MAAM,KAAK,OAAO,CAGpB,QAAgB,EAAsB,CACpC,KAAK,OAAO,KAAK,EAAM,CACvB,KAAK,QAAQ,IAAI,EAAG,CAClB,SAAU,KAAK,QAAQ,SACvB,KAAM,EAAM,KACb,CAAC,CAEF,KAAK,OAAO,gBAAgB,mBAAmB,EAAM,OAAS,GAAS,CACrE,EAAK,aAAa,YAAa,KAAK,QAAQ,SAAS,CACjD,KAAK,QAAQ,QACf,EAAK,aAAa,UAAW,KAAK,QAAQ,OAAO,CACnD,EAAK,aAAa,6BAA8B,EAAM,KAAK,CAC3D,EAAK,KAAK,EACV,CAEE,KAAK,OAAO,QAAU,KAAK,YACxB,KAAK,OAAO,GAKvB,MAAa,EAAyB,GACpC,IAAI,EAAgB,EAAQ"}

package/dist/types.d.ts

@@ -1,59 +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 };
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,iBAAA;AAAA,UAKK,iBAAA,CALY;EAKZ,EAAA,CAAA,EAAA,MAAA;EAUA,QAAA,EAAA,MAAA;EAMA,MAAA,CAAA,EAAA,MAAA;EAMA,IAAA,CAAA,EAAA,MAAA;EAOL,MAAA,CAAA,EAAA,MAAA;EACR,SAAA,EAAA,MAAA;EACA,QAAA,CAAA,EAxBS,MAwBT,CAAA,MAAA,EAAA,OAAA,CAAA;;AACiB,UAtBJ,gBAAA,SAAyB,iBAsBrB,CAAA;EAEJ,IAAA,EAAA,cAAa;EAYb,SAAA,EAAA,MAAA;EACF,KAAA,EAAA,MAAA;;AAEsB,UAjCpB,iBAAA,SAA0B,iBAiCN,CAAA;EAAf,IAAA,EAAA,eAAA;EAAM,OAAA,EAAA,MAAA;EAIX,MAAA,EAAA,QAAA,GAAgB,WAAA,GAAA,WAAA;;UA/BhB,iBAAA,SAA0B;;;;;;KAO/B,aAAA,GACR,mBACA,oBACA;UAEa,aAAA;;;;;;;;;;;UAYA,eAAA;eACF;iBACE;sBACK,eAAe;;;UAIpB,gBAAA"}