@abloatai/transaction 0.37.0

package/dist/source/migrations.js

@@ -0,0 +1,104 @@
+/**
+ * The canonical table-creation SQL every ORM adapter ships for its own infrastructure
+ * tables: `ablo_idempotency`, whose legacy-named `client_tx_id` column stores the
+ * scoped server correlation, and (for endpoint wrappers only) `ablo_outbox`, the
+ * transactional outbox the `events()` feed reads. Direct wrappers install only
+ * the ledger migration because WAL is their authoritative feed.
+ *
+ * These are infrastructure tables, not model tables, and they exist only on your
+ * own database when you run a Data Source. Ablo's hosted storage does not use them;
+ * it records changes in its own `sync_deltas` log instead.
+ */
+/**
+ * Add a column to `ablo_idempotency` only when it is genuinely missing.
+ *
+ * `ADD COLUMN IF NOT EXISTS` performs its ownership check before the existence
+ * short-circuit, so on a ledger owned by another role the no-op re-run still
+ * errors "must be owner of table ablo_idempotency" — the setup's re-run promise
+ * breaks. `pg_attribute` is readable regardless of table ownership, so this DO
+ * block resolves the ledger through the search path and runs the `ALTER` only
+ * when the column is absent — a true no-op on a table that already has it.
+ */
+function addColumnIfAbsent(column, definition) {
+    return `DO $$
+DECLARE ledger regclass := to_regclass('ablo_idempotency');
+BEGIN
+  IF ledger IS NOT NULL AND NOT EXISTS (
+    SELECT 1 FROM pg_attribute
+    WHERE attrelid = ledger AND attname = '${column}' AND attnum > 0 AND NOT attisdropped
+  ) THEN
+    ALTER TABLE ablo_idempotency ADD COLUMN ${column} ${definition};
+  END IF;
+END $$;`;
+}
+/** The idempotency ledger shared by direct and endpoint mutation wrappers. New
+ *  rows carry a bounded `expires_at` (set by the adapter at write time) so the
+ *  customer can prune them; the `infinity` column default is only a fallback for
+ *  a row inserted without one. */
+export function idempotencyLedgerMigrations() {
+    return [
+        {
+            name: 'ablo_idempotency',
+            up: `CREATE TABLE IF NOT EXISTS ablo_idempotency (
+  client_tx_id TEXT PRIMARY KEY,
+  response     JSONB NOT NULL,
+  request_hash TEXT,
+  expires_at   TIMESTAMPTZ NOT NULL DEFAULT 'infinity',
+  created_at   TIMESTAMPTZ NOT NULL DEFAULT now()
+);`,
+        },
+        {
+            name: 'ablo_idempotency_request_hash',
+            // Nullable only for rows created by older adapter versions. New writes
+            // always populate it; replaying a legacy NULL row fails closed because
+            // the adapter cannot prove that the intent matches.
+            //
+            // The column already exists on any current table (the CREATE above
+            // includes it), so this only matters when upgrading a pre-existing
+            // ledger. `ALTER TABLE ... ADD COLUMN IF NOT EXISTS` checks ownership
+            // BEFORE it evaluates IF NOT EXISTS, so on a ledger that predates the
+            // setup — owned by another role — the no-op still errors "must be owner".
+            // Guard on the catalog (readable regardless of ownership) so the ALTER
+            // runs only when the column is genuinely absent, keeping re-runs safe.
+            up: addColumnIfAbsent('request_hash', 'TEXT'),
+        },
+        {
+            name: 'ablo_idempotency_permanent_retention',
+            up: addColumnIfAbsent('expires_at', `TIMESTAMPTZ NOT NULL DEFAULT 'infinity'`),
+        },
+    ];
+}
+/** Endpoint-only transactional outbox and its correlation columns. */
+export function endpointOutboxMigrations() {
+    return [
+        {
+            name: 'ablo_outbox',
+            up: `CREATE TABLE IF NOT EXISTS ablo_outbox (
+  cursor          BIGSERIAL PRIMARY KEY,
+  id              TEXT NOT NULL UNIQUE,
+  model           TEXT NOT NULL,
+  entity_id       TEXT NOT NULL,
+  type            TEXT NOT NULL,
+  data            JSONB,
+  organization_id TEXT,
+  client_tx_id    TEXT,
+  correlation_id  TEXT,
+  transaction_id  TEXT,
+  occurred_at     BIGINT,
+  created_at      TIMESTAMPTZ NOT NULL DEFAULT now()
+);`,
+        },
+        {
+            name: 'ablo_outbox_correlation',
+            up: `ALTER TABLE ablo_outbox
+  ADD COLUMN IF NOT EXISTS correlation_id TEXT;
+ALTER TABLE ablo_outbox
+  ADD COLUMN IF NOT EXISTS transaction_id TEXT;`,
+        },
+    ];
+}
+/** Full endpoint adapter migrations (ledger + outbox). */
+export function adapterTableMigrations() {
+    return [...idempotencyLedgerMigrations(), ...endpointOutboxMigrations()];
+}
+//# sourceMappingURL=migrations.js.map

