@toa.io/extensions.chronicles 1.0.0-alpha.332 → 1.0.0-alpha.335

package/transpiled/Recorder.d.ts

@@ -1,28 +1,38 @@
 import { Connector } from '@toa.io/core';
-import type { Writer } from './Writer.ts';
+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 names
- * under `events`, and a state for the one it names its `state`. A message carries what the event
- * rendered and its id, so what is said of the entity — which, its version, when — is read from
- * the payload, where the entity as it stands carries `id`, `VERSION` and `UPDATED`.
+ * 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 identity;
-    private readonly writer;
-    /** `identity` is the property of the payload that names whose a row is, where the component has one */
-    constructor(label: string, kind: Kind, identity: string | null, writer: Writer);
+    private readonly of;
+    private readonly publisher;
+    constructor(label: string, kind: Kind, of: Of, publisher: Publisher);
     receive(message: Message): Promise<void>;
 }
-export declare function row(label: string, component: string, message: Message, identity?: string | null): Row;
+/** 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, identity?: string | null): State;
+export declare function state(label: string, component: string, message: Message, of: Of): State;
 export type Kind = 'event' | 'state';

package/transpiled/Recorder.js

@@ -1,50 +1,50 @@
 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 names
- * under `events`, and a state for the one it names its `state`. A message carries what the event
- * rendered and its id, so what is said of the entity — which, its version, when — is read from
- * the payload, where the entity as it stands carries `id`, `VERSION` and `UPDATED`.
+ * 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;
-    identity;
-    writer;
-    /** `identity` is the property of the payload that names whose a row is, where the component has one */
+    of;
+    publisher;
     // eslint-disable-next-line max-params
-    constructor(label, kind, identity, writer) {
+    constructor(label, kind, of, publisher) {
         super();
         this.label = label;
         this.component = label.slice(0, label.lastIndexOf('.'));
         this.kind = kind;
-        this.identity = identity;
-        this.writer = writer;
+        this.of = of;
+        this.publisher = publisher;
     }
     async receive(message) {
         if (this.kind === 'state')
-            await this.writer.write([], [state(this.label, this.component, message, this.identity)]);
+            await this.publisher.publish([], [state(this.label, this.component, message, this.of)]);
         else
-            await this.writer.write([row(this.label, this.component, message, this.identity)]);
+            await this.publisher.publish([row(this.label, this.component, message, this.of)]);
     }
 }
 // eslint-disable-next-line max-params
-export function row(label, component, message, identity = null) {
+export function row(label, component, message, of) {
     const payload = object(message.payload);
-    const { id, VERSION, UPDATED } = 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: typeof UPDATED === 'number' ? UPDATED : Date.now(),
+        time: when(payload, message, of.timestamp),
         entity: typeof id === 'string' ? id : null,
         version: typeof VERSION === 'number' ? VERSION : null,
-        identity: whose(payload, identity),
-        ip: null,
-        country: null,
+        identity: whose(payload, of.identity),
         trace: message.telemetry ?? null,
-        payload
+        payload: declared(label, payload, of.contract)
     };
 }
 /**
@@ -53,20 +53,45 @@ export function row(label, component, message, identity = null) {
  * 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, identity = null) {
+export function state(label, component, message, of) {
     const payload = object(message.payload);
-    const { id, VERSION, UPDATED } = 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, identity),
-        time: typeof UPDATED === 'number' ? UPDATED : Date.now(),
-        payload
+        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)

package/transpiled/Recorder.js.map

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

@@ -1,21 +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>`. 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.
+ * `<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?;
-    constructor(host: extensions.Host, locator: Locator);
+    /** `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 facts;
+    private recorder;
 }

package/transpiled/Sender.js

@@ -1,20 +1,25 @@
 import { current, encode } from 'openspan';
 import { Connector, Locator, entities, exceptions } from '@toa.io/core';
-import { FACTS, NAMESPACE } from '@toa.io/definitions/extensions.chronicles';
+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>`. 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.
+ * `<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;
-    constructor(host, locator) {
+    /** `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
@@ -29,6 +34,9 @@ export class Sender extends Connector {
         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(),
@@ -38,19 +46,17 @@ export class Sender extends Connector {
             entity: null,
             version: null,
             identity: typeof options?.identity === 'string' ? options.identity : null,
-            ip: null,
-            country: null,
             trace: context === undefined ? null : encode(context),
-            payload: payload ?? {}
+            payload: declared(name, payload ?? {}, contract)
         };
-        const remote = await this.facts();
+        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 facts() {
+    async recorder() {
         this.remote ??= (async () => {
             const remote = await this.host.remote(LOCATOR, SOURCE);
             this.depends(remote);
@@ -63,7 +69,18 @@ export class Sender extends Connector {
         return await this.remote;
     }
 }
-const LOCATOR = new Locator(FACTS, NAMESPACE);
+/** 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

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

@@ -3,22 +3,19 @@
  * needs of it is a statement and its answer.
  */
 export declare class ClickHouse {
-    readonly database: string;
     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. `database` is the one it runs in, where that
-     * is not this client's: `''` for a statement that must run before the database exists.
-     */
-    run(sql: string, settings?: Record<string, string>, database?: string): Promise<void>;
+    /** 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 database itself. */
-    rows<T = Record<string, unknown>>(sql: string): Promise<T[]>;
+    /** 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 {

package/transpiled/clickhouse/Client.js

@@ -3,21 +3,17 @@
  * needs of it is a statement and its answer.
  */
 export class ClickHouse {
-    database;
     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.database = decodeURIComponent(url.pathname.replace(/^\/+|\/+$/g, ''));
         this.endpoint = `${url.protocol}//${url.host}/`;
         this.headers = { 'x-clickhouse-user': user, 'x-clickhouse-key': key };
     }
-    /**
-     * A statement that answers nothing worth reading. `database` is the one it runs in, where that
-     * is not this client's: `''` for a statement that must run before the database exists.
-     */
-    async run(sql, settings = {}, database = this.database) {
-        await this.request(sql, settings, database);
+    /** 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
@@ -27,15 +23,17 @@ export class ClickHouse {
         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 database itself. */
-    async rows(sql) {
-        const text = await this.request(sql, { ...NUMBERS, default_format: 'JSON' });
+    /** 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, database = this.database) {
+    async request(sql, settings) {
         const search = new URLSearchParams(settings);
-        if (database !== '')
-            search.set('database', database);
         const response = await fetch(`${this.endpoint}?${search.toString()}`, {
             method: 'POST',
             headers: this.headers,