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

package/transpiled/Provider.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Where the log is kept. A provider holds the log's two tables — `events`, a row for everything
+ * that happened, and `states`, each entity as it stands — and reads them in a dialect of its own,
+ * which is what an agent writes its queries in.
+ */
+export interface Provider {
+    /** what a query is written in, which `describe` tells whoever writes one */
+    readonly dialect: string;
+    /** the names a view cannot take: the provider's own tables */
+    readonly tables: string[];
+    /** the tables, and the reader queries run as, made what the settings say */
+    provision(): Promise<void>;
+    /**
+     * Rows of `events`, written once however often a row of one `id` is written; and states, each
+     * kept where it is of a higher version than the one there.
+     */
+    write(rows: Row[], states: State[]): Promise<void>;
+    /** the labels, with their counts, their times and the fields of their payloads */
+    labels(): Promise<Label[]>;
+    /** the components with a state, with how many entities each has and the fields of the state */
+    states(): Promise<Summary[]>;
+    /** a statement of the dialect, run as a reader that can read the log and nothing else */
+    query(sql: string): Promise<Result>;
+    /** refuses what a view could not be: anything but one statement a query could run */
+    validate(sql: string): Promise<void>;
+    views(): Promise<View[]>;
+    /** a view of `name`, replacing one there is; with `refresh`, recomputed on that cycle */
+    define(name: string, sql: string, refresh?: number): Promise<void>;
+    drop(name: string): Promise<void>;
+}
+/** A row of the log. */
+export interface Row {
+    /** the same however many times it is delivered */
+    id: string;
+    /** `<component>.<event>`, `<component>.<name>` for a fact, `agent.<name>` for a browser */
+    label: string;
+    /** the component it is of */
+    component: string;
+    /** when it happened, in milliseconds */
+    time: number;
+    /** the id of the record that changed, where the payload carries one */
+    entity: string | null;
+    /** its `VERSION`, likewise */
+    version: number | null;
+    /** the identity it is of, where something says so */
+    identity: string | null;
+    /** the address and the country of the browser that sent it, where one did */
+    ip: string | null;
+    country: string | null;
+    /** the W3C traceparent of the call that caused it */
+    trace: string | null;
+    payload: object;
+}
+/** An entity as it stands, as the event a component names its `state` renders it. */
+export interface State {
+    component: string;
+    entity: string;
+    version: number;
+    identity: string | null;
+    time: number;
+    payload: object;
+}
+export interface Summary {
+    component: string;
+    entities: number;
+    paths: string[];
+}
+export interface Label {
+    label: string;
+    rows: number;
+    first: string;
+    last: string;
+    paths: string[];
+}
+export interface View {
+    name: string;
+    sql: string;
+    /** seconds between computations of a view that is a table */
+    refresh?: number;
+}
+export interface Result {
+    columns: Array<{
+        name: string;
+        type: string;
+    }>;
+    rows: unknown[][];
+    truncated: boolean;
+}
+/** What a provider refused a statement with, in its own words. */
+export declare class Refusal extends Error {
+}

package/transpiled/Provider.js

@@ -0,0 +1,4 @@
+/** What a provider refused a statement with, in its own words. */
+export class Refusal extends Error {
+}
+//# sourceMappingURL=Provider.js.map

package/transpiled/Provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../source/Provider.ts"],"names":[],"mappings":"AAgHA,kEAAkE;AAClE,MAAM,OAAO,OAAQ,SAAQ,KAAK;CAAG"}

package/transpiled/Reader.d.ts

@@ -0,0 +1,16 @@
+import { Connector } from '@toa.io/core';
+import type { Provider } from './Provider.ts';
+/**
+ * What `chronicles.queries` reads the log through: queries in the provider's dialect, and views
+ * made from a statement the provider let a query run.
+ */
+export declare class Reader extends Connector {
+    readonly name = "chronicles";
+    private readonly provider;
+    constructor(provider: () => Provider);
+    invoke(method: string, ...args: any[]): Promise<unknown>;
+    private describe;
+    private query;
+    private define;
+    private drop;
+}

package/transpiled/Reader.js

