@syntrologie/runtime-sdk 0.2.13 → 0.2.14

package/dist/bootstrap.d.ts

@@ -12,6 +12,7 @@
  */
 import { decodeToken, encodeToken } from "./token";
 import { SmartCanvasConfig, SmartCanvasHandle } from "./api";
+import { SessionMetricTracker } from "./metrics";
 import type { ExperimentClient } from "./experiments/types";
 import type { TelemetryClient } from "./telemetry/types";
 import type { CanvasConfigFetcher } from "./types";
@@ -35,6 +36,14 @@ export interface SyntroInitOptions {
      * The token's telemetry credentials (t field) are still used if present.
      */
     fetcher?: CanvasConfigFetcher;
+    /**
+     * Enable session-based metric tracking.
+     * When true, a SessionMetricTracker is created that tracks metrics during
+     * the user's session and updates GrowthBook attributes in real-time.
+     *
+     * @default false
+     */
+    enableSessionMetrics?: boolean;
 }
 export interface SyntroInitResult {
     /**
@@ -49,6 +58,11 @@ export interface SyntroInitResult {
      * The telemetry client, if telemetry is configured in the token.
      */
     telemetry?: TelemetryClient;
+    /**
+     * The session metric tracker, if enableSessionMetrics is true.
+     * Use this to track session-based metrics for real-time targeting.
+     */
+    sessionMetrics?: SessionMetricTracker;
 }
 /**
  * Initialize the Syntro SDK with a single token.

package/dist/bootstrap.js

@@ -16,6 +16,7 @@ import { createTelemetryClient } from "./telemetry/registry";
 import { createConfigFetcher } from "./fetchers/registry";
 import { createCanvasConfigFetcher } from "./configFetcher";
 import { createSmartCanvas } from "./api";
+import { createSessionMetricTracker } from "./metrics";
 /**
  * Get environment variable, supporting both Vite and Next.js patterns.
  */
@@ -54,6 +55,58 @@ function isEditorMode() {
     });
     return hasToken;
 }
