@earendil-works/chord 1.5.0 → 1.5.1

package/dist/link/values.js

@@ -0,0 +1,121 @@
+// Values in messages (§3 values, §22): JSON text, and for payloads marked as carrying bytes raw byte segments, a
+// `Uint8Array` leaf written as `{"$bytes": i}` and read back as a view of the received message (no copy, never
+// base64); a part as the text codec splices it. Shared by the codecs.
+import { invalid } from "../data/internal.js";
+import { DeflatedPart } from "./part.js";
+/** Strict, and a leading U+FEFF is data, not a byte order mark to strip. */
+const STRICT_UTF8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+/** A JSON part at its origin: the value's JSON text (state and params are JSON only). */
+export function jsonPart(value) {
+    return JSON.stringify(value) ?? "null";
+}
+/**
+ * A payload part at its origin (arguments, a result): its JSON and, when `bytes` (its method's schema has a `bytes()`
+ * leaf), its byte segments: each `Uint8Array` leaf becomes a segment, and an own key `$bytes`, reserved there, fails
+ * `invalid/args`; otherwise plain JSON, where `$bytes` is ordinary data. `undefined` (a handler returning nothing) is
+ * `null`.
+ */
+export function payloadPart(value, bytes) {
+    if (!bytes)
+        return { json: jsonPart(value), segments: undefined };
+    const segments = [];
+    const json = JSON.stringify(value, function (key, leaf) {
+        if (typeof leaf !== "object" || leaf === null)
+            return leaf;
+        // The holder's own value: a `Uint8Array` subclass with a `toJSON` (Node's `Buffer`) reaches the replacer as
+        // what its `toJSON` made (a Buffer pays that copy: 3.6 ms per MiB; a plain `Uint8Array` none).
+        const original = this[key];
+        if (original instanceof Uint8Array) {
+            segments.push(original);
+            return { $bytes: segments.length - 1 };
+        }
+        // The replacer does not see the markers it returns, only their fields.
+        if (Object.hasOwn(leaf, "$bytes"))
+            throw invalid("args", '"$bytes" is reserved in values crossing a link');
+        return leaf;
+    });
+    return { json: json ?? "null", segments };
+}
+/**
+ * Parses a part's JSON where it is owned, once opened (`openPart`). Throws on a part that is no strict UTF-8 JSON (a
+ * protocol error).
+ */
+export function parsePart(json) {
+    return typeof json === "string" ? JSON.parse(json) : parseJson(json);
+}
+/**
+ * Parses a payload part's JSON where it is owned, once opened, its `{"$bytes": i}` references resolved to views of
+ * `segments` when it has them. Throws on a malformed part (a protocol error).
+ */
+export function parsePayload(json, segments) {
+    const value = parsePart(json);
+    return segments === undefined ? value : resolveSegments(value, segments);
+}
+/**
+ * A part as the text codec splices it into its tuple, tagged so that no JSON value is reserved: `[0, json]` for a plain
+ * part, `[1, base64]` for a deflated one. Throws on invalid UTF-8.
+ */
+export function partText(part) {
+    if (part instanceof DeflatedPart)
+        return `[1,"${base64(part.bytes)}"]`;
+    return `[0,${typeof part === "string" ? part : readUtf8(part)}]`;
+}
+/** A part from its place in a text tuple (`partText` reversed). Throws on anything else (a protocol error). */
+export function textPart(value) {
+    // Trust boundary: fresh JSON from the text decoder.
+    if (!Array.isArray(value) || value.length !== 2)
+        throw new Error("text: a part is no [codec, payload] pair");
+    const [codec, payload] = value;
+    if (codec === 0)
+        return JSON.stringify(payload);
+    if (codec === 1 && typeof payload === "string")
+        return new DeflatedPart(fromBase64(payload));
+    throw new Error("text: a part of an unknown codec");
+}
+/** Strict UTF-8 JSON. Throws on anything else (a protocol error). */
+export function parseJson(bytes) {
+    return JSON.parse(STRICT_UTF8.decode(bytes));
+}
+/** Strict UTF-8 text. Throws on invalid UTF-8 (a protocol error). */
+export function readUtf8(bytes) {
+    return STRICT_UTF8.decode(bytes);
+}
+/**
+ * Replaces every `{"$bytes": i}` in a freshly decoded payload with segment `i`, in place. Throws on a malformed
+ * reference (a protocol error).
+ */
+export function resolveSegments(value, segments) {
+    if (typeof value !== "object" || value === null)
+        return value;
+    // Trust boundary: fresh JSON from the link, owned by this decode.
+    const node = value;
+    if (!Array.isArray(node) && Object.hasOwn(node, "$bytes")) {
+        const index = node.$bytes;
+        if (Object.keys(node).length !== 1 || typeof index !== "number" || segments[index] === undefined) {
+            throw new Error("payload: a malformed byte segment reference");
+        }
+        return segments[index];
+    }
+    for (const key of Object.keys(node)) {
+        const child = node[key];
+        const resolved = resolveSegments(child, segments);
+        // Defined, not assigned: a key `__proto__` is an own property of parsed JSON.
+        if (resolved !== child)
+            Object.defineProperty(node, key, { value: resolved, writable: true, enumerable: true, configurable: true });
+    }
+    return node;
+}
+/** Bytes as base64 (the text codec's deflated parts; portable: `btoa` over a binary string, in chunks). */
+function base64(bytes) {
+    let binary = "";
+    for (let offset = 0; offset < bytes.byteLength; offset += 0x8000) {
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
+    }
+    return btoa(binary);
+}
+/** Bytes from base64. Throws on text that is no base64 (a protocol error). */
+function fromBase64(text) {
+    const binary = atob(text);
+    return Uint8Array.from(binary, (char) => char.charCodeAt(0));
+}
+//# sourceMappingURL=values.js.map

