@loomwork/plugin-sqlite 0.0.0-stage → 0.1.1

package/dist/SqliteContentStore.d.ts

@@ -0,0 +1,55 @@
+import { type ContentListPage, type ContentListPageOptions, type ContentRef, type ContentStore } from "@loomwork/plugin-content";
+/**
+ * SQLite-backed {@link ContentStore} (the first durable content backend —
+ * ADR 0046 deferred one "until a real requirement lands"; the db-copilot's
+ * evidence retention is that requirement, and `loom sweep content` needs a
+ * file-backed store to operate on). Content-addressed (`sha256:<hex>`),
+ * idempotent by hash, `putStream` per the ADR 0059 outcome contract
+ * (hash-while-spooling). Point it at its own file — blob I/O must not contend
+ * with event-append latency (TS-7 discipline).
+ *
+ * SPI 1.4.0 adds `touch` (a batched `UPDATE … RETURNING`). SPI 1.3.0 (ADR 0055 D5/D6): every blob carries `touched_at`, bumped by EVERY put (a dedup'd
+ * put is a re-citation), so `deleteIfUntouchedSince` is one conditional `DELETE` and
+ * `listPage` is a keyset scan on the `address` primary key. A pre-1.3.0 file is migrated on
+ * open: the column is added and existing blobs are backfilled to the migration time
+ * (conservative — none ages out until a full TTL after the upgrade).
+ */
+export interface SqliteContentStoreOptions {
+    /** Clock for touch times (epoch ms). Default `Date.now`. */
+    now?: () => number;
+}
+export declare class SqliteContentStore implements ContentStore {
+    private readonly db;
+    private readonly now;
+    private readonly insertStmt;
+    private readonly getStmt;
+    private readonly deleteStmt;
+    private readonly deleteIfUntouchedStmt;
+    private readonly pageStmt;
+    private readonly pageBeforeStmt;
+    constructor(dbPath: string, options?: SqliteContentStoreOptions);
+    put(bytes: Uint8Array): Promise<ContentRef>;
+    putStream(stream: AsyncIterable<Uint8Array>): Promise<ContentRef>;
+    get(ref: ContentRef): Promise<Uint8Array | null>;
+    delete(ref: ContentRef): Promise<void>;
+    deleteIfUntouchedSince(ref: ContentRef, cutoffMs: number): Promise<boolean>;
+    touchClock(): Promise<number>;
+    /**
+     * SPI 1.4.0: bump `touched_at` for existing blobs without a put. One `UPDATE … WHERE address
+     * IN (…) RETURNING address` per chunk (bounded bind-variable count), all inside one
+     * transaction so a batch is all-or-nothing. `max()` keeps the time monotonic; an unknown
+     * address matches no row (no insert), and is reported back as missing.
+     */
+    /** One prepared `UPDATE` per distinct chunk size (at most {@link TOUCH_CHUNK} of them): a full chunk is prepared once, not per call. */
+    private readonly touchStatements;
+    private touchStatement;
+    touch(addresses: readonly string[]): Promise<string[]>;
+    listPage(opts?: ContentListPageOptions): Promise<ContentListPage>;
+    /**
+     * One-time upgrade of a pre-1.3.0 file. IMMEDIATE so two processes opening the same file
+     * cannot both add the column; the re-check inside the transaction makes it idempotent.
+     */
+    private migrateTouchedAt;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteContentStore.d.ts.map

package/dist/SqliteContentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteContentStore.d.ts","sourceRoot":"","sources":["../src/SqliteContentStore.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,0BAA0B,CAAC;AAMlC;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqB;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B;IAsC7D,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAM3C,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBjE,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKhD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,sBAAsB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;;;;OAKG;IACH,wIAAwI;IACxI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyC;IAEzE,OAAO,CAAC,cAAc;IAYhB,KAAK,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBtD,QAAQ,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IAc3E;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAelB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/SqliteContentStore.js

@@ -0,0 +1,150 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteContentStore = void 0;
+const node_crypto_1 = require("node:crypto");
+const plugin_content_1 = require("@loomwork/plugin-content");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+/** Bind variables per `touch` UPDATE (SQLite builds cap at 999 on old versions). */
+const TOUCH_CHUNK = 500;
+class SqliteContentStore {
+    db;
+    now;
+    insertStmt;
+    getStmt;
+    deleteStmt;
+    deleteIfUntouchedStmt;
+    pageStmt;
+    pageBeforeStmt;
+    constructor(dbPath, options = {}) {
+        this.now = options.now ?? Date.now;
+        this.db = new better_sqlite3_1.default(dbPath);
+        try {
+            this.db.pragma("journal_mode = WAL");
+            this.db.pragma("synchronous = NORMAL");
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS content_blobs (
+          address TEXT PRIMARY KEY,
+          bytes BLOB NOT NULL,
+          touched_at INTEGER NOT NULL DEFAULT 0
+        );
+      `);
+            this.migrateTouchedAt();
+            // Monotonic bump: a clock stepping back cannot make a re-cited blob look older.
+            this.insertStmt = this.db.prepare(`INSERT INTO content_blobs (address, bytes, touched_at) VALUES (?, ?, ?)
+         ON CONFLICT(address) DO UPDATE SET touched_at = max(touched_at, excluded.touched_at)`);
+            this.getStmt = this.db.prepare("SELECT bytes FROM content_blobs WHERE address = ?");
+            this.deleteStmt = this.db.prepare("DELETE FROM content_blobs WHERE address = ?");
+            this.deleteIfUntouchedStmt = this.db.prepare("DELETE FROM content_blobs WHERE address = ? AND touched_at < ?");
+            this.pageStmt = this.db.prepare(`SELECT address, touched_at AS touchedAt FROM content_blobs
+         WHERE address > ? ORDER BY address LIMIT ?`);
+            this.pageBeforeStmt = this.db.prepare(`SELECT address, touched_at AS touchedAt FROM content_blobs
+         WHERE address > ? AND touched_at < ? ORDER BY address LIMIT ?`);
+        }
+        catch (err) {
+            this.db.close(); // don't leak the file handle if setup fails on a bad/locked file
+            throw err;
+        }
+    }
+    async put(bytes) {
+        const address = `sha256:${(0, node_crypto_1.createHash)("sha256").update(bytes).digest("hex")}`;
+        this.insertStmt.run(address, Buffer.from(bytes), this.now());
+        return { __loomContent: address, size: bytes.byteLength };
+    }
+    async putStream(stream) {
+        // ADR 0059 outcome contract: address of the full sequence, idempotent —
+        // hash while spooling, then a single idempotent insert.
+        const hash = (0, node_crypto_1.createHash)("sha256");
+        const chunks = [];
+        let size = 0;
+        for await (const chunk of stream) {
+            hash.update(chunk);
+            chunks.push(Buffer.from(chunk));
+            size += chunk.byteLength;
+        }
+        const address = `sha256:${hash.digest("hex")}`;
+        this.insertStmt.run(address, Buffer.concat(chunks, size), this.now());
+        return { __loomContent: address, size };
+    }
+    async get(ref) {
+        const row = this.getStmt.get(ref.__loomContent);
+        return row === undefined ? null : new Uint8Array(row.bytes);
+    }
+    async delete(ref) {
+        this.deleteStmt.run(ref.__loomContent);
+    }
+    async deleteIfUntouchedSince(ref, cutoffMs) {
+        return this.deleteIfUntouchedStmt.run(ref.__loomContent, cutoffMs).changes > 0;
+    }
+    async touchClock() {
+        return this.now();
+    }
+    /**
+     * SPI 1.4.0: bump `touched_at` for existing blobs without a put. One `UPDATE … WHERE address
+     * IN (…) RETURNING address` per chunk (bounded bind-variable count), all inside one
+     * transaction so a batch is all-or-nothing. `max()` keeps the time monotonic; an unknown
+     * address matches no row (no insert), and is reported back as missing.
+     */
+    /** One prepared `UPDATE` per distinct chunk size (at most {@link TOUCH_CHUNK} of them): a full chunk is prepared once, not per call. */
+    touchStatements = new Map();
+    touchStatement(size) {
+        let statement = this.touchStatements.get(size);
+        if (statement === undefined) {
+            statement = this.db.prepare(`UPDATE content_blobs SET touched_at = max(touched_at, ?)
+         WHERE address IN (${Array.from({ length: size }, () => "?").join(",")}) RETURNING address`);
+            this.touchStatements.set(size, statement);
+        }
+        return statement;
+    }
+    async touch(addresses) {
+        const unique = [...new Set(addresses)];
+        if (unique.length === 0)
+            return [];
+        const touchedAt = this.now();
+        const present = new Set();
+        this.db.transaction(() => {
+            for (let i = 0; i < unique.length; i += TOUCH_CHUNK) {
+                const chunk = unique.slice(i, i + TOUCH_CHUNK);
+                const rows = this.touchStatement(chunk.length).all(touchedAt, ...chunk);
+                for (const row of rows)
+                    present.add(row.address);
+            }
+        })();
+        return unique.filter((a) => !present.has(a));
+    }
+    async listPage(opts = {}) {
+        const limit = (0, plugin_content_1.contentListPageLimit)(opts.limit);
+        const after = opts.cursor ?? "";
+        const entries = (opts.touchedBefore === undefined
+            ? this.pageStmt.all(after, limit)
+            : this.pageBeforeStmt.all(after, opts.touchedBefore, limit));
+        const last = entries[entries.length - 1];
+        return entries.length === limit && last !== undefined
+            ? { entries, nextCursor: last.address }
+            : { entries };
+    }
+    /**
+     * One-time upgrade of a pre-1.3.0 file. IMMEDIATE so two processes opening the same file
+     * cannot both add the column; the re-check inside the transaction makes it idempotent.
+     */
+    migrateTouchedAt() {
+        const hasColumn = () => this.db.prepare("PRAGMA table_info(content_blobs)").all().some((c) => c.name === "touched_at");
+        if (hasColumn())
+            return;
+        this.db
+            .transaction(() => {
+            if (hasColumn())
+                return;
+            this.db.exec("ALTER TABLE content_blobs ADD COLUMN touched_at INTEGER NOT NULL DEFAULT 0");
+            this.db.prepare("UPDATE content_blobs SET touched_at = ?").run(this.now());
+        })
+            .immediate();
+    }
+    async close() {
+        this.db.close();
+    }
+}
+exports.SqliteContentStore = SqliteContentStore;
+//# sourceMappingURL=SqliteContentStore.js.map

package/dist/SqliteContentStore.js.map

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

package/dist/SqliteDurableStateStore.d.ts

@@ -0,0 +1,26 @@
+import type { DurableStateRecord, DurableStateStore } from "@loomwork/plugin-durable-state";
+/**
+ * SQLite-backed {@link DurableStateStore} (ADR 0051 D2). Point it at the same
+ * DB file as the SqliteEventStore so one backup captures events + carry state.
+ * Own idempotent migration, same pattern as SqliteTimerStore. CAS rides
+ * single-statement atomicity: the guarded INSERT/UPDATE either lands the new
+ * revision or changes nothing, and a zero-change outcome reports the actual
+ * revision in a loud RevisionConflictError.
+ */
+export declare class SqliteDurableStateStore implements DurableStateStore {
+    private readonly db;
+    private readonly loadStmt;
+    private readonly insertStmt;
+    private readonly updateStmt;
+    private readonly revisionStmt;
+    private readonly clearStmt;
+    constructor(dbPath: string);
+    load(key: string): Promise<DurableStateRecord | null>;
+    save(key: string, value: {
+        contractVersion: number;
+        payload: unknown;
+    }, expectedRevision: number): Promise<DurableStateRecord>;
+    clear(key: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteDurableStateStore.d.ts.map

package/dist/SqliteDurableStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteDurableStateStore.d.ts","sourceRoot":"","sources":["../src/SqliteDurableStateStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAU5F;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,MAAM,EAAE,MAAM;IA8BpB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAUrD,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EACpD,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAuBxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/SqliteDurableStateStore.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteDurableStateStore = void 0;
+const plugin_durable_state_1 = require("@loomwork/plugin-durable-state");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+/**
+ * SQLite-backed {@link DurableStateStore} (ADR 0051 D2). Point it at the same
+ * DB file as the SqliteEventStore so one backup captures events + carry state.
+ * Own idempotent migration, same pattern as SqliteTimerStore. CAS rides
+ * single-statement atomicity: the guarded INSERT/UPDATE either lands the new
+ * revision or changes nothing, and a zero-change outcome reports the actual
+ * revision in a loud RevisionConflictError.
+ */
+class SqliteDurableStateStore {
+    db;
+    loadStmt;
+    insertStmt;
+    updateStmt;
+    revisionStmt;
+    clearStmt;
+    constructor(dbPath) {
+        this.db = new better_sqlite3_1.default(dbPath);
+        try {
+            this.db.pragma("journal_mode = WAL");
+            this.db.pragma("synchronous = NORMAL");
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS durable_state (
+          key TEXT PRIMARY KEY,
+          contract_version INTEGER NOT NULL,
+          revision INTEGER NOT NULL,
+          payload TEXT NOT NULL
+        );
+      `);
+            this.loadStmt = this.db.prepare("SELECT contract_version, revision, payload FROM durable_state WHERE key = ?");
+            this.insertStmt = this.db.prepare("INSERT OR IGNORE INTO durable_state (key, contract_version, revision, payload) VALUES (?, ?, 1, ?)");
+            this.updateStmt = this.db.prepare("UPDATE durable_state SET contract_version = ?, revision = ?, payload = ? WHERE key = ? AND revision = ?");
+            this.revisionStmt = this.db.prepare("SELECT revision FROM durable_state WHERE key = ?");
+            this.clearStmt = this.db.prepare("DELETE FROM durable_state WHERE key = ?");
+        }
+        catch (err) {
+            this.db.close(); // don't leak the file handle if setup fails on a bad/locked file
+            throw err;
+        }
+    }
+    async load(key) {
+        const row = this.loadStmt.get(key);
+        if (row === undefined)
+            return null;
+        return {
+            contractVersion: row.contract_version,
+            revision: row.revision,
+            payload: JSON.parse(row.payload),
+        };
+    }
+    async save(key, value, expectedRevision) {
+        const payload = JSON.stringify(value.payload);
+        const changes = expectedRevision === 0
+            ? this.insertStmt.run(key, value.contractVersion, payload).changes
+            : this.updateStmt.run(value.contractVersion, expectedRevision + 1, payload, key, expectedRevision).changes;
+        if (changes === 1) {
+            return {
+                contractVersion: value.contractVersion,
+                revision: expectedRevision + 1,
+                payload: value.payload,
+            };
+        }
+        const row = this.revisionStmt.get(key);
+        throw new plugin_durable_state_1.RevisionConflictError(key, expectedRevision, row?.revision ?? 0);
+    }
+    async clear(key) {
+        this.clearStmt.run(key);
+    }
+    async close() {
+        this.db.close();
+    }
+}
+exports.SqliteDurableStateStore = SqliteDurableStateStore;
+//# sourceMappingURL=SqliteDurableStateStore.js.map

