jazz-tools 0.19.7 → 0.19.8

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> jazz-tools@0.19.7 build /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.19.8 build /home/runner/_work/jazz/jazz/packages/jazz-tools
 > tsup && pnpm types && pnpm build:svelte
 
 CLI Building entry: {"index":"src/index.ts","testing":"src/testing.ts","tools/ssr":"src/tools/ssr/index.ts"}
@@ -8,7 +8,7 @@
 CLI Using tsconfig: tsconfig.json
 CLI Building entry: {"index":"src/media/index.ts","index.browser":"src/media/index.browser.ts","index.native":"src/media/index.native.ts","index.server":"src/media/index.server.ts"}
 CLI Using tsconfig: tsconfig.json
-CLI Building entry: {"index":"src/expo/index.ts","testing":"src/expo/testing.ts","crypto":"src/expo/crypto.ts"}
+CLI Building entry: {"index":"src/expo/index.ts","testing":"src/expo/testing.ts","crypto":"src/expo/crypto.ts","polyfills":"src/react-native-core/polyfills/index.js"}
 CLI Using tsconfig: tsconfig.json
 CLI Building entry: {"index":"src/inspector/index.tsx"}
 CLI Using tsconfig: tsconfig.json
@@ -20,7 +20,7 @@
 CLI Using tsconfig: tsconfig.json
 CLI Building entry: {"index":"src/react-core/index.ts","testing":"src/react-core/testing.tsx"}
 CLI Using tsconfig: tsconfig.json
-CLI Building entry: {"index":"src/react-native/index.ts","testing":"src/react-native/testing.ts","crypto":"src/react-native/crypto.ts"}
+CLI Building entry: {"index":"src/react-native/index.ts","testing":"src/react-native/testing.ts","crypto":"src/react-native/crypto.ts","polyfills":"src/react-native-core/polyfills/index.js"}
 CLI Using tsconfig: tsconfig.json
 CLI Building entry: {"index":"src/react-native-core/index.ts","testing":"src/react-native-core/testing.tsx","crypto":"src/react-native-core/crypto/index.ts"}
 CLI Using tsconfig: tsconfig.json
@@ -107,105 +107,109 @@
 ESM Build start
 CLI Cleaning output folder
 ESM Build start
+ESM dist/tiptap/index.js     564.00 B
+ESM dist/tiptap/index.js.map 1.21 KB
+ESM ⚡️ Build success in 51ms
 ESM dist/worker/index.js           3.19 KB
-ESM dist/worker/napi-crypto.js     110.00 B
 ESM dist/worker/edge-wasm.js       215.00 B
+ESM dist/worker/napi-crypto.js     110.00 B
 ESM dist/worker/index.js.map       6.24 KB
-ESM dist/worker/napi-crypto.js.map 162.00 B
 ESM dist/worker/edge-wasm.js.map   434.00 B
-ESM ⚡️ Build success in 39ms
-ESM dist/tiptap/index.js     564.00 B
-ESM dist/tiptap/index.js.map 1.21 KB
-ESM ⚡️ Build success in 54ms
+ESM dist/worker/napi-crypto.js.map 162.00 B
+ESM ⚡️ Build success in 50ms
 ESM dist/better-auth/auth/client.js     4.50 KB
 ESM dist/better-auth/auth/server.js     8.36 KB
 ESM dist/better-auth/auth/react.js      799.00 B
 ESM dist/better-auth/auth/client.js.map 8.32 KB
 ESM dist/better-auth/auth/server.js.map 15.31 KB
 ESM dist/better-auth/auth/react.js.map  2.04 KB
-ESM ⚡️ Build success in 43ms
-ESM dist/react-native/index.js       2.53 KB
-ESM dist/react-native/testing.js     120.00 B
-ESM dist/react-native/crypto.js      161.00 B
-ESM dist/react-native/testing.js.map 176.00 B
-ESM dist/react-native/index.js.map   5.68 KB
-ESM dist/react-native/crypto.js.map  197.00 B
-ESM ⚡️ Build success in 45ms
+ESM ⚡️ Build success in 51ms
 ESM dist/media/index.js              236.00 B
-ESM dist/media/index.server.js       2.95 KB
 ESM dist/media/index.browser.js      2.79 KB
 ESM dist/media/index.native.js       4.01 KB
+ESM dist/media/index.server.js       2.95 KB
 ESM dist/media/chunk-3LKBM3G3.js     6.69 KB
 ESM dist/media/index.js.map          71.00 B
 ESM dist/media/index.browser.js.map  6.15 KB
