@electric-sql/client 1.5.5 → 1.5.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@electric-sql/client",
   "description": "Postgres everywhere - your data, in sync, wherever you need it.",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "author": "ElectricSQL team and contributors.",
   "bugs": {
     "url": "https://github.com/electric-sql/electric/issues"

package/src/client.ts

@@ -1342,7 +1342,18 @@ export class ShapeStream<T extends Row<unknown> = Row>
         // #start handles it correctly.
         throw new FetchBackoffAbortError()
       }
-      throw error
+      // Re-throw known Electric errors so the caller can handle them
+      // (e.g., 409 shape rotation, stale cache retry, missing headers).
+      // Other errors (body parsing, SSE protocol failures, null body)
+      // are SSE connection failures handled by the fallback mechanism
+      // in the finally block below.
+      if (
+        error instanceof FetchError ||
+        error instanceof StaleCacheError ||
+        error instanceof MissingHeadersError
+      ) {
+        throw error
+      }
     } finally {
       // Check if the SSE connection closed too quickly
       // This can happen when responses are cached or when the proxy/server

package/src/fetch.ts

@@ -226,6 +226,17 @@ export function createFetchWithChunkBuffer(
 
   const prefetchClient = async (...args: Parameters<typeof fetchClient>) => {
     const url = args[0].toString()
+    const method = getRequestMethod(args[0], args[1])
+
+    // Prefetch is only valid for GET requests. The prefetch queue matches
+    // requests by URL alone and ignores HTTP method/body, so a POST request
+    // with the same URL would incorrectly consume the prefetched stream
+    // response instead of making its own request.
+    if (method !== `GET`) {
+      prefetchQueue?.abort()
+      prefetchQueue = undefined
+      return fetchClient(...args)
+    }
 
     // try to consume from the prefetch queue first, and if request is
     // not present abort the prefetch queue as it must no longer be valid
@@ -494,3 +505,18 @@ function chainAborter(
 }
 
 function noop() {}
+
+function getRequestMethod(
+  input: Parameters<typeof fetch>[0],
+  init?: Parameters<typeof fetch>[1]
+): string {
+  if (init?.method) {
+    return init.method.toUpperCase()
+  }
+
+  if (typeof Request !== `undefined` && input instanceof Request) {
+    return input.method.toUpperCase()
+  }
+
+  return `GET`
+}

package/src/shape-stream-state.ts

@@ -380,6 +380,19 @@ abstract class FetchingState extends ActiveState {
     if (staleResult) return staleResult
 
     const shared = this.parseResponseFields(input)
+
+    // NOTE: 204s are deprecated, the Electric server should not send these
+    // in latest versions but this is here for backwards compatibility.
+    // A 204 means "no content, you're caught up" — transition to live.
+    // Skip SSE detection: a 204 gives no indication SSE will work, and
+    // the 3-attempt fallback cycle adds unnecessary latency.
+    if (input.status === 204) {
+      return {
+        action: `accepted`,
+        state: new LiveState(shared, { sseFallbackToLongPolling: true }),
+      }
+    }
+
     return { action: `accepted`, state: new SyncingState(shared) }
   }