@x12i/memorix-service 3.12.4 → 3.14.0

package/dist/writes/receipt-store.d.ts

@@ -0,0 +1,131 @@
+import type { Db } from "mongodb";
+export declare const WRITE_RECEIPTS_COLLECTION = "write-receipts";
+export declare const RECEIPT_SEQ_COLLECTION = "write-receipt-seq";
+export declare const REJECTED_RECEIPT_TTL_MS: number;
+export declare const WRITE_ATTEMPT_LEASE_MS = 30000;
+export type WriteOperation = "created" | "updated" | "removed" | "unchanged";
+export type WriteReceipt = {
+    storageKey: {
+        objectType: string;
+        contentType: string;
+        recordId: string;
+        discriminator?: string;
+    };
+    revision: number;
+    writtenAt: string;
+    operation: WriteOperation;
+};
+export type StoredContentWrite = {
+    scope: {
+        orgId: string;
+        agentIds: string[];
+    };
+    caller: string;
+    op: "add" | "upsert" | "patch" | "replace" | "remove";
+    objectType: string;
+    contentType: string;
+    precondition: "absent" | "exact-revision" | "none";
+    expectedRevision?: number;
+    discriminatorValue?: string;
+    suppressHooks: boolean;
+    record?: Record<string, unknown>;
+    patch?: unknown;
+    subject?: {
+        objectType: string;
+        recordId: string;
+    };
+    datasourceDeclared: boolean;
+    datasourceDeclaration?: unknown;
+};
+export type ReceiptError = {
+    code: string;
+    field: string | null;
+    message: string;
+    retryable: boolean;
+    retryAfterMs?: number;
+    status: number;
+};
+/**
+ * What a queued row adds to its receipt. A synchronous receipt has none of this.
+ */
+export type QueuedWriteInfo = {
+    /** Accept number, monotonic per org. Rows for one key apply in this order. */
+    seq: number;
+    /** The storage key the row lands on. Rows with the same `keyId` apply one at a time. */
+    keyId: string;
+    runId: string;
+    stepId: string;
+    storageKey: WriteReceipt["storageKey"];
+};
+export type RunReceiptStatus = "queued" | "stored" | "rejected";
+export type RunSummary = {
+    queued: number;
+    stored: number;
+    rejected: number;
+};
+export type WriteReceiptRow = {
+    receiptId: string;
+    orgId: string;
+    caller: string;
+    writeId?: string;
+    contentHash: string;
+    /**
+     * `pending` is a synchronous write that failed in a way a retry can fix.
+     * `queued` is a row that was accepted with `queue: true` and is not applied yet.
+     */
+    status: "pending" | "queued" | "stored" | "rejected";
+    receipt?: WriteReceipt;
+    error?: ReceiptError;
+    request: StoredContentWrite;
+    queue?: QueuedWriteInfo;
+    attempts: number;
+    nextAttemptAt: string;
+    createdAt: string;
+    updatedAt: string;
+    expireAt?: string;
+};
+export type WriteReceiptStore = {
+    findByWriteId(orgId: string, caller: string, writeId: string): Promise<WriteReceiptRow | null>;
+    get(orgId: string, receiptId: string): Promise<WriteReceiptRow | null>;
+    /** `conflict` when this caller already has that writeId. */
+    insert(row: WriteReceiptRow): Promise<"inserted" | "conflict">;
+    save(row: WriteReceiptRow): Promise<void>;
+    list(args: {
+        orgId: string;
+        caller: string;
+        status?: "pending" | "queued" | "stored" | "rejected";
+        limit: number;
+    }): Promise<WriteReceiptRow[]>;
+    claimDue(orgId: string, now: string, limit: number, leaseMs: number): Promise<WriteReceiptRow[]>;
+    /** The first of `count` consecutive accept numbers for this org. */
+    reserveSeq(orgId: string, count: number): Promise<number>;
+    /**
+     * Queued rows that are due and have no earlier open row on the same key.
+     * Each returned row is leased: no other claim returns it until the lease ends.
+     */
+    claimQueued(orgId: string, now: string, limit: number, leaseMs: number): Promise<WriteReceiptRow[]>;
+    /** Queued-write receipts of one run for one caller, in accept order, after the cursor. */
+    listByRun(args: {
+        orgId: string;
+        caller: string;
+        runId: string;
+        stepId?: string;
+        status?: RunReceiptStatus;
+        /** Return rows whose accept number is greater than this. */
+        after?: number;
+        limit: number;
+    }): Promise<WriteReceiptRow[]>;
+    summarizeRun(args: {
+        orgId: string;
+        caller: string;
+        runId: string;
+        stepId?: string;
+    }): Promise<RunSummary>;
+    /** The newest accepted row for a key that has not been applied. */
+    latestQueuedForKey(orgId: string, keyId: string): Promise<WriteReceiptRow | null>;
+};
+export declare function newReceiptId(): string;
+export declare function rejectedExpiry(nowIso: string): string;
+export declare function createMemoryWriteReceiptStore(): WriteReceiptStore;
+export declare function createMongoWriteReceiptStore(db: Db): WriteReceiptStore;
+//# sourceMappingURL=receipt-store.d.ts.map

