@electric-sql/client 1.0.3 → 1.0.5

package/src/constants.ts

@@ -12,4 +12,6 @@ export const TABLE_QUERY_PARAM = `table`
 export const WHERE_QUERY_PARAM = `where`
 export const REPLICA_PARAM = `replica`
 export const WHERE_PARAMS_PARAM = `params`
+export const EXPERIMENTAL_LIVE_SSE_QUERY_PARAM = `experimental_live_sse`
 export const FORCE_DISCONNECT_AND_REFRESH = `force-disconnect-and-refresh`
+export const PAUSE_STREAM = `pause-stream`

package/src/fetch.ts

@@ -38,7 +38,8 @@ export const BackoffDefaults = {
 
 export function createFetchWithBackoff(
   fetchClient: typeof fetch,
-  backoffOptions: BackoffOptions = BackoffDefaults
+  backoffOptions: BackoffOptions = BackoffDefaults,
+  sseMode: boolean = false
 ): typeof fetch {
   const {
     initialDelay,
@@ -64,7 +65,16 @@ export function createFetchWithBackoff(
       try {
         const result = await fetchClient(...args)
         if (result.ok) return result
-        else throw await FetchError.fromResponse(result, url.toString())
+
+        const err = await FetchError.fromResponse(result, url.toString())
+        if (err.status === 409 && sseMode) {
+          // The json body is [ { headers: { control: 'must-refetch' } } ] in normal mode
+          // and is { headers: { control: 'must-refetch' } } in SSE mode
+          // So in SSE mode we need to wrap it in an array
+          err.json = [err.json]
+        }
+
+        throw err
       } catch (e) {
         onFailedAttempt?.()
         if (options?.signal?.aborted) {

package/src/helpers.ts

@@ -1,4 +1,4 @@
-import { ChangeMessage, ControlMessage, Message, Row } from './types'
+import { ChangeMessage, ControlMessage, Message, Offset, Row } from './types'
 
 /**
  * Type guard for checking {@link Message} is {@link ChangeMessage}.
@@ -51,3 +51,15 @@ export function isUpToDateMessage<T extends Row<unknown> = Row>(
 ): message is ControlMessage & { up_to_date: true } {
   return isControlMessage(message) && message.headers.control === `up-to-date`
 }
+
+/**
+ * Parses the LSN from the up-to-date message and turns it into an offset.
+ * The LSN is only present in the up-to-date control message when in SSE mode.
+ * If we are not in SSE mode this function will return undefined.
+ */
+export function getOffset(message: ControlMessage): Offset | undefined {
+  const lsn = Number(message.headers.global_last_seen_lsn)
+  if (lsn && !isNaN(lsn)) {
+    return `${lsn}_0`
+  }
+}

package/src/types.ts

@@ -26,7 +26,10 @@ interface Header {
 export type Operation = `insert` | `update` | `delete`
 
 export type ControlMessage = {
-  headers: Header & { control: `up-to-date` | `must-refetch` }
+  headers: Header & {
+    control: `up-to-date` | `must-refetch`
+    global_last_seen_lsn?: string
+  }
 }
 
 export type ChangeMessage<T extends Row<unknown> = Row> = {