@toa.io/core 1.0.0-alpha.284 → 1.0.0-alpha.287

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 { 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: Request) => 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): Promise<T>;
+}

package/transpiled/component.js

@@ -0,0 +1,61 @@
+import assert from 'node:assert';
+import { console, current, decode, run } from 'openspan';
+import { Connector } from './connector.js';
+export class Component extends Connector {
+    locator;
+    operations;
+    kind = 'server';
+    /** span options per endpoint */
+    #spans = {};
+    constructor(locator, operations) {
+        super();
+        this.locator = locator;
+        this.operations = operations;
+        Object.values(operations).forEach((operation) => this.depends(operation));
+    }
+    async invoke(endpoint, request) {
+        if (!(endpoint in this.operations))
+            // `assert.fail`, not `assert.ok`: the message is built only when it is needed
+            assert.fail(`Endpoint '${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 task = async () => this.#process(endpoint, request);
+        if (remote === null)
+            return task();
+        else
+            return run(remote, task);
+    }
+    async #process(endpoint, request) {
+        return console.span(this.#span(endpoint), async () => {
+            const reply = await this.operations[endpoint].invoke(request);
+            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,47 @@
+/** Abstract connections hierarchy */
+export declare class Connector {
+    #private;
+    readonly id: string;
+    connected: 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;
+}

package/transpiled/connector.js

@@ -0,0 +1,143 @@
+import { console } from 'openspan';
+/** Abstract connections hierarchy */
+export class Connector {
+    #dependencies = [];
+    #links = [];
+    #connecting;
+    #disconnecting;
+    id;
+    connected = false;
+    constructor() {
+        this.id = this.constructor.name + '#' + Math.random().toString(36).substring(2, 8);
+    }
+    /**
+     * Creates a dependency and backlink with another Connector or a set of Connectors
+     *
+     * See .connect() and .disconnect()
+     *
+     */
+    depends(connector) {
+        let next;
+        if (connector instanceof Array) {
+            if (connector.length === 0)
+                throw new Error('Connectors array must not be empty');
+            if (connector.length > 1) {
+                next = new Connector();
+                for (const item of connector) {
+                    this.#dependencies.push(item);
+                    item.depends(next);
+                }
+            }
+            else
+                next = connector[0];
+        }
+        else
+            next = connector;
+        this.#dependencies.push(next);
+        next.link(this);
+        return next;
+    }
+    /**
+     * Creates a backlink to another Connector
+     *
+     * See .connect() and .disconnect()
+     *
+     */
+    link(connector) {
+        this.#links.push(connector);
+    }
+    /**
+     * Connects dependants then self
+     *
+     * In case of exception disconnects with current connection interruption
+     *
+     * Method is idempotent
+     *
+     */
+    async connect() {
+        if (this.#connecting)
+            return this.#connecting;
+        this.#disconnecting = undefined;
+        const work = async () => {
+            await Promise.all(this.#dependencies.map((connector) => connector.connect()));
+            await this.open();
+        };
+        // anonymous grouping nodes are not worth a span
+        this.#connecting =
+            TRACE_BOOT && this.constructor.name !== 'Connector'
+                ? console.span({
+                    name: `connect ${this.constructor.name}`,
+                    // a connector that has a locator is named by it; a grouping node has none
+                    attributes: { id: this.locator?.id ?? this.id }
+                }, work)
+                : work();
+        try {
+            await this.#connecting;
+            this.connected = true;
+        }
+        catch (e) {
+            await this.disconnect(true);
+            throw e;
+        }
+    }
+    /**
+     * Disconnects self then dependants
+     *
+     * Does nothing if there are connected linked Connectors
+     *
+     * Method is idempotent
+     *
+     */
+    async disconnect(interrupt) {
+        // a connector that has not finished connecting has nothing to close, and
+        // awaiting a connection that may never settle outlives any grace period
+        const pending = interrupt === true || this.connected === false;
+        if (!pending)
+            await this.#connecting;
+        if (this.#disconnecting)
+            return this.#disconnecting;
+        const linked = this.#links.reduce((acc, parent) => acc || parent.connected, false);
+        if (linked && interrupt !== true)
+            return;
+        this.#disconnecting = (async () => {
+            const start = +new Date();
+            const interval = setInterval(() => {
+                const delay = +new Date() - start;
+                if (delay > DELAY)
+                    console.warn(`Connector ${this.id} still disconnecting (${delay})`);
+            }, DELAY);
+            if (!pending)
+                await this.close();
+            // said once the closing is done rather than when it starts: a dependant that is
+            // still closing is still using what it depends on, and the check above reads this
+            // of every dependant. Saying it early lets the first to start tear down a shared
+            // dependency under the others.
+            this.connected = false;
+            this.#connecting = undefined;
+            clearInterval(interval);
+            await Promise.all(this.#dependencies.map((connector) => connector.disconnect()));
+            await this.dispose();
+        })();
+        await this.#disconnecting;
+    }
+    async reconnect() {
+        await this.disconnect();
+        await this.connect();
+    }
+    debug(node = {}) {
+        node[this.id] = { connected: this.connected };
+        if (this.#dependencies.length > 0)
+            for (const connector of this.#dependencies)
+                connector.debug?.(node[this.id]);
+        return node;
+    }
+    /** Called on connection */
+    open() { }
+    /** Called on disconnection */
+    close() { }
+    /** Called after self and dependants disconnection is complete */
+    dispose() { }
+}
+const DELAY = 5000;
+const TRACE_BOOT = process.env.TOA_BOOT_TRACE === '1';
+//# sourceMappingURL=connector.js.map

package/transpiled/connector.js.map

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

package/transpiled/context.d.ts

@@ -0,0 +1,18 @@
+import { Connector } from './connector.js';
+import type { Locator } from './locator.js';
+import type { Component } from './component.js';
+import type { Remote } from './remote.js';
+import type { Aspect } from './types/extensions.js';
+import type { Request } from './types/request.js';
+type Discover = (namespace: string, name: string) => Promise<Remote>;
+export declare class Context extends Connector {
+    #private;
+    readonly env: string | undefined;
+    readonly name: string | undefined;
+    readonly aspects: Aspect[];
+    readonly locator: Locator;
+    constructor(local: Component, discover: Discover, aspects?: Aspect[]);
+    apply(endpoint: string, request: Request): Promise<any>;
+    call(namespace: string, name: string, endpoint: string, request: Request): Promise<any>;
+}
+export {};

package/transpiled/context.js

@@ -0,0 +1,41 @@
+import { Connector } from './connector.js';
+export class Context extends Connector {
+    env;
+    name;
+    aspects;
+    locator;
+    #local;
+    #discover;
+    #remotes = {};
+    constructor(local, discover, aspects = []) {
+        super();
+        this.env = process.env.TOA_ENV;
+        this.name = process.env.TOA_CONTEXT;
+        this.aspects = aspects;
+        this.locator = local?.locator;
+        this.#local = local;
+        this.#discover = discover;
+        this.depends(local);
+        if (aspects.length > 0)
+            this.depends(aspects);
+    }
+    async apply(endpoint, request) {
+        return this.#local.invoke(endpoint, request);
+    }
+    // eslint-disable-next-line max-params
+    async call(namespace, name, endpoint, request) {
+        const remote = await this.#remote(namespace, name);
+        return remote.invoke(endpoint, request);
+    }
+    async #remote(namespace, name) {
+        const key = namespace + '.' + name;
+        this.#remotes[key] ??= this.#connect(namespace, name);
+        return this.#remotes[key];
+    }
+    async #connect(namespace, name) {
+        const remote = await this.#discover(namespace, name);
+        this.depends(remote);
+        return remote;
+    }
+}
+//# sourceMappingURL=context.js.map

package/transpiled/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../source/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAS1C,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpB,GAAG,CAAoB;IACvB,IAAI,CAAoB;IACxB,OAAO,CAAU;IACjB,OAAO,CAAS;IAEvB,MAAM,CAAW;IACjB,SAAS,CAAU;IACnB,QAAQ,GAAoC,EAAE,CAAA;IAEvD,YAAmB,KAAgB,EAAE,QAAkB,EAAE,OAAO,GAAa,EAAE;QAC7E,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,OAAO,CAAA;QAE7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QAEzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAEnB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAgB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,sCAAsC;IAC/B,KAAK,CAAC,IAAI,CACf,SAAiB,EACjB,IAAY,EACZ,QAAgB,EAChB,OAAgB;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAElD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,IAAY;QAC3C,MAAM,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAA;QAElC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAErD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAAY;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAEpD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/contract/contract.d.ts

@@ -0,0 +1,10 @@
+import type { Schema, SchemaError } from '@toa.io/schemas';
+import type { Exception } from '../exceptions.js';
+/** What a contract throws with, stated by the subclass. */
+export type Refusal = new (error: SchemaError, cause?: unknown) => Exception;
+export declare class Contract {
+    readonly schema: Schema;
+    static Exception: Refusal;
+    constructor(schema: Schema);
+    fit(value: unknown): void;
+}

package/transpiled/contract/contract.js

@@ -0,0 +1,14 @@
+import { SystemException } from '../exceptions.js';
+export class Contract {
+    schema;
+    static Exception = SystemException;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    fit(value) {
+        const error = this.schema.fit(value);
+        if (error !== null)
+            throw new this.constructor.Exception(error, value);
+    }
+}
+//# sourceMappingURL=contract.js.map

package/transpiled/contract/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../source/contract/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOlD,MAAM,OAAO,QAAQ;IACH,MAAM,CAAQ;IAEvB,MAAM,CAAC,SAAS,GAAY,eAAqC,CAAA;IAExE,YAAmB,MAAc;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEM,GAAG,CAAC,KAAc;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAEpC,IAAI,KAAK,KAAK,IAAI;YAChB,MAAM,IAAK,IAAI,CAAC,WAA+B,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC;CACF"}

package/transpiled/contract/index.d.ts

@@ -0,0 +1,2 @@
+export { Request } from './request.js';
+export { Reply } from './reply.js';

package/transpiled/contract/index.js

@@ -0,0 +1,3 @@
+export { Request } from './request.js';
+export { Reply } from './reply.js';
+//# sourceMappingURL=index.js.map

package/transpiled/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/transpiled/contract/reply.d.ts

@@ -0,0 +1,7 @@
+import { Contract } from './contract.js';
+import type { Refusal } from './contract.js';
+import type { JSONSchema } from './schemas.js';
+export declare class Reply extends Contract {
+    static Exception: Refusal;
+    static schema(output?: JSONSchema, errors?: Array<string | number>): JSONSchema;
+}

package/transpiled/contract/reply.js

@@ -0,0 +1,48 @@
+import { Contract } from './contract.js';
+import { ResponseContractException } from '../exceptions.js';
+export class Reply extends Contract {
+    static Exception = ResponseContractException;
+    static schema(output, errors) {
+        const schema = {
+            type: 'object',
+            properties: {},
+            additionalProperties: false
+        };
+        if (output !== undefined) {
+            /*
+             * A reply carries more than the operation declares — `VERSION` and the rest of the
+             * record's own fields — so what it is validated against is the declaration relaxed.
+             * On a copy: the declaration itself is what a component publishes when asked to
+             * explain, and relaxing that would publish a contract nobody wrote.
+             */
+            output = structuredClone(output);
+            if (output.type === 'object')
+                output.additionalProperties = true;
+            else if (output.type === 'array' && output.items?.type === 'object')
+                output.items.additionalProperties = true;
+            schema.properties.output = output;
+        }
+        /*
+         * An error a caller is meant to handle is one the operation states. Where none are
+         * stated, an error is not a reply this operation makes — it is a mistake, and the
+         * contract says so rather than passing an undeclared code on to whoever called.
+         */
+        schema.properties.error =
+            errors === undefined
+                ? false
+                : {
+                    type: 'object',
+                    properties: {
+                        code: {
+                            enum: errors
+                        },
+                        message: {
+                            type: 'string'
+                        }
+                    },
+                    required: ['code']
+                };
+        return schema;
+    }
+}
+//# sourceMappingURL=reply.js.map

package/transpiled/contract/reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.js","sourceRoot":"","sources":["../../source/contract/reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAI5D,MAAM,OAAO,KAAM,SAAQ,QAAQ;IAC1B,MAAM,CAAU,SAAS,GAC9B,yBAA+C,CAAA;IAE1C,MAAM,CAAC,MAAM,CAAC,MAAmB,EAAE,MAA+B;QACvE,MAAM,MAAM,GAAe;YACzB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,oBAAoB,EAAE,KAAK;SAC5B,CAAA;QAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB;;;;;eAKG;YACH,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;YAEhC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,CAAC,oBAAoB,GAAG,IAAI,CAAA;iBAC3D,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ;gBACjE,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAA;YAE1C,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAA;QACnC,CAAC;QAED;;;;WAIG;QACH,MAAM,CAAC,UAAU,CAAC,KAAK;YACrB,MAAM,KAAK,SAAS;gBAClB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC;oBACE,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,MAAM;yBACb;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;yBACf;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB,CAAA;QAEP,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/contract/request.d.ts

@@ -0,0 +1,24 @@
+import { Contract } from './contract.js';
+import type { Schema } from '@toa.io/schemas';
+import type { Refusal } from './contract.js';
+import type { JSONSchema } from './schemas.js';
+/** What an operation states about itself, and answers when asked to explain. */
+export interface Explanation {
+    description?: string;
+    input?: JSONSchema | null;
+    output?: JSONSchema | null;
+    errors?: Array<string | number>;
+}
+export interface Definition extends Explanation {
+    type?: string;
+    scope?: string;
+    query?: boolean;
+}
+export declare class Request extends Contract {
+    readonly discovery: Explanation;
+    static Exception: Refusal;
+    constructor(schema: Schema, definition: Definition);
+    static schema(definition: Definition, entity?: {
+        properties: Record<string, JSONSchema>;
+    }): JSONSchema;
+}

package/transpiled/contract/request.js

@@ -0,0 +1,59 @@
+import * as schemas from './schemas.js';
+import { RequestContractException } from '../exceptions.js';
+import { Contract } from './contract.js';
+export class Request extends Contract {
+    discovery = {};
+    static Exception = RequestContractException;
+    constructor(schema, definition) {
+        super(schema);
+        for (const key of ['description', 'input', 'output', 'errors'])
+            if (definition[key] !== undefined)
+                this.discovery[key] = definition[key];
+    }
+    static schema(definition, entity) {
+        // `source` is not among these: the framework stamps it and whoever reads it takes the keys
+        // it knows, so holding it to a schema would only fail calls from a peer that stamps one more
+        const schema = {
+            type: 'object',
+            properties: {
+                authentic: { type: 'boolean' },
+                task: { type: 'boolean' }
+            },
+            additionalProperties: true
+        };
+        const required = [];
+        if (definition.input !== undefined) {
+            schema.properties.input = definition.input;
+            required.push('input');
+        }
+        else
+            schema.properties.input = { type: 'null' };
+        if (entity === undefined)
+            definition.query = false;
+        if (definition.query === true)
+            required.push('query');
+        if (definition.query === false)
+            schema.properties.query = { type: 'null' };
+        if (definition.query !== false) {
+            const query = structuredClone(schemas.query);
+            query.properties.id = entity?.properties.id;
+            if (definition.type === 'observation')
+                delete query.properties.version;
+            else
+                delete query.properties.projection;
+            if (definition.type !== 'observation' || definition.scope !== 'objects') {
+                delete query.properties.omit;
+                delete query.properties.limit;
+            }
+            else if (query.required === undefined)
+                query.required = ['limit'];
+            else
+                query.required.push('limit');
+            schema.properties.query = query;
+        }
+        if (required.length > 0)
+            schema.required = required;
+        return schema;
+    }
+}
+//# sourceMappingURL=request.js.map

package/transpiled/contract/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../source/contract/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAmBxC,MAAM,OAAO,OAAQ,SAAQ,QAAQ;IACnB,SAAS,GAAgB,EAAE,CAAA;IAEpC,MAAM,CAAU,SAAS,GAC9B,wBAA8C,CAAA;IAEhD,YAAmB,MAAc,EAAE,UAAsB;QACvD,KAAK,CAAC,MAAM,CAAC,CAAA;QAEb,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAU;YACrE,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS;gBAC9B,IAAI,CAAC,SAAqC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IACxE,CAAC;IAEM,MAAM,CAAC,MAAM,CAClB,UAAsB,EACtB,MAAmD;QAEnD,2FAA2F;QAC3F,6FAA6F;QAC7F,MAAM,MAAM,GAAe;YACzB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC1B;YACD,oBAAoB,EAAE,IAAI;SAC3B,CAAA;QAED,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;YAC1C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;;YAAM,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QAEjD,IAAI,MAAM,KAAK,SAAS;YAAE,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;QAElD,IAAI,UAAU,CAAC,KAAK,KAAK,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAErD,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK;YAAE,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QAE1E,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAE5C,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,CAAC,EAAE,CAAA;YAE3C,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,CAAA;;gBACjE,OAAO,KAAK,CAAC,UAAU,CAAC,UAAU,CAAA;YAEvC,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxE,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAA;gBAC5B,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAA;YAC/B,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,CAAA;;gBAC9D,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAEjC,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;QACjC,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAEnD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/contract/schemas.d.ts

@@ -0,0 +1,4 @@
+/** A JSON Schema, loose because it is handed to a validator and edited by the contracts. */
+export type JSONSchema = Record<string, any>;
+export declare const query: JSONSchema;
+export declare const error: JSONSchema;

package/transpiled/contract/schemas.js

@@ -0,0 +1,36 @@
+export const query = {
+    type: 'object',
+    properties: {
+        id: { type: 'string' },
+        ids: { type: 'array', uniqueItems: true, minItems: 1, items: { type: 'string' } },
+        version: { type: 'integer', minimum: 0 },
+        criteria: { type: 'string' },
+        search: { type: 'string' },
+        sample: { type: 'number' },
+        omit: { type: 'integer', minimum: 0 },
+        limit: { type: 'integer', minimum: 0 },
+        sort: {
+            type: 'array',
+            uniqueItems: true,
+            minItems: 1,
+            items: { type: 'string', pattern: '^\\w{1,32}(?::(?:asc|desc))?$' }
+        },
+        projection: {
+            type: 'array',
+            uniqueItems: true,
+            minItems: 1,
+            items: { type: 'string', not: { const: 'id' } }
+        },
+        deleted: { type: 'boolean' }
+    },
+    additionalProperties: false
+};
+export const error = {
+    type: 'object',
+    properties: {
+        code: { anyOf: [{ type: 'integer' }, { type: 'string' }] },
+        message: { type: 'string' }
+    },
+    required: ['code']
+};
+//# sourceMappingURL=schemas.js.map

package/transpiled/contract/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/contract/schemas.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACjF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACrC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACtC,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,+BAA+B,EAAE;SACpE;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;SAChD;QACD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC7B;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC1D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5B;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;CACnB,CAAA"}

package/transpiled/discovery.d.ts

@@ -0,0 +1,12 @@
+import { Connector } from './connector.js';
+import type { Locator } from './locator.js';
+interface Lookup extends Connector {
+    invoke: () => Promise<any>;
+}
+export declare class Discovery extends Connector {
+    #private;
+    constructor(lookup: (locator: Locator) => Promise<Lookup>);
+    protected open(): Promise<void>;
+    lookup(locator: Locator): Promise<any>;
+}
+export {};