@@ -0,0 +1,82 @@
+import { Connector, exceptions } from '@toa.io/core';
+import { Refusal } from './Provider.js';
+/**
+ * What `chronicles.queries` reads the log through: queries in the provider's dialect, and views
+ * made from a statement the provider let a query run.
+ */
+export class Reader extends Connector {
+    name = 'chronicles';
+    provider;
+    constructor(provider) {
+        super();
+        this.provider = provider;
+    }
+    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], args[1], args[2]);
+            case 'drop':
+                return await this.drop(args[0]);
+            default:
+                throw new exceptions.MisuseException(`Chronicles have no '${method}'`);
+        }
+    }
+    async describe() {
+        const provider = this.provider();
+        return {
+            dialect: provider.dialect,
+            labels: await provider.labels(),
+            states: await provider.states(),
+            views: await provider.views()
+        };
+    }
+    async query(sql) {
+        return await refused(async () => await this.provider().query(statement(sql)));
+    }
+    async define(name, sql, refresh) {
+        const provider = this.provider();
+        if (provider.tables.includes(name))
+            return new Error('RESERVED', {
+                cause: { message: `'${name}' is a table of the log` }
+            });
+        const select = statement(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(name, select, refresh));
+        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;
+    }
+}
+/** 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 MAX_VIEWS = 50;
+//# sourceMappingURL=Reader.js.map

package/transpiled/Reader.js.map

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

package/transpiled/Recorder.d.ts

@@ -0,0 +1,28 @@
+import { Connector } from '@toa.io/core';
+import type { Writer } from './Writer.ts';
+import type { Row, State } from './Provider.ts';
+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`.
+ */
+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);
+    receive(message: Message): Promise<void>;
+}
+export declare function row(label: string, component: string, message: Message, identity?: string | null): 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 type Kind = 'event' | 'state';

package/transpiled/Recorder.js

