@toa.io/core 1.0.0-alpha.32 → 1.0.0-alpha.320

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@toa.io/core",
-  "version": "1.0.0-alpha.32",
+  "version": "1.0.0-alpha.320",
+  "type": "module",
   "description": "Toa Core",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -11,23 +12,38 @@
   "bugs": {
     "url": "https://github.com/toa-io/toa/issues"
   },
-  "main": "src/index.js",
-  "types": "types/index.ts",
+  "main": "transpiled/index.js",
+  "types": "transpiled/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./transpiled/index.d.ts",
+      "default": "./transpiled/index.js"
+    },
+    "./types": {
+      "types": "./transpiled/types/index.d.ts",
+      "default": "./transpiled/types/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "transpiled",
+    "!**/tsconfig.tsbuildinfo",
+    "!**/*.test.*",
+    "!**/.env*"
+  ],
   "scripts": {
+    "transpile": "tsc",
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@rsql/parser": "1.2.4",
-    "@toa.io/console": "1.0.0-alpha.32",
-    "@toa.io/generic": "1.0.0-alpha.32",
-    "@toa.io/yaml": "1.0.0-alpha.32",
-    "error-value": "0.3.0"
-  },
-  "devDependencies": {
-    "clone-deep": "4.0.1"
+    "@rsql/parser": "1.6.0",
+    "@toa.io/generic": "1.0.0-alpha.311",
+    "@toa.io/schemas": "1.0.0-alpha.311",
+    "openspan": "1.0.0-alpha.305",
+    "uuid": "14.0.2"
   },
-  "gitHead": "93ceb53797363abb77eb9c550db77e906691d42a"
+  "gitHead": "5ef92ab939a596e4ac820965c59c015820eba7b2"
 }

package/transpiled/abandon.d.ts

@@ -0,0 +1,9 @@
+import type { Exception } from './exceptions.ts';
+/** What a caller that stopped waiting for `target` is told. */
+export declare function abandoned(target: string, signal: AbortSignal): Exception;
+/**
+ * What the promise settles with, or *abandoned* once the signal aborts, whichever comes first — at
+ * once where it has aborted already. The promise goes on running, and settles with nobody waiting
+ * for it.
+ */
+export declare function waiting<T>(promise: Promise<T>, signal: AbortSignal | undefined, target: string): Promise<T>;

package/transpiled/abandon.js

@@ -0,0 +1,37 @@
+import { AbandonedException } from './exceptions.js';
+/** What a caller that stopped waiting for `target` is told. */
+export function abandoned(target, signal) {
+    return new AbandonedException(`'${target}' went unanswered`, signal.reason);
+}
+/**
+ * What the promise settles with, or *abandoned* once the signal aborts, whichever comes first — at
+ * once where it has aborted already. The promise goes on running, and settles with nobody waiting
+ * for it.
+ */
+export async function waiting(promise, signal, target) {
+    if (signal === undefined)
+        return await promise;
+    if (signal.aborted) {
+        promise.catch(noop);
+        throw abandoned(target, signal);
+    }
+    let abort = noop;
+    const aborted = new Promise((_resolve, reject) => {
+        abort = () => reject(abandoned(target, signal));
+    });
+    signal.addEventListener('abort', abort, { once: true });
+    try {
+        return await Promise.race([promise, aborted]);
+    }
+    catch (exception) {
+        // however the wait ended — here, or in whatever was carrying it
+        if (signal.aborted)
+            throw abandoned(target, signal);
+        throw exception;
+    }
+    finally {
+        signal.removeEventListener('abort', abort);
+    }
+}
+function noop() { }
+//# sourceMappingURL=abandon.js.map

package/transpiled/abandon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abandon.js","sourceRoot":"","sources":["../source/abandon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGpD,+DAA+D;AAC/D,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAAmB;IAC3D,OAAO,IAAI,kBAAkB,CAAC,IAAI,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAmB,EACnB,MAA+B,EAC/B,MAAc;IAEd,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,OAAO,CAAA;IAE9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEnB,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,KAAK,GAAe,IAAI,CAAA;IAE5B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtD,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAEvD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,gEAAgE;QAChE,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAEnD,MAAM,SAAS,CAAA;IACjB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,IAAI,KAAU,CAAC"}