package/dist/source/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/source/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,MAAc,EAAE,UAAkB;IAC3D,OAAO;;;;;6CAKoC,MAAM;;8CAEL,MAAM,IAAI,UAAU;;QAE1D,CAAC;AACT,CAAC;AAED;;;kCAGkC;AAClC,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL;YACE,IAAI,EAAE,kBAAkB;YACxB,EAAE,EAAE;;;;;;GAMP;SACE;QACD;YACE,IAAI,EAAE,+BAA+B;YACrC,uEAAuE;YACvE,uEAAuE;YACvE,oDAAoD;YACpD,EAAE;YACF,mEAAmE;YACnE,mEAAmE;YACnE,sEAAsE;YACtE,sEAAsE;YACtE,0EAA0E;YAC1E,uEAAuE;YACvE,uEAAuE;YACvE,EAAE,EAAE,iBAAiB,CAAC,cAAc,EAAE,MAAM,CAAC;SAC9C;QACD;YACE,IAAI,EAAE,sCAAsC;YAC5C,EAAE,EAAE,iBAAiB,CAAC,YAAY,EAAE,yCAAyC,CAAC;SAC/E;KACF,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL;YACE,IAAI,EAAE,aAAa;YACnB,EAAE,EAAE;;;;;;;;;;;;;GAaP;SACE;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,EAAE,EAAE;;;gDAGsC;SAC3C;KACF,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,sBAAsB;IACpC,OAAO,CAAC,GAAG,2BAA2B,EAAE,EAAE,GAAG,wBAAwB,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/source/next.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A thin Next.js App Router wrapper for a Data Source. The core `dataSource()`
+ * already returns a standard `(Request) => Promise<Response>`, which the App Router
+ * accepts directly, so this helper adds only convenience: it names the handler
+ * `POST` so your route file can export it in one line.
+ *
+ *   // app/api/ablo/source/route.ts
+ *   import { dataSourceNext } from '@abloatai/transaction/source/next';
+ *   import { prismaDataSource } from '@abloatai/transaction/source';
+ *   import { schema } from '@/ablo/schema';
+ *   import { prisma } from '@/lib/prisma';
+ *
+ *   export const { POST } = dataSourceNext({
+ *     schema,
+ *     apiKey: process.env.ABLO_API_KEY!,
+ *     adapter: prismaDataSource(prisma, schema),
+ *   });
+ *
+ * For hand-written handlers, or another framework, call the core `dataSource()`
+ * directly and export its result however that framework expects.
+ */
+import type { SchemaRecord } from '../schema/schema.js';
+import { type DataSourceOptions } from './factory.js';
+/**
+ * The options for `dataSourceNext`, which are exactly the core
+ * `DataSourceOptions`. Pass `{ schema, apiKey, adapter }`, the same shape
+ * `dataSource()` takes.
+ */
+export type DataSourceNextOptions<S extends SchemaRecord, TAuth = unknown> = DataSourceOptions<S, TAuth>;
+export declare function dataSourceNext<const S extends SchemaRecord, TAuth = unknown>(options: DataSourceNextOptions<S, TAuth>): {
+    readonly POST: (request: Request) => Promise<Response>;
+};
+//# sourceMappingURL=next.d.ts.map