+// ============================================================================
+// Segment Attribute Caching (localStorage)
+// ============================================================================
+const SEGMENT_CACHE_KEY = 'syntro_segment_attributes';
+/**
+ * Load cached segment attributes from localStorage.
+ * Returns cached values for instant Phase 1 evaluation.
+ */
+function loadCachedSegmentAttributes() {
+    if (typeof window === 'undefined')
+        return {};
+    try {
+        const cached = localStorage.getItem(SEGMENT_CACHE_KEY);
+        if (cached) {
+            const attrs = JSON.parse(cached);
+            console.log('[Syntro Bootstrap] Loaded cached segment attributes:', attrs);
+            return attrs;
+        }
+    }
+    catch (err) {
+        console.warn('[Syntro Bootstrap] Failed to load cached segment attributes:', err);
+    }
+    return {};
+}
+/**
+ * Save segment attributes to localStorage for faster future loads.
+ */
+function cacheSegmentAttributes(attrs) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        localStorage.setItem(SEGMENT_CACHE_KEY, JSON.stringify(attrs));
+        console.log('[Syntro Bootstrap] Cached segment attributes:', attrs);
+    }
+    catch (err) {
+        console.warn('[Syntro Bootstrap] Failed to cache segment attributes:', err);
+    }
+}
+/**
+ * Extract segment flags (in_segment_*) from PostHog feature flags.
+ */
+function extractSegmentFlags(allFlags) {
+    if (!allFlags)
+        return {};
+    const segmentFlags = {};
+    for (const [key, value] of Object.entries(allFlags)) {
+        if (key.startsWith('in_segment_')) {
+            segmentFlags[key] = value === true;
+        }
+    }
+    return segmentFlags;
+}
 /**
  * Initialize the Syntro SDK with a single token.
  *
@@ -116,20 +169,55 @@ async function init(options) {
     const editorUrl = getEnvVar("NEXT_PUBLIC_SYNTRO_EDITOR_URL")
         || getEnvVar("VITE_SYNTRO_EDITOR_URL")
         || ((_b = options.canvas) === null || _b === void 0 ? void 0 : _b.editorUrl);
-    // Initialize telemetry client FIRST (so experiments can wire tracking callback)
+    // ============================================================================
+    // PHASE 1: Load cached segment attributes for instant evaluation
+    // ============================================================================
+    const cachedSegmentAttrs = loadCachedSegmentAttributes();
+    console.log('[Syntro Bootstrap] Phase 1: Using cached segment attributes:', cachedSegmentAttrs);
+    // Will be set when experiments client is created
+    let experiments;
+    // Callback for when PostHog feature flags are loaded (Phase 2)
+    const onFeatureFlagsLoaded = (allFlags) => {
+        var _a, _b, _c;
+        console.log('[Syntro Bootstrap] Phase 2: PostHog feature flags loaded');
+        // Extract segment flags (in_segment_*)
+        const segmentFlags = extractSegmentFlags(allFlags);
+        console.log('[Syntro Bootstrap] Segment flags from PostHog:', segmentFlags);
+        // Cache for next page load
+        cacheSegmentAttributes(segmentFlags);
+        // Update GrowthBook with fresh segment attributes
+        if (experiments) {
+            // Get current session metrics if available
+            const sessionAttrs = (_b = (_a = sessionMetrics === null || sessionMetrics === void 0 ? void 0 : sessionMetrics.getAll) === null || _a === void 0 ? void 0 : _a.call(sessionMetrics)) !== null && _b !== void 0 ? _b : {};
+            // Merge session metrics + segment flags and update GrowthBook
+            const updatedAttrs = { ...sessionAttrs, ...segmentFlags };
+            console.log('[Syntro Bootstrap] Updating GrowthBook with attributes:', updatedAttrs);
+            (_c = experiments.setAttributes) === null || _c === void 0 ? void 0 : _c.call(experiments, updatedAttrs);
+        }
+    };
+    // Initialize telemetry client with feature flags callback
     let telemetry;
     if (payload === null || payload === void 0 ? void 0 : payload.t) {
         telemetry = createTelemetryClient("posthog", {
             apiKey: payload.t,
             apiHost: telemetryHost, // undefined falls back to adapter default
+            // Enable PostHog feature flags for segment membership
+            enableFeatureFlags: true,
+            // Wire up callback for when flags are loaded (Phase 2)
+            onFeatureFlagsLoaded,
         });
     }
-    // Initialize experiment client with tracking callback wired to telemetry
-    let experiments;
+    // ============================================================================
+    // Initialize experiment client with CACHED attributes (Phase 1)
+    // PostHog will update these when /decide returns (Phase 2)
+    // ============================================================================
+    let sessionMetrics;
     if (payload === null || payload === void 0 ? void 0 : payload.e) {
         experiments = createExperimentClient("growthbook", {
             clientKey: payload.e,
             apiHost: experimentHost, // undefined falls back to adapter default
+            // Phase 1: Use cached segment attributes for instant evaluation
+            attributes: cachedSegmentAttrs,
             // Wire experiment tracking to telemetry provider
             onExperimentViewed: (telemetry === null || telemetry === void 0 ? void 0 : telemetry.trackExperiment)
                 ? (key, variationId, variationName) => {
@@ -161,6 +249,16 @@ async function init(options) {
         // Default: use experiments-based fetcher (GrowthBook config or URI)
         fetcher = createCanvasConfigFetcher({ experiments });
     }
+    // Create session metric tracker if enabled
+    if (options.enableSessionMetrics) {
+        sessionMetrics = createSessionMetricTracker({
+            experiments,
+            onMetricChange: (key, value) => {
+                console.log(`[Syntro Bootstrap] Session metric changed: ${key} = ${value}`);
+            },
+        });
+        console.log('[Syntro Bootstrap] SessionMetricTracker created');
+    }
     // Create canvas with integrations
     const canvas = await createSmartCanvas({
         ...options.canvas,
@@ -168,7 +266,7 @@ async function init(options) {
         integrations: { experiments, telemetry },
         editorUrl,
     });
-    return { canvas, experiments, telemetry };
+    return { canvas, experiments, telemetry, sessionMetrics };
 }
 /**
  * The Syntro namespace for single-token initialization.

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAsB,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAwC,MAAM,OAAO,CAAC;AA8ChF;;GAEG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClD,oBAAoB;QACpB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,0EAA0E;IAC1E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC;QACtC,IAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY;IACnB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE;QACpD,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC9B,cAAc,EAAE,QAAQ;QACxB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,IAAI,CAAC,OAA0B;;IAC5C,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE;QACzC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK;QACzB,WAAW,EAAE,CAAA,MAAA,OAAO,CAAC,KAAK,0CAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAG,KAAK;QAChD,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM;KACnC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,UAAU,CAAC,CAAC;IAE3D,IAAI,OAAuC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,uDAAuD;QACvD,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;YACtE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,kDAAkD;YAClD,OAAO,CAAC,KAAK,CAAC,6EAA6E,CAAC,CAAC;YAC7F,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;QACD,6DAA6D;IAC/D,CAAC;SAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvB,0CAA0C;QAC1C,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC7E,CAAC;IAED,sDAAsD;IACtD,gEAAgE;IAChE,MAAM,cAAc,GAAG,SAAS,CAAC,oCAAoC,CAAC;WACjE,SAAS,CAAC,6BAA6B,CAAC;YACxC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,EAAE,CAAA,CAAC,CAAE,aAAa;IAEhC,MAAM,aAAa,GAAG,SAAS,CAAC,mCAAmC,CAAC;WAC/D,SAAS,CAAC,4BAA4B,CAAC;YACvC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,EAAE,CAAA,CAAC,CAAE,aAAa;IAEhC,mDAAmD;IACnD,MAAM,SAAS,GAAG,SAAS,CAAC,+BAA+B,CAAC;WACvD,SAAS,CAAC,wBAAwB,CAAC;YACnC,MAAA,OAAO,CAAC,MAAM,0CAAE,SAAS,CAAA,CAAC;IAE/B,gFAAgF;IAChF,IAAI,SAAsC,CAAC;IAC3C,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,CAAC,EAAE,CAAC;QACf,SAAS,GAAG,qBAAqB,CAAC,SAAS,EAAE;YAC3C,MAAM,EAAE,OAAO,CAAC,CAAC;YACjB,OAAO,EAAE,aAAa,EAAG,0CAA0C;SACpE,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,IAAI,WAAyC,CAAC;IAC9C,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,CAAC,EAAE,CAAC;QACf,WAAW,GAAG,sBAAsB,CAAC,YAAY,EAAE;YACjD,SAAS,EAAE,OAAO,CAAC,CAAC;YACpB,OAAO,EAAE,cAAc,EAAG,0CAA0C;YACpE,iDAAiD;YACjD,kBAAkB,EAAE,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,eAAe;gBAC5C,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE;oBAClC,SAAU,CAAC,eAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;gBAC/D,CAAC;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,yEAAyE;IACzE,IAAI,OAAwC,CAAC;IAC7C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,oFAAoF;QACpF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,CAAC,EAAE,CAAC;QACtB,2CAA2C;QAC3C,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,MAAA,OAAO,CAAC,CAAC,mCAAI,EAAE,CAAC,CAAC;QACtE,OAAO,GAAG,KAAK,IAAI,EAAE;;YACnB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3C,OAAO;gBACL,GAAG,MAAM,CAAC,MAAM;gBAChB,KAAK,EAAE,MAAA,MAAM,CAAC,MAAM,CAAC,KAAK,mCAAI,EAAE;aACjC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,oEAAoE;QACpE,OAAO,GAAG,yBAAyB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,kCAAkC;IAClC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,GAAG,OAAO,CAAC,MAAM;QACjB,OAAO;QACP,YAAY,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE;QACxC,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI;IACJ,WAAW;IACX,WAAW;CACZ,CAAC;AASF,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IAClC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/experiments/registry.d.ts

@@ -10,6 +10,11 @@ import type { ExperimentClient } from "./types";
 export interface CreateExperimentClientConfig {
     clientKey: string;
     apiHost?: string;
+    /**
+     * Initial user attributes for targeting.
+     * Used for segment-based targeting.
+     */
+    attributes?: Record<string, unknown>;
     /**
      * Callback fired when a user is assigned to an experiment.
      * Use this to send experiment data to your analytics provider.

package/dist/experiments/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/experiments/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,sBAAsB,GAGvB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,QAAQ,GAAmC;IAC/C,UAAU,EAAE,CAAC,MAAgC,EAAE,EAAE,CAC/C,sBAAsB,CAAC;QACrB,GAAG,MAAM;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;CACL,CAAC;AAYF;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,MAAoC;IAEpC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,gBAAgB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/experiments/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,sBAAsB,GAGvB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,QAAQ,GAAmC;IAC/C,UAAU,EAAE,CAAC,MAAgC,EAAE,EAAE,CAC/C,sBAAsB,CAAC;QACrB,GAAG,MAAM;QACT,QAAQ,EAAE,IAAI;KACf,CAAC;CACL,CAAC;AAiBF;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,MAAoC;IAEpC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,gBAAgB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from "./configFetcher";
 export * from "./overlays/types";
 export * from "./overlays/schema";
 export * from "./overlays/fetcher";
+export * from "./metrics";
 export { Syntro } from "./bootstrap";
 export type { SyntroInitOptions, SyntroInitResult } from "./bootstrap";
 export { encodeToken, decodeToken } from "./token";

package/dist/index.js

@@ -14,6 +14,8 @@ export * from "./configFetcher";
 export * from "./overlays/types";
 export * from "./overlays/schema";
 export * from "./overlays/fetcher";
+// Metrics for session-based targeting
+export * from "./metrics";
 // Single-token initialization
 export { Syntro } from "./bootstrap";
 export { encodeToken, decodeToken } from "./token";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAEnC,8BAA8B;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAEnC,sCAAsC;AACtC,cAAc,WAAW,CAAC;AAE1B,8BAA8B;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/metrics/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Metrics module for session-based real-time targeting.
+ */
+export { SessionMetricTracker, createSessionMetricTracker, type SessionMetricTrackerOptions, } from "./sessionMetrics";

