convex 1.26.0-alpha.2 → 1.26.0-alpha.3

package/dist/browser.bundle.js

@@ -28,7 +28,7 @@ var convex = (() => {
   });
 
   // src/index.ts
-  var version = "1.26.0-alpha.2";
+  var version = "1.26.0-alpha.3";
 
   // src/values/base64.ts
   var base64_exports = {};
@@ -897,8 +897,9 @@ var convex = (() => {
 
   // src/browser/sync/request_manager.ts
   var RequestManager = class {
-    constructor(logger) {
+    constructor(logger, markConnectionStateDirty) {
       this.logger = logger;
+      this.markConnectionStateDirty = markConnectionStateDirty;
       this.inflightRequests = /* @__PURE__ */ new Map();
       this.requestsOlderThanRestart = /* @__PURE__ */ new Set();
     }
@@ -919,6 +920,7 @@ var convex = (() => {
           this.inflightActionsCount++;
         }
       });
+      this.markConnectionStateDirty();
       return result;
     }
     /**
@@ -971,6 +973,7 @@ var convex = (() => {
         } else if (requestInfo.message.type === "Mutation") {
           this.inflightMutationsCount--;
         }
+        this.markConnectionStateDirty();
         return { requestId: response.requestId, result };
       }
       requestInfo.status = {
@@ -998,6 +1001,9 @@ var convex = (() => {
           this.requestsOlderThanRestart.delete(requestId);
         }
       }
+      if (completeRequests.size > 0) {
+        this.markConnectionStateDirty();
+      }
       return completeRequests;
     }
     restart() {
@@ -1025,6 +1031,7 @@ var convex = (() => {
           });
         }
       }
+      this.markConnectionStateDirty();
       return allMessages;
     }
     resume() {
@@ -1576,6 +1583,25 @@ var convex = (() => {
     return "Unknown";
   }
   var WebSocketManager = class {
+    constructor(uri, callbacks, webSocketConstructor, logger, markConnectionStateDirty) {
+      this.markConnectionStateDirty = markConnectionStateDirty;
+      this.webSocketConstructor = webSocketConstructor;
+      this.socket = { state: "disconnected" };
+      this.connectionCount = 0;
+      this.lastCloseReason = "InitialConnect";
+      this.defaultInitialBackoff = 1e3;
+      this.maxBackoff = 16e3;
+      this.retries = 0;
+      this.serverInactivityThreshold = 3e4;
+      this.reconnectDueToServerInactivityTimeout = null;
+      this.uri = uri;
+      this.onOpen = callbacks.onOpen;
+      this.onResume = callbacks.onResume;
+      this.onMessage = callbacks.onMessage;
+      this.onServerDisconnectError = callbacks.onServerDisconnectError;
+      this.logger = logger;
+      this.connect();
+    }
     socket;
     connectionCount;
     _hasEverConnected = false;
@@ -1597,29 +1623,12 @@ var convex = (() => {
     webSocketConstructor;
     logger;
     onServerDisconnectError;
-    constructor(uri, callbacks, webSocketConstructor, logger) {
-      this.webSocketConstructor = webSocketConstructor;
-      this.socket = { state: "disconnected" };
-      this.connectionCount = 0;
-      this.lastCloseReason = "InitialConnect";
-      this.defaultInitialBackoff = 1e3;
-      this.maxBackoff = 16e3;
-      this.retries = 0;
-      this.serverInactivityThreshold = 3e4;
-      this.reconnectDueToServerInactivityTimeout = null;
-      this.uri = uri;
-      this.onOpen = callbacks.onOpen;
-      this.onResume = callbacks.onResume;
-      this.onMessage = callbacks.onMessage;
-      this.onServerDisconnectError = callbacks.onServerDisconnectError;
-      this.logger = logger;
-      this.connect();
-    }
     setSocketState(state) {
       this.socket = state;
       this._logVerbose(
         `socket state changed: ${this.socket.state}, paused: ${"paused" in this.socket ? this.socket.paused : void 0}`
       );
+      this.markConnectionStateDirty();
     }
     connect() {
       if (this.socket.state === "terminated") {
@@ -1673,6 +1682,7 @@ var convex = (() => {
         const response = this.onMessage(serverMessage);
         if (response.hasSyncedPastLastReconnect) {
           this.retries = 0;
+          this.markConnectionStateDirty();
         }
       };
       ws.onclose = (event) => {
@@ -1753,6 +1763,7 @@ var convex = (() => {
     scheduleReconnect(reason) {
       this.socket = { state: "disconnected" };
       const backoff = this.nextBackoff(reason);
+      this.markConnectionStateDirty();
       this.logger.log(`Attempting reconnect in ${backoff}ms`);
       setTimeout(() => this.connect(), backoff);
     }
@@ -2388,6 +2399,9 @@ var convex = (() => {
     debug;
     logger;
     maxObservedTimestamp;
+    connectionStateSubscribers = /* @__PURE__ */ new Map();
+    nextConnectionStateSubscriberId = 0;
+    _lastPublishedConnectionState;
     /**
      * @param address - The url of your Convex deployment, often provided
      * by an environment variable. E.g. `https://small-mouse-123.convex.cloud`.
@@ -2437,7 +2451,10 @@ var convex = (() => {
         (queryId) => this.state.queryPath(queryId),
         this.logger
       );
-      this.requestManager = new RequestManager(this.logger);
+      this.requestManager = new RequestManager(
+        this.logger,
+        this.markConnectionStateDirty
+      );
       this.authenticationManager = new AuthenticationManager(
         this.state,
         {
@@ -2588,7 +2605,8 @@ var convex = (() => {
           onServerDisconnectError: options.onServerDisconnectError
         },
         webSocketConstructor,
-        this.logger
+        this.logger,
+        this.markConnectionStateDirty
       );
       this.mark("convexClientConstructed");
     }
@@ -2805,6 +2823,38 @@ var convex = (() => {
         inflightActions: this.requestManager.inflightActions()
       };
     }
+    /**
+     * Call this whenever the connection state may have changed in a way that could
+     * require publishing it. Schedules a possibly update.
+     */
+    markConnectionStateDirty = () => {
+      void Promise.resolve().then(() => {
+        const curConnectionState = this.connectionState();
+        if (JSON.stringify(curConnectionState) !== JSON.stringify(this._lastPublishedConnectionState)) {
+          this._lastPublishedConnectionState = curConnectionState;
+          for (const cb of this.connectionStateSubscribers.values()) {
+            cb(curConnectionState);
+          }
+        }
+      });
+    };
+    /**
+     * Subscribe to the {@link ConnectionState} between the client and the Convex
+     * backend, calling a callback each time it changes.
+     *
+     * Subscribed callbacks will be called when any part of ConnectionState changes.
+     * ConnectionState may grow in future versions (e.g. to provide a array of
+     * inflight requests) in which case callbacks would be called more frequently.
+     *
+     * @returns An unsubscribe function to stop listening.
+     */
+    subscribeToConnectionState(cb) {
+      const id = this.nextConnectionStateSubscriberId++;
+      this.connectionStateSubscribers.set(id, cb);
+      return () => {
+        this.connectionStateSubscribers.delete(id);
+      };
+    }
     /**
        * Execute a mutation function.
        *
@@ -3275,6 +3325,31 @@ var convex = (() => {
         );
       });
     }
+    /**
+     * Get the current {@link ConnectionState} between the client and the Convex
+     * backend.
+     *
+     * @returns The {@link ConnectionState} with the Convex backend.
+     */
+    connectionState() {
+      if (this.disabled) throw new Error("ConvexClient is disabled");
+      return this.client.connectionState();
+    }
+    /**
+     * Subscribe to the {@link ConnectionState} between the client and the Convex
+     * backend, calling a callback each time it changes.
+     *
+     * Subscribed callbacks will be called when any part of ConnectionState changes.
+     * ConnectionState may grow in future versions (e.g. to provide a array of
+     * inflight requests) in which case callbacks would be called more frequently.
+     *
+     * @returns An unsubscribe function to stop listening.
+     */
+    subscribeToConnectionState(cb) {
+      if (this.disabled) return () => {
+      };
+      return this.client.subscribeToConnectionState(cb);
+    }
   };
 
   // src/browser/http_client.ts