@toa.io/extensions.exposition 1.0.0-alpha.34 → 1.0.0-alpha.340

package/transpiled/Endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"Endpoint.js","sourceRoot":"","sources":["../source/Endpoint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Endpoint.js","sourceRoot":"","sources":["../source/Endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAClD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AAOvC,wFAAwF;AACxF,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAEpC,MAAM,OAAO,QAAQ;IACF,QAAQ,CAAQ;IAChB,OAAO,CAAS;IAChB,SAAS,CAAiB;IACnC,MAAM,GAAkB,IAAI,CAAA;IAEpC,+FAA+F;IAC9E,IAAI,CAAS;IAE9B,kFAAkF;IAC1E,aAAa,GAAyB,IAAI,CAAA;IAElD,sCAAsC;IACtC,YACE,QAAgB,EAChB,OAAgB,EAChB,SAA0B,EAC1B,IAAI,GAAY,KAAK;QAErB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,OAAqC,EACrC,UAA2B;QAE3B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QACzD,uFAAuF;QACvF,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;QAEpD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAE9E,6EAA6E;QAC7E,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QAEvE,8EAA8E;QAC9E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAEjE;;;;WAIG;QACH,IACE,OAAO,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS;YACnC,OAAO,CAAC,KAAK,KAAK,IAAI;YACtB,CAAC,OAAO,CAAC,UAAU;YAEnB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;QAExB,wFAAwF;QACxF,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA;QAE1D,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAEpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAE9D,wFAAwF;QACxF,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;YAAE,MAAM,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAA;QAErE,IAAI,KAAK,YAAY,KAAK;YAAE,MAAM,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;QAErE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAEzD,sFAAsF;QACtF,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,IAAI,KAAK,CAAC,kBAAkB;YAC1D,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAEtC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;IACnF,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;IACjC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,UAA2B;QAC9C,IAAI,CAAC,aAAa,KAAK,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;QAExD,0EAA0E;QAC1E,OAAO,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,UAAU,CAAC,UAA2B;QAClD,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAEpC,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;QAE3E,wFAAwF;QACxF,yFAAyF;QACzF,yFAAyF;QACzF,OAAO,SAAS,CAAC,WAAW,CAAA;QAE5B,IAAI,KAAK,GAAkC,IAAI,CAAA;QAE/C,uFAAuF;QACvF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;YAE9C,IAAI,MAAM,KAAK,SAAS;gBAAE,SAAQ;YAElC,KAAK,KAAK,EAAE,CAAA;YACZ,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;QAChC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;QAC1C,MAAM,aAAa,GAAkB,EAAE,CAAA;QAEvC,IAAI,KAAK,KAAK,IAAI;YAAE,aAAa,CAAC,KAAK,GAAG,KAAK,CAAA;QAE/C,IAAI,KAAK,KAAK,IAAI;YAAE,aAAa,CAAC,KAAK,GAAG,KAAK,CAAA;QAE/C,IAAI,SAAS,KAAK,IAAI;YAAE,aAAa,CAAC,SAAS,GAAG,SAAS,CAAA;QAE3D,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;QAEvC,OAAO,aAAa,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAEpC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IACzC,CAAC;IAEO,KAAK,CAAC,OAAqB;QACjC,oEAAoE;QACpE,MAAM,KAAK,GACT,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC/E,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAEhD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAEpF,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QAE3B,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;QAE/D,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAED,MAAM,OAAO,gBAAgB;IACV,OAAO,CAAS;IAEjC,YAAmB,OAAgB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,MAAM,CAAC,MAAyB,EAAE,OAAgB;QACvD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAC9B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAE3D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAC5B,MAAM,CAAC,OAAO,CAAC,KAAK,EACpB,MAAM,CAAC,OAAO,CAAC,KAAK,EACpB,MAAM,CAAC,OAAO,CAAC,QAAQ,CACxB,CAAA;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAA;QAEhC,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,SAAS,CAAA;QAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,SAAS,CAAA;QAE/D,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;YACpD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QAEjE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;QAE/E,OAAO,IAAI,QAAQ,CACjB,MAAM,CAAC,OAAO,CAAC,QAAQ,EACvB,OAAO,EACP,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CACtB,CAAA;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;AAErC,MAAM,SAAS,GAAG,IAAI,CAAA;AAEtB;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,QAAQ,CAAC,OAAqC,EAAE,GAAW;IAClE,OAAO,QAAQ,CAAC,MAAM,CACpB,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,SAAS,EACjC,GAAG,EACH,OAAO,CAAC,OAAO,CAAC,MAAM,EACtB,OAAO,CAAC,GAAG,CAAC,QAAQ,CACrB,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,SAAS,GAAG,EAAE,CAAA;AAEpB,MAAM,eAAe,GAAG,iBAAiB,CAAA"}

package/transpiled/Factory.d.ts

@@ -1,9 +1,29 @@
-import { syntax } from './RTD';
-import type { Connector, Locator, extensions } from '@toa.io/core';
+import { Realtime } from './realtime/Factory.ts';
+import type { syntax } from './RTD/index.ts';
+import type { Connector, Contract, Locator } from '@toa.io/core';
+import type { extensions } from '@toa.io/core/types';
 export declare class Factory implements extensions.Factory {
-    private readonly boot;
-    constructor(boot: Bootloader);
-    tenant(locator: Locator, node: syntax.Node): Connector;
-    service(): Connector | null;
+    /** `realtime`, declared beside `exposition`: the routes of a component's events to streams */
+    readonly keys: {
+        realtime: Realtime;
+    };
+    private readonly host;
+    private announcing;
+    private announcements;
+    constructor(host: Host);
+    tenant(locator: Locator, node: syntax.Node, manifest: Manifest): Promise<Connector>;
+    /**
+     * The announcements this process holds, made if there are none. A factory is loaded once and
+     * outlives every composition it hands a tenant to, so what it remembers is replaced rather
+     * than handed out again once it has been taken down.
+     */
+    private shared;
+    private announce;
+    service(): Promise<Connector | null>;
 }
-export type Bootloader = typeof import('@toa.io/boot');
+export type Host = extensions.Host;
+/** What a tenant reads of the component it announces: what it provides, and which version. */
+type Manifest = Contract & {
+    version: string;
+};
+export {};

package/transpiled/Factory.js

@@ -1,74 +1,55 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+import { createHash } from 'node:crypto';
+import { contract } from '@toa.io/core';
+import { Announcements } from './Announcements.js';
+import { Tenant } from './Tenant.js';
+import { Realtime } from './realtime/Factory.js';
+import { CHANNEL } from '@toa.io/definitions/extensions.exposition';
+export class Factory {
+    /** `realtime`, declared beside `exposition`: the routes of a component's events to streams */
+    keys = { realtime: new Realtime() };
+    host;
+    announcing;
+    announcements;
+    constructor(host) {
+        this.host = host;
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Factory = void 0;
-const node_assert_1 = __importDefault(require("node:assert"));
-const generic_1 = require("@toa.io/generic");
-const Tenant_1 = require("./Tenant");
-const Gateway_1 = require("./Gateway");
-const Remotes_1 = require("./Remotes");
-const RTD_1 = require("./RTD");
-const Endpoint_1 = require("./Endpoint");
-const directives_1 = require("./directives");
-const Directive_1 = require("./Directive");
-const Composition_1 = require("./Composition");
-const root = __importStar(require("./root"));
-const Interception_1 = require("./Interception");
-const http = __importStar(require("./HTTP"));
-class Factory {
-    boot;
-    constructor(boot) {
-        this.boot = boot;
+    async tenant(locator, node, manifest) {
+        const announcements = await this.shared();
+        const routes = createHash('sha256').update(JSON.stringify(node)).digest('hex');
+        // no timestamp: the tenant stamps each announcement with its own start time
+        const branch = {
+            // boot only ever hands a tenant a component's locator, which always has a namespace
+            namespace: locator.namespace,
+            component: locator.name,
+            isolated: locator.namespace === 'identity',
+            node,
+            version: manifest.version,
+            contract: contract.component(manifest),
+            routes
+        };
+        return new Tenant(announcements, branch);
     }
-    tenant(locator, node) {
-        const broadcast = this.boot.bindings.broadcast(CHANNEL, locator.id);
-        return new Tenant_1.Tenant(broadcast, locator, node);
+    /**
+     * The announcements this process holds, made if there are none. A factory is loaded once and
+     * outlives every composition it hands a tenant to, so what it remembers is replaced rather
+     * than handed out again once it has been taken down.
+     */
+    async shared() {
+        if (this.announcements?.disposed === true) {
+            this.announcing = undefined;
+            this.announcements = undefined;
+        }
+        this.announcing ??= this.announce();
+        return await this.announcing;
     }
-    service() {
-        node_assert_1.default.ok(process.env.TOA_EXPOSITION_PROPERTIES, 'TOA_EXPOSITION_PROPERTIES is undefined');
-        const options = (0, generic_1.decode)(process.env.TOA_EXPOSITION_PROPERTIES);
-        const broadcast = this.boot.bindings.broadcast(CHANNEL);
-        const server = http.Server.create({ ...options, methods: RTD_1.syntax.verbs });
-        const remotes = new Remotes_1.Remotes(this.boot);
-        const node = root.resolve();
-        const methods = new Endpoint_1.EndpointsFactory(remotes);
-        const directives = new Directive_1.DirectivesFactory(directives_1.families, remotes);
-        const interception = new Interception_1.Interception(directives_1.interceptors);
-        const tree = new RTD_1.Tree(node, methods, directives);
-        const composition = new Composition_1.Composition(this.boot);
-        const gateway = new Gateway_1.Gateway(broadcast, tree, interception);
-        gateway.depends(remotes);
-        gateway.depends(composition);
-        server.attach(gateway.process.bind(gateway));
-        server.depends(gateway);
-        return server;
+    async announce() {
+        const announcements = new Announcements(await this.host.broadcast(CHANNEL));
+        this.announcements = announcements;
+        return announcements;
+    }
+    async service() {
+        const { service } = await import('./service.js');
+        return await service(this.host);
     }
 }
-exports.Factory = Factory;
-const CHANNEL = 'exposition';
 //# sourceMappingURL=Factory.js.map

package/transpiled/Factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAAgC;AAChC,6CAAwC;AACxC,qCAAiC;AACjC,uCAAmC;AACnC,uCAAmC;AACnC,+BAAoC;AACpC,yCAA6C;AAC7C,6CAAqD;AACrD,2CAA+C;AAC/C,+CAA2C;AAC3C,6CAA8B;AAC9B,iDAA6C;AAC7C,6CAA8B;AAI9B,MAAa,OAAO;IACD,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,MAAM,CAAE,OAAgB,EAAE,IAAiB;QAChD,MAAM,SAAS,GAAc,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QAE9E,OAAO,IAAI,eAAM,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAC7C,CAAC;IAEM,OAAO;QACZ,qBAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAC7C,wCAAwC,CAAC,CAAA;QAE3C,MAAM,OAAO,GAAG,IAAA,gBAAM,EAAe,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;QAC3E,MAAM,SAAS,GAAc,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,YAAM,CAAC,KAAK,EAAE,CAAC,CAAA;QACxE,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAC3B,MAAM,OAAO,GAAG,IAAI,2BAAgB,CAAC,OAAO,CAAC,CAAA;QAC7C,MAAM,UAAU,GAAG,IAAI,6BAAiB,CAAC,qBAAQ,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,IAAI,2BAAY,CAAC,yBAAY,CAAC,CAAA;QACnD,MAAM,IAAI,GAAG,IAAI,UAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;QAEhD,MAAM,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QAE1D,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACxB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;QAC5C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAEvB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAtCD,0BAsCC;AAED,MAAM,OAAO,GAAG,YAAY,CAAA"}
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,2CAA2C,CAAA;AAMnE,MAAM,OAAO,OAAO;IAClB,8FAA8F;IAC9E,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,QAAQ,EAAE,EAAE,CAAA;IAElC,IAAI,CAAM;IACnB,UAAU,CAAoC;IAC9C,aAAa,CAA2B;IAEhD,YAAmB,IAAU;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,MAAM,CACjB,OAAgB,EAChB,IAAiB,EACjB,QAAkB;QAElB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACzC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAE9E,4EAA4E;QAC5E,MAAM,MAAM,GAA8B;YACxC,oFAAoF;YACpF,SAAS,EAAE,OAAO,CAAC,SAAU;YAC7B,SAAS,EAAE,OAAO,CAAC,IAAI;YACvB,QAAQ,EAAE,OAAO,CAAC,SAAS,KAAK,UAAU;YAC1C,IAAI;YACJ,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtC,MAAM;SACP,CAAA;QAED,OAAO,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,MAAM;QAClB,IAAI,IAAI,CAAC,aAAa,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;YAC3B,IAAI,CAAC,aAAa,GAAG,SAAS,CAAA;QAChC,CAAC;QAED,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;QAEnC,OAAO,MAAM,IAAI,CAAC,UAAU,CAAA;IAC9B,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;QAE3E,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAElC,OAAO,aAAa,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;QAEhD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;CACF"}

package/transpiled/Gateway.d.ts

@@ -1,18 +1,74 @@
-import { type bindings, Connector } from '@toa.io/core';
-import * as http from './HTTP';
-import type { Interception } from './Interception';
-import type { Tree } from './RTD';
-import type { Label } from './discovery';
+import { Connector } from '@toa.io/core';
+import type { bindings } from '@toa.io/core/types';
+import * as http from './HTTP/index.ts';
+import type { Interception } from './Interception.ts';
+import type { Dispatcher } from './RPC/index.ts';
+import type { Server } from './MCP/index.ts';
+import type { DirectiveFactory, Tree } from './RTD/index.ts';
+import type { Label } from './discovery.ts';
 export declare class Gateway extends Connector {
     private readonly broadcast;
     private readonly tree;
     private readonly interceptor;
-    constructor(broadcast: Broadcast, tree: Tree, interception: Interception);
+    private readonly directives;
+    /** JSON-RPC is served only where the annotation asked for it. */
+    private readonly dispatcher;
+    /** And the same of MCP. */
+    private readonly mcp;
+    /** The tree, for every route at once. Served always, and so not nullable. */
+    private readonly explorer;
+    private readonly branches;
+    private lastMerge;
+    private widestGap;
+    private lastPing;
+    private stopped;
+    private resolveFirstMerge;
+    /** How a call of several a request carries is routed, made once rather than for every request. */
+    private readonly routing;
+    constructor(broadcast: Broadcast, tree: Tree, interception: Interception, directives: DirectiveFactory, dispatcher: Dispatcher | null, mcp: Server | null);
     process(context: http.Context): Promise<http.OutgoingMessage>;
+    /**
+     * What answers the request: a pinned endpoint that makes calls of its own, or the route
+     * the path names.
+     */
+    private endpoint;
+    /** Whether the application serves the trunk with the verb the request was made with. */
+    private serves;
+    /**
+     * One call: everything that needs a node. A request makes one of these, and a request
+     * that carries several calls makes one per call.
+     */
+    private route;
     protected open(): Promise<void>;
+    /**
+     * Both of these reach into components, and a dependency is torn down only once this has
+     * returned — where `dispose` runs after every one of them already has. The throttling
+     * ticker firing in between calls an endpoint that has just been unbound, and reports the
+     * refusal as a failure to reconcile.
+     */
+    protected close(): Promise<void>;
     protected dispose(): void;
+    private match;
     private call;
+    private explain;
     private discover;
+    /**
+     * A single ping is enough only if every tenant is listening by then, which is
+     * not the case while the deployment is still rolling out.
+     */
+    private knock;
+    private ping;
+    private reping;
+    private settled;
+    /**
+     * How long the branches must stay quiet before discovery counts as settled.
+     *
+     * Every tenant of a local composition answers the first ping at once, so a short window
+     * is enough; a rolling deployment brings them up seconds apart, and the window grows with
+     * the widest gap seen so far to keep waiting for the ones still starting.
+     */
+    private quiet;
     private merge;
+    private expose;
 }
 export type Broadcast = bindings.Broadcast<Label>;

package/transpiled/Gateway.js

@@ -1,92 +1,308 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Gateway = void 0;
-const core_1 = require("@toa.io/core");
-const http = __importStar(require("./HTTP"));
-const exceptions_1 = require("./exceptions");
-class Gateway extends core_1.Connector {
+import { setTimeout } from 'node:timers/promises';
+import { console } from 'openspan';
+import { Connector } from '@toa.io/core';
+import * as http from './HTTP/index.js';
+import { DISCOVERY, MCP, RPC } from '@toa.io/definitions/extensions.exposition';
+import { rethrow } from './exceptions.js';
+import { decide } from './Branch.js';
+import { DECIDED, publish } from './diagnostics.js';
+import { describing } from './Introspection.js';
+import { Explorer, looking } from './Discovery/index.js';
+export class Gateway extends Connector {
     broadcast;
     tree;
     interceptor;
-    constructor(broadcast, tree, interception) {
+    directives;
+    /** JSON-RPC is served only where the annotation asked for it. */
+    dispatcher;
+    /** And the same of MCP. */
+    mcp;
+    /** The tree, for every route at once. Served always, and so not nullable. */
+    explorer;
+    branches = new Map();
+    lastMerge = 0;
+    widestGap = 0;
+    lastPing = 0;
+    stopped = false;
+    resolveFirstMerge = null;
+    /** How a call of several a request carries is routed, made once rather than for every request. */
+    routing = async (call) => await this.route(call);
+    // eslint-disable-next-line max-params
+    constructor(broadcast, tree, interception, directives, dispatcher, mcp) {
         super();
         this.broadcast = broadcast;
         this.tree = tree;
         this.interceptor = interception;
+        this.directives = directives;
+        this.dispatcher = dispatcher;
+        this.mcp = mcp;
+        this.explorer = new Explorer(tree, mcp);
         this.depends(broadcast);
     }
     async process(context) {
-        const interception = await context.timing.capture('intercept', this.interceptor.intercept(context));
+        const interception = await this.interceptor.intercept(context);
         if (interception !== null)
             return interception;
-        const match = this.tree.match(context.url.pathname);
-        if (match === null)
-            throw new http.NotFound('Route not found');
-        const { node, parameters } = match;
-        if (!(context.request.method in node.methods))
+        // request-scoped, before anything is routed: this is where a credential is read
+        await this.directives.preflight(context).catch(rethrow);
+        const response = await this.endpoint(context);
+        // request-scoped, on whatever is going back: this is where a credential is re-issued
+        await this.directives.depart(context, response).catch(rethrow);
+        return response;
+    }
+    /**
+     * What answers the request: a pinned endpoint that makes calls of its own, or the route
+     * the path names.
+     */
+    async endpoint(context) {
+        // a host given to a model is an address with one meaning: the endpoint, and nothing else
+        if (this.mcp !== null && this.mcp.hosted(context.url.host)) {
+            if (context.url.pathname !== '/')
+                throw new http.NotFound('Route not found');
+            return await this.mcp.process(context, this.routing);
+        }
+        if (this.dispatcher !== null && context.url.pathname === RPC)
+            return await this.dispatcher.dispatch(context, this.routing);
+        if (this.mcp !== null && context.url.pathname === MCP)
+            return await this.mcp.process(context, this.routing);
+        // the page under this prefix is an interceptor's, and has already answered
+        if (context.url.pathname === DISCOVERY || context.url.pathname === DISCOVERY + '/')
+            return await this.explorer.process(context);
+        // a browser that asked for the trunk of an API is looking for the page, and where the
+        // application answers there itself, that is what answers
+        if (context.url.pathname === '/' && !this.serves(context)) {
+            const page = looking(context);
+            if (page !== null)
+                return page;
+        }
+        return await this.route(context);
+    }
+    /** Whether the application serves the trunk with the verb the request was made with. */
+    serves(context) {
+        const match = this.tree.match('/');
+        return match !== null && context.request.method in match.node.methods;
+    }
+    /**
+     * One call: everything that needs a node. A request makes one of these, and a request
+     * that carries several calls makes one per call.
+     */
+    async route(context) {
+        const { node, parameters } = this.match(context);
+        if (context.request.method === 'OPTIONS')
+            return await this.explain(context, node, parameters);
+        let verb = context.request.method;
+        if (!(verb in node.methods) && verb === 'HEAD' && 'GET' in node.methods)
+            verb = 'GET';
+        if (!(verb in node.methods))
             throw new http.MethodNotAllowed();
-        const method = node.methods[context.request.method];
-        const interruption = await context.timing.capture('preflight', method.directives.preflight(context, parameters)).catch(exceptions_1.rethrow);
-        const response = interruption ??
-            await context.timing.capture('call', this.call(method, context, parameters));
-        await context.timing.capture('settle', method.directives.settle(context, response)).catch(exceptions_1.rethrow);
+        const method = node.methods[verb];
+        const interruption = await method.directives
+            .precall(context, parameters)
+            .catch(rethrow);
+        const response = interruption ?? (await this.call(method, context, parameters));
+        await method.directives.settle(context, response).catch(rethrow);
         return response;
     }
     async open() {
         await this.discover();
-        console.info('Gateway has started and is awaiting resource branches');
+        // what is served besides the tree, so that turning one on can be seen to have worked
+        const pinned = [];
+        if (this.dispatcher !== null)
+            pinned.push(RPC);
+        if (this.mcp !== null)
+            pinned.push(MCP);
+        console.info('Gateway started', {
+            endpoints: pinned.length === 0 ? 'none' : pinned.join(' ')
+        });
+    }
+    /**
+     * Both of these reach into components, and a dependency is torn down only once this has
+     * returned — where `dispose` runs after every one of them already has. The throttling
+     * ticker firing in between calls an endpoint that has just been unbound, and reports the
+     * refusal as a failure to reconcile.
+     */
+    async close() {
+        this.stopped = true;
+        this.tree.dispose();
     }
     dispose() {
         console.info('Gateway is closed');
     }
+    match(context) {
+        const match = this.tree.match(context.url.pathname);
+        if (match === null) {
+            // the route may be missing because an expose has been lost
+            this.reping();
+            throw new http.NotFound('Route not found');
+        }
+        // what the request is measured under, now that it is known to be a route and not a URL
+        context.labels.route = match.route;
+        if (match.node.forward === null)
+            return match;
+        const destination = match.node.forward.replace(/\/:([^/]+)/g, (_, name) => {
+            const value = match.parameters.find((parameter) => parameter.name === name)?.value;
+            if (value === undefined)
+                throw new Error(`Forwarded parameter '${name}' not found`);
+            return `/${value}`;
+        });
+        const forward = this.tree.match(destination);
+        if (forward === null)
+            throw new Error('Forwarded route not found');
+        // the request is served by where it was forwarded to, so that is what it measures
+        context.labels.route = forward.route;
+        return forward;
+    }
     async call(method, context, parameters) {
         if (context.url.pathname[context.url.pathname.length - 1] !== '/')
             throw new http.NotFound('Trailing slash is required');
-        if (context.encoder === null)
+        // a route that states what it produces has answered the request's `accept` itself
+        if (context.encoder === null && context.answers === undefined)
             throw new http.NotAcceptable();
         if (method.endpoint === null)
             throw new http.MethodNotAllowed();
-        return await method.endpoint
+        return (await method.endpoint
             .call(context, parameters)
-            .catch(exceptions_1.rethrow);
+            .catch(rethrow));
+    }
+    async explain(context, node, parameters) {
+        const { described, methods } = await node.explain(describing(context), parameters);
+        const verbs = Object.keys(methods);
+        // what a caller may not use is not a resource to them, and describing it would be the leak
+        if (verbs.length === 0 && Object.keys(node.methods).length > 0)
+            throw new http.Forbidden();
+        // what the resource is, beside the methods it serves; a verb is upper case and cannot
+        // collide with either key
+        return {
+            body: { ...described, ...methods },
+            headers: new Headers({ allow: verbs.join(', ') })
+        };
     }
     async discover() {
+        const first = new Promise((resolve) => {
+            this.resolveFirstMerge = resolve;
+        });
         await this.broadcast.receive('expose', this.merge.bind(this));
-        await this.broadcast.transmit('ping', null);
+        void this.knock();
+        await this.settled(first);
+    }
+    /**
+     * A single ping is enough only if every tenant is listening by then, which is
+     * not the case while the deployment is still rolling out.
+     */
+    async knock() {
+        for (const delay of KNOCK_DELAYS) {
+            if (this.stopped)
+                return;
+            if (delay > 0)
+                await setTimeout(delay, undefined, { ref: false });
+            await this.ping();
+        }
+    }
+    async ping() {
+        if (this.stopped)
+            return;
+        this.lastPing = Date.now();
+        await this.broadcast
+            .transmit('ping', null)
+            .catch((exception) => console.error('Discovery ping failed', { message: exception.message }));
+    }
+    reping() {
+        if (Date.now() - this.lastPing < PING_COOLDOWN)
+            return;
+        void this.ping();
+    }
+    async settled(first) {
+        const deadline = Date.now() + SETTLE_TIMEOUT;
+        const abort = new AbortController();
+        // an uncancelled timer keeps the process alive long after the race is won
+        await Promise.race([
+            first,
+            setTimeout(SETTLE_TIMEOUT, undefined, { signal: abort.signal })
+        ])
+            .finally(() => {
+            abort.abort();
+        })
+            .catch(() => { });
+        if (this.lastMerge === 0) {
+            console.warn('Discovery timed out waiting for the first expose');
+            return;
+        }
+        while (Date.now() - this.lastMerge < this.quiet()) {
+            if (Date.now() >= deadline)
+                break;
+            await setTimeout(SETTLE_POLL);
+        }
+    }
+    /**
+     * How long the branches must stay quiet before discovery counts as settled.
+     *
+     * Every tenant of a local composition answers the first ping at once, so a short window
+     * is enough; a rolling deployment brings them up seconds apart, and the window grows with
+     * the widest gap seen so far to keep waiting for the ones still starting.
+     */
+    quiet() {
+        const adaptive = this.widestGap * SETTLE_QUIET_FACTOR;
+        return Math.min(Math.max(adaptive, SETTLE_QUIET_MIN), SETTLE_QUIET_MAX);
     }
     merge(branch) {
+        const id = branch.namespace + '.' + branch.component;
+        try {
+            this.expose(id, branch);
+        }
+        finally {
+            publish(DECIDED, { id, timestamp: branch.timestamp });
+        }
+    }
+    expose(id, branch) {
+        const attributes = {
+            namespace: branch.namespace,
+            component: branch.component,
+            version: branch.version
+        };
+        const exposed = this.branches.get(id);
+        if (exposed !== undefined)
+            switch (decide(exposed, branch)) {
+                // rebuilding an identical branch would only tear down its live endpoints
+                case 'refresh':
+                    this.tree.refresh(exposed.nodes);
+                    console.trace('Branch refreshed', attributes);
+                    return;
+                case 'superseded':
+                    console.debug('Branch superseded', {
+                        ...attributes,
+                        timestamp: branch.timestamp,
+                        exposed: exposed.timestamp
+                    });
+                    return;
+            }
+        let nodes;
         try {
-            this.tree.merge(branch.node, branch);
-            console.info('Resource branch of ' +
-                `'${branch.namespace}.${branch.component}' has been merged`);
+            nodes = this.tree.merge(branch.node, branch);
         }
         catch (exception) {
-            console.error(exception);
+            const message = exception instanceof Error ? exception.message : 'Unknown error';
+            console.error('Branch merge exception', { message, ...attributes });
+            return;
         }
+        this.branches.set(id, {
+            version: branch.version,
+            routes: branch.routes,
+            timestamp: branch.timestamp,
+            nodes
+        });
+        if (this.lastMerge !== 0)
+            this.widestGap = Math.max(this.widestGap, Date.now() - this.lastMerge);
+        this.lastMerge = Date.now();
+        this.resolveFirstMerge?.();
+        this.resolveFirstMerge = null;
+        console.info('Branch merged', attributes);
     }
 }
-exports.Gateway = Gateway;
+const SETTLE_QUIET_MIN = 500;
+const SETTLE_QUIET_MAX = 10_000;
+const SETTLE_QUIET_FACTOR = 2;
+const SETTLE_TIMEOUT = 30_000;
+const SETTLE_POLL = 50;
+const KNOCK_DELAYS = [0, 500, 1000, 1500];
+const PING_COOLDOWN = 5_000;
 //# sourceMappingURL=Gateway.js.map