@syntrologie/runtime-sdk 0.2.20 → 1.0.0-canary.1

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

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * PostHog Event Normalizer
+ *
+ * Transforms PostHog autocapture events into normalized events for the EventBus.
+ *
+ * This module is automatically wired up during `Syntro.init()` when PostHog
+ * credentials are provided in the token. The flow is:
+ *
+ * 1. PostHog captures user interactions (clicks, scrolls, navigation, etc.)
+ * 2. PostHog's `eventCaptured` callback fires
+ * 3. `createPostHogNormalizer()` transforms the event to a NormalizedEvent
+ * 4. The normalized event is published to the EventBus
+ *
+ * This allows canvas components and decision strategies to react to user
+ * interactions with the main webapp, not just canvas-specific events.
+ *
+ * @example
+ * ```typescript
+ * // In bootstrap.ts (already wired up automatically)
+ * const normalizer = createPostHogNormalizer((event) => {
+ *   eventBus.publishEvent(event);
+ * });
+ *
+ * // PostHog adapter calls normalizer on each capture
+ * posthog.on('eventCaptured', normalizer);
+ * ```
+ *
+ * @see RUNTIME_V2_REFERENCE.md for the full event mapping table
+ */
+import type { NormalizedEvent } from '../types';
+/**
+ * PostHog event structure (simplified).
+ */
+interface PostHogEvent {
+    event: string;
+    properties?: Record<string, unknown>;
+    timestamp?: string | number;
+}
+/**
+ * Normalize a PostHog event into a NormalizedEvent.
+ */
+export declare function normalizePostHogEvent(phEvent: PostHogEvent): NormalizedEvent;
+/**
+ * Check if a PostHog event should be normalized.
+ * Filters out internal/system events that aren't useful for adaptives.
+ */
+export declare function shouldNormalizeEvent(phEvent: PostHogEvent): boolean;
+/**
+ * Create a function that hooks into PostHog's onCapture callback
+ * and normalizes events into the EventBus.
+ */
+export declare function createPostHogNormalizer(publishFn: (event: NormalizedEvent) => void): (eventName: string, properties?: Record<string, unknown>) => void;
+export {};

package/dist/events/normalizers/posthog.js

@@ -0,0 +1,163 @@
+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;
+    // Defensive guard: PostHog's eventCaptured can emit non-string event names
+    if (typeof eventName !== 'string') {
+        return 'posthog.unknown';
+    }
+    // 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;
+    if (typeof eventName !== 'string')
+        return false;
+    // 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) => {
+        if (typeof eventName !== 'string')
+            return;
+        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, {
+    name: string;
+    source: "posthog" | "canvas" | "derived";
+    schemaVersion: string;
+    ts: number;
+    props?: Record<string, unknown> | undefined;
+}, {
+    name: string;
+    source: "posthog" | "canvas" | "derived";
+    schemaVersion: string;
+    ts: number;
+    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?: ("posthog" | "canvas" | "derived")[] | undefined;
+}, {
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+}>;
+/**
+ * Validate a NormalizedEvent object.
+ */
+export declare function validateNormalizedEvent(data: unknown): z.SafeParseReturnType<{
+    name: string;
+    source: "posthog" | "canvas" | "derived";
+    schemaVersion: string;
+    ts: number;
+    props?: Record<string, unknown> | undefined;
+}, {
+    name: string;
+    source: "posthog" | "canvas" | "derived";
+    schemaVersion: string;
+    ts: number;
+    props?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Validate an EventFilter object.
+ */
+export declare function validateEventFilter(data: unknown): z.SafeParseReturnType<{
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("posthog" | "canvas" | "derived")[] | undefined;
+}, {
+    names?: string[] | undefined;
+    patterns?: string[] | undefined;
+    sources?: ("posthog" | "canvas" | "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,79 @@
+/**
+ * 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";
+    readonly ACTION_APPLIED: "action.applied";
+    readonly ACTION_REVERTED: "action.reverted";
+    readonly ACTION_FAILED: "action.failed";
+    readonly ACTION_CTA_CLICKED: "action.cta_clicked";
+    readonly SURFACE_MOUNTED: "surface.mounted";
+    readonly SURFACE_UNMOUNTED: "surface.unmounted";
+};
+/**
+ * Current schema version for normalized events.
+ */
+export declare const EVENT_SCHEMA_VERSION = "1.0.0";

package/dist/events/types.js

@@ -0,0 +1,49 @@
+/**
+ * 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',
+    // Action events
+    ACTION_APPLIED: 'action.applied',
+    ACTION_REVERTED: 'action.reverted',
+    ACTION_FAILED: 'action.failed',
+    ACTION_CTA_CLICKED: 'action.cta_clicked',
+    // Surface events
+    SURFACE_MOUNTED: 'surface.mounted',
+    SURFACE_UNMOUNTED: 'surface.unmounted',
+};
+/**
+ * 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;IAExC,gBAAgB;IAChB,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IAExC,iBAAiB;IACjB,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC"}