package/dist/metrics/index.js

@@ -0,0 +1,5 @@
+/**
+ * Metrics module for session-based real-time targeting.
+ */
+export { SessionMetricTracker, createSessionMetricTracker, } from "./sessionMetrics";
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC"}

package/dist/metrics/sessionMetrics.d.ts

@@ -0,0 +1,101 @@
+/**
+ * SessionMetricTracker - Real-time session-based metrics for segment targeting.
+ *
+ * This module tracks metrics during a user's session and updates GrowthBook
+ * attributes in real-time, enabling instant segment targeting without waiting
+ * for batch PostHog cohort computation.
+ *
+ * Use cases:
+ * - "Show action plan after 3+ button clicks in this session"
+ * - "Target users who viewed 5+ products this session"
+ * - "Trigger intervention when user hovers a CTA 2+ times"
+ */
+import type { ExperimentClient } from "../experiments/types";
+/**
+ * Options for creating a SessionMetricTracker.
+ */
+export interface SessionMetricTrackerOptions {
+    /**
+     * The experiment client to update attributes on.
+     * When a metric changes, the session_${metricKey} attribute is updated.
+     */
+    experiments?: ExperimentClient;
+    /**
+     * Prefix for attribute keys sent to GrowthBook.
+     * @default "session_"
+     */
+    attributePrefix?: string;
+    /**
+     * Callback fired when any metric value changes.
+     * Useful for debugging or custom integrations.
+     */
+    onMetricChange?: (key: string, newValue: number) => void;
+}
+/**
+ * Tracks session-based metrics for real-time segment targeting.
+ */
+export declare class SessionMetricTracker {
+    private metrics;
+    private experiments?;
+    private attributePrefix;
+    private onMetricChange?;
+    constructor(options?: SessionMetricTrackerOptions);
+    /**
+     * Increment a metric by the specified amount.
+     *
+     * @param metricKey - The metric to increment (e.g., "button_clicks", "page_views")
+     * @param amount - Amount to increment by (default: 1)
+     * @returns The new metric value
+     */
+    increment(metricKey: string, amount?: number): number;
+    /**
+     * Set a metric to a specific value.
+     *
+     * @param metricKey - The metric to set
+     * @param value - The value to set
+     */
+    set(metricKey: string, value: number): void;
+    /**
+     * Get the current value of a metric.
+     *
+     * @param metricKey - The metric to get
+     * @returns The current value (0 if not set)
+     */
+    get(metricKey: string): number;
+    /**
+     * Check if a metric meets or exceeds a threshold.
+     *
+     * @param metricKey - The metric to check
+     * @param threshold - The threshold value
+     * @returns True if metric >= threshold
+     */
+    meetsThreshold(metricKey: string, threshold: number): boolean;
+    /**
+     * Get all current metric values.
+     *
+     * @returns Record of metric keys to values
+     */
+    getAll(): Record<string, number>;
+    /**
+     * Reset a specific metric to zero.
+     *
+     * @param metricKey - The metric to reset
+     */
+    reset(metricKey: string): void;
+    /**
+     * Reset all metrics (clear the session).
+     */
+    resetAll(): void;
+    /**
+     * Update the experiment client (useful if experiments client changes).
+     */
+    setExperiments(experiments: ExperimentClient): void;
+    private updateExperimentAttributes;
+    private syncAllToExperiments;
+    private loadFromStorage;
+    private saveToStorage;
+}
+/**
+ * Create a SessionMetricTracker instance.
+ */
+export declare function createSessionMetricTracker(options?: SessionMetricTrackerOptions): SessionMetricTracker;

