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

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":"AAEA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACrB,OAAe,EACf,UAAoC,EACpC,IAAI,GAAG,EAAE;IAET,MAAM,SAAS,GAA4B,EAAE,CAAA;IAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAA;QAExD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QAEjC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAA;IAChF,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,GAAG,CAAC,KAAc,EAAE,QAAkB,EAAE,IAAY;IAC3D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAE/B,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAEjE,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC/D,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAEpC,OAAO,KAAK,CAAA;QACd,KAAK,SAAS;YACZ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAEhE,OAAO,KAAK,CAAA;QACd,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACtD,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAEpC,OAAO,KAAK,CAAA;QACd,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAElE,OAAO,KAAK,CAAA;QACd,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACnD,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAEpC,OAAO,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;QACxD,KAAK,OAAO;YACV,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAE7D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAM,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAA;IACtF,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,IAAI,CAAQ;IAE5B,YAAmB,IAAY,EAAE,QAAkB;QACjD,KAAK,CACH,QAAQ,CAAC,IAAI,KAAK,SAAS;YACzB,CAAC,CAAC,IAAI,IAAI,yBAAyB,QAAQ,CAAC,IAAI,GAAG;YACnD,CAAC,CAAC,IAAI,IAAI,mBAAmB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvF,CAAA;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/transpiled/index.d.ts