package/dist/writes/receipt-store.d.ts.map

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

package/dist/writes/receipt-store.js

@@ -0,0 +1,360 @@
+/**
+ * FR-2 / FR-4 — durable write receipts. Rejected rows stay listable for 7 days.
+ */
+import { randomBytes } from "node:crypto";
+export const WRITE_RECEIPTS_COLLECTION = "write-receipts";
+export const RECEIPT_SEQ_COLLECTION = "write-receipt-seq";
+export const REJECTED_RECEIPT_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+export const WRITE_ATTEMPT_LEASE_MS = 30_000;
+export function newReceiptId() {
+    return `wr_${randomBytes(16).toString("hex")}`;
+}
+export function rejectedExpiry(nowIso) {
+    return new Date(Date.parse(nowIso) + REJECTED_RECEIPT_TTL_MS).toISOString();
+}
+function matchesRun(row, args) {
+    return (row.caller === args.caller &&
+        row.queue?.runId === args.runId &&
+        (args.stepId === undefined || row.queue.stepId === args.stepId));
+}
+export function createMemoryWriteReceiptStore() {
+    const buckets = new Map();
+    function bucket(orgId) {
+        let found = buckets.get(orgId);
+        if (!found) {
+            found = { byId: new Map(), byWriteId: new Map(), seq: 0 };
+            buckets.set(orgId, found);
+        }
+        return found;
+    }
+    function writeKey(caller, writeId) {
+        return `${caller}\n${writeId}`;
+    }
+    return {
+        async findByWriteId(orgId, caller, writeId) {
+            const id = bucket(orgId).byWriteId.get(writeKey(caller, writeId));
+            if (!id)
+                return null;
+            return structuredClone(bucket(orgId).byId.get(id) ?? null);
+        },
+        async get(orgId, receiptId) {
+            return structuredClone(bucket(orgId).byId.get(receiptId) ?? null);
+        },
+        async insert(row) {
+            const box = bucket(row.orgId);
+            if (row.writeId) {
+                const key = writeKey(row.caller, row.writeId);
+                if (box.byWriteId.has(key))
+                    return "conflict";
+                box.byWriteId.set(key, row.receiptId);
+            }
+            box.byId.set(row.receiptId, structuredClone(row));
+            return "inserted";
+        },
+        async save(row) {
+            const box = bucket(row.orgId);
+            box.byId.set(row.receiptId, structuredClone(row));
+            if (row.writeId)
+                box.byWriteId.set(writeKey(row.caller, row.writeId), row.receiptId);
+        },
+        async list(args) {
+            const cutoff = Date.now() - REJECTED_RECEIPT_TTL_MS;
+            return [...bucket(args.orgId).byId.values()]
+                .filter((row) => row.caller === args.caller)
+                .filter((row) => (args.status ? row.status === args.status : true))
+                .filter((row) => row.status !== "rejected" || Date.parse(row.createdAt) >= cutoff)
+                .sort((a, b) => b.createdAt.localeCompare(a.createdAt))
+                .slice(0, args.limit)
+                .map((row) => structuredClone(row));
+        },
+        async claimDue(orgId, now, limit, leaseMs) {
+            const until = new Date(Date.parse(now) + leaseMs).toISOString();
+            const due = [...bucket(orgId).byId.values()]
+                .filter((row) => row.status === "pending" && row.nextAttemptAt <= now)
+                .sort((a, b) => a.nextAttemptAt.localeCompare(b.nextAttemptAt))
+                .slice(0, limit);
+            const claimed = [];
+            for (const row of due) {
+                if (row.status !== "pending" || row.nextAttemptAt > now)
+                    continue;
+                row.nextAttemptAt = until;
+                row.attempts += 1;
+                row.updatedAt = now;
+                claimed.push(structuredClone(row));
+            }
+            return claimed;
+        },
+        async reserveSeq(orgId, count) {
+            const box = bucket(orgId);
+            const first = box.seq + 1;
+            box.seq += count;
+            return first;
+        },
+        async claimQueued(orgId, now, limit, leaseMs) {
+            const until = new Date(Date.parse(now) + leaseMs).toISOString();
+            const open = [...bucket(orgId).byId.values()].filter((row) => row.status === "queued" && row.queue);
+            const earliestOpen = new Map();
+            for (const row of open) {
+                const seen = earliestOpen.get(row.queue.keyId);
+                if (seen === undefined || row.queue.seq < seen)
+                    earliestOpen.set(row.queue.keyId, row.queue.seq);
+            }
+            const claimed = [];
+            const due = open
+                .filter((row) => row.nextAttemptAt <= now)
+                .sort((a, b) => a.queue.seq - b.queue.seq);
+            for (const row of due) {
+                if (claimed.length >= limit)
+                    break;
+                if (earliestOpen.get(row.queue.keyId) !== row.queue.seq)
+                    continue;
+                row.nextAttemptAt = until;
+                row.attempts += 1;
+                row.updatedAt = now;
+                claimed.push(structuredClone(row));
+            }
+            return claimed;
+        },
+        async listByRun(args) {
+            return [...bucket(args.orgId).byId.values()]
+                .filter((row) => matchesRun(row, args))
+                .filter((row) => (args.status ? row.status === args.status : true))
+                .filter((row) => (args.after === undefined ? true : row.queue.seq > args.after))
+                .sort((a, b) => a.queue.seq - b.queue.seq)
+                .slice(0, args.limit)
+                .map((row) => structuredClone(row));
+        },
+        async summarizeRun(args) {
+            const summary = { queued: 0, stored: 0, rejected: 0 };
+            for (const row of bucket(args.orgId).byId.values()) {
+                if (!matchesRun(row, args))
+                    continue;
+                if (row.status === "queued" || row.status === "stored" || row.status === "rejected") {
+                    summary[row.status] += 1;
+                }
+            }
+            return summary;
+        },
+        async latestQueuedForKey(orgId, keyId) {
+            let latest = null;
+            for (const row of bucket(orgId).byId.values()) {
+                if (row.status !== "queued" || row.queue?.keyId !== keyId)
+                    continue;
+                if (!latest || row.queue.seq > latest.queue.seq)
+                    latest = row;
+            }
+            return latest ? structuredClone(latest) : null;
+        },
+    };
+}
+export function createMongoWriteReceiptStore(db) {
+    const coll = db.collection(WRITE_RECEIPTS_COLLECTION);
+    let ready = null;
+    function ensure() {
+        ready ??= Promise.all([
+            coll.createIndex({ orgId: 1, caller: 1, writeId: 1 }, {
+                unique: true,
+                name: "write_id",
+                partialFilterExpression: { writeId: { $type: "string" } },
+            }),
+            coll.createIndex({ orgId: 1, caller: 1, status: 1, createdAt: -1 }, { name: "caller_status" }),
+            coll.createIndex({ orgId: 1, status: 1, nextAttemptAt: 1 }, { name: "pending_due" }),
+            coll.createIndex({ expireAtDate: 1 }, { expireAfterSeconds: 0, name: "rejected_ttl" }),
+        ]).then(() => undefined);
+        return ready;
+    }
+    /**
+     * Indexes for queued writes only. They are separate from `ensure()` so a synchronous write never
+     * waits for them: on a large `write-receipts` collection the first build scans every row once.
+     * Partial filters keep synchronous receipts out of these indexes, and each query on one of them
+     * states the field its filter names, so the planner can use it.
+     * A failed build is tried again on the next queue call.
+     */
+    let queueReady = null;
+    function ensureQueue() {
+        queueReady ??= Promise.all([
+            ensure(),
+            coll.createIndex({ orgId: 1, status: 1, "queue.seq": 1 }, { name: "queue_seq", partialFilterExpression: { "queue.seq": { $exists: true } } }),
+            coll.createIndex({ orgId: 1, "queue.keyId": 1, status: 1, "queue.seq": 1 }, { name: "queue_key", partialFilterExpression: { "queue.keyId": { $exists: true } } }),
+            coll.createIndex({ orgId: 1, caller: 1, "queue.runId": 1, status: 1, "queue.seq": 1 }, { name: "queue_run_status", partialFilterExpression: { "queue.runId": { $exists: true } } }),
+            coll.createIndex({ orgId: 1, caller: 1, "queue.runId": 1, "queue.seq": 1 }, { name: "queue_run", partialFilterExpression: { "queue.runId": { $exists: true } } }),
+        ]).then(() => undefined, (err) => {
+            queueReady = null;
+            throw err;
+        });
+        return queueReady;
+    }
+    /** One counter document per org. `$inc` is atomic, so two processes never share a number. */
+    const counters = db.collection(RECEIPT_SEQ_COLLECTION);
+    return {
+        async findByWriteId(orgId, caller, writeId) {
+            await ensure();
+            const doc = await coll.findOne({ orgId, caller, writeId });
+            return doc ? fromDoc(doc) : null;
+        },
+        async get(orgId, receiptId) {
+            await ensure();
+            const doc = await coll.findOne({ _id: receiptId, orgId });
+            return doc ? fromDoc(doc) : null;
+        },
+        async insert(row) {
+            // A synchronous receipt never waits for the queue indexes.
+            await (row.queue ? ensureQueue() : ensure());
+            try {
+                await coll.insertOne(toDoc(row));
+                return "inserted";
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if (message.includes("E11000") || message.includes("duplicate"))
+                    return "conflict";
+                throw err;
+            }
+        },
+        async save(row) {
+            await ensure();
+            await coll.replaceOne({ _id: row.receiptId }, toDoc(row), { upsert: true });
+        },
+        async list(args) {
+            await ensure();
+            const cutoff = new Date(Date.now() - REJECTED_RECEIPT_TTL_MS).toISOString();
+            const filter = { orgId: args.orgId, caller: args.caller };
+            if (args.status)
+                filter.status = args.status;
+            if (args.status === "rejected")
+                filter.createdAt = { $gte: cutoff };
+            const docs = await coll.find(filter).sort({ createdAt: -1 }).limit(args.limit).toArray();
+            return docs.map(fromDoc);
+        },
+        async claimDue(orgId, now, limit, leaseMs) {
+            await ensure();
+            const until = new Date(Date.parse(now) + leaseMs).toISOString();
+            const due = await coll
+                .find({ orgId, status: "pending", nextAttemptAt: { $lte: now } })
+                .sort({ nextAttemptAt: 1 })
+                .limit(limit)
+                .toArray();
+            const claimed = [];
+            for (const doc of due) {
+                const updated = await coll.updateOne({ _id: doc._id, status: "pending", nextAttemptAt: doc.nextAttemptAt }, { $set: { nextAttemptAt: until, updatedAt: now }, $inc: { attempts: 1 } });
+                if (updated.modifiedCount !== 1)
+                    continue;
+                const fresh = await coll.findOne({ _id: doc._id });
+                if (fresh)
+                    claimed.push(fromDoc(fresh));
+            }
+            return claimed;
+        },
+        async reserveSeq(orgId, count) {
+            const after = await counters.findOneAndUpdate({ _id: orgId }, { $inc: { seq: count } }, { upsert: true, returnDocument: "after" });
+            if (!after)
+                throw new Error("receipt sequence counter did not return a document");
+            return after.seq - count + 1;
+        },
+        async claimQueued(orgId, now, limit, leaseMs) {
+            await ensureQueue();
+            const until = new Date(Date.parse(now) + leaseMs).toISOString();
+            const claimed = [];
+            const taken = new Set();
+            const pageSize = Math.max(limit * 4, 16);
+            // Rows waiting behind an earlier row on the same key fill the front of the order.
+            // Keep paging past them, up to a cap, so other keys are not starved.
+            const SCAN_CAP = 4_000;
+            let scanned = 0;
+            let after = 0;
+            while (claimed.length < limit && scanned < SCAN_CAP) {
+                // Only what the claim needs. The full row, with its request body, is read once it is claimed.
+                const page = await coll
+                    .find({ orgId, status: "queued", "queue.seq": { $gt: after }, nextAttemptAt: { $lte: now } }, { projection: { _id: 1, "queue.seq": 1, "queue.keyId": 1, nextAttemptAt: 1 } })
+                    .sort({ "queue.seq": 1 })
+                    .limit(pageSize)
+                    .toArray();
+                if (page.length === 0)
+                    break;
+                for (const doc of page) {
+                    scanned += 1;
+                    after = doc.queue.seq;
+                    if (claimed.length >= limit)
+                        break;
+                    const keyId = doc.queue.keyId;
+                    if (taken.has(keyId))
+                        continue;
+                    const ahead = await coll.findOne({
+                        orgId,
+                        status: "queued",
+                        "queue.keyId": keyId,
+                        "queue.seq": { $lt: doc.queue.seq },
+                    }, { projection: { _id: 1 } });
+                    if (ahead)
+                        continue;
+                    const updated = await coll.updateOne({ _id: doc._id, status: "queued", nextAttemptAt: doc.nextAttemptAt }, { $set: { nextAttemptAt: until, updatedAt: now }, $inc: { attempts: 1 } });
+                    if (updated.modifiedCount !== 1)
+                        continue;
+                    taken.add(keyId);
+                    const fresh = await coll.findOne({ _id: doc._id });
+                    if (fresh)
+                        claimed.push(fromDoc(fresh));
+                }
+                if (page.length < pageSize)
+                    break;
+            }
+            return claimed;
+        },
+        async listByRun(args) {
+            await ensureQueue();
+            const filter = {
+                orgId: args.orgId,
+                caller: args.caller,
+                "queue.runId": args.runId,
+                "queue.seq": { $gt: args.after ?? 0 },
+            };
+            if (args.stepId !== undefined)
+                filter["queue.stepId"] = args.stepId;
+            if (args.status)
+                filter.status = args.status;
+            const docs = await coll.find(filter).sort({ "queue.seq": 1 }).limit(args.limit).toArray();
+            return docs.map(fromDoc);
+        },
+        async summarizeRun(args) {
+            await ensureQueue();
+            const match = {
+                orgId: args.orgId,
+                caller: args.caller,
+                "queue.runId": args.runId,
+            };
+            if (args.stepId !== undefined)
+                match["queue.stepId"] = args.stepId;
+            const groups = await coll
+                .aggregate([
+                { $match: match },
+                { $group: { _id: "$status", n: { $sum: 1 } } },
+            ])
+                .toArray();
+            const summary = { queued: 0, stored: 0, rejected: 0 };
+            for (const group of groups) {
+                if (group._id === "queued" || group._id === "stored" || group._id === "rejected") {
+                    summary[group._id] = group.n;
+                }
+            }
+            return summary;
+        },
+        async latestQueuedForKey(orgId, keyId) {
+            await ensureQueue();
+            const doc = await coll.findOne({ orgId, status: "queued", "queue.keyId": keyId, "queue.seq": { $gt: 0 } }, { sort: { "queue.seq": -1 } });
+            return doc ? fromDoc(doc) : null;
+        },
+    };
+}
+function toDoc(row) {
+    const doc = { ...row, _id: row.receiptId };
+    if (row.expireAt)
+        doc.expireAtDate = new Date(row.expireAt);
+    return doc;
+}
+function fromDoc(doc) {
+    const { _id: _drop, expireAtDate: _date, ...rest } = doc;
+    void _drop;
+    void _date;
+    return rest;
+}
+//# sourceMappingURL=receipt-store.js.map

