@vibesdotdev/localdb 0.0.1

package/dist/core/database.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Local Database Manager
+ *
+ * High-level API for managing local SQLite databases in vibes dev.
+ * Provides connection pooling, migration management, and consistent configuration.
+ *
+ * Usage:
+ *   const db = localdb.getDatabase('atlas', '.vibes/atlas/project.db');
+ *   // db is ready to use with WAL mode, busy timeout, and migrations applied
+ */
+import { Database } from 'bun:sqlite';
+import { type Migration } from './migration-registry.ts';
+export interface DatabaseOptions {
+    /** Namespace for migrations (e.g., 'atlas', 'session') */
+    namespace: string;
+    /** Path to database file */
+    dbPath: string;
+    /** Consumer identifier for debugging */
+    consumer?: string;
+    /** Skip migration check/run on initialization */
+    skipMigrations?: boolean;
+    /** Use connection pool (default: true) */
+    usePool?: boolean;
+}
+export declare class LocalDatabase {
+    private db;
+    private options;
+    private initialized;
+    constructor(options: DatabaseOptions);
+    /**
+     * Initialize the database connection
+     * - Creates directory if needed
+     * - Gets/creates pooled connection
+     * - Runs pending migrations
+     */
+    initialize(): Promise<void>;
+    /**
+     * Establish initial connection
+     */
+    private establishConnection;
+    /**
+     * Perform recovery from migration failure
+     * 1. Close connection
+     * 2. Backup corrupted DB
+     * 3. Delete corrupted DB
+     * 4. Re-initialize fresh DB
+     * 5. Re-run migrations
+     */
+    private performRecovery;
+    private pruneBackupFiles;
+    /**
+     * Configure database with optimal settings (for non-pooled connections)
+     */
+    private configureDatabase;
+    /**
+     * Get the underlying Database instance
+     */
+    getDatabase(): Database;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+    /**
+     * Check if database is healthy
+     */
+    healthCheck(): boolean;
+    /**
+     * Get migration status for this database
+     */
+    getMigrationStatus(): {
+        namespace: string;
+        currentVersion: number;
+        targetVersion: number;
+        pendingMigrations: number;
+        migrations: Array<{
+            version: number;
+            name: string;
+            applied: boolean;
+        }>;
+    };
+}
+/**
+ * LocalDB Manager
+ * Main entry point for accessing local databases
+ */
+declare class LocalDBManager {
+    private databases;
+    private dbPathLocks;
+    private withDbPathLock;
+    /**
+     * Register migrations for a namespace
+     * Must be called before getDatabase() for that namespace
+     */
+    registerMigrations(namespace: string, migrations: Migration[]): void;
+    /**
+     * Get or create a database instance
+     *
+     * @param namespace Migration namespace (e.g., 'atlas', 'session')
+     * @param dbPath Path to database file
+     * @param consumer Consumer identifier for debugging
+     * @returns Initialized database instance
+     */
+    getDatabase(namespace: string, dbPath: string, consumer?: string): Promise<LocalDatabase>;
+    /**
+     * Get a raw Database instance (auto-configured with WAL, etc.)
+     * For when you don't need migration management
+     */
+    getRawDatabase(dbPath: string, consumer?: string): Database;
+    /**
+     * Release a database instance
+     */
+    releaseDatabase(namespace: string, dbPath: string): Promise<void>;
+    /**
+     * Get connection pool statistics
+     */
+    getPoolStats(): import("./connection-pool.ts").ConnectionStats;
+    /**
+     * Get migration registry status
+     */
+    getMigrationStatus(): {
+        namespace: string;
+        currentVersion: number;
+        targetVersion: number;
+        pendingMigrations: number;
+    }[];
+    /**
+     * List all registered migration namespaces
+     */
+    listNamespaces(): string[];
+    /**
+     * Close all database connections
+     */
+    closeAll(): Promise<void>;
+}
+export declare const localdb: LocalDBManager;
+export {};
+//# sourceMappingURL=database.d.ts.map

