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

package/transpiled/entities/entity.js

@@ -0,0 +1,109 @@
+import { EntityContractException, EntityGuardException } from '../exceptions.js';
+import { newid } from './newid.js';
+export class Entity {
+    deleted = false;
+    #schema;
+    #blank;
+    #guards;
+    #origin = null;
+    #state;
+    #mutable = true;
+    /**
+     * 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
+     */
+    // eslint-disable-next-line max-params
+    constructor(schema, blank, argument, guards, mutable = true) {
+        this.#schema = schema;
+        this.#blank = blank;
+        this.#guards = guards;
+        if (typeof argument === 'object')
+            this.#acquire(argument, mutable);
+        else
+            this.#write(this.#compose(argument ?? newid()));
+    }
+    get() {
+        return this.#state;
+    }
+    set(value) {
+        if (!this.#mutable)
+            throw new Error('Entity acquired by a read-only operation cannot be modified');
+        this.#guard(value);
+        const error = this.#schema.fit(value);
+        if (error !== null)
+            throw new EntityContractException(error, value);
+        this.#revive(value);
+        this.#write(value);
+    }
+    event(input) {
+        return {
+            origin: this.#origin,
+            state: this.#state,
+            trailers: this.#state._trailers,
+            input
+        };
+    }
+    /**
+     * The origin is the pre-image a commit diffs the new state against. An operation that
+     * cannot commit has nothing to diff, so it takes the record as it came from the storage
+     * instead of paying for a deep copy of every record it read.
+     */
+    #acquire(record, mutable) {
+        this.#mutable = mutable;
+        if (!mutable) {
+            this.#write(record);
+            return;
+        }
+        this.#write(structuredClone(record));
+        this.#origin = record;
+    }
+    /**
+     * A blank is not validated: what the component declared is fitted once, at boot, and the
+     * system properties are the runtime's own. It is copied because every entity the component
+     * makes is written over its own.
+     */
+    #compose(id) {
+        return { id, VERSION: 0, DELETED: null, ...structuredClone(this.#blank) };
+    }
+    #guard(value) {
+        if (this.#guards === undefined)
+            return;
+        for (const guard of this.#guards) {
+            const ok = guard.fit(value, this.#origin);
+            if (ok === false)
+                throw new EntityGuardException(guard.name, value);
+        }
+    }
+    // deletion is only expressed as a new DELETED timestamp,
+    // so committing over a tombstone without touching it means revival
+    #revive(value) {
+        if (this.#origin?.DELETED == null || value.DELETED !== this.#origin.DELETED)
+            return;
+        value.DELETED = null;
+        this.deleted = false;
+    }
+    #write(value) {
+        if (!('_trailers' in value))
+            Object.defineProperty(value, '_trailers', {
+                writable: false,
+                configurable: false,
+                enumerable: false,
+                value: {}
+            });
+        if (!('CREATED' in value)) {
+            value.CREATED = Date.now();
+            value.UPDATED ??= value.CREATED;
+        }
+        if ('DELETED' in value && value.DELETED !== null)
+            this.deleted = true;
+        if (this.#state !== undefined) {
+            value.UPDATED = Date.now();
+            value.VERSION++;
+        }
+        this.#state = value;
+    }
+}
+//# sourceMappingURL=entity.js.map

package/transpiled/entities/entity.js.map

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

package/transpiled/entities/factory.d.ts

@@ -0,0 +1,22 @@
+import { Entity } from './entity.js';
+import { EntitySet } from './set.js';
+import { Changeset } from './changeset.js';
+import type { Schema } from '@toa.io/schemas';
+import type { Guard } from '../guard.js';
+import type { Query, Record } from '../types/storages.js';
+/** The two schemas a component's records are held to, and what a new one starts as. */
+export interface Schemas {
+    /** what a stored record must fit */
+    entity: Schema;
+    /** what a changeset must fit: the same properties, none of them required */
+    changeset: Schema;
+}
+export declare class Factory {
+    #private;
+    constructor(schemas: Schemas, blank: object, guards?: Guard[]);
+    fit(values: object): void;
+    init(id?: string): Entity;
+    object(record: Record, mutable?: boolean): Entity;
+    objects(recordset: Record[], init?: string[], mutable?: boolean): EntitySet;
+    changeset(query: Query): Changeset;
+}

package/transpiled/entities/factory.js

@@ -0,0 +1,34 @@
+import { newid } from './newid.js';
+import { Entity } from './entity.js';
+import { EntitySet } from './set.js';
+import { Changeset } from './changeset.js';
+export class Factory {
+    #schemas;
+    #blank;
+    #guards;
+    constructor(schemas, blank, guards) {
+        this.#schemas = schemas;
+        this.#blank = blank;
+        this.#guards = guards;
+    }
+    fit(values) {
+        this.#schemas.entity.validate({ id: newid(), ...this.#blank, ...values }, 'Entity');
+    }
+    init(id) {
+        return new Entity(this.#schemas.entity, this.#blank, id, this.#guards);
+    }
+    object(record, mutable = true) {
+        return new Entity(this.#schemas.entity, this.#blank, record, this.#guards, mutable);
+    }
+    objects(recordset, init, mutable = true) {
+        const set = recordset.map((record) => this.object(record, mutable));
+        if (init !== undefined)
+            for (const id of init)
+                set.unshift(this.init(id));
+        return new EntitySet(set);
+    }
+    changeset(query) {
+        return new Changeset(this.#schemas.changeset, query);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/transpiled/entities/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../source/entities/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAc1C,MAAM,OAAO,OAAO;IACT,QAAQ,CAAS;IACjB,MAAM,CAAQ;IACd,OAAO,CAAqB;IAErC,YAAmB,OAAgB,EAAE,KAAa,EAAE,MAAgB;QAClE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAEM,GAAG,CAAC,MAAc;QACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAA;IACrF,CAAC;IAEM,IAAI,CAAC,EAAW;QACrB,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IACxE,CAAC;IAEM,MAAM,CAAC,MAAc,EAAE,OAAO,GAAG,IAAI;QAC1C,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACrF,CAAC;IAEM,OAAO,CAAC,SAAmB,EAAE,IAAe,EAAE,OAAO,GAAG,IAAI;QACjE,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QAEnE,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,MAAM,EAAE,IAAI,IAAI;gBAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;QAEzE,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAEM,SAAS,CAAC,KAAY;QAC3B,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IACtD,CAAC;CACF"}

package/transpiled/entities/index.d.ts

@@ -0,0 +1,4 @@
+export { Factory } from './factory.js';
+export { Entity } from './entity.js';
+export { EntitySet } from './set.js';
+export { Changeset } from './changeset.js';

package/transpiled/entities/index.js

@@ -0,0 +1,5 @@
+export { Factory } from './factory.js';
+export { Entity } from './entity.js';
+export { EntitySet } from './set.js';
+export { Changeset } from './changeset.js';
+//# sourceMappingURL=index.js.map

package/transpiled/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/entities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/transpiled/entities/newid.d.ts

@@ -0,0 +1 @@
+export declare function newid(): string;

package/transpiled/entities/newid.js

@@ -0,0 +1,7 @@
+import * as uuid from 'uuid';
+export function newid() {
+    const buf = Buffer.alloc(16);
+    uuid.v7(undefined, buf);
+    return buf.toString('hex');
+}
+//# sourceMappingURL=newid.js.map

package/transpiled/entities/newid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newid.js","sourceRoot":"","sources":["../../source/entities/newid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,MAAM,UAAU,KAAK;IACnB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAE5B,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAEvB,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC"}

package/transpiled/entities/set.d.ts

@@ -0,0 +1,10 @@
+import type { Entity } from './entity.js';
+import type { Record } from '../types/storages.js';
+import type { Event } from '../types/state.js';
+export declare class EntitySet {
+    #private;
+    constructor(set: Entity[]);
+    get(): Record[];
+    set(values: Record[]): void;
+    events(input?: object): Event[];
+}

package/transpiled/entities/set.js

@@ -0,0 +1,19 @@
+import { SystemException } from '../exceptions.js';
+export class EntitySet {
+    #set;
+    constructor(set) {
+        this.#set = set;
+    }
+    get() {
+        return this.#set.map((entity) => entity.get());
+    }
+    set(values) {
+        if (values.length !== this.#set.length)
+            throw new SystemException('Objects array must not be modified');
+        values.forEach((value, index) => this.#set[index].set(value));
+    }
+    events(input) {
+        return this.#set.map((entity) => entity.event(input));
+    }
+}
+//# sourceMappingURL=set.js.map

package/transpiled/entities/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../source/entities/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKlD,MAAM,OAAO,SAAS;IACX,IAAI,CAAU;IAEvB,YAAmB,GAAa;QAC9B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAEM,GAAG;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;IAChD,CAAC;IAEM,GAAG,CAAC,MAAgB;QACzB,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM;YACpC,MAAM,IAAI,eAAe,CAAC,oCAAoC,CAAC,CAAA;QAEjE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/D,CAAC;IAEM,MAAM,CAAC,KAAc;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IACvD,CAAC;CACF"}

package/transpiled/event.d.ts

@@ -0,0 +1,14 @@
+import { Connector } from './connector.js';
+import type { Emitter } from './types/bindings.js';
+import type { Event as Bridge } from './types/bridges.js';
+import type { Event as StateEvent } from './types/state.js';
+export interface Definition {
+    conditioned?: boolean;
+    subjective?: boolean;
+    label?: string;
+}
+export declare class Event extends Connector {
+    #private;
+    constructor(definition: Definition, emitter: Emitter, bridge?: Bridge);
+    emit(event: StateEvent): Promise<void>;
+}

package/transpiled/event.js

@@ -0,0 +1,38 @@
+import { console, current, encode } from 'openspan';
+import { Connector } from './connector.js';
+export class Event extends Connector {
+    #emitter;
+    #bridge;
+    #conditioned;
+    #subjective;
+    #label;
+    constructor(definition, emitter, bridge) {
+        super();
+        this.#conditioned = definition.conditioned;
+        this.#subjective = definition.subjective;
+        this.#label = definition.label ?? 'event';
+        this.#emitter = emitter;
+        this.#bridge = bridge;
+        this.depends(emitter);
+        if (bridge !== undefined)
+            this.depends(bridge);
+    }
+    async emit(event) {
+        if (this.#conditioned === false || (await this.#bridge?.condition(event)) === true) {
+            const payload = this.#subjective === true ? await this.#bridge?.payload(event) : event.state;
+            const message = { payload };
+            const options = {
+                name: `${this.#label} publish`,
+                kind: 'producer',
+                attributes: { 'messaging.destination.name': this.#label }
+            };
+            await console.span(options, async () => {
+                const context = current();
+                if (context !== undefined)
+                    message.telemetry = encode(context);
+                await this.#emitter.emit(message);
+            });
+        }
+    }
+}
+//# sourceMappingURL=event.js.map

package/transpiled/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../source/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAY1C,MAAM,OAAO,KAAM,SAAQ,SAAS;IACzB,QAAQ,CAAS;IACjB,OAAO,CAAoB;IAC3B,YAAY,CAAqB;IACjC,WAAW,CAAqB;IAChC,MAAM,CAAQ;IAEvB,YAAmB,UAAsB,EAAE,OAAgB,EAAE,MAAe;QAC1E,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,WAAW,CAAA;QAC1C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,UAAU,CAAA;QACxC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,IAAI,OAAO,CAAA;QACzC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QAErB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAErB,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAiB;QACjC,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnF,MAAM,OAAO,GACX,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAA;YAE9E,MAAM,OAAO,GAAY,EAAE,OAAO,EAAE,CAAA;YAEpC,MAAM,OAAO,GAAgB;gBAC3B,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,UAAU;gBAC9B,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,EAAE,4BAA4B,EAAE,IAAI,CAAC,MAAM,EAAE;aAC1D,CAAA;YAED,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;gBACrC,MAAM,OAAO,GAAG,OAAO,EAAE,CAAA;gBAEzB,IAAI,OAAO,KAAK,SAAS;oBAAE,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;gBAE9D,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACnC,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}

package/transpiled/exceptions.d.ts

@@ -0,0 +1,61 @@
+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;
+    Communication: number;
+    Transmission: 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);
+}
+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 CommunicationException: Derived;
+export declare const TransmissionException: Derived;
+export declare const names: Record<string, string>;
+export {};

package/transpiled/exceptions.js

@@ -0,0 +1,93 @@
+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,
+    Communication: 400,
+    Transmission: 401
+};
+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;
+    }
+}
+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', 'property', 'schema', 'path', 'params'])
+                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 CommunicationException = derive('Communication');
+export const TransmissionException = derive('Transmission');
+export const names = swap(codes);
+// #endregion
+//# 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,35 @@
+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/index.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 * as entities from './entities/index.js';
+export * as exceptions from './exceptions.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,29 @@
+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/index.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 * as entities from './entities/index.js';
+export * as exceptions from './exceptions.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,mBAAmB,CAAA;AAC1C,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,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA"}

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