@syntrologie/runtime-sdk 0.2.19 → 0.2.21

package/dist/decisions/schema.js

@@ -0,0 +1,143 @@
+/**
+ * Zod schemas for decision strategy validation.
+ */
+import { z } from "zod";
+// =============================================================================
+// CONDITION SCHEMAS
+// =============================================================================
+export const PageUrlConditionZ = z.object({
+    type: z.literal("page_url"),
+    url: z.string(),
+});
+export const RouteConditionZ = z.object({
+    type: z.literal("route"),
+    routeId: z.string(),
+});
+export const AnchorVisibleConditionZ = z.object({
+    type: z.literal("anchor_visible"),
+    anchorId: z.string(),
+    state: z.enum(["visible", "present", "absent"]),
+});
+export const EventOccurredConditionZ = z.object({
+    type: z.literal("event_occurred"),
+    eventName: z.string(),
+    withinMs: z.number().optional(),
+});
+export const StateEqualsConditionZ = z.object({
+    type: z.literal("state_equals"),
+    key: z.string(),
+    value: z.unknown(),
+});
+export const ViewportConditionZ = z.object({
+    type: z.literal("viewport"),
+    minWidth: z.number().optional(),
+    maxWidth: z.number().optional(),
+    minHeight: z.number().optional(),
+    maxHeight: z.number().optional(),
+});
+export const SessionMetricConditionZ = z.object({
+    type: z.literal("session_metric"),
+    key: z.string(),
+    operator: z.enum(["gte", "lte", "eq", "gt", "lt"]),
+    threshold: z.number(),
+});
+export const DismissedConditionZ = z.object({
+    type: z.literal("dismissed"),
+    key: z.string(),
+    inverted: z.boolean().optional(),
+});
+export const CooldownActiveConditionZ = z.object({
+    type: z.literal("cooldown_active"),
+    key: z.string(),
+    inverted: z.boolean().optional(),
+});
+export const FrequencyLimitConditionZ = z.object({
+    type: z.literal("frequency_limit"),
+    key: z.string(),
+    limit: z.number(),
+    inverted: z.boolean().optional(),
+});
+export const ConditionZ = z.discriminatedUnion("type", [
+    PageUrlConditionZ,
+    RouteConditionZ,
+    AnchorVisibleConditionZ,
+    EventOccurredConditionZ,
+    StateEqualsConditionZ,
+    ViewportConditionZ,
+    SessionMetricConditionZ,
+    DismissedConditionZ,
+    CooldownActiveConditionZ,
+    FrequencyLimitConditionZ,
+]);
+// =============================================================================
+// STRATEGY SCHEMAS
+// =============================================================================
+export const RuleZ = z.object({
+    conditions: z.array(ConditionZ),
+    value: z.unknown(),
+});
+export const RuleStrategyZ = z.object({
+    type: z.literal("rules"),
+    rules: z.array(RuleZ),
+    default: z.unknown(),
+});
+export const ScoreStrategyZ = z.object({
+    type: z.literal("score"),
+    field: z.string(),
+    threshold: z.number(),
+    above: z.unknown(),
+    below: z.unknown(),
+});
+export const ModelStrategyZ = z.object({
+    type: z.literal("model"),
+    modelId: z.string(),
+    inputs: z.array(z.string()),
+    outputMapping: z.record(z.unknown()),
+    default: z.unknown(),
+});
+export const ExternalStrategyZ = z.object({
+    type: z.literal("external"),
+    endpoint: z.string(),
+    method: z.enum(["GET", "POST"]).optional(),
+    default: z.unknown(),
+    timeoutMs: z.number().optional(),
+});
+export const DecisionStrategyZ = z.discriminatedUnion("type", [
+    RuleStrategyZ,
+    ScoreStrategyZ,
+    ModelStrategyZ,
+    ExternalStrategyZ,
+]);
+// =============================================================================
+// ACTIVATION CONFIG SCHEMA
+// =============================================================================
+export const RouteFilterZ = z.object({
+    include: z.array(z.string()).optional(),
+    exclude: z.array(z.string()).optional(),
+});
+export const ActivationConfigZ = z.object({
+    routes: RouteFilterZ.optional(),
+    strategy: DecisionStrategyZ.optional(),
+});
+// =============================================================================
+// VALIDATION FUNCTIONS
+// =============================================================================
+/**
+ * Validate a Condition object.
+ */
+export function validateCondition(data) {
+    return ConditionZ.safeParse(data);
+}
+/**
+ * Validate a DecisionStrategy object.
+ */
+export function validateStrategy(data) {
+    return DecisionStrategyZ.safeParse(data);
+}
+/**
+ * Validate an ActivationConfig object.
+ */
+export function validateActivationConfig(data) {
+    return ActivationConfigZ.safeParse(data);
+}
+//# sourceMappingURL=schema.js.map

