@toa.io/extensions.chronicles 0.0.0-stage → 1.0.0-alpha.333

package/transpiled/Publisher.js

@@ -0,0 +1,169 @@
+import { createConnection } from 'node:net';
+import { connect } from 'comq';
+import { console } from 'openspan';
+import { Connector } from '@toa.io/core';
+import { EXCHANGE } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * Rows to the broker of the log: each a JSON message to the exchange `chronicles` under the key of
+ * its table, with the scope of the context and when it expires. A publication resolves once the
+ * broker has confirmed it, which is what the caller acknowledges what it carried by.
+ *
+ * The connection is made by the first publication and not before, and nothing waits for it to
+ * start: while the broker is away, a publication waits for it, and what it carries waits, unacknowledged,
+ * where it came from.
+ */
+export class Publisher extends Connector {
+    url;
+    scope;
+    retention;
+    io;
+    opened;
+    /** aborted as the publisher stops: what waits for the broker then gives up, to be delivered again */
+    closing = new AbortController();
+    stopped = false;
+    /** where it publishes, which a publisher of other settings does not */
+    address;
+    // eslint-disable-next-line max-params
+    constructor(address, user, scope, retention) {
+        super();
+        this.address = address;
+        const url = new URL(address);
+        url.username = encodeURIComponent(user.username);
+        url.password = encodeURIComponent(user.password);
+        this.url = url.href;
+        this.scope = scope;
+        this.retention = retention;
+    }
+    async publish(rows, states = [], encounters = []) {
+        if (this.stopped)
+            throw new Error('The chronicles are stopping');
+        const io = await this.connection();
+        await Promise.all([
+            ...rows.map(async (row) => await this.route(io, 'events', row, row.time)),
+            ...states.map(async (state) => await this.route(io, 'states', state)),
+            ...encounters.map(async (encounter) => await this.route(io, 'encounters', encounter, encounter.received))
+        ]);
+    }
+    /**
+     * Fails what waits for the broker, and what is published from now on, so the service publishing
+     * through it is not held open by what would wait for the broker past the service's own end: it
+     * is delivered again, to this process or another.
+     */
+    get done() {
+        return this.stopped;
+    }
+    stop() {
+        this.stopped = true;
+        this.closing.abort();
+    }
+    async open() {
+        this.stopped = false;
+        this.closing = new AbortController();
+    }
+    /**
+     * A connection still being made is not waited for — it may never be — but closed once it is,
+     * and what waits for it is failed, so it is delivered again, to this process or another.
+     */
+    async close() {
+        const { io, opened } = this;
+        this.io = undefined;
+        this.opened = undefined;
+        this.stop();
+        if (opened !== undefined)
+            await opened.close();
+        else
+            void io?.then(async (late) => await late.close(), () => undefined);
+    }
+    async connection() {
+        this.io ??= reachable(this.url, this.closing.signal)
+            .then(async () => await connect(this.url))
+            .then((io) => {
+            this.opened = io;
+            return io;
+        }, (error) => {
+            this.io = undefined;
+            console.warn('Chronicles failed to reach their broker', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        });
+        const { signal } = this.closing;
+        // a publication waits for the broker a while, and then fails, so what it carries is
+        // delivered again rather than held: a process that stops is not kept by one that never ends
+        return await new Promise((resolve, reject) => {
+            function away() {
+                reject(new Error('The broker of the chronicles is away'));
+            }
+            function closing() {
+                reject(new Error('The chronicles are closing'));
+            }
+            const timer = setTimeout(away, WAIT);
+            signal.addEventListener('abort', closing, { once: true });
+            this.io.then(resolve, reject).finally(() => {
+                clearTimeout(timer);
+                signal.removeEventListener('abort', closing);
+            });
+        });
+    }
+    // eslint-disable-next-line max-params
+    async route(io, table, row, from) {
+        const body = message(row, this.scope, from === undefined ? null : expires(from, this.retention));
+        await io.route(EXCHANGE, table, body, 'application/json');
+    }
+}
+/**
+ * Resolves once the broker accepts a connection, trying again until it does or `signal` aborts.
+ * A connection is asked of comq only then: one it is asked for keeps trying for as long as it
+ * takes, and is no longer the publisher's to give up.
+ */
+async function reachable(url, signal) {
+    const { protocol, hostname, port } = new URL(url);
+    const target = { host: hostname, port: Number(port === '' ? DEFAULT[protocol] : port) };
+    while (!signal.aborted) {
+        const reached = await new Promise((resolve) => {
+            const socket = createConnection(target);
+            function settle(ok) {
+                socket.destroy();
+                resolve(ok);
+            }
+            socket.setTimeout(PROBE);
+            socket.once('connect', () => settle(true));
+            socket.once('timeout', () => settle(false));
+            socket.once('error', () => settle(false));
+        });
+        if (reached)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, PROBE).unref());
+    }
+    throw new Error('The chronicles are closing');
+}
+/**
+ * A row as the store reads it: of a scope, its times in the store's format, and when it expires,
+ * where it does.
+ */
+export function message(row, scope, until) {
+    const body = { scope, ...row, time: timestamp(row.time) };
+    if ('received' in row)
+        body.received = timestamp(row.received);
+    if (until !== null)
+        body.expires = until;
+    return body;
+}
+/** When a row stops being kept: its time and the retention, or the end of the store's time. */
+export function expires(from, retention) {
+    if (retention === undefined)
+        return FOREVER;
+    return timestamp(from + retention * DAY).slice(0, 19);
+}
+/** A `DateTime64(3)` as the store reads one without guessing: UTC, to the millisecond. */
+export function timestamp(ms) {
+    return new Date(ms).toISOString().replace('T', ' ').replace('Z', '');
+}
+const DAY = 86_400_000;
+/** milliseconds a publication waits for the broker */
+const WAIT = 10_000;
+/** milliseconds a try to reach the broker takes, and between two of them */
+const PROBE = 1_000;
+const DEFAULT = { 'amqp:': 5672, 'amqps:': 5671 };
+const FOREVER = '2106-01-01 00:00:00';
+//# sourceMappingURL=Publisher.js.map

