@stackmemoryai/stackmemory 0.3.1 → 0.3.5

package/dist/core/database/connection-pool.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/core/database/connection-pool.ts"],
-  "sourcesContent": ["/**\n * SQLite Connection Pool\n * Manages a pool of SQLite database connections for performance optimization\n */\n\nimport Database from 'better-sqlite3';\nimport { createTracedDatabase, TracedDatabaseOptions } from '../trace/db-trace-wrapper.js';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface ConnectionPoolOptions extends TracedDatabaseOptions {\n  maxConnections?: number;\n  acquireTimeoutMs?: number;\n  idleTimeoutMs?: number;\n  checkInterval?: number;\n}\n\nexport interface PooledConnection {\n  db: Database.Database;\n  id: string;\n  createdAt: number;\n  lastUsed: number;\n  inUse: boolean;\n}\n\nexport class SQLiteConnectionPool {\n  private connections: Map<string, PooledConnection> = new Map();\n  private filename: string;\n  private options: ConnectionPoolOptions;\n  private maxConnections: number;\n  private acquireTimeoutMs: number;\n  private idleTimeoutMs: number;\n  private cleanupInterval: NodeJS.Timeout | null = null;\n  \n  // Statistics\n  private stats = {\n    totalCreated: 0,\n    totalAcquired: 0,\n    totalReleased: 0,\n    currentActive: 0,\n    currentIdle: 0,\n  };\n\n  constructor(filename: string, options: ConnectionPoolOptions = {}) {\n    this.filename = filename;\n    this.options = options;\n    this.maxConnections = options.maxConnections ?? 5;\n    this.acquireTimeoutMs = options.acquireTimeoutMs ?? 5000;\n    this.idleTimeoutMs = options.idleTimeoutMs ?? 300000; // 5 minutes\n    \n    // Start cleanup interval\n    if (options.checkInterval !== 0) {\n      this.cleanupInterval = setInterval(\n        () => this.cleanup(),\n        options.checkInterval ?? 60000 // 1 minute\n      );\n    }\n\n    logger.info('SQLite connection pool initialized', {\n      filename,\n      maxConnections: this.maxConnections,\n      acquireTimeoutMs: this.acquireTimeoutMs,\n      idleTimeoutMs: this.idleTimeoutMs,\n    });\n  }\n\n  /**\n   * Acquire a connection from the pool\n   */\n  async acquire(): Promise<PooledConnection> {\n    const startTime = Date.now();\n    \n    while (Date.now() - startTime < this.acquireTimeoutMs) {\n      // Try to find an idle connection\n      for (const [id, connection] of this.connections) {\n        if (!connection.inUse) {\n          connection.inUse = true;\n          connection.lastUsed = Date.now();\n          this.stats.totalAcquired++;\n          this.stats.currentActive++;\n          this.stats.currentIdle--;\n          \n          logger.debug('Reused connection from pool', { connectionId: id });\n          return connection;\n        }\n      }\n\n      // Create new connection if under limit\n      if (this.connections.size < this.maxConnections) {\n        return this.createConnection();\n      }\n\n      // Wait briefly before retrying\n      await new Promise(resolve => setTimeout(resolve, 10));\n    }\n\n    throw new Error(`Failed to acquire connection within ${this.acquireTimeoutMs}ms timeout`);\n  }\n\n  /**\n   * Release a connection back to the pool\n   */\n  release(connection: PooledConnection): void {\n    if (this.connections.has(connection.id)) {\n      connection.inUse = false;\n      connection.lastUsed = Date.now();\n      this.stats.totalReleased++;\n      this.stats.currentActive--;\n      this.stats.currentIdle++;\n      \n      logger.debug('Released connection to pool', { connectionId: connection.id });\n    }\n  }\n\n  /**\n   * Execute a function with a pooled connection\n   */\n  async withConnection<T>(fn: (db: Database.Database) => T | Promise<T>): Promise<T> {\n    const connection = await this.acquire();\n    try {\n      return await fn(connection.db);\n    } finally {\n      this.release(connection);\n    }\n  }\n\n  /**\n   * Execute a transaction with a pooled connection\n   */\n  async withTransaction<T>(fn: (db: Database.Database) => T): Promise<T> {\n    const connection = await this.acquire();\n    try {\n      const transaction = connection.db.transaction(() => fn(connection.db));\n      return transaction();\n    } finally {\n      this.release(connection);\n    }\n  }\n\n  /**\n   * Get pool statistics\n   */\n  getStats() {\n    return {\n      ...this.stats,\n      totalConnections: this.connections.size,\n      maxConnections: this.maxConnections,\n    };\n  }\n\n  /**\n   * Close all connections and cleanup\n   */\n  async close(): Promise<void> {\n    if (this.cleanupInterval) {\n      clearInterval(this.cleanupInterval);\n      this.cleanupInterval = null;\n    }\n\n    for (const [id, connection] of this.connections) {\n      try {\n        connection.db.close();\n        logger.debug('Closed connection', { connectionId: id });\n      } catch (error) {\n        logger.warn('Error closing connection', {\n          connectionId: id,\n          error: (error as Error).message,\n        });\n      }\n    }\n\n    this.connections.clear();\n    this.stats.currentActive = 0;\n    this.stats.currentIdle = 0;\n    \n    logger.info('Connection pool closed', { \n      totalCreated: this.stats.totalCreated,\n      totalAcquired: this.stats.totalAcquired,\n      totalReleased: this.stats.totalReleased,\n    });\n  }\n\n  /**\n   * Create a new connection\n   */\n  private createConnection(): PooledConnection {\n    const id = `conn_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    const now = Date.now();\n    \n    const db = createTracedDatabase(this.filename, this.options);\n    \n    // Configure for performance\n    db.pragma('journal_mode = WAL');\n    db.pragma('synchronous = NORMAL');\n    db.pragma('cache_size = 1000');\n    db.pragma('temp_store = MEMORY');\n    \n    const connection: PooledConnection = {\n      db,\n      id,\n      createdAt: now,\n      lastUsed: now,\n      inUse: true,\n    };\n\n    this.connections.set(id, connection);\n    this.stats.totalCreated++;\n    this.stats.totalAcquired++;\n    this.stats.currentActive++;\n\n    logger.debug('Created new connection', { \n      connectionId: id,\n      totalConnections: this.connections.size,\n    });\n\n    return connection;\n  }\n\n  /**\n   * Clean up idle connections\n   */\n  private cleanup(): void {\n    const now = Date.now();\n    const toRemove: string[] = [];\n\n    for (const [id, connection] of this.connections) {\n      if (!connection.inUse && now - connection.lastUsed > this.idleTimeoutMs) {\n        toRemove.push(id);\n      }\n    }\n\n    for (const id of toRemove) {\n      const connection = this.connections.get(id);\n      if (connection) {\n        try {\n          connection.db.close();\n          this.connections.delete(id);\n          this.stats.currentIdle--;\n          \n          logger.debug('Cleaned up idle connection', { \n            connectionId: id,\n            idleTime: now - connection.lastUsed,\n          });\n        } catch (error) {\n          logger.warn('Error cleaning up connection', {\n            connectionId: id,\n            error: (error as Error).message,\n          });\n        }\n      }\n    }\n\n    if (toRemove.length > 0) {\n      logger.info('Connection cleanup completed', {\n        removed: toRemove.length,\n        remaining: this.connections.size,\n      });\n    }\n  }\n}\n\n// Global pool instance\nlet globalPool: SQLiteConnectionPool | null = null;\n\n/**\n * Get or create the global connection pool\n */\nexport function getConnectionPool(\n  filename?: string, \n  options?: ConnectionPoolOptions\n): SQLiteConnectionPool {\n  if (!globalPool && filename) {\n    globalPool = new SQLiteConnectionPool(filename, options);\n  }\n  \n  if (!globalPool) {\n    throw new Error('Connection pool not initialized. Call with filename first.');\n  }\n  \n  return globalPool;\n}\n\n/**\n * Close the global connection pool\n */\nexport async function closeGlobalPool(): Promise<void> {\n  if (globalPool) {\n    await globalPool.close();\n    globalPool = null;\n  }\n}"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Connection Pool Manager for ParadeDB\n * Manages PostgreSQL connection pooling with health checks and monitoring\n */\n\nimport { Pool, PoolClient, PoolConfig } from 'pg';\nimport { EventEmitter } from 'events';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface ConnectionPoolConfig extends PoolConfig {\n  // Basic pool settings\n  min?: number; // Minimum pool size (default: 2)\n  max?: number; // Maximum pool size (default: 10)\n  idleTimeoutMillis?: number; // Close idle connections after ms (default: 30000)\n  connectionTimeoutMillis?: number; // Connection acquire timeout (default: 5000)\n\n  // Health check settings\n  healthCheckInterval?: number; // Health check frequency in ms (default: 30000)\n  healthCheckQuery?: string; // Query to test connection health (default: 'SELECT 1')\n  retryOnFailure?: boolean; // Retry failed connections (default: true)\n  maxRetries?: number; // Max retry attempts (default: 3)\n  retryDelayMs?: number; // Delay between retries (default: 1000)\n\n  // Monitoring settings\n  enableMetrics?: boolean; // Enable connection metrics (default: true)\n  metricsInterval?: number; // Metrics collection interval (default: 60000)\n}\n\nexport interface ConnectionMetrics {\n  totalConnections: number;\n  idleConnections: number;\n  activeConnections: number;\n  waitingRequests: number;\n  totalAcquired: number;\n  totalReleased: number;\n  totalErrors: number;\n  averageAcquireTime: number;\n  peakConnections: number;\n  uptime: number;\n}\n\nexport interface ConnectionHealth {\n  isHealthy: boolean;\n  lastCheck: Date;\n  consecutiveFailures: number;\n  totalChecks: number;\n  totalFailures: number;\n  averageResponseTime: number;\n}\n\nexport class ConnectionPool extends EventEmitter {\n  private pool: Pool;\n  private config: Required<ConnectionPoolConfig>;\n  private metrics: ConnectionMetrics;\n  private health: ConnectionHealth;\n  private healthCheckTimer?: NodeJS.Timeout;\n  private metricsTimer?: NodeJS.Timeout;\n  private startTime: Date;\n  private badConnections = new Set<PoolClient>();\n  private acquireTimes: number[] = [];\n\n  constructor(config: ConnectionPoolConfig) {\n    super();\n\n    this.config = this.normalizeConfig(config);\n    this.startTime = new Date();\n\n    // Initialize metrics\n    this.metrics = {\n      totalConnections: 0,\n      idleConnections: 0,\n      activeConnections: 0,\n      waitingRequests: 0,\n      totalAcquired: 0,\n      totalReleased: 0,\n      totalErrors: 0,\n      averageAcquireTime: 0,\n      peakConnections: 0,\n      uptime: 0,\n    };\n\n    // Initialize health\n    this.health = {\n      isHealthy: false,\n      lastCheck: new Date(),\n      consecutiveFailures: 0,\n      totalChecks: 0,\n      totalFailures: 0,\n      averageResponseTime: 0,\n    };\n\n    // Create pool\n    this.pool = new Pool(this.config);\n    this.setupPoolEvents();\n\n    // Start monitoring if enabled\n    if (this.config.enableMetrics) {\n      this.startMonitoring();\n    }\n  }\n\n  private normalizeConfig(\n    config: ConnectionPoolConfig\n  ): Required<ConnectionPoolConfig> {\n    return {\n      ...config,\n      min: config.min ?? 2,\n      max: config.max ?? 10,\n      idleTimeoutMillis: config.idleTimeoutMillis ?? 30000,\n      connectionTimeoutMillis: config.connectionTimeoutMillis ?? 5000,\n      healthCheckInterval: config.healthCheckInterval ?? 30000,\n      healthCheckQuery: config.healthCheckQuery ?? 'SELECT 1',\n      retryOnFailure: config.retryOnFailure ?? true,\n      maxRetries: config.maxRetries ?? 3,\n      retryDelayMs: config.retryDelayMs ?? 1000,\n      enableMetrics: config.enableMetrics ?? true,\n      metricsInterval: config.metricsInterval ?? 60000,\n    };\n  }\n\n  private setupPoolEvents(): void {\n    this.pool.on('connect', (client) => {\n      logger.debug('New database connection established');\n      this.metrics.totalConnections++;\n      this.updatePeakConnections();\n      this.emit('connect', client);\n    });\n\n    this.pool.on('acquire', (client) => {\n      this.metrics.totalAcquired++;\n      this.emit('acquire', client);\n    });\n\n    this.pool.on('release', (client) => {\n      this.metrics.totalReleased++;\n      this.emit('release', client);\n    });\n\n    this.pool.on('remove', (client) => {\n      logger.debug('Database connection removed from pool');\n      this.metrics.totalConnections--;\n      this.emit('remove', client);\n    });\n\n    this.pool.on('error', (error) => {\n      logger.error('Database pool error:', error);\n      this.metrics.totalErrors++;\n      this.emit('error', error);\n    });\n  }\n\n  private updatePeakConnections(): void {\n    const current = this.pool.totalCount;\n    if (current > this.metrics.peakConnections) {\n      this.metrics.peakConnections = current;\n    }\n  }\n\n  private startMonitoring(): void {\n    // Health checks\n    if (this.config.healthCheckInterval > 0) {\n      this.healthCheckTimer = setInterval(() => {\n        this.performHealthCheck().catch((error) => {\n          logger.error('Health check failed:', error);\n        });\n      }, this.config.healthCheckInterval);\n    }\n\n    // Metrics collection\n    if (this.config.metricsInterval > 0) {\n      this.metricsTimer = setInterval(() => {\n        this.updateMetrics();\n        this.emit('metrics', this.getMetrics());\n      }, this.config.metricsInterval);\n    }\n\n    // Initial health check\n    this.performHealthCheck().catch((error) => {\n      logger.warn('Initial health check failed:', error);\n    });\n  }\n\n  private async performHealthCheck(): Promise<void> {\n    const startTime = Date.now();\n    let client: PoolClient | undefined;\n\n    try {\n      this.health.totalChecks++;\n\n      client = await this.pool.connect();\n      await client.query(this.config.healthCheckQuery);\n\n      const responseTime = Date.now() - startTime;\n      this.updateHealthMetrics(true, responseTime);\n\n      logger.debug(`Health check passed in ${responseTime}ms`);\n    } catch (error) {\n      const responseTime = Date.now() - startTime;\n      this.updateHealthMetrics(false, responseTime);\n\n      logger.warn(`Health check failed after ${responseTime}ms:`, error);\n\n      if (\n        this.config.retryOnFailure &&\n        this.health.consecutiveFailures < this.config.maxRetries\n      ) {\n        setTimeout(() => {\n          this.performHealthCheck().catch(() => {\n            // Ignore retry failures\n          });\n        }, this.config.retryDelayMs);\n      }\n    } finally {\n      if (client) {\n        client.release();\n      }\n    }\n  }\n\n  private updateHealthMetrics(success: boolean, responseTime: number): void {\n    this.health.lastCheck = new Date();\n\n    if (success) {\n      this.health.isHealthy = true;\n      this.health.consecutiveFailures = 0;\n    } else {\n      this.health.isHealthy = false;\n      this.health.consecutiveFailures++;\n      this.health.totalFailures++;\n    }\n\n    // Update average response time (simple moving average of last 10 checks)\n    const weight = Math.min(this.health.totalChecks, 10);\n    this.health.averageResponseTime =\n      (this.health.averageResponseTime * (weight - 1) + responseTime) / weight;\n  }\n\n  private updateMetrics(): void {\n    this.metrics.idleConnections = this.pool.idleCount;\n    this.metrics.activeConnections = this.pool.totalCount - this.pool.idleCount;\n    this.metrics.waitingRequests = this.pool.waitingCount;\n    this.metrics.uptime = Date.now() - this.startTime.getTime();\n\n    // Update average acquire time\n    if (this.acquireTimes.length > 0) {\n      this.metrics.averageAcquireTime =\n        this.acquireTimes.reduce((sum, time) => sum + time, 0) /\n        this.acquireTimes.length;\n\n      // Keep only recent acquire times (last 100)\n      if (this.acquireTimes.length > 100) {\n        this.acquireTimes = this.acquireTimes.slice(-100);\n      }\n    }\n  }\n\n  /**\n   * Acquire a connection from the pool\n   */\n  async acquire(): Promise<PoolClient> {\n    const startTime = Date.now();\n\n    try {\n      const client = await this.pool.connect();\n\n      // Track acquire time\n      const acquireTime = Date.now() - startTime;\n      this.acquireTimes.push(acquireTime);\n\n      // Check if connection is marked as bad\n      if (this.badConnections.has(client)) {\n        this.badConnections.delete(client);\n        client.release(true); // Force removal\n        return this.acquire(); // Try again\n      }\n\n      return client;\n    } catch (error) {\n      this.metrics.totalErrors++;\n      logger.error('Failed to acquire connection:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Release a connection back to the pool\n   */\n  release(client: PoolClient, error?: Error | boolean): void {\n    if (error) {\n      // Release with error - connection will be removed from pool\n      client.release(true);\n    } else {\n      client.release();\n    }\n  }\n\n  /**\n   * Mark a connection as bad (will be removed on next acquire)\n   */\n  markConnectionAsBad(client: PoolClient): void {\n    this.badConnections.add(client);\n    logger.warn('Connection marked as bad and will be removed');\n  }\n\n  /**\n   * Get current connection metrics\n   */\n  getMetrics(): ConnectionMetrics {\n    this.updateMetrics();\n    return { ...this.metrics };\n  }\n\n  /**\n   * Get current health status\n   */\n  getHealth(): ConnectionHealth {\n    return { ...this.health };\n  }\n\n  /**\n   * Test connection to database\n   */\n  async ping(): Promise<boolean> {\n    try {\n      const client = await this.acquire();\n      await client.query('SELECT 1');\n      this.release(client);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Get pool status information\n   */\n  getStatus() {\n    return {\n      totalCount: this.pool.totalCount,\n      idleCount: this.pool.idleCount,\n      waitingCount: this.pool.waitingCount,\n      config: {\n        min: this.config.min,\n        max: this.config.max,\n        idleTimeoutMillis: this.config.idleTimeoutMillis,\n        connectionTimeoutMillis: this.config.connectionTimeoutMillis,\n      },\n      health: this.getHealth(),\n      metrics: this.getMetrics(),\n    };\n  }\n\n  /**\n   * Close all connections and clean up\n   */\n  async close(): Promise<void> {\n    logger.info('Closing connection pool');\n\n    // Clear timers\n    if (this.healthCheckTimer) {\n      clearInterval(this.healthCheckTimer);\n    }\n    if (this.metricsTimer) {\n      clearInterval(this.metricsTimer);\n    }\n\n    // Close pool\n    await this.pool.end();\n\n    // Clear bad connections set\n    this.badConnections.clear();\n\n    this.emit('close');\n    logger.info('Connection pool closed');\n  }\n\n  /**\n   * Drain pool gracefully (wait for active connections to finish)\n   */\n  async drain(timeoutMs = 30000): Promise<void> {\n    logger.info('Draining connection pool');\n\n    const startTime = Date.now();\n\n    while (this.pool.totalCount - this.pool.idleCount > 0) {\n      if (Date.now() - startTime > timeoutMs) {\n        logger.warn('Pool drain timeout reached, forcing close');\n        break;\n      }\n\n      // Wait a bit before checking again\n      await new Promise((resolve) => setTimeout(resolve, 100));\n    }\n\n    await this.close();\n  }\n\n  /**\n   * Execute a query using a pooled connection\n   */\n  async query<T = any>(\n    text: string,\n    params?: any[]\n  ): Promise<{ rows: T[]; rowCount: number }> {\n    const client = await this.acquire();\n\n    try {\n      const result = await client.query(text, params);\n      return {\n        rows: result.rows,\n        rowCount: result.rowCount || 0,\n      };\n    } finally {\n      this.release(client);\n    }\n  }\n\n  /**\n   * Execute multiple queries in a transaction\n   */\n  async transaction<T>(\n    callback: (client: PoolClient) => Promise<T>\n  ): Promise<T> {\n    const client = await this.acquire();\n\n    try {\n      await client.query('BEGIN');\n      const result = await callback(client);\n      await client.query('COMMIT');\n      return result;\n    } catch (error) {\n      try {\n        await client.query('ROLLBACK');\n      } catch (rollbackError) {\n        logger.error('Transaction rollback failed:', rollbackError);\n        this.markConnectionAsBad(client);\n      }\n      throw error;\n    } finally {\n      this.release(client);\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/core/database/database-adapter.js

@@ -0,0 +1,51 @@
+class DatabaseAdapter {
+  projectId;
+  config;
+  constructor(projectId, config) {
+    this.projectId = projectId;
+    this.config = config || {};
+  }
+  // Utility methods
+  generateId() {
+    return crypto.randomUUID();
+  }
+  sanitizeQuery(query) {
+    console.warn(
+      "sanitizeQuery() is deprecated and unsafe - use parameterized queries"
+    );
+    return query.replace(/[;'"\\]/g, "");
+  }
+  buildWhereClause(conditions) {
+    const clauses = Object.entries(conditions).map(([key, value]) => {
+      if (value === null) {
+        return `${key} IS NULL`;
+      } else if (Array.isArray(value)) {
+        return `${key} IN (${value.map(() => "?").join(",")})`;
+      } else {
+        return `${key} = ?`;
+      }
+    });
+    return clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
+  }
+  buildOrderByClause(orderBy, direction) {
+    if (!orderBy) return "";
+    return ` ORDER BY ${orderBy} ${direction || "ASC"}`;
+  }
+  buildLimitClause(limit, offset) {
+    if (!limit) return "";
+    let clause = ` LIMIT ${limit}`;
+    if (offset) clause += ` OFFSET ${offset}`;
+    return clause;
+  }
+}
+class FeatureAwareDatabaseAdapter extends DatabaseAdapter {
+  async canUseFeature(feature) {
+    const features = this.getFeatures();
+    return features[feature] || false;
+  }
+}
+export {
+  DatabaseAdapter,
+  FeatureAwareDatabaseAdapter
+};
+//# sourceMappingURL=database-adapter.js.map

package/dist/core/database/database-adapter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/database/database-adapter.ts"],
+  "sourcesContent": ["/**\n * Database Adapter Interface\n * Provides abstraction layer for different database implementations\n * Supports SQLite (current) and ParadeDB (new) with seamless migration\n */\n\nimport type { Frame, Event, Anchor } from '../context/frame-manager.js';\n\nexport interface QueryOptions {\n  limit?: number;\n  offset?: number;\n  orderBy?: string;\n  orderDirection?: 'ASC' | 'DESC';\n  timeout?: number;\n}\n\nexport interface SearchOptions extends QueryOptions {\n  query: string;\n  searchType?: 'text' | 'vector' | 'hybrid';\n  scoreThreshold?: number;\n  fields?: string[];\n  boost?: Record<string, number>;\n}\n\nexport interface AggregationOptions {\n  groupBy: string[];\n  metrics: Array<{\n    field: string;\n    operation: 'count' | 'sum' | 'avg' | 'min' | 'max';\n    alias?: string;\n  }>;\n  having?: Record<string, any>;\n}\n\nexport interface BulkOperation {\n  type: 'insert' | 'update' | 'delete';\n  table: string;\n  data?: any;\n  where?: Record<string, any>;\n}\n\nexport interface DatabaseStats {\n  totalFrames: number;\n  activeFrames: number;\n  totalEvents: number;\n  totalAnchors: number;\n  diskUsage: number;\n  lastVacuum?: Date;\n}\n\n// Database result type interfaces\nexport interface CountResult {\n  count: number;\n}\n\nexport interface VersionResult {\n  version: number;\n}\n\nexport interface FrameRow {\n  frame_id: string;\n  parent_frame_id?: string;\n  project_id: string;\n  run_id: string;\n  type: string;\n  name: string;\n  state: string;\n  depth: number;\n  inputs: string;\n  outputs: string;\n  digest_text: string;\n  digest_json: string;\n  created_at: number;\n  closed_at?: number;\n  score?: number;\n}\n\nexport interface EventRow {\n  event_id: string;\n  frame_id: string;\n  seq: number;\n  type: string;\n  text: string;\n  metadata: string;\n}\n\nexport interface AnchorRow {\n  anchor_id: string;\n  frame_id: string;\n  type: string;\n  text: string;\n  priority: number;\n  created_at: number;\n  metadata: string;\n}\n\nexport abstract class DatabaseAdapter {\n  protected readonly projectId: string;\n  protected readonly config: any;\n\n  constructor(projectId: string, config?: any) {\n    this.projectId = projectId;\n    this.config = config || {};\n  }\n\n  // Lifecycle methods\n  abstract connect(): Promise<void>;\n  abstract disconnect(): Promise<void>;\n  abstract isConnected(): boolean;\n  abstract ping(): Promise<boolean>;\n\n  // Schema management\n  abstract initializeSchema(): Promise<void>;\n  abstract migrateSchema(targetVersion: number): Promise<void>;\n  abstract getSchemaVersion(): Promise<number>;\n\n  // Frame operations\n  abstract createFrame(frame: Partial<Frame>): Promise<string>;\n  abstract getFrame(frameId: string): Promise<Frame | null>;\n  abstract updateFrame(frameId: string, updates: Partial<Frame>): Promise<void>;\n  abstract deleteFrame(frameId: string): Promise<void>;\n  abstract getActiveFrames(runId?: string): Promise<Frame[]>;\n  abstract closeFrame(frameId: string, outputs?: any): Promise<void>;\n\n  // Event operations\n  abstract createEvent(event: Partial<Event>): Promise<string>;\n  abstract getFrameEvents(\n    frameId: string,\n    options?: QueryOptions\n  ): Promise<Event[]>;\n  abstract deleteFrameEvents(frameId: string): Promise<void>;\n\n  // Anchor operations\n  abstract createAnchor(anchor: Partial<Anchor>): Promise<string>;\n  abstract getFrameAnchors(frameId: string): Promise<Anchor[]>;\n  abstract deleteFrameAnchors(frameId: string): Promise<void>;\n\n  // Search operations (enhanced for ParadeDB)\n  abstract search(\n    options: SearchOptions\n  ): Promise<Array<Frame & { score: number }>>;\n  abstract searchByVector(\n    embedding: number[],\n    options?: QueryOptions\n  ): Promise<Array<Frame & { similarity: number }>>;\n  abstract searchHybrid(\n    textQuery: string,\n    embedding: number[],\n    weights?: { text: number; vector: number }\n  ): Promise<Array<Frame & { score: number }>>;\n\n  // Aggregation operations\n  abstract aggregate(\n    table: string,\n    options: AggregationOptions\n  ): Promise<Record<string, any>[]>;\n\n  // Pattern detection\n  abstract detectPatterns(timeRange?: { start: Date; end: Date }): Promise<\n    Array<{\n      pattern: string;\n      type: string;\n      frequency: number;\n      lastSeen: Date;\n    }>\n  >;\n\n  // Bulk operations\n  abstract executeBulk(operations: BulkOperation[]): Promise<void>;\n  abstract vacuum(): Promise<void>;\n  abstract analyze(): Promise<void>;\n\n  // Statistics\n  abstract getStats(): Promise<DatabaseStats>;\n  abstract getQueryStats(): Promise<\n    Array<{\n      query: string;\n      calls: number;\n      meanTime: number;\n      totalTime: number;\n    }>\n  >;\n\n  // Transaction support\n  abstract beginTransaction(): Promise<void>;\n  abstract commitTransaction(): Promise<void>;\n  abstract rollbackTransaction(): Promise<void>;\n  abstract inTransaction(\n    callback: (adapter: DatabaseAdapter) => Promise<void>\n  ): Promise<void>;\n\n  // Export/Import for migration\n  abstract exportData(\n    tables: string[],\n    format: 'json' | 'parquet' | 'csv'\n  ): Promise<Buffer>;\n  abstract importData(\n    data: Buffer,\n    format: 'json' | 'parquet' | 'csv',\n    options?: { truncate?: boolean; upsert?: boolean }\n  ): Promise<void>;\n\n  // Utility methods\n  protected generateId(): string {\n    return crypto.randomUUID();\n  }\n\n  protected sanitizeQuery(query: string): string {\n    // DEPRECATED: Use parameterized queries instead\n    // This method is kept for legacy compatibility but should not be used\n    console.warn(\n      'sanitizeQuery() is deprecated and unsafe - use parameterized queries'\n    );\n    return query.replace(/[;'\"\\\\]/g, '');\n  }\n\n  protected buildWhereClause(conditions: Record<string, any>): string {\n    const clauses = Object.entries(conditions).map(([key, value]) => {\n      if (value === null) {\n        return `${key} IS NULL`;\n      } else if (Array.isArray(value)) {\n        return `${key} IN (${value.map(() => '?').join(',')})`;\n      } else {\n        return `${key} = ?`;\n      }\n    });\n    return clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';\n  }\n\n  protected buildOrderByClause(\n    orderBy?: string,\n    direction?: 'ASC' | 'DESC'\n  ): string {\n    if (!orderBy) return '';\n    return ` ORDER BY ${orderBy} ${direction || 'ASC'}`;\n  }\n\n  protected buildLimitClause(limit?: number, offset?: number): string {\n    if (!limit) return '';\n    let clause = ` LIMIT ${limit}`;\n    if (offset) clause += ` OFFSET ${offset}`;\n    return clause;\n  }\n}\n\n// Feature flags for gradual migration\nexport interface DatabaseFeatures {\n  supportsFullTextSearch: boolean;\n  supportsVectorSearch: boolean;\n  supportsPartitioning: boolean;\n  supportsAnalytics: boolean;\n  supportsCompression: boolean;\n  supportsMaterializedViews: boolean;\n  supportsParallelQueries: boolean;\n}\n\nexport abstract class FeatureAwareDatabaseAdapter extends DatabaseAdapter {\n  abstract getFeatures(): DatabaseFeatures;\n\n  async canUseFeature(feature: keyof DatabaseFeatures): Promise<boolean> {\n    const features = this.getFeatures();\n    return features[feature] || false;\n  }\n}\n"],
+  "mappings": "AAgGO,MAAe,gBAAgB;AAAA,EACjB;AAAA,EACA;AAAA,EAEnB,YAAY,WAAmB,QAAc;AAC3C,SAAK,YAAY;AACjB,SAAK,SAAS,UAAU,CAAC;AAAA,EAC3B;AAAA;AAAA,EAoGU,aAAqB;AAC7B,WAAO,OAAO,WAAW;AAAA,EAC3B;AAAA,EAEU,cAAc,OAAuB;AAG7C,YAAQ;AAAA,MACN;AAAA,IACF;AACA,WAAO,MAAM,QAAQ,YAAY,EAAE;AAAA,EACrC;AAAA,EAEU,iBAAiB,YAAyC;AAClE,UAAM,UAAU,OAAO,QAAQ,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAC/D,UAAI,UAAU,MAAM;AAClB,eAAO,GAAG,GAAG;AAAA,MACf,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,eAAO,GAAG,GAAG,QAAQ,MAAM,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,MACrD,OAAO;AACL,eAAO,GAAG,GAAG;AAAA,MACf;AAAA,IACF,CAAC;AACD,WAAO,QAAQ,SAAS,IAAI,SAAS,QAAQ,KAAK,OAAO,CAAC,KAAK;AAAA,EACjE;AAAA,EAEU,mBACR,SACA,WACQ;AACR,QAAI,CAAC,QAAS,QAAO;AACrB,WAAO,aAAa,OAAO,IAAI,aAAa,KAAK;AAAA,EACnD;AAAA,EAEU,iBAAiB,OAAgB,QAAyB;AAClE,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,SAAS,UAAU,KAAK;AAC5B,QAAI,OAAQ,WAAU,WAAW,MAAM;AACvC,WAAO;AAAA,EACT;AACF;AAaO,MAAe,oCAAoC,gBAAgB;AAAA,EAGxE,MAAM,cAAc,SAAmD;AACrE,UAAM,WAAW,KAAK,YAAY;AAClC,WAAO,SAAS,OAAO,KAAK;AAAA,EAC9B;AACF;",
+  "names": []
+}