@dvina/sdk 4.0.212 → 4.0.215

package/dist/{chunk-4EESBP3A.cjs → chunk-XK5PW7IX.cjs}

@@ -2,7 +2,7 @@
 
 var chunk342BFYZZ_cjs = require('./chunk-342BFYZZ.cjs');
 var chunkUELAE75E_cjs = require('./chunk-UELAE75E.cjs');
-var chunkBL3GFOZR_cjs = require('./chunk-BL3GFOZR.cjs');
+var chunkY4OD5SDF_cjs = require('./chunk-Y4OD5SDF.cjs');
 var chunkKV5SP7RP_cjs = require('./chunk-KV5SP7RP.cjs');
 var chunk32A6N4YK_cjs = require('./chunk-32A6N4YK.cjs');
 var chunkDZUJEN5N_cjs = require('./chunk-DZUJEN5N.cjs');
@@ -6035,7 +6035,6 @@ var require_dexie = chunkDZUJEN5N_cjs.__commonJS({
 // src/chat-stream.ts
 var INITIAL_RECONNECT_DELAY_MS = 1e3;
 var MAX_RECONNECT_DELAY_MS = 3e4;
-var RECONNECT_BACKOFF_MULTIPLIER = 2;
 var MAX_CONSECUTIVE_AUTH_FAILURES = 3;
 var AuthChatStreamError = class extends Error {
   constructor(status) {
@@ -6049,24 +6048,63 @@ var ChatStreamConnection = class {
     this.chatId = chatId;
     this.options = options;
     this.onEmpty = onEmpty;
+    this.supervisor = new chunkY4OD5SDF_cjs.ConnectionSupervisor({
+      authRetryDelayMs: INITIAL_RECONNECT_DELAY_MS,
+      baseReconnectDelayMs: INITIAL_RECONNECT_DELAY_MS,
+      getToken: options.getToken,
+      id: chatId,
+      isAuthError: (error) => error instanceof AuthChatStreamError,
+      kind: "chat-sse",
+      maxConsecutiveAuthFailures: MAX_CONSECUTIVE_AUTH_FAILURES,
+      maxReconnectDelayMs: MAX_RECONNECT_DELAY_MS,
+      onFatalError: () => {
+        const authError = new chunkKV5SP7RP_cjs.DvinaAuthenticationError("Chat SSE stream authentication failed permanently");
+        this.options.onError?.(authError);
+        this.close(authError);
+      },
+      dial: async (context) => {
+        const url = new URL(`${this.options.baseUrl}/${encodeURIComponent(this.chatId)}/stream`);
+        if (this.lastEventId) {
+          url.searchParams.set("lastEventId", this.lastEventId);
+        }
+        const response = await fetch(url.toString(), {
+          method: "GET",
+          headers: {
+            Accept: "text/event-stream",
+            Authorization: `Bearer ${context.token}`,
+            "Cache-Control": "no-cache",
+            ...this.lastEventId ? { "Last-Event-ID": this.lastEventId } : {}
+          },
+          signal: context.signal
+        });
+        if (!response.ok) {
+          if (response.status === 401 || response.status === 403) {
+            throw new AuthChatStreamError(response.status);
+          }
+          throw new Error(`Chat stream connection failed: ${response.status} ${response.statusText}`);
+        }
+        if (!response.body) {
+          throw new Error("Chat stream response has no body");
+        }
+        context.markConnected();
+        await chunkY4OD5SDF_cjs.consumeSseStream(response.body, context.signal, {
+          onChunk: () => context.markActivity(),
+          onEventBlock: (block) => this.processEventBlock(block, context.requestTokenRefresh)
+        });
+      }
+    });
   }
-  abortController;
-  consecutiveAuthFailures = 0;
   destroyed = false;
   lastEventId;
-  needsForceRefresh = false;
-  reconnectDelay = INITIAL_RECONNECT_DELAY_MS;
-  reconnectTimer;
-  shouldReconnect = false;
   subscribers = /* @__PURE__ */ new Set();
+  supervisor;
   addSubscriber(subscriber) {
     if (this.destroyed) {
       throw new Error(`Chat stream '${this.chatId}' is closed`);
     }
     this.subscribers.add(subscriber);
-    if (!this.shouldReconnect) {
-      this.shouldReconnect = true;
-      void this.doConnect();
+    if (this.subscribers.size === 1) {
+      void this.supervisor.start();
     }
   }
   removeSubscriber(subscriber) {
@@ -6075,17 +6113,18 @@ var ChatStreamConnection = class {
       this.close();
     }
   }
-  close(error) {
-    this.shouldReconnect = false;
-    this.destroyed = true;
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = void 0;
+  reconnect() {
+    if (this.destroyed || this.subscribers.size === 0) {
+      return;
     }
-    if (this.abortController) {
-      this.abortController.abort();
-      this.abortController = void 0;
+    this.supervisor.reconnect();
+  }
+  close(error) {
+    if (this.destroyed) {
+      return;
     }
+    this.destroyed = true;
+    this.supervisor.close();
     for (const subscriber of Array.from(this.subscribers)) {
       subscriber.finish(error);
     }
@@ -6095,94 +6134,7 @@ var ChatStreamConnection = class {
   get isDestroyed() {
     return this.destroyed;
   }
-  async doConnect() {
-    if (!this.shouldReconnect || this.destroyed || this.subscribers.size === 0) {
-      return;
-    }
-    this.abortController = new AbortController();
-    try {
-      const forceRefresh = this.needsForceRefresh;
-      this.needsForceRefresh = false;
-      const token = await this.options.getToken(forceRefresh ? { forceRefresh: true } : void 0);
-      const url = new URL(`${this.options.baseUrl}/${encodeURIComponent(this.chatId)}/stream`);
-      if (this.lastEventId) {
-        url.searchParams.set("lastEventId", this.lastEventId);
-      }
-      const response = await fetch(url.toString(), {
-        method: "GET",
-        headers: {
-          Accept: "text/event-stream",
-          Authorization: `Bearer ${token}`,
-          "Cache-Control": "no-cache",
-          ...this.lastEventId ? { "Last-Event-ID": this.lastEventId } : {}
-        },
-        signal: this.abortController.signal
-      });
-      if (!response.ok) {
-        if (response.status === 401 || response.status === 403) {
-          throw new AuthChatStreamError(response.status);
-        }
-        throw new Error(`Chat stream connection failed: ${response.status} ${response.statusText}`);
-      }
-      if (!response.body) {
-        throw new Error("Chat stream response has no body");
-      }
-      this.consecutiveAuthFailures = 0;
-      this.reconnectDelay = INITIAL_RECONNECT_DELAY_MS;
-      await this.parseSseStream(response.body, this.abortController.signal);
-    } catch (error) {
-      if (error.name === "AbortError") {
-        return;
-      }
-      if (!this.shouldReconnect || this.destroyed || this.subscribers.size === 0) {
-        return;
-      }
-      const isAuthError2 = error instanceof AuthChatStreamError;
-      if (isAuthError2) {
-        this.consecutiveAuthFailures += 1;
-        if (this.consecutiveAuthFailures >= MAX_CONSECUTIVE_AUTH_FAILURES) {
-          const authError = new chunkKV5SP7RP_cjs.DvinaAuthenticationError("Chat SSE stream authentication failed permanently");
-          this.options.onError?.(authError);
-          this.close(authError);
-          return;
-        }
-        this.needsForceRefresh = true;
-      }
-      const delay = isAuthError2 ? INITIAL_RECONNECT_DELAY_MS : this.reconnectDelay;
-      this.scheduleReconnect(delay);
-      if (!isAuthError2) {
-        this.reconnectDelay = Math.min(
-          this.reconnectDelay * RECONNECT_BACKOFF_MULTIPLIER,
-          MAX_RECONNECT_DELAY_MS
-        );
-      }
-    }
-  }
-  async parseSseStream(body, signal) {
-    const reader = body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    try {
-      while (!signal.aborted && this.shouldReconnect && !this.destroyed) {
-        const { done, value } = await reader.read();
-        if (done) {
-          break;
-        }
-        buffer += decoder.decode(value, { stream: true });
-        const parts = buffer.split(/(?:\r\n|\r|\n){2}/);
-        buffer = parts.pop() ?? "";
-        for (const part of parts) {
-          this.processEventBlock(part.trim());
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-    if (this.shouldReconnect && !this.destroyed && this.subscribers.size > 0) {
-      this.scheduleReconnect(this.reconnectDelay);
-    }
-  }
-  processEventBlock(block) {
+  processEventBlock(block, requestTokenRefresh) {
     if (!block || block.startsWith(":")) {
       return;
     }
@@ -6199,8 +6151,8 @@ var ChatStreamConnection = class {
       }
     }
     if (eventType === "token-expired") {
-      this.needsForceRefresh = true;
-      return;
+      requestTokenRefresh();
+      throw new AuthChatStreamError(401);
     }
     if (!eventId || dataLines.length === 0) {
       return;
@@ -6217,40 +6169,64 @@ var ChatStreamConnection = class {
       subscriber.push(value);
     }
   }
-  scheduleReconnect(delay) {
-    if (!this.shouldReconnect || this.destroyed || this.subscribers.size === 0) {
-      return;
-    }
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-    }
-    this.reconnectTimer = setTimeout(() => {
-      this.reconnectTimer = void 0;
-      void this.doConnect();
-    }, delay);
-  }
 };
 var ActiveChatStreamConnection = class {
   constructor(options, onEmpty) {
     this.options = options;
     this.onEmpty = onEmpty;
+    this.supervisor = new chunkY4OD5SDF_cjs.ConnectionSupervisor({
+      authRetryDelayMs: INITIAL_RECONNECT_DELAY_MS,
+      baseReconnectDelayMs: INITIAL_RECONNECT_DELAY_MS,
+      getToken: options.getToken,
+      id: "active",
+      isAuthError: (error) => error instanceof AuthChatStreamError,
+      kind: "active-chat-sse",
+      maxConsecutiveAuthFailures: MAX_CONSECUTIVE_AUTH_FAILURES,
+      maxReconnectDelayMs: MAX_RECONNECT_DELAY_MS,
+      onFatalError: () => {
+        const authError = new chunkKV5SP7RP_cjs.DvinaAuthenticationError(
+          "Active chat SSE stream authentication failed permanently"
+        );
+        this.options.onError?.(authError);
+        this.close(authError);
+      },
+      dial: async (context) => {
+        const response = await fetch(new URL(`${this.options.baseUrl}/active`).toString(), {
+          method: "GET",
+          headers: {
+            Accept: "text/event-stream",
+            Authorization: `Bearer ${context.token}`,
+            "Cache-Control": "no-cache"
+          },
+          signal: context.signal
+        });
+        if (!response.ok) {
+          if (response.status === 401 || response.status === 403) {
+            throw new AuthChatStreamError(response.status);
+          }
+          throw new Error(`Active chat stream connection failed: ${response.status} ${response.statusText}`);
+        }
+        if (!response.body) {
+          throw new Error("Active chat stream response has no body");
+        }
+        context.markConnected();
+        await chunkY4OD5SDF_cjs.consumeSseStream(response.body, context.signal, {
+          onChunk: () => context.markActivity(),
+          onEventBlock: (block) => this.processEventBlock(block, context.requestTokenRefresh)
+        });
+      }
+    });
   }
-  abortController;
-  consecutiveAuthFailures = 0;
   destroyed = false;
-  needsForceRefresh = false;
-  reconnectDelay = INITIAL_RECONNECT_DELAY_MS;
-  reconnectTimer;
-  shouldReconnect = false;
   subscribers = /* @__PURE__ */ new Set();
+  supervisor;
   addSubscriber(subscriber) {
     if (this.destroyed) {
       throw new Error("Active chat stream is closed");
     }
     this.subscribers.add(subscriber);
-    if (!this.shouldReconnect) {
-      this.shouldReconnect = true;
-      void this.doConnect();
+    if (this.subscribers.size === 1) {
+      void this.supervisor.start();
     }
   }
   removeSubscriber(subscriber) {
@@ -6259,17 +6235,18 @@ var ActiveChatStreamConnection = class {
       this.close();
     }
   }
-  close(error) {
-    this.shouldReconnect = false;
-    this.destroyed = true;
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = void 0;
+  reconnect() {
+    if (this.destroyed || this.subscribers.size === 0) {
+      return;
     }
-    if (this.abortController) {
-      this.abortController.abort();
-      this.abortController = void 0;
+    this.supervisor.reconnect();
+  }
+  close(error) {
+    if (this.destroyed) {
+      return;
     }
+    this.destroyed = true;
+    this.supervisor.close();
     for (const subscriber of Array.from(this.subscribers)) {
       subscriber.finish(error);
     }
@@ -6279,91 +6256,7 @@ var ActiveChatStreamConnection = class {
   get isDestroyed() {
     return this.destroyed;
   }
-  async doConnect() {
-    if (!this.shouldReconnect || this.destroyed || this.subscribers.size === 0) {
-      return;
-    }
-    this.abortController = new AbortController();
-    try {
-      const forceRefresh = this.needsForceRefresh;
-      this.needsForceRefresh = false;
-      const token = await this.options.getToken(forceRefresh ? { forceRefresh: true } : void 0);
-      const response = await fetch(new URL(`${this.options.baseUrl}/active`).toString(), {
-        method: "GET",
-        headers: {
-          Accept: "text/event-stream",
-          Authorization: `Bearer ${token}`,
-          "Cache-Control": "no-cache"
-        },
-        signal: this.abortController.signal
-      });
-      if (!response.ok) {
-        if (response.status === 401 || response.status === 403) {
-          throw new AuthChatStreamError(response.status);
-        }
-        throw new Error(`Active chat stream connection failed: ${response.status} ${response.statusText}`);
-      }
-      if (!response.body) {
-        throw new Error("Active chat stream response has no body");
-      }
-      this.consecutiveAuthFailures = 0;
-      this.reconnectDelay = INITIAL_RECONNECT_DELAY_MS;
-      await this.parseSseStream(response.body, this.abortController.signal);
-    } catch (error) {
-      if (error.name === "AbortError") {
-        return;
-      }
-      if (!this.shouldReconnect || this.destroyed || this.subscribers.size === 0) {
-        return;
-      }
-      const isAuthError2 = error instanceof AuthChatStreamError;
-      if (isAuthError2) {
-        this.consecutiveAuthFailures += 1;
-        if (this.consecutiveAuthFailures >= MAX_CONSECUTIVE_AUTH_FAILURES) {
-          const authError = new chunkKV5SP7RP_cjs.DvinaAuthenticationError(
-            "Active chat SSE stream authentication failed permanently"
-          );
-          this.options.onError?.(authError);
-          this.close(authError);
-          return;
-        }
-        this.needsForceRefresh = true;
-      }
-      const delay = isAuthError2 ? INITIAL_RECONNECT_DELAY_MS : this.reconnectDelay;
-      this.scheduleReconnect(delay);
-      if (!isAuthError2) {
-        this.reconnectDelay = Math.min(
-          this.reconnectDelay * RECONNECT_BACKOFF_MULTIPLIER,
-          MAX_RECONNECT_DELAY_MS
-        );
-      }
-    }
-  }
-  async parseSseStream(body, signal) {
-    const reader = body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    try {
-      while (!signal.aborted && this.shouldReconnect && !this.destroyed) {
-        const { done, value } = await reader.read();
-        if (done) {
-          break;
-        }
-        buffer += decoder.decode(value, { stream: true });
-        const parts = buffer.split(/(?:\r\n|\r|\n){2}/);
-        buffer = parts.pop() ?? "";
-        for (const part of parts) {
-          this.processEventBlock(part.trim());
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-    if (this.shouldReconnect && !this.destroyed && this.subscribers.size > 0) {
-      this.scheduleReconnect(this.reconnectDelay);
-    }
-  }
-  processEventBlock(block) {
+  processEventBlock(block, requestTokenRefresh) {
     if (!block || block.startsWith(":")) {
       return;
     }
@@ -6377,8 +6270,8 @@ var ActiveChatStreamConnection = class {
       }
     }
     if (eventType === "token-expired") {
-      this.needsForceRefresh = true;
-      return;
+      requestTokenRefresh();
+      throw new AuthChatStreamError(401);
     }
     if (eventType !== "active" || dataLines.length === 0) {
       return;
@@ -6397,18 +6290,6 @@ var ActiveChatStreamConnection = class {
       subscriber.push(value);
     }
   }
-  scheduleReconnect(delay) {
-    if (!this.shouldReconnect || this.destroyed || this.subscribers.size === 0) {
-      return;
-    }
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-    }
-    this.reconnectTimer = setTimeout(() => {
-      this.reconnectTimer = void 0;
-      void this.doConnect();
-    }, delay);
-  }
 };
 function createChatStreamClient(options) {
   const connections = /* @__PURE__ */ new Map();
@@ -6577,6 +6458,12 @@ function createChatStreamClient(options) {
       }
     };
   }
+  function reconnectAll() {
+    for (const connection of connections.values()) {
+      connection.reconnect();
+    }
+    activeConnection?.reconnect();
+  }
   function destroy() {
     for (const connection of Array.from(connections.values())) {
       connection.close();
@@ -6591,6 +6478,7 @@ function createChatStreamClient(options) {
     },
     listen,
     stream,
+    reconnectAll,
     destroy
   };
 }
@@ -7338,20 +7226,12 @@ function createWsTransport(options) {
   let lastCloseCode = null;
   let nextToken;
   let currentToken;
-  let refreshPromise = null;
   async function refreshToken() {
-    if (!refreshPromise) {
-      const failedToken = currentToken;
-      refreshPromise = options.getToken({ forceRefresh: true }).then((token) => {
-        if (!token || token === failedToken) {
-          throw new chunkKV5SP7RP_cjs.DvinaAuthenticationError("Token refresh did not produce a new token", failedToken);
-        }
-        nextToken = token;
-      }).finally(() => {
-        refreshPromise = null;
-      });
+    const token = await chunkY4OD5SDF_cjs.refreshTokenSingleFlight(options.getToken, currentToken);
+    if (!token) {
+      throw new chunkKV5SP7RP_cjs.DvinaAuthenticationError("Token refresh did not produce a new token", currentToken);
     }
-    return refreshPromise;
+    nextToken = token;
   }
   async function prepareSubscriptionConnection() {
     const token = nextToken ?? await options.getToken();
@@ -7399,7 +7279,7 @@ function createWsTransport(options) {
     }
   });
   function subscribe(document2, variables) {
-    const query = chunkBL3GFOZR_cjs.print(document2);
+    const query = chunkY4OD5SDF_cjs.print(document2);
     const subscribeOnce = () => ({
       [Symbol.asyncIterator]() {
         const queue = [];
@@ -8087,35 +7967,47 @@ var AuthSseError = class extends Error {
 };
 var INITIAL_RECONNECT_DELAY_MS2 = 1e3;
 var MAX_RECONNECT_DELAY_MS2 = 3e4;
-var RECONNECT_BACKOFF_MULTIPLIER2 = 2;
 var MAX_CONSECUTIVE_AUTH_FAILURES2 = 3;
 var SUBSCRIPTION_REFRESH_INTERVAL_MS = 5 * 60 * 1e3;
+function mapSupervisorState(state) {
+  if (state === "connected") {
+    return "connected";
+  }
+  if (state === "connecting") {
+    return "connecting";
+  }
+  return "disconnected";
+}
 function createSseTransport(options) {
-  let abortController;
   let isConnected = false;
-  let reconnectDelay = INITIAL_RECONNECT_DELAY_MS2;
-  let reconnectTimer;
-  let refreshTimer;
-  let shouldReconnect = false;
   let currentLastSyncId;
-  let needsForceRefresh = false;
-  let consecutiveAuthFailures = 0;
+  let refreshTimer;
   let hasConnectedOnce = false;
+  let lastLegacyState;
   const activeSubscriptions = /* @__PURE__ */ new Map();
-  async function connect(lastSyncId) {
-    disconnect();
-    shouldReconnect = true;
-    currentLastSyncId = lastSyncId;
-    await doConnect();
-  }
-  async function doConnect() {
-    if (!shouldReconnect) return;
-    abortController = new AbortController();
-    options.onStateChange?.("connecting");
-    try {
-      const forceRefresh = needsForceRefresh;
-      needsForceRefresh = false;
-      const token = await options.getToken(forceRefresh ? { forceRefresh: true } : void 0);
+  const emitLegacyState = (state) => {
+    const mapped = mapSupervisorState(state);
+    if (mapped === lastLegacyState) {
+      return;
+    }
+    lastLegacyState = mapped;
+    isConnected = mapped === "connected";
+    if (!isConnected) {
+      stopSubscriptionRefresh();
+    }
+    options.onStateChange?.(mapped);
+  };
+  const supervisor = new chunkY4OD5SDF_cjs.ConnectionSupervisor({
+    authRetryDelayMs: INITIAL_RECONNECT_DELAY_MS2,
+    baseReconnectDelayMs: INITIAL_RECONNECT_DELAY_MS2,
+    getToken: options.getToken,
+    id: "primary",
+    isAuthError: (error) => error instanceof AuthSseError,
+    kind: "sync-sse",
+    maxConsecutiveAuthFailures: MAX_CONSECUTIVE_AUTH_FAILURES2,
+    maxReconnectDelayMs: MAX_RECONNECT_DELAY_MS2,
+    onStateChange: (snapshot) => emitLegacyState(snapshot.state),
+    dial: async (context) => {
       const url = new URL(options.url);
       if (currentLastSyncId && currentLastSyncId !== "0") {
         url.searchParams.set("lastSyncId", currentLastSyncId);
@@ -8123,11 +8015,11 @@ function createSseTransport(options) {
       const response = await fetch(url.toString(), {
         method: "GET",
         headers: {
-          Authorization: `Bearer ${token}`,
+          Authorization: `Bearer ${context.token}`,
           Accept: "text/event-stream",
           "Cache-Control": "no-cache"
         },
-        signal: abortController.signal
+        signal: context.signal
       });
       if (!response.ok) {
         if (response.status === 401 || response.status === 403) {
@@ -8138,73 +8030,100 @@ function createSseTransport(options) {
       if (!response.body) {
         throw new Error("SSE response has no body");
       }
-      isConnected = true;
-      consecutiveAuthFailures = 0;
-      reconnectDelay = INITIAL_RECONNECT_DELAY_MS2;
-      options.onStateChange?.("connected");
       const isReconnect = hasConnectedOnce;
       hasConnectedOnce = true;
-      await syncActiveSubscriptions(token);
+      context.markConnected();
+      await syncActiveSubscriptions(context.token);
       startSubscriptionRefresh();
       if (isReconnect && activeSubscriptions.size > 0) {
         options.onReconnect?.();
       }
-      await parseSseStream(response.body, abortController.signal);
-    } catch (err) {
-      if (err.name === "AbortError") {
-        return;
-      }
-      isConnected = false;
-      stopSubscriptionRefresh();
+      await chunkY4OD5SDF_cjs.consumeSseStream(response.body, context.signal, {
+        onChunk: () => context.markActivity(),
+        onEventBlock: (block) => processEventBlock(block, context.requestTokenRefresh)
+      });
+    }
+  });
+  async function connect(lastSyncId) {
+    currentLastSyncId = lastSyncId;
+    disconnect();
+    await supervisor.start();
+  }
+  function disconnect() {
+    supervisor.stop();
+    isConnected = false;
+    stopSubscriptionRefresh();
+    if (lastLegacyState !== "disconnected") {
+      lastLegacyState = "disconnected";
       options.onStateChange?.("disconnected");
-      if (shouldReconnect) {
-        const isAuth = err instanceof AuthSseError;
-        if (isAuth) {
-          consecutiveAuthFailures++;
-          if (consecutiveAuthFailures >= MAX_CONSECUTIVE_AUTH_FAILURES2) {
-            disconnect();
-            return;
-          }
-          needsForceRefresh = true;
-        }
-        const delay = isAuth ? INITIAL_RECONNECT_DELAY_MS2 : reconnectDelay;
-        reconnectTimer = setTimeout(() => {
-          doConnect();
-        }, delay);
-        if (!isAuth) {
-          reconnectDelay = Math.min(reconnectDelay * RECONNECT_BACKOFF_MULTIPLIER2, MAX_RECONNECT_DELAY_MS2);
-        }
-      }
     }
   }
-  async function parseSseStream(body, signal) {
-    const reader = body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    try {
-      while (!signal.aborted) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        const parts = buffer.split(/(?:\r\n|\r|\n){2}/);
-        buffer = parts.pop() ?? "";
-        for (const part of parts) {
-          processEventBlock(part.trim());
-        }
-      }
-    } finally {
-      reader.releaseLock();
+  function reconnect() {
+    supervisor.reconnect();
+  }
+  function subscribe(descriptor) {
+    activeSubscriptions.set(descriptor.id, descriptor);
+    if (isConnected) {
+      startSubscriptionRefresh();
     }
-    if (shouldReconnect) {
-      isConnected = false;
+    void postMessage({ type: "subscribe", subscription: descriptor });
+  }
+  function unsubscribe(subscriptionId) {
+    activeSubscriptions.delete(subscriptionId);
+    if (activeSubscriptions.size === 0) {
       stopSubscriptionRefresh();
-      options.onStateChange?.("disconnected");
-      reconnectTimer = setTimeout(() => {
-        doConnect();
-      }, reconnectDelay);
     }
+    void postMessage({ type: "unsubscribe", subscriptionId });
+  }
+  function startSubscriptionRefresh() {
+    if (!isConnected || activeSubscriptions.size === 0 || refreshTimer) {
+      return;
+    }
+    refreshTimer = setInterval(() => {
+      void syncActiveSubscriptions();
+    }, SUBSCRIPTION_REFRESH_INTERVAL_MS);
+  }
+  function stopSubscriptionRefresh() {
+    if (!refreshTimer) {
+      return;
+    }
+    clearInterval(refreshTimer);
+    refreshTimer = void 0;
+  }
+  async function syncActiveSubscriptions(token) {
+    if (activeSubscriptions.size === 0) {
+      return;
+    }
+    const resolvedToken = token ?? await options.getToken().catch(() => void 0);
+    if (!resolvedToken) {
+      return;
+    }
+    await Promise.all(
+      Array.from(activeSubscriptions.values()).map(
+        (descriptor) => postMessage({ type: "subscribe", subscription: descriptor }, resolvedToken).catch(() => {
+        })
+      )
+    );
   }
-  function processEventBlock(block) {
+  async function postMessage(body, token) {
+    let resolvedToken = token ?? await options.getToken();
+    const url = new URL(options.url);
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${resolvedToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(body)
+      });
+      if (response.status !== 401 && response.status !== 403) {
+        return;
+      }
+      resolvedToken = await chunkY4OD5SDF_cjs.refreshTokenSingleFlight(options.getToken, resolvedToken);
+    }
+  }
+  function processEventBlock(block, requestTokenRefresh) {
     if (!block || block.startsWith(":")) {
       return;
     }
@@ -8221,8 +8140,8 @@ function createSseTransport(options) {
       }
     }
     if (eventType === "token-expired") {
-      needsForceRefresh = true;
-      return;
+      requestTokenRefresh();
+      throw new AuthSseError(401);
     }
     if (eventType === "full-resync") {
       options.onFullResync?.();
@@ -8239,7 +8158,9 @@ function createSseTransport(options) {
       }
       return;
     }
-    if (!eventId) return;
+    if (!eventId) {
+      return;
+    }
     currentLastSyncId = eventId;
     if (eventType === "cursor") {
       options.onCursor?.(eventId);
@@ -8256,82 +8177,10 @@ function createSseTransport(options) {
       }
     }
   }
-  function disconnect() {
-    shouldReconnect = false;
-    isConnected = false;
-    stopSubscriptionRefresh();
-    if (reconnectTimer) {
-      clearTimeout(reconnectTimer);
-      reconnectTimer = void 0;
-    }
-    if (abortController) {
-      abortController.abort();
-      abortController = void 0;
-    }
-    options.onStateChange?.("disconnected");
-  }
-  function subscribe(descriptor) {
-    activeSubscriptions.set(descriptor.id, descriptor);
-    if (isConnected) {
-      startSubscriptionRefresh();
-    }
-    postMessage({ type: "subscribe", subscription: descriptor }).catch(() => {
-    });
-  }
-  function unsubscribe(subscriptionId) {
-    activeSubscriptions.delete(subscriptionId);
-    if (activeSubscriptions.size === 0) {
-      stopSubscriptionRefresh();
-    }
-    postMessage({ type: "unsubscribe", subscriptionId }).catch(() => {
-    });
-  }
-  function startSubscriptionRefresh() {
-    if (!isConnected || activeSubscriptions.size === 0 || refreshTimer) {
-      return;
-    }
-    refreshTimer = setInterval(() => {
-      syncActiveSubscriptions().catch(() => {
-      });
-    }, SUBSCRIPTION_REFRESH_INTERVAL_MS);
-  }
-  function stopSubscriptionRefresh() {
-    if (!refreshTimer) {
-      return;
-    }
-    clearInterval(refreshTimer);
-    refreshTimer = void 0;
-  }
-  async function syncActiveSubscriptions(token) {
-    if (activeSubscriptions.size === 0) {
-      return;
-    }
-    const resolvedToken = token ?? await options.getToken().catch(() => void 0);
-    if (!resolvedToken) {
-      return;
-    }
-    await Promise.all(
-      Array.from(activeSubscriptions.values()).map(
-        (descriptor) => postMessage({ type: "subscribe", subscription: descriptor }, resolvedToken).catch(() => {
-        })
-      )
-    );
-  }
-  async function postMessage(body, token) {
-    const resolvedToken = token ?? await options.getToken();
-    const url = new URL(options.url);
-    await fetch(url.toString(), {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${resolvedToken}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
-    });
-  }
   return {
     connect,
     disconnect,
+    reconnect,
     subscribe,
     unsubscribe,
     get connected() {
@@ -10242,6 +10091,8 @@ async function applyRemoteCacheEpoch(db, engine, syncPolicyUrl, getToken) {
 function createLazySyncEngine(httpTransport, sseUrl, syncPolicyUrl, getToken, getDb) {
   let realEngine;
   let initPromise;
+  let activeSseTransport;
+  let shouldKeepSyncRunning = false;
   async function getEngine() {
     if (realEngine) return realEngine;
     if (initPromise) return initPromise;
@@ -10274,10 +10125,12 @@ function createLazySyncEngine(httpTransport, sseUrl, syncPolicyUrl, getToken, ge
           }
         });
         sseTransport = transport;
+        activeSseTransport = transport;
       }
       realEngine = new SyncEngine({ db, httpTransport, sseTransport });
       await applyRemoteCacheEpoch(db, realEngine, syncPolicyUrl, getToken);
       if (sseTransport) {
+        shouldKeepSyncRunning = true;
         realEngine.startSync().catch(() => {
         });
       }
@@ -10323,11 +10176,19 @@ function createLazySyncEngine(httpTransport, sseUrl, syncPolicyUrl, getToken, ge
   };
   lazy.startSync = async function() {
     const engine = await getEngine();
+    shouldKeepSyncRunning = true;
     return engine.startSync();
   };
   lazy.stopSync = function() {
+    shouldKeepSyncRunning = false;
     realEngine?.stopSync();
   };
+  lazy.reconnectActiveSync = function() {
+    if (!shouldKeepSyncRunning) {
+      return;
+    }
+    activeSseTransport?.reconnect();
+  };
   lazy.processSyncEvent = async function(event) {
     const engine = await getEngine();
     return engine.processSyncEvent(event);
@@ -10516,6 +10377,7 @@ function isBrowserRuntime() {
 var DEFAULT_BASE_URL = "api.dvina.ai";
 var DB_INIT_TOKEN_POLL_INTERVAL_MS = 100;
 var DB_INIT_TOKEN_TIMEOUT_MS = 15e3;
+var LIFECYCLE_HINT_DEBOUNCE_MS = 250;
 function resolveGetToken(options) {
   if ("getToken" in options && options.getToken) {
     return options.getToken;
@@ -10565,7 +10427,7 @@ function createDvinaClient(options) {
   const getToken = resolveGetToken(options);
   const getLanguage = resolveLanguage(options.language);
   const getUserTimezone = resolveUserTimezone();
-  const httpTransport = chunkBL3GFOZR_cjs.createHttpTransport({
+  const httpTransport = chunkY4OD5SDF_cjs.createHttpTransport({
     url: httpUrl,
     getToken,
     getLanguage,
@@ -10613,6 +10475,7 @@ function createDvinaClient(options) {
     });
   }
   const syncEngine = createLazySyncEngine(httpTransport, sseUrl, syncPolicyUrl, getToken, getDb);
+  const recoverableSyncEngine = syncEngine;
   const request = async (document2, variables, _options) => {
     return syncEngine.query(document2, variables);
   };
@@ -10623,7 +10486,22 @@ function createDvinaClient(options) {
   const billingBase = hasProtocol ? billingOverride.replace(/\/+$/, "") : `${httpProtocol}://${billingOverride ?? baseUrl.replace(/^api\./, "billing.")}`;
   const billingHttpUrl = `${billingBase}/graphql`;
   const billingSseUrl = `${billingBase}/subscriptions/stream`;
-  const billing = new chunkBL3GFOZR_cjs.BillingClient({ billingHttpUrl, billingSseUrl, getToken, onError: options.onError });
+  const billing = new chunkY4OD5SDF_cjs.BillingClient({ billingHttpUrl, billingSseUrl, getToken, onError: options.onError });
+  let lifecycleHintTimer;
+  const lifecycle = {
+    hint(_reason) {
+      if (lifecycleHintTimer) {
+        return;
+      }
+      lifecycleHintTimer = setTimeout(() => {
+        lifecycleHintTimer = void 0;
+        recoverableSyncEngine.reconnectActiveSync();
+        chatStream.reconnectAll();
+        wsTransport?.terminate();
+        billing.reconnectAll();
+      }, LIFECYCLE_HINT_DEBOUNCE_MS);
+    }
+  };
   return {
     syncEngine,
     request,
@@ -10641,6 +10519,7 @@ function createDvinaClient(options) {
     },
     inference,
     billing,
+    lifecycle,
     baseUrl
   };
 }
@@ -10940,7 +10819,7 @@ function buildSmartQuery(baseDocument, rootFieldName, includes, baseVariables, i
   }
   const doc = cloneDocument(baseDocument);
   const mergedVariables = { ...baseVariables };
-  const opDef = doc.definitions.find((d) => d.kind === chunkBL3GFOZR_cjs.Kind.OPERATION_DEFINITION);
+  const opDef = doc.definitions.find((d) => d.kind === chunkY4OD5SDF_cjs.Kind.OPERATION_DEFINITION);
   if (!opDef) {
     return { document: baseDocument, variables: baseVariables };
   }
@@ -10950,7 +10829,7 @@ function buildSmartQuery(baseDocument, rootFieldName, includes, baseVariables, i
   }
   const existingFragments = /* @__PURE__ */ new Set();
   for (const def of doc.definitions) {
-    if (def.kind === chunkBL3GFOZR_cjs.Kind.FRAGMENT_DEFINITION) {
+    if (def.kind === chunkY4OD5SDF_cjs.Kind.FRAGMENT_DEFINITION) {
       existingFragments.add(def.name.value);
     }
   }
@@ -10974,10 +10853,10 @@ function buildSmartQuery(baseDocument, rootFieldName, includes, baseVariables, i
   }
   if (isConnection && connectionIncludeFields.length > 0) {
     const nodesWrapper = {
-      kind: chunkBL3GFOZR_cjs.Kind.FIELD,
-      name: { kind: chunkBL3GFOZR_cjs.Kind.NAME, value: "nodes" },
+      kind: chunkY4OD5SDF_cjs.Kind.FIELD,
+      name: { kind: chunkY4OD5SDF_cjs.Kind.NAME, value: "nodes" },
       selectionSet: {
-        kind: chunkBL3GFOZR_cjs.Kind.SELECTION_SET,
+        kind: chunkY4OD5SDF_cjs.Kind.SELECTION_SET,
         selections: connectionIncludeFields
       }
     };
@@ -10991,14 +10870,14 @@ function buildSmartQuery(baseDocument, rootFieldName, includes, baseVariables, i
 function processIncludeDirective(include, prefix, opDef, mergedVariables, existingFragments, newDefinitions) {
   const fieldArgs = buildPrefixedArguments(include.fieldArguments ?? [], prefix);
   const fragmentDefs = include.fragmentDoc.definitions.filter(
-    (d) => d.kind === chunkBL3GFOZR_cjs.Kind.FRAGMENT_DEFINITION
+    (d) => d.kind === chunkY4OD5SDF_cjs.Kind.FRAGMENT_DEFINITION
   );
   const mainFragment = fragmentDefs[0];
   if (!mainFragment) return void 0;
   const selections = [
     {
-      kind: chunkBL3GFOZR_cjs.Kind.FRAGMENT_SPREAD,
-      name: { kind: chunkBL3GFOZR_cjs.Kind.NAME, value: mainFragment.name.value }
+      kind: chunkY4OD5SDF_cjs.Kind.FRAGMENT_SPREAD,
+      name: { kind: chunkY4OD5SDF_cjs.Kind.NAME, value: mainFragment.name.value }
     }
   ];
   if (include.children && include.children.length > 0) {
@@ -11020,10 +10899,10 @@ function processIncludeDirective(include, prefix, opDef, mergedVariables, existi
     if (childFields.length > 0) {
       if (include.isConnection) {
         const nodesWrapper = {
-          kind: chunkBL3GFOZR_cjs.Kind.FIELD,
-          name: { kind: chunkBL3GFOZR_cjs.Kind.NAME, value: "nodes" },
+          kind: chunkY4OD5SDF_cjs.Kind.FIELD,
+          name: { kind: chunkY4OD5SDF_cjs.Kind.NAME, value: "nodes" },
           selectionSet: {
-            kind: chunkBL3GFOZR_cjs.Kind.SELECTION_SET,
+            kind: chunkY4OD5SDF_cjs.Kind.SELECTION_SET,
             selections: childFields
           }
         };
@@ -11034,11 +10913,11 @@ function processIncludeDirective(include, prefix, opDef, mergedVariables, existi
     }
   }
   const includeField = {
-    kind: chunkBL3GFOZR_cjs.Kind.FIELD,
-    name: { kind: chunkBL3GFOZR_cjs.Kind.NAME, value: include.fieldName },
+    kind: chunkY4OD5SDF_cjs.Kind.FIELD,
+    name: { kind: chunkY4OD5SDF_cjs.Kind.NAME, value: include.fieldName },
     arguments: fieldArgs.length > 0 ? fieldArgs : void 0,
     selectionSet: {
-      kind: chunkBL3GFOZR_cjs.Kind.SELECTION_SET,
+      kind: chunkY4OD5SDF_cjs.Kind.SELECTION_SET,
       selections
     }
   };
@@ -11065,7 +10944,7 @@ function processIncludeDirective(include, prefix, opDef, mergedVariables, existi
 }
 function findFieldInSelectionSet(selectionSet, fieldName) {
   for (const selection of selectionSet.selections) {
-    if (selection.kind === chunkBL3GFOZR_cjs.Kind.FIELD && selection.name.value === fieldName) {
+    if (selection.kind === chunkY4OD5SDF_cjs.Kind.FIELD && selection.name.value === fieldName) {
       return selection;
     }
   }
@@ -11079,7 +10958,7 @@ function buildPrefixedArguments(args, prefix) {
   });
 }
 function prefixVariableReferences(node, prefix) {
-  if (node["kind"] === chunkBL3GFOZR_cjs.Kind.VARIABLE && typeof node["name"]?.["value"] === "string") {
+  if (node["kind"] === chunkY4OD5SDF_cjs.Kind.VARIABLE && typeof node["name"]?.["value"] === "string") {
     node["name"]["value"] = `${prefix}${node["name"]["value"]}`;
     return;
   }
@@ -11104,7 +10983,7 @@ function buildPrefixedVariableDefinitions(varDefs, prefix) {
 }
 function extractIncludeInfo(nestedDocument, nestedFieldName, parentVarNames) {
   const opDef = nestedDocument.definitions.find(
-    (d) => d.kind === chunkBL3GFOZR_cjs.Kind.OPERATION_DEFINITION
+    (d) => d.kind === chunkY4OD5SDF_cjs.Kind.OPERATION_DEFINITION
   );
   if (!opDef) {
     return { variableDefinitions: [], fieldArguments: [] };
@@ -11116,7 +10995,7 @@ function extractIncludeInfo(nestedDocument, nestedFieldName, parentVarNames) {
   let fieldArguments = [];
   function findNestedField(selectionSet) {
     for (const sel of selectionSet.selections) {
-      if (sel.kind === chunkBL3GFOZR_cjs.Kind.FIELD) {
+      if (sel.kind === chunkY4OD5SDF_cjs.Kind.FIELD) {
         if (sel.name.value === nestedFieldName && sel.arguments) {
           fieldArguments = sel.arguments;
           return;
@@ -22136,6 +22015,8 @@ var DvinaSdk = class extends chunk342BFYZZ_cjs.Request {
   syncEngine;
   /** Chat SSE client for chat-scoped stream listeners. */
   chatStream;
+  /** Semantic lifecycle bridge for connectivity and foreground recovery hints. */
+  lifecycle;
   _getToken;
   _terminateWs;
   _closeDb;
@@ -22144,10 +22025,11 @@ var DvinaSdk = class extends chunk342BFYZZ_cjs.Request {
   /** Billing client for the Dvina Billing API (plans, subscriptions, seats, sessions). */
   billing;
   constructor(options) {
-    const { syncEngine, request, subscribe, chatStream, getToken, terminateWs, closeDb, inference, billing, baseUrl } = createDvinaClient(options);
+    const { syncEngine, request, subscribe, chatStream, lifecycle, getToken, terminateWs, closeDb, inference, billing, baseUrl } = createDvinaClient(options);
     super(request, syncEngine, subscribe, baseUrl);
     this.syncEngine = syncEngine;
     this.chatStream = chatStream;
+    this.lifecycle = lifecycle;
     this._getToken = getToken;
     this._terminateWs = terminateWs;
     this._closeDb = closeDb;
@@ -23178,5 +23060,5 @@ exports.getOrCreateDatabase = getOrCreateDatabase;
 exports.reconstructConnectionNodes = reconstructConnectionNodes;
 exports.reconstructEntity = reconstructEntity;
 exports.uploadFile = uploadFile;
-//# sourceMappingURL=chunk-4EESBP3A.cjs.map
-//# sourceMappingURL=chunk-4EESBP3A.cjs.map
+//# sourceMappingURL=chunk-XK5PW7IX.cjs.map
+//# sourceMappingURL=chunk-XK5PW7IX.cjs.map