@procedures/peer 0.10.0 → 0.12.0

package/dist/host/faces.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The faces of the procedures host (CLI-7): HTTP, WebSocket, MCP and each face that a package adds.
+ *
+ * A face is a factory. The host gives it the handler of its calls, the server, the registry and
+ * the policy. The face gives what it mounts on a listener and its stop parts:
+ *
+ * - `handler`: a request handler for the mount list of a listener. The first match wins.
+ * - `upgrade`: an upgrade handler and the path that it takes.
+ * - `parts`: a transport of the service, for a face that holds work outside its requests (the
+ *   connections of WebSocket).
+ * - `endpoint`: the scheme and the path of the face, for `host.info`.
+ *
+ * `httpFace()` and `wsFace()` are the faces of this package, on `procedureHandler` and
+ * `upgradeHandler` of `@procedures/client/node`. `mcpFace()` of `@procedures/mcp-server` is the
+ * MCP face. A face of another package has the same shape, so the host needs no change for it.
+ */
+import type { IncomingMessage, ServerResponse as NodeResponse } from "node:http";
+import type { Duplex } from "node:stream";
+import type { TransportImpl } from "@mark1russell7/service";
+import { Client, type Clock, type HostPolicy, type ProcedureRegistry, type ProcedureServer } from "@procedures/client";
+import { type ProcedureHandlerOptions, type UpgradeHandlerOptions } from "@procedures/client/node";
+import type { FaceHandler } from "./tracking.js";
+/** What the host gives a face. */
+export interface HostFaceContext {
+    /** The name of the face in the host: the first part of the route of each call. */
+    readonly name: string;
+    /** The handler of the calls of the face: each call goes through the request tracking of the service. */
+    readonly handler: FaceHandler;
+    readonly server: ProcedureServer;
+    readonly registry: ProcedureRegistry;
+    readonly policy: HostPolicy;
+    /** The clock of the host: the clock of the lifecycle. */
+    readonly clock: Clock;
+}
+/** The upgrade handler of a face, and the path or the function that tells which upgrades it takes. */
+export interface HostFaceUpgrade {
+    readonly match: string | ((req: IncomingMessage) => boolean);
+    readonly handler: (req: IncomingMessage, socket: Duplex, head: Buffer) => unknown;
+}
+/** The scheme and the path of a face on a listener, for `host.info`. */
+export interface HostFaceEndpoint {
+    /** The type of the endpoint in `host.info`: `http`, `websocket`, `mcp` or another name. */
+    readonly type: string;
+    readonly scheme: "http" | "ws";
+    readonly path: string;
+}
+/** What a face gives the host. */
+export interface HostFace {
+    /** The request handler of the face. It gives true when it takes a request, and false for another request. */
+    readonly handler?: ((req: IncomingMessage, res: NodeResponse) => boolean) | undefined;
+    readonly upgrade?: HostFaceUpgrade | undefined;
+    /** The stop parts of the face: a transport of the service, with the name `<host>.<face>`. */
+    readonly parts?: TransportImpl | undefined;
+    readonly endpoint?: HostFaceEndpoint | undefined;
+    /** The ids of the connections of the face, for a face of connections (WebSocket). */
+    readonly connections?: (() => string[]) | undefined;
+    /** A client of one connection: its calls go to the procedures that the connected client serves. */
+    readonly clientFor?: ((connectionId: string) => Client | undefined) | undefined;
+}
+/** A face factory: the host calls it one time, with the context of the face. */
+export type HostFaceFactory = (context: HostFaceContext) => HostFace;
+/**
+ * This function gives the HTTP face: `procedureHandler` of `@procedures/client/node`, under
+ * `options.basePath` (default `/api`). The browser checks of the policy apply, and the options win over them.
+ */
+export declare function httpFace(options?: ProcedureHandlerOptions): HostFaceFactory;
+/**
+ * This function gives the WebSocket face: `upgradeHandler` of `@procedures/client/node`, at
+ * `options.path` (default `/ws`).
+ *
+ * - The upgrade: a failed browser check gets 403. A connection that the server does not admit
+ *   gets 401: the token check and the request hook of each call run on the credentials of the
+ *   upgrade (`ProcedureServer.admits`). Thus no idle connection without credentials stays open.
+ * - The stop parts refuse new calls at the stop of the intake. In the drain, each connection
+ *   closes when its calls end, so the drain of the listener does not wait for an idle connection.
+ */
+export declare function wsFace(options?: UpgradeHandlerOptions): HostFaceFactory;
+//# sourceMappingURL=faces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faces.d.ts","sourceRoot":"","sources":["../../src/host/faces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAgD,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrK,OAAO,EAAoC,KAAK,uBAAuB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wGAAwG;IACxG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,sGAAsG;AACtG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACnF;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,QAAQ;IACvB,6GAA6G;IAC7G,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,qFAAqF;IACrF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACpD,mGAAmG;IACnG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACjF;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,QAAQ,CAAC;AAWrE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,uBAA4B,GAAG,eAAe,CAQ/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,qBAA0B,GAAG,eAAe,CA4B3E"}