package/dist/decisions/schema.js.map

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

package/dist/decisions/strategies/rules.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Rule Strategy Evaluator
+ *
+ * Evaluates rules in order and returns the value of the first matching rule.
+ */
+import type { RuleStrategy, Rule, Condition, DecisionResult, EvaluationContext } from "../types";
+/**
+ * Evaluate a single condition against the evaluation context.
+ */
+export declare function evaluateCondition(condition: Condition, evalContext: EvaluationContext): boolean;
+/**
+ * Evaluate a single rule (all conditions must be true).
+ */
+export declare function evaluateRule(rule: Rule, evalContext: EvaluationContext): {
+    matched: boolean;
+    conditionResults: Array<{
+        condition: Condition;
+        result: boolean;
+    }>;
+};
+/**
+ * Evaluate a RuleStrategy and return the result.
+ */
+export declare function evaluateRuleStrategy<T>(strategy: RuleStrategy<T>, evalContext: EvaluationContext): DecisionResult<T>;

package/dist/decisions/strategies/rules.js

@@ -0,0 +1,152 @@
+/**
+ * Evaluate a single condition against the evaluation context.
+ */
+export function evaluateCondition(condition, evalContext) {
+    var _a, _b, _c, _d, _e;
+    const { context, state, events } = evalContext;
+    switch (condition.type) {
+        case "page_url": {
+            const { url } = condition;
+            const currentUrl = context.page.url;
+            // Simple pattern matching with wildcards
+            const pattern = url
+                .replace(/[.+^${}()|[\]\\]/g, "\\$&") // Escape regex chars except * and ?
+                .replace(/\*\*/g, ".*") // ** matches anything
+                .replace(/\*/g, "[^/]*"); // * matches within path segment
+            const regex = new RegExp(`^${pattern}$`);
+            return regex.test(currentUrl);
+        }
+        case "route": {
+            return context.page.routeId === condition.routeId;
+        }
+        case "anchor_visible": {
+            const anchor = (_a = context.anchors) === null || _a === void 0 ? void 0 : _a.find((a) => a.anchorId === condition.anchorId);
+            switch (condition.state) {
+                case "visible":
+                    return (anchor === null || anchor === void 0 ? void 0 : anchor.visible) === true;
+                case "present":
+                    return (anchor === null || anchor === void 0 ? void 0 : anchor.present) === true;
+                case "absent":
+                    return !(anchor === null || anchor === void 0 ? void 0 : anchor.present);
+                default:
+                    return false;
+            }
+        }
+        case "event_occurred": {
+            if (!events)
+                return false;
+            const withinMs = (_b = condition.withinMs) !== null && _b !== void 0 ? _b : 60000; // Default 1 minute
+            return events.hasRecentEvent(condition.eventName, withinMs);
+        }
+        case "state_equals": {
+            // This checks arbitrary state values - implementation depends on
+            // how the state store exposes values. For now, check session storage.
+            if (!state)
+                return false;
+            // The state key format could be "dismissals:xyz" or just "xyz"
+            // For simplicity, we'll do a basic comparison
+            return false; // TODO: Implement when state interface is clearer
+        }
+        case "viewport": {
+            const { width, height } = context.viewport;
+            if (condition.minWidth !== undefined && width < condition.minWidth)
+                return false;
+            if (condition.maxWidth !== undefined && width > condition.maxWidth)
+                return false;
+            if (condition.minHeight !== undefined && height < condition.minHeight)
+                return false;
+            if (condition.maxHeight !== undefined && height > condition.maxHeight)
+                return false;
+            return true;
+        }
+        case "session_metric": {
+            if (!state)
+                return false;
+            const metricValue = state.getSessionMetric(condition.key);
+            const { operator, threshold } = condition;
+            switch (operator) {
+                case "gte":
+                    return metricValue >= threshold;
+                case "lte":
+                    return metricValue <= threshold;
+                case "eq":
+                    return metricValue === threshold;
+                case "gt":
+                    return metricValue > threshold;
+                case "lt":
+                    return metricValue < threshold;
+                default:
+                    return false;
+            }
+        }
+        case "dismissed": {
+            if (!state)
+                return (_c = condition.inverted) !== null && _c !== void 0 ? _c : false;
+            const isDismissed = state.isDismissed(condition.key);
+            return condition.inverted ? !isDismissed : isDismissed;
+        }
+        case "cooldown_active": {
+            if (!state)
+                return (_d = condition.inverted) !== null && _d !== void 0 ? _d : false;
+            const isActive = state.isCooldownActive(condition.key);
+            return condition.inverted ? !isActive : isActive;
+        }
+        case "frequency_limit": {
+            if (!state)
+                return (_e = condition.inverted) !== null && _e !== void 0 ? _e : false;
+            const count = state.getFrequencyCount(condition.key);
+            const limitReached = count >= condition.limit;
+            return condition.inverted ? !limitReached : limitReached;
+        }
+        default:
+            // Unknown condition type - fail closed (return false)
+            console.warn("[RuleStrategy] Unknown condition type:", condition.type);
+            return false;
+    }
+}
+/**
+ * Evaluate a single rule (all conditions must be true).
+ */
+export function evaluateRule(rule, evalContext) {
+    const conditionResults = [];
+    for (const condition of rule.conditions) {
+        const result = evaluateCondition(condition, evalContext);
+        conditionResults.push({ condition, result });
+        // Short-circuit: if any condition fails, rule doesn't match
+        if (!result) {
+            return { matched: false, conditionResults };
+        }
+    }
+    // All conditions passed
+    return { matched: true, conditionResults };
+}
+/**
+ * Evaluate a RuleStrategy and return the result.
+ */
+export function evaluateRuleStrategy(strategy, evalContext) {
+    // Evaluate rules in order
+    for (let i = 0; i < strategy.rules.length; i++) {
+        const rule = strategy.rules[i];
+        const { matched, conditionResults } = evaluateRule(rule, evalContext);
+        if (matched) {
+            return {
+                value: rule.value,
+                isFallback: false,
+                matchInfo: {
+                    strategyType: "rules",
+                    matchedRuleIndex: i,
+                    evaluatedConditions: conditionResults,
+                },
+            };
+        }
+    }
+    // No rules matched, return default
+    return {
+        value: strategy.default,
+        isFallback: true,
+        matchInfo: {
+            strategyType: "rules",
+        },
+    };
+}
+//# sourceMappingURL=rules.js.map