package/dist/metrics/sessionMetrics.js

@@ -0,0 +1,178 @@
+/**
+ * SessionMetricTracker - Real-time session-based metrics for segment targeting.
+ *
+ * This module tracks metrics during a user's session and updates GrowthBook
+ * attributes in real-time, enabling instant segment targeting without waiting
+ * for batch PostHog cohort computation.
+ *
+ * Use cases:
+ * - "Show action plan after 3+ button clicks in this session"
+ * - "Target users who viewed 5+ products this session"
+ * - "Trigger intervention when user hovers a CTA 2+ times"
+ */
+const STORAGE_KEY = "syntro_session_metrics";
+/**
+ * Tracks session-based metrics for real-time segment targeting.
+ */
+export class SessionMetricTracker {
+    constructor(options = {}) {
+        var _a;
+        this.metrics = new Map();
+        this.experiments = options.experiments;
+        this.attributePrefix = (_a = options.attributePrefix) !== null && _a !== void 0 ? _a : "session_";
+        this.onMetricChange = options.onMetricChange;
+        // Restore metrics from sessionStorage
+        this.loadFromStorage();
+    }
+    /**
+     * Increment a metric by the specified amount.
+     *
+     * @param metricKey - The metric to increment (e.g., "button_clicks", "page_views")
+     * @param amount - Amount to increment by (default: 1)
+     * @returns The new metric value
+     */
+    increment(metricKey, amount = 1) {
+        var _a, _b;
+        const currentValue = (_a = this.metrics.get(metricKey)) !== null && _a !== void 0 ? _a : 0;
+        const newValue = currentValue + amount;
+        this.metrics.set(metricKey, newValue);
+        this.saveToStorage();
+        // Update GrowthBook attributes for real-time targeting
+        this.updateExperimentAttributes(metricKey, newValue);
+        // Fire callback if configured
+        (_b = this.onMetricChange) === null || _b === void 0 ? void 0 : _b.call(this, metricKey, newValue);
+        return newValue;
+    }
+    /**
+     * Set a metric to a specific value.
+     *
+     * @param metricKey - The metric to set
+     * @param value - The value to set
+     */
+    set(metricKey, value) {
+        var _a;
+        this.metrics.set(metricKey, value);
+        this.saveToStorage();
+        this.updateExperimentAttributes(metricKey, value);
+        (_a = this.onMetricChange) === null || _a === void 0 ? void 0 : _a.call(this, metricKey, value);
+    }
+    /**
+     * Get the current value of a metric.
+     *
+     * @param metricKey - The metric to get
+     * @returns The current value (0 if not set)
+     */
+    get(metricKey) {
+        var _a;
+        return (_a = this.metrics.get(metricKey)) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Check if a metric meets or exceeds a threshold.
+     *
+     * @param metricKey - The metric to check
+     * @param threshold - The threshold value
+     * @returns True if metric >= threshold
+     */
+    meetsThreshold(metricKey, threshold) {
+        return this.get(metricKey) >= threshold;
+    }
+    /**
+     * Get all current metric values.
+     *
+     * @returns Record of metric keys to values
+     */
+    getAll() {
+        return Object.fromEntries(this.metrics);
+    }
+    /**
+     * Reset a specific metric to zero.
+     *
+     * @param metricKey - The metric to reset
+     */
+    reset(metricKey) {
+        var _a;
+        this.metrics.delete(metricKey);
+        this.saveToStorage();
+        this.updateExperimentAttributes(metricKey, 0);
+        (_a = this.onMetricChange) === null || _a === void 0 ? void 0 : _a.call(this, metricKey, 0);
+    }
+    /**
+     * Reset all metrics (clear the session).
+     */
+    resetAll() {
+        var _a, _b, _c;
+        const keys = Array.from(this.metrics.keys());
+        this.metrics.clear();
+        this.saveToStorage();
+        // Update all attributes to 0
+        const attrs = {};
+        for (const key of keys) {
+            attrs[`${this.attributePrefix}${key}`] = 0;
+            (_a = this.onMetricChange) === null || _a === void 0 ? void 0 : _a.call(this, key, 0);
+        }
+        (_c = (_b = this.experiments) === null || _b === void 0 ? void 0 : _b.setAttributes) === null || _c === void 0 ? void 0 : _c.call(_b, attrs);
+    }
+    /**
+     * Update the experiment client (useful if experiments client changes).
+     */
+    setExperiments(experiments) {
+        this.experiments = experiments;
+        // Sync all current metrics to the new experiment client
+        this.syncAllToExperiments();
+    }
+    // ==================== Private Methods ====================
+    updateExperimentAttributes(metricKey, value) {
+        var _a;
+        if (!((_a = this.experiments) === null || _a === void 0 ? void 0 : _a.setAttributes))
+            return;
+        const attributeKey = `${this.attributePrefix}${metricKey}`;
+        this.experiments.setAttributes({ [attributeKey]: value });
+    }
+    syncAllToExperiments() {
+        var _a;
+        if (!((_a = this.experiments) === null || _a === void 0 ? void 0 : _a.setAttributes))
+            return;
+        const attrs = {};
+        for (const [key, value] of this.metrics) {
+            attrs[`${this.attributePrefix}${key}`] = value;
+        }
+        this.experiments.setAttributes(attrs);
+    }
+    loadFromStorage() {
+        if (typeof window === "undefined" || typeof sessionStorage === "undefined")
+            return;
+        try {
+            const stored = sessionStorage.getItem(STORAGE_KEY);
+            if (stored) {
+                const data = JSON.parse(stored);
+                for (const [key, value] of Object.entries(data)) {
+                    this.metrics.set(key, value.count);
+                }
+            }
+        }
+        catch (err) {
+            console.warn("[SessionMetricTracker] Failed to load from sessionStorage:", err);
+        }
+    }
+    saveToStorage() {
+        if (typeof window === "undefined" || typeof sessionStorage === "undefined")
+            return;
+        try {
+            const data = {};
+            for (const [key, count] of this.metrics) {
+                data[key] = { count, lastUpdated: Date.now() };
+            }
+            sessionStorage.setItem(STORAGE_KEY, JSON.stringify(data));
+        }
+        catch (err) {
+            console.warn("[SessionMetricTracker] Failed to save to sessionStorage:", err);
+        }
+    }
+}
+/**
+ * Create a SessionMetricTracker instance.
+ */
+export function createSessionMetricTracker(options = {}) {
+    return new SessionMetricTracker(options);
+}
+//# sourceMappingURL=sessionMetrics.js.map

package/dist/metrics/sessionMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionMetrics.js","sourceRoot":"","sources":["../../src/metrics/sessionMetrics.ts"],"names":[],"mappings":"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"}

package/dist/overlays/runtime/overlay/highlight.d.ts

@@ -7,4 +7,6 @@ export declare function showHighlight(anchorEl: HTMLElement, overlayRoot: HTMLEl
     scrimOpacity?: number;
     ringColor?: string;
     blocking?: boolean;
+    onClickOutside?: boolean;
+    onEsc?: boolean;
 }): HighlightHandle;

