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

package/transpiled/Sender.js

@@ -0,0 +1,86 @@
+import { current, encode } from 'openspan';
+import { Connector, Locator, entities, exceptions } from '@toa.io/core';
+import { NAMESPACE, RELAY } from '@toa.io/definitions/extensions.chronicles';
+import { Mismatch, project } from './contract.js';
+/**
+ * `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 class Sender extends Connector {
+    name = 'chronicles';
+    host;
+    locator;
+    facts;
+    remote;
+    /** `facts` are the contracts of the facts the component declares, by name */
+    constructor(host, locator, facts) {
+        super();
+        this.host = host;
+        this.locator = locator;
+        this.facts = facts;
+    }
+    // named rather than forwarded, so that the connector's lifecycle is not reachable from an
+    // algorithm
+    async invoke(method, ...args) {
+        if (method !== 'send')
+            throw new exceptions.MisuseException(`Chronicles have no '${method}'`);
+        await this.send(args[0], args[1], args[2]);
+    }
+    async send(name, payload, options) {
+        if (typeof name !== 'string' || !NAME.test(name))
+            throw new exceptions.MisuseException(`A chronicle is named by segments of letters and digits separated by dots, not '${String(name)}'`);
+        if (payload !== undefined &&
+            (typeof payload !== 'object' || payload === null || Array.isArray(payload)))
+            throw new exceptions.MisuseException('The payload of a chronicle is an object');
+        const contract = this.facts[name];
+        if (contract === undefined)
+            throw new exceptions.MisuseException(`'${this.locator.id}' declares no fact '${name}'`);
+        const context = current();
+        const row = {
+            id: entities.newid(),
+            label: `${this.locator.id}.${name}`,
+            component: this.locator.id,
+            time: Date.now(),
+            entity: null,
+            version: null,
+            identity: typeof options?.identity === 'string' ? options.identity : null,
+            trace: context === undefined ? null : encode(context),
+            payload: declared(name, payload ?? {}, contract)
+        };
+        const remote = await this.recorder();
+        await remote.invoke('record', { input: row, task: true });
+    }
+    /**
+     * 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.
+     */
+    async recorder() {
+        this.remote ??= (async () => {
+            const remote = await this.host.remote(LOCATOR, SOURCE);
+            this.depends(remote);
+            await remote.connect();
+            return remote;
+        })().catch((error) => {
+            this.remote = undefined;
+            throw error;
+        });
+        return await this.remote;
+    }
+}
+/** What the contract declares of the payload of a fact; one it does not admit is not sent. */
+function declared(name, payload, contract) {
+    try {
+        return project(payload, contract.properties);
+    }
+    catch (exception) {
+        if (exception instanceof Mismatch)
+            throw new exceptions.MisuseException(`The fact '${name}' is not what its chronicles declare: ${exception.message}`);
+        throw exception;
+    }
+}
+const LOCATOR = new Locator(RELAY, NAMESPACE);
+const SOURCE = { service: 'chronicles' };
+const NAME = /^[a-zA-Z][a-zA-Z0-9]*(\.[a-zA-Z][a-zA-Z0-9]*)*$/;
+//# sourceMappingURL=Sender.js.map

package/transpiled/Sender.js.map

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

package/transpiled/Service.d.ts

@@ -0,0 +1,26 @@
+import { Connector } from '@toa.io/core';
+import type { Publisher } from './Publisher.ts';
+import type { Settings } from '@toa.io/definitions/extensions.chronicles';
+import type { extensions } from '@toa.io/core/types';
+/**
+ * The extension's own service: a consumer of every event the log is kept of — one group for every
+ * replica, so each event is published once — and the components it ships: the queries, the relay,
+ * and the encounters where the annotation asks for them. Nothing of it waits for the broker the
+ * rows are published to.
+ */
+export declare class Service extends Connector {
+    private readonly host;
+    private readonly settings;
+    private readonly publisher;
+    constructor(host: extensions.Host, settings: Settings, publisher: Publisher);
+    /** first of all, so what waits for the broker of the log holds up none of what closes after */
+    protected close(): Promise<void>;
+    protected open(): Promise<void>;
+}
+/** The components this extension ships, which run inside its own service. */
+export declare function components(): Components;
+interface Components {
+    labels: string[];
+    paths: string[];
+}
+export {};

package/transpiled/Service.js