package/dist/decisions/strategies/rules.js.map

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

package/dist/decisions/strategies/score.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Score Strategy Evaluator
+ *
+ * Compares an augmented field value against a threshold.
+ */
+import type { ScoreStrategy, DecisionResult, EvaluationContext } from "../types";
+/**
+ * Evaluate a ScoreStrategy and return the result.
+ */
+export declare function evaluateScoreStrategy<T>(strategy: ScoreStrategy<T>, evalContext: EvaluationContext): DecisionResult<T>;

package/dist/decisions/strategies/score.js

@@ -0,0 +1,29 @@
+/**
+ * Evaluate a ScoreStrategy and return the result.
+ */
+export function evaluateScoreStrategy(strategy, evalContext) {
+    var _a;
+    const { context } = evalContext;
+    // Get the score from augmented context
+    const score = (_a = context.augmented) === null || _a === void 0 ? void 0 : _a[strategy.field];
+    // If no score available, return below value as fallback
+    if (score === undefined || typeof score !== "number") {
+        return {
+            value: strategy.below,
+            isFallback: true,
+            matchInfo: {
+                strategyType: "score",
+            },
+        };
+    }
+    // Compare against threshold
+    const isAbove = score >= strategy.threshold;
+    return {
+        value: isAbove ? strategy.above : strategy.below,
+        isFallback: false,
+        matchInfo: {
+            strategyType: "score",
+        },
+    };
+}
+//# sourceMappingURL=score.js.map

