@defai.digital/sqlite-adapter 13.0.3

package/dist/fts-store.d.ts

@@ -0,0 +1,137 @@
+/**
+ * FTS5 Full-Text Search Store
+ *
+ * Provides full-text search capabilities using SQLite FTS5 extension.
+ * Used for semantic search over memory items.
+ *
+ * Invariants:
+ * - INV-FTS-001: FTS index updated on every insert/update/delete
+ * - INV-FTS-002: Search results ranked by relevance (BM25)
+ * - INV-FTS-003: Support for phrase and prefix queries
+ */
+import type Database from 'better-sqlite3';
+/**
+ * FTS search result
+ */
+export interface FTSResult {
+    key: string;
+    namespace: string;
+    value: string;
+    snippet: string;
+    rank: number;
+    createdAt: string;
+}
+/**
+ * FTS search options
+ */
+export interface FTSSearchOptions {
+    /** Namespace to search within */
+    namespace?: string | undefined;
+    /** Maximum results to return */
+    limit?: number | undefined;
+    /** Offset for pagination */
+    offset?: number | undefined;
+    /** Highlight snippets around matches */
+    highlight?: boolean | undefined;
+    /** Prefix for highlighted text */
+    highlightPrefix?: string | undefined;
+    /** Suffix for highlighted text */
+    highlightSuffix?: string | undefined;
+}
+/**
+ * FTS item to index
+ */
+export interface FTSItem {
+    key: string;
+    namespace: string;
+    value: string;
+    tags?: string[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Error thrown by FTS store operations
+ */
+export declare class FTSStoreError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Error codes for FTS store
+ */
+export declare const FTSStoreErrorCodes: {
+    readonly INDEX_ERROR: "FTS_INDEX_ERROR";
+    readonly SEARCH_ERROR: "FTS_SEARCH_ERROR";
+    readonly DATABASE_ERROR: "FTS_DATABASE_ERROR";
+};
+/**
+ * SQLite FTS5 Store implementation
+ */
+export declare class SQLiteFTSStore {
+    private readonly db;
+    private readonly tableName;
+    private readonly ftsTableName;
+    constructor(db: Database.Database, tableName?: string);
+    /**
+     * Initializes the database schema with FTS5 support
+     */
+    private initialize;
+    /**
+     * Stores an item with full-text indexing
+     */
+    store(item: FTSItem): void;
+    /**
+     * Retrieves an item by key and namespace
+     */
+    get(key: string, namespace?: string): FTSItem | null;
+    /**
+     * Deletes an item by key and namespace
+     */
+    delete(key: string, namespace?: string): boolean;
+    /**
+     * Full-text search with BM25 ranking
+     * INV-FTS-002: Results ranked by relevance
+     * INV-FTS-003: Supports phrase and prefix queries
+     *
+     * @param query - FTS5 query string (supports AND, OR, NOT, phrases, prefixes)
+     * @param options - Search options
+     */
+    search(query: string, options?: FTSSearchOptions): FTSResult[];
+    /**
+     * Lists all items in a namespace
+     */
+    list(namespace?: string, limit?: number, offset?: number): FTSItem[];
+    /**
+     * Counts items in a namespace
+     */
+    count(namespace?: string): number;
+    /**
+     * Clears all items in a namespace
+     */
+    clear(namespace?: string): number;
+    /**
+     * Rebuilds the FTS index
+     */
+    rebuildIndex(): void;
+    /**
+     * Optimizes the FTS index
+     */
+    optimizeIndex(): void;
+    /**
+     * Gets index statistics
+     */
+    getStats(): {
+        totalItems: number;
+        namespaces: string[];
+        indexSize: number;
+    };
+    /**
+     * Escapes special characters in FTS5 query
+     */
+    private escapeQuery;
+}
+/**
+ * Creates a SQLite FTS store
+ */
+export declare function createSQLiteFTSStore(db: Database.Database, tableName?: string): SQLiteFTSStore;
+//# sourceMappingURL=fts-store.d.ts.map

package/dist/fts-store.d.ts.map

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

package/dist/fts-store.js

@@ -0,0 +1,312 @@
+/**
+ * FTS5 Full-Text Search Store
+ *
+ * Provides full-text search capabilities using SQLite FTS5 extension.
+ * Used for semantic search over memory items.
+ *
+ * Invariants:
+ * - INV-FTS-001: FTS index updated on every insert/update/delete
+ * - INV-FTS-002: Search results ranked by relevance (BM25)
+ * - INV-FTS-003: Support for phrase and prefix queries
+ */
+/**
+ * Error thrown by FTS store operations
+ */
+export class FTSStoreError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'FTSStoreError';
+    }
+}
+/**
+ * Error codes for FTS store
+ */
+export const FTSStoreErrorCodes = {
+    INDEX_ERROR: 'FTS_INDEX_ERROR',
+    SEARCH_ERROR: 'FTS_SEARCH_ERROR',
+    DATABASE_ERROR: 'FTS_DATABASE_ERROR',
+};
+/**
+ * SQLite FTS5 Store implementation
+ */
+export class SQLiteFTSStore {
+    db;
+    tableName;
+    ftsTableName;
+    constructor(db, tableName = 'memory_items') {
+        this.db = db;
+        this.tableName = tableName;
+        this.ftsTableName = `${tableName}_fts`;
+        this.initialize();
+    }
+    /**
+     * Initializes the database schema with FTS5 support
+     */
+    initialize() {
+        // Main table for memory items
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        key TEXT NOT NULL,
+        namespace TEXT NOT NULL DEFAULT 'default',
+        value TEXT NOT NULL,
+        tags TEXT,
+        metadata TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+        UNIQUE(key, namespace)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_namespace
+        ON ${this.tableName}(namespace);
+
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_created_at
+        ON ${this.tableName}(created_at);
+    `);
+        // FTS5 virtual table for full-text search
+        // INV-FTS-002: Using BM25 ranking algorithm
+        this.db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS ${this.ftsTableName} USING fts5(
+        key,
+        namespace,
+        value,
+        tags,
+        content='${this.tableName}',
+        content_rowid='id',
+        tokenize='porter unicode61'
+      );
+    `);
+        // Triggers to keep FTS index in sync (INV-FTS-001)
+        this.db.exec(`
+      CREATE TRIGGER IF NOT EXISTS ${this.tableName}_ai AFTER INSERT ON ${this.tableName} BEGIN
+        INSERT INTO ${this.ftsTableName}(rowid, key, namespace, value, tags)
+        VALUES (new.id, new.key, new.namespace, new.value, new.tags);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS ${this.tableName}_ad AFTER DELETE ON ${this.tableName} BEGIN
+        INSERT INTO ${this.ftsTableName}(${this.ftsTableName}, rowid, key, namespace, value, tags)
+        VALUES ('delete', old.id, old.key, old.namespace, old.value, old.tags);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS ${this.tableName}_au AFTER UPDATE ON ${this.tableName} BEGIN
+        INSERT INTO ${this.ftsTableName}(${this.ftsTableName}, rowid, key, namespace, value, tags)
+        VALUES ('delete', old.id, old.key, old.namespace, old.value, old.tags);
+        INSERT INTO ${this.ftsTableName}(rowid, key, namespace, value, tags)
+        VALUES (new.id, new.key, new.namespace, new.value, new.tags);
+      END;
+    `);
+    }
+    /**
+     * Stores an item with full-text indexing
+     */
+    store(item) {
+        const tagsStr = item.tags?.join(' ') ?? null;
+        const metadataStr = item.metadata ? JSON.stringify(item.metadata) : null;
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO ${this.tableName} (key, namespace, value, tags, metadata)
+        VALUES (?, ?, ?, ?, ?)
+        ON CONFLICT(key, namespace) DO UPDATE SET
+          value = excluded.value,
+          tags = excluded.tags,
+          metadata = excluded.metadata,
+          updated_at = datetime('now')
+      `);
+            stmt.run(item.key, item.namespace, item.value, tagsStr, metadataStr);
+        }
+        catch (error) {
+            throw new FTSStoreError(FTSStoreErrorCodes.INDEX_ERROR, `Failed to store item: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Retrieves an item by key and namespace
+     */
+    get(key, namespace = 'default') {
+        const stmt = this.db.prepare(`
+      SELECT key, namespace, value, tags, metadata
+      FROM ${this.tableName}
+      WHERE key = ? AND namespace = ?
+    `);
+        const row = stmt.get(key, namespace);
+        if (!row) {
+            return null;
+        }
+        return rowToItem(row);
+    }
+    /**
+     * Deletes an item by key and namespace
+     */
+    delete(key, namespace = 'default') {
+        const stmt = this.db.prepare(`
+      DELETE FROM ${this.tableName}
+      WHERE key = ? AND namespace = ?
+    `);
+        const result = stmt.run(key, namespace);
+        return result.changes > 0;
+    }
+    /**
+     * Full-text search with BM25 ranking
+     * INV-FTS-002: Results ranked by relevance
+     * INV-FTS-003: Supports phrase and prefix queries
+     *
+     * @param query - FTS5 query string (supports AND, OR, NOT, phrases, prefixes)
+     * @param options - Search options
+     */
+    search(query, options = {}) {
+        const { namespace, limit = 50, offset = 0, highlight = true, highlightPrefix = '**', highlightSuffix = '**', } = options;
+        try {
+            // Escape special FTS5 characters in query
+            const escapedQuery = this.escapeQuery(query);
+            let sql = `
+        SELECT
+          m.key,
+          m.namespace,
+          m.value,
+          ${highlight ? `highlight(${this.ftsTableName}, 2, '${highlightPrefix}', '${highlightSuffix}')` : 'm.value'} as snippet,
+          bm25(${this.ftsTableName}) as rank,
+          m.created_at
+        FROM ${this.ftsTableName} fts
+        JOIN ${this.tableName} m ON fts.rowid = m.id
+        WHERE ${this.ftsTableName} MATCH ?
+      `;
+            const params = [escapedQuery];
+            if (namespace !== undefined) {
+                sql += ` AND m.namespace = ?`;
+                params.push(namespace);
+            }
+            sql += `
+        ORDER BY rank
+        LIMIT ? OFFSET ?
+      `;
+            params.push(limit, offset);
+            const stmt = this.db.prepare(sql);
+            const rows = stmt.all(...params);
+            return rows.map((row) => ({
+                key: row.key,
+                namespace: row.namespace,
+                value: row.value,
+                snippet: row.snippet,
+                rank: row.rank,
+                createdAt: row.created_at,
+            }));
+        }
+        catch (error) {
+            throw new FTSStoreError(FTSStoreErrorCodes.SEARCH_ERROR, `Search failed: ${error instanceof Error ? error.message : 'Unknown error'}`, { query });
+        }
+    }
+    /**
+     * Lists all items in a namespace
+     */
+    list(namespace = 'default', limit = 100, offset = 0) {
+        const stmt = this.db.prepare(`
+      SELECT key, namespace, value, tags, metadata
+      FROM ${this.tableName}
+      WHERE namespace = ?
+      ORDER BY created_at DESC
+      LIMIT ? OFFSET ?
+    `);
+        const rows = stmt.all(namespace, limit, offset);
+        return rows.map(rowToItem);
+    }
+    /**
+     * Counts items in a namespace
+     */
+    count(namespace) {
+        let sql = `SELECT COUNT(*) as count FROM ${this.tableName}`;
+        const params = [];
+        if (namespace !== undefined) {
+            sql += ` WHERE namespace = ?`;
+            params.push(namespace);
+        }
+        const stmt = this.db.prepare(sql);
+        const row = stmt.get(...params);
+        return row.count;
+    }
+    /**
+     * Clears all items in a namespace
+     */
+    clear(namespace) {
+        let sql = `DELETE FROM ${this.tableName}`;
+        const params = [];
+        if (namespace !== undefined) {
+            sql += ` WHERE namespace = ?`;
+            params.push(namespace);
+        }
+        const stmt = this.db.prepare(sql);
+        const result = stmt.run(...params);
+        return result.changes;
+    }
+    /**
+     * Rebuilds the FTS index
+     */
+    rebuildIndex() {
+        this.db.exec(`INSERT INTO ${this.ftsTableName}(${this.ftsTableName}) VALUES('rebuild')`);
+    }
+    /**
+     * Optimizes the FTS index
+     */
+    optimizeIndex() {
+        this.db.exec(`INSERT INTO ${this.ftsTableName}(${this.ftsTableName}) VALUES('optimize')`);
+    }
+    /**
+     * Gets index statistics
+     */
+    getStats() {
+        const countStmt = this.db.prepare(`SELECT COUNT(*) as count FROM ${this.tableName}`);
+        const countRow = countStmt.get();
+        const nsStmt = this.db.prepare(`SELECT DISTINCT namespace FROM ${this.tableName}`);
+        const nsRows = nsStmt.all();
+        // Approximate index size from page count
+        const sizeStmt = this.db.prepare(`
+      SELECT page_count * page_size as size FROM pragma_page_count(), pragma_page_size()
+    `);
+        const sizeRow = sizeStmt.get();
+        return {
+            totalItems: countRow.count,
+            namespaces: nsRows.map((r) => r.namespace),
+            indexSize: sizeRow?.size ?? 0,
+        };
+    }
+    /**
+     * Escapes special characters in FTS5 query
+     */
+    escapeQuery(query) {
+        // Handle common query patterns
+        // Allow: AND, OR, NOT, quotes for phrases, * for prefix
+        // Escape: - at start, special chars
+        // If query looks like natural language, wrap in quotes for phrase search
+        if (!query.includes('"') && !query.includes('*') && !(/\b(AND|OR|NOT)\b/i.exec(query))) {
+            // Simple query - treat as phrase
+            return `"${query.replace(/"/g, '""')}"`;
+        }
+        return query;
+    }
+}
+/**
+ * Converts a database row to an FTSItem
+ */
+function rowToItem(row) {
+    const item = {
+        key: row.key,
+        namespace: row.namespace,
+        value: row.value,
+    };
+    if (row.tags !== null) {
+        item.tags = row.tags.split(' ').filter((t) => t.length > 0);
+    }
+    if (row.metadata !== null) {
+        item.metadata = JSON.parse(row.metadata);
+    }
+    return item;
+}
+/**
+ * Creates a SQLite FTS store
+ */
+export function createSQLiteFTSStore(db, tableName) {
+    return new SQLiteFTSStore(db, tableName);
+}
+//# sourceMappingURL=fts-store.js.map

