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

package/transpiled/clickhouse/ddl.d.ts

@@ -0,0 +1,9 @@
+/** The log's tables, which a view is not named after. */
+export declare const TABLES: string[];
+/** What a query answers at most, which the provider cuts a result at to tell it is cut. */
+export declare const LIMITS: {
+    rows: number;
+};
+/** An identifier, quoted: a scope, which may have hyphens, or a name held to letters and digits. */
+export declare function id(name: string): string;
+export declare function literal(value: string): string;

package/transpiled/clickhouse/ddl.js

@@ -0,0 +1,15 @@
+/** The log's tables, which a view is not named after. */
+export const TABLES = ['events', 'states', 'encounters'];
+/** What a query answers at most, which the provider cuts a result at to tell it is cut. */
+export const LIMITS = { rows: 10_000 };
+/** An identifier, quoted: a scope, which may have hyphens, or a name held to letters and digits. */
+export function id(name) {
+    if (!IDENTIFIER.test(name))
+        throw new Error(`'${name}' is not a ClickHouse identifier chronicles accept`);
+    return '`' + name + '`';
+}
+export function literal(value) {
+    return "'" + value.replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'";
+}
+const IDENTIFIER = /^[a-zA-Z0-9_][a-zA-Z0-9_-]*$/;
+//# sourceMappingURL=ddl.js.map

package/transpiled/clickhouse/ddl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.js","sourceRoot":"","sources":["../../source/clickhouse/ddl.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAA;AAExD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAEtC,oGAAoG;AACpG,MAAM,UAAU,EAAE,CAAC,IAAY;IAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,oDAAoD,CAAC,CAAA;IAE/E,OAAO,GAAG,GAAG,IAAI,GAAG,GAAG,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,GAAG,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,GAAG,8BAA8B,CAAA"}

package/transpiled/clickhouse/views.d.ts

@@ -0,0 +1,11 @@
+import type { Property } from '@toa.io/definitions/extensions.chronicles';
+import type { Field } from '../Provider.ts';
+/**
+ * How a declared property is read from the payload in its type, by `JSONExtract`, which reads what
+ * is not of the type as `NULL` rather than failing the query — a row written under an earlier
+ * contract is read by the one there is now.
+ */
+/** The fields of a contract, at every depth, each with the type its column reads it as. */
+export declare function fields(properties: Record<string, Property>, prefix?: string): Field[];
+/** What a property reads as, `NULL` aside. */
+export declare function type(property: Property): string;

package/transpiled/clickhouse/views.js

@@ -0,0 +1,97 @@
+import { id, literal } from './ddl.js';
+/**
+ * How a declared property is read from the payload in its type, by `JSONExtract`, which reads what
+ * is not of the type as `NULL` rather than failing the query — a row written under an earlier
+ * contract is read by the one there is now.
+ */
+/** The fields of a contract, at every depth, each with the type its column reads it as. */
+export function fields(properties, prefix = '') {
+    const found = [];
+    for (const [name, property] of Object.entries(properties)) {
+        if (empty(property))
+            continue;
+        const path = prefix === '' ? name : `${prefix}.${name}`;
+        const field = { path, type: type(property), description: property.description };
+        // a property of a property is read inside the one that holds it
+        if (prefix === '')
+            field.read = extract(name, property);
+        found.push(field);
+        const nested = property.type === 'array' ? property.items : property;
+        if (nested.type === 'object')
+            found.push(...fields(nested.properties, path));
+    }
+    return found;
+}
+/** What a property reads as, `NULL` aside. */
+export function type(property) {
+    switch (property.type) {
+        case 'object':
+            return `Tuple(${members(property, type)})`;
+        case 'array':
+            return `Array(${type(property.items)})`;
+        default:
+            return scalar(property);
+    }
+}
+/** The column of a property: a value of the type, or `NULL` where it was not one. */
+function column(property) {
+    switch (property.type) {
+        case 'object':
+            return `Tuple(${members(property, column)})`;
+        case 'array':
+            return `Array(${column(property.items)})`;
+        default:
+            return property.enum === undefined
+                ? `Nullable(${scalar(property)})`
+                : 'LowCardinality(Nullable(String))';
+    }
+}
+function scalar(property) {
+    if (property.enum !== undefined)
+        return 'LowCardinality(String)';
+    const formatted = property.format === undefined ? undefined : FORMATS[property.format];
+    return formatted?.type === property.type ? formatted.as : SCALARS[property.type];
+}
+function members(property, of) {
+    return Object.entries(property.properties)
+        .filter(([, nested]) => !empty(nested))
+        .map(([name, nested]) => `${name} ${of(nested)}`)
+        .join(', ');
+}
+/**
+ * An object is read from the JSON of its paths, which is an object however few of them a row has;
+ * anything else from the JSON of its value, which is `null` where a row has none.
+ */
+function extract(name, property) {
+    const json = property.type === 'object'
+        ? `toJSONString(payload.^${id(name)})`
+        : `ifNull(toJSONString(payload.${id(name)}), 'null')`;
+    return `JSONExtract(${json}, ${literal(column(property))})`;
+}
+/** An object of no properties is no column: a tuple of nothing is no type. */
+function empty(property) {
+    const nested = property.type === 'array' ? property.items : property;
+    return (nested.type === 'object' &&
+        Object.values(nested.properties ?? {}).every((member) => empty(member)));
+}
+const SCALARS = {
+    string: 'String',
+    integer: 'Int64',
+    number: 'Float64',
+    boolean: 'Bool'
+};
+const FORMATS = {
+    'date-time': { type: 'string', as: "DateTime64(3, 'UTC')" },
+    'iso-date-time': { type: 'string', as: "DateTime64(3, 'UTC')" },
+    date: { type: 'string', as: 'Date32' },
+    time: { type: 'string', as: 'Time64(3)' },
+    'iso-time': { type: 'string', as: 'Time64(3)' },
+    uuid: { type: 'string', as: 'UUID' },
+    ipv4: { type: 'string', as: 'IPv4' },
+    ipv6: { type: 'string', as: 'IPv6' },
+    int32: { type: 'integer', as: 'Int32' },
+    int64: { type: 'integer', as: 'Int64' },
+    float: { type: 'number', as: 'Float32' },
+    double: { type: 'number', as: 'Float64' }
+};
+//# sourceMappingURL=views.js.map

