KyleAMathews · Oct 21, 2026 · Oct 21, 2026
diff --git a/.changeset/deferred-sync-held-rows.md b/.changeset/deferred-sync-held-rows.md
diff --git a/.changeset/stale-reacquired-query-ownership.md b/.changeset/stale-reacquired-query-ownership.md
diff --git a/.changeset/storable-row-values.md b/.changeset/storable-row-values.md
diff --git a/examples/angular/todos/package.json b/examples/angular/todos/package.json
@@ -27,8 +27,8 @@
     "@angular/forms": "^20.3.16",
     "@angular/platform-browser": "^20.3.16",
     "@angular/router": "^20.3.16",
-    "@tanstack/angular-db": "^0.2.11",
-    "@tanstack/db": "^0.15.1",
+    "@tanstack/angular-db": "^0.2.12",
+    "@tanstack/db": "^0.15.2",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "~0.15.0"

diff --git a/examples/electron/offline-first/package.json b/examples/electron/offline-first/package.json
@@ -13,11 +13,11 @@
     "postinstall": "prebuild-install --runtime electron --target 41.0.0 --arch arm64 || echo 'prebuild-install failed, try: npx @electron/rebuild'"
   },
   "dependencies": {
-    "@tanstack/electron-db-sqlite-persistence": "^0.2.12",
-    "@tanstack/node-db-sqlite-persistence": "^0.2.36",
-    "@tanstack/offline-transactions": "^1.1.3",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/electron-db-sqlite-persistence": "^0.2.13",
+    "@tanstack/node-db-sqlite-persistence": "^0.2.37",
+    "@tanstack/offline-transactions": "^1.1.4",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/react-db": "^0.5.12",
     "@tanstack/react-query": "^5.90.20",
     "better-sqlite3": "^12.6.2",
     "react": "^19.2.4",

diff --git a/examples/react-native/offline-transactions/package.json b/examples/react-native/offline-transactions/package.json
@@ -15,11 +15,11 @@
     "@op-engineering/op-sqlite": "^15.2.5",
     "@react-native-async-storage/async-storage": "2.1.2",
     "@react-native-community/netinfo": "11.4.1",
-    "@tanstack/db": "^0.15.1",
-    "@tanstack/offline-transactions": "^1.1.3",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/react-db": "^0.5.11",
-    "@tanstack/react-native-db-sqlite-persistence": "^0.2.36",
+    "@tanstack/db": "^0.15.2",
+    "@tanstack/offline-transactions": "^1.1.4",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/react-db": "^0.5.12",
+    "@tanstack/react-native-db-sqlite-persistence": "^0.2.37",
     "@tanstack/react-query": "^5.90.20",
     "expo": "~53.0.26",
     "expo-constants": "~17.1.0",

diff --git a/examples/react-native/shopping-list/package.json b/examples/react-native/shopping-list/package.json
@@ -18,11 +18,11 @@
     "@op-engineering/op-sqlite": "^15.2.5",
     "@react-native-async-storage/async-storage": "2.1.2",
     "@react-native-community/netinfo": "11.4.1",
-    "@tanstack/db": "^0.15.1",
-    "@tanstack/electric-db-collection": "^0.6.2",
-    "@tanstack/offline-transactions": "^1.1.3",
-    "@tanstack/react-db": "^0.5.11",
-    "@tanstack/react-native-db-sqlite-persistence": "^0.2.36",
+    "@tanstack/db": "^0.15.2",
+    "@tanstack/electric-db-collection": "^0.6.3",
+    "@tanstack/offline-transactions": "^1.1.4",
+    "@tanstack/react-db": "^0.5.12",
+    "@tanstack/react-native-db-sqlite-persistence": "^0.2.37",
     "@tanstack/react-query": "^5.90.20",
     "expo": "~53.0.26",
     "expo-constants": "~17.1.0",

diff --git a/examples/react/action-enforcement/package.json b/examples/react/action-enforcement/package.json
@@ -12,8 +12,8 @@
   },
   "dependencies": {
     "@tanstack/query-core": "^5.90.20",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/react-db": "^0.5.12",
     "react": "^19.2.4",
     "react-dom": "^19.2.4"
   },

