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

package/transpiled/exceptions.d.ts

@@ -0,0 +1,89 @@
+import type { SchemaError } from '@toa.io/schemas';
+export declare const codes: {
+    System: number;
+    Contract: number;
+    RequestSyntax: number;
+    RequestContract: number;
+    RequestConflict: number;
+    ResponseContract: number;
+    EntityContract: number;
+    EntityGuard: number;
+    QuerySyntax: number;
+    State: number;
+    StateNotFound: number;
+    StatePrecondition: number;
+    StateConcurrency: number;
+    StateInitialization: number;
+    Duplicate: number;
+    /** this call has been made, and what it changed is changed */
+    DuplicateCall: number;
+    Communication: number;
+    Transmission: number;
+    Endpoint: number;
+    /** nothing held the name an addressed call named */
+    Addressee: number;
+    /** the caller stopped waiting, and what it called may still run */
+    Abandoned: number;
+    /** a chain that came back to where it had been, or went further than a chain goes */
+    Loop: number;
+};
+export declare class Exception {
+    readonly code: number;
+    readonly message: string;
+    cause?: unknown;
+    /** what a contract exception copies off the schema error it refused with */
+    [key: string]: unknown;
+    constructor(code: number, message: string, cause?: unknown);
+}
+export declare class SystemException extends Exception {
+    readonly stack?: string;
+    constructor(error: Error | string);
+}
+/**
+ * A call refused for where it has been rather than for what it says. Named, and so permanent:
+ * the chain is deterministic, and another attempt reproduces it hop for hop.
+ */
+export declare class LoopException extends Exception {
+    /** the whole chain, so what is set aside can be read without guessing */
+    readonly trail: string[];
+    constructor(message: string, trail: string[]);
+}
+export declare class ContractException extends Exception {
+    constructor(code: number | undefined, error: SchemaError | string | null, cause?: unknown);
+}
+export declare class RequestContractException extends ContractException {
+    constructor(error: SchemaError | string, cause?: unknown);
+}
+export declare class ResponseContractException extends ContractException {
+    constructor(error: SchemaError | string, cause?: unknown);
+}
+export declare class EntityContractException extends ContractException {
+    constructor(error: SchemaError | string, cause?: unknown);
+}
+export declare class EntityGuardException extends ContractException {
+    constructor(name: string, cause?: unknown);
+}
+type Derived = new (message?: string, cause?: unknown) => Exception;
+export declare const RequestSyntaxException: Derived;
+export declare const RequestConflictException: Derived;
+export declare const QuerySyntaxException: Derived;
+export declare const StateException: Derived;
+export declare const StateNotFoundException: Derived;
+export declare const StatePreconditionException: Derived;
+export declare const StateConcurrencyException: Derived;
+export declare const StateInitializationException: Derived;
+export declare const DuplicateException: Derived;
+export declare const DuplicateCallException: Derived;
+export declare const CommunicationException: Derived;
+export declare const TransmissionException: Derived;
+export declare const EndpointException: Derived;
+export declare const AddresseeException: Derived;
+export declare const AbandonedException: Derived;
+export declare const names: Record<string, string>;
+/**
+ * Takes `unknown` because a caller has caught something rather than been handed an `Exception`.
+ * Anything core did not raise — an error from a driver, a rejection with no code at all — is not
+ * on the list, and is therefore worth trying again.
+ */
+export declare function permanent(exception: unknown): boolean;
+export {};

package/transpiled/exceptions.js

