Handle pushed down predicates in Electric collection by kevin-dp · Pull Request #618 · TanStack/db

kevin-dp · 2025-10-01T08:18:22Z

stacked on #669

This PR is a follow up on #617 and modifies the Electric collection to handle predicates that are being pushed down to the Electric collection.

changeset-bot · 2025-10-01T08:18:26Z

🦋 Changeset detected

Latest commit: 80284c2

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

This PR includes changesets to release 2 packages

Name	Type
@tanstack/electric-db-collection	Patch
@tanstack/db-example-react-todo	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 · 2025-10-06T13:59:26Z

More templates

@tanstack/angular-db

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

@tanstack/db

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

@tanstack/db-ivm

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

@tanstack/electric-db-collection

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

@tanstack/offline-transactions

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

@tanstack/powersync-db-collection

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

@tanstack/query-db-collection

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

@tanstack/react-db

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

@tanstack/rxdb-db-collection

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

@tanstack/solid-db

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

@tanstack/svelte-db

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

@tanstack/trailbase-db-collection

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

@tanstack/vue-db

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

commit: 80284c2

github-actions · 2025-10-06T14:02:53Z

Size Change: 0 B

Total Size: 83 kB

ℹ️ View Unchanged

Filename	Size
`./packages/db/dist/esm/collection/change-events.js`	1.34 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.12 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.02 kB
`./packages/db/dist/esm/deferred.js`	207 B
`./packages/db/dist/esm/errors.js`	3.9 kB
`./packages/db/dist/esm/event-emitter.js`	748 B
`./packages/db/dist/esm/index.js`	2.49 kB
`./packages/db/dist/esm/indexes/auto-index.js`	731 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.08 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`	606 B
`./packages/db/dist/esm/query/builder/index.js`	3.85 kB
`./packages/db/dist/esm/query/builder/ref-proxy.js`	917 B
`./packages/db/dist/esm/query/compiler/evaluators.js`	1.26 kB
`./packages/db/dist/esm/query/compiler/expressions.js`	674 B
`./packages/db/dist/esm/query/compiler/group-by.js`	1.78 kB
`./packages/db/dist/esm/query/compiler/index.js`	1.95 kB
`./packages/db/dist/esm/query/compiler/joins.js`	2 kB
`./packages/db/dist/esm/query/compiler/order-by.js`	1.17 kB
`./packages/db/dist/esm/query/compiler/select.js`	1.07 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 kB
`./packages/db/dist/esm/query/live/collection-registry.js`	214 B
`./packages/db/dist/esm/query/live/collection-subscriber.js`	1.77 kB
`./packages/db/dist/esm/query/optimizer.js`	2.6 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`	237 B
`./packages/db/dist/esm/strategies/queueStrategy.js`	418 B
`./packages/db/dist/esm/strategies/throttleStrategy.js`	236 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`	660 B
`./packages/db/dist/esm/utils/index-optimization.js`	1.49 kB
`./packages/db/dist/esm/utils/type-guards.js`	157 B

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

github-actions · 2025-10-06T14:04:17Z

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}

Co-authored-by: Kevin De Porre <kevin@electric-sql.com> Co-authored-by: Sam Willis <sam.willis@gmail.com>

* Handle pushed down predicates in Electric collection Co-authored-by: Kevin De Porre <kevin@electric-sql.com> Co-authored-by: Sam Willis <sam.willis@gmail.com> * use the subsetDuduper for electric * Leave fixme * fix DeduplicatedLoadSubset call * fix tests --------- Co-authored-by: Sam Willis <sam.willis@gmail.com>

kevin-dp mentioned this pull request Oct 1, 2025
WIP: predicate pushdown to sync #587
Closed

kevin-dp force-pushed the kevin/pred-pushdown-to-sync-db branch from aa2e623 to 2ae236fCompare October 6, 2025 12:17

kevin-dp force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch from d66c54e to 71cef08Compare October 6, 2025 13:57

kevin-dp requested a review from samwillis October 6, 2025 14:59

kevin-dp force-pushed the kevin/pred-pushdown-to-sync-db branch from 91ea051 to 3493f6dCompare October 7, 2025 09:33

Base automatically changed from kevin/pred-pushdown-to-sync-db to mainOctober 7, 2025 10:17

kevin-dp force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch from 49f1f59 to dd337d8Compare October 7, 2025 10:20

samwillis reviewed Oct 10, 2025
View reviewed changes

Comment threadpackages/electric-db-collection/src/sql-compiler.ts Outdated
Comment threadpackages/electric-db-collection/tests/electric-live-query.test.ts Outdated

kevin-dp commented Oct 13, 2025
View reviewed changes

samwillis force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch from e8e12e7 to c568cafCompare October 14, 2025 10:16

samwillis changed the base branch from main to samwillis/load-more-trackingOctober 14, 2025 10:16

kevin-dp commented Oct 14, 2025
View reviewed changes

Comment threadpackages/electric-db-collection/src/electric.ts Outdated
Comment threadpackages/electric-db-collection/src/electric.ts Outdated

samwillis force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch 2 times, most recently from bc6190d to 8eab056Compare October 15, 2025 12:31

Base automatically changed from samwillis/load-more-tracking to mainOctober 15, 2025 17:49

samwillis force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch 3 times, most recently from baa4fa2 to f7211d9Compare October 15, 2025 19:11

samwillis changed the base branch from main to samwillis/predicate-utilsOctober 15, 2025 19:13

kevin-dp force-pushed the samwillis/predicate-utils branch 2 times, most recently from a732165 to 6ee696cCompare October 22, 2025 09:18

kevin-dp force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch 3 times, most recently from f7211d9 to 59e396cCompare November 4, 2025 09:08

samwillis added this to TanStack DB 1.0.0 release Nov 4, 2025

samwillis moved this to Ready for review in TanStack DB 1.0.0 release Nov 4, 2025

Base automatically changed from samwillis/predicate-utils to query-driven-syncNovember 5, 2025 11:15

samwillis mentioned this pull request Nov 5, 2025
Query Driven Sync with On-Demand Collection Loading #763
Merged
7 tasks

samwillisand others added 3 commits November 5, 2025 14:45

Handle pushed down predicates in Electric collection
d725a0e
Co-authored-by: Kevin De Porre <kevin@electric-sql.com> Co-authored-by: Sam Willis <sam.willis@gmail.com>

use the subsetDuduper for electric
2b42067

Leave fixme
ffe08e9

samwillis force-pushed the kevin/pred-pushdown-to-sync-electric-coll branch from e4a6188 to ffe08e9Compare November 5, 2025 14:45

samwillis added 2 commits November 5, 2025 14:49

fix DeduplicatedLoadSubset call
247e0dd

fix tests
80284c2

samwillis merged commit cb47bea into query-driven-syncNov 5, 2025
6 checks passed

samwillis deleted the kevin/pred-pushdown-to-sync-electric-coll branch November 5, 2025 15:30

KyleAMathews moved this from Ready for review to Done in TanStack DB 1.0.0 release Nov 13, 2025

Navigation Menu

Uh oh!

Handle pushed down predicates in Electric collection - #618

Handle pushed down predicates in Electric collection#618
samwillis merged 5 commits into
query-driven-syncfrom
kevin/pred-pushdown-to-sync-electric-coll

kevin-dp commented Oct 1, 2025•
edited by samwillis
Loading

Uh oh!

changeset-botBot commented Oct 1, 2025•
edited
Loading

Uh oh!

pkg-pr-newBot commented Oct 6, 2025•
edited
Loading

Uh oh!

github-actionsBot commented Oct 6, 2025•
edited
Loading

Uh oh!

github-actionsBot commented Oct 6, 2025•
edited
Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

kevin-dp commented Oct 1, 2025• edited by samwillis Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-botBot commented Oct 1, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-newBot commented Oct 6, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actionsBot commented Oct 6, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actionsBot commented Oct 6, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

kevin-dp commented Oct 1, 2025•
edited by samwillis
Loading

changeset-botBot commented Oct 1, 2025•
edited
Loading

pkg-pr-newBot commented Oct 6, 2025•
edited
Loading

github-actionsBot commented Oct 6, 2025•
edited
Loading

github-actionsBot commented Oct 6, 2025•
edited
Loading