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

package/transpiled/Gateway.js

@@ -1,92 +1,335 @@
-"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))
+        // the route of a plain request that presents a credential is found first: what its
+        // method declares may say the credential is not the gateway's to read
+        const match = context.request.headers.authorization !== undefined && this.plain(context)
+            ? this.find(context)
+            : null;
+        const method = match === null ? undefined : methodOf(match.node, context.request.method);
+        // request-scoped, before anything is called: this is where a credential is read
+        await this.directives.preflight(context, method?.directives).catch(rethrow);
+        const response = await this.endpoint(context, match);
+        // 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, match = null) {
+        // 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, match);
+    }
+    /** Whether a request is to a route of the tree, rather than to an endpoint served beside it. */
+    plain(context) {
+        const { pathname } = context.url;
+        return (!(this.mcp !== null && this.mcp.hosted(context.url.host)) &&
+            !(this.dispatcher !== null && pathname === RPC) &&
+            !(this.mcp !== null && pathname === MCP) &&
+            pathname !== DISCOVERY &&
+            pathname !== DISCOVERY + '/');
+    }
+    /** 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, found = null) {
+        const { node, parameters } = found ?? this.match(context);
+        if (context.request.method === 'OPTIONS')
+            return await this.explain(context, node, parameters);
+        const method = methodOf(node, context.request.method);
+        if (method === undefined)
             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 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.find(context);
+        if (match === null) {
+            // the route may be missing because an expose has been lost
+            this.reping();
+            throw new http.NotFound('Route not found');
+        }
+        return match;
+    }
+    /** The route a request is served by, where the tree has one, forwarded where it says so. */
+    find(context) {
+        const match = this.tree.match(context.url.pathname);
+        if (match === null)
+            return null;
+        // 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.tree.merge(branch.node, branch);
-            console.info('Resource branch of ' +
-                `'${branch.namespace}.${branch.component}' has been merged`);
+            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 {
+            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;
+/** The method of a node a verb is served by: `HEAD` by `GET` where the node has no `HEAD`. */
+function methodOf(node, verb) {
+    if (verb in node.methods)
+        return node.methods[verb];
+    if (verb === 'HEAD')
+        return node.methods.GET;
+    return undefined;
+}
 //# sourceMappingURL=Gateway.js.map

package/transpiled/Gateway.js.map

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

package/transpiled/HTTP/Context.d.ts

@@ -1,31 +1,87 @@
-/// <reference types="node" />
-import { Timing } from './Timing';
-import { type Format } from './formats';
-import type { OutgoingMessage } from './messages';
-import type * as http from 'node:http';
+import { Timing } from './Timing.ts';
+import { type Format } from './formats/index.ts';
+import type { OutgoingMessage } from './messages.ts';
+import { type Labels } from '../measurements.ts';
+import type { IncomingMessage } from './types.ts';
 export declare class Context {
     readonly authority: string;
     readonly request: IncomingMessage;
+    /** the client address, read as the deployment says; none otherwise, see `documentation/ip.md` */
+    readonly ip: string | undefined;
+    /** the client's country, read as the deployment says; none otherwise, see `documentation/ip.md` */
+    readonly country: string | undefined;
     readonly url: URL;
     readonly subtype: string | null;
     readonly encoder: Format | null;
     readonly timing: Timing;
-    readonly debug: boolean;
+    /**
+     * The labels the request is measured under. `route` is `none` until the tree matches one, and
+     * the object is the very one the span carries — so setting it here is what the metric records.
+     */
+    labels: Labels;
+    /**
+     * Aborted when the reply is finished, when the connection is gone, or when the gateway is
+     * stopping. What is still waiting on something else when it fires abandons it.
+     */
+    readonly signal: AbortSignal;
+    /**
+     * Whether this is a procedure a request made, rather than the request. What forks one
+     * says so, and a directive that answers differently to a procedure than to a request
+     * reads it here.
+     */
+    readonly procedural: boolean;
+    /**
+     * Whether this describes a resource rather than calling one. What builds a describing
+     * context says so, and a directive that answers differently to a description than to a
+     * call reads it here.
+     */
+    readonly exploratory: boolean;
+    /**
+     * The process a stateful operation is called on, as the route carries it. What `map:instance`
+     * takes out of the route is left here for the endpoint to call with.
+     */
+    instance?: string;
+    /**
+     * What this request receives of the operation's output, as `io:output` states it: the
+     * properties of each object it answers, and none of it where the list is empty. Absent where
+     * the reply passes whole.
+     */
+    output?: string[];
+    /**
+     * Whether the call this request makes may only read, as `io:readonly` states it. Absent where
+     * no route states one, and the method the request was made with is then what answers.
+     */
+    readonly?: boolean;
+    /**
+     * Whether anything on the way out reads the body: a directive that takes a property of it, or
+     * builds an answer around it. What does says so, and a reply is then values rather than bytes.
+     */
+    reads?: boolean;
+    /**
+     * The media type this request is answered in, where the route states what it produces: resolved
+     * against the request's `accept` before the call, handed to the operation, and what a stream it
+     * answers is served under.
+     */
+    answers?: string;
+    /** Whether the body outgrew what the route takes, which is answered rather than served. */
+    exceeded?: boolean;
     readonly pipelines: Pipelines;
-    constructor(authority: string, request: IncomingMessage, properties: Properties);
+    private consumed;
+    constructor(authority: string, request: IncomingMessage, properties: Properties, url: URL, signal: AbortSignal);
+    buffer(): Promise<Buffer>;
+    /** The body as it arrives, for whoever hands it over rather than reads it. */
+    stream(): IncomingMessage;
     body<T>(): Promise<T>;
     private log;
 }
-export interface IncomingMessage extends http.IncomingMessage {
-    url: string;
-    method: string;
-}
 interface Pipelines {
     body: Array<(input: unknown) => unknown>;
-    response: Array<(output: OutgoingMessage) => void>;
+    response: Array<(output: OutgoingMessage) => void | Promise<void>>;
 }
 interface Properties {
-    debug: boolean;
-    trace: boolean;
+    /** the header the client address is read from; the connection's without one */
+    ip?: string;
+    /** the header the client's country is read from */
+    country?: string;
 }
 export {};