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

package/transpiled/connector.js

@@ -0,0 +1,193 @@
+import { console } from 'openspan';
+import { environment } from '@toa.io/generic';
+/** Abstract connections hierarchy */
+export class Connector {
+    #dependencies = [];
+    #links = [];
+    #connecting;
+    #disconnecting;
+    #discarded = false;
+    id;
+    connected = false;
+    /**
+     * 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 = 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);
+        // See .#discard()
+        if (this.#disconnecting !== undefined)
+            next.#discard();
+        return next;
+    }
+    /**
+     * Disconnects, now and again if a connection is still to land.
+     *
+     * A dependency taken on after its dependant was disconnected — a lookup that returns
+     * once the teardown walk has gone by — is one nothing is left to take down, as the
+     * walk that would have reached it is over. One that stays connected holds open
+     * everything it depends on with it: a dependency reads `connected` of every dependant
+     * before it closes, and a dependant that is connected for good is a dependency that
+     * never closes.
+     */
+    #discard() {
+        this.#discarded = true;
+        // one that is up already, or on its way, is taken down here; one that is not is
+        // taken down by the connection when it comes, and until then there is nothing to do
+        if (this.#connecting !== undefined)
+            void this.#drop();
+    }
+    /**
+     * 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
+        const 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();
+        this.#connecting = connecting;
+        try {
+            await connecting;
+            /*
+             * A disconnection that did not wait for this connection emptied `#connecting` to
+             * say so. Reporting `connected` now would report it of a connector nothing takes
+             * down again — its `#disconnecting` has settled, so a later call returns at once —
+             * and what it depends on reads that of every dependant before it closes.
+             */
+            if (this.#connecting === connecting)
+                this.connected = true;
+        }
+        catch (e) {
+            await this.disconnect(true);
+            throw e;
+        }
+        // a connection asked for before this one was discarded, landing after. See .#discard()
+        if (this.#discarded)
+            await this.#drop();
+    }
+    /** Disconnects a discarded connector, saying so rather than throwing at whoever is not waiting. */
+    async #drop() {
+        this.#discarded = false;
+        try {
+            await this.disconnect();
+        }
+        catch (error) {
+            console.error('Discarded connector failed to disconnect', { id: this.id, error });
+        }
+    }
+    /**
+     * 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();
+            this.disposed = true;
+        })();
+        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 = environment.get('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,25 @@
+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 { Options, 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;
+    /**
+     * The rank of the region this deployment is, which is what its writes are stamped with. A
+     * deployment that is no region at all reads as zero, which is what its records carry.
+     */
+    readonly region: number;
+    readonly aspects: Aspect[];
+    readonly locator: Locator;
+    /** The name this process answers addressed calls under. */
+    readonly instance: string;
+    constructor(local: Component, discover: Discover, aspects?: Aspect[]);
+    apply(endpoint: string, request: Request, options?: Options): Promise<any>;
+    call(namespace: string, name: string, endpoint: string, request: Request, options?: Options): Promise<any>;
+}
+export {};

package/transpiled/context.js

