Add debug logging and tests for columnMapper.encode in loadSubset #1176

KyleAMathews · 2026-01-22T23:24:05Z

🎯 Changes

This PR adds debug logging and comprehensive test coverage for the columnMapper.encode functionality in the loadSubset method:

Changes to electric.ts:

Added debug logging at the start of createLoadSubsetDedupe to indicate whether columnMapper.encode is configured
enable logging by running DEBUG=ts/db:electric npm start in your browser console.
Added debug logging in two places where SQL is compiled to show the generated WHERE clause, helping with troubleshooting query compilation

Changes to electric.test.ts:

Added helper functions (val, ref, func) for creating IR expressions in tests
Added test case should encode column names using columnMapper.encode in loadSubset WHERE clause to verify that when a columnMapper.encode function is provided, column names in the WHERE clause are properly encoded (e.g., camelCase to snake_case)
Added test case should not encode column names when columnMapper is not provided to verify that column names remain unchanged when no columnMapper is configured

These changes improve observability and ensure the column name encoding feature works correctly in the loadSubset method.

✅ Checklist

I have followed the steps in the Contributing guide.
I have tested this code locally with pnpm test:pr.

🚀 Release Impact

This change affects published code, and I have generated a changeset.
This change is docs/CI/dev-only (no release).

Adds two tests to verify that columnMapper.encode is properly applied when compiling WHERE clauses for loadSubset requests: 1. When columnMapper.encode is configured, column names in WHERE clauses are transformed (e.g., isArchived → is_archived) 2. When no columnMapper is provided, column names are preserved as-is This helps verify the fix from PR #1141 that added columnMapper support to SQL compilation for subset queries.

Adds debug logging to help diagnose when columnMapper encoding is or isn't being applied to WHERE clauses in loadSubset requests. Logs: - Whether columnMapper.encode is configured when createLoadSubsetDedupe runs - The compiled WHERE clause before it's sent to the server Enable debugging with: DEBUG=ts/db:electric

changeset-bot · 2026-01-22T23:24:10Z

⚠️ No Changeset found

Latest commit: 365807d

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

pkg-pr-new · 2026-01-22T23:26:58Z

More templates

@tanstack/angular-db

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

@tanstack/db

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

@tanstack/db-ivm

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

@tanstack/electric-db-collection

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

@tanstack/offline-transactions

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

@tanstack/powersync-db-collection

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

@tanstack/query-db-collection

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

@tanstack/react-db

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

@tanstack/rxdb-db-collection

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

@tanstack/solid-db

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

@tanstack/svelte-db

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

@tanstack/trailbase-db-collection

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

@tanstack/vue-db

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

commit: 365807d

github-actions · 2026-01-22T23:27:35Z

Size Change: 0 B

Total Size: 90.9 kB

ℹ️ View Unchanged

Filename	Size
`./packages/db/dist/esm/collection/change-events.js`	1.39 kB
`./packages/db/dist/esm/collection/changes.js`	1.19 kB
`./packages/db/dist/esm/collection/events.js`	388 B
`./packages/db/dist/esm/collection/index.js`	3.32 kB
`./packages/db/dist/esm/collection/indexes.js`	1.1 kB
`./packages/db/dist/esm/collection/lifecycle.js`	1.68 kB
`./packages/db/dist/esm/collection/mutations.js`	2.34 kB
`./packages/db/dist/esm/collection/state.js`	3.49 kB
`./packages/db/dist/esm/collection/subscription.js`	3.62 kB
`./packages/db/dist/esm/collection/sync.js`	2.41 kB
`./packages/db/dist/esm/deferred.js`	207 B
`./packages/db/dist/esm/errors.js`	4.7 kB
`./packages/db/dist/esm/event-emitter.js`	748 B
`./packages/db/dist/esm/index.js`	2.69 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.93 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.75 kB
`./packages/db/dist/esm/query/builder/functions.js`	733 B
`./packages/db/dist/esm/query/builder/index.js`	4.08 kB
`./packages/db/dist/esm/query/builder/ref-proxy.js`	1.05 kB
`./packages/db/dist/esm/query/compiler/evaluators.js`	1.42 kB
`./packages/db/dist/esm/query/compiler/expressions.js`	430 B
`./packages/db/dist/esm/query/compiler/group-by.js`	1.81 kB
`./packages/db/dist/esm/query/compiler/index.js`	2.02 kB
`./packages/db/dist/esm/query/compiler/joins.js`	2.07 kB
`./packages/db/dist/esm/query/compiler/order-by.js`	1.45 kB
`./packages/db/dist/esm/query/compiler/select.js`	1.06 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.42 kB
`./packages/db/dist/esm/query/live/collection-registry.js`	264 B
`./packages/db/dist/esm/query/live/collection-subscriber.js`	1.93 kB
`./packages/db/dist/esm/query/live/internal.js`	145 B
`./packages/db/dist/esm/query/optimizer.js`	2.56 kB
`./packages/db/dist/esm/query/predicate-utils.js`	2.97 kB
`./packages/db/dist/esm/query/subset-dedupe.js`	921 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`	924 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/cursor.js`	457 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 · 2026-01-22T23:28:12Z

Size Change: 0 B

Total Size: 3.7 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.34 kB
`./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}

KyleAMathews · 2026-01-23T20:43:58Z

Just for testing something — will close eventually

claude added 2 commits January 22, 2026 23:08

ci: apply automated fixes

365807d

KyleAMathews marked this pull request as draft January 23, 2026 20:43

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add debug logging and tests for columnMapper.encode in loadSubset #1176

Add debug logging and tests for columnMapper.encode in loadSubset #1176

Uh oh!

KyleAMathews commented Jan 22, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Jan 22, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Jan 22, 2026

Uh oh!

github-actions bot commented Jan 22, 2026

Uh oh!

github-actions bot commented Jan 22, 2026

Uh oh!

KyleAMathews commented Jan 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Add debug logging and tests for columnMapper.encode in loadSubset #1176

Are you sure you want to change the base?

Add debug logging and tests for columnMapper.encode in loadSubset #1176

Uh oh!

Conversation

KyleAMathews commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

✅ Checklist

🚀 Release Impact

Uh oh!

changeset-bot bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

pkg-pr-new bot commented Jan 22, 2026

Uh oh!

github-actions bot commented Jan 22, 2026

Uh oh!

github-actions bot commented Jan 22, 2026

Uh oh!

KyleAMathews commented Jan 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

KyleAMathews commented Jan 22, 2026 •

edited

Loading

changeset-bot bot commented Jan 22, 2026 •

edited

Loading