package/transpiled/assignment.d.ts

@@ -0,0 +1,6 @@
+import { Operation } from './operation.ts';
+import type { Store } from './operation.ts';
+export declare class Assignment extends Operation {
+    protected acquire(store: Store): Promise<void>;
+    protected commit(store: Store): Promise<void>;
+}

package/transpiled/assignment.js

@@ -0,0 +1,25 @@
+import { Operation } from './operation.js';
+export class Assignment extends Operation {
+    async acquire(store) {
+        const changeset = this.scope.changeset(store.request.query);
+        store.scope = changeset;
+        store.state = changeset.get();
+    }
+    async commit(store) {
+        const { scope, state, reply, request } = store;
+        if (reply.error !== undefined)
+            return;
+        const changeset = scope;
+        changeset.set(state);
+        /*
+         * The call carries the reply as it stands, which is empty where the algorithm named no
+         * output — the storage fills it with the post-image it computes, because that is where the
+         * post-image is known.
+         */
+        const output = await this.scope.apply(changeset, request.input, this.call(store));
+        // assignment returns new state by default
+        if (store.reply.output === undefined)
+            store.reply.output = output;
+    }
+}
+//# sourceMappingURL=assignment.js.map

package/transpiled/assignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.js","sourceRoot":"","sources":["../source/assignment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI1C,MAAM,OAAO,UAAW,SAAQ,SAAS;IACpB,KAAK,CAAC,OAAO,CAAC,KAAY;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,KAAY,CAAC,CAAA;QAElE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAA;QACvB,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,CAAA;IAC/B,CAAC;IAEkB,KAAK,CAAC,MAAM,CAAC,KAAY;QAC1C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,CAAA;QAE9C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,OAAM;QAErC,MAAM,SAAS,GAAG,KAAkB,CAAA;QAEpC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAEpB;;;;WAIG;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAEjF,0CAA0C;QAC1C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAA;IACnE,CAAC;CACF"}

package/transpiled/call.d.ts

@@ -0,0 +1,10 @@
+import { Connector } from './connector.ts';
+import type { Transmission } from './transmission.ts';
+import type { Request as Contract } from './contract/request.ts';
+import type { Options, Request, Source } from './types/request.ts';
+export declare class Call extends Connector {
+    #private;
+    constructor(transmitter: Transmission, contract: Contract, target: string, source?: Source, stateful?: boolean, safe?: boolean, streamed?: string);
+    invoke(request?: Request, options?: Options): Promise<any>;
+    explain(): any;
+}

package/transpiled/call.js