package/dist/overlays/runtime/overlay/highlight.js

@@ -1,22 +1,26 @@
 var _a;
 const supportsPathClip = typeof CSS !== "undefined" && ((_a = CSS.supports) === null || _a === void 0 ? void 0 : _a.call(CSS, "clip-path", "path('M0 0 H1 V1 Z')"));
 export function showHighlight(anchorEl, overlayRoot, opts) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     const padding = (_a = opts === null || opts === void 0 ? void 0 : opts.paddingPx) !== null && _a !== void 0 ? _a : 12;
     const radius = (_b = opts === null || opts === void 0 ? void 0 : opts.radiusPx) !== null && _b !== void 0 ? _b : 12;
     const opacity = Math.min(Math.max((_c = opts === null || opts === void 0 ? void 0 : opts.scrimOpacity) !== null && _c !== void 0 ? _c : 0.55, 0), 1);
     const ringColor = (_d = opts === null || opts === void 0 ? void 0 : opts.ringColor) !== null && _d !== void 0 ? _d : "var(--syntro-ring, #5b8cff)";
     const blocking = (_e = opts === null || opts === void 0 ? void 0 : opts.blocking) !== null && _e !== void 0 ? _e : false;
+    const onClickOutside = (_f = opts === null || opts === void 0 ? void 0 : opts.onClickOutside) !== null && _f !== void 0 ? _f : true; // Default to true for backwards compat
+    const onEsc = (_g = opts === null || opts === void 0 ? void 0 : opts.onEsc) !== null && _g !== void 0 ? _g : true; // Default to true for backwards compat
     const rootStyles = getComputedStyle(document.documentElement);
     const tokenScrim = rootStyles.getPropertyValue("--syntro-spotlight-backdrop").trim();
     const tokenRing = rootStyles.getPropertyValue("--syntro-ring").trim();
     const scrim = document.createElement("div");
     scrim.className = "syntro-spotlight-scrim";
