@superbee/core 0.2.0-pre.2 → 0.2.0-pre.21

package/dist/hosted-transport/root-write.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The bundle's front page: one write that replaces the root `index.md` (`bundles.root.replace.v1`,
+ * `POST <sync prefix>/root`), compare-and-swap on the root's version or on its absence.
+ *
+ * It is not an identified write. It carries no `X-Superbee-Write-Request`, the host keeps no
+ * receipt of it, and there is no outcome lookup. A root version is the SHA-256 of its exact UTF-8
+ * bytes, so a client that lost the answer re-reads the root's version from the capabilities answer
+ * instead ({@link rootLanding}): the digest of what it sent means the write landed, its base means
+ * it did not, and anything else is a conflict. The window this leaves (the root returning to the
+ * same old bytes in between) is accepted for a front page.
+ *
+ * The refusal envelope is the write schema's, read by the same parser as a document write's; only
+ * the success differs, since it names the bundle and no document.
+ */
+import { type AuthorizationCode } from "./answer-rows.js";
+import { type HostedAnswer, type HostedCarrier } from "./carrier.js";
+export declare const ROOT_OPERATION_ID = "bundles.root.replace.v1";
+/** What a capabilities answer says about replacing the bundle's root `index.md`; absent reads as `"refused"`. */
+export type HostedRootWrites = "allowed" | "refused";
+export declare const ROOT_WRITE_BOUNDS: Readonly<{
+    /** The request ceiling, measured on the encoded JSON body: the same bound as every sync write. */
+    payloadBytes: 65536;
+    /** The answer is a bounded result envelope. */
+    answerBytes: 65536;
+}>;
+/** The root's version as the host computes it: `sha256:` and the hex SHA-256 of the UTF-8 bytes. */
+export declare function rootVersionOf(content: string): string;
+/** The body one root write sends: against `expectedVersion`, or creating a root that is absent. */
+export type RootWritePayload = {
+    readonly bundleId: string;
+    readonly content: string;
+    readonly expectedVersion: string;
+} | {
+    readonly bundleId: string;
+    readonly content: string;
+    readonly expectAbsent: true;
+};
+/** A root the transport will not send, and why: over the request bound, or content the host refuses outright. */
+export declare class RootWriteInputError extends Error {
+    readonly name = "RootWriteInputError";
+    readonly code: "too_large" | "invalid_input";
+    constructor(code: "too_large" | "invalid_input", message: string);
+}
+/**
+ * The request a root write sends, and its encoded body, refused before anything leaves when the
+ * host could only refuse it: a leading byte-order mark or text that is not well formed (the host's
+ * version and the client's digest of it could then differ), or a body over the request bound.
+ */
+export declare function rootWriteRequest(bundleId: string, content: string, base: string | null): {
+    payload: RootWritePayload;
+    body: string;
+    bytes: number;
+};
+/**
+ * One root write's outcome. `committed` names the version stored (the digest of the bytes sent).
+ * `conflict` is a stale base (`version_conflict`, or `document_exists` for a create that found a
+ * root), with the host's version when it said. `refused` applied nothing and is final;
+ * `authorization` is set when the refusal is about the caller, not the content. `unknown` may
+ * have landed: resolve it with {@link rootLanding}.
+ */
+export type RootWriteOutcome = {
+    readonly kind: "committed";
+    readonly version: string;
+    readonly changed: boolean;
+} | {
+    readonly kind: "conflict";
+    readonly current?: string;
+} | {
+    readonly kind: "refused";
+    readonly code: string;
+    readonly message: string;
+    readonly authorization?: AuthorizationCode;
+    /** The host refused the request itself as malformed (`400`): nothing about the content. */
+    readonly malformed?: true;
+} | {
+    readonly kind: "unknown";
+};
+/**
+ * The outcome one root write's answer stands for. The refusal rows are the identified writes'
+ * ({@link updateRow}), read without an identity: a refusal that says `not_applied` is final, and
+ * anything the host may have applied without saying so is unknown.
+ */
+export declare function classifyRootAnswer(answer: Pick<HostedAnswer, "status" | "body">, expected: {
+    bundleId: string;
+    sent: string;
+}): RootWriteOutcome;
+/** The refusal codes of a root write that say only that the host was busy: the next sync sends it again. */
+export declare const ROOT_BUSY_CODES: ReadonlySet<string>;
+export interface RootWriteOptions {
+    carrier: HostedCarrier;
+    /** The root route, e.g. `/sync/v1/root`. */
+    route: string;
+    bundleId: string;
+    /** The checkout's binding (`X-Superbee-Checkout`). */
+    binding: string;
+    /** The agent the client runs under (`X-Superbee-Via`); a token {@link isAgentLabelVia} admits. */
+    via?: string;
+    content: string;
+    /** The root version the content replaces, or null to create a root the bundle lacks. */
+    base: string | null;
+    signal?: AbortSignal;
+}
+/**
+ * Send one root write and classify its answer. Content the host would refuse outright is refused
+ * here without sending ({@link rootWriteRequest}). Never sends a request identity.
+ */
+export declare function sendRootWrite(options: RootWriteOptions): Promise<RootWriteOutcome>;
+/**
+ * Whether a root write whose answer was lost landed, from the root version the host serves now
+ * (`null`: no root): the digest of the bytes sent means it landed, its base means it did not, and
+ * anything else is a conflict (another write moved the root).
+ */
+export declare function rootLanding(current: string | null, sent: string, base: string | null): "landed" | "not_landed" | "conflict";
+//# sourceMappingURL=root-write.d.ts.map

