@rocicorp/zero 0.0.0-202410031711

package/out/zero-cache/src/services/view-syncer/cvr-store.js

@@ -0,0 +1,386 @@
+import { resolver } from '@rocicorp/resolver';
+import { assert } from '../../../../shared/src/asserts.js';
+import { CustomKeyMap } from '../../../../shared/src/custom-key-map.js';
+import { deepEqual } from '../../../../shared/src/json.js';
+import { must } from '../../../../shared/src/must.js';
+import { astSchema } from '../../../../zero-protocol/src/mod.js';
+import { versionToLexi } from '../../types/lexi-version.js';
+import { rowIDHash } from '../../types/row-key.js';
+import { rowRecordToRowsRow, rowsRowToRowRecord, } from './schema/cvr.js';
+import { cmpVersions, versionFromString, versionString, } from './schema/types.js';
+class RowRecordCache {
+    #cache;
+    #db;
+    #cvrID;
+    constructor(db, cvrID) {
+        this.#db = db;
+        this.#cvrID = cvrID;
+    }
+    async #ensureLoaded() {
+        if (this.#cache) {
+            return this.#cache;
+        }
+        const r = resolver();
+        const cache = new CustomKeyMap(rowIDHash);
+        for await (const rows of this.#db `SELECT * FROM cvr.rows WHERE "clientGroupID" = ${this.#cvrID} AND "refCounts" IS NOT NULL`
+            // TODO(arv): Arbitrary page size
+            .cursor(5000)) {
+            for (const row of rows) {
+                const rowRecord = rowsRowToRowRecord(row);
+                cache.set(rowRecord.id, rowRecord);
+            }
+        }
+        r.resolve(cache);
+        this.#cache = r.promise;
+        return this.#cache;
+    }
+    getRowRecords() {
+        return this.#ensureLoaded();
+    }
+    async flush(rowRecords) {
+        const cache = await this.#ensureLoaded();
+        for (const row of rowRecords) {
+            if (row.refCounts === null) {
+                cache.delete(row.id);
+            }
+            else {
+                cache.set(row.id, row);
+            }
+        }
+    }
+}
+function asQuery(row) {
+    const ast = astSchema.parse(row.clientAST);
+    const maybeVersion = (s) => s === null ? undefined : versionFromString(s);
+    return row.internal
+        ? {
+            id: row.queryHash,
+            ast,
+            transformationHash: row.transformationHash ?? undefined,
+            transformationVersion: maybeVersion(row.transformationVersion),
+            internal: true,
+        }
+        : {
+            id: row.queryHash,
+            ast,
+            patchVersion: maybeVersion(row.patchVersion),
+            desiredBy: {},
+            transformationHash: row.transformationHash ?? undefined,
+            transformationVersion: maybeVersion(row.transformationVersion),
+        };
+}
+export class CVRStore {
+    #lc;
+    #id;
+    #db;
+    #writes = new Set();
+    #pendingRowRecordPuts = new CustomKeyMap(rowIDHash);
+    #rowCache;
+    constructor(lc, db, cvrID) {
+        this.#lc = lc;
+        this.#db = db;
+        this.#id = cvrID;
+        this.#rowCache = new RowRecordCache(db, cvrID);
+    }
+    async load() {
+        const start = Date.now();
+        const id = this.#id;
+        const cvr = {
+            id,
+            version: { stateVersion: versionToLexi(0) },
+            lastActive: { epochMillis: 0 },
+            clients: {},
+            queries: {},
+        };
+        const [versionAndLastActive, clientsRows, queryRows, desiresRows] = await this.#db.begin(tx => [
+            tx `SELECT version, "lastActive" FROM cvr.instances WHERE "clientGroupID" = ${id}`,
+            tx `SELECT "clientID", "patchVersion" FROM cvr.clients WHERE "clientGroupID" = ${id}`,
+            tx `SELECT * FROM cvr.queries WHERE "clientGroupID" = ${id} AND (deleted IS NULL OR deleted = FALSE)`,
+            tx `SELECT * FROM cvr.desires WHERE "clientGroupID" = ${id} AND (deleted IS NULL OR deleted = FALSE)`,
+        ]);
+        if (versionAndLastActive.length !== 0) {
+            assert(versionAndLastActive.length === 1);
+            const { version, lastActive } = versionAndLastActive[0];
+            cvr.version = versionFromString(version);
+            cvr.lastActive = { epochMillis: lastActive.getTime() };
+        }
+        else {
+            // This is the first time we see this CVR.
+            const change = {
+                clientGroupID: id,
+                version: versionString(cvr.version),
+                lastActive: new Date(0),
+            };
+            this.#writes.add({
+                stats: { instances: 1 },
+                write: tx => tx `INSERT INTO cvr.instances ${tx(change)}`,
+            });
+        }
+        for (const row of clientsRows) {
+            const version = versionFromString(row.patchVersion);
+            cvr.clients[row.clientID] = {
+                id: row.clientID,
+                patchVersion: version,
+                desiredQueryIDs: [],
+            };
+        }
+        for (const row of queryRows) {
+            const query = asQuery(row);
+            cvr.queries[row.queryHash] = query;
+        }
+        for (const row of desiresRows) {
+            const client = cvr.clients[row.clientID];
+            assert(client, 'Client not found');
+            client.desiredQueryIDs.push(row.queryHash);
+            const query = cvr.queries[row.queryHash];
+            if (query && !query.internal) {
+                query.desiredBy[row.clientID] = versionFromString(row.patchVersion);
+            }
+        }
+        this.#lc.debug?.(`loaded CVR @${versionString(cvr.version)} (${Date.now() - start} ms)`);
+        return cvr;
+    }
+    getRowRecords() {
+        return this.#rowCache.getRowRecords();
+    }
+    getPendingRowRecord(id) {
+        return this.#pendingRowRecordPuts.get(id);
+    }
+    putRowRecord(row) {
+        this.#pendingRowRecordPuts.set(row.id, row);
+    }
+    putInstance(version, lastActive) {
+        const change = {
+            clientGroupID: this.#id,
+            version: versionString(version),
+            lastActive: new Date(lastActive.epochMillis),
+        };
+        this.#writes.add({
+            stats: { instances: 1 },
+            write: tx => tx `INSERT INTO cvr.instances ${tx(change)} ON CONFLICT ("clientGroupID") DO UPDATE SET ${tx(change)}`,
+        });
+    }
+    markQueryAsDeleted(version, queryPatch) {
+        this.#writes.add({
+            stats: { queries: 1 },
+            write: tx => tx `UPDATE cvr.queries SET ${tx({
+                patchVersion: versionString(version),
+                deleted: true,
+                transformationHash: null,
+                transformationVersion: null,
+            })}
+      WHERE "clientGroupID" = ${this.#id} AND "queryHash" = ${queryPatch.id}`,
+        });
+    }
+    putQuery(query) {
+        const maybeVersionString = (v) => v ? versionString(v) : null;
+        const change = query.internal
+            ? {
+                clientGroupID: this.#id,
+                queryHash: query.id,
+                clientAST: query.ast,
+                patchVersion: null,
+                transformationHash: query.transformationHash ?? null,
+                transformationVersion: maybeVersionString(query.transformationVersion),
+                internal: true,
+                deleted: false, // put vs del "got" query
+            }
+            : {
+                clientGroupID: this.#id,
+                queryHash: query.id,
+                clientAST: query.ast,
+                patchVersion: maybeVersionString(query.patchVersion),
+                transformationHash: query.transformationHash ?? null,
+                transformationVersion: maybeVersionString(query.transformationVersion),
+                internal: null,
+                deleted: false, // put vs del "got" query
+            };
+        this.#writes.add({
+            stats: { queries: 1 },
+            write: tx => tx `INSERT INTO cvr.queries ${tx(change)}
+      ON CONFLICT ("clientGroupID", "queryHash")
+      DO UPDATE SET ${tx(change)}`,
+        });
+    }
+    updateQuery(query) {
+        const maybeVersionString = (v) => v ? versionString(v) : null;
+        const change = {
+            patchVersion: query.internal
+                ? null
+                : maybeVersionString(query.patchVersion),
+            transformationHash: query.transformationHash ?? null,
+            transformationVersion: maybeVersionString(query.transformationVersion),
+            deleted: false,
+        };
+        this.#writes.add({
+            stats: { queries: 1 },
+            write: tx => tx `UPDATE cvr.queries SET ${tx(change)}
+      WHERE "clientGroupID" = ${this.#id} AND "queryHash" = ${query.id}`,
+        });
+    }
+    updateClientPatchVersion(clientID, patchVersion) {
+        this.#writes.add({
+            stats: { clients: 1 },
+            write: tx => tx `UPDATE cvr.clients
+      SET "patchVersion" = ${versionString(patchVersion)}
+      WHERE "clientGroupID" = ${this.#id} AND "clientID" = ${clientID}`,
+        });
+    }
+    insertClient(client) {
+        const change = {
+            clientGroupID: this.#id,
+            clientID: client.id,
+            patchVersion: versionString(client.patchVersion),
+            // TODO(arv): deleted is never set to true
+            deleted: false,
+        };
+        this.#writes.add({
+            stats: { clients: 1 },
+            write: tx => tx `INSERT INTO cvr.clients ${tx(change)}`,
+        });
+    }
+    insertDesiredQuery(newVersion, query, client, deleted) {
+        const change = {
+            clientGroupID: this.#id,
+            clientID: client.id,
+            queryHash: query.id,
+            patchVersion: versionString(newVersion),
+            deleted,
+        };
+        this.#writes.add({
+            stats: { desires: 1 },
+            write: tx => tx `INSERT INTO cvr.desires ${tx(change)}`,
+        });
+    }
+    delDesiredQuery(oldPutVersion, query, client) {
+        this.#writes.add({
+            stats: { desires: 1 },
+            write: tx => tx `DELETE FROM cvr.desires WHERE "clientGroupID" = ${this.#id} AND "clientID" = ${client.id} AND "queryHash" = ${query.id} AND "patchVersion" = ${versionString(oldPutVersion)}`,
+        });
+    }
+    async *catchupRowPatches(lc, afterVersion, upToCVR, excludeQueryHashes = []) {
+        if (cmpVersions(afterVersion, upToCVR.version) >= 0) {
+            lc.debug?.('all clients up to date. no config catchup.');
+            return;
+        }
+        const startMs = Date.now();
+        const sql = this.#db;
+        const start = afterVersion ? versionString(afterVersion) : '';
+        const end = versionString(upToCVR.version);
+        lc.debug?.(`catching up clients from ${start}`);
+        const query = excludeQueryHashes.length === 0
+            ? sql `SELECT * FROM cvr.rows
+        WHERE "clientGroupID" = ${this.#id}
+          AND "patchVersion" > ${start}
+          AND "patchVersion" <= ${end}`
+            : // Exclude rows that were already sent as part of query hydration.
+                sql `SELECT * FROM cvr.rows
+        WHERE "clientGroupID" = ${this.#id}
+          AND "patchVersion" > ${start}
+          AND "patchVersion" <= ${end}
+          AND ("refCounts" IS NULL OR NOT "refCounts" ?| ${excludeQueryHashes})`;
+        yield* query.cursor(10000);
+        lc.debug?.(`finished row catchup (${Date.now() - startMs} ms)`);
+    }
+    async catchupConfigPatches(lc, afterVersion, upToCVR) {
+        if (cmpVersions(afterVersion, upToCVR.version) >= 0) {
+            lc.debug?.('all clients up to date. no config catchup.');
+            return [];
+        }
+        const startMs = Date.now();
+        const sql = this.#db;
+        const start = afterVersion ? versionString(afterVersion) : '';
+        const end = versionString(upToCVR.version);
+        const [allDesires, clientRows, queryRows] = await Promise.all([
+            sql `SELECT * FROM cvr.desires
+       WHERE "clientGroupID" = ${this.#id}
+        AND "patchVersion" > ${start}
+        AND "patchVersion" <= ${end}`,
+            sql `SELECT * FROM cvr.clients
+       WHERE "clientGroupID" = ${this.#id}
+        AND "patchVersion" > ${start}
+        AND "patchVersion" <= ${end}`,
+            sql `SELECT deleted, "queryHash", "patchVersion" FROM cvr.queries
+      WHERE "clientGroupID" = ${this.#id}
+        AND "patchVersion" > ${start}
+        AND "patchVersion" <= ${end}`,
+        ]);
+        const ast = (id) => must(upToCVR.queries[id]).ast;
+        const patches = [];
+        for (const row of queryRows) {
+            const { queryHash: id } = row;
+            const patch = row.deleted
+                ? { type: 'query', op: 'del', id }
+                : { type: 'query', op: 'put', id, ast: ast(id) };
+            const v = row.patchVersion;
+            assert(v);
+            patches.push({ patch, toVersion: versionFromString(v) });
+        }
+        for (const row of clientRows) {
+            const patch = {
+                type: 'client',
+                op: row.deleted ? 'del' : 'put',
+                id: row.clientID,
+            };
+            patches.push({ patch, toVersion: versionFromString(row.patchVersion) });
+        }
+        for (const row of allDesires) {
+            const { clientID, queryHash: id } = row;
+            const patch = row.deleted
+                ? { type: 'query', op: 'del', id, clientID }
+                : { type: 'query', op: 'put', id, clientID, ast: ast(id) };
+            patches.push({ patch, toVersion: versionFromString(row.patchVersion) });
+        }
+        lc.debug?.(`${patches.length} config patches (${Date.now() - startMs} ms)`);
+        return patches;
+    }
+    async flush() {
+        const stats = {
+            instances: 0,
+            queries: 0,
+            desires: 0,
+            clients: 0,
+            rows: 0,
+            statements: 0,
+        };
+        const existingRowRecords = await this.getRowRecords();
+        const rowRecordsToFlush = [...this.#pendingRowRecordPuts.values()].filter(row => {
+            const existing = existingRowRecords.get(row.id);
+            return ((existing !== undefined || row.refCounts !== null) &&
+                !deepEqual(row, existing));
+        });
+        stats.rows = rowRecordsToFlush.length;
+        await this.#db.begin(tx => {
+            if (this.#pendingRowRecordPuts.size > 0) {
+                const rowRecordRows = rowRecordsToFlush.map(r => rowRecordToRowsRow(this.#id, r));
+                let i = 0;
+                while (i < rowRecordRows.length) {
+                    void tx `INSERT INTO cvr.rows ${tx(rowRecordRows.slice(i, i + ROW_RECORD_UPSERT_BATCH_SIZE))} 
+            ON CONFLICT ("clientGroupID", "schema", "table", "rowKey")
+            DO UPDATE SET "rowVersion" = excluded."rowVersion",
+              "patchVersion" = excluded."patchVersion",
+              "refCounts" = excluded."refCounts"`.execute();
+                    i += ROW_RECORD_UPSERT_BATCH_SIZE;
+                    stats.statements++;
+                }
+            }
+            for (const write of this.#writes) {
+                stats.instances += write.stats.instances ?? 0;
+                stats.queries += write.stats.queries ?? 0;
+                stats.desires += write.stats.desires ?? 0;
+                stats.clients += write.stats.clients ?? 0;
+                void write.write(tx).execute();
+                stats.statements++;
+            }
+        });
+        await this.#rowCache.flush(rowRecordsToFlush);
+        this.#writes.clear();
+        this.#pendingRowRecordPuts.clear();
+        return stats;
+    }
+}
+// Max number of parameters for our sqlite build is 65534.
+// Each row record has 7 parameters (1 per column).
+// 65534 / 7 = 9362
+const ROW_RECORD_UPSERT_BATCH_SIZE = 9_360;
+//# sourceMappingURL=cvr-store.js.map

