@syntrologie/runtime-sdk 0.2.20 → 1.0.1-canary.0

package/dist/overlays/schema.d.ts

@@ -15,11 +15,11 @@ export declare const SelectorZ: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"css">;
     value: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    value: string;
     type: "css";
-}, {
     value: string;
+}, {
     type: "css";
+    value: string;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"aria">;
     role: z.ZodOptional<z.ZodString>;
@@ -36,11 +36,11 @@ export declare const SelectorZ: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"shadow-css">;
     value: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    value: string;
     type: "shadow-css";
-}, {
     value: string;
+}, {
     type: "shadow-css";
+    value: string;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"ref">;
     el: z.ZodAny;
@@ -70,11 +70,11 @@ export declare const TooltipStepZ: z.ZodObject<{
         type: z.ZodLiteral<"css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "css";
-    }, {
         value: string;
+    }, {
         type: "css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"aria">;
         role: z.ZodOptional<z.ZodString>;
@@ -91,11 +91,11 @@ export declare const TooltipStepZ: z.ZodObject<{
         type: z.ZodLiteral<"shadow-css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "shadow-css";
-    }, {
         value: string;
+    }, {
         type: "shadow-css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"ref">;
         el: z.ZodAny;
@@ -139,15 +139,15 @@ export declare const TooltipStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
@@ -173,15 +173,15 @@ export declare const TooltipStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
@@ -221,11 +221,11 @@ export declare const HighlightStepZ: z.ZodObject<{
         type: z.ZodLiteral<"css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "css";
-    }, {
         value: string;
+    }, {
         type: "css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"aria">;
         role: z.ZodOptional<z.ZodString>;
@@ -242,11 +242,11 @@ export declare const HighlightStepZ: z.ZodObject<{
         type: z.ZodLiteral<"shadow-css">;
         value: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        value: string;
         type: "shadow-css";
-    }, {
         value: string;
+    }, {
         type: "shadow-css";
+        value: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"ref">;
         el: z.ZodAny;
@@ -296,28 +296,28 @@ export declare const HighlightStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
     };
     kind: "highlight";
     id: string;
+    copy?: string | undefined;
     blocking?: boolean | undefined;
     dismiss?: {
         onEsc?: boolean | undefined;
         timeoutMs?: number | undefined;
         onClickOutside?: boolean | undefined;
     } | undefined;
-    copy?: string | undefined;
     ring?: {
         paddingPx?: number | undefined;
         radiusPx?: number | undefined;
@@ -332,28 +332,28 @@ export declare const HighlightStepZ: z.ZodObject<{
         key: string;
         value?: string | undefined;
     } | {
-        value: string;
         type: "css";
+        value: string;
     } | {
         type: "aria";
         label?: string | undefined;
         role?: string | undefined;
     } | {
-        value: string;
         type: "shadow-css";
+        value: string;
     } | {
         type: "ref";
         el?: any;
     };
     kind: "highlight";
     id: string;
+    copy?: string | undefined;
     blocking?: boolean | undefined;
     dismiss?: {
         onEsc?: boolean | undefined;
         timeoutMs?: number | undefined;
         onClickOutside?: boolean | undefined;
     } | undefined;
-    copy?: string | undefined;
     ring?: {
         paddingPx?: number | undefined;
         radiusPx?: number | undefined;
@@ -386,11 +386,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "css";
-        }, {
             value: string;
+        }, {
             type: "css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"aria">;
             role: z.ZodOptional<z.ZodString>;
@@ -407,11 +407,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"shadow-css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "shadow-css";
-        }, {
             value: string;
+        }, {
             type: "shadow-css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"ref">;
             el: z.ZodAny;
@@ -455,15 +455,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -489,15 +489,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -536,11 +536,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "css";
-        }, {
             value: string;
+        }, {
             type: "css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"aria">;
             role: z.ZodOptional<z.ZodString>;
@@ -557,11 +557,11 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             type: z.ZodLiteral<"shadow-css">;
             value: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            value: string;
             type: "shadow-css";
-        }, {
             value: string;
+        }, {
             type: "shadow-css";
+            value: string;
         }>, z.ZodObject<{
             type: z.ZodLiteral<"ref">;
             el: z.ZodAny;
@@ -611,28 +611,28 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
         };
         kind: "highlight";
         id: string;
+        copy?: string | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
             onEsc?: boolean | undefined;
             timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
-        copy?: string | undefined;
         ring?: {
             paddingPx?: number | undefined;
             radiusPx?: number | undefined;
@@ -647,28 +647,28 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
         };
         kind: "highlight";
         id: string;
+        copy?: string | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
             onEsc?: boolean | undefined;
             timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
-        copy?: string | undefined;
         ring?: {
             paddingPx?: number | undefined;
             radiusPx?: number | undefined;
@@ -685,15 +685,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -719,28 +719,28 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
         };
         kind: "highlight";
         id: string;
+        copy?: string | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
             onEsc?: boolean | undefined;
             timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
-        copy?: string | undefined;
         ring?: {
             paddingPx?: number | undefined;
             radiusPx?: number | undefined;
@@ -760,15 +760,15 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -794,28 +794,28 @@ export declare const CanvasRecipeZ: z.ZodObject<{
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
         };
         kind: "highlight";
         id: string;
+        copy?: string | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
             onEsc?: boolean | undefined;
             timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
-        copy?: string | undefined;
         ring?: {
             paddingPx?: number | undefined;
             radiusPx?: number | undefined;
@@ -836,15 +836,15 @@ export declare function validateRecipe(json: unknown): {
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
@@ -870,28 +870,28 @@ export declare function validateRecipe(json: unknown): {
             key: string;
             value?: string | undefined;
         } | {
-            value: string;
             type: "css";
+            value: string;
         } | {
             type: "aria";
             label?: string | undefined;
             role?: string | undefined;
         } | {
-            value: string;
             type: "shadow-css";
+            value: string;
         } | {
             type: "ref";
             el?: any;
         };
         kind: "highlight";
         id: string;
+        copy?: string | undefined;
         blocking?: boolean | undefined;
         dismiss?: {
             onEsc?: boolean | undefined;
             timeoutMs?: number | undefined;
             onClickOutside?: boolean | undefined;
         } | undefined;
-        copy?: string | undefined;
         ring?: {
             paddingPx?: number | undefined;
             radiusPx?: number | undefined;

package/dist/runtime.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SmartCanvasRuntime - Unified runtime for v2 adaptives.
+ *
+ * The runtime provides access to all core providers:
+ * - telemetry: Event tracking (PostHog)
+ * - context: Page/session/viewport state
+ * - events: Normalized event stream
+ * - state: Persistent state storage
+ *
+ * Note: ExperimentClient (GrowthBook) is NOT part of the runtime.
+ * GrowthBook's job is done at page load when it selects which config to deliver.
+ * The runtime receives the config and makes decisions using DecisionStrategy.
+ */
+import type { TelemetryClient } from "./telemetry/types";
+import { ContextManager } from "./context/ContextManager";
+import { EventBus } from "./events/EventBus";
+import { StateStore } from "./state/StateStore";
+import type { DecisionStrategy, DecisionResult } from "./decisions/types";
+import type { SessionMetricTracker } from "./metrics/sessionMetrics";
+import type { RoutesConfig, TileConfig } from "./types";
+/**
+ * Runtime version.
+ */
+export declare const RUNTIME_VERSION = "2.0.0";
+/**
+ * Runtime mode.
+ */
+export type RuntimeMode = "production" | "development" | "editor" | "audit";
+/**
+ * SmartCanvasRuntime interface.
+ */
+export interface SmartCanvasRuntime {
+    /** Telemetry client for event tracking */
+    telemetry?: TelemetryClient;
+    /** Context manager for page/session/viewport state */
+    context: ContextManager;
+    /** Event bus for normalized event stream */
+    events: EventBus;
+    /** State store for persistent state */
+    state: StateStore;
+    /** Session metric tracker (optional) */
+    sessionMetrics?: SessionMetricTracker;
+    /** Runtime version */
+    version: string;
+    /** Runtime mode */
+    mode: RuntimeMode;
+    /**
+     * Evaluate a decision strategy against the current context.
+     */
+    evaluate<T>(strategy: DecisionStrategy<T>): Promise<DecisionResult<T>>;
+    /**
+     * Synchronously evaluate a decision strategy (for simple strategies).
+     */
+    evaluateSync<T>(strategy: DecisionStrategy<T>): DecisionResult<T>;
+    /**
+     * Filter tiles based on their activation configs.
+     */
+    filterTiles(tiles: TileConfig[]): Promise<TileConfig[]>;
+    /**
+     * Update the routes config (e.g., when config is fetched).
+     */
+    setRoutes(routes: RoutesConfig): void;
+    /**
+     * Clean up runtime resources.
+     */
+    destroy(): void;
+}
+/**
+ * Options for creating a SmartCanvasRuntime.
+ */
+export interface SmartCanvasRuntimeOptions {
+    /** Telemetry client */
+    telemetry?: TelemetryClient;
+    /** Session metric tracker */
+    sessionMetrics?: SessionMetricTracker;
+    /** Initial routes config */
+    routes?: RoutesConfig;
+    /** Runtime mode */
+    mode?: RuntimeMode;
+    /** State namespace */
+    namespace?: string;
+}
+/**
+ * Create a SmartCanvasRuntime instance.
+ */
+export declare function createSmartCanvasRuntime(options?: SmartCanvasRuntimeOptions): SmartCanvasRuntime;

package/dist/runtime.js

@@ -0,0 +1,132 @@
+import { createContextManager } from "./context/ContextManager";
+import { createEventBus } from "./events/EventBus";
+import { createStateStore } from "./state/StateStore";
+import { createDecisionEngine } from "./decisions/engine";
+/**
+ * Runtime version.
+ */
+export const RUNTIME_VERSION = "2.0.0";
+/**
+ * Check if a URL matches a route filter.
+ */
+function matchesRouteFilter(url, filter) {
+    if (!filter)
+        return true;
+    // Extract pathname
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        pathname = url;
+    }
+    // Normalize pathname
+    const normalizedPath = pathname.replace(/\/$/, "") || "/";
+    // Check exclude patterns first
+    if (filter.exclude) {
+        for (const pattern of filter.exclude) {
+            if (matchRoutePattern(normalizedPath, pattern)) {
+                return false; // Explicitly excluded
+            }
+        }
+    }
+    // If include list exists, must match at least one
+    if (filter.include && filter.include.length > 0) {
+        for (const pattern of filter.include) {
+            if (matchRoutePattern(normalizedPath, pattern)) {
+                return true; // Matches include list
+            }
+        }
+        return false; // Didn't match any include pattern
+    }
+    // No include list, not excluded = pass
+    return true;
+}
+/**
+ * Match a pathname against a route pattern.
+ */
+function matchRoutePattern(pathname, pattern) {
+    const normalizedPattern = pattern.replace(/\/$/, "") || "/";
+    // Exact match
+    if (pathname === normalizedPattern)
+        return true;
+    // Convert pattern to regex
+    const regexPattern = normalizedPattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&") // Escape regex chars
+        .replace(/\*\*/g, ".*") // ** matches anything
+        .replace(/\*/g, "[^/]*") // * matches within path segment
+        .replace(/:[^/]+/g, "[^/]+"); // :param matches any segment
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(pathname);
+}
+/**
+ * Create a SmartCanvasRuntime instance.
+ */
+export function createSmartCanvasRuntime(options = {}) {
+    const { telemetry, sessionMetrics, routes, mode = "production", namespace } = options;
+    // Create core providers
+    const context = createContextManager({
+        telemetry,
+        routes,
+    });
+    const events = createEventBus();
+    const state = createStateStore({
+        namespace,
+    });
+    // Create decision engine with bound options
+    const decisionEngine = createDecisionEngine({
+        state,
+        events,
+        sessionMetrics,
+    });
+    const runtime = {
+        telemetry,
+        context,
+        events,
+        state,
+        sessionMetrics,
+        version: RUNTIME_VERSION,
+        mode,
+        async evaluate(strategy) {
+            return decisionEngine.evaluate(strategy, context.get());
+        },
+        evaluateSync(strategy) {
+            return decisionEngine.evaluateSync(strategy, context.get());
+        },
+        async filterTiles(tiles) {
+            const currentUrl = context.get().page.url;
+            const results = [];
+            for (const tile of tiles) {
+                const activation = tile.activation;
+                // If no activation config, tile always renders
+                if (!activation) {
+                    results.push(tile);
+                    continue;
+                }
+                // Check route filter first
+                if (!matchesRouteFilter(currentUrl, activation.routes)) {
+                    continue; // Doesn't match route filter
+                }
+                // If no strategy, tile renders (route filter passed)
+                if (!activation.strategy) {
+                    results.push(tile);
+                    continue;
+                }
+                // Evaluate strategy
+                const result = await this.evaluate(activation.strategy);
+                if (result.value) {
+                    results.push(tile);
+                }
+            }
+            return results;
+        },
+        setRoutes(routes) {
+            context.setRoutes(routes);
+        },
+        destroy() {
+            context.destroy();
+        },
+    };
+    return runtime;
+}
+//# sourceMappingURL=runtime.js.map