@earendil-works/chord 1.1.0 → 1.3.0

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+/** Error codes callers see (guide table). A refused or aborted reload keeps the code of its cause. */
+export declare const CHORD_ERROR_CODES: readonly ["aborted", "contract_mismatch", "forbidden", "gone", "invalid", "not_in_variant", "not_ready", "released", "superseded", "unavailable", "upgrade_conflict", "upgrade_required"];
+export type ChordErrorCode = (typeof CHORD_ERROR_CODES)[number];
+/**
+ * Finer cause inside a code, for logs and tests: e.g. `invalid` + `args`, `result`, `state`, `input`, `implementation`,
+ * `duplicate`, `cycle`, `read_only`, `not_host_lifetime`, `registry_conflict`; `unavailable` + `unknown_type`.
+ */
+export type ChordErrorReason = string;
+export declare class ChordError extends Error {
+    readonly code: ChordErrorCode;
+    readonly reason: ChordErrorReason | undefined;
+    readonly retryable: boolean;
+    readonly details: unknown;
+    constructor(code: ChordErrorCode, message: string, options?: {
+        cause?: unknown;
+        details?: unknown;
+        reason?: ChordErrorReason;
+    });
+}
+export declare const isChordError: (error: unknown, code?: ChordErrorCode) => error is ChordError;
+/** For factories and methods refusing a principal: `throw forbidden()`. */
+export declare const forbidden: (message?: string) => ChordError;
+export declare const invalid: (reason: ChordErrorReason, message: string, details?: unknown) => ChordError;
+/** Keeps a ChordError's code; anything else becomes `unavailable` with the original as cause. */
+export declare const asChordError: (error: unknown, context: string) => ChordError;
+/** Runs every step, then throws one error, or an AggregateError when several failed. */
+export declare function runAll(steps: readonly (() => unknown)[], message: string): Promise<void>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,YAC7B,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,kBAAkB,CACT,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAItC,qBAAa,UAAW,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,YACC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;KAAE,EAU3E;CACD;AAED,eAAO,MAAM,YAAY,UAAW,OAAO,SAAS,cAAc,KAAG,KAAK,IAAI,UACH,CAAC;AAE5E,2EAA2E;AAC3E,eAAO,MAAM,SAAS,wBAA4B,UAAkD,CAAC;AAErG,eAAO,MAAM,OAAO,WAAY,gBAAgB,WAAW,MAAM,YAAY,OAAO,KAAG,UAC/B,CAAC;AAEzD,iGAAiG;AACjG,eAAO,MAAM,YAAY,UAAW,OAAO,WAAW,MAAM,KAAG,UAK1D,CAAC;AAEN,wFAAwF;AACxF,wBAAsB,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F"}

package/dist/errors.js

