@electric-sql/client
1.5.28 · 9 Sep 2026Apache-2.02.8M / weekRepositoryHomepagenpmAtom feed
82 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
1.5.28
9 Sep 2026Stop
ExpiredShapesCache.getExpiredHandlewriting the whole cache tolocalStorageon every read. The LRU touch it performs runs while building the
URL of every shape request, so in live mode it persisted the entire cache once
per poll for as long as the app stayed open.lastUsedis now updated in memory
only; it is read from memory whenmarkExpiredpicks an eviction candidate, so
the sole effect is that eviction order can be staler after a reload.
1.5.27
1 Sep 2026Preserve data messages when suppressing cached up-to-date notifications during replay.
Prevent subscription startup failures from also surfacing as unhandled promise
rejections after they are delivered to the subscriber error callback.Fix duplicate download of subset snapshot responses caused by the chunk prefetcher mistaking them for a normal chunk to prefetch.
1.5.26
14 Aug 2026Fix subset snapshot filtering after PostgreSQL transaction ID wraparound and
retire filters once the stream passes each snapshot's database LSN.
1.5.25
4 Aug 2026Subqueries in shape WHERE clauses are now generally available and always enabled, including incremental move handling for compound
AND/OR/NOTexpressions. Theallow_subqueriesandtagged_subqueriesfeature flags have been removed — they no longer need to be set viaELECTRIC_FEATURE_FLAGS.
1.5.24
8 Jul 2026Use the React Native package export to wire AppState lifecycle handling in Metro/Expo builds, replacing brittle runtime
require('react-native')auto-detection while keepingruntimeVisibilityas an explicit escape hatch.
1.5.23
2 Jul 2026Add a request watchdog so ShapeStream can recover when mobile fetch implementations hang across app lifecycle or network transitions. Live long-poll requests and refresh catch-up requests now time out after
liveRequestTimeoutMs(default 45s, orfalseto disable), abort with an internallive-request-timeoutreason, and restart the request loop even if the platform fetch promise never settles.Also make retry backoff abort-aware at sleep entry, keep wake-triggered refreshes in non-live catch-up mode until the next request-loop tick completes, and auto-detect React Native AppState when available so mobile apps pause Electric requests while backgrounded and resume catch-up after foregrounding. A runtime visibility adapter hook remains available for other non-browser runtimes.
1.5.22
25 Jun 2026Fix ShapeStream wake reconnects in runtimes that do not preserve
AbortSignal.reason, such as some React Native fetch/AbortController implementations.
1.5.21
11 Jun 2026Export
FetchBackoffAbortErrorfrom the package entrypoint to match the documented error handling API.
1.5.20
1 Jun 2026Fix
requestSnapshot()so it resolves only after the injected snapshot batch has been delivered to subscribers, including async and reentrant subscriber paths.
1.5.19
25 May 2026Document Bun's default 256 concurrent
fetch()cap in the proxy-auth and deployment skills. Auth/caching proxies running on Bun bottleneck under load unlessBUN_CONFIG_MAX_HTTP_REQUESTSis raised; Node and Deno are unaffected.
1.5.18
18 May 2026Reading the note…
1.5.17
12 May 2026Reading the note…
1.5.16
29 Apr 2026Reading the note…
1.5.15
10 Apr 2026Reading the note…
1.5.14
31 Mar 2026Reading the note…
1.5.13
17 Mar 2026Reading the note…
1.5.12
6 Mar 2026Reading the note…
1.5.11
5 Mar 2026Reading the note…
1.5.10
2 Mar 2026Reading the note…
1.5.9
26 Feb 2026Reading the note…
1.5.8
24 Feb 2026Reading the note…
1.5.7
19 Feb 2026Reading the note…
1.5.6
18 Feb 2026Reading the note…
1.5.5
13 Feb 2026Reading the note…
1.5.4
12 Feb 2026Reading the note…
1.5.3
11 Feb 2026Reading the note…
1.5.2
9 Feb 2026Reading the note…
1.5.1
29 Jan 2026Reading the note…
1.5.0
27 Jan 2026Add POST support for subset snapshots to avoid URL length limits. Clients can now send subset parameters (WHERE clauses, ordering, pagination) in the request body instead of URL query parameters, preventing HTTP 414 errors with complex queries or large IN lists.
1.4.2
27 Jan 2026Reading the note…
1.4.1
14 Jan 2026Reading the note…
1.4.0
6 Jan 2026Add structured subset params support (whereExpr, orderByExpr) to enable proper columnMapper transformations for subset queries. When TanStack DB sends structured expression data alongside compiled SQL strings, the client can now apply column name transformations (e.g., camelCase to snake_case) before generating the final SQL.
1.3.1
24 Dec 2025Reading the note…
1.3.0
16 Dec 2025Denote end of injected subset snapshot with an additional message
Fix memory leak from recursive async functions by upgrading TypeScript target to ES2017.
The ES2016 target caused async/await to be transpiled using the
__asynchelper which creates nested Promise chains that cannot be garbage collected when recursive async functions likerequestShape()call themselves. With ES2017+, native async/await is used which doesn't have this issue.Fix stream stopping after tab visibility changes due to stale aborted requests in PrefetchQueue.
Root cause: When a page is hidden, the stream pauses and aborts in-flight prefetch requests. The aborted promises remained in the PrefetchQueue's internal Map. When the page became visible and the stream resumed,
consume()returned the stale aborted promise, causing an AbortError to propagate to ShapeStream and stop syncing.The fix:
Fixes #3460
1.2.2
12 Dec 2025Reading the note…
1.2.1
11 Dec 2025Reading the note…
1.2.0
24 Nov 2025Add 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.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.
1.1.5
19 Nov 2025Reading the note…
1.1.4
13 Nov 2025Reading the note…
1.1.3
4 Nov 2025Reading the note…
1.1.2
3 Nov 2025Reading the note…
1.1.1
28 Oct 2025Reading the note…
1.1.0
24 Oct 2025Reading the note…
1.0.14
4 Oct 2025Reading the note…
1.0.13
3 Oct 2025Reading the note…
1.0.12
2 Oct 2025Reading the note…
1.0.11
2 Oct 2025Reading the note…
1.0.10
10 Sep 2025Reading the note…
1.0.9
26 Aug 2025Reading the note…
1.0.8
22 Aug 2025Reading the note…
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.