@@ -0,0 +1,180 @@
+import { swap } from '@toa.io/generic';
+export const codes = {
+    System: 0,
+    Contract: 200,
+    RequestSyntax: 201,
+    RequestContract: 202,
+    RequestConflict: 203,
+    ResponseContract: 211,
+    EntityContract: 212,
+    EntityGuard: 213,
+    QuerySyntax: 221,
+    State: 300,
+    StateNotFound: 302,
+    StatePrecondition: 303,
+    StateConcurrency: 304,
+    StateInitialization: 305,
+    Duplicate: 306,
+    /** this call has been made, and what it changed is changed */
+    DuplicateCall: 307,
+    Communication: 400,
+    Transmission: 401,
+    Endpoint: 402,
+    /** nothing held the name an addressed call named */
+    Addressee: 403,
+    /** the caller stopped waiting, and what it called may still run */
+    Abandoned: 404,
+    /** a chain that came back to where it had been, or went further than a chain goes */
+    Loop: 500
+};
+export class Exception {
+    code;
+    message;
+    cause;
+    constructor(code, message, cause) {
+        this.code = code;
+        this.message = message;
+        if (cause !== undefined)
+            this.cause = cause;
+    }
+}
+export class SystemException extends Exception {
+    stack;
+    constructor(error) {
+        super(codes.System, typeof error === 'string' ? error : error.message);
+        if (typeof error !== 'string' && error.stack !== undefined)
+            this.stack = error.stack;
+    }
+}
+/**
+ * A call refused for where it has been rather than for what it says. Named, and so permanent:
+ * the chain is deterministic, and another attempt reproduces it hop for hop.
+ */
+export class LoopException extends Exception {
+    /** the whole chain, so what is set aside can be read without guessing */
+    trail;
+    constructor(message, trail) {
+        super(codes.Loop, message);
+        this.trail = trail;
+    }
+}
+export class ContractException extends Exception {
+    constructor(code, error, cause) {
+        super(code ?? codes.Contract, typeof error === 'string' ? error : (error?.message ?? ''), cause);
+        if (typeof error === 'object' && error !== null)
+            for (const k of [
+                'keyword',
+                'instancePath',
+                'schemaPath',
+                'params',
+                'propertyName'
+            ])
+                if (k in error)
+                    this[k] = error[k];
+    }
+}
+export class RequestContractException extends ContractException {
+    constructor(error, cause) {
+        super(codes.RequestContract, error, cause);
+    }
+}
+export class ResponseContractException extends ContractException {
+    constructor(error, cause) {
+        super(codes.ResponseContract, error, cause);
+    }
+}
+export class EntityContractException extends ContractException {
+    constructor(error, cause) {
+        super(codes.EntityContract, error, cause);
+    }
+}
+export class EntityGuardException extends ContractException {
+    constructor(name, cause) {
+        super(codes.EntityGuard, name, cause);
+    }
+}
+function derive(name) {
+    const classname = name + 'Exception';
+    const derived = class extends Exception {
+        constructor(message, cause) {
+            super(codes[name], message === undefined ? classname : `${classname}: ${message}`, cause);
+        }
+    };
+    // the name is the class's own, and a class expression has none worth reporting
+    Object.defineProperty(derived, 'name', { value: classname });
+    return derived;
+}
+export const RequestSyntaxException = derive('RequestSyntax');
+export const RequestConflictException = derive('RequestConflict');
+export const QuerySyntaxException = derive('QuerySyntax');
+export const StateException = derive('State');
+export const StateNotFoundException = derive('StateNotFound');
+export const StatePreconditionException = derive('StatePrecondition');
+export const StateConcurrencyException = derive('StateConcurrency');
+export const StateInitializationException = derive('StateInitialization');
+export const DuplicateException = derive('Duplicate');
+export const DuplicateCallException = derive('DuplicateCall');
+export const CommunicationException = derive('Communication');
+export const TransmissionException = derive('Transmission');
+export const EndpointException = derive('Endpoint');
+export const AddresseeException = derive('Addressee');
+export const AbandonedException = derive('Abandoned');
+export const names = swap(codes);
+// #endregion
+/**
+ * Whether a failure means the same thing on a later attempt.
+ *
+ * Every code answers, and the answer is here rather than inferred: `Record<keyof typeof codes>`
+ * refuses to compile until a code added later says which it is. What core names, core raised on
+ * purpose — a contract does not start fitting, a version that has passed does not come back.
+ * `System` is the exception that proves it: it is a code like any other, and what it wraps is
+ * whatever reached core from below, which is the kind that passes.
+ */
+const OUTCOME = {
+    // whatever the algorithm or a connector threw: core neither chose it nor can read it
+    System: 'transient',
+    Contract: 'permanent',
+    RequestSyntax: 'permanent',
+    RequestContract: 'permanent',
+    RequestConflict: 'permanent',
+    ResponseContract: 'permanent',
+    EntityContract: 'permanent',
+    EntityGuard: 'permanent',
+    QuerySyntax: 'permanent',
+    State: 'permanent',
+    // an event about an entity can outrun the one that creates it; nothing promises order
+    StateNotFound: 'transient',
+    // an entity's version only grows, so one that has passed does not start matching
+    StatePrecondition: 'permanent',
+    // the compare-and-swap lost, which is the case a later attempt exists for
+    StateConcurrency: 'transient',
+    StateInitialization: 'permanent',
+    Duplicate: 'permanent',
+    // a call that has been made stays made: another attempt is refused by the same record
+    DuplicateCall: 'permanent',
+    Communication: 'transient',
+    // nothing is listening on that queue yet — a deployment in progress, most of the time
+    Transmission: 'transient',
+    // its sibling, and the other way round: nothing carried the call is a moment,
+    // there is nothing to carry it to is a fact
+    Endpoint: 'permanent',
+    // a process that lost its broker connection claims its name again once it is restored
+    Addressee: 'transient',
+    // what the caller gave up on may have run, and may run yet
+    Abandoned: 'transient',
+    // the chain is deterministic, so another attempt walks it again: a retry is another cycle
+    Loop: 'permanent'
+};
+const PERMANENT = new Set(Object.entries(OUTCOME)
+    .filter(([, outcome]) => outcome === 'permanent')
+    .map(([name]) => codes[name]));
+/**
+ * Takes `unknown` because a caller has caught something rather than been handed an `Exception`.
+ * Anything core did not raise — an error from a driver, a rejection with no code at all — is not
+ * on the list, and is therefore worth trying again.
+ */
+export function permanent(exception) {
+    const code = exception?.code;
+    return code !== undefined && PERMANENT.has(code);
+}
+//# sourceMappingURL=exceptions.js.map