@@ -0,0 +1,82 @@
+import { Connector, entities, exceptions } from '@toa.io/core';
+/**
+ * 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`.
+ */
+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 */
+    // eslint-disable-next-line max-params
+    constructor(label, kind, identity, writer) {
+        super();
+        this.label = label;
+        this.component = label.slice(0, label.lastIndexOf('.'));
+        this.kind = kind;
+        this.identity = identity;
+        this.writer = writer;
+    }
+    async receive(message) {
+        if (this.kind === 'state')
+            await this.writer.write([], [state(this.label, this.component, message, this.identity)]);
+        else
+            await this.writer.write([row(this.label, this.component, message, this.identity)]);
+    }
+}
+// eslint-disable-next-line max-params
+export function row(label, component, message, identity = null) {
+    const payload = object(message.payload);
+    const { id, VERSION, UPDATED } = 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(),
+        entity: typeof id === 'string' ? id : null,
+        version: typeof VERSION === 'number' ? VERSION : null,
+        identity: whose(payload, identity),
+        ip: null,
+        country: null,
+        trace: message.telemetry ?? null,
+        payload
+    };
+}
+/**
+ * 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, identity = null) {
+    const payload = object(message.payload);
+    const { id, VERSION, UPDATED } = 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
+    };
+}
+/** 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/Scribe.d.ts

@@ -0,0 +1,25 @@
+import { Connector } from '@toa.io/core';
+import type { Provider } from './Provider.ts';
+import type { Writer } from './Writer.ts';
+import type { Settings } from '@toa.io/definitions/extensions.chronicles';
+import type { extensions } from '@toa.io/core/types';
+/**
+ * The extension's own service: the store provisioned, then a consumer of every event the log is
+ * kept of — one group for every replica, so each event is written once — and the components it
+ * ships: the queries, the facts, and the client route where the annotation asks for it.
+ */
+export declare class Scribe extends Connector {
+    private readonly host;
+    private readonly settings;
+    private readonly provider;
+    private readonly writer;
+    constructor(host: extensions.Host, settings: Settings, provider: Provider, writer: Writer);
+    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/Scribe.js

@@ -0,0 +1,61 @@
+import { readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Connector } from '@toa.io/core';
+import { INGESTION, NAMESPACE, SERVICE } from '@toa.io/definitions/extensions.chronicles';
+import { Recorder } from './Recorder.js';
+/**
+ * The extension's own service: the store provisioned, then a consumer of every event the log is
+ * kept of — one group for every replica, so each event is written once — and the components it
+ * ships: the queries, the facts, and the client route where the annotation asks for it.
+ */
+export class Scribe extends Connector {
+    host;
+    settings;
+    provider;
+    writer;
+    // eslint-disable-next-line max-params
+    constructor(host, settings, provider, writer) {
+        super();
+        this.host = host;
+        this.settings = settings;
+        this.provider = provider;
+        this.writer = writer;
+    }
+    async open() {
+        await this.provider.provision();
+        const consumed = [
+            ...this.settings.events.map((label) => [label, 'event']),
+            ...this.settings.states.map((label) => [label, 'state'])
+        ];
+        for (const [label, kind] 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 component = label.slice(0, label.lastIndexOf('.'));
+            const identity = this.settings.identities[component] ?? null;
+            const recorder = new Recorder(label, kind, identity, this.writer);
+            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 paths(settings) {
+    return components().paths.filter((path) => settings.ingest || !path.endsWith(`${NAMESPACE}.${INGESTION}`));
+}
+const ROOT = resolve(import.meta.dirname, '../components/');
+const GROUP = `${NAMESPACE}.${SERVICE}`;
+//# sourceMappingURL=Scribe.js.map

package/transpiled/Scribe.js.map

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

package/transpiled/Sender.d.ts

@@ -0,0 +1,21 @@
+import { Connector, Locator } from '@toa.io/core';
+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.
+ */
+export declare class Sender extends Connector {
+    readonly name = "chronicles";
+    private readonly host;
+    private readonly locator;
+    private remote?;
+    constructor(host: extensions.Host, locator: Locator);
+    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;
+}

package/transpiled/Sender.js

@@ -0,0 +1,69 @@
+import { current, encode } from 'openspan';
+import { Connector, Locator, entities, exceptions } from '@toa.io/core';
+import { FACTS, NAMESPACE } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * `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.
+ */
+export class Sender extends Connector {
+    name = 'chronicles';
+    host;
+    locator;
+    remote;
+    constructor(host, locator) {
+        super();
+        this.host = host;
+        this.locator = locator;
+    }
+    // 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 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,
+            ip: null,
+            country: null,
+            trace: context === undefined ? null : encode(context),
+            payload: payload ?? {}
+        };
+        const remote = await this.facts();
+        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() {
+        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;
+    }
+}
+const LOCATOR = new Locator(FACTS, 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/Writer.d.ts

@@ -0,0 +1,14 @@
+import type { Provider, Row, State } from './Provider.ts';
+/**
+ * Rows to the provider in batches: what arrives within a moment, or until a batch is full, is
+ * one write. Each caller is answered when the write its rows went in is, so a delivery is
+ * acknowledged once what it carried is kept, and is delivered again where it was not.
+ */
+export declare class Writer {
+    private readonly provider;
+    private pending;
+    constructor(provider: Provider);
+    write(rows: Row[], states?: State[]): Promise<void>;
+    private open;
+    private flush;
+}

package/transpiled/Writer.js

@@ -0,0 +1,50 @@
+import { console } from 'openspan';
+/**
+ * Rows to the provider in batches: what arrives within a moment, or until a batch is full, is
+ * one write. Each caller is answered when the write its rows went in is, so a delivery is
+ * acknowledged once what it carried is kept, and is delivered again where it was not.
+ */
+export class Writer {
+    provider;
+    pending = null;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async write(rows, states = []) {
+        const batch = (this.pending ??= this.open());
+        batch.rows.push(...rows);
+        batch.states.push(...states);
+        if (batch.rows.length + batch.states.length >= SIZE)
+            this.flush(batch);
+        await batch.written;
+    }
+    open() {
+        let settle;
+        const written = new Promise((resolve, reject) => {
+            settle = (error) => (error === undefined ? resolve() : reject(error));
+        });
+        const batch = { rows: [], states: [], written, settle, timer: null };
+        batch.timer = setTimeout(() => this.flush(batch), WAIT);
+        return batch;
+    }
+    flush(batch) {
+        if (this.pending === batch)
+            this.pending = null;
+        if (batch.timer === null)
+            return;
+        clearTimeout(batch.timer);
+        batch.timer = null;
+        this.provider.write(batch.rows, batch.states).then(() => batch.settle(), (error) => {
+            console.warn('Chronicles failed to write', {
+                rows: batch.rows.length,
+                states: batch.states.length,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            batch.settle(error);
+        });
+    }
+}
+/** rows that make a batch full, and milliseconds a batch waits for more */
+const SIZE = 1000;
+const WAIT = 500;
+//# sourceMappingURL=Writer.js.map

package/transpiled/Writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Writer.js","sourceRoot":"","sources":["../source/Writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAGlC;;;;GAIG;AACH,MAAM,OAAO,MAAM;IACA,QAAQ,CAAU;IAC3B,OAAO,GAAiB,IAAI,CAAA;IAEpC,YAAmB,QAAkB;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAW,EAAE,MAAM,GAAY,EAAE;QAClD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAE5C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACxB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QAE5B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAEtE,MAAM,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IAEO,IAAI;QACV,IAAI,MAAkC,CAAA;QAEtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpD,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACvE,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QAE3E,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;QAEvD,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,KAAK,CAAC,KAAY;QACxB,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QAE/C,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;YAAE,OAAM;QAEhC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACzB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;QAElB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAChD,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EACpB,CAAC,KAAc,EAAE,EAAE;YACjB,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE;gBACzC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;gBACvB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAA;YAEF,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC,CACF,CAAA;IACH,CAAC;CACF;AAUD,2EAA2E;AAC3E,MAAM,IAAI,GAAG,IAAI,CAAA;AACjB,MAAM,IAAI,GAAG,GAAG,CAAA"}

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"}