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

package/transpiled/Provider.d.ts

@@ -1,38 +1,38 @@
+import type { Property } from '@toa.io/definitions/extensions.chronicles';
 /**
- * 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.
+ * Where the log is read. A provider reads the log's tables — `events`, a row for everything a
+ * component did, `states`, each entity as it stands, and `encounters`, what clients sent — in a
+ * dialect of its own, which is what an agent writes its queries in. What it reads is what the store
+ * lets the context's user read; it creates nothing there but the views it is asked to.
  */
 export interface Provider {
-    /** what a query is written in, which `describe` tells whoever writes one */
-    readonly dialect: string;
+    /** how the store is read: its dialect and what is particular to it, for whoever writes a query */
+    readonly guide: 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 */
+    /** the fields of declared properties, at every depth, each with the type its view reads it as */
+    fields(properties: Record<string, Property>): Field[];
+    /** the labels written, with their counts and their times */
     labels(): Promise<Label[]>;
-    /** the components with a state, with how many entities each has and the fields of the state */
+    /** the components with a state, with how many entities each has */
     states(): Promise<Summary[]>;
+    /** the names of encounters, with their counts, their times and the fields their payloads have */
+    encounters(): Promise<Encountered[]>;
     /** 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>;
+    /** the views defined over the log */
     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>;
+    define(definition: Definition): Promise<void>;
     drop(name: string): Promise<void>;
 }
-/** A row of the log. */
+/** A row of `events`. */
 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 */
+    /** `<component>.<event>`, or `<component>.<name>` for a fact */
     label: string;
     /** the component it is of */
     component: string;