package/dist/fts-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { SqliteEventStore, SqliteEventStoreError, SqliteEventStoreErrorCodes, createSqliteEventStore, } from './event-store.js';
+export { SqliteTraceStore, SqliteTraceStoreError, SqliteTraceStoreErrorCodes, createSqliteTraceStore, } from './trace-store.js';
+export { SQLiteFTSStore, FTSStoreError, FTSStoreErrorCodes, createSQLiteFTSStore, type FTSResult, type FTSSearchOptions, type FTSItem, } from './fts-store.js';
+export { SqliteCheckpointStorage, SqliteCheckpointStoreError, SqliteCheckpointStoreErrorCodes, createSqliteCheckpointStorage, } from './checkpoint-store.js';
+export { SqliteDeadLetterStorage, SqliteDeadLetterStoreError, SqliteDeadLetterStoreErrorCodes, createSqliteDeadLetterStorage, } from './dead-letter-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,OAAO,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { SqliteEventStore, SqliteEventStoreError, SqliteEventStoreErrorCodes, createSqliteEventStore, } from './event-store.js';
+export { SqliteTraceStore, SqliteTraceStoreError, SqliteTraceStoreErrorCodes, createSqliteTraceStore, } from './trace-store.js';
+export { SQLiteFTSStore, FTSStoreError, FTSStoreErrorCodes, createSQLiteFTSStore, } from './fts-store.js';
+export { SqliteCheckpointStorage, SqliteCheckpointStoreError, SqliteCheckpointStoreErrorCodes, createSqliteCheckpointStorage, } from './checkpoint-store.js';
+export { SqliteDeadLetterStorage, SqliteDeadLetterStoreError, SqliteDeadLetterStoreErrorCodes, createSqliteDeadLetterStorage, } from './dead-letter-store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GAIrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC"}

