@traffical/node 0.1.2

package/dist/client.js

@@ -0,0 +1,419 @@
+/**
+ * Traffical Node.js SDK Client
+ *
+ * HTTP client with caching, background refresh, and graceful degradation.
+ * Wraps the pure core-ts resolution engine.
+ *
+ * Features:
+ * - ETag-based caching for efficient config fetches
+ * - Background refresh for keeping config up-to-date
+ * - Automatic decision tracking for intent-to-treat analysis
+ * - Batched event transport for efficiency
+ * - Graceful degradation with local config and schema defaults
+ */
+import { resolveParameters, decide as coreDecide, DecisionDeduplicator, generateExposureId, generateTrackEventId, } from "@traffical/core";
+import { EventBatcher } from "./event-batcher.js";
+// =============================================================================
+// Constants
+// =============================================================================
+const SDK_NAME = "node";
+const SDK_VERSION = "0.1.0"; // Should match package.json version
+const DEFAULT_BASE_URL = "https://sdk.traffical.io";
+const DEFAULT_REFRESH_INTERVAL_MS = 60_000; // 1 minute
+const OFFLINE_WARNING_INTERVAL_MS = 300_000; // 5 minutes
+const DECISION_CACHE_MAX_SIZE = 1000; // Max decisions to cache for attribution lookup
+// =============================================================================
+// Traffical Client Class
+// =============================================================================
+/**
+ * TrafficalClient - the main SDK client for Node.js environments.
+ *
+ * Features:
+ * - ETag-based caching for efficient config fetches
+ * - Background refresh for keeping config up-to-date
+ * - Automatic decision tracking for intent-to-treat analysis
+ * - Batched event transport for efficiency
+ * - Graceful degradation with local config and schema defaults
+ * - Rate-limited offline warnings
+ */
+export class TrafficalClient {
+    _options;
+    _state = {
+        bundle: null,
+        etag: null,
+        lastFetchTime: 0,
+        lastOfflineWarning: 0,
+        refreshTimer: null,
+        isInitialized: false,
+    };
+    _eventBatcher;
+    _decisionDedup;
+    /** Cache of recent decisions for attribution lookup on rewards */
+    _decisionCache = new Map();
+    constructor(options) {
+        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,
+            strictMode: options.strictMode ?? false,
+            trackDecisions: options.trackDecisions !== false, // Default: true
+        };
+        // Initialize event batcher
+        this._eventBatcher = new EventBatcher({
+            endpoint: `${this._options.baseUrl}/v1/events/batch`,
+            apiKey: options.apiKey,
+            batchSize: options.eventBatchSize,
+            flushIntervalMs: options.eventFlushIntervalMs,
+            debug: options.debugEvents,
+            onError: (error) => {
+                console.warn(`[Traffical] Event batching error: ${error.message}`);
+            },
+        });
+        // Initialize decision deduplicator
+        this._decisionDedup = new DecisionDeduplicator({
+            ttlMs: options.decisionDeduplicationTtlMs,
+        });
+        // Initialize with local config if provided
+        if (this._options.localConfig) {
+            this._state.bundle = this._options.localConfig;
+        }
+    }
+    /**
+     * Initializes the client by fetching the config bundle.
+     * This is called automatically by createTrafficalClient.
+     */
+    async initialize() {
+        await this._fetchConfig();
+        this._startBackgroundRefresh();
+        this._state.isInitialized = true;
+    }
+    /**
+     * Stops background refresh and cleans up resources.
+     */
+    async destroy() {
+        if (this._state.refreshTimer) {
+            clearInterval(this._state.refreshTimer);
+            this._state.refreshTimer = null;
+        }
+        // Flush remaining events
+        await this._eventBatcher.destroy();
+    }
+    /**
+     * Synchronous destroy for process exit handlers.
+     * Use destroy() when possible for proper cleanup.
+     */
+    destroySync() {
+        if (this._state.refreshTimer) {
+            clearInterval(this._state.refreshTimer);
+            this._state.refreshTimer = null;
+        }
+        this._eventBatcher.destroySync();
+    }
+    /**
+     * Manually refreshes the config bundle.
+     */
+    async refreshConfig() {
+        await this._fetchConfig();
+    }
+    /**
+     * Gets the current config bundle version.
+     */
+    getConfigVersion() {
+        return this._state.bundle?.version ?? null;
+    }
+    /**
+     * Flush pending events immediately.
+     */
+    async flushEvents() {
+        await this._eventBatcher.flush();
+    }
+    /**
+     * Resolves parameters with defaults as fallback.
+     *
+     * Resolution priority (highest wins):
+     * 1. Policy overrides (from remote bundle)
+     * 2. Parameter defaults (from remote bundle)
+     * 3. Local config (if remote unavailable)
+     * 4. Caller defaults
+     */
+    getParams(options) {
+        const bundle = this._getEffectiveBundle();
+        return resolveParameters(bundle, options.context, options.defaults);
+    }
+    /**
+     * Makes a decision with full metadata for tracking.
+     *
+     * When trackDecisions is enabled (default), automatically sends a DecisionEvent
+     * to the backend for intent-to-treat analysis.
+     */
+    decide(options) {
+        const start = Date.now();
+        const bundle = this._getEffectiveBundle();
+        const decision = coreDecide(bundle, options.context, options.defaults);
+        const latencyMs = Date.now() - start;
+        // Cache decision for attribution lookup when trackReward is called
+        this._cacheDecision(decision);
+        // Auto-track decision if enabled
+        if (this._options.trackDecisions) {
+            this._trackDecision(decision, latencyMs, Object.keys(options.defaults));
+        }
+        return decision;
+    }
+    /**
+     * Tracks an exposure event.
+     *
+     * If the decision includes filtered context (from policies with contextLogging),
+     * it will be included in the exposure event for contextual bandit training.
+     */
+    trackExposure(decision) {
+        const unitKey = decision.metadata.unitKeyValue;
+        if (!unitKey) {
+            // Can't track without unit key
+            return;
+        }
+        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,
+            // Include filtered context for contextual bandit training
+            context: decision.metadata.filteredContext,
+            sdkName: SDK_NAME,
+            sdkVersion: SDK_VERSION,
+        };
+        this._eventBatcher.log(event);
+    }
+    /**
+     * Tracks a user event.
+     *
+     * @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: 'dec_xyz' });
+     */
+    track(event, properties, options) {
+        const value = typeof properties?.value === 'number' ? properties.value : undefined;
+        // Auto-populate attribution from cached decision if available
+        const attribution = this._getAttributionFromCache(options?.decisionId);
+        const trackEvent = {
+            type: "track",
+            id: generateTrackEventId(),
+            orgId: this._options.orgId,
+            projectId: this._options.projectId,
+            env: this._options.env,
+            unitKey: options?.unitKey || "",
+            timestamp: new Date().toISOString(),
+            event,
+            value,
+            properties,
+            decisionId: options?.decisionId,
+            attribution,
+            sdkName: SDK_NAME,
+            sdkVersion: SDK_VERSION,
+        };
+        this._eventBatcher.log(trackEvent);
+    }
+    /**
+     * @deprecated Use track() instead.
+     * Tracks a reward event.
+     * If decisionId is provided and the decision is cached, attribution is auto-populated.
+     */
+    trackReward(options) {
+        // Map old API to new track() API
+        this.track(options.event, options.properties, {
+            decisionId: undefined, // Not available in old API without decisionId
+        });
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    /**
+     * Gets the effective bundle: remote > local > null
+     */
+    _getEffectiveBundle() {
+        return this._state.bundle ?? this._options.localConfig ?? null;
+    }
+    /**
+     * Fetches the config bundle from the edge worker.
+     * Uses ETag for efficient caching.
+     */
+    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}`,
+        };
+        // Add ETag for conditional request
+        if (this._state.etag) {
+            headers["If-None-Match"] = this._state.etag;
+        }
+        try {
+            const response = await fetch(url, { method: "GET", headers });
+            if (response.status === 304) {
+                // Not modified - bundle is still valid
+                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();
+        }
+        catch (error) {
+            this._logOfflineWarning(error);
+        }
+    }
+    /**
+     * Starts background refresh timer.
+     */
+    _startBackgroundRefresh() {
+        if (this._options.refreshIntervalMs <= 0) {
+            return;
+        }
+        this._state.refreshTimer = setInterval(() => {
+            this._fetchConfig().catch(() => {
+                // Errors are logged in _fetchConfig
+            });
+        }, this._options.refreshIntervalMs);
+        // Unref so timer doesn't keep process alive
+        if (typeof this._state.refreshTimer.unref === "function") {
+            this._state.refreshTimer.unref();
+        }
+    }
+    /**
+     * Logs an offline warning (rate-limited).
+     */
+    _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;
+        }
+    }
+    /**
+     * Tracks a decision event (internal).
+     * Called automatically when trackDecisions is enabled.
+     */
+    _trackDecision(decision, latencyMs, requestedParameters) {
+        const unitKey = decision.metadata.unitKeyValue;
+        if (!unitKey) {
+            // Can't track without unit key
+            return;
+        }
+        // Hash assignments for deduplication
+        const hash = DecisionDeduplicator.hashAssignments(decision.assignments);
+        // Check deduplication
+        if (!this._decisionDedup.checkAndMark(unitKey, hash)) {
+            return; // Duplicate, skip
+        }
+        // Build the decision event
+        const event = {
+            type: "decision",
+            id: decision.decisionId,
+            orgId: this._options.orgId,
+            projectId: this._options.projectId,
+            env: this._options.env,
+            unitKey,
+            timestamp: decision.metadata.timestamp,
+            requestedParameters,
+            assignments: decision.assignments,
+            layers: decision.metadata.layers,
+            latencyMs,
+            // Include filtered context if available
+            context: decision.metadata.filteredContext,
+            sdkName: SDK_NAME,
+            sdkVersion: SDK_VERSION,
+        };
+        this._eventBatcher.log(event);
+    }
+    /**
+     * Caches a decision for attribution lookup when trackReward 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);
+    }
+    /**
+     * Gets attribution info from cached decision if available.
+     */
+    _getAttributionFromCache(decisionId) {
+        if (!decisionId) {
+            return undefined;
+        }
+        const cachedDecision = this._decisionCache.get(decisionId);
+        if (!cachedDecision) {
+            return undefined;
+        }
+        const attribution = cachedDecision.metadata.layers
+            .filter((l) => l.policyId && l.allocationName)
+            .map((l) => ({
+            layerId: l.layerId,
+            policyId: l.policyId,
+            allocationName: l.allocationName,
+        }));
+        return attribution.length > 0 ? attribution : undefined;
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Creates and initializes a Traffical client.
+ *
+ * @example
+ * ```typescript
+ * const traffical = await createTrafficalClient({
+ *   orgId: "org_123",
+ *   projectId: "proj_456",
+ *   env: "production",
+ *   apiKey: "sk_...",
+ * });
+ *
+ * const params = traffical.getParams({
+   *   context: { userId: "user_789" },
+   *   defaults: {
+   *     "ui.button.color": "#000",
+   *   },
+   * });
+ * ```
+ */
+export async function createTrafficalClient(options) {
+    const client = new TrafficalClient(options);
+    await client.initialize();
+    return client;
+}
+/**
+ * Creates a Traffical client without initializing (synchronous).
+ * Useful when you want to control initialization timing.
+ */
+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/event-batcher.d.ts

@@ -0,0 +1,74 @@
+/**
+ * EventBatcher - Batched event transport for Node.js environments.
+ *
+ * Features:
+ * - Batches events for efficient network usage
+ * - Flushes on batch size or interval (whichever comes first)
+ * - Graceful shutdown with final flush
+ * - Error handling with configurable callback
+ *
+ * Unlike the browser EventLogger, this implementation:
+ * - Does not use sendBeacon (Node.js doesn't have it)
+ * - Does not persist failed events to storage
+ * - Uses standard fetch for HTTP requests
+ */
+import type { TrackableEvent } from "@traffical/core";
+/**
+ * Options for EventBatcher.
+ */
+export interface EventBatcherOptions {
+    /** API endpoint for events */
+    endpoint: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Max events before auto-flush (default: 10) */
+    batchSize?: number;
+    /** Auto-flush interval in ms (default: 30000) */
+    flushIntervalMs?: number;
+    /** Callback on flush error */
+    onError?: (error: Error) => void;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export declare class EventBatcher {
+    private readonly _endpoint;
+    private readonly _apiKey;
+    private readonly _batchSize;
+    private readonly _flushIntervalMs;
+    private readonly _onError?;
+    private readonly _debug;
+    private _queue;
+    private _flushTimer;
+    private _isFlushing;
+    private _isDestroyed;
+    constructor(options: EventBatcherOptions);
+    /**
+     * Log an event (added to batch queue).
+     */
+    log(event: TrackableEvent): void;
+    /**
+     * Flush all queued events immediately.
+     */
+    flush(): Promise<void>;
+    /**
+     * Get the number of events in the queue.
+     */
+    get queueSize(): number;
+    /**
+     * Check if the batcher is destroyed.
+     */
+    get isDestroyed(): boolean;
+    /**
+     * Destroy the batcher (cleanup timers and flush remaining events).
+     */
+    destroy(): Promise<void>;
+    /**
+     * Synchronous destroy (for process exit handlers).
+     * Does not wait for flush to complete.
+     */
+    destroySync(): void;
+    private _sendEvents;
+    private _startFlushTimer;
+    private _log;
+}
+//# sourceMappingURL=event-batcher.d.ts.map

package/dist/event-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-batcher.d.ts","sourceRoot":"","sources":["../src/event-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,mBAAmB;IAYxC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAkBhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;;OAGG;IACH,WAAW,IAAI,IAAI;YAgBL,WAAW;IAezB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,IAAI;CAKb"}

package/dist/event-batcher.js

@@ -0,0 +1,165 @@
+/**
+ * EventBatcher - Batched event transport for Node.js environments.
+ *
+ * Features:
+ * - Batches events for efficient network usage
+ * - Flushes on batch size or interval (whichever comes first)
+ * - Graceful shutdown with final flush
+ * - Error handling with configurable callback
+ *
+ * Unlike the browser EventLogger, this implementation:
+ * - Does not use sendBeacon (Node.js doesn't have it)
+ * - Does not persist failed events to storage
+ * - Uses standard fetch for HTTP requests
+ */
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_FLUSH_INTERVAL_MS = 30_000; // 30 seconds
+export class EventBatcher {
+    _endpoint;
+    _apiKey;
+    _batchSize;
+    _flushIntervalMs;
+    _onError;
+    _debug;
+    _queue = [];
+    _flushTimer = null;
+    _isFlushing = false;
+    _isDestroyed = false;
+    constructor(options) {
+        this._endpoint = options.endpoint;
+        this._apiKey = options.apiKey;
+        this._batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+        this._flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this._onError = options.onError;
+        this._debug = options.debug ?? false;
+        // Start flush timer
+        this._startFlushTimer();
+    }
+    /**
+     * Log an event (added to batch queue).
+     */
+    log(event) {
+        if (this._isDestroyed) {
+            this._log("Attempted to log event after destroy, ignoring");
+            return;
+        }
+        this._queue.push(event);
+        this._log(`Event queued (queue size: ${this._queue.length})`);
+        // Auto-flush if batch is full
+        if (this._queue.length >= this._batchSize) {
+            this._log("Batch size reached, flushing");
+            this.flush().catch(() => {
+                // Errors handled in flush
+            });
+        }
+    }
+    /**
+     * Flush all queued events immediately.
+     */
+    async flush() {
+        if (this._isFlushing || this._queue.length === 0) {
+            return;
+        }
+        this._isFlushing = true;
+        // Take current queue
+        const events = [...this._queue];
+        this._queue = [];
+        try {
+            await this._sendEvents(events);
+            this._log(`Flushed ${events.length} events successfully`);
+        }
+        catch (error) {
+            // Put events back in queue for retry (at the front)
+            this._queue.unshift(...events);
+            this._log(`Flush failed, ${events.length} events re-queued`);
+            this._onError?.(error instanceof Error ? error : new Error(String(error)));
+        }
+        finally {
+            this._isFlushing = false;
+        }
+    }
+    /**
+     * Get the number of events in the queue.
+     */
+    get queueSize() {
+        return this._queue.length;
+    }
+    /**
+     * Check if the batcher is destroyed.
+     */
+    get isDestroyed() {
+        return this._isDestroyed;
+    }
+    /**
+     * Destroy the batcher (cleanup timers and flush remaining events).
+     */
+    async destroy() {
+        if (this._isDestroyed) {
+            return;
+        }
+        this._isDestroyed = true;
+        // Stop timer
+        if (this._flushTimer) {
+            clearInterval(this._flushTimer);
+            this._flushTimer = null;
+        }
+        // Final flush
+        if (this._queue.length > 0) {
+            this._log(`Destroying with ${this._queue.length} events in queue, flushing`);
+            await this.flush();
+        }
+    }
+    /**
+     * Synchronous destroy (for process exit handlers).
+     * Does not wait for flush to complete.
+     */
+    destroySync() {
+        this._isDestroyed = true;
+        if (this._flushTimer) {
+            clearInterval(this._flushTimer);
+            this._flushTimer = null;
+        }
+        // Attempt to flush but don't wait
+        if (this._queue.length > 0) {
+            this.flush().catch(() => {
+                // Best effort on shutdown
+            });
+        }
+    }
+    async _sendEvents(events) {
+        const response = await fetch(this._endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this._apiKey}`,
+            },
+            body: JSON.stringify({ events }),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+    }
+    _startFlushTimer() {
+        if (this._flushIntervalMs <= 0) {
+            return;
+        }
+        this._flushTimer = setInterval(() => {
+            if (this._queue.length > 0) {
+                this.flush().catch(() => {
+                    // Errors handled in flush
+                });
+            }
+        }, this._flushIntervalMs);
+        // Unref the timer so it doesn't keep the process alive
+        // This is important for Node.js servers that need to shutdown gracefully
+        if (typeof this._flushTimer.unref === "function") {
+            this._flushTimer.unref();
+        }
+    }
+    _log(message) {
+        if (this._debug) {
+            console.log(`[Traffical EventBatcher] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=event-batcher.js.map

package/dist/event-batcher.js.map

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