convex 1.24.0 → 1.25.0-alpha.0

package/CHANGELOG.md

@@ -1,16 +1,47 @@
 # Changelog
 
-## Unreleased
+## 1.24.1
 
-- The `npx convex login --login-flow paste` flag can be used to explicitly opt
-  into the manual token paste login method.
+- Accept `true` and `false` as values for logger in all clients, making
+  disabling logs from convex functions run on a development deployment simpler:
+  it's no longer necessary write your own no-op logger.
+
+## 1.24.0
 
-- Drop support for React 17 and remove use of `unstable_batchedUpdates` as react
+- Drop support for React 17 and remove use of `unstable_batchedUpdates` as React
   18 introduced
   [Automatic batching](https://react.dev/blog/2022/03/29/react-v18#new-feature-automatic-batching)
 
+  If you use React 17 and choose to override the change in supported peer
+  dependencies (please don't), you may notice query updates are no longer
+  batched: it's possible for one Convex query update to occur on a different
+  React render than another causing single frames of discrepancies in UI or
+  worse, errors if you have code that relies on the client-side consistency like
+  client-side joins.
+
+  You may also notice nothing. Without batched updates some queries may be a few
+  milliseconds ahead of other queries, which is still much less than the
+  differences in other data fetching solutions, e.g. React Query or SWR, in
+  non-batched mode.
+
 - Remove dependency on `react-dom`, making it possible to use on "React Native
-  only" projects.
+  only" projects without overriding any dependency resolution.
+
+- New optimistic update helpers for paginated queries: three helpers
+  `insertAtTop`, `insertAtBottomIfLoaded`, and `insertAtPosition`.
+
+- The `npx convex login --login-flow paste` flag can be used to explicitly opt
+  into the manual token paste login method.
+
+- Fix MCP servers for self-hosted deployments: previously MCP CLI commands were
+  attempting to contact a cloud deployment (which didn't exist) in self-hosted
+  setups.
+
+- New `compareValues` function exported from `convex/values` which matches
+  Convex values semantics as implemented in backends. This function should match
+  the Rust implementation in backend (and it property-tested in pursuit of
+  this!) but in the event of discrepancies the Rust implementation should be
+  considered authoritative.
 
 ## 1.23.0
 

package/dist/browser.bundle.js

@@ -28,7 +28,7 @@ var convex = (() => {
   });
 
   // src/index.ts
-  var version = "1.24.0";
+  var version = "1.25.0-alpha.0";
 
   // src/values/base64.ts
   var base64_exports = {};
@@ -548,6 +548,9 @@ var convex = (() => {
     });
     return logger;
   }
+  function instantiateNoopLogger(options) {
+    return new Logger(options);
+  }
   function logForFunction(logger, type, source, udfPath, message) {
     const prefix = prefix_for_source(source);
     if (typeof message === "object") {
@@ -2367,7 +2370,7 @@ var convex = (() => {
       webSocketConstructor = webSocketConstructor || WebSocket;
       this.debug = options.reportDebugInfoToConvex ?? false;
       this.address = address;
-      this.logger = options.logger ?? instantiateDefaultLogger({ verbose: options.verbose ?? false });
+      this.logger = options.logger === false ? instantiateNoopLogger({ verbose: options.verbose ?? false }) : options.logger !== true && options.logger ? options.logger : instantiateDefaultLogger({ verbose: options.verbose ?? false });
       const i = address.search("://");
       if (i === -1) {
         throw new Error("Provided address was not an absolute URL.");
@@ -2971,7 +2974,7 @@ var convex = (() => {
     // A synthetic server event to run callbacks the first time
     callNewListenersWithCurrentValuesTimer;
     _closed;
-    disabled;
+    _disabled;
     /**
      * Once closed no registered callbacks will fire again.
      */
@@ -2982,6 +2985,9 @@ var convex = (() => {
       if (this._client) return this._client;
       throw new Error("ConvexClient is disabled");
     }
+    get disabled() {
+      return this._disabled;
+    }
     /**
      * Construct a client and immediately initiate a WebSocket connection to the passed address.
      *
@@ -2993,7 +2999,7 @@ var convex = (() => {
       }
       const { disabled, ...baseOptions } = options;
       this._closed = false;
-      this.disabled = !!disabled;
+      this._disabled = !!disabled;
       if (defaultWebSocketConstructor && !("webSocketConstructor" in baseOptions) && typeof WebSocket === "undefined") {
         baseOptions.webSocketConstructor = defaultWebSocketConstructor;
       }
@@ -3108,10 +3114,11 @@ var convex = (() => {
      * `fetchToken` will be called automatically again if a token expires.
      * `fetchToken` should return `null` if the token cannot be retrieved, for example
      * when the user's rights were permanently revoked.
-     * @param fetchToken - an async function returning the JWT-encoded OpenID Connect Identity Token
+     * @param fetchToken - an async function returning the JWT (typically an OpenID Connect Identity Token)
      * @param onChange - a callback that will be called when the authentication status changes
      */
     setAuth(fetchToken, onChange) {
+      if (this.disabled) return;
       this.client.setAuth(
         fetchToken,
         onChange ?? (() => {
@@ -3246,7 +3253,7 @@ var convex = (() => {
       if (opts.skipConvexDeploymentUrlCheck !== true) {
         validateDeploymentUrl(address);
       }
-      this.logger = opts.logger ?? instantiateDefaultLogger({ verbose: false });
+      this.logger = options?.logger === false ? instantiateNoopLogger({ verbose: false }) : options?.logger !== true && options?.logger ? options.logger : instantiateDefaultLogger({ verbose: false });
       this.address = address;
       this.debug = true;
     }