@syntrologie/runtime-sdk 0.2.19 → 0.2.21

package/dist/context/ContextManager.js

@@ -0,0 +1,268 @@
+/**
+ * Creates a default RuntimeContext.
+ */
+function createDefaultContext() {
+    const now = Date.now();
+    return {
+        page: {
+            url: typeof window !== "undefined" ? window.location.href : "",
+            title: typeof document !== "undefined" ? document.title : undefined,
+        },
+        session: {
+            sessionId: "",
+            startTs: now,
+            pageHistory: [],
+        },
+        viewport: {
+            width: typeof window !== "undefined" ? window.innerWidth : 0,
+            height: typeof window !== "undefined" ? window.innerHeight : 0,
+        },
+    };
+}
+/**
+ * Match a URL against route patterns from RoutesConfig.
+ * Returns the matched pattern or undefined.
+ */
+function matchRoute(url, routes) {
+    if (!routes)
+        return undefined;
+    // Extract pathname from URL
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        pathname = url;
+    }
+    // Check exclude patterns first
+    if (routes.exclude) {
+        for (const pattern of routes.exclude) {
+            if (matchPattern(pathname, pattern)) {
+                return undefined; // Excluded route
+            }
+        }
+    }
+    // Check include patterns
+    if (routes.include) {
+        for (const pattern of routes.include) {
+            if (matchPattern(pathname, pattern)) {
+                return pattern;
+            }
+        }
+        return undefined; // No match in include list
+    }
+    return pathname; // No include list, return pathname as route
+}
+/**
+ * Simple pattern matching for routes.
+ * Supports:
+ * - Exact matches: "/products"
+ * - Wildcard segments: "/products/*"
+ * - Parameter segments: "/products/:id"
+ */
+function matchPattern(pathname, pattern) {
+    // Normalize paths
+    const normalizedPath = pathname.replace(/\/$/, "") || "/";
+    const normalizedPattern = pattern.replace(/\/$/, "") || "/";
+    // Exact match
+    if (normalizedPath === normalizedPattern)
+        return true;
+    // Convert pattern to regex
+    const regexPattern = normalizedPattern
+        .replace(/:[^/]+/g, "[^/]+") // :param -> [^/]+
+        .replace(/\*/g, ".*"); // * -> .*
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(normalizedPath);
+}
+/**
+ * ContextManager class for managing runtime context.
+ */
+export class ContextManager {
+    constructor(options = {}) {
+        var _a;
+        this.listeners = new Set();
+        // Event listener cleanup functions
+        this.cleanupFns = [];
+        this.telemetry = options.telemetry;
+        this.routes = options.routes;
+        // Initialize context
+        this.context = createDefaultContext();
+        this.previousContext = { ...this.context };
+        // Set initial session ID from telemetry
+        if ((_a = options.telemetry) === null || _a === void 0 ? void 0 : _a.getSessionId) {
+            const sessionId = options.telemetry.getSessionId();
+            if (sessionId) {
+                this.context.session.sessionId = sessionId;
+            }
+        }
+        // Set initial page history
+        if (options.initialPageHistory) {
+            this.context.session.pageHistory = options.initialPageHistory;
+        }
+        // Set initial route ID
+        this.context.page.routeId = matchRoute(this.context.page.url, this.routes);
+        // Add current page to history
+        this.addPageToHistory(this.context.page.url);
+        // Setup browser event listeners
+        if (typeof window !== "undefined") {
+            this.setupBrowserListeners();
+        }
+    }
+    /**
+     * Get the current runtime context.
+     */
+    get() {
+        return { ...this.context };
+    }
+    /**
+     * Subscribe to context changes.
+     * Returns an unsubscribe function.
+     */
+    subscribe(callback) {
+        this.listeners.add(callback);
+        return () => {
+            this.listeners.delete(callback);
+        };
+    }
+    /**
+     * Update the routes config (e.g., when config is fetched).
+     */
+    setRoutes(routes) {
+        this.routes = routes;
+        // Re-evaluate current route
+        const newRouteId = matchRoute(this.context.page.url, this.routes);
+        if (newRouteId !== this.context.page.routeId) {
+            this.updateContext({ page: { ...this.context.page, routeId: newRouteId } });
+        }
+    }
+    /**
+     * Update anchor states.
+     */
+    setAnchors(anchors) {
+        this.updateContext({ anchors });
+    }
+    /**
+     * Manually update the session ID (e.g., when telemetry initializes).
+     */
+    setSessionId(sessionId) {
+        if (sessionId !== this.context.session.sessionId) {
+            this.updateContext({
+                session: { ...this.context.session, sessionId },
+            });
+        }
+    }
+    /**
+     * Clean up event listeners and subscriptions.
+     */
+    destroy() {
+        for (const cleanup of this.cleanupFns) {
+            cleanup();
+        }
+        this.cleanupFns = [];
+        this.listeners.clear();
+    }
+    // ==================== Private Methods ====================
+    setupBrowserListeners() {
+        // Viewport resize listener (debounced)
+        let resizeTimeout;
+        const handleResize = () => {
+            clearTimeout(resizeTimeout);
+            resizeTimeout = setTimeout(() => {
+                this.updateViewport();
+            }, 100);
+        };
+        window.addEventListener("resize", handleResize);
+        this.cleanupFns.push(() => window.removeEventListener("resize", handleResize));
+        // Navigation listener (popstate for back/forward)
+        const handlePopState = () => {
+            this.updatePage();
+        };
+        window.addEventListener("popstate", handlePopState);
+        this.cleanupFns.push(() => window.removeEventListener("popstate", handlePopState));
+        // History pushState/replaceState interception
+        const originalPushState = history.pushState.bind(history);
+        const originalReplaceState = history.replaceState.bind(history);
+        history.pushState = (...args) => {
+            originalPushState(...args);
+            this.updatePage();
+        };
+        history.replaceState = (...args) => {
+            originalReplaceState(...args);
+            this.updatePage();
+        };
+        this.cleanupFns.push(() => {
+            history.pushState = originalPushState;
+            history.replaceState = originalReplaceState;
+        });
+    }
+    updateViewport() {
+        const newViewport = {
+            width: window.innerWidth,
+            height: window.innerHeight,
+        };
+        if (newViewport.width !== this.context.viewport.width ||
+            newViewport.height !== this.context.viewport.height) {
+            this.updateContext({ viewport: newViewport });
+        }
+    }
+    updatePage() {
+        const url = window.location.href;
+        const title = document.title;
+        const routeId = matchRoute(url, this.routes);
+        const newPage = {
+            url,
+            title,
+            routeId,
+        };
+        // Only update if something changed
+        if (newPage.url !== this.context.page.url ||
+            newPage.title !== this.context.page.title ||
+            newPage.routeId !== this.context.page.routeId) {
+            // Add to page history if URL changed
+            if (newPage.url !== this.context.page.url) {
+                this.addPageToHistory(newPage.url);
+            }
+            this.updateContext({ page: newPage });
+        }
+    }
+    addPageToHistory(url) {
+        const entry = {
+            url,
+            ts: Date.now(),
+        };
+        const pageHistory = [...(this.context.session.pageHistory || []), entry];
+        // Keep last 50 pages in history
+        if (pageHistory.length > 50) {
+            pageHistory.shift();
+        }
+        this.context.session.pageHistory = pageHistory;
+    }
+    updateContext(partial) {
+        // Save previous context
+        this.previousContext = { ...this.context };
+        // Merge updates
+        this.context = {
+            ...this.context,
+            ...partial,
+        };
+        // Notify listeners
+        this.notifyListeners();
+    }
+    notifyListeners() {
+        for (const callback of this.listeners) {
+            try {
+                callback(this.context, this.previousContext);
+            }
+            catch (err) {
+                console.error("[ContextManager] Listener error:", err);
+            }
+        }
+    }
+}
+/**
+ * Create a ContextManager instance.
+ */
+export function createContextManager(options = {}) {
+    return new ContextManager(options);
+}
+//# sourceMappingURL=ContextManager.js.map

