@happyvertical/sql 0.112.2 → 0.113.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/AGENT.md +18 -0
  2. package/README.md +100 -1
  3. package/dist/chunks/{duckdb-DCV4JFWK.js → duckdb-aMJ05d68.js} +11 -4
  4. package/dist/chunks/duckdb-aMJ05d68.js.map +1 -0
  5. package/dist/chunks/{postgres-dialect-CaNhva-C.js → postgres-dialect-C8GwYO-9.js} +14 -3
  6. package/dist/chunks/postgres-dialect-C8GwYO-9.js.map +1 -0
  7. package/dist/chunks/{query-Dz0TZ0pY.js → query-CcLSVKOo.js} +3 -46
  8. package/dist/chunks/query-CcLSVKOo.js.map +1 -0
  9. package/dist/chunks/{sqlite-nNhv0FMq.js → sqlite-DAzuB3Hb.js} +18 -11
  10. package/dist/chunks/sqlite-DAzuB3Hb.js.map +1 -0
  11. package/dist/chunks/sqlite-engine-ByvkAlrK.js +205 -0
  12. package/dist/chunks/sqlite-engine-ByvkAlrK.js.map +1 -0
  13. package/dist/chunks/{sqlite-native-CZGNm9zh.js → sqlite-native-Dj0hF4qn.js} +13 -6
  14. package/dist/chunks/sqlite-native-Dj0hF4qn.js.map +1 -0
  15. package/dist/chunks/{schema-manager-psLzQ2yh.js → types-DihIt7ez.js} +73 -2
  16. package/dist/chunks/types-DihIt7ez.js.map +1 -0
  17. package/dist/duckdb.d.ts.map +1 -1
  18. package/dist/index.d.ts +2 -2
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +31 -6
  21. package/dist/index.js.map +1 -1
  22. package/dist/json.d.ts.map +1 -1
  23. package/dist/pglite.d.ts.map +1 -1
  24. package/dist/pglite.js +9 -2
  25. package/dist/pglite.js.map +1 -1
  26. package/dist/postgres.d.ts.map +1 -1
  27. package/dist/query.js +3 -3
  28. package/dist/shared/reopen.d.ts +7 -0
  29. package/dist/shared/reopen.d.ts.map +1 -0
  30. package/dist/shared/sqlite-engine.d.ts +32 -0
  31. package/dist/shared/sqlite-engine.d.ts.map +1 -0
  32. package/dist/shared/types.d.ts +91 -0
  33. package/dist/shared/types.d.ts.map +1 -1
  34. package/dist/sqlite-native.d.ts.map +1 -1
  35. package/dist/sqlite.d.ts.map +1 -1
  36. package/package.json +3 -3
  37. package/dist/chunks/duckdb-DCV4JFWK.js.map +0 -1
  38. package/dist/chunks/postgres-dialect-CaNhva-C.js.map +0 -1
  39. package/dist/chunks/query-Dz0TZ0pY.js.map +0 -1
  40. package/dist/chunks/schema-manager-psLzQ2yh.js.map +0 -1
  41. package/dist/chunks/sqlite-connection-cache-BycfrYfi.js +0 -70
  42. package/dist/chunks/sqlite-connection-cache-BycfrYfi.js.map +0 -1
  43. package/dist/chunks/sqlite-nNhv0FMq.js.map +0 -1
  44. package/dist/chunks/sqlite-native-CZGNm9zh.js.map +0 -1
package/AGENT.md CHANGED
@@ -93,3 +93,21 @@ malformed names and expressions still reject.
93
93
 
94
94
  Aggregate numeric compatibility applies to operands/ordinals, while SELECT aliases,
95
95
  FROM/JOIN names and ORDER BY selected aliases always use identifier rendering.
