@syntrologie/runtime-sdk 0.2.20 → 0.2.21

package/dist/events/normalizers/posthog.js

@@ -0,0 +1,155 @@
+import { StandardEvents, EVENT_SCHEMA_VERSION } from "../types";
+/**
+ * Map PostHog event names to normalized event names.
+ */
+const POSTHOG_EVENT_MAP = {
+    // Autocapture events
+    $autocapture: "ui.click", // Default autocapture is usually clicks
+    $click: StandardEvents.UI_CLICK,
+    $scroll: StandardEvents.UI_SCROLL,
+    $input: StandardEvents.UI_INPUT,
+    $change: StandardEvents.UI_CHANGE,
+    $submit: StandardEvents.UI_SUBMIT,
+    // Navigation events
+    $pageview: StandardEvents.NAV_PAGE_VIEW,
+    $pageleave: StandardEvents.NAV_PAGE_LEAVE,
+    // Session events
+    $session_start: "session.start",
+    // Identify events
+    $identify: "user.identify",
+};
+/**
+ * Extract the normalized event name from a PostHog event.
+ */
+function getEventName(phEvent) {
+    var _a, _b;
+    const eventName = phEvent.event;
+    // Check mapped events
+    if (POSTHOG_EVENT_MAP[eventName]) {
+        return POSTHOG_EVENT_MAP[eventName];
+    }
+    // For autocapture, check the element type to determine the action
+    if (eventName === "$autocapture") {
+        const tagName = (_a = phEvent.properties) === null || _a === void 0 ? void 0 : _a.$tag_name;
+        const eventType = (_b = phEvent.properties) === null || _b === void 0 ? void 0 : _b.$event_type;
+        if (eventType === "submit")
+            return StandardEvents.UI_SUBMIT;
+        if (eventType === "change")
+            return StandardEvents.UI_CHANGE;
+        if (tagName === "input" || tagName === "textarea")
+            return StandardEvents.UI_INPUT;
+        return StandardEvents.UI_CLICK;
+    }
+    // For custom events, prefix with "posthog." to namespace them
+    if (!eventName.startsWith("$")) {
+        return `posthog.${eventName}`;
+    }
+    // Pass through other $ events as-is but normalized
+    return eventName.replace("$", "posthog.");
+}
+/**
+ * Extract relevant properties from a PostHog event.
+ */
+function extractProps(phEvent) {
+    const props = {};
+    const phProps = phEvent.properties || {};
+    // Element info
+    if (phProps.$tag_name)
+        props.tagName = phProps.$tag_name;
+    if (phProps.$el_text)
+        props.elementText = phProps.$el_text;
+    if (phProps.$elements)
+        props.elements = phProps.$elements;
+    // URL/page info
+    if (phProps.$current_url)
+        props.url = phProps.$current_url;
+    if (phProps.$pathname)
+        props.pathname = phProps.$pathname;
+    if (phProps.$host)
+        props.host = phProps.$host;
+    // Device/viewport info
+    if (phProps.$viewport_width)
+        props.viewportWidth = phProps.$viewport_width;
+    if (phProps.$viewport_height)
+        props.viewportHeight = phProps.$viewport_height;
+    // Session info
+    if (phProps.$session_id)
+        props.sessionId = phProps.$session_id;
+    // Scroll-specific properties
+    if (phProps.$scroll_depth)
+        props.scrollDepth = phProps.$scroll_depth;
+    if (phProps.$scroll_percentage)
+        props.scrollPercentage = phProps.$scroll_percentage;
+    // Original event name
+    props.originalEvent = phEvent.event;
+    return props;
+}
+/**
+ * Normalize a PostHog event into a NormalizedEvent.
+ */
+export function normalizePostHogEvent(phEvent) {
+    // Parse timestamp
+    let ts;
+    if (typeof phEvent.timestamp === "number") {
+        ts = phEvent.timestamp;
+    }
+    else if (typeof phEvent.timestamp === "string") {
+        ts = new Date(phEvent.timestamp).getTime();
+    }
+    else {
+        ts = Date.now();
+    }
+    return {
+        ts,
+        name: getEventName(phEvent),
+        source: "posthog",
+        props: extractProps(phEvent),
+        schemaVersion: EVENT_SCHEMA_VERSION,
+    };
+}
+/**
+ * Check if a PostHog event should be normalized.
+ * Filters out internal/system events that aren't useful for adaptives.
+ */
+export function shouldNormalizeEvent(phEvent) {
+    const eventName = phEvent.event;
+    // Skip internal PostHog events
+    const skipEvents = [
+        "$feature_flag_called",
+        "$feature_flags",
+        "$groups",
+        "$groupidentify",
+        "$set",
+        "$set_once",
+        "$unset",
+        "$create_alias",
+        "$capture_metrics",
+        "$performance_event",
+        "$web_vitals",
+        "$exception",
+        "$dead_click",
+        "$heatmap",
+    ];
+    if (skipEvents.includes(eventName)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Create a function that hooks into PostHog's onCapture callback
+ * and normalizes events into the EventBus.
+ */
+export function createPostHogNormalizer(publishFn) {
+    return (eventName, properties) => {
+        const phEvent = {
+            event: eventName,
+            properties,
+            timestamp: Date.now(),
+        };
+        if (shouldNormalizeEvent(phEvent)) {
+            const normalizedEvent = normalizePostHogEvent(phEvent);
+            publishFn(normalizedEvent);
+        }
+    };
+}
+//# sourceMappingURL=posthog.js.map

package/dist/events/normalizers/posthog.js.map

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

package/dist/events/schema.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Zod schemas for event validation.
+ */
+import { z } from "zod";
+export declare const EventSourceZ: z.ZodEnum<["posthog", "canvas", "derived"]>;
+export declare const NormalizedEventZ: z.ZodObject<{
+    ts: z.ZodNumber;
+    name: z.ZodString;
+    source: z.ZodEnum<["posthog", "canvas", "derived"]>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    schemaVersion: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "canvas" | "posthog" | "derived";
+    name: string;
+    ts: number;
+    schemaVersion: string;
+    props?: Record<string, unknown> | undefined;
+}, {
+    source: "canvas" | "posthog" | "derived";
+    name: string;
+    ts: number;
+    schemaVersion: string;
+    props?: Record<string, unknown> | undefined;
+}>;
+export declare const EventFilterZ: z.ZodObject<{
+    names: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["posthog", "canvas", "derived"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
+}, {
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
+}>;
+/**
+ * Validate a NormalizedEvent object.
+ */
+export declare function validateNormalizedEvent(data: unknown): z.SafeParseReturnType<{
+    source: "canvas" | "posthog" | "derived";
+    name: string;
+    ts: number;
+    schemaVersion: string;
+    props?: Record<string, unknown> | undefined;
+}, {
+    source: "canvas" | "posthog" | "derived";
+    name: string;
+    ts: number;
+    schemaVersion: string;
+    props?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Validate an EventFilter object.
+ */
+export declare function validateEventFilter(data: unknown): z.SafeParseReturnType<{
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
+}, {
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("canvas" | "posthog" | "derived")[] | undefined;
+}>;
+/**
+ * Type inference from Zod schema.
+ */
+export type NormalizedEventSchema = z.infer<typeof NormalizedEventZ>;
+export type EventFilterSchema = z.infer<typeof EventFilterZ>;

package/dist/events/schema.js

@@ -0,0 +1,30 @@
+/**
+ * Zod schemas for event validation.
+ */
+import { z } from "zod";
+export const EventSourceZ = z.enum(["posthog", "canvas", "derived"]);
+export const NormalizedEventZ = z.object({
+    ts: z.number(),
+    name: z.string(),
+    source: EventSourceZ,
+    props: z.record(z.unknown()).optional(),
+    schemaVersion: z.string(),
+});
+export const EventFilterZ = z.object({
+    names: z.array(z.string()).optional(),
+    patterns: z.array(z.string()).optional(),
+    sources: z.array(EventSourceZ).optional(),
+});
+/**
+ * Validate a NormalizedEvent object.
+ */
+export function validateNormalizedEvent(data) {
+    return NormalizedEventZ.safeParse(data);
+}
+/**
+ * Validate an EventFilter object.
+ */
+export function validateEventFilter(data) {
+    return EventFilterZ.safeParse(data);
+}
+//# sourceMappingURL=schema.js.map

package/dist/events/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/events/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAa;IACnD,OAAO,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/events/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Event Bus Types
+ *
+ * The EventBus provides a normalized event stream that unifies events from
+ * PostHog autocapture, Canvas events, and derived behavioral signals.
+ */
+/**
+ * Event sources in the runtime.
+ */
+export type EventSource = "posthog" | "canvas" | "derived";
+/**
+ * Normalized event structure for the event bus.
+ */
+export interface NormalizedEvent {
+    /** Event timestamp (milliseconds since epoch) */
+    ts: number;
+    /** Normalized event name (e.g., "ui.click", "canvas.opened") */
+    name: string;
+    /** Event source */
+    source: EventSource;
+    /** Event properties/payload */
+    props?: Record<string, unknown>;
+    /** Schema version for forward compatibility */
+    schemaVersion: string;
+}
+/**
+ * Event filter for subscriptions.
+ */
+export interface EventFilter {
+    /** Filter by event names (exact match) */
+    names?: string[];
+    /** Filter by event name patterns (regex) */
+    patterns?: string[];
+    /** Filter by sources */
+    sources?: EventSource[];
+}
+/**
+ * Callback for event subscriptions.
+ */
+export type EventCallback = (event: NormalizedEvent) => void;
+/**
+ * Unsubscribe function returned by subscribe().
+ */
+export type EventUnsubscribe = () => void;
+/**
+ * Standard event names used by the runtime.
+ */
+export declare const StandardEvents: {
+    readonly UI_CLICK: "ui.click";
+    readonly UI_SCROLL: "ui.scroll";
+    readonly UI_INPUT: "ui.input";
+    readonly UI_CHANGE: "ui.change";
+    readonly UI_SUBMIT: "ui.submit";
+    readonly NAV_PAGE_VIEW: "nav.page_view";
+    readonly NAV_PAGE_LEAVE: "nav.page_leave";
+    readonly CANVAS_OPENED: "canvas.opened";
+    readonly CANVAS_CLOSED: "canvas.closed";
+    readonly TILE_VIEWED: "tile.viewed";
+    readonly TILE_EXPANDED: "tile.expanded";
+    readonly TILE_COLLAPSED: "tile.collapsed";
+    readonly TILE_ACTION: "tile.action";
+    readonly OVERLAY_STARTED: "overlay.started";
+    readonly OVERLAY_COMPLETED: "overlay.completed";
+    readonly OVERLAY_DISMISSED: "overlay.dismissed";
+    readonly OVERLAY_STEP_VIEWED: "overlay.step_viewed";
+    readonly BEHAVIOR_RAGE_CLICK: "behavior.rage_click";
+    readonly BEHAVIOR_HESITATION: "behavior.hesitation";
+    readonly BEHAVIOR_CONFUSION: "behavior.confusion";
+};
+/**
+ * Current schema version for normalized events.
+ */
+export declare const EVENT_SCHEMA_VERSION = "1.0.0";

package/dist/events/types.js

@@ -0,0 +1,41 @@
+/**
+ * Event Bus Types
+ *
+ * The EventBus provides a normalized event stream that unifies events from
+ * PostHog autocapture, Canvas events, and derived behavioral signals.
+ */
+/**
+ * Standard event names used by the runtime.
+ */
+export const StandardEvents = {
+    // UI events (from PostHog autocapture)
+    UI_CLICK: "ui.click",
+    UI_SCROLL: "ui.scroll",
+    UI_INPUT: "ui.input",
+    UI_CHANGE: "ui.change",
+    UI_SUBMIT: "ui.submit",
+    // Navigation events
+    NAV_PAGE_VIEW: "nav.page_view",
+    NAV_PAGE_LEAVE: "nav.page_leave",
+    // Canvas events
+    CANVAS_OPENED: "canvas.opened",
+    CANVAS_CLOSED: "canvas.closed",
+    TILE_VIEWED: "tile.viewed",
+    TILE_EXPANDED: "tile.expanded",
+    TILE_COLLAPSED: "tile.collapsed",
+    TILE_ACTION: "tile.action",
+    // Overlay/tour events
+    OVERLAY_STARTED: "overlay.started",
+    OVERLAY_COMPLETED: "overlay.completed",
+    OVERLAY_DISMISSED: "overlay.dismissed",
+    OVERLAY_STEP_VIEWED: "overlay.step_viewed",
+    // Derived behavioral signals (Phase 3)
+    BEHAVIOR_RAGE_CLICK: "behavior.rage_click",
+    BEHAVIOR_HESITATION: "behavior.hesitation",
+    BEHAVIOR_CONFUSION: "behavior.confusion",
+};
+/**
+ * Current schema version for normalized events.
+ */
+export const EVENT_SCHEMA_VERSION = "1.0.0";
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,uCAAuC;IACvC,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IAEtB,oBAAoB;IACpB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAEhC,gBAAgB;IAChB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAE1B,sBAAsB;IACtB,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAE1C,uCAAuC;IACvC,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC"}

package/dist/hooks/useShadowCanvasConfig.d.ts

@@ -1,10 +1,14 @@
 import type { CanvasConfigFetcher, TileConfig, CanvasThemeConfig, LauncherConfig, RoutesConfig } from "../types";
 import type { Patch } from "../hostPatcher/core/types";
 import type { ExperimentClient } from "../experiments/types";
+import type { SmartCanvasRuntime } from "../runtime";
 export interface UseShadowCanvasConfigOptions {
     fetcher: CanvasConfigFetcher;
     pollIntervalMs?: number;
+    /** @deprecated Use runtime instead */
     experiments?: ExperimentClient;
+    /** v2 Runtime for activation-based filtering */
+    runtime?: SmartCanvasRuntime;
 }
 export interface ShadowCanvasConfigState {
     tiles: TileConfig[];
@@ -26,4 +30,4 @@ export interface ShadowCanvasConfigState {
     /** Route filtering configuration */
     routes?: RoutesConfig;
 }
-export declare function useShadowCanvasConfig({ fetcher, pollIntervalMs, experiments, }: UseShadowCanvasConfigOptions): ShadowCanvasConfigState;
+export declare function useShadowCanvasConfig({ fetcher, pollIntervalMs, experiments, runtime, }: UseShadowCanvasConfigOptions): ShadowCanvasConfigState;

package/dist/hooks/useShadowCanvasConfig.js

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
 const sortTiles = (tiles) => [...tiles].sort((a, b) => { var _a, _b; return ((_a = a.order) !== null && _a !== void 0 ? _a : 0) - ((_b = b.order) !== null && _b !== void 0 ? _b : 0); });
-export function useShadowCanvasConfig({ fetcher, pollIntervalMs = 30000, experiments, }) {
+export function useShadowCanvasConfig({ fetcher, pollIntervalMs = 30000, experiments, runtime, }) {
     const [state, setState] = useState({
         tiles: [],
         isLoading: true,
@@ -10,7 +10,21 @@ export function useShadowCanvasConfig({ fetcher, pollIntervalMs = 30000, experim
             setState((prev) => ({ ...prev, isLoading: true, error: undefined }));
             const response = await fetcher();
             let tiles = response.tiles || [];
-            if (experiments) {
+            // Update runtime routes config if provided
+            if (runtime && response.routes) {
+                runtime.setRoutes(response.routes);
+            }
+            // Filter tiles based on activation config (v2) or experiments (v1)
+            if (runtime) {
+                // v2: Use runtime's filterTiles which handles both activation.strategy and legacy experiment
+                tiles = await runtime.filterTiles(tiles);
+                // Also apply legacy experiment filter for backward compatibility
+                if (experiments) {
+                    tiles = tiles.filter((tile) => experiments.shouldRenderRectangle(tile));
+                }
+            }
+            else if (experiments) {
+                // v1: Use legacy experiment filtering only
                 tiles = tiles.filter((tile) => experiments.shouldRenderRectangle(tile));
             }
             setState({
@@ -34,7 +48,7 @@ export function useShadowCanvasConfig({ fetcher, pollIntervalMs = 30000, experim
                 error: err instanceof Error ? err.message : "Unknown error",
             }));
         }
-    }, [experiments, fetcher]);
+    }, [experiments, fetcher, runtime]);
     useEffect(() => {
         load();
         if (!pollIntervalMs)

package/dist/hooks/useShadowCanvasConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"useShadowCanvasConfig.js","sourceRoot":"","sources":["../../src/hooks/useShadowCanvasConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAgClE,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE,CACxC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,eAAC,OAAA,CAAC,MAAA,CAAC,CAAC,KAAK,mCAAI,CAAC,CAAC,GAAG,CAAC,MAAA,CAAC,CAAC,KAAK,mCAAI,CAAC,CAAC,CAAA,EAAA,CAAC,CAAC;AAE7D,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,cAAc,GAAG,KAAK,EACtB,WAAW,GACkB;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA0B;QAC1D,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,IAAI,CAAC;YACH,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YACrE,MAAM,QAAQ,GAAG,MAAM,OAAO,EAAE,CAAC;YACjC,IAAI,KAAK,GAAiB,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/C,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1E,CAAC;YACD,QAAQ,CAAC;gBACP,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;gBACvB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAClB,GAAG,IAAI;gBACP,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAC5D,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,cAAc;YAAE,OAAO;QAC5B,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAE3B,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"useShadowCanvasConfig.js","sourceRoot":"","sources":["../../src/hooks/useShadowCanvasConfig.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -15,6 +15,12 @@ export * from "./overlays/types";
 export * from "./overlays/schema";
 export * from "./overlays/fetcher";
 export * from "./metrics";
+export * from "./context";
+export * from "./events";
+export * from "./state";
+export * from "./decisions";
+export { createSmartCanvasRuntime, RUNTIME_VERSION, } from "./runtime";
+export type { SmartCanvasRuntime, SmartCanvasRuntimeOptions, RuntimeMode, } from "./runtime";
 export { Syntro } from "./bootstrap";
 export type { SyntroInitOptions, SyntroInitResult } from "./bootstrap";
 export { encodeToken, decodeToken } from "./token";

package/dist/index.js

@@ -16,7 +16,22 @@ export * from "./overlays/schema";
 export * from "./overlays/fetcher";
 // Metrics for session-based targeting
 export * from "./metrics";
+// ============================================================================
+// v2 Runtime Modules
+// ============================================================================
+// Context - Page/session/viewport state management
+export * from "./context";
+// Events - Normalized event stream
+export * from "./events";
+// State - Persistent state storage with helpers
+export * from "./state";
+// Decisions - Strategy-based conditional rendering
+export * from "./decisions";
+// Unified runtime
+export { createSmartCanvasRuntime, RUNTIME_VERSION, } from "./runtime";
+// ============================================================================
 // Single-token initialization
+// ============================================================================
 export { Syntro } from "./bootstrap";
 export { encodeToken, decodeToken } from "./token";
 //# sourceMappingURL=index.js.map

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,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"}
+{"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,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,mDAAmD;AACnD,cAAc,WAAW,CAAC;AAE1B,mCAAmC;AACnC,cAAc,UAAU,CAAC;AAEzB,gDAAgD;AAChD,cAAc,SAAS,CAAC;AAExB,mDAAmD;AACnD,cAAc,aAAa,CAAC;AAE5B,kBAAkB;AAClB,OAAO,EACL,wBAAwB,EACxB,eAAe,GAChB,MAAM,WAAW,CAAC;AAOnB,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}