package/out/zero-cache/src/services/view-syncer/cvr-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cvr-store.js","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/cvr-store.ts"],"names":[],"mappings":"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"}

package/out/zero-cache/src/services/view-syncer/cvr.d.ts

@@ -0,0 +1,146 @@
+import type { LogContext } from '@rocicorp/logger';
+import type { JSONObject } from '../../../../zero-cache/src/types/bigint-json.js';
+import type { AST } from '../../../../zql/src/zql/ast/ast.js';
+import type { LexiVersion } from '../../types/lexi-version.js';
+import type { PatchToVersion } from './client-handler.js';
+import type { CVRFlushStats, CVRStore } from './cvr-store.js';
+import { type CVRVersion, type ClientRecord, type LastActive, type QueryRecord, type RowID } from './schema/types.js';
+export type RowUpdate = {
+    version?: string;
+    contents?: JSONObject;
+    refCounts: {
+        [hash: string]: number;
+    };
+};
+/** Internally used mutable CVR type. */
+export type CVR = {
+    id: string;
+    version: CVRVersion;
+    lastActive: LastActive;
+    clients: Record<string, ClientRecord>;
+    queries: Record<string, QueryRecord>;
+};
+/** Exported immutable CVR type. */
+export type CVRSnapshot = {
+    readonly id: string;
+    readonly version: CVRVersion;
+    readonly lastActive: LastActive;
+    readonly clients: Readonly<Record<string, ClientRecord>>;
+    readonly queries: Readonly<Record<string, QueryRecord>>;
+};
+/**
+ * The base CVRUpdater contains logic common to the {@link CVRConfigDrivenUpdater} and
+ * {@link CVRQueryDrivenUpdater}. The CVRUpdater class itself is exported for updating
+ * the `lastActive` time of the CVR in the absence of any changes to the CVR contents.
+ * Although activity is automatically tracked when the CVR contents change, there may be
+ * edge cases in which a client actively connects to a CVR that doesn't itself change.
+ * Calling `new CVRUpdater(...).flush()` will explicitly update the active index and
+ * prevent the CVR from being garbage collected.
+ */
+export declare class CVRUpdater {
+    #private;
+    protected readonly _orig: CVRSnapshot;
+    protected readonly _cvr: CVR;
+    protected readonly _cvrStore: CVRStore;
+    /**
+     * @param cvrStore The CVRStore to use for storage
+     * @param cvr The current CVR
+     */
+    constructor(cvrStore: CVRStore, cvr: CVRSnapshot);
+    protected _setVersion(version: CVRVersion): {
+        minorVersion?: number | undefined;
+        stateVersion: string;
+    };
+    /**
+     * Ensures that the new CVR has a higher version than the original.
+     * This method is idempotent in that it will always return the same
+     * (possibly bumped) version.
+     */
+    protected _ensureNewVersion(): CVRVersion;
+    flush(lc: LogContext, lastActive?: Date): Promise<{
+        cvr: CVRSnapshot;
+        stats: CVRFlushStats;
+    }>;
+}
+/**
+ * A {@link CVRConfigDrivenUpdater} is used for updating a CVR with config-driven
+ * changes. Note that this may result in row deletion (e.g. if queries get dropped),
+ * but the `stateVersion` of the CVR does not change.
+ */
+export declare class CVRConfigDrivenUpdater extends CVRUpdater {
+    #private;
+    putDesiredQueries(clientID: string, queries: {
+        [id: string]: AST;
+    }): {
+        id: string;
+        ast: AST;
+    }[];
+    deleteDesiredQueries(clientID: string, queries: string[]): void;
+    clearDesiredQueries(clientID: string): void;
+    flush(lc: LogContext, lastActive?: Date): Promise<{
+        cvr: CVRSnapshot;
+        stats: CVRFlushStats;
+    }>;
+}
+type Hash = string;
+export type Column = string;
+export type RefCounts = Record<Hash, number>;
+/**
+ * A {@link CVRQueryDrivenUpdater} is used for updating a CVR after making queries.
+ * The caller should invoke:
+ *
+ * * {@link trackQueries} for queries that are being executed or removed.
+ * * {@link received} for all rows received from the executed queries
+ * * {@link deleteUnreferencedRows} to remove any rows that have
+ *       fallen out of the query result view.
+ * * {@link flush}
+ *
+ * After flushing, the caller should perform any necessary catchup of
+ * config and row patches for clients that are behind. See
+ * {@link CVRStore.catchupConfigPatches} and {@link CVRStore.catchupRowPatches}.
+ */
+export declare class CVRQueryDrivenUpdater extends CVRUpdater {
+    #private;
+    /**
+     * @param stateVersion The `stateVersion` at which the queries were executed.
+     */
+    constructor(cvrStore: CVRStore, cvr: CVRSnapshot, stateVersion: LexiVersion);
+    /**
+     * Initiates the tracking of the specified `executed` and `removed` queries.
+     * This kicks of a lookup of existing {@link RowRecord}s currently associated
+     * with those queries, which will be used to reconcile the rows to keep
+     * after all rows have been {@link received()}.
+     *
+     * @returns The new CVRVersion to be used when all changes are committed.
+     */
+    trackQueries(lc: LogContext, executed: {
+        id: string;
+        transformationHash: string;
+    }[], removed: string[]): {
+        newVersion: CVRVersion;
+        queryPatches: PatchToVersion[];
+    };
+    updatedVersion(): CVRVersion;
+    /**
+     * Tracks rows received from executing queries. This will update row records
+     * and row patches if the received rows have a new version. The method also
+     * returns (put) patches to be returned to update their state, versioned by
+     * patchVersion so that only the patches new to the clients are sent.
+     */
+    received(_: LogContext, rows: Map<RowID, RowUpdate>): Promise<PatchToVersion[]>;
+    /**
+     * Computes and updates the row records based on:
+     * * The {@link #executed} queries
+     * * The {@link #removed} queries
+     * * The {@link received} rows
+     *
+     * Returns the final delete and patch ops that must be sent to the client
+     * to delete rows that are no longer referenced by any query.
+     *
+     * This is Step [5] of the
+     * [CVR Sync Algorithm](https://www.notion.so/replicache/Sync-and-Client-View-Records-CVR-a18e02ec3ec543449ea22070855ff33d?pvs=4#7874f9b80a514be2b8cd5cf538b88d37).
+     */
+    deleteUnreferencedRows(): Promise<PatchToVersion[]>;
+}
+export {};
+//# sourceMappingURL=cvr.d.ts.map