96
+
97
+ ## SQLite engines: `db.engine` and `db.reopenOptions()`
98
+
99
+ A SQLite file opens through `node:sqlite` (`secureFile`, native `capabilities`)
100
+ or `@libsql/client` (everything else). These are separate copies of SQLite
101
+ whose locks do not coordinate, so one file must never be held through both in
102
+ one process, including a worker thread. `db.engine` is `'node-sqlite' |
103
+ 'libsql' | 'postgres' | 'pglite' | 'duckdb' | 'json'`, present on connections,
104
+ transaction handles and scoped `tx`. Open a worker's second connection with
105
+ `getDatabase(db.reopenOptions())`, which keeps the engine; it throws
106
+ `ReopenNotSupportedError` for `:memory:`, PGlite, DuckDB and JSON. Do not call
107
+ `getDatabase({ type: 'sqlite', url })` for a file another connection holds
108
+ through `secureFile`. An in-thread mix emits warning `HV_SQL_SQLITE_ENGINE_MIX`;
109
+ workers are not seen. Never change the default engine selection for this.
110
+ `reopenOptions()` carries no PRAGMAs: re-apply `PRAGMA busy_timeout` in the worker
111
+ or its writes fail at once with "database is locked". `secureFile.windowsCustody`
112
+ (a function) is left out of the options; a Windows worker supplies its own.
113
+ `engine === undefined` means a wrapper or double: treat as unsafe to share.
package/README.md CHANGED
@@ -355,6 +355,105 @@ acquisition is intentional. Secure mode requires the package's supported Node
355
355
  runtime with built-in `node:sqlite`; it installs no additional native peer.
356
356
  Default LibSQL use remains unchanged.
357
357
 