@@ -0,0 +1,70 @@
+import { readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Connector } from '@toa.io/core';
+import { ENCOUNTERS, NAMESPACE, SERVICE } from '@toa.io/definitions/extensions.chronicles';
+import { Recorder } from './Recorder.js';
+/**
+ * The extension's own service: a consumer of every event the log is kept of — one group for every
+ * replica, so each event is published once — and the components it ships: the queries, the relay,
+ * and the encounters where the annotation asks for them. Nothing of it waits for the broker the
+ * rows are published to.
+ */
+export class Service extends Connector {
+    host;
+    settings;
+    publisher;
+    // eslint-disable-next-line max-params
+    constructor(host, settings, publisher) {
+        super();
+        this.host = host;
+        this.settings = settings;
+        this.publisher = publisher;
+        this.depends(publisher);
+    }
+    /** first of all, so what waits for the broker of the log holds up none of what closes after */
+    async close() {
+        this.publisher.stop();
+    }
+    async open() {
+        const consumed = [
+            ...Object.entries(this.settings.events).map(([label, contract]) => [label, 'event', contract]),
+            ...Object.entries(this.settings.states).map(([label, contract]) => [label, 'state', contract])
+        ];
+        for (const [label, kind, contract] of consumed) {
+            // an event that is both a row and a state is two consumers, each of a group of its own
+            const group = kind === 'state' ? `${GROUP}.states` : GROUP;
+            const of = {
+                contract,
+                identity: this.settings.identities[component(label)] ?? null,
+                timestamp: this.settings.timestamps[component(label)] ?? null
+            };
+            const recorder = new Recorder(label, kind, of, this.publisher);
+            const consumer = await this.host.receive(label, group, recorder);
+            this.depends(consumer);
+            await consumer.connect();
+        }
+        const composition = await this.host.composition(paths(this.settings));
+        this.depends(composition);
+        await composition.connect();
+    }
+}
+/** The components this extension ships, which run inside its own service. */
+export function components() {
+    const labels = [];
+    const paths = [];
+    for (const entry of readdirSync(ROOT, { withFileTypes: true }))
+        if (entry.isDirectory()) {
+            labels.push(entry.name.replace('.', '-'));
+            paths.push(resolve(ROOT, entry.name));
+        }
+    return { labels, paths };
+}
+function component(label) {
+    return label.slice(0, label.lastIndexOf('.'));
+}
+function paths(settings) {
+    return components().paths.filter((path) => settings.encounters || !path.endsWith(`${NAMESPACE}.${ENCOUNTERS}`));
+}
+const ROOT = resolve(import.meta.dirname, '../components/');
+const GROUP = `${NAMESPACE}.${SERVICE}`;
+//# sourceMappingURL=Service.js.map

package/transpiled/Service.js.map

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

package/transpiled/address.d.ts

@@ -0,0 +1,7 @@
+import type { Address } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * How much of a browser's address the log keeps. An address is personal data, and the log erases
+ * nothing, so by default it keeps the network the address is in — a /24 of IPv4, a /48 of IPv6 —
+ * which is as much as a question of where a client is asks for. What is not an address is not kept.
+ */
+export declare function keep(address: unknown, how: Address): string | null;

package/transpiled/address.js

@@ -0,0 +1,27 @@
+import { isIPv4, isIPv6 } from 'node:net';
+/**
+ * How much of a browser's address the log keeps. An address is personal data, and the log erases
+ * nothing, so by default it keeps the network the address is in — a /24 of IPv4, a /48 of IPv6 —
+ * which is as much as a question of where a client is asks for. What is not an address is not kept.
+ */
+export function keep(address, how) {
+    if (typeof address !== 'string')
+        return null;
+    if (isIPv4(address))
+        return how === 'full' ? address : address.replace(/\.\d+$/, '.0');
+    if (isIPv6(address))
+        return how === 'full' ? address : network(address);
+    return null;
+}
+/** The first three groups of an IPv6 address, and none of the rest. */
+function network(address) {
+    const [head, tail = ''] = address.split('::');
+    const left = head === '' ? [] : head.split(':');
+    const right = tail === '' ? [] : tail.split(':');
+    const groups = [...left, ...Array(8 - left.length - right.length).fill('0'), ...right];
+    return (groups
+        .slice(0, 3)
+        .map((group) => group.replace(/^0+(?=.)/, ''))
+        .join(':') + '::');
+}
+//# sourceMappingURL=address.js.map