package/transpiled/exceptions.js.map

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

package/transpiled/exposition.d.ts

@@ -0,0 +1,18 @@
+import { Connector } from './connector.js';
+import type { Locator } from './locator.js';
+interface Manifest {
+    namespace: string;
+    name: string;
+    entity?: object;
+    operations?: object;
+    events?: object;
+}
+export declare class Exposition extends Connector {
+    #private;
+    readonly locator: Locator;
+    constructor(locator: Locator, manifest: Manifest);
+    invoke(): Promise<{
+        output: Partial<Manifest>;
+    }>;
+}
+export {};

package/transpiled/exposition.js

@@ -0,0 +1,18 @@
+import { Connector } from './connector.js';
+export class Exposition extends Connector {
+    locator;
+    #exposition;
+    constructor(locator, manifest) {
+        super();
+        this.locator = locator;
+        this.#exposition = expose(manifest);
+    }
+    async invoke() {
+        return { output: this.#exposition };
+    }
+}
+function expose(manifest) {
+    const { namespace, name, entity, operations, events } = manifest;
+    return { namespace, name, entity, operations, events };
+}
+//# sourceMappingURL=exposition.js.map

package/transpiled/exposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposition.js","sourceRoot":"","sources":["../source/exposition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAW1C,MAAM,OAAO,UAAW,SAAQ,SAAS;IACvB,OAAO,CAAS;IAEvB,WAAW,CAAmB;IAEvC,YAAmB,OAAgB,EAAE,QAAkB;QACrD,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACrC,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAAA;IACrC,CAAC;CACF;AAED,SAAS,MAAM,CAAC,QAAkB;IAChC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAA;IAEhE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA;AACxD,CAAC"}

package/transpiled/guard.d.ts

@@ -0,0 +1,7 @@
+import type { Guard as Bridge } from './types/bridges.js';
+export declare class Guard {
+    #private;
+    readonly name: string;
+    constructor(name: string, bridge: Bridge);
+    fit(state: object, origin: object | null): boolean;
+}

package/transpiled/guard.js

@@ -0,0 +1,12 @@
+export class Guard {
+    name;
+    #bridge;
+    constructor(name, bridge) {
+        this.name = name;
+        this.#bridge = bridge;
+    }
+    fit(state, origin) {
+        return this.#bridge.fit(state, origin);
+    }
+}
+//# sourceMappingURL=guard.js.map

package/transpiled/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../source/guard.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,KAAK;IACA,IAAI,CAAQ;IAEnB,OAAO,CAAQ;IAExB,YAAmB,IAAY,EAAE,MAAc;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAEM,GAAG,CAAC,KAAa,EAAE,MAAqB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACxC,CAAC;CACF"}

package/transpiled/index.d.ts

@@ -0,0 +1,37 @@
+export { Assignment } from './assignment.js';
+export { Call } from './call.js';
+export { Cascade } from './cascade.js';
+export { Component } from './component.js';
+export { Composition } from './composition.js';
+export { Connector } from './connector.js';
+export { Context } from './context.js';
+export { Discovery } from './discovery.js';
+export { Effect } from './effect.js';
+export { Emission } from './emission.js';
+export { Event } from './event.js';
+export { Exposition } from './exposition.js';
+export { Locator } from './locator.js';
+export { Observation } from './observation.js';
+export { Outbox } from './outbox.js';
+export { Operation } from './operation.js';
+export { Query } from './query.js';
+export { Receiver } from './receiver.js';
+export { Reflection } from './reflection.js';
+export { Remote } from './remote.js';
+export { State } from './state.js';
+export { Transition } from './transition.js';
+export { Transmission } from './transmission.js';
+export { Unmanaged } from './unmanaged.js';
+export { Guard } from './guard.js';
+export { instance } from './instance.js';
+export * as entities from './entities/index.js';
+export * as exceptions from './exceptions.js';
+export * as trail from './trail.js';
+export * as contract from './contract/index.js';
+export type { Exception } from './exceptions.js';
+export type { Invocable } from './component.js';
+export type { Explicable } from './remote.js';
+export type { Scoped, Store } from './operation.js';
+export type { Source as ReflectionSource } from './reflection.js';
+export type { Explanation } from './contract/request.js';
+export type { JSONSchema } from './contract/schemas.js';

package/transpiled/index.js

@@ -0,0 +1,31 @@
+export { Assignment } from './assignment.js';
+export { Call } from './call.js';
+export { Cascade } from './cascade.js';
+export { Component } from './component.js';
+export { Composition } from './composition.js';
+export { Connector } from './connector.js';
+export { Context } from './context.js';
+export { Discovery } from './discovery.js';
+export { Effect } from './effect.js';
+export { Emission } from './emission.js';
+export { Event } from './event.js';
+export { Exposition } from './exposition.js';
+export { Locator } from './locator.js';
+export { Observation } from './observation.js';
+export { Outbox } from './outbox.js';
+export { Operation } from './operation.js';
+export { Query } from './query.js';
+export { Receiver } from './receiver.js';
+export { Reflection } from './reflection.js';
+export { Remote } from './remote.js';
+export { State } from './state.js';
+export { Transition } from './transition.js';
+export { Transmission } from './transmission.js';
+export { Unmanaged } from './unmanaged.js';
+export { Guard } from './guard.js';
+export { instance } from './instance.js';
+export * as entities from './entities/index.js';
+export * as exceptions from './exceptions.js';
+export * as trail from './trail.js';
+export * as contract from './contract/index.js';
+//# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA"}

package/transpiled/instance.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The name this process answers addressed calls under, and what a call to one of its stateful
+ * operations names: given by `TOA_INSTANCE`, or generated once.
+ *
+ * It is kept where every copy of this package reads it, because a binding and a component loaded
+ * against two copies must agree on whose name a call carries.
+ */
+export declare function instance(): string;
+/** How long an addressed call waits where it names no timeout of its own, in milliseconds. */
+export declare function timeout(): number;

package/transpiled/instance.js

@@ -0,0 +1,30 @@
+import { environment } from '@toa.io/generic';
+import { newid } from './entities/newid.js';
+const KEY = Symbol.for('toa.core.instance');
+// what a queue name may carry, short enough that one made of it stays within a broker's limit
+const NAME = /^[\w.:-]{1,64}$/;
+const TIMEOUT = 5000;
+/**
+ * The name this process answers addressed calls under, and what a call to one of its stateful
+ * operations names: given by `TOA_INSTANCE`, or generated once.
+ *
+ * It is kept where every copy of this package reads it, because a binding and a component loaded
+ * against two copies must agree on whose name a call carries.
+ */
+export function instance() {
+    return (globalThis[KEY] ??= named());
+}
+/** How long an addressed call waits where it names no timeout of its own, in milliseconds. */
+export function timeout() {
+    const value = Number(environment.get('TOA_ADDRESSED_TIMEOUT'));
+    return Number.isInteger(value) && value > 0 ? value : TIMEOUT;
+}
+function named() {
+    const given = environment.get('TOA_INSTANCE');
+    if (given === undefined)
+        return newid();
+    if (!NAME.test(given))
+        throw new Error(`TOA_INSTANCE '${given}' must be 1 to 64 letters, digits, '_', '-', '.' or ':'`);
+    return given;
+}
+//# sourceMappingURL=instance.js.map

package/transpiled/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../source/instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAE3C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;AAI3C,8FAA8F;AAC9F,MAAM,IAAI,GAAG,iBAAiB,CAAA;AAE9B,MAAM,OAAO,GAAG,IAAI,CAAA;AAEpB;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAE,UAAoB,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,OAAO;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAA;IAE9D,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAA;AAC/D,CAAC;AAED,SAAS,KAAK;IACZ,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAE7C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,EAAE,CAAA;IAEvC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,iBAAiB,KAAK,yDAAyD,CAChF,CAAA;IAEH,OAAO,KAAK,CAAA;AACd,CAAC"}

package/transpiled/locator.d.ts

@@ -0,0 +1,12 @@
+/** Where a component is, as every name derived from it. */
+export declare class Locator {
+    readonly name: string;
+    readonly namespace: string | undefined;
+    readonly id: string;
+    readonly label: string;
+    readonly uppercase: string;
+    readonly lowercase: string;
+    constructor(name: string, namespace?: string);
+    static parse(string: string): Locator;
+    hostname(prefix?: string): string;
+}

package/transpiled/locator.js

@@ -0,0 +1,32 @@
+import { concat } from '@toa.io/generic';
+/** Where a component is, as every name derived from it. */
+export class Locator {
+    name;
+    namespace;
+    id;
+    label;
+    uppercase;
+    lowercase;
+    constructor(name, namespace) {
+        if (name === undefined)
+            throw new TypeError('Locator name must be defined');
+        this.name = name;
+        this.namespace = namespace;
+        this.id = concat(namespace, '.') + name;
+        this.label = (concat(namespace, '-') + name).toLowerCase();
+        this.uppercase = (concat(namespace, '_') + name).toUpperCase();
+        this.lowercase = (concat(namespace, '_') + name).toLowerCase();
+    }
+    static parse(string) {
+        const [namespace, name] = string.split(DOT);
+        if (name === undefined)
+            return new Locator(namespace);
+        else
+            return new Locator(name, namespace);
+    }
+    hostname(prefix) {
+        return concat(prefix?.toLowerCase(), '-') + this.label;
+    }
+}
+const DOT = '.';
+//# sourceMappingURL=locator.js.map

package/transpiled/locator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.js","sourceRoot":"","sources":["../source/locator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,2DAA2D;AAC3D,MAAM,OAAO,OAAO;IACF,IAAI,CAAQ;IACZ,SAAS,CAAoB;IAE7B,EAAE,CAAQ;IACV,KAAK,CAAQ;IACb,SAAS,CAAQ;IACjB,SAAS,CAAQ;IAEjC,YAAmB,IAAY,EAAE,SAAkB;QACjD,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAA;QAE3E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;QACvC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;QAC9D,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IAChE,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,MAAc;QAChC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAE3C,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;;YAChD,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAC1C,CAAC;IAEM,QAAQ,CAAC,MAAe;QAC7B,OAAO,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAA;IACxD,CAAC;CACF;AAED,MAAM,GAAG,GAAG,GAAG,CAAA"}

package/transpiled/observation.d.ts

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

package/transpiled/observation.js

@@ -0,0 +1,12 @@
+import { Operation } from './operation.js';
+export class Observation extends Operation {
+    async run(store) {
+        const scope = store.scope;
+        if (scope === null ||
+            (scope?.deleted === true && store.request.query?.options?.deleted !== true))
+            store.reply = null;
+        else
+            await super.run(store);
+    }
+}
+//# sourceMappingURL=observation.js.map

package/transpiled/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../source/observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAI1C,MAAM,OAAO,WAAY,SAAQ,SAAS;IACrB,KAAK,CAAC,GAAG,CAAC,KAAY;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAsB,CAAA;QAE1C,IACE,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,IAAK,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;YAEpF,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;;YACf,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/transpiled/operation.d.ts

@@ -0,0 +1,67 @@
+import { Readable } from 'node:stream';
+import { Connector } from './connector.js';
+import type { Cascade } from './cascade.js';
+import type { State } from './state.js';
+import type { Query as Translator } from './query.js';
+import type { Contract } from './contract/contract.js';
+import type { Entity } from './entities/entity.js';
+import type { EntitySet } from './entities/set.js';
+import type { Changeset } from './entities/changeset.js';
+import type { scope as Scope } from './types/operations.js';
+import type { Call } from './types/inbox.js';
+import type { Envelope, Query } from './types/request.js';
+/** What an operation acquires for the algorithm to run against. */
+export type Scoped = Entity | EntitySet | Changeset | Readable | null;
+/** What one invocation carries from step to step. */
+export interface Store {
+    request: Envelope;
+    scope?: Scoped;
+    state?: any;
+    reply?: any;
+    /** set by a transition, which is the only operation that runs its steps again */
+    retry?: () => Promise<any>;
+}
+export interface Contracts {
+    request: Contract;
+    reply: Contract;
+}
+export interface Definition {
+    scope: Scope;
+    concurrency?: string;
+    /** whether the same call arriving twice changes state once; see `documentation/inbox.md` */
+    once?: boolean;
+}
+export declare class Operation extends Connector {
+    #private;
+    scope: State;
+    /**
+     * Whether what this operation acquires may be modified and committed. Only a
+     * transition commits, and only a commit needs the pre-image an entity keeps
+     * to diff the new state against.
+     *
+     * @protected
+     */
+    protected mutable: boolean;
+    constructor(cascade: Cascade, scope: State, contracts: Contracts, query: Translator, definition: Definition);
+    invoke(request: Envelope): Promise<any>;
+    /**
+     * The call, once. What it answered is recorded with what it changed, in one transaction, so a
+     * second arrival of the same identity finds the key taken, changes nothing, and is answered
+     * with what the first one answered.
+     *
+     * The read in front of it is not what makes that true — the key is — but it is what keeps the
+     * ordinary duplicate from running the algorithm at all, and the ordinary duplicate is a
+     * retransmission that arrives after the first call has finished.
+     */
+    protected once(store: Store): Promise<any>;
+    /**
+     * What is recorded with the write. Read where the write is made, which is after the algorithm
+     * has run, because the reply is what a duplicate is answered with.
+     */
+    protected call(store: Store): Call | undefined;
+    protected process(store: Store): Promise<any>;
+    protected acquire(store: Store): Promise<void>;
+    protected run(store: Store): Promise<void>;
+    protected commit(_store: Store): Promise<void>;
+    protected query(query?: Query): Promise<Scoped>;
+}