@earendil-works/chord 1.4.0 → 1.5.1

package/dist/host/host.d.ts

@@ -0,0 +1,571 @@
+import { type SpanAttributes, type TelemetryContext } from "@earendil-works/pi-telemetry";
+import { type Context } from "../context/index.ts";
+import type { Address, Contract, HostKind, ParamsOf } from "../contracts/index.ts";
+import { type Params } from "../contracts/internal.ts";
+import { ChordError, type FailureCause, type Principal, type PrincipalKeyFunction } from "../data/index.ts";
+import type { TransactionCancelled } from "../documents/internal.ts";
+import type { JsonValue } from "../json.ts";
+import { type Codec, type Compression, type Link, type PartLimits } from "../link/index.ts";
+import type { Registry, RegistryValue } from "../registries/index.ts";
+import { type RegistryError, RegistryRecord } from "../registries/internal.ts";
+import { type HoldRequest, HostLink, Path, type ProviderSide } from "../remote/internal.ts";
+import { Batch, type BatchError } from "../state/internal.ts";
+import type { ChordStore, Store } from "../store/store.ts";
+import { type ChordMetrics } from "../telemetry.ts";
+import type { Watchable } from "../watch.ts";
+import { type ActivityCounts } from "./activity.ts";
+import { Backoff } from "./backoff.ts";
+import { type Caller, type Ctx } from "./ctx.ts";
+import { type Placed } from "./destination.ts";
+import { ChordObject, type Holder } from "./object.ts";
+import { OldWork } from "./old-work.ts";
+import { type Presence } from "./presence.ts";
+import { Binding, type CheckedParams, type Held, type Reference, type Target } from "./reference.ts";
+import { ReloadCycles } from "./reload-cycle.ts";
+import { type RevokedBy } from "./revocation.ts";
+import { type RootOptions } from "./root.ts";
+import { type RouteHandle, type RouteOptions } from "./route.ts";
+import { type PluginFacet } from "./staging.ts";
+import { type UnboundRequest } from "./unbound.ts";
+import { type UnboundLong } from "./unbound-clock.ts";
+/** What `createHost` takes; `R` is the app's revocation type (JSON). */
+export type HostOptions<P extends Principal = Principal, R extends JsonValue = JsonValue> = {
+    /** This host's address (`Session({ id })`): it serves only objects placed there. Without one, a client. */
+    readonly address?: Address;
+    /** Who this host acts as for its own requests; a host without one (a client) has none. */
+    readonly principal?: P;
+    /** The key of a principal in identities; L1's canonical JSON by default. The same function on every host. */
+    readonly principalKey?: PrincipalKeyFunction<P>;
+    /**
+     * The telemetry adapter (§29): this host's root spans (activations, closes, resolves, routines, methods called over
+     * links) and metrics, and the carriers its links extract; NOOP by default, which records nothing and costs one call
+     * per span site.
+     */
+    readonly telemetry?: TelemetryContext;
+    /**
+     * Who a span was for (decision "Who a span was for"): the attributes its method and call spans record for a
+     * principal, in place of the default `chord.principal` (its principal key, capped at 256 characters). Called for
+     * every span recorded with a principal: synchronous and cheap; caching, if any, is the hook's own. The same
+     * function on every host.
+     */
+    readonly principalAttributes?: PrincipalAttributes<P>;
+    /** Everything that fails in the background; every app handles it. */
+    readonly onError: (error: HostError) => void;
+    /** How long a native's close, and an ending object's running calls, are waited for; 30 s by default. */
+    readonly closeTimeout?: number;
+    /** How long an activation attempt, and a `get`, may take until the object is live; 60 s by default. */
+    readonly readyTimeout?: number;
+    /**
+     * How long a reload's restart keeps its old attempt open for old work (its calls, routed calls, its successor's
+     * readiness) before it is sealed and anything still running is cut off (`released`); 5 s by default, at most
+     * `closeTimeout`. Ends in seconds the waits Chord cannot see (a root opened without the method's `ctx`).
+     */
+    readonly reloadDrainTimeout?: number;
+    /**
+     * The heartbeat of every link: a link silent for `ping` ms (15 s by default) sends a `ping`; one silent for `close`
+     * ms (30 s by default), its handshake included, is closed.
+     */
+    readonly heartbeat?: {
+        readonly ping?: number;
+        readonly close?: number;
+    };
+    /**
+     * What revokes a principal (§4): `host.revoke(r)` ends the objects and closes the child links of every principal
+     * `p` whose `revokedBy(p)` holds `r` (compared as canonical JSON). The same function on every host.
+     */
+    readonly revokedBy?: RevokedBy<P, R>;
+    /**
+     * A synchronous compressor (`nodeCompression` for Node): JSON parts above 16 KiB this host originates are deflated
+     * once, and deflated parts it owns inflated in place. Without one (a browser), nothing is compressed and deflated
+     * parts are inflated asynchronously, later messages of their link waiting in order.
+     */
+    readonly compression?: Compression;
+    /**
+     * The store persisted documents and tables live in (`openStore`); the app owns it and closes it after the host.
+     * One open host per store. A `storage_failed` of the store is reported once and closes the host.
+     */
+    readonly store?: Store;
+};
+/** The span attributes recorded for a principal (`HostOptions.principalAttributes`): none, its key, or more. */
+export type PrincipalAttributes<P extends Principal = Principal> = (principal: P) => Readonly<SpanAttributes>;
+/** Where a reported part sits on its object: a routine (`on`, `onLive`) or a native, by kind, from 1 in declaration order. */
+export type Position = {
+    readonly kind: "on" | "onLive" | "native";
+    readonly position: number;
+};
+/**
+ * What `onError` gets, by kind. `object` is the object's type, with its params key when it has params; `failure` is a
+ * `FailureCause`, `error` the plain error.
+ */
+export type HostError = BatchError | RegistryError | UnboundLong | TransactionCancelled | {
+    readonly kind: "activation_failed";
+    readonly object: string;
+    readonly failure: FailureCause;
+}
+/** A live object failed at runtime (a `migrate` failing on access, a stored version newer than the code). */
+ | {
+    readonly kind: "object_failed";
+    readonly object: string;
+    readonly failure: FailureCause;
+}
+/** The host's store stopped after a backend error: the host closes itself (once). */
+ | {
+    readonly kind: "storage_failed";
+    readonly error: unknown;
+} | {
+    readonly kind: "close_failed";
+    readonly object: string;
+    readonly native: Position;
+    readonly error: unknown;
+} | {
+    readonly kind: "close_timeout";
+    readonly object: string;
+    readonly native: Position;
+} | {
+    readonly kind: "drain_timeout";
+    readonly object: string;
+} | {
+    readonly kind: "protocol_error";
+    readonly error: unknown;
+} | {
+    readonly kind: "resolve_failed";
+    readonly address: string;
+    readonly error: unknown;
+}
+/**
+ * A derive's compute threw (its owner's, once per failure episode: the first failure after a value or after its
+ * creation; a value ends the episode); `member` when it is an exposed state member.
+ */
+ | {
+    readonly kind: "derive_failed";
+    readonly object: string;
+    readonly member?: string;
+    readonly error: unknown;
+}
+/**
+ * A live query's run in a commit threw (a row its code cannot read), once per failure episode (a good run ends it):
+ * the query is a failed member until then (`self.query`).
+ */
+ | {
+    readonly kind: "query_failed";
+    readonly object: string;
+    readonly table: string;
+    readonly error: unknown;
+}
+/** A routine's call threw, or its source failed for good; `routine` is its kind and position. */
+ | {
+    readonly kind: "routine_failed";
+    readonly object: string;
+    readonly routine: Position;
+    readonly error: unknown;
+}
+/** A job's `run` threw (not after an abort): its outcome is `failed { threw }`. */
+ | {
+    readonly kind: "job_failed";
+    readonly object: string;
+    readonly job: string;
+    readonly id: string;
+    readonly error: unknown;
+}
+/** A job's `finish` threw: retried with backoff, blocked after five failures in a row. */
+ | {
+    readonly kind: "job_finish_failed";
+    readonly object: string;
+    readonly job: string;
+    readonly id: string;
+    readonly error: unknown;
+}
+/** A persisted run was cut off five times in a row by crashes (D6): it ends `failed { restart_limit }`, `finish` runs. */
+ | {
+    readonly kind: "job_interrupted";
+    readonly object: string;
+    readonly job: string;
+    readonly id: string;
+    readonly restarts: number;
+}
+/** A blocked run was dropped without `finish`: aborted, or its object ended. */
+ | {
+    readonly kind: "job_dropped";
+    readonly object: string;
+    readonly job: string;
+    readonly id: string;
+}
+/**
+ * An attempt parked longer than `readyTimeout` (since `since`, `Date.now()` time), whatever its blocker: once per
+ * parking episode, naming the first blocker in declaration order (`waitingFor`, a reference's label or `registry
+ * <name>`) and its `state`; a diagnostic of a ring across hosts started at the same moment or a long wait (nothing
+ * fails).
+ */
+ | {
+    readonly kind: "parked_long";
+    readonly object: string;
+    readonly waitingFor: string;
+    readonly state: "loading" | "failed";
+    readonly since: number;
+};
+/**
+ * What `accept` and `connect` take: the principal of the host at the other end, as this host stamps it; `trusted` skips
+ * the message check on the link (IPC to the host's own processes; never grants the principal fields); the codec both
+ * ends of the link use (`binaryCodec` by default); and the limits per part of what arrives on it (Q2: none on a
+ * trusted link, 16 MiB on the wire and 64 MiB decoded otherwise, unless set).
+ */
+export type LinkOptions<P extends Principal = Principal> = {
+    readonly principal: P;
+    readonly trusted?: boolean;
+    readonly codec?: Codec;
+    readonly limits?: PartLimits;
+};
+/** What `host.get` and `host.hold` take besides the type, the params and the context. */
+export type GetOptions = {
+    /**
+     * A getter's deadline for its whole wait, and how long a call made while the reference is loading waits (the park
+     * deadline); the host's `readyTimeout` by default.
+     */
+    readonly readyTimeout?: number;
+};
+/**
+ * A host whatever its principal type, as Chord's own parts use it: `ChordHost<P>` is invariant in `P` (`load` takes
+ * facets typed for exactly `P`).
+ */
+export type AnyHost = Omit<ChordHost, "load" | "reload" | "accept" | "connect" | "route" | "references" | "root">;
+/** A host. `P` is the app's principal type, `R` its revocation type. */
+export interface Host<P extends Principal = Principal, R extends JsonValue = JsonValue> {
+    /** This host's address (`HostOptions.address`); `undefined` on a client. */
+    readonly address: Address | undefined;
+    /** This run of the host, sent in every handshake (R20): a link's peer sees it as its calls' `ctx.incarnation`. */
+    readonly incarnation: string;
+    /**
+     * The attributes this host's spans record for `principal`: its `principalAttributes` hook's, else `chord.principal`,
+     * its principal key; none without a principal.
+     */
+    principalAttributes(principal: P | undefined, context: Context): Readonly<SpanAttributes>;
+    /**
+     * Runs every facet's setup and publishes what they declared in one batch (the types and registries served, the
+     * registries composed once, the contributions); holds that waited for the publication are placed after that batch,
+     * and a registry with contributions and no provider is reported (`registry_undeclared`). Then activates every
+     * served type with empty params and resolves when each has had its first outcome (the start barrier, decision (a)):
+     * live, failed by its own cause, parked with no blocker here still without its first outcome, or ended (failures go
+     * to `onError`). A plugin whose setup throws or is refused at declaration (a name given twice, a type or registry
+     * another plugin serves, a remote type here without principal or address, `checkAccepts`) is left out and reported
+     * (`failed`); it never closes the host. A name that is no npm name throws before anything changes. Runs once.
+     */
+    load(facets: readonly PluginFacet<P>[], context: Context): Promise<LoadReport>;
+    /**
+     * Reloads this host's plugins (slice 7b): `facets` is its complete new plugin set; a plugin in it and not loaded
+     * is added, one loaded with another facet value is changed (the same facet object is unchanged: untouched), one
+     * loaded and not in it is removed. Staging runs every new setup and every affected object's new factory against a
+     * recording `self`, per plugin: a plugin whose new code fails there keeps its old code (an added one is left out),
+     * and so does a changed plugin whose recorded requests would not bind because of it (the closure rule); both are
+     * reported (`failed`); `options.failed` names plugins the caller passes as their loaded facet because their new
+     * code failed before (a build, an evaluation): the same for the closure rule and the report. Then it commits in one
+     * batch (types, registries, contributions; a publication waking the requests for the names it serves) and every
+     * object of a changed or removed plugin takes its fate: restarted (its old attempt finishing old work first),
+     * retried, or ended (its type removed). Resolves with the report once every fate started (retries checked their
+     * dependencies; a restart reports what its readiness found at once; it does not wait for objects to go live).
+     * Reloads run one after another. Throws before `load` resolved and for a name that is no npm name (before anything
+     * changes); rejects `released/closed` after `close`; `context`'s abort before the commit rejects `aborted` and
+     * changes nothing, after it only ends the wait (`aborted`, its `details.committed` naming what the commit applied:
+     * `CommittedReload`).
+     */
+    reload(facets: readonly PluginFacet<P>[], context: Context, options?: ReloadOptions): Promise<ReloadReport>;
+    /**
+     * A reference once its object is live (and hydrated). It acts as the host's principal and goes where its type's host
+     * address puts it: here, over a route, or over the parent link (`Destination`). It waits while the reference is
+     * `loading`, `failed { transient }` or `failed { waiting }` until its `readyTimeout`, then rejects with the last
+     * cause and releases the reference; a broken failure rejects at once, and so does a get before `load` (`not_ready`).
+     */
+    get<C extends Contract>(Type: C, params: ParamsOf<C>, context: Context, options?: GetOptions): Promise<Reference<C>>;
+    /**
+     * A reference at once, following its object until released: loading, live, failed (retried as its object is) and
+     * loading again while its link is down; it never rejects. Throws at once only for invalid params and before `load`
+     * (`not_ready`). A type not served where it goes is `failed { waiting }` (bound when a publication serves it;
+     * reported `unbound_long` after 5 s); a `hostAddress` or route that refuses fails it broken. Its `variant` is
+     * `undefined` until its first binding.
+     */
+    hold<C extends Contract>(Type: C, params: ParamsOf<C>, context: Context, options?: GetOptions): Held<C>;
+    /**
+     * A link from a child: this host serves its remote types over it, every hold and call arriving on it acting as
+     * `principal`. `context` is the parent of the work arriving on it (its cancellation is dropped).
+     */
+    accept(link: Link, options: LinkOptions<P>, context: Context): void;
+    /**
+     * This host's parent link: remote types not served here and not routed are held over it, every such reference held
+     * again on a new one; holds arriving on it may name whom they act for. Throws while the previous one is open; once
+     * it closed (a drop), `connect` takes the next. `principal` is who the parent is.
+     */
+    connect(link: Link, options: LinkOptions<P>, context: Context): void;
+    /**
+     * How this host reaches hosts of `Kind` (called before `load`, once per kind): `authorize` admits every hold routed
+     * over it, `resolve` makes the link of an address, for a new hold, on `retry`, or once after a link that completed
+     * its handshake dropped while held (no timer). A rejected `resolve`, or a link closed before its handshake, fails the
+     * address's holders `failed { waiting }` (they stay on its path). `context` is the parent of the route's work (its
+     * `resolve`s, the holds and calls on its links), aborted for it when this host closes. Returns the address controls.
+     */
+    route<N extends string, Q extends Params>(Kind: HostKind<N, Q>, options: RouteOptions<P, HostKind<N, Q>>, context: Context): RouteHandle<HostKind<N, Q>>;
+    /**
+     * Revokes `revocation` (§4, R10, R11), synchronously: every remote object whose principal it revokes (`revokedBy`)
+     * ends at once, whatever references remain (holders get `forbidden`, running calls are aborted, an activation is
+     * abandoned); every child link whose principal it revokes closes (never the parent, never this host's own
+     * principal); and every route link is sent `revoke`, which the host there applies with its own `revokedBy`. Nothing
+     * is replayed to links made later.
+     */
+    revoke(revocation: R, context: Context): void;
+    /**
+     * The references to objects of `Type` on this host (§19), one entry per reference: the object's params, the
+     * principal it acts as (remote types) and its origin, the incarnation of the host it was made for (two tabs are two
+     * origins). Changes in the batch where a reference binds or ends; a link drop is a departure.
+     */
+    references<C extends Contract>(Type: C): Watchable<readonly Presence<C, P>[]>;
+    /**
+     * The work keeping this host busy, for the app's supervisor: holds arriving over links and served here, method
+     * calls running, running jobs and lingering objects; published at most once per microtask turn with changes.
+     */
+    readonly activity: Watchable<ActivityCounts>;
+    /**
+     * Registry `R`'s composed value as `R`'s version sees it, for code outside objects, once it is usable: waits while it
+     * has no value (`unavailable/undeclared` without a provider, a first `compose` that threw, a version not served
+     * here: `contract_mismatch`) until its `readyTimeout`, then rejects with the last error; before `load` it rejects
+     * `not_ready` at once.
+     */
+    registry<C, V>(R: Registry<C, V>, context: Context, options?: GetOptions): Promise<RegistryValue<V>>;
+    /**
+     * Runs `fn` with a call context for code outside objects (a Durable tool, a CLI): the host's principal (or
+     * `options.principal`; an explicit `undefined` runs anonymous), this host's incarnation, `context`'s telemetry and signal, `ctx.get`. When `fn` settles or
+     * `context` aborts, the context is sealed: its signal aborted, `ctx.get` refused `released`, every reference it took
+     * released; an abort rejects at once. `host.close` seals the open ones; after it, `root` rejects `released`.
+     */
+    root<T>(fn: (ctx: Ctx<P>) => Promise<T>, context: Context, options?: RootOptions<P>): Promise<T>;
+    /**
+     * Closes its links, seals its root scopes, then ends every object at once, then drains and closes them one by one,
+     * the last to go live first (reason `close`). Rejects with an `AggregateError` of the closes that threw.
+     */
+    close(context: Context): Promise<void>;
+}
+/** A plugin left out at `load`, or whose new code failed at a reload (it kept its old code, if it had any), and why. */
+export type PluginFailure = {
+    readonly plugin: string;
+    readonly error: unknown;
+};
+/**
+ * What a reload's commit applied, by plugin name: the `details.committed` of the `aborted` error of a reload whose
+ * context aborted after its commit (the commit stands; only the wait for the report ended).
+ */
+export type CommittedReload = {
+    readonly added: readonly string[];
+    readonly changed: readonly string[];
+    readonly removed: readonly string[];
+    /** The plugins whose new code failed: they kept their old code (an added one was left out). */
+    readonly failed: readonly string[];
+};
+/** What `host.reload` takes besides the plugin set: the plugins whose new code failed before it (a build, an evaluation). */
+export type ReloadOptions = {
+    readonly failed?: readonly PluginFailure[];
+};
+/** What `load` did (decision "Per plugin at startup and reload"): the plugins it left out. */
+export type LoadReport = {
+    readonly failed: readonly PluginFailure[];
+};
+/**
+ * What a reload did (slice 7b §1): its plugins by change (those applied), the plugins whose new code failed, and what
+ * every affected object did.
+ */
+export type ReloadReport = {
+    readonly plugins: {
+        readonly added: readonly string[];
+        readonly changed: readonly string[];
+        readonly removed: readonly string[];
+    };
+    readonly failed: readonly PluginFailure[];
+    /** Every live, activating, parked or failed object of a changed or removed plugin, by its label. */
+    readonly objects: readonly ReloadedObject[];
+};
+/**
+ * One object's fate in a reload: `restarted` (its old attempt drained, sealed and closed with reason `reload`, a new
+ * attempt on the new code), `ended` (its type is gone), `parked` (its new code waits for a failed dependency,
+ * `cause`), or `retried` (it was failed, parked or activating: a new attempt runs on the new code).
+ */
+export type ReloadedObject = {
+    readonly object: string;
+} & ({
+    readonly kind: "restarted";
+} | {
+    readonly kind: "ended";
+} | {
+    readonly kind: "parked";
+    readonly cause: FailureCause;
+} | {
+    readonly kind: "retried";
+});
+/**
+ * What a hold placed here binds to (`serving`): its object, or why it waits unbound (`failed { waiting }`: not served,
+ * another version, or placed elsewhere by the provider's code).
+ */
+export type Serving = {
+    readonly kind: "object";
+    readonly object: ChordObject;
+} | {
+    readonly kind: "waiting";
+    readonly cause: FailureCause;
+};
+/** Creates a host. */
+export declare function createHost<P extends Principal = Principal, R extends JsonValue = JsonValue>(options: HostOptions<P, R>): Host<P, R>;
+/** The host: its served types, its objects by identity, its batch, backoff and endings. */
+export declare class ChordHost<P extends Principal = Principal, R extends JsonValue = JsonValue> implements Host<P, R> {
+    #private;
+    readonly batch: Batch;
+    readonly timeouts: {
+        readonly close: number;
+        readonly ready: number;
+        readonly reload: number;
+    };
+    /** Its old work during reloads (whether a context runs under it): see `old-work.ts`. */
+    readonly oldWork: OldWork;
+    /** The waits of old work on objects that are not live, cut at once when they cycle through their own drain. */
+    readonly reloadCycles: ReloadCycles;
+    readonly backoff: Backoff;
+    readonly address: Address | undefined;
+    readonly principal: P | undefined;
+    /** This run of the host, sent in every handshake (R20). */
+    readonly incarnation: string;
+    readonly compression: Compression | undefined;
+    /** The host's store, if it has one. */
+    readonly store: ChordStore | undefined;
+    /** The telemetry adapter: root spans start on it, carriers from links are extracted with it. */
+    readonly telemetry: TelemetryContext;
+    /** The `chord.host` attribute of this host's spans: its address key, `client` without an address. */
+    readonly spanHost: string;
+    /** Chord's instruments on the adapter's metrics: the host's own counts (links, holds, calls, commits). */
+    readonly metrics: ChordMetrics;
+    /**
+     * Remote references failed for a part past a link's limits: on no link's path (no reconnect holds them, no route
+     * resolves for them) until `ref.retry()` places them anew; ended at `close` like the others.
+     */
+    readonly unplaced: Path;
+    /** The downstream origins this host relays holds for, by their number on upstream links (never reused). */
+    readonly relays: Map<number, ProviderSide>;
+    constructor(options: HostOptions<P>);
+    load(facets: readonly PluginFacet<P>[], context: Context): Promise<LoadReport>;
+    reload(facets: readonly PluginFacet<P>[], context: Context, options?: ReloadOptions): Promise<ReloadReport>;
+    get<C extends Contract>(Type: C, params: ParamsOf<C>, context: Context, options?: GetOptions): Promise<Reference<C>>;
+    hold<C extends Contract>(Type: C, params: ParamsOf<C>, context: Context, options?: GetOptions): Held<C>;
+    accept(link: Link, options: LinkOptions<P>, context: Context): void;
+    connect(link: Link, options: LinkOptions<P>, context: Context): void;
+    route<N extends string, Q extends Params>(Kind: HostKind<N, Q>, options: RouteOptions<P, HostKind<N, Q>>, context: Context): RouteHandle<HostKind<N, Q>>;
+    revoke(revocation: R, context: Context): void;
+    get activity(): Watchable<ActivityCounts>;
+    references<C extends Contract>(Type: C): Watchable<readonly Presence<C, P>[]>;
+    registry<C, V>(R: Registry<C, V>, context: Context, options?: GetOptions): Promise<RegistryValue<V>>;
+    root<T>(fn: (ctx: Ctx<P>) => Promise<T>, context: Context, options?: RootOptions<P>): Promise<T>;
+    principalAttributes(principal: P | undefined, context: Context): Readonly<SpanAttributes>;
+    /**
+     * The names requests here wait for unbound that no plugin here serves (types and registries: `not_served`), sorted;
+     * a name served at another version (`version`) is not among them.
+     */
+    unservedNames(): string[];
+    /** How many objects here have an activation under way (`ChordObject.activating`). */
+    activationsUnderWay(): number;
+    /** The registries with contributions here and no provider, each with the newest version contributed, by name. */
+    undeclaredRegistries(): {
+        readonly name: string;
+        readonly version: number;
+    }[];
+    /** The record of registry `name` on this host, made by its first use. */
+    registryRecord(name: string): RegistryRecord;
+    close(_context: Context): Promise<void>;
+    /**
+     * Whether the host published its setups (`load`'s batch): until then requests made here and holds arriving wait in
+     * the unbound index, placed by the publication.
+     */
+    get published(): boolean;
+    /**
+     * `request` cannot bind yet: indexed under `name` (the type or registry it waits for) until woken or ended, waiting
+     * for the publication (no `cause`) or for a provider that fits (`cause`).
+     */
+    index(name: string, request: UnboundRequest, cause: FailureCause | undefined): void;
+    /**
+     * `binding`, whose object left it (its type removed, its version no longer bound: slice 7b §6), waits unbound with
+     * `cause` under its type's name; a publication places it again (`params` checked as it was, under `context`).
+     */
+    rewait(binding: Binding, Type: Contract, params: CheckedParams, cause: FailureCause, context: Context): void;
+    /** `request` left the unbound index's wait for `name` (it ended, or a retry checks it again). */
+    unindex(name: string, request: UnboundRequest): void;
+    /** Whether the host closes: its objects end through `close`, not through its links. */
+    get closing(): boolean;
+    /**
+     * A reference to `Type` made by `caller` (its principal, its origin's incarnation), once it is live (`host.get`,
+     * `ctx.get`): a hold, waited for up to the getter's one deadline, across reconnects and through `loading`,
+     * `failed { transient }` and `failed { waiting }`; a broken failure rejects at once, the deadline with the last
+     * failure's error. A getter that gives up releases its reference.
+     */
+    acquire(Type: Contract, params: unknown, caller: Caller, context: Context, options: GetOptions): Promise<Binding>;
+    /**
+     * `waiting` (a getter's or a gate's wait on `target`, for `contract`'s version) as `context` makes it: as old work it
+     * is cut at once with `unavailable/reload_cycle` when it cycles through that work's own drain (`ReloadCycles`);
+     * otherwise as it is.
+     */
+    waitAsOldWork<T>(waiting: Promise<T>, target: ChordObject, contract: Contract, context: Context): Promise<T>;
+    /** Adds `delta` to the keep-alive count of `kind` (`host.activity`), where the work happens. */
+    count(kind: keyof ActivityCounts, delta: number): void;
+    /** `holder` references `object`: listed in its type's presence, if someone asked for it and it is listed. */
+    referenced(object: ChordObject, holder: Holder, context: Context): void;
+    /** `holders` of `object` ended: gone from its type's presence. */
+    unreferenced(object: ChordObject, holders: Iterable<Holder>, context: Context): void;
+    /** Reports a background failure to `onError`; a throwing `onError` has nowhere left to report to. */
+    report(error: HostError): void;
+    /**
+     * An unbound reference to an object of `Type` made by `caller`, declared by `dependent` (`undefined` for
+     * `host.get`, `host.hold` and `ctx.get`).
+     */
+    reference(Type: Contract, dependent: ChordObject | undefined, caller: Caller, options: GetOptions): Binding;
+    /**
+     * Binds `binding` to the object for (Type, params) as its principal where its host address puts it (`Destination`):
+     * the object here, created with its first attempt if there is none, or a remote object held over its path. Placed
+     * here, the check is only against the type served here: not served (or of the other kind) or not at the caller's
+     * version and fingerprint, the reference waits unbound, `failed { waiting }`, indexed under the type's name. Returns
+     * the object it bound to; throws as `Destination.reference` does (a broken refusal).
+     */
+    bind(binding: Binding, Type: Contract, params: CheckedParams, context: Context): Target | undefined;
+    /** Where a hold arriving on `link` goes (`Destination.hold`: by the address it names); `released` once the host closed. */
+    place(request: HoldRequest, link: HostLink, caller: Caller, context: Context): Placed;
+    /**
+     * What a hold placed here binds to, acting as `principal`: the object, or why it waits unbound (`failed
+     * { waiting }`): a remote type not served here (`not_served`), not at the hold's version and fingerprint, or whose
+     * params put it on another host (code skew: `version`). Throws for a broken refusal: invalid params, an activation
+     * the hold's chain waits for (`invalid/cycle`, Q5). A new object keeps the hold's chain.
+     */
+    serving(request: HoldRequest, params: unknown, principal: Principal, context: Context): Serving;
+    /**
+     * The path a remote reference of `Type` with `params` acting as `principal` goes over now: `ref.retry()` places a
+     * reference failed for a part past the limits anew (a route may have forgotten its old path). Throws as
+     * `Destination.reference` does, and `unavailable` for a type placed here now.
+     */
+    pathOf(Type: Contract, params: ParamsOf<Contract>, principal: Principal | undefined): Path;
+    /**
+     * The `invalid/cycle` error of a cycle through `chain` (Q5): its entries from the activation `id` on, by label
+     * where the object is on this host ("…" for other hosts'), then `closing`.
+     */
+    cycle(chain: readonly string[], id: string, closing: readonly string[]): ChordError;
+    /** A new origin number for `side`, which relays holds upstream; registered in `relays` until it closes. */
+    relayOrigin(side: ProviderSide): number;
+    /**
+     * A route's link, its work under the route's `context`: registered with the host and its heartbeat; one closed
+     * already is returned closed.
+     */
+    routeLink(link: Link, options: LinkOptions<Principal>, context: Context): HostLink;
+    /** A link completed its handshake: a route's address resolves again once if it drops. */
+    linkOpened(link: HostLink): void;
+    /**
+     * Forgets a link once it closed: the origins relaying to it, then the parent's path or its route's address are
+     * told; the heartbeat may stop.
+     */
+    unlink(link: HostLink): void;
+    /** Moves `object` behind every object that went live before it (close ends in reverse); its backoff is over. */
+    wentLive(object: ChordObject): void;
+    /** Drops an ended object (once, before a next instance of its identity exists). */
+    forget(object: ChordObject): void;
+    /** Records a teardown for `identity`: its next attempt waits for it and for every earlier one still running. */
+    ending(identity: string, teardown: Promise<void>): void;
+    /** What the next attempt for `identity` waits for: its previous instances' teardowns, if any still run. */
+    endingOf(identity: string): Promise<void> | undefined;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host/host.d.ts.map

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