package/dist/link/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/link/values.ts"],"names":[],"mappings":"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","sourcesContent":["// Values in messages (§3 values, §22): JSON text, and for payloads marked as carrying bytes raw byte segments, a\n// `Uint8Array` leaf written as `{\"$bytes\": i}` and read back as a view of the received message (no copy, never\n// base64); a part as the text codec splices it. Shared by the codecs.\n\nimport { invalid } from \"../data/internal.ts\";\nimport { DeflatedPart, type Part } from \"./part.ts\";\n\n/** Strict, and a leading U+FEFF is data, not a byte order mark to strip. */\nconst STRICT_UTF8 = new TextDecoder(\"utf-8\", { fatal: true, ignoreBOM: true });\n\n/** A JSON part at its origin: the value's JSON text (state and params are JSON only). */\nexport function jsonPart(value: unknown): string {\n\treturn JSON.stringify(value) ?? \"null\";\n}\n\n/**\n * A payload part at its origin (arguments, a result): its JSON and, when `bytes` (its method's schema has a `bytes()`\n * leaf), its byte segments: each `Uint8Array` leaf becomes a segment, and an own key `$bytes`, reserved there, fails\n * `invalid/args`; otherwise plain JSON, where `$bytes` is ordinary data. `undefined` (a handler returning nothing) is\n * `null`.\n */\nexport function payloadPart(\n\tvalue: unknown,\n\tbytes: boolean,\n): { readonly json: string; readonly segments: Uint8Array[] | undefined } {\n\tif (!bytes) return { json: jsonPart(value), segments: undefined };\n\tconst segments: Uint8Array[] = [];\n\tconst json = JSON.stringify(value, function (this: Record<string, unknown>, key: string, leaf: unknown) {\n\t\tif (typeof leaf !== \"object\" || leaf === null) return leaf;\n\t\t// The holder's own value: a `Uint8Array` subclass with a `toJSON` (Node's `Buffer`) reaches the replacer as\n\t\t// what its `toJSON` made (a Buffer pays that copy: 3.6 ms per MiB; a plain `Uint8Array` none).\n\t\tconst original = this[key];\n\t\tif (original instanceof Uint8Array) {\n\t\t\tsegments.push(original);\n\t\t\treturn { $bytes: segments.length - 1 };\n\t\t}\n\t\t// The replacer does not see the markers it returns, only their fields.\n\t\tif (Object.hasOwn(leaf, \"$bytes\")) throw invalid(\"args\", '\"$bytes\" is reserved in values crossing a link');\n\t\treturn leaf;\n\t});\n\treturn { json: json ?? \"null\", segments };\n}\n\n/**\n * Parses a part's JSON where it is owned, once opened (`openPart`). Throws on a part that is no strict UTF-8 JSON (a\n * protocol error).\n */\nexport function parsePart(json: string | Uint8Array): unknown {\n\treturn typeof json === \"string\" ? JSON.parse(json) : parseJson(json);\n}\n\n/**\n * Parses a payload part's JSON where it is owned, once opened, its `{\"$bytes\": i}` references resolved to views of\n * `segments` when it has them. Throws on a malformed part (a protocol error).\n */\nexport function parsePayload(json: string | Uint8Array, segments: readonly Uint8Array[] | undefined): unknown {\n\tconst value = parsePart(json);\n\treturn segments === undefined ? value : resolveSegments(value, segments);\n}\n\n/**\n * A part as the text codec splices it into its tuple, tagged so that no JSON value is reserved: `[0, json]` for a plain\n * part, `[1, base64]` for a deflated one. Throws on invalid UTF-8.\n */\nexport function partText(part: Part): string {\n\tif (part instanceof DeflatedPart) return `[1,\"${base64(part.bytes)}\"]`;\n\treturn `[0,${typeof part === \"string\" ? part : readUtf8(part)}]`;\n}\n\n/** A part from its place in a text tuple (`partText` reversed). Throws on anything else (a protocol error). */\nexport function textPart(value: unknown): Part {\n\t// Trust boundary: fresh JSON from the text decoder.\n\tif (!Array.isArray(value) || value.length !== 2) throw new Error(\"text: a part is no [codec, payload] pair\");\n\tconst [codec, payload] = value as [unknown, unknown];\n\tif (codec === 0) return JSON.stringify(payload);\n\tif (codec === 1 && typeof payload === \"string\") return new DeflatedPart(fromBase64(payload));\n\tthrow new Error(\"text: a part of an unknown codec\");\n}\n\n/** Strict UTF-8 JSON. Throws on anything else (a protocol error). */\nexport function parseJson(bytes: Uint8Array): unknown {\n\treturn JSON.parse(STRICT_UTF8.decode(bytes));\n}\n\n/** Strict UTF-8 text. Throws on invalid UTF-8 (a protocol error). */\nexport function readUtf8(bytes: Uint8Array): string {\n\treturn STRICT_UTF8.decode(bytes);\n}\n\n/**\n * Replaces every `{\"$bytes\": i}` in a freshly decoded payload with segment `i`, in place. Throws on a malformed\n * reference (a protocol error).\n */\nexport function resolveSegments(value: unknown, segments: readonly Uint8Array[]): unknown {\n\tif (typeof value !== \"object\" || value === null) return value;\n\t// Trust boundary: fresh JSON from the link, owned by this decode.\n\tconst node = value as Record<string, unknown>;\n\tif (!Array.isArray(node) && Object.hasOwn(node, \"$bytes\")) {\n\t\tconst index = node.$bytes;\n\t\tif (Object.keys(node).length !== 1 || typeof index !== \"number\" || segments[index] === undefined) {\n\t\t\tthrow new Error(\"payload: a malformed byte segment reference\");\n\t\t}\n\t\treturn segments[index];\n\t}\n\tfor (const key of Object.keys(node)) {\n\t\tconst child = node[key];\n\t\tconst resolved = resolveSegments(child, segments);\n\t\t// Defined, not assigned: a key `__proto__` is an own property of parsed JSON.\n\t\tif (resolved !== child)\n\t\t\tObject.defineProperty(node, key, { value: resolved, writable: true, enumerable: true, configurable: true });\n\t}\n\treturn node;\n}\n\n/** Bytes as base64 (the text codec's deflated parts; portable: `btoa` over a binary string, in chunks). */\nfunction base64(bytes: Uint8Array): string {\n\tlet binary = \"\";\n\tfor (let offset = 0; offset < bytes.byteLength; offset += 0x8000) {\n\t\tbinary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));\n\t}\n\treturn btoa(binary);\n}\n\n/** Bytes from base64. Throws on text that is no base64 (a protocol error). */\nfunction fromBase64(text: string): Uint8Array {\n\tconst binary = atob(text);\n\treturn Uint8Array.from(binary, (char) => char.charCodeAt(0));\n}\n"]}

