@happyvertical/sql 0.86.2 → 0.86.4

package/dist/chunks/duckdb-D2Nah7NF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-D2Nah7NF.js","names":[],"sources":["../../src/duckdb.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { basename, extname, join } from 'node:path';\nimport { DatabaseError } from '@happyvertical/utils';\nimport { DatabaseSchemaManager } from './schema-manager';\nimport {\n  escapeQuotedIdentifier,\n  escapeStringLiteral,\n  generateAddColumnStatement,\n  generateCreateIndexStatement,\n  validateColumnName,\n  validateColumnNames,\n  validateIndexName,\n  validateTableName,\n} from './shared/alter-utils';\nimport { validateDatabaseCacheOptions } from './shared/connection-cache';\nimport {\n  createDuckDBResourceCloser,\n  throwWithDuckDBCleanup,\n} from './shared/duckdb-resources';\nimport { convertUniqueIndexesToInlineConstraints } from './shared/duckdb-schema-utils';\nimport { redactDatabaseUrl } from './shared/redact-database-url';\nimport { createTransactionLock } from './shared/transaction-lock';\nimport type {\n  ColumnDefinition,\n  ColumnDefinitionWithName,\n  DatabaseInterface,\n  DuckDBOptions,\n  IndexDefinition,\n  QueryResult,\n  SchemaInitializationOptions,\n  TableInterface,\n  TableSchemaInfo,\n  TransactionHandle,\n  UpsertOptions,\n} from './shared/types';\nimport { NestedTransactionError, resolveSchemas } from './shared/types';\nimport {\n  buildWhere,\n  formatDbError,\n  resolveInsertColumns,\n} from './shared/utils';\n\n/**\n * Creates tables from provided schema definitions\n *\n * DuckDB has a known limitation (issue #12684) where ON CONFLICT clauses\n * fail with UNIQUE INDEX but work with inline UNIQUE constraints.\n * This function converts UNIQUE indexes to inline constraints for compatibility.\n *\n * @param connection - DuckDB connection\n * @param schemas - Schema definitions to create\n */\nasync function createTablesFromSchemas(\n  connection: any,\n  schemas: Record<string, import('./shared/types').SchemaProvider>,\n): Promise<void> {\n  for (const [tableName, schema] of Object.entries(schemas)) {\n    try {\n      // Check if table already exists\n      const result = await connection.runAndReadAll(\n        `SELECT name FROM sqlite_master WHERE type='table' AND name='${tableName}'`,\n      );\n      const rows = result.getRowObjects();\n\n      if (rows.length > 0) {\n        console.log(`[duckdb] Table ${tableName} already exists, skipping`);\n        continue;\n      }\n\n      console.log(`[duckdb] Creating table ${tableName} from provided schema`);\n\n      // Convert UNIQUE indexes to inline UNIQUE constraints for DuckDB compatibility\n      // DuckDB's ON CONFLICT requires inline constraints, not separate indexes\n      const transformed = convertUniqueIndexesToInlineConstraints(\n        schema.ddl,\n        schema.indexes,\n      );\n\n      // Create table from transformed DDL\n      await connection.run(transformed.ddl);\n\n      // Create remaining indexes (non-UNIQUE indexes only)\n      // UNIQUE indexes have been converted to inline constraints\n      if (transformed.indexes && transformed.indexes.length > 0) {\n        for (const indexSQL of transformed.indexes) {\n          try {\n            await connection.run(indexSQL);\n          } catch (error) {\n            console.warn(\n              `[duckdb] Failed to create index for ${tableName}: ${error instanceof Error ? error.message : String(error)}`,\n            );\n          }\n        }\n      }\n\n      // Create triggers (if supported)\n      if (schema.triggers && schema.triggers.length > 0) {\n        for (const triggerSQL of schema.triggers) {\n          try {\n            await connection.run(triggerSQL);\n          } catch (error) {\n            console.warn(\n              `[duckdb] Failed to create trigger for ${tableName}: ${error instanceof Error ? error.message : String(error)}`,\n            );\n          }\n        }\n      }\n    } catch (error) {\n      throw new DatabaseError(\n        `Failed to create table ${tableName} from schema`,\n        {\n          tableName,\n          schema,\n          originalError: error instanceof Error ? error.message : String(error),\n        },\n      );\n    }\n  }\n}\n\n/**\n * Resolves a DuckDB URL, handling :memory: variants to prevent file leakage.\n *\n * DuckDB interprets any string as a file path unless it's exactly ':memory:'.\n * URLs like ':memory:12345' create files named ':memory:12345' in the working directory.\n *\n * This function:\n * - Returns ':memory:' unchanged (pure in-memory database)\n * - Converts ':memory:*' patterns to temp files in os.tmpdir()\n * - Returns other URLs unchanged (file paths, etc.)\n *\n * @param url - The database URL to resolve\n * @returns The resolved URL safe for DuckDB\n */\nfunction resolveDuckDBUrl(url: string): string {\n  // Pure in-memory: use as-is\n  if (url === ':memory:') {\n    return url;\n  }\n\n  // Pattern: :memory: followed by anything (e.g., :memory:12345-0.5678)\n  // These would create files in CWD - redirect to temp directory instead\n  if (url.startsWith(':memory:')) {\n    const suffix = url.slice(':memory:'.length);\n    const tempPath = join(tmpdir(), `duckdb-memory-${suffix}.db`);\n    return tempPath;\n  }\n\n  // Other URLs (file paths, etc.): use as-is\n  return url;\n}\n\n/**\n * Creates a DuckDB connection instance\n *\n * @param options - DuckDB connection options\n * @returns Promise resolving to a DuckDB connection\n */\nasync function createDuckDBConnection(options: DuckDBOptions) {\n  const {\n    url = ':memory:',\n    dataDir = './data',\n    autoRegisterJSON = true,\n  } = options;\n  const schemas = resolveSchemas(options.schemas) ?? {};\n\n  // Resolve URL to prevent file leakage from :memory:* patterns\n  const resolvedUrl = resolveDuckDBUrl(url);\n\n  let instance: Awaited<ReturnType<any>> | undefined;\n  let connection: any;\n  try {\n    // Dynamic import to avoid bundling\n    const duckdbModule = '@duckdb/node-api';\n    const { DuckDBInstance } = await import(/* @vite-ignore */ duckdbModule);\n\n    // Create DuckDB instance with resolved URL\n    instance = await DuckDBInstance.create(resolvedUrl);\n    connection = await instance.connect();\n\n    // Create tables from provided schemas first\n    if (schemas && Object.keys(schemas).length > 0) {\n      await createTablesFromSchemas(connection, schemas);\n    }\n\n    // Auto-register JSON files if enabled\n    if (autoRegisterJSON && dataDir) {\n      await registerJSONFiles(connection, dataDir);\n    }\n\n    return { connection, instance };\n  } catch (error) {\n    const errorMessage = redactDatabaseUrl(\n      error instanceof Error ? error.message : String(error),\n    );\n    const databaseError = new DatabaseError(\n      `Failed to create DuckDB connection: ${errorMessage}`,\n      {\n        url: redactDatabaseUrl(url),\n        originalError: errorMessage,\n      },\n    );\n    return throwWithDuckDBCleanup(\n      databaseError,\n      createDuckDBResourceCloser(connection, instance),\n    );\n  }\n}\n\n/**\n * Scans the data directory and registers JSON files as queryable tables\n *\n * @param connection - DuckDB connection\n * @param dataDir - Directory containing JSON files\n */\nasync function registerJSONFiles(connection: any, dataDir: string) {\n  try {\n    const files = await readdir(dataDir);\n    const jsonFiles = files.filter(\n      (file) => extname(file).toLowerCase() === '.json',\n    );\n\n    for (const file of jsonFiles) {\n      const filePath = join(dataDir, file);\n      const tableName = basename(file, '.json');\n\n      // Create view that reads from JSON file\n      // DuckDB automatically infers schema with ISO date/timestamp parsing\n      // Both halves come from a file in the data directory: the view name from\n      // its basename, the path from its location. Anyone who can drop a file\n      // there would otherwise get DDL execution at getDatabase() time.\n      validateTableName(tableName);\n      await connection.run(\n        `CREATE OR REPLACE VIEW ${tableName} AS SELECT * FROM read_json('${escapeStringLiteral(filePath)}', auto_detect=true, format='auto', timestampformat='iso', dateformat='iso')`,\n      );\n    }\n  } catch (error) {\n    // If directory doesn't exist, that's okay - user might not have JSON files yet\n    if ((error as any).code !== 'ENOENT') {\n      throw new DatabaseError(`Failed to register JSON files from ${dataDir}`, {\n        dataDir,\n        originalError: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n}\n\n/**\n * Converts DuckDB-specific type representations to JavaScript types\n *\n * Handles two cases:\n * 1. JavaScript BigInt values → converted to numbers\n * 2. DuckDB timestamp objects ({ micros: number }) → converted to Date objects\n *\n * DuckDB represents TIMESTAMP values as objects with a single property\n * called 'micros' containing microseconds since Unix epoch. This function\n * converts them to JavaScript Date objects for proper serialization.\n *\n * @param obj - Object that may contain BigInt or timestamp values\n * @returns Object with DuckDB types converted to JavaScript types\n */\nfunction convertBigInts(obj: any): any {\n  if (obj === null || obj === undefined) return obj;\n  if (typeof obj === 'bigint') return Number(obj);\n\n  // Handle DuckDB timestamp objects: { micros: number | bigint }\n  // Convert to JavaScript Date for proper serialization\n  // Fixes issue #314: DuckDB returns dates as { micros } objects\n  if (\n    typeof obj === 'object' &&\n    !Array.isArray(obj) &&\n    'micros' in obj &&\n    Object.keys(obj).length === 1 &&\n    (typeof obj.micros === 'number' || typeof obj.micros === 'bigint')\n  ) {\n    // Convert microseconds to milliseconds for Date constructor\n    // DuckDB stores timestamps as microseconds since Unix epoch\n    // Handle both number and bigint types (DuckDB can return either)\n    const micros =\n      typeof obj.micros === 'bigint' ? Number(obj.micros) : obj.micros;\n    const milliseconds = micros / 1000;\n    return new Date(milliseconds);\n  }\n\n  if (Array.isArray(obj)) return obj.map(convertBigInts);\n  if (typeof obj === 'object') {\n    const result: any = {};\n    for (const key in obj) {\n      result[key] = convertBigInts(obj[key]);\n    }\n    return result;\n  }\n  return obj;\n}\n\n/**\n * Creates a DuckDB database adapter\n *\n * @param options - DuckDB connection options\n * @returns Database interface for DuckDB\n */\nexport async function getDatabase(\n  options: DuckDBOptions = {},\n): Promise<DatabaseInterface> {\n  validateDatabaseCacheOptions(options);\n  const { connection, instance } = await createDuckDBConnection(options);\n  const writeStrategy = options.writeStrategy || 'none';\n  const dataDir = options.dataDir || './data';\n  // Use resolved URL to reflect actual database location\n  const url = resolveDuckDBUrl(options.url || ':memory:');\n\n  // One lock per connection. This adapter creates a fresh DuckDB instance and\n  // connection per call and caches nothing, so the lock's scope is exactly the\n  // connection it was created alongside.\n  const connectionLock = createTransactionLock(\n    'duckdb',\n    options.transactionQueueTimeout,\n  );\n  const closeResources = createDuckDBResourceCloser(connection, instance);\n\n  /**\n   * Inserts one or more records into a table\n   *\n   * @param table - Table name\n   * @param data - Single record or array of records to insert\n   * @returns Promise resolving to operation result\n   * @throws Error if the insert operation fails\n   */\n  const insert = async (\n    table: string,\n    data: Record<string, any> | Record<string, any>[],\n  ): Promise<QueryResult> => {\n    validateTableName(table);\n    const records = Array.isArray(data) ? data : [data];\n\n    if (records.length === 0) {\n      return { operation: 'insert', affected: 0 };\n    }\n\n    const keys = resolveInsertColumns(table, records);\n    validateColumnNames(keys);\n    const values: any[] = [];\n    let paramIdx = 1;\n\n    // Build placeholders with proper type casting for DuckDB\n    const placeholders = records\n      .map((record) => {\n        const rowPlaceholders = keys.map((key) => {\n          const value = record[key];\n\n          if (value === null || value === undefined) {\n            return 'NULL';\n          } else if (value === '' && typeof value === 'string') {\n            // CAST empty strings to TEXT to prevent DuckDB ANY type inference\n            values.push(value);\n            return `CAST($${paramIdx++} AS TEXT)`;\n          } else if (value instanceof Date) {\n            // Convert Date objects to ISO strings for DuckDB\n            values.push(value.toISOString());\n            return `$${paramIdx++}`;\n          } else if (Array.isArray(value)) {\n            // CAST arrays to JSON to prevent DuckDB ANY type inference\n            values.push(JSON.stringify(value));\n            return `CAST($${paramIdx++} AS JSON)`;\n          } else if (\n            typeof value === 'object' &&\n            value !== null &&\n            Object.getPrototypeOf(value) === Object.prototype\n          ) {\n            // CAST plain objects to JSON to prevent DuckDB ANY type inference\n            values.push(JSON.stringify(value));\n            return `CAST($${paramIdx++} AS JSON)`;\n          } else {\n            // Direct parameter binding for other values\n            values.push(value);\n            return `$${paramIdx++}`;\n          }\n        });\n        return `(${rowPlaceholders.join(', ')})`;\n      })\n      .join(', ');\n\n    const sql = `INSERT INTO ${table} (${keys.join(', ')}) VALUES ${placeholders}`;\n\n    try {\n      await connection.run(sql, values);\n      const affected = records.length;\n\n      // Handle write-back strategy\n      if (writeStrategy === 'immediate') {\n        await exportTableToJSON(connection, table, dataDir);\n      }\n\n      return { operation: 'insert', affected };\n    } catch (e) {\n      throw new DatabaseError('Failed to insert records into table', {\n        table,\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Retrieves a single record matching the where criteria\n   *\n   * @param table - Table name\n   * @param where - Criteria to match records\n   * @returns Promise resolving to matching record or null if not found\n   * @throws Error if the query fails\n   */\n  const get = async (\n    table: string,\n    where: Record<string, any>,\n  ): Promise<Record<string, any> | null> => {\n    validateTableName(table);\n    const { sql: whereClause, values } = buildWhere(where, 1, 'duckdb');\n    const sql = `SELECT * FROM ${table} ${whereClause} LIMIT 1`;\n\n    try {\n      const reader = await connection.runAndReadAll(sql, values);\n      const rows = reader.getRowObjects();\n      return rows.length > 0 ? convertBigInts(rows[0]) : null;\n    } catch (e) {\n      throw new DatabaseError('Failed to retrieve record from table', {\n        table,\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Retrieves multiple records matching the where criteria\n   *\n   * @param table - Table name\n   * @param where - Criteria to match records\n   * @returns Promise resolving to array of matching records\n   * @throws Error if the query fails\n   */\n  const list = async (\n    table: string,\n    where: Record<string, any>,\n  ): Promise<Record<string, any>[]> => {\n    validateTableName(table);\n    const { sql: whereClause, values } = buildWhere(where, 1, 'duckdb');\n    const sql = `SELECT * FROM ${table} ${whereClause}`;\n\n    try {\n      const reader = await connection.runAndReadAll(sql, values);\n      return convertBigInts(reader.getRowObjects());\n    } catch (e) {\n      throw new DatabaseError('Failed to list records from table', {\n        table,\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Updates records matching the where criteria\n   *\n   * @param table - Table name\n   * @param where - Criteria to match records to update\n   * @param data - New data to set\n   * @returns Promise resolving to operation result\n   * @throws Error if the update operation fails\n   */\n  const update = async (\n    table: string,\n    where: Record<string, any>,\n    data: Record<string, any>,\n  ): Promise<QueryResult> => {\n    validateTableName(table);\n    const keys = Object.keys(data);\n    validateColumnNames(keys);\n    const setClause = keys.map((key, idx) => `${key} = $${idx + 1}`).join(', ');\n    const { sql: whereClause, values: whereValues } = buildWhere(\n      where,\n      keys.length + 1,\n      'duckdb',\n    );\n\n    const sql = `UPDATE ${table} SET ${setClause} ${whereClause}`;\n    // Read values through the validated key list rather than a second\n    // enumeration of `data`, so a hostile Proxy cannot return values that\n    // disagree in order or membership with the `keys` driving `setClause`.\n    const values = [...keys.map((key) => data[key]), ...whereValues];\n\n    try {\n      await connection.run(sql, values);\n\n      // Handle write-back strategy\n      if (writeStrategy === 'immediate') {\n        await exportTableToJSON(connection, table, dataDir);\n      }\n\n      // DuckDB doesn't return rowsAffected in the same way, estimate from where clause\n      return { operation: 'update', affected: 1 };\n    } catch (e) {\n      throw new DatabaseError('Failed to update records in table', {\n        table,\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  const buildDuckDBValueExpression = (\n    value: any,\n    values: any[],\n    paramIdx: { value: number },\n  ): string => {\n    if (value === null || value === undefined) {\n      return 'NULL';\n    }\n    if (value === '' && typeof value === 'string') {\n      values.push(value);\n      return `CAST($${paramIdx.value++} AS TEXT)`;\n    }\n    if (value instanceof Date) {\n      values.push(value.toISOString());\n      return `$${paramIdx.value++}`;\n    }\n    if (Array.isArray(value)) {\n      values.push(JSON.stringify(value));\n      return `CAST($${paramIdx.value++} AS JSON)`;\n    }\n    if (\n      typeof value === 'object' &&\n      value !== null &&\n      Object.getPrototypeOf(value) === Object.prototype\n    ) {\n      values.push(JSON.stringify(value));\n      return `CAST($${paramIdx.value++} AS JSON)`;\n    }\n\n    values.push(value);\n    return `$${paramIdx.value++}`;\n  };\n\n  const executeNullAwareDuckDBUpsert = async (\n    table: string,\n    conflictColumns: string[],\n    data: Record<string, any>,\n  ): Promise<QueryResult> => {\n    const conflictWhere = Object.fromEntries(\n      conflictColumns.map((col) => [col, data[col]]),\n    );\n    const existing = await get(table, conflictWhere);\n\n    if (!existing) {\n      return insert(table, data);\n    }\n\n    const keys = Object.keys(data);\n    const values: any[] = [];\n    const paramIdx = { value: 1 };\n    const assignments = keys.map((key) => {\n      const valueExpr = buildDuckDBValueExpression(data[key], values, paramIdx);\n      return `\"${escapeQuotedIdentifier(key)}\" = ${valueExpr}`;\n    });\n    const { sql: whereClause, values: whereValues } = buildWhere(\n      conflictWhere,\n      paramIdx.value,\n      'duckdb',\n    );\n    const sql = `UPDATE ${table} SET ${assignments.join(', ')} ${whereClause}`;\n\n    try {\n      await connection.run(sql, [...values, ...whereValues]);\n\n      if (writeStrategy === 'immediate') {\n        await exportTableToJSON(connection, table, dataDir);\n      }\n\n      return { operation: 'upsert', affected: 1 };\n    } catch (e) {\n      throw new DatabaseError('Failed to upsert record into table', {\n        table,\n        sql,\n        values: [...values, ...whereValues],\n        conflictColumns,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Inserts a record or updates it if it already exists (UPSERT)\n   *\n   * @param table - Table name\n   * @param conflictColumns - Columns that define the uniqueness constraint\n   * @param data - Data to insert or update\n   * @returns Promise resolving to operation result\n   * @throws Error if the upsert operation fails\n   */\n  const upsert = async (\n    table: string,\n    conflictColumns: string[],\n    data: Record<string, any>,\n    options?: UpsertOptions,\n  ): Promise<QueryResult> => {\n    validateTableName(table);\n    // Snapshot the record once. Every read below — the presence check, the\n    // column list, the value list, and the null-aware branch — must see the\n    // same keys and values, or a hostile object could present one shape to the\n    // checks and another to the interpolated `keys`. A plain-object copy cannot\n    // observe how many times it is read.\n    const record = { ...data };\n    // Coerce the conflict columns to primitive strings once, for the same\n    // reason as `record`. These are not validated (they are quoted, so names\n    // that need quotes keep working), only escaped — and `escapeQuotedIdentifier`\n    // must run on a primitive. Coercing here also pins the value the presence\n    // check below sees to the value the `ON CONFLICT` list escapes, so a crafted\n    // object cannot read as `id` for the check and as unescaped SQL for the SQL.\n    const conflictCols = conflictColumns.map((col) => String(col));\n    // Conflict columns reach two very different positions. In the plain\n    // `ON CONFLICT(...)` path below they are quoted, so a name that needs\n    // quotes — `Full Name`, `user-id`, whatever the source data called its\n    // keys — is ordinary and has always worked; escaping keeps it working\n    // while making it impossible to leave the quotes. In the null-aware path\n    // they become `buildWhere` keys instead, which requires a plain identifier\n    // and rejects them there, as it did before this change.\n    // Validate that all conflict columns are present in the data\n    const missingColumns = conflictCols.filter((col) => !(col in record));\n\n    if (missingColumns.length > 0) {\n      throw new DatabaseError('Conflict columns missing from data', {\n        table,\n        conflictColumns: conflictCols,\n        missingColumns,\n        availableColumns: Object.keys(record),\n        hint: 'All columns specified in ON CONFLICT must be present in the data being inserted. Undefined values should be replaced with null or an appropriate default.',\n      });\n    }\n\n    if (\n      !options?.nullsDistinct &&\n      conflictCols.some((col) => record[col] === null)\n    ) {\n      return executeNullAwareDuckDBUpsert(table, conflictCols, record);\n    }\n\n    const keys = Object.keys(record);\n    const dataValues = Object.values(record);\n\n    // Build placeholders and values with proper type handling for DuckDB\n    // DuckDB cannot infer types from empty strings or certain values, so we need explicit CAST\n    const placeholders: string[] = [];\n    const values: any[] = [];\n    let paramIdx = 1;\n\n    for (const value of dataValues) {\n      if (value === null || value === undefined) {\n        // DuckDB requires explicit NULL for null/undefined values\n        placeholders.push('NULL');\n      } else if (value === '' && typeof value === 'string') {\n        // CAST empty strings to TEXT to prevent DuckDB ANY type inference\n        placeholders.push(`CAST($${paramIdx} AS TEXT)`);\n        values.push(value);\n        paramIdx++;\n      } else if (value instanceof Date) {\n        // Convert Date objects to ISO strings for DuckDB\n        placeholders.push(`$${paramIdx}`);\n        values.push(value.toISOString());\n        paramIdx++;\n      } else if (Array.isArray(value)) {\n        // CAST arrays to JSON to prevent DuckDB ANY type inference\n        // DuckDB cannot infer array element types from empty arrays or mixed types\n        placeholders.push(`CAST($${paramIdx} AS JSON)`);\n        values.push(JSON.stringify(value));\n        paramIdx++;\n      } else if (\n        typeof value === 'object' &&\n        value !== null &&\n        Object.getPrototypeOf(value) === Object.prototype\n      ) {\n        // CAST plain objects to JSON to prevent DuckDB ANY type inference\n        // Only applies to plain objects (not class instances)\n        placeholders.push(`CAST($${paramIdx} AS JSON)`);\n        values.push(JSON.stringify(value));\n        paramIdx++;\n      } else {\n        // Direct parameter binding for other values\n        placeholders.push(`$${paramIdx}`);\n        values.push(value);\n        paramIdx++;\n      }\n    }\n\n    // Build UPDATE SET clause with same type handling\n    // DO NOT reset paramIdx - parameters must be unique across entire query\n    const updateSetParts: string[] = [];\n\n    for (let i = 0; i < keys.length; i++) {\n      const key = keys[i];\n      const value = dataValues[i];\n\n      if (value === null || value === undefined) {\n        // DuckDB requires explicit NULL for null/undefined values\n        updateSetParts.push(`${key} = NULL`);\n      } else if (value === '' && typeof value === 'string') {\n        updateSetParts.push(`${key} = CAST($${paramIdx} AS TEXT)`);\n        values.push(value);\n        paramIdx++;\n      } else if (value instanceof Date) {\n        updateSetParts.push(`${key} = $${paramIdx}`);\n        values.push(value.toISOString());\n        paramIdx++;\n      } else if (Array.isArray(value)) {\n        // CAST arrays to JSON to prevent DuckDB ANY type inference\n        updateSetParts.push(`${key} = CAST($${paramIdx} AS JSON)`);\n        values.push(JSON.stringify(value));\n        paramIdx++;\n      } else if (\n        typeof value === 'object' &&\n        value !== null &&\n        Object.getPrototypeOf(value) === Object.prototype\n      ) {\n        // CAST plain objects to JSON to prevent DuckDB ANY type inference\n        updateSetParts.push(`${key} = CAST($${paramIdx} AS JSON)`);\n        values.push(JSON.stringify(value));\n        paramIdx++;\n      } else {\n        updateSetParts.push(`${key} = $${paramIdx}`);\n        values.push(value);\n        paramIdx++;\n      }\n    }\n\n    // Quote ALL column names to match DuckDB's schema generation\n    // SchemaGenerator always quotes column names, so UPSERT must match\n    const conflict = conflictCols\n      .map((col) => `\"${escapeQuotedIdentifier(col)}\"`)\n      .join(', ');\n    const quotedKeys = keys\n      .map((key) => `\"${escapeQuotedIdentifier(key)}\"`)\n      .join(', ');\n\n    // Quote column names in UPDATE SET clause to match schema and ON CONFLICT\n    // Extract the value expression from each updateSetPart (everything after '=')\n    const quotedUpdateSetParts = keys.map((key, i) => {\n      const part = updateSetParts[i];\n      const valueExpr = part.substring(part.indexOf('=') + 1).trim();\n      return `\"${escapeQuotedIdentifier(key)}\" = ${valueExpr}`;\n    });\n\n    const sql = `INSERT INTO ${table} (${quotedKeys}) VALUES (${placeholders.join(', ')}) ON CONFLICT(${conflict}) DO UPDATE SET ${quotedUpdateSetParts.join(', ')}`;\n\n    try {\n      await connection.run(sql, values);\n\n      // Handle write-back strategy\n      if (writeStrategy === 'immediate') {\n        await exportTableToJSON(connection, table, dataDir);\n      }\n\n      return { operation: 'upsert', affected: 1 };\n    } catch (e) {\n      throw new DatabaseError('Failed to upsert record into table', {\n        table,\n        sql,\n        values,\n        conflictColumns: conflictCols,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Gets a record matching the where criteria or inserts it if not found\n   *\n   * @param table - Table name\n   * @param where - Criteria to match existing record\n   * @param data - Data to insert if no record found\n   * @returns Promise resolving to the record (either retrieved or newly inserted)\n   * @throws Error if the operation fails\n   */\n  const getOrInsert = async (\n    table: string,\n    where: Record<string, any>,\n    data: Record<string, any>,\n  ): Promise<Record<string, any>> => {\n    const result = await get(table, where);\n    if (result) return result;\n\n    await insert(table, data);\n    const inserted = await get(table, where);\n\n    if (!inserted) {\n      throw new DatabaseError('Failed to insert and retrieve record', {\n        table,\n        where,\n        data,\n      });\n    }\n\n    return inserted;\n  };\n\n  /**\n   * Deletes records from a table matching the where criteria\n   *\n   * @param table - Table name\n   * @param where - Criteria to match records for deletion\n   * @returns Promise resolving to operation result with count of deleted rows\n   * @throws Error if the delete operation fails\n   */\n  const deleteRecords = async (\n    table: string,\n    where: Record<string, any>,\n  ): Promise<QueryResult> => {\n    validateTableName(table);\n\n    const keys = Object.keys(where);\n    if (keys.length === 0) {\n      throw new DatabaseError(\n        'DELETE requires at least one WHERE condition to prevent accidental deletion of all records',\n        { table },\n      );\n    }\n\n    const { sql: whereClause, values } = buildWhere(where, 1, 'duckdb');\n    const sql = `DELETE FROM ${table} ${whereClause}`;\n\n    try {\n      await connection.run(sql, values);\n\n      // Handle write-back strategy\n      if (writeStrategy === 'immediate') {\n        await exportTableToJSON(connection, table, dataDir);\n      }\n\n      return { operation: 'delete', affected: 1 };\n    } catch (e) {\n      throw new DatabaseError('Failed to delete records from table', {\n        table,\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Counts records in a table matching the where criteria\n   *\n   * @param table - Table name\n   * @param where - Criteria to match records (optional, counts all if omitted)\n   * @returns Promise resolving to count of matching records\n   * @throws Error if the count operation fails\n   */\n  const count = async (\n    table: string,\n    where?: Record<string, any>,\n  ): Promise<number> => {\n    validateTableName(table);\n\n    try {\n      if (!where || Object.keys(where).length === 0) {\n        // Count all records\n        const result = await connection.runAndReadAll(\n          `SELECT COUNT(*) as count FROM ${table}`,\n        );\n        const rows = result.getRowObjects();\n        return Number(rows[0]?.count) || 0;\n      }\n\n      // Count with conditions\n      const { sql: whereClause, values } = buildWhere(where, 1, 'duckdb');\n      const sql = `SELECT COUNT(*) as count FROM ${table} ${whereClause}`;\n\n      const result = await connection.runAndReadAll(sql, values);\n      const rows = result.getRowObjects();\n\n      return Number(rows[0]?.count) || 0;\n    } catch (e) {\n      throw new DatabaseError('Failed to count records in table', {\n        table,\n        where,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Checks if a table exists in the database\n   *\n   * @param tableName - Name of the table to check\n   * @returns Promise resolving to boolean indicating if the table exists\n   */\n  const tableExists = async (tableName: string): Promise<boolean> => {\n    // The name is interpolated into a statement, and this engine executes every\n    // statement in the string it is given, so an unvalidated name here is a\n    // DDL/DML sink rather than a read oracle — the `catch` below swallows the\n    // error, not the execution. Validation runs outside the try for that\n    // reason: a rejected identifier must be reported, not reported as `false`.\n    validateTableName(tableName);\n    try {\n      // Try to query the table - simpler and works for both tables and views\n      await connection.runAndReadAll(`SELECT * FROM ${tableName} LIMIT 1`);\n      return true;\n    } catch {\n      return false;\n    }\n  };\n\n  /**\n   * Exports a table to a JSON file (for write-back strategies)\n   *\n   * @param connection - DuckDB connection\n   * @param table - Table name\n   * @param dataDir - Directory to write JSON file\n   */\n  const exportTableToJSON = async (\n    connection: any,\n    table: string,\n    dataDir: string,\n  ): Promise<void> => {\n    // Every caller-facing path into this function takes a table name, and it is\n    // interpolated into a COPY statement and into the target file path.\n    // Unvalidated, `exportTable('t TO $$/etc/x$$; DROP ...; --')` both writes a\n    // file outside the data directory and runs the trailing statements.\n    // Validate at this choke point so the internal callers that pass\n    // catalog-derived names are covered too.\n    validateTableName(table);\n\n    const filePath = join(dataDir, `${table}.json`);\n    await connection.run(\n      `COPY (SELECT * FROM ${table}) TO '${filePath}' (FORMAT JSON, ARRAY true)`,\n    );\n  };\n\n  /**\n   * Manual export method for 'manual' write strategy\n   *\n   * @param table - Table name to export\n   * @returns Promise that resolves when export completes\n   */\n  const exportTable = async (table: string): Promise<void> => {\n    if (writeStrategy === 'none') {\n      throw new DatabaseError(\n        'Cannot export table: write strategy is set to none',\n        { table, writeStrategy },\n      );\n    }\n    await exportTableToJSON(connection, table, dataDir);\n  };\n\n  /**\n   * Creates a table-specific interface for simplified table operations\n   *\n   * @param tableName - Table name\n   * @returns TableInterface for the specified table\n   */\n  const table = (tableName: string): TableInterface => ({\n    insert: (data) => insert(tableName, data),\n    get: (where) => get(tableName, where),\n    list: (where) => list(tableName, where),\n  });\n\n  /**\n   * Parses a tagged template literal into a SQL query and values\n   *\n   * @param strings - Template strings\n   * @param vars - Variables to interpolate into the query\n   * @returns Object with SQL query and values array\n   */\n  const parseTemplate = (strings: TemplateStringsArray, ...vars: any[]) => {\n    let sql = strings[0];\n    const values = [];\n    for (let i = 0; i < vars.length; i++) {\n      values.push(vars[i]);\n      sql += `$${i + 1}${strings[i + 1]}`;\n    }\n    return { sql, values };\n  };\n\n  /**\n   * Executes a SQL query using template literals and returns multiple rows\n   *\n   * @param strings - Template strings\n   * @param vars - Variables to interpolate into the query\n   * @returns Promise resolving to array of result records\n   * @throws Error if the query fails\n   */\n  const many = async (\n    strings: TemplateStringsArray,\n    ...vars: any[]\n  ): Promise<Record<string, any>[]> => {\n    const { sql, values } = parseTemplate(strings, ...vars);\n    try {\n      const reader = await connection.runAndReadAll(sql, values);\n      return convertBigInts(reader.getRowObjects());\n    } catch (e) {\n      throw new DatabaseError('Failed to execute many query', {\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Executes a SQL query using template literals and returns a single row\n   *\n   * @param strings - Template strings\n   * @param vars - Variables to interpolate into the query\n   * @returns Promise resolving to a single result record or null\n   * @throws Error if the query fails\n   */\n  const single = async (\n    strings: TemplateStringsArray,\n    ...vars: any[]\n  ): Promise<Record<string, any> | null> => {\n    const { sql, values } = parseTemplate(strings, ...vars);\n    try {\n      const reader = await connection.runAndReadAll(sql, values);\n      const rows = reader.getRowObjects();\n      return rows[0] ? convertBigInts(rows[0]) : null;\n    } catch (e) {\n      throw new DatabaseError('Failed to execute single query', {\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Executes a SQL query using template literals and returns a single value\n   *\n   * @param strings - Template strings\n   * @param vars - Variables to interpolate into the query\n   * @returns Promise resolving to a single value (first column of first row)\n   * @throws Error if the query fails\n   */\n  const pluck = async (\n    strings: TemplateStringsArray,\n    ...vars: any[]\n  ): Promise<any> => {\n    const { sql, values } = parseTemplate(strings, ...vars);\n    try {\n      const reader = await connection.runAndReadAll(sql, values);\n      const rows = reader.getRowObjects();\n      if (rows.length === 0) return null;\n      const firstRow = rows[0];\n      const firstKey = Object.keys(firstRow)[0];\n      return convertBigInts(firstRow[firstKey]);\n    } catch (e) {\n      throw new DatabaseError('Failed to execute pluck query', {\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Executes a SQL query using template literals without returning results\n   *\n   * @param strings - Template strings\n   * @param vars - Variables to interpolate into the query\n   * @returns Promise that resolves when the query completes\n   * @throws Error if the query fails\n   */\n  const execute = async (\n    strings: TemplateStringsArray,\n    ...vars: any[]\n  ): Promise<void> => {\n    const { sql, values } = parseTemplate(strings, ...vars);\n    try {\n      await connection.run(sql, values);\n    } catch (e) {\n      throw new DatabaseError('Failed to execute query', {\n        sql,\n        values,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * Executes a raw SQL query with parameterized values\n   *\n   * @param str - SQL query string\n   * @param values - Variables to use as parameters\n   * @returns Promise resolving to query result with rows and metadata\n   * @throws Error if the query fails\n   */\n  const query = async (str: string, ...values: any[]) => {\n    const sql = str;\n    const args = Array.isArray(values[0]) ? values[0] : values;\n\n    try {\n      const reader = await connection.runAndReadAll(sql, args);\n      const rows = convertBigInts(reader.getRowObjects());\n\n      return {\n        command: sql.split(' ')[0].toUpperCase(),\n        rowCount: rows.length,\n        oid: null,\n        fields:\n          rows.length > 0\n            ? Object.keys(rows[0]).map((name) => ({\n                name,\n                tableID: 0,\n                columnID: 0,\n                dataTypeID: 0,\n                dataTypeSize: -1,\n                dataTypeModifier: -1,\n                format: 'text',\n              }))\n            : [],\n        rows,\n      };\n    } catch (e) {\n      throw new DatabaseError('Failed to execute raw query', {\n        sql,\n        args,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  // Shorthand aliases for query methods\n  const oo = many; // (o)bjective-(o)bjects: returns multiple rows\n  const oO = single; // (o)bjective-(O)bject: returns a single row\n  const ox = pluck; // (o)bjective-(x): returns a single value\n  const xx = execute; // e(x)ecute-e(x)ecute: executes without returning\n\n  /**\n   * Synchronizes database schema with provided SQL DDL\n   *\n   * DuckDB requires UNIQUE constraints to be defined **inline** in CREATE TABLE\n   * statements for ON CONFLICT clauses to work. This method automatically\n   * transforms UNIQUE indexes to inline constraints before executing the schema.\n   *\n   * @param schema - SQL schema definition with CREATE TABLE and CREATE INDEX statements\n   * @returns Promise that resolves when schema is synchronized\n   */\n  const syncSchema = async (schema: string): Promise<void> => {\n    const statements = schema\n      .trim()\n      .split(';')\n      .filter((stmt) => stmt.trim() !== '');\n\n    const createTableStatements: string[] = [];\n    const indexStatements: string[] = [];\n\n    // Separate CREATE TABLE from CREATE INDEX statements\n    for (const stmt of statements) {\n      const trimmed = stmt.trim();\n      if (!trimmed) continue;\n\n      if (\n        trimmed.startsWith('CREATE INDEX') ||\n        trimmed.startsWith('CREATE UNIQUE INDEX')\n      ) {\n        indexStatements.push(trimmed);\n      } else if (trimmed.startsWith('CREATE TABLE')) {\n        createTableStatements.push(trimmed);\n      }\n    }\n\n    // Process each CREATE TABLE statement\n    for (const ddl of createTableStatements) {\n      // Transform UNIQUE indexes to inline constraints for DuckDB compatibility\n      const { ddl: transformedDDL, indexes: remainingIndexes } =\n        convertUniqueIndexesToInlineConstraints(ddl, indexStatements);\n\n      // Execute transformed DDL\n      try {\n        await connection.run(transformedDDL);\n      } catch (e) {\n        console.error('Schema sync error (CREATE TABLE):', e);\n      }\n\n      // Execute remaining (non-UNIQUE) indexes for this table\n      for (const indexSQL of remainingIndexes) {\n        try {\n          await connection.run(indexSQL);\n        } catch (e) {\n          console.error('Schema sync error (CREATE INDEX):', e);\n        }\n      }\n    }\n  };\n\n  /**\n   * Initialize database schemas from JSON manifest\n   * Supports dependency resolution and schema overrides\n   *\n   * @param options - Schema initialization options\n   * @returns Promise that resolves when schemas are initialized\n   */\n  const initializeSchemas = async (\n    options: SchemaInitializationOptions,\n  ): Promise<void> => {\n    const schemaManager = new DatabaseSchemaManager();\n    const currentDb: DatabaseInterface = {\n      url,\n      client: connection,\n      query,\n      insert,\n      update,\n      upsert,\n      get,\n      list,\n      getOrInsert,\n      delete: deleteRecords,\n      count,\n      table,\n      tableExists,\n      many,\n      single,\n      pluck,\n      execute,\n      oo,\n      oO,\n      ox,\n      xx,\n      syncSchema,\n    };\n\n    await schemaManager.initializeSchemas(currentDb, options);\n  };\n\n  /**\n   * Retrieves the schema information for a table\n   *\n   * @param table - Table name\n   * @returns Promise resolving to table schema info or null if table doesn't exist\n   * @throws Error if the query fails\n   */\n  const getTableSchema = async (\n    table: string,\n  ): Promise<TableSchemaInfo | null> => {\n    validateTableName(table);\n\n    try {\n      // Check if table exists\n      const exists = await tableExists(table);\n      if (!exists) {\n        return null;\n      }\n\n      // Get column information from information_schema\n      const columnRows = await many`\n        SELECT\n          column_name,\n          data_type,\n          is_nullable,\n          column_default\n        FROM information_schema.columns\n        WHERE table_name = ${table}\n        ORDER BY ordinal_position\n      `;\n\n      // Get primary key columns from DuckDB system tables\n      const pkRows = await many`\n        SELECT column_name\n        FROM duckdb_constraints() con\n        JOIN duckdb_columns() cols\n          ON con.table_oid = cols.table_oid\n        WHERE con.table_name = ${table}\n          AND con.constraint_type = 'PRIMARY KEY'\n          AND cols.column_name = ANY(con.constraint_column_names)\n      `;\n\n      const pkColumns = new Set(pkRows.map((row) => row.column_name));\n\n      const columns: Record<string, ColumnDefinition> = {};\n      for (const row of columnRows) {\n        const colName = row.column_name as string;\n        columns[colName] = {\n          type: row.data_type as string,\n          primaryKey: pkColumns.has(colName),\n          notNull: row.is_nullable === 'NO',\n          defaultValue: row.column_default,\n        };\n      }\n\n      // Get index information from duckdb_indexes()\n      const indexRows = await many`\n        SELECT\n          index_name,\n          sql\n        FROM duckdb_indexes()\n        WHERE table_name = ${table}\n          AND NOT is_primary\n      `;\n\n      const indexes: IndexDefinition[] = [];\n      for (const row of indexRows) {\n        const indexName = row.index_name as string;\n        const indexDef = (row.sql as string) || '';\n\n        // Parse column names from index definition\n        const colMatch = indexDef.match(/\\(([^)]+)\\)/);\n        const indexColumns = colMatch\n          ? colMatch[1].split(',').map((col) => col.trim())\n          : [];\n\n        const isUnique = indexDef.toUpperCase().includes('UNIQUE');\n\n        indexes.push({\n          name: indexName,\n          columns: indexColumns,\n          unique: isUnique,\n        });\n      }\n\n      // Get foreign key information\n      const fkRows = await many`\n        SELECT\n          constraint_column_names,\n          constraint_column_indexes,\n          constraint_text\n        FROM duckdb_constraints()\n        WHERE table_name = ${table}\n          AND constraint_type = 'FOREIGN KEY'\n      `;\n\n      const foreignKeys: Array<{\n        column: string;\n        referencesTable: string;\n        referencesColumn: string;\n        onDelete?: string;\n        onUpdate?: string;\n      }> = [];\n\n      for (const fkRow of fkRows) {\n        // Parse foreign key constraint text to extract referenced table and column\n        const fkText = (fkRow.constraint_text as string) || '';\n        const referencesMatch = fkText.match(\n          /REFERENCES\\s+(\\w+)\\s*\\(([^)]+)\\)/i,\n        );\n\n        if (\n          referencesMatch &&\n          Array.isArray(fkRow.constraint_column_names) &&\n          fkRow.constraint_column_names.length > 0\n        ) {\n          const columnName = fkRow.constraint_column_names[0];\n          const referencedTable = referencesMatch[1];\n          const referencedColumn = referencesMatch[2].trim();\n\n          const onDeleteMatch = fkText.match(/ON DELETE\\s+(\\w+)/i);\n          const onUpdateMatch = fkText.match(/ON UPDATE\\s+(\\w+)/i);\n\n          foreignKeys.push({\n            column: columnName,\n            referencesTable: referencedTable,\n            referencesColumn: referencedColumn,\n            onDelete: onDeleteMatch ? onDeleteMatch[1] : undefined,\n            onUpdate: onUpdateMatch ? onUpdateMatch[1] : undefined,\n          });\n        }\n      }\n\n      return {\n        tableName: table,\n        columns,\n        indexes,\n        foreignKeys,\n      };\n    } catch (e) {\n      throw new DatabaseError('Failed to retrieve table schema', {\n        table,\n        originalError: formatDbError(e),\n      });\n    }\n  };\n\n  /**\n   * ALTER TABLE operations for schema evolution\n   */\n  const alterTable = {\n    /**\n     * Adds a new column to an existing table\n     *\n     * @param table - Table name\n     * @param column - Column definition with name\n     * @returns Promise that resolves when column is added\n     * @throws Error if the alter operation fails\n     */\n    addColumn: async (\n      table: string,\n      column: ColumnDefinitionWithName,\n    ): Promise<void> => {\n      validateTableName(table);\n      validateColumnName(column.name);\n\n      try {\n        const sql = generateAddColumnStatement(table, column, 'duckdb');\n        await connection.run(sql);\n      } catch (e) {\n        throw new DatabaseError('Failed to add column to table', {\n          table,\n          column: column.name,\n          originalError: formatDbError(e),\n        });\n      }\n    },\n\n    /**\n     * Adds a new index to an existing table\n     *\n     * @param table - Table name\n     * @param index - Index definition\n     * @returns Promise that resolves when index is created\n     * @throws Error if the create index operation fails\n     */\n    addIndex: async (table: string, index: IndexDefinition): Promise<void> => {\n      validateTableName(table);\n      validateIndexName(index.name);\n\n      for (const col of index.columns) {\n        validateColumnName(col);\n      }\n\n      try {\n        const sql = generateCreateIndexStatement(table, index);\n        await connection.run(sql);\n      } catch (e) {\n        throw new DatabaseError('Failed to create index on table', {\n          table,\n          index: index.name,\n          originalError: formatDbError(e),\n        });\n      }\n    },\n  };\n\n  /**\n   * Executes a callback within a database transaction\n   * Automatically commits on success or rolls back on error\n   *\n   * @param callback - Function to execute within transaction\n   * @returns Promise resolving to callback result\n   */\n  const transaction = async <T>(\n    callback: (tx: DatabaseInterface) => Promise<T>,\n  ): Promise<T> =>\n    // Held across the whole BEGIN … COMMIT/ROLLBACK span. Without it two\n    // overlapping calls raced on the one connection: the second BEGIN threw,\n    // its catch ran ROLLBACK, and that rollback ended the *first* transaction\n    // — half of its writes durable, half lost, and its promise rejected, so\n    // the caller was told nothing had happened.\n    connectionLock.run(async () => {\n      try {\n        await connection.run('BEGIN TRANSACTION');\n\n        const result = await callback(createTransactionScope());\n        await connection.run('COMMIT');\n        return result;\n      } catch (error) {\n        // A failing ROLLBACK must not replace the caller's error: DuckDB reports\n        // \"cannot rollback - no transaction is active\" whenever the transaction\n        // is already gone, which says nothing about what actually failed.\n        try {\n          await connection.run('ROLLBACK');\n        } catch {\n          // Nothing left to roll back.\n        }\n        throw error;\n      }\n    });\n\n  /**\n   * Builds the transaction-scoped interface handed to a transaction callback.\n   *\n   * The only difference from the top-level interface is `transaction`, which\n   * refuses to nest. DuckDB has no SAVEPOINT, so there is no way to re-enter\n   * the transaction already in progress; re-exposing the top-level\n   * `transaction` (the previous behaviour) sent the nested call into a second\n   * BEGIN on the same connection, which throws and then rolls back the\n   * *enclosing* transaction, silently discarding its work.\n   */\n  const createTransactionScope = (): DatabaseInterface => {\n    const txDb: DatabaseInterface = {\n      url,\n      client: connection,\n      insert,\n      get,\n      list,\n      update,\n      upsert,\n      getOrInsert,\n      delete: deleteRecords,\n      count,\n      table,\n      many,\n      single,\n      pluck,\n      execute,\n      query,\n      oo,\n      oO,\n      ox,\n      xx,\n      tableExists,\n      syncSchema,\n      transaction: async () => {\n        throw new NestedTransactionError(\n          'Nested transactions are not supported by this adapter because its engine has no SAVEPOINT. Pass the existing transaction to the callee instead of opening a new one.',\n          { adapter: 'duckdb' },\n        );\n      },\n    };\n\n    return txDb;\n  };\n\n  /**\n   * Begins a new transaction and returns a handle for manual control\n   *\n   * Unlike transaction(), this gives you explicit control over commit/rollback.\n   * Ideal for test isolation where you want to rollback after each test.\n   *\n   * @returns Promise resolving to a TransactionHandle\n   */\n  const beginTransaction = async (): Promise<TransactionHandle> => {\n    // The handle owns the connection until the caller ends it, so the lock is\n    // held across the gap rather than around a single call. A handle that is\n    // never committed or rolled back therefore blocks every later transaction\n    // until the queue timeout reports it.\n    const releaseConnection = await connectionLock.acquire();\n    try {\n      await connection.run('BEGIN TRANSACTION');\n    } catch (error) {\n      // No transaction was opened, so there is no handle to end it and nothing\n      // left to release the connection.\n      releaseConnection();\n      throw error;\n    }\n\n    let active = true;\n\n    // COMMIT and ROLLBACK can both throw, and the transaction is over either\n    // way, so the connection goes back before the error is rethrown.\n    const end = async (command: 'COMMIT' | 'ROLLBACK'): Promise<void> => {\n      if (!active) {\n        throw new DatabaseError('Transaction already ended', {});\n      }\n      try {\n        await connection.run(command);\n      } catch (error) {\n        // COMMIT can fail and leave the transaction *open* — SQLite documents\n        // exactly that for SQLITE_BUSY. Releasing the connection then would hand\n        // the next queued caller a connection still inside a transaction: its\n        // BEGIN would throw, and its catch would ROLLBACK, discarding this\n        // transaction's work. So normalize before releasing, the way the pooled\n        // adapter's discardTxClient does.\n        try {\n          await connection.run('ROLLBACK');\n        } catch {\n          // Already gone; nothing left to normalize.\n        }\n        throw error;\n      } finally {\n        active = false;\n        releaseConnection();\n      }\n    };\n\n    const commit = (): Promise<void> => end('COMMIT');\n\n    const rollback = (): Promise<void> => end('ROLLBACK');\n\n    const isActive = (): boolean => active;\n\n    // Create a transaction-scoped database interface with commit/rollback.\n    // The handle is inside a transaction for the same reason a callback\n    // scope is, so it gets the same non-nesting `transaction`.\n    const txHandle: TransactionHandle = {\n      ...createTransactionScope(),\n      commit,\n      rollback,\n      isActive,\n    };\n\n    return txHandle;\n  };\n\n  return {\n    url,\n    requiresSchemaCheck: true,\n    client: connection,\n    query,\n    insert,\n    update,\n    upsert,\n    get,\n    list,\n    getOrInsert,\n    delete: deleteRecords,\n    count,\n    table,\n    tableExists,\n    many,\n    single,\n    pluck,\n    execute,\n    oo,\n    oO,\n    ox,\n    xx,\n    syncSchema,\n    initializeSchemas,\n    transaction,\n    beginTransaction,\n    getTableSchema,\n    alterTable,\n    close: async () => {\n      await closeResources();\n    },\n    // DuckDB-specific export method\n    exportTable,\n  } as DatabaseInterface & { exportTable: (table: string) => Promise<void> };\n}\n"],"mappings":"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"}

package/dist/chunks/{duckdb-schema-utils-B-XBP8QF.js → duckdb-resources-Cci6Lo6H.js}

@@ -110,6 +110,47 @@ function convertUniqueIndexesToInlineConstraints(ddl, indexes) {
 	};
 }
 //#endregion
-export { convertUniqueIndexesToInlineConstraints as t };
+//#region src/shared/duckdb-resources.ts
+/** Best-effort DuckDB resource closer. Successful resources are never closed twice. */
+function createDuckDBResourceCloser(connection, instance) {
+	let connectionClosed = !connection;
+	let instanceClosed = !instance;
+	let active;
+	return async () => {
+		if (connectionClosed && instanceClosed) return;
+		active ??= (async () => {
+			const errors = [];
+			if (!connectionClosed) try {
+				connection?.closeSync();
+				connectionClosed = true;
+			} catch (error) {
+				errors.push(error);
+			}
+			if (!instanceClosed) try {
+				instance?.closeSync();
+				instanceClosed = true;
+			} catch (error) {
+				errors.push(error);
+			}
+			if (errors.length === 1) throw errors[0];
+			if (errors.length > 1) throw new AggregateError(errors, "Failed to close DuckDB resources");
+		})();
+		try {
+			await active;
+		} finally {
+			active = void 0;
+		}
+	};
+}
+async function throwWithDuckDBCleanup(error, close) {
+	try {
+		await close();
+	} catch (cleanupError) {
+		throw new AggregateError([error, cleanupError], "DuckDB initialization and cleanup failed");
+	}
+	throw error;
+}
+//#endregion
+export { throwWithDuckDBCleanup as n, convertUniqueIndexesToInlineConstraints as r, createDuckDBResourceCloser as t };
 
-//# sourceMappingURL=duckdb-schema-utils-B-XBP8QF.js.map
+//# sourceMappingURL=duckdb-resources-Cci6Lo6H.js.map

package/dist/chunks/duckdb-resources-Cci6Lo6H.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-resources-Cci6Lo6H.js","names":[],"sources":["../../src/shared/duckdb-schema-utils.ts","../../src/shared/duckdb-resources.ts"],"sourcesContent":["/**\n * DuckDB-specific schema transformation utilities\n *\n * DuckDB has a known limitation (issue #12684) where ON CONFLICT clauses\n * fail with UNIQUE INDEX but work with inline UNIQUE constraints.\n *\n * This module provides utilities to transform SMRT-generated schemas\n * (which use separate CREATE UNIQUE INDEX statements) into DuckDB-compatible\n * schemas (which use inline UNIQUE constraints).\n */\n\n/**\n * Index definition extracted from CREATE INDEX statement\n */\ninterface ParsedIndex {\n  name: string;\n  columns: string[];\n  unique: boolean;\n  sql: string;\n}\n\n/**\n * Parses a CREATE INDEX statement to extract index details\n *\n * @param indexSQL - CREATE INDEX statement\n * @returns Parsed index definition or null if parsing fails\n *\n * @example\n * ```typescript\n * const index = parseIndexStatement(\n *   'CREATE UNIQUE INDEX ds_slug_context_idx ON ds (slug, context)'\n * );\n * // Returns: {\n * //   name: 'ds_slug_context_idx',\n * //   columns: ['slug', 'context'],\n * //   unique: true,\n * //   sql: '...'\n * // }\n * ```\n */\nexport function parseIndexStatement(indexSQL: string): ParsedIndex | null {\n  const trimmed = indexSQL.trim();\n\n  // Match: CREATE [UNIQUE] INDEX [IF NOT EXISTS] name ON table (columns)\n  // Support both quoted and unquoted identifiers: table, \"table\", columns, \"columns\"\n  const match = trimmed.match(\n    /CREATE\\s+(UNIQUE\\s+)?INDEX\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(\\w+)\\s+ON\\s+(?:\"?\\w+\"?)\\s*\\(([^)]+)\\)/i,\n  );\n\n  if (!match) {\n    return null;\n  }\n\n  const [, uniqueKeyword, name, columnsStr] = match;\n\n  // Remove quotes from column names\n  const columns = columnsStr\n    .split(',')\n    .map((col) => col.trim().replace(/^\"|\"$/g, ''));\n\n  return {\n    name,\n    columns,\n    unique: Boolean(uniqueKeyword),\n    sql: trimmed,\n  };\n}\n\n/**\n * Converts UNIQUE INDEX statements to inline UNIQUE constraints for DuckDB compatibility\n *\n * DuckDB's ON CONFLICT clause requires inline UNIQUE constraints, not separate indexes.\n * This function transforms SMRT-generated schemas to work with DuckDB's limitations.\n *\n * @param ddl - CREATE TABLE DDL statement\n * @param indexes - Array of CREATE INDEX statements (optional)\n * @returns Transformed DDL with inline UNIQUE constraints and filtered index list\n *\n * @example\n * ```typescript\n * const ddl = `\n *   CREATE TABLE ds (\n *     id TEXT PRIMARY KEY,\n *     slug TEXT NOT NULL,\n *     context TEXT NOT NULL\n *   )\n * `;\n * const indexes = [\n *   'CREATE UNIQUE INDEX ds_slug_context_idx ON ds (slug, context)'\n * ];\n *\n * const result = convertUniqueIndexesToInlineConstraints(ddl, indexes);\n * // result.ddl:\n * //   CREATE TABLE ds (\n * //     id TEXT PRIMARY KEY,\n * //     slug TEXT NOT NULL,\n * //     context TEXT NOT NULL,\n * //     UNIQUE(slug, context)\n * //   )\n * // result.indexes: []  (UNIQUE index removed, non-UNIQUE indexes preserved)\n * ```\n */\nexport function convertUniqueIndexesToInlineConstraints(\n  ddl: string,\n  indexes?: string[],\n): {\n  ddl: string;\n  indexes: string[];\n} {\n  if (!indexes || indexes.length === 0) {\n    return { ddl, indexes: [] };\n  }\n\n  // Parse all indexes\n  const parsedIndexes = indexes\n    .map(parseIndexStatement)\n    .filter((idx): idx is ParsedIndex => idx !== null);\n\n  // Separate UNIQUE indexes from regular indexes\n  const uniqueIndexes = parsedIndexes.filter((idx) => idx.unique);\n  const regularIndexes = parsedIndexes.filter((idx) => !idx.unique);\n\n  // If no UNIQUE indexes, return unchanged\n  if (uniqueIndexes.length === 0) {\n    return { ddl, indexes };\n  }\n\n  // Find the closing parenthesis of the CREATE TABLE statement\n  const lines = ddl.split('\\n');\n  let closingParenIndex = -1;\n\n  for (let i = lines.length - 1; i >= 0; i--) {\n    const trimmed = lines[i].trim();\n    if (trimmed === ')' || trimmed.startsWith(');')) {\n      closingParenIndex = i;\n      break;\n    }\n  }\n\n  if (closingParenIndex === -1) {\n    // Can't find closing paren - return unchanged\n    console.warn(\n      '[duckdb-schema-utils] Could not find closing parenthesis in CREATE TABLE statement',\n    );\n    return { ddl, indexes };\n  }\n\n  // Build inline UNIQUE constraints with quoted column names\n  const uniqueConstraints = uniqueIndexes.map((idx) => {\n    const columns = idx.columns.map((col) => `\"${col}\"`).join(', ');\n    return `  UNIQUE(${columns})`;\n  });\n\n  // Insert UNIQUE constraints before closing parenthesis\n  const modifiedLines = [...lines];\n  const closingLine = modifiedLines[closingParenIndex].trim();\n\n  // Add comma to previous line if it doesn't have one\n  if (closingParenIndex > 0) {\n    const prevLine = modifiedLines[closingParenIndex - 1].trim();\n    if (!prevLine.endsWith(',')) {\n      modifiedLines[closingParenIndex - 1] = modifiedLines[\n        closingParenIndex - 1\n      ].replace(/\\s*$/, ',');\n    }\n  }\n\n  // Insert UNIQUE constraints\n  const constraintLines = uniqueConstraints.map((constraint, idx) => {\n    // Add comma after all but the last constraint\n    return idx < uniqueConstraints.length - 1 ? `${constraint},` : constraint;\n  });\n\n  modifiedLines.splice(closingParenIndex, 0, ...constraintLines);\n\n  const transformedDDL = modifiedLines.join('\\n');\n\n  // Return regular (non-UNIQUE) indexes only\n  const remainingIndexes = regularIndexes.map((idx) => idx.sql);\n\n  return {\n    ddl: transformedDDL,\n    indexes: remainingIndexes,\n  };\n}\n\n/**\n * Checks if a schema definition contains UNIQUE indexes that need conversion\n *\n * @param indexes - Array of CREATE INDEX statements\n * @returns True if any UNIQUE indexes are present\n */\nexport function hasUniqueIndexes(indexes?: string[]): boolean {\n  if (!indexes || indexes.length === 0) {\n    return false;\n  }\n\n  return indexes.some((indexSQL) => {\n    const parsed = parseIndexStatement(indexSQL);\n    return parsed?.unique === true;\n  });\n}\n","type SyncClosable = { closeSync(): void };\n\n/** Best-effort DuckDB resource closer. Successful resources are never closed twice. */\nexport function createDuckDBResourceCloser(\n  connection: SyncClosable | undefined,\n  instance: SyncClosable | undefined,\n): () => Promise<void> {\n  let connectionClosed = !connection;\n  let instanceClosed = !instance;\n  let active: Promise<void> | undefined;\n\n  return async () => {\n    if (connectionClosed && instanceClosed) return;\n    active ??= (async () => {\n      const errors: unknown[] = [];\n      if (!connectionClosed) {\n        try {\n          connection?.closeSync();\n          connectionClosed = true;\n        } catch (error) {\n          errors.push(error);\n        }\n      }\n      if (!instanceClosed) {\n        try {\n          instance?.closeSync();\n          instanceClosed = true;\n        } catch (error) {\n          errors.push(error);\n        }\n      }\n      if (errors.length === 1) throw errors[0];\n      if (errors.length > 1)\n        throw new AggregateError(errors, 'Failed to close DuckDB resources');\n    })();\n    try {\n      await active;\n    } finally {\n      active = undefined;\n    }\n  };\n}\n\nexport async function throwWithDuckDBCleanup(\n  error: unknown,\n  close: () => Promise<void>,\n): Promise<never> {\n  try {\n    await close();\n  } catch (cleanupError) {\n    throw new AggregateError(\n      [error, cleanupError],\n      'DuckDB initialization and cleanup failed',\n    );\n  }\n  throw error;\n}\n"],"mappings":"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"}

package/dist/chunks/redact-database-url-CfMDvSdy.js

@@ -0,0 +1,33 @@
+//#region src/shared/redact-database-url.ts
+var CREDENTIAL_PARAM = /(?:auth|credential|key|pass|secret|token)/i;
+var REMOTE_DATABASE_SCHEME = /^((?:https?|libsql):)/i;
+var REMOTE_DATABASE_AUTHORITY = /^(?:https?|libsql):\/\//i;
+function redactMalformedUrl(value) {
+	const authorityStart = value.indexOf("//");
+	if (authorityStart >= 0 && value.indexOf("@", authorityStart + 2) >= 0) return `${value.slice(0, authorityStart + 2)}[redacted]`;
+	const suffixStarts = [value.indexOf("?"), value.indexOf("#")].filter((index) => index >= 0);
+	if (suffixStarts.length === 0) return value;
+	const suffixStart = Math.min(...suffixStarts);
+	return `${value.slice(0, suffixStart)}${value[suffixStart]}[redacted]`;
+}
+/** Redacts credentials without requiring the input to be a valid URL. */
+function redactDatabaseUrl(value) {
+	const remoteCandidate = value.replace(/[\t\n\r]/g, "").trim();
+	const remoteScheme = REMOTE_DATABASE_SCHEME.exec(remoteCandidate);
+	if (remoteScheme && !REMOTE_DATABASE_AUTHORITY.test(remoteCandidate)) return `${remoteScheme[1]}[redacted]`;
+	try {
+		const url = new URL(remoteScheme ? remoteCandidate : value);
+		if (remoteScheme && !url.host) return `${remoteScheme[1]}//[redacted]`;
+		if (url.username) url.username = "[redacted]";
+		if (url.password) url.password = "[redacted]";
+		for (const key of url.searchParams.keys()) if (CREDENTIAL_PARAM.test(key)) url.searchParams.set(key, "[redacted]");
+		if (url.hash) url.hash = "[redacted]";
+		return url.toString();
+	} catch {
+		return redactMalformedUrl(remoteScheme ? remoteCandidate : value);
+	}
+}
+//#endregion
+export { redactDatabaseUrl as t };
+
+//# sourceMappingURL=redact-database-url-CfMDvSdy.js.map

package/dist/chunks/redact-database-url-CfMDvSdy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-database-url-CfMDvSdy.js","names":[],"sources":["../../src/shared/redact-database-url.ts"],"sourcesContent":["const CREDENTIAL_PARAM = /(?:auth|credential|key|pass|secret|token)/i;\nconst REMOTE_DATABASE_SCHEME = /^((?:https?|libsql):)/i;\nconst REMOTE_DATABASE_AUTHORITY = /^(?:https?|libsql):\\/\\//i;\n\nfunction redactMalformedUrl(value: string): string {\n  const authorityStart = value.indexOf('//');\n  if (authorityStart >= 0 && value.indexOf('@', authorityStart + 2) >= 0) {\n    // Once parsing has failed, an `@` may belong to userinfo or to a secret\n    // query/fragment value. Redact the whole malformed authority and suffix so\n    // neither interpretation can expose a credential tail.\n    return `${value.slice(0, authorityStart + 2)}[redacted]`;\n  }\n\n  const queryStart = value.indexOf('?');\n  const fragmentStart = value.indexOf('#');\n  const suffixStarts = [queryStart, fragmentStart].filter(\n    (index) => index >= 0,\n  );\n  if (suffixStarts.length === 0) return value;\n  const suffixStart = Math.min(...suffixStarts);\n  return `${value.slice(0, suffixStart)}${value[suffixStart]}[redacted]`;\n}\n\n/** Redacts credentials without requiring the input to be a valid URL. */\nexport function redactDatabaseUrl(value: string): string {\n  const remoteCandidate = value.replace(/[\\t\\n\\r]/g, '').trim();\n  const remoteScheme = REMOTE_DATABASE_SCHEME.exec(remoteCandidate);\n  if (remoteScheme && !REMOTE_DATABASE_AUTHORITY.test(remoteCandidate)) {\n    return `${remoteScheme[1]}[redacted]`;\n  }\n\n  try {\n    const url = new URL(remoteScheme ? remoteCandidate : value);\n    if (remoteScheme && !url.host) {\n      return `${remoteScheme[1]}//[redacted]`;\n    }\n    if (url.username) url.username = '[redacted]';\n    if (url.password) url.password = '[redacted]';\n    for (const key of url.searchParams.keys()) {\n      if (CREDENTIAL_PARAM.test(key)) url.searchParams.set(key, '[redacted]');\n    }\n    if (url.hash) url.hash = '[redacted]';\n    return url.toString();\n  } catch {\n    return redactMalformedUrl(remoteScheme ? remoteCandidate : value);\n  }\n}\n"],"mappings":";AAAA,IAAM,mBAAmB;AACzB,IAAM,yBAAyB;AAC/B,IAAM,4BAA4B;AAElC,SAAS,mBAAmB,OAAuB;CACjD,MAAM,iBAAiB,MAAM,QAAQ,IAAI;CACzC,IAAI,kBAAkB,KAAK,MAAM,QAAQ,KAAK,iBAAiB,CAAC,KAAK,GAInE,OAAO,GAAG,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE;CAK/C,MAAM,eAAe,CAFF,MAAM,QAAQ,GAEX,GADA,MAAM,QAAQ,GACF,CAAa,CAAC,CAAC,QAC9C,UAAU,SAAS,CACtB;CACA,IAAI,aAAa,WAAW,GAAG,OAAO;CACtC,MAAM,cAAc,KAAK,IAAI,GAAG,YAAY;CAC5C,OAAO,GAAG,MAAM,MAAM,GAAG,WAAW,IAAI,MAAM,aAAa;AAC7D;;AAGA,SAAgB,kBAAkB,OAAuB;CACvD,MAAM,kBAAkB,MAAM,QAAQ,aAAa,EAAE,CAAC,CAAC,KAAK;CAC5D,MAAM,eAAe,uBAAuB,KAAK,eAAe;CAChE,IAAI,gBAAgB,CAAC,0BAA0B,KAAK,eAAe,GACjE,OAAO,GAAG,aAAa,GAAG;CAG5B,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,eAAe,kBAAkB,KAAK;EAC1D,IAAI,gBAAgB,CAAC,IAAI,MACvB,OAAO,GAAG,aAAa,GAAG;EAE5B,IAAI,IAAI,UAAU,IAAI,WAAW;EACjC,IAAI,IAAI,UAAU,IAAI,WAAW;EACjC,KAAK,MAAM,OAAO,IAAI,aAAa,KAAK,GACtC,IAAI,iBAAiB,KAAK,GAAG,GAAG,IAAI,aAAa,IAAI,KAAK,YAAY;EAExE,IAAI,IAAI,MAAM,IAAI,OAAO;EACzB,OAAO,IAAI,SAAS;CACtB,QAAQ;EACN,OAAO,mBAAmB,eAAe,kBAAkB,KAAK;CAClE;AACF"}

package/dist/chunks/{sqlite-Crx5PQ3G.js → sqlite-B2bnGN2x.js}

@@ -1,17 +1,13 @@
-import { a as validateColumnName, c as validateTableName, d as formatDbError, i as generateCreateIndexStatement, l as DatabaseSchemaManager, m as resolveInsertColumns, o as validateColumnNames, r as generateAddColumnStatement, s as validateIndexName, u as buildWhere } from "./alter-utils-DeDDAATm.js";
+import { a as generateAddColumnStatement, c as validateColumnNames, d as DatabaseSchemaManager, f as buildWhere, g as resolveInsertColumns, l as validateIndexName, n as validateDatabaseCacheOptions, o as generateCreateIndexStatement, p as formatDbError, s as validateColumnName, u as validateTableName } from "./connection-cache-6EMfKWpo.js";
+import { t as redactDatabaseUrl } from "./redact-database-url-CfMDvSdy.js";
 import { n as resolveSchemas, r as createTransactionLock } from "./types-uVFHgaSU.js";
+import { t as getCachedSqliteDatabase } from "./sqlite-connection-cache-0iFbrrI3.js";
 import { DatabaseError } from "@happyvertical/utils";
 //#region src/sqlite.ts
 /**
 * Connection cache for in-memory databases with memoryId
 * Enables sharing of :memory: databases across multiple getDatabase() calls
 */
-var memoryConnectionCache = /* @__PURE__ */ new Map();
-/**
-* Pending connection promises to handle concurrent getDatabase() calls
-* Prevents creating duplicate connections when parallel calls happen
-*/
-var pendingConnections = /* @__PURE__ */ new Map();
 var NULL_AWARE_UPSERT_MAX_ATTEMPTS = 8;
 var NULL_AWARE_UPSERT_BASE_DELAY_MS = 25;
 var nullAwareUpsertLocks = /* @__PURE__ */ new Map();
@@ -55,7 +51,23 @@ function generateDbId() {
 async function createLibSQLClient(options) {
 	const { url = ":memory:", authToken, encryptionKey } = options;
 	let libsqlUrl = url;
-	if (url !== ":memory:" && !url.startsWith("http://") && !url.startsWith("https://") && !url.startsWith("libsql://") && !url.startsWith("file:")) {
+	const remoteUrl = url.replace(/[\t\n\r]/g, "").trim();
+	const hasRemoteScheme = /^(?:https?|libsql):/i.test(remoteUrl);
+	if (hasRemoteScheme) {
+		libsqlUrl = remoteUrl;
+		let parsedRemoteUrl;
+		try {
+			parsedRemoteUrl = new URL(remoteUrl);
+		} catch {
+			const safeUrl = redactDatabaseUrl(remoteUrl);
+			throw new DatabaseError(`Invalid remote database URL: ${safeUrl}`, { url: safeUrl });
+		}
+		if (!/^(?:https?|libsql):\/\//i.test(remoteUrl) || !parsedRemoteUrl.host) {
+			const safeUrl = redactDatabaseUrl(remoteUrl);
+			throw new DatabaseError(`Invalid remote database URL: ${safeUrl}`, { url: safeUrl });
+		}
+	}
+	if (url !== ":memory:" && !hasRemoteScheme && !url.startsWith("file:")) {
 		const { resolve } = await import("node:path");
 		libsqlUrl = `file://${resolve(url)}`;
 	}
@@ -70,13 +82,14 @@ async function createLibSQLClient(options) {
 			encryptionKey
 		});
 	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : String(error);
-		if (errorMessage?.includes("URL_SCHEME_NOT_SUPPORTED")) throw new DatabaseError(`Unsupported URL scheme. Use ':memory:' for in-memory databases or 'libsql://' for remote LibSQL databases. Original: ${url}, Converted: ${libsqlUrl}`, {
-			url: libsqlUrl,
+		const errorMessage = redactDatabaseUrl(error instanceof Error ? error.message : String(error));
+		const safeUrl = redactDatabaseUrl(libsqlUrl);
+		if (errorMessage?.includes("URL_SCHEME_NOT_SUPPORTED")) throw new DatabaseError(`Unsupported URL scheme. Use ':memory:' for in-memory databases or 'libsql://' for remote LibSQL databases. URL: ${safeUrl}`, {
+			url: safeUrl,
 			originalError: errorMessage
 		});
 		throw new DatabaseError(`Failed to create LibSQL client: ${errorMessage}`, {
-			url: libsqlUrl,
+			url: safeUrl,
 			originalError: errorMessage
 		});
 	}
@@ -128,20 +141,27 @@ async function createTablesFromSchemas(client, schemas) {
 * @returns Database interface for SQLite
 */
 async function getDatabase(options = {}) {
+	validateDatabaseCacheOptions(options);
 	const url = options.url || ":memory:";
-	if (url === ":memory:" && !options.dbid) options.dbid = generateDbId();
-	if (hasNativeSqliteCapabilities(options)) return (await import("./sqlite-native-DCAaADpP.js")).getNativeSqliteDatabase(options);
-	if (options.dbid) {
-		const cached = memoryConnectionCache.get(options.dbid);
-		if (cached) return cached;
-		const pending = pendingConnections.get(options.dbid);
-		if (pending) return pending;
-	}
-	const connectionPromise = (async () => {
+	if (url === ":memory:" && !options.dbid && options.cache !== false) options.dbid = generateDbId();
+	if (hasNativeSqliteCapabilities(options)) return (await import("./sqlite-native-Dc8eFStu.js")).getNativeSqliteDatabase(options);
+	return getCachedSqliteDatabase("libsql", options, () => createDatabase(options, url));
+}
+async function createDatabase(options, url) {
+	return (async () => {
 		const client = await createLibSQLClient(options);
 		const connectionLock = createTransactionLock("sqlite", options.transactionQueueTimeout);
 		const resolvedSchemas = resolveSchemas(options.schemas);
-		if (resolvedSchemas && Object.keys(resolvedSchemas).length > 0) await createTablesFromSchemas(client, resolvedSchemas);
+		if (resolvedSchemas && Object.keys(resolvedSchemas).length > 0) try {
+			await createTablesFromSchemas(client, resolvedSchemas);
+		} catch (error) {
+			try {
+				client.close();
+			} catch (cleanupError) {
+				throw new AggregateError([error, cleanupError], "LibSQL schema initialization and cleanup failed");
+			}
+			throw error;
+		}
 		/**
 		* Serializes a value for SQLite storage
 		* Converts objects and arrays to JSON strings
@@ -167,8 +187,7 @@ async function getDatabase(options = {}) {
 		};
 		const hasNullConflictValue = (conflictColumns, data) => conflictColumns.some((col) => data[col] === null);
 		const buildNullAwareUpsertLockKey = (table, conflictColumns, data) => {
-			const conflictValues = conflictColumns.map((col) => `${col}:${JSON.stringify(data[col])}`).join("|");
-			return `${url}:${table}:${conflictValues}`;
+			return `${url}:${table}:${conflictColumns.map((col) => `${col}:${JSON.stringify(data[col])}`).join("|")}`;
 		};
 		const validateUpsertConflictColumns = (table, conflictColumns, serializedData) => {
 			const missingColumns = conflictColumns.filter((col) => !(col in serializedData));
@@ -1017,6 +1036,63 @@ async function getDatabase(options = {}) {
 				});
 			}
 		};
+		/**
+		* ALTER TABLE operations for schema evolution
+		*/
+		const alterTable = {
+			/**
+			* Adds a new column to an existing table
+			*
+			* @param table - Table name
+			* @param column - Column definition with name
+			* @returns Promise that resolves when column is added
+			* @throws Error if the alter operation fails
+			*/
+			addColumn: async (table, column) => {
+				validateTableName(table);
+				validateColumnName(column.name);
+				try {
+					const sql = generateAddColumnStatement(table, column, "sqlite");
+					await client.execute({
+						sql,
+						args: []
+					});
+				} catch (e) {
+					throw new DatabaseError("Failed to add column to table", {
+						table,
+						column: column.name,
+						originalError: formatDbError(e)
+					});
+				}
+			},
+			/**
+			* Adds a new index to an existing table
+			*
+			* @param table - Table name
+			* @param index - Index definition
+			* @returns Promise that resolves when index is created
+			* @throws Error if the create index operation fails
+			*/
+			addIndex: async (table, index) => {
+				validateTableName(table);
+				validateIndexName(index.name);
+				for (const col of index.columns) validateColumnName(col);
+				try {
+					const sql = generateCreateIndexStatement(table, index);
+					await client.execute({
+						sql,
+						args: []
+					});
+				} catch (e) {
+					throw new DatabaseError("Failed to create index on table", {
+						table,
+						index: index.name,
+						originalError: formatDbError(e)
+					});
+				}
+			}
+		};
+		let closed = false;
 		return {
 			url,
 			client,
@@ -1044,71 +1120,16 @@ async function getDatabase(options = {}) {
 			transaction,
 			beginTransaction,
 			getTableSchema,
-			alterTable: {
-				/**
-				* Adds a new column to an existing table
-				*
-				* @param table - Table name
-				* @param column - Column definition with name
-				* @returns Promise that resolves when column is added
-				* @throws Error if the alter operation fails
-				*/
-				addColumn: async (table, column) => {
-					validateTableName(table);
-					validateColumnName(column.name);
-					try {
-						const sql = generateAddColumnStatement(table, column, "sqlite");
-						await client.execute({
-							sql,
-							args: []
-						});
-					} catch (e) {
-						throw new DatabaseError("Failed to add column to table", {
-							table,
-							column: column.name,
-							originalError: formatDbError(e)
-						});
-					}
-				},
-				/**
-				* Adds a new index to an existing table
-				*
-				* @param table - Table name
-				* @param index - Index definition
-				* @returns Promise that resolves when index is created
-				* @throws Error if the create index operation fails
-				*/
-				addIndex: async (table, index) => {
-					validateTableName(table);
-					validateIndexName(index.name);
-					for (const col of index.columns) validateColumnName(col);
-					try {
-						const sql = generateCreateIndexStatement(table, index);
-						await client.execute({
-							sql,
-							args: []
-						});
-					} catch (e) {
-						throw new DatabaseError("Failed to create index on table", {
-							table,
-							index: index.name,
-							originalError: formatDbError(e)
-						});
-					}
-				}
+			alterTable,
+			close: async () => {
+				if (closed) return;
+				client.close();
+				closed = true;
 			}
 		};
 	})();
-	if (options.dbid) pendingConnections.set(options.dbid, connectionPromise);
-	try {
-		const db = await connectionPromise;
-		if (options.dbid) memoryConnectionCache.set(options.dbid, db);
-		return db;
-	} finally {
-		if (options.dbid) pendingConnections.delete(options.dbid);
-	}
 }
 //#endregion
 export { getDatabase };
 
-//# sourceMappingURL=sqlite-Crx5PQ3G.js.map
+//# sourceMappingURL=sqlite-B2bnGN2x.js.map