-ESM dist/media/index.server.js.map   6.37 KB
 ESM dist/media/index.native.js.map   8.10 KB
+ESM dist/media/index.server.js.map   6.37 KB
 ESM dist/media/chunk-3LKBM3G3.js.map 16.99 KB
-ESM ⚡️ Build success in 50ms
-ESM dist/expo/index.js       4.68 KB
-ESM dist/expo/testing.js     112.00 B
-ESM dist/expo/crypto.js      153.00 B
-ESM dist/expo/testing.js.map 168.00 B
-ESM dist/expo/index.js.map   10.23 KB
-ESM dist/expo/crypto.js.map  189.00 B
-ESM ⚡️ Build success in 42ms
-ESM dist/browser/index.js     14.06 KB
-ESM dist/browser/index.js.map 29.94 KB
-ESM ⚡️ Build success in 52ms
+ESM ⚡️ Build success in 59ms
+ESM dist/react-core/index.js              14.72 KB
 ESM dist/react-core/testing.js            1.22 KB
 ESM dist/react-core/chunk-7DYMJ74I.js     279.00 B
-ESM dist/react-core/index.js              14.41 KB
+ESM dist/react-core/index.js.map          41.44 KB
 ESM dist/react-core/testing.js.map        1.86 KB
 ESM dist/react-core/chunk-7DYMJ74I.js.map 533.00 B
-ESM dist/react-core/index.js.map          40.79 KB
-ESM ⚡️ Build success in 48ms
-ESM dist/react-native-core/testing.js     119.00 B
-ESM dist/react-native-core/index.js       18.97 KB
-ESM dist/react-native-core/crypto.js      2.58 KB
-ESM dist/react-native-core/testing.js.map 175.00 B
-ESM dist/react-native-core/index.js.map   38.60 KB
-ESM dist/react-native-core/crypto.js.map  5.25 KB
-ESM ⚡️ Build success in 62ms
+ESM ⚡️ Build success in 75ms
 ESM dist/prosemirror/index.js     77.76 KB
 ESM dist/prosemirror/index.js.map 307.20 KB
-ESM ⚡️ Build success in 69ms
+ESM ⚡️ Build success in 77ms
+ESM dist/browser/index.js     14.06 KB
+ESM dist/browser/index.js.map 29.94 KB
+ESM ⚡️ Build success in 80ms
 ESM dist/better-auth/database-adapter/index.js     26.65 KB
 ESM dist/better-auth/database-adapter/index.js.map 58.26 KB
-ESM ⚡️ Build success in 56ms
+ESM ⚡️ Build success in 78ms
+ESM dist/expo/index.js         4.68 KB
+ESM dist/expo/testing.js       112.00 B
+ESM dist/expo/crypto.js        153.00 B
+ESM dist/expo/polyfills.js     858.00 B
+ESM dist/expo/index.js.map     10.23 KB
+ESM dist/expo/testing.js.map   168.00 B
+ESM dist/expo/crypto.js.map    189.00 B
+ESM dist/expo/polyfills.js.map 1.61 KB
+ESM ⚡️ Build success in 85ms
+ESM dist/react-native-core/index.js       18.97 KB
+ESM dist/react-native-core/testing.js     119.00 B
+ESM dist/react-native-core/crypto.js      2.58 KB
+ESM dist/react-native-core/index.js.map   38.60 KB
+ESM dist/react-native-core/testing.js.map 175.00 B
+ESM dist/react-native-core/crypto.js.map  5.25 KB
+ESM ⚡️ Build success in 91ms
+ESM dist/react-native/index.js         21.51 KB
+ESM dist/react-native/testing.js       120.00 B
+ESM dist/react-native/crypto.js        161.00 B
+ESM dist/react-native/polyfills.js     858.00 B
+ESM dist/react-native/index.js.map     44.15 KB
+ESM dist/react-native/testing.js.map   176.00 B
+ESM dist/react-native/crypto.js.map    197.00 B
+ESM dist/react-native/polyfills.js.map 1.61 KB
+ESM ⚡️ Build success in 110ms
 ESM dist/react/index.js       25.74 KB
 ESM dist/react/testing.js     122.00 B
 ESM dist/react/ssr.js         697.00 B
+ESM dist/react/index.js.map   55.43 KB
 ESM dist/react/testing.js.map 165.00 B
 ESM dist/react/ssr.js.map     1.11 KB
-ESM dist/react/index.js.map   55.43 KB
-ESM ⚡️ Build success in 60ms
+ESM ⚡️ Build success in 101ms
 ESM dist/inspector/index.js     125.80 KB
 ESM dist/inspector/index.js.map 216.33 KB
