@superbee/core 0.2.0-pre.4 → 0.2.0-pre.41

package/dist/hosted-transport/paged-reads.js

@@ -0,0 +1,238 @@
+/**
+ * Following the host's page cursor for heads and snapshot. The host serves both a page at a
+ * time: a request without `cursor` is the first page, and each page that is not the last names
+ * the `next` cursor. Every page is served under the one bundle revision the first page pinned
+ * and states the whole listing's `count` and `digest`; a write between pages makes the next page
+ * refuse with `409 concurrent_change` rather than mix two states, and the reader starts again.
+ *
+ * A bundle that fits in one page gets the answer it got before paging, so these helpers only
+ * stitch pages together: the assembled heads go through {@link parseHeadsAnswer} and the
+ * stitched snapshot body through {@link readSnapshotStream}, which keep deciding what a working
+ * copy may trust (the count, the terminator, the digest).
+ */
+import { isHeadsDigest } from "../heads-digest.js";
+import { malformed, RemoteError } from "../remote-error.js";
+import { SNAPSHOT_TRUNCATED } from "../remote-parsers.js";
+/** The refusal a page answers when the bundle moved since the first page pinned it. */
+export const PAGE_RESTART_CODE = "concurrent_change";
+/** How many times a heads listing starts again from the first page before the refusal stands. */
+export const HEADS_PAGE_ATTEMPTS = 3;
+/**
+ * The pause before each restart, by restart: about a quarter second, then about a second. A burst
+ * of writes (an organizer apply, an agent's batch) usually settles within that, where restarts
+ * back to back would spend every attempt inside the same burst.
+ */
+export const PAGE_RESTART_DELAYS_MS = Object.freeze([250, 1000]);
+/** The pause before restart `restart` (1-based): half the base plus up to half again, at random. */
+export function pageRestartDelay(restart, random = Math.random) {
+    const base = PAGE_RESTART_DELAYS_MS[Math.min(restart, PAGE_RESTART_DELAYS_MS.length) - 1];
+    return Math.round(base / 2 + (random() * base) / 2);
+}
+/** Waits `ms`, or rejects with the signal's reason once it aborts. */
+export function pause(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted)
+            return reject(signal.reason);
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", aborted);
+            resolve();
+        }, ms);
+        const aborted = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", aborted, { once: true });
+    });
+}
+/** The longest cursor a reader passes back; the host's are far shorter. */
+export const MAXIMUM_CURSOR_LENGTH = 4096;
+/** True when `error` is the host's refusal of a page because the bundle moved since the first. */
+export function isPageRestart(error) {
+    return error instanceof RemoteError && error.status === 409 && error.code === PAGE_RESTART_CODE;
+}
+/**
+ * True when a snapshot ended as truncation because a later page was refused as a restart: the
+ * documents changed while the pages streamed. The snapshot cannot start again by itself, since
+ * its header and first documents already reached the consumer; the caller that consumes it
+ * (a bootstrap or a checkout) runs again, after {@link pageRestartDelay}, a bounded number of
+ * times ({@link SNAPSHOT_RESTART_ATTEMPTS}).
+ */
+export function isSnapshotRestart(error) {
+    return error instanceof RemoteError && error.code === SNAPSHOT_TRUNCATED && isPageRestart(error.cause);
+}
+/** How many times a snapshot consumer runs before a restart truncation stands. */
+export const SNAPSHOT_RESTART_ATTEMPTS = 3;
+/**
+ * Runs `consume` (a bootstrap or a checkout over one snapshot) again when it fails with a
+ * snapshot restart, pausing before each run, at most `attempts` times in all. Any other failure,
+ * and the last restart, stand.
+ */
+export async function retrySnapshotRestarts(consume, options) {
+    const attempts = options.attempts ?? SNAPSHOT_RESTART_ATTEMPTS;
+    for (let attempt = 1;; attempt += 1) {
+        try {
+            return await consume();
+        }
+        catch (error) {
+            if (attempt >= attempts || !isSnapshotRestart(error))
+                throw error;
+            await (options.sleep ?? pause)(pageRestartDelay(attempt), options.signal);
+        }
+    }
+}
+function isCursor(value) {
+    return typeof value === "string" && value.length > 0 && value.length <= MAXIMUM_CURSOR_LENGTH;
+}
+export function decodeHeadsPage(value) {
+    const body = value;
+    if (typeof body !== "object" || body === null || Array.isArray(body))
+        throw malformed("heads page is not a JSON object");
+    if (typeof body.count !== "number" || !Number.isSafeInteger(body.count) || body.count < 0)
+        throw malformed("heads page carries no listing count");
+    if (!isHeadsDigest(body.digest))
+        throw malformed("heads page carries no well-formed digest");
+    if (!Array.isArray(body.heads))
+        throw malformed("heads page carries no heads array");
+    const heads = body.heads.map((row) => {
+        const head = row;
+        if (typeof head !== "object" || head === null || typeof head.id !== "string" || typeof head.version !== "string")
+            throw malformed("heads page carries a row that is not { id, version }");
+        return { id: head.id, version: head.version };
+    });
+    if (body.next !== undefined && !isCursor(body.next))
+        throw malformed("heads page carries a malformed next cursor");
+    return { count: body.count, digest: body.digest, heads, ...(body.next === undefined ? {} : { next: body.next }) };
+}
+/**
+ * Collects paged heads into the one listing they page. Every page must state the first page's
+ * count and digest, rows must strictly ascend by id across pages (so no row repeats), a page that
+ * names a next cursor must carry rows, and the rows may never outnumber the count. The caller
+ * hands the assembled `{ count, digest, heads }` to the shared heads parser.
+ */
+export class HeadsPages {
+    #first;
+    #rows = [];
+    /** Adds a page; answers the cursor of the next page, or undefined once the listing is whole. */
+    add(page) {
+        const first = (this.#first ??= page);
+        if (page.count !== first.count || page.digest !== first.digest)
+            throw malformed("heads pages disagree on the listing they page");
+        for (const head of page.heads) {
+            const last = this.#rows.at(-1);
+            if (last !== undefined && !(last.id < head.id))
+                throw malformed("heads pages repeat or reorder a row");
+            this.#rows.push(head);
+        }
+        if (this.#rows.length > first.count)
+            throw malformed(`heads pages carry more than the ${first.count} row(s) they announce`);
+        if (page.next !== undefined && page.heads.length === 0)
+            throw malformed("a heads page names a next page but carries no rows");
+        return page.next;
+    }
+    /** The assembled answer, in the unpaged answer's shape. */
+    whole() {
+        if (!this.#first)
+            throw malformed("no heads page arrived");
+        return { count: this.#first.count, digest: this.#first.digest, heads: [...this.#rows] };
+    }
+}
+/** Complete lines of one NDJSON body as they arrive; a partial trailing line is not yielded. */
+async function* bodyLines(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffered = "";
+    try {
+        for (;;) {
+            const chunk = await reader.read();
+            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 lineRecord(line) {
+    try {
+        const record = JSON.parse(line);
+        return typeof record === "object" && record !== null && !Array.isArray(record) ? record : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The prefix every document line the host writes begins with; any other line is parsed here. */
+const DOC_LINE = '{"kind":"doc",';
+/**
+ * One snapshot body stitched from its pages, in the unpaged grammar: the first page's header,
+ * every page's document lines in order, and the last page's `end` terminator. A later page's
+ * header must state the first page's count and digest and is dropped; a `page` terminator must
+ * count the document lines its page carried and names the cursor `open` fetches next. Anything
+ * else passes through verbatim for the snapshot parser to judge, and a page that fails to open
+ * or ends early ends the stitched body without its terminator, which the parser reports as
+ * truncation. Cancelling the stitched body cancels the page being read.
+ */
+export function stitchSnapshotPages(first, open) {
+    async function* lines() {
+        let body = first;
+        let header;
+        for (;;) {
+            let index = 0;
+            let documents = 0;
+            let next;
+            for await (const line of bodyLines(body)) {
+                if (index++ === 0 && header !== undefined) {
+                    const record = lineRecord(line);
+                    if (record?.kind !== "snapshot" || record.count !== header.count || record.digest !== header.digest)
+                        throw malformed("snapshot pages disagree on the header");
+                    continue;
+                }
+                if (line.startsWith(DOC_LINE)) {
+                    documents += 1;
+                    yield `${line}\n`;
+                    continue;
+                }
+                const record = lineRecord(line);
+                if (header === undefined && record?.kind === "snapshot")
+                    header = { count: record.count, digest: record.digest };
+                if (record?.kind === "page") {
+                    if (record.count !== documents || documents === 0 || !isCursor(record.next))
+                        throw malformed("snapshot page terminator disagrees with its page");
+                    next = record.next;
+                    break;
+                }
+                yield `${line}\n`;
+            }
+            if (next === undefined)
+                return;
+            body = await open(next);
+        }
+    }
+    const produced = lines();
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+        async pull(controller) {
+            try {
+                const step = await produced.next();
+                if (step.done)
+                    controller.close();
+                else
+                    controller.enqueue(encoder.encode(step.value));
+            }
+            catch (error) {
+                controller.error(error);
+            }
+        },
+        async cancel() {
+            await produced.return(undefined);
+        },
+    });
+}
+//# sourceMappingURL=paged-reads.js.map

package/dist/hosted-transport/paged-reads.js.map

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

package/dist/hosted-transport/read-adapter.d.ts

@@ -0,0 +1,256 @@
+/**
+ * The working copy's read side over a hosted bundle: a `StorageBackend` that also carries
+ * `heads`, `snapshot` and `wireCapabilities`, so the shared bootstrap and pull verbs take their
+ * wire path against it. It answers only what those verbs call and refuses the rest before any
+ * request leaves; every mutation is refused, because edits leave through the write transport.
+ *
+ * Refusals follow {@link READ_ANSWER_ROWS}: an authority refusal is a `RemoteError` with the
+ * host's status and code, which the shared runtime classifies; a `503` says nothing about the
+ * bundle, so it is the carrier's `unavailable` and the runtime reports itself offline. A read
+ * the host answers `document_not_found` is an ENOENT-shaped rejection, as every backend answers
+ * absence.
+ *
+ * The capabilities answer (flags, bound, root, retention window) is read once and held. Every
+ * heads answer states the root's version; one that differs from the held answer's root drops
+ * it, so the root and the edition it declares are as new as the listing. Any authority refusal
+ * drops it too.
+ *
+ * The host serves heads and snapshot a page at a time; a bundle that fits in one page gets one
+ * answer, as before paging. The adapter follows the `next` cursor (`paged-reads.ts`) and hands
+ * the verbs the same whole listing and the same one snapshot body.
+ */
+import { RemoteError } from "../remote-error.js";
+import { type HeadsResult, type RemoteSnapshot } from "../remote-parsers.js";
+import type { HeadsOptions, WireCapabilities } from "../remote-backend.js";
+import type { ConceptId, ReadResult, StorageBackend } from "../types.js";
+import { HostedCarrierError, type HostedCarrier } from "./carrier.js";
+/** What a capabilities answer says about changing the bundle's model (its Kind conventions). */
+export type HostedDefinitionWrites = "allowed" | "refused";
+/** What the capabilities route states about one bundle, beyond the wire booleans. */
+export interface HostedCapabilities {
+    readonly heads: boolean;
+    readonly snapshot: boolean;
+    readonly operations: boolean;
+    /** The inventory bound and the per-document byte bound the host serves a working copy within. */
+    readonly bound: Readonly<{
+        documents: number;
+        bytes: number;
+    }>;
+    /**
+     * The inventory bound a host that pages serves a bundle within (each page within
+     * `bound.documents`), or `null` for a host from before paging, which serves only
+     * `bound.documents` in one answer.
+     */
+    readonly paged: Readonly<{
+        documents: number;
+    }> | null;
+    /** The bundle root's reserved `index.md` as exact bytes with its version, or `null` without one. */
+    readonly root: Readonly<{
+        content: string;
+        version: string;
+    }> | null;
+    /** How long the host keeps a request identity, in milliseconds (stated, or the thirty-day default). */
+    readonly operationsRetentionMs: number;
+    /**
+     * Whether the caller may change this bundle's model (its Kind conventions) through the identified
+     * writes: `null` when the host does not say (a host or workspace without model changes), else
+     * what it says. Any value other than `"allowed"` reads as `"refused"`.
+     */
+    readonly definitionWrites: HostedDefinitionWrites | null;
+    /**
+     * Whether the caller may replace the bundle's root `index.md` (`bundles.root.replace.v1`): only
+     * an answer that says `"allowed"` does; a host from before the root write says nothing, which
+     * reads as `"refused"`, as does any other value.
+     */
+    readonly rootWrites: "allowed" | "refused";
+    /**
+     * The host's whole-document write bound (`limits.documentInputBytes`): the largest create,
+     * replace or outcome request body it accepts, in bytes of JSON. `null` when the host does not
+     * state one; a client then assumes 65,536, the bound of every host before it was stated.
+     */
+    readonly documentInputBytes: number | null;
+    /** Ordinary-file routes are admitted independently of document writes. Absent means refused. */
+    readonly blobReads?: "allowed" | "refused";
+    readonly blobWrites?: "allowed" | "refused";
+    /** Independent advertised byte bounds; absent or malformed statements read as null. */
+    readonly blobReadBytes?: number | null;
+    readonly blobWriteBytes?: number | null;
+}
+/** The retention window assumed for a host that states none: thirty days. */
+export declare const DEFAULT_OPERATIONS_RETENTION_MS: number;
+/**
+ * How long before the window ends an absent outcome stops being trusted: the host expires rows
+ * by its own clock and the client measures an intent's age by its own, so the last hour of the
+ * window is treated as already expired.
+ */
+export declare const OPERATIONS_RETENTION_SKEW_MS: number;
+/** The header every heads answer carries: the root's content version, or {@link ROOT_VERSION_ABSENT}. */
+export declare const ROOT_VERSION_HEADER = "X-Superbee-Root-Version";
+export declare const ROOT_VERSION_ABSENT = "none";
+/** The root version a heads answer states: a version, `null` for the absent marker, `undefined` when malformed. */
+export declare function decodeRootVersion(value: string | null): string | null | undefined;
+export declare const HOSTED_READ_BOUNDS: Readonly<{
+    /** A capabilities answer carries the root's exact bytes, bounded like one document read. */
+    capabilitiesBytes: number;
+    /** A heads listing at the inventory bound is a few hundred KiB; four MiB is a safe superset. */
+    headsBytes: number;
+    /** One document read's answer, and one snapshot line. */
+    documentBytes: number;
+    /** One history page's answer: the host bounds `documents.history.v1` at 1 MiB; the slack is the envelope's. */
+    historyBytes: number;
+    /** The operation listing's answer: at most 200 descriptors, each with its two JSON Schemas. */
+    operationsBytes: number;
+    /** Any one operation run's answer; the operation's own `maximumOutputBytes` is lower when it says so. */
+    runBytes: number;
+    /** The most bytes one run's input may take, as a caller serializes it (the CLI's --input, MCP's run_operation). */
+    runInputBytes: number;
+    /** The most operation descriptors one listing admits; the rest are dropped with a note. */
+    operations: 200;
+    /** The deepest nesting (objects and arrays, the schema itself level 1) a descriptor's schema may have. */
+    operationSchemaDepth: 32;
+    /** An operation title's and description's length, in UTF-16 units, once stripped. */
+    operationTitleChars: 200;
+    operationDescriptionChars: 2048;
+    /** The deepest nesting (objects and arrays, the data itself level 1) a run's data may have. */
+    runDepth: 256;
+    /** Document reads in flight at once, whatever concurrency a caller's batches ask for. */
+    readConcurrency: 8;
+}>;
+/** The routes one client family reads; the browser's are the defaults. */
+export interface HostedReadRoutes {
+    capabilities: string;
+    heads: string;
+    snapshot: string;
+    read: string;
+}
+export declare const BROWSER_READ_ROUTES: HostedReadRoutes;
+export declare const SYNC_READ_ROUTES: HostedReadRoutes;
+export declare class HostedReadAdapterError extends Error {
+    readonly name = "HostedReadAdapterError";
+    readonly code: "read_only" | "unsupported";
+    constructor(code: "read_only" | "unsupported");
+}
+export interface HostedReadAdapterOptions {
+    carrier: HostedCarrier;
+    bundleId: string;
+    routes?: HostedReadRoutes;
+    /** Pinned on every document read, when the family binds reads (the browser's recovery target). */
+    binding?: string;
+    /** Test seam: how the adapter waits before a heads restart. Default: a timer that the adapter's abort cancels. */
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+export interface HostedReadAdapter extends StorageBackend {
+    heads(options?: HeadsOptions): Promise<HeadsResult | null>;
+    snapshot(): Promise<RemoteSnapshot>;
+    wireCapabilities(): Promise<WireCapabilities>;
+    hostedCapabilities(): Promise<HostedCapabilities>;
+    operationsRetentionMs(): Promise<number>;
+    /** Aborts every request in flight as a carrier failure and refuses every later one. */
+    abort(): void;
+    readonly signal: AbortSignal;
+}
+/**
+ * The grammar of a refusal code a host may name (`bundle_not_found`, `unknown_operation`, ...).
+ * A code is host text that reaches messages and details; anything outside it is never echoed.
+ */
+export declare const REFUSAL_CODE: RegExp;
+/** A read route's refusal as the runtime must see it (the `refusal` rows of {@link READ_ANSWER_ROWS}). */
+export declare function readRefusal(answer: {
+    status: number;
+    body: unknown;
+}): RemoteError | HostedCarrierError;
+/**
+ * The whole-document write bound a host states in its `limits`, or `null` when it states none.
+ * A malformed statement reads as none (the 65,536 every older host accepts), never as a refusal:
+ * the bound only narrows what a client sends.
+ */
+export declare function statedDocumentInputBytes(limits: unknown): number | null;
+/** The capabilities route's answer, admitted or refused as one; fields the route may gain are ignored. */
+export declare function decodeHostedCapabilities(value: unknown): HostedCapabilities;
+/**
+ * A `documents.read.v1` success, decoded against hosted's result schema
+ * (`{ ok: true, operationId, data: { document: { id, frontmatter, body }, version } }`, with an
+ * optional `viewActionContext` and `readSnapshot` this reader does not use): the document it names
+ * must be the one asked for, at a content version.
+ */
+export declare function decodeDocumentRead(id: ConceptId, body: unknown, route?: string): ReadResult;
+/** The operation a hosted history read runs (`POST <sync prefix>/history`). */
+export declare const HISTORY_OPERATION_ID = "documents.history.v1";
+/** The most versions one history page lists (hosted's `READ_LIMITS.documents`). */
+export declare const HISTORY_PAGE_LIMIT = 100;
+/** One page of a document's history, as asked: the newest `limit` versions older than `before`. */
+export interface HostedHistoryRequest {
+    readonly documentId: ConceptId;
+    /** 1..{@link HISTORY_PAGE_LIMIT}. */
+    readonly limit: number;
+    /** Only versions with a smaller `seq` are listed. Absent for the first page. */
+    readonly before?: number;
+    /** Ask for each listed version's stored bytes. */
+    readonly includeContent?: boolean;
+}
+/** One version of a document's lineage. `seq` counts the lineage's writes from 1. */
+export interface HostedHistoryVersion {
+    readonly seq: number;
+    readonly version: string;
+    /** The principal that made the write. */
+    readonly actor: string;
+    readonly timestamp: string;
+    /** The agent label the write named, when it named one. */
+    readonly agent?: string;
+    /** The version's stored bytes, verified against `version`; only when asked for. */
+    readonly content?: string;
+}
+export interface HostedHistoryPage {
+    readonly documentId: ConceptId;
+    /** Newest first. */
+    readonly versions: readonly HostedHistoryVersion[];
+    /** True when older versions exist before the last one listed. */
+    readonly more: boolean;
+    /** Every version of the lineage: stated on the first page (no `before`) only. */
+    readonly total?: number;
+}
+/** The body a history request sends. */
+export declare function historyInput(bundleId: string, request: HostedHistoryRequest): Record<string, unknown>;
+/**
+ * A `documents.history.v1` success, decoded against hosted's result schema
+ * (`{ ok: true, operationId, data: { documentId, versions: [{ seq, version, actor, timestamp,
+ * agent?, content? }], more, total? } }`) and against the page asked for: the document named,
+ * at most `limit` rows, `seq` strictly descending and below `before`, content exactly when asked
+ * and hashing to its version, a `more` page that is full, and a first page's `total`. Fields the
+ * result may gain are ignored.
+ */
+export declare function decodeDocumentHistory(request: HostedHistoryRequest, body: unknown, route?: string): HostedHistoryPage;
+/** An operation's refusal (`ok: false`): the kernel's error code, its message and its retry advice. */
+export interface HostedOperationRefusal {
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+}
+/**
+ * The refusal a 200 operation answer carries, or `undefined` for an answer that is not one
+ * (`ok` is not `false`). A refusal must name `operationId` and an error code in
+ * {@link REFUSAL_CODE}; any other `ok: false` envelope is malformed. The message is host text,
+ * stripped of control and format characters. One reading for every kernel operation a hosted
+ * client runs.
+ */
+export declare function operationRefusal(body: unknown, operationId: string, route?: string): HostedOperationRefusal | undefined;
+/**
+ * A route family's own refusal body (`{ error: { code, message, retryable } }`, as capabilities,
+ * export and the operation listing answer it), or `undefined` when the body is not one or names a
+ * code outside {@link REFUSAL_CODE}. The message is host text, stripped.
+ */
+export declare function familyRefusal(answer: {
+    body: unknown;
+}): HostedOperationRefusal | undefined;
+/** One history page's answer: the page, or the operation's refusal (`document_not_found` and the kernel's other codes). */
+export type HostedHistoryAnswer = {
+    ok: true;
+    page: HostedHistoryPage;
+} | {
+    ok: false;
+    refusal: HostedOperationRefusal;
+};
+/** A 200 history answer, decoded against the page asked for. */
+export declare function decodeHistoryAnswer(request: HostedHistoryRequest, body: unknown, route?: string): HostedHistoryAnswer;
+export declare function createHostedReadAdapter(options: HostedReadAdapterOptions): HostedReadAdapter;
+//# sourceMappingURL=read-adapter.d.ts.map

package/dist/hosted-transport/read-adapter.d.ts.map

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