@superbee/core 0.2.0-pre.1 → 0.2.0-pre.10

package/dist/remote-document-codec.js

@@ -0,0 +1,103 @@
+import { InvalidInputError } from "./errors.js";
+/** Metadata cannot be represented by the JSON document transport without loss. */
+export class RemoteDocumentValueError extends InvalidInputError {
+    path;
+    constructor(path, reason) {
+        super(`Remote document ${path}: ${reason}. Supply JSON-compatible metadata explicitly.`);
+        this.name = "RemoteDocumentValueError";
+        this.path = path;
+    }
+}
+/** Capture the wire value once, without invoking accessors or custom serialization hooks. */
+export function captureRemoteFrontmatter(frontmatter) {
+    const ancestors = new Set();
+    const refuse = (path, reason) => { throw new RemoteDocumentValueError(path, reason); };
+    const visit = (value, path, depth) => {
+        if (depth > 512)
+            return refuse(path, "metadata nesting exceeds the supported depth");
+        if (value === null || typeof value === "string" || typeof value === "boolean")
+            return value;
+        if (typeof value === "number") {
+            if (!Number.isFinite(value) || Object.is(value, -0))
+                return refuse(path, "number would change during JSON encoding");
+            return value;
+        }
+        if (typeof value !== "object")
+            return refuse(path, `${typeof value} is not a JSON value`);
+        if (ancestors.has(value))
+            return refuse(path, "cyclic metadata cannot be represented in JSON");
+        const prototype = Object.getPrototypeOf(value);
+        const descriptors = Object.getOwnPropertyDescriptors(value);
+        const hook = descriptors.toJSON;
+        if (hook && (!("value" in hook) || typeof hook.value === "function")) {
+            return refuse(`${path}["toJSON"]`, "custom serialization hooks are not supported");
+        }
+        for (const key of Reflect.ownKeys(descriptors)) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (typeof key === "symbol" && descriptor.enumerable)
+                return refuse(path, "enumerable symbol keys would be omitted");
+        }
+        if (prototype === Date.prototype) {
+            if (Object.values(descriptors).some(descriptor => descriptor.enumerable))
+                return refuse(path, "Date properties would be omitted");
+            let instant;
+            try {
+                instant = Date.prototype.getTime.call(value);
+            }
+            catch {
+                return refuse(path, "object has no Date value");
+            }
+            if (!Number.isFinite(instant))
+                return refuse(path, "invalid Date would become null");
+            return Date.prototype.toISOString.call(value);
+        }
+        const array = Array.isArray(value);
+        if (array ? prototype !== Array.prototype && prototype !== null : prototype !== Object.prototype && prototype !== null) {
+            return refuse(path, "only plain records, arrays, and valid Dates are supported");
+        }
+        ancestors.add(value);
+        try {
+            if (array) {
+                const length = value.length;
+                const result = [];
+                // Keep prototype serialization hooks out of the captured payload as well.
+                Object.setPrototypeOf(result, null);
+                for (const key of Object.keys(descriptors)) {
+                    if (descriptors[key].enumerable && !(String(Number(key)) === key && Number.isInteger(Number(key)) && Number(key) >= 0 && Number(key) < length)) {
+                        return refuse(`${path}[${JSON.stringify(key)}]`, "extra array properties would be omitted");
+                    }
+                }
+                for (let index = 0; index < length; index++) {
+                    const descriptor = descriptors[String(index)];
+                    if (!descriptor)
+                        return refuse(`${path}[${index}]`, "array holes would become null");
+                    if (!("value" in descriptor))
+                        return refuse(`${path}[${index}]`, "accessors are not supported");
+                    result[index] = visit(descriptor.value, `${path}[${index}]`, depth + 1);
+                }
+                return result;
+            }
+            const result = Object.create(null);
+            for (const key of Object.keys(descriptors)) {
+                const descriptor = descriptors[key];
+                if (!descriptor.enumerable)
+                    continue;
+                const field = `${path}[${JSON.stringify(key)}]`;
+                if (!("value" in descriptor))
+                    return refuse(field, "accessors are not supported");
+                result[key] = visit(descriptor.value, field, depth + 1);
+            }
+            return result;
+        }
+        finally {
+            ancestors.delete(value);
+        }
+    };
+    return visit(frontmatter, "frontmatter", 0);
+}
+/** Encode only the captured value, never the caller's live metadata a second time. */
+export function encodeRemoteDocument(frontmatter, body) {
+    const payload = Object.assign(Object.create(null), { frontmatter: captureRemoteFrontmatter(frontmatter), body });
+    return JSON.stringify(payload);
+}
+//# sourceMappingURL=remote-document-codec.js.map

