@powersync/web 0.0.0-dev-20260225163712 → 0.0.0-dev-20260226160529

package/dist/worker/{node_modules_pnpm_journeyapps_wa-sqlite_0_0_0-dev-20260225162137_node_modules_journeyapps_wa--3f11fc.umd.js → node_modules_pnpm_journeyapps_wa-sqlite_0_0_0-dev-20260226145021_node_modules_journeyapps_wa--24f702.umd.js}

@@ -1,9 +1,9 @@
 "use strict";
-(self["webpackChunksdk_web"] = self["webpackChunksdk_web"] || []).push([["node_modules_pnpm_journeyapps_wa-sqlite_0_0_0-dev-20260225162137_node_modules_journeyapps_wa--3f11fc"],{
+(self["webpackChunksdk_web"] = self["webpackChunksdk_web"] || []).push([["node_modules_pnpm_journeyapps_wa-sqlite_0_0_0-dev-20260226145021_node_modules_journeyapps_wa--24f702"],{
 
-/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/FacadeVFS.js"
+/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/FacadeVFS.js"
 /*!*************************************************************************************************************************************!*\
-  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/FacadeVFS.js ***!
+  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/FacadeVFS.js ***!
   \*************************************************************************************************************************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -11,7 +11,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   FacadeVFS: () => (/* binding */ FacadeVFS)
 /* harmony export */ });
-/* harmony import */ var _VFS_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./VFS.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/VFS.js");
+/* harmony import */ var _VFS_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./VFS.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/VFS.js");
 // Copyright 2024 Roy T. Hashimoto. All Rights Reserved.
 
 
@@ -735,9 +735,9 @@ class DataViewProxy {
 
 /***/ },
 
-/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/VFS.js"
+/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/VFS.js"
 /*!*******************************************************************************************************************************!*\
-  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/VFS.js ***!
+  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/VFS.js ***!
   \*******************************************************************************************************************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -978,7 +978,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   SQLITE_UTF8: () => (/* reexport safe */ _sqlite_constants_js__WEBPACK_IMPORTED_MODULE_0__.SQLITE_UTF8),
 /* harmony export */   SQLITE_WARNING: () => (/* reexport safe */ _sqlite_constants_js__WEBPACK_IMPORTED_MODULE_0__.SQLITE_WARNING)
 /* harmony export */ });
-/* harmony import */ var _sqlite_constants_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./sqlite-constants.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/sqlite-constants.js");
+/* harmony import */ var _sqlite_constants_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./sqlite-constants.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/sqlite-constants.js");
 // Copyright 2024 Roy T. Hashimoto. All Rights Reserved.
 
 
@@ -1204,9 +1204,9 @@ const FILE_TYPE_MASK = [
 
 /***/ },
 
-/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/LazyLock.js"
+/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/LazyLock.js"
 /*!*********************************************************************************************************************************************!*\
-  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/LazyLock.js ***!
+  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/LazyLock.js ***!
   \*********************************************************************************************************************************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -1214,7 +1214,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   LazyLock: () => (/* binding */ LazyLock)
 /* harmony export */ });
-/* harmony import */ var _Lock_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Lock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js");
+/* harmony import */ var _Lock_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Lock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js");
 
 
 class LazyLock extends _Lock_js__WEBPACK_IMPORTED_MODULE_0__.Lock {
@@ -1239,7 +1239,7 @@ class LazyLock extends _Lock_js__WEBPACK_IMPORTED_MODULE_0__.Lock {
   }
 
   close() {
-    super.close
+    super.close();
     this.#channel.onmessage = null;
     this.#channel.close();
   }
@@ -1308,9 +1308,9 @@ class LazyLock extends _Lock_js__WEBPACK_IMPORTED_MODULE_0__.Lock {
 
 /***/ },
 
-/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js"
+/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js"
 /*!*****************************************************************************************************************************************!*\
-  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js ***!
+  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js ***!
   \*****************************************************************************************************************************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -1389,9 +1389,9 @@ class Lock {
 
 /***/ },
 
