@toa.io/extensions.exposition 1.0.0-alpha.30 → 1.0.0-alpha.301

package/transpiled/RTD/Method.js.map

@@ -1 +1 @@
-{"version":3,"file":"Method.js","sourceRoot":"","sources":["../../source/RTD/Method.ts"],"names":[],"mappings":";;;AAGA,MAAa,MAAM;IACD,QAAQ,CAAiB;IACzB,UAAU,CAAY;IAEtC,YAAoB,QAAyB,EAAE,UAAsB;QACnE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF;AAZD,wBAYC"}
+{"version":3,"file":"Method.js","sourceRoot":"","sources":["../../source/RTD/Method.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAG3C,MAAM,OAAO,MAAM;IACD,QAAQ,CAAiB;IACzB,UAAU,CAAY;IAEtC,YAAmB,QAAyB,EAAE,UAAsB;QAClE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAClB,OAAgB,EAChB,UAAuB;QAEvB,MAAM,aAAa,GACjB,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAEvE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAEvE,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACrD,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF"}

package/transpiled/RTD/Node.d.ts

@@ -1,19 +1,57 @@
-import { type Route } from './Route';
-import { type Methods } from './Method';
-import { type Match, type Parameter } from './Match';
+import { type Route } from './Route.ts';
+import { type Method, type Methods } from './Method.ts';
+import { type Match, type Parameter } from './Match.ts';
+import type { Segment } from './segment.ts';
+import type { Context } from '../HTTP/index.ts';
+import { type Described } from '../directives/help/index.ts';
+import type { Introspection } from '../Introspection.ts';
 export declare class Node {
     intermediate: boolean;
+    forward: string | null;
+    expiration: number;
     methods: Methods;
     private readonly protected;
     private routes;
     constructor(routes: Route[], methods: Methods, properties: Properties);
     match(fragments: string[], parameters?: Parameter[]): Match | null;
-    merge(node: Node): void;
+    /**
+     * Returns the nodes the merged branch has landed on, so that its expiration
+     * can later be extended without rebuilding anything.
+     */
+    merge(node: Node): Node[];
+    touch(expiration: number): void;
+    /**
+     * Every method under this node, with the template it answers at.
+     *
+     * An intermediate node is skipped: it is never what a path matches, because its `/` route
+     * answers at the same place and is reached instead. The trunk is the exception `match`
+     * makes for it — `'/'` answers the trunk itself, whatever it holds.
+     */
+    walk(segments: Segment[], trunk?: boolean): Generator<Mount>;
+    /**
+     * What this resource is, and every method of it this caller may reach, in the order they
+     * were declared. The two are answered apart because only the methods are `Allow`.
+     */
+    explain(context: Context, parameters: Parameter[]): Promise<Explained>;
     private replace;
     private append;
-    private mergeRoute;
+    private route;
+    private nodes;
     private sort;
 }
+/** What a resource says of itself, and what it serves. */
+export interface Explained {
+    described: Described | null;
+    methods: Record<string, Introspection>;
+}
+/** A method, and the route template it is reached by. */
+export interface Mount {
+    segments: Segment[];
+    verb: string;
+    method: Method;
+}
 export interface Properties {
     protected: boolean;
+    forward?: string;
+    expiration?: number;
 }

package/transpiled/RTD/Node.js

@@ -1,8 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Node = void 0;
-class Node {
+import { guarded, resource } from '../directives/help/index.js';
+export class Node {
     intermediate;
+    forward;
+    expiration;
     methods;
     protected;
     routes;
@@ -10,53 +10,107 @@ class Node {
         this.routes = routes;
         this.methods = methods;
         this.protected = properties.protected;
+        this.forward = properties.forward ?? null;
+        this.expiration = properties.expiration ?? Infinity;
         this.intermediate = this.routes.findIndex((route) => route.root) !== -1;
         this.sort();
     }
     match(fragments, parameters = []) {
+        // a route only pushes, so what a failed one added is cut off rather than the array copied
+        const mark = parameters.length;
         for (const route of this.routes) {
             const match = route.match(fragments, parameters);
             if (match !== null)
                 return match;
+            parameters.length = mark;
         }
         return null;
     }
+    /**
+     * Returns the nodes the merged branch has landed on, so that its expiration
+     * can later be extended without rebuilding anything.
+     */
     merge(node) {
         this.intermediate = node.intermediate;
-        if (!this.protected)
-            this.replace(node);
-        else
-            this.append(node);
+        const nodes = this.protected ? this.append(node) : this.replace(node);
         this.sort();
+        return nodes;
+    }
+    touch(expiration) {
+        if (!this.protected)
+            this.expiration = expiration;
+    }
+    /**
+     * Every method under this node, with the template it answers at.
+     *
+     * An intermediate node is skipped: it is never what a path matches, because its `/` route
+     * answers at the same place and is reached instead. The trunk is the exception `match`
+     * makes for it — `'/'` answers the trunk itself, whatever it holds.
+     */
+    *walk(segments, trunk = false) {
+        if (trunk || !this.intermediate)
+            for (const [verb, method] of Object.entries(this.methods))
+                yield { segments, verb, method };
+        for (const route of this.routes)
+            yield* route.walk(segments);
+    }
+    /**
+     * What this resource is, and every method of it this caller may reach, in the order they
+     * were declared. The two are answered apart because only the methods are `Allow`.
+     */
+    async explain(context, parameters) {
+        const entries = Object.entries(this.methods);
+        const explained = await Promise.all(entries.map(async ([, method]) => await method.explain(context, parameters)));
+        const methods = {};
+        for (let i = 0; i < entries.length; i++)
+            if (explained[i] !== null)
+                methods[entries[i][0]] = explained[i];
+        // every method of a node carries the same declaration, so the first that is there says it
+        const stated = entries.length === 0 ? null : resource(entries[0][1].directives);
+        const described = { ...stated, ...guarded(methods) };
+        return {
+            described: Object.keys(described).length === 0 ? null : described,
+            methods
+        };
     }
     replace(node) {
         const methods = Object.values(this.methods);
         this.routes = node.routes;
         this.methods = node.methods;
+        this.expiration = node.expiration;
+        this.forward = node.forward;
+        // race condition is really unlikely
         for (const method of methods)
             void method.close();
-        // race condition is really unlikely
+        return this.nodes();
     }
     append(node) {
+        const nodes = [];
         for (const route of node.routes)
-            this.mergeRoute(route);
+            nodes.push(...this.route(route));
         for (const [verb, method] of Object.entries(node.methods))
-            if (verb in this.methods)
-                console.warn(`Overriding of the protected method ${verb} is not permitted.`);
-            else
-                this.methods[verb] = method;
+            this.methods[verb] = method;
+        return nodes;
     }
-    mergeRoute(candidate) {
+    route(candidate) {
         for (const route of this.routes)
-            if (candidate.equals(route)) {
-                route.merge(candidate);
-                return;
-            }
+            if (candidate.equals(route))
+                return route.merge(candidate);
         this.routes.push(candidate);
+        return candidate.node.nodes();
+    }
+    nodes() {
+        const nodes = [this];
+        for (const route of this.routes)
+            nodes.push(...route.node.nodes());
+        return nodes;
     }
     sort() {
-        this.routes.sort((a, b) => a.variables - b.variables);
+        this.routes.sort((a, b) => {
+            return a.variables === b.variables
+                ? b.segments.length - a.segments.length // routes with more segments should be matched first
+                : a.variables - b.variables; // routes with more variables should be matched last
+        });
     }
 }
-exports.Node = Node;
 //# sourceMappingURL=Node.js.map

package/transpiled/RTD/Node.js.map

@@ -1 +1 @@
-{"version":3,"file":"Node.js","sourceRoot":"","sources":["../../source/RTD/Node.ts"],"names":[],"mappings":";;;AAIA,MAAa,IAAI;IACR,YAAY,CAAS;IACrB,OAAO,CAAS;IACN,SAAS,CAAS;IAC3B,MAAM,CAAS;IAEvB,YACC,MAAe,EAAE,OAAgB,EAAE,UAAsB;QACxD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAA;QACrC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAEvE,IAAI,CAAC,IAAI,EAAE,CAAA;IACb,CAAC;IAEM,KAAK,CAAE,SAAmB,EAAE,aAA0B,EAAE;QAC7D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;YAEhD,IAAI,KAAK,KAAK,IAAI;gBAChB,OAAO,KAAK,CAAA;QAChB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAEM,KAAK,CAAE,IAAU;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;QAErC,IAAI,CAAC,IAAI,CAAC,SAAS;YACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;;YAElB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAEnB,IAAI,CAAC,IAAI,EAAE,CAAA;IACb,CAAC;IAEO,OAAO,CAAE,IAAU;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAE3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAE3B,KAAK,MAAM,MAAM,IAAI,OAAO;YAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAA;QAErB,oCAAoC;IACtC,CAAC;IAEO,MAAM,CAAE,IAAU;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAC7B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QAExB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YACvD,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO;gBACtB,OAAO,CAAC,IAAI,CAAC,sCAAsC,IAAI,oBAAoB,CAAC,CAAA;;gBAE5E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;IACjC,CAAC;IAEO,UAAU,CAAE,SAAgB;QAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAC7B,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;gBAEtB,OAAM;YACR,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC7B,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAA;IACvD,CAAC;CACF;AA3ED,oBA2EC"}
+{"version":3,"file":"Node.js","sourceRoot":"","sources":["../../source/RTD/Node.ts"],"names":[],"mappings":"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"}

package/transpiled/RTD/Route.d.ts

@@ -1,14 +1,16 @@
-import { type Node } from './Node';
-import { type Segment } from './segment';
-import { type Match, type Parameter } from './Match';
+import { type Segment } from './segment.ts';
+import { type Match, type Parameter } from './Match.ts';
+import type { Mount, Node } from './Node.ts';
 export declare class Route {
     readonly root: boolean;
     readonly variables: number;
-    private readonly segments;
-    private readonly node;
+    readonly segments: Segment[];
+    readonly node: Node;
+    private readonly wildcard;
     constructor(segments: Segment[], node: Node);
     match(fragments: string[], parameters: Parameter[]): Match | null;
+    walk(prefix: Segment[]): Generator<Mount>;
     equals(route: Route): boolean;
-    merge(route: Route): void;
+    merge(route: Route): Node[];
     private matchNested;
 }

package/transpiled/RTD/Route.js

@@ -1,33 +1,49 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Route = void 0;
-class Route {
+export class Route {
     root;
     variables = 0;
     segments;
     node;
+    wildcard = false;
     constructor(segments, node) {
         this.root = segments.length === 0;
         this.segments = segments;
         this.node = node;
         for (const segment of segments)
-            if (segment.fragment === null)
+            if (segment.fragment === null) {
                 this.variables++;
+                this.wildcard ||= segment.wildcard === true;
+            }
     }
     match(fragments, parameters) {
+        if (Date.now() >= this.node.expiration)
+            return null;
         for (let i = 0; i < this.segments.length; i++) {
             const segment = this.segments[i];
             if (segment.fragment !== null && segment.fragment !== fragments[i])
                 return null;
             if (segment.fragment === null && segment.placeholder !== null)
-                parameters.push({ name: segment.placeholder, value: fragments[i] });
+                parameters.push({ name: segment.placeholder, value: decode(fragments[i]) });
+            if (segment.fragment === null && segment.wildcard === true)
+                parameters.push({
+                    name: '**',
+                    value: fragments
+                        .slice(this.segments.length - 1)
+                        .map(decode)
+                        .join('/')
+                });
         }
         const exact = this.segments.length === fragments.length;
-        if (exact && !this.node.intermediate)
+        if ((exact && !this.node.intermediate) || this.wildcard)
             return { node: this.node, parameters };
         else
             return this.matchNested(fragments, parameters);
     }
+    *walk(prefix) {
+        // an expired branch is not matched, so nothing under it is reachable to name
+        if (Date.now() >= this.node.expiration)
+            return;
+        yield* this.node.walk(prefix.concat(this.segments));
+    }
     equals(route) {
         if (route.segments.length !== this.segments.length)
             return false;
@@ -37,13 +53,27 @@ class Route {
         return true;
     }
     merge(route) {
-        this.node.merge(route.node);
+        return this.node.merge(route.node);
     }
     matchNested(fragments, parameters) {
         fragments = fragments.slice(this.segments.length);
-        parameters = parameters.slice();
         return this.node.match(fragments, parameters);
     }
 }
-exports.Route = Route;
+/**
+ * What the segment says, rather than how it was written: a value is percent-encoded to
+ * survive the path, and an operation reads what a caller meant — a `client_id` that is a
+ * URL arrives as one. A literal segment is matched as written, which is how it is declared.
+ *
+ * An escape that decodes to nothing valid is left as it stands; refusing the route over it
+ * would answer `404` to a request whose only fault is its spelling.
+ */
+function decode(fragment) {
+    try {
+        return decodeURIComponent(fragment);
+    }
+    catch {
+        return fragment;
+    }
+}
 //# sourceMappingURL=Route.js.map

package/transpiled/RTD/Route.js.map

@@ -1 +1 @@
-{"version":3,"file":"Route.js","sourceRoot":"","sources":["../../source/RTD/Route.ts"],"names":[],"mappings":";;;AAIA,MAAa,KAAK;IACA,IAAI,CAAS;IACb,SAAS,GAAW,CAAC,CAAA;IACpB,QAAQ,CAAW;IACnB,IAAI,CAAM;IAE3B,YAAoB,QAAmB,EAAE,IAAU;QACjD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAEhB,KAAK,MAAM,OAAO,IAAI,QAAQ;YAC5B,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;gBAC3B,IAAI,CAAC,SAAS,EAAE,CAAA;IACtB,CAAC;IAEM,KAAK,CAAE,SAAmB,EAAE,UAAuB;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAEhC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC;gBAChE,OAAO,IAAI,CAAA;YAEb,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI;gBAC3D,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACvE,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,CAAA;QAEvD,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;;YACvE,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACrD,CAAC;IAEM,MAAM,CAAE,KAAY;QACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM;YAChD,OAAO,KAAK,CAAA;QAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE;YAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;gBAC1D,OAAO,KAAK,CAAA;QAEhB,OAAO,IAAI,CAAA;IACb,CAAC;IAEM,KAAK,CAAE,KAAY;QACxB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAEO,WAAW,CAAE,SAAmB,EAAE,UAAuB;QAC/D,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACjD,UAAU,GAAG,UAAU,CAAC,KAAK,EAAE,CAAA;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IAC/C,CAAC;CACF;AAtDD,sBAsDC"}
+{"version":3,"file":"Route.js","sourceRoot":"","sources":["../../source/RTD/Route.ts"],"names":[],"mappings":"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"}

package/transpiled/RTD/Tree.d.ts

@@ -1,7 +1,8 @@
-import type { Match } from './Match';
-import type { DirectiveFactory } from './Directives';
-import type { EndpointsFactory } from './Endpoint';
-import type * as syntax from './syntax';
+import type { Mount, Node } from './Node.ts';
+import type { Match } from './Match.ts';
+import type { DirectiveFactory } from './Directives.ts';
+import type { EndpointsFactory } from './Endpoint.ts';
+import type * as syntax from './syntax/index.ts';
 export declare class Tree {
     private readonly root;
     private readonly trunk;
@@ -9,6 +10,14 @@ export declare class Tree {
     private readonly directives;
     constructor(node: syntax.Node, endpoints: EndpointsFactory, directives: DirectiveFactory);
     match(path: string): Match | null;
-    merge(node: syntax.Node, extension: any): void;
+    /** Every method in the tree, with the template it answers at. */
+    walk(): Generator<Mount>;
+    merge(node: syntax.Node, extension: unknown): Node[];
+    /**
+     * Extends the expiration of an already merged branch, leaving its endpoints
+     * and their remotes intact.
+     */
+    refresh(nodes: Node[]): void;
+    dispose(): void;
     private createNode;
 }

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,8 +11,9 @@ 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 === '/')
@@ -20,12 +21,29 @@ class Tree {
                 node: this.trunk,
                 parameters: []
             };
-        const fragments = (0, segment_1.fragment)(path);
+        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 = {
@@ -33,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":";;;AAAA,uCAAsC;AACtC,uCAAoC;AAQpC,MAAa,IAAI;IACE,IAAI,CAAa;IACjB,KAAK,CAAM;IACX,SAAS,CAAkB;IAC3B,UAAU,CAAkB;IAE7C,YACC,IAAiB,EAAE,SAA2B,EAAE,UAA4B;QAC3E,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;gBACL,IAAI,EAAE,IAAI,CAAC,KAAK;gBAChB,UAAU,EAAE,EAAE;aACf,CAAA;QAEH,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,CACjB,IAAiB,EAAE,OAAgB,EAAE,SAAe;QACnD,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;AA9CD,oBA8CC;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,4 +1,5 @@
-import { Node } from './Node';
-import type { Context } from './Context';
-import type * as syntax from './syntax';
+import { Node } from './Node.ts';
+import type { Context } from './Context.ts';
+import type * as syntax from './syntax/index.ts';
 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 = method.directives.concat(context.directives.stack);
-    const directives = context.directives.factory.create(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;AAC/B,uCAAmC;AACnC,qCAA+C;AAI/C,SAAgB,UAAU,CAAE,IAAiB,EAAE,OAAgB;IAC7D,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;AAfD,gCAeC;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,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAChE,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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,EAAE,IAAI,EAAmB,MAAM,WAAW,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAA;AAIlD,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,OAAgB;IAC5D,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAA;;QACjE,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAEhF,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAExB,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;QAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEvF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAA;IAEnD,MAAM,UAAU,GAAe;QAC7B,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;KAC1D,CAAA;IAED,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAA;IAEzD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,UAAU,CAAA;IAE1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAE5B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAA;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB,EAAE,OAAgB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEpC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAErC;;;;OAIG;IACH,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QACrB,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACpD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAClD,CAAA;IAEH,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAE5C,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA,CAAC,UAAU;IAC3C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA;IAEnB,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY;IACtC,2DAA2D;IAC3D,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,MAAqB,EAAE,OAAgB;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzE,MAAM,QAAQ,GACZ,MAAM,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS;QACpC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/C,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAiB,EAAE,OAAgB;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAC/B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,IAAI,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,CACtE,CAAA;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAM;IAEzD,4EAA4E;IAC5E,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAM;IAE5D,MAAM,KAAK,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEpD,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,qBAAqB,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,IAAI,GAAG,GAAG,CAAA;AAChB,MAAM,IAAI,GAAG,MAAM,CAAA"}

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.ts';
+export * from './Node.ts';
+export * from './Match.ts';
+export * from './Method.ts';
+export * from './Context.ts';
+export * from './Endpoint.ts';
+export * from './Directives.ts';
+export * as syntax from './syntax/index.ts';