diff --git a/examples/react/next-ssr-e2e/package.json b/examples/react/next-ssr-e2e/package.json
@@ -9,8 +9,8 @@
     "test:e2e": "pnpm --filter @tanstack/db build && pnpm --filter @tanstack/react-db build && playwright test"
   },
   "dependencies": {
-    "@tanstack/db": "^0.15.1",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/db": "^0.15.2",
+    "@tanstack/react-db": "^0.5.12",
     "next": "^16.3.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4"

diff --git a/examples/react/offline-transactions/package.json b/examples/react/offline-transactions/package.json
@@ -8,11 +8,11 @@
     "build": "vite build && tsc --noEmit"
   },
   "dependencies": {
-    "@tanstack/browser-db-sqlite-persistence": "^0.2.36",
-    "@tanstack/db": "^0.15.1",
-    "@tanstack/offline-transactions": "^1.1.3",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/browser-db-sqlite-persistence": "^0.2.37",
+    "@tanstack/db": "^0.15.2",
+    "@tanstack/offline-transactions": "^1.1.4",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/react-db": "^0.5.12",
     "@tanstack/react-query": "^5.90.20",
     "@tanstack/react-router": "^1.170.41",
     "@tanstack/react-router-devtools": "^1.159.5",

diff --git a/examples/react/paced-mutations-demo/package.json b/examples/react/paced-mutations-demo/package.json
@@ -9,8 +9,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/db": "^0.15.1",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/db": "^0.15.2",
+    "@tanstack/react-db": "^0.5.12",
     "mitt": "^3.0.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4"

diff --git a/examples/react/projects/package.json b/examples/react/projects/package.json
@@ -17,8 +17,8 @@
   "dependencies": {
     "@tailwindcss/vite": "^4.1.18",
     "@tanstack/query-core": "^5.90.20",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/react-db": "^0.5.12",
     "@tanstack/react-router": "^1.170.41",
     "@tanstack/react-router-devtools": "^1.159.5",
     "@tanstack/react-router-with-query": "^1.130.17",

diff --git a/examples/react/start-ssr-e2e/package.json b/examples/react/start-ssr-e2e/package.json
@@ -10,7 +10,7 @@
     "test:e2e:hosted": "playwright test"
   },
   "dependencies": {
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/react-db": "^0.5.12",
     "@tanstack/react-router": "^1.170.41",
     "@tanstack/react-router-with-db": "^0.1.0",
     "@tanstack/react-start": "^1.168.60",

diff --git a/examples/react/todo/package.json b/examples/react/todo/package.json
@@ -3,13 +3,13 @@
   "private": true,
   "version": "0.1.31",
   "dependencies": {
-    "@tanstack/electric-db-collection": "^0.6.2",
+    "@tanstack/electric-db-collection": "^0.6.3",
     "@tanstack/query-core": "^5.90.20",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/react-db": "^0.5.11",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/react-db": "^0.5.12",
     "@tanstack/react-router": "^1.170.41",
     "@tanstack/react-start": "^1.168.60",
-    "@tanstack/trailbase-db-collection": "^0.1.122",
+    "@tanstack/trailbase-db-collection": "^0.1.123",
     "cors": "^2.8.6",
     "drizzle-orm": "^0.45.1",
     "drizzle-zod": "^0.8.3",

diff --git a/examples/solid/todo/package.json b/examples/solid/todo/package.json
@@ -3,13 +3,13 @@
   "private": true,
   "version": "0.0.39",
   "dependencies": {
-    "@tanstack/electric-db-collection": "^0.6.2",
+    "@tanstack/electric-db-collection": "^0.6.3",
     "@tanstack/query-core": "^5.90.20",
-    "@tanstack/query-db-collection": "^1.4.7",
-    "@tanstack/solid-db": "^0.3.11",
+    "@tanstack/query-db-collection": "^1.4.8",
+    "@tanstack/solid-db": "^0.3.12",
     "@tanstack/solid-router": "^1.170.38",
     "@tanstack/solid-start": "^1.168.57",
-    "@tanstack/trailbase-db-collection": "^0.1.122",
+    "@tanstack/trailbase-db-collection": "^0.1.123",
     "cors": "^2.8.6",
     "drizzle-orm": "^0.45.1",
     "drizzle-zod": "^0.8.3",

diff --git a/packages/angular-db/CHANGELOG.md b/packages/angular-db/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/angular-db
 
+## 0.2.12
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66), [`9aecbab`](https://github.com/TanStack/db/commit/9aecbab4cacb3f1123b1716e6f063abb5affc74f)]:
+  - @tanstack/db@0.15.2
+
 ## 0.2.11
 
 ### Patch Changes

diff --git a/packages/angular-db/package.json b/packages/angular-db/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/angular-db",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Angular integration for @tanstack/db",
   "author": "Ethan McDaniel",
   "license": "MIT",

diff --git a/packages/browser-db-sqlite-persistence/CHANGELOG.md b/packages/browser-db-sqlite-persistence/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/browser-db-sqlite-persistence
 
+## 0.2.37
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66)]:
+  - @tanstack/db-sqlite-persistence-core@0.4.12
+
 ## 0.2.36
 
 ### Patch Changes

diff --git a/packages/browser-db-sqlite-persistence/package.json b/packages/browser-db-sqlite-persistence/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/browser-db-sqlite-persistence",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "Browser wa-sqlite persisted collection adapter for TanStack DB",
   "author": "TanStack Team",
   "license": "MIT",

diff --git a/packages/capacitor-db-sqlite-persistence/CHANGELOG.md b/packages/capacitor-db-sqlite-persistence/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/capacitor-db-sqlite-persistence
 
+## 0.2.37
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66)]:
+  - @tanstack/db-sqlite-persistence-core@0.4.12
+
 ## 0.2.36
 
 ### Patch Changes

