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

package/dist/editorLoader.js

@@ -1,3 +1,4 @@
+import { debug, warn } from "./logger";
 export const DEFAULT_EDITOR_URL = "https://cdn.syntrologie.com/editor-sdk/latest/editor-sdk.js";
 /**
  * Allowed hosts for loading the editor SDK.
@@ -17,18 +18,18 @@ const ALLOWED_EDITOR_HOSTS = [
  * Requires HTTPS for non-localhost URLs.
  */
 function validateEditorUrl(url) {
-    console.log('[Syntro Runtime] Validating editor URL:', url);
+    debug('Syntro Runtime', 'Validating editor URL:', url);
     try {
         const parsed = new URL(url);
         const isLocalhost = /^(localhost|127\.0\.0\.1)$/.test(parsed.hostname);
-        console.log('[Syntro Runtime] Parsed URL:', {
+        debug('Syntro Runtime', 'Parsed URL:', {
             hostname: parsed.hostname,
             protocol: parsed.protocol,
             isLocalhost,
         });
         // Require HTTPS for non-localhost
         if (parsed.protocol !== 'https:' && !isLocalhost) {
-            console.warn('[Syntro Runtime] ❌ Editor URL must use HTTPS:', url);
+            warn('Syntro Runtime', '❌ Editor URL must use HTTPS:', url);
             return false;
         }
         // Check against allowlist - handle both exact match and suffix match
@@ -39,20 +40,20 @@ function validateEditorUrl(url) {
             }
             return parsed.hostname === host;
         });
-        console.log('[Syntro Runtime] Host allowlist check:', {
+        debug('Syntro Runtime', 'Host allowlist check:', {
             hostname: parsed.hostname,
             allowedHosts: ALLOWED_EDITOR_HOSTS,
             isAllowed,
         });
         if (!isAllowed) {
-            console.warn('[Syntro Runtime] ❌ Editor URL host not in allowlist:', parsed.hostname);
+            warn('Syntro Runtime', '❌ Editor URL host not in allowlist:', parsed.hostname);
             return false;
         }
-        console.log('[Syntro Runtime] ✓ Editor URL validated');
+        debug('Syntro Runtime', '✓ Editor URL validated');
         return true;
     }
     catch (e) {
-        console.warn('[Syntro Runtime] ❌ Invalid editor URL:', url, e);
+        warn('Syntro Runtime', '❌ Invalid editor URL: ' + url, e);
         return false;
     }
 }
@@ -62,18 +63,18 @@ function validateEditorUrl(url) {
  */
 export const shouldLoadEditor = () => {
     var _a;
-    console.log('[Syntro Runtime] ====== EDITOR LOAD CHECK ======');
+    debug('Syntro Runtime', '====== EDITOR LOAD CHECK ======');
     if (typeof window === "undefined") {
-        console.log('[Syntro Runtime] Not in browser - skipping editor');
+        debug('Syntro Runtime', 'Not in browser - skipping editor');
         return false;
     }
     const params = new URLSearchParams(window.location.search);
-    console.log('[Syntro Runtime] URL:', window.location.href);
-    console.log('[Syntro Runtime] Search params:', window.location.search);
+    debug('Syntro Runtime', 'URL:', window.location.href);
+    debug('Syntro Runtime', 'Search params:', window.location.search);
     // Require editor_token for security - prevents arbitrary editor activation
     const hasEditorFlag = params.has("syntro_editor") || params.has("syntro-editor");
     const hasEditorToken = params.has("editor_token");
-    console.log('[Syntro Runtime] Editor flags:', {
+    debug('Syntro Runtime', 'Editor flags:', {
         hasEditorFlag,
         hasEditorToken,
         syntro_editor: params.get("syntro_editor"),
@@ -81,28 +82,66 @@ export const shouldLoadEditor = () => {
         editor_token: hasEditorToken ? `${(_a = params.get("editor_token")) === null || _a === void 0 ? void 0 : _a.slice(0, 10)}...` : 'none',
     });
     if (hasEditorFlag && !hasEditorToken) {
-        console.warn('[Syntro Runtime] ❌ Editor activation requires editor_token parameter');
-        console.log('[Syntro Runtime] ================================');
+        warn('Syntro Runtime', '❌ Editor activation requires editor_token parameter');
+        debug('Syntro Runtime', '================================');
         return false;
     }
     const shouldLoad = hasEditorFlag && hasEditorToken;
-    console.log('[Syntro Runtime] Should load editor:', shouldLoad);
-    console.log('[Syntro Runtime] ================================');
+    debug('Syntro Runtime', 'Should load editor:', shouldLoad);
+    debug('Syntro Runtime', '================================');
     return shouldLoad;
 };
+/**
+ * Checks if audit mode should be activated based on URL query parameters.
+ * Audit mode enables element marking for product touring.
+ */
+export const isAuditMode = () => {
+    debug('Syntro Runtime', '====== AUDIT MODE CHECK ======');
+    if (typeof window === "undefined") {
+        debug('Syntro Runtime', 'Not in browser - skipping audit');
+        return false;
+    }
+    const params = new URLSearchParams(window.location.search);
+    const hasAuditFlag = params.has("syntro_audit");
+    const auditSessionId = params.get("audit_session_id");
+    debug('Syntro Runtime', 'Audit flags:', {
+        hasAuditFlag,
+        auditSessionId: auditSessionId ? `${auditSessionId.slice(0, 8)}...` : 'none',
+    });
+    // Require syntro_audit flag to activate audit mode
+    if (!hasAuditFlag) {
+        debug('Syntro Runtime', 'No syntro_audit param - not in audit mode');
+        debug('Syntro Runtime', '================================');
+        return false;
+    }
+    debug('Syntro Runtime', '✓ Audit mode active');
+    debug('Syntro Runtime', '================================');
+    return true;
+};
+/**
+ * Checks if any SDK mode (editor or audit) should be loaded.
+ * Returns the mode type if active, or null if neither.
+ */
+export const getActiveSdkMode = () => {
+    if (shouldLoadEditor())
+        return 'editor';
+    if (isAuditMode())
+        return 'audit';
+    return null;
+};
 /**
  * Dynamically loads the Editor SDK script.
  * Validates URL against allowlist and supports SRI integrity checking.
  */
 export const loadEditorSdk = async (editorUrlOrOptions) => {
     var _a;
-    console.log('[Syntro Runtime] ====== LOAD EDITOR SDK ======');
+    debug('Syntro Runtime', '====== LOAD EDITOR SDK ======');
     if (typeof window === "undefined") {
-        console.log('[Syntro Runtime] Not in browser - skipping editor SDK load');
+        debug('Syntro Runtime', 'Not in browser - skipping editor SDK load');
         return;
     }
     if (window.SyntroEditor) {
-        console.log('[Syntro Runtime] Editor SDK already loaded (window.SyntroEditor exists)');
+        debug('Syntro Runtime', 'Editor SDK already loaded (window.SyntroEditor exists)');
         return;
     }
     // Handle both legacy string arg and new options object
@@ -110,18 +149,18 @@ export const loadEditorSdk = async (editorUrlOrOptions) => {
         ? { editorUrl: editorUrlOrOptions }
         : editorUrlOrOptions !== null && editorUrlOrOptions !== void 0 ? editorUrlOrOptions : {};
     const editorUrl = (_a = options.editorUrl) !== null && _a !== void 0 ? _a : DEFAULT_EDITOR_URL;
-    console.log('[Syntro Runtime] Editor URL:', editorUrl);
-    console.log('[Syntro Runtime] Options:', {
+    debug('Syntro Runtime', 'Editor URL:', editorUrl);
+    debug('Syntro Runtime', 'Options:', {
         hasIntegrity: !!options.integrity,
         isDefault: editorUrl === DEFAULT_EDITOR_URL,
     });
     // Security: Validate URL against allowlist
     if (!validateEditorUrl(editorUrl)) {
         console.error('[Syntro Runtime] ❌ BLOCKED: Editor from untrusted URL:', editorUrl);
-        console.log('[Syntro Runtime] ================================');
+        debug('Syntro Runtime', '================================');
         return;
     }
-    console.log('[Syntro Runtime] ✓ URL validated, injecting script tag...');
+    debug('Syntro Runtime', '✓ URL validated, injecting script tag...');
     return new Promise((resolve, reject) => {
         const script = document.createElement("script");
         script.src = editorUrl;
@@ -130,23 +169,23 @@ export const loadEditorSdk = async (editorUrlOrOptions) => {
         if (options.integrity) {
             script.integrity = options.integrity;
             script.crossOrigin = "anonymous";
-            console.log('[Syntro Runtime] SRI integrity check enabled');
+            debug('Syntro Runtime', 'SRI integrity check enabled');
         }
         script.onload = () => {
-            console.log('[Syntro Runtime] ✓ Editor SDK script loaded successfully');
-            console.log('[Syntro Runtime] window.SyntroEditor:', !!window.SyntroEditor);
-            console.log('[Syntro Runtime] ================================');
+            debug('Syntro Runtime', '✓ Editor SDK script loaded successfully');
+            debug('Syntro Runtime', 'window.SyntroEditor:', !!window.SyntroEditor);
+            debug('Syntro Runtime', '================================');
             resolve();
         };
         script.onerror = (err) => {
             console.error('[Syntro Runtime] ❌ Failed to load Editor SDK:', err);
             console.error('[Syntro Runtime] URL attempted:', editorUrl);
             console.error('[Syntro Runtime] Check: Is the URL accessible? CORS? Network?');
-            console.log('[Syntro Runtime] ================================');
+            debug('Syntro Runtime', '================================');
             reject(err);
         };
         document.head.appendChild(script);
-        console.log('[Syntro Runtime] Script tag appended to <head>');
+        debug('Syntro Runtime', 'Script tag appended to <head>');
     });
 };
 //# sourceMappingURL=editorLoader.js.map

package/dist/editorLoader.js.map

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

package/dist/events/EventBus.d.ts

@@ -0,0 +1,59 @@
+/**
+ * EventBus - Normalized event stream for the runtime.
+ *
+ * The EventBus provides:
+ * - Publish/subscribe for normalized events
+ * - Event history for recent event lookups
+ * - Filtering by name, pattern, or source
+ */
+import type { NormalizedEvent, EventFilter, EventCallback, EventUnsubscribe } from "./types";
+export interface EventBusOptions {
+    /** Maximum number of events to keep in history */
+    maxHistorySize?: number;
+}
+/**
+ * EventBus class for managing normalized events.
+ */
+export declare class EventBus {
+    private subscriptions;
+    private history;
+    private maxHistorySize;
+    constructor(options?: EventBusOptions);
+    /**
+     * Subscribe to events matching an optional filter.
+     * Returns an unsubscribe function.
+     */
+    subscribe(filterOrCallback: EventFilter | EventCallback, maybeCallback?: EventCallback): EventUnsubscribe;
+    /**
+     * Publish an event to all matching subscribers.
+     */
+    publish(name: string, props?: Record<string, unknown>, source?: NormalizedEvent["source"]): void;
+    /**
+     * Publish a pre-constructed NormalizedEvent.
+     */
+    publishEvent(event: NormalizedEvent): void;
+    /**
+     * Get recent events matching an optional filter.
+     */
+    getRecent(filter?: EventFilter, limit?: number): NormalizedEvent[];
+    /**
+     * Check if an event with a specific name occurred within a time window.
+     */
+    hasRecentEvent(eventName: string, withinMs: number, source?: NormalizedEvent["source"]): boolean;
+    /**
+     * Count events matching a filter within a time window.
+     */
+    countRecentEvents(filter: EventFilter, withinMs?: number): number;
+    /**
+     * Clear all event history.
+     */
+    clearHistory(): void;
+    /**
+     * Get the number of current subscribers.
+     */
+    getSubscriberCount(): number;
+}
+/**
+ * Create an EventBus instance.
+ */
+export declare function createEventBus(options?: EventBusOptions): EventBus;

package/dist/events/EventBus.js

@@ -0,0 +1,154 @@
+import { EVENT_SCHEMA_VERSION } from "./types";
+/**
+ * Check if an event matches a filter.
+ */
+function matchesFilter(event, filter) {
+    if (!filter)
+        return true;
+    // Check name filter
+    if (filter.names && filter.names.length > 0) {
+        if (!filter.names.includes(event.name)) {
+            return false;
+        }
+    }
+    // Check pattern filter
+    if (filter.patterns && filter.patterns.length > 0) {
+        const matched = filter.patterns.some((pattern) => {
+            try {
+                const regex = new RegExp(pattern);
+                return regex.test(event.name);
+            }
+            catch {
+                return false;
+            }
+        });
+        if (!matched)
+            return false;
+    }
+    // Check source filter
+    if (filter.sources && filter.sources.length > 0) {
+        if (!filter.sources.includes(event.source)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * EventBus class for managing normalized events.
+ */
+export class EventBus {
+    constructor(options = {}) {
+        var _a;
+        this.subscriptions = new Set();
+        this.history = [];
+        this.maxHistorySize = (_a = options.maxHistorySize) !== null && _a !== void 0 ? _a : 100;
+    }
+    /**
+     * Subscribe to events matching an optional filter.
+     * Returns an unsubscribe function.
+     */
+    subscribe(filterOrCallback, maybeCallback) {
+        let filter;
+        let callback;
+        // Handle overloaded signatures
+        if (typeof filterOrCallback === "function") {
+            filter = undefined;
+            callback = filterOrCallback;
+        }
+        else {
+            filter = filterOrCallback;
+            callback = maybeCallback;
+        }
+        const subscription = { filter, callback };
+        this.subscriptions.add(subscription);
+        return () => {
+            this.subscriptions.delete(subscription);
+        };
+    }
+    /**
+     * Publish an event to all matching subscribers.
+     */
+    publish(name, props, source = "canvas") {
+        const event = {
+            ts: Date.now(),
+            name,
+            source,
+            props,
+            schemaVersion: EVENT_SCHEMA_VERSION,
+        };
+        this.publishEvent(event);
+    }
+    /**
+     * Publish a pre-constructed NormalizedEvent.
+     */
+    publishEvent(event) {
+        // Add to history
+        this.history.push(event);
+        if (this.history.length > this.maxHistorySize) {
+            this.history.shift();
+        }
+        // Notify matching subscribers
+        for (const subscription of this.subscriptions) {
+            if (matchesFilter(event, subscription.filter)) {
+                try {
+                    subscription.callback(event);
+                }
+                catch (err) {
+                    console.error("[EventBus] Subscriber error:", err);
+                }
+            }
+        }
+    }
+    /**
+     * Get recent events matching an optional filter.
+     */
+    getRecent(filter, limit) {
+        let events = this.history;
+        if (filter) {
+            events = events.filter((e) => matchesFilter(e, filter));
+        }
+        if (limit && limit > 0) {
+            events = events.slice(-limit);
+        }
+        return events;
+    }
+    /**
+     * Check if an event with a specific name occurred within a time window.
+     */
+    hasRecentEvent(eventName, withinMs, source) {
+        const cutoff = Date.now() - withinMs;
+        return this.history.some((e) => e.name === eventName &&
+            e.ts >= cutoff &&
+            (source === undefined || e.source === source));
+    }
+    /**
+     * Count events matching a filter within a time window.
+     */
+    countRecentEvents(filter, withinMs) {
+        let events = this.history.filter((e) => matchesFilter(e, filter));
+        if (withinMs !== undefined) {
+            const cutoff = Date.now() - withinMs;
+            events = events.filter((e) => e.ts >= cutoff);
+        }
+        return events.length;
+    }
+    /**
+     * Clear all event history.
+     */
+    clearHistory() {
+        this.history = [];
+    }
+    /**
+     * Get the number of current subscribers.
+     */
+    getSubscriberCount() {
+        return this.subscriptions.size;
+    }
+}
+/**
+ * Create an EventBus instance.
+ */
+export function createEventBus(options = {}) {
+    return new EventBus(options);
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/events/EventBus.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Events module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { EventBus, createEventBus } from "./EventBus";
+export type { EventBusOptions } from "./EventBus";
+export { normalizePostHogEvent, shouldNormalizeEvent, createPostHogNormalizer, } from "./normalizers/posthog";
+export { CanvasEvents } from "./normalizers/canvas";

package/dist/events/index.js

@@ -0,0 +1,10 @@
+/**
+ * Events module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { EventBus, createEventBus } from "./EventBus";
+// Normalizers
+export { normalizePostHogEvent, shouldNormalizeEvent, createPostHogNormalizer, } from "./normalizers/posthog";
+export { CanvasEvents } from "./normalizers/canvas";
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGtD,cAAc;AACd,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/events/normalizers/canvas.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Canvas Event Normalizer
+ *
+ * Transforms Smart Canvas events into normalized events for the EventBus.
+ */
+import type { NormalizedEvent } from "../types";
+import type { CanvasSurface } from "../../telemetry/types";
+/**
+ * Canvas opened event.
+ */
+export declare function canvasOpened(surface: CanvasSurface): NormalizedEvent;
+/**
+ * Canvas closed event.
+ */
+export declare function canvasClosed(surface: CanvasSurface): NormalizedEvent;
+/**
+ * Tile viewed event.
+ */
+export declare function tileViewed(tileId: string, surface: CanvasSurface): NormalizedEvent;
+/**
+ * Tile expanded event.
+ */
+export declare function tileExpanded(tileId: string, surface: CanvasSurface): NormalizedEvent;
+/**
+ * Tile collapsed event.
+ */
+export declare function tileCollapsed(tileId: string, surface: CanvasSurface): NormalizedEvent;
+/**
+ * Tile action event.
+ */
+export declare function tileAction(tileId: string, actionId: string, surface: CanvasSurface): NormalizedEvent;
+/**
+ * Overlay/tour started event.
+ */
+export declare function overlayStarted(recipeId: string, recipeName?: string): NormalizedEvent;
+/**
+ * Overlay/tour completed event.
+ */
+export declare function overlayCompleted(recipeId: string, recipeName?: string): NormalizedEvent;
+/**
+ * Overlay/tour dismissed event.
+ */
+export declare function overlayDismissed(recipeId: string, recipeName?: string, stepIndex?: number): NormalizedEvent;
+/**
+ * Overlay step viewed event.
+ */
+export declare function overlayStepViewed(recipeId: string, stepIndex: number, stepTitle?: string): NormalizedEvent;
+/**
+ * Create a custom canvas event.
+ */
+export declare function customCanvasEvent(name: string, props?: Record<string, unknown>): NormalizedEvent;
+/**
+ * Canvas event factory for easy event creation.
+ */
+export declare const CanvasEvents: {
+    canvasOpened: typeof canvasOpened;
+    canvasClosed: typeof canvasClosed;
+    tileViewed: typeof tileViewed;
+    tileExpanded: typeof tileExpanded;
+    tileCollapsed: typeof tileCollapsed;
+    tileAction: typeof tileAction;
+    overlayStarted: typeof overlayStarted;
+    overlayCompleted: typeof overlayCompleted;
+    overlayDismissed: typeof overlayDismissed;
+    overlayStepViewed: typeof overlayStepViewed;
+    custom: typeof customCanvasEvent;
+};

package/dist/events/normalizers/canvas.js

@@ -0,0 +1,116 @@
+import { StandardEvents, EVENT_SCHEMA_VERSION } from "../types";
+/**
+ * Create a canvas event with standard metadata.
+ */
+function createCanvasEvent(name, props) {
+    return {
+        ts: Date.now(),
+        name,
+        source: "canvas",
+        props,
+        schemaVersion: EVENT_SCHEMA_VERSION,
+    };
+}
+/**
+ * Canvas opened event.
+ */
+export function canvasOpened(surface) {
+    return createCanvasEvent(StandardEvents.CANVAS_OPENED, { surface });
+}
+/**
+ * Canvas closed event.
+ */
+export function canvasClosed(surface) {
+    return createCanvasEvent(StandardEvents.CANVAS_CLOSED, { surface });
+}
+/**
+ * Tile viewed event.
+ */
+export function tileViewed(tileId, surface) {
+    return createCanvasEvent(StandardEvents.TILE_VIEWED, { tileId, surface });
+}
+/**
+ * Tile expanded event.
+ */
+export function tileExpanded(tileId, surface) {
+    return createCanvasEvent(StandardEvents.TILE_EXPANDED, { tileId, surface });
+}
+/**
+ * Tile collapsed event.
+ */
+export function tileCollapsed(tileId, surface) {
+    return createCanvasEvent(StandardEvents.TILE_COLLAPSED, { tileId, surface });
+}
+/**
+ * Tile action event.
+ */
+export function tileAction(tileId, actionId, surface) {
+    return createCanvasEvent(StandardEvents.TILE_ACTION, {
+        tileId,
+        actionId,
+        surface,
+    });
+}
+/**
+ * Overlay/tour started event.
+ */
+export function overlayStarted(recipeId, recipeName) {
+    return createCanvasEvent(StandardEvents.OVERLAY_STARTED, {
+        recipeId,
+        recipeName,
+    });
+}
+/**
+ * Overlay/tour completed event.
+ */
+export function overlayCompleted(recipeId, recipeName) {
+    return createCanvasEvent(StandardEvents.OVERLAY_COMPLETED, {
+        recipeId,
+        recipeName,
+    });
+}
+/**
+ * Overlay/tour dismissed event.
+ */
+export function overlayDismissed(recipeId, recipeName, stepIndex) {
+    return createCanvasEvent(StandardEvents.OVERLAY_DISMISSED, {
+        recipeId,
+        recipeName,
+        stepIndex,
+    });
+}
+/**
+ * Overlay step viewed event.
+ */
+export function overlayStepViewed(recipeId, stepIndex, stepTitle) {
+    return createCanvasEvent(StandardEvents.OVERLAY_STEP_VIEWED, {
+        recipeId,
+        stepIndex,
+        stepTitle,
+    });
+}
+/**
+ * Create a custom canvas event.
+ */
+export function customCanvasEvent(name, props) {
+    // Prefix custom events with "canvas." if not already prefixed
+    const eventName = name.startsWith("canvas.") ? name : `canvas.${name}`;
+    return createCanvasEvent(eventName, props);
+}
+/**
+ * Canvas event factory for easy event creation.
+ */
+export const CanvasEvents = {
+    canvasOpened,
+    canvasClosed,
+    tileViewed,
+    tileExpanded,
+    tileCollapsed,
+    tileAction,
+    overlayStarted,
+    overlayCompleted,
+    overlayDismissed,
+    overlayStepViewed,
+    custom: customCanvasEvent,
+};
+//# sourceMappingURL=canvas.js.map