package/transpiled/clickhouse/views.js.map

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

package/transpiled/contract.d.ts

@@ -0,0 +1,12 @@
+import type { Property } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * What of a payload is written: the declared properties, at every depth, and nothing else. A
+ * value that is not of its declared type is a payload the contract does not admit, which throws a
+ * `Mismatch` naming where; `null` is admitted for any property, and an absent one stays absent.
+ */
+export declare function project(payload: object, properties: Record<string, Property>, path?: string): Record<string, unknown>;
+/** A payload's value at `path` is not of the type its contract declares. */
+export declare class Mismatch extends Error {
+    readonly path: string;
+    constructor(path: string, property: Property);
+}

package/transpiled/contract.js

@@ -0,0 +1,58 @@
+/**
+ * What of a payload is written: the declared properties, at every depth, and nothing else. A
+ * value that is not of its declared type is a payload the contract does not admit, which throws a
+ * `Mismatch` naming where; `null` is admitted for any property, and an absent one stays absent.
+ */
+export function project(payload, properties, path = '') {
+    const projected = {};
+    for (const [name, property] of Object.entries(properties)) {
+        const value = payload[name];
+        if (value === undefined)
+            continue;
+        projected[name] = fit(value, property, path === '' ? name : `${path}.${name}`);
+    }
+    return projected;
+}
+function fit(value, property, path) {
+    if (value === null)
+        return null;
+    switch (property.type) {
+        case 'string':
+            if (typeof value !== 'string')
+                throw new Mismatch(path, property);
+            if (property.enum !== undefined && !property.enum.includes(value))
+                throw new Mismatch(path, property);
+            return value;
+        case 'integer':
+            if (!Number.isInteger(value))
+                throw new Mismatch(path, property);
+            return value;
+        case 'number':
+            if (typeof value !== 'number' || !Number.isFinite(value))
+                throw new Mismatch(path, property);
+            return value;
+        case 'boolean':
+            if (typeof value !== 'boolean')
+                throw new Mismatch(path, property);
+            return value;
+        case 'object':
+            if (typeof value !== 'object' || Array.isArray(value))
+                throw new Mismatch(path, property);
+            return project(value, property.properties ?? {}, path);
+        case 'array':
+            if (!Array.isArray(value))
+                throw new Mismatch(path, property);
+            return value.map((item, index) => fit(item, property.items, `${path}[${index}]`));
+    }
+}
+/** A payload's value at `path` is not of the type its contract declares. */
+export class Mismatch extends Error {
+    path;
+    constructor(path, property) {
+        super(property.enum === undefined
+            ? `'${path}' is not of the type '${property.type}'`
+            : `'${path}' is not one of ${property.enum.map((value) => `'${value}'`).join(', ')}`);
+        this.path = path;
+    }
+}
+//# sourceMappingURL=contract.js.map

package/transpiled/contract.js.map

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

package/transpiled/index.d.ts

@@ -0,0 +1,15 @@
+export { Factory } from './Factory.ts';
+/** `context.chronicles` of a component that declares `chronicles`. */
+export interface Chronicles {
+    /**
+     * Writes a fact that changes no state to the log, under `<component>.<name>`, of which what the
+     * component declares of it is written. Resolves once the broker has it; nothing retries it.
+     * Throws for a name the component does not declare, or a payload its declaration does not admit.
+     */
+    send(name: string, payload?: object, options?: Options): Promise<void>;
+}
+/** What a fact is said to be of: the operation knows whose it is, the extension does not. */
+export interface Options {
+    /** the identity the fact is of */
+    identity?: string;
+}

package/transpiled/index.js

@@ -0,0 +1,2 @@
+export { Factory } from './Factory.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,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/settings.d.ts

