@happyvertical/sql 0.116.1 → 0.116.3

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 (41) hide show
  1. package/README.md +28 -14
  2. package/dist/chunks/{duckdb-ddmnqn5l.js → duckdb-KwkNHwu2.js} +18 -14
  3. package/dist/chunks/duckdb-KwkNHwu2.js.map +1 -0
  4. package/dist/chunks/{postgres-dbGVT9aR.js → postgres-DPYxHPpn.js} +4 -4
  5. package/dist/chunks/{postgres-dbGVT9aR.js.map → postgres-DPYxHPpn.js.map} +1 -1
  6. package/dist/chunks/{postgres-dialect-uyqX-KB-.js → postgres-dialect-CL4kFDM0.js} +12 -9
  7. package/dist/chunks/postgres-dialect-CL4kFDM0.js.map +1 -0
  8. package/dist/chunks/{query-DFAYXNk-.js → query-BXjIqpxx.js} +2 -2
  9. package/dist/chunks/{query-DFAYXNk-.js.map → query-BXjIqpxx.js.map} +1 -1
  10. package/dist/chunks/{sqlite-DQXS8fAo.js → sqlite-B_nn3rHX.js} +16 -9
  11. package/dist/chunks/sqlite-B_nn3rHX.js.map +1 -0
  12. package/dist/chunks/{sqlite-engine-DpcUbF-P.js → sqlite-engine-Bai741Ho.js} +3 -3
  13. package/dist/chunks/{sqlite-engine-DpcUbF-P.js.map → sqlite-engine-Bai741Ho.js.map} +1 -1
  14. package/dist/chunks/{sqlite-native-BJcrl8b4.js → sqlite-native-BC8jcbGo.js} +22 -14
  15. package/dist/chunks/sqlite-native-BC8jcbGo.js.map +1 -0
  16. package/dist/chunks/{transaction-lock-BX2GJ4ei.js → transaction-lock-BaXakB9D.js} +2 -2
  17. package/dist/chunks/{transaction-lock-BX2GJ4ei.js.map → transaction-lock-BaXakB9D.js.map} +1 -1
  18. package/dist/chunks/{types-DihIt7ez.js → types-B5zTs-6A.js} +13 -2
  19. package/dist/chunks/types-B5zTs-6A.js.map +1 -0
  20. package/dist/doctor.d.ts +4 -2
  21. package/dist/doctor.d.ts.map +1 -1
  22. package/dist/duckdb.d.ts.map +1 -1
  23. package/dist/index.js +9 -9
  24. package/dist/index.js.map +1 -1
  25. package/dist/json.d.ts.map +1 -1
  26. package/dist/pglite.js +3 -3
  27. package/dist/query.js +2 -2
  28. package/dist/shared/alter-utils.d.ts +9 -0
  29. package/dist/shared/alter-utils.d.ts.map +1 -1
  30. package/dist/shared/postgres-dialect.d.ts +3 -3
  31. package/dist/shared/postgres-dialect.d.ts.map +1 -1
  32. package/dist/shared/types.d.ts +39 -6
  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-ddmnqn5l.js.map +0 -1
  38. package/dist/chunks/postgres-dialect-uyqX-KB-.js.map +0 -1
  39. package/dist/chunks/sqlite-DQXS8fAo.js.map +0 -1
  40. package/dist/chunks/sqlite-native-BJcrl8b4.js.map +0 -1
  41. package/dist/chunks/types-DihIt7ez.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"sqlite-engine-DpcUbF-P.js","names":[],"sources":["../../src/shared/sqlite-connection-cache.ts","../../src/shared/sqlite-engine.ts"],"sourcesContent":["import { ConnectionCache } from './connection-cache';\nimport type { DatabaseInterface, DatabaseOptions } from './types';\n\nexport type SqliteAdapterPath = 'libsql' | 'native' | 'secure';\n\nconst sqliteConnectionCache = new ConnectionCache<DatabaseInterface>();\ntype SqliteCacheGroup = {\n barrier?: Promise<void>;\n failure?: unknown;\n hasFailure: boolean;\n};\nconst sqliteCacheGroups = new Map<string, SqliteCacheGroup>();\n\nconst cacheKey = (dbid: string, path: SqliteAdapterPath) =>\n `sqlite:${path}:${dbid}`;\n\nasync function closeSqliteDatabase(db: DatabaseInterface): Promise<void> {\n await db.close?.();\n}\n\nasync function clearSqliteCacheGroup(dbid: string): Promise<void> {\n const group = sqliteCacheGroups.get(dbid) ?? { hasFailure: false };\n sqliteCacheGroups.set(dbid, group);\n const previous = group.barrier;\n const barrier = (previous?.catch(() => {}) ?? Promise.resolve()).then(\n async () => {\n const results = await Promise.allSettled([\n sqliteConnectionCache.evict(\n cacheKey(dbid, 'libsql'),\n closeSqliteDatabase,\n ),\n sqliteConnectionCache.evict(\n cacheKey(dbid, 'native'),\n closeSqliteDatabase,\n ),\n sqliteConnectionCache.evict(\n cacheKey(dbid, 'secure'),\n closeSqliteDatabase,\n ),\n ]);\n const failures = results.filter(\n (result): result is PromiseRejectedResult =>\n result.status === 'rejected',\n );\n if (failures.length) {\n group.failure =\n failures.length === 1\n ? failures[0].reason\n : new AggregateError(\n failures.map((failure) => failure.reason),\n 'Multiple SQLite adapter paths failed to clear',\n );\n group.hasFailure = true;\n throw group.failure;\n }\n group.failure = undefined;\n group.hasFailure = false;\n },\n );\n group.barrier = barrier;\n try {\n await barrier;\n } finally {\n if (group.barrier === barrier) {\n group.barrier = undefined;\n if (!group.hasFailure) sqliteCacheGroups.delete(dbid);\n }\n }\n}\n\nasync function awaitSqliteCacheGroup(dbid: string): Promise<void> {\n const group = sqliteCacheGroups.get(dbid);\n if (!group) return;\n if (group.barrier) await group.barrier;\n if (group.hasFailure) throw group.failure;\n}\n\nexport async function getCachedSqliteDatabase(\n path: SqliteAdapterPath,\n options: DatabaseOptions,\n create: () => Promise<DatabaseInterface>,\n): Promise<DatabaseInterface> {\n const { dbid } = options;\n if (dbid && options.clearCache) {\n await clearSqliteCacheGroup(dbid);\n } else if (dbid) {\n await awaitSqliteCacheGroup(dbid);\n }\n\n return sqliteConnectionCache.getOrCreate(\n dbid ? cacheKey(dbid, path) : undefined,\n { ...options, clearCache: false },\n async () => {\n const db = await create();\n const originalClose = db.close?.bind(db);\n let closePromise: Promise<void> | undefined;\n db.close = async () => {\n if (!closePromise) {\n closePromise = originalClose?.() ?? Promise.resolve();\n }\n try {\n await closePromise;\n sqliteConnectionCache.forget(db);\n } catch (error) {\n closePromise = undefined;\n throw error;\n }\n };\n // Secure SQLite exposes a guarded public client.close() seam. Route it\n // through the same cache-aware close boundary so a direct client close\n // cannot leave a closed adapter cached under an explicit dbid.\n if ((db.client as any)?.transactionReservation === 'exclusive') {\n (db.client as any).close = db.close;\n }\n return db;\n },\n closeSqliteDatabase,\n async (db) =>\n path !== 'libsql' || (db.client as { closed?: boolean })?.closed !== true,\n );\n}\n","import { realpathSync } from 'node:fs';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { SqliteOptions } from '../sqlite';\nimport { type DatabaseEngine, ReopenNotSupportedError } from './types';\n\n/** The SQLite engines, which share files but not file locks. */\ntype SqliteEngine = Extract<DatabaseEngine, 'node-sqlite' | 'libsql'>;\n\n/**\n * The normalized URL when `url` names a remote LibSQL database (`libsql:`,\n * `http:` or `https:`), otherwise `undefined`. The adapter uses this one test\n * everywhere, so a URL with stray whitespace is remote in every code path.\n */\nexport function remoteSqliteUrl(url: string): string | undefined {\n const normalized = url.replace(/[\\t\\n\\r]/g, '').trim();\n return /^(?:https?|libsql):/i.test(normalized) ? normalized : undefined;\n}\n\n/**\n * The local file a SQLite URL opens, or `undefined` for in-memory and remote\n * databases. Accepts a plain path, `file:path`, and `file://path`.\n */\nexport function localSqliteFilePath(url: string): string | undefined {\n if (url === ':memory:' || url.startsWith('file::memory:')) return undefined;\n if (remoteSqliteUrl(url)) return undefined;\n try {\n if (url.startsWith('file://')) return fileURLToPath(new URL(url));\n if (url.startsWith('file:')) {\n const path = url.slice('file:'.length).split('?')[0];\n return path ? resolve(path) : undefined;\n }\n } catch {\n return undefined;\n }\n return resolve(url);\n}\n\n/** Resolved real path; falls back to the real parent when the file is new. */\nfunction realFilePath(path: string): string {\n try {\n return realpathSync(path);\n } catch {\n try {\n return join(realpathSync(dirname(path)), basename(path));\n } catch {\n return path;\n }\n }\n}\n\n/**\n * Bookkeeping of the SQLite files this thread holds open, by resolved real\n * path. It exists to warn about the one unsafe arrangement: the same file held\n * through both engines.\n *\n * It sees only this thread. A connection opened in a worker thread (the\n * hazardous case in practice) is invisible to it, because module state is\n * per thread, so a worker has to rely on {@link DatabaseInterface.engine} and\n * `reopenOptions()` instead.\n */\nconst openFiles = new Map<string, Map<SqliteEngine, number>>();\nconst warned = new Set<string>();\n\n/**\n * Records that this thread opened `url` through `engine` and warns once per\n * file when the other engine already holds it. Returns an idempotent release\n * to call when the connection closes. In-memory and remote URLs are ignored.\n */\nexport function trackSqliteFile(url: string, engine: SqliteEngine): () => void {\n const local = localSqliteFilePath(url);\n if (!local) return () => {};\n const path = realFilePath(local);\n const engines = openFiles.get(path) ?? new Map<SqliteEngine, number>();\n openFiles.set(path, engines);\n engines.set(engine, (engines.get(engine) ?? 0) + 1);\n\n const other: SqliteEngine = engine === 'libsql' ? 'node-sqlite' : 'libsql';\n if (engines.has(other) && !warned.has(path)) {\n warned.add(path);\n process.emitWarning(\n `SQLite file ${path} is open through both node:sqlite and @libsql/client in this process. ` +\n 'They are separate copies of SQLite whose file locks do not coordinate, so concurrent ' +\n 'writes can corrupt the file. Open every connection to one file through the same engine ' +\n '(compare db.engine, and use db.reopenOptions() for a second connection).',\n { type: 'SqliteEngineMixWarning', code: 'HV_SQL_SQLITE_ENGINE_MIX' },\n );\n }\n\n let released = false;\n return () => {\n if (released) return;\n released = true;\n const count = (engines.get(engine) ?? 1) - 1;\n if (count > 0) engines.set(engine, count);\n else engines.delete(engine);\n if (engines.size === 0) {\n openFiles.delete(path);\n warned.delete(path);\n }\n };\n}\n\n/** @internal test hook */\nexport function resetSqliteFileTracking(): void {\n openFiles.clear();\n warned.clear();\n}\n\n/**\n * The location a reopen should use, fixed when the connection is acquired so a\n * later `process.chdir` or a worker with another working directory still\n * reaches the same file. Remote URLs are returned as they are.\n */\nfunction absoluteSqliteUrl(url: string): string {\n // A `file://` URL is already absolute, and decoding it would lose escapes.\n const remote = remoteSqliteUrl(url);\n if (remote) return remote;\n if (url.startsWith('file://')) return url;\n const local = localSqliteFilePath(url);\n if (!local) return url;\n const query = url.startsWith('file:') ? url.split('?').slice(1) : [];\n return query.length ? `file:${local}?${query.join('?')}` : local;\n}\n\n/**\n * Builds the `reopenOptions` function for a SQLite connection: options that\n * reopen the same database on the same engine, for another thread.\n */\nexport function createSqliteReopenOptions(\n engine: SqliteEngine,\n options: SqliteOptions,\n url: string,\n): () => SqliteOptions & { type: 'sqlite' } {\n const memory = url === ':memory:' || url.startsWith('file::memory:');\n const location = memory ? url : absoluteSqliteUrl(url);\n // Fixed at acquisition like the path. `windowsCustody` is a function and\n // cannot cross a thread boundary; it is left out, so a Windows worker must\n // supply its own verifier or `getDatabase` fails closed.\n const secureFile =\n options.secureFile && typeof options.secureFile === 'object'\n ? {\n driver: options.secureFile.driver,\n custody: options.secureFile.custody,\n ...(options.secureFile.root === undefined\n ? {}\n : { root: resolve(options.secureFile.root) }),\n }\n : undefined;\n return () => {\n if (memory) {\n throw new ReopenNotSupportedError(\n engine,\n 'an in-memory database exists only inside its own connection',\n );\n }\n const defined = <T extends object>(value: T): T =>\n Object.fromEntries(\n Object.entries(value).filter(([, entry]) => entry !== undefined),\n ) as T;\n const reopened: SqliteOptions & { type: 'sqlite' } = {\n type: 'sqlite',\n url: location,\n ...defined({\n transactionQueueTimeout: options.transactionQueueTimeout,\n }),\n };\n if (engine === 'node-sqlite') {\n // Copies, so a caller changing the result cannot change this connection.\n if (secureFile) reopened.secureFile = { ...secureFile };\n if (options.capabilities) {\n reopened.capabilities = structuredClone(options.capabilities);\n }\n return reopened;\n }\n return Object.assign(\n reopened,\n defined({\n authToken: options.authToken,\n encryptionKey: options.encryptionKey,\n }),\n );\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"sqlite-engine-Bai741Ho.js","names":[],"sources":["../../src/shared/sqlite-connection-cache.ts","../../src/shared/sqlite-engine.ts"],"sourcesContent":["import { ConnectionCache } from './connection-cache';\nimport type { DatabaseInterface, DatabaseOptions } from './types';\n\nexport type SqliteAdapterPath = 'libsql' | 'native' | 'secure';\n\nconst sqliteConnectionCache = new ConnectionCache<DatabaseInterface>();\ntype SqliteCacheGroup = {\n barrier?: Promise<void>;\n failure?: unknown;\n hasFailure: boolean;\n};\nconst sqliteCacheGroups = new Map<string, SqliteCacheGroup>();\n\nconst cacheKey = (dbid: string, path: SqliteAdapterPath) =>\n `sqlite:${path}:${dbid}`;\n\nasync function closeSqliteDatabase(db: DatabaseInterface): Promise<void> {\n await db.close?.();\n}\n\nasync function clearSqliteCacheGroup(dbid: string): Promise<void> {\n const group = sqliteCacheGroups.get(dbid) ?? { hasFailure: false };\n sqliteCacheGroups.set(dbid, group);\n const previous = group.barrier;\n const barrier = (previous?.catch(() => {}) ?? Promise.resolve()).then(\n async () => {\n const results = await Promise.allSettled([\n sqliteConnectionCache.evict(\n cacheKey(dbid, 'libsql'),\n closeSqliteDatabase,\n ),\n sqliteConnectionCache.evict(\n cacheKey(dbid, 'native'),\n closeSqliteDatabase,\n ),\n sqliteConnectionCache.evict(\n cacheKey(dbid, 'secure'),\n closeSqliteDatabase,\n ),\n ]);\n const failures = results.filter(\n (result): result is PromiseRejectedResult =>\n result.status === 'rejected',\n );\n if (failures.length) {\n group.failure =\n failures.length === 1\n ? failures[0].reason\n : new AggregateError(\n failures.map((failure) => failure.reason),\n 'Multiple SQLite adapter paths failed to clear',\n );\n group.hasFailure = true;\n throw group.failure;\n }\n group.failure = undefined;\n group.hasFailure = false;\n },\n );\n group.barrier = barrier;\n try {\n await barrier;\n } finally {\n if (group.barrier === barrier) {\n group.barrier = undefined;\n if (!group.hasFailure) sqliteCacheGroups.delete(dbid);\n }\n }\n}\n\nasync function awaitSqliteCacheGroup(dbid: string): Promise<void> {\n const group = sqliteCacheGroups.get(dbid);\n if (!group) return;\n if (group.barrier) await group.barrier;\n if (group.hasFailure) throw group.failure;\n}\n\nexport async function getCachedSqliteDatabase(\n path: SqliteAdapterPath,\n options: DatabaseOptions,\n create: () => Promise<DatabaseInterface>,\n): Promise<DatabaseInterface> {\n const { dbid } = options;\n if (dbid && options.clearCache) {\n await clearSqliteCacheGroup(dbid);\n } else if (dbid) {\n await awaitSqliteCacheGroup(dbid);\n }\n\n return sqliteConnectionCache.getOrCreate(\n dbid ? cacheKey(dbid, path) : undefined,\n { ...options, clearCache: false },\n async () => {\n const db = await create();\n const originalClose = db.close?.bind(db);\n let closePromise: Promise<void> | undefined;\n db.close = async () => {\n if (!closePromise) {\n closePromise = originalClose?.() ?? Promise.resolve();\n }\n try {\n await closePromise;\n sqliteConnectionCache.forget(db);\n } catch (error) {\n closePromise = undefined;\n throw error;\n }\n };\n // Secure SQLite exposes a guarded public client.close() seam. Route it\n // through the same cache-aware close boundary so a direct client close\n // cannot leave a closed adapter cached under an explicit dbid.\n if ((db.client as any)?.transactionReservation === 'exclusive') {\n (db.client as any).close = db.close;\n }\n return db;\n },\n closeSqliteDatabase,\n async (db) =>\n path !== 'libsql' || (db.client as { closed?: boolean })?.closed !== true,\n );\n}\n","import { realpathSync } from 'node:fs';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { SqliteOptions } from '../sqlite';\nimport { type DatabaseEngine, ReopenNotSupportedError } from './types';\n\n/** The SQLite engines, which share files but not file locks. */\ntype SqliteEngine = Extract<DatabaseEngine, 'node-sqlite' | 'libsql'>;\n\n/**\n * The normalized URL when `url` names a remote LibSQL database (`libsql:`,\n * `http:` or `https:`), otherwise `undefined`. The adapter uses this one test\n * everywhere, so a URL with stray whitespace is remote in every code path.\n */\nexport function remoteSqliteUrl(url: string): string | undefined {\n const normalized = url.replace(/[\\t\\n\\r]/g, '').trim();\n return /^(?:https?|libsql):/i.test(normalized) ? normalized : undefined;\n}\n\n/**\n * The local file a SQLite URL opens, or `undefined` for in-memory and remote\n * databases. Accepts a plain path, `file:path`, and `file://path`.\n */\nexport function localSqliteFilePath(url: string): string | undefined {\n if (url === ':memory:' || url.startsWith('file::memory:')) return undefined;\n if (remoteSqliteUrl(url)) return undefined;\n try {\n if (url.startsWith('file://')) return fileURLToPath(new URL(url));\n if (url.startsWith('file:')) {\n const path = url.slice('file:'.length).split('?')[0];\n return path ? resolve(path) : undefined;\n }\n } catch {\n return undefined;\n }\n return resolve(url);\n}\n\n/** Resolved real path; falls back to the real parent when the file is new. */\nfunction realFilePath(path: string): string {\n try {\n return realpathSync(path);\n } catch {\n try {\n return join(realpathSync(dirname(path)), basename(path));\n } catch {\n return path;\n }\n }\n}\n\n/**\n * Bookkeeping of the SQLite files this thread holds open, by resolved real\n * path. It exists to warn about the one unsafe arrangement: the same file held\n * through both engines.\n *\n * It sees only this thread. A connection opened in a worker thread (the\n * hazardous case in practice) is invisible to it, because module state is\n * per thread, so a worker has to rely on {@link DatabaseInterface.engine} and\n * `reopenOptions()` instead.\n */\nconst openFiles = new Map<string, Map<SqliteEngine, number>>();\nconst warned = new Set<string>();\n\n/**\n * Records that this thread opened `url` through `engine` and warns once per\n * file when the other engine already holds it. Returns an idempotent release\n * to call when the connection closes. In-memory and remote URLs are ignored.\n */\nexport function trackSqliteFile(url: string, engine: SqliteEngine): () => void {\n const local = localSqliteFilePath(url);\n if (!local) return () => {};\n const path = realFilePath(local);\n const engines = openFiles.get(path) ?? new Map<SqliteEngine, number>();\n openFiles.set(path, engines);\n engines.set(engine, (engines.get(engine) ?? 0) + 1);\n\n const other: SqliteEngine = engine === 'libsql' ? 'node-sqlite' : 'libsql';\n if (engines.has(other) && !warned.has(path)) {\n warned.add(path);\n process.emitWarning(\n `SQLite file ${path} is open through both node:sqlite and @libsql/client in this process. ` +\n 'They are separate copies of SQLite whose file locks do not coordinate, so concurrent ' +\n 'writes can corrupt the file. Open every connection to one file through the same engine ' +\n '(compare db.engine, and use db.reopenOptions() for a second connection).',\n { type: 'SqliteEngineMixWarning', code: 'HV_SQL_SQLITE_ENGINE_MIX' },\n );\n }\n\n let released = false;\n return () => {\n if (released) return;\n released = true;\n const count = (engines.get(engine) ?? 1) - 1;\n if (count > 0) engines.set(engine, count);\n else engines.delete(engine);\n if (engines.size === 0) {\n openFiles.delete(path);\n warned.delete(path);\n }\n };\n}\n\n/** @internal test hook */\nexport function resetSqliteFileTracking(): void {\n openFiles.clear();\n warned.clear();\n}\n\n/**\n * The location a reopen should use, fixed when the connection is acquired so a\n * later `process.chdir` or a worker with another working directory still\n * reaches the same file. Remote URLs are returned as they are.\n */\nfunction absoluteSqliteUrl(url: string): string {\n // A `file://` URL is already absolute, and decoding it would lose escapes.\n const remote = remoteSqliteUrl(url);\n if (remote) return remote;\n if (url.startsWith('file://')) return url;\n const local = localSqliteFilePath(url);\n if (!local) return url;\n const query = url.startsWith('file:') ? url.split('?').slice(1) : [];\n return query.length ? `file:${local}?${query.join('?')}` : local;\n}\n\n/**\n * Builds the `reopenOptions` function for a SQLite connection: options that\n * reopen the same database on the same engine, for another thread.\n */\nexport function createSqliteReopenOptions(\n engine: SqliteEngine,\n options: SqliteOptions,\n url: string,\n): () => SqliteOptions & { type: 'sqlite' } {\n const memory = url === ':memory:' || url.startsWith('file::memory:');\n const location = memory ? url : absoluteSqliteUrl(url);\n // Fixed at acquisition like the path. `windowsCustody` is a function and\n // cannot cross a thread boundary; it is left out, so a Windows worker must\n // supply its own verifier or `getDatabase` fails closed.\n const secureFile =\n options.secureFile && typeof options.secureFile === 'object'\n ? {\n driver: options.secureFile.driver,\n custody: options.secureFile.custody,\n ...(options.secureFile.root === undefined\n ? {}\n : { root: resolve(options.secureFile.root) }),\n }\n : undefined;\n return () => {\n if (memory) {\n throw new ReopenNotSupportedError(\n engine,\n 'an in-memory database exists only inside its own connection',\n );\n }\n const defined = <T extends object>(value: T): T =>\n Object.fromEntries(\n Object.entries(value).filter(([, entry]) => entry !== undefined),\n ) as T;\n const reopened: SqliteOptions & { type: 'sqlite' } = {\n type: 'sqlite',\n url: location,\n ...defined({\n transactionQueueTimeout: options.transactionQueueTimeout,\n }),\n };\n if (engine === 'node-sqlite') {\n // Copies, so a caller changing the result cannot change this connection.\n if (secureFile) reopened.secureFile = { ...secureFile };\n if (options.capabilities) {\n reopened.capabilities = structuredClone(options.capabilities);\n }\n return reopened;\n }\n return Object.assign(\n reopened,\n defined({\n authToken: options.authToken,\n encryptionKey: options.encryptionKey,\n }),\n );\n };\n}\n"],"mappings":";;;;;;AAKA,IAAM,wBAAwB,IAAI,gBAAmC;AAMrE,IAAM,oCAAoB,IAAI,IAA8B;AAE5D,IAAM,YAAY,MAAc,SAC9B,UAAU,KAAK,GAAG;AAEpB,eAAe,oBAAoB,IAAsC;CACvE,MAAM,GAAG,QAAQ;AACnB;AAEA,eAAe,sBAAsB,MAA6B;CAChE,MAAM,QAAQ,kBAAkB,IAAI,IAAI,KAAK,EAAE,YAAY,MAAM;CACjE,kBAAkB,IAAI,MAAM,KAAK;CAEjC,MAAM,WADW,MAAM,SACI,YAAY,CAAC,CAAC,KAAK,QAAQ,QAAQ,EAAA,CAAG,KAC/D,YAAY;EAeV,MAAM,YAAW,MAdK,QAAQ,WAAW;GACvC,sBAAsB,MACpB,SAAS,MAAM,QAAQ,GACvB,mBACF;GACA,sBAAsB,MACpB,SAAS,MAAM,QAAQ,GACvB,mBACF;GACA,sBAAsB,MACpB,SAAS,MAAM,QAAQ,GACvB,mBACF;EACF,CAAC,EAAA,CACwB,QACtB,WACC,OAAO,WAAW,UACtB;EACA,IAAI,SAAS,QAAQ;GACnB,MAAM,UACJ,SAAS,WAAW,IAChB,SAAS,EAAE,CAAC,SACZ,IAAI,eACF,SAAS,KAAK,YAAY,QAAQ,MAAM,GACxC,+CACF;GACN,MAAM,aAAa;GACnB,MAAM,MAAM;EACd;EACA,MAAM,UAAU,KAAA;EAChB,MAAM,aAAa;CACrB,CACF;CACA,MAAM,UAAU;CAChB,IAAI;EACF,MAAM;CACR,UAAU;EACR,IAAI,MAAM,YAAY,SAAS;GAC7B,MAAM,UAAU,KAAA;GAChB,IAAI,CAAC,MAAM,YAAY,kBAAkB,OAAO,IAAI;EACtD;CACF;AACF;AAEA,eAAe,sBAAsB,MAA6B;CAChE,MAAM,QAAQ,kBAAkB,IAAI,IAAI;CACxC,IAAI,CAAC,OAAO;CACZ,IAAI,MAAM,SAAS,MAAM,MAAM;CAC/B,IAAI,MAAM,YAAY,MAAM,MAAM;AACpC;AAEA,eAAsB,wBACpB,MACA,SACA,QAC4B;CAC5B,MAAM,EAAE,SAAS;CACjB,IAAI,QAAQ,QAAQ,YAClB,MAAM,sBAAsB,IAAI;MAC3B,IAAI,MACT,MAAM,sBAAsB,IAAI;CAGlC,OAAO,sBAAsB,YAC3B,OAAO,SAAS,MAAM,IAAI,IAAI,KAAA,GAC9B;EAAE,GAAG;EAAS,YAAY;CAAM,GAChC,YAAY;EACV,MAAM,KAAK,MAAM,OAAO;EACxB,MAAM,gBAAgB,GAAG,OAAO,KAAK,EAAE;EACvC,IAAI;EACJ,GAAG,QAAQ,YAAY;GACrB,IAAI,CAAC,cACH,eAAe,gBAAgB,KAAK,QAAQ,QAAQ;GAEtD,IAAI;IACF,MAAM;IACN,sBAAsB,OAAO,EAAE;GACjC,SAAS,OAAO;IACd,eAAe,KAAA;IACf,MAAM;GACR;EACF;EAIA,IAAK,GAAG,QAAgB,2BAA2B,aACjD,GAAI,OAAe,QAAQ,GAAG;EAEhC,OAAO;CACT,GACA,qBACA,OAAO,OACL,SAAS,YAAa,GAAG,QAAiC,WAAW,IACzE;AACF;;;;;;;;AC1GA,SAAgB,gBAAgB,KAAiC;CAC/D,MAAM,aAAa,IAAI,QAAQ,aAAa,EAAE,CAAC,CAAC,KAAK;CACrD,OAAO,uBAAuB,KAAK,UAAU,IAAI,aAAa,KAAA;AAChE;;;;;AAMA,SAAgB,oBAAoB,KAAiC;CACnE,IAAI,QAAQ,cAAc,IAAI,WAAW,eAAe,GAAG,OAAO,KAAA;CAClE,IAAI,gBAAgB,GAAG,GAAG,OAAO,KAAA;CACjC,IAAI;EACF,IAAI,IAAI,WAAW,SAAS,GAAG,OAAO,cAAc,IAAI,IAAI,GAAG,CAAC;EAChE,IAAI,IAAI,WAAW,OAAO,GAAG;GAC3B,MAAM,OAAO,IAAI,MAAM,CAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;GAClD,OAAO,OAAO,QAAQ,IAAI,IAAI,KAAA;EAChC;CACF,QAAQ;EACN;CACF;CACA,OAAO,QAAQ,GAAG;AACpB;;AAGA,SAAS,aAAa,MAAsB;CAC1C,IAAI;EACF,OAAO,aAAa,IAAI;CAC1B,QAAQ;EACN,IAAI;GACF,OAAO,KAAK,aAAa,QAAQ,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC;EACzD,QAAQ;GACN,OAAO;EACT;CACF;AACF;;;;;;;;;;;AAYA,IAAM,4BAAY,IAAI,IAAuC;AAC7D,IAAM,yBAAS,IAAI,IAAY;;;;;;AAO/B,SAAgB,gBAAgB,KAAa,QAAkC;CAC7E,MAAM,QAAQ,oBAAoB,GAAG;CACrC,IAAI,CAAC,OAAO,aAAa,CAAC;CAC1B,MAAM,OAAO,aAAa,KAAK;CAC/B,MAAM,UAAU,UAAU,IAAI,IAAI,qBAAK,IAAI,IAA0B;CACrE,UAAU,IAAI,MAAM,OAAO;CAC3B,QAAQ,IAAI,SAAS,QAAQ,IAAI,MAAM,KAAK,KAAK,CAAC;CAElD,MAAM,QAAsB,WAAW,WAAW,gBAAgB;CAClE,IAAI,QAAQ,IAAI,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,GAAG;EAC3C,OAAO,IAAI,IAAI;EACf,QAAQ,YACN,eAAe,KAAK,6TAIpB;GAAE,MAAM;GAA0B,MAAM;EAA2B,CACrE;CACF;CAEA,IAAI,WAAW;CACf,aAAa;EACX,IAAI,UAAU;EACd,WAAW;EACX,MAAM,SAAS,QAAQ,IAAI,MAAM,KAAK,KAAK;EAC3C,IAAI,QAAQ,GAAG,QAAQ,IAAI,QAAQ,KAAK;OACnC,QAAQ,OAAO,MAAM;EAC1B,IAAI,QAAQ,SAAS,GAAG;GACtB,UAAU,OAAO,IAAI;GACrB,OAAO,OAAO,IAAI;EACpB;CACF;AACF;;;;;;AAaA,SAAS,kBAAkB,KAAqB;CAE9C,MAAM,SAAS,gBAAgB,GAAG;CAClC,IAAI,QAAQ,OAAO;CACnB,IAAI,IAAI,WAAW,SAAS,GAAG,OAAO;CACtC,MAAM,QAAQ,oBAAoB,GAAG;CACrC,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,QAAQ,IAAI,WAAW,OAAO,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;CACnE,OAAO,MAAM,SAAS,QAAQ,MAAM,GAAG,MAAM,KAAK,GAAG,MAAM;AAC7D;;;;;AAMA,SAAgB,0BACd,QACA,SACA,KAC0C;CAC1C,MAAM,SAAS,QAAQ,cAAc,IAAI,WAAW,eAAe;CACnE,MAAM,WAAW,SAAS,MAAM,kBAAkB,GAAG;CAIrD,MAAM,aACJ,QAAQ,cAAc,OAAO,QAAQ,eAAe,WAChD;EACE,QAAQ,QAAQ,WAAW;EAC3B,SAAS,QAAQ,WAAW;EAC5B,GAAI,QAAQ,WAAW,SAAS,KAAA,IAC5B,CAAC,IACD,EAAE,MAAM,QAAQ,QAAQ,WAAW,IAAI,EAAE;CAC/C,IACA,KAAA;CACN,aAAa;EACX,IAAI,QACF,MAAM,IAAI,wBACR,QACA,6DACF;EAEF,MAAM,WAA6B,UACjC,OAAO,YACL,OAAO,QAAQ,KAAK,CAAC,CAAC,QAAQ,GAAG,WAAW,UAAU,KAAA,CAAS,CACjE;EACF,MAAM,WAA+C;GACnD,MAAM;GACN,KAAK;GACL,GAAG,QAAQ,EACT,yBAAyB,QAAQ,wBACnC,CAAC;EACH;EACA,IAAI,WAAW,eAAe;GAE5B,IAAI,YAAY,SAAS,aAAa,EAAE,GAAG,WAAW;GACtD,IAAI,QAAQ,cACV,SAAS,eAAe,gBAAgB,QAAQ,YAAY;GAE9D,OAAO;EACT;EACA,OAAO,OAAO,OACZ,UACA,QAAQ;GACN,WAAW,QAAQ;GACnB,eAAe,QAAQ;EACzB,CAAC,CACH;CACF;AACF"}
@@ -1,6 +1,6 @@
1
- import { C as quoteSqliteLiteralIdentifier, D as validateIndexName, E as validateColumnNames, O as validatePlainColumnName, S as quoteSqliteColumnName, T as validateColumnName, a as buildAdapterWhere, d as rewriteSqlParameters, g as generateCreateIndexStatement, h as generateAddColumnStatement, i as DatabaseSchemaManager, k as validateTableName, p as wrapDatabaseError, r as resolveSchemas, s as formatDbError, t as NestedTransactionError, u as resolveInsertColumns } from "./types-DihIt7ez.js";
2
- import { n as createTransactionLock } from "./transaction-lock-BX2GJ4ei.js";
3
- import { i as getCachedSqliteDatabase, r as trackSqliteFile, t as createSqliteReopenOptions } from "./sqlite-engine-DpcUbF-P.js";
1
+ import { A as validateTableName, C as quoteSqliteColumnName, D as validateColumnNames, E as validateColumnName, O as validateIndexName, _ as generateCreateIndexStatement, a as buildAdapterWhere, d as rewriteSqlParameters, g as generateAddColumnStatement, i as DatabaseSchemaManager, k as validatePlainColumnName, m as assertIntrospectionTableName, p as wrapDatabaseError, r as resolveSchemas, s as formatDbError, t as NestedTransactionError, u as resolveInsertColumns, w as quoteSqliteLiteralIdentifier } from "./types-B5zTs-6A.js";
2
+ import { n as createTransactionLock } from "./transaction-lock-BaXakB9D.js";
3
+ import { i as getCachedSqliteDatabase, r as trackSqliteFile, t as createSqliteReopenOptions } from "./sqlite-engine-Bai741Ho.js";
4
4
  import { DatabaseError } from "@happyvertical/utils";
5
5
  import { resolve } from "node:path";
6
6
  import { fileURLToPath } from "node:url";
@@ -895,19 +895,27 @@ async function createNativeSqliteDatabase(options, url) {
895
895
  const initializeSchemas = async (schemaOptions) => {
896
896
  await new DatabaseSchemaManager().initializeSchemas(buildDatabaseInterface(upsert), schemaOptions);
897
897
  };
898
- const getTableSchema = async (tableName) => {
899
- validateTableName(tableName);
898
+ const getTableSchema = async (tableName, schemaOptions) => {
899
+ assertIntrospectionTableName(tableName);
900
+ const optedIn = !!schemaOptions?.includeGenerated || !!schemaOptions?.includeHidden;
900
901
  if (!await tableExists(tableName)) return null;
901
902
  const columnRows = database.prepare(`PRAGMA table_xinfo(${quoteSqliteLiteralIdentifier(tableName)})`).all().map(toPlainRow);
902
903
  const columns = {};
903
- for (const row of columnRows) columns[row.name] = {
904
- type: row.type,
905
- primaryKey: row.pk === 1,
906
- notNull: row.notnull === 1,
907
- defaultValue: row.dflt_value,
908
- generated: row.hidden === 2 || row.hidden === 3,
909
- hidden: row.hidden === 1
910
- };
904
+ for (const row of columnRows) {
905
+ const kind = Number(row.hidden ?? 0);
906
+ if (kind === 1 && !schemaOptions?.includeHidden) continue;
907
+ if ((kind === 2 || kind === 3) && !schemaOptions?.includeGenerated) continue;
908
+ columns[row.name] = {
909
+ type: row.type,
910
+ primaryKey: row.pk === 1,
911
+ notNull: row.notnull === 1,
912
+ defaultValue: row.dflt_value,
913
+ ...optedIn ? {
914
+ generated: kind === 2 || kind === 3,
915
+ hidden: kind === 1
916
+ } : {}
917
+ };
918
+ }
911
919
  const indexRows = executeNativeQuery(database, `SELECT name FROM sqlite_master
912
920
  WHERE type = 'index'
913
921
  AND tbl_name = ?
@@ -1030,4 +1038,4 @@ async function createNativeSqliteDatabase(options, url) {
1030
1038
  //#endregion
1031
1039
  export { getNativeSqliteDatabase };
1032
1040
 
1033
- //# sourceMappingURL=sqlite-native-BJcrl8b4.js.map
1041
+ //# sourceMappingURL=sqlite-native-BC8jcbGo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqlite-native-BC8jcbGo.js","names":[],"sources":["../../src/sqlite-native.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { DatabaseError } from '@happyvertical/utils';\nimport { DatabaseSchemaManager } from './schema-manager.js';\nimport {\n assertIntrospectionTableName,\n generateAddColumnStatement,\n generateCreateIndexStatement,\n quoteSqliteLiteralIdentifier as quoteIdentifier,\n quoteSqliteColumnName,\n validateColumnName,\n validateColumnNames,\n validateIndexName,\n validatePlainColumnName,\n validateTableName,\n} from './shared/alter-utils.js';\nimport { getCachedSqliteDatabase } from './shared/sqlite-connection-cache.js';\nimport {\n createSqliteReopenOptions,\n trackSqliteFile,\n} from './shared/sqlite-engine.js';\nimport { createTransactionLock } from './shared/transaction-lock.js';\nimport type {\n ColumnDefinitionWithName,\n DatabaseInterface,\n GetTableSchemaOptions,\n IndexDefinition,\n NotificationCapabilities,\n NotificationListenOptions,\n NotificationPruneOptions,\n NotificationWaitOptions,\n QueryResult,\n SchemaInitializationOptions,\n SchemaProvider,\n SqliteNotificationCapabilityOptions,\n SqliteVectorCapabilityOptions,\n TableColumnInfo,\n TableInterface,\n TableSchemaInfo,\n TransactionHandle,\n UpsertOptions,\n VectorCapabilities,\n VectorIndexOptions,\n VectorSearchOptions,\n VectorSearchResult,\n WhereClause,\n} from './shared/types.js';\nimport { NestedTransactionError, resolveSchemas } from './shared/types.js';\nimport {\n buildAdapterWhere as buildWhere,\n formatDbError,\n resolveInsertColumns,\n rewriteSqlParameters,\n wrapDatabaseError,\n} from './shared/utils.js';\nimport type { SqliteOptions } from './sqlite.js';\n\ntype NativeDatabase = any;\ntype NativeStatement = any;\ntype NativeCloseable = { close?: () => void };\n\n/** @internal Best-effort, retryable closer used by native SQLite. */\nexport function createNativeSqliteCloser(\n notificationCloseables: Set<NativeCloseable>,\n honkerDb: NativeCloseable | null,\n database: { close(): void },\n): () => Promise<void> {\n const completed = new Set<object>();\n let active: Promise<void> | undefined;\n return async () => {\n active ??= (async () => {\n const resources: NativeCloseable[] = [\n ...notificationCloseables,\n ...(honkerDb ? [honkerDb] : []),\n database,\n ];\n const errors: unknown[] = [];\n for (const resource of resources) {\n if (completed.has(resource)) continue;\n try {\n resource.close?.();\n completed.add(resource);\n notificationCloseables.delete(resource);\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(\n errors,\n 'Failed to close native SQLite resources',\n );\n }\n })();\n try {\n await active;\n } finally {\n active = undefined;\n }\n };\n}\n\nconst nativeNullAwareUpsertLocks = new Map<string, Promise<void>>();\nlet nodeSqliteModulePromise: Promise<any> | null = null;\n// sqlite-vector's ESM wrapper uses dynamic require for platform packages.\nconst requireOptionalPackage = createRequire(import.meta.url);\n\ninterface NativeSqliteLocation {\n location: string;\n filePath: string | null;\n isMemory: boolean;\n}\n\ninterface NativeQueryResult {\n rows: Record<string, any>[];\n rowCount: number;\n command?: string;\n fields?: Array<{ name: string }>;\n}\n\nfunction getCapabilityOptions<T extends Record<string, any>>(\n value: boolean | T | undefined,\n): T {\n return typeof value === 'object' && value ? value : ({} as T);\n}\n\nfunction resolveNativeLocation(url = ':memory:'): NativeSqliteLocation {\n if (\n url.startsWith('libsql://') ||\n url.startsWith('http://') ||\n url.startsWith('https://')\n ) {\n throw new DatabaseError(\n 'SQLite native capabilities are only supported for local SQLite databases',\n {\n url,\n hint: \"Use a local file path, 'file:...' URL, or ':memory:' when enabling SQLite capabilities.\",\n },\n );\n }\n\n if (url === ':memory:' || url.startsWith('file::memory:')) {\n return { location: url, filePath: null, isMemory: true };\n }\n\n if (url.startsWith('file://')) {\n const filePath = fileURLToPath(new URL(url));\n return { location: filePath, filePath, isMemory: false };\n }\n\n if (url.startsWith('file:')) {\n const path = url.slice('file:'.length);\n if (!path || path.includes('?')) {\n throw new DatabaseError(\n 'SQLite native capabilities do not support file: URLs with query parameters',\n { url },\n );\n }\n const filePath = resolve(path);\n return { location: filePath, filePath, isMemory: false };\n }\n\n const filePath = resolve(url);\n return { location: filePath, filePath, isMemory: false };\n}\n\nasync function loadNodeSqlite(): Promise<any> {\n nodeSqliteModulePromise ??= importNodeSqlite().catch((error) => {\n nodeSqliteModulePromise = null;\n throw error;\n });\n return nodeSqliteModulePromise;\n}\n\nasync function importNodeSqlite(): Promise<any> {\n const originalEmitWarning = process.emitWarning;\n\n try {\n process.emitWarning = function suppressNodeSqliteExperimentalWarning(\n warning: string | Error,\n ...args: any[]\n ) {\n if (\n args[0] === 'ExperimentalWarning' &&\n String(warning).includes('SQLite is an experimental feature')\n ) {\n return;\n }\n\n return originalEmitWarning.call(process, warning as any, ...args);\n } as typeof process.emitWarning;\n\n const moduleName = 'node:sqlite';\n return (await import(/* @vite-ignore */ moduleName)) as any;\n } catch (error) {\n throw new DatabaseError('Node native SQLite is not available', {\n originalError: formatDbError(error),\n hint: 'SQLite native capabilities require a Node.js runtime with node:sqlite support.',\n });\n } finally {\n process.emitWarning = originalEmitWarning;\n }\n}\n\nasync function loadSqliteVectorExtension(\n database: NativeDatabase,\n): Promise<void> {\n try {\n const moduleName = '@sqliteai/sqlite-vector';\n const module = requireOptionalPackage(moduleName) as any;\n const getExtensionPath =\n module.getExtensionPath ?? module.default?.getExtensionPath;\n\n if (typeof getExtensionPath !== 'function') {\n throw new Error('getExtensionPath export was not found');\n }\n\n database.enableLoadExtension(true);\n database.loadExtension(getExtensionPath());\n } catch (error) {\n throw new DatabaseError(\n 'Failed to load optional SQLite vector capability: install @sqliteai/sqlite-vector',\n {\n packageName: '@sqliteai/sqlite-vector',\n originalError: formatDbError(error),\n hint: 'Install @sqliteai/sqlite-vector to use SQLite vector capabilities.',\n },\n );\n } finally {\n try {\n database.enableLoadExtension(false);\n } catch (_error) {\n // Leave the original extension-loading failure intact.\n }\n }\n}\n\nasync function openHonkerDatabase(\n filePath: string,\n options: SqliteNotificationCapabilityOptions,\n): Promise<any> {\n try {\n const moduleName = '@russellthehippo/honker-node';\n const module = requireOptionalPackage(moduleName) as any;\n const open = module.open ?? module.default?.open;\n\n if (typeof open !== 'function') {\n throw new Error('open export was not found');\n }\n\n return open(filePath, options.maxReaders, options.watcherBackend);\n } catch (error) {\n throw new DatabaseError(\n 'Failed to load optional SQLite notification capability: install @russellthehippo/honker-node',\n {\n packageName: '@russellthehippo/honker-node',\n originalError: formatDbError(error),\n hint: 'Install @russellthehippo/honker-node to use SQLite notification capabilities.',\n },\n );\n }\n}\n\nfunction toPlainRow(row: Record<string, any>): Record<string, any> {\n return Object.fromEntries(Object.entries(row));\n}\n\nfunction getErrorMessage(error: unknown): string | undefined {\n return error instanceof Error ? error.message : undefined;\n}\n\nfunction firstSqlToken(sql: string): string {\n return sql.trim().split(/\\s+/)[0]?.toUpperCase() ?? '';\n}\n\nfunction normalizeNativeQuery(\n sql: string,\n values: any[],\n): { sql: string; args: any[] } {\n const flatArgs = Array.isArray(values[0]) ? values[0] : values;\n const args: any[] = [];\n const normalized = replaceNativeParameters(sql, (index) => {\n args.push(flatArgs[index - 1]);\n return '?';\n });\n return args.length > 0 ? { sql: normalized, args } : { sql, args: flatArgs };\n}\n\n/** Ignore literal/identifier text when translating executable numbered binds. */\nfunction replaceNativeParameters(\n sql: string,\n replace: (index: number) => string,\n): string {\n return rewriteSqlParameters(sql, 'sqlite', (token, index) =>\n index === undefined ? token : replace(index),\n );\n}\n\nfunction executeNativeQuery(\n database: NativeDatabase,\n sql: string,\n args: any[] = [],\n): NativeQueryResult {\n const statement: NativeStatement = database.prepare(sql);\n const columns = statement.columns();\n\n if (columns.length > 0) {\n const rows = statement.all(...args).map(toPlainRow);\n return {\n rows,\n rowCount: rows.length,\n command: firstSqlToken(sql),\n fields: columns.map((column: { name: string }) => ({\n name: column.name,\n })),\n };\n }\n\n const result = statement.run(...args);\n return {\n rows: [],\n rowCount: Number(result?.changes ?? 0),\n command: firstSqlToken(sql),\n fields: [],\n };\n}\n\nfunction createNativeTablesFromSchemas(\n database: NativeDatabase,\n schemas: Record<string, SchemaProvider>,\n): void {\n for (const [tableName, schema] of Object.entries(schemas)) {\n try {\n const result = executeNativeQuery(\n database,\n \"SELECT name FROM sqlite_master WHERE type='table' AND name=?\",\n [tableName],\n );\n\n if (result.rows.length > 0) {\n continue;\n }\n\n database.exec(schema.ddl);\n\n for (const indexSql of schema.indexes ?? []) {\n try {\n database.exec(indexSql);\n } catch (error) {\n console.warn(\n `[sqlite] Failed to create index for ${tableName}: ${formatDbError(error)}`,\n );\n }\n }\n\n for (const triggerSql of schema.triggers ?? []) {\n try {\n database.exec(triggerSql);\n } catch (error) {\n console.warn(\n `[sqlite] Failed to create trigger for ${tableName}: ${formatDbError(error)}`,\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: formatDbError(error),\n },\n );\n }\n }\n}\n\nfunction buildQuestionWhere(where: WhereClause, startIndex = 1) {\n const built = buildWhere(where, startIndex, 'sqlite');\n return {\n sql: replaceNativeParameters(built.sql, () => '?'),\n values: built.values,\n };\n}\n\nfunction serializeValue(value: any): any {\n if (value === null || value === undefined) {\n return value;\n }\n if (value instanceof Date) {\n return value.toISOString();\n }\n if (typeof value === 'object') {\n return JSON.stringify(value);\n }\n return value;\n}\n\nfunction serializeRecord(record: Record<string, any>): Record<string, any> {\n const serialized: Record<string, any> = {};\n for (const [key, value] of Object.entries(record)) {\n if (value === undefined) {\n continue;\n }\n serialized[key] = serializeValue(value);\n }\n return serialized;\n}\n\nasync function withNativeNullAwareUpsertLock<T>(\n lockKey: string,\n callback: () => Promise<T>,\n): Promise<T> {\n const previous = nativeNullAwareUpsertLocks.get(lockKey) ?? Promise.resolve();\n let release: () => void = () => {};\n const current = new Promise<void>((resolve) => {\n release = resolve;\n });\n const next = previous.catch(() => {}).then(() => current);\n\n nativeNullAwareUpsertLocks.set(lockKey, next);\n await previous.catch(() => {});\n\n try {\n return await callback();\n } finally {\n release();\n if (nativeNullAwareUpsertLocks.get(lockKey) === next) {\n nativeNullAwareUpsertLocks.delete(lockKey);\n }\n }\n}\n\nfunction sqliteVectorDistance(metric: 'cosine' | 'l2' | 'ip'): string {\n switch (metric) {\n case 'l2':\n return 'L2';\n case 'ip':\n return 'DOT';\n default:\n return 'COSINE';\n }\n}\n\nfunction sqliteVectorQuantization(\n options: SqliteVectorCapabilityOptions,\n): string {\n const parts: string[] = [];\n\n switch (options.quantization ?? 'turbo4') {\n case 'turbo2':\n parts.push('qtype=TURBO,qbits=2');\n break;\n case 'turbo3':\n parts.push('qtype=TURBO,qbits=3');\n break;\n case 'turbo4':\n parts.push('qtype=TURBO,qbits=4');\n break;\n case 'uint8':\n parts.push('qtype=UINT8');\n break;\n case 'int8':\n parts.push('qtype=INT8');\n break;\n case '1bit':\n parts.push('qtype=1BIT');\n break;\n }\n\n if (options.maxMemory) {\n parts.push(`max_memory=${options.maxMemory}`);\n }\n\n return parts.join(',');\n}\n\nfunction createNotificationCapabilities(\n honkerDb: any,\n closeables: Set<{ close?: () => void }>,\n): NotificationCapabilities {\n return {\n async notify(channel: string, payload: any): Promise<number> {\n return Number(honkerDb.notify(channel, payload));\n },\n\n listen(channel: string, options?: NotificationListenOptions) {\n const listener = honkerDb.listen(channel, {\n fallbackPollS:\n options?.fallbackPollMs === null\n ? null\n : options?.fallbackPollMs !== undefined\n ? options.fallbackPollMs / 1000\n : undefined,\n });\n closeables.add(listener);\n return listener;\n },\n\n async waitForUpdate(options?: NotificationWaitOptions): Promise<boolean> {\n const updateEvents = honkerDb.updateEvents();\n closeables.add(updateEvents);\n let timeout: NodeJS.Timeout | undefined;\n let removeAbortListener: (() => void) | undefined;\n\n try {\n if (options?.signal?.aborted) {\n return false;\n }\n\n const updatePromise = updateEvents.next().then(\n () => true,\n () => false,\n );\n const races: Array<Promise<boolean>> = [updatePromise];\n\n if (options?.timeoutMs !== undefined) {\n const timeoutMs = options.timeoutMs;\n races.push(\n new Promise((resolve) => {\n timeout = setTimeout(\n () => resolve(false),\n Math.max(0, timeoutMs),\n );\n }),\n );\n }\n\n if (options?.signal) {\n races.push(\n new Promise((resolve) => {\n const onAbort = () => resolve(false);\n options.signal?.addEventListener('abort', onAbort, {\n once: true,\n });\n removeAbortListener = () =>\n options.signal?.removeEventListener('abort', onAbort);\n }),\n );\n }\n\n return await Promise.race(races);\n } finally {\n if (timeout) {\n clearTimeout(timeout);\n }\n removeAbortListener?.();\n closeables.delete(updateEvents);\n updateEvents.close?.();\n }\n },\n\n async prune(options?: NotificationPruneOptions): Promise<number> {\n return Number(\n honkerDb.pruneNotifications(options?.olderThanS, options?.maxKeep),\n );\n },\n };\n}\n\nfunction createVectorCapabilities(\n database: NativeDatabase,\n options: SqliteVectorCapabilityOptions,\n): VectorCapabilities {\n const initialized = new Map<\n string,\n { dimensions: number; metric: 'cosine' | 'l2' | 'ip' }\n >();\n const indexed = new Map<\n string,\n { metric: 'cosine' | 'l2' | 'ip'; options: SqliteVectorCapabilityOptions }\n >();\n\n const keyFor = (table: string, column: string) => `${table}.${column}`;\n\n const columnExists = (table: string, column: string): boolean => {\n const rows = database\n .prepare(`PRAGMA table_info(${quoteIdentifier(table)})`)\n .all()\n .map(toPlainRow);\n return rows.some((row: Record<string, any>) => row.name === column);\n };\n\n const ensureInitialized = (\n table: string,\n column: string,\n dimensions: number,\n metric: 'cosine' | 'l2' | 'ip' = 'cosine',\n ): void => {\n if (!Number.isInteger(dimensions) || dimensions <= 0) {\n throw new DatabaseError('Vector dimensions must be a positive integer', {\n dimensions,\n });\n }\n\n validateTableName(table);\n validateColumnName(column);\n\n executeNativeQuery(database, 'SELECT vector_init(?, ?, ?)', [\n table,\n column,\n `dimension=${dimensions},type=FLOAT32,distance=${sqliteVectorDistance(metric)}`,\n ]);\n initialized.set(keyFor(table, column), { dimensions, metric });\n };\n\n const quantize = (\n table: string,\n column: string,\n vectorOptions: SqliteVectorCapabilityOptions,\n ): void => {\n const quantizationOptions = sqliteVectorQuantization(vectorOptions);\n if (quantizationOptions) {\n executeNativeQuery(database, 'SELECT vector_quantize(?, ?, ?)', [\n table,\n column,\n quantizationOptions,\n ]);\n } else {\n executeNativeQuery(database, 'SELECT vector_quantize(?, ?)', [\n table,\n column,\n ]);\n }\n\n if (vectorOptions.preload) {\n executeNativeQuery(database, 'SELECT vector_quantize_preload(?, ?)', [\n table,\n column,\n ]);\n }\n };\n\n return {\n async ensureColumn(\n table: string,\n column: string,\n dimensions: number,\n ): Promise<void> {\n validateTableName(table);\n validateColumnName(column);\n\n try {\n if (!columnExists(table, column)) {\n executeNativeQuery(\n database,\n `ALTER TABLE ${quoteIdentifier(table)} ADD COLUMN ${quoteIdentifier(column)} BLOB`,\n );\n }\n ensureInitialized(table, column, dimensions, 'cosine');\n } catch (error) {\n throw new DatabaseError('Failed to ensure SQLite vector column', {\n table,\n column,\n dimensions,\n originalError: formatDbError(error),\n });\n }\n },\n\n async ensureIndex(\n table: string,\n column: string,\n indexOptions?: VectorIndexOptions,\n ): Promise<void> {\n validateTableName(table);\n validateColumnName(column);\n\n const key = keyFor(table, column);\n const dimensions =\n indexOptions?.dimensions ?? initialized.get(key)?.dimensions;\n if (!dimensions) {\n throw new DatabaseError(\n 'SQLite vector index creation requires dimensions',\n {\n table,\n column,\n hint: 'Call ensureColumn(table, column, dimensions) first or pass dimensions to ensureIndex().',\n },\n );\n }\n\n const metric = indexOptions?.metric ?? 'cosine';\n\n try {\n ensureInitialized(table, column, dimensions, metric);\n const vectorOptions = { ...options };\n quantize(table, column, vectorOptions);\n indexed.set(key, { metric, options: vectorOptions });\n } catch (error) {\n throw new DatabaseError('Failed to ensure SQLite vector index', {\n table,\n column,\n originalError: formatDbError(error),\n });\n }\n },\n\n async upsertVector(\n table: string,\n where: Record<string, any>,\n column: string,\n embedding: number[],\n ): Promise<void> {\n validateTableName(table);\n validateColumnName(column);\n\n const key = keyFor(table, column);\n const dimensions = initialized.get(key)?.dimensions ?? embedding.length;\n const { sql: whereClause, values } = buildQuestionWhere(where);\n\n if (!whereClause) {\n throw new DatabaseError(\n 'SQLite vector update requires at least one WHERE condition',\n { table, column },\n );\n }\n\n try {\n ensureInitialized(\n table,\n column,\n dimensions,\n initialized.get(key)?.metric ?? 'cosine',\n );\n executeNativeQuery(\n database,\n `UPDATE ${quoteIdentifier(table)} SET ${quoteIdentifier(column)} = vector_as_f32(?) ${whereClause}`,\n [JSON.stringify(embedding), ...values],\n );\n\n const indexState = indexed.get(key);\n if (indexState) {\n quantize(table, column, indexState.options);\n }\n } catch (error) {\n throw new DatabaseError('Failed to upsert SQLite vector', {\n table,\n column,\n where,\n originalError: formatDbError(error),\n });\n }\n },\n\n async search(\n table: string,\n column: string,\n embedding: number[],\n searchOptions?: VectorSearchOptions,\n ): Promise<VectorSearchResult[]> {\n validateTableName(table);\n validateColumnName(column);\n\n const key = keyFor(table, column);\n const metric = searchOptions?.metric ?? 'cosine';\n const limit = searchOptions?.limit ?? 10;\n const limitArg = BigInt(limit);\n const dimensions = initialized.get(key)?.dimensions ?? embedding.length;\n const indexState = indexed.get(key);\n const useQuantizedScan = indexState?.metric === metric;\n const scanFunction = useQuantizedScan\n ? 'vector_quantize_scan'\n : 'vector_full_scan';\n const convertedWhere = searchOptions?.where\n ? replaceNativeParameters(searchOptions.where, () => '?')\n : '';\n const whereParams = searchOptions?.params ?? [];\n\n try {\n ensureInitialized(table, column, dimensions, metric);\n\n const rows = convertedWhere\n ? executeNativeQuery(\n database,\n `SELECT base.*, base.rowid AS __sqlite_rowid, vec.distance\n FROM ${scanFunction}(?, ?, vector_as_f32(?)) AS vec\n JOIN ${quoteIdentifier(table)} AS base ON base.rowid = vec.rowid\n WHERE (${convertedWhere})\n ORDER BY vec.distance\n LIMIT ?`,\n [\n table,\n column,\n JSON.stringify(embedding),\n ...whereParams,\n limitArg,\n ],\n ).rows\n : executeNativeQuery(\n database,\n `SELECT base.*, base.rowid AS __sqlite_rowid, vec.distance\n FROM ${scanFunction}(?, ?, vector_as_f32(?), ?) AS vec\n JOIN ${quoteIdentifier(table)} AS base ON base.rowid = vec.rowid\n ORDER BY vec.distance`,\n [table, column, JSON.stringify(embedding), limitArg],\n ).rows;\n\n return rows.map((row) => {\n const { __sqlite_rowid: rowid, ...result } = row;\n return {\n ...result,\n id: String(result.id ?? rowid),\n distance: Number(row.distance),\n };\n });\n } catch (error) {\n throw new DatabaseError('Failed to execute SQLite vector search', {\n table,\n column,\n metric,\n limit,\n originalError: formatDbError(error),\n });\n }\n },\n };\n}\n\nexport async function getNativeSqliteDatabase(\n options: SqliteOptions = {},\n): Promise<DatabaseInterface> {\n const url = options.url || ':memory:';\n\n return getCachedSqliteDatabase('native', options, () =>\n createNativeSqliteDatabase(options, url),\n );\n}\n\nasync function createNativeSqliteDatabase(\n options: SqliteOptions,\n url: string,\n): Promise<DatabaseInterface> {\n const location = resolveNativeLocation(url);\n const notificationsOptions = getCapabilityOptions(\n options.capabilities?.notifications,\n );\n const vectorOptions = getCapabilityOptions(options.capabilities?.vector);\n const wantsNotifications = Boolean(options.capabilities?.notifications);\n const wantsVector = Boolean(options.capabilities?.vector);\n\n if (wantsNotifications && location.isMemory) {\n throw new DatabaseError(\n 'SQLite notification capabilities require a file-backed database',\n {\n url,\n hint: 'Use a temporary file-backed .db for development and tests that need notifications.',\n },\n );\n }\n\n const { DatabaseSync } = await loadNodeSqlite();\n const database = new DatabaseSync(location.location, {\n allowExtension: wantsVector,\n });\n\n // One lock per connection. `getNativeSqliteDatabase` hands cached callers\n // this same closure, so \"created here\" and \"per connection\" are the same\n // scope.\n const connectionLock = createTransactionLock(\n 'sqlite (native)',\n options.transactionQueueTimeout,\n );\n let closeResources: (() => Promise<void>) | undefined;\n\n try {\n if (wantsVector) {\n await loadSqliteVectorExtension(database);\n }\n\n const honkerDb =\n wantsNotifications && location.filePath\n ? await openHonkerDatabase(location.filePath, notificationsOptions)\n : null;\n const notificationCloseables = new Set<{ close?: () => void }>();\n\n const vectorCapabilities = wantsVector\n ? createVectorCapabilities(database, vectorOptions)\n : undefined;\n const notificationCapabilities = honkerDb\n ? createNotificationCapabilities(honkerDb, notificationCloseables)\n : undefined;\n\n const query = async (\n sql: string,\n ...values: any[]\n ): Promise<{ rows: Record<string, any>[]; rowCount: number }> => {\n const normalized = normalizeNativeQuery(sql, values);\n try {\n const result = executeNativeQuery(\n database,\n normalized.sql,\n normalized.args,\n );\n return { rows: result.rows, rowCount: result.rowCount };\n } catch (error) {\n throw wrapDatabaseError('Failed to execute raw query', error, {\n sql: normalized.sql,\n values: normalized.args,\n });\n }\n };\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 += `?${strings[i + 1]}`;\n }\n return { sql, values };\n };\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]).map(\n serializeRecord,\n );\n if (records.length === 0) {\n return { operation: 'insert', affected: 0 };\n }\n const keys = resolveInsertColumns(table, records);\n validateColumnNames(keys);\n const placeholders = records\n .map(() => `(${keys.map(() => '?').join(', ')})`)\n .join(', ');\n const values = records.flatMap((record) =>\n keys.map((key) => record[key]),\n );\n const sql = `INSERT INTO ${table} (${keys.map((key) => quoteSqliteColumnName(key)).join(', ')}) VALUES ${placeholders}`;\n\n try {\n const result = executeNativeQuery(database, sql, values);\n return { operation: 'insert', affected: result.rowCount };\n } catch (error) {\n throw new DatabaseError('Failed to insert records into table', {\n table,\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\n\n const get = async (\n table: string,\n where: WhereClause,\n ): Promise<Record<string, any> | null> => {\n validateTableName(table);\n const { sql: whereClause, values } = buildQuestionWhere(where);\n if (!whereClause) {\n throw new DatabaseError(\n 'GET requires at least one WHERE condition to prevent returning an arbitrary record',\n { table },\n );\n }\n\n const sql = `SELECT * FROM ${table} ${whereClause}`;\n try {\n const result = executeNativeQuery(database, sql, values);\n return result.rows[0] || null;\n } catch (error) {\n throw new DatabaseError('Failed to retrieve record from table', {\n table,\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\n\n const list = async (\n table: string,\n where: WhereClause,\n ): Promise<Record<string, any>[]> => {\n validateTableName(table);\n const { sql: whereClause, values } = buildQuestionWhere(where);\n const sql = `SELECT * FROM ${table} ${whereClause}`;\n try {\n return executeNativeQuery(database, sql, values).rows;\n } catch (error) {\n throw new DatabaseError('Failed to list records from table', {\n table,\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\n\n const update = async (\n table: string,\n where: WhereClause,\n data: Record<string, any>,\n ): Promise<QueryResult> => {\n validateTableName(table);\n const serializedData = serializeRecord(data);\n const keys = Object.keys(serializedData);\n validateColumnNames(keys);\n const values = Object.values(serializedData);\n const setClause = keys\n .map((key) => `${quoteSqliteColumnName(key)} = ?`)\n .join(', ');\n const { sql: whereClause, values: whereValues } =\n buildQuestionWhere(where);\n\n if (!whereClause) {\n throw new DatabaseError(\n 'UPDATE requires at least one WHERE condition to prevent accidental update of all records',\n { table },\n );\n }\n\n const sql = `UPDATE ${table} SET ${setClause} ${whereClause}`;\n try {\n const result = executeNativeQuery(database, sql, [\n ...values,\n ...whereValues,\n ]);\n return { operation: 'update', affected: result.rowCount };\n } catch (error) {\n throw new DatabaseError('Failed to update records in table', {\n table,\n sql,\n values: [...values, ...whereValues],\n originalError: formatDbError(error),\n });\n }\n };\n\n const hasNullConflictValue = (\n conflictColumns: string[],\n data: Record<string, any>,\n ): boolean => conflictColumns.some((column) => data[column] === null);\n\n const validateUpsertConflictColumns = (\n table: string,\n conflictColumns: string[],\n serializedData: Record<string, any>,\n ): void => {\n const missingColumns = conflictColumns.filter(\n (column) => !(column in serializedData),\n );\n\n if (missingColumns.length > 0) {\n throw new DatabaseError('Conflict columns missing from data', {\n table,\n conflictColumns,\n missingColumns,\n availableColumns: Object.keys(serializedData),\n hint: 'All columns specified in ON CONFLICT must be present in the data being inserted. Undefined values are filtered out during serialization - consider using null or an empty string instead.',\n });\n }\n };\n\n const executeStandardUpsert = (\n table: string,\n conflictColumns: string[],\n serializedData: Record<string, any>,\n ): QueryResult => {\n const keys = Object.keys(serializedData);\n const values = Object.values(serializedData);\n const placeholders = keys.map(() => '?').join(', ');\n const updateSet = keys\n .map(\n (key) =>\n `${quoteSqliteColumnName(key)} = excluded.${quoteSqliteColumnName(key)}`,\n )\n .join(', ');\n const conflict = conflictColumns.map(quoteSqliteColumnName).join(', ');\n const sql = `INSERT INTO ${table} (${keys.map((key) => quoteSqliteColumnName(key)).join(', ')}) VALUES (${placeholders}) ON CONFLICT(${conflict}) DO UPDATE SET ${updateSet}`;\n const result = executeNativeQuery(database, sql, values);\n return { operation: 'upsert', affected: result.rowCount };\n };\n\n const executeNullAwareUpsertAttempt = (\n table: string,\n conflictColumns: string[],\n serializedData: Record<string, any>,\n ): QueryResult => {\n const keys = Object.keys(serializedData);\n const values = Object.values(serializedData);\n const updateSet = keys\n .map((key) => `${quoteSqliteColumnName(key)} = ?`)\n .join(', ');\n const whereClause = conflictColumns\n .map((column) => `${quoteSqliteColumnName(column)} IS ?`)\n .join(' AND ');\n const whereValues = conflictColumns.map(\n (column) => serializedData[column],\n );\n\n const updateResult = executeNativeQuery(\n database,\n `UPDATE ${table} SET ${updateSet} WHERE ${whereClause}`,\n [...values, ...whereValues],\n );\n\n if (updateResult.rowCount > 0) {\n return { operation: 'upsert', affected: updateResult.rowCount };\n }\n\n const placeholders = keys.map(() => '?').join(', ');\n const insertResult = executeNativeQuery(\n database,\n `INSERT INTO ${table} (${keys.map((key) => quoteSqliteColumnName(key)).join(', ')}) VALUES (${placeholders})`,\n values,\n );\n\n return { operation: 'upsert', affected: insertResult.rowCount };\n };\n\n /**\n * Rejects hostile table/column identifiers before an upsert builds SQL.\n *\n * Called from the public entry points rather than from `executeUpsert`, so\n * the failure reaches the caller naming the bad identifier instead of being\n * flattened into the wrapper's generic \"Failed to upsert record into table\".\n *\n * Validates the keys of the already-serialized snapshot — the exact array\n * the executors interpolate — not a fresh enumeration of the caller's\n * `data`. Enumerating `data` again could disagree with the snapshot if it is\n * a Proxy whose `ownKeys` trap returns different keys on successive reads.\n */\n const validateUpsertIdentifiers = (\n table: string,\n conflictColumns: string[],\n serializedData: Record<string, any>,\n ): void => {\n validateTableName(table);\n validateColumnNames([...conflictColumns, ...Object.keys(serializedData)]);\n };\n\n const executeUpsert = async (\n table: string,\n conflictColumns: string[],\n serializedData: Record<string, any>,\n upsertOptions: UpsertOptions | undefined,\n acquireTransaction: boolean,\n ): Promise<QueryResult> => {\n validateUpsertConflictColumns(table, conflictColumns, serializedData);\n\n if (\n upsertOptions?.nullsDistinct ||\n !hasNullConflictValue(conflictColumns, serializedData)\n ) {\n return executeStandardUpsert(table, conflictColumns, serializedData);\n }\n\n if (!acquireTransaction) {\n return executeNullAwareUpsertAttempt(\n table,\n conflictColumns,\n serializedData,\n );\n }\n\n const lockKey = `${location.location}:${table}:${conflictColumns\n .map((column) => `${column}:${JSON.stringify(serializedData[column])}`)\n .join('|')}`;\n\n return withNativeNullAwareUpsertLock(lockKey, async () => {\n // This opens a transaction on the shared connection like any other, so\n // it takes the same lock — otherwise a null-aware upsert overlapping a\n // `transaction()` call reintroduces exactly the corruption the lock\n // exists to prevent.\n const releaseConnection = await connectionLock.acquire();\n try {\n database.exec('BEGIN IMMEDIATE');\n const result = executeNullAwareUpsertAttempt(\n table,\n conflictColumns,\n serializedData,\n );\n database.exec('COMMIT');\n return result;\n } catch (error) {\n try {\n database.exec('ROLLBACK');\n } catch (_rollbackError) {\n // Preserve the original failure.\n }\n throw error;\n } finally {\n releaseConnection();\n }\n });\n };\n\n const upsert = async (\n table: string,\n conflictColumns: string[],\n data: Record<string, any>,\n upsertOptions?: UpsertOptions,\n ): Promise<QueryResult> => {\n // Snapshot the record and the conflict columns once and thread both\n // through validation and SQL, so neither a hostile record nor a hostile\n // conflict-column array can present different identifiers to each.\n const serializedData = serializeRecord(data);\n const conflictCols = [...conflictColumns];\n validateUpsertIdentifiers(table, conflictCols, serializedData);\n try {\n return await executeUpsert(\n table,\n conflictCols,\n serializedData,\n upsertOptions,\n true,\n );\n } catch (error) {\n if (getErrorMessage(error) === 'Conflict columns missing from data') {\n throw error;\n }\n throw new DatabaseError('Failed to upsert record into table', {\n table,\n values: data,\n conflictColumns,\n originalError: formatDbError(error),\n });\n }\n };\n\n const upsertInCurrentTransaction = (\n table: string,\n conflictColumns: string[],\n data: Record<string, any>,\n upsertOptions?: UpsertOptions,\n ): Promise<QueryResult> => {\n // Snapshot the record and the conflict columns once and thread both\n // through validation and SQL, so neither a hostile record nor a hostile\n // conflict-column array can present different identifiers to each.\n const serializedData = serializeRecord(data);\n const conflictCols = [...conflictColumns];\n validateUpsertIdentifiers(table, conflictCols, serializedData);\n return executeUpsert(\n table,\n conflictCols,\n serializedData,\n upsertOptions,\n false,\n );\n };\n\n const getOrInsert = async (\n table: string,\n where: WhereClause,\n data: Record<string, any>,\n ): Promise<Record<string, any>> => {\n const existing = await get(table, where);\n if (existing) return existing;\n await insert(table, data);\n const inserted = await get(table, where);\n if (!inserted) {\n throw new DatabaseError('Failed to insert and retrieve record', {\n table,\n where,\n data,\n });\n }\n return inserted;\n };\n\n const deleteRecords = async (\n table: string,\n where: WhereClause,\n ): Promise<QueryResult> => {\n validateTableName(table);\n const { sql: whereClause, values } = buildQuestionWhere(where);\n if (!whereClause) {\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 try {\n const result = executeNativeQuery(\n database,\n `DELETE FROM ${table} ${whereClause}`,\n values,\n );\n return { operation: 'delete', affected: result.rowCount };\n } catch (error) {\n throw new DatabaseError('Failed to delete records from table', {\n table,\n where,\n originalError: formatDbError(error),\n });\n }\n };\n\n const count = async (\n table: string,\n where?: WhereClause,\n ): Promise<number> => {\n validateTableName(table);\n if (\n !where ||\n (typeof where === 'object' && Object.keys(where).length === 0)\n ) {\n const result = executeNativeQuery(\n database,\n `SELECT COUNT(*) as count FROM ${table}`,\n );\n return Number(result.rows[0]?.count) || 0;\n }\n\n const { sql: whereClause, values } = buildQuestionWhere(where);\n const result = executeNativeQuery(\n database,\n `SELECT COUNT(*) as count FROM ${table} ${whereClause}`,\n values,\n );\n return Number(result.rows[0]?.count) || 0;\n };\n\n const tableExists = async (tableName: string): Promise<boolean> => {\n const result = executeNativeQuery(\n database,\n \"SELECT name FROM sqlite_master WHERE type='table' AND name=?\",\n [tableName],\n );\n return result.rows.length > 0;\n };\n\n const syncSchema = async (schema: string): Promise<void> => {\n const commands = schema\n .replace(/\\s+/g, ' ')\n .replace(/DEFAULT CAST\\(([^)]+)\\s+AS\\s+\\w+\\)/gi, 'DEFAULT $1')\n .trim()\n .split(';')\n .map((command) => command.trim())\n .filter((command) => command.length > 0);\n\n for (const command of commands) {\n database.exec(command);\n }\n };\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 return executeNativeQuery(database, sql, values).rows;\n } catch (error) {\n throw new DatabaseError('Failed to execute many query', {\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\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 return executeNativeQuery(database, sql, values).rows[0] || null;\n } catch (error) {\n throw new DatabaseError('Failed to execute single query', {\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\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 row = executeNativeQuery(database, sql, values).rows[0];\n return row ? Object.values(row)[0] : null;\n } catch (error) {\n throw new DatabaseError('Failed to execute pluck query', {\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\n\n const execute = async (\n strings: TemplateStringsArray,\n ...vars: any[]\n ): Promise<void> => {\n const { sql, values } = parseTemplate(strings, ...vars);\n try {\n if (values.length === 0) {\n database.exec(sql);\n return;\n }\n executeNativeQuery(database, sql, values);\n } catch (error) {\n throw new DatabaseError('Failed to execute query', {\n sql,\n values,\n originalError: formatDbError(error),\n });\n }\n };\n\n const oo = many;\n const oO = single;\n const ox = pluck;\n const xx = execute;\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 // Names nested savepoints. Only ever appended to an identifier the adapter\n // generates, never caller input.\n let savepointSequence = 0;\n\n /**\n * Re-enters the transaction already in progress under a savepoint.\n *\n * This is what the transaction-scoped interface exposes as `transaction`.\n * Handing it the top-level `transaction` instead — the previous behaviour —\n * sent a nested call into a second BEGIN on the one shared connection; that\n * throws, and the nested call's own ROLLBACK then discarded the *enclosing*\n * transaction's work while later writes committed in autocommit.\n */\n const nestedTransaction = async <T>(\n callback: (tx: DatabaseInterface) => Promise<T>,\n ): Promise<T> => {\n savepointSequence += 1;\n const name = `hv_sp_${savepointSequence}`;\n database.exec(`SAVEPOINT ${name}`);\n try {\n const result = await callback(\n buildDatabaseInterface(\n upsertInCurrentTransaction,\n nestedTransaction,\n refuseNestedBeginTransaction,\n ),\n );\n database.exec(`RELEASE SAVEPOINT ${name}`);\n return result;\n } catch (error) {\n try {\n // ROLLBACK TO leaves the savepoint defined, so release it too or it\n // accumulates for the life of the transaction.\n database.exec(`ROLLBACK TO SAVEPOINT ${name}`);\n database.exec(`RELEASE SAVEPOINT ${name}`);\n } catch {\n // The enclosing transaction is already unwinding; its teardown owns\n // the connection from here.\n }\n throw error;\n }\n };\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*\n // transaction — half of its writes durable, half lost, and its promise\n // rejected, so the caller was told nothing had happened.\n connectionLock.run(async () => {\n try {\n database.exec('BEGIN TRANSACTION');\n const txDb = buildDatabaseInterface(\n upsertInCurrentTransaction,\n nestedTransaction,\n refuseNestedBeginTransaction,\n );\n const result = await callback(txDb);\n database.exec('COMMIT');\n return result;\n } catch (error) {\n // A failing ROLLBACK must not replace the caller's error: SQLite\n // reports \"cannot rollback - no transaction is active\" whenever the\n // transaction is already gone, which says nothing about what failed.\n try {\n database.exec('ROLLBACK');\n } catch {\n // Nothing left to roll back.\n }\n throw error;\n }\n });\n\n /**\n * The `beginTransaction` exposed on a transaction-scoped interface.\n *\n * Unlike `transaction`, a manual handle has no savepoint equivalent: it\n * would have to own the connection until the caller ends it, which the\n * enclosing transaction already does. Issuing a second BEGIN threw before\n * transactions were serialized; now it would instead wait on a lock its own\n * caller holds, so refuse explicitly rather than deadlock.\n */\n const refuseNestedBeginTransaction = async (): Promise<never> => {\n throw new NestedTransactionError(\n 'beginTransaction() cannot be called inside a transaction. Use the transaction you already have, or nest with transaction() to re-enter it under a savepoint.',\n { adapter: 'sqlite-native' },\n );\n };\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 database.exec('BEGIN TRANSACTION');\n } catch (error) {\n // No transaction was opened, so there is no handle to end it and\n // nothing 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 = (command: 'COMMIT' | 'ROLLBACK'): void => {\n if (!active) {\n throw new DatabaseError('Transaction already ended', {});\n }\n try {\n database.exec(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 database.exec('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 = async (): Promise<void> => end('COMMIT');\n\n const rollback = async (): Promise<void> => end('ROLLBACK');\n\n return {\n // The handle is inside a transaction for the same reason a callback\n // scope is, so it re-enters via savepoint too.\n ...buildDatabaseInterface(\n upsertInCurrentTransaction,\n nestedTransaction,\n refuseNestedBeginTransaction,\n ),\n commit,\n rollback,\n isActive: () => active,\n };\n };\n\n const initializeSchemas = async (\n schemaOptions: SchemaInitializationOptions,\n ): Promise<void> => {\n const schemaManager = new DatabaseSchemaManager();\n await schemaManager.initializeSchemas(\n buildDatabaseInterface(upsert),\n schemaOptions,\n );\n };\n\n const getTableSchema = async (\n tableName: string,\n schemaOptions?: GetTableSchemaOptions,\n ): Promise<TableSchemaInfo | null> => {\n // The name is only ever bound or rendered with identifier quoting.\n assertIntrospectionTableName(tableName);\n const optedIn =\n !!schemaOptions?.includeGenerated || !!schemaOptions?.includeHidden;\n\n if (!(await tableExists(tableName))) {\n return null;\n }\n\n const columnRows = database\n .prepare(`PRAGMA table_xinfo(${quoteIdentifier(tableName)})`)\n .all()\n .map(toPlainRow);\n\n // table_xinfo also lists generated and hidden columns; `hidden` is 0\n // ordinary, 1 hidden virtual-table column, 2 virtual generated, 3 stored\n // generated.\n const columns: Record<string, TableColumnInfo> = {};\n for (const row of columnRows) {\n const kind = Number(row.hidden ?? 0);\n // Default: ordinary columns only, as PRAGMA table_info (0.115) listed.\n if (kind === 1 && !schemaOptions?.includeHidden) continue;\n if ((kind === 2 || kind === 3) && !schemaOptions?.includeGenerated) {\n continue;\n }\n columns[row.name as string] = {\n type: row.type as string,\n primaryKey: row.pk === 1,\n notNull: row.notnull === 1,\n defaultValue: row.dflt_value,\n ...(optedIn\n ? { generated: kind === 2 || kind === 3, hidden: kind === 1 }\n : {}),\n };\n }\n\n const indexRows = executeNativeQuery(\n database,\n `SELECT name FROM sqlite_master\n WHERE type = 'index'\n AND tbl_name = ?\n AND name NOT LIKE 'sqlite_%'`,\n [tableName],\n ).rows;\n\n const indexes: IndexDefinition[] = [];\n for (const row of indexRows) {\n const indexName = row.name as string;\n const indexInfoRows = database\n .prepare(`PRAGMA index_info(${quoteIdentifier(indexName)})`)\n .all()\n .map(toPlainRow);\n const indexListRows = database\n .prepare(`PRAGMA index_list(${quoteIdentifier(tableName)})`)\n .all()\n .map(toPlainRow);\n\n indexes.push({\n name: indexName,\n columns: indexInfoRows.map((info: Record<string, any>) => info.name),\n unique: indexListRows.some(\n (info: Record<string, any>) =>\n info.name === indexName && info.unique === 1,\n ),\n });\n }\n\n const fkRows = database\n .prepare(`PRAGMA foreign_key_list(${quoteIdentifier(tableName)})`)\n .all()\n .map(toPlainRow);\n\n return {\n tableName,\n columns,\n indexes,\n foreignKeys: fkRows.map((row: Record<string, any>) => ({\n column: row.from as string,\n referencesTable: row.table as string,\n referencesColumn: row.to as string,\n onDelete: row.on_delete as string | undefined,\n onUpdate: row.on_update as string | undefined,\n })),\n };\n };\n\n const alterTable = {\n addColumn: async (\n tableName: string,\n column: ColumnDefinitionWithName,\n ): Promise<void> => {\n validateTableName(tableName);\n validateColumnName(column.name);\n let sql: string | undefined;\n try {\n sql = generateAddColumnStatement(tableName, column, 'sqlite');\n executeNativeQuery(database, sql);\n } catch (error) {\n throw wrapDatabaseError('Failed to add column to table', error, {\n table: tableName,\n column: column.name,\n ...(sql ? { sql } : {}),\n });\n }\n },\n\n addIndex: async (\n tableName: string,\n index: IndexDefinition,\n ): Promise<void> => {\n validateTableName(tableName);\n validateIndexName(index.name);\n\n for (const column of index.columns) {\n validatePlainColumnName(column);\n }\n let sql: string | undefined;\n try {\n sql = generateCreateIndexStatement(tableName, index, 'sqlite');\n executeNativeQuery(database, sql);\n } catch (error) {\n throw wrapDatabaseError('Failed to create index on table', error, {\n table: tableName,\n index: index.name,\n ...(sql ? { sql } : {}),\n });\n }\n },\n };\n\n const closeNative = createNativeSqliteCloser(\n notificationCloseables,\n honkerDb,\n database,\n );\n const releaseFile = trackSqliteFile(url, 'node-sqlite');\n const close = async () => {\n await closeNative();\n releaseFile();\n };\n closeResources = close;\n\n const reopenOptions = createSqliteReopenOptions(\n 'node-sqlite',\n options,\n url,\n );\n\n function buildDatabaseInterface(\n upsertImpl: DatabaseInterface['upsert'],\n transactionImpl: DatabaseInterface['transaction'] = transaction,\n beginTransactionImpl: DatabaseInterface['beginTransaction'] = beginTransaction,\n ): DatabaseInterface {\n return {\n url,\n engine: 'node-sqlite',\n reopenOptions,\n client: database,\n query,\n insert,\n update,\n upsert: upsertImpl,\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: transactionImpl,\n beginTransaction: beginTransactionImpl,\n getTableSchema,\n alterTable,\n close,\n ...(vectorCapabilities ? { vector: vectorCapabilities } : {}),\n ...(notificationCapabilities\n ? { notifications: notificationCapabilities }\n : {}),\n };\n }\n\n const db = buildDatabaseInterface(upsert);\n const resolvedSchemas = resolveSchemas(options.schemas);\n if (resolvedSchemas && Object.keys(resolvedSchemas).length > 0) {\n createNativeTablesFromSchemas(database, resolvedSchemas);\n }\n\n return db;\n } catch (error) {\n try {\n if (closeResources) await closeResources();\n else database.close();\n } catch (cleanupError) {\n throw new AggregateError(\n [error, cleanupError],\n 'Native SQLite initialization and cleanup failed',\n );\n }\n throw error;\n }\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { n as ReopenNotSupportedError } from "./types-DihIt7ez.js";
1
+ import { n as ReopenNotSupportedError } from "./types-B5zTs-6A.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");
@@ -412,4 +412,4 @@ function createTransactionLock(adapter, timeoutMs = DEFAULT_TRANSACTION_QUEUE_TI
412
412
  //#endregion
413
413
  export { enableCachedValidation as a, ConnectionCache as i, createTransactionLock as n, validateDatabaseCacheOptions as o, refuseReopen as r, DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS as t };
414
414
 
415
- //# sourceMappingURL=transaction-lock-BX2GJ4ei.js.map
415
+ //# sourceMappingURL=transaction-lock-BaXakB9D.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"transaction-lock-BX2GJ4ei.js","names":["#connections","#pending","#evictions","#requests","#clearing","#failedClosures","#registerRequest","#throwIfCancelled","#throwIfFailedClosure","#waitForEviction","#clearError","#finishRequest","#clearKey","#cancelRequests"],"sources":["../../src/shared/connection-cache.ts","../../src/shared/reopen.ts","../../src/shared/transaction-lock.ts"],"sourcesContent":["import type { DatabaseCacheOptions } from './types';\n\nconst CACHED_VALIDATION_CAPABILITY = Symbol.for(\n '@happyvertical/sql/connection-cache-cached-validation/v1',\n);\n\ntype PendingConnection<T> = {\n invalidated: false | 'clear' | 'evict';\n promise: Promise<T>;\n};\n\ntype EvictionChain<T> = {\n promise: Promise<void>;\n state: {\n invalidated: Set<PendingConnection<T>>;\n invalidation: 'clear' | 'evict';\n };\n};\n\ntype CacheRequest = {\n cancelled: boolean;\n done: Promise<void>;\n finish: () => void;\n};\n\n/** Race-safe async resource cache used by database adapters. */\nexport class ConnectionCache<T> {\n readonly [CACHED_VALIDATION_CAPABILITY] = true;\n readonly #connections = new Map<string, T>();\n readonly #pending = new Map<string, PendingConnection<T>>();\n readonly #evictions = new Map<string, EvictionChain<T>>();\n readonly #requests = new Map<string, Set<CacheRequest>>();\n readonly #clearing = new Map<string, number>();\n readonly #failedClosures = new Map<\n string,\n { error: unknown; resources: Set<T> }\n >();\n\n async getOrCreate(\n key: string | undefined,\n options: DatabaseCacheOptions,\n create: () => Promise<T>,\n close: (connection: T) => Promise<void>,\n validateCached?: (connection: T) => Promise<boolean>,\n ): Promise<T> {\n validateDatabaseCacheOptions(options);\n const request =\n key && options.cache !== false ? this.#registerRequest(key) : undefined;\n try {\n this.#throwIfCancelled(request);\n if (key && options.clearCache) {\n await this.evict(key, close);\n this.#throwIfCancelled(request);\n }\n if (key) this.#throwIfFailedClosure(key);\n\n if (!key || options.cache === false) {\n return create();\n }\n\n while (true) {\n if (this.#evictions.has(key)) {\n await this.#waitForEviction(key);\n this.#throwIfCancelled(request);\n }\n this.#throwIfFailedClosure(key);\n\n const cached = this.#connections.get(key);\n if (cached !== undefined) {\n if (!validateCached) return cached;\n\n // Validation may yield while another caller evicts this entry. Only\n // return the resource when it remains this key's live cache entry.\n const isValid = await validateCached(cached);\n this.#throwIfCancelled(request);\n if (\n isValid &&\n this.#connections.get(key) === cached &&\n !this.#evictions.has(key)\n ) {\n return cached;\n }\n if (\n !isValid &&\n this.#connections.get(key) === cached &&\n !this.#evictions.has(key)\n ) {\n await this.evict(key, close);\n this.#throwIfCancelled(request);\n }\n continue;\n }\n\n let pending = this.#pending.get(key);\n if (!pending) {\n this.#throwIfCancelled(request);\n pending = { invalidated: false, promise: create() };\n this.#pending.set(key, pending);\n }\n\n let connection: T;\n try {\n connection = await pending.promise;\n } catch (error) {\n if (this.#pending.get(key) === pending) {\n this.#pending.delete(key);\n }\n throw error;\n }\n\n if (pending.invalidated || this.#evictions.has(key)) {\n if (this.#evictions.has(key)) {\n await this.#waitForEviction(key);\n }\n this.#throwIfCancelled(request);\n if (pending.invalidated === 'clear') {\n throw this.#clearError();\n }\n continue;\n }\n\n this.#throwIfCancelled(request);\n if (this.#pending.get(key) === pending) {\n this.#pending.delete(key);\n }\n this.#connections.set(key, connection);\n return connection;\n }\n } finally {\n if (request && key) {\n this.#finishRequest(key, request);\n }\n }\n }\n\n async evict(\n key: string,\n close: (connection: T) => Promise<void>,\n invalidation: 'clear' | 'evict' = 'evict',\n ) {\n const previous = this.#evictions.get(key);\n const state = previous?.state ?? {\n invalidated: new Set<PendingConnection<T>>(),\n invalidation,\n };\n if (invalidation === 'clear') {\n state.invalidation = 'clear';\n for (const pending of state.invalidated) {\n pending.invalidated = 'clear';\n }\n }\n\n const eviction = (previous?.promise ?? Promise.resolve()).then(async () => {\n const resources = new Set<T>(\n this.#failedClosures.get(key)?.resources ?? [],\n );\n this.#failedClosures.delete(key);\n const cached = this.#connections.get(key);\n this.#connections.delete(key);\n if (cached) resources.add(cached);\n\n const pending = this.#pending.get(key);\n this.#pending.delete(key);\n if (pending) {\n state.invalidated.add(pending);\n pending.invalidated = state.invalidation;\n // The original initializer caller still observes its rejection. For\n // eviction, a stale failure means there is simply no resource to close.\n const initialized = await pending.promise.catch(() => undefined);\n if (initialized !== undefined) resources.add(initialized);\n }\n\n const closeResults = await Promise.allSettled(\n [...resources].map(async (resource) => {\n await close(resource);\n return resource;\n }),\n );\n const failures = closeResults.filter(\n (result): result is PromiseRejectedResult =>\n result.status === 'rejected',\n );\n if (failures.length) {\n const resourceList = [...resources];\n const failedResources = new Set<T>();\n closeResults.forEach((result, index) => {\n if (result.status === 'rejected') {\n failedResources.add(resourceList[index]);\n }\n });\n const error =\n failures.length === 1\n ? failures[0].reason\n : new AggregateError(\n failures.map((failure) => failure.reason),\n 'Multiple database connections failed to close',\n );\n this.#failedClosures.set(key, {\n error,\n resources: failedResources,\n });\n throw error;\n }\n });\n\n const chain = { promise: eviction, state };\n this.#evictions.set(key, chain);\n try {\n await eviction;\n } finally {\n if (this.#evictions.get(key) === chain) {\n this.#evictions.delete(key);\n }\n }\n }\n\n async clear(close: (connection: T) => Promise<void>) {\n const keys = new Set([\n ...this.#connections.keys(),\n ...this.#pending.keys(),\n ...this.#evictions.keys(),\n ...this.#requests.keys(),\n ...this.#clearing.keys(),\n ...this.#failedClosures.keys(),\n ]);\n const results = await Promise.allSettled(\n [...keys].map((key) => this.#clearKey(key, close)),\n );\n const failures = results.filter(\n (result): result is PromiseRejectedResult => result.status === 'rejected',\n );\n if (failures.length === 1) throw failures[0].reason;\n if (failures.length > 1) {\n throw new AggregateError(\n failures.map((failure) => failure.reason),\n 'Multiple database connection cache entries failed to clear',\n );\n }\n }\n\n forget(connection: T): void {\n for (const [key, cached] of this.#connections) {\n if (cached === connection) {\n this.#connections.delete(key);\n }\n }\n }\n\n /** @internal Test-only visibility; includes every retained namespace. */\n get size(): number {\n return (\n this.#connections.size +\n this.#pending.size +\n this.#evictions.size +\n this.#requests.size +\n this.#clearing.size +\n this.#failedClosures.size\n );\n }\n\n async #clearKey(key: string, close: (connection: T) => Promise<void>) {\n this.#clearing.set(key, (this.#clearing.get(key) ?? 0) + 1);\n try {\n this.#cancelRequests(key);\n await this.evict(key, close, 'clear');\n while (this.#requests.get(key)?.size) {\n this.#cancelRequests(key);\n await Promise.all(\n [...(this.#requests.get(key) ?? [])].map((request) => request.done),\n );\n }\n } finally {\n const remaining = (this.#clearing.get(key) ?? 1) - 1;\n if (remaining === 0) this.#clearing.delete(key);\n else this.#clearing.set(key, remaining);\n }\n }\n\n #cancelRequests(key: string): void {\n for (const request of this.#requests.get(key) ?? []) {\n request.cancelled = true;\n }\n }\n\n #clearError(): Error {\n return new Error(\n 'Database connection initialization was cancelled by cache clear',\n );\n }\n\n #finishRequest(key: string, request: CacheRequest): void {\n const requests = this.#requests.get(key);\n requests?.delete(request);\n if (requests?.size === 0) this.#requests.delete(key);\n request.finish();\n }\n\n #registerRequest(key: string): CacheRequest {\n let finish = () => {};\n const done = new Promise<void>((resolve) => {\n finish = resolve;\n });\n const request = {\n cancelled: this.#clearing.has(key),\n done,\n finish,\n };\n const requests = this.#requests.get(key) ?? new Set<CacheRequest>();\n requests.add(request);\n this.#requests.set(key, requests);\n return request;\n }\n\n #throwIfCancelled(request: CacheRequest | undefined): void {\n if (request?.cancelled) throw this.#clearError();\n }\n\n #throwIfFailedClosure(key: string): void {\n const failure = this.#failedClosures.get(key);\n if (failure) throw failure.error;\n }\n\n async #waitForEviction(key: string): Promise<void> {\n while (true) {\n const eviction = this.#evictions.get(key);\n if (!eviction) return;\n await eviction.promise;\n }\n }\n}\n\n/**\n * Adds cached-resource validation to a shared cache created by an older module.\n *\n * JSON connection caches live on `globalThis`, so a compatible older SDK copy\n * can create the shared object before this module loads. Mutating that object\n * preserves one cache for both module copies while upgrading its four-argument\n * `getOrCreate` method to the current validation contract.\n */\nexport function enableCachedValidation<T>(\n cache: ConnectionCache<T>,\n): ConnectionCache<T> {\n const compatible = cache as ConnectionCache<T> &\n Record<symbol, boolean | undefined>;\n if (compatible[CACHED_VALIDATION_CAPABILITY]) return cache;\n\n const legacyGetOrCreate = cache.getOrCreate.bind(cache) as (\n key: string | undefined,\n options: DatabaseCacheOptions,\n create: () => Promise<T>,\n close: (connection: T) => Promise<void>,\n ) => Promise<T>;\n const legacyClear = cache.clear.bind(cache);\n const locks = new Map<string, Promise<void>>();\n let clearGeneration = 0;\n let activeClear: Promise<void> | undefined;\n\n const runLocked = async <R>(key: string, work: () => Promise<R>) => {\n const previous = locks.get(key) ?? Promise.resolve();\n let release!: () => void;\n const current = new Promise<void>((resolve) => {\n release = resolve;\n });\n const chain = previous.then(\n () => current,\n () => current,\n );\n locks.set(key, chain);\n await previous.catch(() => {});\n try {\n return await work();\n } finally {\n release();\n if (locks.get(key) === chain) locks.delete(key);\n }\n };\n\n Object.defineProperty(cache, 'getOrCreate', {\n configurable: true,\n value: async (\n key: string | undefined,\n options: DatabaseCacheOptions,\n create: () => Promise<T>,\n close: (connection: T) => Promise<void>,\n validateCached?: (connection: T) => Promise<boolean>,\n ): Promise<T> => {\n if (!key || options.cache === false) {\n return legacyGetOrCreate(key, options, create, close);\n }\n const requestGeneration = clearGeneration;\n const throwIfCleared = () => {\n if (activeClear || requestGeneration !== clearGeneration) {\n throw new Error(\n 'Database connection initialization was cancelled by cache clear',\n );\n }\n };\n\n return runLocked(key, async () => {\n throwIfCleared();\n let requestOptions = options;\n while (true) {\n throwIfCleared();\n const candidate = await legacyGetOrCreate(\n key,\n requestOptions,\n create,\n close,\n );\n throwIfCleared();\n if (!validateCached) return candidate;\n\n const isValid = await validateCached(candidate);\n throwIfCleared();\n if (isValid) {\n // Reacquire under the compatibility lock so an explicit eviction\n // that completed during validation cannot make us return its old\n // resource.\n const confirmed = await legacyGetOrCreate(\n key,\n { ...requestOptions, clearCache: false },\n create,\n close,\n );\n throwIfCleared();\n if (confirmed === candidate) return candidate;\n } else {\n await cache.evict(key, close);\n }\n requestOptions = { ...options, clearCache: false };\n }\n });\n },\n writable: true,\n });\n Object.defineProperty(cache, 'clear', {\n configurable: true,\n value: async (close: (connection: T) => Promise<void>): Promise<void> => {\n if (activeClear) return activeClear;\n\n clearGeneration += 1;\n const clearing = (async () => {\n let clearError: unknown;\n let clearFailed = false;\n try {\n await legacyClear(close);\n } catch (error) {\n clearFailed = true;\n clearError = error;\n }\n while (locks.size > 0) {\n await Promise.allSettled([...locks.values()]);\n }\n if (clearFailed) throw clearError;\n })();\n activeClear = clearing;\n try {\n await clearing;\n } finally {\n if (activeClear === clearing) activeClear = undefined;\n }\n },\n writable: true,\n });\n Object.defineProperty(cache, CACHED_VALIDATION_CAPABILITY, {\n configurable: false,\n enumerable: false,\n value: true,\n writable: false,\n });\n return cache;\n}\n\nexport function validateDatabaseCacheOptions(options: DatabaseCacheOptions) {\n if (options.dbid === '') {\n throw new Error('Database cache dbid must be a non-empty string');\n }\n}\n","import { type DatabaseEngine, ReopenNotSupportedError } from './types';\n\n/**\n * A `reopenOptions` for engines that allow one owner per database: it refuses\n * with {@link ReopenNotSupportedError}.\n */\nexport function refuseReopen(\n engine: DatabaseEngine,\n reason: string,\n): () => never {\n return () => {\n throw new ReopenNotSupportedError(engine, reason);\n };\n}\n","import { DatabaseError } from '@happyvertical/utils';\n\n/**\n * How long a queued transaction waits for the connection before giving up.\n *\n * A transaction that legitimately runs longer than this will make the ones\n * behind it fail rather than stall indefinitely. Raise it with the adapter's\n * `transactionQueueTimeout` option if that is the wrong trade for a workload.\n */\nexport const DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS = 30_000;\n\n/**\n * Serializes transactions on a connection that cannot hold more than one.\n */\nexport interface TransactionLock {\n /** Whether one caller currently owns the connection. */\n readonly held: boolean;\n\n /**\n * Takes the connection and returns the function that gives it back.\n *\n * Calling the returned function more than once is a no-op, so a teardown\n * path that runs twice cannot hand the connection to two callers at once.\n */\n acquire(): Promise<() => void>;\n\n /**\n * Runs `work` with exclusive use of the connection, releasing it however\n * `work` finishes.\n */\n run<T>(work: () => Promise<T>): Promise<T>;\n}\n\n/**\n * Creates a lock that serializes transactions on one connection.\n *\n * SQLite, DuckDB and the JSON adapter each drive a single connection, and a\n * connection can only be in one transaction at a time. `transaction()` used to\n * issue `BEGIN` on that shared connection with no serialization and no record\n * of whether one was already open, so two overlapping calls corrupted each\n * other: the second `BEGIN` threw, its `catch` ran `ROLLBACK`, and that\n * rollback landed on the *first* transaction — committing part of its work,\n * discarding the rest, and rejecting its promise. Nesting was not required;\n * two concurrent requests were enough, which made it reachable from any server\n * handling more than one at a time.\n *\n * The lock spans the whole `BEGIN` … `COMMIT`/`ROLLBACK` sequence, so a queued\n * transaction starts only once the previous one has ended. It is a\n * promise-chain mutex, the same shape as the `withNullAwareUpsertLock` the\n * SQLite adapter already used for the narrower upsert case.\n *\n * Re-entrant calls must not come through here. A nested `tx.transaction()`\n * arrives via the transaction-scoped interface, which re-enters under a\n * `SAVEPOINT` (SQLite) or refuses (DuckDB, JSON) without ever reaching the\n * top-level `transaction()`; routing one here instead would make it wait on a\n * lock its own caller is holding.\n *\n * @param adapter - Adapter name, for the timeout error\n * @param timeoutMs - Ceiling on how long to wait for a turn\n */\nexport function createTransactionLock(\n adapter: string,\n timeoutMs: number = DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS,\n): TransactionLock {\n // The timer is measured from enqueue, not from when the lock frees, so this\n // bounds the total wait rather than any one holder. A caller that expects\n // sustained bursts on one connection should raise it: a hundred queued\n // 400ms transactions exceed 30s even though none of them is stuck.\n if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n throw new DatabaseError(\n 'transactionQueueTimeout must be a positive, finite number of milliseconds',\n { adapter, timeoutMs },\n );\n }\n // Resolves when the transaction currently holding the connection ends.\n let tail: Promise<void> = Promise.resolve();\n let held = false;\n\n const acquire = async (): Promise<() => void> => {\n const previous = tail;\n let release: () => void = () => {};\n const current = new Promise<void>((resolve) => {\n release = resolve;\n });\n\n // Publish our turn before awaiting, so a caller that arrives while we are\n // suspended queues behind us rather than racing us for the connection.\n tail = previous.then(\n () => current,\n () => current,\n );\n\n let timer: ReturnType<typeof setTimeout> | undefined;\n try {\n await new Promise<void>((resolve, reject) => {\n timer = setTimeout(() => {\n reject(\n new DatabaseError(\n `Timed out after ${timeoutMs}ms waiting for the ${adapter} connection's current transaction to finish. This connection runs one transaction at a time. Usually one of: a beginTransaction() handle that was never committed or rolled back; a top-level db.* call that opens its own transaction being made inside a transaction callback, which waits on the connection its own caller holds (use the tx-scoped method instead); or simply more queued transactions than transactionQueueTimeout allows for.`,\n { adapter, timeoutMs },\n ),\n );\n }, timeoutMs);\n previous.then(resolve, resolve);\n });\n } catch (error) {\n // Drop out of the queue rather than wedge it: `tail` still chains through\n // `current`, so resolving it lets the callers behind us take their turn.\n release();\n throw error;\n } finally {\n if (timer) clearTimeout(timer);\n }\n\n let released = false;\n held = true;\n return () => {\n if (released) return;\n released = true;\n held = false;\n release();\n };\n };\n\n const run = async <T>(work: () => Promise<T>): Promise<T> => {\n const release = await acquire();\n try {\n return await work();\n } finally {\n release();\n }\n };\n\n return {\n acquire,\n get held() {\n return held;\n },\n run,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"transaction-lock-BaXakB9D.js","names":["#connections","#pending","#evictions","#requests","#clearing","#failedClosures","#registerRequest","#throwIfCancelled","#throwIfFailedClosure","#waitForEviction","#clearError","#finishRequest","#clearKey","#cancelRequests"],"sources":["../../src/shared/connection-cache.ts","../../src/shared/reopen.ts","../../src/shared/transaction-lock.ts"],"sourcesContent":["import type { DatabaseCacheOptions } from './types';\n\nconst CACHED_VALIDATION_CAPABILITY = Symbol.for(\n '@happyvertical/sql/connection-cache-cached-validation/v1',\n);\n\ntype PendingConnection<T> = {\n invalidated: false | 'clear' | 'evict';\n promise: Promise<T>;\n};\n\ntype EvictionChain<T> = {\n promise: Promise<void>;\n state: {\n invalidated: Set<PendingConnection<T>>;\n invalidation: 'clear' | 'evict';\n };\n};\n\ntype CacheRequest = {\n cancelled: boolean;\n done: Promise<void>;\n finish: () => void;\n};\n\n/** Race-safe async resource cache used by database adapters. */\nexport class ConnectionCache<T> {\n readonly [CACHED_VALIDATION_CAPABILITY] = true;\n readonly #connections = new Map<string, T>();\n readonly #pending = new Map<string, PendingConnection<T>>();\n readonly #evictions = new Map<string, EvictionChain<T>>();\n readonly #requests = new Map<string, Set<CacheRequest>>();\n readonly #clearing = new Map<string, number>();\n readonly #failedClosures = new Map<\n string,\n { error: unknown; resources: Set<T> }\n >();\n\n async getOrCreate(\n key: string | undefined,\n options: DatabaseCacheOptions,\n create: () => Promise<T>,\n close: (connection: T) => Promise<void>,\n validateCached?: (connection: T) => Promise<boolean>,\n ): Promise<T> {\n validateDatabaseCacheOptions(options);\n const request =\n key && options.cache !== false ? this.#registerRequest(key) : undefined;\n try {\n this.#throwIfCancelled(request);\n if (key && options.clearCache) {\n await this.evict(key, close);\n this.#throwIfCancelled(request);\n }\n if (key) this.#throwIfFailedClosure(key);\n\n if (!key || options.cache === false) {\n return create();\n }\n\n while (true) {\n if (this.#evictions.has(key)) {\n await this.#waitForEviction(key);\n this.#throwIfCancelled(request);\n }\n this.#throwIfFailedClosure(key);\n\n const cached = this.#connections.get(key);\n if (cached !== undefined) {\n if (!validateCached) return cached;\n\n // Validation may yield while another caller evicts this entry. Only\n // return the resource when it remains this key's live cache entry.\n const isValid = await validateCached(cached);\n this.#throwIfCancelled(request);\n if (\n isValid &&\n this.#connections.get(key) === cached &&\n !this.#evictions.has(key)\n ) {\n return cached;\n }\n if (\n !isValid &&\n this.#connections.get(key) === cached &&\n !this.#evictions.has(key)\n ) {\n await this.evict(key, close);\n this.#throwIfCancelled(request);\n }\n continue;\n }\n\n let pending = this.#pending.get(key);\n if (!pending) {\n this.#throwIfCancelled(request);\n pending = { invalidated: false, promise: create() };\n this.#pending.set(key, pending);\n }\n\n let connection: T;\n try {\n connection = await pending.promise;\n } catch (error) {\n if (this.#pending.get(key) === pending) {\n this.#pending.delete(key);\n }\n throw error;\n }\n\n if (pending.invalidated || this.#evictions.has(key)) {\n if (this.#evictions.has(key)) {\n await this.#waitForEviction(key);\n }\n this.#throwIfCancelled(request);\n if (pending.invalidated === 'clear') {\n throw this.#clearError();\n }\n continue;\n }\n\n this.#throwIfCancelled(request);\n if (this.#pending.get(key) === pending) {\n this.#pending.delete(key);\n }\n this.#connections.set(key, connection);\n return connection;\n }\n } finally {\n if (request && key) {\n this.#finishRequest(key, request);\n }\n }\n }\n\n async evict(\n key: string,\n close: (connection: T) => Promise<void>,\n invalidation: 'clear' | 'evict' = 'evict',\n ) {\n const previous = this.#evictions.get(key);\n const state = previous?.state ?? {\n invalidated: new Set<PendingConnection<T>>(),\n invalidation,\n };\n if (invalidation === 'clear') {\n state.invalidation = 'clear';\n for (const pending of state.invalidated) {\n pending.invalidated = 'clear';\n }\n }\n\n const eviction = (previous?.promise ?? Promise.resolve()).then(async () => {\n const resources = new Set<T>(\n this.#failedClosures.get(key)?.resources ?? [],\n );\n this.#failedClosures.delete(key);\n const cached = this.#connections.get(key);\n this.#connections.delete(key);\n if (cached) resources.add(cached);\n\n const pending = this.#pending.get(key);\n this.#pending.delete(key);\n if (pending) {\n state.invalidated.add(pending);\n pending.invalidated = state.invalidation;\n // The original initializer caller still observes its rejection. For\n // eviction, a stale failure means there is simply no resource to close.\n const initialized = await pending.promise.catch(() => undefined);\n if (initialized !== undefined) resources.add(initialized);\n }\n\n const closeResults = await Promise.allSettled(\n [...resources].map(async (resource) => {\n await close(resource);\n return resource;\n }),\n );\n const failures = closeResults.filter(\n (result): result is PromiseRejectedResult =>\n result.status === 'rejected',\n );\n if (failures.length) {\n const resourceList = [...resources];\n const failedResources = new Set<T>();\n closeResults.forEach((result, index) => {\n if (result.status === 'rejected') {\n failedResources.add(resourceList[index]);\n }\n });\n const error =\n failures.length === 1\n ? failures[0].reason\n : new AggregateError(\n failures.map((failure) => failure.reason),\n 'Multiple database connections failed to close',\n );\n this.#failedClosures.set(key, {\n error,\n resources: failedResources,\n });\n throw error;\n }\n });\n\n const chain = { promise: eviction, state };\n this.#evictions.set(key, chain);\n try {\n await eviction;\n } finally {\n if (this.#evictions.get(key) === chain) {\n this.#evictions.delete(key);\n }\n }\n }\n\n async clear(close: (connection: T) => Promise<void>) {\n const keys = new Set([\n ...this.#connections.keys(),\n ...this.#pending.keys(),\n ...this.#evictions.keys(),\n ...this.#requests.keys(),\n ...this.#clearing.keys(),\n ...this.#failedClosures.keys(),\n ]);\n const results = await Promise.allSettled(\n [...keys].map((key) => this.#clearKey(key, close)),\n );\n const failures = results.filter(\n (result): result is PromiseRejectedResult => result.status === 'rejected',\n );\n if (failures.length === 1) throw failures[0].reason;\n if (failures.length > 1) {\n throw new AggregateError(\n failures.map((failure) => failure.reason),\n 'Multiple database connection cache entries failed to clear',\n );\n }\n }\n\n forget(connection: T): void {\n for (const [key, cached] of this.#connections) {\n if (cached === connection) {\n this.#connections.delete(key);\n }\n }\n }\n\n /** @internal Test-only visibility; includes every retained namespace. */\n get size(): number {\n return (\n this.#connections.size +\n this.#pending.size +\n this.#evictions.size +\n this.#requests.size +\n this.#clearing.size +\n this.#failedClosures.size\n );\n }\n\n async #clearKey(key: string, close: (connection: T) => Promise<void>) {\n this.#clearing.set(key, (this.#clearing.get(key) ?? 0) + 1);\n try {\n this.#cancelRequests(key);\n await this.evict(key, close, 'clear');\n while (this.#requests.get(key)?.size) {\n this.#cancelRequests(key);\n await Promise.all(\n [...(this.#requests.get(key) ?? [])].map((request) => request.done),\n );\n }\n } finally {\n const remaining = (this.#clearing.get(key) ?? 1) - 1;\n if (remaining === 0) this.#clearing.delete(key);\n else this.#clearing.set(key, remaining);\n }\n }\n\n #cancelRequests(key: string): void {\n for (const request of this.#requests.get(key) ?? []) {\n request.cancelled = true;\n }\n }\n\n #clearError(): Error {\n return new Error(\n 'Database connection initialization was cancelled by cache clear',\n );\n }\n\n #finishRequest(key: string, request: CacheRequest): void {\n const requests = this.#requests.get(key);\n requests?.delete(request);\n if (requests?.size === 0) this.#requests.delete(key);\n request.finish();\n }\n\n #registerRequest(key: string): CacheRequest {\n let finish = () => {};\n const done = new Promise<void>((resolve) => {\n finish = resolve;\n });\n const request = {\n cancelled: this.#clearing.has(key),\n done,\n finish,\n };\n const requests = this.#requests.get(key) ?? new Set<CacheRequest>();\n requests.add(request);\n this.#requests.set(key, requests);\n return request;\n }\n\n #throwIfCancelled(request: CacheRequest | undefined): void {\n if (request?.cancelled) throw this.#clearError();\n }\n\n #throwIfFailedClosure(key: string): void {\n const failure = this.#failedClosures.get(key);\n if (failure) throw failure.error;\n }\n\n async #waitForEviction(key: string): Promise<void> {\n while (true) {\n const eviction = this.#evictions.get(key);\n if (!eviction) return;\n await eviction.promise;\n }\n }\n}\n\n/**\n * Adds cached-resource validation to a shared cache created by an older module.\n *\n * JSON connection caches live on `globalThis`, so a compatible older SDK copy\n * can create the shared object before this module loads. Mutating that object\n * preserves one cache for both module copies while upgrading its four-argument\n * `getOrCreate` method to the current validation contract.\n */\nexport function enableCachedValidation<T>(\n cache: ConnectionCache<T>,\n): ConnectionCache<T> {\n const compatible = cache as ConnectionCache<T> &\n Record<symbol, boolean | undefined>;\n if (compatible[CACHED_VALIDATION_CAPABILITY]) return cache;\n\n const legacyGetOrCreate = cache.getOrCreate.bind(cache) as (\n key: string | undefined,\n options: DatabaseCacheOptions,\n create: () => Promise<T>,\n close: (connection: T) => Promise<void>,\n ) => Promise<T>;\n const legacyClear = cache.clear.bind(cache);\n const locks = new Map<string, Promise<void>>();\n let clearGeneration = 0;\n let activeClear: Promise<void> | undefined;\n\n const runLocked = async <R>(key: string, work: () => Promise<R>) => {\n const previous = locks.get(key) ?? Promise.resolve();\n let release!: () => void;\n const current = new Promise<void>((resolve) => {\n release = resolve;\n });\n const chain = previous.then(\n () => current,\n () => current,\n );\n locks.set(key, chain);\n await previous.catch(() => {});\n try {\n return await work();\n } finally {\n release();\n if (locks.get(key) === chain) locks.delete(key);\n }\n };\n\n Object.defineProperty(cache, 'getOrCreate', {\n configurable: true,\n value: async (\n key: string | undefined,\n options: DatabaseCacheOptions,\n create: () => Promise<T>,\n close: (connection: T) => Promise<void>,\n validateCached?: (connection: T) => Promise<boolean>,\n ): Promise<T> => {\n if (!key || options.cache === false) {\n return legacyGetOrCreate(key, options, create, close);\n }\n const requestGeneration = clearGeneration;\n const throwIfCleared = () => {\n if (activeClear || requestGeneration !== clearGeneration) {\n throw new Error(\n 'Database connection initialization was cancelled by cache clear',\n );\n }\n };\n\n return runLocked(key, async () => {\n throwIfCleared();\n let requestOptions = options;\n while (true) {\n throwIfCleared();\n const candidate = await legacyGetOrCreate(\n key,\n requestOptions,\n create,\n close,\n );\n throwIfCleared();\n if (!validateCached) return candidate;\n\n const isValid = await validateCached(candidate);\n throwIfCleared();\n if (isValid) {\n // Reacquire under the compatibility lock so an explicit eviction\n // that completed during validation cannot make us return its old\n // resource.\n const confirmed = await legacyGetOrCreate(\n key,\n { ...requestOptions, clearCache: false },\n create,\n close,\n );\n throwIfCleared();\n if (confirmed === candidate) return candidate;\n } else {\n await cache.evict(key, close);\n }\n requestOptions = { ...options, clearCache: false };\n }\n });\n },\n writable: true,\n });\n Object.defineProperty(cache, 'clear', {\n configurable: true,\n value: async (close: (connection: T) => Promise<void>): Promise<void> => {\n if (activeClear) return activeClear;\n\n clearGeneration += 1;\n const clearing = (async () => {\n let clearError: unknown;\n let clearFailed = false;\n try {\n await legacyClear(close);\n } catch (error) {\n clearFailed = true;\n clearError = error;\n }\n while (locks.size > 0) {\n await Promise.allSettled([...locks.values()]);\n }\n if (clearFailed) throw clearError;\n })();\n activeClear = clearing;\n try {\n await clearing;\n } finally {\n if (activeClear === clearing) activeClear = undefined;\n }\n },\n writable: true,\n });\n Object.defineProperty(cache, CACHED_VALIDATION_CAPABILITY, {\n configurable: false,\n enumerable: false,\n value: true,\n writable: false,\n });\n return cache;\n}\n\nexport function validateDatabaseCacheOptions(options: DatabaseCacheOptions) {\n if (options.dbid === '') {\n throw new Error('Database cache dbid must be a non-empty string');\n }\n}\n","import { type DatabaseEngine, ReopenNotSupportedError } from './types';\n\n/**\n * A `reopenOptions` for engines that allow one owner per database: it refuses\n * with {@link ReopenNotSupportedError}.\n */\nexport function refuseReopen(\n engine: DatabaseEngine,\n reason: string,\n): () => never {\n return () => {\n throw new ReopenNotSupportedError(engine, reason);\n };\n}\n","import { DatabaseError } from '@happyvertical/utils';\n\n/**\n * How long a queued transaction waits for the connection before giving up.\n *\n * A transaction that legitimately runs longer than this will make the ones\n * behind it fail rather than stall indefinitely. Raise it with the adapter's\n * `transactionQueueTimeout` option if that is the wrong trade for a workload.\n */\nexport const DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS = 30_000;\n\n/**\n * Serializes transactions on a connection that cannot hold more than one.\n */\nexport interface TransactionLock {\n /** Whether one caller currently owns the connection. */\n readonly held: boolean;\n\n /**\n * Takes the connection and returns the function that gives it back.\n *\n * Calling the returned function more than once is a no-op, so a teardown\n * path that runs twice cannot hand the connection to two callers at once.\n */\n acquire(): Promise<() => void>;\n\n /**\n * Runs `work` with exclusive use of the connection, releasing it however\n * `work` finishes.\n */\n run<T>(work: () => Promise<T>): Promise<T>;\n}\n\n/**\n * Creates a lock that serializes transactions on one connection.\n *\n * SQLite, DuckDB and the JSON adapter each drive a single connection, and a\n * connection can only be in one transaction at a time. `transaction()` used to\n * issue `BEGIN` on that shared connection with no serialization and no record\n * of whether one was already open, so two overlapping calls corrupted each\n * other: the second `BEGIN` threw, its `catch` ran `ROLLBACK`, and that\n * rollback landed on the *first* transaction — committing part of its work,\n * discarding the rest, and rejecting its promise. Nesting was not required;\n * two concurrent requests were enough, which made it reachable from any server\n * handling more than one at a time.\n *\n * The lock spans the whole `BEGIN` … `COMMIT`/`ROLLBACK` sequence, so a queued\n * transaction starts only once the previous one has ended. It is a\n * promise-chain mutex, the same shape as the `withNullAwareUpsertLock` the\n * SQLite adapter already used for the narrower upsert case.\n *\n * Re-entrant calls must not come through here. A nested `tx.transaction()`\n * arrives via the transaction-scoped interface, which re-enters under a\n * `SAVEPOINT` (SQLite) or refuses (DuckDB, JSON) without ever reaching the\n * top-level `transaction()`; routing one here instead would make it wait on a\n * lock its own caller is holding.\n *\n * @param adapter - Adapter name, for the timeout error\n * @param timeoutMs - Ceiling on how long to wait for a turn\n */\nexport function createTransactionLock(\n adapter: string,\n timeoutMs: number = DEFAULT_TRANSACTION_QUEUE_TIMEOUT_MS,\n): TransactionLock {\n // The timer is measured from enqueue, not from when the lock frees, so this\n // bounds the total wait rather than any one holder. A caller that expects\n // sustained bursts on one connection should raise it: a hundred queued\n // 400ms transactions exceed 30s even though none of them is stuck.\n if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n throw new DatabaseError(\n 'transactionQueueTimeout must be a positive, finite number of milliseconds',\n { adapter, timeoutMs },\n );\n }\n // Resolves when the transaction currently holding the connection ends.\n let tail: Promise<void> = Promise.resolve();\n let held = false;\n\n const acquire = async (): Promise<() => void> => {\n const previous = tail;\n let release: () => void = () => {};\n const current = new Promise<void>((resolve) => {\n release = resolve;\n });\n\n // Publish our turn before awaiting, so a caller that arrives while we are\n // suspended queues behind us rather than racing us for the connection.\n tail = previous.then(\n () => current,\n () => current,\n );\n\n let timer: ReturnType<typeof setTimeout> | undefined;\n try {\n await new Promise<void>((resolve, reject) => {\n timer = setTimeout(() => {\n reject(\n new DatabaseError(\n `Timed out after ${timeoutMs}ms waiting for the ${adapter} connection's current transaction to finish. This connection runs one transaction at a time. Usually one of: a beginTransaction() handle that was never committed or rolled back; a top-level db.* call that opens its own transaction being made inside a transaction callback, which waits on the connection its own caller holds (use the tx-scoped method instead); or simply more queued transactions than transactionQueueTimeout allows for.`,\n { adapter, timeoutMs },\n ),\n );\n }, timeoutMs);\n previous.then(resolve, resolve);\n });\n } catch (error) {\n // Drop out of the queue rather than wedge it: `tail` still chains through\n // `current`, so resolving it lets the callers behind us take their turn.\n release();\n throw error;\n } finally {\n if (timer) clearTimeout(timer);\n }\n\n let released = false;\n held = true;\n return () => {\n if (released) return;\n released = true;\n held = false;\n release();\n };\n };\n\n const run = async <T>(work: () => Promise<T>): Promise<T> => {\n const release = await acquire();\n try {\n return await work();\n } finally {\n release();\n }\n };\n\n return {\n acquire,\n get held() {\n return held;\n },\n run,\n };\n}\n"],"mappings":"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"}
@@ -122,6 +122,17 @@ function validateTableName(tableName) {
122
122
  if (typeof tableName !== "string" || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(tableName)) throw new Error(`Invalid table name: ${tableName}. Table names must be a string that starts with a letter or underscore and contains only alphanumeric characters and underscores.`);
123
123
  }
124
124
  /**
125
+ * Validates a table name that is only ever bound as a catalog-query parameter
126
+ * or rendered with identifier quoting (introspection: `getTableSchema`,
127
+ * `tableExists`). Any legal name is accepted, including quoted, spaced and
128
+ * mixed-case ones; only values that cannot be a name are rejected.
129
+ *
130
+ * Use {@link validateTableName} instead wherever a name is interpolated raw.
131
+ */
132
+ function assertIntrospectionTableName(tableName) {
133
+ if (typeof tableName !== "string" || tableName.length === 0 || tableName.includes("\0")) throw new Error(`Invalid table name: ${String(tableName)}`);
134
+ }
135
+ /**
125
136
  * Validates a column name to prevent SQL injection
126
137
  *
127
138
  * Rejects non-strings for the same reason as {@link validateTableName}: a value
@@ -1297,6 +1308,6 @@ function resolveSchemas(schemas) {
1297
1308
  return schemas;
1298
1309
  }
1299
1310
  //#endregion
1300
- export { quoteSqliteLiteralIdentifier as C, validateIndexName as D, validateColumnNames as E, validatePlainColumnName as O, quoteSqliteColumnName as S, validateColumnName as T, identifierParts as _, buildAdapterWhere as a, quoteLiteralIdentifier as b, parseConditionKey as c, rewriteSqlParameters as d, unwrapRawKey as f, generateCreateIndexStatement as g, generateAddColumnStatement as h, DatabaseSchemaManager as i, validateTableName as k, raw as l, escapeStringLiteral as m, ReopenNotSupportedError as n, buildWhere as o, wrapDatabaseError as p, resolveSchemas as r, formatDbError as s, NestedTransactionError as t, resolveInsertColumns as u, isLegacyNumericSqlToken as v, renderIdentifier as w, quotePostgresColumnName as x, quoteDuckDBColumnName as y };
1311
+ export { validateTableName as A, quoteSqliteColumnName as C, validateColumnNames as D, validateColumnName as E, validateIndexName as O, quotePostgresColumnName as S, renderIdentifier as T, generateCreateIndexStatement as _, buildAdapterWhere as a, quoteDuckDBColumnName as b, parseConditionKey as c, rewriteSqlParameters as d, unwrapRawKey as f, generateAddColumnStatement as g, escapeStringLiteral as h, DatabaseSchemaManager as i, validatePlainColumnName as k, raw as l, assertIntrospectionTableName as m, ReopenNotSupportedError as n, buildWhere as o, wrapDatabaseError as p, resolveSchemas as r, formatDbError as s, NestedTransactionError as t, resolveInsertColumns as u, identifierParts as v, quoteSqliteLiteralIdentifier as w, quoteLiteralIdentifier as x, isLegacyNumericSqlToken as y };
1301
1312
 
1302
- //# sourceMappingURL=types-DihIt7ez.js.map
1313
+ //# sourceMappingURL=types-B5zTs-6A.js.map