358
+ ### Which SQLite engine backs a connection, and a second connection on the same engine
359
+
360
+ A SQLite file can be opened through two separate copies of SQLite that live in
361
+ one process: the `node:sqlite` built into Node (used by `secureFile` and by
362
+ native `capabilities`) and the one inside `@libsql/client` (used by every other
363
+ local or remote SQLite connection). Their file locks do not coordinate. If both
364
+ hold one file in the same process, a writer on one does not wait for a writer
365
+ on the other, and a WAL-mode file is corrupted within seconds (`locking
366
+ protocol`, `database disk image is malformed`). This applies across threads
367
+ too: a worker thread that opens `{ type: 'sqlite', url }` gets libsql even when
368
+ the main thread holds the file through `node:sqlite`.
369
+
370
+ Ask the connection which engine it uses:
371
+
372
+ ```typescript
373
+ const db = await getDatabase({ type: 'sqlite', url: 'app.db', secureFile });
374
+ db.engine; // 'node-sqlite'
375
+ // 'node-sqlite' | 'libsql' | 'postgres' | 'pglite' | 'duckdb' | 'json'
376
+ ```
377
+
378
+ `db.engine` is the same on the connection, on `beginTransaction()` handles and
379
+ on the `tx` passed to `transaction()`. Two connections to one SQLite file are
380
+ safe together only when their `engine` values are equal.
381
+
382
+ To open a second connection from a worker thread, take the options from the
383
+ first one instead of rebuilding them:
384
+
385
+ ```typescript
386
+ import { Worker } from 'node:worker_threads';
387
+
388
+ new Worker(new URL('./worker.js', import.meta.url), {
389
+ workerData: { db: db.reopenOptions?.() },
390
+ });
391
+
392
+ // worker.js
393
+ const second = await getDatabase(workerData.db); // same engine, own connection
394
+ ```
395
+
396
+ `reopenOptions()` returns an opaque `ReopenOptions` value (pass it straight to
397
+ `getDatabase`) that reopens the same database on the same
398
+ engine, with no cache identity, so each `getDatabase` call is a separate
399
+ connection. A `secureFile` connection yields `secureFile` options (and so
400
+ `node:sqlite`); a plain one yields `@libsql/client` options. The result can hold
401
+ credentials (`authToken`, `encryptionKey`, `password`). It is plain data that
402
+ survives `structuredClone`, `workerData` and `postMessage` unchanged, and it is a
403
+ copy: changing it does not change the connection. Paths, including
404
+ `secureFile.root`, are made absolute when the connection is opened, so a later
405
+ `process.chdir` does not move them.
406
+
407
+ `secureFile.windowsCustody` is a function and cannot cross a thread boundary, so
408
+ it is **left out** of the options. That keeps the custody check from being
409
+ smuggled across: on Windows `getDatabase` fails closed in the worker until the
410
+ worker passes its own verifier
411
+ (`{ ...options, secureFile: { ...options.secureFile, windowsCustody } }`). It is
412
+ ignored on macOS and Linux.
413
+
414
+ **Per-connection settings are not carried over.** Neither engine sets a busy
415
+ timeout, so a reopened connection that overlaps a write fails at once with
416
+ `database is locked` (it is safe, not patient). Re-apply what you set on the
417
+ first connection after reopening, for example
418
+ `await second.query('PRAGMA busy_timeout = 5000')`, which makes the write wait
419
+ for the lock instead. The same goes for any other `PRAGMA` or temporary table.
420
+
421
+ PostgreSQL reopens get their own pool, not a share of the first one, with `max`
422
+ capped at 5 by default (set `max` on the returned options to change it).
423
+
424
+ | Connection | `engine` | `reopenOptions()` |
425
+ |------------|----------|-------------------|
426
+ | SQLite file, default | `'libsql'` | `{ type: 'sqlite', url, ... }` |
427
+ | SQLite file, `secureFile` or native `capabilities` | `'node-sqlite'` | same, with `secureFile` / `capabilities` |
428
+ | SQLite remote (`libsql://`, `https://`) | `'libsql'` | same URL and `authToken` |
429
+ | SQLite `:memory:` | `'libsql'` | throws `ReopenNotSupportedError` |
430
+ | PostgreSQL | `'postgres'` | the effective connection options |
431
+ | PGlite, DuckDB, JSON | `'pglite'`, `'duckdb'`, `'json'` | throws `ReopenNotSupportedError` |
432
+
433
+ `ReopenNotSupportedError` (a `DatabaseError`, with an `engine` property) means
434
+ the database has one owner: an in-memory database exists only inside its
435
+ connection, DuckDB and PGlite hold their files exclusively, and JSON keeps a
436
+ private in-memory copy per connection. Keep that work on the existing
437
+ connection.
438
+
439
+ When one thread opens the same resolved file path through both engines, the
440
+ adapter emits a one-time process warning with code `HV_SQL_SQLITE_ENGINE_MIX`.
441
+ It only sees connections in its own thread, because the bookkeeping is
442
+ per-thread module state; it cannot see a worker. Check `engine` where you hand
443
+ a file to another thread. It never refuses, so existing callers keep working.
444
+
445
+ Reading `engine`:
446
+
447
+ - `undefined` means the object is not an adapter connection from this package (a
448
+ wrapper, a proxy, a hand-written test double). Treat it as unsafe to share a
449
+ file with; do not assume it matches anything.
450
+ - Local and remote libsql both report `'libsql'`; remote databases have no local
451
+ file lock to share, so only a local `url` matters for the hazard.
452
+ - `'node-sqlite'` names the copy of SQLite the connection uses. A connection with
453
+ native `notifications` also opens the same file through the optional honker
454
+ module, which may carry its own copy of SQLite; that hazard predates
455
+ `engine` and is not described by it.
456
+
358
457
  ### Template Literal Queries
359
458
 
