@syntrologie/runtime-sdk 0.2.20 → 0.2.21

package/dist/context/schema.js

@@ -0,0 +1,50 @@
+/**
+ * Zod schemas for RuntimeContext validation.
+ */
+import { z } from "zod";
+export const PageContextZ = z.object({
+    url: z.string(),
+    routeId: z.string().optional(),
+    title: z.string().optional(),
+    locale: z.string().optional(),
+});
+export const PageHistoryEntryZ = z.object({
+    url: z.string(),
+    ts: z.number(),
+});
+export const SessionContextZ = z.object({
+    sessionId: z.string(),
+    startTs: z.number(),
+    pageHistory: z.array(PageHistoryEntryZ).optional(),
+});
+export const ViewportContextZ = z.object({
+    width: z.number(),
+    height: z.number(),
+});
+export const BoundingBoxZ = z.object({
+    x: z.number(),
+    y: z.number(),
+    w: z.number(),
+    h: z.number(),
+});
+export const AnchorStateZ = z.object({
+    anchorId: z.string(),
+    present: z.boolean(),
+    visible: z.boolean().optional(),
+    boundingBox: BoundingBoxZ.optional(),
+});
+export const AugmentationZ = z.record(z.union([z.number(), z.string(), z.boolean(), z.undefined()]));
+export const RuntimeContextZ = z.object({
+    page: PageContextZ,
+    session: SessionContextZ,
+    viewport: ViewportContextZ,
+    anchors: z.array(AnchorStateZ).optional(),
+    augmented: AugmentationZ.optional(),
+});
+/**
+ * Validate a RuntimeContext object.
+ */
+export function validateRuntimeContext(data) {
+    return RuntimeContextZ.safeParse(data);
+}
+//# sourceMappingURL=schema.js.map

package/dist/context/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/context/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACb,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACb,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACb,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,YAAY,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CACnC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAC9D,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,gBAAgB;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,aAAa,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,OAAO,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/context/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Runtime Context Types
+ *
+ * The RuntimeContext represents the current state of the page, session, viewport,
+ * and other environmental factors that can be used for adaptive decision-making.
+ */
+/**
+ * Page context - information about the current page.
+ */
+export interface PageContext {
+    /** Current page URL */
+    url: string;
+    /** Matched route pattern from RoutesConfig (e.g., "/products/:id") */
+    routeId?: string;
+    /** Document title */
+    title?: string;
+    /** Page locale (e.g., "en-US") */
+    locale?: string;
+}
+/**
+ * Page history entry for session tracking.
+ */
+export interface PageHistoryEntry {
+    /** Page URL */
+    url: string;
+    /** Timestamp when page was visited */
+    ts: number;
+}
+/**
+ * Session context - information about the current session.
+ */
+export interface SessionContext {
+    /** Unique session ID (from PostHog) */
+    sessionId: string;
+    /** Session start timestamp */
+    startTs: number;
+    /** Page history within this session */
+    pageHistory?: PageHistoryEntry[];
+}
+/**
+ * Viewport context - information about the viewport size.
+ */
+export interface ViewportContext {
+    /** Viewport width in pixels */
+    width: number;
+    /** Viewport height in pixels */
+    height: number;
+}
+/**
+ * Bounding box for anchor elements.
+ */
+export interface BoundingBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/**
+ * Anchor state - tracks visibility and position of anchored elements.
+ */
+export interface AnchorState {
+    /** Anchor element ID */
+    anchorId: string;
+    /** Whether the element is present in the DOM */
+    present: boolean;
+    /** Whether the element is visible in the viewport */
+    visible?: boolean;
+    /** Element's bounding box (when visible) */
+    boundingBox?: BoundingBox;
+}
+/**
+ * Augmentation data from ML models (Phase 3).
+ * Placeholder for future implementation.
+ */
+export interface Augmentation {
+    /** Augmentation confidence scores by field name */
+    [field: string]: number | string | boolean | undefined;
+}
+/**
+ * The complete runtime context available to adaptives.
+ */
+export interface RuntimeContext {
+    /** Current page information */
+    page: PageContext;
+    /** Current session information */
+    session: SessionContext;
+    /** Current viewport size */
+    viewport: ViewportContext;
+    /** Tracked anchor element states (optional) */
+    anchors?: AnchorState[];
+    /** ML-derived augmentation data (Phase 3) */
+    augmented?: Augmentation;
+}
+/**
+ * Callback for context changes.
+ */
+export type ContextChangeCallback = (context: RuntimeContext, previousContext: RuntimeContext) => void;
+/**
+ * Unsubscribe function returned by subscribe().
+ */
+export type Unsubscribe = () => void;

package/dist/context/types.js