package/dist/source/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/source/next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,GAAG,OAAO,IACvE,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAE9B,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,GAAG,OAAO,EAC1E,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,KAAK,CAAC,GACvC;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAE5D"}

package/dist/source/next.js

@@ -0,0 +1,26 @@
+/**
+ * A thin Next.js App Router wrapper for a Data Source. The core `dataSource()`
+ * already returns a standard `(Request) => Promise<Response>`, which the App Router
+ * accepts directly, so this helper adds only convenience: it names the handler
+ * `POST` so your route file can export it in one line.
+ *
+ *   // app/api/ablo/source/route.ts
+ *   import { dataSourceNext } from '@abloatai/transaction/source/next';
+ *   import { prismaDataSource } from '@abloatai/transaction/source';
+ *   import { schema } from '@/ablo/schema';
+ *   import { prisma } from '@/lib/prisma';
+ *
+ *   export const { POST } = dataSourceNext({
+ *     schema,
+ *     apiKey: process.env.ABLO_API_KEY!,
+ *     adapter: prismaDataSource(prisma, schema),
+ *   });
+ *
+ * For hand-written handlers, or another framework, call the core `dataSource()`
+ * directly and export its result however that framework expects.
+ */
+import { dataSource } from './factory.js';
+export function dataSourceNext(options) {
+    return { POST: dataSource(options) };
+}
+//# sourceMappingURL=next.js.map

package/dist/source/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/source/next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,UAAU,EAA0B,MAAM,cAAc,CAAC;AAUlE,MAAM,UAAU,cAAc,CAC5B,OAAwC;IAExC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;AACvC,CAAC"}

package/dist/source/pushQueue.d.ts