360
459
  ```typescript
@@ -1037,7 +1136,7 @@ shipping it beyond development or test environments.
1037
1136
 
1038
1137
  **Factory**: `getDatabase(options)` — creates or returns a cached database connection.
1039
1138
 
1040
- **Interface** (`DatabaseInterface`): `many`, `single`, `pluck`, `execute`, `query`, `insert`, `get`, `list`, `update`, `upsert`, `getOrInsert`, `delete`, `count`, `table`, `tableExists`, `syncSchema`, `transaction`, `beginTransaction`, `vector`, `notifications`, `close`.
1139
+ **Interface** (`DatabaseInterface`): `many`, `single`, `pluck`, `execute`, `query`, `insert`, `get`, `list`, `update`, `upsert`, `getOrInsert`, `delete`, `count`, `table`, `tableExists`, `syncSchema`, `transaction`, `beginTransaction`, `vector`, `notifications`, `close`, plus `engine` and `reopenOptions()` (see above).
1041
1140
 
1042
1141
  **Utilities**: `buildWhere`, `raw`, `syncSchema`, `tableExists`, `escapeSqlValue`, `validateColumnName`, `formatDbError`, `convertUniqueIndexesToInlineConstraints`.
1043
1142
 
@@ -1,6 +1,6 @@
1
- import { C as validateColumnNames, E as validateTableName, S as validateColumnName, T as validatePlainColumnName, d as escapeStringLiteral, f as generateAddColumnStatement, g as quoteDuckDBColumnName, i as formatDbError, n as buildAdapterWhere, p as generateCreateIndexStatement, s as resolveInsertColumns, t as DatabaseSchemaManager, u as wrapDatabaseError, w as validateIndexName } from "./schema-manager-psLzQ2yh.js";
2
- import { a as NestedTransactionError, o as resolveSchemas, s as convertUniqueIndexesToInlineConstraints } from "./query-Dz0TZ0pY.js";
3
- import { c as createTransactionLock, d as validateDatabaseCacheOptions } from "./postgres-dialect-CaNhva-C.js";
1
+ import { D as validateIndexName, E as validateColumnNames, O as validatePlainColumnName, T as validateColumnName, a as buildAdapterWhere, g as generateCreateIndexStatement, h as generateAddColumnStatement, i as DatabaseSchemaManager, k as validateTableName, m as escapeStringLiteral, p as wrapDatabaseError, r as resolveSchemas, s as formatDbError, t as NestedTransactionError, u as resolveInsertColumns, y as quoteDuckDBColumnName } from "./types-DihIt7ez.js";
2
+ import { a as convertUniqueIndexesToInlineConstraints } from "./query-CcLSVKOo.js";
3
+ import { c as createTransactionLock, f as validateDatabaseCacheOptions, l as refuseReopen } from "./postgres-dialect-C8GwYO-9.js";
4
4
  import { n as createDuckDBResourceCloser, r as throwWithDuckDBCleanup, t as serializeDuckDBStatements } from "./duckdb-statement-queue-BJ6-PQRr.js";
5
5
  import { t as redactDatabaseUrl } from "./redact-database-url-CfMDvSdy.js";
6
6
  import { DatabaseError } from "@happyvertical/utils";
@@ -165,6 +165,7 @@ async function getDatabase(options = {}) {
165
165
  const url = resolveDuckDBUrl(options.url || ":memory:");
166
166
  const connectionLock = createTransactionLock("duckdb", options.transactionQueueTimeout);
167
167
  const closeResources = createDuckDBResourceCloser(connection, instance);
168
+ const reopenOptions = refuseReopen("duckdb", "DuckDB allows one instance per database file in a process, so a second thread cannot open it");
168
169
  /**
169
170
  * Inserts one or more records into a table
170
171
  *
@@ -747,6 +748,8 @@ async function getDatabase(options = {}) {
747
748
  const schemaManager = new DatabaseSchemaManager();
748
749
  const currentDb = {
749
750
  url,
751
+ engine: "duckdb",
752
+ reopenOptions,
750
753
  client: connection,
751
754
  query,
752
755
  insert,
@@ -959,6 +962,8 @@ async function getDatabase(options = {}) {
959
962
  const createTransactionScope = () => {
960
963
  return {
961
964
  url,
965
+ engine: "duckdb",
966
+ reopenOptions,
962
967
  client: connection,
963
968
  insert,
964
969
  get,
@@ -1028,6 +1033,8 @@ async function getDatabase(options = {}) {
1028
1033
  };
1029
1034
  return {
1030
1035
  url,
1036
+ engine: "duckdb",
1037
+ reopenOptions,
1031
1038
  requiresSchemaCheck: true,
1032
1039
  client: connection,
1033
1040
  query,
@@ -1064,4 +1071,4 @@ async function getDatabase(options = {}) {
1064
1071
  //#endregion
1065
1072
  export { getDatabase };
1066
1073
 
1067
- //# sourceMappingURL=duckdb-DCV4JFWK.js.map
1074
+ //# sourceMappingURL=duckdb-aMJ05d68.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"duckdb-aMJ05d68.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 escapeStringLiteral,\n generateAddColumnStatement,\n generateCreateIndexStatement,\n quoteDuckDBColumnName,\n validateColumnName,\n validateColumnNames,\n validateIndexName,\n validatePlainColumnName,\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 { serializeDuckDBStatements } from './shared/duckdb-statement-queue';\nimport { redactDatabaseUrl } from './shared/redact-database-url';\nimport { refuseReopen } from './shared/reopen';\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 buildAdapterWhere as buildWhere,\n formatDbError,\n resolveInsertColumns,\n wrapDatabaseError,\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='${escapeStringLiteral(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 // One connection serves every call on this handle; queue its statements.\n connection = serializeDuckDBStatements(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 const reopenOptions = refuseReopen(\n 'duckdb',\n 'DuckDB allows one instance per database file in a process, so a second thread cannot open it',\n );\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.map((key) => quoteDuckDBColumnName(key)).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\n .map((key, idx) => `${quoteDuckDBColumnName(key)} = $${idx + 1}`)\n .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) => [\n quoteDuckDBColumnName(col, true),\n data[col],\n ]),\n );\n const existing = await get(table, conflictWhere);\n\n if (!existing) {\n return insert(\n table,\n Object.fromEntries(\n Object.entries(data).map(([key, value]) => [\n quoteDuckDBColumnName(key, true),\n value,\n ]),\n ),\n );\n }\n\n const keys = Object.keys(data);\n const updateKeys = keys.filter((key) => !conflictColumns.includes(key));\n if (updateKeys.length === 0) {\n return { operation: 'upsert', affected: 1 };\n }\n const values: any[] = [];\n const paramIdx = { value: 1 };\n const assignments = updateKeys.map((key) => {\n const valueExpr = buildDuckDBValueExpression(data[key], values, paramIdx);\n return `${quoteDuckDBColumnName(key, true)} = ${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 and record keys remain literal physical names, including dots,\n // spaces and quote characters. The NULL-aware branch delimits those names\n // before passing them to the qualified WHERE renderer.\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 const updateKeys = keys.filter((key) => !conflictCols.includes(key));\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 const updateIndex = { value: paramIdx };\n const quotedUpdateSetParts = updateKeys.map(\n (key) =>\n `${quoteDuckDBColumnName(key, true)} = ${buildDuckDBValueExpression(record[key], values, updateIndex)}`,\n );\n const conflict = conflictCols\n .map((col) => quoteDuckDBColumnName(col, true))\n .join(', ');\n const quotedKeys = keys\n .map((key) => quoteDuckDBColumnName(key, true))\n .join(', ');\n\n const conflictAction =\n quotedUpdateSetParts.length > 0\n ? `DO UPDATE SET ${quotedUpdateSetParts.join(', ')}`\n : 'DO NOTHING';\n const sql = `INSERT INTO ${table} (${quotedKeys}) VALUES (${placeholders.join(', ')}) ON CONFLICT(${conflict}) ${conflictAction}`;\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 '${escapeStringLiteral(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 wrapDatabaseError('Failed to execute raw query', e, {\n sql,\n args,\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 engine: 'duckdb',\n reopenOptions,\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 let sql: string | undefined;\n try {\n sql = generateAddColumnStatement(table, column, 'duckdb');\n await connection.run(sql);\n } catch (e) {\n throw wrapDatabaseError('Failed to add column to table', e, {\n table,\n column: column.name,\n ...(sql ? { sql } : {}),\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 validatePlainColumnName(col);\n }\n\n let sql: string | undefined;\n try {\n sql = generateCreateIndexStatement(table, index, 'duckdb');\n await connection.run(sql);\n } catch (e) {\n throw wrapDatabaseError('Failed to create index on table', e, {\n table,\n index: index.name,\n ...(sql ? { sql } : {}),\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 engine: 'duckdb',\n reopenOptions,\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 engine: 'duckdb',\n reopenOptions,\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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"}
@@ -1,4 +1,4 @@
1
- import { C as validateColumnNames, E as validateTableName, S as validateColumnName, T as validatePlainColumnName, _ as quoteLiteralIdentifier, c as rewriteSqlParameters, f as generateAddColumnStatement, i as formatDbError, n as buildAdapterWhere, p as generateCreateIndexStatement, s as resolveInsertColumns, u as wrapDatabaseError, v as quotePostgresColumnName, w as validateIndexName, x as renderIdentifier } from "./schema-manager-psLzQ2yh.js";
1
+ import { D as validateIndexName, E as validateColumnNames, O as validatePlainColumnName, T as validateColumnName, a as buildAdapterWhere, b as quoteLiteralIdentifier, d as rewriteSqlParameters, g as generateCreateIndexStatement, h as generateAddColumnStatement, k as validateTableName, n as ReopenNotSupportedError, p as wrapDatabaseError, s as formatDbError, u as resolveInsertColumns, w as renderIdentifier, x as quotePostgresColumnName } from "./types-DihIt7ez.js";
2
2
  import { DatabaseError } from "@happyvertical/utils";
3
3
  //#region src/shared/connection-cache.ts
4
4
  var CACHED_VALIDATION_CAPABILITY = Symbol.for("@happyvertical/sql/connection-cache-cached-validation/v1");
@@ -306,6 +306,17 @@ function validateDatabaseCacheOptions(options) {
306
306
  if (options.dbid === "") throw new Error("Database cache dbid must be a non-empty string");
307
307
  }
308
308
  //#endregion
309
+ //#region src/shared/reopen.ts
310
+ /**
311
+ * A `reopenOptions` for engines that allow one owner per database: it refuses
312
+ * with {@link ReopenNotSupportedError}.
313
+ */
314
+ function refuseReopen(engine, reason) {
315
+ return () => {
316
+ throw new ReopenNotSupportedError(engine, reason);
317
+ };
318
+ }
319
+ //#endregion
309
320
  //#region src/shared/transaction-lock.ts
310
321
  /**
311
322
  * How long a queued transaction waits for the connection before giving up.
@@ -1651,6 +1662,6 @@ function createAlterTable(client) {
1651
1662
  };
1652
1663
  }
1653
1664
  //#endregion
1654
- export { createVectorCapabilities as a, createTransactionLock as c, validateDatabaseCacheOptions as d, createTransactionErrorTracker as i, ConnectionCache as l, createGetTableSchema as n, normalizePostgresRawQuery as o, createPostgresDialect as r, DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS as s, createAlterTable as t, enableCachedValidation as u };
1665
+ export { createVectorCapabilities as a, createTransactionLock as c, enableCachedValidation as d, validateDatabaseCacheOptions as f, createTransactionErrorTracker as i, refuseReopen as l, createGetTableSchema as n, normalizePostgresRawQuery as o, createPostgresDialect as r, DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS as s, createAlterTable as t, ConnectionCache as u };
1655
1666
 
1656
- //# sourceMappingURL=postgres-dialect-CaNhva-C.js.map
1667
+ //# sourceMappingURL=postgres-dialect-C8GwYO-9.js.map