@electric-sql/client
1.5.28 · 9 Sep 2026Apache-2.02.8M / weekRepositoryHomepagenpmAtom feed
1.5.28 is the newest release of 1.x.
In short
1 new2 fixed
Release note
Minor Changes
Add bidirectional column mapping API for query filters with built-in snake_case ↔ camelCase support. Introduces
columnMapperoption toShapeStreamthat handles both encoding (TypeScript → Database) for WHERE clauses and decoding (Database → TypeScript) for results. IncludessnakeCamelMapper()helper for automatic snake_case/camelCase conversion andcreateColumnMapper()for custom mappings. The new API deprecates usingtransformersolely for column renaming, thoughtransformerremains useful for value transformations like encryption.
Patch Changes
Fix subset__params to use constant parameter name for proxy configurations
Changed subsetparams from deepObject style (subsetparams[1], subsetparams[2]) to JSON serialization (subsetparams={"1":"value1","2":"value2"}). This allows proxy configurations to match the constant parameter name "subset__params" in ELECTRIC_PROTOCOL_QUERY_PARAMS without needing dynamic pattern matching.
Fix multiple renders from cached up-to-date messages on page refresh. When a shape receives multiple updates within the HTTP cache window (60s), each update ends with an up-to-date control message that gets cached. On page refresh, these cached responses replay rapidly, causing multiple renders. This change implements cursor-based detection to suppress cached up-to-date notifications until a fresh response (with a new cursor) arrives from the server, ensuring only one render occurs.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.