Packages

@electric-sql/client

1.5.28 · 9 Sep 2026Apache-2.02.8M / weekRepositoryHomepagenpmAtom feed

Your version

1.2.0

24 Nov 2025Where it was published

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 columnMapper option to ShapeStream that handles both encoding (TypeScript → Database) for WHERE clauses and decoding (Database → TypeScript) for results. Includes snakeCamelMapper() helper for automatic snake_case/camelCase conversion and createColumnMapper() for custom mappings. The new API deprecates using transformer solely for column renaming, though transformer remains 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.