feat: Cloudflare DO SQLite persisted collection by kevin-dp · Pull Request #1360 · TanStack/db

kevin-dp · 2026-03-12T09:19:28Z

Summary

Follow-up to #1358 (core persistence). Adds the Cloudflare Durable Object SQLite persistence package:

db-cloudflare-do-sqlite-persisted-collection — Cloudflare Durable Object persistence with wrangler e2e tests

Test plan

Cloudflare DO driver and persistence unit tests pass
Cloudflare DO core adapter contract tests pass
Cloudflare DO wrangler e2e tests pass

🤖 Generated with Claude Code

changeset-bot · 2026-03-12T09:19:34Z

⚠️ No Changeset found

Latest commit: fca6dae

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

pkg-pr-new · 2026-03-12T09:21:44Z

More templates

@tanstack/angular-db

npm i https://pkg.pr.new/TanStack/db/@tanstack/angular-db@1360

@tanstack/db

npm i https://pkg.pr.new/TanStack/db/@tanstack/db@1360

@tanstack/db-browser-wa-sqlite-persisted-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-browser-wa-sqlite-persisted-collection@1360

@tanstack/db-cloudflare-do-sqlite-persisted-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-cloudflare-do-sqlite-persisted-collection@1360

@tanstack/db-electron-sqlite-persisted-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-electron-sqlite-persisted-collection@1360

@tanstack/db-ivm

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-ivm@1360

@tanstack/db-node-sqlite-persisted-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-node-sqlite-persisted-collection@1360

@tanstack/db-react-native-sqlite-persisted-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-react-native-sqlite-persisted-collection@1360

@tanstack/db-sqlite-persisted-collection-core

npm i https://pkg.pr.new/TanStack/db/@tanstack/db-sqlite-persisted-collection-core@1360

@tanstack/electric-db-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/electric-db-collection@1360

@tanstack/offline-transactions

npm i https://pkg.pr.new/TanStack/db/@tanstack/offline-transactions@1360

@tanstack/powersync-db-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/powersync-db-collection@1360

@tanstack/query-db-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/query-db-collection@1360

@tanstack/react-db

npm i https://pkg.pr.new/TanStack/db/@tanstack/react-db@1360

@tanstack/rxdb-db-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/rxdb-db-collection@1360

@tanstack/solid-db

npm i https://pkg.pr.new/TanStack/db/@tanstack/solid-db@1360

@tanstack/svelte-db

npm i https://pkg.pr.new/TanStack/db/@tanstack/svelte-db@1360

@tanstack/trailbase-db-collection

npm i https://pkg.pr.new/TanStack/db/@tanstack/trailbase-db-collection@1360

@tanstack/vue-db

npm i https://pkg.pr.new/TanStack/db/@tanstack/vue-db@1360

commit: 78afbfd

github-actions · 2026-03-12T09:22:22Z

Size Change: 0 B

Total Size: 110 kB

ℹ️ View Unchanged

