@revealui/db 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 RevealUI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,137 @@
+# @revealui/db
+
+**Status:** 🟡 Active Development | ⚠️ NOT Production Ready
+
+See [Project Status](../../docs/PROJECT_STATUS.md) for framework readiness.
+
+Database schemas and Drizzle ORM integration for RevealUI.
+
+> **Test Coverage:** ~60% (best coverage in project, but still needs improvement)
+
+## Features
+
+- **Drizzle ORM**: Type-safe database queries with Drizzle
+- **Schema Management**: Database schema definitions for all RevealUI tables
+- **Multiple Providers**: Works with Neon, Supabase, and Vercel Postgres
+- **Type Generation**: Auto-generate TypeScript types from database schema
+- **Migrations**: Database migration management with Drizzle Kit
+- **Type-safe**: Full TypeScript support with inferred types
+
+## Installation
+
+```bash
+pnpm add @revealui/db
+```
+
+## Usage
+
+### Import Database Client
+
+```typescript
+import { createClient } from '@revealui/db/client'
+
+const db = createClient({
+  connectionString: process.env.POSTGRES_URL!
+})
+```
+
+### Import Schemas
+
+```typescript
+// Import all schemas
+import * as schema from '@revealui/db/schema'
+
+// Import specific schemas
+import { users } from '@revealui/db/schema/users'
+import { posts } from '@revealui/db/schema/cms'
+import { agentContexts } from '@revealui/db/schema/agents'
+import { vectorMemory } from '@revealui/db/schema/vector'
+```
+
+### Query Database
+
+```typescript
+import { createClient } from '@revealui/db/client'
+import { users } from '@revealui/db/schema/users'
+import { eq } from 'drizzle-orm'
+
+const db = createClient({ connectionString: process.env.POSTGRES_URL! })
+
+// Query users
+const allUsers = await db.select().from(users)
+
+// Query with filter
+const user = await db.select().from(users).where(eq(users.email, 'user@example.com'))
+
+// Insert user
+await db.insert(users).values({
+  email: 'newuser@example.com',
+  name: 'New User'
+})
+```
+
+## Available Exports
+
+- `@revealui/db` - Main export with database client
+- `@revealui/db/client` - Database client factory
+- `@revealui/db/schema` - All database schemas
+- `@revealui/db/schema/agents` - Agent-related tables
+- `@revealui/db/schema/cms` - CMS tables (posts, pages, media)
+- `@revealui/db/schema/users` - User and authentication tables
+- `@revealui/db/schema/vector` - Vector memory tables
+- `@revealui/db/schema/crdt-operations` - CRDT operation log
+- `@revealui/db/schema/node-ids` - Node ID mapping
+- `@revealui/db/schema/rate-limits` - Rate limiting tables
+- `@revealui/db/schema/sites` - Site configuration tables
+- `@revealui/db/types` - TypeScript types for database entities
+
+## Database Management
+
+```bash
+# Generate types from schema
+pnpm --filter @revealui/db generate:types
+
+# Generate migration files
+pnpm --filter @revealui/db db:generate
+
+# Run migrations
+pnpm --filter @revealui/db db:migrate
+
+# Push schema changes (development only)
+pnpm --filter @revealui/db db:push
+
+# Open Drizzle Studio (database GUI)
+pnpm --filter @revealui/db db:studio
+```
+
+## Type Safety
+
+All database operations are fully type-safe:
+
+```typescript
+import { createClient } from '@revealui/db/client'
+import { users } from '@revealui/db/schema/users'
+
+const db = createClient({ connectionString: process.env.POSTGRES_URL! })
+
+// TypeScript knows the shape of user rows
+const allUsers = await db.select().from(users)
+// allUsers: { id: string, email: string, name: string | null, ... }[]
+
+// Insert is type-checked
+await db.insert(users).values({
+  email: 'test@example.com',
+  name: 'Test User'
+  // TypeScript error if you add invalid fields
+})
+```
+
+## Related Documentation
+
+- [Database Guide](../../docs/DATABASE.md) - Complete database setup and configuration
+- [Database Management](../../docs/DATABASE_MANAGEMENT.md) - Operations and maintenance
+- [Drizzle ORM Docs](https://orm.drizzle.team/) - Official Drizzle documentation
+
+## License
+
+MIT

package/dist/audit-store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Drizzle Audit Store
+ *
+ * Persistent implementation of the AuditStore interface from @revealui/ai.
+ * Stores audit entries in the audit_log PostgreSQL table via Drizzle ORM.
+ * Append-only — no update or delete operations.
+ *
+ * Types are defined locally to avoid a circular dependency on @revealui/ai.
+ * They mirror AuditEntry and AuditFilter from @revealui/ai/audit/types.
+ */
+import type { Database } from './client/index.js';
+/** Audit entry stored in the database */
+export interface AuditEntry {
+    id: string;
+    timestamp: Date;
+    eventType: string;
+    severity: string;
+    agentId: string;
+    taskId?: string;
+    sessionId?: string;
+    payload: Record<string, unknown>;
+    policyViolations: string[];
+}
+/** Filters for querying audit entries */
+export interface AuditFilter {
+    agentId?: string;
+    taskId?: string;
+    sessionId?: string;
+    eventTypes?: string[];
+    severity?: string[];
+    startTime?: Date;
+    endTime?: Date;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * PostgreSQL-backed audit store using Drizzle ORM.
+ * Implements the AuditStore interface for production use.
+ *
+ * All writes are append-only. The table has no UPDATE or DELETE operations.
+ */
+export declare class DrizzleAuditStore {
+    private readonly db;
+    constructor(db: Database);
+    /** Append a single entry to the audit log */
+    append(entry: AuditEntry): Promise<void>;
+    /** Append multiple entries atomically in a single INSERT */
+    appendBatch(entries: AuditEntry[]): Promise<void>;
+    /** Query entries with filters (human-side only) */
+    query(filter: AuditFilter): Promise<AuditEntry[]>;
+    /** Get total entry count (optionally filtered by agent) */
+    count(agentId?: string): Promise<number>;
+    /** Get entries since a given timestamp */
+    since(timestamp: Date, limit?: number): Promise<AuditEntry[]>;
+}
+//# sourceMappingURL=audit-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-store.d.ts","sourceRoot":"","sources":["../src/audit-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAMjD,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;;;GAKG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEzC,6CAA6C;IACvC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,4DAA4D;IACtD,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD,mDAAmD;IAC7C,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoCvD,2DAA2D;IACrD,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,0CAA0C;IACpC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,SAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAUlE"}

package/dist/audit-store.js

@@ -0,0 +1,120 @@
+/**
+ * Drizzle Audit Store
+ *
+ * Persistent implementation of the AuditStore interface from @revealui/ai.
+ * Stores audit entries in the audit_log PostgreSQL table via Drizzle ORM.
+ * Append-only — no update or delete operations.
+ *
+ * Types are defined locally to avoid a circular dependency on @revealui/ai.
+ * They mirror AuditEntry and AuditFilter from @revealui/ai/audit/types.
+ */
+import { and, count, desc, eq, gte, inArray, lte } from 'drizzle-orm';
+import { auditLog } from './schema/audit-log.js';
+// ─── Drizzle Audit Store ────────────────────────────────────────────────────
+/**
+ * PostgreSQL-backed audit store using Drizzle ORM.
+ * Implements the AuditStore interface for production use.
+ *
+ * All writes are append-only. The table has no UPDATE or DELETE operations.
+ */
+export class DrizzleAuditStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Append a single entry to the audit log */
+    async append(entry) {
+        await this.db.insert(auditLog).values({
+            id: entry.id,
+            timestamp: entry.timestamp,
+            eventType: entry.eventType,
+            severity: entry.severity,
+            agentId: entry.agentId,
+            taskId: entry.taskId ?? null,
+            sessionId: entry.sessionId ?? null,
+            payload: entry.payload,
+            policyViolations: entry.policyViolations,
+        });
+    }
+    /** Append multiple entries atomically in a single INSERT */
+    async appendBatch(entries) {
+        if (entries.length === 0)
+            return;
+        await this.db.insert(auditLog).values(entries.map((entry) => ({
+            id: entry.id,
+            timestamp: entry.timestamp,
+            eventType: entry.eventType,
+            severity: entry.severity,
+            agentId: entry.agentId,
+            taskId: entry.taskId ?? null,
+            sessionId: entry.sessionId ?? null,
+            payload: entry.payload,
+            policyViolations: entry.policyViolations,
+        })));
+    }
+    /** Query entries with filters (human-side only) */
+    async query(filter) {
+        const conditions = [];
+        if (filter.agentId) {
+            conditions.push(eq(auditLog.agentId, filter.agentId));
+        }
+        if (filter.taskId) {
+            conditions.push(eq(auditLog.taskId, filter.taskId));
+        }
+        if (filter.sessionId) {
+            conditions.push(eq(auditLog.sessionId, filter.sessionId));
+        }
+        if (filter.eventTypes && filter.eventTypes.length > 0) {
+            conditions.push(inArray(auditLog.eventType, filter.eventTypes));
+        }
+        if (filter.severity && filter.severity.length > 0) {
+            conditions.push(inArray(auditLog.severity, filter.severity));
+        }
+        if (filter.startTime) {
+            conditions.push(gte(auditLog.timestamp, filter.startTime));
+        }
+        if (filter.endTime) {
+            conditions.push(lte(auditLog.timestamp, filter.endTime));
+        }
+        const rows = await this.db
+            .select()
+            .from(auditLog)
+            .where(conditions.length > 0 ? and(...conditions) : undefined)
+            .orderBy(desc(auditLog.timestamp))
+            .limit(filter.limit ?? 1000)
+            .offset(filter.offset ?? 0);
+        return rows.map(rowToEntry);
+    }
+    /** Get total entry count (optionally filtered by agent) */
+    async count(agentId) {
+        const condition = agentId ? eq(auditLog.agentId, agentId) : undefined;
+        const result = await this.db.select({ value: count() }).from(auditLog).where(condition);
+        return result[0]?.value ?? 0;
+    }
+    /** Get entries since a given timestamp */
+    async since(timestamp, limit = 1000) {
+        const rows = await this.db
+            .select()
+            .from(auditLog)
+            .where(gte(auditLog.timestamp, timestamp))
+            .orderBy(desc(auditLog.timestamp))
+            .limit(limit);
+        return rows.map(rowToEntry);
+    }
+}
+// ─── Row Mapping ────────────────────────────────────────────────────────────
+/** Convert a database row to an AuditEntry */
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        timestamp: row.timestamp,
+        eventType: row.eventType,
+        severity: row.severity,
+        agentId: row.agentId,
+        taskId: row.taskId ?? undefined,
+        sessionId: row.sessionId ?? undefined,
+        payload: (row.payload ?? {}),
+        policyViolations: (row.policyViolations ?? []),
+    };
+}
+//# sourceMappingURL=audit-store.js.map