@@ -0,0 +1,59 @@
+/** Error codes callers see (guide table). A refused or aborted reload keeps the code of its cause. */
+export const CHORD_ERROR_CODES = [
+    "aborted",
+    "contract_mismatch",
+    "forbidden",
+    "gone",
+    "invalid",
+    "not_in_variant",
+    "not_ready",
+    "released",
+    "superseded",
+    "unavailable",
+    "upgrade_conflict",
+    "upgrade_required",
+];
+const RETRYABLE = new Set(["superseded", "upgrade_conflict"]);
+export class ChordError extends Error {
+    code;
+    reason;
+    retryable;
+    details;
+    constructor(code, message, options) {
+        super(`${code}${options?.reason ? `/${options.reason}` : ""}: ${message}`, {
+            cause: options?.cause,
+        });
+        this.name = "ChordError";
+        this.code = code;
+        this.reason = options?.reason;
+        this.retryable = RETRYABLE.has(code);
+        this.details = options?.details;
+    }
+}
+export const isChordError = (error, code) => error instanceof ChordError && (code === undefined || error.code === code);
+/** For factories and methods refusing a principal: `throw forbidden()`. */
+export const forbidden = (message = "forbidden") => new ChordError("forbidden", message);
+export const invalid = (reason, message, details) => new ChordError("invalid", message, { reason, details });
+/** Keeps a ChordError's code; anything else becomes `unavailable` with the original as cause. */
+export const asChordError = (error, context) => error instanceof ChordError
+    ? error
+    : new ChordError("unavailable", `${context}: ${error instanceof Error ? error.message : String(error)}`, {
+        cause: error,
+    });
+/** Runs every step, then throws one error, or an AggregateError when several failed. */
+export async function runAll(steps, message) {
+    const errors = [];
+    for (const step of steps) {
+        try {
+            await step();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    if (errors.length === 1)
+        throw errors[0];
+    if (errors.length > 1)
+        throw new AggregateError(errors, message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,SAAS;IACT,mBAAmB;IACnB,WAAW;IACX,MAAM;IACN,SAAS;IACT,gBAAgB;IAChB,WAAW;IACX,UAAU;IACV,YAAY;IACZ,aAAa;IACb,kBAAkB;IAClB,kBAAkB;CACT,CAAC;AASX,MAAM,SAAS,GAAgC,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE3F,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC3B,IAAI,CAAiB;IACrB,MAAM,CAA+B;IACrC,SAAS,CAAU;IACnB,OAAO,CAAU;IAC1B,YACC,IAAoB,EACpB,OAAe,EACf,OAA2E;QAE3E,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE,EAAE;YAC1E,KAAK,EAAE,OAAO,EAAE,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,CAAC;CACD;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,IAAqB,EAAuB,EAAE,CAC1F,KAAK,YAAY,UAAU,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAE5E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,GAAG,WAAW,EAAc,EAAE,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAwB,EAAE,OAAe,EAAE,OAAiB,EAAc,EAAE,CACnG,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAEzD,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,OAAe,EAAc,EAAE,CAC3E,KAAK,YAAY,UAAU;IAC1B,CAAC,CAAC,KAAK;IACP,CAAC,CAAC,IAAI,UAAU,CAAC,aAAa,EAAE,GAAG,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;QACvG,KAAK,EAAE,KAAK;KACZ,CAAC,CAAC;AAEN,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAiC,EAAE,OAAe;IAC9E,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACJ,MAAM,IAAI,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC","sourcesContent":["/** Error codes callers see (guide table). A refused or aborted reload keeps the code of its cause. */\nexport const CHORD_ERROR_CODES = [\n\t\"aborted\",\n\t\"contract_mismatch\",\n\t\"forbidden\",\n\t\"gone\",\n\t\"invalid\",\n\t\"not_in_variant\",\n\t\"not_ready\",\n\t\"released\",\n\t\"superseded\",\n\t\"unavailable\",\n\t\"upgrade_conflict\",\n\t\"upgrade_required\",\n] as const;\nexport type ChordErrorCode = (typeof CHORD_ERROR_CODES)[number];\n\n/**\n * Finer cause inside a code, for logs and tests: e.g. `invalid` + `args`, `result`, `state`, `input`, `implementation`,\n * `duplicate`, `cycle`, `read_only`, `not_host_lifetime`, `registry_conflict`; `unavailable` + `unknown_type`.\n */\nexport type ChordErrorReason = string;\n\nconst RETRYABLE: ReadonlySet<ChordErrorCode> = new Set([\"superseded\", \"upgrade_conflict\"]);\n\nexport class ChordError extends Error {\n\treadonly code: ChordErrorCode;\n\treadonly reason: ChordErrorReason | undefined;\n\treadonly retryable: boolean;\n\treadonly details: unknown;\n\tconstructor(\n\t\tcode: ChordErrorCode,\n\t\tmessage: string,\n\t\toptions?: { cause?: unknown; details?: unknown; reason?: ChordErrorReason },\n\t) {\n\t\tsuper(`${code}${options?.reason ? `/${options.reason}` : \"\"}: ${message}`, {\n\t\t\tcause: options?.cause,\n\t\t});\n\t\tthis.name = \"ChordError\";\n\t\tthis.code = code;\n\t\tthis.reason = options?.reason;\n\t\tthis.retryable = RETRYABLE.has(code);\n\t\tthis.details = options?.details;\n\t}\n}\n\nexport const isChordError = (error: unknown, code?: ChordErrorCode): error is ChordError =>\n\terror instanceof ChordError && (code === undefined || error.code === code);\n\n/** For factories and methods refusing a principal: `throw forbidden()`. */\nexport const forbidden = (message = \"forbidden\"): ChordError => new ChordError(\"forbidden\", message);\n\nexport const invalid = (reason: ChordErrorReason, message: string, details?: unknown): ChordError =>\n\tnew ChordError(\"invalid\", message, { reason, details });\n\n/** Keeps a ChordError's code; anything else becomes `unavailable` with the original as cause. */\nexport const asChordError = (error: unknown, context: string): ChordError =>\n\terror instanceof ChordError\n\t\t? error\n\t\t: new ChordError(\"unavailable\", `${context}: ${error instanceof Error ? error.message : String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\n/** Runs every step, then throws one error, or an AggregateError when several failed. */\nexport async function runAll(steps: readonly (() => unknown)[], message: string): Promise<void> {\n\tconst errors: unknown[] = [];\n\tfor (const step of steps) {\n\t\ttry {\n\t\t\tawait step();\n\t\t} catch (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t}\n\tif (errors.length === 1) throw errors[0];\n\tif (errors.length > 1) throw new AggregateError(errors, message);\n}\n"]}

package/dist/host.d.ts

@@ -0,0 +1,348 @@
+import { type AcceptOptions, Connection, type LinkOptions, type RelayRef } from "./connection.ts";
+import { type AnyContract, type InputOf, type LocalContract, type LocalDef, type Ref, type RemoteContract, type RemoteDef } from "./contract.ts";
+import type { Link } from "./link.ts";
+import { type Decls, type Factory, type HostCore, ObjectImpl, type RefCore, type RefOwner, type ServeOptionsFor, type Service } from "./object.ts";
+import type { Registry, RegistryTable, RegistryView } from "./registry.ts";
+import { type ReloadOptions, type ReloadReport } from "./reload.ts";
+import { RemoteBinding } from "./remote.ts";
+import type { Ctx, GetOptions } from "./types.ts";
+import type { Frame } from "./wire.ts";
+/**
+ * Registers a factory for a type. Overloaded on the contract's definition (not the contract type) so TypeScript
+ * keeps literal `variant`s in factory returns. `P` is the app's principal type (see `createHost`).
+ */
+export interface Serve<P = unknown> {
+    <D extends RemoteDef>(type: RemoteContract<D>, factory: Factory<RemoteContract<D>, P>, options?: ServeOptionsFor<RemoteContract<D>>): void;
+    <D extends LocalDef>(type: LocalContract<D>, factory: Factory<LocalContract<D>, P>, options?: ServeOptionsFor<LocalContract<D>>): void;
+}
+/**
+ * What a facet's `setup` gets. `serve` registers types; `root` and `registry` give the facet's code that is not a
+ * Chord method, listener or task (Durable tools and hooks, callbacks of native libraries) access to its own host,
+ * so plugins never need a process-global host. Both may be kept and used after `setup` returns.
+ */
+export interface FacetApi<P = unknown> {
+    readonly serve: Serve<P>;
+    /** The host's name (`server`, `session:S1`, ...). */
+    readonly name: string;
+    /** Starts a root on the facet's host (in its current code version at call time). */
+    root<T>(fn: (ctx: Ctx<P>) => T | Promise<T>, options?: RootOptions<P>): Promise<T>;
+    /** The facet's host's registry view (`get(key, ctx)` reads the table of `ctx.codeVersion`). */
+    registry<V>(registry: Registry<V>): RegistryView<V>;
+    /**
+     * Aborted when this run of the facet is no longer installed: a reload that replaced or removed it committed, the reload
+     * that loaded it aborted, or the host closed. While a reload prepares, the installed and the candidate run are both
+     * live.
+     */
+    readonly signal: AbortSignal;
+}
+/** What a facet module exports (default export): the code that serves its types on one host kind. */
+export interface FacetDefinition<P = unknown> {
+    /** Contract tokens this facet consumes; checked against providers at reload. */
+    readonly uses?: readonly AnyContract[];
+    setup(api: FacetApi<P>): void;
+}
+/** A named facet. Modules are named by their URL; reloading a facet replaces everything it served. */
+export interface Facet<P = unknown> extends FacetDefinition<P> {
+    readonly name: string;
+}
+/** `defineFacet<P>(…)`: an app passes its principal type, so factories and contexts see `P`. */
+export declare const defineFacet: <P = unknown>(setup: (api: FacetApi<P>) => void, options?: {
+    readonly uses?: readonly AnyContract[];
+}) => FacetDefinition<P>;
+/** Imports facet modules (fresh copies on every call) and names them by module URL. */
+export type FacetLoader = (modules: readonly (string | URL)[]) => Promise<Facet[]>;
+/** A facet object, or a module (path or URL) whose default export is a FacetDefinition. */
+export type PluginRef<P = unknown> = Facet<P> | string | URL;
+/**
+ * `P` is the app's principal type: who a caller is, JSON-serializable. Chord never makes one up: the app supplies the
+ * host's own (`self`), the one its parent's own requests act as (`connect`), the ones links act as (`accept`) and the
+ * ones routed hosts act as (`Route.principal`).
+ */
+export interface HostOptions<P = unknown> {
+    readonly name?: string;
+    /**
+     * The principal of the host's own code: roots it starts, code inside its objects, and its `lifetime: "host"` objects.
+     * Compared by `principalKey`, so an equal principal from elsewhere reaches the same objects. Not used to infer `P`:
+     * pass the app's type as `createHost<P>(…)`.
+     */
+    readonly self: NoInfer<P>;
+    /** Maps a principal to its object key (should include connection provenance and grant revision). */
+    readonly principalKey?: (principal: P) => string;
+    /** Validates every cell write and exposed state value against its schemas. */
+    readonly dev?: boolean;
+    /** Errors from background work (disposal, listeners, tasks). Defaults to console.error. */
+    readonly onError?: (error: unknown) => void;
+    /**
+     * Milliseconds a reload waits for an object's aborted tasks to finish before it starts their replacements anyway
+     * (reported). Default 5000.
+     */
+    readonly taskStopDeadline?: number;
+    /**
+     * Milliseconds an activation (or a reload's prepare) waits for its references to be ready and hydrated, and an
+     * awaited `get` for its reference, before failing with `unavailable/ready_timeout`. Default 60000.
+     */
+    readonly readyTimeout?: number;
+    /**
+     * Consumer-side linger of remote references: when the last reference to a remote object is released, its binding
+     * stays held, and hydrated, for `types[typeName]` milliseconds, so a reference taken again meanwhile costs nothing
+     * on the link. At most `cap` bindings (default 4) linger; beyond, the least recently released go first. Types not
+     * listed do not linger. (The provider's own `serve(…, { linger })` keeps its object after the last reference.)
+     */
+    readonly linger?: {
+        readonly types?: Readonly<Record<string, number>>;
+        readonly cap?: number;
+    };
+    /** Needed for `load`/`reload` with modules; `nodeLoader` from loader.ts in Node. */
+    readonly loader?: FacetLoader;
+    /** `client` (browser): never a reload participant, never carries roots or code versions. Default `host`. */
+    readonly kind?: "host" | "client";
+    /** The link to this host's parent (server). Can also be set later with `connect`. */
+    readonly upstream?: {
+        readonly link: Link;
+    } & ConnectOptions<P>;
+}
+/** `connect` options: the link's, and the principal its parent's own requests act as. */
+export interface ConnectOptions<P = unknown> extends LinkOptions {
+    /** What a request from the parent acts as when the parent does not forward its caller's principal (its own code). */
+    readonly principal: P;
+}
+/** Where requests for hosts named `prefix…` go (on the server). */
+export interface Route<P = unknown> {
+    /** Checked before resolving (or spawning) and again after: grants may change meanwhile. */
+    authorize(principal: P, hostName: string): boolean | Promise<boolean>;
+    /** A link to the host, spawned if needed. */
+    resolve(hostName: string): Promise<Link>;
+    /** The principal the resolved host acts as when it calls back. */
+    readonly principal: (hostName: string) => P;
+}
+/** Fields a principal must have, equal (`deepEqual`), for an `invalidatePrincipal` pattern. */
+export type PrincipalPattern<P> = P extends object ? {
+    readonly [K in keyof P]?: P[K];
+} : Readonly<Record<string, unknown>>;
+/** `invalidatePrincipal` matches: a predicate (this host only), or a pattern (fields that must be equal; propagates). */
+export type PrincipalMatch<P = unknown> = ((principal: P) => boolean) | PrincipalPattern<P>;
+export interface RootOptions<P = unknown> {
+    readonly principal?: P;
+    readonly signal?: AbortSignal;
+    /** Start the root in a retained code version (links carry code versions). Defaults to the current code version. */
+    readonly codeVersion?: number;
+}
+export interface LoadOptions {
+    /**
+     * Await the activation of the `lifetime: "host"` objects the facets serve (default true). False starts them but
+     * leaves readiness to `host.ready()` (a child host whose objects need its parent, which admits it only later).
+     */
+    readonly awaitHostObjects?: boolean;
+}
+export interface Host<P = unknown> {
+    readonly name: string;
+    readonly codeVersion: number;
+    readonly previousCodeVersion: number | undefined;
+    readonly serve: Serve<P>;
+    /** Installs synchronously, then awaits this facet's host objects unless `awaitHostObjects` is false. */
+    install(facet: Facet<P>, options?: LoadOptions): Promise<void>;
+    /** Installs all facets before awaiting their host objects; referenced objects are created when first referenced. */
+    load(plugins: readonly PluginRef<P>[], options?: LoadOptions): Promise<void>;
+    /** Awaits the host objects present at call time, including those started by `serve` or deferred loads. */
+    ready(): Promise<void>;
+    /**
+     * A reference held until `release()`. Resolves once it is ready: live, with every state member of its variant
+     * (unless `state: false`). Rejects with the activation error, `aborted` (`signal`), or `unavailable/ready_timeout`
+     * after `readyTimeout`; the reference is released then.
+     */
+    get<C extends AnyContract>(type: C, input: InputOf<C>, options?: GetOptions<P> & {
+        readonly signal?: AbortSignal;
+    }): Promise<Ref<C>>;
+    /**
+     * The same reference, synchronously, possibly still `loading`: for UI runtimes that render its status (hooks, a
+     * TUI watch). Its state members throw `not_ready` until it is live.
+     */
+    hold<C extends AnyContract>(type: C, input: InputOf<C>, options?: GetOptions<P>): Ref<C>;
+    root<T>(fn: (ctx: Ctx<P>) => T | Promise<T>, options?: RootOptions<P>): Promise<T>;
+    registry<V>(registry: Registry<V>): RegistryView<V>;
+    /**
+     * Force-disposes every object whose principal matches (never the host's own principal), re-stamps or closes
+     * matching links, and propagates pattern matches to child hosts.
+     */
+    invalidatePrincipal(match: PrincipalMatch<P>): Promise<void>;
+    /** Accepts a child link (a worker or a browser); requests on it act as `options.principal`. */
+    accept(link: Link, options: AcceptOptions<P>): void;
+    /**
+     * Sets (or replaces, after a reconnect) the link to this host's parent; remote references re-hold over it. The
+     * parent's own requests act as `options.principal`; requests it relays act as the principal it forwards.
+     */
+    connect(link: Link, options: ConnectOptions<P>): void;
+    route(prefix: string, route: Route<P>): void;
+    /** Reloads the given facets (modules are re-imported); facets not listed keep running unchanged. */
+    reload(plugins: readonly PluginRef<P>[], options?: ReloadOptions): Promise<ReloadReport>;
+    close(): Promise<void>;
+}
+export interface CodeVersionState {
+    readonly id: number;
+    readonly services: Map<string, Service>;
+    tables: ReadonlyMap<string, RegistryTable<unknown>>;
+    /** Running roots with the number of their calls running here. */
+    readonly roots: Map<string, number>;
+    /** Aborts every root of this code version (forced retirement). */
+    readonly abort: AbortController;
+}
+/** A host whose principals are `P` (the app's type; `unknown` if not given). */
+export declare function createHost<P = unknown>(options: HostOptions<P>): Host<P>;
+export declare class HostImpl implements Host, HostCore {
+    #private;
+    readonly name: string;
+    readonly dev: boolean;
+    readonly principal: unknown;
+    inFactory: number;
+    failed: unknown;
+    readonly objects: Map<string, ObjectImpl>;
+    readonly codeVersions: Map<number, CodeVersionState>;
+    readonly facets: Map<string, Facet<unknown>>;
+    /** The host's own references to its `lifetime: "host"` objects, by type name. */
+    readonly hostObjects: Map<string, RefCore>;
+    readonly kind: "host" | "client";
+    readonly connections: Set<Connection>;
+    upstream: Connection | undefined;
+    /** Shared bindings of this host's remote references, by key (re-held after an upstream reconnect). */
+    readonly bindings: Map<string, RemoteBinding>;
+    /** Child facet modules by host-name prefix, from every committed cluster reload (for reconciling children). */
+    remoteModules: Record<string, string[]>;
+    /** Removal tombstones also reconcile children that connected during a transaction. */
+    remoteRemoved: Record<string, string[]>;
+    current: CodeVersionState;
+    previous: CodeVersionState | undefined;
+    /** The code version a running reload will commit; new types activated during prepare install their implementation for it. */
+    pending: CodeVersionState | undefined;
+    /** Activations of these types wait (reload gate). */
+    /** Types behind a reload gate: new objects of these types are rejected `upgrade_conflict` until commit/abort. */
+    gating: ReadonlySet<string> | undefined;
+    reloading: boolean;
+    readonly taskStopDeadline: number;
+    readonly readyTimeout: number;
+    constructor(options: HostOptions);
+    /** Whether `principal` is the host's own: the same key as `self`. */
+    isSelf(principal: unknown): boolean;
+    get codeVersion(): number;
+    get previousCodeVersion(): number | undefined;
+    /** Allocates the next code version id, or adopts one issued by the coordinating server. */
+    nextCodeVersionId(given?: number): number;
+    report(error: unknown): void;
+    readonly serve: Serve;
+    install(facet: Facet, options?: LoadOptions): Promise<void>;
+    load(plugins: readonly PluginRef[], options?: LoadOptions): Promise<void>;
+    ready(): Promise<void>;
+    /** Turns plugin references into facets, importing modules through the loader. */
+    resolve(plugins: readonly PluginRef[]): Promise<Facet[]>;
+    facetApi(serve: Serve, signal: AbortSignal): FacetApi;
+    /** The installed run of facet `name` is now `run` (or none): the run it replaces is aborted. */
+    facetRunChanged(name: string, run: AbortController | undefined): void;
+    serveInto(services: Map<string, Service>, service: Service): void;
+    startHostObject(service: Service): RefCore;
+    currentCodeVersion(): number;
+    hasCodeVersion(codeVersion: number): boolean;
+    retainedCodeVersions(): Iterable<readonly [number, ReadonlyMap<string, Service>]>;
+    pendingCodeVersion(): number | undefined;
+    /** The current code for a type; a type a running reload adds is served from the pending code version. */
+    service(typeName: string): Service | undefined;
+    addressOf(type: AnyContract, input: unknown, principal: unknown, candidate?: boolean): string;
+    acquire(type: AnyContract, input: unknown, options: GetOptions | undefined, owner: RefOwner, from?: ObjectImpl, candidate?: boolean): RefCore;
+    forget(object: ObjectImpl): void;
+    disposed(object: ObjectImpl): void;
+    touch(rootId: string, object: ObjectImpl): void;
+    root<T>(fn: (ctx: Ctx) => T | Promise<T>, options?: RootOptions): Promise<T>;
+    /**
+     * Runs `fn` inside root `rootId` of `codeVersion`. A root counts as running here (for retirement) while any of its
+     * calls runs here. A root that started here ends when its last call here settles, even if it went out and came back
+     * over a link meanwhile. A foreign root (started elsewhere, arriving `from` a link) keeps its leases on objects
+     * until every link it came over announced its end (`root_end`) or closed, so its re-entry stays grandfathered.
+     */
+    joinRoot<T>(rootId: string, codeVersionId: number, fn: (ctx: Ctx) => T | Promise<T>, options?: {
+        readonly principal?: unknown;
+        readonly signal?: AbortSignal;
+        readonly from?: Connection;
+    }): Promise<T>;
+    /** Remembers that calls of `rootId` went out on `connection`, which must hear when the root ends. */
+    rootSent(rootId: string, connection: Connection): void;
+    /** A root ended (here, or announced by its origin): end its leases and tell the links it went out on. */
+    endRoot(rootId: string): void;
+    /**
+     * `from` announced the end of a foreign root (or closed). Honored only if the root came over `from`: a peer cannot
+     * end leases of roots it never carried. The root ends when no link that brought it remains.
+     */
+    foreignRootEnded(rootId: string, from: Connection): void;
+    /**
+     * Retires the previous code version once no local roots of it remain. A child also waits for its parent to retire
+     * it: roots span hosts, and an old root on the server may still call in.
+     */
+    maybeRetire(): void;
+    /** The previous code version has no roots left here and, on a child host, the parent has retired it. */
+    retirable(): boolean;
+    allowRetire(codeVersion: number): void;
+    /** Calls `watcher` whenever a root ends, the parent allows a retirement, or a code version retires. */
+    watchRetirement(watcher: () => void): () => void;
+    /**
+     * Tells a child that is now in step which code versions this host retired before: every id below the oldest one it
+     * retains (ids only grow). Without it, a child reconciled after those retirements would never hear a `retire` frame for
+     * its own previous code version and would wait for the retire deadline at every reload.
+     */
+    announceRetired(connection: Connection): void;
+    /** Drops the previous code version: its implementations and the declarations only it used. */
+    retire(): void;
+    /**
+     * Drops an object's implementation for `codeVersion` and what only that implementation declared, in disposal order:
+     * resources close (reverse open order) before its references are released.
+     */
+    retireImplementation(object: ObjectImpl, codeVersion: number): void;
+    registry<V>(registry: Registry<V>): RegistryView<V>;
+    /** Builds registry tables from (object, declarations) pairs. Throws registry_conflict. */
+    buildTables(entries: Iterable<readonly [ObjectImpl, Decls]>): Map<string, RegistryTable<unknown>>;
+    /** Live objects with their current declarations; objects waiting for a reload's commit only with `candidates`. */
+    liveDecls(candidates?: boolean): [ObjectImpl, Decls][];
+    checkRegistrations(object: ObjectImpl, decls: Decls): void;
+    registriesChanged(including?: ObjectImpl): void;
+    /** A commit failed midway: from now on this host admits no work (calls fail `unavailable/host_failed`). */
+    fail(error: unknown): void;
+    /** Installs tables for `codeVersion`; subscribers hear about changed tables of the current code version (all tables when `all`). */
+    installTables(codeVersion: CodeVersionState, tables: Map<string, RegistryTable<unknown>>, all?: boolean): void;
+    get<C extends AnyContract>(type: C, input: InputOf<C>, options?: GetOptions & {
+        readonly signal?: AbortSignal;
+    }): Promise<Ref<C>>;
+    hold<C extends AnyContract>(type: C, input: InputOf<C>, options?: GetOptions): Ref<C>;
+    invalidatePrincipal(match: PrincipalMatch): Promise<void>;
+    accept(link: Link, options: AcceptOptions): void;
+    connect(link: Link, options: ConnectOptions): void;
+    route(prefix: string, route: Route): void;
+    /**
+     * A child host announced its code version. In step: usable. Behind: fenced (nothing is routed to it) and reconciled
+     * by a reload of its modules to this host's code version, never by renumbering what it runs. Ahead: impossible,
+     * refused.
+     */
+    peerHello(connection: Connection, codeVersion: number): void;
+    /** The host's reload slot was freed: children that said hello meanwhile are synced or reconciled now. */
+    reloadEnded(): void;
+    /** Resolves once no reload runs on this host. */
+    whenReloadEnded(): Promise<void>;
+    connectionClosed(connection: Connection): void;
+    /** The last reference to `binding` was released: it lingers if its type does (`HostOptions.linger`), else closes. */
+    bindingIdle(binding: RemoteBinding): void;
+    forgetBinding(binding: RemoteBinding): void;
+    /**
+     * Relays a reference from `relay.origin` to the host it names. Relaying needs a route: it is where authorization
+     * lives. The origin's authorization generation is re-checked after every await and right before forwarding, so a
+     * revocation during resolution wins.
+     */
+    relay(relay: RelayRef): Promise<void>;
+    reload(plugins: readonly PluginRef[], options?: ReloadOptions): Promise<ReloadReport>;
+    onReloadFrame(connection: Connection, frame: Extract<Frame, {
+        t: "prepare" | "commit" | "abort";
+    }>): void;
+    rememberRemoteModules(remote: Readonly<Record<string, readonly string[]>> | undefined, remove: Readonly<Record<string, readonly string[]>> | undefined): void;
+    /** The code version id the next reload would commit. */
+    peekNextCodeVersion(): number;
+    /**
+     * Disposes every object, holders before what they reference (a resource's `close` may still use the objects its object
+     * references, local or remote), then closes the links.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

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