@toa.io/core 1.0.0-alpha.30 → 1.0.0-alpha.300

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@toa.io/core",
-  "version": "1.0.0-alpha.30",
+  "version": "1.0.0-alpha.300",
+  "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.30",
-    "@toa.io/generic": "1.0.0-alpha.30",
-    "@toa.io/yaml": "1.0.0-alpha.30",
-    "error-value": "0.3.0"
-  },
-  "devDependencies": {
-    "clone-deep": "4.0.1"
+    "@rsql/parser": "1.6.0",
+    "@toa.io/generic": "1.0.0-alpha.292",
+    "@toa.io/schemas": "1.0.0-alpha.299",
+    "openspan": "1.0.0-alpha.293",
+    "uuid": "14.0.2"
   },
-  "gitHead": "29cc19358f35fbe9229dced979724f7a26538013"
+  "gitHead": "f91131a9aeb29aa271f177c4055ddcf0cda8c75e"
 }

package/transpiled/abandon.d.ts

@@ -0,0 +1,9 @@
+import type { Exception } from './exceptions.js';
+/** 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.js';
+import type { Store } from './operation.js';
+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.js';
+import type { Transmission } from './transmission.js';
+import type { Request as Contract } from './contract/request.js';
+import type { Options, Request, Source } from './types/request.js';
+export declare class Call extends Connector {
+    #private;
+    constructor(transmitter: Transmission, contract: Contract, target: string, source?: Source, stateful?: boolean);
+    invoke(request?: Request, options?: Options): Promise<any>;
+    explain(): any;
+}

package/transpiled/call.js

@@ -0,0 +1,146 @@
+import { Readable } from 'node:stream';
+import { current, encode } from 'openspan';
+import { Connector } from './connector.js';
+import { derive, newid } from './entities/newid.js';
+import { RequestContractException } 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;
+    // eslint-disable-next-line max-params
+    constructor(transmitter, contract, target, source, stateful = false) {
+        super();
+        this.#transmitter = transmitter;
+        this.#contract = contract;
+        this.#target = target;
+        this.#source = source;
+        this.#stateful = stateful;
+        this.depends(transmitter);
+    }
+    async invoke(request = {}, options = {}) {
+        const invocation = trail.current();
+        this.#refuse(request, options);
+        // the process a call goes to, which the transmission is handed beside what the call asks
+        const { instance, ...asked } = request;
+        /*
+         * 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;
+        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) {
+        const { instance, task } = request;
+        const { timeout, signal } = options;
+        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\``);
+        // 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`');
+        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 one only where its caller set it.
+     */
+    #terms(instance, timeout, signal) {
+        const deadline = timeout ?? (this.#stateful ? addressed.timeout() : undefined);
+        if (instance === undefined && deadline === undefined && signal === undefined)
+            return undefined;
+        const signals = [];
+        if (signal !== undefined)
+            signals.push(signal);
+        if (deadline !== undefined)
+            signals.push(AbortSignal.timeout(deadline));
+        const terms = {};
+        if (instance !== undefined)
+            terms.instance = instance;
+        if (deadline !== undefined)
+            terms.timeout = deadline;
+        if (signals.length > 0)
+            terms.signal = signals.length === 1 ? signals[0] : AbortSignal.any(signals);
+        return terms;
+    }
+    /** 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);
+    }
+}
+/** 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.js';
+import type { Algorithm } from './types/bridges.js';
+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.js';
+import type { Locator } from './locator.js';
+import type { Envelope, Options, Request } from './types/request.js';
+/** 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,93 @@
+import { console, current, decode, run } from 'openspan';
+import { Connector } from './connector.js';
+import { EndpointException } from './exceptions.js';
+import * as trail from './trail.js';
+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) {
+        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.
+             */
+            const scope = { hops, id: request?.id, calls: new Map() };
+            task = async () => trail.follow(scope, invocation);
+        }
+        if (remote === null)
+            return task();
+        else
+            return run(remote, task);
+    }
+    async #process(endpoint, request, options) {
+        return console.span(this.#span(endpoint), async () => {
+            const reply = await this.operations[endpoint].invoke(request, options);
+            if (reply?.exception !== undefined) {
+                const span = current();
+                if (span !== undefined)
+                    span.status = 'error';
+                console.error('Failed to execute operation', {
+                    endpoint: `${this.locator.id}.${endpoint}`,
+                    exception: reply.exception
+                });
+            }
+            return reply;
+        });
+    }
+    /**
+     * 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) {
+            options = { name: `${this.locator.id}.${endpoint}`, kind: this.kind };
+            // 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.js';
+export declare class Composition extends Connector {
+    constructor(expositions: Connector[], producers: Connector[], receivers: Connector[], tenants: Connector[]);
+    protected open(): Promise<void>;
+    protected dispose(): Promise<void>;
+}

package/transpiled/composition.js

@@ -0,0 +1,23 @@
+import { console } from 'openspan';
+import { Connector } from './connector.js';
+export class Composition extends Connector {
+    // eslint-disable-next-line max-params
+    constructor(expositions, producers, receivers, tenants) {
+        super();
+        if (expositions.length > 0)
+            this.depends(expositions);
+        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,sCAAsC;IACtC,YACE,WAAwB,EACxB,SAAsB,EACtB,SAAsB,EACtB,OAAoB;QAEpB,KAAK,EAAE,CAAA;QAEP,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACrD,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"}

package/transpiled/connector.d.ts

@@ -0,0 +1,54 @@
+/** Abstract connections hierarchy */
+export declare class Connector {
+    #private;
+    readonly id: string;
+    connected: boolean;
+    /**
+     * Whether this has been taken down. What is disposed of is never connected again: a
+     * communication it held is sealed, an announcement it made has stopped, an algorithm it ran
+     * is unmounted. Whoever remembers one for the life of the process — an extension factory
+     * caching what it hands to components — replaces it rather than handing it out twice.
+     */
+    disposed: boolean;
+    constructor();
+    /**
+     * Creates a dependency and backlink with another Connector or a set of Connectors
+     *
+     * See .connect() and .disconnect()
+     *
+     */
+    depends(connector: Connector | Connector[]): Connector;
+    /**
+     * Creates a backlink to another Connector
+     *
+     * See .connect() and .disconnect()
+     *
+     */
+    link(connector: Connector): void;
+    /**
+     * Connects dependants then self
+     *
+     * In case of exception disconnects with current connection interruption
+     *
+     * Method is idempotent
+     *
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnects self then dependants
+     *
+     * Does nothing if there are connected linked Connectors
+     *
+     * Method is idempotent
+     *
+     */
+    disconnect(interrupt?: boolean): Promise<void>;
+    reconnect(): Promise<void>;
+    debug(node?: Record<string, any>): Record<string, any>;
+    /** Called on connection */
+    protected open(): Promise<void> | void;
+    /** Called on disconnection */
+    protected close(): Promise<void> | void;
+    /** Called after self and dependants disconnection is complete */
+    protected dispose(): Promise<void> | void;
+}