fix electric collection progressive mode

[samwillis]

Depends on electric-sql/electric#3463, must have deps bumped to new electric client version when that is released.done

Fix progressive mode to use fetchSnapshot and atomic swap

Progressive mode was broken because requestSnapshot() injected snapshots into the stream in causally correct position, which didn't work properly with the full mode stream. This release fixes progressive mode by:

Core Changes:

• Use fetchSnapshot() during initial sync to fetch and apply snapshots immediately in sync transactions
• Buffer all stream messages during initial sync (renamed flag to isBufferingInitialSync)
• Perform atomic swap on first up-to-date: truncate snapshot data → apply buffered messages → mark ready
• Track txids/snapshots only after atomic swap (enables correct optimistic transaction confirmation)

Test Infrastructure:

• Added ELECTRIC_TEST_HOOKS symbol for test control (hidden from public API)
• Added progressiveTestControl.releaseInitialSync() to E2E test config for explicit transition control
• Created comprehensive progressive mode E2E test suite (8 tests):
  • Explicit snapshot phase and atomic swap validation
  • Txid tracking behavior (Electric-only)
  • Multiple concurrent snapshots with deduplication
  • Incremental updates after swap
  • Predicate handling and resilience tests

Bug Fixes:

• Fixed type errors in test files
• All 166 unit tests + 95 E2E tests passing

[changeset-bot]

🦋 Changeset detected

Latest commit: 2846a6e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 11 packages

Name	Type
@tanstack/electric-db-collection	Patch
@tanstack/db-collection-e2e	Patch
@tanstack/db	Patch
@tanstack/angular-db	Patch
@tanstack/powersync-db-collection	Patch
@tanstack/react-db	Patch
@tanstack/rxdb-db-collection	Patch
@tanstack/solid-db	Patch
@tanstack/svelte-db	Patch
@tanstack/trailbase-db-collection	Patch
@tanstack/vue-db	Patch

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

[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
• @tanstack/db-example-solid-todo

@tanstack/angular-db

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

@tanstack/db

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

@tanstack/db-ivm

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

@tanstack/electric-db-collection

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

@tanstack/offline-transactions

npm i https://pkg.pr.new/@tanstack/offline-transactions@852

@tanstack/powersync-db-collection

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

@tanstack/query-db-collection

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

@tanstack/react-db

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

@tanstack/rxdb-db-collection

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

@tanstack/solid-db

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

@tanstack/svelte-db

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

@tanstack/trailbase-db-collection

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

@tanstack/vue-db

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

commit: 2846a6e

[github-actions]

Size Change: 0 B

Total Size: 86.2 kB

ℹ️ View Unchanged

Filename	Size
./packages/db/dist/esm/collection/change-events.js	1.38 kB
./packages/db/dist/esm/collection/changes.js	977 B
./packages/db/dist/esm/collection/events.js	388 B
./packages/db/dist/esm/collection/index.js	3.24 kB
./packages/db/dist/esm/collection/indexes.js	1.1 kB
./packages/db/dist/esm/collection/lifecycle.js	1.67 kB
./packages/db/dist/esm/collection/mutations.js	2.26 kB
./packages/db/dist/esm/collection/state.js	3.43 kB
./packages/db/dist/esm/collection/subscription.js	2.42 kB
./packages/db/dist/esm/collection/sync.js	2.29 kB
./packages/db/dist/esm/deferred.js	207 B
./packages/db/dist/esm/errors.js	4.19 kB
./packages/db/dist/esm/event-emitter.js	748 B
./packages/db/dist/esm/index.js	2.64 kB
./packages/db/dist/esm/indexes/auto-index.js	742 B
./packages/db/dist/esm/indexes/base-index.js	766 B
./packages/db/dist/esm/indexes/btree-index.js	1.87 kB
./packages/db/dist/esm/indexes/lazy-index.js	1.1 kB
./packages/db/dist/esm/indexes/reverse-index.js	513 B
./packages/db/dist/esm/local-only.js	837 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.22 kB
./packages/db/dist/esm/query/builder/functions.js	733 B
./packages/db/dist/esm/query/builder/index.js	3.96 kB
./packages/db/dist/esm/query/builder/ref-proxy.js	917 B
./packages/db/dist/esm/query/compiler/evaluators.js	1.35 kB
./packages/db/dist/esm/query/compiler/expressions.js	430 B
./packages/db/dist/esm/query/compiler/group-by.js	1.8 kB
./packages/db/dist/esm/query/compiler/index.js	1.96 kB
./packages/db/dist/esm/query/compiler/joins.js	2 kB
./packages/db/dist/esm/query/compiler/order-by.js	1.25 kB
./packages/db/dist/esm/query/compiler/select.js	1.07 kB
./packages/db/dist/esm/query/expression-helpers.js	1.43 kB
./packages/db/dist/esm/query/ir.js	673 B
./packages/db/dist/esm/query/live-query-collection.js	360 B
./packages/db/dist/esm/query/live/collection-config-builder.js	5.26 kB
./packages/db/dist/esm/query/live/collection-registry.js	264 B
./packages/db/dist/esm/query/live/collection-subscriber.js	1.74 kB
./packages/db/dist/esm/query/live/internal.js	130 B
./packages/db/dist/esm/query/optimizer.js	2.56 kB
./packages/db/dist/esm/query/predicate-utils.js	2.88 kB
./packages/db/dist/esm/query/subset-dedupe.js	921 B
./packages/db/dist/esm/scheduler.js	1.21 kB
./packages/db/dist/esm/SortedMap.js	1.18 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	881 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	852 B
./packages/db/dist/esm/utils/index-optimization.js	1.51 kB
./packages/db/dist/esm/utils/type-guards.js	157 B

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

[github-actions]

Size Change: 0 B

Total Size: 3.34 kB

ℹ️ View Unchanged

Filename	Size
./packages/react-db/dist/esm/index.js	225 B
./packages/react-db/dist/esm/useLiveInfiniteQuery.js	1.17 kB
./packages/react-db/dist/esm/useLiveQuery.js	1.11 kB
./packages/react-db/dist/esm/useLiveSuspenseQuery.js	431 B
./packages/react-db/dist/esm/usePacedMutations.js	401 B

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

[KyleAMathews]

Looks great! All that work you did on truncate is coming in handy! Very nice semantics to be able to easily do this clean swap.

[kevin-dp]

Mostly note to self during review:

Perform atomic swap on first up-to-date: truncate snapshot data → apply buffered messages → mark ready

--> Need to check that we also cancel in-flight fetchSnapshot requests and/or ignore fetchSnapshot requests that resolve after the swap.

[kevin-dp]

This is great work, i think we're almost there but i believe there is a bug with fetchSnapshot requests that resolve after the up-to-date message. For the rest i only have minor comments/nits.

[samwillis]

@kevin-dp I've addressed your review. We should still come back to this file and tidy it up more.

Discussed with Kyle, merging as is before the weekend. We can make further changes later.