@x12i/memorix-service 3.12.4 → 3.14.0

package/dist/writes/effects.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Side effects after a content write is stored. A failure here does not hide the receipt.
+ */
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+import type { CommittedWrite } from "./content-write.js";
+export declare function commitWriteEffects(args: {
+    platform: MemorixPlatform;
+    scope: MemorixScope;
+    caller: string;
+    event: CommittedWrite;
+}): Promise<unknown>;
+//# sourceMappingURL=effects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/writes/effects.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;CACvB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBnB"}

package/dist/writes/effects.js

@@ -0,0 +1,28 @@
+import { memorixActivityRing } from "../activity-ring.js";
+import { maybeEnqueueNexumAnalysis } from "../nexum-analysis/enqueue.js";
+export async function commitWriteEffects(args) {
+    const indexing = args.event.operation === "removed"
+        ? undefined
+        : await maybeEnqueueNexumAnalysis({
+            platform: args.platform,
+            scope: args.scope,
+            objectType: args.event.objectType,
+            contentType: args.event.contentType,
+            recordId: args.event.recordId,
+            revision: args.event.revision,
+            data: args.event.data,
+        });
+    memorixActivityRing.recordLand({
+        orgId: args.scope.orgId,
+        caller: args.caller,
+        objectType: args.event.objectType,
+        contentType: args.event.contentType,
+        recordId: args.event.recordId,
+        revision: args.event.revision,
+        outcome: args.event.operation,
+        indexing,
+        hooks: args.event.hooks,
+    });
+    return indexing;
+}
+//# sourceMappingURL=effects.js.map

package/dist/writes/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../src/writes/effects.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAKxC;IACC,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,yBAAyB,CAAC;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;YACnC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAC7B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAC7B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;SACtB,CAAC,CAAC;IACT,mBAAmB,CAAC,UAAU,CAAC;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;QACjC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;QACnC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;QAC7B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;QAC7B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS;QAC7B,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;KACxB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/writes/error-shape.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FR-6 — a rejection names the field and says whether the same request can succeed later.
+ */
+export type FailureShape = {
+    field: string | null;
+    retryable: boolean;
+    retryAfterMs?: number;
+};
+export declare function classifyFailure(err: unknown, status: number): FailureShape;
+export declare function httpStatusForCode(code: string, fallback?: number): number;
+//# sourceMappingURL=error-shape.d.ts.map

package/dist/writes/error-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-shape.d.ts","sourceRoot":"","sources":["../../src/writes/error-shape.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAyBF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAoD1E;AAUD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAsBtE"}

package/dist/writes/error-shape.js