package/dist/hosted-transport/root-write.d.ts.map

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

package/dist/hosted-transport/root-write.js

@@ -0,0 +1,171 @@
+/**
+ * The bundle's front page: one write that replaces the root `index.md` (`bundles.root.replace.v1`,
+ * `POST <sync prefix>/root`), compare-and-swap on the root's version or on its absence.
+ *
+ * It is not an identified write. It carries no `X-Superbee-Write-Request`, the host keeps no
+ * receipt of it, and there is no outcome lookup. A root version is the SHA-256 of its exact UTF-8
+ * bytes, so a client that lost the answer re-reads the root's version from the capabilities answer
+ * instead ({@link rootLanding}): the digest of what it sent means the write landed, its base means
+ * it did not, and anything else is a conflict. The window this leaves (the root returning to the
+ * same old bytes in between) is accepted for a front page.
+ *
+ * The refusal envelope is the write schema's, read by the same parser as a document write's; only
+ * the success differs, since it names the bundle and no document.
+ */
+import { sha256HexOfUtf8 } from "../sha256.js";
+import { isContentVersion } from "../version-transport.js";
+import { parseWriteResult, updateRow } from "./answer-rows.js";
+import { HostedCarrierError, isAgentLabelVia } from "./carrier.js";
+import { WHOLE_DOCUMENT_BOUNDS } from "./whole-document-transport.js";
+export const ROOT_OPERATION_ID = "bundles.root.replace.v1";
+export const ROOT_WRITE_BOUNDS = Object.freeze({
+    /** The request ceiling, measured on the encoded JSON body: the same bound as every sync write. */
+    payloadBytes: WHOLE_DOCUMENT_BOUNDS.payloadBytes,
+    /** The answer is a bounded result envelope. */
+    answerBytes: WHOLE_DOCUMENT_BOUNDS.answerBytes,
+});
+/** The root's version as the host computes it: `sha256:` and the hex SHA-256 of the UTF-8 bytes. */
+export function rootVersionOf(content) {
+    return `sha256:${sha256HexOfUtf8(content)}`;
+}
+/** A root the transport will not send, and why: over the request bound, or content the host refuses outright. */
+export class RootWriteInputError extends Error {
+    name = "RootWriteInputError";
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/;
+const encoder = new TextEncoder();
+/**
+ * The request a root write sends, and its encoded body, refused before anything leaves when the
+ * host could only refuse it: a leading byte-order mark or text that is not well formed (the host's
+ * version and the client's digest of it could then differ), or a body over the request bound.
+ */
+export function rootWriteRequest(bundleId, content, base) {
+    if (base !== null && !isContentVersion(base))
+        throw new RootWriteInputError("invalid_input", "the root's base is not a version");
+    if (content.startsWith(""))
+        throw new RootWriteInputError("invalid_input", "the root index starts with a byte-order mark, which the host refuses");
+    if (LONE_SURROGATE.test(content))
+        throw new RootWriteInputError("invalid_input", "the root index is not well-formed text");
+    const payload = base === null ? { bundleId, content, expectAbsent: true } : { bundleId, content, expectedVersion: base };
+    const body = JSON.stringify(payload);
+    const bytes = encoder.encode(body).byteLength;
+    if (bytes > ROOT_WRITE_BOUNDS.payloadBytes)
+        throw new RootWriteInputError("too_large", `the root index is over the ${ROOT_WRITE_BOUNDS.payloadBytes / 1024} KiB a sync write carries (${bytes} bytes as a request)`);
+    return { payload, body, bytes };
+}
+const UNKNOWN = Object.freeze({ kind: "unknown" });
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** A root write's `200` success, admitted only for this bundle, a content version and a boolean `changed`. */
+function rootSuccess(body, bundleId) {
+    if (!isRecord(body) || body.ok !== true || body.operationId !== ROOT_OPERATION_ID || body.error !== undefined)
+        return null;
+    const data = body.data;
+    if (!isRecord(data) || !Object.keys(data).every((key) => key === "bundleId" || key === "version" || key === "changed"))
+        return null;
+    if (data.bundleId !== bundleId || !isContentVersion(data.version) || typeof data.changed !== "boolean")
+        return null;
+    return { version: data.version, changed: data.changed };
+}
+/** The authorization code the identified writes' row for a `200` refusal carries, if any. */
+function authorizationOf(code) {
+    try {
+        return updateRow(`200 ${code}`).code;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The outcome one root write's answer stands for. The refusal rows are the identified writes'
+ * ({@link updateRow}), read without an identity: a refusal that says `not_applied` is final, and
+ * anything the host may have applied without saying so is unknown.
+ */
+export function classifyRootAnswer(answer, expected) {
+    const { status, body } = answer;
+    const error = isRecord(body) && isRecord(body.error) ? body.error : undefined;
+    const notApplied = error?.writeState === "not_applied";
+    if (status === 200) {
+        if (isRecord(body) && body.ok === true) {
+            const success = rootSuccess(body, expected.bundleId);
+            // A success naming other bytes than those sent is not evidence about this request.
+            return success && success.version === expected.sent ? { kind: "committed", ...success } : UNKNOWN;
+        }
+        let failure;
+        try {
+            failure = parseWriteResult(body, { operationIds: [ROOT_OPERATION_ID], documentId: "index.md", bundleId: expected.bundleId });
+        }
+        catch {
+            return UNKNOWN;
+        }
+        if (failure.ok || failure.error.writeState !== "not_applied")
+            return UNKNOWN;
+        const { code, message, currentVersion } = failure.error;
+        if (code === "version_conflict" || code === "document_exists")
+            return { kind: "conflict", ...(currentVersion !== undefined ? { current: currentVersion } : {}) };
+        const authorization = authorizationOf(code);
+        return { kind: "refused", code, message, ...(authorization ? { authorization } : {}) };
+    }
+    // A malformed binding or body: the host read nothing, and the same request can only repeat it.
+    if (status === 400)
+        return { kind: "refused", code: typeof error?.code === "string" ? error.code : "invalid_input", message: typeof error?.message === "string" ? error.message : "The host refused the request as malformed; nothing was written.", malformed: true };
+    if (status === 401)
+        return notApplied ? { kind: "refused", code: "AUTH_REQUIRED", message: "The hosted session ended; the front page was not sent.", authorization: "AUTH_REQUIRED" } : UNKNOWN;
+    // As the identified writes' `403` row: access withdrawn, which signing in again cannot fix.
+    if (status === 403)
+        return { kind: "refused", code: "access_withdrawn", message: "The host denied access to this bundle.", authorization: "AUTH_REQUIRED" };
+    if (status === 503 && notApplied)
+        return { kind: "refused", code: typeof error?.code === "string" ? error.code : "backend_unavailable", message: typeof error?.message === "string" ? error.message : "The host was unavailable; nothing was written." };
+    return UNKNOWN;
+}
+/** The refusal codes of a root write that say only that the host was busy: the next sync sends it again. */
+export const ROOT_BUSY_CODES = new Set(["backend_unavailable", "concurrent_change", "internal_error", "deadline_exceeded", "cancelled"]);
+/**
+ * Send one root write and classify its answer. Content the host would refuse outright is refused
+ * here without sending ({@link rootWriteRequest}). Never sends a request identity.
+ */
+export async function sendRootWrite(options) {
+    if (options.via !== undefined && !isAgentLabelVia(options.via))
+        throw new TypeError("the via token is not one the host admits");
+    let request;
+    try {
+        request = rootWriteRequest(options.bundleId, options.content, options.base);
+    }
+    catch (error) {
+        if (error instanceof RootWriteInputError)
+            return { kind: "refused", code: error.code, message: `${error.message}; it was not sent.` };
+        throw error;
+    }
+    let answer;
+    try {
+        answer = await options.carrier.json(options.route, request.payload, options.signal ?? new AbortController().signal, {
+            maximum: ROOT_WRITE_BOUNDS.answerBytes,
+            binding: options.binding,
+            ...(options.via !== undefined ? { via: options.via } : {}),
+        });
+    }
+    catch (error) {
+        // A credential that was already gone sent nothing; anything else may have left.
+        if (error instanceof HostedCarrierError && error.code === "denied")
+            return { kind: "refused", code: "AUTH_REQUIRED", message: "No credential was available; the front page was not sent.", authorization: "AUTH_REQUIRED" };
+        return UNKNOWN;
+    }
+    return classifyRootAnswer(answer, { bundleId: options.bundleId, sent: rootVersionOf(options.content) });
+}
+/**
+ * Whether a root write whose answer was lost landed, from the root version the host serves now
+ * (`null`: no root): the digest of the bytes sent means it landed, its base means it did not, and
+ * anything else is a conflict (another write moved the root).
+ */
+export function rootLanding(current, sent, base) {
+    if (current === sent)
+        return "landed";
+    if (current === base)
+        return "not_landed";
+    return "conflict";
+}
+//# sourceMappingURL=root-write.js.map

package/dist/hosted-transport/root-write.js.map

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

package/dist/hosted-transport/whole-document-transport.d.ts

@@ -0,0 +1,204 @@
+/**
+ * The sync delivery side: an {@link OperationTransport} that pushes one whole document per
+ * request. The intent's kind names the operation and its base must agree with it
+ * ({@link WHOLE_DOCUMENT_INTENT_KINDS}): a create (`documents.create.v1`, create-only) has no
+ * base, a replace (`documents.replace.v1`) is against exactly the intent's base, and a delete
+ * (`documents.delete.v1`) removes the document at exactly the intent's base, so the host's
+ * compare-and-swap decides every concurrent change to one document and never merges it. Any other
+ * kind (a body update) or a kind its base contradicts is refused before anything is sent, and
+ * never mapped to another operation. The managed fields the host owns are stripped before
+ * sending; the host carries them from the stored document. The one exception is a bundle's
+ * creation ({@link WholeDocumentRequestOptions.mode} `import`), where nothing is stored yet.
+ *
+ * A deleted document leaves a tombstone on the host. A create of that id is refused as a
+ * `version_conflict` naming the tombstone unless it acknowledges exactly the id's latest one
+ * (`X-Superbee-Recreate`), and the refusal comes back as the "deleted remotely" conflict carrying
+ * the tombstone (`{ kind: "conflict", actual: null, tombstone }`). The acknowledgement is sent
+ * only when the intent says so ({@link OperationIntent.recreates}); a stale one is refused again
+ * and comes back as a fresh conflict naming the newer tombstone, never as last-writer-wins.
+ *
+ * Every answer is mapped by the shared rows in `answer-rows.ts`, with one difference a
+ * create-only write needs: `document_exists` is a conflict against the served head, because a
+ * create that finds the document is exactly a compare-and-swap mismatch on absence.
+ *
+ * The committed version comes from the host's recorded result, and the host stores its own
+ * serialization (with managed fields), so a committed version is not the intent's `local`
+ * version. Deliver with `settlement: "recorded-only"` ({@link WHOLE_DOCUMENT_SETTLEMENT}) so a
+ * conflict is never read as a commit by comparing versions.
+ *
+ * `OperationTransport.lookup` names only a request identity, and the host's outcome route takes
+ * the same body as the write it identifies, so the transport reads the intent back from the
+ * journal (`intentFor`) to rebuild it.
+ */
+import type { Frontmatter, Version } from "../types.js";
+import { type OperationIntent, type OperationTransport, type UncertainWriteOptions } from "../uncertain-write.js";
+import { DELETE_OPERATION_ID } from "./answer-rows.js";
+import { type HostedCarrier } from "./carrier.js";
+import { type HostedReadAdapter } from "./read-adapter.js";
+/** Frontmatter the host owns; no caller may set it, and the host carries it from the stored document. */
+export declare const HOSTED_MANAGED_FIELDS: ReadonlySet<string>;
+/**
+ * The managed fields a bundle's creation carries as the folder states them: provenance a local
+ * engine stored, which nothing on the host could restore later, so a bundle moved to the host
+ * reads as it did. Each is the folder's claim, not authority: `generated` and
+ * `superbee_updated_by` say who produced and last wrote the content (the host shows either as
+ * attribution, never as an authorization input), and `verified` events are the checks the folder
+ * records, which the host has no path to write again. The host's own record of the creation is its
+ * history row, which names the person who published; every later write through the host stamps
+ * `superbee_updated_by` itself and carries `verified` from the stored document. A field outside
+ * this list ({@link IMPORT_DROPPED_FIELDS}) never leaves.
+ */
+export declare const IMPORT_CARRIED_FIELDS: readonly string[];
+/** The managed fields a creation drops: none today; a managed field added later stays behind until it is named above. */
+export declare const IMPORT_DROPPED_FIELDS: readonly string[];
+/** The most frontmatter fields the kernel accepts on a create or replace. */
+export declare const FRONTMATTER_KEY_LIMIT = 32;
+/** The settlement mode a whole-document delivery must use. */
+export declare const WHOLE_DOCUMENT_SETTLEMENT: NonNullable<UncertainWriteOptions["settlement"]>;
+export declare const WHOLE_DOCUMENT_BOUNDS: Readonly<{
+    /**
+     * The write routes' request ceiling on a host that states none (`limits.documentInputBytes`); a
+     * larger payload is refused here before it leaves. A host that states its bound is held to that.
+     */
+    payloadBytes: 65536;
+    /** A write answer is a bounded result envelope. */
+    answerBytes: 65536;
+    /** An outcome answer carries the committed document as base64 under this envelope ceiling. */
+    outcomeAnswerBytes: number;
+}>;
+/**
+ * The whole-document write bound current hosts state (`limits.documentInputBytes`, 983,040 bytes:
+ * 1 MiB less a 64 KiB margin). A client plans against it only before it has asked the host, and
+ * holds a request to what the host actually states.
+ */
+export declare const CURRENT_HOST_DOCUMENT_INPUT_BYTES = 983040;
+export interface WholeDocumentRoutes {
+    create: string;
+    replace: string;
+    delete: string;
+    outcome: string;
+}
+export declare const SYNC_WRITE_ROUTES: WholeDocumentRoutes;
+/**
+ * The exact kernel input one intent becomes, and the route and operation it goes to. A create
+ * that re-creates a deleted document carries the tombstone it acknowledges in `recreates`, which
+ * rides the `X-Superbee-Recreate` header, never the body.
+ */
+export type WholeDocumentRequest = {
+    kind: "create";
+    operationId: "documents.create.v1";
+    payload: {
+        bundleId: string;
+        documentId: string;
+        expectAbsent: true;
+        frontmatter: Frontmatter;
+        body: string;
+    };
+    recreates?: Version;
+    /** An `import` request only: the managed fields the document held, carried and dropped. */
+    provenance?: {
+        carried: string[];
+        dropped: string[];
+    };
+} | {
+    kind: "replace";
+    operationId: "documents.replace.v1";
+    payload: {
+        bundleId: string;
+        documentId: string;
+        expectedVersion: Version;
+        frontmatter: Frontmatter;
+        body: string;
+    };
+} | {
+    kind: "delete";
+    operationId: typeof DELETE_OPERATION_ID;
+    payload: {
+        bundleId: string;
+        documentId: string;
+        expectedVersion: Version;
+    };
+};
+/**
+ * The intent kinds this transport sends, each with the base it requires. `document.write` is the
+ * working-copy engine's whole-document write, a create exactly when it has no base.
+ * `document.delete` removes the document at exactly its base, so it requires one. Every other
+ * kind is unsupported: it is refused without sending, never routed by its base.
+ */
+export declare const WHOLE_DOCUMENT_INTENT_KINDS: Readonly<Record<string, "create" | "replace" | "delete" | "by-base">>;
+/**
+ * An intent the transport will not send, and why: the answer a `refused` outcome carries.
+ * `unsupported_operation` is an intent kind this transport does not send, or one its base
+ * contradicts; `invalid_input` is a document the host would refuse.
+ */
+export declare class WholeDocumentInputError extends Error {
+    readonly name = "WholeDocumentInputError";
+    readonly code: "invalid_input" | "unsupported_operation";
+    constructor(message: string, code?: "invalid_input" | "unsupported_operation");
+}
+export interface WholeDocumentRequestOptions {
+    /**
+     * `write` (the default): every managed field is removed, as every write to an existing bundle
+     * needs. `import`: the document is part of a bundle's creation, where the host stores what it
+     * is sent and holds nothing to carry managed fields from, so {@link IMPORT_CARRIED_FIELDS}
+     * travel as the folder states them and {@link IMPORT_DROPPED_FIELDS} are removed. Only a create
+     * may be an import; any other operation is refused.
+     */
+    mode?: "write" | "import";
+}
+/**
+ * The request an intent becomes: the serialized document parsed under the bundle's edition,
+ * managed fields removed (for an `import`, the dropped ones), a create or a replace against
+ * `base` as its kind names. The kind is checked first, so an unsupported kind is refused before
+ * its content is read. A document whose frontmatter is not plain JSON (a date object, say) is
+ * refused here, because sending it would change what it says.
+ */
+export declare function wholeDocumentRequest(bundleId: string, intent: Pick<OperationIntent, "kind" | "target" | "base" | "content" | "recreates">, okfVersion?: string, options?: WholeDocumentRequestOptions): WholeDocumentRequest;
+export interface WholeDocumentTransportOptions {
+    carrier: HostedCarrier;
+    bundleId: string;
+    /** The checkout's binding, pinned on every write and lookup; the outcome answer must name it. */
+    binding: string;
+    /** The intent a request identity names, from the journal; the lookup rebuilds its request from it. */
+    intentFor(requestId: string): Promise<OperationIntent | undefined>;
+    /** The served head after a conflict without a current version, and the retention window. */
+    remote: Pick<HostedReadAdapter, "read" | "operationsRetentionMs">;
+    routes?: WholeDocumentRoutes;
+    /** The bundle's edition, for parsing an intent's serialized frontmatter. */
+    okfVersion?: string;
+    /** Ends every request in flight. */
+    signal?: AbortSignal;
+    now?: () => number;
+    /**
+     * The agent the client runs under (`X-Superbee-Via`), sent on every write and its lookup. It
+     * must be a token {@link isAgentLabelVia} admits: the transport refuses to be built otherwise.
+     */
+    via?: string;
+    /**
+     * The person's typed acknowledgment of the host's mass-delete hold (`X-Superbee-Accept-Deletes`),
+     * sent on every delete write of this transport and on nothing else. Set it only after the person
+     * confirmed that many deletions in their own terminal; never from an agent's decision.
+     */
+    acceptDeletes?: number;
+    /**
+     * The host's whole-document write bound as its capabilities answer states it
+     * (`documentInputBytes`), in bytes of the request's JSON. Absent or null: the host states none,
+     * and {@link WHOLE_DOCUMENT_BOUNDS}`.payloadBytes` applies.
+     */
+    documentInputBytes?: number | null;
+    /**
+     * Told of each delete the host's mass-delete hold refused (`428 deletions_held`), with the
+     * bundle's counts. The intent is settled `refused` with {@link DELETIONS_HELD_REFUSAL_CODE},
+     * which never pauses the store: it stays until a person accepts or restores it.
+     */
+    onDeletionsHeld?: (held: {
+        requestId: string;
+        target: string;
+        deletions: number;
+        baseline: number;
+    }) => void;
+}
+export declare function createWholeDocumentTransport(options: WholeDocumentTransportOptions): OperationTransport & {
+    readonly settlement: typeof WHOLE_DOCUMENT_SETTLEMENT;
+};
+//# sourceMappingURL=whole-document-transport.d.ts.map

package/dist/hosted-transport/whole-document-transport.d.ts.map

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