ci: Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@tanstack/db@0.10.0

Minor Changes

• Deprecation: Mutation handler return values and QueryCollection auto-refetch behavior. (#843)

  What's changed:

  • Handler return values remain type-compatible during the deprecation window
  • Deprecation warnings are logged when deprecated patterns are used

  QueryCollection changes:

  • Auto-refetch after handlers is deprecated and will be removed in v1.0
  • To skip auto-refetch now, return { refetch: false } from your handler
  • To migrate to explicit refetch now, await collection.utils.refetch() and return { refetch: false } to prevent a second fetch; remove the return in v1.0
  • In v1.0, call await collection.utils.refetch() explicitly when needed, or omit it to skip

  ElectricCollection changes:

  • Returning { txid } is deprecated - use await collection.utils.awaitTxId(txid) instead
  • The default awaitTxId and awaitMatch timeouts increase to 15 seconds

  Migration guide:

  // QueryCollection - skip refetch (current)
  onInsert: async ({ transaction }) => {
    await api.create(transaction.mutations[0].modified)
    return { refetch: false } // Opt out of auto-refetch
  }
  
  // QueryCollection - migrate to explicit refetch now
  onInsert: async ({ transaction, collection }) => {
    await api.create(transaction.mutations[0].modified)
    await collection.utils.refetch() // Explicit refetch
    return { refetch: false } // Prevent a second pre-1.0 refetch; remove in v1.0
  }
  
  // ElectricCollection - before
  onInsert: async ({ transaction }) => {
    const result = await api.create(transaction.mutations[0].modified)
    return { txid: result.txid } // Deprecated
  }
  
  // ElectricCollection - after
  onInsert: async ({ transaction, collection }) => {
    const result = await api.create(transaction.mutations[0].modified)
    await collection.utils.awaitTxId(result.txid) // Explicit
  }

• Require Collection.update keys to match the collection's declared key type. (#1851)
  Calls that pass possibly undefined keys (including unchecked indexed access) or
  plain strings to branded-key collections must narrow or assert those values to
  the declared key type before calling update.

• Keep virtual row fields on inferred collection and query row roots without (#1865)
  exposing them on nested user objects or projected child values.
  Default Ref<T> and SingleRowRefProxy<T> annotations now support reusable
  helpers for both root and nested refs; helpers that require row metadata should
  set their third generic parameter to true. Preserve discriminated unions when
  removing virtual row fields.

• Preserve collection key and adapter utility types throughout mutation handlers and nested transaction mutations. Mutation keys now use the collection's declared key type instead of any; collections that use the default key type expose string | number. Prevent Query and Electric collections from exposing nonexistent cross-adapter utilities. (#1849)

Patch Changes

• Document oracle tests as executable subsystem models, align their vocabulary with production code, and make deterministic failures easier to replay. (#1870)

• Restrict built-in aggregate helpers to their supported value domains so numeric aggregates and min/max no longer advertise impossible runtime result types. (#1862)

• Preserve explicit locale settings when locale sorting is selected by default and omit unset locale fields from collection comparison options. (#1833)

• Fix same-key delete-then-insert reduction, preserve whole-row replacements through local adapters, and publish immutable previous values for live-object and replacement-object sync updates. Same-reference live rows still require an immutable provider previousValue; stale or partial values on that reused reference remain unsupported. (#1835)

• Preserve null alongside undefined when nullable fields flow through query references, selected results, and branch unions. (#1852)

• Start idle collections only after locally decidable mutation validation succeeds, and publish authoritative Query Collection refetch results without stale intermediate snapshots. (#1840)

• Align live-query join keys with established predicate equality for binary, temporal, Date, and opaque values, including on-demand collection loading, and prevent nullish operands from matching in full and correlated joins. (#1834)

• Preserve whole-object nullability through supported join and unionAll projections, retain intrinsic nullish fields when right/full joins follow branch unions, and preserve constrained generic fields through supported join and unionAll query chains. (#1843)

• Preserve only captured accepted local inserts across a truncate. Preserve sparse-array length and RegExp state through ordered-query hashing, including hosts without a global File constructor. Prevent delayed replay reads from rerunning any transaction removed while the read was in flight, without rescanning the outbox. (#1822)

• Allow collection index and change-filter callbacks to traverse optional or nullable nested plain objects with optional chaining while preserving built-in values and functions as query leaves. (#1850)

• Updated dependencies [3ad64a4]:

  • @tanstack/db-ivm@0.1.23

@tanstack/electric-db-collection@0.5.0

Minor Changes

• Deprecation: Mutation handler return values and QueryCollection auto-refetch behavior. (#843)

  What's changed:

  • Handler return values remain type-compatible during the deprecation window
  • Deprecation warnings are logged when deprecated patterns are used

  QueryCollection changes:

  • Auto-refetch after handlers is deprecated and will be removed in v1.0
  • To skip auto-refetch now, return { refetch: false } from your handler
  • To migrate to explicit refetch now, await collection.utils.refetch() and return { refetch: false } to prevent a second fetch; remove the return in v1.0
  • In v1.0, call await collection.utils.refetch() explicitly when needed, or omit it to skip

  ElectricCollection changes:

  • Returning { txid } is deprecated - use await collection.utils.awaitTxId(txid) instead
  • The default awaitTxId and awaitMatch timeouts increase to 15 seconds

  Migration guide:

  // QueryCollection - skip refetch (current)
  onInsert: async ({ transaction }) => {
    await api.create(transaction.mutations[0].modified)
    return { refetch: false } // Opt out of auto-refetch
  }
  
  // QueryCollection - migrate to explicit refetch now
  onInsert: async ({ transaction, collection }) => {
    await api.create(transaction.mutations[0].modified)
    await collection.utils.refetch() // Explicit refetch
    return { refetch: false } // Prevent a second pre-1.0 refetch; remove in v1.0
  }
  
  // ElectricCollection - before
  onInsert: async ({ transaction }) => {
    const result = await api.create(transaction.mutations[0].modified)
    return { txid: result.txid } // Deprecated
  }
  
  // ElectricCollection - after
  onInsert: async ({ transaction, collection }) => {
    const result = await api.create(transaction.mutations[0].modified)
    await collection.utils.awaitTxId(result.txid) // Explicit
  }

• Preserve collection key and adapter utility types throughout mutation handlers and nested transaction mutations. Mutation keys now use the collection's declared key type instead of any; collections that use the default key type expose string | number. Prevent Query and Electric collections from exposing nonexistent cross-adapter utilities. (#1849)

Patch Changes

• Preserve PostgreSQL semantics for boolean comparisons and array membership, (#1832)
  including nullable values, compatible reference-to-array types, and non-text
  array elements. Reject nullish membership operands and literal-array left
  operands, and escape quotes in mapped column names.
• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/powersync-db-collection@0.2.0

Minor Changes

• Require PowerSync 2 and fix update conservation, declared-view rows, transformed-schema comparison, and portable inferred declarations. (#1831)

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/query-db-collection@1.3.0

Minor Changes

• Deprecation: Mutation handler return values and QueryCollection auto-refetch behavior. (#843)

  What's changed:

  • Handler return values remain type-compatible during the deprecation window
  • Deprecation warnings are logged when deprecated patterns are used

  QueryCollection changes:

  • Auto-refetch after handlers is deprecated and will be removed in v1.0
  • To skip auto-refetch now, return { refetch: false } from your handler
  • To migrate to explicit refetch now, await collection.utils.refetch() and return { refetch: false } to prevent a second fetch; remove the return in v1.0
  • In v1.0, call await collection.utils.refetch() explicitly when needed, or omit it to skip

  ElectricCollection changes:

  • Returning { txid } is deprecated - use await collection.utils.awaitTxId(txid) instead
  • The default awaitTxId and awaitMatch timeouts increase to 15 seconds

  Migration guide:

  // QueryCollection - skip refetch (current)
  onInsert: async ({ transaction }) => {
    await api.create(transaction.mutations[0].modified)
    return { refetch: false } // Opt out of auto-refetch
  }
  
  // QueryCollection - migrate to explicit refetch now
  onInsert: async ({ transaction, collection }) => {
    await api.create(transaction.mutations[0].modified)
    await collection.utils.refetch() // Explicit refetch
    return { refetch: false } // Prevent a second pre-1.0 refetch; remove in v1.0
  }
  
  // ElectricCollection - before
  onInsert: async ({ transaction }) => {
    const result = await api.create(transaction.mutations[0].modified)
    return { txid: result.txid } // Deprecated
  }
  
  // ElectricCollection - after
  onInsert: async ({ transaction, collection }) => {
    const result = await api.create(transaction.mutations[0].modified)
    await collection.utils.awaitTxId(result.txid) // Explicit
  }

• Preserve collection key and adapter utility types throughout mutation handlers and nested transaction mutations. Mutation keys now use the collection's declared key type instead of any; collections that use the default key type expose string | number. Prevent Query and Electric collections from exposing nonexistent cross-adapter utilities. (#1849)

Patch Changes

• Add createCursorPager to fulfill offset/limit requests from endpoints with opaque continuation tokens. Reuse fresh backend pages through the existing QueryClient, with Query-managed expiry, invalidation and garbage collection, while retaining the existing UI peek-ahead behavior. (#1824)

  Keep manual raw-row writes from overwriting other cache formats or marking them fresh. Preserve wrapped-response writes and seeding of empty row caches.

• Keep on-demand Query cache ownership and post-write readiness isolated across collections, co-owners, deferred cleanup, errors, and custom query hashes. Active enabled scopes revalidate from post-write provider results, while inactive collection-owned entries are removed without disturbing unrelated or foreign-observed Queries. (#1826)

• Start idle collections only after locally decidable mutation validation succeeds, and publish authoritative Query Collection refetch results without stale intermediate snapshots. (#1840)

• Fix queryCollectionOptions to accept selectors that materialize transforming schema outputs from wrapped responses while preserving schema input types for mutations. (#1861)

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:

  • @tanstack/db@0.10.0

@tanstack/angular-db@0.1.92

Patch Changes

• Preserve pre-created collection row, key, and utility types in React infinite (#1864)
  queries. Align conditional live-query result types with each framework's
  disabled representation, including nullable collections, disabled statuses,
  and empty single-result data in the empty-reactive bindings.
• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/browser-db-sqlite-persistence@0.2.24

Patch Changes

• Terminate OPFS workers on pagehide, including during initialization, and reject pending requests with AbortError. Include available VFS error details in SQLite open failures. Connections must be recreated when restoring a document from the back/forward cache. (#1844)

• Updated dependencies [3d96614]:

  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/capacitor-db-sqlite-persistence@0.2.24

Patch Changes

• Updated dependencies [3d96614]:
  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/cloudflare-durable-objects-db-sqlite-persistence@0.2.24

Patch Changes

• Updated dependencies [3d96614]:
  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/db-ivm@0.1.23

Patch Changes

• Preserve only captured accepted local inserts across a truncate. Preserve sparse-array length and RegExp state through ordered-query hashing, including hosts without a global File constructor. Prevent delayed replay reads from rerunning any transaction removed while the read was in flight, without rescanning the outbox. (#1822)

@tanstack/db-sqlite-persistence-core@0.2.24

Patch Changes

• Preserve schema input and output inference when persisted collection options are passed to createCollection. Accept Expo's native SQLite database type and preserve transaction callback results while validating bind values against Expo's supported domain. (#1866)

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:

  • @tanstack/db@0.10.0

@tanstack/electron-db-sqlite-persistence@0.1.36

Patch Changes

• Updated dependencies [3d96614]:
  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/expo-db-sqlite-persistence@0.2.24

Patch Changes

• Preserve schema input and output inference when persisted collection options are passed to createCollection. Accept Expo's native SQLite database type and preserve transaction callback results while validating bind values against Expo's supported domain. (#1866)

• Updated dependencies [3d96614]:

  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/node-db-sqlite-persistence@0.2.24

Patch Changes

• Updated dependencies [3d96614]:
  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/offline-transactions@1.0.57

Patch Changes

• Fence each successful outbox clear deletion from overlapping reads, including when another deletion is still pending or fails. (#1836)

• Preserve only captured accepted local inserts across a truncate. Preserve sparse-array length and RegExp state through ordered-query hashing, including hosts without a global File constructor. Prevent delayed replay reads from rerunning any transaction removed while the read was in flight, without rescanning the outbox. (#1822)

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:

  • @tanstack/db@0.10.0

@tanstack/react-db@0.4.2

Patch Changes

• Preserve pre-created collection row, key, and utility types in React infinite (#1864)
  queries. Align conditional live-query result types with each framework's
  disabled representation, including nullable collections, disabled statuses,
  and empty single-result data in the empty-reactive bindings.
• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/react-native-db-sqlite-persistence@0.2.24

Patch Changes

• Updated dependencies [3d96614]:
  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/rxdb-db-collection@0.1.98

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/solid-db@0.2.46

Patch Changes

• Preserve pre-created collection row, key, and utility types in React infinite (#1864)
  queries. Align conditional live-query result types with each framework's
  disabled representation, including nullable collections, disabled statuses,
  and empty single-result data in the empty-reactive bindings.

• Keep Solid live-query rows tied to their result identities when custom-key rows (#1825)
  reorder or multiple results share the same public $key.

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:

  • @tanstack/db@0.10.0

@tanstack/svelte-db@0.4.2

Patch Changes

• Preserve pre-created collection row, key, and utility types in React infinite (#1864)
  queries. Align conditional live-query result types with each framework's
  disabled representation, including nullable collections, disabled statuses,
  and empty single-result data in the empty-reactive bindings.
• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/tauri-db-sqlite-persistence@0.2.24

Patch Changes

• Updated dependencies [3d96614]:
  • @tanstack/db-sqlite-persistence-core@0.2.24

@tanstack/trailbase-db-collection@0.1.110

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

@tanstack/vue-db@0.2.2

Patch Changes

• Preserve pre-created collection row, key, and utility types in React infinite (#1864)
  queries. Align conditional live-query result types with each framework's
  disabled representation, including nullable collections, disabled statuses,
  and empty single-result data in the empty-reactive bindings.
• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0

todos@0.0.22

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 8ca04e7, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/angular-db@0.1.92

offline-transactions-react-native@1.0.9

Patch Changes

• Updated dependencies [179d003, b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 8ca04e7, 7f6b643, c479fdc, 09776a8, fdcb078, 76d766e, 1e54c6a, d698b90, 47004bd, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/query-db-collection@1.3.0
  • @tanstack/db@0.10.0
  • @tanstack/react-db@0.4.2
  • @tanstack/offline-transactions@1.0.57
  • @tanstack/react-native-db-sqlite-persistence@0.2.24

shopping-list-react-native@1.0.9

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, b4494fd, 8ca04e7, 7f6b643, c479fdc, 09776a8, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/electric-db-collection@0.5.0
  • @tanstack/react-db@0.4.2
  • @tanstack/offline-transactions@1.0.57
  • @tanstack/react-native-db-sqlite-persistence@0.2.24

@tanstack/db-example-react-next-ssr-e2e@0.0.4

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 8ca04e7, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/react-db@0.4.2

@tanstack/db-example-paced-mutations-demo@0.0.14

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 8ca04e7, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/react-db@0.4.2

@tanstack/db-example-react-todo@0.1.29

Patch Changes

• Updated dependencies [179d003, 84fc44b, b4494fd, 8ca04e7, fdcb078, 76d766e, 47004bd, 71ad428]:
  • @tanstack/query-db-collection@1.3.0
  • @tanstack/electric-db-collection@0.5.0
  • @tanstack/react-db@0.4.2
  • @tanstack/trailbase-db-collection@0.1.110

@tanstack/db-example-solid-todo@0.0.37

Patch Changes

• Updated dependencies [179d003, 84fc44b, b4494fd, 8ca04e7, fdcb078, 76d766e, 47004bd, 1db0729, 71ad428]:
  • @tanstack/query-db-collection@1.3.0
  • @tanstack/electric-db-collection@0.5.0
  • @tanstack/solid-db@0.2.46
  • @tanstack/trailbase-db-collection@0.1.110

@tanstack/capacitor-db-sqlite-persistence-e2e-app@0.0.36

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/capacitor-db-sqlite-persistence@0.2.24

@tanstack/expo-db-sqlite-persistence-e2e-app@0.0.36

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 3d96614, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/expo-db-sqlite-persistence@0.2.24

@tanstack/tauri-db-sqlite-persistence-e2e-app@0.0.36

Patch Changes

• Updated dependencies [b528a61, 84fc44b, 2775082, 1ab1cd3, e5fe2ea, 7f6b643, c479fdc, 76d766e, 1e54c6a, d698b90, 3ad64a4, fc1adde, 9cbc885, 71ad428]:
  • @tanstack/db@0.10.0
  • @tanstack/tauri-db-sqlite-persistence@0.2.24

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 2b796587-65c8-488e-9b6e-2a97d2a5b652

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

---

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.}