@superbee/core 0.2.0-pre.14 → 0.2.0-pre.16

package/dist/hosted-client/node.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `@superbee/core/hosted-client/node`: the hosted client's Node-only half, a supported public API
+ * under core's normal versioning. It downloads a hosted bundle's portable export
+ * (`<prefix>/export`) and verifies it with `@superbee/core/portable-export`, whose digests and
+ * file placement need Node, so it is kept off the browser-safe `@superbee/core/hosted-client`.
+ *
+ * The result is a verified export or a typed failure, never files: a stopped, tampered or
+ * oversized export is refused before anything is returned, and placing the verified entries is
+ * the caller's (`materializeExport`, or its own staging).
+ */
+import { type VerifiedExport } from "../portable-export.js";
+import type { HostedClient } from "./client.js";
+export { ExportArchiveError, MAX_EXPORT_BYTES, type VerifiedExport } from "../portable-export.js";
+/**
+ * The host's export window: an export (or one page of a paged one) is answered within 60 s. A
+ * client that downloads exports should be created with at least this `deadlineMs`; the default
+ * 15 s read deadline would cut a large bundle.
+ */
+export declare const EXPORT_WINDOW_MS = 60000;
+/**
+ * Why a download was refused, apart from the host's refusals and the verifier's:
+ * `stopped` — the answer's body failed part way (the network, or the carrier's idle deadline), so
+ * the same request may succeed; `too_large` — the answer ran past what an export carries
+ * ({@link MAX_EXPORT_BYTES} in all); `source_changed` — the bundle kept changing between the pages
+ * of a paged export, every attempt.
+ */
+export type HostedExportProblem = "stopped" | "too_large" | "source_changed";
+export declare class HostedExportError extends Error {
+    readonly name = "HostedExportError";
+    readonly problem: HostedExportProblem;
+    readonly bundleId: string;
+    /** With `too_large`: the bound the answer ran past, in bytes. */
+    readonly maximum?: number;
+    constructor(problem: HostedExportProblem, bundleId: string, message: string, options?: {
+        cause?: unknown;
+        maximum?: number;
+    });
+}
+/** True when `error` is a {@link HostedExportError}, with `problem` when one is named. */
+export declare function isHostedExportError(error: unknown, problem?: HostedExportProblem): error is HostedExportError;
+export interface DownloadExportOptions {
+    /** Aborting it stops the download; it is thrown as the signal's reason. The client's own signal applies too. */
+    readonly signal?: AbortSignal;
+}
+/** What a download needs of a client: its carrier, its sync prefix and its signal. A `within` client qualifies the bundle. */
+export type HostedExportClient = Pick<HostedClient, "carrier" | "prefix" | "signal">;
+/**
+ * The verified portable export of `bundleId` at its latest confirmed revision: every document,
+ * reserved file and blob, byte for byte, read whole and checked against the host's digest
+ * manifests before it is returned.
+ *
+ * A host that pages the export answers it a page at a time; each page is verified as it arrives,
+ * checked against the pages before it, and the pages are joined (`ExportPageChain`). A host from
+ * before paging refuses the paged request as `invalid_input`, and the whole bundle is then read as
+ * one archive. A bundle that changes between pages (`concurrent_change`) is read again from its
+ * first page, up to three attempts. A page the host was too busy for (`backend_unavailable`, its
+ * one export slot) or stopped part way is asked for once more.
+ *
+ * Failures are typed:
+ * - `HostedCarrierError` — transport (the request may not have been answered);
+ * - `HostedRouteNotServed` — a host from before the export route;
+ * - `RemoteError` — the host's refusal, with its code and status (`bundle_not_found`,
+ *   `result_too_large`, `validation_failed`, `unauthenticated` and so on);
+ * - `ExportArchiveError` — the verifier refused the archive (`incomplete` when the host stopped it);
+ * - {@link HostedExportError} — the answer stopped part way, ran past {@link MAX_EXPORT_BYTES}, or
+ *   the bundle kept changing;
+ * - the signal's reason, once `options.signal` or the client's signal aborts.
+ */
+export declare function downloadExport(client: HostedExportClient, bundleId: string, options?: DownloadExportOptions): Promise<VerifiedExport>;
+//# sourceMappingURL=node.d.ts.map