package/dist/host/faces.js

@@ -0,0 +1,77 @@
+/**
+ * The faces of the procedures host (CLI-7): HTTP, WebSocket, MCP and each face that a package adds.
+ *
+ * A face is a factory. The host gives it the handler of its calls, the server, the registry and
+ * the policy. The face gives what it mounts on a listener and its stop parts:
+ *
+ * - `handler`: a request handler for the mount list of a listener. The first match wins.
+ * - `upgrade`: an upgrade handler and the path that it takes.
+ * - `parts`: a transport of the service, for a face that holds work outside its requests (the
+ *   connections of WebSocket).
+ * - `endpoint`: the scheme and the path of the face, for `host.info`.
+ *
+ * `httpFace()` and `wsFace()` are the faces of this package, on `procedureHandler` and
+ * `upgradeHandler` of `@procedures/client/node`. `mcpFace()` of `@procedures/mcp-server` is the
+ * MCP face. A face of another package has the same shape, so the host needs no change for it.
+ */
+import { Client, requestCredentials } from "@procedures/client";
+import { procedureHandler, upgradeHandler } from "@procedures/client/node";
+/** The browser checks of the policy, as options of a face. The options of the face win over them. */
+function browserOptions(browser, http) {
+    return {
+        ...(browser.allowedOrigins !== undefined ? { allowedOrigins: browser.allowedOrigins } : {}),
+        ...(browser.allowedHosts !== undefined ? { allowedHosts: browser.allowedHosts } : {}),
+        ...(http && browser.allowGet !== undefined ? { allowGet: browser.allowGet } : {}),
+    };
+}
+/**
+ * This function gives the HTTP face: `procedureHandler` of `@procedures/client/node`, under
+ * `options.basePath` (default `/api`). The browser checks of the policy apply, and the options win over them.
+ */
+export function httpFace(options = {}) {
+    return (context) => {
+        const handler = procedureHandler(context.handler, { clock: context.clock, ...browserOptions(context.policy.browser, true), ...options });
+        return {
+            handler: (req, res) => handler(req, res),
+            endpoint: { type: "http", scheme: "http", path: handler.basePath },
+        };
+    };
+}
+/**
+ * This function gives the WebSocket face: `upgradeHandler` of `@procedures/client/node`, at
+ * `options.path` (default `/ws`).
+ *
+ * - The upgrade: a failed browser check gets 403. A connection that the server does not admit
+ *   gets 401: the token check and the request hook of each call run on the credentials of the
+ *   upgrade (`ProcedureServer.admits`). Thus no idle connection without credentials stays open.
+ * - The stop parts refuse new calls at the stop of the intake. In the drain, each connection
+ *   closes when its calls end, so the drain of the listener does not wait for an idle connection.
+ */
+export function wsFace(options = {}) {
+    return (context) => {
+        const { server } = context;
+        const admits = (req) => server.admits(requestCredentials({ headers: req.headers, url: req.url }, { tokenQuery: "token" }));
+        const upgrade = upgradeHandler(context.handler, { ...browserOptions(context.policy.browser, false), authenticate: admits, ...options });
+        const transport = upgrade.transport;
+        return {
+            upgrade: { match: upgrade.path, handler: upgrade },
+            parts: {
+                start: () => upgrade.start(),
+                stopIntake: () => upgrade.stopIntake(),
+                drain: async (deadline, signal) => {
+                    await upgrade.drain(deadline, signal);
+                    // The calls ended, or the cooperative abort came: the connections end in their protocol
+                    await upgrade.close();
+                },
+                inFlight: () => upgrade.inFlight(),
+                close: () => upgrade.close(),
+            },
+            endpoint: { type: "websocket", scheme: "ws", path: upgrade.path },
+            connections: () => transport.getTrackedConnections().map((connection) => connection.id),
+            clientFor: (connectionId) => transport.getTrackedConnection(connectionId) === undefined
+                ? undefined
+                : new Client({ transport: transport.transportFor(connectionId), throwOnError: true }),
+        };
+    };
+}
+//# sourceMappingURL=faces.js.map

