@contractspec/lib.personalization 6.0.17 → 6.0.18

package/dist/browser/index.js

@@ -1,128 +1,4 @@
-// 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: 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`
-  }));
-}
-
-// src/analyzer.ts
-var DEFAULT_THRESHOLD = 3;
-
-class BehaviorAnalyzer {
-  store;
-  options;
-  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;
-    }
-    const summary = await this.store.summarize(query);
-    return buildInsights(summary, 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 < 0.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";
-}
-
-// src/docs/behavior-tracking.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var personalization_behavior_tracking_DocBlocks = [
-  {
-    id: "docs.personalization.behavior-tracking",
-    title: "Behavior Tracking",
-    summary: "`@contractspec/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
+function T(e,t){let r=[];if(e.suggestedHiddenFields.forEach((o)=>{r.push({type:"hideField",field:o,reason:"Automatically hidden because usage is near zero"})}),e.frequentlyUsedFields.length)r.push({type:"reorderFields",fields:e.frequentlyUsedFields});if(!r.length)return null;return{overlayId:t.overlayId,version:t.version??"1.0.0",appliesTo:{tenantId:t.tenantId,capability:t.capability,userId:t.userId,role:t.role},modifications:r,metadata:{generatedAt:new Date().toISOString(),automated:!0}}}function O(e){return e.workflowBottlenecks.map((t)=>({workflow:t.workflow,step:t.step,note:`High drop rate (${Math.round(t.dropRate*100)}%) detected`}))}class h{store;options;constructor(e,t={}){this.store=e;this.options=t}async analyze(e){let t={tenantId:e.tenantId,userId:e.userId,role:e.role};if(e.windowMs)t.since=Date.now()-e.windowMs;let r=await this.store.summarize(t);return v(r,this.options)}}function v(e,t){let r=t.fieldInactivityThreshold??3,o=t.minSamples??10,i=[],l=[];for(let[n,s]of Object.entries(e.fieldCounts)){if(s<=r)i.push(n);if(s>=r*4)l.push(n)}let c=Object.entries(e.workflowStepCounts).flatMap(([n,s])=>{let u=Object.values(s).reduce((a,d)=>a+d,0);if(!u||u<o)return[];return Object.entries(s).filter(([,a])=>a/u<0.4).map(([a,d])=>({workflow:n,step:a,dropRate:1-d/u}))}),p=m(e);return{unusedFields:i,suggestedHiddenFields:i.slice(0,5),frequentlyUsedFields:l.slice(0,10),workflowBottlenecks:c,layoutPreference:p}}function m(e){let t=Object.keys(e.fieldCounts).length;if(!t)return;if(t>=15)return"table";if(t>=8)return"grid";return"form"}import{registerDocBlocks as g}from"@contractspec/lib.contracts-spec/docs";var y=[{id:"docs.personalization.behavior-tracking",title:"Behavior Tracking",summary:"`@contractspec/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
 
 \`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
 
@@ -201,23 +77,7 @@ When the adapter returns an overlay spec, pass it to the overlay engine to regis
 
 
 
-`
-  }
-];
-registerDocBlocks(personalization_behavior_tracking_DocBlocks);
-
-// src/docs/overlay-engine.docblock.ts
-import { registerDocBlocks as registerDocBlocks2 } from "@contractspec/lib.contracts-spec/docs";
-var personalization_overlay_engine_DocBlocks = [
-  {
-    id: "docs.personalization.overlay-engine",
-    title: "Overlay Engine",
-    summary: "`@contractspec/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
+`}];g(y);import{registerDocBlocks as w}from"@contractspec/lib.contracts-spec/docs";var B=[{id:"docs.personalization.overlay-engine",title:"Overlay Engine",summary:"`@contractspec/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
 
 \`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
 
@@ -297,23 +157,7 @@ const result = engine.apply({
 
 
 
-`
-  }
-];
-registerDocBlocks2(personalization_overlay_engine_DocBlocks);
-
-// src/docs/workflow-composition.docblock.ts
-import { registerDocBlocks as registerDocBlocks3 } from "@contractspec/lib.contracts-spec/docs";
-var personalization_workflow_composition_DocBlocks = [
-  {
-    id: "docs.personalization.workflow-composition",
-    title: "Workflow Composition",
-    summary: "`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions, strict validation, deterministic merge ordering, metadata/annotation overlays, and orphan-graph protection for hidden-step rewrites.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/personalization/workflow-composition",
-    tags: ["personalization", "workflow-composition"],
-    body: `# Workflow Composition
+`}];w(B);import{registerDocBlocks as k}from"@contractspec/lib.contracts-spec/docs";var I=[{id:"docs.personalization.workflow-composition",title:"Workflow Composition",summary:"`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions, strict validation, deterministic merge ordering, metadata/annotation overlays, and orphan-graph protection for hidden-step rewrites.",kind:"reference",visibility:"public",route:"/docs/personalization/workflow-composition",tags:["personalization","workflow-composition"],body:`# Workflow Composition
 
 \`@contractspec/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
 
@@ -365,178 +209,4 @@ workflowRunner.execute(runtimeSpec, ctx);
 - \`metadata\` and \`annotations\` overlays are merged into the composed runtime workflow for downstream observability and rollout tracing.
 
 This keeps tenant overlays additive, auditable, and replay-safe.
-`
-  }
-];
-registerDocBlocks3(personalization_workflow_composition_DocBlocks);
-// src/store.ts
-class InMemoryBehaviorStore {
-  events = [];
-  async record(event) {
-    this.events.push(event);
-  }
-  async bulkRecord(events) {
-    this.events.push(...events);
-  }
-  async query(query) {
-    return filterEvents(this.events, query);
-  }
-  async summarize(query) {
-    const events = await this.query(query);
-    const summary = {
-      fieldCounts: {},
-      featureCounts: {},
-      workflowStepCounts: {},
-      totalEvents: events.length
-    };
-    events.forEach((event) => {
-      switch (event.type) {
-        case "field_access":
-          summary.fieldCounts[event.field] = (summary.fieldCounts[event.field] ?? 0) + 1;
-          break;
-        case "feature_usage":
-          summary.featureCounts[event.feature] = (summary.featureCounts[event.feature] ?? 0) + 1;
-          break;
-        case "workflow_step": {
-          const workflow = summary.workflowStepCounts[event.workflow] ??= {};
-          workflow[event.step] = (workflow[event.step] ?? 0) + 1;
-          break;
-        }
-        default:
-          break;
-      }
-    });
-    return summary;
-  }
-  async clear() {
-    this.events = [];
-  }
-}
-function filterEvents(events, query) {
-  return events.filter((event) => {
-    if (query.tenantId && event.tenantId !== query.tenantId) {
-      return false;
-    }
-    if (query.userId && event.userId !== query.userId) {
-      return false;
-    }
-    if (query.role && event.role !== query.role) {
-      return false;
-    }
-    if (query.since && event.timestamp < query.since) {
-      return false;
-    }
-    if (query.until && event.timestamp > query.until) {
-      return false;
-    }
-    if (query.operation && event.type === "field_access" && event.operation !== query.operation) {
-      return false;
-    }
-    if (query.feature && event.type === "feature_usage" && event.feature !== query.feature) {
-      return false;
-    }
-    if (query.workflow && event.type === "workflow_step" && event.workflow !== query.workflow) {
-      return false;
-    }
-    return true;
-  });
-}
-
-// src/tracker.ts
-import { metrics, trace } from "@opentelemetry/api";
-var DEFAULT_BUFFER_SIZE = 25;
-
-class BehaviorTracker {
-  store;
-  context;
-  tracer = trace.getTracer("lssm.personalization", "1.0.0");
-  counter = metrics.getMeter("lssm.personalization", "1.0.0").createCounter("lssm.personalization.events", {
-    description: "Behavior events tracked for personalization"
-  });
-  buffer = [];
-  bufferSize;
-  flushTimer;
-  constructor(options) {
-    this.store = options.store;
-    this.context = options.context;
-    this.bufferSize = options.bufferSize ?? DEFAULT_BUFFER_SIZE;
-    if (options.autoFlushIntervalMs) {
-      this.flushTimer = setInterval(() => {
-        this.flush();
-      }, options.autoFlushIntervalMs);
-    }
-  }
-  trackFieldAccess(input) {
-    const event = {
-      type: "field_access",
-      operation: input.operation,
-      field: input.field,
-      timestamp: Date.now(),
-      ...this.context,
-      metadata: { ...this.context.metadata, ...input.metadata }
-    };
-    this.enqueue(event);
-  }
-  trackFeatureUsage(input) {
-    const event = {
-      type: "feature_usage",
-      feature: input.feature,
-      action: input.action,
-      timestamp: Date.now(),
-      ...this.context,
-      metadata: { ...this.context.metadata, ...input.metadata }
-    };
-    this.enqueue(event);
-  }
-  trackWorkflowStep(input) {
-    const event = {
-      type: "workflow_step",
-      workflow: input.workflow,
-      step: input.step,
-      status: input.status,
-      timestamp: Date.now(),
-      ...this.context,
-      metadata: { ...this.context.metadata, ...input.metadata }
-    };
-    this.enqueue(event);
-  }
-  async flush() {
-    if (!this.buffer.length)
-      return;
-    const events = this.buffer;
-    this.buffer = [];
-    await this.store.bulkRecord(events);
-  }
-  async dispose() {
-    if (this.flushTimer) {
-      clearInterval(this.flushTimer);
-    }
-    await this.flush();
-  }
-  enqueue(event) {
-    this.buffer.push(event);
-    this.counter.add(1, {
-      tenantId: this.context.tenantId,
-      type: event.type
-    });
-    this.tracer.startActiveSpan(`personalization.${event.type}`, (span) => {
-      span.setAttribute("tenant.id", this.context.tenantId);
-      if (this.context.userId)
-        span.setAttribute("user.id", this.context.userId);
-      span.setAttribute("personalization.event_type", event.type);
-      span.end();
-    });
-    if (this.buffer.length >= this.bufferSize) {
-      this.flush();
-    }
-  }
-}
-var createBehaviorTracker = (options) => new BehaviorTracker(options);
-export {
-  insightsToWorkflowAdaptations,
-  insightsToOverlaySuggestion,
-  createBehaviorTracker,
-  InMemoryBehaviorStore,
-  BehaviorTracker,
-  BehaviorAnalyzer
-};
+`}];k(I);class x{events=[];async record(e){this.events.push(e)}async bulkRecord(e){this.events.push(...e)}async query(e){return b(this.events,e)}async summarize(e){let t=await this.query(e),r={fieldCounts:{},featureCounts:{},workflowStepCounts:{},totalEvents:t.length};return t.forEach((o)=>{switch(o.type){case"field_access":r.fieldCounts[o.field]=(r.fieldCounts[o.field]??0)+1;break;case"feature_usage":r.featureCounts[o.feature]=(r.featureCounts[o.feature]??0)+1;break;case"workflow_step":{let i=r.workflowStepCounts[o.workflow]??={};i[o.step]=(i[o.step]??0)+1;break}default:break}}),r}async clear(){this.events=[]}}function b(e,t){return e.filter((r)=>{if(t.tenantId&&r.tenantId!==t.tenantId)return!1;if(t.userId&&r.userId!==t.userId)return!1;if(t.role&&r.role!==t.role)return!1;if(t.since&&r.timestamp<t.since)return!1;if(t.until&&r.timestamp>t.until)return!1;if(t.operation&&r.type==="field_access"&&r.operation!==t.operation)return!1;if(t.feature&&r.type==="feature_usage"&&r.feature!==t.feature)return!1;if(t.workflow&&r.type==="workflow_step"&&r.workflow!==t.workflow)return!1;return!0})}import{metrics as S,trace as E}from"@opentelemetry/api";var F=25;class f{store;context;tracer=E.getTracer("lssm.personalization","1.0.0");counter=S.getMeter("lssm.personalization","1.0.0").createCounter("lssm.personalization.events",{description:"Behavior events tracked for personalization"});buffer=[];bufferSize;flushTimer;constructor(e){if(this.store=e.store,this.context=e.context,this.bufferSize=e.bufferSize??F,e.autoFlushIntervalMs)this.flushTimer=setInterval(()=>{this.flush()},e.autoFlushIntervalMs)}trackFieldAccess(e){let t={type:"field_access",operation:e.operation,field:e.field,timestamp:Date.now(),...this.context,metadata:{...this.context.metadata,...e.metadata}};this.enqueue(t)}trackFeatureUsage(e){let t={type:"feature_usage",feature:e.feature,action:e.action,timestamp:Date.now(),...this.context,metadata:{...this.context.metadata,...e.metadata}};this.enqueue(t)}trackWorkflowStep(e){let t={type:"workflow_step",workflow:e.workflow,step:e.step,status:e.status,timestamp:Date.now(),...this.context,metadata:{...this.context.metadata,...e.metadata}};this.enqueue(t)}async flush(){if(!this.buffer.length)return;let e=this.buffer;this.buffer=[],await this.store.bulkRecord(e)}async dispose(){if(this.flushTimer)clearInterval(this.flushTimer);await this.flush()}enqueue(e){if(this.buffer.push(e),this.counter.add(1,{tenantId:this.context.tenantId,type:e.type}),this.tracer.startActiveSpan(`personalization.${e.type}`,(t)=>{if(t.setAttribute("tenant.id",this.context.tenantId),this.context.userId)t.setAttribute("user.id",this.context.userId);t.setAttribute("personalization.event_type",e.type),t.end()}),this.buffer.length>=this.bufferSize)this.flush()}}var D=(e)=>new f(e);export{O as insightsToWorkflowAdaptations,T as insightsToOverlaySuggestion,D as createBehaviorTracker,x as InMemoryBehaviorStore,f as BehaviorTracker,h as BehaviorAnalyzer};

package/dist/browser/store.js

@@ -1,75 +1 @@
-// src/store.ts
-class InMemoryBehaviorStore {
-  events = [];
-  async record(event) {
-    this.events.push(event);
-  }
-  async bulkRecord(events) {
-    this.events.push(...events);
-  }
-  async query(query) {
-    return filterEvents(this.events, query);
-  }
-  async summarize(query) {
-    const events = await this.query(query);
-    const summary = {
-      fieldCounts: {},
-      featureCounts: {},
-      workflowStepCounts: {},
-      totalEvents: events.length
-    };
-    events.forEach((event) => {
-      switch (event.type) {
-        case "field_access":
-          summary.fieldCounts[event.field] = (summary.fieldCounts[event.field] ?? 0) + 1;
-          break;
-        case "feature_usage":
-          summary.featureCounts[event.feature] = (summary.featureCounts[event.feature] ?? 0) + 1;
-          break;
-        case "workflow_step": {
-          const workflow = summary.workflowStepCounts[event.workflow] ??= {};
-          workflow[event.step] = (workflow[event.step] ?? 0) + 1;
-          break;
-        }
-        default:
-          break;
-      }
-    });
-    return summary;
-  }
-  async clear() {
-    this.events = [];
-  }
-}
-function filterEvents(events, query) {
-  return events.filter((event) => {
-    if (query.tenantId && event.tenantId !== query.tenantId) {
-      return false;
-    }
-    if (query.userId && event.userId !== query.userId) {
-      return false;
-    }
-    if (query.role && event.role !== query.role) {
-      return false;
-    }
-    if (query.since && event.timestamp < query.since) {
-      return false;
-    }
-    if (query.until && event.timestamp > query.until) {
-      return false;
-    }
-    if (query.operation && event.type === "field_access" && event.operation !== query.operation) {
-      return false;
-    }
-    if (query.feature && event.type === "feature_usage" && event.feature !== query.feature) {
-      return false;
-    }
-    if (query.workflow && event.type === "workflow_step" && event.workflow !== query.workflow) {
-      return false;
-    }
-    return true;
-  });
-}
-export {
-  InMemoryBehaviorStore
-};
+class i{events=[];async record(o){this.events.push(o)}async bulkRecord(o){this.events.push(...o)}async query(o){return s(this.events,o)}async summarize(o){let e=await this.query(o),r={fieldCounts:{},featureCounts:{},workflowStepCounts:{},totalEvents:e.length};return e.forEach((t)=>{switch(t.type){case"field_access":r.fieldCounts[t.field]=(r.fieldCounts[t.field]??0)+1;break;case"feature_usage":r.featureCounts[t.feature]=(r.featureCounts[t.feature]??0)+1;break;case"workflow_step":{let a=r.workflowStepCounts[t.workflow]??={};a[t.step]=(a[t.step]??0)+1;break}default:break}}),r}async clear(){this.events=[]}}function s(o,e){return o.filter((r)=>{if(e.tenantId&&r.tenantId!==e.tenantId)return!1;if(e.userId&&r.userId!==e.userId)return!1;if(e.role&&r.role!==e.role)return!1;if(e.since&&r.timestamp<e.since)return!1;if(e.until&&r.timestamp>e.until)return!1;if(e.operation&&r.type==="field_access"&&r.operation!==e.operation)return!1;if(e.feature&&r.type==="feature_usage"&&r.feature!==e.feature)return!1;if(e.workflow&&r.type==="workflow_step"&&r.workflow!==e.workflow)return!1;return!0})}export{i as InMemoryBehaviorStore};

package/dist/browser/tracker.js

@@ -1,94 +1 @@
-// src/tracker.ts
-import { metrics, trace } from "@opentelemetry/api";
-var DEFAULT_BUFFER_SIZE = 25;
-
-class BehaviorTracker {
-  store;
-  context;
-  tracer = trace.getTracer("lssm.personalization", "1.0.0");
-  counter = metrics.getMeter("lssm.personalization", "1.0.0").createCounter("lssm.personalization.events", {
-    description: "Behavior events tracked for personalization"
-  });
-  buffer = [];
-  bufferSize;
-  flushTimer;
-  constructor(options) {
-    this.store = options.store;
-    this.context = options.context;
-    this.bufferSize = options.bufferSize ?? DEFAULT_BUFFER_SIZE;
-    if (options.autoFlushIntervalMs) {
-      this.flushTimer = setInterval(() => {
-        this.flush();
-      }, options.autoFlushIntervalMs);
-    }
-  }
-  trackFieldAccess(input) {
-    const event = {
-      type: "field_access",
-      operation: input.operation,
-      field: input.field,
-      timestamp: Date.now(),
-      ...this.context,
-      metadata: { ...this.context.metadata, ...input.metadata }
-    };
-    this.enqueue(event);
-  }
-  trackFeatureUsage(input) {
-    const event = {
-      type: "feature_usage",
-      feature: input.feature,
-      action: input.action,
-      timestamp: Date.now(),
-      ...this.context,
-      metadata: { ...this.context.metadata, ...input.metadata }
-    };
-    this.enqueue(event);
-  }
-  trackWorkflowStep(input) {
-    const event = {
-      type: "workflow_step",
-      workflow: input.workflow,
-      step: input.step,
-      status: input.status,
-      timestamp: Date.now(),
-      ...this.context,
-      metadata: { ...this.context.metadata, ...input.metadata }
-    };
-    this.enqueue(event);
-  }
-  async flush() {
-    if (!this.buffer.length)
-      return;
-    const events = this.buffer;
-    this.buffer = [];
-    await this.store.bulkRecord(events);
-  }
-  async dispose() {
-    if (this.flushTimer) {
-      clearInterval(this.flushTimer);
-    }
-    await this.flush();
-  }
-  enqueue(event) {
-    this.buffer.push(event);
-    this.counter.add(1, {
-      tenantId: this.context.tenantId,
-      type: event.type
-    });
-    this.tracer.startActiveSpan(`personalization.${event.type}`, (span) => {
-      span.setAttribute("tenant.id", this.context.tenantId);
-      if (this.context.userId)
-        span.setAttribute("user.id", this.context.userId);
-      span.setAttribute("personalization.event_type", event.type);
-      span.end();
-    });
-    if (this.buffer.length >= this.bufferSize) {
-      this.flush();
-    }
-  }
-}
-var createBehaviorTracker = (options) => new BehaviorTracker(options);
-export {
-  createBehaviorTracker,
-  BehaviorTracker
-};
+import{metrics as a,trace as s}from"@opentelemetry/api";var i=25;class r{store;context;tracer=s.getTracer("lssm.personalization","1.0.0");counter=a.getMeter("lssm.personalization","1.0.0").createCounter("lssm.personalization.events",{description:"Behavior events tracked for personalization"});buffer=[];bufferSize;flushTimer;constructor(e){if(this.store=e.store,this.context=e.context,this.bufferSize=e.bufferSize??i,e.autoFlushIntervalMs)this.flushTimer=setInterval(()=>{this.flush()},e.autoFlushIntervalMs)}trackFieldAccess(e){let t={type:"field_access",operation:e.operation,field:e.field,timestamp:Date.now(),...this.context,metadata:{...this.context.metadata,...e.metadata}};this.enqueue(t)}trackFeatureUsage(e){let t={type:"feature_usage",feature:e.feature,action:e.action,timestamp:Date.now(),...this.context,metadata:{...this.context.metadata,...e.metadata}};this.enqueue(t)}trackWorkflowStep(e){let t={type:"workflow_step",workflow:e.workflow,step:e.step,status:e.status,timestamp:Date.now(),...this.context,metadata:{...this.context.metadata,...e.metadata}};this.enqueue(t)}async flush(){if(!this.buffer.length)return;let e=this.buffer;this.buffer=[],await this.store.bulkRecord(e)}async dispose(){if(this.flushTimer)clearInterval(this.flushTimer);await this.flush()}enqueue(e){if(this.buffer.push(e),this.counter.add(1,{tenantId:this.context.tenantId,type:e.type}),this.tracer.startActiveSpan(`personalization.${e.type}`,(t)=>{if(t.setAttribute("tenant.id",this.context.tenantId),this.context.userId)t.setAttribute("user.id",this.context.userId);t.setAttribute("personalization.event_type",e.type),t.end()}),this.buffer.length>=this.bufferSize)this.flush()}}var n=(e)=>new r(e);export{n as createBehaviorTracker,r as BehaviorTracker};

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

@@ -1,16 +1,5 @@
 // @bun
-// src/docs/behavior-tracking.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var personalization_behavior_tracking_DocBlocks = [
-  {
-    id: "docs.personalization.behavior-tracking",
-    title: "Behavior Tracking",
-    summary: "`@contractspec/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
+import{registerDocBlocks as d}from"@contractspec/lib.contracts-spec/docs";var f=[{id:"docs.personalization.behavior-tracking",title:"Behavior Tracking",summary:"`@contractspec/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
 
 \`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
 
@@ -89,10 +78,4 @@ When the adapter returns an overlay spec, pass it to the overlay engine to regis
 
 
 
-`
-  }
-];
-registerDocBlocks(personalization_behavior_tracking_DocBlocks);
-export {
-  personalization_behavior_tracking_DocBlocks
-};
+`}];d(f);export{f as personalization_behavior_tracking_DocBlocks};

package/dist/docs/index.js

@@ -1,16 +1,5 @@
 // @bun
-// src/docs/behavior-tracking.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var personalization_behavior_tracking_DocBlocks = [
-  {
-    id: "docs.personalization.behavior-tracking",
-    title: "Behavior Tracking",
-    summary: "`@contractspec/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
+import{registerDocBlocks as m}from"@contractspec/lib.contracts-spec/docs";var d=[{id:"docs.personalization.behavior-tracking",title:"Behavior Tracking",summary:"`@contractspec/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
 
 \`@contractspec/lib.personalization\` provides primitives to observe how tenants/users interact with specs and turn that telemetry into personalization insights.
 
@@ -89,23 +78,7 @@ When the adapter returns an overlay spec, pass it to the overlay engine to regis
 
 
 
-`
-  }
-];
-registerDocBlocks(personalization_behavior_tracking_DocBlocks);
-
-// src/docs/overlay-engine.docblock.ts
-import { registerDocBlocks as registerDocBlocks2 } from "@contractspec/lib.contracts-spec/docs";
-var personalization_overlay_engine_DocBlocks = [
-  {
-    id: "docs.personalization.overlay-engine",
-    title: "Overlay Engine",
-    summary: "`@contractspec/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
+`}];m(d);import{registerDocBlocks as j}from"@contractspec/lib.contracts-spec/docs";var q=[{id:"docs.personalization.overlay-engine",title:"Overlay Engine",summary:"`@contractspec/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
 
 \`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
 
@@ -185,23 +158,7 @@ const result = engine.apply({
 
 
 
-`
-  }
-];
-registerDocBlocks2(personalization_overlay_engine_DocBlocks);
-
-// src/docs/workflow-composition.docblock.ts
-import { registerDocBlocks as registerDocBlocks3 } from "@contractspec/lib.contracts-spec/docs";
-var personalization_workflow_composition_DocBlocks = [
-  {
-    id: "docs.personalization.workflow-composition",
-    title: "Workflow Composition",
-    summary: "`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions, strict validation, deterministic merge ordering, metadata/annotation overlays, and orphan-graph protection for hidden-step rewrites.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/personalization/workflow-composition",
-    tags: ["personalization", "workflow-composition"],
-    body: `# Workflow Composition
+`}];j(q);import{registerDocBlocks as u}from"@contractspec/lib.contracts-spec/docs";var x=[{id:"docs.personalization.workflow-composition",title:"Workflow Composition",summary:"`@contractspec/lib.workflow-composer` composes base WorkflowSpecs with tenant/role/device-specific extensions, strict validation, deterministic merge ordering, metadata/annotation overlays, and orphan-graph protection for hidden-step rewrites.",kind:"reference",visibility:"public",route:"/docs/personalization/workflow-composition",tags:["personalization","workflow-composition"],body:`# Workflow Composition
 
 \`@contractspec/lib.workflow-composer\` composes base WorkflowSpecs with tenant/role/device-specific extensions.
 
@@ -253,7 +210,4 @@ workflowRunner.execute(runtimeSpec, ctx);
 - \`metadata\` and \`annotations\` overlays are merged into the composed runtime workflow for downstream observability and rollout tracing.
 
 This keeps tenant overlays additive, auditable, and replay-safe.
-`
-  }
-];
-registerDocBlocks3(personalization_workflow_composition_DocBlocks);
+`}];u(x);

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

@@ -1,16 +1,5 @@
 // @bun
-// src/docs/overlay-engine.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var personalization_overlay_engine_DocBlocks = [
-  {
-    id: "docs.personalization.overlay-engine",
-    title: "Overlay Engine",
-    summary: "`@contractspec/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
+import{registerDocBlocks as b}from"@contractspec/lib.contracts-spec/docs";var d=[{id:"docs.personalization.overlay-engine",title:"Overlay Engine",summary:"`@contractspec/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
 
 \`@contractspec/lib.overlay-engine\` is the canonical runtime for OverlaySpecs. It validates specs, tracks scope precedence, and exposes hooks for React renderers.
 
@@ -90,10 +79,4 @@ const result = engine.apply({
 
 
 
-`
-  }
-];
-registerDocBlocks(personalization_overlay_engine_DocBlocks);
-export {
-  personalization_overlay_engine_DocBlocks
-};
+`}];b(d);export{d as personalization_overlay_engine_DocBlocks};