@traffical/js-client 0.1.2

package/dist/plugins/decision-tracking.d.ts

@@ -0,0 +1,68 @@
+/**
+ * DecisionTrackingPlugin - Automatically tracks decision events.
+ *
+ * This plugin hooks into the SDK's decision lifecycle and sends a DecisionEvent
+ * to the control plane whenever decide() is called. This enables:
+ * - Intent-to-treat analysis: tracking all assignments, not just exposures
+ * - Debugging: understanding why specific values were computed
+ * - Audit trail: tracking all decisions made by the SDK
+ *
+ * Decision events are deduplicated: the same user seeing the same assignment
+ * will only trigger one event within the deduplication TTL.
+ */
+import type { TrafficalPlugin } from "./types.js";
+import type { DecisionEvent } from "@traffical/core";
+/**
+ * Options for the DecisionTrackingPlugin.
+ */
+export interface DecisionTrackingPluginOptions {
+    /**
+     * Disable decision tracking entirely.
+     * Default: false (tracking enabled)
+     */
+    disabled?: boolean;
+    /**
+     * Time-to-live for deduplication in milliseconds.
+     * Same user+assignment combination won't be tracked again within this window.
+     * Default: 1 hour (3600000 ms)
+     */
+    deduplicationTtlMs?: number;
+}
+/**
+ * Dependencies injected by the SDK client.
+ */
+export interface DecisionTrackingPluginDeps {
+    /** Organization ID */
+    orgId: string;
+    /** Project ID */
+    projectId: string;
+    /** Environment */
+    env: string;
+    /**
+     * Function to log a decision event.
+     * This is typically the EventLogger.log() method.
+     */
+    log: (event: DecisionEvent) => void;
+}
+/**
+ * Creates a DecisionTrackingPlugin instance.
+ *
+ * @param options - Plugin configuration options
+ * @param deps - Dependencies injected by the SDK client
+ * @returns A TrafficalPlugin that tracks decision events
+ *
+ * @example
+ * ```typescript
+ * const plugin = createDecisionTrackingPlugin(
+ *   { disabled: false },
+ *   {
+ *     orgId: "org_123",
+ *     projectId: "proj_456",
+ *     env: "production",
+ *     log: (event) => eventLogger.log(event),
+ *   }
+ * );
+ * ```
+ */
+export declare function createDecisionTrackingPlugin(options: DecisionTrackingPluginOptions, deps: DecisionTrackingPluginDeps): TrafficalPlugin;
+//# sourceMappingURL=decision-tracking.d.ts.map

package/dist/plugins/decision-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-tracking.d.ts","sourceRoot":"","sources":["../../src/plugins/decision-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAkB,aAAa,EAAkB,MAAM,iBAAiB,CAAC;AAMrF;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,0BAA0B,GAC/B,eAAe,CAwDjB"}

package/dist/plugins/decision-tracking.js

@@ -0,0 +1,83 @@
+/**
+ * DecisionTrackingPlugin - Automatically tracks decision events.
+ *
+ * This plugin hooks into the SDK's decision lifecycle and sends a DecisionEvent
+ * to the control plane whenever decide() is called. This enables:
+ * - Intent-to-treat analysis: tracking all assignments, not just exposures
+ * - Debugging: understanding why specific values were computed
+ * - Audit trail: tracking all decisions made by the SDK
+ *
+ * Decision events are deduplicated: the same user seeing the same assignment
+ * will only trigger one event within the deduplication TTL.
+ */
+import { DecisionDeduplicator } from "@traffical/core";
+const SDK_NAME = "js-client";
+const SDK_VERSION = "0.1.0"; // Should match package.json version
+/**
+ * Creates a DecisionTrackingPlugin instance.
+ *
+ * @param options - Plugin configuration options
+ * @param deps - Dependencies injected by the SDK client
+ * @returns A TrafficalPlugin that tracks decision events
+ *
+ * @example
+ * ```typescript
+ * const plugin = createDecisionTrackingPlugin(
+ *   { disabled: false },
+ *   {
+ *     orgId: "org_123",
+ *     projectId: "proj_456",
+ *     env: "production",
+ *     log: (event) => eventLogger.log(event),
+ *   }
+ * );
+ * ```
+ */
+export function createDecisionTrackingPlugin(options, deps) {
+    const dedup = new DecisionDeduplicator({
+        ttlMs: options.deduplicationTtlMs,
+    });
+    return {
+        name: "decision-tracking",
+        onDecision(decision) {
+            // Skip if disabled
+            if (options.disabled) {
+                return;
+            }
+            // Skip if no unit key (can't attribute)
+            const unitKey = decision.metadata.unitKeyValue;
+            if (!unitKey) {
+                return;
+            }
+            // Hash assignments for deduplication
+            const hash = DecisionDeduplicator.hashAssignments(decision.assignments);
+            // Check deduplication
+            if (!dedup.checkAndMark(unitKey, hash)) {
+                return; // Duplicate, skip
+            }
+            // Build the decision event
+            const event = {
+                type: "decision",
+                id: decision.decisionId,
+                orgId: deps.orgId,
+                projectId: deps.projectId,
+                env: deps.env,
+                unitKey,
+                timestamp: decision.metadata.timestamp,
+                assignments: decision.assignments,
+                layers: decision.metadata.layers,
+                // Include filtered context if available (for contextual bandit training)
+                context: decision.metadata.filteredContext,
+                sdkName: SDK_NAME,
+                sdkVersion: SDK_VERSION,
+            };
+            // Log the event
+            deps.log(event);
+        },
+        onDestroy() {
+            // Clear the deduplication cache
+            dedup.clear();
+        },
+    };
+}
+//# sourceMappingURL=decision-tracking.js.map