Filename	Size
`./packages/db/dist/esm/collection/change-events.js`	1.39 kB
`./packages/db/dist/esm/collection/changes.js`	1.38 kB
`./packages/db/dist/esm/collection/cleanup-queue.js`	810 B
`./packages/db/dist/esm/collection/events.js`	434 B
`./packages/db/dist/esm/collection/index.js`	3.69 kB
`./packages/db/dist/esm/collection/indexes.js`	2.35 kB
`./packages/db/dist/esm/collection/lifecycle.js`	1.76 kB
`./packages/db/dist/esm/collection/mutations.js`	2.47 kB
`./packages/db/dist/esm/collection/state.js`	5.2 kB
`./packages/db/dist/esm/collection/subscription.js`	3.71 kB
`./packages/db/dist/esm/collection/sync.js`	2.43 kB
`./packages/db/dist/esm/collection/transaction-metadata.js`	144 B
`./packages/db/dist/esm/deferred.js`	207 B
`./packages/db/dist/esm/errors.js`	4.83 kB
`./packages/db/dist/esm/event-emitter.js`	748 B
`./packages/db/dist/esm/index.js`	2.85 kB
`./packages/db/dist/esm/indexes/auto-index.js`	777 B
`./packages/db/dist/esm/indexes/base-index.js`	766 B
`./packages/db/dist/esm/indexes/btree-index.js`	2.17 kB
`./packages/db/dist/esm/indexes/lazy-index.js`	1.24 kB
`./packages/db/dist/esm/indexes/reverse-index.js`	538 B
`./packages/db/dist/esm/local-only.js`	890 B
`./packages/db/dist/esm/local-storage.js`	2.1 kB
`./packages/db/dist/esm/optimistic-action.js`	359 B
`./packages/db/dist/esm/paced-mutations.js`	496 B
`./packages/db/dist/esm/proxy.js`	3.75 kB
`./packages/db/dist/esm/query/builder/functions.js`	792 B
`./packages/db/dist/esm/query/builder/index.js`	5.15 kB
`./packages/db/dist/esm/query/builder/ref-proxy.js`	1.05 kB
`./packages/db/dist/esm/query/compiler/evaluators.js`	1.62 kB
`./packages/db/dist/esm/query/compiler/expressions.js`	430 B
`./packages/db/dist/esm/query/compiler/group-by.js`	2.69 kB
`./packages/db/dist/esm/query/compiler/index.js`	3.62 kB
`./packages/db/dist/esm/query/compiler/joins.js`	2.11 kB
`./packages/db/dist/esm/query/compiler/order-by.js`	1.5 kB
`./packages/db/dist/esm/query/compiler/select.js`	1.11 kB
`./packages/db/dist/esm/query/effect.js`	4.78 kB
`./packages/db/dist/esm/query/expression-helpers.js`	1.43 kB
`./packages/db/dist/esm/query/ir.js`	784 B
`./packages/db/dist/esm/query/live-query-collection.js`	360 B
`./packages/db/dist/esm/query/live/collection-config-builder.js`	7.63 kB
`./packages/db/dist/esm/query/live/collection-registry.js`	264 B
`./packages/db/dist/esm/query/live/collection-subscriber.js`	1.94 kB
`./packages/db/dist/esm/query/live/internal.js`	145 B
`./packages/db/dist/esm/query/live/utils.js`	1.57 kB
`./packages/db/dist/esm/query/optimizer.js`	2.62 kB
`./packages/db/dist/esm/query/predicate-utils.js`	2.97 kB
`./packages/db/dist/esm/query/query-once.js`	359 B
`./packages/db/dist/esm/query/subset-dedupe.js`	960 B
`./packages/db/dist/esm/scheduler.js`	1.3 kB
`./packages/db/dist/esm/SortedMap.js`	1.3 kB
`./packages/db/dist/esm/strategies/debounceStrategy.js`	247 B
`./packages/db/dist/esm/strategies/queueStrategy.js`	428 B
`./packages/db/dist/esm/strategies/throttleStrategy.js`	246 B
`./packages/db/dist/esm/transactions.js`	2.9 kB
`./packages/db/dist/esm/utils.js`	927 B
`./packages/db/dist/esm/utils/browser-polyfills.js`	304 B
`./packages/db/dist/esm/utils/btree.js`	5.61 kB
`./packages/db/dist/esm/utils/comparison.js`	1.05 kB
`./packages/db/dist/esm/utils/cursor.js`	457 B
`./packages/db/dist/esm/utils/index-optimization.js`	1.54 kB
`./packages/db/dist/esm/utils/type-guards.js`	157 B
`./packages/db/dist/esm/virtual-props.js`	360 B

_{compressed-size-action::db-package-size}

github-actions · 2026-03-12T09:23:00Z

Size Change: 0 B

Total Size: 4.23 kB

ℹ️ View Unchanged

Filename	Size
`./packages/react-db/dist/esm/index.js`	249 B
`./packages/react-db/dist/esm/useLiveInfiniteQuery.js`	1.32 kB
`./packages/react-db/dist/esm/useLiveQuery.js`	1.34 kB
`./packages/react-db/dist/esm/useLiveQueryEffect.js`	355 B
`./packages/react-db/dist/esm/useLiveSuspenseQuery.js`	559 B
`./packages/react-db/dist/esm/usePacedMutations.js`	401 B

_{compressed-size-action::react-db-package-size}

samwillis

just need a patch changeset

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…ti-tab support Web Locks for per-collection leadership election, BroadcastChannel for cross-tab RPC transport, DB writer lock for SQLite write serialization, envelope dedup for exactly-once mutations, and leader heartbeats. Includes 15 unit tests with Web Locks/BroadcastChannel mocks. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

… follow-up branches Remove db-electron-sqlite-persisted-collection, db-node-sqlite-persisted-collection, and db-cloudflare-do-sqlite-persisted-collection from this branch so it contains only the core persistence packages (db, db-sqlite-persisted-collection-core, db-browser-wa-sqlite-persisted-collection, db-react-native-sqlite-persisted-collection). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Restore db-node-sqlite-persisted-collection (better-sqlite3 driver) and db-cloudflare-do-sqlite-persisted-collection (Durable Object driver) with their test suites and e2e configurations. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The node SQLite driver is needed by the electron package tests, so it has been moved to the kevin/persistence-electron branch instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…DO driver The rebase duplicated the applied_tx age-based pruning DELETE. The second copy used this.driver instead of the transaction driver parameter, which deadlocked the cloudflare DO driver's serialized queue. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…tures Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

The runtime bridge e2e test used exact equality which fails now that collections include virtual props ($collectionId, $key, $origin, $synced). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…ommits These packages were removed from this branch before they were merged to main. Now that they're on main, the extraction commits incorrectly delete them during rebase. Restore them from main. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…e-cloudflare # Conflicts: # pnpm-lock.yaml

These were removed by the extraction commits but the packages are back on main now. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

kevin-dp mentioned this pull request Mar 12, 2026