package/dist/host/faces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faces.js","sourceRoot":"","sources":["../../src/host/faces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAuG,MAAM,oBAAoB,CAAC;AACrK,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAA4D,MAAM,yBAAyB,CAAC;AA+CrI,qGAAqG;AACrG,SAAS,cAAc,CAAC,OAA4B,EAAE,IAAa;IACjE,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAO,GAA4B,EAAE;IAC5D,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACzI,OAAO;YACL,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;YACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE;SACnE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,OAAO,GAA0B,EAAE;IACxD,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,GAAoB,EAAoB,EAAE,CACxD,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAkC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAChI,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACxI,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;YAClD,KAAK,EAAE;gBACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;gBAC5B,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE;gBACtC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;oBAChC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBACtC,wFAAwF;oBACxF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC;gBACD,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAClC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;aAC7B;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;YACjE,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YACvF,SAAS,EAAE,CAAC,YAAY,EAAE,EAAE,CAC1B,SAAS,CAAC,oBAAoB,CAAC,YAAY,CAAC,KAAK,SAAS;gBACxD,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SAC1F,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/host/index.d.ts

@@ -0,0 +1,186 @@
+/**
+ * The procedures host: one factory for each procedures server in Node (CLI-7, decision D2).
+ *
+ * `createProcedureHost()` builds the server, its faces and its stop parts from one set of
+ * options. It starts nothing and installs no signal handler. The service of the process declares
+ * the parts (`host.declare(svc)`), and only the entry of the process starts `run()`.
+ *
+ * - The faces: HTTP (`procedureHandler`), WebSocket (`upgradeHandler`), MCP (`mcpFace()` of
+ *   `@procedures/mcp-server`) and each face factory of another package.
+ * - A listener that the host owns is an `httpTransport` of `@mark1russell7/service/http`. Its
+ *   faces mount on its mount list, so they share one port. Without a listener, the app mounts
+ *   `host.handler` and `host.upgrade` on its own listener.
+ * - The request tracking: one route pattern for each face, and a function of the idempotency of
+ *   each call (decision D3). Each call is a stream (decision D4).
+ * - The collections: the option `collections` gives the storages, and the host serves
+ *   `collections.<name>.*`. Each storage is a dependency of the service.
+ */
+import type { IncomingMessage, ServerResponse as NodeResponse } from "node:http";
+import type { Duplex } from "node:stream";
+import type { Check, CheckFn, Dependency, DependencyHandle, Operation, OperationOf, ServiceBuilder, TransportImpl } from "@mark1russell7/service";
+import { type HttpKnobs } from "@mark1russell7/service/http";
+import { ProcedureServer, type Client, type Clock, type CollectionProceduresOptions, type CollectionStorage, type HostPolicy, type ProcedurePath, type ProcedureRegistry, type ProcedureServerOptions } from "@procedures/client";
+import type { ProcedureHandlerOptions, UpgradeHandlerOptions } from "@procedures/client/node";
+import { type HostFaceFactory } from "./faces.js";
+/** The knobs of a transport of the service, by the names of the ordering law. */
+export type HostKnobs = Parameters<ServiceBuilder["server"]>[1];
+/**
+ * The knobs of a listener on the computer of a developer, as data. The transport has no defaults,
+ * so the caller gives these values or its own: an idle close of 5 s (the default of Node), a sweep
+ * of the idle connections each second, and a `Retry-After` of 1 s on each 503.
+ */
+export declare const LOCAL_LISTENER_KNOBS: HttpKnobs;
+/** A collection of the host: its storage, and the procedures `collections.<name>.*`. */
+export interface HostCollection {
+    readonly storage: CollectionStorage<unknown>;
+    /**
+     * The procedures `collections.<name>.*`: true (the default), false for none, or the options of
+     * `createCollectionProcedures()` (the query policy, the change events).
+     */
+    readonly procedures?: boolean | CollectionProceduresOptions | undefined;
+}
+/**
+ * The faces of the host. `http` and `ws` take `true`, their options or a face factory. Each other
+ * name takes a face factory, for example `mcp: mcpFace()` of `@procedures/mcp-server`.
+ */
+export interface ProcedureHostFaces {
+    readonly http?: boolean | ProcedureHandlerOptions | HostFaceFactory | undefined;
+    readonly ws?: boolean | UpgradeHandlerOptions | HostFaceFactory | undefined;
+    readonly mcp?: HostFaceFactory | undefined;
+    readonly [face: string]: boolean | ProcedureHandlerOptions | UpgradeHandlerOptions | HostFaceFactory | undefined;
+}
+/** A listener that the host owns: an `httpTransport` of the service on one port. */
+export interface HostListener {
+    /** The name of the listener: its part is `<host>.listen.<name>`. The default is `http`, or the port when the host has more listeners. */
+    readonly name?: string | undefined;
+    /** The port. 0 gives a free port, and `host.info` gives the real one. */
+    readonly port: number;
+    /** The address. The default is `127.0.0.1`: only this computer can reach the procedures. */
+    readonly host?: string | undefined;
+    /** The faces that mount on this listener. The default is each face of the host. */
+    readonly faces?: readonly string[] | undefined;
+    /** The knobs of the transport. They have no defaults: give `LOCAL_LISTENER_KNOBS` or your own. */
+    readonly knobs: HttpKnobs;
+}
+/** The options of `ProcedureServer` that the host and its policy do not give. */
+export type HostServerOptions = Omit<ProcedureServerOptions, "registry" | "collections" | "clock" | "transports" | "expose" | "token" | "principalOf" | "events" | "interceptors">;
+/** The options of `createProcedureHost()`. */
+export interface ProcedureHostOptions {
+    /** The name of the host: the prefix of the names of its parts, and the name of its controller. The default is `procedures`. */
+    readonly name?: string | undefined;
+    /** The id of the host: `host.info` and `host.health` give it as `peerId`. The default is a new id. */
+    readonly id?: string | undefined;
+    /** The registry of the procedures. The default is the global registry. */
+    readonly registry?: ProcedureRegistry | undefined;
+    /** The host policy (`hostPolicy()`): the expose rule, the token, the request hook, the browser checks and the capability. */
+    readonly policy?: HostPolicy | undefined;
+    /** The procedures that the host serves. It wins over the expose rule of the policy. */
+    readonly expose?: ((path: ProcedurePath) => boolean) | undefined;
+    /** True (the default): the host serves each procedure of the registry, also a procedure that the registry gets later. */
+    readonly autoRegister?: boolean | undefined;
+    /** True (the default): the host counts the calls of each procedure for `host.metrics`. */
+    readonly metrics?: boolean | undefined;
+    /** The faces. The default is `{ http: true }`. */
+    readonly faces?: ProcedureHostFaces | undefined;
+    /** The listeners that the host owns. Without them, the app mounts `host.handler` and `host.upgrade`. */
+    readonly listen?: readonly HostListener[] | undefined;
+    /** The collections by name: a storage, or a storage and its procedures. */
+    readonly collections?: Readonly<Record<string, CollectionStorage<unknown> | HostCollection>> | undefined;
+    /** The clock of the host: give the clock of the lifecycle. The default is the clock of the platform. */
+    readonly clock?: Clock | undefined;
+    /** More options of the server: `idempotency`, `authenticate`, `ambientCredentials`, the loggers. */
+    readonly serverOptions?: HostServerOptions | undefined;
+    /** More endpoints for `host.info`, after the endpoints of the listeners, for example `local://in-process`. */
+    readonly endpoints?: readonly HostEndpoint[] | undefined;
+}
+/** A transport of the host for the service: its name, its knobs and its implementation. */
+export interface HostPart {
+    readonly name: string;
+    readonly knobs: HostKnobs;
+    readonly impl: TransportImpl;
+}
+/** A dependency of the host for the service: a storage, as a dependency handle. */
+export interface HostDependency {
+    readonly name: string;
+    readonly spec: Omit<Dependency, "name">;
+    readonly handle: DependencyHandle;
+}
+/** A check of the host for the service, with its function. */
+export interface HostCheck {
+    readonly check: Check;
+    readonly run: CheckFn;
+}
+/** A route pattern of the controller of the host: one for each face (decision D3). */
+export interface HostPattern {
+    readonly pattern: string;
+    readonly operations: Readonly<Record<string, Operation>>;
+    readonly operationOf: OperationOf;
+}
+/** The controller of the calls of the host, for the declaration of the service. */
+export interface HostController {
+    readonly name: string;
+    readonly requires: readonly string[];
+    readonly patterns: readonly HostPattern[];
+}
+/** An endpoint of the host: the type of its face and its address. */
+export interface HostEndpoint {
+    readonly type: string;
+    readonly address: string;
+}
+/** The identity of the host, as `host.info` gives it. */
+export interface HostInfo {
+    readonly id: string;
+    /** The time at which the host was made, from `Date.now()`. */
+    readonly startedAt: number;
+    /** The endpoints of the faces on the listeners of the host. A listener has its address only after its start. */
+    endpoints(): HostEndpoint[];
+    /** The number of the procedures that the host serves now. */
+    procedureCount(): number;
+}
+/** A procedures host: the parts of a service, and the handlers of the faces that the app mounts. */
+export interface ProcedureHost {
+    readonly name: string;
+    readonly id: string;
+    readonly server: ProcedureServer;
+    readonly registry: ProcedureRegistry;
+    readonly policy: HostPolicy;
+    /** The request handler of the faces that are on no listener of the host, for the mount list of the app. */
+    readonly handler: (req: IncomingMessage, res: NodeResponse) => boolean;
+    /** The upgrade handler of the faces that are on no listener of the host. */
+    readonly upgrade: (req: IncomingMessage, socket: Duplex, head: Buffer) => boolean;
+    /** The transports: the procedure server first, then the stop parts of the faces, then each listener of the host. */
+    readonly parts: readonly HostPart[];
+    /** The dependencies: one for each storage of the collections. */
+    readonly dependencies: readonly HostDependency[];
+    readonly checks: readonly HostCheck[];
+    /** The controller of the calls, with one route pattern for each face. */
+    readonly controllers: readonly HostController[];
+    readonly info: HostInfo;
+    /** This method declares the dependencies, the transports, the checks and the controller on the builder of a service. */
+    declare(svc: ServiceBuilder): ServiceBuilder;
+    /** The ids of the connections of the faces of connections (WebSocket). */
+    connections(): string[];
+    /** A client of one connection of a face: its calls go to the procedures that the connected client serves. */
+    clientFor(connectionId: string): Client;
+}
+/**
+ * This function builds a procedures host. It starts nothing: the service of the process starts
+ * its parts (`host.declare(svc)` and `run()`). `createPeer()` declares them in a service of its own.
+ *
+ * @example
+ * ```typescript
+ * const host = createProcedureHost({
+ *   registry,
+ *   policy: hostPolicy({ token }),
+ *   faces: { http: true, ws: true, mcp: mcpFace() },
+ *   listen: [{ port: 3000, knobs: LOCAL_LISTENER_KNOBS }],
+ * });
+ * const svc = host.declare(service("mark").profile(localDev));
+ * ```
+ */
+export declare function createProcedureHost(options?: ProcedureHostOptions): ProcedureHost;
+export { httpFace, wsFace } from "./faces.js";
+export type { HostFace, HostFaceContext, HostFaceEndpoint, HostFaceFactory, HostFaceUpgrade } from "./faces.js";
+export { callOperations, faceHandler, operationOfCall } from "./tracking.js";
+export type { CallDetail, CallOperation, FaceHandler, FaceHandlerOptions } from "./tracking.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/host/index.js

