Packages

@electric-sql/client

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

Your version

82 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 1.5.28

    9 Sep 2026
    • Stop ExpiredShapesCache.getExpiredHandle writing the whole cache to
      localStorage on 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. lastUsed is now updated in memory
      only; it is read from memory when markExpired picks an eviction candidate, so
      the sole effect is that eviction order can be staler after a reload.

  2. 1.5.27

    1 Sep 2026
    • Preserve 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.

  3. 1.5.26

    14 Aug 2026
    • Fix subset snapshot filtering after PostgreSQL transaction ID wraparound and
      retire filters once the stream passes each snapshot's database LSN.

  4. 1.5.25

    4 Aug 2026
    • Subqueries in shape WHERE clauses are now generally available and always enabled, including incremental move handling for compound AND/OR/NOT expressions. The allow_subqueries and tagged_subqueries feature flags have been removed — they no longer need to be set via ELECTRIC_FEATURE_FLAGS.

  5. 1.5.24

    8 Jul 2026
    • Use the React Native package export to wire AppState lifecycle handling in Metro/Expo builds, replacing brittle runtime require('react-native') auto-detection while keeping runtimeVisibility as an explicit escape hatch.

  6. 1.5.23

    2 Jul 2026
    • Add 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, or false to disable), abort with an internal live-request-timeout reason, 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.

  7. 1.5.22

    25 Jun 2026
    • Fix ShapeStream wake reconnects in runtimes that do not preserve AbortSignal.reason, such as some React Native fetch/AbortController implementations.

  8. 1.5.21

    11 Jun 2026
    • Export FetchBackoffAbortError from the package entrypoint to match the documented error handling API.

  9. 1.5.20

    1 Jun 2026
    • Fix requestSnapshot() so it resolves only after the injected snapshot batch has been delivered to subscribers, including async and reentrant subscriber paths.

  10. 1.5.19

    25 May 2026
    • Document Bun's default 256 concurrent fetch() cap in the proxy-auth and deployment skills. Auth/caching proxies running on Bun bottleneck under load unless BUN_CONFIG_MAX_HTTP_REQUESTS is raised; Node and Deno are unaffected.

  11. 1.5.18

    18 May 2026

    Reading the note…

  12. 1.5.17

    12 May 2026

    Reading the note…

  13. 1.5.16

    29 Apr 2026

    Reading the note…

  14. 1.5.15

    10 Apr 2026

    Reading the note…

  15. 1.5.14

    31 Mar 2026

    Reading the note…

  16. 1.5.13

    17 Mar 2026

    Reading the note…

  17. 1.5.12

    6 Mar 2026

    Reading the note…

  18. 1.5.11

    5 Mar 2026

    Reading the note…

  19. 1.5.10

    2 Mar 2026

    Reading the note…

  20. 1.5.9

    26 Feb 2026

    Reading the note…

  21. 1.5.8

    24 Feb 2026

    Reading the note…

  22. 1.5.7

    19 Feb 2026

    Reading the note…

  23. 1.5.6

    18 Feb 2026

    Reading the note…

  24. 1.5.5

    13 Feb 2026

    Reading the note…

  25. 1.5.4

    12 Feb 2026

    Reading the note…

  26. 1.5.3

    11 Feb 2026

    Reading the note…

  27. 1.5.2

    9 Feb 2026

    Reading the note…

  28. 1.5.1

    29 Jan 2026

    Reading the note…

  29. 1.5.0

    27 Jan 2026
    • Add 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.

  30. 1.4.2

    27 Jan 2026

    Reading the note…

  31. 1.4.1

    14 Jan 2026

    Reading the note…

  32. 1.4.0

    6 Jan 2026
    • Add 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.

  33. 1.3.1

    24 Dec 2025

    Reading the note…

  34. 1.3.0

    16 Dec 2025
    • Denote 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 __async helper which creates nested Promise chains that cannot be garbage collected when recursive async functions like requestShape() 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

  35. 1.2.2

    12 Dec 2025

    Reading the note…

  36. 1.2.1

    11 Dec 2025

    Reading the note…

  37. 1.2.0

    24 Nov 2025
    • 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.

    • 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.

  38. 1.1.5

    19 Nov 2025

    Reading the note…

  39. 1.1.4

    13 Nov 2025

    Reading the note…

  40. 1.1.3

    4 Nov 2025

    Reading the note…

  41. 1.1.2

    3 Nov 2025

    Reading the note…

  42. 1.1.1

    28 Oct 2025

    Reading the note…

  43. 1.1.0

    24 Oct 2025

    Reading the note…

  44. 1.0.14

    4 Oct 2025

    Reading the note…

  45. 1.0.13

    3 Oct 2025

    Reading the note…

  46. 1.0.12

    2 Oct 2025

    Reading the note…

  47. 1.0.11

    2 Oct 2025

    Reading the note…

  48. 1.0.10

    10 Sep 2025

    Reading the note…

  49. 1.0.9

    26 Aug 2025

    Reading the note…

  50. 1.0.8

    22 Aug 2025

    Reading 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.