package/transpiled/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../source/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGzC;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,OAAgB,EAAE,GAAY;IACjD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE5C,IAAI,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAEtF,IAAI,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAEvE,OAAO,IAAI,CAAA;AACb,CAAC;AAED,uEAAuE;AACvE,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAA;IAEtF,OAAO,CACL,MAAM;SACH,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CACpB,CAAA;AACH,CAAC"}

package/transpiled/agent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * What a client is, as its `user-agent` says, in the few words a question of who visits asks for:
+ * the browser, the operating system and the kind of device, by name and without versions — which
+ * browsers freeze or leave out, and which make an agent more of a fingerprint. Each is the first of
+ * its list that matches, so a name another agent copies comes after the one that copies it: Edge
+ * says Chrome and Safari, Chrome says Safari. What matches nothing is `null`.
+ *
+ * Safari on an iPad says it is a Mac, as it has since iPadOS 13, and nothing the request carries
+ * says otherwise: it is a desktop running macOS here.
+ */
+export declare function classify(agent: unknown): Classified;
+export interface Classified {
+    browser: string | null;
+    os: string | null;
+    device: string | null;
+}

package/transpiled/agent.js

@@ -0,0 +1,48 @@
+/**
+ * What a client is, as its `user-agent` says, in the few words a question of who visits asks for:
+ * the browser, the operating system and the kind of device, by name and without versions — which
+ * browsers freeze or leave out, and which make an agent more of a fingerprint. Each is the first of
+ * its list that matches, so a name another agent copies comes after the one that copies it: Edge
+ * says Chrome and Safari, Chrome says Safari. What matches nothing is `null`.
+ *
+ * Safari on an iPad says it is a Mac, as it has since iPadOS 13, and nothing the request carries
+ * says otherwise: it is a desktop running macOS here.
+ */
+export function classify(agent) {
+    if (typeof agent !== 'string' || agent === '')
+        return { browser: null, os: null, device: null };
+    return {
+        browser: first(BROWSERS, agent),
+        os: first(SYSTEMS, agent),
+        device: first(DEVICES, agent) ?? 'desktop'
+    };
+}
+function first(list, agent) {
+    return list.find(([, pattern]) => pattern.test(agent))?.[0] ?? null;
+}
+const BROWSERS = [
+    ['Edge', /\bEdg(e|A|iOS)?\//],
+    ['Opera', /\bOPR\/|\bOPT\/|\bOpera\b/],
+    ['Samsung Internet', /\bSamsungBrowser\//],
+    ['Firefox', /\bFirefox\/|\bFxiOS\//],
+    ['Chrome', /(\b|Headless)Chrome\/|\bCriOS\//],
+    ['Safari', /\bVersion\/[\d.]+.*\bSafari\//]
+];
+const SYSTEMS = [
+    ['Windows', /\bWindows\b/],
+    ['iOS', /\b(iPhone|iPad|iPod)\b/],
+    ['macOS', /\bMac OS X\b|\bMacintosh\b/],
+    ['Android', /\bAndroid\b/],
+    ['ChromeOS', /\bCrOS\b/],
+    ['Linux', /\bLinux\b/]
+];
+// a desktop is what is none of these, so it is not listed
+const DEVICES = [
+    [
+        'bot',
+        /bot\b|crawl|spider|slurp|preview|headless|^curl\/|^wget\/|^python-|^go-http|^okhttp/i
+    ],
+    ['tablet', /\biPad\b|\bTablet\b|\bAndroid\b(?!.*\bMobile\b)/],
+    ['mobile', /\bMobile\b|\biPhone\b|\biPod\b/]
+];
+//# sourceMappingURL=agent.js.map

package/transpiled/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../source/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;QAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAElD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC/B,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,SAAS;KAC3C,CAAA;AACH,CAAC;AAQD,SAAS,KAAK,CAAC,IAA6B,EAAE,KAAa;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACrE,CAAC;AAED,MAAM,QAAQ,GAA4B;IACxC,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAC7B,CAAC,OAAO,EAAE,2BAA2B,CAAC;IACtC,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAC1C,CAAC,SAAS,EAAE,uBAAuB,CAAC;IACpC,CAAC,QAAQ,EAAE,iCAAiC,CAAC;IAC7C,CAAC,QAAQ,EAAE,+BAA+B,CAAC;CAC5C,CAAA;AAED,MAAM,OAAO,GAA4B;IACvC,CAAC,SAAS,EAAE,aAAa,CAAC;IAC1B,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACjC,CAAC,OAAO,EAAE,4BAA4B,CAAC;IACvC,CAAC,SAAS,EAAE,aAAa,CAAC;IAC1B,CAAC,UAAU,EAAE,UAAU,CAAC;IACxB,CAAC,OAAO,EAAE,WAAW,CAAC;CACvB,CAAA;AAED,0DAA0D;AAC1D,MAAM,OAAO,GAA4B;IACvC;QACE,KAAK;QACL,sFAAsF;KACvF;IACD,CAAC,QAAQ,EAAE,iDAAiD,CAAC;IAC7D,CAAC,QAAQ,EAAE,gCAAgC,CAAC;CAC7C,CAAA"}

package/transpiled/clickhouse/Client.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ClickHouse over its HTTP interface, as one user: `fetch` and nothing else, because what the log
+ * needs of it is a statement and its answer.
+ */
+export declare class ClickHouse {
+    private readonly endpoint;
+    private readonly headers;
+    /** The statements run in the user's default database, which is what the store gives it to read. */
+    constructor(address: string, user: string, key: string);
+    /** A statement that answers nothing worth reading. */
+    run(sql: string, settings?: Record<string, string>): Promise<void>;
+    /**
+     * A query, answered as `JSONCompact`: the columns, and the rows as arrays. The format is the
+     * default rather than a clause, which a statement like `EXPLAIN` would take as its own.
+     */
+    select(sql: string, settings?: Record<string, string>): Promise<Answer>;
+    /** Each row as an object, for what this extension reads of the store itself. */
+    rows<T = Record<string, unknown>>(sql: string, settings?: Record<string, string>): Promise<T[]>;
+    private request;
+}
+export interface Answer {
+    meta: Array<{
+        name: string;
+        type: string;
+    }>;
+    data: unknown[][];
+    rows: number;
+}
+/** What ClickHouse refused a statement with, as it said it. */
+export declare class ClickHouseError extends Error {
+    readonly status: number;
+    /** ClickHouse's own code, where its message carries one */
+    readonly code: number | undefined;
+    constructor(status: number, message: string);
+}

package/transpiled/clickhouse/Client.js

@@ -0,0 +1,71 @@
+/**
+ * ClickHouse over its HTTP interface, as one user: `fetch` and nothing else, because what the log
+ * needs of it is a statement and its answer.
+ */
+export class ClickHouse {
+    endpoint;
+    headers;
+    /** The statements run in the user's default database, which is what the store gives it to read. */
+    constructor(address, user, key) {
+        const url = new URL(address);
+        this.endpoint = `${url.protocol}//${url.host}/`;
+        this.headers = { 'x-clickhouse-user': user, 'x-clickhouse-key': key };
+    }
+    /** A statement that answers nothing worth reading. */
+    async run(sql, settings = {}) {
+        await this.request(sql, settings);
+    }
+    /**
+     * A query, answered as `JSONCompact`: the columns, and the rows as arrays. The format is the
+     * default rather than a clause, which a statement like `EXPLAIN` would take as its own.
+     */
+    async select(sql, settings = {}) {
+        const text = await this.request(sql, { ...settings, default_format: 'JSONCompact' });
+        return parse(text);
+    }
+    /** Each row as an object, for what this extension reads of the store itself. */
+    async rows(sql, settings = {}) {
+        const text = await this.request(sql, {
+            ...settings,
+            ...NUMBERS,
+            default_format: 'JSON'
+        });
+        return parse(text).data;
+    }
+    async request(sql, settings) {
+        const search = new URLSearchParams(settings);
+        const response = await fetch(`${this.endpoint}?${search.toString()}`, {
+            method: 'POST',
+            headers: this.headers,
+            body: sql
+        });
+        const text = await response.text();
+        if (!response.ok)
+            throw new ClickHouseError(response.status, text.trim());
+        return text;
+    }
+}
+/** What ClickHouse refused a statement with, as it said it. */
+export class ClickHouseError extends Error {
+    status;
+    /** ClickHouse's own code, where its message carries one */
+    code;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        const code = /^Code: (\d+)\./.exec(message)?.[1];
+        this.code = code === undefined ? undefined : Number(code);
+    }
+}
+/** An answer in another format is one the statement asked for itself, with a `FORMAT`. */
+function parse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new ClickHouseError(200, 'The answer is not JSON: a statement leaves `FORMAT` out');
+    }
+}
+/** UInt64 as numbers rather than strings: what this extension reads of them is counts. */
+const NUMBERS = { output_format_json_quote_64bit_integers: '0' };
+//# sourceMappingURL=Client.js.map

package/transpiled/clickhouse/Client.js.map

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

package/transpiled/clickhouse/Provider.d.ts

@@ -0,0 +1,35 @@
+import type { Definition, Encountered, Field, Label, Provider, Result, Summary, View } from '../Provider.ts';
+import type { User } from '../settings.ts';
+import type { Property } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * The log in ClickHouse, read as the context's user of it: `events`, `states` and `encounters` in
+ * the user's default database, which the store lets it read the rows of its scope of, under limits
+ * of its own. A query is asked to be read-only besides; only a view is created, in the database
+ * named after the scope, where the store lets the user create one.
+ *
+ * A view says what it is in its comment, as JSON: the `title` and the `description` it was defined
+ * with.
+ */
+export declare class ClickHouseProvider implements Provider {
+    readonly guide: string;
+    readonly tables: string[];
+    private readonly user;
+    private readonly scope;
+    /** `scope` is the context's, which its views are kept under */
+    constructor(url: string, user: User, scope: string);
+    fields(properties: Record<string, Property>): Field[];
+    states(): Promise<Summary[]>;
+    labels(): Promise<Label[]>;
+    encounters(): Promise<Encountered[]>;
+    /**
+     * One row more than is answered, cut by the `limit` setting — the result's own, outside whatever
+     * the statement says — so a result of the limit exactly reads as whole, and one past it as cut.
+     */
+    query(sql: string): Promise<Result>;
+    validate(sql: string): Promise<void>;
+    views(): Promise<View[]>;
+    define(definition: Definition): Promise<void>;
+    drop(name: string): Promise<void>;
+    private view;
+    private read;
+}

package/transpiled/clickhouse/Provider.js

@@ -0,0 +1,169 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { ClickHouse, ClickHouseError } from './Client.js';
+import * as ddl from './ddl.js';
+import * as views from './views.js';
+import { Refusal } from '../Provider.js';
+/**
+ * The log in ClickHouse, read as the context's user of it: `events`, `states` and `encounters` in
+ * the user's default database, which the store lets it read the rows of its scope of, under limits
+ * of its own. A query is asked to be read-only besides; only a view is created, in the database
+ * named after the scope, where the store lets the user create one.
+ *
+ * A view says what it is in its comment, as JSON: the `title` and the `description` it was defined
+ * with.
+ */
+export class ClickHouseProvider {
+    guide = GUIDE;
+    tables = ddl.TABLES;
+    user;
+    scope;
+    /** `scope` is the context's, which its views are kept under */
+    constructor(url, user, scope) {
+        this.user = new ClickHouse(url, user.username, user.password);
+        this.scope = scope;
+    }
+    fields(properties) {
+        return views.fields(properties);
+    }
+    async states() {
+        return await this.read(`SELECT component, uniqExact(entity) AS entities, toString(max(time)) AS last
+      FROM states GROUP BY component ORDER BY component`);
+    }
+    async labels() {
+        return await this.read(`SELECT label, count() AS rows, toString(min(time)) AS first, toString(max(time)) AS last
+      FROM events GROUP BY label ORDER BY label`);
+    }
+    async encounters() {
+        const names = await this.read(`SELECT name, count() AS rows, toString(min(time)) AS first, toString(max(time)) AS last,
+        toString(max(received)) AS received
+      FROM encounters GROUP BY name ORDER BY name`);
+        // the fields of the latest payloads of each name, as they were sent: two types of one path
+        // are two clients that disagree
+        const fields = await this.read(`SELECT name, path, arraySort(groupUniqArray(type)) AS types
+      FROM (
+        SELECT name, typed.1 AS path, typed.2 AS type
+        FROM (SELECT name, payload FROM encounters ORDER BY received DESC LIMIT ${SAMPLE} BY name)
+        ARRAY JOIN arrayZip(
+          mapKeys(JSONAllPathsWithTypes(payload)),
+          mapValues(JSONAllPathsWithTypes(payload))
+        ) AS typed
+      )
+      GROUP BY name, path ORDER BY name, path`);
+        return names.map((encountered) => ({
+            ...encountered,
+            fields: fields
+                .filter(({ name }) => name === encountered.name)
+                .map(({ path, types }) => ({ path, types }))
+        }));
+    }
+    /**
+     * One row more than is answered, cut by the `limit` setting — the result's own, outside whatever
+     * the statement says — so a result of the limit exactly reads as whole, and one past it as cut.
+     */
+    async query(sql) {
+        const settings = { ...READONLY, ...NUMBERS, limit: String(ddl.LIMITS.rows + 1) };
+        const answer = await refusing(async () => await this.user.select(sql, settings));
+        return {
+            columns: answer.meta,
+            rows: answer.data.slice(0, ddl.LIMITS.rows),
+            truncated: answer.data.length > ddl.LIMITS.rows
+        };
+    }
+    // parsed and planned as the user, which is what refuses a view that reads what a query could not
+    async validate(sql) {
+        await refusing(async () => {
+            const [ast] = await this.read(`EXPLAIN AST ${sql}`);
+            if (!ast.explain.startsWith('SelectWithUnionQuery'))
+                throw new Refusal('A view is one SELECT');
+            await this.user.run(`EXPLAIN PLAN ${sql}`, READONLY);
+        });
+    }
+    async views() {
+        const tables = await this.read(`SELECT name, as_select, create_table_query, comment FROM system.tables
+      WHERE database = ${ddl.literal(this.scope)} AND NOT startsWith(name, '.inner')
+      ORDER BY name`);
+        const refreshes = await this.read(`SELECT view, toString(last_success_time) AS refreshed FROM system.view_refreshes
+      WHERE database = ${ddl.literal(this.scope)} AND last_success_time IS NOT NULL`);
+        const refreshed = new Map(refreshes.map(({ view, refreshed }) => [view, refreshed]));
+        return tables.map((table) => {
+            const { title, description } = said(table.comment);
+            const view = {
+                name: table.name,
+                read: `${ddl.id(this.scope)}.${ddl.id(table.name)}`,
+                sql: table.as_select
+            };
+            if (title !== undefined)
+                view.title = title;
+            if (description !== undefined)
+                view.description = description;
+            // stated in seconds, and kept in the largest unit that divides them
+            const every = /REFRESH EVERY (\d+) (SECOND|MINUTE|HOUR|DAY|WEEK)/.exec(table.create_table_query);
+            if (every !== null) {
+                view.refresh = Number(every[1]) * UNITS[every[2]];
+                const at = refreshed.get(table.name);
+                if (at !== undefined)
+                    view.refreshed = at;
+            }
+            return view;
+        });
+    }
+    // the comment is on a line of its own: a statement that ends in a comment of its own would
+    // take it in otherwise
+    async define(definition) {
+        const { name, sql, refresh, title, description } = definition;
+        const comment = ddl.literal(JSON.stringify({ title, description }));
+        const view = this.view(name);
+        await refusing(async () => {
+            await this.user.run(`DROP TABLE IF EXISTS ${view} SYNC`);
+            if (refresh === undefined)
+                await this.user.run(`CREATE VIEW ${view} SQL SECURITY INVOKER AS ${sql}\nCOMMENT ${comment}`);
+            else
+                await this.user.run(`CREATE MATERIALIZED VIEW ${view} REFRESH EVERY ${refresh} SECOND
+          ENGINE = MergeTree ORDER BY tuple() AS ${sql}\nCOMMENT ${comment}`);
+        });
+    }
+    async drop(name) {
+        await refusing(async () => await this.user.run(`DROP TABLE IF EXISTS ${this.view(name)} SYNC`));
+    }
+    view(name) {
+        return `${ddl.id(this.scope)}.${ddl.id(name)}`;
+    }
+    async read(sql) {
+        return await this.user.rows(sql, READONLY);
+    }
+}
+/** What ClickHouse refused is the provider's refusal, in ClickHouse's words. */
+async function refusing(fn) {
+    try {
+        return await fn();
+    }
+    catch (exception) {
+        if (exception instanceof ClickHouseError)
+            throw new Refusal(exception.message);
+        throw exception;
+    }
+}
+/** What a view's comment says of it; nothing, of one made otherwise. */
+function said(comment) {
+    try {
+        const parsed = JSON.parse(comment);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+const UNITS = {
+    SECOND: 1,
+    MINUTE: 60,
+    HOUR: 3600,
+    DAY: 86400,
+    WEEK: 604800
+};
+const SAMPLE = 1000;
+const GUIDE = readFileSync(resolve(import.meta.dirname, '../../guides/clickhouse.md'), 'utf8');
+const NUMBERS = { output_format_json_quote_64bit_integers: '0' };
+/** what a request asks besides its user's rights: to change nothing */
+const READONLY = { readonly: '1' };
+//# sourceMappingURL=Provider.js.map

package/transpiled/clickhouse/Provider.js.map

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