package/dist/hosted-client/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/hosted-client/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAElG;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAS,CAAC;AASvC;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE7E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAkB,IAAI,uBAAuB;IAC7C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBACd,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;CAMjI;AAED,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,KAAK,IAAI,iBAAiB,CAE7G;AAED,MAAM,WAAW,qBAAqB;IACpC,gHAAgH;IAChH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,8HAA8H;AAC9H,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,cAAc,CAAC,CA4C/I"}

package/dist/hosted-client/node.js

@@ -0,0 +1,214 @@
+/**
+ * `@superbee/core/hosted-client/node`: the hosted client's Node-only half, a supported public API
+ * under core's normal versioning. It downloads a hosted bundle's portable export
+ * (`<prefix>/export`) and verifies it with `@superbee/core/portable-export`, whose digests and
+ * file placement need Node, so it is kept off the browser-safe `@superbee/core/hosted-client`.
+ *
+ * The result is a verified export or a typed failure, never files: a stopped, tampered or
+ * oversized export is refused before anything is returned, and placing the verified entries is
+ * the caller's (`materializeExport`, or its own staging).
+ */
+import { ExportArchiveError, ExportPageChain, MAX_EXPORT_BYTES, verifyExport, } from "../portable-export.js";
+import { RemoteError } from "../remote-error.js";
+import { HostedRouteNotServed } from "./errors.js";
+export { ExportArchiveError, MAX_EXPORT_BYTES } from "../portable-export.js";
+/**
+ * The host's export window: an export (or one page of a paged one) is answered within 60 s. A
+ * client that downloads exports should be created with at least this `deadlineMs`; the default
+ * 15 s read deadline would cut a large bundle.
+ */
+export const EXPORT_WINDOW_MS = 60_000;
+/** How many times a paged export starts again from its first page when the bundle moves under it. */
+const PAGED_EXPORT_ATTEMPTS = 3;
+/** The pause before each restart, so a burst of writes can settle (with jitter). */
+const PAGED_EXPORT_RESTART_MS = [500, 1500];
+/** The pause before asking for a page again after a busy host or a page it stopped part way. */
+const PAGE_RETRY_MS = 1000;
+export class HostedExportError extends Error {
+    name = "HostedExportError";
+    problem;
+    bundleId;
+    /** With `too_large`: the bound the answer ran past, in bytes. */
+    maximum;
+    constructor(problem, bundleId, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.problem = problem;
+        this.bundleId = bundleId;
+        if (options.maximum !== undefined)
+            this.maximum = options.maximum;
+    }
+}
+/** True when `error` is a {@link HostedExportError}, with `problem` when one is named. */
+export function isHostedExportError(error, problem) {
+    return error instanceof HostedExportError && (problem === undefined || error.problem === problem);
+}
+/**
+ * The verified portable export of `bundleId` at its latest confirmed revision: every document,
+ * reserved file and blob, byte for byte, read whole and checked against the host's digest
+ * manifests before it is returned.
+ *
+ * A host that pages the export answers it a page at a time; each page is verified as it arrives,
+ * checked against the pages before it, and the pages are joined (`ExportPageChain`). A host from
+ * before paging refuses the paged request as `invalid_input`, and the whole bundle is then read as
+ * one archive. A bundle that changes between pages (`concurrent_change`) is read again from its
+ * first page, up to three attempts. A page the host was too busy for (`backend_unavailable`, its
+ * one export slot) or stopped part way is asked for once more.
+ *
+ * Failures are typed:
+ * - `HostedCarrierError` — transport (the request may not have been answered);
+ * - `HostedRouteNotServed` — a host from before the export route;
+ * - `RemoteError` — the host's refusal, with its code and status (`bundle_not_found`,
+ *   `result_too_large`, `validation_failed`, `unauthenticated` and so on);
+ * - `ExportArchiveError` — the verifier refused the archive (`incomplete` when the host stopped it);
+ * - {@link HostedExportError} — the answer stopped part way, ran past {@link MAX_EXPORT_BYTES}, or
+ *   the bundle kept changing;
+ * - the signal's reason, once `options.signal` or the client's signal aborts.
+ */
+export async function downloadExport(client, bundleId, options = {}) {
+    if (typeof bundleId !== "string" || bundleId === "")
+        throw new TypeError("an export names its bundle");
+    const signal = options.signal ? AbortSignal.any([client.signal, options.signal]) : client.signal;
+    const download = { client, bundleId, signal, route: `${client.prefix}/export` };
+    signal.throwIfAborted();
+    for (let attempt = 1;; attempt += 1) {
+        const chain = new ExportPageChain();
+        let bytes = 0;
+        let cursor;
+        let moved = false;
+        for (;;) {
+            let page;
+            for (let tries = 1; page === undefined; tries += 1) {
+                const answer = await exportAnswer(download, { bundleId, paged: true, ...(cursor !== undefined ? { cursor } : {}) });
+                // Only the very first request can meet a host from before paging.
+                if (answer.refused === "invalid_input" && cursor === undefined && attempt === 1)
+                    return await wholeExport(download);
+                if (answer.refused === "concurrent_change") {
+                    moved = true;
+                    break;
+                }
+                try {
+                    if (answer.refused !== undefined)
+                        throw refusal(download, answer);
+                    page = verifyExport(await readArchive(download, answer.ok, MAX_EXPORT_BYTES - bytes), bundleId, { paged: true });
+                }
+                catch (error) {
+                    signal.throwIfAborted();
+                    const again = isHostedExportError(error, "stopped") ||
+                        (error instanceof ExportArchiveError && error.problem === "incomplete") ||
+                        (answer.refused === "backend_unavailable" && answer.status >= 500);
+                    if (!again || tries >= 2)
+                        throw error;
+                    await pause(PAGE_RETRY_MS, signal);
+                }
+            }
+            if (moved)
+                break;
+            bytes += page.bytes;
+            cursor = chain.add(page);
+            if (cursor === undefined)
+                return chain.joined();
+        }
+        if (attempt >= PAGED_EXPORT_ATTEMPTS) {
+            throw new HostedExportError("source_changed", bundleId, `'${bundleId}' kept changing while it was exported (${attempt} attempts)`);
+        }
+        const base = PAGED_EXPORT_RESTART_MS[attempt - 1];
+        await pause(Math.round(base / 2 + (Math.random() * base) / 2), signal);
+    }
+}
+/** One export request's answer: the archive's body, or the refusal code the host answered. */
+async function exportAnswer({ client, signal, route }, input) {
+    signal.throwIfAborted();
+    let answer;
+    try {
+        answer = await client.carrier.stream(route, input, signal);
+    }
+    catch (error) {
+        signal.throwIfAborted();
+        throw error;
+    }
+    if (!answer.ok)
+        return { refused: refusalCode(answer.body) ?? "RUNTIME", status: answer.status, body: answer.body };
+    return { ok: answer.body };
+}
+/** The whole bundle as one archive (a host from before paged export). */
+async function wholeExport(download) {
+    const answer = await exportAnswer(download, { bundleId: download.bundleId });
+    if (answer.refused !== undefined)
+        throw refusal(download, answer);
+    return verifyExport(await readArchive(download, answer.ok, MAX_EXPORT_BYTES), download.bundleId);
+}
+function refusalCode(body) {
+    const error = body?.error;
+    if (typeof error === "string")
+        return error;
+    const code = error?.code;
+    return typeof code === "string" ? code : undefined;
+}
+/** The typed error a refused export is: the family's unknown-route answer, or the host's refusal. */
+function refusal({ route }, answer) {
+    if (answer.status === 404 && isUnknownRoute(answer.body))
+        return new HostedRouteNotServed(route);
+    return new RemoteError(`hosted export answered ${answer.status}`, answer.refused, answer.status);
+}
+/** The sync family's answer to a route it does not have: `404 {"error":"not_found"}`, nothing else. */
+function isUnknownRoute(body) {
+    return typeof body === "object" && body !== null && !Array.isArray(body) && Object.keys(body).length === 1 && body.error === "not_found";
+}
+/** One archive's body, read whole and bounded by `budget` (what the export may still hold). */
+async function readArchive({ bundleId, signal }, body, budget) {
+    const reader = body.getReader();
+    const chunks = [];
+    let size = 0;
+    const onAbort = () => void reader.cancel(signal.reason).catch(() => { });
+    signal.addEventListener("abort", onAbort, { once: true });
+    try {
+        for (;;) {
+            let part;
+            try {
+                part = await reader.read();
+            }
+            catch (cause) {
+                signal.throwIfAborted();
+                throw new HostedExportError("stopped", bundleId, `the export of '${bundleId}' stopped part way`, { cause });
+            }
+            signal.throwIfAborted();
+            if (part.done)
+                break;
+            size += part.value.byteLength;
+            if (size > budget) {
+                throw new HostedExportError("too_large", bundleId, `the export of '${bundleId}' is larger than ${MAX_EXPORT_BYTES} bytes`, { maximum: MAX_EXPORT_BYTES });
+            }
+            chunks.push(part.value);
+        }
+    }
+    finally {
+        signal.removeEventListener("abort", onAbort);
+        void reader.cancel().catch(() => { });
+    }
+    const archive = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        archive.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return archive;
+}
+/** A pause the signal cuts short (its reason thrown), leaving no timer behind either way. */
+function pause(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=node.js.map

package/dist/hosted-client/node.js.map

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

package/dist/hosted-client/reference.d.ts

@@ -0,0 +1,12 @@
+/** True for a workspace slug as the host reports it. */
+export declare function isWorkspaceSlug(value: unknown): value is string;
+export interface HostedBundleReference {
+    /** The workspace the reference names, or null for a bare id. */
+    readonly slug: string | null;
+    readonly bundleId: string;
+}
+/** The reference a string names, or null when it is neither a hosted bundle id nor `<slug>/<id>`. */
+export declare function parseHostedBundleReference(value: string): HostedBundleReference | null;
+/** The reference's spelling: the bare id, or `<slug>/<bundle-id>`. */
+export declare function hostedBundleReferenceText(reference: HostedBundleReference): string;
+//# sourceMappingURL=reference.d.ts.map

package/dist/hosted-client/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/hosted-client/reference.ts"],"names":[],"mappings":"AAYA,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,qGAAqG;AACrG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAOtF;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,qBAAqB,GAAG,MAAM,CAElF"}

package/dist/hosted-client/reference.js

@@ -0,0 +1,29 @@
+// A hosted bundle reference: how a person, a command and the host's bundle list name one hosted
+// bundle. `<bundle-id>` names it when one of the person's workspaces holds that id;
+// `<workspace-slug>/<bundle-id>` names the workspace too, for an id more than one of them holds.
+// The slug is the workspace's own (the first label of its host, as `whoami` reports it), resolved
+// by the host among the person's own workspaces. The bundle id part is held to the one rule
+// `isHostedBundleId` states, so a reference never carries an id a bare one could not.
+import { isHostedBundleId } from "../dependencies.js";
+/** One lowercase DNS label: the host's workspace slug grammar. */
+const SLUG = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+/** True for a workspace slug as the host reports it. */
+export function isWorkspaceSlug(value) {
+    return typeof value === "string" && SLUG.test(value);
+}
+/** The reference a string names, or null when it is neither a hosted bundle id nor `<slug>/<id>`. */
+export function parseHostedBundleReference(value) {
+    const at = value.indexOf("/");
+    const slug = at < 0 ? null : value.slice(0, at);
+    const bundleId = at < 0 ? value : value.slice(at + 1);
+    if (slug !== null && !SLUG.test(slug))
+        return null;
+    if (!isHostedBundleId(bundleId))
+        return null;
+    return { slug, bundleId };
+}
+/** The reference's spelling: the bare id, or `<slug>/<bundle-id>`. */
+export function hostedBundleReferenceText(reference) {
+    return reference.slug === null ? reference.bundleId : `${reference.slug}/${reference.bundleId}`;
+}
+//# sourceMappingURL=reference.js.map

package/dist/hosted-client/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/hosted-client/reference.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,oFAAoF;AACpF,iGAAiG;AACjG,kGAAkG;AAClG,4FAA4F;AAC5F,sFAAsF;AAEtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,kEAAkE;AAClE,MAAM,IAAI,GAAG,wCAAwC,CAAC;AAEtD,wDAAwD;AACxD,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAQD,qGAAqG;AACrG,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,yBAAyB,CAAC,SAAgC;IACxE,OAAO,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;AAClG,CAAC"}

package/dist/hosted-client/write.d.ts

@@ -0,0 +1,191 @@
+import { type HostedCarrier, type HostedCapabilities, type HostedReadAdapter, type HostedReadRoutes, type WriteErrorCode } from "../hosted-transport/index.js";
+import type { Version } from "../types.js";
+import { type OperationState } from "../uncertain-write.js";
+/** What one write asks: a create of an absent document, or a replace at exactly `expectedVersion`. */
+export type HostedWriteInput = {
+    readonly id: string;
+    readonly document: string;
+    readonly expectedVersion: Version;
+    readonly expectAbsent?: never;
+} | {
+    readonly id: string;
+    readonly document: string;
+    readonly expectAbsent: true;
+    readonly expectedVersion?: never;
+};
+export interface HostedWriteOptions {
+    /**
+     * The request identity to send under, a lowercase UUID v4. Default: a fresh one. Pass the
+     * identity of a write this client's intent store holds to confirm it again: the same write
+     * resumes under that identity (nothing new is applied), and a different write is refused.
+     */
+    readonly requestId?: string;
+    /** Ends this write's requests; an abort after sending leaves the outcome unknown. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * A recorded write, everything its outcome lookup needs to rebuild the exact request: the
+ * operation, the bundle (and the workspace it was named in), the document and its digest, the
+ * precondition, the request identity and the binding.
+ */
+export interface HostedWriteIntent {
+    readonly requestId: string;
+    /** The client binding (`X-Superbee-Checkout`) the write and every lookup of it carry. */
+    readonly binding: string;
+    readonly bundleId: string;
+    /** The workspace slug the bundle was named in (`within`), or null. */
+    readonly workspace: string | null;
+    readonly operation: "create" | "replace";
+    readonly documentId: string;
+    /** The whole serialized document, as sent. */
+    readonly document: string;
+    /** `sha256:<hex>` of the document's UTF-8 bytes. */
+    readonly digest: Version;
+    /** The version replaced, or null for a create. */
+    readonly expectedVersion: Version | null;
+    /** The bundle's OKF edition the document was parsed under, or null when the bundle names none. */
+    readonly okfVersion: string | null;
+    /** When the intent was recorded (ISO instant): its age decides whether absence is still evidence. */
+    readonly createdAt: string;
+    /** Submissions made or about to leave; a non-zero count starts any later delivery at the lookup. */
+    readonly attempts: number;
+    readonly state: OperationState;
+}
+/**
+ * Where a client keeps its writes until they settle. The default is in memory
+ * ({@link createMemoryIntentStore}); a service that must recover a write across restarts passes
+ * a durable one. `put` replaces the record under its request identity; a settled write is
+ * deleted, and a write whose outcome is unknown stays for `lookupWrite` and `settleWrite`.
+ * `list`, when the store has it, yields every record it holds, so a service restarting with a
+ * durable store finds its unsettled writes (`heldWrites`).
+ */
+export interface HostedIntentStore {
+    put(intent: HostedWriteIntent): Promise<void> | void;
+    get(requestId: string): Promise<HostedWriteIntent | undefined> | HostedWriteIntent | undefined;
+    delete(requestId: string): Promise<void> | void;
+    list?(): AsyncIterable<HostedWriteIntent>;
+}
+/** An in-memory {@link HostedIntentStore}: records live as long as the store. */
+export declare function createMemoryIntentStore(): HostedIntentStore;
+/** The code of {@link HostedIntentsNotListable}. */
+export declare const INTENTS_NOT_LISTABLE = "INTENTS_NOT_LISTABLE";
+/** `heldWrites` was asked of a client whose intent store has no `list`. */
+export declare class HostedIntentsNotListable extends Error {
+    readonly code = "INTENTS_NOT_LISTABLE";
+    constructor();
+}
+/** A refusal's code: the host's own (`validation_failed`, ...) or one the client names. */
+export type HostedWriteRefusalCode = "AUTH_REQUIRED" | "PERMISSION_DENIED" | "REQUEST_CAPACITY_PRINCIPAL" | "REQUEST_CAPACITY_BUNDLE"
+/** The host serves this bundle no identified writes. */
+ | "read_only" | "unsupported_operation" | WriteErrorCode | (string & {});
+interface WriteResultBase {
+    readonly requestId: string;
+    readonly documentId: string;
+}
+/**
+ * A write's settled answer, or `unknown`. A conflict is final for this request identity: nothing
+ * was written, and a further attempt is the caller's decision, as a new write.
+ */
+export type HostedWriteResult = (WriteResultBase & {
+    readonly status: "committed";
+    readonly version: Version;
+})
+/**
+ * The document is not at the expected version (or, for a create, exists): `currentVersion` is
+ * the version the host serves, or null when it serves none. `tombstone` names the deletion a
+ * create of a deleted id ran into, when the host named one.
+ */
+ | (WriteResultBase & {
+    readonly status: "conflict";
+    readonly reason: "version_conflict";
+    readonly currentVersion: Version | null;
+    readonly tombstone?: Version;
+})
+/** Another write to the bundle overlapped this one past the host's own retries; nothing was applied. */
+ | (WriteResultBase & {
+    readonly status: "conflict";
+    readonly reason: "concurrent_change";
+    readonly message: string;
+}) | (WriteResultBase & {
+    readonly status: "refused";
+    readonly code: HostedWriteRefusalCode;
+    readonly message: string;
+})
+/** The host may or may not hold the write. `lookupWrite` or `settleWrite` asks again later. */
+ | (WriteResultBase & {
+    readonly status: "unknown";
+});
+/**
+ * What `lookupWrite` and `settleWrite` answer: a write's result, or `unrecorded` when the intent
+ * store holds no write under the identity (never recorded, or already settled and deleted).
+ */
+export type HostedWriteLookupResult = HostedWriteResult | {
+    readonly status: "unrecorded";
+    readonly requestId: string;
+};
+/** What a write needs from its client: the carrier for a workspace, the routes and the store. */
+export interface HostedWriteContext {
+    readonly binding: string;
+    readonly store: HostedIntentStore;
+    /** One chain per request identity in flight, shared by a client and its `within` clients. */
+    readonly inFlight: Map<string, Promise<unknown>>;
+    readonly prefix: string;
+    readonly workspace: string | null;
+    readonly signal: AbortSignal;
+    /** The wait between outcome lookups (default 250 ms). */
+    readonly lookupDelayMs?: number;
+    /** Each bundle's capabilities as writes use them, shared by a client and its `within` clients. */
+    readonly capabilities: HostedCapabilitiesCache;
+    carrierFor(workspace: string | null): HostedCarrier;
+    readRoutes: HostedReadRoutes;
+}
+/** The capabilities a write uses, from one answer: the flags and bounds, and the edition its root declares. */
+interface WriteSideAnswer {
+    readonly capabilities: HostedCapabilities;
+    readonly okfVersion: "0.1" | "0.2" | null;
+}
+/**
+ * One bundle's write side: a reader of its own (never the public `reader()`, whose held answer
+ * is checked against heads answers) and its one capabilities answer, in flight or arrived.
+ */
+interface WriteSide {
+    readonly reader: HostedReadAdapter;
+    readonly answer: Promise<WriteSideAnswer>;
+    /** When the answer arrived, by the cache's clock; undefined while it is in flight. */
+    answeredAt: number | undefined;
+}
+/**
+ * Each bundle's write side, keyed by the workspace the bundle is named in and its id, and held
+ * for `ttlMs` after its answer arrives. A `ttlMs` of 0 holds nothing: every write reads anew.
+ */
+export interface HostedCapabilitiesCache {
+    readonly ttlMs: number;
+    readonly now: () => number;
+    readonly entries: Map<string, WriteSide>;
+}
+/** The default time a bundle's capabilities answer serves writes: 60 s. */
+export declare const DEFAULT_CAPABILITIES_TTL_MS = 60000;
+export declare function createCapabilitiesCache(ttlMs?: number, now?: () => number): HostedCapabilitiesCache;
+/** `HostedClient.write`. */
+export declare function hostedWrite(context: HostedWriteContext, bundleId: string, input: HostedWriteInput, options?: HostedWriteOptions): Promise<HostedWriteResult>;
+/**
+ * `HostedClient.lookupWrite`: what the host recorded for a held write, by one outcome lookup under
+ * the identity and binding it was sent with. It never sends the write: a host that holds no
+ * outcome yet (absent or pending), or a lookup that fails, is `unknown`.
+ */
+export declare function hostedLookupWrite(context: HostedWriteContext, requestId: string, options?: {
+    signal?: AbortSignal;
+}): Promise<HostedWriteLookupResult>;
+/**
+ * `HostedClient.settleWrite`: settle a held write. It looks the identity up under the binding it
+ * was sent with; when the host never recorded it (within the retention window it serves), it
+ * delivers that same identity once more, as the write itself would have. An unclear lookup is
+ * `unknown` again. A bundle the host serves no writes for is only looked up.
+ */
+export declare function hostedSettleWrite(context: HostedWriteContext, requestId: string, options?: {
+    signal?: AbortSignal;
+}): Promise<HostedWriteLookupResult>;
+/** `HostedClient.heldWrites`: every write the intent store holds. */
+export declare function hostedHeldWrites(context: HostedWriteContext): Promise<HostedWriteIntent[]>;
+export {};
+//# sourceMappingURL=write.d.ts.map

package/dist/hosted-client/write.d.ts.map

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