@@ -0,0 +1,257 @@
+/**
+ * The procedures host: one factory for each procedures server in Node (CLI-7, decision D2).
+ *
+ * `createProcedureHost()` builds the server, its faces and its stop parts from one set of
+ * options. It starts nothing and installs no signal handler. The service of the process declares
+ * the parts (`host.declare(svc)`), and only the entry of the process starts `run()`.
+ *
+ * - The faces: HTTP (`procedureHandler`), WebSocket (`upgradeHandler`), MCP (`mcpFace()` of
+ *   `@procedures/mcp-server`) and each face factory of another package.
+ * - A listener that the host owns is an `httpTransport` of `@mark1russell7/service/http`. Its
+ *   faces mount on its mount list, so they share one port. Without a listener, the app mounts
+ *   `host.handler` and `host.upgrade` on its own listener.
+ * - The request tracking: one route pattern for each face, and a function of the idempotency of
+ *   each call (decision D3). Each call is a stream (decision D4).
+ * - The collections: the option `collections` gives the storages, and the host serves
+ *   `collections.<name>.*`. Each storage is a dependency of the service.
+ */
+import { createServer } from "node:http";
+import { httpTransport, pathOf } from "@mark1russell7/service/http";
+import { PROCEDURE_REGISTRY, ProcedureServer, TIMER_DEFAULTS, hostPolicy, hostProcedures, metricsInterceptor, optionalMs, procedureServerOptions, realClock, seconds, } from "@procedures/client";
+import { httpFace, wsFace } from "./faces.js";
+import { callOperations, faceHandler, operationOfCall } from "./tracking.js";
+/**
+ * The knobs of a listener on the computer of a developer, as data. The transport has no defaults,
+ * so the caller gives these values or its own: an idle close of 5 s (the default of Node), a sweep
+ * of the idle connections each second, and a `Retry-After` of 1 s on each 503.
+ */
+export const LOCAL_LISTENER_KNOBS = Object.freeze({
+    server_idle_close: seconds(5),
+    server_idle_sweep_interval: seconds(1),
+    server_retry_after: seconds(1),
+});
+/** The face factory of a name and its value in the options. */
+function factoryOf(name, value) {
+    if (value === undefined || value === false)
+        return undefined;
+    if (typeof value === "function")
+        return value;
+    const options = value === true ? {} : value;
+    if (name === "http")
+        return httpFace(options);
+    if (name === "ws")
+        return wsFace(options);
+    throw new Error(`The face "${name}" of the host needs a face factory, for example mcpFace() of @procedures/mcp-server`);
+}
+/** The storage and the procedures of a collection of the options. */
+function collectionOf(value) {
+    return typeof value.get === "function" ? { storage: value } : value;
+}
+/** The text of an error. */
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** The operations of a storage as a dependency: a read can go again, a write cannot. */
+const STORAGE_OPERATIONS = Object.freeze({ read: { idempotent: true }, write: { idempotent: false } });
+/**
+ * This function builds a procedures host. It starts nothing: the service of the process starts
+ * its parts (`host.declare(svc)` and `run()`). `createPeer()` declares them in a service of its own.
+ *
+ * @example
+ * ```typescript
+ * const host = createProcedureHost({
+ *   registry,
+ *   policy: hostPolicy({ token }),
+ *   faces: { http: true, ws: true, mcp: mcpFace() },
+ *   listen: [{ port: 3000, knobs: LOCAL_LISTENER_KNOBS }],
+ * });
+ * const svc = host.declare(service("mark").profile(localDev));
+ * ```
+ */
+export function createProcedureHost(options = {}) {
+    const name = options.name ?? "procedures";
+    const id = options.id ?? `peer-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const registry = options.registry ?? PROCEDURE_REGISTRY;
+    const policy = options.policy ?? hostPolicy();
+    const clock = options.clock ?? realClock;
+    const startedAt = Date.now();
+    // The server: the policy, the metrics of host.metrics (R19) and the options of the caller
+    const metrics = options.metrics === false ? undefined : metricsInterceptor();
+    const base = procedureServerOptions(policy, registry);
+    const interceptors = [...(base.interceptors ?? []), ...(metrics ? [metrics.interceptor] : [])];
+    const server = new ProcedureServer({
+        ...base,
+        ...options.serverOptions,
+        ...(interceptors.length > 0 ? { interceptors } : {}),
+        autoRegister: options.autoRegister ?? true,
+        registry,
+        clock,
+        ...(options.expose ? { expose: options.expose } : {}),
+    });
+    // The collections, from the option: the storage, and the procedures collections.<name>.*
+    for (const [collection, value] of Object.entries(options.collections ?? {})) {
+        const { storage, procedures } = collectionOf(value);
+        server.useStorage(collection, storage);
+        if (procedures !== false)
+            server.registerCollectionProcedures(collection, procedures === true || procedures === undefined ? undefined : procedures);
+    }
+    // The lifecycle of the service, from the start of the part of the server. Before it, no tracking.
+    let life = null;
+    const idempotency = options.serverOptions?.idempotency;
+    const keyedWindowMs = idempotency === false ? undefined : (optionalMs(idempotency?.ttl, "idempotency.ttl") ?? TIMER_DEFAULTS.idempotency.ttlMs);
+    // The faces
+    const faceSpecs = options.faces ?? { http: true };
+    const faces = new Map();
+    for (const [faceName, value] of Object.entries(faceSpecs)) {
+        const factory = factoryOf(faceName, value);
+        if (!factory)
+            continue;
+        const handler = faceHandler({ server, controller: name, face: faceName, life: () => life, keyed: keyedWindowMs !== undefined });
+        faces.set(faceName, factory({ name: faceName, handler, server, registry, policy, clock }));
+    }
+    // The listeners that the host owns, each one with the faces of its mount list
+    const listeners = options.listen ?? [];
+    const onListener = new Set();
+    const endpoints = [];
+    const listenerParts = listeners.map((listener, index) => {
+        const host = listener.host ?? "127.0.0.1";
+        const listenerName = listener.name ?? (listeners.length === 1 ? "http" : String(listener.port || index));
+        const transport = httpTransport(createServer(), listener.knobs, { listen: { port: listener.port, host }, clock });
+        const mounted = (listener.faces ?? [...faces.keys()]).map((faceName) => {
+            const face = faces.get(faceName);
+            if (!face)
+                throw new Error(`The listener "${listenerName}" names the face "${faceName}", which the host does not have`);
+            onListener.add(faceName);
+            if (face.handler) {
+                const handle = face.handler;
+                transport.mount((req, res) => handle(req, res));
+            }
+            if (face.upgrade) {
+                const upgrade = face.upgrade;
+                transport.upgrade(upgrade.match, (req, socket, head) => {
+                    upgrade.handler(req, socket, head);
+                });
+            }
+            return face;
+        });
+        const shown = host === "0.0.0.0" || host === "::" ? "localhost" : host;
+        endpoints.push(() => {
+            const address = transport.server.address();
+            if (typeof address !== "object" || address === null)
+                return [];
+            return mounted.flatMap((face) => (face.endpoint ? [{ type: face.endpoint.type, address: `${face.endpoint.scheme}://${shown}:${address.port}${face.endpoint.path}` }] : []));
+        });
+        // The faces of a listener of WebSocket only: the error of its listen names WebSocket
+        const what = mounted.every((face) => face.upgrade && !face.handler) ? "WebSocket" : "HTTP";
+        const impl = {
+            start: async (signal, lifecycle) => {
+                try {
+                    await transport.start(signal, lifecycle);
+                }
+                catch (error) {
+                    throw new Error(`The ${what} server cannot listen on ${host}:${listener.port}: ${messageOf(error)}`, { cause: error });
+                }
+            },
+            stopIntake: () => transport.stopIntake(),
+            drain: (deadline, signal) => transport.drain(deadline, signal),
+            inFlight: () => transport.inFlight(),
+            close: () => transport.close(),
+        };
+        return { name: `${name}.listen.${listenerName}`, knobs: transport.knobs, impl };
+    });
+    // The faces on no listener: the app mounts them
+    const appFaces = [...faces.entries()].filter(([faceName]) => !onListener.has(faceName)).map(([, face]) => face);
+    const handler = (req, res) => {
+        for (const face of appFaces)
+            if (face.handler?.(req, res))
+                return true;
+        return false;
+    };
+    const upgrade = (req, socket, head) => {
+        for (const face of appFaces) {
+            const match = face.upgrade?.match;
+            if (match === undefined)
+                continue;
+            if (typeof match === "string" ? pathOf(req.url) === match : match(req)) {
+                face.upgrade.handler(req, socket, head);
+                return true;
+            }
+        }
+        return false;
+    };
+    // The transports: the server first, so its part has the lifecycle before a listener takes a call
+    const serverPart = {
+        name,
+        knobs: {},
+        impl: {
+            start: (_signal, lifecycle) => {
+                life = lifecycle;
+                return server.start();
+            },
+            stopIntake: () => server.stopIntake(),
+            drain: (deadline, signal) => server.drain(deadline, signal),
+            inFlight: () => server.inFlight(),
+            close: () => server.close(),
+        },
+    };
+    const faceParts = [...faces.entries()].flatMap(([faceName, face]) => (face.parts ? [{ name: `${name}.${faceName}`, knobs: {}, impl: face.parts }] : []));
+    const parts = [serverPart, ...faceParts, ...listenerParts];
+    const dependencies = server.storageHandles().map((handle) => ({
+        name: handle.name,
+        spec: { system: null, knobs: {}, operations: STORAGE_OPERATIONS },
+        handle,
+    }));
+    const checks = [];
+    const operations = callOperations(keyedWindowMs);
+    const controllers = [
+        { name, requires: [], patterns: [...faces.keys()].map((faceName) => ({ pattern: `${faceName} *`, operations, operationOf: operationOfCall })) },
+    ];
+    const info = {
+        id,
+        startedAt,
+        endpoints: () => [...endpoints.flatMap((each) => each()), ...(options.endpoints ?? [])],
+        procedureCount: () => server.procedureCount,
+    };
+    // host.health, host.info and host.metrics: pinned on the server, not in the registry (R19)
+    server.registerProcedures(hostProcedures({ id, startedAt, server, endpoints: () => info.endpoints(), ...(metrics ? { metrics } : {}) }));
+    return {
+        name,
+        id,
+        server,
+        registry,
+        policy,
+        handler,
+        upgrade,
+        parts,
+        dependencies,
+        checks,
+        controllers,
+        info,
+        declare(svc) {
+            for (const dependency of dependencies)
+                svc.dependency(dependency.name, dependency.spec, dependency.handle);
+            for (const part of parts)
+                svc.server(part.name, part.knobs, part.impl);
+            for (const { check, run } of checks)
+                svc.check(check, run);
+            for (const controller of controllers) {
+                const builder = svc.controller(controller.name).requires(...controller.requires);
+                for (const pattern of controller.patterns)
+                    builder.pattern(pattern.pattern, pattern.operations, pattern.operationOf);
+            }
+            return svc;
+        },
+        connections: () => [...faces.values()].flatMap((face) => face.connections?.() ?? []),
+        clientFor(connectionId) {
+            for (const face of faces.values()) {
+                const client = face.clientFor?.(connectionId);
+                if (client)
+                    return client;
+            }
+            throw new Error(`Connection not found: ${connectionId}`);
+        },
+    };
+}
+export { httpFace, wsFace } from "./faces.js";
+export { callOperations, faceHandler, operationOfCall } from "./tracking.js";
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

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