package/dist/remote-document-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-document-codec.js","sourceRoot":"","sources":["../src/remote-document-codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,kFAAkF;AAClF,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IACpD,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,mBAAmB,IAAI,KAAK,MAAM,+CAA+C,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAID,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB,CAAC,WAAoB;IAC3D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,MAAc,EAAS,EAAE,GAAG,MAAM,IAAI,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,IAAY,EAAE,KAAa,EAAa,EAAE;QACvE,IAAI,KAAK,GAAG,GAAG;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,8CAA8C,CAAC,CAAC;QACrF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAC,IAAI,EAAE,0CAA0C,CAAC,CAAC;YACrH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,GAAG,OAAO,KAAK,sBAAsB,CAAC,CAAC;QAC1F,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC;QAC/F,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC;QAChC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;YACrE,OAAO,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE,8CAA8C,CAAC,CAAC;QACrF,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAE,CAAC;YAChE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU;gBAAE,OAAO,MAAM,CAAC,IAAI,EAAE,yCAAyC,CAAC,CAAC;QACvH,CAAC;QACD,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,OAAO,MAAM,CAAC,IAAI,EAAE,kCAAkC,CAAC,CAAC;YAClI,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,MAAM,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;YAClD,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,MAAM,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvH,OAAO,MAAM,CAAC,IAAI,EAAE,2DAA2D,CAAC,CAAC;QACnF,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,MAAM,GAAI,KAAmB,CAAC,MAAM,CAAC;gBAC3C,MAAM,MAAM,GAAgB,EAAE,CAAC;gBAC/B,0EAA0E;gBAC1E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACpC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC3C,IAAI,WAAW,CAAC,GAAG,CAAE,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;wBAChJ,OAAO,MAAM,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;oBAC9F,CAAC;gBACH,CAAC;gBACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC9C,IAAI,CAAC,UAAU;wBAAE,OAAO,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,+BAA+B,CAAC,CAAC;oBACrF,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;wBAAE,OAAO,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,6BAA6B,CAAC,CAAC;oBAChG,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC1E,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAiC,CAAC;YACnE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3C,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAE,CAAC;gBACrC,IAAI,CAAC,UAAU,CAAC,UAAU;oBAAE,SAAS;gBACrC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAChD,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;oBAAE,OAAO,MAAM,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;gBAClF,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IACF,OAAO,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,WAAoB,EAAE,IAAY;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,wBAAwB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACjH,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/remote-error.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The typed rejection of the wire client, shared by {@link RemoteBackend} and the heads and
+ * snapshot parsers in `remote-parsers.ts`, which the backend calls; a module of its own so the
+ * two need no import cycle. Runtime-neutral: nothing from Node.
+ */
+/**
+ * A non-2xx wire response that is neither a `404` (ENOENT-shaped) nor a `412`
+ * ({@link VersionConflict}): the generic case, carrying the error envelope's `code` alongside
+ * the raw HTTP `status`, so a caller can distinguish e.g.
+ * `AUTH_REQUIRED` (401, an unauthenticated/misconfigured `--remote`) from `RUNTIME` (5xx, a
+ * genuine server-side bug) instead of both collapsing into a generically-classified `Error`.
+ */
+export declare class RemoteError extends Error {
+    /** The envelope's `code` field, or a status-derived guess when the envelope is missing/unparseable. */
+    readonly code: string;
+    /** The raw HTTP status that produced this error. */
+    readonly status: number;
+    constructor(message: string, code: string, status: number, cause?: unknown);
+}
+/**
+ * The code of an answer the authority produced that the client's contract does not admit. It is
+ * deterministic (the same request gets the same answer), so it is never retried and never read
+ * as truncation or as the host being unavailable. The status stays `502` so a write whose answer
+ * is malformed is still an unknown outcome to the uncertain-write primitive, not a refusal.
+ */
+export declare const MALFORMED_ANSWER = "MALFORMED_ANSWER";
+/** A {@link MALFORMED_ANSWER} rejection, naming the route that answered when the reader knows it. */
+export declare class MalformedAnswer extends RemoteError {
+    route: string | undefined;
+    constructor(message: string, route?: string);
+}
+/** A wire payload the authority produced but the contract does not admit: not retried, not truncation. */
+export declare function malformed(message: string, route?: string): MalformedAnswer;
+/** True when `error` is a {@link MalformedAnswer}. */
+export declare function isMalformedAnswer(error: unknown): error is MalformedAnswer;
+/** Run `read`, naming `route` on a malformed answer it rejects with that does not name one yet. */
+export declare function onRoute<T>(route: string, read: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=remote-error.d.ts.map

package/dist/remote-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-error.d.ts","sourceRoot":"","sources":["../src/remote-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,uGAAuG;IACvG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM3E;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,qGAAqG;AACrG,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI5C;AAED,0GAA0G;AAC1G,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAE1E;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,mGAAmG;AACnG,wBAAsB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOlF"}

package/dist/remote-error.js

@@ -0,0 +1,59 @@
+/**
+ * The typed rejection of the wire client, shared by {@link RemoteBackend} and the heads and
+ * snapshot parsers in `remote-parsers.ts`, which the backend calls; a module of its own so the
+ * two need no import cycle. Runtime-neutral: nothing from Node.
+ */
+/**
+ * A non-2xx wire response that is neither a `404` (ENOENT-shaped) nor a `412`
+ * ({@link VersionConflict}): the generic case, carrying the error envelope's `code` alongside
+ * the raw HTTP `status`, so a caller can distinguish e.g.
+ * `AUTH_REQUIRED` (401, an unauthenticated/misconfigured `--remote`) from `RUNTIME` (5xx, a
+ * genuine server-side bug) instead of both collapsing into a generically-classified `Error`.
+ */
+export class RemoteError extends Error {
+    /** The envelope's `code` field, or a status-derived guess when the envelope is missing/unparseable. */
+    code;
+    /** The raw HTTP status that produced this error. */
+    status;
+    constructor(message, code, status, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = "RemoteError";
+        this.code = code;
+        this.status = status;
+    }
+}
+/**
+ * The code of an answer the authority produced that the client's contract does not admit. It is
+ * deterministic (the same request gets the same answer), so it is never retried and never read
+ * as truncation or as the host being unavailable. The status stays `502` so a write whose answer
+ * is malformed is still an unknown outcome to the uncertain-write primitive, not a refusal.
+ */
+export const MALFORMED_ANSWER = "MALFORMED_ANSWER";
+/** A {@link MALFORMED_ANSWER} rejection, naming the route that answered when the reader knows it. */
+export class MalformedAnswer extends RemoteError {
+    route;
+    constructor(message, route) {
+        super(message, MALFORMED_ANSWER, 502);
+        this.route = route;
+    }
+}
+/** A wire payload the authority produced but the contract does not admit: not retried, not truncation. */
+export function malformed(message, route) {
+    return new MalformedAnswer(message, route);
+}
+/** True when `error` is a {@link MalformedAnswer}. */
+export function isMalformedAnswer(error) {
+    return error instanceof MalformedAnswer;
+}
+/** Run `read`, naming `route` on a malformed answer it rejects with that does not name one yet. */
+export async function onRoute(route, read) {
+    try {
+        return await read();
+    }
+    catch (error) {
+        if (error instanceof MalformedAnswer && error.route === undefined)
+            error.route = route;
+        throw error;
+    }
+}
+//# sourceMappingURL=remote-error.js.map

package/dist/remote-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-error.js","sourceRoot":"","sources":["../src/remote-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,uGAAuG;IAC9F,IAAI,CAAS;IACtB,oDAAoD;IAC3C,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,IAAY,EAAE,MAAc,EAAE,KAAe;QACxE,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,qGAAqG;AACrG,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,KAAK,CAAqB;IAC1B,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,0GAA0G;AAC1G,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAc;IACvD,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAC;AAC1C,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,KAAa,EAAE,IAAsB;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACvF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/remote-operations.d.ts

@@ -12,7 +12,10 @@
  * carrier failure and a 5xx response both propagate unchanged: a 502 or 504 from an intermediary,
  * or the authority's own runtime failure, says nothing about whether the write was applied, so
  * the primitive classifies it as unknown and resolves it by lookup, which is the whole reason
- * the identity exists. Only a 4xx is final: the authority answered and declined.
+ * the identity exists. A 4xx is final because the authority answered and declined. A local
+ * refusal is also final because no PUT was sent, not because the authority recorded an outcome:
+ * an intent kind other than `document.write`, content that does not parse, or metadata the wire
+ * cannot encode is refused `USAGE` without a PUT.
  *
  * The transport is only sound against an authority that implements identity. A host that
  * predates it ignores the header, applies every retry as a fresh write, and answers the lookup
@@ -30,8 +33,8 @@
  * the verdict visible uses {@link openRemoteOperationTransport} or reads `wireCapabilities()`
  * itself. And the check is memoized on success: a host downgraded afterwards is not detected,
  * so one unidentified resubmission can reach it. Because every identified write is guarded by
- * its base, that exposure is bounded to a spurious conflict at a moved head, never a double
- * application.
+ * its base, that exposure is bounded to a spurious conflict at a moved head, or a second
+ * application when the head has returned to the base's exact content.
  *
  * This module imports nothing from Node so a browser working copy and a Node consumer share
  * one transport over one client adapter.

package/dist/remote-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-operations.d.ts","sourceRoot":"","sources":["../src/remote-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAmB,kBAAkB,EAAW,MAAM,sBAAsB,CAAC;AAGzF,MAAM,WAAW,+BAA+B;IAC9C,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,4BAA4B;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,+BAAoC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIpJ;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,+BAAoC,GAAG,kBAAkB,CAEvI"}
+{"version":3,"file":"remote-operations.d.ts","sourceRoot":"","sources":["../src/remote-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAmB,kBAAkB,EAAW,MAAM,sBAAsB,CAAC;AAGzF,MAAM,WAAW,+BAA+B;IAC9C,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,4BAA4B;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,+BAAoC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIpJ;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,+BAAoC,GAAG,kBAAkB,CAEvI"}

package/dist/remote-operations.js

@@ -12,7 +12,10 @@
  * carrier failure and a 5xx response both propagate unchanged: a 502 or 504 from an intermediary,
  * or the authority's own runtime failure, says nothing about whether the write was applied, so
  * the primitive classifies it as unknown and resolves it by lookup, which is the whole reason
- * the identity exists. Only a 4xx is final: the authority answered and declined.
+ * the identity exists. A 4xx is final because the authority answered and declined. A local
+ * refusal is also final because no PUT was sent, not because the authority recorded an outcome:
+ * an intent kind other than `document.write`, content that does not parse, or metadata the wire
+ * cannot encode is refused `USAGE` without a PUT.
  *
  * The transport is only sound against an authority that implements identity. A host that
  * predates it ignores the header, applies every retry as a fresh write, and answers the lookup
@@ -30,8 +33,8 @@
  * the verdict visible uses {@link openRemoteOperationTransport} or reads `wireCapabilities()`
  * itself. And the check is memoized on success: a host downgraded afterwards is not detected,
  * so one unidentified resubmission can reach it. Because every identified write is guarded by
- * its base, that exposure is bounded to a spurious conflict at a moved head, never a double
- * application.
+ * its base, that exposure is bounded to a spurious conflict at a moved head, or a second
+ * application when the head has returned to the base's exact content.
  *
  * This module imports nothing from Node so a browser working copy and a Node consumer share
  * one transport over one client adapter.
@@ -39,6 +42,7 @@
 import { parseMarkdown } from "./frontmatter.js";
 import { pathFromConceptId } from "./paths.js";
 import { RemoteBackend, RemoteError } from "./remote-backend.js";
+import { RemoteDocumentValueError } from "./remote-document-codec.js";
 import { VersionConflict } from "./version-transport.js";
 /** The authority behind a remote does not record outcomes by request identity. */
 export class OperationsUnsupportedError extends Error {
@@ -76,10 +80,19 @@ function buildTransport(remote, options) {
     };
     const transport = {
         async submit(intent) {
+            // Refused rather than thrown: the primitive classifies a throw as unknown, and an intent
+            // that can never be sent would then stay pending as possibly delivered on every push.
             if (intent.kind !== "document.write") {
-                throw new Error(`remote operation transport: unsupported intent kind '${intent.kind}'`);
+                return { kind: "refused", code: "USAGE", message: `remote operation transport: unsupported intent kind '${intent.kind}'` };
             }
-            const { frontmatter, body } = parseMarkdown(intent.content, pathFromConceptId(intent.target));
+            let parsed;
+            try {
+                parsed = parseMarkdown(intent.content, pathFromConceptId(intent.target));
+            }
+            catch (error) {
+                return { kind: "refused", code: "USAGE", message: error instanceof Error ? error.message : String(error) };
+            }
+            const { frontmatter, body } = parsed;
             const writeOptions = {
                 expectedVersion: intent.base,
                 requestId: intent.requestId,
@@ -93,6 +106,8 @@ function buildTransport(remote, options) {
                 return { kind: "committed", version };
             }
             catch (error) {
+                if (error instanceof RemoteDocumentValueError)
+                    return { kind: "refused", code: "USAGE", message: error.message };
                 if (error instanceof VersionConflict)
                     return { kind: "conflict", actual: error.actual };
                 if (error instanceof RemoteError && error.status < 500)

package/dist/remote-operations.js.map

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

package/dist/remote-parsers.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The client side of the wire's heads and snapshot grammar (`docs/WIRE-PROTOCOL.md`, "Heads and
+ * snapshot"): what a heads answer must carry before its rows may be diffed as deletions, and
+ * how a snapshot body is read so that iterating it to completion is the completeness signal.
+ * {@link RemoteBackend.heads} and {@link RemoteBackend.snapshot} are thin callers over these
+ * two functions; a host that serves the same grammar through routes of its own validates the
+ * answers with the same functions rather than a second parser, since this grammar decides what
+ * a working copy deletes locally.
+ *
+ * Only `TextDecoder` and the Web Streams reader are used, so the same code runs in a browser, a
+ * Worker, and Node.
+ */
+import { type DocumentHead } from "./heads-digest.js";
+import type { ConceptId, Frontmatter, Version } from "./types.js";
+/** A snapshot body that ended, or failed, before its terminator arrived with the announced count. */
+export declare const SNAPSHOT_TRUNCATED = "SNAPSHOT_TRUNCATED";
+/**
+ * A snapshot whose body arrived whole, with its terminator and the announced count, but whose
+ * rows digest to something other than the header announced. Not truncation: re-requesting will
+ * not necessarily repair it, since the authority contradicted itself. A consumer discards the
+ * documents' claim to the header digest either way.
+ */
+export declare const SNAPSHOT_DIGEST_MISMATCH = "SNAPSHOT_DIGEST_MISMATCH";
+/** A `200` from `GET /heads`: every document id and version, and the digest over them. */
+export interface HeadsResult {
+    digest: string;
+    heads: DocumentHead[];
+}
+/** The snapshot's first line: how many documents follow and the digest `heads` would return for this state. */
+export interface SnapshotHeader {
+    count: number;
+    digest: string;
+}
+/** One `doc` line of a snapshot. */
+export interface SnapshotDocument {
+    id: ConceptId;
+    version: Version;
+    frontmatter: Frontmatter;
+    body: string;
+}
+/**
+ * A snapshot as {@link readSnapshotStream} hands it over: the header, already parsed, and the
+ * documents as they stream. Iterating `docs` to completion is the completeness signal: the
+ * loop ends only after the `end` line arrived with the announced count and the digest recomputed
+ * over the received `{ id, version }` rows equals the header's, and it throws
+ * `SNAPSHOT_TRUNCATED` (the body ended or failed first) or `SNAPSHOT_DIGEST_MISMATCH` (the body
+ * was whole but describes a state the header did not announce) otherwise, so a consumer that
+ * writes batches as they arrive has one control path and never needs to inspect a terminator
+ * or a digest itself. A consumer records the header digest as matched only after the loop
+ * ended normally.
+ */
+export interface RemoteSnapshot {
+    header: SnapshotHeader;
+    docs: AsyncIterable<SnapshotDocument>;
+}
+/** Options for {@link readSnapshotStream}. */
+export interface ReadSnapshotStreamOptions {
+    /**
+     * The HTTP status the response carried, reported as `RemoteError.status` by the truncation and
+     * digest-mismatch rejections; a caller that has already checked `res.ok` passes `res.status`.
+     * Defaults to `200`, the only status a snapshot body is read under.
+     */
+    status?: number;
+}
+/**
+ * The `200` body of `GET /heads`, admitted or refused as one: a well-formed digest, a `heads`
+ * array of `{ id, version }` rows, a `count` equal to the number of rows, and rows that digest
+ * by the documented recipe to the digest served. Anything else rejects as malformed (a
+ * {@link MalformedAnswer}, code `MALFORMED_ANSWER`) rather than being trusted. The
+ * recomputation is what stops a listing that is whole by its own count but not the state its
+ * digest names (a shortened listing under the real digest) from being diffed as a mass
+ * deletion. Rows keep the order served: the recipe sorts for itself, so order does not decide
+ * admission.
+ */
+export declare function parseHeadsAnswer(payload: unknown): HeadsResult;
+/**
+ * Read a `GET /snapshot` body by the documented grammar. The header line is parsed before this
+ * resolves, so a body that ends before it rejects here with `SNAPSHOT_TRUNCATED` and a first
+ * line that is not the header rejects as malformed; the documents then stream through
+ * {@link RemoteSnapshot.docs}, which ends normally only for a whole body whose rows digest to
+ * the header's announcement (see {@link RemoteSnapshot}). Obtaining the response, checking its
+ * status, and re-requesting a truncated snapshot are the caller's: this function reads one body
+ * once and cancels the reader when the iteration is abandoned or fails.
+ */
+export declare function readSnapshotStream(body: ReadableStream<Uint8Array>, options?: ReadSnapshotStreamOptions): Promise<RemoteSnapshot>;
+//# sourceMappingURL=remote-parsers.d.ts.map

package/dist/remote-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-parsers.d.ts","sourceRoot":"","sources":["../src/remote-parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAElE,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,+GAA+G;AAC/G,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAe9D;AA6GD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAa3I"}

package/dist/remote-parsers.js

@@ -0,0 +1,181 @@
+/**
+ * The client side of the wire's heads and snapshot grammar (`docs/WIRE-PROTOCOL.md`, "Heads and
+ * snapshot"): what a heads answer must carry before its rows may be diffed as deletions, and
+ * how a snapshot body is read so that iterating it to completion is the completeness signal.
+ * {@link RemoteBackend.heads} and {@link RemoteBackend.snapshot} are thin callers over these
+ * two functions; a host that serves the same grammar through routes of its own validates the
+ * answers with the same functions rather than a second parser, since this grammar decides what
+ * a working copy deletes locally.
+ *
+ * Only `TextDecoder` and the Web Streams reader are used, so the same code runs in a browser, a
+ * Worker, and Node.
+ */
+import { headsDigest, isHeadsDigest } from "./heads-digest.js";
+import { RemoteError, malformed } from "./remote-error.js";
+/** A snapshot body that ended, or failed, before its terminator arrived with the announced count. */
+export const SNAPSHOT_TRUNCATED = "SNAPSHOT_TRUNCATED";
+/**
+ * A snapshot whose body arrived whole, with its terminator and the announced count, but whose
+ * rows digest to something other than the header announced. Not truncation: re-requesting will
+ * not necessarily repair it, since the authority contradicted itself. A consumer discards the
+ * documents' claim to the header digest either way.
+ */
+export const SNAPSHOT_DIGEST_MISMATCH = "SNAPSHOT_DIGEST_MISMATCH";
+function isDocumentHead(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const head = value;
+    return typeof head.id === "string" && typeof head.version === "string";
+}
+/**
+ * The `200` body of `GET /heads`, admitted or refused as one: a well-formed digest, a `heads`
+ * array of `{ id, version }` rows, a `count` equal to the number of rows, and rows that digest
+ * by the documented recipe to the digest served. Anything else rejects as malformed (a
+ * {@link MalformedAnswer}, code `MALFORMED_ANSWER`) rather than being trusted. The
+ * recomputation is what stops a listing that is whole by its own count but not the state its
+ * digest names (a shortened listing under the real digest) from being diffed as a mass
+ * deletion. Rows keep the order served: the recipe sorts for itself, so order does not decide
+ * admission.
+ */
+export function parseHeadsAnswer(payload) {
+    const answer = payload;
+    if (!isHeadsDigest(answer?.digest))
+        throw malformed("wire heads answered without a well-formed digest");
+    if (!Array.isArray(answer.heads) || !answer.heads.every(isDocumentHead)) {
+        throw malformed("wire heads answered without a heads array of { id, version } rows");
+    }
+    if (answer.count !== answer.heads.length) {
+        throw malformed(`wire heads count ${String(answer.count)} disagrees with its ${answer.heads.length} row(s)`);
+    }
+    const heads = answer.heads.map(({ id, version }) => ({ id, version }));
+    const recomputed = headsDigest(heads);
+    if (recomputed !== answer.digest) {
+        throw malformed(`wire heads served digest ${answer.digest}, but its ${heads.length} row(s) digest to ${recomputed}`);
+    }
+    return { digest: answer.digest, heads };
+}
+/**
+ * Split a response body into its NDJSON lines as they arrive, decoding UTF-8 across chunk
+ * boundaries. A partial trailing line at the end of the body is a cut line and is not yielded; a
+ * transport failure while reading is reported as truncation, since either way the terminator
+ * never arrived. Leaving the loop early cancels the reader so the connection is released.
+ */
+async function* ndjsonLines(body, status) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffered = "";
+    try {
+        for (;;) {
+            let chunk;
+            try {
+                chunk = await reader.read();
+            }
+            catch (cause) {
+                throw new RemoteError("snapshot body failed before its end line arrived", SNAPSHOT_TRUNCATED, status, cause);
+            }
+            buffered += decoder.decode(chunk.value, { stream: !chunk.done });
+            let start = 0;
+            for (let newline = buffered.indexOf("\n"); newline !== -1; newline = buffered.indexOf("\n", start)) {
+                yield buffered.slice(start, newline);
+                start = newline + 1;
+            }
+            buffered = buffered.slice(start);
+            if (chunk.done)
+                return;
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+    }
+}
+function parseSnapshotLine(line) {
+    let record;
+    try {
+        record = JSON.parse(line);
+    }
+    catch {
+        throw malformed("snapshot line is not JSON");
+    }
+    if (typeof record !== "object" || record === null)
+        throw malformed("snapshot line is not a JSON object");
+    return record;
+}
+function parseSnapshotHeader(line) {
+    const record = parseSnapshotLine(line);
+    if (record.kind !== "snapshot")
+        throw malformed("snapshot did not begin with its header line");
+    if (typeof record.count !== "number" || !Number.isInteger(record.count) || record.count < 0) {
+        throw malformed("snapshot header carries no document count");
+    }
+    if (!isHeadsDigest(record.digest))
+        throw malformed("snapshot header carries no well-formed digest");
+    return { count: record.count, digest: record.digest };
+}
+/**
+ * The document lines of a snapshot, ending normally only at an `end` line whose count equals
+ * both the header's announcement and the documents actually seen, and only when the digest
+ * recomputed over the received heads equals the header's. Anything else is a rejection: a body
+ * that ends first is `SNAPSHOT_TRUNCATED`; a whole body whose heads digest differently is
+ * `SNAPSHOT_DIGEST_MISMATCH`; a line the contract does not admit is malformed. The digest is the
+ * client's own check of the listing it is about to trust: a count and a terminator say the body
+ * is whole, only the recipe says it is the state the header named.
+ */
+async function* snapshotDocuments(lines, header, status) {
+    let seen = 0;
+    const received = [];
+    for await (const line of lines) {
+        const record = parseSnapshotLine(line);
+        if (record.kind === "doc") {
+            if (typeof record.id !== "string" || typeof record.version !== "string" || typeof record.body !== "string") {
+                throw malformed("snapshot doc line lacks id, version, or body");
+            }
+            if (typeof record.frontmatter !== "object" || record.frontmatter === null || Array.isArray(record.frontmatter)) {
+                throw malformed("snapshot doc line lacks a frontmatter object");
+            }
+            seen += 1;
+            if (seen > header.count)
+                throw malformed(`snapshot delivered more than the ${header.count} announced document(s)`);
+            received.push({ id: record.id, version: record.version });
+            yield { id: record.id, version: record.version, frontmatter: record.frontmatter, body: record.body };
+            continue;
+        }
+        if (record.kind === "end") {
+            if (record.count !== seen || seen !== header.count) {
+                throw new RemoteError(`snapshot end line counts ${String(record.count)} document(s), but ${seen} of ${header.count} announced arrived`, SNAPSHOT_TRUNCATED, status);
+            }
+            const recomputed = headsDigest(received);
+            if (recomputed !== header.digest) {
+                throw new RemoteError(`snapshot header announced digest ${header.digest}, but its ${seen} document(s) digest to ${recomputed}`, SNAPSHOT_DIGEST_MISMATCH, status);
+            }
+            return;
+        }
+        throw malformed(`snapshot line has unexpected kind ${JSON.stringify(record.kind)}`);
+    }
+    throw new RemoteError(`snapshot ended after ${seen} of ${header.count} document(s) without its end line`, SNAPSHOT_TRUNCATED, status);
+}
+/**
+ * Read a `GET /snapshot` body by the documented grammar. The header line is parsed before this
+ * resolves, so a body that ends before it rejects here with `SNAPSHOT_TRUNCATED` and a first
+ * line that is not the header rejects as malformed; the documents then stream through
+ * {@link RemoteSnapshot.docs}, which ends normally only for a whole body whose rows digest to
+ * the header's announcement (see {@link RemoteSnapshot}). Obtaining the response, checking its
+ * status, and re-requesting a truncated snapshot are the caller's: this function reads one body
+ * once and cancels the reader when the iteration is abandoned or fails.
+ */
+export async function readSnapshotStream(body, options = {}) {
+    const status = options.status ?? 200;
+    const lines = ndjsonLines(body, status);
+    const first = await lines.next();
+    if (first.done)
+        throw new RemoteError("snapshot ended before its header line", SNAPSHOT_TRUNCATED, status);
+    let header;
+    try {
+        header = parseSnapshotHeader(first.value);
+    }
+    catch (err) {
+        await lines.return(undefined);
+        throw err;
+    }
+    return { header, docs: snapshotDocuments(lines, header, status) };
+}
+//# sourceMappingURL=remote-parsers.js.map

package/dist/remote-parsers.js.map

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

package/dist/remote.d.ts

@@ -1,4 +1,9 @@
 /** Browser-safe client adapter for the Superbee wire protocol. */
-export { RemoteBackend, RemoteError } from "./remote-backend.js";
-export type { FetchLike, RemoteBackendOptions } from "./remote-backend.js";
+export { RemoteBackend } from "./remote-backend.js";
+export type { FetchLike, HeadsOptions, RemoteBackendOptions, WireCapabilities } from "./remote-backend.js";
+export { RemoteError } from "./remote-error.js";
+export { SNAPSHOT_DIGEST_MISMATCH, SNAPSHOT_TRUNCATED, parseHeadsAnswer, readSnapshotStream } from "./remote-parsers.js";
+export type { HeadsResult, ReadSnapshotStreamOptions, RemoteSnapshot, SnapshotDocument, SnapshotHeader } from "./remote-parsers.js";
+export { headsDigest, isHeadsDigest, sortHeads } from "./heads-digest.js";
+export type { DocumentHead } from "./heads-digest.js";
 //# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzH,YAAY,EAAE,WAAW,EAAE,yBAAyB,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpI,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}