package/out/zero-cache/src/services/view-syncer/cvr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cvr.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/cvr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAKjD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAC;AAE7D,OAAO,KAAK,EAAQ,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAC,aAAa,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,KAAK,EAEX,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE;QAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAC,CAAC;CACrC,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,GAAG,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACtC,CAAC;AAEF,mCAAmC;AAEnC,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CACzD,CAAC;AAaF;;;;;;;;GAQG;AACH,qBAAa,UAAU;;IACrB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IAE7B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAEvC;;;OAGG;gBACS,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW;IAMhD,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU;;;;IAOzC;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,IAAI,UAAU;IAanC,KAAK,CACT,EAAE,EAAE,UAAU,EACd,UAAU,OAAa,GACtB,OAAO,CAAC;QACT,GAAG,EAAE,WAAW,CAAC;QACjB,KAAK,EAAE,aAAa,CAAC;KACtB,CAAC;CAcH;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;;IAyCpD,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAC,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,GAC3B;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAC,EAAE;IA2B3B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IA6BxD,mBAAmB,CAAC,QAAQ,EAAE,MAAM;IAKpC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,UAAU,OAAa;aAhItC,WAAW;eACT,aAAa;;CAmIvB;AAED,KAAK,IAAI,GAAG,MAAM,CAAC;AACnB,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAC5B,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;;IAKnD;;OAEG;gBACS,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW;IAS3E;;;;;;;OAOG;IACH,YAAY,CACV,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAC,EAAE,EACpD,OAAO,EAAE,MAAM,EAAE,GAChB;QAAC,UAAU,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,cAAc,EAAE,CAAA;KAAC;IA2H3D,cAAc,IAAI,UAAU;IAI5B;;;;;OAKG;IACG,QAAQ,CACZ,CAAC,EAAE,UAAU,EACb,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC;IAkE5B;;;;;;;;;;;OAWG;IACG,sBAAsB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAsD1D"}