@@ -0,0 +1,135 @@
+/**
+ * The durable retry queue for delivering source events to the server.
+ *
+ * When your application changes a row, it can push the resulting event to
+ * the server, which acknowledges delivery synchronously. If your process
+ * crashes mid-call, the network drops, or the server returns a 5xx, that
+ * event would be lost without a safety net. This queue is the safety net:
+ * it persists each event first, then delivers it from a background worker
+ * with automatic retries. (Polling the change feed is the slower fallback
+ * for anything the queue never manages to deliver.)
+ *
+ * The queue follows a familiar enqueue-and-worker shape:
+ *
+ *   - `enqueue(events)` returns as soon as the events are persisted.
+ *   - A background worker delivers them and retries on failure, following
+ *     the Standard Webhooks schedule (0, 5s, 5m, 30m, 2h, 5h, 10h, 14h,
+ *     20h, 24h — roughly three days in total).
+ *   - Items that exhaust every retry move to a dead-letter queue you can
+ *     monitor.
+ *
+ * Persistence is pluggable through {@link PushQueueStorage}. Use
+ * {@link InMemoryPushQueueStorage} for a single process, or implement that
+ * interface against your own outbox table for production durability.
+ */
+import type { SourceEvent } from './types.js';
+/** One queued delivery: a batch of source events plus its retry bookkeeping. */
+export interface PushQueueItem {
+    readonly id: string;
+    readonly events: readonly SourceEvent[];
+    readonly attempts: number;
+    /** When the next attempt is due, in epoch milliseconds. The worker skips items due later. */
+    readonly nextAttemptAt: number;
+    /** The most recent error message, set once an attempt has failed. */
+    readonly lastError?: string;
+    /** `pending` while awaiting delivery, `delivered` on success, `dlq` once retries are exhausted. */
+    readonly status: 'pending' | 'delivered' | 'dlq';
+}
+/**
+ * The persistence behind a {@link PushQueue}. Implement it against your own
+ * durable table (or use {@link InMemoryPushQueueStorage}) so queued events
+ * survive a process restart. The queue calls these methods; you decide where
+ * the rows actually live.
+ */
+export interface PushQueueStorage {
+    /**
+     * Append a new item and return the persisted record. Generate a stable id
+     * — it doubles as the `webhook-id` on the delivered request — and set
+     * `nextAttemptAt` to the current time so the item is due immediately.
+     */
+    enqueue(events: readonly SourceEvent[]): Promise<PushQueueItem>;
+    /** Return pending items whose `nextAttemptAt` is at or before `now`, up to `limit`. */
+    due(now: number, limit: number): Promise<readonly PushQueueItem[]>;
+    /** Increase the attempt count and set the next attempt time after a failed delivery. */
+    reschedule(id: string, nextAttemptAt: number, lastError: string): Promise<void>;
+    /** Mark the item delivered so no further attempts are made. */
+    markDelivered(id: string): Promise<void>;
+    /** Move the item to the dead-letter queue after its retries are exhausted. */
+    markDlq(id: string, lastError: string): Promise<void>;
+    /** Read the dead-letter queue. Your monitoring reads this to surface deliveries that never succeeded. */
+    listDlq(): Promise<readonly PushQueueItem[]>;
+}
+/**
+ * The default retry schedule, taken from the Standard Webhooks
+ * specification. The index is the attempt number and the value is the delay
+ * in milliseconds after the previous attempt failed. Once an item runs off
+ * the end of this array, it moves to the dead-letter queue.
+ *
+ * See https://www.standardwebhooks.com/.
+ */
+export declare const STANDARD_WEBHOOKS_RETRY_SCHEDULE: readonly number[];
+/** Configuration for {@link createPushQueue}. */
+export interface PushQueueOptions {
+    /** The URL the worker delivers events to. */
+    readonly endpoint: string;
+    /** The API key used to sign each delivery. */
+    readonly apiKey: string;
+    /** Where queued items are persisted. */
+    readonly storage: PushQueueStorage;
+    /**
+     * Override the retry delays. Defaults to {@link STANDARD_WEBHOOKS_RETRY_SCHEDULE}.
+     * The number of attempts equals the array length, and the i-th entry is the
+     * delay after attempt `i` failed.
+     */
+    readonly retrySchedule?: readonly number[];
+    /** How often the worker checks for due items, in milliseconds. Defaults to 1000. */
+    readonly tickIntervalMs?: number;
+    /** The most items the worker delivers per tick. Defaults to 50. */
+    readonly batchSize?: number;
+    /** A custom fetch implementation, for tests or runtimes without a global `fetch`. */
+    readonly fetch?: typeof fetch;
+    /** A custom clock source, mainly for tests. Defaults to `Date.now`. */
+    readonly now?: () => number;
+    /** Random jitter applied to each retry delay, as a fraction. Defaults to ±10%; set 0 to disable. */
+    readonly jitter?: number;
+    /** Called when an item is dead-lettered or the worker loop hits an error. */
+    readonly onError?: (item: PushQueueItem, err: unknown) => void;
+}
+/** A running push queue: persist events, deliver them, and recover dead-lettered ones. */
+export interface PushQueue {
+    /** Persist a batch of events for delivery and return the queued item. */
+    enqueue(events: readonly SourceEvent[]): Promise<PushQueueItem>;
+    /** Run the delivery worker until `signal` aborts. */
+    run(signal: AbortSignal): Promise<void>;
+    /**
+     * Re-enqueue every dead-lettered item for another round of delivery. Call
+     * this yourself once you have fixed whatever caused the failures. Returns
+     * the number of items re-enqueued.
+     */
+    redriveDlq(): Promise<number>;
+}
+/** Create a {@link PushQueue} from the given {@link PushQueueOptions}. */
+export declare function createPushQueue(options: PushQueueOptions): PushQueue;
+/**
+ * A {@link PushQueueStorage} that keeps items in memory. It is not durable —
+ * items are lost when the process restarts — so it suits development and
+ * low-volume use. For production, implement {@link PushQueueStorage} against
+ * your own table.
+ */
+export declare class InMemoryPushQueueStorage implements PushQueueStorage {
+    private items;
+    private nextId;
+    private readonly now;
+    constructor(options?: {
+        now?: () => number;
+    });
+    enqueue(events: readonly SourceEvent[]): Promise<PushQueueItem>;
+    due(now: number, limit: number): Promise<readonly PushQueueItem[]>;
+    reschedule(id: string, nextAttemptAt: number, lastError: string): Promise<void>;
+    markDelivered(id: string): Promise<void>;
+    markDlq(id: string, lastError: string): Promise<void>;
+    listDlq(): Promise<readonly PushQueueItem[]>;
+    /** Test helper — read all items regardless of status. */
+    snapshot(): readonly PushQueueItem[];
+}
+//# sourceMappingURL=pushQueue.d.ts.map