package/dist/audit-store.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,214 @@
+/**
+ * @revealui/db - Database Client
+ *
+ * Provides a configured Drizzle ORM client for PostgreSQL databases.
+ * Supports dual database architecture:
+ * - REST Database (NeonDB): Uses @neondatabase/serverless with drizzle-orm/neon-http
+ * - Vector Database (Supabase): Uses postgres-js with drizzle-orm/postgres-js
+ *
+ * This dual-driver approach avoids the Neon driver's compatibility issue with Supabase,
+ * where it incorrectly transforms Supabase hostnames (aws-0-*.pooler.supabase.com → api.pooler.supabase.com).
+ *
+ * Connection String Format:
+ * - NeonDB: postgresql://...@neon.tech/...
+ * - Supabase: postgresql://...@*.supabase.co:6543/postgres (transaction pooler)
+ * - Supabase: postgresql://...@*.supabase.co:5432/postgres (direct/session pooler)
+ *
+ * Reference:
+ * - Neon: https://orm.drizzle.team/docs/connect-neon
+ * - Supabase: https://orm.drizzle.team/docs/tutorials/drizzle-with-supabase
+ */
+import { type NeonHttpDatabase } from 'drizzle-orm/neon-http';
+import { type NodePgDatabase } from 'drizzle-orm/node-postgres';
+import * as schema from '../schema/index.js';
+import * as restSchema from '../schema/rest.js';
+import * as vectorSchema from '../schema/vector.js';
+export interface PoolMetrics {
+    /** Total connections in pool */
+    totalCount: number;
+    /** Idle connections */
+    idleCount: number;
+    /** Waiting requests */
+    waitingCount: number;
+    /** Pool name/identifier */
+    name: string;
+}
+/**
+ * Database type selector for dual database architecture
+ * - 'rest': NeonDB for transactional REST API operations
+ * - 'vector': Supabase for vector search operations
+ */
+export type DatabaseType = 'rest' | 'vector';
+/**
+ * Database client type (Drizzle ORM client)
+ *
+ * This is the actual database client returned by createClient/getClient.
+ * For the centralized Database type matching Supabase structure, see @revealui/db/types
+ *
+ * Note: This is a union type to support both Neon (REST) and Postgres (Vector) drivers.
+ * The actual type will be NeonHttpDatabase for REST and PgDatabase for Vector.
+ */
+export type Database = NeonHttpDatabase<typeof schema> | NodePgDatabase<typeof schema>;
+export interface DatabaseConfig {
+    connectionString: string;
+    logger?: boolean;
+}
+/**
+ * Creates a Drizzle database client, automatically selecting the appropriate driver:
+ * - Supabase/localhost connections: Uses node-postgres with drizzle-orm/node-postgres
+ * - NeonDB connections: Uses @neondatabase/serverless with drizzle-orm/neon-http
+ *
+ * This dual-driver approach fixes the Neon driver's compatibility issue with Supabase,
+ * where it incorrectly transforms Supabase hostnames. It also enables local testing
+ * with localhost PostgreSQL databases.
+ *
+ * @param config - Database configuration
+ * @param dbSchema - Optional schema to use (defaults to full schema for backward compatibility)
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@revealui/db/client'
+ *
+ * // Automatically uses node-postgres for Supabase
+ * const supabaseDb = createClient({
+ *   connectionString: process.env.DATABASE_URL!, // Supabase URL
+ * })
+ *
+ * // Automatically uses node-postgres for localhost (testing)
+ * const testDb = createClient({
+ *   connectionString: 'postgresql://test:test@localhost:5432/test',
+ * })
+ *
+ * // Automatically uses Neon driver for NeonDB
+ * const neonDb = createClient({
+ *   connectionString: process.env.POSTGRES_URL!, // NeonDB URL
+ * })
+ * ```
+ */
+export declare function createClient(config: DatabaseConfig, dbSchema?: typeof restSchema | typeof vectorSchema | typeof schema): Database;
+/**
+ * Gets or creates a global database client.
+ * Supports dual database architecture with separate clients for REST and Vector operations.
+ * Uses config module if available, otherwise falls back to process.env for backward compatibility.
+ *
+ * @param typeOrConnectionString - Database type ('rest' | 'vector') or connection string (legacy API)
+ * @returns Database client instance
+ *
+ * @example
+ * ```typescript
+ * import { getClient } from '@revealui/db/client'
+ *
+ * // New API: Specify database type
+ * const restDb = getClient('rest')
+ * const vectorDb = getClient('vector')
+ *
+ * // Legacy API: Still supported for backward compatibility
+ * const db = getClient() // defaults to 'rest'
+ * const db2 = getClient('postgresql://...') // uses provided connection string as 'rest'
+ * ```
+ */
+export declare function getClient(typeOrConnectionString?: DatabaseType | string): Database;
+/**
+ * Gets or creates the REST database client (NeonDB).
+ * Convenience function for accessing the REST database.
+ *
+ * @example
+ * ```typescript
+ * import { getRestClient } from '@revealui/db/client'
+ *
+ * const db = getRestClient()
+ * const users = await db.query.users.findMany()
+ * ```
+ */
+export declare function getRestClient(): Database;
+/**
+ * Gets or creates the Vector database client (Supabase).
+ * Convenience function for accessing the vector database.
+ *
+ * @example
+ * ```typescript
+ * import { getVectorClient } from '@revealui/db/client'
+ *
+ * const db = getVectorClient()
+ * const memories = await db.query.agentMemories.findMany()
+ * ```
+ */
+export declare function getVectorClient(): Database;
+/**
+ * Resets the global clients (useful for testing).
+ * Clears both REST and Vector client instances.
+ */
+export declare function resetClient(): void;
+/**
+ * Gets metrics for all active database connection pools.
+ *
+ * @returns Array of pool metrics
+ *
+ * @example
+ * ```typescript
+ * import { getPoolMetrics } from '@revealui/db/client'
+ *
+ * const metrics = getPoolMetrics()
+ * for (const pool of metrics) {
+ *   // Log pool statistics
+ *   logger.info(`${pool.name}: ${pool.totalCount} total, ${pool.idleCount} idle`)
+ * }
+ * ```
+ */
+export declare function getPoolMetrics(): PoolMetrics[];
+/**
+ * Closes all active database connection pools.
+ * This should be called during graceful shutdown.
+ *
+ * @example
+ * ```typescript
+ * import { closeAllPools } from '@revealui/db/client'
+ *
+ * process.on('SIGTERM', async () => {
+ *   await closeAllPools()
+ *   process.exit(0)
+ * })
+ * ```
+ */
+export declare function closeAllPools(): Promise<void>;
+/**
+ * Execute a database transaction with automatic BEGIN/COMMIT/ROLLBACK.
+ *
+ * ⚠️ IMPORTANT: Transaction support depends on the database driver:
+ * - ✅ Supabase/localhost (pg Pool): Full transaction support
+ * - ❌ NeonDB (HTTP driver): Transactions NOT supported
+ *
+ * The Neon HTTP driver (@neondatabase/serverless with neon-http) does not support
+ * transactions because it uses stateless HTTP requests. Each query is independent.
+ *
+ * For transaction support, use:
+ * 1. Supabase with connection pooling (recommended for production)
+ * 2. Localhost PostgreSQL (for development/testing)
+ * 3. Neon with WebSocket driver (coming in future versions)
+ *
+ * @param db - Database client (must be created with pg Pool driver)
+ * @param fn - Transaction callback that receives a transaction context
+ * @returns Result from the transaction callback
+ * @throws {Error} If using Neon HTTP driver (no transaction support)
+ * @throws {Error} If transaction fails (automatic ROLLBACK is performed)
+ *
+ * @example
+ * ```typescript
+ * // ✅ Works with Supabase/localhost (pg Pool driver)
+ * const supabaseDb = getClient('vector') // Uses pg Pool
+ * const result = await withTransaction(supabaseDb, async (tx) => {
+ *   const site = await tx.insert(sites).values({ ... }).returning()
+ *   await tx.insert(pages).values({ siteId: site[0].id, ... })
+ *   return site[0]
+ * })
+ *
+ * // ❌ Throws error with NeonDB (HTTP driver)
+ * const neonDb = getClient('rest') // Uses Neon HTTP
+ * await withTransaction(neonDb, async (tx) => { ... }) // Error!
+ * ```
+ */
+export declare function withTransaction<T>(db: Database, fn: (tx: Database) => Promise<T>): Promise<T>;
+export { schema };
+export type { AgentAction, AgentContext, AgentMemory, Conversation, CRDTOperation, GlobalFooter, GlobalHeader, GlobalSettings, Media, NewAgentAction, NewAgentContext, NewAgentMemory, NewConversation, NewCRDTOperation, NewGlobalFooter, NewGlobalHeader, NewGlobalSettings, NewMedia, NewNodeIdMapping, NewPage, NewPageRevision, NewPost, NewSession, NewSite, NewSiteCollaborator, NewUser, NodeIdMapping, Page, PageRevision, Post, Session, Site, SiteCollaborator, User, } from '../schema/index.js';
+export type { Database as DatabaseSchema, DatabaseClient, QueryResult, QueryResults, RelatedTables, TableRelationships, Transaction, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACrF,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAErF,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAA;AAoBnD,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;CACb;AAMD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,CAAA;AAEtF,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AA0CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,QAAQ,GAAE,OAAO,UAAU,GAAG,OAAO,YAAY,GAAG,OAAO,MAAe,GACzE,QAAQ,CAkCV;AAkCD;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,wBAAgB,SAAS,CAAC,sBAAsB,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,QAAQ,CAqBlF;AAiDD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAa9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBnD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAMD,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,OAAO,EACP,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,gBAAgB,EAChB,IAAI,GACL,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,QAAQ,IAAI,cAAc,EAC1B,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAA"}