package/dist/plugins/decision-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-tracking.js","sourceRoot":"","sources":["../../src/plugins/decision-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,QAAQ,GAAG,WAAW,CAAC;AAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,oCAAoC;AAqCjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAsC,EACtC,IAAgC;IAEhC,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC;QACrC,KAAK,EAAE,OAAO,CAAC,kBAAkB;KAClC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,mBAAmB;QAEzB,UAAU,CAAC,QAAwB;YACjC,mBAAmB;YACnB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,wCAAwC;YACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,qCAAqC;YACrC,MAAM,IAAI,GAAG,oBAAoB,CAAC,eAAe,CAC/C,QAAQ,CAAC,WAA6C,CACvD,CAAC;YAEF,sBAAsB;YACtB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;gBACvC,OAAO,CAAC,kBAAkB;YAC5B,CAAC;YAED,2BAA2B;YAC3B,MAAM,KAAK,GAAkB;gBAC3B,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,QAAQ,CAAC,UAAU;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,OAAO;gBACP,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;gBACtC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;gBAChC,yEAAyE;gBACzE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;gBAC1C,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,WAAW;aACxB,CAAC;YAEF,gBAAgB;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAED,SAAS;YACP,gCAAgC;YAChC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/dom-binding.d.ts

@@ -0,0 +1,48 @@
+/**
+ * DOM Binding Plugin
+ *
+ * Automatically applies parameter values to DOM elements based on bindings
+ * configured in Traffical via the visual editor.
+ *
+ * Features:
+ * - URL pattern matching to apply bindings only on matching pages
+ * - MutationObserver for dynamic content (SPA support)
+ * - Supports multiple property types: innerHTML, textContent, src, href, style.*
+ *
+ * @example
+ * ```typescript
+ * import { createTrafficalClient, createDOMBindingPlugin } from '@traffical/js-client';
+ *
+ * const client = await createTrafficalClient({
+ *   // ... config
+ *   plugins: [createDOMBindingPlugin()],
+ * });
+ * ```
+ */
+import type { BundleDOMBinding } from "@traffical/core";
+import type { TrafficalPlugin } from "./types.js";
+export interface DOMBindingPluginOptions {
+    /**
+     * Whether to start observing DOM mutations automatically.
+     * Useful for SPAs where content is dynamically loaded.
+     * @default true
+     */
+    observeMutations?: boolean;
+    /**
+     * Debounce time in ms for mutation-triggered reapplication.
+     * @default 100
+     */
+    debounceMs?: number;
+}
+/**
+ * Creates a DOM binding plugin instance.
+ *
+ * This plugin applies parameter values to DOM elements based on bindings
+ * defined via the visual editor.
+ */
+export declare function createDOMBindingPlugin(options?: DOMBindingPluginOptions): TrafficalPlugin & {
+    applyBindings: (params?: Record<string, unknown>) => void;
+    getBindings: () => BundleDOMBinding[];
+};
+export type DOMBindingPlugin = ReturnType<typeof createDOMBindingPlugin>;
+//# sourceMappingURL=dom-binding.d.ts.map