-/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/OPFSWriteAheadVFS.js"
+/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/OPFSWriteAheadVFS.js"
 /*!******************************************************************************************************************************************************!*\
-  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/OPFSWriteAheadVFS.js ***!
+  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/OPFSWriteAheadVFS.js ***!
   \******************************************************************************************************************************************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -1399,12 +1399,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   OPFSWriteAheadVFS: () => (/* binding */ OPFSWriteAheadVFS)
 /* harmony export */ });
-/* harmony import */ var _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../FacadeVFS.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/FacadeVFS.js");
-/* harmony import */ var _VFS_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../VFS.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/VFS.js");
-/* harmony import */ var _Lock_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./Lock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js");
-/* harmony import */ var _LazyLock_js__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./LazyLock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/LazyLock.js");
-/* harmony import */ var _WriteAhead_js__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./WriteAhead.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/WriteAhead.js");
-
+/* harmony import */ var _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../FacadeVFS.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/FacadeVFS.js");
+/* harmony import */ var _VFS_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../VFS.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/VFS.js");
+/* harmony import */ var _LazyLock_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./LazyLock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/LazyLock.js");
+/* harmony import */ var _WriteAhead_js__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./WriteAhead.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/WriteAhead.js");
 
 
 
@@ -1431,8 +1429,10 @@ const finalizationRegistry = new FinalizationRegistry((/** @type {() => void} */
  * @property {'normal'|'exclusive'|null} [lockingMode]
  * @property {number} [lockState] SQLITE_LOCK_*
  * @property {LazyLock} [readLock]
- * @property {Lock} [writeLock]
+ * @property {LazyLock} [writeLock]
+ * @property {'none'|'read'|'write'|'readwrite'} [useLazyLock]
  * @property {number} [timeout]
+ * @property {0|1|2|3} [synchronous]
  * 
  * @property {WriteAhead} [writeAhead]
  */
@@ -1556,14 +1556,17 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
         // Initialize database file state.
         file.accessHandle = file.retryResult.accessHandle;
         file.journalHandle = file.retryResult.journalHandle;
+        file.waHandle = file.retryResult.waHandle;
         file.writeAhead = file.retryResult.writeAhead;
         file.retryResult = null;
 
         file.lockState = _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_LOCK_NONE;
         file.lockingMode = null;
-        file.readLock = new _LazyLock_js__WEBPACK_IMPORTED_MODULE_3__.LazyLock(`${zName}#read`);
-        file.writeLock = new _Lock_js__WEBPACK_IMPORTED_MODULE_2__.Lock(`${zName}#write`);
+        file.readLock = new _LazyLock_js__WEBPACK_IMPORTED_MODULE_2__.LazyLock(`${zName}#read`);
+        file.writeLock = new _LazyLock_js__WEBPACK_IMPORTED_MODULE_2__.LazyLock(`${zName}#write`);
+        file.useLazyLock = 'readwrite';
         file.timeout = -1;
+        file.synchronous = 1; // NORMAL
         file.useWriteAhead = true;
         file.writeHint = null;
       } else if (flags & _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_OPEN_MAIN_JOURNAL) {
@@ -1813,8 +1816,8 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
       const file = this.mapIdToFile.get(fileId);
       if (file.flags & _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_OPEN_MAIN_DB) {
         if (file.useWriteAhead) {
-          // TODO: Track PRAGMA synchronous setting.
-          file.writeAhead.sync('normal');
+          const durability = file.synchronous > 1 ? 'strict' : 'relaxed';
+          file.writeAhead.sync({ durability });
         } else {
           file.accessHandle.flush();
         }
@@ -1879,18 +1882,35 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
             file.useWriteAhead = false;
           }
 
-          if (file.writeHint || file.readLock.mode !== 'shared') {
-            // Asynchronous lock acquisition is needed. Set retryResult to
-            // non-null so when SQLite calls jUnlock() it knows not to reset
-            // any locks we have in progress.
-            file.retryResult = {};
-            this._module.retryOps.push(this.#retryLock(pFile, lockType));
-            return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_BUSY;
+          // There are three distinct cases. In each case if the required
+          // lock is already held then we can proceed synchronously.
+          // Otherwise we need to acquire state asynchronously and retry.
+          if (!file.writeHint) {
+            // Case 1: Read transaction with write-ahead logging.
+            if (!file.readLock.acquireIfHeld('shared')) {
+              file.retryResult = {};
+              this._module.retryOps.push(this.#retryLockRead(file));
+              return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_BUSY;
+            } else {
+              file.writeAhead.isolateForRead();
+            }
+          } else {
+            if (file.useWriteAhead) {
+              // Case 2: Write transaction with write-ahead logging.
+              if (!file.writeLock.acquireIfHeld('exclusive')) {
+                file.retryResult = {};
+                this._module.retryOps.push(this.#retryLockWrite(file));
+                return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_BUSY;
+              } else {
+                file.writeAhead.isolateForWrite();
+              }
+            } else {
+              // Case 3: Transaction without write-ahead logging.
+              file.retryResult = {};
+              this._module.retryOps.push(this.#retryLockExclusive(file));
+              return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_BUSY;
+            }
           }
-
-          // This is a read transaction and we can get the shared
-          // lock synchronously.
-          file.readLock.acquireIfHeld('shared');
         } else if (file.retryResult instanceof Error) {
           throw file.retryResult;
         }
@@ -1898,13 +1918,6 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
         // We have acquired the needed locks, either synchronously or
         // via retry.
         file.retryResult = null;
-        if (file.writeHint === null) {
-          // Ensure that our read-only view of the database does not change
-          // while in the SHARED lock state. The corresponding method
-          // isolateForWrite() is not called in this method, but instead
-          // in retryLock() because it is asynchronous.
-          file.writeAhead.isolateForRead();
-        }
       } else if (lockType >= _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_LOCK_RESERVED && !file.writeLock.mode) {
         // This is a write transaction but we don't already have the write
         // lock. This happens when the write hint was not used, which this
@@ -1943,15 +1956,28 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
           file.writeAhead.rejoin();
         }
 
-        file.writeLock.release();
-        if (file.readLock.mode === 'exclusive') {
-          // TODO: Consider lazy release here as well.
-          file.readLock.release();
-        } else {
-          file.readLock.releaseLazy();
+        // Release any locks.
+        switch (file.useLazyLock) {
+          case 'none':
+            file.writeLock.release();
+            file.readLock.release();
+            break;
+          case 'read':
+            file.writeLock.release();
+            file.readLock.releaseLazy();
+            break;
+          case 'write':
+            file.writeLock.releaseLazy();
+            file.readLock.release();
+            break;
+          case 'readwrite':
+            file.writeLock.releaseLazy();
+            file.readLock.releaseLazy();
+            break;
         }
-        file.writeHint = null;
 
+        // Reset state for the next transaction.
+        file.writeHint = null;
         if (file.lockingMode === 'normal') {
           file.useWriteAhead = true;
         }
@@ -2035,6 +2061,30 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
                   break;
               }
               break;
+            case 'synchronous':
+              if (value !== null) {
+                switch (value.toLowerCase()) {
+                  case 'off':
+                  case '0':
+                    file.synchronous = 0;
+                    break;
+                  case 'normal':
+                  case '1':
+                    file.synchronous = 1;
+                    break;
+                  case 'full':
+                  case '2':
+                    file.synchronous = 2;
+                    break;
+                  case 'extra':
+                  case '3':
+                    file.synchronous = 3;
+                    break;
+                  default:
+                    throw new Error(`unexpected synchronous value: ${value}`);
+                }
+              }
+              break;
             case 'vfs_trace':
               // This is a trace feature for debugging only.
               if (value !== null) {
@@ -2044,15 +2094,13 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
               return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_OK;
             case 'wal_autocheckpoint':
               if (value !== null) {
-                const pageCount = parseInt(value);
-                if (pageCount > 0) {
-                  file.writeAhead.options.autoCheckpointPages = pageCount;
-                }
+                const nPages = parseInt(value);
+                file.writeAhead.options.autoCheckpointPages = Math.max(nPages, 0);
               }
               break;
             case 'wal_checkpoint':
               const checkpointMode = (value ?? 'passive').toLowerCase();
-              switch ((value ?? 'passive').toLowerCase()) {
+              switch (checkpointMode) {
                 case 'passive':
                 case 'full':
                 case 'restart':
@@ -2064,19 +2112,41 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
                   this._module.pendingOps.push(this.#pendingCheckpoint(file, checkpointMode));
                   break;
                 case 'noop':
-                  // Return the current size of the write-ahead file. SQLite
-                  // returns different information, but that is not feasible
-                  // from a VFS.
-                  {
-                    const s = file.writeAhead.getWriteAheadSize().toString();
-                    const ptr = this._module._sqlite3_malloc64(s.length + 1);
-                    this._module.stringToUTF8(s, ptr, s.length + 1);
-                    pArg.setUint32(0, ptr, true);
-                  }
                   break;
                 default:
                   throw new Error(`unexpected wal_checkpoint mode: ${value}`);
               }
+
+              // Return the approximate size of the write-ahead data (which
+              // may be smaller than the actual file size). SQLite returns
+              // different information, but that is not feasible from a VFS.
+              {
+                const s = file.writeAhead.getWriteAheadSize().toString();
+                const ptr = this._module._sqlite3_malloc64(s.length + 1);
+                this._module.stringToUTF8(s, ptr, s.length + 1);
+                pArg.setUint32(0, ptr, true);
+              }
+              return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_OK;
+            case 'lazy_lock':
+              if (value !== null) {
+                const useLazyLock = value.toLowerCase();
+                switch (useLazyLock) {
+                  case 'read':
+                  case 'write':
+                  case 'readwrite':
+                  case 'none':
+                    file.useLazyLock = useLazyLock;
+                    break;
+                  default:
+                    throw new Error(`unexpected value for lazy_lock: ${value}`);
+                }
+              }
+              {
+                const s = file.useLazyLock;
+                const ptr = this._module._sqlite3_malloc64(s.length + 1);
+                this._module.stringToUTF8(s, ptr, s.length + 1);
+                pArg.setUint32(0, ptr, true);
+              }
               return _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_OK;
             case 'write_ahead':
               // For testing purposes only: enable or disable write-ahead mode.
@@ -2205,61 +2275,81 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
   }
 
   /**
-   * 
+   * Asynchronous PRAGMA operation to checkpoint the write-ahead log.
    * @param {FileEntry} file 
    * @param {'passive'|'full'|'restart'|'truncate'} mode 
    */
   async #pendingCheckpoint(file, mode) {
     try {
-      const ckptLockOptions = { ifAvailable: mode === 'passive' };
       if (mode !== 'passive') {
-        await file.readLock.acquire('exclusive', file.timeout);
         await file.writeLock.acquire('exclusive');
       }
       
       await file.writeAhead.checkpoint(mode);
     } catch (e) {
-      console.error(e);
+      if (e.name === 'AbortError') {
+        e.code = _VFS_js__WEBPACK_IMPORTED_MODULE_1__.SQLITE_BUSY;
+      }
+      throw e;
     } finally {
-      file.readLock.release();
       file.writeLock.release();
     }
   }
 
   /**
-   * Handle asynchronous jLock() tasks.
-   * @param {number} pFile 
-   * @param {number} lockType 
+   * @param {FileEntry} file 
    */
-  async #retryLock(pFile, lockType) {
-    const file = this.mapIdToFile.get(pFile);
+  async #retryLockRead(file) {
     try {
-      switch (file.writeHint) {
-        case 'reserved':
-        case 'exclusive':
-          if (file.useWriteAhead) {
-            // Write-ahead transactions only need writeLock, not readLock.
-            await file.writeLock.acquire('exclusive', file.timeout);
-            file.writeAhead.isolateForWrite();
-          } else {
-            // This transaction will write directly to the database,
-            // i.e. not using write-ahead. Get exclusive access.
-            await file.readLock.acquire('exclusive', file.timeout);
-            await file.writeLock.acquire('exclusive');
+      await file.readLock.acquire('shared', file.timeout);
+      file.writeAhead.isolateForRead();
+      file.retryResult = {};
+    } catch (e) {
+      if (file.readLock.mode) {
+        file.readLock.release();
+      }
+      file.retryResult = e;
+    }
+  }
 
-            // Transfer everything in write-ahead to the OPFS file.
-            await file.writeAhead.checkpoint('restart');
-          }
-          break;
-        default:
-          // This transaction will only read.
-          await file.readLock.acquire('shared', file.timeout);
-          break;
+  /**
+   * @param {FileEntry} file 
+   */
+  async #retryLockWrite(file) {
+    try {
+      // Write-ahead transactions only need writeLock, not readLock.
+      await file.writeLock.acquire('exclusive', file.timeout);
+      file.writeAhead.isolateForWrite();
+      file.retryResult = {};
+    } catch (e) {
+      if (file.writeLock.mode) {
+        file.writeLock.release();
       }
+      file.retryResult = e;
+    }
+  }
+
+  /**
+   * @param {FileEntry} file 
+   */
+  async #retryLockExclusive(file) {
+    try {
+      // This transaction will write directly to the database,
+      // i.e. not using write-ahead. Get exclusive access.
+      await file.readLock.acquire('exclusive', file.timeout);
+      await file.writeLock.acquire('exclusive', file.timeout);
+
+      // Transfer everything in write-ahead to the OPFS file.
+      await file.writeAhead.checkpoint('restart');
       file.retryResult = {};
     } catch (e) {
+      if (file.writeLock.mode) {
+        file.writeLock.release();
+      }
+      if (file.readLock.mode) {
+        file.readLock.release();
+      }
       file.retryResult = e;
-      return;
     }
   }
 
@@ -2347,7 +2437,7 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
         });
         
         // Create the write-ahead manager.
-        const writeAhead = new _WriteAhead_js__WEBPACK_IMPORTED_MODULE_4__.WriteAhead(
+        const writeAhead = new _WriteAhead_js__WEBPACK_IMPORTED_MODULE_3__.WriteAhead(
           zName,
           accessHandle,
           waHandle,
@@ -2368,9 +2458,9 @@ class OPFSWriteAheadVFS extends _FacadeVFS_js__WEBPACK_IMPORTED_MODULE_0__.Facad
 
 /***/ },
 
-/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/WriteAhead.js"
+/***/ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/WriteAhead.js"
 /*!***********************************************************************************************************************************************!*\
-  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/WriteAhead.js ***!
+  !*** ../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/WriteAhead.js ***!
   \***********************************************************************************************************************************************/
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -2378,10 +2468,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   WriteAhead: () => (/* binding */ WriteAhead)
 /* harmony export */ });
-/* harmony import */ var _Lock_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Lock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260225162137/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js");
+/* harmony import */ var _Lock_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Lock.js */ "../../node_modules/.pnpm/@journeyapps+wa-sqlite@0.0.0-dev-20260226145021/node_modules/@journeyapps/wa-sqlite/src/examples/Lock.js");
 
 
-const DEFAULT_AUTOCHECKPOINT_PAGES = 1_000;
+const DEFAULT_AUTOCHECKPOINT_PAGES = 1000;
 const DEFAULT_BACKSTOP_INTERVAL = 30_000;
 
 const SECTOR_SIZE = 4096;