package/transpiled/Publisher.js.map

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

package/transpiled/Reader.d.ts

@@ -0,0 +1,28 @@
+import { Connector } from '@toa.io/core';
+import type { Provider } from './Provider.ts';
+import type { extensions } from '@toa.io/core/types';
+import type { Settings } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * What `chronicles.queries` reads the log through: queries in the provider's dialect, views made
+ * from a statement the provider let a query run, and what the log holds — how it is read, what the
+ * components declare, what the context documents of encounters, and what the store has written.
+ */
+export declare class Reader extends Connector {
+    readonly name = "chronicles";
+    private readonly host;
+    private readonly provider;
+    private readonly settings;
+    private encounters?;
+    constructor(host: extensions.Host, provider: () => Provider, settings: () => Settings);
+    invoke(method: string, ...args: any[]): Promise<unknown>;
+    private describe;
+    private query;
+    private define;
+    private drop;
+    /**
+     * What the configuration of `chronicles.encounters` documents, asked of that component, which is
+     * in this service where the context serves encounters. Found on the first ask and not before: an
+     * aspect is made ahead of the components of its composition.
+     */
+    private documented;
+}

package/transpiled/Reader.js

@@ -0,0 +1,166 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Connector, Locator, exceptions } from '@toa.io/core';
+import { ENCOUNTERS, NAMESPACE } from '@toa.io/definitions/extensions.chronicles';
+import { Refusal } from './Provider.js';
+/**
+ * What `chronicles.queries` reads the log through: queries in the provider's dialect, views made
+ * from a statement the provider let a query run, and what the log holds — how it is read, what the
+ * components declare, what the context documents of encounters, and what the store has written.
+ */
+export class Reader extends Connector {
+    name = 'chronicles';
+    host;
+    provider;
+    settings;
+    encounters;
+    constructor(host, provider, settings) {
+        super();
+        this.host = host;
+        this.provider = provider;
+        this.settings = settings;
+    }
+    async invoke(method, ...args) {
+        switch (method) {
+            case 'describe':
+                return await this.describe();
+            case 'query':
+                return await this.query(args[0]);
+            case 'define':
+                return await this.define(args[0]);
+            case 'drop':
+                return await this.drop(args[0]);
+            default:
+                throw new exceptions.MisuseException(`Chronicles have no '${method}'`);
+        }
+    }
+    async describe() {
+        const provider = this.provider();
+        const settings = this.settings();
+        const [written, kept, sent, views, documented] = await Promise.all([
+            provider.labels(),
+            provider.states(),
+            provider.encounters(),
+            provider.views(),
+            this.documented(settings)
+        ]);
+        const declared = { ...settings.events, ...settings.facts };
+        const stated = Object.fromEntries(Object.entries(settings.states).map(([label, contract]) => [
+            component(label),
+            contract
+        ]));
+        const labels = merge(written.map(({ label, ...stats }) => [label, stats]), Object.keys(declared)).map(([label, stats]) => ({
+            label,
+            ...about(declared[label], provider),
+            ...(stats ?? { rows: 0 })
+        }));
+        const states = merge(kept.map(({ component, ...stats }) => [component, stats]), Object.keys(stated)).map(([component, stats]) => ({
+            component,
+            ...about(stated[component], provider),
+            ...(stats ?? { entities: 0 })
+        }));
+        const encounters = merge(sent.map(({ name, ...stats }) => [name, stats]), Object.keys(documented)).map(([name, stats]) => {
+            const { description, fields: told = {} } = documented[name] ?? {};
+            const fields = (stats?.fields ?? []).map((field) => told[field.path] === undefined
+                ? field
+                : { ...field, description: told[field.path] });
+            return {
+                name,
+                ...(description === undefined ? {} : { description }),
+                ...(stats ?? { rows: 0 }),
+                fields
+            };
+        });
+        return { guide: `${GUIDE}\n${provider.guide}`, labels, states, encounters, views };
+    }
+    async query(sql) {
+        return await refused(async () => await this.provider().query(statement(sql)));
+    }
+    async define(definition) {
+        const provider = this.provider();
+        const { name } = definition;
+        if (provider.tables.includes(name))
+            return new Error('RESERVED', {
+                cause: { message: `'${name}' is a table of the log` }
+            });
+        const select = statement(definition.sql);
+        const invalid = await refused(async () => await provider.validate(select));
+        if (invalid instanceof Error)
+            return invalid;
+        const views = await provider.views();
+        if (!views.some((view) => view.name === name) && views.length >= MAX_VIEWS)
+            return new Error('EXHAUSTED', {
+                cause: { message: `A context has at most ${MAX_VIEWS} views` }
+            });
+        const defined = await refused(async () => await provider.define({ ...definition, sql: select }));
+        return defined instanceof Error ? defined : undefined;
+    }
+    async drop(name) {
+        const provider = this.provider();
+        const views = await provider.views();
+        if (!views.some((view) => view.name === name))
+            return new Error('NOT_FOUND');
+        await provider.drop(name);
+        return undefined;
+    }
+    /**
+     * What the configuration of `chronicles.encounters` documents, asked of that component, which is
+     * in this service where the context serves encounters. Found on the first ask and not before: an
+     * aspect is made ahead of the components of its composition.
+     */
+    async documented(settings) {
+        if (!settings.encounters)
+            return {};
+        this.encounters ??= (async () => {
+            const remote = await this.host.remote(LOCATOR, SOURCE);
+            this.depends(remote);
+            await remote.connect();
+            return remote;
+        })().catch((error) => {
+            this.encounters = undefined;
+            throw error;
+        });
+        const remote = await this.encounters;
+        return (await remote.invoke('describe', {}));
+    }
+}
+/**
+ * Of what was written and what is declared, by key, in order: a key declared and not yet written
+ * has no statistics, and one written and no longer declared has nothing else.
+ */
+function merge(written, declared) {
+    const by = new Map(written);
+    const keys = [...new Set([...by.keys(), ...declared])].sort();
+    return keys.map((key) => [key, by.get(key)]);
+}
+/** What a declaration says of a label or a state: its meaning, and its fields. */
+function about(contract, provider) {
+    if (contract === undefined)
+        return {};
+    return {
+        description: contract.description,
+        fields: provider.fields(contract.properties)
+    };
+}
+function component(label) {
+    return label.slice(0, label.lastIndexOf('.'));
+}
+/** One statement: a trailing semicolon is an agent's habit. */
+function statement(sql) {
+    return sql.trim().replace(/;+$/, '').trim();
+}
+async function refused(fn) {
+    try {
+        return await fn();
+    }
+    catch (exception) {
+        if (exception instanceof Refusal)
+            return new Error('REFUSED', { cause: { message: exception.message } });
+        throw exception;
+    }
+}
+const LOCATOR = new Locator(ENCOUNTERS, NAMESPACE);
+const SOURCE = { service: 'chronicles' };
+const MAX_VIEWS = 50;
+const GUIDE = readFileSync(resolve(import.meta.dirname, '../guides/log.md'), 'utf8');
+//# sourceMappingURL=Reader.js.map