diff --git a/packages/capacitor-db-sqlite-persistence/e2e/app/CHANGELOG.md b/packages/capacitor-db-sqlite-persistence/e2e/app/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/capacitor-db-sqlite-persistence-e2e-app
 
+## 0.0.49
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66), [`9aecbab`](https://github.com/TanStack/db/commit/9aecbab4cacb3f1123b1716e6f063abb5affc74f)]:
+  - @tanstack/db@0.15.2
+  - @tanstack/capacitor-db-sqlite-persistence@0.2.37
+
 ## 0.0.48
 
 ### Patch Changes

diff --git a/packages/capacitor-db-sqlite-persistence/e2e/app/package.json b/packages/capacitor-db-sqlite-persistence/e2e/app/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/capacitor-db-sqlite-persistence-e2e-app",
   "private": true,
-  "version": "0.0.48",
+  "version": "0.0.49",
   "type": "module",
   "scripts": {
     "build": "vite build",

diff --git a/packages/capacitor-db-sqlite-persistence/package.json b/packages/capacitor-db-sqlite-persistence/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/capacitor-db-sqlite-persistence",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "Capacitor SQLite persisted collection adapter for TanStack DB",
   "author": "TanStack Team",
   "license": "MIT",

diff --git a/packages/cloudflare-durable-objects-db-sqlite-persistence/CHANGELOG.md b/packages/cloudflare-durable-objects-db-sqlite-persistence/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/cloudflare-durable-objects-db-sqlite-persistence
 
+## 0.2.37
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66)]:
+  - @tanstack/db-sqlite-persistence-core@0.4.12
+
 ## 0.2.36
 
 ### Patch Changes

diff --git a/packages/cloudflare-durable-objects-db-sqlite-persistence/package.json b/packages/cloudflare-durable-objects-db-sqlite-persistence/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cloudflare-durable-objects-db-sqlite-persistence",
-  "version": "0.2.36",
+  "version": "0.2.37",
   "description": "Cloudflare Durable Object SQLite persisted collection adapter for TanStack DB",
   "author": "TanStack Team",
   "license": "MIT",