package/dist/SqliteDurableStateStore.js.map

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

package/dist/SqliteEventStore.d.ts

@@ -0,0 +1,55 @@
+import type { EventEnvelope } from "@loomwork/core";
+import type { AppendIfUnchangedResult, EventStore, TipObservation } from "@loomwork/event-runtime";
+export declare class SqliteEventStore implements EventStore {
+    private readonly db;
+    private pageFirstStmt;
+    private pageAfterStmt;
+    private readonly subscribers;
+    constructor(dbPath: string);
+    append(envelope: EventEnvelope): Promise<void>;
+    /**
+     * ADR 0074 D1 — bulk append in ONE transaction. better-sqlite3's `transaction()` wrapper
+     * is synchronous and rolls back on throw, which gives the required atomicity directly:
+     * a UNIQUE(execution_id, sequence) violation part-way aborts the whole statement group,
+     * so no execution is left with a hole.
+     *
+     * Subscribers fire only after the transaction commits — a subscriber must never observe
+     * a batch that could still roll back.
+     */
+    appendBatch(envelopes: readonly EventEnvelope[]): Promise<void>;
+    /**
+     * Which envelope in a rejected batch claimed something already taken — a
+     * `(executionId, sequence)` slot or an envelope `id`, either because the log already held
+     * it or because another envelope in the SAME batch did. Slot first, so a writer that lost
+     * a sequence race is told THAT rather than told about the id its own naming convention
+     * derived from the sequence it lost.
+     */
+    private duplicateIn;
+    /**
+     * SPI 2.2.0 (ADR 0116 amendment) — existence, head and the (always 0: SQLite does not fence)
+     * token are checked and the row inserted inside ONE `BEGIN IMMEDIATE` transaction, so a
+     * retention delete or another process's append cannot slip between the check and the write.
+     */
+    appendIfUnchanged(executionId: string, event: EventEnvelope | null, expect?: TipObservation): Promise<AppendIfUnchangedResult>;
+    read(executionId: string): Promise<EventEnvelope[]>;
+    readFrom(executionId: string, fromSequence: number): Promise<EventEnvelope[]>;
+    head(executionId: string): Promise<number | null>;
+    readRange(executionId: string, fromSequence: number, toSequence: number): Promise<EventEnvelope[]>;
+    copyPrefix(fromExecutionId: string, toExecutionId: string, throughSequence: number, metadata: Record<string, unknown>): Promise<void>;
+    subscribe(executionId: string, handler: (event: EventEnvelope) => void): Promise<() => void>;
+    deleteExecution(executionId: string): Promise<void>;
+    deleteThrough(executionId: string, through: number): Promise<void>;
+    truncatePrefix(executionId: string, throughSequence: number): Promise<void>;
+    truncatePrefixKeeping(executionId: string, throughSequence: number, keepEventTypes: readonly string[]): Promise<void>;
+    listExecutions(): Promise<string[]>;
+    listExecutionsPage(opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        executionIds: string[];
+        nextCursor?: string;
+    }>;
+    close(): Promise<void>;
+    private notify;
+}
+//# sourceMappingURL=SqliteEventStore.d.ts.map

package/dist/SqliteEventStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteEventStore.d.ts","sourceRoot":"","sources":["../src/SqliteEventStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAgEnG,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;gBAE5C,MAAM,EAAE,MAAM;IAYpB,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCpD;;;;;;;;OAQG;IACG,WAAW,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCrE;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;;OAIG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,uBAAuB,CAAC;IAkE7B,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASnD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAS7E,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASjD,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC;IAUrB,UAAU,CACd,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAoBV,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GACtC,OAAO,CAAC,MAAM,IAAI,CAAC;IAIhB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3E,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAAC,IAAI,CAAC;IAUV,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQnC,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,MAAM;CAGf"}