package/dist/context/ContextManager.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Context module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { ContextManager, createContextManager } from "./ContextManager";
+export type { ContextManagerOptions } from "./ContextManager";

package/dist/context/index.js

@@ -0,0 +1,7 @@
+/**
+ * Context module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { ContextManager, createContextManager } from "./ContextManager";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/context/schema.d.ts

@@ -0,0 +1,360 @@
+/**
+ * Zod schemas for RuntimeContext validation.
+ */
+import { z } from "zod";
+export declare const PageContextZ: z.ZodObject<{
+    url: z.ZodString;
+    routeId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    title?: string | undefined;
+    routeId?: string | undefined;
+    locale?: string | undefined;
+}, {
+    url: string;
+    title?: string | undefined;
+    routeId?: string | undefined;
+    locale?: string | undefined;
+}>;
+export declare const PageHistoryEntryZ: z.ZodObject<{
+    url: z.ZodString;
+    ts: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    ts: number;
+}, {
+    url: string;
+    ts: number;
+}>;
+export declare const SessionContextZ: z.ZodObject<{
+    sessionId: z.ZodString;
+    startTs: z.ZodNumber;
+    pageHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        ts: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        ts: number;
+    }, {
+        url: string;
+        ts: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    startTs: number;
+    pageHistory?: {
+        url: string;
+        ts: number;
+    }[] | undefined;
+}, {
+    sessionId: string;
+    startTs: number;
+    pageHistory?: {
+        url: string;
+        ts: number;
+    }[] | undefined;
+}>;
+export declare const ViewportContextZ: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+}, {
+    width: number;
+    height: number;
+}>;
+export declare const BoundingBoxZ: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>;
+export declare const AnchorStateZ: z.ZodObject<{
+    anchorId: z.ZodString;
+    present: z.ZodBoolean;
+    visible: z.ZodOptional<z.ZodBoolean>;
+    boundingBox: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    present: boolean;
+    anchorId: string;
+    visible?: boolean | undefined;
+    boundingBox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+}, {
+    present: boolean;
+    anchorId: string;
+    visible?: boolean | undefined;
+    boundingBox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+}>;
+export declare const AugmentationZ: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodUndefined]>>;
+export declare const RuntimeContextZ: z.ZodObject<{
+    page: z.ZodObject<{
+        url: z.ZodString;
+        routeId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        title?: string | undefined;
+        routeId?: string | undefined;
+        locale?: string | undefined;
+    }, {
+        url: string;
+        title?: string | undefined;
+        routeId?: string | undefined;
+        locale?: string | undefined;
+    }>;
+    session: z.ZodObject<{
+        sessionId: z.ZodString;
+        startTs: z.ZodNumber;
+        pageHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            ts: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            ts: number;
+        }, {
+            url: string;
+            ts: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        sessionId: string;
+        startTs: number;
+        pageHistory?: {
+            url: string;
+            ts: number;
+        }[] | undefined;
+    }, {
+        sessionId: string;
+        startTs: number;
+        pageHistory?: {
+            url: string;
+            ts: number;
+        }[] | undefined;
+    }>;
+    viewport: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>;
+    anchors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        anchorId: z.ZodString;
+        present: z.ZodBoolean;
+        visible: z.ZodOptional<z.ZodBoolean>;
+        boundingBox: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        present: boolean;
+        anchorId: string;
+        visible?: boolean | undefined;
+        boundingBox?: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        } | undefined;
+    }, {
+        present: boolean;
+        anchorId: string;
+        visible?: boolean | undefined;
+        boundingBox?: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        } | undefined;
+    }>, "many">>;
+    augmented: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodUndefined]>>>;
+}, "strip", z.ZodTypeAny, {
+    viewport: {
+        width: number;
+        height: number;
+    };
+    page: {
+        url: string;
+        title?: string | undefined;
+        routeId?: string | undefined;
+        locale?: string | undefined;
+    };
+    session: {
+        sessionId: string;
+        startTs: number;
+        pageHistory?: {
+            url: string;
+            ts: number;
+        }[] | undefined;
+    };
+    anchors?: {
+        present: boolean;
+        anchorId: string;
+        visible?: boolean | undefined;
+        boundingBox?: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        } | undefined;
+    }[] | undefined;
+    augmented?: Record<string, string | number | boolean | undefined> | undefined;
+}, {
+    viewport: {
+        width: number;
+        height: number;
+    };
+    page: {
+        url: string;
+        title?: string | undefined;
+        routeId?: string | undefined;
+        locale?: string | undefined;
+    };
+    session: {
+        sessionId: string;
+        startTs: number;
+        pageHistory?: {
+            url: string;
+            ts: number;
+        }[] | undefined;
+    };
+    anchors?: {
+        present: boolean;
+        anchorId: string;
+        visible?: boolean | undefined;
+        boundingBox?: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        } | undefined;
+    }[] | undefined;
+    augmented?: Record<string, string | number | boolean | undefined> | undefined;
+}>;
+/**
+ * Validate a RuntimeContext object.
+ */
+export declare function validateRuntimeContext(data: unknown): z.SafeParseReturnType<{
+    viewport: {
+        width: number;
+        height: number;
+    };
+    page: {
+        url: string;
+        title?: string | undefined;
+        routeId?: string | undefined;
+        locale?: string | undefined;
+    };
+    session: {
+        sessionId: string;
+        startTs: number;
+        pageHistory?: {
+            url: string;
+            ts: number;
+        }[] | undefined;
+    };
+    anchors?: {
+        present: boolean;
+        anchorId: string;
+        visible?: boolean | undefined;
+        boundingBox?: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        } | undefined;
+    }[] | undefined;
+    augmented?: Record<string, string | number | boolean | undefined> | undefined;
+}, {
+    viewport: {
+        width: number;
+        height: number;
+    };
+    page: {
+        url: string;
+        title?: string | undefined;
+        routeId?: string | undefined;
+        locale?: string | undefined;
+    };
+    session: {
+        sessionId: string;
+        startTs: number;
+        pageHistory?: {
+            url: string;
+            ts: number;
+        }[] | undefined;
+    };
+    anchors?: {
+        present: boolean;
+        anchorId: string;
+        visible?: boolean | undefined;
+        boundingBox?: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        } | undefined;
+    }[] | undefined;
+    augmented?: Record<string, string | number | boolean | undefined> | undefined;
+}>;
+/**
+ * Type inference from Zod schema.
+ */
+export type RuntimeContextSchema = z.infer<typeof RuntimeContextZ>;
+export type PageContextSchema = z.infer<typeof PageContextZ>;
+export type SessionContextSchema = z.infer<typeof SessionContextZ>;
+export type ViewportContextSchema = z.infer<typeof ViewportContextZ>;
+export type AnchorStateSchema = z.infer<typeof AnchorStateZ>;