@dynamic-labs/sdk-react-core 4.86.0 → 4.87.0

package/CHANGELOG.md

@@ -1,4 +1,16 @@
 
+## [4.87.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.86.0...v4.87.0) (2026-06-02)
+
+
+### Features
+
+* **sdk-react-core:** instrument logout reason for Datadog observability DYNT-870 ([#11429](https://github.com/dynamic-labs/dynamic-auth/issues/11429)) ([8f9b3f3](https://github.com/dynamic-labs/dynamic-auth/commit/8f9b3f364dc711414ae59642c36f5f0a4cc4576a))
+
+
+### Bug Fixes
+
+* **sdk-react-core:** only flag auto-wallet abandoned on a sustained exit, not transient webview hide DYNT-870 ([#11428](https://github.com/dynamic-labs/dynamic-auth/issues/11428)) ([5984cdd](https://github.com/dynamic-labs/dynamic-auth/commit/5984cddb4ac04b226f6dd6ebe44340186902b012))
+
 ## [4.86.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.85.0...v4.86.0) (2026-06-01)
 
 

package/package.cjs

@@ -3,11 +3,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.86.0";
+var version = "4.87.0";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.985",
 	"@dynamic-labs-sdk/client": "1.1.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "1.0.7",
+	"@dynamic-labs-wallet/browser-wallet-client": "1.0.13",
 	"@dynamic-labs-wallet/forward-mpc-client": "0.10.1",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",

package/package.js

@@ -1,9 +1,9 @@
 'use client'
-var version = "4.86.0";
+var version = "4.87.0";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.985",
 	"@dynamic-labs-sdk/client": "1.1.0",
-	"@dynamic-labs-wallet/browser-wallet-client": "1.0.7",
+	"@dynamic-labs-wallet/browser-wallet-client": "1.0.13",
 	"@dynamic-labs-wallet/forward-mpc-client": "0.10.1",
 	"@hcaptcha/react-hcaptcha": "1.4.4",
 	"@thumbmarkjs/thumbmarkjs": "0.16.0",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dynamic-labs/sdk-react-core",
-  "version": "4.86.0",
+  "version": "4.87.0",
   "dependencies": {
     "@dynamic-labs/sdk-api-core": "0.0.985",
     "@dynamic-labs-sdk/client": "1.1.0",
-    "@dynamic-labs-wallet/browser-wallet-client": "1.0.7",
+    "@dynamic-labs-wallet/browser-wallet-client": "1.0.13",
     "@dynamic-labs-wallet/forward-mpc-client": "0.10.1",
     "@hcaptcha/react-hcaptcha": "1.4.4",
     "@thumbmarkjs/thumbmarkjs": "0.16.0",
@@ -17,17 +17,17 @@
     "yup": "0.32.11",
     "react-international-phone": "4.5.0",
     "bs58": "5.0.0",
-    "@dynamic-labs/assert-package-version": "4.86.0",
-    "@dynamic-labs/iconic": "4.86.0",
-    "@dynamic-labs/locale": "4.86.0",
-    "@dynamic-labs/logger": "4.86.0",
-    "@dynamic-labs/multi-wallet": "4.86.0",
-    "@dynamic-labs/rpc-providers": "4.86.0",
-    "@dynamic-labs/store": "4.86.0",
-    "@dynamic-labs/types": "4.86.0",
-    "@dynamic-labs/utils": "4.86.0",
-    "@dynamic-labs/wallet-book": "4.86.0",
-    "@dynamic-labs/wallet-connector-core": "4.86.0",
+    "@dynamic-labs/assert-package-version": "4.87.0",
+    "@dynamic-labs/iconic": "4.87.0",
+    "@dynamic-labs/locale": "4.87.0",
+    "@dynamic-labs/logger": "4.87.0",
+    "@dynamic-labs/multi-wallet": "4.87.0",
+    "@dynamic-labs/rpc-providers": "4.87.0",
+    "@dynamic-labs/store": "4.87.0",
+    "@dynamic-labs/types": "4.87.0",
+    "@dynamic-labs/utils": "4.87.0",
+    "@dynamic-labs/wallet-book": "4.87.0",
+    "@dynamic-labs/wallet-connector-core": "4.87.0",
     "eventemitter3": "5.0.1"
   },
   "devDependencies": {

package/src/lib/context/DynamicContext/hooks/useHandleLogout/useHandleLogout.cjs

@@ -132,6 +132,20 @@ const useHandleLogout = (params) => {
             reason,
         });
         utils.tracing.logEvent('logout', `useHandleLogout called (reason=${reason})`);
+        // Surface the logout reason to Datadog. Every internal logout path funnels
+        // through here, but the reason was only sent to tracing/verbose — never the
+        // HTTP log transport — so logout causes were invisible in DD (e.g. an
+        // auto-logout firing mid-ceremony that revokes the session and abandons
+        // wallet creation). @environmentId is attached by the transport from its
+        // post URL; pair with @key:sdk_logout to see the reason breakdown per env.
+        logger.logger.instrument('SDK logout', {
+            key: 'sdk_logout',
+            reason: reason !== null && reason !== void 0 ? reason : 'unspecified',
+            time: 0,
+        });
+        // The trace buffer is otherwise never sent — flush the logout + session-key
+        // context so a logout that aborts wallet creation is diagnosable in DD.
+        utils.tracing.flush((packed) => logger.logger.instrument(packed), ['logout', 'session-key']);
         p.setSelectedWalletConnectorKey(null);
         p.clearAllWalletConnectSessions();
         p.setShowDynamicUserProfile(false);

package/src/lib/context/DynamicContext/hooks/useHandleLogout/useHandleLogout.js

@@ -128,6 +128,20 @@ const useHandleLogout = (params) => {
             reason,
         });
         tracing.logEvent('logout', `useHandleLogout called (reason=${reason})`);
+        // Surface the logout reason to Datadog. Every internal logout path funnels
+        // through here, but the reason was only sent to tracing/verbose — never the
+        // HTTP log transport — so logout causes were invisible in DD (e.g. an
+        // auto-logout firing mid-ceremony that revokes the session and abandons
+        // wallet creation). @environmentId is attached by the transport from its
+        // post URL; pair with @key:sdk_logout to see the reason breakdown per env.
+        logger.instrument('SDK logout', {
+            key: 'sdk_logout',
+            reason: reason !== null && reason !== void 0 ? reason : 'unspecified',
+            time: 0,
+        });
+        // The trace buffer is otherwise never sent — flush the logout + session-key
+        // context so a logout that aborts wallet creation is diagnosable in DD.
+        tracing.flush((packed) => logger.instrument(packed), ['logout', 'session-key']);
         p.setSelectedWalletConnectorKey(null);
         p.clearAllWalletConnectSessions();
         p.setShowDynamicUserProfile(false);

package/src/lib/utils/hooks/useSyncDynamicWaas/instrumentWalletCreation.cjs

@@ -23,6 +23,15 @@ require('../../../shared/consts/index.cjs');
  * fire here means the flow genuinely stalled rather than just being slow.
  */
 const AUTO_WALLET_CREATION_TIMEOUT_MS = 30000;
+/**
+ * A page must stay hidden this long before we count the ceremony as abandoned.
+ * Android webviews and bfcache navigations fire `pagehide`/`visibilitychange`
+ * transiently — frequently ~1s into the flow — and webviews pause JS timers
+ * while backgrounded. Requiring a *sustained* hide (and ignoring reversible
+ * bfcache `pagehide`) stops a user who never actually left from being logged as
+ * abandoned (DYNT-870 follow-up).
+ */
+const ABANDON_CONFIRM_MS = 5000;
 /**
  * Wraps the auto-wallet-creation ceremony so that "silent" failures carry a
  * reason. Without this, a ceremony that hangs (promise never settles) or a user
@@ -31,30 +40,67 @@ const AUTO_WALLET_CREATION_TIMEOUT_MS = 30000;
  *
  * Emits:
  * - `auto_wallet_creation_timeout` if `run` has not settled within `timeoutMs`.
- * - `auto_wallet_creation_abandoned` if the page is hidden while `run` is still
- *   in flight (relies on the logger's keepalive transport to survive unload).
+ * - `auto_wallet_creation_abandoned` if the user genuinely leaves while `run` is
+ *   still in flight — either a terminal unload (`pagehide`, non-bfcache) or a
+ *   hide that stays hidden for `ABANDON_CONFIRM_MS`. Transient hides (tab
+ *   switch, OS pause, the ~1s webview flicker) are ignored. Relies on the
+ *   logger's keepalive transport to survive unload.
  *
  * The watchdog is observational: it never aborts `run`, and its return value /
  * rejection is passed through unchanged.
  */
 const instrumentWalletCreation = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ run, logData, timeoutMs = AUTO_WALLET_CREATION_TIMEOUT_MS, }) {
-    var _b, _c;
+    var _b, _c, _d, _e;
     const startTime = Date.now();
+    const doc = globalThis.document;
     const timeoutId = setTimeout(() => {
         logger.logger.instrument('Auto wallet creation timed out', Object.assign(Object.assign({}, logData), { key: 'auto_wallet_creation_timeout', reason: 'timeout', time: Date.now() - startTime }));
     }, timeoutMs);
-    const handlePageHide = () => {
-        logger.logger.instrument('Auto wallet creation abandoned', Object.assign(Object.assign({}, logData), { key: 'auto_wallet_creation_abandoned', reason: 'page_hidden', time: Date.now() - startTime }));
+    let abandonReported = false;
+    let hiddenTimer = null;
+    const reportAbandoned = (reason) => {
+        if (abandonReported) {
+            return;
+        }
+        abandonReported = true;
+        logger.logger.instrument('Auto wallet creation abandoned', Object.assign(Object.assign({}, logData), { key: 'auto_wallet_creation_abandoned', reason, time: Date.now() - startTime }));
+    };
+    // A terminal unload (not a reversible bfcache freeze) is a genuine exit:
+    // report immediately and let the logger's keepalive transport flush it.
+    const handlePageHide = (event) => {
+        if (event.persisted) {
+            return;
+        }
+        reportAbandoned('page_hidden');
+    };
+    // Transient backgrounding (tab switch, OS pause, the ~1s webview flicker)
+    // fires `hidden` then `visible` again; only a hide that *stays* hidden counts.
+    // If the webview pauses JS while hidden, the timer simply never fires — which
+    // is the desired outcome (the user did not actually abandon).
+    const handleVisibilityChange = () => {
+        if ((doc === null || doc === void 0 ? void 0 : doc.visibilityState) === 'hidden') {
+            hiddenTimer = setTimeout(() => reportAbandoned('backgrounded'), ABANDON_CONFIRM_MS);
+        }
+        else if (hiddenTimer) {
+            clearTimeout(hiddenTimer);
+            hiddenTimer = null;
+        }
     };
     (_b = globalThis.addEventListener) === null || _b === void 0 ? void 0 : _b.call(globalThis, 'pagehide', handlePageHide);
+    (_c = doc === null || doc === void 0 ? void 0 : doc.addEventListener) === null || _c === void 0 ? void 0 : _c.call(doc, 'visibilitychange', handleVisibilityChange);
     try {
         return yield run();
     }
     finally {
         clearTimeout(timeoutId);
-        (_c = globalThis.removeEventListener) === null || _c === void 0 ? void 0 : _c.call(globalThis, 'pagehide', handlePageHide);
+        if (hiddenTimer) {
+            clearTimeout(hiddenTimer);
+        }
+        (_d = globalThis.removeEventListener) === null || _d === void 0 ? void 0 : _d.call(globalThis, 'pagehide', handlePageHide);
+        (_e = doc === null || doc === void 0 ? void 0 : doc.removeEventListener) === null || _e === void 0 ? void 0 : _e.call(doc, 'visibilitychange', handleVisibilityChange);
     }
 });
 
+exports.ABANDON_CONFIRM_MS = ABANDON_CONFIRM_MS;
 exports.AUTO_WALLET_CREATION_TIMEOUT_MS = AUTO_WALLET_CREATION_TIMEOUT_MS;
 exports.instrumentWalletCreation = instrumentWalletCreation;

package/src/lib/utils/hooks/useSyncDynamicWaas/instrumentWalletCreation.d.ts

@@ -4,6 +4,15 @@
  * fire here means the flow genuinely stalled rather than just being slow.
  */
 export declare const AUTO_WALLET_CREATION_TIMEOUT_MS = 30000;
+/**
+ * A page must stay hidden this long before we count the ceremony as abandoned.
+ * Android webviews and bfcache navigations fire `pagehide`/`visibilitychange`
+ * transiently — frequently ~1s into the flow — and webviews pause JS timers
+ * while backgrounded. Requiring a *sustained* hide (and ignoring reversible
+ * bfcache `pagehide`) stops a user who never actually left from being logged as
+ * abandoned (DYNT-870 follow-up).
+ */
+export declare const ABANDON_CONFIRM_MS = 5000;
 type InstrumentWalletCreationArgs<T> = {
     /** The wallet-creation work to run and observe (the MPC ceremony). */
     run: () => Promise<T>;
@@ -19,8 +28,11 @@ type InstrumentWalletCreationArgs<T> = {
  *
  * Emits:
  * - `auto_wallet_creation_timeout` if `run` has not settled within `timeoutMs`.
- * - `auto_wallet_creation_abandoned` if the page is hidden while `run` is still
- *   in flight (relies on the logger's keepalive transport to survive unload).
+ * - `auto_wallet_creation_abandoned` if the user genuinely leaves while `run` is
+ *   still in flight — either a terminal unload (`pagehide`, non-bfcache) or a
+ *   hide that stays hidden for `ABANDON_CONFIRM_MS`. Transient hides (tab
+ *   switch, OS pause, the ~1s webview flicker) are ignored. Relies on the
+ *   logger's keepalive transport to survive unload.
  *
  * The watchdog is observational: it never aborts `run`, and its return value /
  * rejection is passed through unchanged.

package/src/lib/utils/hooks/useSyncDynamicWaas/instrumentWalletCreation.js

@@ -19,6 +19,15 @@ import '../../../shared/consts/index.js';
  * fire here means the flow genuinely stalled rather than just being slow.
  */
 const AUTO_WALLET_CREATION_TIMEOUT_MS = 30000;
+/**
+ * A page must stay hidden this long before we count the ceremony as abandoned.
+ * Android webviews and bfcache navigations fire `pagehide`/`visibilitychange`
+ * transiently — frequently ~1s into the flow — and webviews pause JS timers
+ * while backgrounded. Requiring a *sustained* hide (and ignoring reversible
+ * bfcache `pagehide`) stops a user who never actually left from being logged as
+ * abandoned (DYNT-870 follow-up).
+ */
+const ABANDON_CONFIRM_MS = 5000;
 /**
  * Wraps the auto-wallet-creation ceremony so that "silent" failures carry a
  * reason. Without this, a ceremony that hangs (promise never settles) or a user
@@ -27,29 +36,65 @@ const AUTO_WALLET_CREATION_TIMEOUT_MS = 30000;
  *
  * Emits:
  * - `auto_wallet_creation_timeout` if `run` has not settled within `timeoutMs`.
- * - `auto_wallet_creation_abandoned` if the page is hidden while `run` is still
- *   in flight (relies on the logger's keepalive transport to survive unload).
+ * - `auto_wallet_creation_abandoned` if the user genuinely leaves while `run` is
+ *   still in flight — either a terminal unload (`pagehide`, non-bfcache) or a
+ *   hide that stays hidden for `ABANDON_CONFIRM_MS`. Transient hides (tab
+ *   switch, OS pause, the ~1s webview flicker) are ignored. Relies on the
+ *   logger's keepalive transport to survive unload.
  *
  * The watchdog is observational: it never aborts `run`, and its return value /
  * rejection is passed through unchanged.
  */
 const instrumentWalletCreation = (_a) => __awaiter(void 0, [_a], void 0, function* ({ run, logData, timeoutMs = AUTO_WALLET_CREATION_TIMEOUT_MS, }) {
-    var _b, _c;
+    var _b, _c, _d, _e;
     const startTime = Date.now();
+    const doc = globalThis.document;
     const timeoutId = setTimeout(() => {
         logger.instrument('Auto wallet creation timed out', Object.assign(Object.assign({}, logData), { key: 'auto_wallet_creation_timeout', reason: 'timeout', time: Date.now() - startTime }));
     }, timeoutMs);
-    const handlePageHide = () => {
-        logger.instrument('Auto wallet creation abandoned', Object.assign(Object.assign({}, logData), { key: 'auto_wallet_creation_abandoned', reason: 'page_hidden', time: Date.now() - startTime }));
+    let abandonReported = false;
+    let hiddenTimer = null;
+    const reportAbandoned = (reason) => {
+        if (abandonReported) {
+            return;
+        }
+        abandonReported = true;
+        logger.instrument('Auto wallet creation abandoned', Object.assign(Object.assign({}, logData), { key: 'auto_wallet_creation_abandoned', reason, time: Date.now() - startTime }));
+    };
+    // A terminal unload (not a reversible bfcache freeze) is a genuine exit:
+    // report immediately and let the logger's keepalive transport flush it.
+    const handlePageHide = (event) => {
+        if (event.persisted) {
+            return;
+        }
+        reportAbandoned('page_hidden');
+    };
+    // Transient backgrounding (tab switch, OS pause, the ~1s webview flicker)
+    // fires `hidden` then `visible` again; only a hide that *stays* hidden counts.
+    // If the webview pauses JS while hidden, the timer simply never fires — which
+    // is the desired outcome (the user did not actually abandon).
+    const handleVisibilityChange = () => {
+        if ((doc === null || doc === void 0 ? void 0 : doc.visibilityState) === 'hidden') {
+            hiddenTimer = setTimeout(() => reportAbandoned('backgrounded'), ABANDON_CONFIRM_MS);
+        }
+        else if (hiddenTimer) {
+            clearTimeout(hiddenTimer);
+            hiddenTimer = null;
+        }
     };
     (_b = globalThis.addEventListener) === null || _b === void 0 ? void 0 : _b.call(globalThis, 'pagehide', handlePageHide);
+    (_c = doc === null || doc === void 0 ? void 0 : doc.addEventListener) === null || _c === void 0 ? void 0 : _c.call(doc, 'visibilitychange', handleVisibilityChange);
     try {
         return yield run();
     }
     finally {
         clearTimeout(timeoutId);
-        (_c = globalThis.removeEventListener) === null || _c === void 0 ? void 0 : _c.call(globalThis, 'pagehide', handlePageHide);
+        if (hiddenTimer) {
+            clearTimeout(hiddenTimer);
+        }
+        (_d = globalThis.removeEventListener) === null || _d === void 0 ? void 0 : _d.call(globalThis, 'pagehide', handlePageHide);
+        (_e = doc === null || doc === void 0 ? void 0 : doc.removeEventListener) === null || _e === void 0 ? void 0 : _e.call(doc, 'visibilitychange', handleVisibilityChange);
     }
 });
 
-export { AUTO_WALLET_CREATION_TIMEOUT_MS, instrumentWalletCreation };
+export { ABANDON_CONFIRM_MS, AUTO_WALLET_CREATION_TIMEOUT_MS, instrumentWalletCreation };