package/dist/writes/receipt-store.js.map

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

package/dist/writes/worker.d.ts

@@ -0,0 +1,30 @@
+import { type WriteReceiptRow, type WriteReceiptStore } from "./receipt-store.js";
+/** Finish writes Memorix already accepted. */
+export declare function tickWriteReceipts(args: {
+    orgIds: string[];
+    now: string;
+    storeFor: (orgId: string) => WriteReceiptStore;
+    replay: (row: WriteReceiptRow) => Promise<void>;
+}): Promise<void>;
+export declare const QUEUE_DEFAULT_CONCURRENCY = 8;
+/**
+ * Apply queued rows until none is due, or the budget ends.
+ *
+ * Rows for one storage key apply one at a time in accept order, because `claimQueued` never returns a
+ * row while an earlier open row for its key exists. Rows for different keys apply at the same time, up
+ * to `concurrency`. A claim is a compare-and-set on the receipt, so a second process draining the same
+ * database cannot apply the same row.
+ */
+export declare function drainQueuedWrites(args: {
+    orgIds: string[];
+    now: () => string;
+    storeFor: (orgId: string) => WriteReceiptStore;
+    replay: (row: WriteReceiptRow) => Promise<void>;
+    concurrency?: number;
+    /** After this long the drain returns. The next tick starts another, so the org list stays fresh. */
+    budgetMs?: number;
+    shouldStop?: () => boolean;
+}): Promise<{
+    applied: number;
+}>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/writes/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/writes/worker.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,8CAA8C;AAC9C,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAG3C;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE/B"}