package/dist/plugins/dom-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-binding.d.ts","sourceRoot":"","sources":["../../src/plugins/dom-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAgB,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,eAAe,GAAG;IAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,gBAAgB,EAAE,CAAA;CAAE,CA2MxH;AAGD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/plugins/dom-binding.js

@@ -0,0 +1,211 @@
+/**
+ * DOM Binding Plugin
+ *
+ * Automatically applies parameter values to DOM elements based on bindings
+ * configured in Traffical via the visual editor.
+ *
+ * Features:
+ * - URL pattern matching to apply bindings only on matching pages
+ * - MutationObserver for dynamic content (SPA support)
+ * - Supports multiple property types: innerHTML, textContent, src, href, style.*
+ *
+ * @example
+ * ```typescript
+ * import { createTrafficalClient, createDOMBindingPlugin } from '@traffical/js-client';
+ *
+ * const client = await createTrafficalClient({
+ *   // ... config
+ *   plugins: [createDOMBindingPlugin()],
+ * });
+ * ```
+ */
+// =============================================================================
+// DOM Binding Plugin
+// =============================================================================
+/**
+ * Creates a DOM binding plugin instance.
+ *
+ * This plugin applies parameter values to DOM elements based on bindings
+ * defined via the visual editor.
+ */
+export function createDOMBindingPlugin(options = {}) {
+    const config = {
+        observeMutations: options.observeMutations ?? true,
+        debounceMs: options.debounceMs ?? 100,
+    };
+    // Internal state
+    let bindings = [];
+    let lastParams = {};
+    let observer = null;
+    let debounceTimer = null;
+    // ==========================================================================
+    // Core binding logic
+    // ==========================================================================
+    /**
+     * Check if URL matches the binding's pattern.
+     */
+    function matchesUrlPattern(pattern, path) {
+        try {
+            const regex = new RegExp(pattern);
+            return regex.test(path);
+        }
+        catch {
+            // Invalid regex - fall back to exact match
+            return path === pattern;
+        }
+    }
+    /**
+     * Set a property on an element.
+     * Supports: innerHTML, textContent, src, href, style.*
+     */
+    function setProperty(element, property, value) {
+        if (property === "innerHTML") {
+            element.innerHTML = value;
+        }
+        else if (property === "textContent") {
+            element.textContent = value;
+        }
+        else if (property === "src" && "src" in element) {
+            element.src = value;
+        }
+        else if (property === "href" && "href" in element) {
+            element.href = value;
+        }
+        else if (property.startsWith("style.")) {
+            const styleProp = property.slice(6); // Remove "style." prefix
+            element.style[styleProp] = value;
+        }
+        else {
+            // Generic attribute setter for other properties
+            element.setAttribute(property, value);
+        }
+    }
+    /**
+     * Apply a single binding to matching elements.
+     */
+    function applyBinding(binding, value) {
+        const stringValue = String(value);
+        try {
+            const elements = document.querySelectorAll(binding.selector);
+            for (const element of elements) {
+                setProperty(element, binding.property, stringValue);
+            }
+        }
+        catch (error) {
+            // Invalid selector or other DOM error - silently warn
+            console.warn(`[Traffical DOM Binding] Failed to apply binding for ${binding.parameterKey}:`, error);
+        }
+    }
+    /**
+     * Apply parameter values to matching DOM elements.
+     */
+    function apply(params, forceAll = false) {
+        lastParams = params;
+        const currentPath = typeof window !== "undefined" ? window.location.pathname : "";
+        for (const binding of bindings) {
+            // Check URL pattern match
+            if (!forceAll && !matchesUrlPattern(binding.urlPattern, currentPath)) {
+                continue;
+            }
+            // Get parameter value
+            const value = params[binding.parameterKey];
+            if (value === undefined) {
+                continue;
+            }
+            // Apply to matching elements
+            applyBinding(binding, value);
+        }
+    }
+    /**
+     * Debounced reapplication of bindings after DOM mutations.
+     */
+    function debouncedApply() {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            apply(lastParams);
+        }, config.debounceMs);
+    }
+    /**
+     * Start observing DOM mutations.
+     */
+    function startObserving() {
+        if (observer || typeof MutationObserver === "undefined" || typeof document === "undefined") {
+            return;
+        }
+        observer = new MutationObserver(() => {
+            debouncedApply();
+        });
+        observer.observe(document.body, {
+            childList: true,
+            subtree: true,
+        });
+    }
+    /**
+     * Stop observing DOM mutations.
+     */
+    function stopObserving() {
+        if (observer) {
+            observer.disconnect();
+            observer = null;
+        }
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+            debounceTimer = null;
+        }
+    }
+    // ==========================================================================
+    // Plugin implementation
+    // ==========================================================================
+    return {
+        name: "dom-binding",
+        onInitialize() {
+            // Start observing if enabled
+            if (config.observeMutations) {
+                startObserving();
+            }
+        },
+        onConfigUpdate(bundle) {
+            // Update bindings from bundle
+            bindings = bundle.domBindings ?? [];
+        },
+        onResolve(params) {
+            // Apply bindings after parameters are resolved
+            apply(params);
+        },
+        onDecision(decision) {
+            // Also apply after decide() calls
+            apply(decision.assignments);
+        },
+        onDestroy() {
+            stopObserving();
+            bindings = [];
+            lastParams = {};
+        },
+        // ==========================================================================
+        // Public API (exposed on plugin instance)
+        // ==========================================================================
+        /**
+         * Manually apply DOM bindings with the given parameter values.
+         * Use this to re-trigger bindings after dynamic content changes.
+         *
+         * @param params - Parameter values to apply. If omitted, uses last known params.
+         */
+        applyBindings(params) {
+            if (params) {
+                apply(params);
+            }
+            else {
+                apply(lastParams);
+            }
+        },
+        /**
+         * Get the current DOM bindings from the config bundle.
+         */
+        getBindings() {
+            return bindings;
+        },
+    };
+}
+//# sourceMappingURL=dom-binding.js.map

