@traffical/node 0.8.0 → 0.10.0

package/dist/contract-0.7.0.test.js

@@ -0,0 +1,171 @@
+/**
+ * Spec 0.7.0 contract behaviors for the Node SDK: bounded event queue with
+ * drop-oldest, exponential-backoff retry + re-queue, HTTP 401 kill-switch,
+ * trackReward value/decisionId forwarding, positional decide/getParams, and
+ * the close()/waitForReady() lifecycle verbs.
+ */
+import { describe, test, expect, beforeEach, afterEach, mock } from "bun:test";
+import { EventBatcher } from "./event-batcher.js";
+import { TrafficalClient } from "./client.js";
+function trackEvent(id = "evt") {
+    return {
+        type: "track",
+        id,
+        orgId: "org_1",
+        projectId: "proj_1",
+        env: "test",
+        unitKey: "u1",
+        timestamp: new Date().toISOString(),
+        event: "e",
+    };
+}
+describe("EventBatcher bounded queue (S8)", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    test("drops the oldest event when the queue is full and counts drops", () => {
+        // Never auto-flush (huge batchSize + interval), tiny queue cap.
+        const batcher = new EventBatcher({
+            endpoint: "https://x/v1/events/batch",
+            apiKey: "pk",
+            batchSize: 1000,
+            flushIntervalMs: 999999,
+            maxQueueSize: 2,
+        });
+        batcher.log(trackEvent("a"));
+        batcher.log(trackEvent("b"));
+        batcher.log(trackEvent("c")); // evicts "a"
+        expect(batcher.queueSize).toBe(2);
+        expect(batcher.droppedCount).toBe(1);
+        batcher.destroySync();
+    });
+    test("HTTP 401 permanently disables delivery and clears the queue", async () => {
+        globalThis.fetch = mock(() => Promise.resolve(new Response("no", { status: 401 })));
+        const batcher = new EventBatcher({
+            endpoint: "https://x/v1/events/batch",
+            apiKey: "pk",
+            batchSize: 1000,
+            flushIntervalMs: 999999,
+        });
+        batcher.log(trackEvent("a"));
+        await batcher.flush();
+        expect(batcher.isDisabled).toBe(true);
+        expect(batcher.queueSize).toBe(0);
+        // Subsequent logs are dropped (no buffering after kill-switch).
+        batcher.log(trackEvent("b"));
+        expect(batcher.queueSize).toBe(0);
+        batcher.destroySync();
+    });
+    test("retries a 5xx with backoff, then re-queues the batch", async () => {
+        const fetchMock = mock(() => Promise.resolve(new Response("err", { status: 503 })));
+        globalThis.fetch = fetchMock;
+        const errors = [];
+        const batcher = new EventBatcher({
+            endpoint: "https://x/v1/events/batch",
+            apiKey: "pk",
+            batchSize: 1000,
+            flushIntervalMs: 999999,
+            maxRetries: 2,
+            retryBackoffMs: 1,
+            onError: (e) => errors.push(e),
+        });
+        batcher.log(trackEvent("a"));
+        await batcher.flush();
+        // 1 initial + 2 retries = 3 attempts, then re-queued for a later flush.
+        expect(fetchMock.mock.calls.length).toBe(3);
+        expect(batcher.queueSize).toBe(1);
+        expect(errors).toHaveLength(1);
+        expect(batcher.isDisabled).toBe(false);
+        batcher.destroySync();
+    });
+});
+describe("Node client contract (S8 + A1)", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+        // Config fetch 404 => fail-open; client stays usable with caller defaults.
+        globalThis.fetch = mock(() => Promise.resolve(new Response("not found", { status: 404 })));
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    test("waitForReady() resolves even when the bundle 404s (fail-open)", async () => {
+        const client = new TrafficalClient({
+            orgId: "o",
+            projectId: "p",
+            env: "test",
+            apiKey: "pk",
+            disableCloudEvents: true,
+        });
+        await client.initialize();
+        await client.waitForReady(); // must not hang
+        expect(true).toBe(true);
+        await client.close();
+    });
+    test("positional decide(context, defaults) matches the legacy object bag", async () => {
+        const client = new TrafficalClient({
+            orgId: "o",
+            projectId: "p",
+            env: "test",
+            apiKey: "pk",
+            disableCloudEvents: true,
+            trackDecisions: false,
+        });
+        await client.initialize();
+        const positional = client.decide({ userId: "u1" }, { "ui.color": "#000" });
+        const bag = client.decide({ context: { userId: "u1" }, defaults: { "ui.color": "#000" } });
+        expect(positional.assignments).toEqual(bag.assignments);
+        expect(positional.metadata.unitKeyValue).toBe(bag.metadata.unitKeyValue);
+        await client.close();
+    });
+    test("trackReward forwards value and decisionId (previously dropped)", async () => {
+        const captured = [];
+        const client = new TrafficalClient({
+            orgId: "o",
+            projectId: "p",
+            env: "test",
+            apiKey: "pk",
+            disableCloudEvents: true,
+            trackDecisions: false,
+            eventLogger: (e) => captured.push(e),
+        });
+        await client.initialize();
+        const decision = client.decide({ userId: "u1" }, { "ui.color": "#000" });
+        client.trackReward({ event: "purchase", value: 42, decisionId: decision.decisionId });
+        const track = captured.find((e) => e.type === "track");
+        expect(track).toBeDefined();
+        expect(track.value).toBe(42);
+        expect(track.decisionId).toBe(decision.decisionId);
+        await client.close();
+    });
+    test("track() options bag carries value/values/eventTimestamp", async () => {
+        const captured = [];
+        const client = new TrafficalClient({
+            orgId: "o",
+            projectId: "p",
+            env: "test",
+            apiKey: "pk",
+            disableCloudEvents: true,
+            trackDecisions: false,
+            eventLogger: (e) => captured.push(e),
+        });
+        await client.initialize();
+        const ts = "2024-06-01T00:00:00.000Z";
+        client.track("purchase", { orderId: "o1" }, {
+            unitKey: "u1",
+            value: 10,
+            values: { revenue: 10, items: 2 },
+            eventTimestamp: ts,
+        });
+        const track = captured.find((e) => e.type === "track");
+        expect(track.value).toBe(10);
+        expect(track.values).toEqual({ revenue: 10, items: 2 });
+        expect(track.eventTimestamp).toBe(ts);
+        await client.close();
+    });
+});
+//# sourceMappingURL=contract-0.7.0.test.js.map