package/dist/link/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/link/websocket.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,IAAI,EAAW,MAAM,WAAW,CAAC;AAE/C,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/E,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/F,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClF,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAClG;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEzD"}

package/dist/link/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/link/websocket.ts"],"names":[],"mappings":"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","sourcesContent":["// WebSocket links (§3): a link over a WebSocket, the browser's or `ws` in Node, typed structurally; binary frames,\n// messages sent while it still connects buffered until it opens.\n\nimport { type Link, LinkEnd } from \"./link.ts\";\n\n/** The part of a WebSocket a link uses (the browser's `WebSocket`, `ws`'s `WebSocket`). */\nexport interface WebSocketLike {\n\t/** 0 connecting, 1 open, 2 closing, 3 closed. */\n\treadonly readyState: number;\n\tbinaryType: string;\n\t/** Typed as the browser's `WebSocket` takes bytes: on an `ArrayBuffer`, never shared memory. */\n\tsend(data: Uint8Array<ArrayBuffer>): void;\n\tclose(): void;\n\taddEventListener(type: \"open\" | \"close\" | \"error\", listener: () => void): void;\n\taddEventListener(type: \"message\", listener: (event: { readonly data: unknown }) => void): void;\n\tremoveEventListener(type: \"open\" | \"close\" | \"error\", listener: () => void): void;\n\tremoveEventListener(type: \"message\", listener: (event: { readonly data: unknown }) => void): void;\n}\n\nconst CONNECTING = 0;\n\nconst OPEN = 1;\n\n/**\n * A link over `socket`, one binary frame per message (`binaryType = \"arraybuffer\"`). Messages sent while it connects\n * wait for `open`; a socket closing or closed already gives a closed link; `close` and `error` close the link once, and\n * so does a text frame (no message of this protocol). A frame above the transport's `maxPayload` closes the socket\n * (code 1009), which closes the link.\n */\nexport function webSocketLink(socket: WebSocketLike): Link {\n\treturn new WebSocketLink(socket);\n}\n\nclass WebSocketLink extends LinkEnd {\n\t/** The socket while the link is open. */\n\t#socket: WebSocketLike | undefined;\n\t/** Messages sent while the socket connects; `undefined` once it is open. */\n\t#connecting: Uint8Array[] | undefined;\n\treadonly #onOpen = (): void => {\n\t\tconst queued = this.#connecting ?? [];\n\t\tthis.#connecting = undefined;\n\t\tfor (const message of queued) this.send(message);\n\t};\n\treadonly #onMessage = (event: { readonly data: unknown }): void => {\n\t\tif (event.data instanceof ArrayBuffer) this.deliver(new Uint8Array(event.data));\n\t\telse this.close();\n\t};\n\treadonly #onError = (): void => this.#end();\n\n\tconstructor(socket: WebSocketLike) {\n\t\tsuper();\n\t\tif (socket.readyState !== CONNECTING && socket.readyState !== OPEN) {\n\t\t\tthis.ended();\n\t\t\treturn;\n\t\t}\n\t\tthis.#socket = socket;\n\t\tsocket.binaryType = \"arraybuffer\";\n\t\tif (socket.readyState === CONNECTING) {\n\t\t\tthis.#connecting = [];\n\t\t\tsocket.addEventListener(\"open\", this.#onOpen);\n\t\t}\n\t\tsocket.addEventListener(\"message\", this.#onMessage);\n\t\t// `error` and `close` stay handled until the socket's own close, after this end closed: `ws` emits an `error`\n\t\t// for a socket closed while it connects, and an unhandled one would end the process.\n\t\tconst onClose = (): void => {\n\t\t\tsocket.removeEventListener(\"close\", onClose);\n\t\t\tsocket.removeEventListener(\"error\", this.#onError);\n\t\t\tthis.#end();\n\t\t};\n\t\tsocket.addEventListener(\"close\", onClose);\n\t\tsocket.addEventListener(\"error\", this.#onError);\n\t}\n\n\tsend(message: Uint8Array): void {\n\t\tconst socket = this.#socket;\n\t\tif (socket === undefined) return;\n\t\tif (this.#connecting !== undefined) {\n\t\t\tthis.#connecting.push(message);\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\t// A link's messages are codec output or received frames, both on plain `ArrayBuffer`s.\n\t\t\tsocket.send(message as Uint8Array<ArrayBuffer>);\n\t\t} catch {\n\t\t\tthis.close();\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tconst socket = this.#socket;\n\t\tif (socket === undefined) return;\n\t\tthis.#end();\n\t\tsocket.close();\n\t}\n\n\t/** Stops listening for frames, drops what waits to be sent and closes this end. */\n\t#end(): void {\n\t\tconst socket = this.#socket;\n\t\tif (socket === undefined) return;\n\t\tthis.#socket = undefined;\n\t\tthis.#connecting = undefined;\n\t\tsocket.removeEventListener(\"open\", this.#onOpen);\n\t\tsocket.removeEventListener(\"message\", this.#onMessage);\n\t\tthis.ended();\n\t}\n}\n"]}