+    // Enable pointer events if blocking OR if we want to dismiss on click outside
+    const needsPointerEvents = blocking || onClickOutside;
     Object.assign(scrim.style, {
         position: "fixed",
         inset: "0",
         zIndex: "2147483646",
-        pointerEvents: blocking ? "auto" : "none",
+        pointerEvents: needsPointerEvents ? "auto" : "none",
         background: tokenScrim || `rgba(2, 6, 23, ${opacity})`,
         transition: "opacity 220ms ease",
         opacity: "0",
@@ -118,18 +122,20 @@ export function showHighlight(anchorEl, overlayRoot, opts) {
     window.addEventListener("scroll", onScroll, true);
     window.addEventListener("resize", onResize);
     const onKey = (e) => {
-        if (e.key === "Escape")
+        if (e.key === "Escape" && onEsc)
             handle.destroy();
     };
-    window.addEventListener("keydown", onKey);
+    if (onEsc) {
+        window.addEventListener("keydown", onKey);
+    }
     const onClick = (event) => {
-        if (!blocking) {
-            handle.destroy();
-        }
-        else {
+        if (blocking) {
             event.preventDefault();
             event.stopPropagation();
         }
+        else if (onClickOutside) {
+            handle.destroy();
+        }
     };
     scrim.addEventListener("click", onClick);
     const handle = {
@@ -137,7 +143,9 @@ export function showHighlight(anchorEl, overlayRoot, opts) {
             ro.disconnect();
             window.removeEventListener("scroll", onScroll, true);
             window.removeEventListener("resize", onResize);
-            window.removeEventListener("keydown", onKey);
+            if (onEsc) {
+                window.removeEventListener("keydown", onKey);
+            }
             scrim.removeEventListener("click", onClick);
             scrim.style.opacity = "0";
             setTimeout(() => {