@@ -0,0 +1,13 @@
+import type { Settings } from '@toa.io/definitions/extensions.chronicles';
+/** Where the log is published and read, and what it is kept of, as the service is deployed with them. */
+export declare function settings(): Settings;
+/** The users of the broker the rows are published to, and of the store they are read from. */
+export declare function credentials(): Credentials;
+export interface Credentials {
+    broker: User;
+    store: User;
+}
+export interface User {
+    username: string;
+    password: string;
+}

package/transpiled/settings.js

@@ -0,0 +1,48 @@
+import { environment } from '@toa.io/generic';
+import { KEYS, SETTINGS } from '@toa.io/definitions/extensions.chronicles';
+/** Where the log is published and read, and what it is kept of, as the service is deployed with them. */
+export function settings() {
+    const value = environment.get(SETTINGS);
+    if (value !== undefined)
+        return JSON.parse(value);
+    if (dev())
+        return DEV;
+    throw new Error(`${SETTINGS} is not set, so nothing says where the log is kept.`);
+}
+/** The users of the broker the rows are published to, and of the store they are read from. */
+export function credentials() {
+    const [brokerUsername, brokerPassword, storeUsername, storePassword] = KEYS.map((key) => environment.get(`${SETTINGS}_${key.toUpperCase()}`));
+    if (brokerUsername !== undefined &&
+        brokerPassword !== undefined &&
+        storeUsername !== undefined &&
+        storePassword !== undefined)
+        return {
+            broker: { username: brokerUsername, password: brokerPassword },
+            store: { username: storeUsername, password: storePassword }
+        };
+    // the development stack's broker, and the context's user of its store, as the reference setup
+    // makes one
+    if (dev())
+        return {
+            broker: { username: 'developer', password: 'secret' },
+            store: { username: environment.scope(), password: 'secret' }
+        };
+    throw new Error(`${SETTINGS}_{${KEYS.join(',').toUpperCase()}} are not all set.`);
+}
+function dev() {
+    return environment.get('TOA_DEV') === '1';
+}
+// Toa's own development stack is not on the conventional ports, which the applications built on
+// Toa are on. See CONTRIBUTING.md.
+const DEV = {
+    broker: 'amqp://localhost:31010',
+    store: { provider: 'clickhouse', url: 'http://localhost:31030' },
+    encounters: true,
+    ip: 'truncated',
+    events: {},
+    states: {},
+    facts: {},
+    identities: {},
+    timestamps: {}
+};
+//# sourceMappingURL=settings.js.map

package/transpiled/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../source/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAA;AAG1E,yGAAyG;AACzG,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEvC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAa,CAAA;IAE7D,IAAI,GAAG,EAAE;QAAE,OAAO,GAAG,CAAA;IAErB,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,qDAAqD,CAAC,CAAA;AACnF,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACtF,WAAW,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CACpD,CAAA;IAED,IACE,cAAc,KAAK,SAAS;QAC5B,cAAc,KAAK,SAAS;QAC5B,aAAa,KAAK,SAAS;QAC3B,aAAa,KAAK,SAAS;QAE3B,OAAO;YACL,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE;YAC9D,KAAK,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE;SAC5D,CAAA;IAEH,8FAA8F;IAC9F,YAAY;IACZ,IAAI,GAAG,EAAE;QACP,OAAO;YACL,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE;YACrD,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAC7D,CAAA;IAEH,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAA;AACnF,CAAC;AAYD,SAAS,GAAG;IACV,OAAO,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CAAA;AAC3C,CAAC;AAED,gGAAgG;AAChG,mCAAmC;AACnC,MAAM,GAAG,GAAa;IACpB,MAAM,EAAE,wBAAwB;IAChC,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,wBAAwB,EAAE;IAChE,UAAU,EAAE,IAAI;IAChB,EAAE,EAAE,WAAW;IACf,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;CACf,CAAA"}

package/transpiled/store.d.ts

@@ -0,0 +1,5 @@
+import type { Provider } from './Provider.ts';
+import type { User } from './settings.ts';
+import type { Settings } from '@toa.io/definitions/extensions.chronicles';
+/** The provider the annotation names, read as the context's user of it. */
+export declare function provider(settings: Settings, user: User, scope: string): Provider;

package/transpiled/store.js

@@ -0,0 +1,11 @@
+import { ClickHouseProvider } from './clickhouse/Provider.js';
+/** The provider the annotation names, read as the context's user of it. */
+export function provider(settings, user, scope) {
+    switch (settings.store.provider) {
+        case 'clickhouse':
+            return new ClickHouseProvider(settings.store.url, user, scope);
+        default:
+            throw new Error(`Chronicles have no store '${String(settings.store.provider)}'`);
+    }
+}
+//# sourceMappingURL=store.js.map

package/transpiled/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../source/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAK7D,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,IAAU,EAAE,KAAa;IACpE,QAAQ,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,YAAY;YACf,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QAChE;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IACpF,CAAC;AACH,CAAC"}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.