@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/telemetry/client.test.js

@@ -0,0 +1,507 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { TelemetryClient } from "./client.js";
+import { resolveTelemetryConfig } from "./config.js";
+const TEST_STATE = {
+    installId: "test-install",
+    salt: "test-salt",
+    createdAt: "2026-01-01T00:00:00Z",
+    firstSeenVersion: "0.0.0",
+};
+function makeClient(stateFactory = vi.fn(() => TEST_STATE), config, 
+// Seeded RNG for deterministic backoff jitter. 0.5 => zero jitter (the
+// symmetric midpoint), so retry delays equal the un-jittered exponential base.
+random = () => 0.5) {
+    return {
+        client: new TelemetryClient({ enabled: true, endpoint: "http://localhost:9999/ingest", ...config }, stateFactory, "0.0.0-test", random),
+        stateFactory,
+    };
+}
+function sentBody() {
+    const requestInit = vi.mocked(fetch).mock.calls.at(-1)?.[1];
+    return JSON.parse(String(requestInit?.body ?? "{}"));
+}
+// Parsed request bodies for every POST the client made this test, in call order.
+function sentBodies() {
+    return vi.mocked(fetch).mock.calls.map((call) => {
+        const requestInit = call[1];
+        return JSON.parse(String(requestInit?.body ?? "{}"));
+    });
+}
+describe("TelemetryClient runtime event gate", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("swallows proposed first-party events before they touch state or the queue", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client, stateFactory } = makeClient();
+        client.track(
+        // @ts-expect-error -- proposed-telemetry(PAP-2411): fixture proposal not in generated schema
+        "skill_studio.skill_created", { sharing_scope: "team" });
+        await client.flush();
+        expect(stateFactory).not.toHaveBeenCalled();
+        expect(fetch).not.toHaveBeenCalled();
+    });
+    it("uses own-property membership so prototype event names are swallowed", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client, stateFactory } = makeClient();
+        // @ts-expect-error constructor is grammar-valid but not a registered Paperclip event.
+        client.track("constructor", {});
+        // @ts-expect-error toString is grammar-valid but not a registered Paperclip event.
+        client.track("toString", {});
+        await client.flush();
+        expect(stateFactory).not.toHaveBeenCalled();
+        expect(fetch).not.toHaveBeenCalled();
+    });
+    it("keeps registered event batches unchanged", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client, stateFactory } = makeClient();
+        client.track("install.started", {});
+        await client.flush();
+        expect(stateFactory).toHaveBeenCalledTimes(1);
+        expect(fetch).toHaveBeenCalledTimes(1);
+        expect(sentBody()).toMatchObject({
+            app: "paperclip",
+            schemaVersion: "1",
+            installId: "test-install",
+            version: "0.0.0-test",
+            events: [
+                {
+                    name: "install.started",
+                    dimensions: {},
+                },
+            ],
+        });
+        expect(sentBody().events[0]?.occurredAt).toEqual(expect.any(String));
+    });
+    it("does not change trackDynamic plugin emission", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client } = makeClient();
+        client.trackDynamic("plugin.linear.sync_completed", { status: "ok" });
+        await client.flush();
+        expect(fetch).toHaveBeenCalledTimes(1);
+        expect(sentBody().events).toEqual([
+            expect.objectContaining({
+                name: "plugin.linear.sync_completed",
+                dimensions: { status: "ok" },
+            }),
+        ]);
+    });
+});
+// Config surface for soft caps + backoff. Fields are optional and additive;
+// `resolveTelemetryConfig` fills documented defaults centrally so no existing
+// caller changes behavior.
+describe("resolveTelemetryConfig caps + backoff surface", () => {
+    it("resolveTelemetryConfig returns default caps and backoff", () => {
+        const config = resolveTelemetryConfig();
+        expect(config.maxEventsPerBatch).toBe(50);
+        expect(config.maxBodyBytes).toBe(524288);
+        expect(config.maxPendingRetryBatches).toBe(20);
+        expect(config.backoff).toEqual({
+            baseDelayMs: 1_000,
+            maxDelayMs: 30_000,
+            maxAttempts: 5,
+            jitterRatio: 0.25,
+        });
+    });
+    it("honors caps/backoff overrides", () => {
+        const config = resolveTelemetryConfig({
+            maxEventsPerBatch: 10,
+            maxBodyBytes: 1024,
+            maxPendingRetryBatches: 3,
+            backoff: {
+                baseDelayMs: 500,
+                maxDelayMs: 5_000,
+                maxAttempts: 2,
+                jitterRatio: 0.1,
+            },
+        });
+        expect(config.maxEventsPerBatch).toBe(10);
+        expect(config.maxBodyBytes).toBe(1024);
+        expect(config.maxPendingRetryBatches).toBe(3);
+        expect(config.backoff).toEqual({
+            baseDelayMs: 500,
+            maxDelayMs: 5_000,
+            maxAttempts: 2,
+            jitterRatio: 0.1,
+        });
+    });
+});
+// flush() must never emit an oversized batch. The drained
+// queue is sub-divided into envelopes of <= config.maxEventsPerBatch events AND
+// <= config.maxBodyBytes serialized bytes, one POST per chunk. Caps are injected
+// (small) so assertions are RELATIVE invariants, never server literals.
+describe("TelemetryClient chunking (count + bytes)", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("splits more than maxEventsPerBatch events into multiple compliant POSTs", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        const cap = 2;
+        const { client } = makeClient(undefined, { maxEventsPerBatch: cap });
+        for (let i = 0; i < 5; i++)
+            client.track("install.started", {});
+        await client.flush();
+        // 5 events / cap 2 => 3 POSTs (2 + 2 + 1)
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+        const bodies = sentBodies();
+        expect(bodies.map((b) => b.events.length)).toEqual([2, 2, 1]);
+        for (const body of bodies) {
+            expect(body.events.length).toBeLessThanOrEqual(cap);
+        }
+    });
+    it("splits a chunk whose serialized bytes exceed maxBodyBytes", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        // Big enough to hold a single fat event but force >1 event to split.
+        const maxBodyBytes = 900;
+        const { client } = makeClient(undefined, { maxEventsPerBatch: 100, maxBodyBytes });
+        const blob = "x".repeat(300);
+        for (let i = 0; i < 6; i++)
+            client.trackDynamic("plugin.telemetry.blob", { blob });
+        await client.flush();
+        expect(fetchMock.mock.calls.length).toBeGreaterThan(1);
+        for (const call of fetchMock.mock.calls) {
+            const body = String(call[1].body);
+            expect(Buffer.byteLength(body)).toBeLessThanOrEqual(maxBodyBytes);
+        }
+    });
+    it("drops a single event larger than maxBodyBytes and logs, sending nothing", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const { client } = makeClient(undefined, { maxBodyBytes: 200 });
+        client.trackDynamic("plugin.telemetry.blob", { blob: "x".repeat(5000) });
+        await client.flush();
+        expect(fetchMock).not.toHaveBeenCalled();
+        expect(warn).toHaveBeenCalled();
+    });
+});
+// Every emitted chunk carries a deterministic, salt-free content-hash `batchId`
+// so server-side retries de-dupe (202) instead of double-counting. Two
+// invariants hold: the hash input includes `installId` (so two installs sending
+// identical events get distinct ids), and the id is >= 32 hex chars (128-bit
+// collision floor).
+describe("TelemetryClient deterministic batchId", () => {
+    // `deriveBatchId` intentionally hashes the full event objects, INCLUDING each
+    // event's `occurredAt` wall-clock stamp, so the id stays a faithful content
+    // hash: two genuinely distinct sends get distinct ids and the server ledger
+    // (keyed on `batchId`) counts both. Dropping `occurredAt` from the hash would
+    // collapse same-shape sends at different times onto one id and make the server
+    // silently drop the later batch as a replay — a silent-loss failure mode.
+    // These cross-instance determinism checks therefore freeze the clock so
+    // both clients stamp an identical `occurredAt`, isolating the hash's structural
+    // determinism from wall-clock skew.
+    beforeEach(() => {
+        vi.useFakeTimers({ now: new Date("2026-01-01T00:00:00.000Z") });
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("emits a batchId on every envelope", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client } = makeClient();
+        client.track("install.started", {});
+        await client.flush();
+        expect(typeof sentBody().batchId).toBe("string");
+    });
+    it("derives a stable batchId for identical events (idempotent retry key)", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const first = makeClient();
+        first.client.trackDynamic("plugin.telemetry.evt", { a: 1, b: "two" });
+        await first.client.flush();
+        const idA = sentBody().batchId;
+        vi.mocked(fetch).mockClear();
+        const second = makeClient();
+        second.client.trackDynamic("plugin.telemetry.evt", { a: 1, b: "two" });
+        await second.client.flush();
+        const idB = sentBody().batchId;
+        // Same installId + same event content => identical id.
+        expect(idA).toBe(idB);
+    });
+    it("derives a different batchId for different events", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const first = makeClient();
+        first.client.trackDynamic("plugin.telemetry.evt", { a: 1 });
+        await first.client.flush();
+        const idA = sentBody().batchId;
+        vi.mocked(fetch).mockClear();
+        const second = makeClient();
+        second.client.trackDynamic("plugin.telemetry.evt", { a: 2 });
+        await second.client.flush();
+        const idB = sentBody().batchId;
+        expect(idA).not.toBe(idB);
+    });
+    it("derives a different batchId for the same events under a different installId", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const stateA = vi.fn(() => ({ ...TEST_STATE, installId: "install-a" }));
+        const first = makeClient(stateA);
+        first.client.trackDynamic("plugin.telemetry.evt", { a: 1 });
+        await first.client.flush();
+        const idA = sentBody().batchId;
+        vi.mocked(fetch).mockClear();
+        const stateB = vi.fn(() => ({ ...TEST_STATE, installId: "install-b" }));
+        const second = makeClient(stateB);
+        second.client.trackDynamic("plugin.telemetry.evt", { a: 1 });
+        await second.client.flush();
+        const idB = sentBody().batchId;
+        expect(idA).not.toBe(idB);
+    });
+    it("emits a batchId of at least 32 hex chars (128-bit collision floor)", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client } = makeClient();
+        client.track("install.started", {});
+        await client.flush();
+        const id = sentBody().batchId;
+        expect(id.length).toBeGreaterThanOrEqual(32);
+        expect(id).toMatch(/^[0-9a-f]+$/);
+    });
+    it("does not crash flush on a circular dimension; drops-and-logs it and still sends valid events", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const { client } = makeClient();
+        // A plugin passing a circular `dimensions` object. `enqueue` shallow-copies
+        // the top level, so the cycle survives one level down and would drive both
+        // `stableStringify` (deriveBatchId) and `JSON.stringify` (serializedBytes /
+        // wire body) into an unhandled throw without the guards.
+        const circular = { a: 1 };
+        circular.self = circular;
+        // Cast models an untyped third-party plugin passing a malformed object at
+        // runtime — TypeScript would reject the cycle, but the wire path cannot.
+        client.trackDynamic("plugin.telemetry.circular", circular);
+        // A well-formed event queued alongside it must still be delivered.
+        client.trackDynamic("plugin.telemetry.ok", { a: 1 });
+        // flush() resolves instead of rejecting with a RangeError/TypeError.
+        await expect(client.flush()).resolves.toBeUndefined();
+        // The circular event was dropped-and-logged (fail loudly), not sent.
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("non-serializable dimension (circular reference?)"));
+        // The valid event still went out on the wire with a well-formed batchId.
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const body = sentBody();
+        expect(body.events).toHaveLength(1);
+        expect(body.events[0]?.name).toBe("plugin.telemetry.ok");
+        const id = body.batchId;
+        expect(id.length).toBeGreaterThanOrEqual(32);
+        expect(id).toMatch(/^[0-9a-f]+$/);
+    });
+});
+// Batch-grouped retry with capped, jittered exponential
+// backoff. Retryable statuses (429/502/503/504 + network) re-send the EXACT
+// same events + batchId (no re-mix — preserves server idempotency); terminal
+// statuses (400/405/409/413) never retry. Backoff uses the injected seeded RNG
+// and retries are driven off fake timers so tests are deterministic.
+describe("TelemetryClient batched retry + backoff", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("retries a 429 with the same batchId and eventually succeeds", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce({ ok: false, status: 429 })
+            .mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        const { client } = makeClient(undefined, {
+            backoff: { baseDelayMs: 1_000, maxDelayMs: 30_000, maxAttempts: 5, jitterRatio: 0.25 },
+        });
+        client.track("install.started", {});
+        await client.flush();
+        expect(fetchMock).toHaveBeenCalledTimes(1); // attempt 1 -> 429, queued for retry
+        // Un-jittered delay for attempt 1 == baseDelayMs.
+        await vi.advanceTimersByTimeAsync(1_000);
+        expect(fetchMock).toHaveBeenCalledTimes(2); // attempt 2 -> 200
+        const bodies = sentBodies();
+        expect(bodies[0]?.batchId).toBe(bodies[1]?.batchId); // identical id on retry
+        client.stop();
+    });
+    it("does not retry a terminal 400", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: false, status: 400 });
+        vi.stubGlobal("fetch", fetchMock);
+        const { client } = makeClient();
+        client.track("install.started", {});
+        await client.flush();
+        await vi.advanceTimersByTimeAsync(120_000);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        client.stop();
+    });
+    it("does not retry a terminal 413", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: false, status: 413 });
+        vi.stubGlobal("fetch", fetchMock);
+        const { client } = makeClient();
+        client.track("install.started", {});
+        await client.flush();
+        await vi.advanceTimersByTimeAsync(120_000);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        client.stop();
+    });
+    it("stops after maxAttempts on a persistent 429 and drops-and-logs", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: false, status: 429 });
+        vi.stubGlobal("fetch", fetchMock);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const maxAttempts = 3;
+        const { client } = makeClient(undefined, {
+            backoff: { baseDelayMs: 1_000, maxDelayMs: 30_000, maxAttempts, jitterRatio: 0.25 },
+        });
+        client.track("install.started", {});
+        await client.flush();
+        // Drive all remaining scheduled retries.
+        await vi.advanceTimersByTimeAsync(600_000);
+        expect(fetchMock).toHaveBeenCalledTimes(maxAttempts);
+        expect(warn).toHaveBeenCalled();
+        client.stop();
+    });
+    // Issue 1 (PR #9946): a transient upstream 5xx on the primary endpoint must
+    // fall through to the healthy secondary endpoint instead of returning early.
+    it("falls through to the secondary endpoint on a transient 5xx", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce({ ok: false, status: 503 }) // primary endpoint: transient
+            .mockResolvedValueOnce({ ok: true }); // secondary endpoint: healthy
+        vi.stubGlobal("fetch", fetchMock);
+        // Empty endpoint => the two built-in DEFAULT_ENDPOINTS are used.
+        const { client } = makeClient(undefined, { endpoint: "" });
+        client.track("install.started", {});
+        await client.flush();
+        // Both endpoints tried within a single attempt; delivered on the secondary,
+        // so no retry is queued.
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        await vi.advanceTimersByTimeAsync(120_000);
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        client.stop();
+    });
+    // Issue 1 (PR #9946): when every endpoint returns a transient 5xx the status
+    // is still surfaced as retryable (not swallowed).
+    it("surfaces the transient status for retry when all endpoints 5xx", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce({ ok: false, status: 502 }) // primary
+            .mockResolvedValueOnce({ ok: false, status: 502 }) // secondary
+            .mockResolvedValue({ ok: true }); // retry succeeds
+        vi.stubGlobal("fetch", fetchMock);
+        const { client } = makeClient(undefined, {
+            endpoint: "",
+            backoff: { baseDelayMs: 1_000, maxDelayMs: 30_000, maxAttempts: 5, jitterRatio: 0.25 },
+        });
+        client.track("install.started", {});
+        await client.flush();
+        expect(fetchMock).toHaveBeenCalledTimes(2); // both endpoints 502 -> queued for retry
+        await vi.advanceTimersByTimeAsync(1_000); // attempt 2 -> ok on primary
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+        client.stop();
+    });
+    // Issue 3 (PR #9946): an out-of-range `Retry-After` hint is clamped to
+    // maxDelayMs rather than overflowing the timer range into a near-immediate
+    // (Node-clamped ~1ms) retry.
+    it("caps a large Retry-After hint at maxDelayMs", async () => {
+        const retryAfterResponse = {
+            ok: false,
+            status: 429,
+            headers: { get: (name) => (name === "retry-after" ? "999999999" : null) },
+        };
+        const fetchMock = vi.fn().mockResolvedValueOnce(retryAfterResponse).mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        const { client } = makeClient(undefined, {
+            backoff: { baseDelayMs: 1_000, maxDelayMs: 30_000, maxAttempts: 5, jitterRatio: 0.25 },
+        });
+        client.track("install.started", {});
+        await client.flush();
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        // Well before the cap: without clamping the huge hint overflows the timer
+        // range and Node fires it near-immediately, so this would already be 2.
+        await vi.advanceTimersByTimeAsync(5_000);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        // At the cap the retry fires.
+        await vi.advanceTimersByTimeAsync(25_000);
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        client.stop();
+    });
+});
+// The pending-retry store is bounded at
+// config.maxPendingRetryBatches. On overflow the OLDEST batch is evicted
+// (newest prioritized) and each eviction is logged (no silent loss). In-memory
+// only. Caps are injected; assertions are relative.
+describe("TelemetryClient bounded pending-retry store", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it("evicts the oldest batch and retries only the newest within the bound", async () => {
+        // First 3 POSTs (one per single-event chunk) fail 429; retries then succeed.
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce({ ok: false, status: 429 })
+            .mockResolvedValueOnce({ ok: false, status: 429 })
+            .mockResolvedValueOnce({ ok: false, status: 429 })
+            .mockResolvedValue({ ok: true });
+        vi.stubGlobal("fetch", fetchMock);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const { client } = makeClient(undefined, { maxEventsPerBatch: 1, maxPendingRetryBatches: 2 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 1 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 2 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 3 });
+        await client.flush();
+        // 3 initial attempts (one per chunk), each 429 -> enqueued; the 3rd enqueue
+        // overflows the bound (2) and evicts the oldest.
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+        const initial = sentBodies();
+        const [oldestId, midId, newestId] = initial.map((b) => b.batchId);
+        expect(warn).toHaveBeenCalled(); // eviction logged
+        await vi.advanceTimersByTimeAsync(120_000);
+        // Only the 2 newest were retained and retried; the oldest was dropped.
+        const retriedIds = sentBodies()
+            .slice(3)
+            .map((b) => b.batchId);
+        expect(retriedIds.sort()).toEqual([midId, newestId].sort());
+        expect(retriedIds).not.toContain(oldestId);
+        client.stop();
+    });
+    // Issue 2 (PR #9946): a batch that is immediately evicted by the bound must
+    // NOT leave a retry timer behind. With maxPendingRetryBatches: 0 every failed
+    // batch is discarded on enqueue, so no timer should ever fire.
+    it("schedules no retry timer for a batch evicted on enqueue (bound 0)", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: false, status: 429 });
+        vi.stubGlobal("fetch", fetchMock);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const { client } = makeClient(undefined, { maxEventsPerBatch: 1, maxPendingRetryBatches: 0 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 1 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 2 });
+        await client.flush();
+        // 2 initial attempts (one per chunk); each 429 is enqueued then immediately
+        // evicted by the 0 bound, so nothing is retried.
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        expect(warn).toHaveBeenCalled(); // eviction logged
+        await vi.advanceTimersByTimeAsync(120_000);
+        expect(fetchMock).toHaveBeenCalledTimes(2); // no timer fired
+        client.stop();
+    });
+    // A batch evicted to keep `pending` within the bound must also have its
+    // already-scheduled retry timer cancelled — otherwise each overflow strands a
+    // live timer for a batch that no longer exists, and the timer set grows
+    // unbounded even though `pending` stays bounded.
+    it("cancels the retry timer of a batch evicted from the bounded store", async () => {
+        const fetchMock = vi.fn().mockResolvedValue({ ok: false, status: 429 });
+        vi.stubGlobal("fetch", fetchMock);
+        vi.spyOn(console, "warn").mockImplementation(() => { });
+        const { client } = makeClient(undefined, { maxEventsPerBatch: 1, maxPendingRetryBatches: 1 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 1 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 2 });
+        client.trackDynamic("plugin.telemetry.evt", { n: 3 });
+        await client.flush();
+        // 3 chunks each 429 -> enqueued; every enqueue past the first overflows the
+        // bound (1) and evicts the previous batch. Only the newest batch survives, so
+        // exactly one retry timer should remain live (the two evicted timers were
+        // cancelled), not one per failed chunk.
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+        expect(vi.getTimerCount()).toBe(1);
+        client.stop();
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/telemetry/client.test.js.map

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

package/dist/telemetry/config.d.ts

@@ -0,0 +1,35 @@
+import type { TelemetryBackoffConfig, TelemetryConfig } from "./types.js";
+/**
+ * Single source of truth for telemetry soft caps + backoff. Kept as config
+ * *defaults* (not hardcoded flush logic) so later work reads config, not
+ * literals. Exported so the `client.ts` consumer resolves the same values.
+ */
+export declare const TELEMETRY_DEFAULTS: {
+    readonly maxEventsPerBatch: number;
+    readonly maxBodyBytes: number;
+    readonly maxPendingRetryBatches: number;
+    readonly backoff: Readonly<TelemetryBackoffConfig>;
+};
+/** Caller-supplied overrides for the additive caps + backoff surface. */
+export type TelemetryConfigOverrides = Partial<Pick<TelemetryConfig, "enabled" | "maxEventsPerBatch" | "maxBodyBytes" | "maxPendingRetryBatches" | "backoff">>;
+/**
+ * Fully-resolved caps + backoff — every field is present (defaults applied), so
+ * `client.ts` can consume them without re-defaulting. `TelemetryConfig`'s own
+ * cap fields stay optional (additive wire surface); this is the resolved view.
+ */
+export interface ResolvedTelemetryCaps {
+    maxEventsPerBatch: number;
+    maxBodyBytes: number;
+    maxPendingRetryBatches: number;
+    backoff: TelemetryBackoffConfig;
+}
+/**
+ * Resolves soft caps + backoff, applying `TELEMETRY_DEFAULTS` for any field the
+ * caller did not override. One source of truth for both the config surface and
+ * the `client.ts` consumer.
+ */
+export declare function resolveCaps(overrides?: TelemetryConfigOverrides): ResolvedTelemetryCaps;
+export declare function resolveTelemetryConfig(fileConfig?: {
+    enabled?: boolean;
+} & TelemetryConfigOverrides): TelemetryConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/telemetry/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI1E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;CAWnD,CAAC;AAEH,yEAAyE;AACzE,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,IAAI,CACF,eAAe,EACf,SAAS,GAAG,mBAAmB,GAAG,cAAc,GAAG,wBAAwB,GAAG,SAAS,CACxF,CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,wBAAwB,GAAG,qBAAqB,CAQvF;AAMD,wBAAgB,sBAAsB,CACpC,UAAU,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,wBAAwB,GAC5D,eAAe,CAkBjB"}

package/dist/telemetry/config.js

@@ -0,0 +1,51 @@
+const CI_ENV_VARS = ["CI", "CONTINUOUS_INTEGRATION", "BUILD_NUMBER", "GITHUB_ACTIONS", "GITLAB_CI"];
+/**
+ * Single source of truth for telemetry soft caps + backoff. Kept as config
+ * *defaults* (not hardcoded flush logic) so later work reads config, not
+ * literals. Exported so the `client.ts` consumer resolves the same values.
+ */
+export const TELEMETRY_DEFAULTS = Object.freeze({
+    maxEventsPerBatch: 50,
+    maxBodyBytes: 512 * 1024, // 524288
+    maxPendingRetryBatches: 20,
+    backoff: Object.freeze({
+        baseDelayMs: 1_000,
+        maxDelayMs: 30_000,
+        maxAttempts: 5,
+        jitterRatio: 0.25,
+    }),
+});
+/**
+ * Resolves soft caps + backoff, applying `TELEMETRY_DEFAULTS` for any field the
+ * caller did not override. One source of truth for both the config surface and
+ * the `client.ts` consumer.
+ */
+export function resolveCaps(overrides) {
+    return {
+        maxEventsPerBatch: overrides?.maxEventsPerBatch ?? TELEMETRY_DEFAULTS.maxEventsPerBatch,
+        maxBodyBytes: overrides?.maxBodyBytes ?? TELEMETRY_DEFAULTS.maxBodyBytes,
+        maxPendingRetryBatches: overrides?.maxPendingRetryBatches ?? TELEMETRY_DEFAULTS.maxPendingRetryBatches,
+        backoff: { ...TELEMETRY_DEFAULTS.backoff, ...overrides?.backoff },
+    };
+}
+function isCI() {
+    return CI_ENV_VARS.some((key) => process.env[key] === "true" || process.env[key] === "1");
+}
+export function resolveTelemetryConfig(fileConfig) {
+    const caps = resolveCaps(fileConfig);
+    if (process.env.PAPERCLIP_TELEMETRY_DISABLED === "1") {
+        return { enabled: false, ...caps };
+    }
+    if (process.env.DO_NOT_TRACK === "1") {
+        return { enabled: false, ...caps };
+    }
+    if (isCI()) {
+        return { enabled: false, ...caps };
+    }
+    if (fileConfig?.enabled === false) {
+        return { enabled: false, ...caps };
+    }
+    const endpoint = process.env.PAPERCLIP_TELEMETRY_ENDPOINT || undefined;
+    return { enabled: true, endpoint, ...caps };
+}
+//# sourceMappingURL=config.js.map

package/dist/telemetry/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/telemetry/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,wBAAwB,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAK3B,MAAM,CAAC,MAAM,CAAC;IAChB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,GAAG,GAAG,IAAI,EAAE,SAAS;IACnC,sBAAsB,EAAE,EAAE;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,IAAI;KAClB,CAAC;CACH,CAAC,CAAC;AAsBH;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoC;IAC9D,OAAO;QACL,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,IAAI,kBAAkB,CAAC,iBAAiB;QACvF,YAAY,EAAE,SAAS,EAAE,YAAY,IAAI,kBAAkB,CAAC,YAAY;QACxE,sBAAsB,EACpB,SAAS,EAAE,sBAAsB,IAAI,kBAAkB,CAAC,sBAAsB;QAChF,OAAO,EAAE,EAAE,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,IAAI;IACX,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA6D;IAE7D,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAErC,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,GAAG,EAAE,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,EAAE,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,UAAU,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,SAAS,CAAC;IACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;AAC9C,CAAC"}