package/dist/decisions/strategies/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../src/decisions/strategies/score.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA0B,EAC1B,WAA8B;;IAE9B,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;IAEhC,uCAAuC;IACvC,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,SAAS,0CAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,wDAAwD;IACxD,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,KAAU;YAC1B,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE;gBACT,YAAY,EAAE,OAAO;aACtB;SACF,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,MAAM,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,SAAS,CAAC;IAE5C,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,CAAC,CAAE,QAAQ,CAAC,KAAW,CAAC,CAAC,CAAE,QAAQ,CAAC,KAAW;QAC9D,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE;YACT,YAAY,EAAE,OAAO;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/decisions/types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Decision Strategy Types
+ *
+ * DecisionStrategy is the core abstraction for conditional rendering
+ * and adaptive behavior in the v2 runtime. It replaces the experiment-based
+ * filtering with a more flexible, context-aware system.
+ */
+import type { RuntimeContext } from "../context/types";
+/**
+ * Condition that checks if the current page URL matches a pattern.
+ */
+export interface PageUrlCondition {
+    type: "page_url";
+    /** URL pattern (supports wildcards: * and **) */
+    url: string;
+}
+/**
+ * Condition that checks if the current route matches.
+ */
+export interface RouteCondition {
+    type: "route";
+    /** Route ID from RoutesConfig */
+    routeId: string;
+}
+/**
+ * Condition that checks anchor element visibility.
+ */
+export interface AnchorVisibleCondition {
+    type: "anchor_visible";
+    /** Anchor element ID */
+    anchorId: string;
+    /** Required state */
+    state: "visible" | "present" | "absent";
+}
+/**
+ * Condition that checks if an event occurred recently.
+ */
+export interface EventOccurredCondition {
+    type: "event_occurred";
+    /** Event name to check */
+    eventName: string;
+    /** Time window in milliseconds (optional) */
+    withinMs?: number;
+}
+/**
+ * Condition that checks a state value.
+ */
+export interface StateEqualsCondition {
+    type: "state_equals";
+    /** State key to check */
+    key: string;
+    /** Expected value */
+    value: unknown;
+}
+/**
+ * Condition that checks viewport size.
+ */
+export interface ViewportCondition {
+    type: "viewport";
+    /** Minimum viewport width */
+    minWidth?: number;
+    /** Maximum viewport width */
+    maxWidth?: number;
+    /** Minimum viewport height */
+    minHeight?: number;
+    /** Maximum viewport height */
+    maxHeight?: number;
+}
+/**
+ * Condition that checks a session metric threshold.
+ */
+export interface SessionMetricCondition {
+    type: "session_metric";
+    /** Metric key */
+    key: string;
+    /** Comparison operator */
+    operator: "gte" | "lte" | "eq" | "gt" | "lt";
+    /** Threshold value */
+    threshold: number;
+}
+/**
+ * Condition that checks if an item has been dismissed.
+ */
+export interface DismissedCondition {
+    type: "dismissed";
+    /** Item key to check */
+    key: string;
+    /** Invert the condition (true if NOT dismissed) */
+    inverted?: boolean;
+}
+/**
+ * Condition that checks if a cooldown is active.
+ */
+export interface CooldownActiveCondition {
+    type: "cooldown_active";
+    /** Cooldown key to check */
+    key: string;
+    /** Invert the condition (true if NOT active) */
+    inverted?: boolean;
+}
+/**
+ * Condition that checks frequency limits.
+ */
+export interface FrequencyLimitCondition {
+    type: "frequency_limit";
+    /** Frequency key to check */
+    key: string;
+    /** Maximum allowed count */
+    limit: number;
+    /** Invert the condition (true if limit NOT reached) */
+    inverted?: boolean;
+}
+/**
+ * Union of all condition types.
+ */
+export type Condition = PageUrlCondition | RouteCondition | AnchorVisibleCondition | EventOccurredCondition | StateEqualsCondition | ViewportCondition | SessionMetricCondition | DismissedCondition | CooldownActiveCondition | FrequencyLimitCondition;
+/**
+ * Rule with conditions and output value.
+ */
+export interface Rule<T = unknown> {
+    /** Conditions that must all be met (AND logic) */
+    conditions: Condition[];
+    /** Value to return if all conditions are met */
+    value: T;
+}
+/**
+ * Rule-based strategy: evaluates rules in order, returns first match.
+ */
+export interface RuleStrategy<T = unknown> {
+    type: "rules";
+    /** Rules to evaluate in order */
+    rules: Rule<T>[];
+    /** Default value if no rules match */
+    default: T;
+}
+/**
+ * Score-based strategy: compares an augmented field against a threshold.
+ */
+export interface ScoreStrategy<T = unknown> {
+    type: "score";
+    /** Field name in augmented context */
+    field: string;
+    /** Threshold value */
+    threshold: number;
+    /** Value if score >= threshold */
+    above: T;
+    /** Value if score < threshold */
+    below: T;
+}
+/**
+ * Model-based strategy: invokes an ML model for prediction.
+ * (Phase 3 - placeholder)
+ */
+export interface ModelStrategy<T = unknown> {
+    type: "model";
+    /** Model endpoint or ID */
+    modelId: string;
+    /** Input fields from context */
+    inputs: string[];
+    /** Mapping of model outputs to values */
+    outputMapping: Record<string, T>;
+    /** Default value if model call fails */
+    default: T;
+}
+/**
+ * External strategy: calls a remote endpoint for decision.
+ * (Phase 3 - placeholder)
+ */
+export interface ExternalStrategy<T = unknown> {
+    type: "external";
+    /** Endpoint URL */
+    endpoint: string;
+    /** HTTP method */
+    method?: "GET" | "POST";
+    /** Default value if endpoint fails */
+    default: T;
+    /** Timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * Union of all strategy types.
+ */
+export type DecisionStrategy<T = unknown> = RuleStrategy<T> | ScoreStrategy<T> | ModelStrategy<T> | ExternalStrategy<T>;
+/**
+ * Result of evaluating a DecisionStrategy.
+ */
+export interface DecisionResult<T = unknown> {
+    /** The decided value */
+    value: T;
+    /** Whether the result came from a fallback/default */
+    isFallback: boolean;
+    /** Debug info about which rule/condition matched */
+    matchInfo?: {
+        /** Strategy type that produced the result */
+        strategyType: DecisionStrategy<T>["type"];
+        /** Index of matched rule (for rule strategy) */
+        matchedRuleIndex?: number;
+        /** Conditions that were evaluated */
+        evaluatedConditions?: Array<{
+            condition: Condition;
+            result: boolean;
+        }>;
+    };
+}
+/**
+ * Route filter for tile activation.
+ */
+export interface RouteFilter {
+    /** Routes where the tile should appear */
+    include?: string[];
+    /** Routes where the tile should NOT appear */
+    exclude?: string[];
+}
+/**
+ * Activation configuration for tiles.
+ * Replaces the old TileExperiment type.
+ */
+export interface ActivationConfig {
+    /** Route-based filtering */
+    routes?: RouteFilter;
+    /** Decision strategy for conditional rendering */
+    strategy?: DecisionStrategy<boolean>;
+}
+/**
+ * Extended context for strategy evaluation.
+ * Includes runtime references for state/event checks.
+ */
+export interface EvaluationContext {
+    /** Runtime context snapshot */
+    context: RuntimeContext;
+    /** Access to state store (for dismissals, cooldowns, frequency) */
+    state?: {
+        isDismissed(key: string): boolean;
+        isCooldownActive(key: string): boolean;
+        getFrequencyCount(key: string): number;
+        getSessionMetric(key: string): number;
+    };
+    /** Access to event bus (for event_occurred checks) */
+    events?: {
+        hasRecentEvent(eventName: string, withinMs: number): boolean;
+    };
+}

package/dist/decisions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/decisions/types.js.map

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

package/dist/editorLoader.d.ts

@@ -4,6 +4,16 @@ export declare const DEFAULT_EDITOR_URL = "https://cdn.syntrologie.com/editor-sd
  * Requires editor_token parameter for security (not just syntro_editor flag).
  */
 export declare const shouldLoadEditor: () => boolean;
+/**
+ * Checks if audit mode should be activated based on URL query parameters.
+ * Audit mode enables element marking for product touring.
+ */
+export declare const isAuditMode: () => boolean;
+/**
+ * Checks if any SDK mode (editor or audit) should be loaded.
+ * Returns the mode type if active, or null if neither.
+ */
+export declare const getActiveSdkMode: () => "editor" | "audit" | null;
 export interface EditorLoadOptions {
     /** URL to load editor SDK from */
     editorUrl?: string;