Repository navigation
Prepare first TanStack DB 1.0 release candidate - #2171
Open
KyleAMathews wants to merge 16 commits into
Open
KyleAMathews wants to merge 16 commits into
KyleAMathews wants to merge 16 commits into
Conversation
🦋 Changeset detectedLatest commit: fa5a48a The changes in this PR will be included in the next version bump. This PR includes changesets to release 36 packages
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
Contributor
|
Important Review skippedToo many files! This PR contains 335 files, which is 35 over the limit of 300. To get a review, reduce the PR to 300 files or fewer by splitting it into smaller PRs or changing its base branch. Usage-priced reviews support at most 300 files. ⚙️ Run configuration
⛔ Files ignored due to path filters: 1
📒 Files selected for processing: 335
You can disable this status message by setting the
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. Comment |
Contributor
|
Size Change: -700 B (-0.32%) Total Size: 217 kB 📦 View Changed
ℹ️ View Unchanged
|
Contributor
Incremental update benchmarkComparing Overall median write time vs base: 1.03× · cold hydrate time: 1.03× (geometric mean of per-case ratios; lower is faster). Writes: 0 regression(s), 1 improvement(s) (threshold: ±20% and >0.05ms). Cold hydrate: 1 regression(s), 1 improvement(s) (threshold: ±50% and >5ms). Per-case flags are noisy on shared runners. Read the geometric means first. Writes
Cold hydrate
Each row aggregates the 14.4 scale/index/write-mode configurations of that query; per-configuration tables below. 100 rows/collection | source indexes: none | synced writes — geomean 1.00×, cold 0.89×
100 rows/collection | source indexes: none | optimistic writes — geomean 1.05×, cold 1.08×
100 rows/collection | source indexes: manual | synced writes — geomean 1.04×, cold 1.04×
100 rows/collection | source indexes: manual | optimistic writes — geomean 1.03×, cold 0.95×
1,000 rows/collection | source indexes: none | synced writes — geomean 0.90×, cold 1.16×, 2 change(s)
1,000 rows/collection | source indexes: none | optimistic writes — geomean 1.09×, cold 0.93×
1,000 rows/collection | source indexes: manual | synced writes — geomean 1.04×, cold 1.34×
1,000 rows/collection | source indexes: manual | optimistic writes — geomean 1.04×, cold 0.86×, 1 change(s)
10,000 rows/collection | source indexes: none | synced writes — geomean 1.07×, cold 1.07×
10,000 rows/collection | source indexes: none | optimistic writes — geomean 1.04×, cold 1.00×
10,000 rows/collection | source indexes: manual | synced writes — geomean 1.01×, cold 1.14×
10,000 rows/collection | source indexes: manual | optimistic writes — geomean 1.09×, cold 1.01×
Runner: node v24.8.0, linux 6.17.0-1022-azure, AMD EPYC 7763 64-Core Processor. Timings on shared CI runners are noisy; treat small deltas as indicative only. |
More templates
@tanstack/angular-db
@tanstack/browser-db-sqlite-persistence
@tanstack/capacitor-db-sqlite-persistence
@tanstack/cloudflare-durable-objects-db-sqlite-persistence
@tanstack/db
@tanstack/db-ivm
@tanstack/db-sqlite-persistence-core
@tanstack/electric-db-collection
@tanstack/electron-db-sqlite-persistence
@tanstack/expo-db-sqlite-persistence
@tanstack/node-db-sqlite-persistence
@tanstack/offline-transactions
@tanstack/powersync-db-collection
@tanstack/query-db-collection
@tanstack/react-db
@tanstack/react-native-db-sqlite-persistence
@tanstack/react-router-with-db
@tanstack/rxdb-db-collection
@tanstack/solid-db
@tanstack/svelte-db
@tanstack/tauri-db-sqlite-persistence
@tanstack/trailbase-db-collection
@tanstack/vue-db
commit: |
added 10 commits
October 15, 2026 09:17
# Conflicts: # docs/contributing/oracle-coverage.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Prepare TanStack DB for its first 1.0 release candidate. Remove the deprecated APIs in #1319 and document recent migration steps.
This PR also keeps virtual metadata tied to the selected source row. The release scripts support ordinary Changesets throughout the RC period.
API and migration
Replace
$syncedwith$hasPendingWrites. Replacetransaction.isPersistedwithtransaction.when('settled').Remove deprecated handler return values, React hook dependency arrays, and Solid query
.dataaccess. Electric mutation handlers now reject returned values. Awaitcollection.utils.awaitTxId(txid)orawaitMatch()inside the handler.A live query protects
$hasPendingWrites,$origin,$key, and$collectionIdon published Collection rows. A selected joined row keeps its source metadata. With multiple source spreads, the last spread supplies that metadata. Collection-valued includes follow the same rule. Inline query values keep their selected shape.Client renders can use
getKeyorschemawithout a ReactqueryKey. Keep those option references stable across renders. SSR streaming still needs an explicit, serializablequeryKey.The migration guide covers these removals and changes since
@tanstack/db@0.9.2in September. It includes Query Collection writes, IndexedDB imports, sync and persistence contracts, query windows, and adapter requirements.Release process
The first Changeset versions all 21 public packages below 1.0 as
1.0.0-rc.1.Query Collection and Offline Transactions accidentally reached 1.x before this RC. They stay on 1.x and receive compatibility patches. Both packages now accept
@tanstack/dbthrough the peer range^0.15.0 || ^1.0.0-rc.0.During the RC, maintainers can add ordinary Changesets:
1.0.0-rc.1to1.0.0-rc.1.1, then to1.0.0-rc.1.2.1.0.0-rc.1.2to1.0.0-rc.2.The publish command sends stable compatibility patches to npm's
latesttag first. It then sends candidate packages to therctag. Both passes use the existing publish authentication.For the final 1.0 release, commit the result of
pnpm changeset pre exit. The next Version Packages PR promotes candidates to1.0.0. Exit applies only pending Changesets. It also includes dependent bumps when an exact workspace dependency must change.Verification
fa5a48a6d, including both DB shards and browser, desktop, and cloud/mobile E2E. CodeRabbit skipped its review because 335 changed files exceed its 300-file limit.pnpm test:release: 9 tests passed after the latest main merge.pnpm test:sherifpassed after the peer dependency order fix.pnpm test:docsstill reports 32 existing links outside/docs. None points to the edited migration guide.Closes #1319.