package/dist/contract-0.7.0.test.js.map

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

package/dist/event-batcher.d.ts

@@ -25,6 +25,26 @@ export interface EventBatcherOptions {
     batchSize?: number;
     /** Auto-flush interval in ms (default: 30000) */
     flushIntervalMs?: number;
+    /**
+     * Timeout in ms for the event batch POST (default: 10000).
+     * On timeout the request is aborted and treated like a failed send:
+     * events are re-queued for retry.
+     */
+    requestTimeoutMs?: number;
+    /**
+     * Maximum number of events buffered in memory (default: 1000). When the
+     * queue is full, the OLDEST event is dropped (a counter is bumped) — the
+     * queue never grows without bound. Aligns with the Python SDK's model.
+     */
+    maxQueueSize?: number;
+    /**
+     * Max retry attempts (after the first) for a transient delivery failure
+     * (network error, timeout, 429, 5xx) before the batch is re-queued for a
+     * later flush (default: 3).
+     */
+    maxRetries?: number;
+    /** Base for exponential retry backoff in ms: base * 2^(attempt-1) (default: 250). */
+    retryBackoffMs?: number;
     /** Callback on flush error */
     onError?: (error: Error) => void;
     /** Enable debug logging */
@@ -37,6 +57,10 @@ export declare class EventBatcher {
     private readonly _apiKey;
     private readonly _batchSize;
     private readonly _flushIntervalMs;
+    private readonly _requestTimeoutMs;
+    private readonly _maxQueueSize;
+    private readonly _maxRetries;
+    private readonly _retryBackoffMs;
     private readonly _onError?;
     private readonly _onSchemaWarnings?;
     private readonly _debug;
@@ -44,19 +68,45 @@ export declare class EventBatcher {
     private _flushTimer;
     private _isFlushing;
     private _isDestroyed;
+    /** Permanently true after an HTTP 401 kill-switch fires. */
+    private _isDisabled;
+    /** Count of events dropped because the bounded queue overflowed. */
+    private _droppedCount;
     constructor(options: EventBatcherOptions);
     /**
-     * Log an event (added to batch queue).
+     * Log an event (added to the bounded batch queue). When the queue is full
+     * the OLDEST event is dropped (drop-oldest) so memory can't grow without
+     * bound. After a 401 kill-switch, events are silently discarded.
      */
     log(event: TrackableEvent): void;
     /**
-     * Flush all queued events immediately.
+     * Flush queued events immediately.
+     *
+     * Drains the queue in batch-sized chunks. Each batch is delivered with
+     * exponential-backoff retry on transient failures (network/timeout/429/5xx).
+     * A batch that still fails after `maxRetries` is re-queued at the FRONT
+     * (bounded) and draining stops until the next flush. A non-retryable 4xx
+     * drops the batch. An HTTP 401 permanently disables delivery and clears the
+     * queue (auth kill-switch).
      */
     flush(): Promise<void>;
+    /**
+     * Delivers one batch with bounded exponential-backoff retry.
+     * onError fires exactly once per batch that ends in a retry-later.
+     */
+    private _deliverWithRetry;
+    /** Re-queues a failed batch at the front, dropping oldest on overflow. */
+    private _requeueFront;
+    private _disable;
+    private _sleep;
     /**
      * Get the number of events in the queue.
      */
     get queueSize(): number;
+    /** Number of events dropped because the bounded queue overflowed. */
+    get droppedCount(): number;
+    /** True once an HTTP 401 permanently disabled delivery. */
+    get isDisabled(): boolean;
     /**
      * Check if the batcher is destroyed.
      */
@@ -70,6 +120,12 @@ export declare class EventBatcher {
      * Does not wait for flush to complete.
      */
     destroySync(): void;
+    /**
+     * Sends one batch and returns the HTTP status code. Throws only on a
+     * transport-level failure (network error / abort), which the caller treats
+     * as a transient, retryable error. HTTP status classification (2xx / 401 /
+     * 4xx / 5xx) is done by the caller.
+     */
     private _sendEvents;
     private _startFlushTimer;
     private _log;

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

@@ -1 +1 @@
-{"version":3,"file":"event-batcher.d.ts","sourceRoot":"","sources":["../src/event-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC;AAK5F;;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;IAChB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;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,iBAAiB,CAAC,CAAmB;IACtD,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;IAaxC;;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;IA0BzB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,IAAI;CAKb"}
+{"version":3,"file":"event-batcher.d.ts","sourceRoot":"","sources":["../src/event-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC;AAS5F;;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;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAKD,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,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAmB;IACtD,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;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,oEAAoE;IACpE,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,EAAE,mBAAmB;IAiBxC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA6BhC;;;;;;;;;OASG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC5B;;;OAGG;YACW,iBAAiB;IAwC/B,0EAA0E;IAC1E,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,MAAM;IASd;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,qEAAqE;IACrE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,2DAA2D;IAC3D,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;;OAGG;IACH,WAAW,IAAI,IAAI;IAgBnB;;;;;OAKG;YACW,WAAW;IAuCzB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,IAAI;CAKb"}

package/dist/event-batcher.js

@@ -14,11 +14,19 @@
  */
 const DEFAULT_BATCH_SIZE = 10;
 const DEFAULT_FLUSH_INTERVAL_MS = 30_000; // 30 seconds
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000; // 10 seconds
+const DEFAULT_MAX_QUEUE_SIZE = 1_000; // bounded queue; overflow drops oldest
+const DEFAULT_MAX_RETRIES = 3; // attempts after the first = 3
+const DEFAULT_RETRY_BACKOFF_MS = 250; // exponential: base * 2^(attempt-1)
 export class EventBatcher {
     _endpoint;
     _apiKey;
     _batchSize;
     _flushIntervalMs;
+    _requestTimeoutMs;
+    _maxQueueSize;
+    _maxRetries;
+    _retryBackoffMs;
     _onError;
     _onSchemaWarnings;
     _debug;
@@ -26,11 +34,19 @@ export class EventBatcher {
     _flushTimer = null;
     _isFlushing = false;
     _isDestroyed = false;
+    /** Permanently true after an HTTP 401 kill-switch fires. */
+    _isDisabled = false;
+    /** Count of events dropped because the bounded queue overflowed. */
+    _droppedCount = 0;
     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._requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this._maxQueueSize = options.maxQueueSize ?? DEFAULT_MAX_QUEUE_SIZE;
+        this._maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this._retryBackoffMs = options.retryBackoffMs ?? DEFAULT_RETRY_BACKOFF_MS;
         this._onError = options.onError;
         this._onSchemaWarnings = options.onSchemaWarnings;
         this._debug = options.debug ?? false;
@@ -38,13 +54,25 @@ export class EventBatcher {
         this._startFlushTimer();
     }
     /**
-     * Log an event (added to batch queue).
+     * Log an event (added to the bounded batch queue). When the queue is full
+     * the OLDEST event is dropped (drop-oldest) so memory can't grow without
+     * bound. After a 401 kill-switch, events are silently discarded.
      */
     log(event) {
         if (this._isDestroyed) {
             this._log("Attempted to log event after destroy, ignoring");
             return;
         }
+        if (this._isDisabled) {
+            // Delivery permanently disabled (401) — stop buffering entirely.
+            return;
+        }
+        // Bounded queue: drop the oldest event on overflow.
+        if (this._queue.length >= this._maxQueueSize) {
+            this._queue.shift();
+            this._droppedCount++;
+            this._log(`Queue full, dropped oldest event (dropped total: ${this._droppedCount})`);
+        }
         this._queue.push(event);
         this._log(`Event queued (queue size: ${this._queue.length})`);
         // Auto-flush if batch is full
@@ -56,36 +84,124 @@ export class EventBatcher {
         }
     }
     /**
-     * Flush all queued events immediately.
+     * Flush queued events immediately.
+     *
+     * Drains the queue in batch-sized chunks. Each batch is delivered with
+     * exponential-backoff retry on transient failures (network/timeout/429/5xx).
+     * A batch that still fails after `maxRetries` is re-queued at the FRONT
+     * (bounded) and draining stops until the next flush. A non-retryable 4xx
+     * drops the batch. An HTTP 401 permanently disables delivery and clears the
+     * queue (auth kill-switch).
      */
     async flush() {
-        if (this._isFlushing || this._queue.length === 0) {
+        if (this._isFlushing || this._isDisabled || 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)));
+            while (this._queue.length > 0 && !this._isDisabled) {
+                // Drain a batch OUT of the queue (so concurrent log()s can't alias it).
+                const batch = this._queue.splice(0, this._batchSize);
+                const outcome = await this._deliverWithRetry(batch);
+                if (outcome === "delivered") {
+                    this._log(`Flushed ${batch.length} events successfully`);
+                    continue;
+                }
+                if (outcome === "dropped") {
+                    continue; // non-retryable rejection; batch discarded
+                }
+                if (outcome === "disabled") {
+                    this._queue = []; // 401 kill-switch
+                    break;
+                }
+                // retry-later: put the batch back at the front (bounded) and stop.
+                this._requeueFront(batch);
+                this._log(`Flush failed, ${batch.length} events re-queued`);
+                break;
+            }
         }
         finally {
             this._isFlushing = false;
         }
     }
+    /**
+     * Delivers one batch with bounded exponential-backoff retry.
+     * onError fires exactly once per batch that ends in a retry-later.
+     */
+    async _deliverWithRetry(batch) {
+        let lastError;
+        for (let attempt = 0; attempt <= this._maxRetries; attempt++) {
+            if (attempt > 0) {
+                // Stop retrying inline once we're shutting down; the batch is
+                // re-queued and best-effort flushed by the caller.
+                if (this._isDestroyed)
+                    break;
+                await this._sleep(this._retryBackoffMs * 2 ** (attempt - 1));
+            }
+            let status;
+            try {
+                status = await this._sendEvents(batch);
+            }
+            catch (error) {
+                // Network error / abort (timeout) — transient, retry.
+                lastError = error instanceof Error ? error : new Error(String(error));
+                continue;
+            }
+            if (status >= 200 && status < 300)
+                return "delivered";
+            if (status === 401) {
+                this._disable();
+                return "disabled";
+            }
+            if (status === 429 || status >= 500) {
+                lastError = new Error(`HTTP ${status}`);
+                continue; // transient, retry
+            }
+            // Other 4xx — permanent rejection, drop the batch.
+            this._onError?.(new Error(`HTTP ${status}: batch rejected, dropping ${batch.length} events`));
+            return "dropped";
+        }
+        if (lastError)
+            this._onError?.(lastError);
+        return "retry-later";
+    }
+    /** Re-queues a failed batch at the front, dropping oldest on overflow. */
+    _requeueFront(batch) {
+        this._queue.unshift(...batch);
+        while (this._queue.length > this._maxQueueSize) {
+            this._queue.shift();
+            this._droppedCount++;
+        }
+    }
+    _disable() {
+        if (this._isDisabled)
+            return;
+        this._isDisabled = true;
+        this._queue = [];
+        console.warn("[Traffical] API key rejected (HTTP 401); event delivery disabled for this client");
+    }
+    _sleep(ms) {
+        return new Promise((resolve) => {
+            const t = setTimeout(resolve, ms);
+            if (typeof t.unref === "function") {
+                t.unref();
+            }
+        });
+    }
     /**
      * Get the number of events in the queue.
      */
     get queueSize() {
         return this._queue.length;
     }
+    /** Number of events dropped because the bounded queue overflowed. */
+    get droppedCount() {
+        return this._droppedCount;
+    }
+    /** True once an HTTP 401 permanently disabled delivery. */
+    get isDisabled() {
+        return this._isDisabled;
+    }
     /**
      * Check if the batcher is destroyed.
      */
@@ -128,17 +244,34 @@ export class EventBatcher {
             });
         }
     }
+    /**
+     * Sends one batch and returns the HTTP status code. Throws only on a
+     * transport-level failure (network error / abort), which the caller treats
+     * as a transient, retryable error. HTTP status classification (2xx / 401 /
+     * 4xx / 5xx) is done by the caller.
+     */
     async _sendEvents(events) {
-        const response = await fetch(this._endpoint, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: `Bearer ${this._apiKey}`,
-            },
-            body: JSON.stringify({ events }),
-        });
+        // Abort the request if the edge hangs so the flush settles and events
+        // go down the re-queue-for-retry path (same as any network failure).
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this._requestTimeoutMs);
+        let response;
+        try {
+            response = await fetch(this._endpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this._apiKey}`,
+                },
+                body: JSON.stringify({ events }),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
         if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            return response.status;
         }
         if (this._onSchemaWarnings) {
             try {
@@ -151,6 +284,7 @@ export class EventBatcher {
                 // Response parsing is best-effort for dev-mode warnings
             }
         }
+        return response.status;
     }
     _startFlushTimer() {
         if (this._flushIntervalMs <= 0) {

package/dist/event-batcher.js.map

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

package/dist/event-batcher.test.js

@@ -119,4 +119,70 @@ describe("EventBatcher schema warnings", () => {
         await batcher.destroy();
     });
 });
+describe("EventBatcher request timeout", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    /** A fetch stub that never resolves, but rejects with AbortError when its signal aborts. */
+    function installHangingFetch() {
+        globalThis.fetch = mock((_url, init) => new Promise((_resolve, reject) => {
+            init?.signal?.addEventListener("abort", () => {
+                reject(new DOMException("The operation was aborted.", "AbortError"));
+            });
+        }));
+    }
+    test("aborts a hung event POST after requestTimeoutMs and re-queues events for retry", async () => {
+        installHangingFetch();
+        const errors = [];
+        const batcher = new EventBatcher({
+            endpoint: "https://test.example.com/v1/events/batch",
+            apiKey: "pk_test",
+            batchSize: 100,
+            flushIntervalMs: 999999,
+            requestTimeoutMs: 20,
+            onError: (error) => {
+                errors.push(error);
+            },
+        });
+        batcher.log(createTrackEvent());
+        // Without the abort timeout this would never settle.
+        await batcher.flush();
+        // Same behavior as a failed send: error surfaced, events re-queued for retry.
+        expect(errors).toHaveLength(1);
+        expect(errors[0].name === "AbortError" || errors[0].message.toLowerCase().includes("abort")).toBe(true);
+        expect(batcher.queueSize).toBe(1);
+        batcher.destroySync();
+    });
+    test("fast response is unaffected and the abort timer is cleaned up", async () => {
+        let capturedSignal;
+        globalThis.fetch = mock((_url, init) => {
+            capturedSignal = init?.signal;
+            return Promise.resolve(new Response(JSON.stringify({ accepted: 1 }), { status: 200 }));
+        });
+        const errors = [];
+        const batcher = new EventBatcher({
+            endpoint: "https://test.example.com/v1/events/batch",
+            apiKey: "pk_test",
+            batchSize: 100,
+            flushIntervalMs: 999999,
+            requestTimeoutMs: 20,
+            onError: (error) => {
+                errors.push(error);
+            },
+        });
+        batcher.log(createTrackEvent());
+        await batcher.flush();
+        // Wait past the timeout: if the timer had leaked, the signal would abort.
+        await new Promise((r) => setTimeout(r, 60));
+        expect(capturedSignal).toBeDefined();
+        expect(capturedSignal?.aborted).toBe(false);
+        expect(errors).toHaveLength(0);
+        expect(batcher.queueSize).toBe(0);
+        await batcher.destroy();
+    });
+});
 //# sourceMappingURL=event-batcher.test.js.map