@@ -2,8 +2,14 @@ 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>`. Resolves once the
-     * broker has it; nothing retries it.
+     * 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): Promise<void>;
+    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/settings.d.ts

@@ -1,11 +1,13 @@
 import type { Settings } from '@toa.io/definitions/extensions.chronicles';
-/** Where the log is kept and what it is kept of, as the service is deployed with them. */
+/** 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 user the store is provisioned as, and the password of the reader it creates. */
+/** 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;
-    /** the password of the reader */
-    reader: string;
 }

package/transpiled/settings.js

@@ -1,6 +1,6 @@
 import { environment } from '@toa.io/generic';
-import { SETTINGS } from '@toa.io/definitions/extensions.chronicles';
-/** Where the log is kept and what it is kept of, as the service is deployed with them. */
+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)
@@ -9,27 +9,40 @@ export function settings() {
         return DEV;
     throw new Error(`${SETTINGS} is not set, so nothing says where the log is kept.`);
 }
-/** The user the store is provisioned as, and the password of the reader it creates. */
+/** The users of the broker the rows are published to, and of the store they are read from. */
 export function credentials() {
-    const [username, password, reader] = KEYS.map((key) => environment.get(`${SETTINGS}_STORE_${key}`));
-    if (username !== undefined && password !== undefined && reader !== undefined)
-        return { username, password, reader };
+    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 { username: 'developer', password: 'secret', reader: 'secret' };
-    throw new Error(`${SETTINGS}_STORE_{USERNAME,PASSWORD,READER} are not all set.`);
+        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';
 }
-const KEYS = ['USERNAME', 'PASSWORD', 'READER'];
 // Toa's own development stack is not on the conventional ports, which the applications built on
 // Toa are on. See CONTRIBUTING.md.
 const DEV = {
-    store: { provider: 'clickhouse', url: 'http://localhost:31030/chronicles' },
-    ingest: true,
+    broker: 'amqp://localhost:31010',
+    store: { provider: 'clickhouse', url: 'http://localhost:31030' },
+    encounters: true,
     ip: 'truncated',
-    events: [],
-    states: [],
-    identities: {}
+    events: {},
+    states: {},
+    facts: {},
+    identities: {},
+    timestamps: {}
 };
 //# sourceMappingURL=settings.js.map

package/transpiled/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../source/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAA;AAGpE,0FAA0F;AAC1F,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,uFAAuF;AACvF,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACpD,WAAW,CAAC,GAAG,CAAC,GAAG,QAAQ,UAAU,GAAG,EAAE,CAAC,CAC5C,CAAA;IAED,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAC1E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAEvC,IAAI,GAAG,EAAE;QAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAEjF,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,oDAAoD,CAAC,CAAA;AAClF,CAAC;AAUD,SAAS,GAAG;IACV,OAAO,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CAAA;AAC3C,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;AAE/C,gGAAgG;AAChG,mCAAmC;AACnC,MAAM,GAAG,GAAa;IACpB,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,mCAAmC,EAAE;IAC3E,MAAM,EAAE,IAAI;IACZ,EAAE,EAAE,WAAW;IACf,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;CACf,CAAA"}
+{"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

@@ -1,5 +1,5 @@
 import type { Provider } from './Provider.ts';
-import type { Credentials } from './settings.ts';
+import type { User } from './settings.ts';
 import type { Settings } from '@toa.io/definitions/extensions.chronicles';
-/** The provider the annotation names. */
-export declare function provider(settings: Settings, credentials: Credentials): Provider;
+/** 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

@@ -1,9 +1,9 @@
 import { ClickHouseProvider } from './clickhouse/Provider.js';
-/** The provider the annotation names. */
-export function provider(settings, credentials) {
+/** 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, credentials, settings.retention);
+            return new ClickHouseProvider(settings.store.url, user, scope);
         default:
             throw new Error(`Chronicles have no store '${String(settings.store.provider)}'`);
     }

package/transpiled/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../source/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAK7D,yCAAyC;AACzC,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,WAAwB;IACnE,QAAQ,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,YAAY;YACf,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;QACpF;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IACpF,CAAC;AACH,CAAC"}
+{"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/components/chronicles.ingestion/manifest.toa.yaml

@@ -1,60 +0,0 @@
-namespace: chronicles
-name: ingestion
-
-# The extension writes what this component is sent to the log, under `agent.`
-chronicles: ~
-
-operations:
-  anonymous:
-    type: effect
-    input: &batch
-      description: >
-        `{ events }`, at most 100 of them, each `{ id, name, time, payload? }`, and the client's
-        `ip` and `country`, which the gateway puts in; as JSON, or as the form
-        `navigator.sendBeacon` sends, whose `events` is their JSON, which the extension parses
-        and checks
-      type: object
-    output: &accepted
-      type: object
-      properties:
-        status:
-          type: integer
-        accepted:
-          type: integer
-    errors: &errors [INVALID, OVERSIZED]
-  identified:
-    type: effect
-    input: *batch
-    output: *accepted
-    errors: *errors
-
-exposition:
-  isolated: true
-  /:
-    POST:
-      anonymous: true
-      map:ip: ip
-      map:country: country
-      io:throttle:
-        key: [ip]
-        requests: 60
-        interval: 60
-      io:status: status
-      io:output: [status, accepted]
-      help:method: null
-      endpoint: anonymous
-  /:identity:
-    POST:
-      auth:id: identity
-      map:segments:
-        identity: identity
-      map:ip: ip
-      map:country: country
-      io:throttle:
-        key: [identity]
-        requests: 60
-        interval: 60
-      io:status: status
-      io:output: [status, accepted]
-      help:method: null
-      endpoint: identified

package/transpiled/Facts.d.ts

@@ -1,9 +0,0 @@
-import { Connector } from '@toa.io/core';
-import type { Writer } from './Writer.ts';
-/** What `chronicles.facts` writes a fact a component sent through. */
-export declare class Facts extends Connector {
-    readonly name = "chronicles";
-    private readonly writer;
-    constructor(writer: () => Writer);
-    invoke(method: string, ...args: any[]): Promise<void>;
-}

package/transpiled/Facts.js

@@ -1,16 +0,0 @@
-import { Connector, exceptions } from '@toa.io/core';
-/** What `chronicles.facts` writes a fact a component sent through. */
-export class Facts extends Connector {
-    name = 'chronicles';
-    writer;
-    constructor(writer) {
-        super();
-        this.writer = writer;
-    }
-    async invoke(method, ...args) {
-        if (method !== 'record')
-            throw new exceptions.MisuseException(`Chronicles have no '${method}'`);
-        await this.writer().write([args[0]]);
-    }
-}
-//# sourceMappingURL=Facts.js.map

package/transpiled/Facts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Facts.js","sourceRoot":"","sources":["../source/Facts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAIpD,sEAAsE;AACtE,MAAM,OAAO,KAAM,SAAQ,SAAS;IAClB,IAAI,GAAG,YAAY,CAAA;IAElB,MAAM,CAAc;IAErC,YAAmB,MAAoB;QACrC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,IAAW;QAChD,IAAI,MAAM,KAAK,QAAQ;YACrB,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAA;QAExE,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAQ,CAAC,CAAC,CAAA;IAC7C,CAAC;CACF"}

package/transpiled/Scribe.d.ts

@@ -1,25 +0,0 @@
-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

@@ -1,61 +0,0 @@
-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

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

package/transpiled/Writer.d.ts

@@ -1,14 +0,0 @@
-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

@@ -1,50 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}