TanStack · kevin-dp · Apr 14, 2026 · Apr 14, 2026
diff --git a/.changeset/includes-child-where-clauses.md b/.changeset/includes-child-where-clauses.md
diff --git a/.changeset/includes-lazy-loading.md b/.changeset/includes-lazy-loading.md
diff --git a/examples/angular/todos/package.json b/examples/angular/todos/package.json
@@ -28,8 +28,8 @@
     "@angular/forms": "^20.3.16",
     "@angular/platform-browser": "^20.3.16",
     "@angular/router": "^20.3.16",
-    "@tanstack/angular-db": "^0.1.64",
-    "@tanstack/db": "^0.6.4",
+    "@tanstack/angular-db": "^0.1.65",
+    "@tanstack/db": "^0.6.5",
     "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 40.2.1 --arch arm64 || echo 'prebuild-install failed, try: npx @electron/rebuild'"
   },
   "dependencies": {
-    "@tanstack/electron-db-sqlite-persistence": "^0.1.8",
-    "@tanstack/node-db-sqlite-persistence": "^0.1.8",
-    "@tanstack/offline-transactions": "^1.0.29",
-    "@tanstack/query-db-collection": "^1.0.35",
-    "@tanstack/react-db": "^0.1.82",
+    "@tanstack/electron-db-sqlite-persistence": "^0.1.9",
+    "@tanstack/node-db-sqlite-persistence": "^0.1.9",
+    "@tanstack/offline-transactions": "^1.0.30",
+    "@tanstack/query-db-collection": "^1.0.36",
+    "@tanstack/react-db": "^0.1.83",
     "@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.6.4",
-    "@tanstack/offline-transactions": "^1.0.29",
-    "@tanstack/query-db-collection": "^1.0.35",
-    "@tanstack/react-db": "^0.1.82",
-    "@tanstack/react-native-db-sqlite-persistence": "^0.1.8",
+    "@tanstack/db": "^0.6.5",
+    "@tanstack/offline-transactions": "^1.0.30",
+    "@tanstack/query-db-collection": "^1.0.36",
+    "@tanstack/react-db": "^0.1.83",
+    "@tanstack/react-native-db-sqlite-persistence": "^0.1.9",
     "@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.6.4",
-    "@tanstack/electric-db-collection": "^0.3.2",
-    "@tanstack/offline-transactions": "^1.0.29",
-    "@tanstack/react-db": "^0.1.82",
-    "@tanstack/react-native-db-sqlite-persistence": "^0.1.8",
+    "@tanstack/db": "^0.6.5",
+    "@tanstack/electric-db-collection": "^0.3.3",
+    "@tanstack/offline-transactions": "^1.0.30",
+    "@tanstack/react-db": "^0.1.83",
+    "@tanstack/react-native-db-sqlite-persistence": "^0.1.9",
     "@tanstack/react-query": "^5.90.20",
     "expo": "~53.0.26",
     "expo-constants": "~17.1.0",

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.1.8",
-    "@tanstack/db": "^0.6.4",
-    "@tanstack/offline-transactions": "^1.0.29",
-    "@tanstack/query-db-collection": "^1.0.35",
-    "@tanstack/react-db": "^0.1.82",
+    "@tanstack/browser-db-sqlite-persistence": "^0.1.9",
+    "@tanstack/db": "^0.6.5",
+    "@tanstack/offline-transactions": "^1.0.30",
+    "@tanstack/query-db-collection": "^1.0.36",
+    "@tanstack/react-db": "^0.1.83",
     "@tanstack/react-query": "^5.90.20",
     "@tanstack/react-router": "^1.159.5",
     "@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.6.4",
-    "@tanstack/react-db": "^0.1.82",
+    "@tanstack/db": "^0.6.5",
+    "@tanstack/react-db": "^0.1.83",
     "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.0.35",
-    "@tanstack/react-db": "^0.1.82",
+    "@tanstack/query-db-collection": "^1.0.36",
+    "@tanstack/react-db": "^0.1.83",
     "@tanstack/react-router": "^1.159.5",
     "@tanstack/react-router-devtools": "^1.159.5",
     "@tanstack/react-router-with-query": "^1.130.17",

diff --git a/examples/react/todo/package.json b/examples/react/todo/package.json
@@ -3,13 +3,13 @@
   "private": true,
   "version": "0.1.25",
   "dependencies": {
-    "@tanstack/electric-db-collection": "^0.3.2",
+    "@tanstack/electric-db-collection": "^0.3.3",
     "@tanstack/query-core": "^5.90.20",
-    "@tanstack/query-db-collection": "^1.0.35",
-    "@tanstack/react-db": "^0.1.82",
+    "@tanstack/query-db-collection": "^1.0.36",
+    "@tanstack/react-db": "^0.1.83",
     "@tanstack/react-router": "^1.159.5",
     "@tanstack/react-start": "^1.159.5",
-    "@tanstack/trailbase-db-collection": "^0.1.82",
+    "@tanstack/trailbase-db-collection": "^0.1.83",
     "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.35",
   "dependencies": {
-    "@tanstack/electric-db-collection": "^0.3.2",
+    "@tanstack/electric-db-collection": "^0.3.3",
     "@tanstack/query-core": "^5.90.20",
-    "@tanstack/query-db-collection": "^1.0.35",
-    "@tanstack/solid-db": "^0.2.18",
+    "@tanstack/query-db-collection": "^1.0.36",
+    "@tanstack/solid-db": "^0.2.19",
     "@tanstack/solid-router": "^1.159.5",
     "@tanstack/solid-start": "^1.159.5",
-    "@tanstack/trailbase-db-collection": "^0.1.82",
+    "@tanstack/trailbase-db-collection": "^0.1.83",
     "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.1.65
+
+### Patch Changes
+
+- Updated dependencies [[`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb), [`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb)]:
+  - @tanstack/db@0.6.5
+
 ## 0.1.64
 
 ### 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.1.64",
+  "version": "0.1.65",
   "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.1.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/db-sqlite-persistence-core@0.1.9
+
 ## 0.1.8
 
 ### 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.1.8",
+  "version": "0.1.9",
   "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.1.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/db-sqlite-persistence-core@0.1.9
+
 ## 0.1.8
 
 ### 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.9
+
+### Patch Changes
+
+- Updated dependencies [[`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb), [`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb)]:
+  - @tanstack/db@0.6.5
+  - @tanstack/capacitor-db-sqlite-persistence@0.1.9
+
 ## 0.0.8
 
 ### 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.8",
+  "version": "0.0.9",
   "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.1.8",
+  "version": "0.1.9",
   "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.1.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/db-sqlite-persistence-core@0.1.9
+
 ## 0.1.8
 
 ### 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.1.8",
+  "version": "0.1.9",
   "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,12 @@
 # @tanstack/db-sqlite-persistence-core
 
+## 0.1.9
+
+### Patch Changes
+
+- Updated dependencies [[`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb), [`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb)]:
+  - @tanstack/db@0.6.5
+
 ## 0.1.8
 
 ### 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.1.8",
+  "version": "0.1.9",
   "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,17 @@
 # @tanstack/db
 
+## 0.6.5
+
+### Patch Changes
+
+- fix: pass child where clauses to loadSubset in includes ([#1471](https://github.com/TanStack/db/pull/1471))
+
+  Pure-child WHERE clauses on includes subqueries (e.g., `.where(({ item }) => eq(item.status, 'active'))`) are now passed through to the child collection's `loadSubset`/`queryFn`, enabling server-side filtering. Previously only the correlation filter reached the sync layer; additional child filters were applied client-side only.
+
+- fix: lazy load includes child collections in on-demand sync mode ([#1471](https://github.com/TanStack/db/pull/1471))
+
+  Includes child collections now use the same lazy loading mechanism as regular joins. When a query uses includes with a correlation WHERE clause (e.g., `.where(({ item }) => eq(item.rootId, r.id))`), only matching child rows are loaded on-demand via `requestSnapshot({ where: inArray(field, keys) })` instead of loading all data upfront. This ensures the sync layer's `queryFn` receives the correlation filter in `loadSubsetOptions`, enabling efficient server-side filtering.
+
 ## 0.6.4
 
 ### Patch Changes

diff --git a/packages/db/package.json b/packages/db/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/db",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "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.3.3
+
+### Patch Changes
+
+- Updated dependencies [[`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb), [`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb)]:
+  - @tanstack/db@0.6.5
+
 ## 0.3.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.3.2",
+  "version": "0.3.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.1.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/db-sqlite-persistence-core@0.1.9
+
 ## 0.1.8
 
 ### 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.1.8",
+  "version": "0.1.9",
   "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.1.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @tanstack/db-sqlite-persistence-core@0.1.9
+
 ## 0.1.8
 
 ### Patch Changes

diff --git a/packages/expo-db-sqlite-persistence/e2e/expo-runtime-app/CHANGELOG.md b/packages/expo-db-sqlite-persistence/e2e/expo-runtime-app/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @tanstack/expo-db-sqlite-persistence-e2e-app
 
+## 0.0.9
+
+### Patch Changes
+
+- Updated dependencies [[`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb), [`232f228`](https://github.com/TanStack/db/commit/232f22845ddfe179a803a241f95a3375ae63a1fb)]:
+  - @tanstack/db@0.6.5
+  - @tanstack/expo-db-sqlite-persistence@0.1.9
+
 ## 0.0.8
 
 ### Patch Changes

diff --git a/packages/expo-db-sqlite-persistence/e2e/expo-runtime-app/package.json b/packages/expo-db-sqlite-persistence/e2e/expo-runtime-app/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/expo-db-sqlite-persistence-e2e-app",
   "private": true,
-  "version": "0.0.8",
+  "version": "0.0.9",
   "main": "index.js",
   "scripts": {
     "start": "expo start",

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