package/dist/plugins/dom-binding.js.map

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

package/dist/plugins/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * PluginManager - Manages plugin lifecycle and hook execution.
+ *
+ * Provides a minimal hook-based system for extending SDK functionality.
+ */
+import type { ConfigBundle, DecisionResult, ExposureEvent, TrackEvent, Context, ParameterValue } from "@traffical/core";
+import type { TrafficalPlugin, PluginOptions } from "./types.js";
+export declare class PluginManager {
+    private _plugins;
+    /**
+     * Register a plugin.
+     */
+    register(options: PluginOptions | TrafficalPlugin): void;
+    /**
+     * Unregister a plugin by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a registered plugin by name.
+     */
+    get(name: string): TrafficalPlugin | undefined;
+    /**
+     * Get all registered plugins.
+     */
+    getAll(): TrafficalPlugin[];
+    /**
+     * Run onInitialize hooks.
+     */
+    runInitialize(): Promise<void>;
+    /**
+     * Run onConfigUpdate hooks.
+     * Called when config bundle is fetched or refreshed.
+     */
+    runConfigUpdate(bundle: ConfigBundle): void;
+    /**
+     * Run onBeforeDecision hooks.
+     * Returns potentially modified context.
+     */
+    runBeforeDecision(context: Context): Context;
+    /**
+     * Run onDecision hooks.
+     */
+    runDecision(decision: DecisionResult): void;
+    /**
+     * Run onResolve hooks.
+     * Called after getParams() resolves parameters.
+     */
+    runResolve(params: Record<string, ParameterValue>): void;
+    /**
+     * Run onExposure hooks.
+     * Returns false if any plugin cancels the exposure.
+     */
+    runExposure(event: ExposureEvent): boolean;
+    /**
+     * Run onTrack hooks.
+     * Returns false if any plugin cancels the track event.
+     */
+    runTrack(event: TrackEvent): boolean;
+    /**
+     * Run onDestroy hooks.
+     */
+    runDestroy(): void;
+    /**
+     * Clear all plugins.
+     */
+    clear(): void;
+}
+export type { TrafficalPlugin, PluginOptions } from "./types.js";
+export { createDecisionTrackingPlugin, type DecisionTrackingPluginOptions, type DecisionTrackingPluginDeps, } from "./decision-tracking.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,UAAU,EACV,OAAO,EACP,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOjE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA0B;IAE1C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI;IAgBxD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAYpC;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAY3C;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAmB5C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAY3C;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IAYxD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAiB1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAiBpC;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAGD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EACL,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC"}