feat: SQLite persistence core #1358

Merged

5 tasks

kevin-dp changed the title ~~feat: Node and Cloudflare DO SQLite persisted collections~~ feat: Cloudflare DO SQLite persisted collection Mar 12, 2026

kevin-dp force-pushed the kevin/persistence branch 2 times, most recently from 38ea25f to 9ce6ae0 Compare March 12, 2026 10:59

samwillis approved these changes Mar 16, 2026

View reviewed changes

kevin-dp force-pushed the kevin/persistence branch 2 times, most recently from 37c3bf5 to ca46819 Compare March 16, 2026 11:30

Base automatically changed from kevin/persistence to main March 16, 2026 12:48

kevin-dp force-pushed the kevin/persistence-node-cloudflare branch from fca6dae to 00164f5 Compare March 19, 2026 13:17

cursoragent and others added 17 commits March 19, 2026 15:22

docs: add sqlite persistence plan and phased guard rails

0936900

feat: add sqlite persisted collection core phase-0 package

85d85cc

feat(db): harden index lifecycle contract for phase-2 bootstrap

f41b973

feat: add time-based applied_tx pruning policy

e378898

feat: add node sqlite persisted collection package

1e3a411

fix: add better-sqlite3 type definitions for node adapter

525615c

feat: add electron sqlite ipc bridge package

4699e82

test: add portable runtime bridge e2e contract

ef7b6a8

ci: apply automated fixes

9d21869

fix: stabilize electron runtime bridge e2e harness

2732e44

test: run electron runtime e2e via built fixtures

47d4803

fix: use cjs preload for electron runtime bridge e2e

fe7c872

feat: add react-native/expo sqlite persisted collection package

e5b81f1

ci: apply automated fixes

37ce1ac

fix: align mobile adapter typing and burst persistence test

8f62c48

ci: apply automated fixes

3d2455a

feat: add cloudflare DO sqlite persistence with wrangler e2e

d205281

cursoragent and others added 24 commits March 19, 2026 15:23

refactor: unify sqlite persistence APIs around shared persisters

a165339

refactor: simplify sqlite persistence APIs across runtimes

2f0338d

fix: narrow generic adapter cast in cloudflare persistence

f6e5325

fix(cloudflare-e2e): use collection-resolved adapter in worker fixture

a8ec9ee

feat(sqlite): accept native runtime handles in persistence factories

8efb265

refactor(persistence): require native sqlite handles only

23ee714

chore: refresh pnpm lockfile for cloudflare package peers

a541f69

ci: apply automated fixes

cf0350c

feat(browser): implement phase 7 single-tab persistence

421726a

fix(browser): move phase 7 opfs path into worker

248773d

docs: update phase 8 plan with implementation status annotations

52921b2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

ci: apply automated fixes

25ee6f9

ci: apply automated fixes

9185cc0

chore: remove node sqlite package (moved to electron branch)

1ee199d

The node SQLite driver is needed by the electron package tests, so it has been moved to the kevin/persistence-electron branch instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix: regenerate pnpm-lock.yaml after rebase on main

4784b39

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: remove duplicate CollectionIndexMetadata export from rebase

74264ac

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: remove duplicate type definition from rebase in electron e2e fix…

a7fa293

…tures Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: use objectContaining in e2e contract to handle virtual props

7b32668

The runtime bridge e2e test used exact equality which fails now that collections include virtual props ($collectionId, $key, $origin, $synced). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: remove electron/node changeset that belongs to a different branch

98bb817

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

kevin-dp force-pushed the kevin/persistence-node-cloudflare branch from af3a3ec to 7735fba Compare March 19, 2026 14:27

kevin-dp and others added 2 commits March 19, 2026 15:57

Merge remote-tracking branch 'origin/main' into kevin/persistence-nod…

ac61f21

…e-cloudflare # Conflicts: # pnpm-lock.yaml

ci: restore node and electron e2e test steps in workflow

78afbfd

These were removed by the extraction commits but the packages are back on main now. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

kevin-dp merged commit a7d858e into main Mar 19, 2026
6 of 7 checks passed

kevin-dp deleted the kevin/persistence-node-cloudflare branch March 19, 2026 15:55

github-actions bot mentioned this pull request Mar 19, 2026

ci: Version Packages #1377

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Cloudflare DO SQLite persisted collection#1360

feat: Cloudflare DO SQLite persisted collection#1360
kevin-dp merged 45 commits intomainfrom
kevin/persistence-node-cloudflare

kevin-dp commented Mar 12, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

samwillis left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

kevin-dp commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

changeset-bot bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

pkg-pr-new bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

samwillis left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

kevin-dp commented Mar 12, 2026 •

edited

Loading

changeset-bot bot commented Mar 12, 2026 •

edited

Loading

pkg-pr-new bot commented Mar 12, 2026 •

edited

Loading

github-actions bot commented Mar 12, 2026 •

edited

Loading

github-actions bot commented Mar 12, 2026 •

edited

Loading