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

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 {};

package/transpiled/discovery.js

@@ -0,0 +1,34 @@
+import { console } from 'openspan';
+import { Connector } from './connector.js';
+export class Discovery extends Connector {
+    #lookup;
+    #lookups = {};
+    constructor(lookup) {
+        super();
+        this.#lookup = lookup;
+    }
+    async open() {
+        this.#lookups = {};
+    }
+    async lookup(locator) {
+        const id = locator.id;
+        if (this.#lookups[id] === undefined) {
+            const lookup = await this.#lookup(locator);
+            this.#lookups[id] = Promise.resolve(lookup);
+            this.depends(lookup);
+        }
+        const since = Date.now();
+        // the wait is unbounded by design, as a dependency may still be starting,
+        // so repeating is the only way a component stuck on one stays visible
+        const warning = setInterval(() => {
+            const waiting = Math.round((Date.now() - since) / 1000);
+            console.warn('Waiting for lookup response', { component: id, waiting });
+        }, INTERVAL);
+        warning.unref();
+        const output = await (await this.#lookups[id]).invoke();
+        clearInterval(warning);
+        return output;
+    }
+}
+const INTERVAL = 5000;
+//# sourceMappingURL=discovery.js.map

package/transpiled/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../source/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAO1C,MAAM,OAAO,SAAU,SAAQ,SAAS;IAC7B,OAAO,CAAuC;IACvD,QAAQ,GAAoC,EAAE,CAAA;IAE9C,YAAmB,MAA6C;QAC9D,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,OAAgB;QAClC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;QAErB,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAExB,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;YAEvD,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;QACzE,CAAC,EAAE,QAAQ,CAAC,CAAA;QAEZ,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;QAEvD,aAAa,CAAC,OAAO,CAAC,CAAA;QAEtB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,IAAI,CAAA"}

package/transpiled/effect.d.ts

@@ -0,0 +1,5 @@
+import { Observation } from './observation.js';
+import type { Store } from './operation.js';
+export declare class Effect extends Observation {
+    protected acquire(store: Store): Promise<void>;
+}

package/transpiled/effect.js

@@ -0,0 +1,11 @@
+import { Observation } from './observation.js';
+export class Effect extends Observation {
+    async acquire(store) {
+        const { query, entity, input } = store.request;
+        if (entity === undefined)
+            return super.acquire(store);
+        store.scope = await this.scope.ensure(query, entity, input);
+        store.state = store.scope.get();
+    }
+}
+//# sourceMappingURL=effect.js.map

package/transpiled/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","sourceRoot":"","sources":["../source/effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAI9C,MAAM,OAAO,MAAO,SAAQ,WAAW;IAClB,KAAK,CAAC,OAAO,CAAC,KAAY;QAC3C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,OAAO,CAAA;QAE9C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAErD,KAAK,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAClE,KAAK,CAAC,KAAK,GAAI,KAAK,CAAC,KAAgB,CAAC,GAAG,EAAE,CAAA;IAC7C,CAAC;CACF"}

package/transpiled/emission.d.ts

@@ -0,0 +1,8 @@
+import { Connector } from './connector.js';
+import type { Event } from './event.js';
+import type { Event as StateEvent } from './types/state.js';
+export declare class Emission extends Connector {
+    #private;
+    constructor(events: Event[]);
+    emit(event: StateEvent): Promise<void>;
+}

package/transpiled/emission.js

@@ -0,0 +1,14 @@
+import { Connector } from './connector.js';
+export class Emission extends Connector {
+    #events;
+    constructor(events) {
+        super();
+        this.#events = events;
+        this.depends(events);
+    }
+    async emit(event) {
+        const emission = this.#events.map((e) => e.emit(event));
+        await Promise.all(emission);
+    }
+}
+//# sourceMappingURL=emission.js.map

package/transpiled/emission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emission.js","sourceRoot":"","sources":["../source/emission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI1C,MAAM,OAAO,QAAS,SAAQ,SAAS;IAC5B,OAAO,CAAS;IAEzB,YAAmB,MAAe;QAChC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QAErB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAiB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAEvD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/transpiled/entities/changeset.d.ts

@@ -0,0 +1,10 @@
+import type { Schema } from '@toa.io/schemas';
+import type { Query, Record } from '../types/storages.js';
+export declare class Changeset {
+    #private;
+    readonly query: Query;
+    constructor(schema: Schema, query: Query);
+    get(): object;
+    set(value: Record): void;
+    export(): object;
+}

package/transpiled/entities/changeset.js

@@ -0,0 +1,27 @@
+import { EntityContractException } from '../exceptions.js';
+export class Changeset {
+    query;
+    /** the changeset schema: the entity's properties, none of them required */
+    #schema;
+    #state;
+    constructor(schema, query) {
+        this.query = query;
+        this.#schema = schema;
+        this.#state = {};
+    }
+    get() {
+        return this.#state;
+    }
+    set(value) {
+        const error = this.#schema.fit(value);
+        if (error !== null)
+            throw new EntityContractException(error, value);
+        delete value.VERSION;
+        value.UPDATED = Date.now();
+        this.#state = value;
+    }
+    export() {
+        return this.#state;
+    }
+}
+//# sourceMappingURL=changeset.js.map

package/transpiled/entities/changeset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeset.js","sourceRoot":"","sources":["../../source/entities/changeset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAI1D,MAAM,OAAO,SAAS;IACJ,KAAK,CAAO;IAE5B,2EAA2E;IAClE,OAAO,CAAQ;IACxB,MAAM,CAAiB;IAEvB,YAAmB,MAAc,EAAE,KAAY;QAC7C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAElB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;IAClB,CAAC;IAEM,GAAG;QACR,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAEM,GAAG,CAAC,KAAa;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAErC,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,IAAI,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QAEnE,OAAQ,KAAyB,CAAC,OAAO,CAAA;QACzC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF"}

package/transpiled/entities/entity.d.ts

@@ -0,0 +1,19 @@
+import type { Schema } from '@toa.io/schemas';
+import type { Guard } from '../guard.js';
+import type { Record } from '../types/storages.js';
+import type { Event } from '../types/state.js';
+export declare class Entity {
+    #private;
+    deleted: boolean;
+    /**
+     * A record makes an entity of what a storage holds; a string, or nothing at all, makes a
+     * blank one under that identity, out of what the component declared a record starts as.
+     *
+     * @param blank what the component declares a record holds before anything is written to it
+     * @param mutable whether the entity may be modified and committed
+     */
+    constructor(schema: Schema, blank: object, argument?: Record | string, guards?: Guard[], mutable?: boolean);
+    get(): Record;
+    set(value: Record): void;
+    event(input?: object): Event;
+}