@@ -44,9 +44,6 @@ export interface Row {
     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;
@@ -60,23 +57,77 @@ export interface State {
     time: number;
     payload: object;
 }
+/** A row of `encounters`: what a client sent. */
+export interface Encounter {
+    /** the client's own */
+    id: string;
+    name: string;
+    /** when it happened, by the gateway's clock, at the distance from sending the client measured */
+    time: number;
+    /** when the gateway received it */
+    received: number;
+    /** the client's id of itself, and of the period of its activity, where it gave them */
+    visitor: string | null;
+    session: string | null;
+    /** the identity the gateway verified the client to be */
+    identity: string | null;
+    /** the address and the country the request came from */
+    ip: string | null;
+    country: string | null;
+    /** the origin of the page that sent it, and the client's `user-agent` */
+    origin: string | null;
+    agent: string | null;
+    /** what the agent says the client is: its browser, its system, its kind of device */
+    browser: string | null;
+    os: string | null;
+    device: string | null;
+    payload: object;
+}
+export interface Label {
+    label: string;
+    rows: number;
+    first: string;
+    last: string;
+}
 export interface Summary {
     component: string;
     entities: number;
-    paths: string[];
+    /** when the latest change of an entity was made */
+    last: string;
 }
-export interface Label {
-    label: string;
+export interface Encountered {
+    name: string;
     rows: number;
     first: string;
     last: string;
-    paths: string[];
+    received: string;
+    /** the paths of the latest payloads, each with the types it was sent as */
+    fields: Array<{
+        path: string;
+        types: string[];
+    }>;
 }
-export interface View {
+/** A field of a declared payload, and the type its view reads it as. */
+export interface Field {
+    path: string;
+    type: string;
+    description?: string;
+    /** the expression that reads it from its table in its type, of a property of the payload */
+    read?: string;
+}
+export interface Definition {
     name: string;
     sql: string;
     /** seconds between computations of a view that is a table */
     refresh?: number;
+    title?: string;
+    description?: string;
+}
+export interface View extends Definition {
+    /** what a query reads it by */
+    read: string;
+    /** when a view that is a table was last computed */
+    refreshed?: string;
 }
 export interface Result {
     columns: Array<{

package/transpiled/Provider.js.map

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

package/transpiled/Publisher.d.ts

@@ -0,0 +1,50 @@
+import { Connector } from '@toa.io/core';
+import type { Encounter, Row, State } from './Provider.ts';
+import type { User } from './settings.ts';
+/**
+ * Rows to the broker of the log: each a JSON message to the exchange `chronicles` under the key of
+ * its table, with the scope of the context and when it expires. A publication resolves once the
+ * broker has confirmed it, which is what the caller acknowledges what it carried by.
+ *
+ * The connection is made by the first publication and not before, and nothing waits for it to
+ * start: while the broker is away, a publication waits for it, and what it carries waits, unacknowledged,
+ * where it came from.
+ */
+export declare class Publisher extends Connector {
+    private readonly url;
+    private readonly scope;
+    private readonly retention;
+    private io?;
+    private opened?;
+    /** aborted as the publisher stops: what waits for the broker then gives up, to be delivered again */
+    private closing;
+    private stopped;
+    /** where it publishes, which a publisher of other settings does not */
+    readonly address: string;
+    constructor(address: string, user: User, scope: string, retention?: number);
+    publish(rows: Row[], states?: State[], encounters?: Encounter[]): Promise<void>;
+    /**
+     * Fails what waits for the broker, and what is published from now on, so the service publishing
+     * through it is not held open by what would wait for the broker past the service's own end: it
+     * is delivered again, to this process or another.
+     */
+    get done(): boolean;
+    stop(): void;
+    protected open(): Promise<void>;
+    /**
+     * A connection still being made is not waited for — it may never be — but closed once it is,
+     * and what waits for it is failed, so it is delivered again, to this process or another.
+     */
+    protected close(): Promise<void>;
+    private connection;
+    private route;
+}
+/**
+ * A row as the store reads it: of a scope, its times in the store's format, and when it expires,
+ * where it does.
+ */
+export declare function message(row: Row | State | Encounter, scope: string, until: string | null): Record<string, unknown>;
+/** When a row stops being kept: its time and the retention, or the end of the store's time. */
+export declare function expires(from: number, retention: number | undefined): string;
+/** A `DateTime64(3)` as the store reads one without guessing: UTC, to the millisecond. */
+export declare function timestamp(ms: number): string;

package/transpiled/Publisher.js

@@ -0,0 +1,169 @@
+import { createConnection } from 'node:net';
+import { connect } from 'comq';
+import { console } from 'openspan';
+import { Connector } from '@toa.io/core';
+import { EXCHANGE } from '@toa.io/definitions/extensions.chronicles';
+/**
+ * Rows to the broker of the log: each a JSON message to the exchange `chronicles` under the key of
+ * its table, with the scope of the context and when it expires. A publication resolves once the
+ * broker has confirmed it, which is what the caller acknowledges what it carried by.
+ *
+ * The connection is made by the first publication and not before, and nothing waits for it to
+ * start: while the broker is away, a publication waits for it, and what it carries waits, unacknowledged,
+ * where it came from.
+ */
+export class Publisher extends Connector {
+    url;
+    scope;
+    retention;
+    io;
+    opened;
+    /** aborted as the publisher stops: what waits for the broker then gives up, to be delivered again */
+    closing = new AbortController();
+    stopped = false;
+    /** where it publishes, which a publisher of other settings does not */
+    address;
+    // eslint-disable-next-line max-params
+    constructor(address, user, scope, retention) {
+        super();
+        this.address = address;
+        const url = new URL(address);
+        url.username = encodeURIComponent(user.username);
+        url.password = encodeURIComponent(user.password);
+        this.url = url.href;
+        this.scope = scope;
+        this.retention = retention;
+    }
+    async publish(rows, states = [], encounters = []) {
+        if (this.stopped)
+            throw new Error('The chronicles are stopping');
+        const io = await this.connection();
+        await Promise.all([
+            ...rows.map(async (row) => await this.route(io, 'events', row, row.time)),
+            ...states.map(async (state) => await this.route(io, 'states', state)),
+            ...encounters.map(async (encounter) => await this.route(io, 'encounters', encounter, encounter.received))
+        ]);
+    }
+    /**
+     * Fails what waits for the broker, and what is published from now on, so the service publishing
+     * through it is not held open by what would wait for the broker past the service's own end: it
+     * is delivered again, to this process or another.
+     */
+    get done() {
+        return this.stopped;
+    }
+    stop() {
+        this.stopped = true;
+        this.closing.abort();
+    }
+    async open() {
+        this.stopped = false;
+        this.closing = new AbortController();
+    }
+    /**
+     * A connection still being made is not waited for — it may never be — but closed once it is,
+     * and what waits for it is failed, so it is delivered again, to this process or another.
+     */
+    async close() {
+        const { io, opened } = this;
+        this.io = undefined;
+        this.opened = undefined;
+        this.stop();
+        if (opened !== undefined)
+            await opened.close();
+        else
+            void io?.then(async (late) => await late.close(), () => undefined);
+    }
+    async connection() {
+        this.io ??= reachable(this.url, this.closing.signal)
+            .then(async () => await connect(this.url))
+            .then((io) => {
+            this.opened = io;
+            return io;
+        }, (error) => {
+            this.io = undefined;
+            console.warn('Chronicles failed to reach their broker', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        });
+        const { signal } = this.closing;
+        // a publication waits for the broker a while, and then fails, so what it carries is
+        // delivered again rather than held: a process that stops is not kept by one that never ends
+        return await new Promise((resolve, reject) => {
+            function away() {
+                reject(new Error('The broker of the chronicles is away'));
+            }
+            function closing() {
+                reject(new Error('The chronicles are closing'));
+            }
+            const timer = setTimeout(away, WAIT);
+            signal.addEventListener('abort', closing, { once: true });
+            this.io.then(resolve, reject).finally(() => {
+                clearTimeout(timer);
+                signal.removeEventListener('abort', closing);
+            });
+        });
+    }
+    // eslint-disable-next-line max-params
+    async route(io, table, row, from) {
+        const body = message(row, this.scope, from === undefined ? null : expires(from, this.retention));
+        await io.route(EXCHANGE, table, body, 'application/json');
+    }
+}
+/**
+ * Resolves once the broker accepts a connection, trying again until it does or `signal` aborts.
+ * A connection is asked of comq only then: one it is asked for keeps trying for as long as it
+ * takes, and is no longer the publisher's to give up.
+ */
+async function reachable(url, signal) {
+    const { protocol, hostname, port } = new URL(url);
+    const target = { host: hostname, port: Number(port === '' ? DEFAULT[protocol] : port) };
+    while (!signal.aborted) {
+        const reached = await new Promise((resolve) => {
+            const socket = createConnection(target);
+            function settle(ok) {
+                socket.destroy();
+                resolve(ok);
+            }
+            socket.setTimeout(PROBE);
+            socket.once('connect', () => settle(true));
+            socket.once('timeout', () => settle(false));
+            socket.once('error', () => settle(false));
+        });
+        if (reached)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, PROBE).unref());
+    }
+    throw new Error('The chronicles are closing');
+}
+/**
+ * A row as the store reads it: of a scope, its times in the store's format, and when it expires,
+ * where it does.
+ */
+export function message(row, scope, until) {
+    const body = { scope, ...row, time: timestamp(row.time) };
+    if ('received' in row)
+        body.received = timestamp(row.received);
+    if (until !== null)
+        body.expires = until;
+    return body;
+}
+/** When a row stops being kept: its time and the retention, or the end of the store's time. */
+export function expires(from, retention) {
+    if (retention === undefined)
+        return FOREVER;
+    return timestamp(from + retention * DAY).slice(0, 19);
+}
+/** A `DateTime64(3)` as the store reads one without guessing: UTC, to the millisecond. */
+export function timestamp(ms) {
+    return new Date(ms).toISOString().replace('T', ' ').replace('Z', '');
+}
+const DAY = 86_400_000;
+/** milliseconds a publication waits for the broker */
+const WAIT = 10_000;
+/** milliseconds a try to reach the broker takes, and between two of them */
+const PROBE = 1_000;
+const DEFAULT = { 'amqp:': 5672, 'amqps:': 5671 };
+const FOREVER = '2106-01-01 00:00:00';
+//# sourceMappingURL=Publisher.js.map

package/transpiled/Publisher.js.map

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

package/transpiled/Reader.d.ts

@@ -1,16 +1,28 @@
 import { Connector } from '@toa.io/core';
 import type { Provider } from './Provider.ts';
+import type { extensions } from '@toa.io/core/types';
+import type { Settings } from '@toa.io/definitions/extensions.chronicles';
 /**
- * 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.
+ * What `chronicles.queries` reads the log through: queries in the provider's dialect, views made
+ * from a statement the provider let a query run, and what the log holds — how it is read, what the
+ * components declare, what the context documents of encounters, and what the store has written.
  */
 export declare class Reader extends Connector {
     readonly name = "chronicles";
+    private readonly host;
     private readonly provider;
-    constructor(provider: () => Provider);
+    private readonly settings;
+    private encounters?;
+    constructor(host: extensions.Host, provider: () => Provider, settings: () => Settings);
     invoke(method: string, ...args: any[]): Promise<unknown>;
     private describe;
     private query;
     private define;
     private drop;
+    /**
+     * What the configuration of `chronicles.encounters` documents, asked of that component, which is
+     * in this service where the context serves encounters. Found on the first ask and not before: an
+     * aspect is made ahead of the components of its composition.
+     */
+    private documented;
 }

package/transpiled/Reader.js

@@ -1,15 +1,24 @@
-import { Connector, exceptions } from '@toa.io/core';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Connector, Locator, exceptions } from '@toa.io/core';
+import { ENCOUNTERS, NAMESPACE } from '@toa.io/definitions/extensions.chronicles';
 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.
+ * What `chronicles.queries` reads the log through: queries in the provider's dialect, views made
+ * from a statement the provider let a query run, and what the log holds — how it is read, what the
+ * components declare, what the context documents of encounters, and what the store has written.
  */
 export class Reader extends Connector {
     name = 'chronicles';
+    host;
     provider;
-    constructor(provider) {
+    settings;
+    encounters;
+    constructor(host, provider, settings) {
         super();
+        this.host = host;
         this.provider = provider;
+        this.settings = settings;
     }
     async invoke(method, ...args) {
         switch (method) {
@@ -18,7 +27,7 @@ export class Reader extends Connector {
             case 'query':
                 return await this.query(args[0]);
             case 'define':
-                return await this.define(args[0], args[1], args[2]);
+                return await this.define(args[0]);
             case 'drop':
                 return await this.drop(args[0]);
             default:
@@ -27,23 +36,54 @@ export class Reader extends Connector {
     }
     async describe() {
         const provider = this.provider();
-        return {
-            dialect: provider.dialect,
-            labels: await provider.labels(),
-            states: await provider.states(),
-            views: await provider.views()
-        };
+        const settings = this.settings();
+        const [written, kept, sent, views, documented] = await Promise.all([
+            provider.labels(),
+            provider.states(),
+            provider.encounters(),
+            provider.views(),
+            this.documented(settings)
+        ]);
+        const declared = { ...settings.events, ...settings.facts };
+        const stated = Object.fromEntries(Object.entries(settings.states).map(([label, contract]) => [
+            component(label),
+            contract
+        ]));
+        const labels = merge(written.map(({ label, ...stats }) => [label, stats]), Object.keys(declared)).map(([label, stats]) => ({
+            label,
+            ...about(declared[label], provider),
+            ...(stats ?? { rows: 0 })
+        }));
+        const states = merge(kept.map(({ component, ...stats }) => [component, stats]), Object.keys(stated)).map(([component, stats]) => ({
+            component,
+            ...about(stated[component], provider),
+            ...(stats ?? { entities: 0 })
+        }));
+        const encounters = merge(sent.map(({ name, ...stats }) => [name, stats]), Object.keys(documented)).map(([name, stats]) => {
+            const { description, fields: told = {} } = documented[name] ?? {};
+            const fields = (stats?.fields ?? []).map((field) => told[field.path] === undefined
+                ? field
+                : { ...field, description: told[field.path] });
+            return {
+                name,
+                ...(description === undefined ? {} : { description }),
+                ...(stats ?? { rows: 0 }),
+                fields
+            };
+        });
+        return { guide: `${GUIDE}\n${provider.guide}`, labels, states, encounters, views };
     }
     async query(sql) {
         return await refused(async () => await this.provider().query(statement(sql)));
     }
-    async define(name, sql, refresh) {
+    async define(definition) {
         const provider = this.provider();
+        const { name } = definition;
         if (provider.tables.includes(name))
             return new Error('RESERVED', {
                 cause: { message: `'${name}' is a table of the log` }
             });
-        const select = statement(sql);
+        const select = statement(definition.sql);
         const invalid = await refused(async () => await provider.validate(select));
         if (invalid instanceof Error)
             return invalid;
@@ -52,7 +92,7 @@ export class Reader extends Connector {
             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));
+        const defined = await refused(async () => await provider.define({ ...definition, sql: select }));
         return defined instanceof Error ? defined : undefined;
     }
     async drop(name) {
@@ -63,6 +103,47 @@ export class Reader extends Connector {
         await provider.drop(name);
         return undefined;
     }
+    /**
+     * What the configuration of `chronicles.encounters` documents, asked of that component, which is
+     * in this service where the context serves encounters. Found on the first ask and not before: an
+     * aspect is made ahead of the components of its composition.
+     */
+    async documented(settings) {
+        if (!settings.encounters)
+            return {};
+        this.encounters ??= (async () => {
+            const remote = await this.host.remote(LOCATOR, SOURCE);
+            this.depends(remote);
+            await remote.connect();
+            return remote;
+        })().catch((error) => {
+            this.encounters = undefined;
+            throw error;
+        });
+        const remote = await this.encounters;
+        return (await remote.invoke('describe', {}));
+    }
+}
+/**
+ * Of what was written and what is declared, by key, in order: a key declared and not yet written
+ * has no statistics, and one written and no longer declared has nothing else.
+ */
+function merge(written, declared) {
+    const by = new Map(written);
+    const keys = [...new Set([...by.keys(), ...declared])].sort();
+    return keys.map((key) => [key, by.get(key)]);
+}
+/** What a declaration says of a label or a state: its meaning, and its fields. */
+function about(contract, provider) {
+    if (contract === undefined)
+        return {};
+    return {
+        description: contract.description,
+        fields: provider.fields(contract.properties)
+    };
+}
+function component(label) {
+    return label.slice(0, label.lastIndexOf('.'));
 }
 /** One statement: a trailing semicolon is an agent's habit. */
 function statement(sql) {
@@ -78,5 +159,8 @@ async function refused(fn) {
         throw exception;
     }
 }
+const LOCATOR = new Locator(ENCOUNTERS, NAMESPACE);
+const SOURCE = { service: 'chronicles' };
 const MAX_VIEWS = 50;
+const GUIDE = readFileSync(resolve(import.meta.dirname, '../guides/log.md'), 'utf8');
 //# sourceMappingURL=Reader.js.map

package/transpiled/Reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"Reader.js","sourceRoot":"","sources":["../source/Reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Reader.js","sourceRoot":"","sources":["../source/Reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAA;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAMvC;;;;GAIG;AACH,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnB,IAAI,GAAG,YAAY,CAAA;IAElB,IAAI,CAAiB;IACrB,QAAQ,CAAgB;IACxB,QAAQ,CAAgB;IACjC,UAAU,CAAkB;IAEpC,YACE,IAAqB,EACrB,QAAwB,EACxB,QAAwB;QAExB,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAG,IAAW;QAChD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,UAAU;gBACb,OAAO,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC9B,KAAK,OAAO;gBACV,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAClC,KAAK,QAAQ;gBACX,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACnC,KAAK,MAAM;gBACT,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACjC;gBACE,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAEhC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjE,QAAQ,CAAC,MAAM,EAAE;YACjB,QAAQ,CAAC,MAAM,EAAE;YACjB,QAAQ,CAAC,UAAU,EAAE;YACrB,QAAQ,CAAC,KAAK,EAAE;YAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;SAC1B,CAAC,CAAA;QAEF,MAAM,QAAQ,GAA6B,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAA;QACpF,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;YACzD,SAAS,CAAC,KAAK,CAAC;YAChB,QAAQ;SACT,CAAC,CACH,CAAA;QAED,MAAM,MAAM,GAAG,KAAK,CAClB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EACpD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CACtB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,KAAK;YACL,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;YACnC,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SAC1B,CAAC,CAAC,CAAA;QAEH,MAAM,MAAM,GAAG,KAAK,CAClB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EACzD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CACpB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,SAAS;YACT,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;YACrC,GAAG,CAAC,KAAK,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC,CAAA;QAEH,MAAM,UAAU,GAAG,KAAK,CACtB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAC/C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CACxB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;YACtB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;YACjE,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;gBAC5B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAChD,CAAA;YAED,OAAO;gBACL,IAAI;gBACJ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;gBACrD,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM;aACP,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACpF,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,GAAW;QAC7B,OAAO,MAAM,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC/E,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,UAAsB;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAA;QAE3B,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAChC,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE;gBAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,yBAAyB,EAAE;aACtD,CAAC,CAAA;QAEJ,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QAE1E,IAAI,OAAO,YAAY,KAAK;YAAE,OAAO,OAAO,CAAA;QAE5C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;QAEpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;YACxE,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE;gBAC5B,KAAK,EAAE,EAAE,OAAO,EAAE,yBAAyB,SAAS,QAAQ,EAAE;aAC/D,CAAC,CAAA;QAEJ,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,KAAK,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAClE,CAAA;QAED,OAAO,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IACvD,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAAY;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;QAEpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;QAE5E,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,UAAU,CAAC,QAAkB;QACzC,IAAI,CAAC,QAAQ,CAAC,UAAU;YAAE,OAAO,EAAE,CAAA;QAEnC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAEtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACpB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;YAEtB,OAAO,MAAM,CAAA;QACf,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;YAE3B,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAA;QAEpC,OAAO,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAe,CAAA;IAC5D,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,KAAK,CACZ,OAA2B,EAC3B,QAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,kFAAkF;AAClF,SAAS,KAAK,CACZ,QAA8B,EAC9B,QAAkB;IAElB,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAErC,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;KAC7C,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,+DAA+D;AAC/D,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AAC7C,CAAC;AAED,KAAK,UAAU,OAAO,CAAI,EAAoB;IAC5C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAA;IACnB,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,IAAI,SAAS,YAAY,OAAO;YAC9B,OAAO,IAAI,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAExE,MAAM,SAAS,CAAA;IACjB,CAAC;AACH,CAAC;AAgBD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;AAClD,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AACxC,MAAM,SAAS,GAAG,EAAE,CAAA;AACpB,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAA"}