-ESM ⚡️ Build success in 86ms
+ESM ⚡️ Build success in 127ms
+ESM dist/index.js              29.76 KB
 ESM dist/testing.js            8.51 KB
-ESM dist/chunk-PZ5AY32C.js     233.00 B
-ESM dist/chunk-M2HGBOXS.js     694.00 B
-ESM dist/index.js              29.30 KB
+ESM dist/chunk-2S3Z2CN6.js     206.41 KB
 ESM dist/tools/ssr.js          156.00 B
-ESM dist/chunk-CUS6O5NE.js     204.35 KB
+ESM dist/chunk-M2HGBOXS.js     694.00 B
+ESM dist/chunk-PZ5AY32C.js     233.00 B
+ESM dist/index.js.map          60.59 KB
 ESM dist/testing.js.map        16.17 KB
+ESM dist/chunk-2S3Z2CN6.js.map 486.44 KB
+ESM dist/tools/ssr.js.map      71.00 B
 ESM dist/chunk-M2HGBOXS.js.map 1.10 KB
 ESM dist/chunk-PZ5AY32C.js.map 71.00 B
-ESM dist/tools/ssr.js.map      71.00 B
-ESM dist/index.js.map          60.30 KB
-ESM dist/chunk-CUS6O5NE.js.map 481.42 KB
-ESM ⚡️ Build success in 97ms
+ESM ⚡️ Build success in 174ms
 ESM dist/inspector/register-custom-element.js     218.00 B
-ESM dist/inspector/register-custom-element.js.map 314.00 B
 ESM dist/inspector/custom-element-P76EIWEV.js     1.60 MB
+ESM dist/inspector/register-custom-element.js.map 314.00 B
 ESM dist/inspector/custom-element-P76EIWEV.js.map 2.45 MB
-ESM ⚡️ Build success in 157ms
+ESM ⚡️ Build success in 217ms
 
-> jazz-tools@0.19.7 types /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.19.8 types /home/runner/_work/jazz/jazz/packages/jazz-tools
 > tsc --outDir dist
 
 
-> jazz-tools@0.19.7 build:svelte /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.19.8 build:svelte /home/runner/_work/jazz/jazz/packages/jazz-tools
 > rm -rf dist/svelte && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json
 
 src/svelte -> dist/svelte

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # jazz-tools
 
+## 0.19.8
+
+### Patch Changes
+
+- 21f7d34: Improve error logging in subscriptions and add stacktraces on errors coming from React hooks.
+
+  Added jazzConfig.setCustomErrorReporter API to intercept subscription errors and send them to an error tracker.
+
+- b22ad89: Narrow down `.load` return type to not include `loading` CoValues
+- 28b23dd: Added polyfills helper to React Native and Expo exports
+- Updated dependencies [93e4a34]
+  - cojson@0.19.8
+  - cojson-storage-indexeddb@0.19.8
+  - cojson-transport-ws@0.19.8
+
 ## 0.19.7
 
 ### Patch Changes

package/dist/{chunk-CUS6O5NE.js → chunk-2S3Z2CN6.js}