package/dist/node/app/app.d.ts

@@ -0,0 +1,269 @@
+import type { TelemetryContext } from "@earendil-works/pi-telemetry";
+import { type Context } from "../../context/index.ts";
+import { type Address, type HostKind, type KindShape } from "../../contracts/index.ts";
+import type { Principal } from "../../data/index.ts";
+import { type Host, type HostError, type PrincipalAttributes } from "../../host/index.ts";
+import { type JsonValue } from "../../json.ts";
+import { type TelemetryIngestTarget } from "../../telemetry-ingest/index.ts";
+import type { Watchable } from "../../watch.ts";
+import { type HttpComponent, type HttpError, type ListenAddress } from "../http/index.ts";
+import { type HostPackages, type InstallOptions, type PluginSource, type Plugins, type PluginsError, type PluginsState, type RolloutResult } from "../plugins/index.ts";
+import { type TuiSurfaceOptions, type WebSurfaceOptions } from "../surfaces/index.ts";
+import { type Workers, type WorkersError } from "../workers/index.ts";
+import { type FilesCaps } from "./files.ts";
+/** The server's host kind: the kit's server host is `Server()`. */
+export declare const Server: HostKind<"server", Record<never, never>>;
+/**
+ * The app's API (slice 12): its package name, the versions it provides (newest first) and this process's modules of
+ * them by specifier (`@acme/app/v3`, `@acme/app/v3/server`).
+ */
+export type AppApi = {
+    readonly name: string;
+    readonly versions: readonly string[];
+    readonly modules: HostPackages;
+};
+/**
+ * A facet kind of the app: where its builds run, and the packages besides the API its plugins share (`react`). Its API
+ * modules are named by convention: `<api>/<version>` and `<api>/<version>/<kind>` for every version.
+ */
+export type AppKind = {
+    readonly platform: "node" | "browser";
+    readonly packages?: HostPackages;
+};
+/** A worker kind: a host kind of the app and how its workers start (the workers component's options). */
+export type AppWorkerKind<P extends Principal> = {
+    /** The host kind (`hostKind("project", { id: str() })`). */
+    readonly kind: KindShape;
+    /**
+     * The worker's entry module (it calls `startWorker`), bundled with the base code it imports at start (every worker of
+     * the kind runs that snapshot until the server restarts); its Node flags and environment.
+     */
+    readonly entry: string;
+    readonly execArgv?: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+    /** The facet kind its workers load: `worker` by default. */
+    readonly facet?: string;
+    /** The app's start data for the worker at `address` (JSON), before each start. */
+    readonly start: (address: Address, context: Context) => Promise<JsonValue> | JsonValue;
+    /** Whether `principal` may reach the worker at `address` (synchronous). */
+    readonly authorize: (principal: P, address: Address) => boolean;
+    /** How long a worker idles before it stops: 5 minutes by default. */
+    readonly idleMs?: () => number;
+};
+/**
+ * What the kit reports: from its host, its HTTP component, its workers or its plugins, a base that did not build after
+ * the start (`base_build`: `base` is `web`, `tui` or the worker kind's name; the server runs on, the page answers 503,
+ * the kind's workers fail their start), or a failed scan of the server's own code (`server_scan`: the server runs on,
+ * that code is not compared).
+ */
+export type AppError = {
+    readonly kind: "host";
+    readonly error: HostError;
+} | {
+    readonly kind: "http";
+    readonly error: HttpError;
+} | {
+    readonly kind: "workers";
+    readonly error: WorkersError;
+} | {
+    readonly kind: "plugins";
+    readonly error: PluginsError;
+} | {
+    readonly kind: "base_build";
+    readonly base: string;
+    readonly error: unknown;
+} | {
+    readonly kind: "server_scan";
+    readonly error: unknown;
+};
+/**
+ * What `startServer` takes. Worker kinds need `principal.worker`: a type error without it, also for a `workers` list
+ * typed as an array (not a tuple) that is empty.
+ */
+export type AppOptions<P extends Principal> = {
+    /** The app's name: its default data directory is `~/.<name>`, its archives carry it. */
+    readonly name: string;
+    /** The data directory (the start script's to decide; no environment variables): `~/.<name>` by default. */
+    readonly dataDir?: string;
+    /** The app's built-in plugins root (required): `plugins/` of the working directory by default. */
+    readonly root?: string;
+    /** Where the server listens: `127.0.0.1`, a free port by default. */
+    readonly listen?: ListenAddress;
+    readonly api: AppApi;
+    /** The app's facet kinds: `server` and each worker kind's facet kind among them. */
+    readonly kinds: Readonly<Record<string, AppKind>>;
+    /**
+     * The server's principal, each worker's (stamped on its link; only with worker kinds) and the owner's: whom the owner
+     * link, the owner token file and device pairing sign in, and who approves pairings and makes invites (`AppInfo.owner`).
+     * The owner must be strict JSON and not the server's principal (refused at start).
+     */
+    readonly principal: {
+        readonly server: P;
+        readonly worker?: (address: Address) => P;
+        readonly owner: P;
+    };
+    /** The worker kinds; none: a server with clients only. */
+    readonly workers?: readonly AppWorkerKind<P>[];
+    /** The caps of each host's files (the server's and every worker's). */
+    readonly files?: FilesCaps;
+    /** The bounds of what public endpoints and imports may cost. */
+    readonly limits?: AppLimits;
+    /** How installs run npm (slice 12's `InstallOptions`): `npm` on the `PATH` by default. */
+    readonly install?: InstallOptions;
+    /**
+     * The web surface (slice 11): the app's web entry (the base bundle's), its page template, the paths serving the
+     * page (`["/"]`), whether the page is public, the conditions its packages resolve with (the server process's by
+     * default); the `web` facet kind. None: no web surface.
+     */
+    readonly web?: AppWeb;
+    /**
+     * The terminal surface (slice 11): the app's terminal entry and the conditions its packages resolve with (the server
+     * process's by default); the `tui` facet kind. None: no terminal clients.
+     */
+    readonly tui?: Pick<TuiSurfaceOptions, "entry" | "conditions">;
+    /**
+     * The app's telemetry store (§29; decision "The server is the one place telemetry is stored"): the server's host,
+     * its HTTP requests and the kit's ingest record to it (`createSqliteTelemetry`'s store). With one, every worker
+     * records in memory and sends its spans and metrics to the server's `WorkerTelemetry`, and pages that record
+     * (`startPage({ telemetry: true })`) theirs to `PageTelemetry`; carriers join them into one trace. None: NOOP.
+     */
+    readonly telemetry?: TelemetryContext & TelemetryIngestTarget;
+    /**
+     * Who a span was for (`createHost`'s `principalAttributes`): the server's hook, also stamped on the spans pages
+     * send (the principal of their link). Each worker's is its `startWorker`'s.
+     */
+    readonly principalAttributes?: PrincipalAttributes<P>;
+    /**
+     * The app's base code beside what the kit knows (files or directories: its API modules, its start script), hashed at
+     * start: `plugins.state.base` is true while a file differs from what the server or a base bundle read (or a source
+     * file is new in one of the directories). The kit adds every file its base bundles were built from, with the bytes
+     * they read: the web's, the terminal's and each worker kind's.
+     */
+    readonly base?: readonly string[];
+    /**
+     * The `closeTimeout`, `readyTimeout` and `reloadDrainTimeout` of every host (the server's and each worker's): 30 s,
+     * 60 s and 5 s by default.
+     */
+    readonly timeouts?: AppTimeouts;
+    readonly onError: (error: AppError) => void;
+} & ({
+    readonly workers?: readonly [];
+} | {
+    readonly principal: {
+        readonly worker: (address: Address) => P;
+    };
+});
+/**
+ * The bounds of what public endpoints, clients and imports may cost: live ephemeral sessions (1,000; past it the
+ * oldest ends, signed out), pairings under way that anonymous clients started (100 in all, 10 per client address; past
+ * them 429; the owner's own are not counted), uploads under way per `Files` object (64; past it `unavailable`, `busy`),
+ * an archive's unpacked bytes (4 GiB) and entries (100,000).
+ */
+export type AppLimits = {
+    readonly uploads?: number;
+    readonly ephemeralSessions?: number;
+    readonly pendingPairings?: number;
+    readonly pairingsPerAddress?: number;
+    readonly importBytes?: number;
+    readonly importEntries?: number;
+};
+/**
+ * The hosts' timeouts in milliseconds (`HostOptions.closeTimeout`, `HostOptions.readyTimeout`,
+ * `HostOptions.reloadDrainTimeout`).
+ */
+export type AppTimeouts = {
+    readonly closeTimeout?: number;
+    readonly readyTimeout?: number;
+    readonly reloadDrainTimeout?: number;
+};
+/** The kit's web surface options (`webSurface`'s, its kind `web` and plugins the kit's). */
+export type AppWeb = Pick<WebSurfaceOptions, "entry" | "page" | "paths" | "public" | "conditions">;
+/** The plugins of a running app, for its "apply changes" control and its installs. */
+export type AppPlugins = {
+    /** The marks (`dirty`, `install`, `set`, `base`): what the app's button shows. */
+    readonly state: Watchable<PluginsState>;
+    /** Installs plugins from git or npm into the user's root (slice 12's `installPlugin`); their names. */
+    install(source: PluginSource, context: Context): Promise<readonly string[]>;
+    /** The plugins component itself. */
+    readonly component: Plugins;
+};
+/** A running app. */
+export interface App<P extends Principal> {
+    readonly host: Host<P>;
+    readonly http: HttpComponent<P>;
+    /** The workers components, by host kind name. */
+    readonly workers: ReadonlyMap<string, Workers<HostKind>>;
+    readonly plugins: AppPlugins;
+    /**
+     * The web surface, when the app has one: its base bundle's hash once built (`basesBuilt`); `undefined` before, and
+     * when its build failed.
+     */
+    readonly web: {
+        readonly base: string | undefined;
+    } | undefined;
+    /** The terminal surface, when the app has one: its base bundle's hash, as `web`'s. */
+    readonly tui: {
+        readonly base: string | undefined;
+    } | undefined;
+    /** The data directory. */
+    readonly dataDir: string;
+    /** The owner link of this start (single use, 10 minutes): `http://127.0.0.1:<port>/_chord/owner#<token>`. */
+    ownerLink(): string;
+    /** The owner token file's path (a device session of the owner, mode 0600). */
+    readonly ownerTokenFile: string;
+    /**
+     * Settles once every base (the web and terminal base bundles, each worker kind's worker base) was built after the
+     * start, or failed (reported, `base_build`). Never rejects.
+     */
+    readonly basesBuilt: Promise<void>;
+    /**
+     * Settles once the base code is recorded, watched and compared once, after the start: the bases' records (after
+     * `basesBuilt`) and the scan of the server's own code. Until then `plugins.state.base` is not known (`false` may
+     * mean "not compared yet"); a file of the server's own code changed since the process started marks it until a
+     * restart (Node may have loaded other bytes than the scan read).
+     */
+    readonly baseWatched: Promise<void>;
+    /**
+     * Builds the dirty plugins and rolls them out: the server, every worker kind, then the clients; never by itself. Calls
+     * run one after another (a later one builds after the earlier one rolled out).
+     */
+    applyChanges(context: Context): Promise<RolloutResult>;
+    /**
+     * Writes the data the worker at `address` created (its store and finished files) as an archive at `path`, stopping
+     * nothing: a running worker packs its own store at one consistent point; without one the server packs it under the
+     * worker's lock (no worker starts meanwhile).
+     */
+    exportData(address: Address, path: string, context: Context): Promise<void>;
+    /**
+     * Makes the data of `address` (which must have none yet: nothing is overwritten) from the archive at `archive`,
+     * under the worker's lock; its next hold starts it.
+     */
+    importData(archive: string, address: Address, context: Context): Promise<void>;
+    /** Closes the HTTP component, the workers, the host, the store, the watcher and the data directory's lock. */
+    close(context: Context): Promise<void>;
+}
+/** What `startWorker` reads from its start data besides the app's: the kit's part. */
+export type KitStart = {
+    readonly dir: string;
+    readonly facet: string;
+    readonly principal: JsonValue;
+    readonly server: JsonValue;
+    readonly files: {
+        readonly maxFile?: number;
+        readonly maxTotal?: number;
+    };
+    /** Whether the server has a telemetry store: the worker then sends what it records to `WorkerTelemetry`. */
+    readonly telemetry: boolean;
+    /** The cap of uploads under way per `Files` object (`limits.uploads`). */
+    readonly uploads?: number;
+    /** The app's host timeouts (`timeouts`), the worker's host takes them too. */
+    readonly timeouts: AppTimeouts;
+};
+/**
+ * Starts the app's server (§1): resolves once its plugins are loaded and it listens. A failing plugin of the app's
+ * root (or a problem discovery reports there) rejects with the plugins component's `PluginError`, everything closed.
+ * The bases are built right after the listen, from the files as they are then (`basesBuilt`): a page request waits
+ * for its surface's, a worker start for its kind's.
+ */
+export declare function startServer<P extends Principal>(options: AppOptions<P>, context: Context): Promise<App<P>>;
+//# sourceMappingURL=app.d.ts.map

package/dist/node/app/app.d.ts.map

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