@@ -0,0 +1,107 @@
+/**
+ * FR-6 — a rejection names the field and says whether the same request can succeed later.
+ */
+const NON_RETRYABLE = new Set([
+    "WRITE_IDENTIFIER_ISSUER",
+    "DIRECTORY_CONFLICT_OBJECT_TYPE",
+    "DIRECTORY_CONFLICT_DATA_CATEGORY",
+    "READ_DISCRIMINATOR_REQUIRED",
+    "WRITE_DISCRIMINATOR_REQUIRED",
+    "WRITE_ID_REUSED",
+    "QUEUE_KEY_REUSED",
+    "READ_QUERY_INVALID",
+    "WRITE_NOT_ABSENT",
+    "WRITE_NOT_FOUND",
+    "WRITE_STALE_REVISION",
+    "WRITE_PRECONDITION_INVALID",
+    "WRITE_IDENTITY_MISMATCH",
+    "WRITE_IDENTITY_ADOPTION",
+    "WRITE_FORMAT_INVALID",
+    "WRITE_INTERFACE_BINDING",
+    "VALIDATION",
+    "SCOPE_INVALID",
+    "BODY_TOO_LARGE",
+    "PUBLICATION_PINNED",
+]);
+export function classifyFailure(err, status) {
+    const code = err && typeof err === "object" && "code" in err && typeof err.code === "string"
+        ? err.code
+        : "";
+    const message = err instanceof Error ? err.message : typeof err === "string" ? err : "";
+    const details = err && typeof err === "object" && "details" in err ? err.details : undefined;
+    const detail = details && typeof details === "object" && !Array.isArray(details)
+        ? details
+        : {};
+    let field = null;
+    if (typeof detail.field === "string" && detail.field.trim())
+        field = detail.field;
+    else if (typeof detail.path === "string" && detail.path.trim())
+        field = detail.path;
+    else if (code === "WRITE_IDENTIFIER_ISSUER")
+        field = "concept.identifiers.primary.issuer";
+    else if (code === "DIRECTORY_CONFLICT_OBJECT_TYPE" || code === "DIRECTORY_CONFLICT_DATA_CATEGORY") {
+        field = "recordId";
+    }
+    else if (code === "READ_DISCRIMINATOR_REQUIRED" || code === "WRITE_DISCRIMINATOR_REQUIRED") {
+        field = "discriminatorValue";
+    }
+    else if (code === "WRITE_ID_REUSED")
+        field = "writeId";
+    else if (code === "QUEUE_KEY_REUSED")
+        field = "stepId";
+    else if (code === "WRITE_NOT_FOUND" || code === "WRITE_NOT_ABSENT")
+        field = "recordId";
+    else {
+        const match = message.match(/filter\[\d+\](?:\.[A-Za-z0-9_]+)?/);
+        if (match)
+            field = match[0];
+    }
+    if (detail.retryable === true) {
+        return { field, retryable: true, retryAfterMs: retryAfter(message, status, detail) };
+    }
+    if (detail.retryable === false || NON_RETRYABLE.has(code)) {
+        return { field, retryable: false };
+    }
+    const transient = status === 408 ||
+        status === 429 ||
+        status === 503 ||
+        status === 504 ||
+        code === "READ_UNAVAILABLE" ||
+        code === "ABSTRACT_WRITE_UNAVAILABLE" ||
+        code === "BACKFILL_UNAVAILABLE" ||
+        /timeout|timed out|ECONNRESET|EAI_AGAIN|MongoNetwork|server selection|overload|too many requests|ECONNREFUSED/i.test(message);
+    if (transient || status >= 500) {
+        return { field, retryable: true, retryAfterMs: retryAfter(message, status, detail) };
+    }
+    return { field, retryable: false };
+}
+function retryAfter(message, status, detail) {
+    if (typeof detail.retryAfterMs === "number" && Number.isFinite(detail.retryAfterMs)) {
+        return detail.retryAfterMs;
+    }
+    if (status === 429 || status === 503 || /overload|too many/i.test(message))
+        return 5_000;
+    return 1_000;
+}
+export function httpStatusForCode(code, fallback = 500) {
+    if (code === "WRITE_ID_REUSED" ||
+        code === "QUEUE_KEY_REUSED" ||
+        code === "WRITE_NOT_ABSENT" ||
+        code === "WRITE_STALE_REVISION") {
+        return 409;
+    }
+    if (code === "WRITE_NOT_FOUND" || code === "READ_NOT_FOUND")
+        return 404;
+    if (code === "READ_UNAVAILABLE" || code === "BACKFILL_UNAVAILABLE")
+        return 503;
+    if (code.startsWith("WRITE_") ||
+        code.startsWith("READ_") ||
+        code.startsWith("ROUTE_") ||
+        code.startsWith("DIRECTORY_") ||
+        code.startsWith("SCOPE_") ||
+        code === "VALIDATION") {
+        return 400;
+    }
+    return fallback;
+}
+//# sourceMappingURL=error-shape.js.map

package/dist/writes/error-shape.js.map

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

package/dist/writes/queued-write.d.ts

@@ -0,0 +1,38 @@
+import { type DatasourceWriteInput } from "@x12i/memorix-data";
+import { type ContentWriteBody, type ContentWriteDeps, type ContentWriteOutcome, type ContentWritePorts } from "./content-write.js";
+import { type WriteReceiptRow } from "./receipt-store.js";
+/**
+ * A new row is not applied for this long. A second accept for the same key may hold a lower accept
+ * number and still be on its way to the database. The wait lets it land first.
+ */
+export declare const QUEUE_SETTLE_MS = 500;
+/** `queue` is absent, or a boolean. */
+export declare function readQueueFlag(value: unknown): boolean;
+/**
+ * The queue key of one stored-document address, or null when the address cannot be resolved
+ * (for example a discriminated content type read without its discriminator).
+ */
+export declare function queueKeyIdFor(catalog: ContentWritePorts["catalog"], args: {
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    discriminatorValue?: string;
+}): string | null;
+/**
+ * The record a queued row will write, shaped like a stored read, minus the `revision` it does not have yet.
+ */
+export declare function pendingRecord(row: WriteReceiptRow): Record<string, unknown>;
+/**
+ * Accept one row. 202 `queued`, or the answer for a repeat, or a rejection that stored nothing.
+ */
+export declare function runQueuedWrite(deps: ContentWriteDeps, body: ContentWriteBody): Promise<ContentWriteOutcome>;
+/**
+ * Accept up to 500 rows in array order. Each row is stored and acknowledged before its result is recorded.
+ * One bad row does not reject the batch or drop rows already stored.
+ */
+export declare function runQueuedBatch(deps: ContentWriteDeps, body: unknown, datasourceFor: (body: ContentWriteBody) => DatasourceWriteInput): Promise<{
+    results: unknown[];
+}>;
+/** What `GET /api/data/receipts/:id`, the run list, and a repeat of a stored row return for a queued write. */
+export declare function publicQueuedReceipt(row: WriteReceiptRow): Record<string, unknown>;
+//# sourceMappingURL=queued-write.d.ts.map