@@ -4122,16 +4122,17 @@ var JazzError = class _JazzError {
     this.issues = issues;
   }
   toString() {
-    return this.issues.map((issue) => {
+    let result = this.issues.map((issue) => {
       let message = `${issue.message}`;
-      if (this.id) {
-        message += ` from ${this.id}`;
-      }
       if (issue.path.length > 0) {
-        message += ` on path ${issue.path.join(".")}`;
+        if (this.id) {
+          message += `. Subscription starts from ${this.id}`;
+        }
+        message += ` and the value is on path ${issue.path.join(".")}`;
       }
       return message;
     }).join("\n");
+    return result;
   }
   prependPath(item) {
     if (this.issues.length === 0) {
@@ -4188,9 +4189,37 @@ function createCoValue(ref2, raw, subscriptionScope) {
   };
 }
 
+// src/tools/subscribe/errorReporting.ts
+var isDev = function() {
+  try {
+    return process.env.NODE_ENV === "development";
+  } catch {
+    return false;
+  }
+}();
+var customErrorReporter;
+var captureErrorCause = isDev;
+function enableCaptureErrorCause(capture) {
+  captureErrorCause = capture;
+}
+function setCustomErrorReporter(reporter) {
+  customErrorReporter = reporter;
+}
+function isCustomErrorReportingEnabled() {
+  return customErrorReporter !== void 0;
+}
+function captureStack() {
+  return captureErrorCause ? new Error() : void 0;
+}
+function captureError(error, props) {
+  if (customErrorReporter) {
+    customErrorReporter(error, props);
+  }
+}
+
 // src/tools/subscribe/SubscriptionScope.ts
 var SubscriptionScope = class _SubscriptionScope {
-  constructor(node, resolve, id, schema, skipRetry = false, bestEffortResolution = false, unstable_branch) {
+  constructor(node, resolve, id, schema, skipRetry = false, bestEffortResolution = false, unstable_branch, callerStack) {
     this.node = node;
     this.id = id;
     this.schema = schema;
@@ -4244,6 +4273,7 @@ var SubscriptionScope = class _SubscriptionScope {
       this.triggerUpdate();
     };
     this.subscribers = /* @__PURE__ */ new Set();
+    this.callerStack = callerStack;
     this.resolve = resolve;
     this.value = { type: CoValueLoadingState.LOADING, id };
     let lastUpdate;
@@ -4281,36 +4311,35 @@ var SubscriptionScope = class _SubscriptionScope {
   handleUpdate(update) {
     if (update === CoValueLoadingState.UNAVAILABLE) {
       if (this.value.type === CoValueLoadingState.LOADING) {
-        this.updateValue(
-          new JazzError(this.id, CoValueLoadingState.UNAVAILABLE, [
-            {
-              code: CoValueLoadingState.UNAVAILABLE,
-              message: "The value is unavailable",
-              params: {
-                id: this.id
-              },
-              path: []
-            }
-          ])
-        );
+        const error = new JazzError(this.id, CoValueLoadingState.UNAVAILABLE, [
+          {
+            code: CoValueLoadingState.UNAVAILABLE,
+            message: `Jazz Unavailable Error: unable to load ${this.id}`,
+            params: {
+              id: this.id
+            },
+            path: []
+          }
+        ]);
+        this.updateValue(error);
       }
       this.triggerUpdate();
       return;
     }
     if (!hasAccessToCoValue(update)) {
       if (this.value.type !== CoValueLoadingState.UNAUTHORIZED) {
-        this.updateValue(
-          new JazzError(this.id, CoValueLoadingState.UNAUTHORIZED, [
-            {
-              code: CoValueLoadingState.UNAUTHORIZED,
-              message: `The current user (${this.node.getCurrentAgent().id}) is not authorized to access this value`,
-              params: {
-                id: this.id
-              },
-              path: []
-            }
-          ])
-        );
+        const message = `Jazz Authorization Error: The current user (${this.node.getCurrentAgent().id}) is not authorized to access ${this.id}`;
+        const error = new JazzError(this.id, CoValueLoadingState.UNAUTHORIZED, [
+          {
+            code: CoValueLoadingState.UNAUTHORIZED,
+            message,
+            params: {
+              id: this.id
+            },
+            path: []
+          }
+        ]);
+        this.updateValue(error);
         this.triggerUpdate();
       }
       return;
@@ -4383,20 +4412,19 @@ var SubscriptionScope = class _SubscriptionScope {
   getCurrentValue() {
     const rawValue = this.getCurrentRawValue();
     if (rawValue === CoValueLoadingState.UNAUTHORIZED || rawValue === CoValueLoadingState.UNAVAILABLE || rawValue === CoValueLoadingState.LOADING) {
+      this.logError();
       return this.getUnloadedValue(rawValue);
     }
     return rawValue;
   }
   getCurrentRawValue() {
     if (this.value.type === CoValueLoadingState.UNAUTHORIZED || this.value.type === CoValueLoadingState.UNAVAILABLE) {
-      console.error(this.value.toString());
       return this.value.type;
     }
     if (!this.shouldSendUpdates()) {
       return CoValueLoadingState.LOADING;
     }
     if (this.errorFromChildren) {
-      console.error(this.errorFromChildren.toString());
       return this.errorFromChildren.type;
     }
     if (this.value.type === CoValueLoadingState.LOADED) {
@@ -4404,6 +4432,49 @@ var SubscriptionScope = class _SubscriptionScope {
     }
     return CoValueLoadingState.LOADING;
   }
+  getCreationStackLines() {
+    const stack = this.callerStack?.stack;
+    if (!stack) {
+      return "";
+    }
+    const creationStackLines = stack.split("\n").slice(2, 15);
+    const creationAppFrame = creationStackLines.find(
+      (line) => !line.includes("node_modules") && !line.includes("useCoValueSubscription") && !line.includes("useCoState") && !line.includes("useAccount") && !line.includes("jazz-tools")
+    );
+    let result = "\n\n";
+    if (creationAppFrame) {
+      result += "Subscription created ", result += creationAppFrame.trim();
+    }
+    result += "\nFull subscription creation stack:";
+    for (const line of creationStackLines.slice(0, 8)) {
+      result += "\n    " + line.trim();
+    }
+    return result;
+  }
+  logError() {
+    let error;
+    if (this.value.type === CoValueLoadingState.UNAUTHORIZED || this.value.type === CoValueLoadingState.UNAVAILABLE) {
+      error = this.value;
+    }
+    if (this.errorFromChildren) {
+      error = this.errorFromChildren;
+    }
+    if (!error || this.lastErrorLogged === error) {
+      return;
+    }
+    if (error.type === CoValueLoadingState.UNAVAILABLE && this.skipRetry) {
+      return;
+    }
+    this.lastErrorLogged = error;
+    if (isCustomErrorReportingEnabled()) {
+      captureError(new Error(error.toString(), { cause: this.callerStack }), {
+        getPrettyStackTrace: () => this.getCreationStackLines(),
+        jazzError: error
+      });
+    } else {
+      console.error(`${error.toString()}${this.getCreationStackLines()}`);
+    }
+  }
   triggerUpdate() {
     if (!this.shouldSendUpdates()) return;
     if (!this.dirty) return;
@@ -4563,7 +4634,7 @@ var SubscriptionScope = class _SubscriptionScope {
                   new JazzError(void 0, CoValueLoadingState.UNAVAILABLE, [
                     {
                       code: "validationError",
-                      message: `The ref on position ${key} requested on ${stream.constructor.name} is missing`,
+                      message: `Jazz Validation Error: The ref on position ${key} is missing`,
                       params: {},
                       path: [key]
                     }
@@ -4615,7 +4686,7 @@ var SubscriptionScope = class _SubscriptionScope {
           new JazzError(void 0, CoValueLoadingState.UNAVAILABLE, [
             {
               code: "validationError",
-              message: `The ref ${key} requested on ${map.constructor.name} is missing`,
+              message: `Jazz Validation Error: The ref ${key} is required but missing`,
               params: {},
               path: [key]
             }
@@ -4646,7 +4717,7 @@ var SubscriptionScope = class _SubscriptionScope {
         new JazzError(void 0, CoValueLoadingState.UNAVAILABLE, [
           {
             code: "validationError",
-            message: `The ref on position ${key} requested on ${list.constructor.name} is missing`,
+            message: `Jazz Validation Error: The ref on position ${key} is required but missing`,
             params: {},
             path: [key]
           }
@@ -6749,13 +6820,9 @@ function subscribeToCoValue(cls, id, options, listener) {
     switch (value.$jazz.loadingState) {
       case CoValueLoadingState.UNAVAILABLE:
         options.onUnavailable?.(value);
-        if (!options.skipRetry) {
-          console.error(value.toString());
-        }
         break;
       case CoValueLoadingState.UNAUTHORIZED:
         options.onUnauthorized?.(value);
-        console.error(value.toString());
         break;
     }
   };
@@ -6898,17 +6965,14 @@ async function exportCoValue(cls, id, options) {
     options.unstable_branch
   );
   const value = await new Promise((resolve2) => {
-    rootNode.setListener((value2) => {
-      if (value2.type === CoValueLoadingState.UNAVAILABLE) {
+    rootNode.setListener(() => {
+      const value2 = rootNode.getCurrentValue();
+      if (value2.$isLoaded) {
+        resolve2(value2);
+      } else if (value2.$jazz.loadingState === CoValueLoadingState.UNAVAILABLE || value2.$jazz.loadingState === CoValueLoadingState.UNAUTHORIZED) {
         resolve2(null);
-        console.error(value2.toString());
-      } else if (value2.type === CoValueLoadingState.UNAUTHORIZED) {
-        resolve2(null);
-        console.error(value2.toString());
-      } else if (value2.type === CoValueLoadingState.LOADED) {
-        resolve2(value2.value);
+        rootNode.destroy();
       }
-      rootNode.destroy();
     });
   });
   if (!value) {
@@ -7046,6 +7110,9 @@ export {
   Encoders,
   coField,
   CoValueLoadingState,
+  enableCaptureErrorCause,
+  setCustomErrorReporter,
+  captureStack,
   SubscriptionScope,
   randomSessionProvider,
   createJazzContextFromExistingCredentials,
@@ -7062,4 +7129,4 @@ export {
   JazzContextManager
 };
 /* istanbul ignore file -- @preserve */
-//# sourceMappingURL=chunk-CUS6O5NE.js.map
+//# sourceMappingURL=chunk-2S3Z2CN6.js.map