package/transpiled/Reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reader.js","sourceRoot":"","sources":["../source/Reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAA;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAMvC;;;;GAIG;AACH,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnB,IAAI,GAAG,YAAY,CAAA;IAElB,IAAI,CAAiB;IACrB,QAAQ,CAAgB;IACxB,QAAQ,CAAgB;IACjC,UAAU,CAAkB;IAEpC,YACE,IAAqB,EACrB,QAAwB,EACxB,QAAwB;QAExB,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,IAAW;QAChD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,UAAU;gBACb,OAAO,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC9B,KAAK,OAAO;gBACV,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,KAAK,QAAQ;gBACX,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACnC,KAAK,MAAM;gBACT,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACjC;gBACE,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAEhC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjE,QAAQ,CAAC,MAAM,EAAE;YACjB,QAAQ,CAAC,MAAM,EAAE;YACjB,QAAQ,CAAC,UAAU,EAAE;YACrB,QAAQ,CAAC,KAAK,EAAE;YAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;SAC1B,CAAC,CAAA;QAEF,MAAM,QAAQ,GAA6B,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAA;QACpF,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;YACzD,SAAS,CAAC,KAAK,CAAC;YAChB,QAAQ;SACT,CAAC,CACH,CAAA;QAED,MAAM,MAAM,GAAG,KAAK,CAClB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EACpD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CACtB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,KAAK;YACL,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;YACnC,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SAC1B,CAAC,CAAC,CAAA;QAEH,MAAM,MAAM,GAAG,KAAK,CAClB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EACzD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CACpB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,SAAS;YACT,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;YACrC,GAAG,CAAC,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC,CAAA;QAEH,MAAM,UAAU,GAAG,KAAK,CACtB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAC/C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CACxB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;YACtB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;YACjE,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;gBAC5B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAChD,CAAA;YAED,OAAO;gBACL,IAAI;gBACJ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;gBACrD,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM;aACP,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACpF,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,GAAW;QAC7B,OAAO,MAAM,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC/E,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,UAAsB;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAA;QAE3B,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAChC,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE;gBAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,yBAAyB,EAAE;aACtD,CAAC,CAAA;QAEJ,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QAE1E,IAAI,OAAO,YAAY,KAAK;YAAE,OAAO,OAAO,CAAA;QAE5C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;QAEpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;YACxE,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE;gBAC5B,KAAK,EAAE,EAAE,OAAO,EAAE,yBAAyB,SAAS,QAAQ,EAAE;aAC/D,CAAC,CAAA;QAEJ,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,KAAK,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAClE,CAAA;QAED,OAAO,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IACvD,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAAY;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;QAEpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;QAE5E,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,UAAU,CAAC,QAAkB;QACzC,IAAI,CAAC,QAAQ,CAAC,UAAU;YAAE,OAAO,EAAE,CAAA;QAEnC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAEtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACpB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;YAEtB,OAAO,MAAM,CAAA;QACf,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;YAE3B,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAA;QAEpC,OAAO,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAe,CAAA;IAC5D,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,KAAK,CACZ,OAA2B,EAC3B,QAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,kFAAkF;AAClF,SAAS,KAAK,CACZ,QAA8B,EAC9B,QAAkB;IAElB,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAErC,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;KAC7C,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,+DAA+D;AAC/D,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AAC7C,CAAC;AAED,KAAK,UAAU,OAAO,CAAI,EAAoB;IAC5C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAA;IACnB,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,IAAI,SAAS,YAAY,OAAO;YAC9B,OAAO,IAAI,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAExE,MAAM,SAAS,CAAA;IACjB,CAAC;AACH,CAAC;AAgBD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;AAClD,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AACxC,MAAM,SAAS,GAAG,EAAE,CAAA;AACpB,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAA"}