package/dist/writes/queued-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-write.d.ts","sourceRoot":"","sources":["../../src/writes/queued-write.ts"],"names":[],"mappings":"AAYA,OAAO,EAML,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAOL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAInC,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIrD;AAyED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,EACrC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F,MAAM,GAAG,IAAI,CAYf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3E;AAwDD;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4CjH;AAgCD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,oBAAoB,GAC9D,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAyCjC;AAED,+GAA+G;AAC/G,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBjF"}

package/dist/writes/queued-write.js

@@ -0,0 +1,288 @@
+/**
+ * Queued content write (docs/async-content-write-FR.md).
+ *
+ * `queue: true` validates a row, stores one receipt in the operational database, and answers 202.
+ * The document is written later by the drain worker, in accept order for each storage key.
+ *
+ * The idempotency identity is storage key + run id + step id. Memorix derives it, keeps it in the
+ * receipt's `writeId`, and the existing unique `(orgId, caller, writeId)` index enforces it.
+ * "The same row" is the canonical content hash a synchronous write computes over the whole body:
+ * `data`, `_metadata`, `_audit` and the rest. The same tuple with any difference is `409 QUEUE_KEY_REUSED`.
+ */
+import { createHash } from "node:crypto";
+import { adoptRecordMetadata, canonicalJson, resolveContentInstanceFromDraft, resolveContentInstanceSelector, WriterError, } from "@x12i/memorix-data";
+import { ServiceError } from "../errors.js";
+import { normalizeWritePrecondition } from "../write-precondition.js";
+import { asServiceError, batchError, CONTENT_BATCH_LIMIT, prepareWrite, queuedBody, storageKey, } from "./content-write.js";
+import { newReceiptId, } from "./receipt-store.js";
+/**
+ * A new row is not applied for this long. A second accept for the same key may hold a lower accept
+ * number and still be on its way to the database. The wait lets it land first.
+ */
+export const QUEUE_SETTLE_MS = 500;
+const MAX_ID_LENGTH = 200;
+/** `queue` is absent, or a boolean. */
+export function readQueueFlag(value) {
+    if (value === undefined || value === null || value === false)
+        return false;
+    if (value === true)
+        return true;
+    throw new ServiceError("VALIDATION", "queue must be a boolean", 400, { field: "queue", retryable: false });
+}
+function validation(field, message) {
+    return new ServiceError("VALIDATION", message, 400, { field, retryable: false });
+}
+/** ACCEPT-03: what a queued write may not carry. */
+function assertQueueShape(body) {
+    if (body.writeId !== undefined && body.writeId !== null && body.writeId !== "") {
+        throw validation("writeId", "writeId is not used with queue: true. Memorix derives the idempotency key from the storage key, run id and step id.");
+    }
+    if (body.op !== undefined && body.op !== "upsert") {
+        throw validation("op", "a queued write is an upsert. patch, replace, add and remove use the synchronous write.");
+    }
+    if (body.precondition !== undefined && body.precondition !== null) {
+        const form = normalizeWritePrecondition(body.precondition, body.expectedRevision).form;
+        if (form !== "none") {
+            throw validation("precondition", `a queued write uses precondition none, not ${form}`);
+        }
+    }
+    if (body.expectedRevision !== undefined && body.expectedRevision !== null) {
+        throw validation("expectedRevision", "a queued write has no caller revision. Memorix assigns it.");
+    }
+    if (!body.record || typeof body.record !== "object" || Array.isArray(body.record)) {
+        throw validation("record", "record required");
+    }
+}
+function readExecutionId(execution, name) {
+    const field = `_metadata.execution.${name}`;
+    const value = execution[name];
+    if (typeof value !== "string" || !value.trim()) {
+        throw validation(field, `${field} is required with queue: true`);
+    }
+    const trimmed = value.trim();
+    if (trimmed.length > MAX_ID_LENGTH) {
+        throw validation(field, `${field} must be at most ${MAX_ID_LENGTH} characters`);
+    }
+    return trimmed;
+}
+/** Run id and step id, read after the fold a synchronous write applies to `properties` / `metadata` / `_metadata`. */
+function executionIds(record) {
+    const data = record.data && typeof record.data === "object" && !Array.isArray(record.data)
+        ? record.data
+        : {};
+    const folded = adoptRecordMetadata({ ...record, data });
+    const execution = folded._metadata?.execution;
+    if (!execution || typeof execution !== "object" || Array.isArray(execution)) {
+        throw validation("_metadata.execution", "_metadata.execution.runId and _metadata.execution.stepId are required with queue: true");
+    }
+    const bag = execution;
+    return { runId: readExecutionId(bag, "runId"), stepId: readExecutionId(bag, "stepId") };
+}
+function keyIdOf(objectType, contentType, address) {
+    return `${objectType}\u0000${contentType}\u0000${address}`;
+}
+/**
+ * The queue key of one stored-document address, or null when the address cannot be resolved
+ * (for example a discriminated content type read without its discriminator).
+ */
+export function queueKeyIdFor(catalog, args) {
+    try {
+        const address = resolveContentInstanceSelector({
+            recordId: args.recordId,
+            contentType: args.contentType,
+            discriminatorValue: args.discriminatorValue,
+            catalog,
+        });
+        return keyIdOf(args.objectType, args.contentType, address.storageKey);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The record a queued row will write, shaped like a stored read, minus the `revision` it does not have yet.
+ */
+export function pendingRecord(row) {
+    const record = structuredClone(row.request.record ?? {});
+    delete record.revision;
+    return record;
+}
+function addMs(iso, ms) {
+    return new Date(Date.parse(iso) + ms).toISOString();
+}
+function nowOf(deps) {
+    return (deps.now ?? (() => new Date().toISOString()))();
+}
+/** Validate the row and derive its identity. Nothing is stored. */
+function prepareQueued(deps, body, now) {
+    assertQueueShape(body);
+    const { queue: _queue, ...rest } = body;
+    void _queue;
+    const prepared = prepareWrite(deps, { ...rest, op: "upsert", precondition: "none" }, now);
+    const request = prepared.request;
+    const catalog = deps.ports.catalog;
+    const objectType = catalog.getObjectType(request.objectType);
+    if (!objectType) {
+        throw new WriterError("ROUTE_UNKNOWN_OBJECT_TYPE", `Unknown objectType ${request.objectType}`);
+    }
+    if (!objectType.contentTypes.includes(request.contentType)) {
+        throw new WriterError("ROUTE_UNKNOWN_CONTENT_TYPE", `contentType ${request.contentType} not allowed for ${request.objectType}`, { objectType: request.objectType, contentType: request.contentType, allowed: objectType.contentTypes });
+    }
+    if (catalog.getContentProfile && !catalog.getContentProfile(request.contentType)) {
+        throw new WriterError("METADATA_DESCRIPTOR_MISSING", `content type ${request.contentType} on ${request.objectType} has no descriptor; ensure the pack at startup before writing`, { objectType: request.objectType, contentType: request.contentType });
+    }
+    const resolved = resolveContentInstanceFromDraft(request.record, catalog);
+    const { runId, stepId } = executionIds(body.record);
+    const recordId = resolved.address.recordId;
+    const key = storageKey(resolved.address.kind === "discriminated"
+        ? { ...request, discriminatorValue: resolved.address.discriminatorValue }
+        : request, recordId);
+    const keyId = keyIdOf(request.objectType, request.contentType, resolved.address.storageKey);
+    const writeId = `queue:${createHash("sha256").update(canonicalJson({ keyId, runId, stepId })).digest("hex")}`;
+    return { prepared, identity: { keyId, runId, stepId, storageKey: key, writeId } };
+}
+/**
+ * Accept one row. 202 `queued`, or the answer for a repeat, or a rejection that stored nothing.
+ */
+export async function runQueuedWrite(deps, body) {
+    const now = nowOf(deps);
+    let prepared;
+    let identity;
+    try {
+        ({ prepared, identity } = prepareQueued(deps, body, now));
+        await deps.checkWrite?.(prepared.request);
+    }
+    catch (err) {
+        return { kind: "rejected", error: asServiceError(err) };
+    }
+    const seq = await deps.receipts.reserveSeq(deps.scope.orgId, 1);
+    const row = {
+        receiptId: newReceiptId(),
+        orgId: deps.scope.orgId,
+        caller: deps.caller,
+        writeId: identity.writeId,
+        contentHash: prepared.contentHash,
+        status: "queued",
+        request: prepared.request,
+        queue: {
+            seq,
+            keyId: identity.keyId,
+            runId: identity.runId,
+            stepId: identity.stepId,
+            storageKey: identity.storageKey,
+        },
+        attempts: 0,
+        nextAttemptAt: addMs(now, QUEUE_SETTLE_MS),
+        createdAt: now,
+        updatedAt: now,
+    };
+    const inserted = await deps.receipts.insert(row);
+    if (inserted === "inserted")
+        return { kind: "queued", httpStatus: 202, body: queuedBody(row) };
+    const existing = await deps.receipts.findByWriteId(deps.scope.orgId, deps.caller, identity.writeId);
+    if (existing)
+        return answerRepeat(existing, prepared.contentHash);
+    return {
+        kind: "rejected",
+        error: new ServiceError("WRITE_UNAVAILABLE", "the write queue could not record this row; send it again", 503, {
+            retryable: true,
+            retryAfterMs: 1_000,
+        }),
+    };
+}
+/** The same tuple again: the original receipt, or 409 when the row differs. */
+function answerRepeat(existing, contentHash) {
+    if (existing.contentHash !== contentHash) {
+        return {
+            kind: "rejected",
+            error: new ServiceError("QUEUE_KEY_REUSED", "this storage key, run id and step id was already accepted with different content. Send a correction under a new step id.", 409, { field: "stepId", retryable: false, receiptId: existing.receiptId }),
+        };
+    }
+    if (existing.status === "stored") {
+        return { kind: "stored", httpStatus: 200, body: publicQueuedReceipt(existing) };
+    }
+    if (existing.status === "queued" || existing.status === "pending") {
+        return { kind: "queued", httpStatus: 202, body: queuedBody(existing) };
+    }
+    const error = existing.error;
+    return {
+        kind: "rejected",
+        error: new ServiceError(error?.code ?? "VALIDATION", error?.message ?? "write was rejected", error?.status ?? 400, {
+            field: error?.field,
+            retryable: false,
+            receiptId: existing.receiptId,
+        }),
+    };
+}
+/**
+ * Accept up to 500 rows in array order. Each row is stored and acknowledged before its result is recorded.
+ * One bad row does not reject the batch or drop rows already stored.
+ */
+export async function runQueuedBatch(deps, body, datasourceFor) {
+    if (!body || typeof body !== "object" || Array.isArray(body) || !Array.isArray(body.writes)) {
+        throw new ServiceError("VALIDATION", "writes must be an array", 400, { field: "writes", retryable: false });
+    }
+    const writes = body.writes;
+    if (writes.length > CONTENT_BATCH_LIMIT) {
+        throw new ServiceError("VALIDATION", `writes accepts at most ${CONTENT_BATCH_LIMIT} rows`, 400, {
+            field: "writes",
+            retryable: false,
+        });
+    }
+    const results = [];
+    for (const item of writes) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            results.push({
+                error: { code: "VALIDATION", field: "writes", message: "each write must be an object", retryable: false },
+            });
+            continue;
+        }
+        const row = item;
+        if (row.queue !== undefined) {
+            results.push({
+                error: {
+                    code: "VALIDATION",
+                    field: "queue",
+                    message: "queue is set on the batch body, not on a row",
+                    retryable: false,
+                },
+            });
+            continue;
+        }
+        try {
+            const datasource = datasourceFor(row);
+            const outcome = await runQueuedWrite({ ...deps, datasource }, row);
+            if (outcome.kind === "rejected")
+                results.push(batchError(outcome.error));
+            else
+                results.push(outcome.body);
+        }
+        catch (err) {
+            results.push(batchError(err));
+        }
+    }
+    return { results };
+}
+/** What `GET /api/data/receipts/:id`, the run list, and a repeat of a stored row return for a queued write. */
+export function publicQueuedReceipt(row) {
+    const queue = row.queue;
+    return {
+        receiptId: row.receiptId,
+        status: row.status,
+        ...(queue ? { storageKey: queue.storageKey, runId: queue.runId, stepId: queue.stepId } : {}),
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+        ...(row.status === "stored" && row.receipt ? { receipt: row.receipt } : {}),
+        ...(row.status === "rejected" && row.error
+            ? {
+                error: {
+                    code: row.error.code,
+                    field: row.error.field,
+                    message: row.error.message,
+                    retryable: row.error.retryable,
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=queued-write.js.map

package/dist/writes/queued-write.js.map

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