@molecule/api-database-duckdb 0.0.0-stage → 1.1.1

package/dist/lifecycle.js

@@ -0,0 +1,45 @@
+/**
+ * Process-lifecycle integration for the DuckDB bond.
+ *
+ * Optional and dynamic — a project without `@molecule/api-process-lifecycle`
+ * imports this bond unchanged. With the package present, `/health/ready` runs
+ * a CRITICAL `SELECT 1` (a DuckDB file can be locked, removed, or its disk
+ * full after boot) and the ordered shutdown closes the pool.
+ *
+ * @module
+ */
+/** Runtime import specifier kept in a variable so the package stays optional. */
+const PROCESS_LIFECYCLE = '@molecule/api-process-lifecycle';
+/**
+ * Register the database readiness check and shutdown hook with the bonded
+ * process-lifecycle provider.
+ *
+ * @param resources - The ping and close functions this bond owns.
+ */
+export function registerLifecycleIntegration(resources) {
+    void import(PROCESS_LIFECYCLE)
+        .then((module) => {
+        const lifecycle = module;
+        lifecycle.registerReadinessCheck({
+            name: 'database',
+            critical: true,
+            timeoutMs: 2_000,
+            description: 'DuckDB accepts a query',
+            check: resources.ping,
+        });
+        lifecycle.registerShutdownHook({
+            name: 'database-pool',
+            // Last: other hooks may still need the database while it closes.
+            order: 40,
+            timeoutMs: 10_000,
+            run: async () => {
+                if (resources.created())
+                    await resources.close();
+            },
+        });
+    })
+        .catch((_error) => {
+        // @molecule/api-process-lifecycle is not installed — nothing to wire.
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iFAAiF;AACjF,MAAM,iBAAiB,GAAG,iCAAiC,CAAA;AAmB3D;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAI5C;IACC,KAAK,MAAM,CAAC,iBAAiB,CAAC;SAC3B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,MAAM,SAAS,GAAG,MAAoC,CAAA;QACtD,SAAS,CAAC,sBAAsB,CAAC;YAC/B,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,wBAAwB;YACrC,KAAK,EAAE,SAAS,CAAC,IAAI;SACtB,CAAC,CAAA;QACF,SAAS,CAAC,oBAAoB,CAAC;YAC7B,IAAI,EAAE,eAAe;YACrB,iEAAiE;YACjE,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,MAAM;YACjB,GAAG,EAAE,KAAK,IAAI,EAAE;gBACd,IAAI,SAAS,CAAC,OAAO,EAAE;oBAAE,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;YAClD,CAAC;SACF,CAAC,CAAA;IACJ,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;QAChB,sEAAsE;IACxE,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/migrator.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DuckDB migration runner.
+ *
+ * Same contract as the sqlite/pglite bonds' migrators: every `*.sql` file in a
+ * directory runs in lexical order; "already exists" errors from a re-run are
+ * warnings; any other error fails the run with every broken file named. There
+ * is no `CREATE DATABASE` step — DuckDB creates the file when it opens. Each
+ * file runs ONCE, inside one transaction, recorded in the
+ * `_molecule_migrations` ledger.
+ *
+ * DuckDB natively supports `ADD COLUMN IF NOT EXISTS`, `DROP COLUMN IF
+ * EXISTS`, `gen_random_uuid()`, `now()` and `CREATE TABLE IF NOT EXISTS`, so
+ * the sqlite bond's column-reconciliation machinery is not needed here. What the
+ * translation does — and refuses — is documented on `translateDdlToDuckdb`:
+ * `jsonb`, index `USING <method>` and partial indexes are translated without
+ * changing behaviour, while an `ON DELETE`/`ON UPDATE` referential action throws
+ * `UnsupportedSqlFeatureError` (DuckDB cannot reproduce it).
+ *
+ * @module
+ */
+import './secrets.js';
+import type { DatabasePool, DatabaseTransaction } from '@molecule/api-database';
+/** The table that records which migration files have run. */
+export declare const MIGRATION_LEDGER = "_molecule_migrations";
+/**
+ * A pool that can run migrations — `DatabasePool` plus the interactive
+ * transaction every bond in the `database` category implements (the interface
+ * marks it optional; no bond ships without it, and the runner needs it).
+ */
+export type MigratablePool = DatabasePool & {
+    /** Begins a transaction that holds the pool's connection until it ends. */
+    transaction(): Promise<DatabaseTransaction>;
+};
+/**
+ * Returns true when `err` looks like an "already exists" / duplicate-object
+ * idempotency error — the class of error an `IF NOT EXISTS` migration is
+ * EXPECTED to hit on a re-run. DuckDB errors carry no code, so this matches
+ * the message text (the same approach the sqlite bond takes).
+ *
+ * @param err - The error thrown while applying a migration.
+ * @returns True if it is safe to warn and continue.
+ */
+export declare function isIdempotencyError(err: unknown): boolean;
+/** Options for the migration runner. */
+export interface MigrationOptions {
+    /** Prefix for ledger keys when one database applies SQL from more than one directory. */
+    namespace?: string;
+}
+/**
+ * Apply every migration file in `migrationsDir` to `pool`, in lexical order.
+ * Exported so a sibling bond (motherduck) can run the same ledger logic on
+ * its own pool.
+ *
+ * @param pool - The pool to migrate (its database is created on first open).
+ * @param migrationsDir - Absolute path to the directory of ordered `*.sql` files.
+ * @param options - Ledger namespace for multi-directory apps.
+ * @returns Resolves when every file is applied or recorded.
+ * @throws {Error} When any file fails with a non-idempotency error — every
+ *   broken file is named in the one error, so a single boot log reports all.
+ */
+export declare function applyMigrations(pool: MigratablePool, migrationsDir: string, options?: MigrationOptions): Promise<void>;
+/**
+ * Returns a `runMigrations()` bound to a migrations directory.
+ *
+ * @param migrationsDir - Absolute path to the directory of ordered `*.sql`
+ *   migration files, resolved from the API package directory.
+ * @param options - A stable namespace for a second SQL directory.
+ * @returns A no-arg `runMigrations()` that opens the DuckDB file (creating it
+ *   and its parent directory if missing) and applies every migration file in
+ *   lexical order. Reads the file path from the `DUCKDB_PATH` env var
+ *   (default `./data/app.duckdb`), matching the pool.
+ */
+export declare function createMigrator(migrationsDir: string, options?: MigrationOptions): () => Promise<void>;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../src/migrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAK/E,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,yBAAyB,CAAA;AAEtD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG;IAC1C,2EAA2E;IAC3E,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAC5C,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOxD;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsGf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,OAAO,CAAC,IAAI,CAAC,CASrB"}

package/dist/migrator.js

@@ -0,0 +1,172 @@
+/**
+ * DuckDB migration runner.
+ *
+ * Same contract as the sqlite/pglite bonds' migrators: every `*.sql` file in a
+ * directory runs in lexical order; "already exists" errors from a re-run are
+ * warnings; any other error fails the run with every broken file named. There
+ * is no `CREATE DATABASE` step — DuckDB creates the file when it opens. Each
+ * file runs ONCE, inside one transaction, recorded in the
+ * `_molecule_migrations` ledger.
+ *
+ * DuckDB natively supports `ADD COLUMN IF NOT EXISTS`, `DROP COLUMN IF
+ * EXISTS`, `gen_random_uuid()`, `now()` and `CREATE TABLE IF NOT EXISTS`, so
+ * the sqlite bond's column-reconciliation machinery is not needed here. What the
+ * translation does — and refuses — is documented on `translateDdlToDuckdb`:
+ * `jsonb`, index `USING <method>` and partial indexes are translated without
+ * changing behaviour, while an `ON DELETE`/`ON UPDATE` referential action throws
+ * `UnsupportedSqlFeatureError` (DuckDB cannot reproduce it).
+ *
+ * @module
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// Side-effect import: registers this bond's secret definitions so the
+// runtime registry is populated even when migrator.js is imported directly
+// (not through the package barrel).
+import './secrets.js';
+import { createPool } from './pool.js';
+import { translateDdlToDuckdb } from './utilities.js';
+/** The table that records which migration files have run. */
+export const MIGRATION_LEDGER = '_molecule_migrations';
+/**
+ * Returns true when `err` looks like an "already exists" / duplicate-object
+ * idempotency error — the class of error an `IF NOT EXISTS` migration is
+ * EXPECTED to hit on a re-run. DuckDB errors carry no code, so this matches
+ * the message text (the same approach the sqlite bond takes).
+ *
+ * @param err - The error thrown while applying a migration.
+ * @returns True if it is safe to warn and continue.
+ */
+export function isIdempotencyError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return (/already exists/i.test(msg) ||
+        /duplicate (column|key|object) name/i.test(msg) ||
+        /multiple primary keys for table/i.test(msg));
+}
+/**
+ * Apply every migration file in `migrationsDir` to `pool`, in lexical order.
+ * Exported so a sibling bond (motherduck) can run the same ledger logic on
+ * its own pool.
+ *
+ * @param pool - The pool to migrate (its database is created on first open).
+ * @param migrationsDir - Absolute path to the directory of ordered `*.sql` files.
+ * @param options - Ledger namespace for multi-directory apps.
+ * @returns Resolves when every file is applied or recorded.
+ * @throws {Error} When any file fails with a non-idempotency error — every
+ *   broken file is named in the one error, so a single boot log reports all.
+ */
+export async function applyMigrations(pool, migrationsDir, options = {}) {
+    const namespace = options.namespace ?? '';
+    const sqlFiles = existsSync(migrationsDir)
+        ? readdirSync(migrationsDir)
+            .filter((file) => file.endsWith('.sql'))
+            .sort()
+        : [];
+    if (sqlFiles.length === 0) {
+        console.log('No migration files found.');
+        return;
+    }
+    await pool.query(`CREATE TABLE IF NOT EXISTS "${MIGRATION_LEDGER}" ("file" VARCHAR PRIMARY KEY, "applied_at" TIMESTAMPTZ NOT NULL DEFAULT now(), "namespace" VARCHAR)`);
+    const applied = new Set((await pool.query(`SELECT "file" FROM "${MIGRATION_LEDGER}"`)).rows.map((row) => String(row.file)));
+    const failures = [];
+    let skipped = 0;
+    for (const file of sqlFiles) {
+        const key = namespace ? `${namespace}/${file}` : file;
+        // Resource/template setup migrations are authored in Postgres dialect.
+        // translateDdlToDuckdb rewrites jsonb, index USING and partial indexes, and
+        // throws for a referential action DuckDB cannot reproduce (naming this file
+        // via options.source, so one boot log points at the resource). No-op on
+        // already-DuckDB DDL.
+        const sql = translateDdlToDuckdb(readFileSync(join(migrationsDir, file), 'utf-8'), {
+            source: file,
+        });
+        if (applied.has(key)) {
+            // A recorded file never runs again (a DROP or a backfill in it would
+            // repeat on every boot).
+            skipped++;
+            continue;
+        }
+        // In a transaction, so a file that fails applies none of its statements.
+        // `pool.transaction()` issues the BEGIN; COMMIT/ROLLBACK come from the
+        // transaction object. A file that manages its own BEGIN/COMMIT runs
+        // OUTSIDE ours — DuckDB refuses to nest transactions ("cannot start a
+        // transaction within a transaction"), the same case the sqlite migrator
+        // detects.
+        const selfManaged = /^\s*(?:BEGIN|START\s+TRANSACTION)\b/im.test(sql);
+        try {
+            if (selfManaged) {
+                await pool.query(sql);
+                await pool.query(`INSERT INTO "${MIGRATION_LEDGER}" ("file", "namespace") VALUES (?, ?)`, [
+                    key,
+                    namespace,
+                ]);
+            }
+            else {
+                const tx = await pool.transaction();
+                try {
+                    // No values: the client runs a multi-statement string in full.
+                    await tx.query(sql);
+                    await tx.query(`INSERT INTO "${MIGRATION_LEDGER}" ("file", "namespace") VALUES (?, ?)`, [
+                        key,
+                        namespace,
+                    ]);
+                    await tx.commit();
+                }
+                catch (err) {
+                    await tx.rollback().catch((_error) => {
+                        // The transaction already aborted in the engine; the rollback is
+                        // bookkeeping. The original error is the one to report.
+                    });
+                    throw err;
+                }
+            }
+            console.log(`✓ ${file}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (isIdempotencyError(err)) {
+                console.warn(`⚠ ${file}: ${msg} — nothing in this file was applied; an object it creates ` +
+                    'already exists, so remove that statement or move the rest to a new migration file');
+            }
+            else {
+                // A genuinely broken migration must NOT be swallowed as if it were
+                // idempotent — that boots the app with a missing/partial schema and
+                // the failure resurfaces later, far from the real cause. Collect it
+                // and keep going so ONE boot log reports every broken file at once.
+                console.error(`✗ ${file}: ${msg}`);
+                failures.push({ file, message: msg });
+            }
+        }
+    }
+    if (failures.length > 0) {
+        throw new Error(`Migrations failed — ${failures.length} file(s) had non-idempotency errors; ` +
+            `the app would boot with a missing/partial schema:\n` +
+            failures.map((f) => `  - ${f.file}: ${f.message}`).join('\n'));
+    }
+    if (skipped > 0)
+        console.log(`· ${skipped} migration file(s) already applied`);
+    console.log('Migrations complete.');
+}
+/**
+ * Returns a `runMigrations()` bound to a migrations directory.
+ *
+ * @param migrationsDir - Absolute path to the directory of ordered `*.sql`
+ *   migration files, resolved from the API package directory.
+ * @param options - A stable namespace for a second SQL directory.
+ * @returns A no-arg `runMigrations()` that opens the DuckDB file (creating it
+ *   and its parent directory if missing) and applies every migration file in
+ *   lexical order. Reads the file path from the `DUCKDB_PATH` env var
+ *   (default `./data/app.duckdb`), matching the pool.
+ */
+export function createMigrator(migrationsDir, options = {}) {
+    return async function runMigrations() {
+        const pool = createPool();
+        try {
+            await applyMigrations(pool, migrationsDir, options);
+        }
+        finally {
+            await pool.end();
+        }
+    };
+}
+//# sourceMappingURL=migrator.js.map

package/dist/migrator.js.map

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

package/dist/pool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * DuckDB `DatabasePool` implementation using `@duckdb/node-api`.
+ *
+ * @module
+ */
+import './secrets.js';
+import type { DuckDBConnection, DuckDBValue } from '@duckdb/node-api';
+import type { DatabasePool, QueryResult } from '@molecule/api-database';
+import type { DuckdbConfig } from './types.js';
+/**
+ * Runs one statement on a connection and normalizes its result into the core
+ * `QueryResult` shape. `$1`-style and `?` placeholders pass through to
+ * DuckDB untranslated — both are native. With VALUES the client prepares the
+ * statement (one statement only); without values a multi-statement string
+ * runs in full and the LAST statement's result is returned (the pglite bond's
+ * simple-query behavior).
+ *
+ * `rowCount` follows node-postgres: rows returned for a statement that
+ * produced rows (a SELECT, or `INSERT/UPDATE/DELETE … RETURNING` — DuckDB
+ * reports 0 changed rows for a RETURNING statement, so the returned rows ARE
+ * the affected count), `rowsChanged` for plain DML, `null` for DDL.
+ *
+ * @param connection - The connection to run on.
+ * @param text - SQL with `$1, $2, …` or `?` placeholders.
+ * @param values - Positional parameter values (already coerced).
+ * @returns The normalized result.
+ */
+export declare function runDuckdbQuery<T = Record<string, unknown>>(connection: DuckDBConnection, text: string, values?: DuckDBValue[]): Promise<QueryResult<T>>;
+/**
+ * Creates a `DatabasePool` backed by DuckDB.
+ *
+ * The database opens on first use, not here, so creating a pool is free and
+ * synchronous. See {@link DuckdbConfig} for where the file lives and the
+ * resource defaults the instance gets.
+ *
+ * @param config - Database path, resource limits and wait timeout.
+ * @returns A pool over one DuckDB connection.
+ */
+export declare const createPool: (config?: DuckdbConfig) => DatabasePool;
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAIrE,OAAO,KAAK,EAEV,YAAY,EAEZ,WAAW,EACZ,MAAM,wBAAwB,CAAA;AAI/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAmC9C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,UAAU,EAAE,gBAAgB,EAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,EAAE,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAmBzB;AAkBD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,YAAY,KAAG,YAoKlD,CAAA"}

package/dist/pool.js

@@ -0,0 +1,273 @@
+/**
+ * DuckDB `DatabasePool` implementation using `@duckdb/node-api`.
+ *
+ * @module
+ */
+// Side-effect import: registers this bond's secret definitions so the
+// runtime registry is populated even when pool.js is imported directly
+// (not through the package barrel).
+import './secrets.js';
+import { ResultReturnType } from '@duckdb/node-api';
+import { getLogger } from '@molecule/api-bond';
+import { getActiveTransaction } from '@molecule/api-database';
+import { acquireInstance, releaseInstance } from './instances.js';
+import { coerceDuckdbParam, normalizeDuckdbRows } from './utilities.js';
+/** Default wait for the single connection. */
+const DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;
+/** How much of a failing statement the error message carries (whitespace-collapsed). */
+const STATEMENT_IN_MESSAGE_CAP = 200;
+/**
+ * Runs `statement` and, when the client throws, names the statement that failed.
+ *
+ * DuckDB's errors carry no SQL at all (`Catalog Error: Table with name x does
+ * not exist!`, `Binder Error: …`) — the same blind spot the sqlite bond patches
+ * with `withStatementContext`. The error keeps its class and message; its
+ * message gains the statement on one line, and `sql` carries the statement
+ * whole. The bound VALUES are never part of either.
+ *
+ * @param sql - The statement as the driver received it.
+ * @param run - Runs the statement and returns its result.
+ * @returns Whatever `run` returned.
+ */
+async function withStatementContext(sql, run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        if (error instanceof Error && !error.sql) {
+            const oneLine = sql.replace(/\s+/g, ' ').trim().slice(0, STATEMENT_IN_MESSAGE_CAP);
+            error.sql = sql;
+            error.message = `${error.message} — in: ${oneLine}`;
+        }
+        throw error;
+    }
+}
+/**
+ * Runs one statement on a connection and normalizes its result into the core
+ * `QueryResult` shape. `$1`-style and `?` placeholders pass through to
+ * DuckDB untranslated — both are native. With VALUES the client prepares the
+ * statement (one statement only); without values a multi-statement string
+ * runs in full and the LAST statement's result is returned (the pglite bond's
+ * simple-query behavior).
+ *
+ * `rowCount` follows node-postgres: rows returned for a statement that
+ * produced rows (a SELECT, or `INSERT/UPDATE/DELETE … RETURNING` — DuckDB
+ * reports 0 changed rows for a RETURNING statement, so the returned rows ARE
+ * the affected count), `rowsChanged` for plain DML, `null` for DDL.
+ *
+ * @param connection - The connection to run on.
+ * @param text - SQL with `$1, $2, …` or `?` placeholders.
+ * @param values - Positional parameter values (already coerced).
+ * @returns The normalized result.
+ */
+export async function runDuckdbQuery(connection, text, values) {
+    return withStatementContext(text, async () => {
+        const result = values && values.length > 0 ? await connection.run(text, values) : await connection.run(text);
+        try {
+            if (result.returnType !== ResultReturnType.QUERY_RESULT) {
+                // Plain INSERT/UPDATE/DELETE/DDL: no rows to read; rowsChanged is the
+                // affected count (0 for DDL).
+                return { rows: [], rowCount: result.rowsChanged };
+            }
+            const rows = normalizeDuckdbRows(await result.getRowObjectsJS());
+            return { rows, rowCount: rows.length };
+        }
+        finally {
+            // On DuckDB 2.0 an unread streaming result blocks its connection from
+            // starting another statement until closed; a materialized result we have
+            // fully read can be released eagerly to hand the buffers back.
+            result.closeSync();
+        }
+    });
+}
+/**
+ * Runs one query with caller values, coercing them on the way in.
+ *
+ * @param connection - The connection to run on.
+ * @param text - SQL with `$1, $2, …` or `?` placeholders.
+ * @param values - Parameter values as the caller passed them.
+ * @returns The normalized result.
+ */
+async function runWithValues(connection, text, values) {
+    return runDuckdbQuery(connection, text, values?.map(coerceDuckdbParam));
+}
+/**
+ * Creates a `DatabasePool` backed by DuckDB.
+ *
+ * The database opens on first use, not here, so creating a pool is free and
+ * synchronous. See {@link DuckdbConfig} for where the file lives and the
+ * resource defaults the instance gets.
+ *
+ * @param config - Database path, resource limits and wait timeout.
+ * @returns A pool over one DuckDB connection.
+ */
+export const createPool = (config) => {
+    const timeout = config?.acquireTimeoutMillis ?? DEFAULT_ACQUIRE_TIMEOUT_MS;
+    let opening = null;
+    let ended = false;
+    /**
+     * Opens the instance and its pooled connection once, on first use.
+     *
+     * @returns The instance handle and its connection.
+     */
+    const open = () => {
+        if (!opening) {
+            opening = (async () => {
+                const handle = await acquireInstance(config);
+                const connection = await handle.instance.connect();
+                getLogger().debug('DuckDB database opened', { path: handle.path });
+                return { handle, connection };
+            })();
+            // A failed open can be retried by the next call.
+            opening.catch((_error) => {
+                // The same rejection reaches the caller awaiting `opening`; resetting
+                // here only lets a later call try again.
+                opening = null;
+            });
+        }
+        return opening;
+    };
+    /**
+     * Rejects after `end()` — the connection is gone.
+     *
+     * @returns A rejected promise.
+     */
+    const refuseEnded = () => Promise.reject(new Error('DuckDB: this pool has been ended'));
+    // Transactions this pool opened: a `query()` made inside `withTransaction()`
+    // runs on the active one when it is ours.
+    const ownTransactions = new WeakSet();
+    const pool = {
+        async query(text, values) {
+            if (ended)
+                return refuseEnded();
+            const active = getActiveTransaction();
+            if (active && ownTransactions.has(active))
+                return active.query(text, values);
+            const { handle, connection } = await open();
+            const release = await handle.lock.acquire('query', timeout);
+            try {
+                return await runWithValues(connection, text, values);
+            }
+            finally {
+                release();
+            }
+        },
+        async connect() {
+            if (ended)
+                return refuseEnded();
+            const { handle, connection } = await open();
+            const release = await handle.lock.acquire('connect()', timeout);
+            let released = false;
+            return {
+                async query(text, values) {
+                    if (released)
+                        throw new Error('DuckDB: query on a released connection');
+                    return runWithValues(connection, text, values);
+                },
+                release() {
+                    released = true;
+                    release();
+                },
+            };
+        },
+        async transaction() {
+            if (ended)
+                return refuseEnded();
+            const { handle, connection } = await open();
+            // Hold the lock for the WHOLE transaction lifetime (BEGIN → … →
+            // COMMIT/ROLLBACK) — a concurrent transaction() or plain query() call
+            // queues behind this one instead of racing BEGIN or conflicting with it.
+            const release = await handle.lock.acquire('transaction()', timeout);
+            let done = false;
+            const finish = () => {
+                done = true;
+                release();
+            };
+            try {
+                await runDuckdbQuery(connection, 'BEGIN');
+            }
+            catch (error) {
+                finish();
+                throw error;
+            }
+            const tx = {
+                async query(text, values) {
+                    if (done)
+                        throw new Error('DuckDB: query on a finished transaction');
+                    // Already holds the lock — run directly, do NOT re-acquire.
+                    return runWithValues(connection, text, values);
+                },
+                release() {
+                    // Matches the pglite bond: returns the connection WITHOUT ending the
+                    // transaction. Roll back first so the connection is clean for the
+                    // next caller.
+                    if (done)
+                        return;
+                    done = true;
+                    runDuckdbQuery(connection, 'ROLLBACK')
+                        .catch((error) => {
+                        // Nothing awaits release(); surface the failure instead of hiding it.
+                        getLogger().error('DuckDB: rollback on transaction release() failed', { error });
+                    })
+                        .finally(release);
+                },
+                async commit() {
+                    if (done)
+                        return;
+                    try {
+                        await runDuckdbQuery(connection, 'COMMIT');
+                    }
+                    finally {
+                        finish();
+                    }
+                },
+                async rollback() {
+                    if (done)
+                        return;
+                    try {
+                        await runDuckdbQuery(connection, 'ROLLBACK');
+                    }
+                    finally {
+                        finish();
+                    }
+                },
+            };
+            ownTransactions.add(tx);
+            return tx;
+        },
+        async end() {
+            if (ended)
+                return;
+            ended = true;
+            if (!opening)
+                return;
+            const { handle, connection } = await opening;
+            // Let queued and open work finish before closing — but do not hang
+            // shutdown forever on a connection somebody never released.
+            let release;
+            try {
+                release = await handle.lock.acquire('end()', timeout);
+            }
+            catch (error) {
+                getLogger().warn('DuckDB: closing the pool while its connection is still held', { error });
+            }
+            try {
+                connection.disconnectSync();
+                releaseInstance(handle);
+            }
+            finally {
+                release?.();
+            }
+            getLogger().debug('DuckDB database closed', { path: handle.path });
+        },
+        stats() {
+            // This pool owns exactly one connection. Before first use the lock does
+            // not exist yet, and forcing a connection just to answer stats() would
+            // be wrong — report the idle pool; once open, waiting queries surface
+            // through the lock's timeout error instead.
+            return { total: 1, idle: 1, waiting: 0 };
+        },
+    };
+    return pool;
+};
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

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