package/transpiled/Recorder.d.ts

@@ -0,0 +1,38 @@
+import { Connector } from '@toa.io/core';
+import type { Publisher } from './Publisher.ts';
+import type { Row, State } from './Provider.ts';
+import type { Contract } from '@toa.io/definitions/extensions.chronicles';
+import type { Message } from '@toa.io/core/types';
+/**
+ * The consumer of one event the log is kept of: a row of `events` for an event a component declares
+ * under `events`, and a state for the one it declares its `state`. A message carries what the event
+ * rendered, its id and when the change was made, so what is said of the entity — which, its
+ * version — is read from the payload, where the entity as it stands carries `id` and `VERSION`;
+ * when, from the property the component names, or the message; and what is written of the payload
+ * is what the contract declares.
+ */
+export declare class Recorder extends Connector {
+    private readonly label;
+    private readonly component;
+    private readonly kind;
+    private readonly of;
+    private readonly publisher;
+    constructor(label: string, kind: Kind, of: Of, publisher: Publisher);
+    receive(message: Message): Promise<void>;
+}
+/** What a component declares of the payloads of a label. */
+export interface Of {
+    contract: Contract;
+    /** the property that names whose a row is; `null` where none does */
+    identity: string | null;
+    /** the property that says when the change was made; `null` where none does */
+    timestamp: string | null;
+}
+export declare function row(label: string, component: string, message: Message, of: Of): Row;
+/**
+ * The entity as its state event renders it. One that does not say which entity it is, and which
+ * version, cannot be kept, and no delivery of it will say otherwise: refused as a contract the
+ * component broke, so it is parked on its first delivery rather than retried.
+ */
+export declare function state(label: string, component: string, message: Message, of: Of): State;
+export type Kind = 'event' | 'state';

