@quereus/quereus 0.13.1 → 0.14.0

package/dist/src/core/database.d.ts

@@ -28,7 +28,7 @@ export declare class Database {
     private isAutocommit;
     private inTransaction;
     private activeConnections;
-    private inImplicitTransaction;
+    private inImplicit;
     readonly optimizer: Optimizer;
     readonly options: DatabaseOptionsManager;
     private instructionTracer;
@@ -38,6 +38,12 @@ export declare class Database {
     private changeLogLayers;
     /** Deferred constraint evaluation queue */
     private readonly deferredConstraints;
+    /**
+     * Mutex for serializing statement execution.
+     * This prevents concurrent statements from interfering with each other's
+     * transaction state, matching SQLite's behavior of serializing writes.
+     */
+    private execMutex;
     constructor();
     /**
      * Prepares an SQL statement for execution.
@@ -65,12 +71,34 @@ export declare class Database {
     prepare(sql: string, paramsOrTypes?: SqlParameters | SqlValue[] | Map<string | number, ScalarType>): Statement;
     /**
      * Executes a query and returns the first result row as an object.
+     * The execution is serialized through the mutex and wrapped in an implicit
+     * transaction when in autocommit mode.
+     *
      * @param sql The SQL query string to execute.
      * @param params Optional parameters to bind.
      * @returns A Promise resolving to the first result row as an object, or undefined if no rows.
      * @throws QuereusError on failure.
      */
     get(sql: string, params?: SqlParameters | SqlValue[]): Promise<Record<string, SqlValue> | undefined>;
+    /**
+     * Parses SQL into a statement batch.
+     */
+    private _parseSql;
+    /**
+     * Determines if a statement batch contains explicit transaction control.
+     */
+    private _hasExplicitTransactionControl;
+    /**
+     * Executes one or more SQL statements directly.
+     * Statements are serialized through the execution mutex and wrapped in an
+     * implicit transaction when in autocommit mode (unless they contain explicit
+     * transaction control statements).
+     *
+     * @param sql The SQL string(s) to execute.
+     * @param params Optional parameters to bind.
+     * @returns A Promise resolving when execution completes.
+     * @throws QuereusError on failure.
+     */
     exec(sql: string, params?: SqlParameters): Promise<void>;
     /**
      * Registers a virtual table module.
@@ -266,6 +294,10 @@ export declare class Database {
      * The underlying statement is automatically finalized when iteration completes
      * or if an error occurs.
      *
+     * The execution is serialized through the mutex and wrapped in an implicit
+     * transaction when in autocommit mode. The mutex is held for the entire
+     * iteration to ensure transactional consistency.
+     *
      * @param sql The SQL query string to execute.
      * @param params Optional parameters to bind (array for positional, object for named).
      * @yields Each result row as an object (`Record<string, SqlValue>`).

package/dist/src/core/database.d.ts.map

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

package/dist/src/core/database.js

@@ -30,6 +30,7 @@ import { DeclaredSchemaManager } from '../schema/declared-schema-manager.js';
 import { analyzeRowSpecific } from '../planner/analysis/constraint-extractor.js';
 import { DeferredConstraintQueue } from '../runtime/deferred-constraint-queue.js';
 import { getParameterTypes } from './param.js';
+import { rowToObject } from './utils.js';
 const log = createLogger('core:database');
 const warnLog = log.extend('warn');
 const errorLog = log.extend('error');
@@ -46,7 +47,7 @@ export class Database {
     isAutocommit = true; // Manages transaction state
     inTransaction = false;
     activeConnections = new Map();
-    inImplicitTransaction = false; // Track if we're in an implicit transaction
+    inImplicit = false; // Track if we're in an implicit transaction
     optimizer;
     options;
     instructionTracer;
@@ -56,6 +57,12 @@ export class Database {
     changeLogLayers = [];
     /** Deferred constraint evaluation queue */
     deferredConstraints = new DeferredConstraintQueue(this);
+    /**
+     * Mutex for serializing statement execution.
+     * This prevents concurrent statements from interfering with each other's
+     * transaction state, matching SQLite's behavior of serializing writes.
+     */
+    execMutex = Promise.resolve();
     constructor() {
         this.schemaManager = new SchemaManager(this);
         this.declaredSchemaManager = new DeclaredSchemaManager();
@@ -205,14 +212,23 @@ export class Database {
     }
     /**
      * Executes a query and returns the first result row as an object.
+     * The execution is serialized through the mutex and wrapped in an implicit
+     * transaction when in autocommit mode.
+     *
      * @param sql The SQL query string to execute.
      * @param params Optional parameters to bind.
      * @returns A Promise resolving to the first result row as an object, or undefined if no rows.
      * @throws QuereusError on failure.
      */
-    get(sql, params) {
+    async get(sql, params) {
+        this.checkOpen();
         const stmt = this.prepare(sql, params);
-        return stmt.get(params);
+        try {
+            return await stmt.get(params);
+        }
+        finally {
+            await stmt.finalize();
+        }
     }
     /**
      * Executes one or more SQL statements directly.
@@ -221,12 +237,78 @@ export class Database {
      * @returns A Promise resolving when execution completes.
      * @throws QuereusError on failure.
      */
+    // ============================================================================
+    // Statement Execution - Core Infrastructure
+    // ============================================================================
+    /**
+     * Acquires the execution mutex and returns a release function.
+     * All statement execution is serialized through this mutex to prevent
+     * concurrent transactions from interfering with each other.
+     * This matches SQLite's behavior of serializing database access.
+     * @internal
+     */
+    async _acquireExecMutex() {
+        const previousMutex = this.execMutex;
+        let releaseMutex;
+        this.execMutex = new Promise(resolve => {
+            releaseMutex = resolve;
+        });
+        await previousMutex;
+        return releaseMutex;
+    }
+    /**
+     * Unified execution wrapper that handles mutex acquisition and implicit transactions.
+     * All public execution methods should use this to ensure consistent behavior.
+     * @internal
+     */
+    async _executeWithProtection(options, executor) {
+        let releaseMutex;
+        try {
+            // Acquire mutex if requested
+            if (options.acquireMutex) {
+                releaseMutex = await this._acquireExecMutex();
+            }
+            // Determine if we need an implicit transaction
+            const needsImplicit = options.manageTransaction && this.isAutocommit;
+            let executionError = null;
+            let result;
+            try {
+                if (needsImplicit) {
+                    await this._beginImplicit();
+                }
+                try {
+                    result = await executor();
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    executionError = error instanceof QuereusError ? error : new QuereusError(error.message, StatusCode.ERROR, error);
+                    throw executionError;
+                }
+            }
+            finally {
+                if (needsImplicit) {
+                    if (executionError) {
+                        await this._rollbackImplicit();
+                    }
+                    else {
+                        await this._commitImplicit();
+                    }
+                }
+            }
+            return result;
+        }
+        finally {
+            if (releaseMutex) {
+                releaseMutex();
+            }
+        }
+    }
     /**
      * @internal
-     * Executes a single AST statement without transaction management.
-     * Used by both exec() and eval() to avoid code duplication.
+     * Executes a single AST statement. Does not manage mutex or transactions.
+     * Used as the innermost execution primitive.
      */
-    async _executeStatement(statementAst, params) {
+    async _executeSingleStatement(statementAst, params) {
         const plan = this._buildPlan([statementAst], params);
         if (plan.statements.length === 0)
             return; // No-op for this AST
@@ -245,54 +327,81 @@ export class Database {
         };
         await scheduler.run(runtimeCtx);
     }
-    async exec(sql, params) {
-        this.checkOpen();
-        log('Executing SQL block (new runtime): %s', sql);
+    /**
+     * @internal
+     * Executes a batch of AST statements sequentially.
+     * Does not manage mutex or transactions - caller must handle that.
+     */
+    async _executeStatementBatch(batch, params) {
+        for (const statementAst of batch) {
+            await this._executeSingleStatement(statementAst, params);
+        }
+    }
+    /**
+     * Parses SQL into a statement batch.
+     */
+    _parseSql(sql) {
         const parser = new Parser();
-        let batch;
         try {
-            batch = parser.parseAll(sql);
+            return parser.parseAll(sql);
         }
         catch (e) {
             if (e instanceof ParseError)
                 throw new QuereusError(`Parse error: ${e.message}`, StatusCode.ERROR, e);
             throw e;
         }
+    }
+    /**
+     * Determines if a statement batch contains explicit transaction control.
+     */
+    _hasExplicitTransactionControl(batch) {
+        return batch.some(ast => ast.type === 'begin' || ast.type === 'commit' || ast.type === 'rollback' || ast.type === 'savepoint' || ast.type === 'release');
+    }
+    // ============================================================================
+    // Statement Execution - Public API
+    // ============================================================================
+    /**
+     * Executes one or more SQL statements directly.
+     * Statements are serialized through the execution mutex and wrapped in an
+     * implicit transaction when in autocommit mode (unless they contain explicit
+     * transaction control statements).
+     *
+     * @param sql The SQL string(s) to execute.
+     * @param params Optional parameters to bind.
+     * @returns A Promise resolving when execution completes.
+     * @throws QuereusError on failure.
+     */
+    async exec(sql, params) {
+        this.checkOpen();
+        log('Executing SQL block: %s', sql);
+        const batch = this._parseSql(sql);
         if (batch.length === 0)
             return;
-        const needsImplicitTransaction = batch.length >= 1
-            && this.isAutocommit
-            // has explicit transaction
-            && !batch.some(ast => ast.type === 'begin' || ast.type === 'commit' || ast.type === 'rollback' || ast.type === 'savepoint' || ast.type === 'release');
-        let executionError = null;
-        try {
-            if (needsImplicitTransaction) {
-                await this._beginImplicitTransaction();
-            }
-            for (let i = 0; i < batch.length; i++) {
-                try {
-                    await this._executeStatement(batch[i], params);
-                }
-                catch (err) {
-                    const error = err instanceof Error ? err : new Error(String(err));
-                    executionError = error instanceof QuereusError ? error : new QuereusError(error.message, StatusCode.ERROR, error);
-                    break; // Stop processing further statements on error
-                }
-            }
-        }
-        finally {
-            if (needsImplicitTransaction) {
-                if (executionError) {
-                    await this._rollbackImplicitTransaction();
-                }
-                else {
-                    await this._commitImplicitTransaction();
-                }
-            }
-        }
-        if (executionError) {
-            throw executionError;
-        }
+        // Don't wrap in implicit transaction if batch has explicit transaction control
+        const hasExplicitTxn = this._hasExplicitTransactionControl(batch);
+        await this._executeWithProtection({ acquireMutex: true, manageTransaction: !hasExplicitTxn }, () => this._executeStatementBatch(batch, params));
+    }
+    /**
+     * Execute SQL without acquiring the mutex.
+     * Used by runtime code (e.g., APPLY SCHEMA) that needs to execute
+     * nested SQL statements while already holding the mutex.
+     * @internal
+     */
+    async _execWithinTransaction(sql, params) {
+        log('Executing nested SQL: %s', sql);
+        const batch = this._parseSql(sql);
+        if (batch.length === 0)
+            return;
+        // No mutex, no implicit transaction - we're already inside one
+        await this._executeWithProtection({ acquireMutex: false, manageTransaction: false }, () => this._executeStatementBatch(batch, params));
+    }
+    /**
+     * Execute a function with mutex and optional implicit transaction management.
+     * This is exposed for Statement to use, avoiding code duplication.
+     * @internal
+     */
+    async _runWithProtection(acquireMutex, manageTransaction, executor) {
+        return this._executeWithProtection({ acquireMutex, manageTransaction }, executor);
     }
     /**
      * Registers a virtual table module.
@@ -717,6 +826,10 @@ export class Database {
      * The underlying statement is automatically finalized when iteration completes
      * or if an error occurs.
      *
+     * The execution is serialized through the mutex and wrapped in an implicit
+     * transaction when in autocommit mode. The mutex is held for the entire
+     * iteration to ensure transactional consistency.
+     *
      * @param sql The SQL query string to execute.
      * @param params Optional parameters to bind (array for positional, object for named).
      * @yields Each result row as an object (`Record<string, SqlValue>`).
@@ -737,8 +850,17 @@ export class Database {
      */
     async *eval(sql, params) {
         this.checkOpen();
+        // Acquire mutex for the entire iteration
+        const releaseMutex = await this._acquireExecMutex();
+        // Determine if we need implicit transaction
+        const needsImplicit = this.isAutocommit;
+        let transactionStarted = false;
         let stmt = null;
         try {
+            if (needsImplicit) {
+                await this._beginImplicit();
+                transactionStarted = true;
+            }
             stmt = this.prepare(sql);
             if (stmt.astBatch.length === 0) {
                 // No statements, yield nothing.
@@ -747,17 +869,19 @@ export class Database {
             if (stmt.astBatch.length > 1) {
                 // Multi-statement batch: execute all but the last statement,
                 // then yield results from the last statement
-                const parser = new Parser();
-                const batch = parser.parseAll(sql);
+                const batch = this._parseSql(sql);
                 // Execute all statements except the last one
                 for (let i = 0; i < batch.length - 1; i++) {
-                    await this._executeStatement(batch[i], params);
+                    await this._executeSingleStatement(batch[i], params);
                 }
                 // Now prepare and execute the last statement to yield its results
                 const lastStmt = new Statement(this, [batch[batch.length - 1]]);
                 this.statements.add(lastStmt);
                 try {
-                    yield* lastStmt.all(params);
+                    const names = lastStmt.getColumnNames();
+                    for await (const row of lastStmt.iterateRows(params)) {
+                        yield rowToObject(row, names);
+                    }
                 }
                 finally {
                     await lastStmt.finalize();
@@ -765,13 +889,34 @@ export class Database {
             }
             else {
                 // Single statement: execute and yield results
-                yield* stmt.all(params);
+                const names = stmt.getColumnNames();
+                for await (const row of stmt.iterateRows(params)) {
+                    yield rowToObject(row, names);
+                }
+            }
+            // Commit implicit transaction on successful completion
+            if (transactionStarted) {
+                await this._commitImplicit();
+                transactionStarted = false;
             }
         }
+        catch (err) {
+            // Rollback on error
+            if (transactionStarted) {
+                await this._rollbackImplicit();
+                transactionStarted = false;
+            }
+            throw err;
+        }
         finally {
             if (stmt) {
                 await stmt.finalize();
             }
+            // If we somehow exit without committing/rolling back, rollback
+            if (transactionStarted) {
+                await this._rollbackImplicit();
+            }
+            releaseMutex();
         }
     }
     getPlan(sqlOrAst) {
@@ -909,7 +1054,7 @@ export class Database {
         const connection = this.activeConnections.get(connectionId);
         if (connection) {
             // Don't disconnect during implicit transactions - let the transaction coordinate
-            if (this.inImplicitTransaction) {
+            if (this.inImplicit) {
                 debugLog(`Deferring disconnect of connection ${connectionId} until implicit transaction completes`);
                 return;
             }
@@ -972,9 +1117,9 @@ export class Database {
      * Begin an implicit transaction and coordinate with virtual table connections
      */
     /** @internal Begin an implicit transaction */
-    async _beginImplicitTransaction() {
+    async _beginImplicit() {
         debugLog("Database: Starting implicit transaction for multi-statement block.");
-        this.inImplicitTransaction = true;
+        this.inImplicit = true;
         // Begin transaction on all active connections first
         const connections = this.getAllConnections();
         for (const connection of connections) {
@@ -994,7 +1139,7 @@ export class Database {
      * Commit an implicit transaction and coordinate with virtual table connections
      * @internal
      */
-    async _commitImplicitTransaction() {
+    async _commitImplicit() {
         debugLog("Database: Committing implicit transaction.");
         try {
             const connectionsToCommit = this.getAllConnections();
@@ -1029,7 +1174,7 @@ export class Database {
         finally {
             this.inTransaction = false;
             this.isAutocommit = true;
-            this.inImplicitTransaction = false;
+            this.inImplicit = false;
             this._clearChangeLog();
         }
     }
@@ -1109,9 +1254,10 @@ export class Database {
         }
     }
     async executeViolationOnce(assertionName, sql) {
-        const stmt = await this.prepare(sql);
+        const stmt = this.prepare(sql);
         try {
-            for await (const _ of stmt.all()) {
+            // Use raw iterateRows() to avoid mutex acquisition - we're already inside the mutex
+            for await (const _ of stmt.iterateRows()) {
                 throw new QuereusError(`Integrity assertion failed: ${assertionName}`, StatusCode.CONSTRAINT);
             }
         }
@@ -1251,7 +1397,7 @@ export class Database {
      * Rollback an implicit transaction and coordinate with virtual table connections
      */
     /** @internal Rollback an implicit transaction */
-    async _rollbackImplicitTransaction() {
+    async _rollbackImplicit() {
         debugLog("Database: Rolling back implicit transaction.");
         // Rollback all active connections
         const connections = this.getAllConnections();
@@ -1268,7 +1414,7 @@ export class Database {
         // Reset database state
         this.inTransaction = false;
         this.isAutocommit = true;
-        this.inImplicitTransaction = false;
+        this.inImplicit = false;
     }
     createBlockWithNewStatements(block, statements) {
         return new BlockNode(block.scope, statements, block.parameters);