@traffical/js-client 0.1.2

package/dist/client.js

@@ -0,0 +1,429 @@
+/**
+ * TrafficalClient - JavaScript SDK for browser environments.
+ *
+ * Features:
+ * - Same API as Node SDK: getParams(), decide(), trackExposure(), track()
+ * - Error boundary wrapping (P0)
+ * - Exposure deduplication (P0)
+ * - Smart event batching with beacon on unload (P1)
+ * - Plugin system (P2)
+ * - Auto stable ID for anonymous users
+ */
+import { resolveParameters, decide as coreDecide, generateExposureId, generateTrackEventId, generateDecisionId, } from "@traffical/core";
+import { ErrorBoundary } from "./error-boundary.js";
+import { EventLogger } from "./event-logger.js";
+import { ExposureDeduplicator } from "./exposure-dedup.js";
+import { StableIdProvider } from "./stable-id.js";
+import { createStorageProvider } from "./storage.js";
+import { PluginManager, createDecisionTrackingPlugin } from "./plugins/index.js";
+// =============================================================================
+// Constants
+// =============================================================================
+const SDK_NAME = "js-client";
+const SDK_VERSION = "0.1.0"; // Should match package.json version
+const DEFAULT_BASE_URL = "https://sdk.traffical.io";
+const DEFAULT_REFRESH_INTERVAL_MS = 60000; // 1 minute
+const OFFLINE_WARNING_INTERVAL_MS = 300000; // 5 minutes
+const DECISION_CACHE_MAX_SIZE = 100; // Max decisions to cache for attribution lookup
+// =============================================================================
+// TrafficalClient Class
+// =============================================================================
+export class TrafficalClient {
+    constructor(options) {
+        this._state = {
+            bundle: null,
+            etag: null,
+            lastFetchTime: 0,
+            lastOfflineWarning: 0,
+            refreshTimer: null,
+            isInitialized: false,
+        };
+        /** Cache of recent decisions for attribution lookup when track() is called */
+        this._decisionCache = new Map();
+        this._options = {
+            orgId: options.orgId,
+            projectId: options.projectId,
+            env: options.env,
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+            localConfig: options.localConfig,
+            refreshIntervalMs: options.refreshIntervalMs ?? DEFAULT_REFRESH_INTERVAL_MS,
+        };
+        // Initialize components
+        this._errorBoundary = new ErrorBoundary(options.errorBoundary);
+        this._storage = options.storage ?? createStorageProvider();
+        this._eventLogger = new EventLogger({
+            endpoint: `${this._options.baseUrl}/v1/events/batch`,
+            apiKey: options.apiKey,
+            storage: this._storage,
+            batchSize: options.eventBatchSize,
+            flushIntervalMs: options.eventFlushIntervalMs,
+            onError: (error) => {
+                console.warn("[Traffical] Event logging error:", error.message);
+            },
+        });
+        this._exposureDedup = new ExposureDeduplicator({
+            storage: this._storage,
+            sessionTtlMs: options.exposureSessionTtlMs,
+        });
+        this._stableId = new StableIdProvider({
+            storage: this._storage,
+        });
+        this._plugins = new PluginManager();
+        // Register decision tracking plugin (enabled by default)
+        if (options.trackDecisions !== false) {
+            this._plugins.register({
+                plugin: createDecisionTrackingPlugin({ deduplicationTtlMs: options.decisionDeduplicationTtlMs }, {
+                    orgId: this._options.orgId,
+                    projectId: this._options.projectId,
+                    env: this._options.env,
+                    log: (event) => this._eventLogger.log(event),
+                }),
+                priority: 100, // High priority so it runs before user plugins
+            });
+        }
+        // Register user-provided plugins
+        if (options.plugins) {
+            for (const plugin of options.plugins) {
+                this._plugins.register(plugin);
+            }
+        }
+        // Initialize with local config if provided
+        if (this._options.localConfig) {
+            this._state.bundle = this._options.localConfig;
+            // Notify plugins about the local config
+            this._plugins.runConfigUpdate(this._options.localConfig);
+        }
+    }
+    // ===========================================================================
+    // Initialization
+    // ===========================================================================
+    /**
+     * Initializes the client by fetching the config bundle.
+     */
+    async initialize() {
+        await this._errorBoundary.captureAsync("initialize", async () => {
+            await this._fetchConfig();
+            this._startBackgroundRefresh();
+            this._state.isInitialized = true;
+            // Run plugin onInitialize hooks
+            await this._plugins.runInitialize();
+        }, undefined);
+    }
+    /**
+     * Check if the client is initialized.
+     */
+    get isInitialized() {
+        return this._state.isInitialized;
+    }
+    /**
+     * Stops background refresh and cleans up resources.
+     */
+    destroy() {
+        if (this._state.refreshTimer) {
+            clearInterval(this._state.refreshTimer);
+            this._state.refreshTimer = null;
+        }
+        // Flush any remaining events
+        this._eventLogger.flushBeacon();
+        this._eventLogger.destroy();
+        // Run plugin onDestroy hooks
+        this._plugins.runDestroy();
+    }
+    // ===========================================================================
+    // Config Management
+    // ===========================================================================
+    /**
+     * Manually refreshes the config bundle.
+     */
+    async refreshConfig() {
+        await this._errorBoundary.swallow("refreshConfig", async () => {
+            await this._fetchConfig();
+        });
+    }
+    /**
+     * Gets the current config bundle version.
+     */
+    getConfigVersion() {
+        return this._state.bundle?.version ?? null;
+    }
+    // ===========================================================================
+    // Parameter Resolution
+    // ===========================================================================
+    /**
+     * Resolves parameters with defaults as fallback.
+     */
+    getParams(options) {
+        return this._errorBoundary.capture("getParams", () => {
+            const bundle = this._getEffectiveBundle();
+            const context = this._enrichContext(options.context);
+            const params = resolveParameters(bundle, context, options.defaults);
+            // Run plugin onResolve hooks (e.g., DOM binding plugin)
+            this._plugins.runResolve(params);
+            return params;
+        }, options.defaults);
+    }
+    /**
+     * Makes a decision with full metadata for tracking.
+     */
+    decide(options) {
+        return this._errorBoundary.capture("decide", () => {
+            const bundle = this._getEffectiveBundle();
+            // Run plugin onBeforeDecision hooks
+            let context = this._enrichContext(options.context);
+            context = this._plugins.runBeforeDecision(context);
+            const decision = coreDecide(bundle, context, options.defaults);
+            // Cache decision for attribution lookup when track() is called
+            this._cacheDecision(decision);
+            // Run plugin onDecision hooks (e.g., DOM binding plugin)
+            this._plugins.runDecision(decision);
+            return decision;
+        }, {
+            decisionId: generateDecisionId(),
+            assignments: options.defaults,
+            metadata: {
+                timestamp: new Date().toISOString(),
+                unitKeyValue: "",
+                layers: [],
+            },
+        });
+    }
+    // ===========================================================================
+    // Event Tracking
+    // ===========================================================================
+    /**
+     * Tracks an exposure event.
+     * Automatically deduplicates exposures for the same user/variant.
+     */
+    trackExposure(decision) {
+        this._errorBoundary.capture("trackExposure", () => {
+            const unitKey = decision.metadata.unitKeyValue;
+            if (!unitKey)
+                return;
+            // Check each layer for deduplication
+            for (const layer of decision.metadata.layers) {
+                if (!layer.policyId || !layer.allocationName)
+                    continue;
+                // Deduplicate
+                const isNew = this._exposureDedup.checkAndMark(unitKey, layer.policyId, layer.allocationName);
+                if (!isNew)
+                    continue;
+                const event = {
+                    type: "exposure",
+                    id: generateExposureId(), // Unique exposure ID (not same as decision)
+                    decisionId: decision.decisionId,
+                    orgId: this._options.orgId,
+                    projectId: this._options.projectId,
+                    env: this._options.env,
+                    unitKey,
+                    timestamp: new Date().toISOString(),
+                    assignments: decision.assignments,
+                    layers: decision.metadata.layers,
+                    context: decision.metadata.filteredContext,
+                    sdkName: SDK_NAME,
+                    sdkVersion: SDK_VERSION,
+                };
+                // Run plugin onExposure hooks
+                if (!this._plugins.runExposure(event)) {
+                    continue;
+                }
+                this._eventLogger.log(event);
+            }
+        }, undefined);
+    }
+    /**
+     * Tracks a user event.
+     *
+     * @param eventName - The event name (e.g., 'purchase', 'add_to_cart')
+     * @param properties - Optional event properties (including value for optimization)
+     * @param options - Optional tracking options (decisionId, unitKey)
+     *
+     * @example
+     * // Track a purchase with revenue
+     * client.track('purchase', { value: 99.99, orderId: 'ord_123' });
+     *
+     * // Track a simple event
+     * client.track('add_to_cart', { itemId: 'sku_456' });
+     *
+     * // Track with explicit decision attribution
+     * client.track('checkout_complete', { value: 1 }, { decisionId: decision.decisionId });
+     */
+    track(eventName, properties, options) {
+        this._errorBoundary.capture("track", () => {
+            const unitKey = options?.unitKey ?? this._stableId.getId();
+            const value = typeof properties?.value === 'number' ? properties.value : undefined;
+            // Auto-populate attribution from cached decision if available
+            let attribution;
+            const decisionId = options?.decisionId;
+            if (decisionId) {
+                const cachedDecision = this._decisionCache.get(decisionId);
+                if (cachedDecision) {
+                    attribution = cachedDecision.metadata.layers
+                        .filter((l) => l.policyId && l.allocationName)
+                        .map((l) => ({
+                        layerId: l.layerId,
+                        policyId: l.policyId,
+                        allocationName: l.allocationName,
+                    }));
+                }
+            }
+            const event = {
+                type: "track",
+                id: generateTrackEventId(),
+                orgId: this._options.orgId,
+                projectId: this._options.projectId,
+                env: this._options.env,
+                unitKey,
+                timestamp: new Date().toISOString(),
+                event: eventName,
+                value,
+                properties,
+                decisionId,
+                attribution,
+                sdkName: SDK_NAME,
+                sdkVersion: SDK_VERSION,
+            };
+            // Run plugin onTrack hooks
+            if (!this._plugins.runTrack(event)) {
+                return;
+            }
+            this._eventLogger.log(event);
+        }, undefined);
+    }
+    /**
+     * Flush pending events immediately.
+     */
+    async flushEvents() {
+        await this._errorBoundary.swallow("flushEvents", async () => {
+            await this._eventLogger.flush();
+        });
+    }
+    // ===========================================================================
+    // Plugin Management
+    // ===========================================================================
+    /**
+     * Register a plugin.
+     */
+    use(plugin) {
+        this._plugins.register(plugin);
+        return this;
+    }
+    /**
+     * Get a registered plugin by name.
+     */
+    getPlugin(name) {
+        return this._plugins.get(name);
+    }
+    // ===========================================================================
+    // Stable ID
+    // ===========================================================================
+    /**
+     * Get the stable ID for the current user.
+     */
+    getStableId() {
+        return this._stableId.getId();
+    }
+    /**
+     * Set a custom stable ID (e.g., when user logs in).
+     */
+    setStableId(id) {
+        this._stableId.setId(id);
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    _getEffectiveBundle() {
+        return this._state.bundle ?? this._options.localConfig ?? null;
+    }
+    _enrichContext(context) {
+        // Add stable ID if not already present
+        const bundle = this._getEffectiveBundle();
+        const unitKey = bundle?.hashing?.unitKey ?? "userId";
+        if (!context[unitKey]) {
+            return {
+                ...context,
+                [unitKey]: this._stableId.getId(),
+            };
+        }
+        return context;
+    }
+    async _fetchConfig() {
+        const url = `${this._options.baseUrl}/v1/config/${this._options.projectId}?env=${this._options.env}`;
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this._options.apiKey}`,
+        };
+        if (this._state.etag) {
+            headers["If-None-Match"] = this._state.etag;
+        }
+        try {
+            const response = await fetch(url, { method: "GET", headers });
+            if (response.status === 304) {
+                this._state.lastFetchTime = Date.now();
+                return;
+            }
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const bundle = (await response.json());
+            const etag = response.headers.get("ETag");
+            this._state.bundle = bundle;
+            this._state.etag = etag;
+            this._state.lastFetchTime = Date.now();
+            // Run plugin onConfigUpdate hooks (e.g., DOM binding plugin)
+            this._plugins.runConfigUpdate(bundle);
+        }
+        catch (error) {
+            this._logOfflineWarning(error);
+        }
+    }
+    _startBackgroundRefresh() {
+        if (this._options.refreshIntervalMs <= 0)
+            return;
+        this._state.refreshTimer = setInterval(() => {
+            this._fetchConfig().catch(() => {
+                // Errors logged in _fetchConfig
+            });
+        }, this._options.refreshIntervalMs);
+    }
+    _logOfflineWarning(error) {
+        const now = Date.now();
+        if (now - this._state.lastOfflineWarning > OFFLINE_WARNING_INTERVAL_MS) {
+            console.warn(`[Traffical] Failed to fetch config: ${error instanceof Error ? error.message : String(error)}. Using ${this._state.bundle ? "cached" : "local"} config.`);
+            this._state.lastOfflineWarning = now;
+        }
+    }
+    /**
+     * Caches a decision for attribution lookup when track() is called.
+     * Maintains a bounded cache to prevent memory leaks.
+     */
+    _cacheDecision(decision) {
+        // Evict oldest entries if cache is full
+        if (this._decisionCache.size >= DECISION_CACHE_MAX_SIZE) {
+            // Get first (oldest) key and delete it
+            const firstKey = this._decisionCache.keys().next().value;
+            if (firstKey) {
+                this._decisionCache.delete(firstKey);
+            }
+        }
+        this._decisionCache.set(decision.decisionId, decision);
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Creates and initializes a Traffical client.
+ */
+export async function createTrafficalClient(options) {
+    const client = new TrafficalClient(options);
+    await client.initialize();
+    return client;
+}
+/**
+ * Creates a Traffical client without initializing (synchronous).
+ */
+export function createTrafficalClientSync(options) {
+    return new TrafficalClient(options);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/error-boundary.d.ts

@@ -0,0 +1,47 @@
+/**
+ * ErrorBoundary - Ensures SDK never crashes customer's application.
+ *
+ * Wraps all public methods to catch errors and return safe defaults.
+ * Optionally reports errors to Traffical backend for monitoring.
+ */
+export interface ErrorBoundaryOptions {
+    /** Whether to report errors to Traffical backend */
+    reportErrors?: boolean;
+    /** Endpoint for error reporting */
+    errorEndpoint?: string;
+    /** SDK key for identification */
+    sdkKey?: string;
+    /** Callback when error occurs */
+    onError?: (tag: string, error: Error) => void;
+}
+export declare class ErrorBoundary {
+    private _seen;
+    private _options;
+    private _lastError;
+    constructor(options?: ErrorBoundaryOptions);
+    /**
+     * Wrap a synchronous function to catch errors and return fallback.
+     */
+    capture<T>(tag: string, fn: () => T, fallback: T): T;
+    /**
+     * Wrap an async function to catch errors and return fallback.
+     */
+    captureAsync<T>(tag: string, fn: () => Promise<T>, fallback: T): Promise<T>;
+    /**
+     * Execute an async operation without expecting a return value.
+     * Used for fire-and-forget operations like event tracking.
+     */
+    swallow(tag: string, fn: () => Promise<void>): Promise<void>;
+    /**
+     * Get the last error that occurred (for debugging).
+     */
+    getLastError(): Error | null;
+    /**
+     * Clear the seen errors set (for testing or session reset).
+     */
+    clearSeen(): void;
+    private _onError;
+    private _reportError;
+    private _resolveError;
+}
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../src/error-boundary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,UAAU,CAAsB;gBAE5B,OAAO,GAAE,oBAAyB;IAI9C;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IASpD;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASjF;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE;;OAEG;IACH,YAAY,IAAI,KAAK,GAAG,IAAI;IAM5B;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,QAAQ;YAyBF,YAAY;IAyB1B,OAAO,CAAC,aAAa;CAStB"}

package/dist/error-boundary.js

@@ -0,0 +1,118 @@
+/**
+ * ErrorBoundary - Ensures SDK never crashes customer's application.
+ *
+ * Wraps all public methods to catch errors and return safe defaults.
+ * Optionally reports errors to Traffical backend for monitoring.
+ */
+export class ErrorBoundary {
+    constructor(options = {}) {
+        this._seen = new Set();
+        this._lastError = null;
+        this._options = options;
+    }
+    /**
+     * Wrap a synchronous function to catch errors and return fallback.
+     */
+    capture(tag, fn, fallback) {
+        try {
+            return fn();
+        }
+        catch (error) {
+            this._onError(tag, error);
+            return fallback;
+        }
+    }
+    /**
+     * Wrap an async function to catch errors and return fallback.
+     */
+    async captureAsync(tag, fn, fallback) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            this._onError(tag, error);
+            return fallback;
+        }
+    }
+    /**
+     * Execute an async operation without expecting a return value.
+     * Used for fire-and-forget operations like event tracking.
+     */
+    async swallow(tag, fn) {
+        try {
+            await fn();
+        }
+        catch (error) {
+            this._onError(tag, error);
+        }
+    }
+    /**
+     * Get the last error that occurred (for debugging).
+     */
+    getLastError() {
+        const error = this._lastError;
+        this._lastError = null;
+        return error;
+    }
+    /**
+     * Clear the seen errors set (for testing or session reset).
+     */
+    clearSeen() {
+        this._seen.clear();
+    }
+    _onError(tag, error) {
+        const resolvedError = this._resolveError(error);
+        this._lastError = resolvedError;
+        // Deduplicate - only handle each unique error once
+        const errorKey = `${tag}:${resolvedError.name}:${resolvedError.message}`;
+        if (this._seen.has(errorKey)) {
+            return;
+        }
+        this._seen.add(errorKey);
+        // Log to console (development)
+        console.warn(`[Traffical] Error in ${tag}:`, resolvedError.message);
+        // Call user-provided callback
+        this._options.onError?.(tag, resolvedError);
+        // Optionally report to backend
+        if (this._options.reportErrors && this._options.errorEndpoint) {
+            this._reportError(tag, resolvedError).catch(() => {
+                // Silently fail - we don't want error reporting to cause errors
+            });
+        }
+    }
+    async _reportError(tag, error) {
+        if (!this._options.errorEndpoint)
+            return;
+        try {
+            await fetch(this._options.errorEndpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...(this._options.sdkKey && { "X-Traffical-Key": this._options.sdkKey }),
+                },
+                body: JSON.stringify({
+                    tag,
+                    error: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                    timestamp: new Date().toISOString(),
+                    sdk: "@traffical/js-client",
+                    userAgent: typeof navigator !== "undefined" ? navigator.userAgent : undefined,
+                }),
+            });
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    _resolveError(error) {
+        if (error instanceof Error) {
+            return error;
+        }
+        if (typeof error === "string") {
+            return new Error(error);
+        }
+        return new Error("An unknown error occurred");
+    }
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/error-boundary.js.map

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