package/transpiled/Recorder.js

@@ -0,0 +1,107 @@
+import { Connector, entities, exceptions } from '@toa.io/core';
+import { Mismatch, project } from './contract.js';
+/**
+ * The consumer of one event the log is kept of: a row of `events` for an event a component declares
+ * under `events`, and a state for the one it declares its `state`. A message carries what the event
+ * rendered, its id and when the change was made, so what is said of the entity — which, its
+ * version — is read from the payload, where the entity as it stands carries `id` and `VERSION`;
+ * when, from the property the component names, or the message; and what is written of the payload
+ * is what the contract declares.
+ */
+export class Recorder extends Connector {
+    label;
+    component;
+    kind;
+    of;
+    publisher;
+    // eslint-disable-next-line max-params
+    constructor(label, kind, of, publisher) {
+        super();
+        this.label = label;
+        this.component = label.slice(0, label.lastIndexOf('.'));
+        this.kind = kind;
+        this.of = of;
+        this.publisher = publisher;
+    }
+    async receive(message) {
+        if (this.kind === 'state')
+            await this.publisher.publish([], [state(this.label, this.component, message, this.of)]);
+        else
+            await this.publisher.publish([row(this.label, this.component, message, this.of)]);
+    }
+}
+// eslint-disable-next-line max-params
+export function row(label, component, message, of) {
+    const payload = object(message.payload);
+    const { id, VERSION } = payload;
+    return {
+        // a message from outside Toa carries no id, and is then the same message by what it says
+        id: message.id ?? entities.derive(label, JSON.stringify(payload)),
+        label,
+        component,
+        time: when(payload, message, of.timestamp),
+        entity: typeof id === 'string' ? id : null,
+        version: typeof VERSION === 'number' ? VERSION : null,
+        identity: whose(payload, of.identity),
+        trace: message.telemetry ?? null,
+        payload: declared(label, payload, of.contract)
+    };
+}
+/**
+ * The entity as its state event renders it. One that does not say which entity it is, and which
+ * version, cannot be kept, and no delivery of it will say otherwise: refused as a contract the
+ * component broke, so it is parked on its first delivery rather than retried.
+ */
+// eslint-disable-next-line max-params
+export function state(label, component, message, of) {
+    const payload = object(message.payload);
+    const { id, VERSION } = payload;
+    if (typeof id !== 'string' || typeof VERSION !== 'number')
+        throw new exceptions.EntityContractException(`The state '${label}' is an entity as it stands, and its payload carries no 'id' and 'VERSION'`);
+    return {
+        component,
+        entity: id,
+        version: VERSION,
+        identity: whose(payload, of.identity),
+        time: when(payload, message, of.timestamp),
+        payload: declared(label, payload, of.contract)
+    };
+}
+/**
+ * When the change was made: what the payload says in the property the component names, or else
+ * what the message says, which the process that made the change stamped as it made it. A message
+ * of a process from before messages said so says nothing, and is when it is taken.
+ */
+function when(payload, message, property) {
+    const said = property === null ? undefined : payload[property];
+    if (typeof said === 'number')
+        return said;
+    return message.time ?? Date.now();
+}
+/**
+ * What the contract declares of a payload. One it does not admit is a contract the component broke,
+ * which no delivery will mend: refused, so it is parked on its first delivery.
+ */
+function declared(label, payload, contract) {
+    try {
+        return project(payload, contract.properties);
+    }
+    catch (exception) {
+        if (exception instanceof Mismatch)
+            throw new exceptions.EntityContractException(`The payload of '${label}' is not what its chronicles declare: ${exception.message}`);
+        throw exception;
+    }
+}
+/** The identity a payload names in the property the component declares, where it is one. */
+function whose(payload, property) {
+    if (property === null)
+        return null;
+    const value = payload[property];
+    return typeof value === 'string' ? value : null;
+}
+function object(payload) {
+    return typeof payload === 'object' && payload !== null && !Array.isArray(payload)
+        ? payload
+        : { value: payload };
+}
+//# sourceMappingURL=Recorder.js.map