package/dist/writes/worker.js

@@ -0,0 +1,100 @@
+import { QUEUE_MAX_ATTEMPTS } from "./content-write.js";
+import { rejectedExpiry, WRITE_ATTEMPT_LEASE_MS, } from "./receipt-store.js";
+/** Finish writes Memorix already accepted. */
+export async function tickWriteReceipts(args) {
+    for (const orgId of args.orgIds) {
+        const store = args.storeFor(orgId);
+        const due = await store.claimDue(orgId, args.now, 20, WRITE_ATTEMPT_LEASE_MS);
+        for (const row of due) {
+            try {
+                await args.replay(row);
+            }
+            catch {
+                row.status = "pending";
+                row.nextAttemptAt = new Date(Date.parse(args.now) + 5_000).toISOString();
+                row.updatedAt = args.now;
+                await store.save(row);
+            }
+        }
+    }
+}
+export const QUEUE_DEFAULT_CONCURRENCY = 8;
+const QUEUE_REPLAY_FAILURE_DELAY_MS = 5_000;
+/**
+ * Apply queued rows until none is due, or the budget ends.
+ *
+ * Rows for one storage key apply one at a time in accept order, because `claimQueued` never returns a
+ * row while an earlier open row for its key exists. Rows for different keys apply at the same time, up
+ * to `concurrency`. A claim is a compare-and-set on the receipt, so a second process draining the same
+ * database cannot apply the same row.
+ */
+export async function drainQueuedWrites(args) {
+    const concurrency = Math.max(1, Math.floor(args.concurrency ?? QUEUE_DEFAULT_CONCURRENCY));
+    const deadline = Date.now() + (args.budgetMs ?? 20_000);
+    const stopped = () => args.shouldStop?.() === true || Date.now() > deadline;
+    let applied = 0;
+    for (const orgId of args.orgIds) {
+        if (stopped())
+            break;
+        const store = args.storeFor(orgId);
+        const inFlight = new Set();
+        const apply = async (row) => {
+            try {
+                await args.replay(row);
+                applied += 1;
+            }
+            catch (err) {
+                // `finish` records its own failures. This is a failure around it, such as the database being down.
+                const now = args.now();
+                try {
+                    if (row.attempts >= QUEUE_MAX_ATTEMPTS) {
+                        row.status = "rejected";
+                        row.error = {
+                            code: "WRITE_FAILED",
+                            field: null,
+                            message: `gave up after ${row.attempts} attempts: ${err instanceof Error ? err.message : String(err)}`,
+                            retryable: false,
+                            status: 500,
+                        };
+                        row.expireAt = rejectedExpiry(now);
+                    }
+                    else {
+                        row.status = "queued";
+                        row.nextAttemptAt = new Date(Date.parse(now) + QUEUE_REPLAY_FAILURE_DELAY_MS).toISOString();
+                    }
+                    row.updatedAt = now;
+                    await store.save(row);
+                }
+                catch {
+                    /* the lease runs out and the row is claimed again */
+                }
+            }
+        };
+        try {
+            while (!stopped()) {
+                const free = concurrency - inFlight.size;
+                let claimed = 0;
+                if (free > 0) {
+                    const rows = await store.claimQueued(orgId, args.now(), free, WRITE_ATTEMPT_LEASE_MS);
+                    claimed = rows.length;
+                    for (const row of rows) {
+                        const task = apply(row).finally(() => {
+                            inFlight.delete(task);
+                        });
+                        inFlight.add(task);
+                    }
+                }
+                if (inFlight.size === 0)
+                    break;
+                // A finished apply can free the next row for its key, so wait for one slot before claiming again.
+                if (claimed === 0 || inFlight.size >= concurrency)
+                    await Promise.race(inFlight);
+            }
+        }
+        finally {
+            await Promise.all(inFlight);
+        }
+    }
+    return { applied };
+}
+//# sourceMappingURL=worker.js.map