diff --git a/packages/db-sqlite-persistence-core/CHANGELOG.md b/packages/db-sqlite-persistence-core/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @tanstack/db-sqlite-persistence-core
 
+## 0.4.12
+
+### Patch Changes
+
+- Keep a settled optimistic row visible while its server row waits behind an earlier persisted write. Previously, two quick writes to one row in a persisted Collection could briefly show the row before the second write. ([#2208](https://github.com/TanStack/db/pull/2208))
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66), [`9aecbab`](https://github.com/TanStack/db/commit/9aecbab4cacb3f1123b1716e6f063abb5affc74f)]:
+  - @tanstack/db@0.15.2
+
 ## 0.4.11
 
 ### Patch Changes

diff --git a/packages/db-sqlite-persistence-core/package.json b/packages/db-sqlite-persistence-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/db-sqlite-persistence-core",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "SQLite persisted collection core for TanStack DB",
   "author": "TanStack Team",
   "license": "MIT",

diff --git a/packages/db/CHANGELOG.md b/packages/db/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @tanstack/db
 
+## 0.15.2
+
+### Patch Changes
+
+- Keep a settled optimistic row visible while its server row waits behind an earlier persisted write. Previously, two quick writes to one row in a persisted Collection could briefly show the row before the second write. ([#2208](https://github.com/TanStack/db/pull/2208))
+
+- LocalStorage Collections with the default JSON parser now reject an insert or update whose row a restore could not return, such as a row with a function, symbol, `NaN`, `Map`, `Set`, or `undefined` array entry. The write's `isPersisted` promise rejects with `SerializationError`, nothing is written, and the optimistic row rolls back. Previously, JSON silently dropped or replaced these values, so peers and later sessions saw a different row than the writer. ([#2207](https://github.com/TanStack/db/pull/2207))
+
+  IndexedDB Collections now report a value that structured clone cannot store as `SerializationError` instead of a raw `DataCloneError`. The `SerializationError` message no longer says "JSON".
+
 ## 0.15.1
 
 ### Patch Changes

diff --git a/packages/db/package.json b/packages/db/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/db",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "A reactive client store for building super fast apps on sync",
   "author": "Kyle Mathews",
   "license": "MIT",

diff --git a/packages/electric-db-collection/CHANGELOG.md b/packages/electric-db-collection/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/electric-db-collection
 
+## 0.6.3
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66), [`9aecbab`](https://github.com/TanStack/db/commit/9aecbab4cacb3f1123b1716e6f063abb5affc74f)]:
+  - @tanstack/db@0.15.2
+
 ## 0.6.2
 
 ### Patch Changes

diff --git a/packages/electric-db-collection/package.json b/packages/electric-db-collection/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/electric-db-collection",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "ElectricSQL collection for TanStack DB",
   "author": "Kyle Mathews",
   "license": "MIT",

diff --git a/packages/electron-db-sqlite-persistence/CHANGELOG.md b/packages/electron-db-sqlite-persistence/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/electron-db-sqlite-persistence
 
+## 0.2.13
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66)]:
+  - @tanstack/db-sqlite-persistence-core@0.4.12
+
 ## 0.2.12
 
 ### Patch Changes

diff --git a/packages/electron-db-sqlite-persistence/package.json b/packages/electron-db-sqlite-persistence/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/electron-db-sqlite-persistence",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "Electron SQLite persisted collection bridge for TanStack DB",
   "author": "TanStack Team",
   "license": "MIT",

diff --git a/packages/expo-db-sqlite-persistence/CHANGELOG.md b/packages/expo-db-sqlite-persistence/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @tanstack/expo-db-sqlite-persistence
 
+## 0.2.37
+
+### Patch Changes
+
+- Updated dependencies [[`5a1b286`](https://github.com/TanStack/db/commit/5a1b286910bdf56917a76732ba160c99d7b1ad66)]:
+  - @tanstack/db-sqlite-persistence-core@0.4.12
+
 ## 0.2.36
 
 ### Patch Changes