@@ -0,0 +1,55 @@
+import { Connector } from './connector.js';
+import { waiting } from './abandon.js';
+import { instance } from './instance.js';
+import { environment } from '@toa.io/generic';
+export class Context extends Connector {
+    env;
+    name;
+    /**
+     * The rank of the region this deployment is, which is what its writes are stamped with. A
+     * deployment that is no region at all reads as zero, which is what its records carry.
+     */
+    region;
+    aspects;
+    locator;
+    /** The name this process answers addressed calls under. */
+    instance;
+    #local;
+    #discover;
+    #remotes = {};
+    constructor(local, discover, aspects = []) {
+        super();
+        this.env = environment.get('TOA_ENV');
+        this.name = environment.get('TOA_CONTEXT');
+        this.region = Number(environment.get('TOA_REGION') ?? 0);
+        this.aspects = aspects;
+        this.locator = local?.locator;
+        this.instance = instance();
+        this.#local = local;
+        this.#discover = discover;
+        this.depends(local);
+        if (aspects.length > 0)
+            this.depends(aspects);
+    }
+    async apply(endpoint, request, options) {
+        return this.#local.invoke(endpoint, request, options);
+    }
+    // eslint-disable-next-line max-params
+    async call(namespace, name, endpoint, request, options) {
+        // the lookup is waited for as the call is: a caller that stops waiting is answered at once, and
+        // the lookup finishes for the next call to use
+        const remote = await waiting(this.#remote(namespace, name), options?.signal, `${namespace}.${name}.${endpoint}`);
+        return remote.invoke(endpoint, request, options);
+    }
+    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;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAS7C,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpB,GAAG,CAAoB;IACvB,IAAI,CAAoB;IAExC;;;OAGG;IACa,MAAM,CAAQ;IAEd,OAAO,CAAU;IACjB,OAAO,CAAS;IAEhC,2DAA2D;IAC3C,QAAQ,CAAQ;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,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QACxD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,OAAO,CAAA;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAA;QAE1B,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,EAAE,OAAiB;QACtE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAED,sCAAsC;IAC/B,KAAK,CAAC,IAAI,CACf,SAAiB,EACjB,IAAY,EACZ,QAAgB,EAChB,OAAgB,EAChB,OAAiB;QAEjB,gGAAgG;QAChG,+CAA+C;QAC/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,GAAG,SAAS,IAAI,IAAI,IAAI,QAAQ,EAAE,CACnC,CAAA;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAClD,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,39 @@
+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;
+    /**
+     * Whether the same call arriving twice changes state once. Said, because a caller cannot tell
+     * it from an answer that says nothing, and what it changes is whether a retry is safe to make.
+     */
+    once?: boolean;
+    /**
+     * Whether a call to it names the process it goes to. Said, because the caller is the one who
+     * has to name one, and a call that names none is refused.
+     */
+    stateful?: boolean;
+    input?: JSONSchema | null;
+    output?: JSONSchema | null;
+    errors?: Array<string | number>;
+}
+export interface Definition extends Explanation {
+    type?: string;
+    scope?: string;
+    query?: boolean;
+}
+/** What the operation works on, as the manifest declares it. */
+export interface Entity {
+    properties: Record<string, JSONSchema>;
+    required?: string[];
+}
+export declare class Request extends Contract {
+    readonly discovery: Explanation;
+    static Exception: Refusal;
+    constructor(schema: Schema, definition: Definition, entity?: Entity);
+    static schema(definition: Definition, entity?: {
+        properties: Record<string, JSONSchema>;
+    }): JSONSchema;
+}

package/transpiled/contract/request.js

@@ -0,0 +1,111 @@
+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, entity) {
+        super(schema);
+        for (const key of ['description', 'once', 'stateful', 'input', 'output', 'errors'])
+            if (definition[key] !== undefined)
+                this.discovery[key] = definition[key];
+        /*
+         * An operation that states no output states an empty schema, which every reply fits —
+         * and which says nothing to whoever reads it. What its type answers does, so that is
+         * said here instead. Here and not in the definition, because the definition is what a
+         * reply is held to: a projection is a lawful answer, and describing one is not the same
+         * as requiring it.
+         */
+        if (empty(this.discovery.output)) {
+            const answered = answers(definition, entity);
+            if (answered !== undefined)
+                this.discovery.output = answered;
+        }
+    }
+    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: {
+                /*
+                 * Listed, and not required. `additionalProperties` already admits it, and a callee skips
+                 * this contract altogether for an `authentic` request — which every request from a `Call`
+                 * is — so requiring it would refuse nothing on the side where a missing identity matters,
+                 * and would refuse every request built by hand on the side where it never is. An
+                 * operation that declares `once` raises on a request without one instead.
+                 */
+                id: { type: 'string' },
+                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;
+    }
+}
+/**
+ * What an operation of this type answers, where it did not say.
+ *
+ * A transition, an observation and an assignment work on the Entity Object, so that is what
+ * they answer — a set of them where the scope is a set. A computation neither uses the scope
+ * nor produces one, and an effect answers whatever it computed, so neither is guessed at.
+ * A stream is not a value with a schema, and is not one either.
+ *
+ * What the entity requires is said as well. It is a description and nothing is held to it —
+ * an operation answering a projection says so by declaring its own output — and a shape
+ * whose every property reads as optional says less than it knows.
+ */
+function answers(definition, entity) {
+    if (entity === undefined || !ENTITY.has(definition.type))
+        return undefined;
+    const object = {
+        type: 'object',
+        properties: entity.properties,
+        ...(entity.required === undefined ? {} : { required: entity.required })
+    };
+    if (definition.scope === 'objects')
+        return { type: 'array', items: object };
+    return definition.scope === 'object' || definition.scope === 'changeset'
+        ? object
+        : undefined;
+}
+/** The types whose subject is the Entity Object; see `documentation/design.md`. */
+const ENTITY = new Set(['transition', 'observation', 'assignment']);
+/** A schema that states nothing, which is what an operation saying nothing normalizes to. */
+function empty(schema) {
+    return schema === undefined || schema === null || Object.keys(schema).length === 0;
+}
+//# 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":"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"}

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,19 @@
+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>;
+    /**
+     * A lookup is unbounded, so one in flight when this goes away never settles and would go on
+     * saying it is waiting for the life of the process. Which nothing noticed while a
+     * disconnected discovery meant a process on its way out — a halt takes one down and builds
+     * another, and every cycle would leave a voice behind.
+     */
+    protected close(): Promise<void>;
+    lookup(locator: Locator): Promise<any>;
+}
+export {};