feat: add Tauri sqlite persisted collection package

[samwillis]

Summary

• add a @tauri-apps/plugin-sql backed Tauri SQLite persisted-collection package on top of the shared SQLite core
• add driver, adapter, and real Tauri e2e conformance coverage plus the repo-local Tauri harness needed to run it
• document the consumer-side Tauri SQL plugin wiring and runtime caveats without publishing repo-owned Rust integration code

Test plan

• pnpm --filter @tanstack/db-tauri-sqlite-persisted-collection test
• pnpm --filter @tanstack/db-tauri-sqlite-persisted-collection test:e2e

Made with Cursor

[changeset-bot]

⚠️ No Changeset found

Latest commit: 22cc426

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

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: aba2ccda-dab6-4cc8-a082-d5f9d6e446fc

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch samwillis/persistence-tarui

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

More templates

• todos
• tanstack-start-example-basic
• @tanstack/db-example-paced-mutations-demo
• tanstack-start-db-projects-example
• @tanstack/db-example-react-todo
• offline-transactions-react-native
• @tanstack/db-example-solid-todo

@tanstack/angular-db

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

@tanstack/db

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

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

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

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

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

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

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

@tanstack/db-ivm

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

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

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

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

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

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

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

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

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

@tanstack/electric-db-collection

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

@tanstack/offline-transactions

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

@tanstack/powersync-db-collection

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

@tanstack/query-db-collection

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

@tanstack/react-db

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

@tanstack/rxdb-db-collection

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

@tanstack/solid-db

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

@tanstack/svelte-db

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

@tanstack/trailbase-db-collection

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

@tanstack/vue-db

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

commit: 22cc426

[github-actions]

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]

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}

[kevin-dp]

PR Review: #1369 — feat: add Tauri sqlite persisted collection package

Overall

Clean implementation. The driver correctly handles the Tauri SQL plugin's $N placeholder syntax (vs the standard ?), the persistence layer follows established patterns, and the e2e harness uses an HTTP callback server to communicate results from the Tauri process — a smart approach.

Issues to address

1. Missing runtime persistence contract test and persistence integration test — Every other persistence package (Browser, Electron, React Native, Capacitor) includes both a *-runtime-persistence-contract.test.ts and a *-persistence.test.ts. This PR only has the driver contract and core adapter contract tests. The runtime persistence contract validates adapter caching, coordinator defaulting/override, and schema policy inference from sync mode — these aren't covered by the other two contract suites.

2. 5,700-line Cargo.lock checked into the repo — This is the Rust lockfile for the e2e Tauri app. It accounts for ~70% of the PR's additions. Consider adding it to .gitignore for the e2e app (it will be regenerated on build), or at minimum confirm this is intentional since it adds significant noise to the repo and will need ongoing maintenance as Tauri/dependency versions change.

Worth considering

• e2e/app/src/runtime-vitest.ts (545 lines) is duplicated verbatim from the Capacitor PR — Now that two packages need this, it's worth extracting into a shared location.

• convertSqlitePlaceholdersToTauri is a custom SQL parser (~70 lines) that handles quoting, escaping, and comments. It's well-implemented, but the test coverage is thin — only one test (keeps literal question marks untouched while binding positional parameters). Consider adding edge cases for ? inside -- line comments, /* */ block comments, and escaped quotes (''), since the parser explicitly handles all three.

• tsconfig.json includes "jsx": "react" — No JSX in this package; unnecessary.

Summary

Approve with changes — add the two missing test suites (runtime persistence contract + persistence integration) and decide on the Cargo.lock. The core driver and persistence implementations look correct. Also fix the failing CI tests.