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

package/dist/queue.d.ts

@@ -0,0 +1,48 @@
+/**
+ * FIFO lock over the pool's single DuckDB connection.
+ *
+ * @module
+ */
+/**
+ * Serializes every use of ONE DuckDB connection.
+ *
+ * All connections from one instance share one database, and DuckDB detects
+ * conflicting writes across connections of one instance as transaction
+ * conflicts — an interactive `BEGIN` … `COMMIT` interleaved with writes from
+ * another connection fails the transaction. So this pool uses ONE connection
+ * (the sqlite bond's model): plain `query()` calls hold it for one statement;
+ * `connect()` and `transaction()` hold it until they are released, so a
+ * transaction's `BEGIN` → … → `COMMIT`/`ROLLBACK` runs alone.
+ *
+ * Waiting is bounded: a waiter that cannot get the lock within its timeout is
+ * removed from the queue and rejected with an error naming the likely cause
+ * (code holding a connection while calling the pool), instead of hanging forever.
+ */
+export declare class ConnectionLock {
+    private locked;
+    private holder;
+    private waiters;
+    /**
+     * Number of callers currently waiting for the lock.
+     *
+     * @returns The queue length.
+     */
+    get waiting(): number;
+    /**
+     * Whether the lock is currently held.
+     *
+     * @returns `true` when held.
+     */
+    get isLocked(): boolean;
+    /**
+     * Waits for the lock in FIFO order. The returned release function MUST be
+     * called exactly once; extra calls are ignored.
+     *
+     * @param purpose - What the caller will do with the lock (`'query'`,
+     *   `'connect()'`, `'transaction()'`), used in the timeout message.
+     * @param timeoutMillis - Maximum wait; `0` or less waits forever.
+     * @returns A release function.
+     */
+    acquire(purpose: string, timeoutMillis: number): Promise<() => void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAmC;IAElD;;;;OAIG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;CAiDrE"}

package/dist/queue.js

@@ -0,0 +1,98 @@
+/**
+ * FIFO lock over the pool's single DuckDB connection.
+ *
+ * @module
+ */
+/**
+ * Serializes every use of ONE DuckDB connection.
+ *
+ * All connections from one instance share one database, and DuckDB detects
+ * conflicting writes across connections of one instance as transaction
+ * conflicts — an interactive `BEGIN` … `COMMIT` interleaved with writes from
+ * another connection fails the transaction. So this pool uses ONE connection
+ * (the sqlite bond's model): plain `query()` calls hold it for one statement;
+ * `connect()` and `transaction()` hold it until they are released, so a
+ * transaction's `BEGIN` → … → `COMMIT`/`ROLLBACK` runs alone.
+ *
+ * Waiting is bounded: a waiter that cannot get the lock within its timeout is
+ * removed from the queue and rejected with an error naming the likely cause
+ * (code holding a connection while calling the pool), instead of hanging forever.
+ */
+export class ConnectionLock {
+    locked = false;
+    holder = null;
+    waiters = [];
+    /**
+     * Number of callers currently waiting for the lock.
+     *
+     * @returns The queue length.
+     */
+    get waiting() {
+        return this.waiters.length;
+    }
+    /**
+     * Whether the lock is currently held.
+     *
+     * @returns `true` when held.
+     */
+    get isLocked() {
+        return this.locked;
+    }
+    /**
+     * Waits for the lock in FIFO order. The returned release function MUST be
+     * called exactly once; extra calls are ignored.
+     *
+     * @param purpose - What the caller will do with the lock (`'query'`,
+     *   `'connect()'`, `'transaction()'`), used in the timeout message.
+     * @param timeoutMillis - Maximum wait; `0` or less waits forever.
+     * @returns A release function.
+     */
+    acquire(purpose, timeoutMillis) {
+        let released = false;
+        const release = () => {
+            if (released)
+                return;
+            released = true;
+            this.holder = null;
+            const next = this.waiters.shift();
+            if (next) {
+                next.grant();
+            }
+            else {
+                this.locked = false;
+            }
+        };
+        if (!this.locked) {
+            this.locked = true;
+            this.holder = purpose;
+            return Promise.resolve(release);
+        }
+        return new Promise((resolve, reject) => {
+            let timer;
+            const waiter = {
+                grant: () => {
+                    if (timer !== undefined)
+                        clearTimeout(timer);
+                    this.locked = true;
+                    this.holder = purpose;
+                    resolve(release);
+                },
+            };
+            this.waiters.push(waiter);
+            if (timeoutMillis > 0) {
+                timer = setTimeout(() => {
+                    const index = this.waiters.indexOf(waiter);
+                    if (index === -1)
+                        return;
+                    this.waiters.splice(index, 1);
+                    reject(new Error(`DuckDB: a ${purpose} waited ${timeoutMillis} ms for the pool's single ` +
+                        `connection, which is held by an open ${this.holder ?? 'operation'}. This pool ` +
+                        `serializes everything on one connection: release() a connect()ed connection and ` +
+                        `commit()/rollback() a transaction before calling the pool or the store again, and ` +
+                        `run every statement of a transaction on its own query().`));
+                }, timeoutMillis);
+            }
+        });
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,GAAG,KAAK,CAAA;IACd,MAAM,GAAkB,IAAI,CAAA;IAC5B,OAAO,GAAiC,EAAE,CAAA;IAElD;;;;OAIG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED;;;;OAIG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAe,EAAE,aAAqB;QAC5C,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;YACjC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,KAAK,EAAE,CAAA;YACd,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;YACrB,CAAC;QACH,CAAC,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAA;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACjC,CAAC;QAED,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACjD,IAAI,KAAgD,CAAA;YACpD,MAAM,MAAM,GAAG;gBACb,KAAK,EAAE,GAAS,EAAE;oBAChB,IAAI,KAAK,KAAK,SAAS;wBAAE,YAAY,CAAC,KAAK,CAAC,CAAA;oBAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;oBAClB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAA;oBACrB,OAAO,CAAC,OAAO,CAAC,CAAA;gBAClB,CAAC;aACF,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACzB,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;oBAC1C,IAAI,KAAK,KAAK,CAAC,CAAC;wBAAE,OAAM;oBACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;oBAC7B,MAAM,CACJ,IAAI,KAAK,CACP,aAAa,OAAO,WAAW,aAAa,4BAA4B;wBACtE,wCAAwC,IAAI,CAAC,MAAM,IAAI,WAAW,cAAc;wBAChF,kFAAkF;wBAClF,oFAAoF;wBACpF,0DAA0D,CAC7D,CACF,CAAA;gBACH,CAAC,EAAE,aAAa,CAAC,CAAA;YACnB,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/secrets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DuckDB secret definitions — self-registered at import time so the
+ * runtime secrets registry (`@molecule/api-secrets`) can drive boot-time
+ * configuration reports and actionable "not configured" errors.
+ *
+ * Content is derived MECHANICALLY from this package's mlcl registry secrets
+ * entry (label/instructions/setupUrl/example) via the fleet formula, so
+ * packages sharing a key register byte-identical definitions and
+ * registration order never matters.
+ *
+ * @module
+ */
+import type { SecretDefinition } from '@molecule/api-secrets';
+/** Secret definitions required by the DuckDB database bond. */
+export declare const databaseDuckdbSecretDefinitions: SecretDefinition[];
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B,EAAE,gBAAgB,EAS7D,CAAA"}

package/dist/secrets.js

@@ -0,0 +1,25 @@
+/**
+ * DuckDB secret definitions — self-registered at import time so the
+ * runtime secrets registry (`@molecule/api-secrets`) can drive boot-time
+ * configuration reports and actionable "not configured" errors.
+ *
+ * Content is derived MECHANICALLY from this package's mlcl registry secrets
+ * entry (label/instructions/setupUrl/example) via the fleet formula, so
+ * packages sharing a key register byte-identical definitions and
+ * registration order never matters.
+ *
+ * @module
+ */
+import { registerSecrets } from '@molecule/api-secrets';
+/** Secret definitions required by the DuckDB database bond. */
+export const databaseDuckdbSecretDefinitions = [
+    {
+        key: 'DUCKDB_PATH',
+        description: 'DuckDB database path — Filesystem path of the DuckDB database file (created on first run), or :memory:.',
+        required: false,
+        example: './data/app.duckdb',
+        default: './data/app.duckdb',
+    },
+];
+registerSecrets(databaseDuckdbSecretDefinitions);
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,+BAA+B,GAAuB;IACjE;QACE,GAAG,EAAE,aAAa;QAClB,WAAW,EACT,yGAAyG;QAC3G,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,mBAAmB;KAC7B;CACF,CAAA;AAED,eAAe,CAAC,+BAA+B,CAAC,CAAA"}

package/dist/sql-dialect.d.ts

@@ -0,0 +1,92 @@
+/**
+ * The slice of SQL lexing and DDL parsing this bond needs to translate, or
+ * refuse, PostgreSQL-dialect migrations without changing their behaviour.
+ *
+ * It lives in the bond because it IS the bond's translation responsibility: a
+ * provider that cannot accept a construct as written has to read the statement
+ * well enough to rewrite it faithfully or to refuse it. It is deliberately not a
+ * general requirement analyser — that decision (which constructs a selection
+ * needs, and whether the selected provider can honour them) is compilation work
+ * and lives in `mlcl/src/lib/sql-requirements.ts`, shared by every harness.
+ *
+ * The rules preserved from that shared analysis: a semicolon ends a statement
+ * only outside a string literal, a quoted identifier, a dollar-quoted body and a
+ * comment; keywords are matched against a mask that blanks comment and literal
+ * CONTENT while keeping every offset, so slicing the mask addresses the same
+ * characters in the original; and a construct written inside a comment or a
+ * string is never mistaken for a real one.
+ *
+ * @module
+ */
+/** One SQL statement located in a migration file. */
+export interface SqlStatement {
+    /** Statement text, including its trailing semicolon when it has one. */
+    text: string;
+    /** 0-based offset of the statement's first character in the source. */
+    start: number;
+    /** 0-based offset just past the statement's last character. */
+    end: number;
+}
+/** A `CREATE INDEX` statement split into the parts the translator rewrites. */
+export interface ParsedCreateIndex {
+    /** Whether the statement declares a UNIQUE index. */
+    unique: boolean;
+    /** Statement text through the opening parenthesis, with any `USING <method>` removed. */
+    prefix: string;
+    /** The original column-list text between the outer parentheses. */
+    columns: string;
+    /** The original text after the closing parenthesis (contains the `WHERE` clause when partial). */
+    afterClose: string;
+    /** The predicate after `WHERE`, or `null` for a non-partial index. */
+    predicate: string | null;
+    /** The original text after the predicate (normally `;`), or `null` for a non-partial index. */
+    afterPredicate: string | null;
+    /** Any index options between the closing parenthesis and `WHERE` (`WITH`, `INCLUDE`), trimmed. */
+    optionsBeforeWhere: string;
+}
+/**
+ * Split a migration file into statements, keeping each statement's exact text
+ * and offsets.
+ *
+ * A semicolon ends a statement only outside a single-quoted string, a
+ * double-quoted identifier, a dollar-quoted body, a line comment and a block
+ * comment. The returned text includes the trailing semicolon; concatenating
+ * every `text` reproduces the input byte for byte.
+ *
+ * @param sql - The migration file's SQL.
+ * @returns The statements in source order.
+ */
+export declare const splitSqlStatements: (sql: string) => SqlStatement[];
+/**
+ * Split a column list at its top-level commas.
+ *
+ * A comma inside a function call (`lower(a, b)`) or a string literal does not
+ * split — the same masking the statement splitter uses keeps offsets aligned.
+ *
+ * @param columns - Text between a `CREATE INDEX` statement's outer parentheses.
+ * @returns Each column/expression text, trimmed.
+ */
+export declare const splitSqlColumns: (columns: string) => string[];
+/**
+ * Parse a `CREATE [UNIQUE] INDEX` statement into the parts this bond rewrites.
+ *
+ * Returns `null` for any other statement. The returned slices are taken from the
+ * ORIGINAL text, so a translator can rebuild the statement without losing the
+ * author's casing or quoting.
+ *
+ * @param statement - One statement from {@link splitSqlStatements}.
+ * @returns The parsed index, or `null` when the statement is not a `CREATE INDEX`.
+ */
+export declare const parseCreateIndexStatement: (statement: string) => ParsedCreateIndex | null;
+/**
+ * Every unsupported foreign-key referential action in one statement, in source
+ * order and normalized (`ON DELETE CASCADE`).
+ *
+ * A construct inside a comment or a string literal is ignored: those carry no
+ * constraint. `NO ACTION` and `RESTRICT` do not match — DuckDB accepts them.
+ *
+ * @param statement - One statement from {@link splitSqlStatements}.
+ * @returns The normalized actions, e.g. `['ON DELETE CASCADE']`.
+ */
+export declare const referentialActionsIn: (statement: string) => string[];
+//# sourceMappingURL=sql-dialect.d.ts.map

package/dist/sql-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-dialect.d.ts","sourceRoot":"","sources":["../src/sql-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAA;IACf,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+FAA+F;IAC/F,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,kGAAkG;IAClG,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAeD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,YAAY,EAwE5D,CAAA;AA6FD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,MAAM,EAgBvD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAI,WAAW,MAAM,KAAG,iBAAiB,GAAG,IAyCjF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,KAAG,MAAM,EAW9D,CAAA"}

package/dist/sql-dialect.js

@@ -0,0 +1,309 @@
+/**
+ * The slice of SQL lexing and DDL parsing this bond needs to translate, or
+ * refuse, PostgreSQL-dialect migrations without changing their behaviour.
+ *
+ * It lives in the bond because it IS the bond's translation responsibility: a
+ * provider that cannot accept a construct as written has to read the statement
+ * well enough to rewrite it faithfully or to refuse it. It is deliberately not a
+ * general requirement analyser — that decision (which constructs a selection
+ * needs, and whether the selected provider can honour them) is compilation work
+ * and lives in `mlcl/src/lib/sql-requirements.ts`, shared by every harness.
+ *
+ * The rules preserved from that shared analysis: a semicolon ends a statement
+ * only outside a string literal, a quoted identifier, a dollar-quoted body and a
+ * comment; keywords are matched against a mask that blanks comment and literal
+ * CONTENT while keeping every offset, so slicing the mask addresses the same
+ * characters in the original; and a construct written inside a comment or a
+ * string is never mistaken for a real one.
+ *
+ * @module
+ */
+/** A dollar-quote opener: `$$` or `$tag$`. */
+const DOLLAR_QUOTE = /^\$([A-Za-z_][A-Za-z0-9_]*)?\$/;
+/** `CREATE [UNIQUE] INDEX [IF NOT EXISTS] <name> ON <table>` up to the next token. */
+const CREATE_INDEX_HEAD = /^\s*CREATE\s+(UNIQUE\s+)?INDEX\s+(?:IF\s+NOT\s+EXISTS\s+)?(?:"(?:[^"]|"")*"|[A-Za-z_][\w$-]*)\s+ON\s+(?:"(?:[^"]|"")*"|[A-Za-z_][\w$.-]*)\s*/i;
+/** `USING <method>` — an index access method, which DuckDB has no equivalent for. */
+const USING_METHOD = /^USING\s+([A-Za-z_][A-Za-z0-9_]*)\s*/i;
+/** An unsupported foreign-key referential action. */
+const FK_REFERENTIAL_ACTION = /\bON\s+(DELETE|UPDATE)\s+(CASCADE|SET\s+NULL|SET\s+DEFAULT)\b/gi;
+/**
+ * Split a migration file into statements, keeping each statement's exact text
+ * and offsets.
+ *
+ * A semicolon ends a statement only outside a single-quoted string, a
+ * double-quoted identifier, a dollar-quoted body, a line comment and a block
+ * comment. The returned text includes the trailing semicolon; concatenating
+ * every `text` reproduces the input byte for byte.
+ *
+ * @param sql - The migration file's SQL.
+ * @returns The statements in source order.
+ */
+export const splitSqlStatements = (sql) => {
+    const statements = [];
+    let start = 0;
+    let index = 0;
+    const length = sql.length;
+    while (index < length) {
+        const char = sql[index];
+        if (char === '-' && sql[index + 1] === '-') {
+            const newline = sql.indexOf('\n', index);
+            index = newline < 0 ? length : newline;
+            continue;
+        }
+        if (char === '/' && sql[index + 1] === '*') {
+            const close = sql.indexOf('*/', index + 2);
+            index = close < 0 ? length : close + 2;
+            continue;
+        }
+        if (char === "'") {
+            index++;
+            while (index < length) {
+                if (sql[index] === '\\') {
+                    index += 2;
+                    continue;
+                }
+                if (sql[index] === "'" && sql[index + 1] === "'") {
+                    index += 2;
+                    continue;
+                }
+                if (sql[index] === "'") {
+                    index++;
+                    break;
+                }
+                index++;
+            }
+            continue;
+        }
+        if (char === '"') {
+            index++;
+            while (index < length) {
+                if (sql[index] === '"' && sql[index + 1] === '"') {
+                    index += 2;
+                    continue;
+                }
+                if (sql[index] === '"') {
+                    index++;
+                    break;
+                }
+                index++;
+            }
+            continue;
+        }
+        if (char === '$') {
+            const opener = DOLLAR_QUOTE.exec(sql.slice(index));
+            if (opener) {
+                const tag = opener[0];
+                const close = sql.indexOf(tag, index + tag.length);
+                index = close < 0 ? length : close + tag.length;
+                continue;
+            }
+        }
+        if (char === ';') {
+            index++;
+            statements.push({ text: sql.slice(start, index), start, end: index });
+            start = index;
+            continue;
+        }
+        index++;
+    }
+    if (start < length) {
+        statements.push({ text: sql.slice(start, length), start, end: length });
+    }
+    return statements;
+};
+/**
+ * Replace comment and string-literal CONTENT with spaces, keeping every offset
+ * (and every double-quoted identifier) in place.
+ *
+ * Keyword and parenthesis scanning then cannot be fooled by text inside a
+ * comment or a literal, while a slice taken from the mask still addresses the
+ * same characters in the original.
+ *
+ * @param text - The SQL text to mask.
+ * @returns A same-length string safe for structural scanning.
+ */
+const maskSql = (text) => {
+    let masked = '';
+    let index = 0;
+    const length = text.length;
+    while (index < length) {
+        const char = text[index];
+        if (char === '-' && text[index + 1] === '-') {
+            while (index < length && text[index] !== '\n') {
+                masked += ' ';
+                index++;
+            }
+            continue;
+        }
+        if (char === '/' && text[index + 1] === '*') {
+            const close = text.indexOf('*/', index + 2);
+            const end = close < 0 ? length : close + 2;
+            masked += ' '.repeat(end - index);
+            index = end;
+            continue;
+        }
+        if (char === "'") {
+            masked += ' ';
+            index++;
+            while (index < length) {
+                if (text[index] === '\\') {
+                    masked += '  ';
+                    index += 2;
+                    continue;
+                }
+                if (text[index] === "'" && text[index + 1] === "'") {
+                    masked += '  ';
+                    index += 2;
+                    continue;
+                }
+                if (text[index] === "'") {
+                    masked += ' ';
+                    index++;
+                    break;
+                }
+                masked += ' ';
+                index++;
+            }
+            continue;
+        }
+        if (char === '$') {
+            const opener = DOLLAR_QUOTE.exec(text.slice(index));
+            if (opener) {
+                const tag = opener[0];
+                const close = text.indexOf(tag, index + tag.length);
+                const end = close < 0 ? length : close + tag.length;
+                masked += ' '.repeat(end - index);
+                index = end;
+                continue;
+            }
+        }
+        masked += char;
+        index++;
+    }
+    return masked;
+};
+/**
+ * Index of the parenthesis matching the one at `openAt`, or -1 when unbalanced.
+ *
+ * @param masked - Masked SQL, same length as the original.
+ * @param openAt - Offset of an opening parenthesis.
+ * @returns Offset of its match, or -1.
+ */
+const matchingParen = (masked, openAt) => {
+    let depth = 0;
+    for (let index = openAt; index < masked.length; index++) {
+        if (masked[index] === '(')
+            depth++;
+        else if (masked[index] === ')') {
+            depth--;
+            if (depth === 0)
+                return index;
+        }
+    }
+    return -1;
+};
+/**
+ * Split a column list at its top-level commas.
+ *
+ * A comma inside a function call (`lower(a, b)`) or a string literal does not
+ * split — the same masking the statement splitter uses keeps offsets aligned.
+ *
+ * @param columns - Text between a `CREATE INDEX` statement's outer parentheses.
+ * @returns Each column/expression text, trimmed.
+ */
+export const splitSqlColumns = (columns) => {
+    const masked = maskSql(columns);
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let index = 0; index < masked.length; index++) {
+        const char = masked[index];
+        if (char === '(')
+            depth++;
+        else if (char === ')')
+            depth--;
+        else if (char === ',' && depth === 0) {
+            parts.push(columns.slice(start, index).trim());
+            start = index + 1;
+        }
+    }
+    parts.push(columns.slice(start).trim());
+    return parts.filter((part) => part.length > 0);
+};
+/**
+ * Parse a `CREATE [UNIQUE] INDEX` statement into the parts this bond rewrites.
+ *
+ * Returns `null` for any other statement. The returned slices are taken from the
+ * ORIGINAL text, so a translator can rebuild the statement without losing the
+ * author's casing or quoting.
+ *
+ * @param statement - One statement from {@link splitSqlStatements}.
+ * @returns The parsed index, or `null` when the statement is not a `CREATE INDEX`.
+ */
+export const parseCreateIndexStatement = (statement) => {
+    const masked = maskSql(statement);
+    const head = CREATE_INDEX_HEAD.exec(masked);
+    if (!head)
+        return null;
+    let cursor = head[0].length;
+    const using = USING_METHOD.exec(masked.slice(cursor));
+    const usingEnd = using ? cursor + using[0].length : cursor;
+    cursor = usingEnd;
+    if (masked[cursor] !== '(')
+        return null;
+    const closeAt = matchingParen(masked, cursor);
+    if (closeAt < 0)
+        return null;
+    const beforeParen = using ? statement.slice(0, head[0].length) : statement.slice(0, cursor);
+    const prefix = `${beforeParen}(`;
+    const columns = statement.slice(cursor + 1, closeAt);
+    const afterClose = statement.slice(closeAt + 1);
+    const maskedAfterClose = masked.slice(closeAt + 1);
+    const whereMatch = /\bWHERE\b/i.exec(maskedAfterClose);
+    if (!whereMatch) {
+        return {
+            unique: Boolean(head[1]),
+            prefix,
+            columns,
+            afterClose,
+            predicate: null,
+            afterPredicate: null,
+            optionsBeforeWhere: '',
+        };
+    }
+    const predicateStart = closeAt + 1 + whereMatch.index + whereMatch[0].length;
+    const trailingSemicolon = /;\s*$/.exec(statement);
+    const predicateEnd = trailingSemicolon ? trailingSemicolon.index : statement.length;
+    return {
+        unique: Boolean(head[1]),
+        prefix,
+        columns,
+        afterClose,
+        predicate: statement.slice(predicateStart, predicateEnd).trim(),
+        afterPredicate: statement.slice(predicateEnd),
+        optionsBeforeWhere: statement.slice(closeAt + 1, predicateStart - whereMatch[0].length).trim(),
+    };
+};
+/**
+ * Every unsupported foreign-key referential action in one statement, in source
+ * order and normalized (`ON DELETE CASCADE`).
+ *
+ * A construct inside a comment or a string literal is ignored: those carry no
+ * constraint. `NO ACTION` and `RESTRICT` do not match — DuckDB accepts them.
+ *
+ * @param statement - One statement from {@link splitSqlStatements}.
+ * @returns The normalized actions, e.g. `['ON DELETE CASCADE']`.
+ */
+export const referentialActionsIn = (statement) => {
+    const masked = maskSql(statement);
+    const actions = [];
+    const action = new RegExp(FK_REFERENTIAL_ACTION.source, 'gi');
+    let match;
+    while ((match = action.exec(masked))) {
+        const event = match[1] ?? '';
+        const what = (match[2] ?? '').replace(/\s+/g, ' ').toUpperCase();
+        actions.push(`ON ${event.toUpperCase()} ${what}`);
+    }
+    return actions;
+};
+//# sourceMappingURL=sql-dialect.js.map

package/dist/sql-dialect.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,18 @@
+/**
+ * DuckDB DataStore implementation.
+ *
+ * Translates abstract DataStore CRUD methods to DuckDB SQL. DuckDB binds `?`
+ * and `$1` placeholders natively positionally, so the SQL built here needs no
+ * conversion on its way to the engine.
+ *
+ * @module
+ */
+import type { DatabasePool, DataStore } from '@molecule/api-database';
+/**
+ * Creates a DataStore backed by a DuckDB DatabasePool.
+ *
+ * @param pool - The DuckDB DatabasePool to use for queries.
+ * @returns A DataStore that translates CRUD operations to DuckDB-compatible SQL.
+ */
+export declare function createStore(pool: DatabasePool): DataStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EAIV,MAAM,wBAAwB,CAAA;AA6J/B;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAsPzD"}