package/dist/source/pushQueue.d.ts.map

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

package/dist/source/pushQueue.js

@@ -0,0 +1,257 @@
+/**
+ * The durable retry queue for delivering source events to the server.
+ *
+ * When your application changes a row, it can push the resulting event to
+ * the server, which acknowledges delivery synchronously. If your process
+ * crashes mid-call, the network drops, or the server returns a 5xx, that
+ * event would be lost without a safety net. This queue is the safety net:
+ * it persists each event first, then delivers it from a background worker
+ * with automatic retries. (Polling the change feed is the slower fallback
+ * for anything the queue never manages to deliver.)
+ *
+ * The queue follows a familiar enqueue-and-worker shape:
+ *
+ *   - `enqueue(events)` returns as soon as the events are persisted.
+ *   - A background worker delivers them and retries on failure, following
+ *     the Standard Webhooks schedule (0, 5s, 5m, 30m, 2h, 5h, 10h, 14h,
+ *     20h, 24h — roughly three days in total).
+ *   - Items that exhaust every retry move to a dead-letter queue you can
+ *     monitor.
+ *
+ * Persistence is pluggable through {@link PushQueueStorage}. Use
+ * {@link InMemoryPushQueueStorage} for a single process, or implement that
+ * interface against your own outbox table for production durability.
+ */
+import { ABLO_SOURCE_HEADERS, signAbloSourceRequest } from './signing.js';
+/**
+ * The default retry schedule, taken from the Standard Webhooks
+ * specification. The index is the attempt number and the value is the delay
+ * in milliseconds after the previous attempt failed. Once an item runs off
+ * the end of this array, it moves to the dead-letter queue.
+ *
+ * See https://www.standardwebhooks.com/.
+ */
+export const STANDARD_WEBHOOKS_RETRY_SCHEDULE = [
+    0, // immediate
+    5_000, // 5s
+    5 * 60_000, // 5m
+    30 * 60_000, // 30m
+    2 * 60 * 60_000, // 2h
+    5 * 60 * 60_000, // 5h
+    10 * 60 * 60_000, // 10h
+    14 * 60 * 60_000, // 14h
+    20 * 60 * 60_000, // 20h
+    24 * 60 * 60_000, // 24h
+];
+/** Create a {@link PushQueue} from the given {@link PushQueueOptions}. */
+export function createPushQueue(options) {
+    const tickIntervalMs = options.tickIntervalMs ?? 1000;
+    const batchSize = options.batchSize ?? 50;
+    const fetchImpl = options.fetch ?? fetch;
+    const now = options.now ?? Date.now;
+    const schedule = options.retrySchedule ?? STANDARD_WEBHOOKS_RETRY_SCHEDULE;
+    const jitter = options.jitter ?? 0.1;
+    return {
+        async enqueue(events) {
+            return options.storage.enqueue(events);
+        },
+        async run(signal) {
+            while (!signal.aborted) {
+                try {
+                    const due = await options.storage.due(now(), batchSize);
+                    for (const item of due) {
+                        if (signal.aborted)
+                            return;
+                        await deliver(item);
+                    }
+                }
+                catch (err) {
+                    // Storage failures shouldn't kill the loop; surface and
+                    // back off the tick interval.
+                    options.onError?.({ id: 'storage', events: [], attempts: 0, nextAttemptAt: 0, status: 'pending' }, err);
+                }
+                await sleep(tickIntervalMs, signal);
+            }
+        },
+        async redriveDlq() {
+            const items = await options.storage.listDlq();
+            let redriven = 0;
+            for (const item of items) {
+                await options.storage.enqueue(item.events);
+                redriven++;
+            }
+            return redriven;
+        },
+    };
+    async function deliver(item) {
+        const rawBody = JSON.stringify({ events: item.events });
+        let signed;
+        try {
+            signed = await signAbloSourceRequest({
+                apiKey: options.apiKey,
+                body: rawBody,
+                timestamp: Math.floor(now() / 1000),
+                // Reuse the queue id as the webhook-id across all retry
+                // attempts so the receiver can dedupe replays per spec.
+                messageId: item.id,
+            });
+        }
+        catch (err) {
+            // Signing should not fail in practice (no network, just HMAC).
+            // If it does, treat as a permanent failure.
+            await options.storage.markDlq(item.id, formatError(err));
+            options.onError?.(item, err);
+            return;
+        }
+        let response;
+        try {
+            response = await fetchImpl(options.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...signed.headers,
+                    [ABLO_SOURCE_HEADERS.idempotencyKey]: item.id,
+                },
+                body: rawBody,
+            });
+        }
+        catch (err) {
+            await reschedule(item, formatError(err));
+            return;
+        }
+        if (response.ok) {
+            await options.storage.markDelivered(item.id);
+            return;
+        }
+        // 4xx other than 408/429 are unrecoverable — don't retry. Move
+        // straight to DLQ so the customer's monitoring catches the bad
+        // request shape early instead of waiting 3 days for retries.
+        if (response.status >= 400 &&
+            response.status < 500 &&
+            response.status !== 408 &&
+            response.status !== 429) {
+            await options.storage.markDlq(item.id, `HTTP ${response.status}`);
+            return;
+        }
+        await reschedule(item, `HTTP ${response.status}`);
+    }
+    async function reschedule(item, error) {
+        const nextAttempt = item.attempts + 1;
+        // Past the end of the backoff schedule: no attempts left, so dead-letter
+        // the item.
+        const backoff = schedule[nextAttempt];
+        if (backoff === undefined) {
+            await options.storage.markDlq(item.id, error);
+            options.onError?.(item, new Error(error));
+            return;
+        }
+        const delay = applyJitter(backoff, jitter);
+        await options.storage.reschedule(item.id, now() + delay, error);
+    }
+}
+/**
+ * A {@link PushQueueStorage} that keeps items in memory. It is not durable —
+ * items are lost when the process restarts — so it suits development and
+ * low-volume use. For production, implement {@link PushQueueStorage} against
+ * your own table.
+ */
+export class InMemoryPushQueueStorage {
+    items = new Map();
+    nextId = 0;
+    now;
+    constructor(options = {}) {
+        this.now = options.now ?? Date.now;
+    }
+    async enqueue(events) {
+        const id = `q_${(++this.nextId).toString(36)}_${Math.random()
+            .toString(36)
+            .slice(2, 8)}`;
+        const item = {
+            id,
+            events,
+            attempts: 0,
+            nextAttemptAt: this.now(),
+            status: 'pending',
+        };
+        this.items.set(id, item);
+        return item;
+    }
+    async due(now, limit) {
+        const out = [];
+        for (const item of this.items.values()) {
+            if (out.length >= limit)
+                break;
+            if (item.status !== 'pending')
+                continue;
+            if (item.nextAttemptAt > now)
+                continue;
+            out.push(item);
+        }
+        return out;
+    }
+    async reschedule(id, nextAttemptAt, lastError) {
+        const item = this.items.get(id);
+        if (!item)
+            return;
+        this.items.set(id, {
+            ...item,
+            attempts: item.attempts + 1,
+            nextAttemptAt,
+            lastError,
+        });
+    }
+    async markDelivered(id) {
+        const item = this.items.get(id);
+        if (!item)
+            return;
+        this.items.set(id, { ...item, status: 'delivered' });
+    }
+    async markDlq(id, lastError) {
+        const item = this.items.get(id);
+        if (!item)
+            return;
+        this.items.set(id, {
+            ...item,
+            attempts: item.attempts + 1,
+            status: 'dlq',
+            lastError,
+        });
+    }
+    async listDlq() {
+        return Array.from(this.items.values()).filter((i) => i.status === 'dlq');
+    }
+    /** Test helper — read all items regardless of status. */
+    snapshot() {
+        return Array.from(this.items.values());
+    }
+}
+function applyJitter(delayMs, factor) {
+    if (factor <= 0 || delayMs === 0)
+        return delayMs;
+    const swing = delayMs * factor;
+    return Math.max(0, delayMs + (Math.random() * 2 - 1) * swing);
+}
+function formatError(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=pushQueue.js.map

package/dist/source/pushQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushQueue.js","sourceRoot":"","sources":["../../src/source/pushQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA6C1E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAsB;IACjE,CAAC,EAAE,YAAY;IACf,KAAK,EAAE,KAAK;IACZ,CAAC,GAAG,MAAM,EAAE,KAAK;IACjB,EAAE,GAAG,MAAM,EAAE,MAAM;IACnB,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK;IACtB,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK;IACtB,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM;IACxB,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM;IACxB,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM;IACxB,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM;CACzB,CAAC;AA4CF,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,gCAAgC,CAAC;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;IAErC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,MAAM;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,MAAM;YACd,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;oBACxD,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;wBACvB,IAAI,MAAM,CAAC,OAAO;4BAAE,OAAO;wBAC3B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,wDAAwD;oBACxD,8BAA8B;oBAC9B,OAAO,CAAC,OAAO,EAAE,CACf,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAC/E,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,UAAU;YACd,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC3C,QAAQ,EAAE,CAAC;YACb,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;IAEF,KAAK,UAAU,OAAO,CAAC,IAAmB;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,MAAyD,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,qBAAqB,CAAC;gBACnC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBACnC,wDAAwD;gBACxD,wDAAwD;gBACxD,SAAS,EAAE,IAAI,CAAC,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,+DAA+D;YAC/D,4CAA4C;YAC5C,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,MAAM,CAAC,OAAO;oBACjB,CAAC,mBAAmB,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,EAAE;iBAC9C;gBACD,IAAI,EAAE,OAAO;aACd,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,+DAA+D;QAC/D,+DAA+D;QAC/D,6DAA6D;QAC7D,IACE,QAAQ,CAAC,MAAM,IAAI,GAAG;YACtB,QAAQ,CAAC,MAAM,GAAG,GAAG;YACrB,QAAQ,CAAC,MAAM,KAAK,GAAG;YACvB,QAAQ,CAAC,MAAM,KAAK,GAAG,EACvB,CAAC;YACD,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAC3B,IAAI,CAAC,EAAE,EACP,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAC1B,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,UAAU,CAAC,IAAI,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,UAAU,UAAU,CACvB,IAAmB,EACnB,KAAa;QAEb,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QACtC,yEAAyE;QACzE,YAAY;QACZ,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAC3B,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,MAAM,GAAG,CAAC,CAAC;IACF,GAAG,CAAe;IAEnC,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAA8B;QAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE;aAC1D,QAAQ,CAAC,EAAE,CAAC;aACZ,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,GAAkB;YAC1B,EAAE;YACF,MAAM;YACN,QAAQ,EAAE,CAAC;YACX,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE;YACzB,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,MAAM,GAAG,GAAoB,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAM;YAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,SAAS;YACxC,IAAI,IAAI,CAAC,aAAa,GAAG,GAAG;gBAAE,SAAS;YACvC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,UAAU,CACd,EAAU,EACV,aAAqB,EACrB,SAAiB;QAEjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YACjB,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;YAC3B,aAAa;YACb,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAU;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,SAAiB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YACjB,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;YAC3B,MAAM,EAAE,KAAK;YACb,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,yDAAyD;IACzD,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;CACF;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,MAAc;IAClD,IAAI,MAAM,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAmB;IAC5C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC"}