@@ -0,0 +1,8 @@
+/**
+ * Runtime Context Types
+ *
+ * The RuntimeContext represents the current state of the page, session, viewport,
+ * and other environmental factors that can be used for adaptive decision-making.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/decisions/engine.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Decision Engine
+ *
+ * The central evaluation engine for DecisionStrategy objects.
+ * Routes strategies to their appropriate evaluators.
+ */
+import type { DecisionStrategy, DecisionResult } from "./types";
+import type { RuntimeContext } from "../context/types";
+import type { StateStore } from "../state/StateStore";
+import type { EventBus } from "../events/EventBus";
+import type { SessionMetricTracker } from "../metrics/sessionMetrics";
+/**
+ * Options for the decision engine evaluate function.
+ */
+export interface EvaluateOptions {
+    /** State store for dismissal/cooldown/frequency checks */
+    state?: StateStore;
+    /** Event bus for event_occurred checks */
+    events?: EventBus;
+    /** Session metric tracker for session_metric checks */
+    sessionMetrics?: SessionMetricTracker;
+}
+/**
+ * Evaluate a DecisionStrategy against the current context.
+ *
+ * @param strategy - The decision strategy to evaluate
+ * @param context - The runtime context
+ * @param options - Additional evaluation options
+ * @returns The decision result
+ */
+export declare function evaluate<T>(strategy: DecisionStrategy<T>, context: RuntimeContext, options?: EvaluateOptions): Promise<DecisionResult<T>>;
+/**
+ * Synchronous version of evaluate for simple strategies.
+ * Use this when you know the strategy doesn't require async operations.
+ */
+export declare function evaluateSync<T>(strategy: DecisionStrategy<T>, context: RuntimeContext, options?: EvaluateOptions): DecisionResult<T>;
+/**
+ * Create a decision engine with pre-bound options.
+ */
+export declare function createDecisionEngine(options: EvaluateOptions): {
+    evaluate: <T>(strategy: DecisionStrategy<T>, context: RuntimeContext) => Promise<DecisionResult<T>>;
+    evaluateSync: <T>(strategy: DecisionStrategy<T>, context: RuntimeContext) => DecisionResult<T>;
+};

package/dist/decisions/engine.js

@@ -0,0 +1,112 @@
+import { evaluateRuleStrategy } from "./strategies/rules";
+import { evaluateScoreStrategy } from "./strategies/score";
+/**
+ * Create an EvaluationContext from runtime components.
+ */
+function createEvaluationContext(context, options) {
+    const { state, events, sessionMetrics } = options;
+    return {
+        context,
+        state: state
+            ? {
+                isDismissed: (key) => state.dismissals.isDismissed(key),
+                isCooldownActive: (key) => state.cooldowns.isActive(key),
+                getFrequencyCount: (key) => state.frequency.count(key),
+                getSessionMetric: (key) => { var _a; return (_a = sessionMetrics === null || sessionMetrics === void 0 ? void 0 : sessionMetrics.get(key)) !== null && _a !== void 0 ? _a : 0; },
+            }
+            : undefined,
+        events: events
+            ? {
+                hasRecentEvent: (eventName, withinMs) => events.hasRecentEvent(eventName, withinMs),
+            }
+            : undefined,
+    };
+}
+/**
+ * Evaluate a DecisionStrategy against the current context.
+ *
+ * @param strategy - The decision strategy to evaluate
+ * @param context - The runtime context
+ * @param options - Additional evaluation options
+ * @returns The decision result
+ */
+export async function evaluate(strategy, context, options = {}) {
+    const evalContext = createEvaluationContext(context, options);
+    switch (strategy.type) {
+        case "rules":
+            return evaluateRuleStrategy(strategy, evalContext);
+        case "score":
+            return evaluateScoreStrategy(strategy, evalContext);
+        case "model":
+            // Phase 3: Model-based strategy
+            // For now, return default
+            return {
+                value: strategy.default,
+                isFallback: true,
+                matchInfo: {
+                    strategyType: "model",
+                },
+            };
+        case "external":
+            // Phase 3: External strategy
+            // For now, return default
+            return {
+                value: strategy.default,
+                isFallback: true,
+                matchInfo: {
+                    strategyType: "external",
+                },
+            };
+        default:
+            // Unknown strategy type
+            console.warn("[DecisionEngine] Unknown strategy type:", strategy.type);
+            return {
+                value: undefined,
+                isFallback: true,
+                matchInfo: {
+                    strategyType: strategy.type,
+                },
+            };
+    }
+}
+/**
+ * Synchronous version of evaluate for simple strategies.
+ * Use this when you know the strategy doesn't require async operations.
+ */
+export function evaluateSync(strategy, context, options = {}) {
+    const evalContext = createEvaluationContext(context, options);
+    switch (strategy.type) {
+        case "rules":
+            return evaluateRuleStrategy(strategy, evalContext);
+        case "score":
+            return evaluateScoreStrategy(strategy, evalContext);
+        case "model":
+        case "external":
+            // These require async, return default
+            return {
+                value: strategy.default,
+                isFallback: true,
+                matchInfo: {
+                    strategyType: strategy.type,
+                },
+            };
+        default:
+            return {
+                value: undefined,
+                isFallback: true,
+                matchInfo: {
+                    strategyType: strategy.type,
+                },
+            };
+    }
+}
+/**
+ * Create a decision engine with pre-bound options.
+ */
+export function createDecisionEngine(options) {
+    return {
+        evaluate: (strategy, context) => evaluate(strategy, context, options),
+        evaluateSync: (strategy, context) => evaluateSync(strategy, context, options),
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/decisions/engine.js.map

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

package/dist/decisions/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decisions module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { evaluate, evaluateSync, createDecisionEngine } from "./engine";
+export type { EvaluateOptions } from "./engine";
+export { evaluateCondition, evaluateRule, evaluateRuleStrategy } from "./strategies/rules";
+export { evaluateScoreStrategy } from "./strategies/score";

package/dist/decisions/index.js

@@ -0,0 +1,10 @@
+/**
+ * Decisions module exports.
+ */
+export * from "./types";
+export * from "./schema";
+export { evaluate, evaluateSync, createDecisionEngine } from "./engine";
+// Strategy evaluators (for advanced use)
+export { evaluateCondition, evaluateRule, evaluateRuleStrategy } from "./strategies/rules";
+export { evaluateScoreStrategy } from "./strategies/score";
+//# sourceMappingURL=index.js.map

package/dist/decisions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decisions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGxE,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}