package/dist/trace-store.d.ts

@@ -0,0 +1,74 @@
+import type { TraceEvent } from '@defai.digital/contracts';
+import type { TraceStore, TraceSummary } from '@defai.digital/trace-domain';
+import type Database from 'better-sqlite3';
+/**
+ * Error thrown by SQLite trace store operations
+ */
+export declare class SqliteTraceStoreError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Error codes for SQLite trace store
+ */
+export declare const SqliteTraceStoreErrorCodes: {
+    readonly DATABASE_ERROR: "SQLITE_TRACE_DATABASE_ERROR";
+    readonly INVALID_EVENT: "SQLITE_TRACE_INVALID_EVENT";
+};
+/**
+ * SQLite implementation of TraceStore
+ * INV-TR-002: Events are strictly ordered by sequence
+ * INV-TR-004: Each trace is independent and self-contained
+ */
+export declare class SqliteTraceStore implements TraceStore {
+    private readonly db;
+    private readonly eventsTable;
+    private readonly summariesTable;
+    constructor(db: Database.Database, eventsTable?: string, summariesTable?: string);
+    /**
+     * Initializes the database schema
+     */
+    private initialize;
+    /**
+     * Writes a trace event
+     * INV-TR-002: Events must be strictly ordered
+     */
+    write(event: TraceEvent): Promise<void>;
+    /**
+     * Flushes pending writes
+     * For SQLite, this is a no-op since we write immediately
+     */
+    flush(): Promise<void>;
+    /**
+     * Gets all events for a trace
+     * INV-TR-002: Events returned in sequence order
+     */
+    getTrace(traceId: string): Promise<TraceEvent[]>;
+    /**
+     * Gets a specific event
+     */
+    getEvent(traceId: string, eventId: string): Promise<TraceEvent | undefined>;
+    /**
+     * Lists recent traces
+     */
+    listTraces(limit?: number): Promise<TraceSummary[]>;
+    /**
+     * Updates trace summary based on event
+     */
+    private updateSummary;
+    /**
+     * Clears all traces (for testing only)
+     */
+    clear(): void;
+    /**
+     * Deletes a trace and all its events
+     * @returns true if trace existed and was deleted
+     */
+    deleteTrace(traceId: string): Promise<boolean>;
+}
+/**
+ * Creates a SQLite trace store
+ */
+export declare function createSqliteTraceStore(db: Database.Database, eventsTable?: string, summariesTable?: string): SqliteTraceStore;
+//# sourceMappingURL=trace-store.d.ts.map

package/dist/trace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.d.ts","sourceRoot":"","sources":["../src/trace-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAEX;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,SAAiB,EAC5B,cAAc,SAAoB;IAQpC;;OAEG;IACH,OAAO,CAAC,UAAU;IA8ClB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCvC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAahD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAY3E;;OAEG;IACH,UAAU,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAahD;;OAEG;IACH,OAAO,CAAC,aAAa;IA6DrB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAuB/C;AAqGD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,gBAAgB,CAElB"}