package/dist/core/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAqB5E,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD,qBAAa,aAAa;IACzB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,eAAe;IASpC;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;;;;;;OAOG;YACW,eAAe;YA4Df,gBAAgB;IAoB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,WAAW,IAAI,QAAQ;IAOvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb;;OAEG;IACH,WAAW,IAAI,OAAO;IAWtB;;OAEG;IACH,kBAAkB;;;;;;;;;;;CAOlB;AAED;;;GAGG;AACH,cAAM,cAAc;IACnB,OAAO,CAAC,SAAS,CAMb;IACJ,OAAO,CAAC,WAAW,CAAoC;YAEzC,cAAc;IAmB5B;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IAIpE;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BzF;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,QAAQ;IAI1D;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE;;OAEG;IACH,YAAY;IAIZ;;OAEG;IACH,kBAAkB;;;;;;IAIlB;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B;AAGD,eAAO,MAAM,OAAO,gBAAuB,CAAC"}

package/dist/core/database.js

@@ -0,0 +1,347 @@
+/**
+ * Local Database Manager
+ *
+ * High-level API for managing local SQLite databases in vibes dev.
+ * Provides connection pooling, migration management, and consistent configuration.
+ *
+ * Usage:
+ *   const db = localdb.getDatabase('atlas', '.vibes/atlas/project.db');
+ *   // db is ready to use with WAL mode, busy timeout, and migrations applied
+ */
+import { Database } from 'bun:sqlite';
+import { getLogger } from '@vibesdotdev/logging';
+import { connectionPool } from "./connection-pool.js";
+import { migrationRegistry } from "./migration-registry.js";
+import { toErrorContext } from './error-context.js';
+import { isLocaldbServerRuntime } from "./runtime.js";
+const logger = getLogger('localdb:database');
+let mkdir;
+let copyFile;
+let unlink;
+let readdir;
+let dirname;
+let basename;
+const BACKUP_RETENTION_COUNT = 12;
+const isServerRuntime = isLocaldbServerRuntime();
+if (isServerRuntime) {
+    ({ mkdir, copyFile, unlink, readdir } = await import('node:fs/promises'));
+    ({ dirname, basename } = await import('node:path'));
+}
+function isFileMissingError(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    return error.code === 'ENOENT';
+}
+export class LocalDatabase {
+    db;
+    options;
+    initialized = false;
+    constructor(options) {
+        this.options = {
+            consumer: 'unknown',
+            skipMigrations: false,
+            usePool: true,
+            ...options
+        };
+    }
+    /**
+     * Initialize the database connection
+     * - Creates directory if needed
+     * - Gets/creates pooled connection
+     * - Runs pending migrations
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        // Ensure directory exists
+        if (!isServerRuntime) {
+            throw new Error('LocalDatabase is not available in browser builds');
+        }
+        await mkdir(dirname(this.options.dbPath), { recursive: true });
+        // Get connection (pooled or direct)
+        this.establishConnection();
+        // Run migrations if needed
+        if (!this.options.skipMigrations) {
+            try {
+                // Check for incompatible database from old migration system
+                if (migrationRegistry.isIncompatibleDatabase(this.db, this.options.namespace)) {
+                    logger.error(`[LocalDB] Detected incompatible database for ${this.options.namespace} (from legacy migration system). Initiating recovery...`);
+                    await this.performRecovery();
+                }
+                else if (migrationRegistry.needsMigration(this.db, this.options.namespace)) {
+                    await migrationRegistry.runMigrations(this.db, this.options.namespace);
+                }
+            }
+            catch (error) {
+                logger.error(`[LocalDB] Migration failed for ${this.options.namespace}. Initiating automatic recovery/trapdoor...`, toErrorContext(error));
+                await this.performRecovery();
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Establish initial connection
+     */
+    establishConnection() {
+        if (this.options.usePool) {
+            this.db = connectionPool.getConnection(this.options.dbPath, this.options.consumer);
+        }
+        else {
+            // Direct connection (for special cases)
+            this.db = new Database(this.options.dbPath);
+            this.configureDatabase(this.db);
+        }
+    }
+    /**
+     * Perform recovery from migration failure
+     * 1. Close connection
+     * 2. Backup corrupted DB
+     * 3. Delete corrupted DB
+     * 4. Re-initialize fresh DB
+     * 5. Re-run migrations
+     */
+    async performRecovery() {
+        // 1. Close the broken database
+        if (this.options.usePool) {
+            connectionPool.closeConnection(this.options.dbPath, true);
+        }
+        else {
+            this.db.close();
+        }
+        // 2. Backup the broken file
+        const backupPath = `${this.options.dbPath}.bak-${Date.now()}`;
+        try {
+            await copyFile(this.options.dbPath, backupPath);
+            logger.info(`[LocalDB] Backed up corrupted database to: ${backupPath}`);
+            await this.pruneBackupFiles();
+        }
+        catch (backupError) {
+            logger.error('[LocalDB] Failed to backup corrupted database:', toErrorContext(backupError));
+        }
+        // 3. Delete the broken file and WAL artifacts
+        try {
+            await unlink(this.options.dbPath);
+            await unlink(`${this.options.dbPath}-wal`).catch(() => { });
+            await unlink(`${this.options.dbPath}-shm`).catch(() => { });
+            logger.info('[LocalDB] Deleted corrupted database file.');
+        }
+        catch (deleteError) {
+            if (isFileMissingError(deleteError)) {
+                logger.info('[LocalDB] Corrupted database file already removed during recovery. Continuing...');
+            }
+            else {
+                logger.error('[LocalDB] Failed to delete corrupted database:', toErrorContext(deleteError));
+                throw deleteError; // If we can't delete, we can't recover.
+            }
+        }
+        // 4. Re-establish connection (creates new DB file)
+        logger.info('[LocalDB] Re-initializing fresh database...');
+        this.establishConnection();
+        // 5. Re-run migrations on fresh DB
+        try {
+            if (migrationRegistry.needsMigration(this.db, this.options.namespace)) {
+                await migrationRegistry.runMigrations(this.db, this.options.namespace);
+            }
+            logger.info('[LocalDB] Recovery successful. Database reset.');
+        }
+        catch (retryError) {
+            logger.error('[LocalDB] Recovery failed. Fresh database migration failed:', toErrorContext(retryError));
+            throw retryError;
+        }
+    }
+    async pruneBackupFiles() {
+        const directory = dirname(this.options.dbPath);
+        const filename = basename(this.options.dbPath);
+        const backupPrefix = `${filename}.bak-`;
+        const files = await readdir(directory).catch(() => []);
+        const backups = files
+            .filter((entry) => entry.startsWith(backupPrefix))
+            .map((entry) => ({ entry, timestamp: Number(entry.slice(backupPrefix.length)) }))
+            .sort((a, b) => {
+            if (Number.isNaN(a.timestamp) || Number.isNaN(b.timestamp)) {
+                return b.entry.localeCompare(a.entry);
+            }
+            return b.timestamp - a.timestamp;
+        });
+        for (const backup of backups.slice(BACKUP_RETENTION_COUNT)) {
+            await unlink(`${directory}/${backup.entry}`).catch(() => { });
+        }
+    }
+    /**
+     * Configure database with optimal settings (for non-pooled connections)
+     */
+    configureDatabase(db) {
+        db.exec('PRAGMA journal_mode = WAL;');
+        db.exec('PRAGMA busy_timeout = 5000;');
+        db.exec('PRAGMA foreign_keys = ON;');
+        db.exec('PRAGMA synchronous = NORMAL;');
+        db.exec('PRAGMA temp_store = MEMORY;');
+    }
+    /**
+     * Get the underlying Database instance
+     */
+    getDatabase() {
+        if (!this.initialized) {
+            throw new Error('Database not initialized. Call initialize() first.');
+        }
+        return this.db;
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        if (!this.initialized)
+            return;
+        if (this.options.usePool) {
+            // Release back to pool
+            connectionPool.releaseConnection(this.options.dbPath);
+        }
+        else {
+            // Direct close
+            this.db.close();
+        }
+        this.initialized = false;
+    }
+    /**
+     * Check if database is healthy
+     */
+    healthCheck() {
+        if (!this.initialized)
+            return false;
+        try {
+            const result = this.db.query('SELECT 1').get();
+            return result !== null;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get migration status for this database
+     */
+    getMigrationStatus() {
+        if (!this.initialized) {
+            throw new Error('Database not initialized');
+        }
+        return migrationRegistry.getDatabaseStatus(this.db, this.options.namespace);
+    }
+}
+/**
+ * LocalDB Manager
+ * Main entry point for accessing local databases
+ */
+class LocalDBManager {
+    databases = new Map();
+    dbPathLocks = new Map();
+    async withDbPathLock(dbPath, task) {
+        const prior = this.dbPathLocks.get(dbPath) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => {
+            release = resolve;
+        });
+        const queued = prior.then(() => current);
+        this.dbPathLocks.set(dbPath, queued);
+        await prior;
+        try {
+            return await task();
+        }
+        finally {
+            release?.();
+            if (this.dbPathLocks.get(dbPath) === queued) {
+                this.dbPathLocks.delete(dbPath);
+            }
+        }
+    }
+    /**
+     * Register migrations for a namespace
+     * Must be called before getDatabase() for that namespace
+     */
+    registerMigrations(namespace, migrations) {
+        migrationRegistry.register(namespace, migrations);
+    }
+    /**
+     * Get or create a database instance
+     *
+     * @param namespace Migration namespace (e.g., 'atlas', 'session')
+     * @param dbPath Path to database file
+     * @param consumer Consumer identifier for debugging
+     * @returns Initialized database instance
+     */
+    getDatabase(namespace, dbPath, consumer) {
+        const key = `${namespace}:${dbPath}`;
+        return this.withDbPathLock(dbPath, async () => {
+            const existing = this.databases.get(key);
+            if (existing) {
+                existing.references += 1;
+                return existing.database;
+            }
+            if (!this.databases.has(key)) {
+                const db = new LocalDatabase({
+                    namespace,
+                    dbPath,
+                    consumer
+                });
+                await db.initialize();
+                this.databases.set(key, {
+                    database: db,
+                    references: 1
+                });
+            }
+            return this.databases.get(key).database;
+        });
+    }
+    /**
+     * Get a raw Database instance (auto-configured with WAL, etc.)
+     * For when you don't need migration management
+     */
+    getRawDatabase(dbPath, consumer = 'raw') {
+        return connectionPool.getConnection(dbPath, consumer);
+    }
+    /**
+     * Release a database instance
+     */
+    async releaseDatabase(namespace, dbPath) {
+        const key = `${namespace}:${dbPath}`;
+        await this.withDbPathLock(dbPath, async () => {
+            const entry = this.databases.get(key);
+            if (!entry)
+                return;
+            entry.references = Math.max(0, entry.references - 1);
+            if (entry.references === 0) {
+                await entry.database.close();
+                this.databases.delete(key);
+            }
+        });
+    }
+    /**
+     * Get connection pool statistics
+     */
+    getPoolStats() {
+        return connectionPool.getStats();
+    }
+    /**
+     * Get migration registry status
+     */
+    getMigrationStatus() {
+        return migrationRegistry.getStatus();
+    }
+    /**
+     * List all registered migration namespaces
+     */
+    listNamespaces() {
+        return migrationRegistry.listNamespaces();
+    }
+    /**
+     * Close all database connections
+     */
+    async closeAll() {
+        for (const entry of this.databases.values()) {
+            await entry.database.close();
+        }
+        this.databases.clear();
+        connectionPool.closeAll();
+    }
+}
+// Singleton instance
+export const localdb = new LocalDBManager();
+//# sourceMappingURL=database.js.map

package/dist/core/database.js.map

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

package/dist/core/error-context.d.ts

@@ -0,0 +1,2 @@
+export declare function toErrorContext(error: unknown): Record<string, unknown> | undefined;
+//# sourceMappingURL=error-context.d.ts.map

package/dist/core/error-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../src/core/error-context.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkBlF"}

package/dist/core/error-context.js

@@ -0,0 +1,17 @@
+export function toErrorContext(error) {
+    if (error instanceof Error) {
+        return {
+            error: error.message,
+            name: error.name,
+            stack: error.stack
+        };
+    }
+    if (typeof error === 'object' && error !== null && !Array.isArray(error)) {
+        return error;
+    }
+    if (error === undefined) {
+        return undefined;
+    }
+    return { error: String(error) };
+}
+//# sourceMappingURL=error-context.js.map

package/dist/core/error-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.js","sourceRoot":"","sources":["../../src/core/error-context.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO;YACN,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAgC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/dist/core/migration-registry.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Migration Registry
+ *
+ * Centralized registration and execution of database migrations.
+ * Consumers register their migrations with the registry, which ensures
+ * they run in order with proper error handling and version tracking.
+ */
+import type { Database } from 'bun:sqlite';
+export interface MigrationFunction {
+    (db: Database): void | Promise<void>;
+}
+export interface Migration {
+    version: number;
+    name: string;
+    up: MigrationFunction;
+    down?: MigrationFunction;
+}
+export interface MigrationNamespace {
+    namespace: string;
+    migrations: Migration[];
+    currentVersion: number;
+}
+declare class MigrationRegistry {
+    private namespaces;
+    private hasVersionTable;
+    private ensureVersionTable;
+    private getLegacyUserVersion;
+    private getTrackedSchemaVersion;
+    private bootstrapSchemaVersion;
+    /**
+     * Register migrations for a namespace (e.g., 'atlas', 'session')
+     */
+    register(namespace: string, migrations: Migration[]): void;
+    /**
+     * Get current schema version from database
+     */
+    getSchemaVersion(db: Database, namespace: string): number;
+    /**
+     * Set schema version in database
+     */
+    private setSchemaVersion;
+    /**
+     * Check if database needs migration
+     */
+    needsMigration(db: Database, namespace: string): boolean;
+    /**
+     * Check if database is from an incompatible/old migration system
+     * This happens when the version is higher than our max (legacy system)
+     */
+    isIncompatibleDatabase(db: Database, namespace: string): boolean;
+    /**
+     * Run all pending migrations for a namespace
+     */
+    runMigrations(db: Database, namespace: string): Promise<void>;
+    /**
+     * Get migration status for all namespaces
+     */
+    getStatus(): Array<{
+        namespace: string;
+        currentVersion: number;
+        targetVersion: number;
+        pendingMigrations: number;
+    }>;
+    /**
+     * Get migration status for a specific database and namespace
+     */
+    getDatabaseStatus(db: Database, namespace: string): {
+        namespace: string;
+        currentVersion: number;
+        targetVersion: number;
+        pendingMigrations: number;
+        migrations: Array<{
+            version: number;
+            name: string;
+            applied: boolean;
+        }>;
+    };
+    /**
+     * List all registered namespaces
+     */
+    listNamespaces(): string[];
+    /**
+     * Get migrations for a namespace
+     */
+    getMigrations(namespace: string): Migration[];
+}
+export declare const migrationRegistry: MigrationRegistry;
+export {};
+//# sourceMappingURL=migration-registry.d.ts.map

package/dist/core/migration-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-registry.d.ts","sourceRoot":"","sources":["../../src/core/migration-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,MAAM,WAAW,iBAAiB;IACjC,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,iBAAiB,CAAC;IACtB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,cAAM,iBAAiB;IACtB,OAAO,CAAC,UAAU,CAAyC;IAE3D,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IA8B1D;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAIzD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAUxD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAchE;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCnE;;OAEG;IACH,SAAS,IAAI,KAAK,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAoBF;;OAEG;IACH,iBAAiB,CAChB,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GACf;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KACvE;IAsBD;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE;CAO7C;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}