@toa.io/extensions.exposition 1.0.0-alpha.3 → 1.0.0-alpha.300

package/transpiled/RTD/Tree.js

@@ -1,9 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tree = void 0;
-const factory_1 = require("./factory");
-const segment_1 = require("./segment");
-class Tree {
+import { console } from 'openspan';
+import { refusal, template } from '../RPC/names.js';
+import { DISCOVERY } from '@toa.io/definitions/extensions.exposition';
+import { branchTTL, createNode } from './factory.js';
+import { fragment } from './segment.js';
+export class Tree {
     root;
     trunk;
     endpoints;
@@ -11,18 +11,39 @@ class Tree {
     constructor(node, endpoints, directives) {
         this.endpoints = endpoints;
         this.directives = directives;
-        this.trunk = this.createNode(node, PROTECTED);
         this.root = node;
+        this.trunk = this.createNode(node, PROTECTED);
+        announce(this.trunk);
     }
     match(path) {
         if (path === '/')
-            return { node: this.trunk, parameters: [] };
-        const fragments = (0, segment_1.fragment)(path);
+            return {
+                node: this.trunk,
+                parameters: []
+            };
+        const fragments = fragment(path);
         return this.trunk.match(fragments);
     }
+    /** Every method in the tree, with the template it answers at. */
+    walk() {
+        return this.trunk.walk([], TRUNK);
+    }
     merge(node, extension) {
         const branch = this.createNode(node, !PROTECTED, extension);
-        this.trunk.merge(branch);
+        announce(branch);
+        return this.trunk.merge(branch);
+    }
+    /**
+     * Extends the expiration of an already merged branch, leaving its endpoints
+     * and their remotes intact.
+     */
+    refresh(nodes) {
+        const expiration = Date.now() + branchTTL();
+        for (const node of nodes)
+            node.touch(expiration);
+    }
+    dispose() {
+        this.directives.dispose();
     }
     createNode(node, protect, extension) {
         const context = {
@@ -30,13 +51,53 @@ class Tree {
             endpoints: this.endpoints,
             directives: {
                 factory: this.directives,
-                stack: this.root?.directives ?? []
+                // A merged branch is mounted under the root, so it inherits the root's
+                // directives. The trunk is the root: createNode adds them itself, and
+                // seeding them here too would apply every one of them twice.
+                stack: node === this.root ? [] : (this.root.directives ?? [])
             },
+            path: label(extension),
             extension
         };
-        return (0, factory_1.createNode)(node, context);
+        return createNode(node, context);
+    }
+}
+/**
+ * What is served but cannot be reached as it reads. Said once per route as it is built,
+ * because either of these is otherwise noticed only by the caller who cannot find it.
+ */
+function announce(node) {
+    const said = new Set();
+    for (const { segments } of node.walk([], TRUNK)) {
+        const route = template(segments);
+        if (said.has(route))
+            continue;
+        // the page is served under this prefix, before a request is routed at all
+        if (route === DISCOVERY || route.startsWith(DISCOVERY + '/')) {
+            said.add(route);
+            console.warn('Route is shadowed by the discovery endpoint', { route });
+            continue;
+        }
+        const segment = refusal(segments);
+        if (segment === null)
+            continue;
+        said.add(route);
+        console.warn('Route cannot be addressed as a procedure', { route, segment });
     }
 }
-exports.Tree = Tree;
+/**
+ * A branch's routes are relative to wherever it is merged, and the mount point is not
+ * known while it is being built — so the component it came from is what keeps two
+ * branches from looking like the same route.
+ */
+function label(extension) {
+    if (extension === null || typeof extension !== 'object')
+        return '';
+    const { namespace, component } = extension;
+    return typeof namespace === 'string' && typeof component === 'string'
+        ? `${namespace}.${component}`
+        : '';
+}
 const PROTECTED = true;
+const TRUNK = true;
 //# sourceMappingURL=Tree.js.map

package/transpiled/RTD/Tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tree.js","sourceRoot":"","sources":["../../source/RTD/Tree.ts"],"names":[],"mappings":";;;AACA,uCAAsC;AACtC,uCAAoC;AAOpC,MAAa,IAAI;IAIE,IAAI,CAAa;IACjB,KAAK,CAA8B;IACnC,SAAS,CAA6B;IACtC,UAAU,CAAmB;IAE9C,YACC,IAAiB,EAAE,SAA2B,EAAE,UAA6B;QAC5E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAE,IAAY;QACxB,IAAI,IAAI,KAAK,GAAG;YACd,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;QAE7C,MAAM,SAAS,GAAG,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAA;QAEhC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACpC,CAAC;IAEM,KAAK,CAAE,IAAiB,EAAE,SAAc;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAE3D,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1B,CAAC;IAEO,UAAU,CAAE,IAAiB,EAAE,OAAgB,EAAE,SAAe;QACtE,MAAM,OAAO,GAAY;YACvB,SAAS,EAAE,OAAO;YAClB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE;gBACV,OAAO,EAAE,IAAI,CAAC,UAAU;gBACxB,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE;aACnC;YACD,SAAS;SACV,CAAA;QAED,OAAO,IAAA,oBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;CACF;AA7CD,oBA6CC;AAED,MAAM,SAAS,GAAG,IAAI,CAAA"}
+{"version":3,"file":"Tree.js","sourceRoot":"","sources":["../../source/RTD/Tree.ts"],"names":[],"mappings":"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"}

package/transpiled/RTD/factory.d.ts

@@ -1,6 +1,5 @@
-import { Node } from './Node';
-import { type Context } from './Context';
-import { type Endpoint } from './Endpoint';
-import { type Directives } from './Directives';
-import type * as syntax from './syntax';
-export declare function createNode<TEndpoint extends Endpoint, TDirectives extends Directives>(node: syntax.Node, context: Context): Node<TEndpoint, TDirectives>;
+import { Node } from './Node.js';
+import type { Context } from './Context.js';
+import type * as syntax from './syntax/index.js';
+export declare function createNode(node: syntax.Node, context: Context): Node;
+export declare function branchTTL(): number;

package/transpiled/RTD/factory.js

@@ -1,36 +1,77 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNode = void 0;
-const Node_1 = require("./Node");
-const Route_1 = require("./Route");
-const segment_1 = require("./segment");
-const Method_1 = require("./Method");
-function createNode(node, context) {
+import { BRANCH_TTL } from '@toa.io/definitions/extensions.exposition';
+import { Node } from './Node.js';
+import { Route } from './Route.js';
+import { fragment, segment } from './segment.js';
+import { Method } from './Method.js';
+export function createNode(node, context) {
     if (node.isolated === true)
         context.directives.stack = node.directives;
     else
         context.directives.stack = node.directives.concat(context.directives.stack);
+    described(node, context);
     const routes = node.routes.map((route) => createRoute(route, context));
     const methods = {};
     for (const method of node.methods)
         methods[method.verb] = createMethod(method, context);
-    const properties = { protected: node.protected ?? context.protected };
-    return new Node_1.Node(routes, methods, properties);
+    const protect = node.protected ?? context.protected;
+    const properties = {
+        protected: protect,
+        forward: node.forward,
+        expiration: protect ? Infinity : Date.now() + branchTTL()
+    };
+    return new Node(routes, methods, properties);
+}
+export function branchTTL() {
+    const value = process.env.__TESTING_EXPOSITION_BRANCH_TTL;
+    if (value === undefined || value === '')
+        return BRANCH_TTL;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : BRANCH_TTL;
 }
-exports.createNode = createNode;
 function createRoute(route, context) {
     const stack = context.directives.stack.slice();
-    const segments = (0, segment_1.segment)(route.path);
+    const path = context.path;
+    const segments = segment(route.path);
+    context.path = join(path, route.path);
+    /*
+     * What a node says of itself is not said of what is under it. Its own `/` is the
+     * exception: an intermediate node is never what a path matches, because that route
+     * answers in its place — so the two are one resource and what describes it carries.
+     */
+    if (route.path !== ROOT)
+        context.directives.stack = stack.filter((directive) => context.directives.factory.inheritable(directive));
     const node = createNode(route.node, context);
     context.directives.stack = stack; // restore
-    return new Route_1.Route(segments, node);
+    context.path = path;
+    return new Route(segments, node);
+}
+function join(base, path) {
+    // '/one/' and '/two/' would otherwise read as '/one//two/'
+    return (base + path).replace(/\/+/g, '/').replace(/(.)\/$/, '$1');
 }
 function createMethod(method, context) {
-    const stack = context.directives.stack.concat(method.directives.reverse());
-    const directives = context.directives.factory.create(stack);
+    const stack = method.directives.concat(context.directives.stack);
+    const directives = context.directives.factory.create(stack, context.path);
     const endpoint = method.mapping?.endpoint === undefined
         ? null
         : context.endpoints.create(method, context);
-    return new Method_1.Method(endpoint, directives);
+    return new Method(endpoint, directives);
+}
+/**
+ * A resource is what it is described beside: a node with no methods of its own is never
+ * what a path answers, so nothing would carry what it says about itself. Refused where the
+ * declaration is, rather than left to be noticed by whoever cannot find it in the answer.
+ */
+function described(node, context) {
+    const help = node.directives.find((directive) => directive.family === HELP && directive.name === 'node');
+    if (help === undefined || node.methods.length > 0)
+        return;
+    // an intermediate node's `/` answers in its place, and carries what it says
+    if (node.routes.some((route) => route.path === ROOT))
+        return;
+    const route = '/' + fragment(context.path).join('/');
+    throw new Error(`Directive help:node: '${route}' serves no methods`);
 }
+const ROOT = '/';
+const HELP = 'help';
 //# sourceMappingURL=factory.js.map

package/transpiled/RTD/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../source/RTD/factory.ts"],"names":[],"mappings":";;;AAAA,iCAA8C;AAC9C,mCAA+B;AAE/B,uCAAmC;AACnC,qCAA+C;AAK/C,SAAgB,UAAU,CACzB,IAAiB,EAAE,OAAgB;IAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;QACxB,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAA;;QAE1C,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAE7E,MAAM,MAAM,GAAY,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/E,MAAM,OAAO,GAAY,EAAE,CAAA;IAE3B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;QAC/B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEtD,MAAM,UAAU,GAAe,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAA;IAEjF,OAAO,IAAI,WAAI,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;AAC9C,CAAC;AAhBD,gCAgBC;AAED,SAAS,WAAW,CAAE,KAAmB,EAAE,OAAgB;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IAC9C,MAAM,QAAQ,GAAG,IAAA,iBAAO,EAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAE5C,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA,CAAC,UAAU;IAE3C,OAAO,IAAI,aAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,YAAY,CAAE,MAAqB,EAAE,OAAgB;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAA;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAE3D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS;QACrD,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE7C,OAAO,IAAI,eAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AACzC,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../source/RTD/factory.ts"],"names":[],"mappings":"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"}

package/transpiled/RTD/index.d.ts

@@ -1,8 +1,8 @@
-export * from './Tree';
-export * from './Node';
-export * from './Match';
-export * from './Method';
-export * from './Context';
-export * from './Endpoint';
-export * from './Directives';
-export * as syntax from './syntax';
+export * from './Tree.js';
+export * from './Node.js';
+export * from './Match.js';
+export * from './Method.js';
+export * from './Context.js';
+export * from './Endpoint.js';
+export * from './Directives.js';
+export * as syntax from './syntax/index.js';

package/transpiled/RTD/index.js

@@ -1,38 +1,9 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-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.syntax = void 0;
-__exportStar(require("./Tree"), exports);
-__exportStar(require("./Node"), exports);
-__exportStar(require("./Match"), exports);
-__exportStar(require("./Method"), exports);
-__exportStar(require("./Context"), exports);
-__exportStar(require("./Endpoint"), exports);
-__exportStar(require("./Directives"), exports);
-exports.syntax = __importStar(require("./syntax"));
+export * from './Tree.js';
+export * from './Node.js';
+export * from './Match.js';
+export * from './Method.js';
+export * from './Context.js';
+export * from './Endpoint.js';
+export * from './Directives.js';
+export * as syntax from './syntax/index.js';
 //# sourceMappingURL=index.js.map

package/transpiled/RTD/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/RTD/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,yCAAsB;AACtB,0CAAuB;AACvB,2CAAwB;AACxB,4CAAyB;AACzB,6CAA0B;AAC1B,+CAA4B;AAC5B,mDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/RTD/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA"}

package/transpiled/RTD/segment.d.ts

@@ -1,3 +1,4 @@
+import type { Parameter } from './Match.js';
 export declare function segment(path: string): Segment[];
 export declare function fragment(path: string): string[];
 export type Segment = {
@@ -5,4 +6,11 @@ export type Segment = {
 } | {
     fragment: null;
     placeholder: string | null;
+    wildcard?: boolean;
 };
+/**
+ * What a route template takes, by name. Describing has no values for them — a template is
+ * not a path — and nothing that describes a method reads one. A `*` is skipped: it stands
+ * for a segment the caller cannot name, so there is nothing to substitute.
+ */
+export declare function variables(segments: Segment[]): Parameter[];

package/transpiled/RTD/segment.js

@@ -1,11 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fragment = exports.segment = void 0;
-function segment(path) {
+export function segment(path) {
     return fragment(path).map(parse);
 }
-exports.segment = segment;
-function fragment(path) {
+export function fragment(path) {
     const parts = path.split('/');
     // trailing slash
     if (parts[parts.length - 1] === '')
@@ -13,13 +9,31 @@ function fragment(path) {
     // leading slash
     return parts.splice(1);
 }
-exports.fragment = fragment;
 function parse(segment) {
     if (segment[0] === ':')
         return { fragment: null, placeholder: segment.substring(1) };
     else if (segment === '*')
         return { fragment: null, placeholder: null };
+    else if (segment === '**')
+        return { fragment: null, placeholder: null, wildcard: true };
     else
         return { fragment: segment };
 }
+/**
+ * What a route template takes, by name. Describing has no values for them — a template is
+ * not a path — and nothing that describes a method reads one. A `*` is skipped: it stands
+ * for a segment the caller cannot name, so there is nothing to substitute.
+ */
+export function variables(segments) {
+    const params = [];
+    for (const segment of segments) {
+        if (segment.fragment !== null)
+            continue;
+        if (segment.wildcard === true)
+            params.push({ name: '**', value: '' });
+        else if (segment.placeholder !== null)
+            params.push({ name: segment.placeholder, value: '' });
+    }
+    return params;
+}
 //# sourceMappingURL=segment.js.map

package/transpiled/RTD/segment.js.map

@@ -1 +1 @@
-{"version":3,"file":"segment.js","sourceRoot":"","sources":["../../source/RTD/segment.ts"],"names":[],"mappings":";;;AAAA,SAAgB,OAAO,CAAE,IAAY;IACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAFD,0BAEC;AAED,SAAgB,QAAQ,CAAE,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,iBAAiB;IACjB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAElD,gBAAgB;IAChB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AACxB,CAAC;AARD,4BAQC;AAED,SAAS,KAAK,CAAE,OAAe;IAC7B,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;SAC/E,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;;QACjE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AACnC,CAAC"}
+{"version":3,"file":"segment.js","sourceRoot":"","sources":["../../source/RTD/segment.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAE7B,iBAAiB;IACjB,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAElD,gBAAgB;IAChB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,KAAK,CAAC,OAAe;IAC5B,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;SAC/E,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;SACjE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;;QAClF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AACnC,CAAC;AAYD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAmB;IAC3C,MAAM,MAAM,GAAgB,EAAE,CAAA;IAE9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAQ;QAEvC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;aAChE,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI;YACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/transpiled/RTD/syntax/index.d.ts

@@ -1,2 +1 @@
-export * from './parse';
-export * from './types';
+export * from '@toa.io/definitions/extensions.exposition/syntax';

package/transpiled/RTD/syntax/index.js

@@ -1,19 +1,2 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./parse"), exports);
-__exportStar(require("./types"), exports);
+export * from '@toa.io/definitions/extensions.exposition/syntax';
 //# sourceMappingURL=index.js.map

package/transpiled/RTD/syntax/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/RTD/syntax/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,0CAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/RTD/syntax/index.ts"],"names":[],"mappings":"AAAA,cAAc,kDAAkD,CAAA"}

package/transpiled/Remotes.d.ts

@@ -1,9 +1,9 @@
-import { Connector, type Component } from '@toa.io/core';
-import { type Bootloader } from './Factory';
+import { Connector, type Remote } from '@toa.io/core';
+import { type Host } from './Factory.js';
 export declare class Remotes extends Connector {
-    private readonly boot;
-    private readonly remotes;
-    constructor(boot: Bootloader);
-    discover(namespace: string, name: string): Promise<Component>;
-    private create;
+    private readonly host;
+    private readonly cache;
+    constructor(host: Host);
+    discover(namespace: string, name: string, version?: string): Promise<Remote>;
+    private locate;
 }

package/transpiled/Remotes.js

@@ -1,25 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Remotes = void 0;
-const core_1 = require("@toa.io/core");
-class Remotes extends core_1.Connector {
-    boot;
-    remotes = {};
-    constructor(boot) {
+import { Locator, Connector } from '@toa.io/core';
+export class Remotes extends Connector {
+    host;
+    cache = {};
+    constructor(host) {
         super();
-        this.boot = boot;
+        this.host = host;
     }
-    async discover(namespace, name) {
-        const locator = new core_1.Locator(name, namespace);
-        this.remotes[locator.id] ??= this.create(locator);
-        return await this.remotes[locator.id];
+    async discover(namespace, name, version = 'local') {
+        const locator = new Locator(name, namespace);
+        const key = locator.id + ':' + version;
+        this.cache[key] ??= this.locate(locator);
+        return this.cache[key];
     }
-    async create(locator) {
-        const remote = await this.boot.remote(locator);
+    async locate(locator) {
+        // the gateway is the origin of every call it forwards
+        const remote = await this.host.remote(locator, SOURCE);
         this.depends(remote);
         await remote.connect();
         return remote;
     }
 }
-exports.Remotes = Remotes;
+const SOURCE = { service: 'exposition' };
 //# sourceMappingURL=Remotes.js.map

package/transpiled/Remotes.js.map

@@ -1 +1 @@
-{"version":3,"file":"Remotes.js","sourceRoot":"","sources":["../source/Remotes.ts"],"names":[],"mappings":";;;AAAA,uCAAiE;AAGjE,MAAa,OAAQ,SAAQ,gBAAS;IACnB,IAAI,CAAY;IAChB,OAAO,GAAuC,EAAE,CAAA;IAEjE,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAE,SAAiB,EAAE,IAAY;QACpD,MAAM,OAAO,GAAG,IAAI,cAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAE5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAEjD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IAEO,KAAK,CAAC,MAAM,CAAE,OAAgB;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE9C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QAEtB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AA1BD,0BA0BC"}
+{"version":3,"file":"Remotes.js","sourceRoot":"","sources":["../source/Remotes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAe,MAAM,cAAc,CAAA;AAI9D,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACnB,IAAI,CAAM;IACV,KAAK,GAAoC,EAAE,CAAA;IAE5D,YAAmB,IAAU;QAC3B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,QAAQ,CACnB,SAAiB,EACjB,IAAY,EACZ,OAAO,GAAW,OAAO;QAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,OAAO,CAAA;QAEtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAExC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAgB;QACnC,sDAAsD;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAEtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QAEtB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,MAAM,MAAM,GAAW,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/transpiled/Tenant.d.ts

@@ -1,12 +1,22 @@
-import { Connector, type Locator, type bindings } from '@toa.io/core';
-import { type Label } from './discovery';
-import type * as RTD from './RTD/syntax';
+import { Connector } from '@toa.io/core';
+import type { bindings } from '@toa.io/core/types';
+import type { Label } from './discovery.js';
+import type { Branch } from './Branch.js';
 export declare class Tenant extends Connector {
     private readonly broadcast;
     private readonly branch;
-    constructor(broadcast: Broadcast, locator: Locator, node: RTD.Node);
+    private started;
+    private stopped;
+    constructor(broadcast: Broadcast, branch: Omit<Branch, 'timestamp'>);
     open(): Promise<void>;
-    dispose(): Promise<void>;
+    /**
+     * Announcing is stopped where the teardown begins, not in `dispose`, which a connector
+     * runs after every one of its dependencies has gone. A component on its way out that
+     * announces itself once more has its routes held open by whoever is listening, and the
+     * requests that follow reach nothing.
+     */
+    protected close(): Promise<void>;
+    private announce;
     private expose;
 }
 type Broadcast = bindings.Broadcast<Label>;

package/transpiled/Tenant.js

@@ -1,34 +1,53 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tenant = void 0;
-const core_1 = require("@toa.io/core");
-class Tenant extends core_1.Connector {
+import { setTimeout } from 'node:timers/promises';
+import { Connector } from '@toa.io/core';
+import { BRANCH_TTL } from '@toa.io/definitions/extensions.exposition';
+export class Tenant extends Connector {
     broadcast;
     branch;
-    constructor(broadcast, locator, node) {
+    started = 0;
+    stopped = false;
+    constructor(broadcast, branch) {
         super();
         this.broadcast = broadcast;
-        this.branch = {
-            namespace: locator.namespace,
-            component: locator.name,
-            isolated: locator.namespace === 'identity',
-            node
-        };
+        this.branch = branch;
         this.depends(broadcast);
     }
     async open() {
+        this.started = Date.now();
         await this.expose();
         await this.broadcast.receive('ping', this.expose.bind(this));
-        console.info('Exposition Tenant for ' +
-            `'${this.branch.namespace}.${this.branch.component}' has started.`);
+        void this.announce();
     }
-    async dispose() {
-        console.info('Exposition Tenant for ' +
-            `'${this.branch.namespace}.${this.branch.component}' has been stopped.`);
+    /**
+     * Announcing is stopped where the teardown begins, not in `dispose`, which a connector
+     * runs after every one of its dependencies has gone. A component on its way out that
+     * announces itself once more has its routes held open by whoever is listening, and the
+     * requests that follow reach nothing.
+     */
+    async close() {
+        this.stopped = true;
+    }
+    async announce() {
+        while (!this.stopped) {
+            const delay = exposeInterval(Date.now() - this.started);
+            await setTimeout(delay, undefined, { ref: false });
+            if (this.stopped)
+                break;
+            await this.expose();
+        }
     }
     async expose() {
-        await this.broadcast.transmit('expose', this.branch);
+        // the ping subscription outlives the announcing loop, and answering one on the way out
+        // is the same announcement by another route
+        if (this.stopped)
+            return;
+        await this.broadcast.transmit('expose', { ...this.branch, timestamp: this.started });
     }
 }
-exports.Tenant = Tenant;
+function exposeInterval(uptime) {
+    return Math.round(EXPOSE_MAX - (EXPOSE_MAX - EXPOSE_MIN) * Math.exp(-uptime / EXPOSE_TAU));
+}
+const EXPOSE_MIN = 5_000;
+const EXPOSE_MAX = Math.round(BRANCH_TTL / 2.1);
+const EXPOSE_TAU = 900_000;
 //# sourceMappingURL=Tenant.js.map

package/transpiled/Tenant.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tenant.js","sourceRoot":"","sources":["../source/Tenant.ts"],"names":[],"mappings":";;;AAAA,uCAAqE;AAKrE,MAAa,MAAO,SAAQ,gBAAS;IAClB,SAAS,CAAW;IACpB,MAAM,CAAQ;IAE/B,YAAoB,SAAoB,EAAE,OAAgB,EAAE,IAAc;QACxE,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,IAAI;YACvB,QAAQ,EAAE,OAAO,CAAC,SAAS,KAAK,UAAU;YAC1C,IAAI;SACL,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;IAEe,KAAK,CAAC,IAAI;QACxB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAE5D,OAAO,CAAC,IAAI,CAAC,wBAAwB;YACnC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,gBAAgB,CAAC,CAAA;IACvE,CAAC;IAEe,KAAK,CAAC,OAAO;QAC3B,OAAO,CAAC,IAAI,CAAC,wBAAwB;YACnC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,qBAAqB,CAAC,CAAA;IAC5E,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACtD,CAAC;CACF;AAnCD,wBAmCC"}
+{"version":3,"file":"Tenant.js","sourceRoot":"","sources":["../source/Tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAA;AAKtE,MAAM,OAAO,MAAO,SAAQ,SAAS;IAClB,SAAS,CAAW;IACpB,MAAM,CAA2B;IAC1C,OAAO,GAAG,CAAC,CAAA;IACX,OAAO,GAAG,KAAK,CAAA;IAEvB,YAAmB,SAAoB,EAAE,MAAiC;QACxE,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;IAEe,KAAK,CAAC,IAAI;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEzB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAE5D,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;IACtB,CAAC;IAED;;;;;OAKG;IACgB,KAAK,CAAC,KAAK;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;IACrB,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;YAEvD,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;YAElD,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAK;YAEvB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,uFAAuF;QACvF,4CAA4C;QAC5C,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QAExB,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IACtF,CAAC;CACF;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,OAAO,IAAI,CAAC,KAAK,CACf,UAAU,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC,CACxE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,GAAG,KAAK,CAAA;AACxB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAA;AAC/C,MAAM,UAAU,GAAG,OAAO,CAAA"}