powersync-ja · simolus3 · Apr 13, 2026 · Jun 18, 2025 · Jun 21, 2025 · Aug 22, 2025
diff --git a/Makefile b/Makefile
@@ -1,8 +1,8 @@
 # dependencies
 
-BASE_SQLITE_VERSION=3.51.2
+BASE_SQLITE_VERSION=3.53.0
 SQLITE_VERSION = version-${BASE_SQLITE_VERSION}
-MC_SQLITE_VERSION = 2.2.7
+MC_SQLITE_VERSION = 2.3.3
 SQLITE_TARBALL_URL = https://www.sqlite.org/src/tarball/$(SQLITE_VERSION)/sqlite.tar.gz
 MC_SQLITE_URL = https://github.com/utelle/SQLite3MultipleCiphers/releases/download/v${MC_SQLITE_VERSION}/sqlite3mc-${MC_SQLITE_VERSION}-sqlite-${BASE_SQLITE_VERSION}-amalgamation.zip
 
@@ -77,6 +77,7 @@ EMCC ?= emcc
 CFLAGS_COMMON = \
 	-I'deps/$(SQLITE_VERSION)' \
 	-Wno-non-literal-null-conversion \
+	-DSQLITE_EXPERIMENTAL_PRAGMA_20251114 \
 	$(CFLAGS_EXTRA)
 CFLAGS_DEBUG = -g -fPIC $(CFLAGS_COMMON)
 CFLAGS_DIST =  -Oz -flto $(CFLAGS_COMMON)

diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@ This is a WebAssembly build of SQLite with support for writing SQLite virtual fi
 
 IndexedDB and several Origin Private File System virtual file systems are among the examples provided as proof of concept. A table comparing the different VFS classes is [here](https://github.com/rhashimoto/wa-sqlite/tree/master/src/examples#vfs-comparison).
 
-[Try the demo](https://rhashimoto.github.io/wa-sqlite/demo/?build=asyncify&config=IDBBatchAtomicVFS&reset) or run [benchmarks](https://rhashimoto.github.io/wa-sqlite/demo/benchmarks/?config=asyncify,IDBBatchAtomicVFS;asyncify,IDBMirrorVFS;default,AccessHandlePoolVFS;default,OPFSCoopSyncVFS;asyncify,OPFSAdaptiveVFS;asyncify,OPFSPermutedVFS) with a modern desktop web browser. More information is available in the [FAQ](https://github.com/rhashimoto/wa-sqlite/issues?q=is%3Aissue+label%3Afaq+), [discussion forums](https://github.com/rhashimoto/wa-sqlite/discussions), and [API reference](https://rhashimoto.github.io/wa-sqlite/docs/).
+[Try the demo](https://rhashimoto.github.io/wa-sqlite/demo/?build=asyncify&config=IDBBatchAtomicVFS&reset) or run [benchmarks](https://rhashimoto.github.io/wa-sqlite/demo/benchmarks/?config=asyncify,IDBBatchAtomicVFS;asyncify,IDBMirrorVFS;default,AccessHandlePoolVFS;default,OPFSCoopSyncVFS;asyncify,OPFSAdaptiveVFS;asyncify,OPFSWriteAheadVFS) with a modern desktop web browser. More information is available in the [FAQ](https://github.com/rhashimoto/wa-sqlite/issues?q=is%3Aissue+label%3Afaq+), [discussion forums](https://github.com/rhashimoto/wa-sqlite/discussions), and [API reference](https://rhashimoto.github.io/wa-sqlite/docs/).
 
 ## Build
 The primary motivation for this project is to enable additions to SQLite with only Javascript. Most developers should be able to use the pre-built artifacts in
@@ -91,7 +91,7 @@ The demo page provides access to databases on multiple VFS implementations. Quer
 | Parameter | Purpose | Values | Default |
 |----|----|----|----|
 | build | Emscripten build type | default, asyncify, jspi | default |
-| config | select VFS | MemoryVFS, MemoryAsyncVFS, IDBBatchAtomicVFS, IDBMirrorVFS, AccessHandlePoolVFS, OPFSAdaptiveVFS, OPFSAnyContextVFS, OPFSCoopSyncVFS, OPFSPermutedVFS | uses SQLite internal memory |
+| config | select VFS | MemoryVFS, MemoryAsyncVFS, IDBBatchAtomicVFS, IDBMirrorVFS, AccessHandlePoolVFS, OPFSAdaptiveVFS, OPFSAnyContextVFS, OPFSCoopSyncVFS, OPFSWriteAheadVFS | uses SQLite internal memory |
 | reset | clear persistent storage | | |
 
 For convenience, if any text region is selected in the editor, only that region will be executed. In addition, the editor contents are restored across page reloads using browser localStorage.

diff --git a/demo/contention/contention-worker.js b/demo/contention/contention-worker.js
@@ -54,9 +54,13 @@ const BUILDS = new Map([
     name: 'OPFSPermutedVFS',
     vfsModule: '../../src/examples/OPFSPermutedVFS.js',
   },
+  {
+    name: 'OPFSWriteAheadVFS',
+    vfsModule: '../../src/examples/OPFSWriteAheadVFS.js',
+  },
   {
     name: 'AccessHandlePoolVFS',
-    vfsModule: '../src/examples/AccessHandlePoolVFS.js',
+    vfsModule: '../../src/examples/AccessHandlePoolVFS.js',
   },
   {
     name: 'FLOOR',

diff --git a/demo/demo-worker.js b/demo/demo-worker.js
@@ -72,6 +72,10 @@ const EXT_WASM = new Map([
     name: 'OPFSPermutedVFS',
     vfsModule: '../src/examples/OPFSPermutedVFS.js',
   },
+  {
+    name: 'OPFSWriteAheadVFS',
+    vfsModule: '../src/examples/OPFSWriteAheadVFS.js',
+  },
   {
     name: 'AccessHandlePoolVFS',
     vfsModule: '../src/examples/AccessHandlePoolVFS.js',

diff --git a/demo/hello/README.md b/demo/hello/README.md
@@ -13,7 +13,7 @@ are valid:
 
 * As of May 2024, the JSPI build works only on recent Chromium browsers
 behind an experiment flag.
-* As of May 2024, OPFSPermutedVFS works only on recent Chromium browsers
+* As of May 2024, OPFSWriteAheadVFS works only on recent Chromium browsers
 as it requires FileSystemSyncAccessHandle "readwrite-unsafe" locking.
 * Some VFS classes work only with an asynchronous build (Asyncify or JSPI).
 * OPFS VFS classes work only within a Worker.
diff --git a/demo/hello/hello.js b/demo/hello/hello.js
@@ -14,16 +14,16 @@ import SQLiteESMFactory from '../../dist/wa-sqlite-async.mjs';
 // in a Worker.
 //
 // Note that certain VFS classes cannot read each others' databases, e.g.
-// IDBBatchAtomicVFS and IDBMirrorVFS, OPFSPermutedVFS and any other OPFS
-// VFS. If you change this demo to use a different VFS, you may need to
-// clear the appropriate storage for things to work.
+// IDBBatchAtomicVFS and IDBMirrorVFS. If you change this demo to use a
+// different VFS, you may need to clear the appropriate storage for things
+// to work.
 import { IDBBatchAtomicVFS as MyVFS } from '../../src/examples/IDBBatchAtomicVFS.js';
 // import { IDBMirrorVFS as MyVFS } from '../../src/examples/IDBMirrorVFS.js';
 // import { AccessHandlePoolVFS as MyVFS } from '../../src/examples/AccessHandlePoolVFS.js';
 // import { OPFSAdaptiveVFS as MyVFS } from '../../src/examples/OPFSAdaptiveVFS.js';
 // import { OPFSAnyContextVFS as MyVFS } from '../../src/examples/OPFSAnyContextVFS.js';
 // import { OPFSCoopSyncVFS as MyVFS } from '../../src/examples/OPFSCoopSyncVFS.js';
-// import { OPFSPermutedVFS as MyVFS } from '../../src/examples/OPFSPermutedVFS.js';
+// import { OPFSWriteAheadVFS as MyVFS } from '../../src/examples/OPFSWriteAheadVFS.js';
 
 import * as SQLite from '../../src/sqlite-api.js';
 

diff --git a/dist/mc-wa-sqlite-async.mjs b/dist/mc-wa-sqlite-async.mjs
diff --git a/dist/mc-wa-sqlite-async.wasm b/dist/mc-wa-sqlite-async.wasm
diff --git a/dist/mc-wa-sqlite-jspi.mjs b/dist/mc-wa-sqlite-jspi.mjs
diff --git a/dist/mc-wa-sqlite-jspi.wasm b/dist/mc-wa-sqlite-jspi.wasm
diff --git a/dist/mc-wa-sqlite.mjs b/dist/mc-wa-sqlite.mjs
diff --git a/dist/mc-wa-sqlite.wasm b/dist/mc-wa-sqlite.wasm
diff --git a/dist/wa-sqlite-async-dynamic-main.mjs b/dist/wa-sqlite-async-dynamic-main.mjs
diff --git a/dist/wa-sqlite-async-dynamic-main.wasm b/dist/wa-sqlite-async-dynamic-main.wasm
diff --git a/dist/wa-sqlite-async.mjs b/dist/wa-sqlite-async.mjs
diff --git a/dist/wa-sqlite-async.wasm b/dist/wa-sqlite-async.wasm
diff --git a/dist/wa-sqlite-dynamic-main.mjs b/dist/wa-sqlite-dynamic-main.mjs
diff --git a/dist/wa-sqlite-dynamic-main.wasm b/dist/wa-sqlite-dynamic-main.wasm
diff --git a/dist/wa-sqlite-jspi.mjs b/dist/wa-sqlite-jspi.mjs
diff --git a/dist/wa-sqlite-jspi.wasm b/dist/wa-sqlite-jspi.wasm
diff --git a/dist/wa-sqlite.mjs b/dist/wa-sqlite.mjs
diff --git a/dist/wa-sqlite.wasm b/dist/wa-sqlite.wasm
diff --git a/docs/assets/navigation.js b/docs/assets/navigation.js
diff --git a/docs/assets/search.js b/docs/assets/search.js
diff --git a/docs/interfaces/SQLiteAPI.html b/docs/interfaces/SQLiteAPI.html
diff --git a/docs/interfaces/SQLitePrepareOptions.html b/docs/interfaces/SQLitePrepareOptions.html
@@ -2,7 +2,7 @@
 </div><div class="tsd-comment tsd-typography"></div></section><div class="tsd-signature"><span class="tsd-signature-keyword">interface </span><span class="tsd-kind-interface">SQLitePrepareOptions</span> <span class="tsd-signature-symbol">{ </span><br/><span>    </span><a class="tsd-kind-property" href="SQLitePrepareOptions.html#flags">flags</a><span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">number</span><span class="tsd-signature-symbol">; </span><br/><span>    </span><a class="tsd-kind-property" href="SQLitePrepareOptions.html#unscoped">unscoped</a><span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">boolean</span><span class="tsd-signature-symbol">; </span><br/><span class="tsd-signature-symbol">}</span></div><section class="tsd-panel-group tsd-index-group"><section class="tsd-panel tsd-index-panel"><details class="tsd-index-content tsd-index-accordion" open><summary class="tsd-accordion-summary tsd-index-summary"><h5 class="tsd-index-heading uppercase" role="button" aria-expanded="false" tabIndex="0"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-chevronSmall"></use></svg> Index</h5></summary><div class="tsd-accordion-details"><section class="tsd-index-section"><h3 class="tsd-index-heading">Properties</h3><div class="tsd-index-list"><a href="SQLitePrepareOptions.html#flags" class="tsd-index-link"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-1024"></use></svg><span>flags?</span></a>
 <a href="SQLitePrepareOptions.html#unscoped" class="tsd-index-link"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-1024"></use></svg><span>unscoped?</span></a>
 </div></section></div></details></section></section><section class="tsd-panel-group tsd-member-group"><h2>Properties</h2><section class="tsd-panel tsd-member"><a id="flags" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><code class="tsd-tag ts-flagOptional">Optional</code> <span>flags</span><a href="#flags" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="#icon-anchor"></use></svg></a></h3><div class="tsd-signature"><span class="tsd-kind-property">flags</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">number</span></div><div class="tsd-comment tsd-typography"><p>SQLITE_PREPARE_* flags</p>
-</div><div class="tsd-comment tsd-typography"><h4>See</h4><p><a href="https://www.sqlite.org/c3ref/c_prepare_normalize.html#sqlitepreparepersistent">https://www.sqlite.org/c3ref/c_prepare_normalize.html#sqlitepreparepersistent</a></p>
+</div><div class="tsd-comment tsd-typography"><h4>See</h4><p><a href="https://sqlite.org/c3ref/c_prepare_dont_log.html#sqlitepreparepersistent">https://sqlite.org/c3ref/c_prepare_dont_log.html#sqlitepreparepersistent</a></p>
 </div></section><section class="tsd-panel tsd-member"><a id="unscoped" class="tsd-anchor"></a><h3 class="tsd-anchor-link"><code class="tsd-tag ts-flagOptional">Optional</code> <span>unscoped</span><a href="#unscoped" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="#icon-anchor"></use></svg></a></h3><div class="tsd-signature"><span class="tsd-kind-property">unscoped</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">boolean</span></div><div class="tsd-comment tsd-typography"><p>Statement handles prepared and yielded by <a href="SQLiteAPI.html#statements" class="tsd-kind-method">SQLiteAPI.statements</a>
 are normally valid only within the scope of an iteration.
 Set <code>unscoped</code> to <code>true</code> to give iterated statements an arbitrary