@@ -2434,6 +2524,7 @@ class WriteAhead {
   /** @type {Map<number, PageEntry>} */ #waOverlay = new Map();
   /** @type {Map<number, Transaction>} */ #mapIdToTx = new Map();
   /** @type {Map<number, Transaction>} */ #pendingTx = new Map();
+  #mapIdToTxPageCount = 0;
 
   #broadcastChannel;
   /** @type {number} */ #backstopTimer;
@@ -2453,9 +2544,8 @@ class WriteAhead {
     // All the asynchronous initialization is done here.
     this.#ready = (async () => {
       // Disable checkpointing by other connections until we're ready.
-      await this.#updateTxIdLock();
       await navigator.locks.request(`${this.#zName}-ckpt`, async () => {
-        // This is just a barrier; nothing needs to be done here.
+        await this.#updateTxIdLock();
       });
 
       // Load all the transactions from the WAL file.
@@ -2467,6 +2557,7 @@ class WriteAhead {
       for (const tx of this.#waFile.readAllTx()) {
         this.#activateTx(tx);
       }
+      this.#updateTxIdLock(); // doesn't need await
 
       // Listen for transactions and checkpoints from other connections.
       this.#broadcastChannel = new BroadcastChannel(`${zName}#wa`);
@@ -2474,11 +2565,8 @@ class WriteAhead {
         this.#handleMessage(event);
       };
 
-      // Update our tx lock to reflect the current txId.
-      await this.#updateTxIdLock();
-
-      // Schedule first backstop. The backstop is a guard against a crash
-      // in another context between persisting a transaction and broadcasting
+      // Schedule backstop. The backstop is a guard against a crash in
+      // another context between persisting a transaction and broadcasting
       // it.
       this.#backstop();
     })();
@@ -2514,8 +2602,8 @@ class WriteAhead {
     this.#isolationState = 'read';
 
     if (this.#waFile.checkReset()) {
-      // The WAL file has been reset with a full checkpoint. Our view
-      // must be at the final transaction before the checkpoint for
+      // The WAL file has been restarted after a full checkpoint. Our
+      // view must be at the final transaction before the checkpoint for
       // that to have happened. The previous overlay is now stale. In
       // case we haven't received the checkpoint broadcast, make sure
       // the overlay is cleared.
@@ -2538,8 +2626,8 @@ class WriteAhead {
     this.#backstopTimer = null;
 
     if (this.#waFile.checkReset()) {
-      // The WAL file has been reset with a full checkpoint. Our view
-      // must be at the final transaction before the checkpoint for
+      // The WAL file has been restarted after a full checkpoint. Our
+      // view must be at the final transaction before the checkpoint for
       // that to have happened. The previous overlay is now stale. In
       // case we haven't received the checkpoint broadcast, make sure
       // the overlay is cleared.
@@ -2554,9 +2642,14 @@ class WriteAhead {
     if (this.#isolationState === 'write') {
       // Resume backstop after write isolation.
       this.#backstop();
+
+      // We need a place for a connection that only does write transactions
+      // to auto-checkpoint. This the best place because writing is
+      // complete.
+      this.#autoCheckpoint();
     } else {
       // Catch up on new transactions that arrived while isolated.
-      this.#advanceTxId();
+      this.#advanceTxId({ autoCheckpoint: true });
     }
     this.#isolationState = null;
   }
@@ -2629,13 +2722,11 @@ class WriteAhead {
     this.#activateTx(this.#txActive);
     this.#updateTxIdLock();
 
+    // Send the transaction to other connections.
     const payload = { type: 'tx', tx: this.#txActive };
-    // this.#handleMessage(new MessageEvent('message', { data: payload }));
-    // this.#advanceTxId();
+    this.#broadcastChannel.postMessage(payload);
     this.#txActive = null;
 
-    // Send the transaction to other connections.
-    this.#broadcastChannel.postMessage(payload);
   }
 
   rollback() {
@@ -2645,10 +2736,10 @@ class WriteAhead {
   }
   
   /**
-   * @param {'normal'|'full'} mode 
+   * @param {{durability: 'strict'|'relaxed'}} options 
    */
-  sync(mode) {
-    if (mode === 'full') {
+  sync(options) {
+    if (options.durability === 'strict') {
       this.#waFile.accessHandle.flush();
     }
   }
@@ -2682,8 +2773,8 @@ class WriteAhead {
 
   /**
    * Return the known usage size of the write-ahead file. Note that the
-   * actual file size may be larger if this connection is not current
-   * or if the file has obsolete content past the current point.
+   * actual file size may be larger than reported if this connection is
+   * not current or if the file has obsolete content past the current point.
    * @returns {number}
    */
   getWriteAheadSize() {
@@ -2697,6 +2788,7 @@ class WriteAhead {
   #activateTx(tx) {
     // Transfer to the active collection of transactions.
     this.#mapIdToTx.set(tx.id, tx);
+    this.#mapIdToTxPageCount += tx.pages.size;
   
     // Add transaction pages to the write-ahead overlay.
     for (const [offset, pageEntry] of tx.pages) {
@@ -2710,7 +2802,7 @@ class WriteAhead {
    * last broadcast transaction. Optionally, also advance through any
    * additional transactions in the WAL file to be fully current.
    * 
-   * @param {{readToCurrent?: boolean}} options
+   * @param {{readToCurrent?: boolean, autoCheckpoint?: boolean}} options
    */
   #advanceTxId(options = {}) {
     let didAdvance = false;
@@ -2742,6 +2834,21 @@ class WriteAhead {
     if (didAdvance) {
       // Publish our new view txId.
       this.#updateTxIdLock();
+
+      if (options.autoCheckpoint) {
+        this.#autoCheckpoint();
+      }
+    }
+  }
+
+  #autoCheckpoint() {
+    // Perform an automatic checkpoint if enabled and needed. Automatic
+    // checkpoints are passive, so this will not change the WAL file
+    // usage or size.
+    if (this.options.autoCheckpointPages > 0 &&
+        this.#mapIdToTxPageCount >= this.options.autoCheckpointPages) {
+      this.log?.(`%cauto-checkpoint`, 'background-color: lightgreen;');
+      this.checkpoint('passive');
     }
   }
 
@@ -2767,24 +2874,8 @@ class WriteAhead {
         // Full checkpoint, use the current WAL file txId.
         ckptId = this.#waFile.txId;
 
-        // Wait for all connections to reach this txId. Each connection
-        // acquires a shared lock whose name contains the database name,
-        // the minimum and maximum txId it has in mapIdToTx. We want all
-        // maximum txId values to be ckptId.
-        let pendingLockNames = [];
-        do {
-          // Wait for connections with lower maximum txIds. When a
-          // connection advances its txId, it will release its previous
-          // lock and acquire a new one.
-          await Promise.all(
-            pendingLockNames.map(name => navigator.locks.request(name, async () => {}))
-          );
-
-          // Refresh the list of locks with lower txIds.
-          pendingLockNames = (await this.#getTxIdLocks())
-            .filter(value => value.maxTxId < ckptId)
-            .map(value => value.name);
-        } while (pendingLockNames.length > 0);
+        // Wait for all connections to reach this txId.
+        await this.#waitForTxIdLocks(value => value.maxTxId >= ckptId);
         this.log?.(`%c#checkpoint full txId ${ckptId}`, 'background-color: lightgreen;');
       } else {
         // Not a full checkpoint, so find the lowest txId in use by any
@@ -2840,8 +2931,11 @@ class WriteAhead {
       }
 
       if (writtenOffsets.size > 0) {
-        // Ensure data is safely in the file.
-        this.#dbHandle.flush();
+        if (ckptId == this.#waFile.txId) {
+          // Ensure data is safely in the file.
+          this.log?.(`%c#checkpoint flush database file`, 'background-color: lightgreen;');
+          this.#dbHandle.flush();
+        }
 
         // Notify other connections and ourselves of the checkpoint.
         this.#broadcastChannel.postMessage({
@@ -2852,6 +2946,9 @@ class WriteAhead {
       }
 
       if (options.isRestart) {
+        // Wait for all connections to clear their overlay.
+        await this.#waitForTxIdLocks(value => value.minTxId > ckptId);
+
         this.#waFile.reset();
       }
     });
@@ -2880,6 +2977,7 @@ class WriteAhead {
 
       // Remove transaction.
       this.#mapIdToTx.delete(tx.id);
+      this.#mapIdToTxPageCount -= tx.pages.size;
     }
     this.#updateTxIdLock();
   }
@@ -2896,7 +2994,7 @@ class WriteAhead {
         this.#pendingTx.set(tx.id, tx);
         if (this.#isolationState === null) {
           // Not in an isolated state, so advance our view of the database.
-          this.#advanceTxId();
+          this.#advanceTxId({ autoCheckpoint: true });
         }
       }
     } else if (event.data.type === 'ckpt') {
@@ -2998,6 +3096,25 @@ class WriteAhead {
     }
     return null;
   }
+
+  /**
+   * Wait for all txId locks that fail the provided predicate.
+   * @param {(lock: {name: string, minTxId: number, maxTxId: number}) => boolean} predicate 
+   */
+  async #waitForTxIdLocks(predicate) {
+    /** @type {string[]} */ let failingLockNames = [];
+    do {
+      // Wait for all connections that fail the predicate.
+      await Promise.all(
+        failingLockNames.map(name => navigator.locks.request(name, async () => {}))
+      );
+
+      // Refresh the list of failing locks.
+      failingLockNames = (await this.#getTxIdLocks())
+        .filter(value => !predicate(value))
+        .map(value => value.name);
+    } while (failingLockNames.length > 0);
+  }
 }
 
 class WriteAheadFile {
@@ -3257,6 +3374,7 @@ class WriteAheadFile {
   #readFrame(offset) {
     const headerView = new DataView(new ArrayBuffer(WriteAheadFile.FRAME_HEADER_SIZE));
     if (this.accessHandle.read(headerView, { at: offset }) !== headerView.byteLength) {
+      // EOF, not an error.
       return null;
     }
 
@@ -3264,6 +3382,8 @@ class WriteAheadFile {
     const frameSalt1 = headerView.getUint32(16);
     const frameSalt2 = headerView.getUint32(20);
     if (frameSalt1 !== this.salt1 || frameSalt2 !== this.salt2) {
+      // Not necessarily an error, could be from a restart without
+      // truncation.
       return null;
     }
 
@@ -3283,6 +3403,8 @@ class WriteAheadFile {
       checksum.update(payloadData);
     }
     if (!checksum.matches(headerView.getUint32(24), headerView.getUint32(28))) {
+      // Not necessarily an error, could be from a restart without
+      // truncation.
       return null;
     }
 
@@ -3295,6 +3417,9 @@ class WriteAheadFile {
         pageData: payloadData
       }
     } else if (frameType === WriteAheadFile.FRAME_TYPE_COMMIT) {
+      // Flags byte is currently unused. A possible future use would be
+      // to indicate an overwrite commit to trigger clearing the overlay.
+      // This might allow a page size change by VACUUM.
       const flags = headerView.getUint8(1);
       return {
         frameType,
@@ -3362,14 +3487,8 @@ class Checksum {
   }
 }
 
-class InvalidFrameError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = 'InvalidFrameError';
-  }
-}
 
 /***/ }
 
 }]);
-//# sourceMappingURL=node_modules_pnpm_journeyapps_wa-sqlite_0_0_0-dev-20260225162137_node_modules_journeyapps_wa--3f11fc.umd.js.map
+//# sourceMappingURL=node_modules_pnpm_journeyapps_wa-sqlite_0_0_0-dev-20260226145021_node_modules_journeyapps_wa--24f702.umd.js.map