package/transpiled/Recorder.js.map

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

package/transpiled/Relay.d.ts

@@ -0,0 +1,14 @@
+import { Connector } from '@toa.io/core';
+import type { Publisher } from './Publisher.ts';
+/**
+ * What `chronicles.relay` publishes the tasks it is given through: a fact a component sent, and the
+ * encounters of a batch a client sent. A task is done once the broker has confirmed its rows. The
+ * publisher is the relay's own, closed with it: the component may be composed by another factory
+ * than the one of the service it runs in.
+ */
+export declare class Relay extends Connector {
+    readonly name = "chronicles";
+    private readonly publisher;
+    constructor(publisher: Publisher);
+    invoke(method: string, ...args: any[]): Promise<void>;
+}

package/transpiled/Relay.js

@@ -0,0 +1,27 @@
+import { Connector, exceptions } from '@toa.io/core';
+/**
+ * What `chronicles.relay` publishes the tasks it is given through: a fact a component sent, and the
+ * encounters of a batch a client sent. A task is done once the broker has confirmed its rows. The
+ * publisher is the relay's own, closed with it: the component may be composed by another factory
+ * than the one of the service it runs in.
+ */
+export class Relay extends Connector {
+    name = 'chronicles';
+    publisher;
+    constructor(publisher) {
+        super();
+        this.publisher = publisher;
+        this.depends(publisher);
+    }
+    async invoke(method, ...args) {
+        switch (method) {
+            case 'record':
+                return await this.publisher.publish([args[0]]);
+            case 'encounter':
+                return await this.publisher.publish([], [], args[0]);
+            default:
+                throw new exceptions.MisuseException(`Chronicles have no '${method}'`);
+        }
+    }
+}
+//# sourceMappingURL=Relay.js.map

package/transpiled/Relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relay.js","sourceRoot":"","sources":["../source/Relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAIpD;;;;;GAKG;AACH,MAAM,OAAO,KAAM,SAAQ,SAAS;IAClB,IAAI,GAAG,YAAY,CAAA;IAElB,SAAS,CAAW;IAErC,YAAmB,SAAoB;QACrC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,IAAW;QAChD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,QAAQ;gBACX,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAC,CAAC,CAAA;YACvD,KAAK,WAAW;gBACd,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAgB,CAAC,CAAA;YACrE;gBACE,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;CACF"}

package/transpiled/Sender.d.ts

@@ -0,0 +1,25 @@
+import { Connector, Locator } from '@toa.io/core';
+import type { Contract } from '@toa.io/definitions/extensions.chronicles';
+import type { extensions } from '@toa.io/core/types';
+/**
+ * `context.chronicles.send(name, payload, { identity })` — a fact that changes no state, written under
+ * `<component>.<name>`, of which what the component declares of it is sent. It is a task to the
+ * component that writes facts, so it resolves once the broker has it, and is kept until that
+ * component takes it.
+ */
+export declare class Sender extends Connector {
+    readonly name = "chronicles";
+    private readonly host;
+    private readonly locator;
+    private readonly facts;
+    private remote?;
+    /** `facts` are the contracts of the facts the component declares, by name */
+    constructor(host: extensions.Host, locator: Locator, facts: Record<string, Contract>);
+    invoke(method: string, ...args: any[]): Promise<void>;
+    private send;
+    /**
+     * Resolved on the first fact and not before: an aspect is made ahead of the components of its
+     * composition, and one that could not be found is looked for again by the next fact.
+     */
+    private recorder;
+}