@@ -0,0 +1,187 @@
+import { Readable } from 'node:stream';
+import { current, encode } from 'openspan';
+import { Connector } from './connector.js';
+import { derive, newid } from './entities/newid.js';
+import { RequestContractException, SafetyException } from './exceptions.js';
+import { abandoned, waiting } from './abandon.js';
+import * as addressed from './instance.js';
+import * as trail from './trail.js';
+export class Call extends Connector {
+    #transmitter;
+    #contract;
+    /** what this calls, as a hop is named, so that an identity derived here names it too */
+    #target;
+    #source;
+    /** whether a call to it names the process it goes to */
+    #stateful;
+    /** whether what it calls is incapable of changing the State; see `safety.ts` */
+    #safe;
+    /** the input property a stream is carried in, where what it calls takes one */
+    #streamed;
+    // eslint-disable-next-line max-params
+    constructor(transmitter, contract, target, source, stateful = false, safe = false, streamed) {
+        super();
+        this.#transmitter = transmitter;
+        this.#contract = contract;
+        this.#target = target;
+        this.#source = source;
+        this.#stateful = stateful;
+        this.#safe = safe;
+        this.#streamed = streamed;
+        this.depends(transmitter);
+    }
+    async invoke(request = {}, options = {}) {
+        const invocation = trail.current();
+        /*
+         * The process a call goes to, which the transmission is handed beside what the call asks, and
+         * what the caller said of reading, which is not the answer on its own.
+         */
+        const { instance, readonly: stated, ...asked } = request;
+        /*
+         * The disjunction is what makes it a guarantee rather than a convention: a caller under a
+         * readonly invocation cannot clear it for a call of its own.
+         */
+        const readonly = stated === true || invocation?.readonly === true;
+        this.#refuse(request, options, readonly);
+        /*
+         * The envelope is built around what the caller asked for rather than written over it: one
+         * request object is handed to several concurrent calls in more than one place, and those are
+         * different calls — sharing one identity would have all but the first refused as duplicates
+         * of it.
+         */
+        const envelope = {
+            ...asked,
+            // avoid validation on the recipient's side
+            authentic: true,
+            // an operation that takes no input still has to send an explicit null
+            input: request.input ?? null,
+            id: request.id ?? this.#identity(invocation),
+            /*
+             * What a receiver has already put on the request wins, and a service with no chain in
+             * scope starts one under its own name.
+             */
+            trail: request.trail ?? invocation?.hops ?? service(this.#source),
+            // the caller may have attributed the call itself, as the node bridge does
+            source: request.source ?? this.#source
+        };
+        // nothing carries a key it has no value for onto the wire
+        if (envelope.source === undefined)
+            delete envelope.source;
+        if (envelope.trail === undefined)
+            delete envelope.trail;
+        if (readonly)
+            envelope.readonly = true;
+        this.#contract.fit(envelope);
+        const context = current();
+        if (context !== undefined)
+            envelope.telemetry = encode(context);
+        const reply = await this.#transmit(envelope, this.#terms(instance, options.timeout, options.signal));
+        if (reply === null)
+            return null;
+        else if (reply instanceof Readable)
+            return reply;
+        else {
+            if (reply.exception !== undefined)
+                throw reply.exception;
+            if (reply.error !== undefined)
+                return new RemoteError(reply.error);
+            else
+                return reply.output;
+        }
+    }
+    explain() {
+        return this.#contract.discovery;
+    }
+    /**
+     * Derived where this process is serving a call, so that the same call served twice makes the
+     * same call here twice over and whatever it reaches refuses its own copy; minted where there
+     * is nothing to derive from, which is an entry point, or a caller from before identities.
+     */
+    #identity(invocation) {
+        if (invocation?.id === undefined)
+            return newid();
+        return derive(invocation.id, this.#target, trail.ordinal(invocation, this.#target));
+    }
+    /** A call whose making contradicts what it calls is refused before anything is sent. */
+    #refuse(request, options, readonly) {
+        const { instance, task } = request;
+        const { timeout, signal } = options;
+        if (readonly && !this.#safe)
+            throw new SafetyException(`'${this.#target}' may change state, and this call may only read`);
+        if (this.#stateful && instance === undefined)
+            throw new RequestContractException(`'${this.#target}' is stateful, and a call to it names \`instance\``);
+        if (!this.#stateful && instance !== undefined)
+            throw new RequestContractException(`'${this.#target}' is stateless, and a call to it names no \`instance\``);
+        // a task is taken by whichever process is free, and a stateful operation is served
+        // under the name of one
+        if (this.#stateful && task === true)
+            throw new RequestContractException(`'${this.#target}' is stateful, and a call to it is no task`);
+        // nobody waits for a task, and it is made from wherever the queue is consumed
+        if (task === true && (timeout !== undefined || signal !== undefined))
+            throw new RequestContractException('A task names no `timeout` and no `signal`');
+        // an ordinary call is answered eventually, and what nobody could answer is parked with who
+        // asked — which only means something to a caller still waiting
+        if (!this.#stateful && (timeout !== undefined || signal !== undefined))
+            throw new RequestContractException(`'${this.#target}' is stateless, and a call to it names no \`timeout\` and no \`signal\``);
+        if (this.#streamed !== undefined) {
+            // a task is taken later, by a process whose caller is no longer holding a stream
+            if (task === true)
+                throw new RequestContractException(`'${this.#target}' takes a stream, and a task carries none`);
+            // the contract has the property, and only what is made here can say what is in it
+            if (!carries(request.input, this.#streamed))
+                throw new RequestContractException(`'${this.#target}' takes a stream at '${this.#streamed}', which this call carries none of`);
+        }
+        if (timeout !== undefined && !(Number.isFinite(timeout) && timeout > 0))
+            throw new RequestContractException('`timeout` is a positive number of milliseconds');
+    }
+    /**
+     * What the transmission is handed beside the envelope. An addressed call always waits for a set
+     * time — its caller's, or the context's — because nothing else ends a call to a process that has
+     * gone; an ordinary call waits for as long as it takes, and is handed nothing.
+     */
+    #terms(instance, timeout, signal) {
+        if (instance === undefined)
+            return undefined;
+        const deadline = timeout ?? addressed.timeout();
+        const expiry = AbortSignal.timeout(deadline);
+        return {
+            instance,
+            timeout: deadline,
+            signal: signal === undefined ? expiry : AbortSignal.any([signal, expiry])
+        };
+    }
+    /** The reply, or *abandoned* once the caller has stopped waiting, however the wait ended. */
+    async #transmit(envelope, terms) {
+        const signal = terms?.signal;
+        // a call its caller stopped waiting for before it was made is handed to no binding
+        if (signal?.aborted === true)
+            throw abandoned(this.#target, signal);
+        return await waiting(this.#transmitter.request(envelope, terms), signal, this.#target);
+    }
+}
+/**
+ * Whether the input carries a stream where the operation takes one: the property itself where its
+ * caller said nothing about it, and the property's `stream` where a route filled one.
+ */
+function carries(input, property) {
+    if (input === null || typeof input !== 'object')
+        return false;
+    const carried = input[property];
+    if (carried instanceof Readable)
+        return true;
+    if (carried === null || typeof carried !== 'object')
+        return false;
+    return carried.stream instanceof Readable;
+}
+/** Where a service calls from no invocation, the chain starts under the service's own name. */
+function service(source) {
+    return source !== undefined && 'service' in source ? [source.service] : undefined;
+}
+// the remote error as a value: every property it carries, and nothing else enumerable
+class RemoteError extends Error {
+    constructor(error) {
+        super();
+        Object.assign(this, error);
+    }
+}
+//# sourceMappingURL=call.js.map

package/transpiled/call.js.map

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

package/transpiled/cascade.d.ts

@@ -0,0 +1,7 @@
+import { Connector } from './connector.ts';
+import type { Algorithm } from './types/bridges.ts';
+export declare class Cascade extends Connector {
+    #private;
+    constructor(bridges: Algorithm[], preflight?: Connector);
+    run(...args: [any, any?]): Promise<any>;
+}

package/transpiled/cascade.js

@@ -0,0 +1,28 @@
+import { Connector } from './connector.js';
+export class Cascade extends Connector {
+    #last;
+    constructor(bridges, preflight) {
+        super();
+        // this.#bridges = bridges
+        this.#last = bridges[bridges.length - 1];
+        if (preflight === undefined)
+            this.depends(bridges);
+        else
+            this.depends(bridges).depends(preflight);
+    }
+    async run(...args) {
+        // const reply = {}
+        //
+        // for (const bridge of this.#bridges) {
+        //   const partial = await bridge.execute(...args)
+        //
+        //   if (partial.error) return { error: partial.error }
+        //
+        //   merge(reply, partial)
+        // }
+        //
+        // return reply
+        return this.#last.execute(...args);
+    }
+}
+//# sourceMappingURL=cascade.js.map

package/transpiled/cascade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../source/cascade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG1C,MAAM,OAAO,OAAQ,SAAQ,SAAS;IAC3B,KAAK,CAAW;IAEzB,YAAmB,OAAoB,EAAE,SAAqB;QAC5D,KAAK,EAAE,CAAA;QAEP,0BAA0B;QAC1B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAExC,IAAI,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;;YAC7C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/C,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAiB;QACnC,mBAAmB;QACnB,EAAE;QACF,wCAAwC;QACxC,kDAAkD;QAClD,EAAE;QACF,uDAAuD;QACvD,EAAE;QACF,0BAA0B;QAC1B,IAAI;QACJ,EAAE;QACF,eAAe;QAEf,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACpC,CAAC;CACF"}

package/transpiled/component.d.ts

@@ -0,0 +1,15 @@
+import { Connector } from './connector.ts';
+import type { Locator } from './locator.ts';
+import type { Envelope, Options, Request } from './types/request.ts';
+/** What a component holds one of per endpoint: an operation, or the call that stands for it. */
+export interface Invocable extends Connector {
+    invoke: (request: Envelope, options?: Options) => Promise<any>;
+}
+export declare class Component<O extends Invocable = Invocable> extends Connector {
+    #private;
+    readonly locator: Locator;
+    protected readonly operations: Record<string, O>;
+    protected kind: 'server' | 'client';
+    constructor(locator: Locator, operations: Record<string, O>);
+    invoke<T = any>(endpoint: string, request?: Request, options?: Options): Promise<T>;
+}

package/transpiled/component.js

@@ -0,0 +1,148 @@
+import { console, current, decode, run } from 'openspan';
+import { Connector } from './connector.js';
+import { DisposedException, EndpointException, names, permanent } from './exceptions.js';
+import * as measure from './measurements.js';
+import * as trail from './trail.js';
+/** The code a declared error refuses with, which its manifest bounds. */
+function code(error) {
+    return String(error.code ?? 'UNDECLARED');
+}
+export class Component extends Connector {
+    locator;
+    operations;
+    kind = 'server';
+    /** span options per endpoint */
+    #spans = {};
+    /** what refuses a call that has been here already, as the environment states it */
+    #limits = trail.limits();
+    constructor(locator, operations) {
+        super();
+        this.locator = locator;
+        this.operations = operations;
+        Object.values(operations).forEach((operation) => this.depends(operation));
+    }
+    async invoke(endpoint, request, options) {
+        /*
+         * A component that has been taken down refuses to work. What reaches it here is something
+         * the component started and did not stop — an interval, a watcher, a promise nobody
+         * awaited — calling through a context whose tree is gone, and a resume builds another tree
+         * rather than reviving this one, so it is never coming back.
+         *
+         * The client side is left alone deliberately: a `Remote` is a client to a queue rather than
+         * to an instance of anything, so its being taken down says nothing about whether what it
+         * calls is there.
+         */
+        if (this.disposed && this.kind === 'server')
+            throw new DisposedException(`'${this.locator.id}' has been taken down, and what reached it here was started by ` +
+                'something that outlived it');
+        if (!(endpoint in this.operations))
+            throw new EndpointException(`'${endpoint}' is not provided by '${this.locator.id}'`);
+        // if the request carries no telemetry, the trace starts here
+        const remote = request?.telemetry === undefined ? null : decode(request.telemetry);
+        const invocation = async () => this.#process(endpoint, request, options);
+        let task = invocation;
+        /*
+         * The hop is the server's alone. A `Remote` is a component too and names the very endpoint
+         * this one does, so counting it there as well would make the threshold depend on how many
+         * clients a call happened to cross — a different number for a local call, an HTTP one and a
+         * delayed one. An endpoint beginning with `.` is the runtime's own and is no hop at all.
+         */
+        if (this.kind === 'server' && endpoint[0] !== '.') {
+            let hops;
+            try {
+                // the span's name is the hop's, and it is already built once per endpoint
+                hops = trail.extend(request?.trail, this.#span(endpoint).name, this.#limits);
+            }
+            catch (exception) {
+                console.error('Call chain refused', {
+                    endpoint: `${this.locator.id}.${endpoint}`,
+                    exception
+                });
+                // answered, not thrown: thrown, this would run into the broker library on the event
+                // path, and on the call path its code would survive only by `Exception` not being an
+                // `Error`. Answered, `Call` throws it into the caller as it does any other.
+                return { exception };
+            }
+            /*
+             * The identity is put in scope with the chain: an operation reaches neither, and the
+             * calls it makes derive their own from what it is serving. So is whether this request may
+             * only read, which is what every call the operation makes is then held to.
+             */
+            const scope = { hops, id: request?.id };
+            if (request?.readonly === true)
+                scope.readonly = true;
+            task = async () => trail.follow(scope, invocation);
+        }
+        if (remote === null)
+            return task();
+        else
+            return run(remote, task);
+    }
+    async #process(endpoint, request, options) {
+        const measurements = this.kind === 'server' ? measure.operation : measure.call;
+        const labels = { component: this.locator.id, operation: endpoint };
+        measurements.inflight.add(1, labels);
+        try {
+            return await console.span(this.#span(endpoint), async () => {
+                const reply = await this.operations[endpoint].invoke(request, options);
+                if (reply?.error !== undefined && this.kind === 'server')
+                    measure.operation.errors.add(1, { ...labels, code: code(reply.error) });
+                if (reply?.exception !== undefined) {
+                    const span = current();
+                    if (span !== undefined)
+                        span.status = 'error';
+                    this.#failed(labels, reply.exception);
+                    console.error('Failed to execute operation', {
+                        endpoint: `${this.locator.id}.${endpoint}`,
+                        exception: reply.exception
+                    });
+                }
+                return reply;
+            });
+        }
+        finally {
+            measurements.inflight.add(-1, labels);
+        }
+    }
+    /**
+     * A refusal the caller sees is one the callee already counted, so only the server side counts
+     * an exception. `outcome` is what a receiver reads to choose between another attempt and the
+     * parking queue, which makes it two different incidents rather than one rate.
+     */
+    #failed(labels, exception) {
+        if (this.kind !== 'server')
+            return;
+        const { code = 0 } = exception;
+        measure.operation.exceptions.add(1, {
+            ...labels,
+            code: names[code] ?? String(code),
+            outcome: permanent(exception) ? 'permanent' : 'transient'
+        });
+    }
+    /**
+     * The span of an endpoint never changes, so it is built once. Not in the constructor:
+     * `kind` is a field of the subclass, and those are assigned after this one is built.
+     *
+     */
+    #span(endpoint) {
+        let options = this.#spans[endpoint];
+        if (options === undefined) {
+            const measurements = this.kind === 'server' ? measure.operation : measure.call;
+            options = {
+                name: `${this.locator.id}.${endpoint}`,
+                kind: this.kind,
+                measure: {
+                    histogram: measurements.duration,
+                    labels: { component: this.locator.id, operation: endpoint }
+                }
+            };
+            // the server span is emitted by the component itself, while the client span
+            // belongs to the calling service and inherits it from the context
+            if (this.kind === 'server')
+                options.service = this.locator.id;
+            this.#spans[endpoint] = options;
+        }
+        return options;
+    }
+}
+//# sourceMappingURL=component.js.map

package/transpiled/component.js.map

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

package/transpiled/composition.d.ts

@@ -0,0 +1,6 @@
+import { Connector } from './connector.ts';
+export declare class Composition extends Connector {
+    constructor(producers: Connector[], receivers: Connector[], tenants: Connector[]);
+    protected open(): Promise<void>;
+    protected dispose(): Promise<void>;
+}

package/transpiled/composition.js

@@ -0,0 +1,20 @@
+import { console } from 'openspan';
+import { Connector } from './connector.js';
+export class Composition extends Connector {
+    constructor(producers, receivers, tenants) {
+        super();
+        if (producers.length > 0)
+            this.depends(producers);
+        if (receivers.length > 0)
+            this.depends(receivers);
+        if (tenants.length > 0)
+            this.depends(tenants);
+    }
+    async open() {
+        console.info('Composition complete');
+    }
+    async dispose() {
+        console.info('Composition shutdown complete');
+    }
+}
+//# sourceMappingURL=composition.js.map

package/transpiled/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../source/composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,YACE,SAAsB,EACtB,SAAsB,EACtB,OAAoB;QAEpB,KAAK,EAAE,CAAA;QAEP,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACjD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IACtC,CAAC;IAEkB,KAAK,CAAC,OAAO;QAC9B,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;IAC/C,CAAC;CACF"}