@dynamic-labs/sdk-react-core 4.78.0 → 4.79.0

package/src/lib/utils/hooks/useVerifyWallet/useVerifyWallet.js

@@ -15,6 +15,7 @@ import { LAST_USED_WALLET } from '../../constants/localStorage.js';
 import '../../constants/colors.js';
 import '../../constants/values.js';
 import '@dynamic-labs/sdk-api-core';
+import { instrumentAuthLoginFailed } from '../../../shared/utils/functions/instrumentAuthLoginFailed/instrumentAuthLoginFailed.js';
 import '../../../shared/consts/index.js';
 import { setAuthMode, getAuthMode } from '../../../store/state/authMode/authMode.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
@@ -286,12 +287,15 @@ const useVerifyWallet = ({ displaySiweStatement, environmentId, projectSettings,
             handleDisconnectWallet({ walletConnector });
             clearStackAndPushInitialView();
         }
-        logger.error(e);
+        instrumentAuthLoginFailed(e, {
+            authOrigin: 'wallet-verify',
+            provider: walletConnector === null || walletConnector === void 0 ? void 0 : walletConnector.key,
+        });
         if (debugError) {
             setError(`${e.message}\n ${e.stack}`);
         }
         else {
-            setErrorMessage(e.code);
+            setErrorMessage(e.code, e, 'wallet-verify');
         }
     };
     return (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletConnector, getAddressOpts, publicWalletAddress, captchaToken, oauth, signedMessageOverride, messageToSignOverride, requestedScopes, }) {

package/src/lib/utils/hooks/useWalletBackup/googleDriveBackupErrors.cjs

@@ -0,0 +1,33 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Stable phrase the waas-sdk includes in Google Drive 401 / scope-insufficient
+ * upload failure messages (see dynamic-waas-sdk
+ * packages/browser/src/backup/providers/googleDrive.ts mapGoogleDriveUploadError).
+ *
+ * We match by `.includes(...)` rather than `.startsWith(...)` because the
+ * iframe message-handler fallback path
+ * (browser-wallet-client/src/services/iframeMessageHandler.ts:
+ * handleIframeMessageResponseError) rewraps the original error as
+ * `new Error(String(response.error))`, which prefixes the message with
+ * "Error: " and drops the original `isRetryable` field. The phrase remains
+ * unique to the auth/scope case across all reasons mapGoogleDriveUploadError
+ * produces (rate-limit, storage-full, 5xx, and network all use distinct
+ * prefixes), so message-only matching is sufficient to discriminate.
+ *
+ * TODO: switch to a stable `error.code` once dynamic-waas-sdk attaches one
+ * (see DYNT-754 follow-up).
+ */
+const ACCESS_DENIED_PHRASE = 'Google Drive access denied';
+/**
+ * Type-guard for Google Drive backup failures caused by missing/insufficient
+ * OAuth scopes (or otherwise denied access). Recover by re-prompting consent
+ * via `linkSocialAccount(ProviderEnum.Google, { forcePopup: true })` and
+ * retrying the backup.
+ */
+const isInsufficientGoogleDriveScopesError = (err) => err instanceof Error && err.message.includes(ACCESS_DENIED_PHRASE);
+
+exports.isInsufficientGoogleDriveScopesError = isInsufficientGoogleDriveScopesError;

package/src/lib/utils/hooks/useWalletBackup/googleDriveBackupErrors.d.ts

@@ -0,0 +1,8 @@
+export type GoogleDriveBackupAccessError = Error;
+/**
+ * Type-guard for Google Drive backup failures caused by missing/insufficient
+ * OAuth scopes (or otherwise denied access). Recover by re-prompting consent
+ * via `linkSocialAccount(ProviderEnum.Google, { forcePopup: true })` and
+ * retrying the backup.
+ */
+export declare const isInsufficientGoogleDriveScopesError: (err: unknown) => err is Error;

package/src/lib/utils/hooks/useWalletBackup/googleDriveBackupErrors.js

@@ -0,0 +1,29 @@
+'use client'
+/**
+ * Stable phrase the waas-sdk includes in Google Drive 401 / scope-insufficient
+ * upload failure messages (see dynamic-waas-sdk
+ * packages/browser/src/backup/providers/googleDrive.ts mapGoogleDriveUploadError).
+ *
+ * We match by `.includes(...)` rather than `.startsWith(...)` because the
+ * iframe message-handler fallback path
+ * (browser-wallet-client/src/services/iframeMessageHandler.ts:
+ * handleIframeMessageResponseError) rewraps the original error as
+ * `new Error(String(response.error))`, which prefixes the message with
+ * "Error: " and drops the original `isRetryable` field. The phrase remains
+ * unique to the auth/scope case across all reasons mapGoogleDriveUploadError
+ * produces (rate-limit, storage-full, 5xx, and network all use distinct
+ * prefixes), so message-only matching is sufficient to discriminate.
+ *
+ * TODO: switch to a stable `error.code` once dynamic-waas-sdk attaches one
+ * (see DYNT-754 follow-up).
+ */
+const ACCESS_DENIED_PHRASE = 'Google Drive access denied';
+/**
+ * Type-guard for Google Drive backup failures caused by missing/insufficient
+ * OAuth scopes (or otherwise denied access). Recover by re-prompting consent
+ * via `linkSocialAccount(ProviderEnum.Google, { forcePopup: true })` and
+ * retrying the backup.
+ */
+const isInsufficientGoogleDriveScopesError = (err) => err instanceof Error && err.message.includes(ACCESS_DENIED_PHRASE);
+
+export { isInsufficientGoogleDriveScopesError };

package/src/lib/utils/hooks/useWalletBackup/googleDriveScopes.cjs

@@ -0,0 +1,22 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * OAuth scopes that must be granted on the user's Google account in order
+ * for the keyshare backup upload to Google Drive to succeed.
+ *
+ * Exported so host apps can pre-flight check / display these in their own
+ * UX if they want to. Kept as a `readonly` tuple to discourage mutation.
+ */
+const GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES = [
+    'https://www.googleapis.com/auth/drive.appdata',
+    'https://www.googleapis.com/auth/drive.file',
+];
+const findMissingGoogleDriveBackupScopes = (grantedScopes) => GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES.filter((required) => !grantedScopes.includes(required));
+const hasAllGoogleDriveBackupScopes = (grantedScopes) => findMissingGoogleDriveBackupScopes(grantedScopes).length === 0;
+
+exports.GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES = GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES;
+exports.findMissingGoogleDriveBackupScopes = findMissingGoogleDriveBackupScopes;
+exports.hasAllGoogleDriveBackupScopes = hasAllGoogleDriveBackupScopes;

package/src/lib/utils/hooks/useWalletBackup/googleDriveScopes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OAuth scopes that must be granted on the user's Google account in order
+ * for the keyshare backup upload to Google Drive to succeed.
+ *
+ * Exported so host apps can pre-flight check / display these in their own
+ * UX if they want to. Kept as a `readonly` tuple to discourage mutation.
+ */
+export declare const GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES: readonly ["https://www.googleapis.com/auth/drive.appdata", "https://www.googleapis.com/auth/drive.file"];
+export declare const findMissingGoogleDriveBackupScopes: (grantedScopes: readonly string[]) => string[];
+export declare const hasAllGoogleDriveBackupScopes: (grantedScopes: readonly string[]) => boolean;

package/src/lib/utils/hooks/useWalletBackup/googleDriveScopes.js

@@ -0,0 +1,16 @@
+'use client'
+/**
+ * OAuth scopes that must be granted on the user's Google account in order
+ * for the keyshare backup upload to Google Drive to succeed.
+ *
+ * Exported so host apps can pre-flight check / display these in their own
+ * UX if they want to. Kept as a `readonly` tuple to discourage mutation.
+ */
+const GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES = [
+    'https://www.googleapis.com/auth/drive.appdata',
+    'https://www.googleapis.com/auth/drive.file',
+];
+const findMissingGoogleDriveBackupScopes = (grantedScopes) => GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES.filter((required) => !grantedScopes.includes(required));
+const hasAllGoogleDriveBackupScopes = (grantedScopes) => findMissingGoogleDriveBackupScopes(grantedScopes).length === 0;
+
+export { GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, findMissingGoogleDriveBackupScopes, hasAllGoogleDriveBackupScopes };

package/src/lib/utils/hooks/useWalletBackup/index.d.ts

@@ -1,2 +1,4 @@
 export { useWalletBackup, useBackupWallets, useDownloadKeyShares, isWalletBackedUp, type WalletToBackup, type WalletWithBackupStatus, type WalletBackupStatus, type WalletOperationState, } from './useWalletBackup';
 export { CloudBackupProvider } from './types';
+export { GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, findMissingGoogleDriveBackupScopes, hasAllGoogleDriveBackupScopes, } from './googleDriveScopes';
+export { isInsufficientGoogleDriveScopesError, type GoogleDriveBackupAccessError, } from './googleDriveBackupErrors';

package/src/lib/utils/hooks/useWalletBackup/useWalletBackup.cjs

@@ -148,6 +148,8 @@ const useWalletBackup = () => {
         isProcessing: false,
         totalWallets: 0,
     });
+    const [lastBackupError, setLastBackupError] = React.useState(undefined);
+    const clearBackupError = React.useCallback(() => setLastBackupError(undefined), []);
     const timeoutRef = React.useRef(null);
     React.useEffect(() => () => {
         if (timeoutRef.current) {
@@ -234,6 +236,7 @@ const useWalletBackup = () => {
         }
     }), [getWaasWalletConnector]);
     const backupWallet = React.useCallback((walletToBackup_1, ...args_1) => _tslib.__awaiter(void 0, [walletToBackup_1, ...args_1], void 0, function* (walletToBackup, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
+        setLastBackupError(undefined);
         try {
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
             if (!waasConnector) {
@@ -259,6 +262,7 @@ const useWalletBackup = () => {
                 address: walletToBackup.address,
                 error,
             });
+            setLastBackupError(error);
             return false;
         }
     }), [getWaasWalletConnector]);
@@ -319,6 +323,7 @@ const useWalletBackup = () => {
         return true;
     }, [isGoogleLinked]);
     const backupToCloudProvider = React.useCallback((options, walletToBackup) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        setLastBackupError(undefined);
         try {
             const { provider, password } = options;
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
@@ -344,6 +349,7 @@ const useWalletBackup = () => {
         }
         catch (error) {
             logger.logger.warn('Error backing up to cloud provider', { error, options });
+            setLastBackupError(error);
             return false;
         }
     }), [getWaasWalletConnector]);
@@ -355,6 +361,7 @@ const useWalletBackup = () => {
         backupToCloudProvider,
         backupWallet,
         checkICloudAuth,
+        clearBackupError,
         ensureGoogleLinked,
         ensureProviderLinked,
         getSupportedProviders,
@@ -364,6 +371,7 @@ const useWalletBackup = () => {
         initBackupProcess,
         isGoogleLinked,
         isProviderLinked,
+        lastBackupError,
         showICloudAuth,
         startBackup,
     };

package/src/lib/utils/hooks/useWalletBackup/useWalletBackup.d.ts

@@ -24,6 +24,7 @@ export declare const useWalletBackup: () => {
     readonly backupToCloudProvider: (options: CloudProviderBackupOptions, walletToBackup: WalletToBackup) => Promise<boolean>;
     readonly backupWallet: (walletToBackup: WalletToBackup, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<boolean>;
     readonly checkICloudAuth: (walletChain: ChainEnum) => Promise<boolean>;
+    readonly clearBackupError: () => void;
     readonly ensureGoogleLinked: () => Promise<boolean>;
     readonly ensureProviderLinked: (provider: CloudBackupProvider) => Promise<boolean>;
     readonly getSupportedProviders: () => import("./cloudProviders").CloudProviderConfigWithIcon[];
@@ -33,6 +34,7 @@ export declare const useWalletBackup: () => {
     readonly initBackupProcess: () => void;
     readonly isGoogleLinked: boolean;
     readonly isProviderLinked: (provider: CloudBackupProvider) => boolean;
+    readonly lastBackupError: unknown;
     readonly showICloudAuth: (displayContainer: HTMLElement, walletChain: ChainEnum) => Promise<boolean>;
     readonly startBackup: (onComplete?: () => void, fromIndex?: number, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<void>;
 };

package/src/lib/utils/hooks/useWalletBackup/useWalletBackup.js

@@ -1,6 +1,6 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
-import { useMemo, useState, useRef, useEffect, useCallback } from 'react';
+import { useMemo, useState, useCallback, useRef, useEffect } from 'react';
 import { WaasBackupOptionsEnum, ProviderEnum } from '@dynamic-labs/sdk-api-core';
 import '@dynamic-labs-sdk/client/core';
 import 'eventemitter3';
@@ -144,6 +144,8 @@ const useWalletBackup = () => {
         isProcessing: false,
         totalWallets: 0,
     });
+    const [lastBackupError, setLastBackupError] = useState(undefined);
+    const clearBackupError = useCallback(() => setLastBackupError(undefined), []);
     const timeoutRef = useRef(null);
     useEffect(() => () => {
         if (timeoutRef.current) {
@@ -230,6 +232,7 @@ const useWalletBackup = () => {
         }
     }), [getWaasWalletConnector]);
     const backupWallet = useCallback((walletToBackup_1, ...args_1) => __awaiter(void 0, [walletToBackup_1, ...args_1], void 0, function* (walletToBackup, provider = CloudBackupProvider.GoogleDrive, displayContainer) {
+        setLastBackupError(undefined);
         try {
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
             if (!waasConnector) {
@@ -255,6 +258,7 @@ const useWalletBackup = () => {
                 address: walletToBackup.address,
                 error,
             });
+            setLastBackupError(error);
             return false;
         }
     }), [getWaasWalletConnector]);
@@ -315,6 +319,7 @@ const useWalletBackup = () => {
         return true;
     }, [isGoogleLinked]);
     const backupToCloudProvider = useCallback((options, walletToBackup) => __awaiter(void 0, void 0, void 0, function* () {
+        setLastBackupError(undefined);
         try {
             const { provider, password } = options;
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
@@ -340,6 +345,7 @@ const useWalletBackup = () => {
         }
         catch (error) {
             logger.warn('Error backing up to cloud provider', { error, options });
+            setLastBackupError(error);
             return false;
         }
     }), [getWaasWalletConnector]);
@@ -351,6 +357,7 @@ const useWalletBackup = () => {
         backupToCloudProvider,
         backupWallet,
         checkICloudAuth,
+        clearBackupError,
         ensureGoogleLinked,
         ensureProviderLinked,
         getSupportedProviders: getSupportedProviders$1,
@@ -360,6 +367,7 @@ const useWalletBackup = () => {
         initBackupProcess,
         isGoogleLinked,
         isProviderLinked,
+        lastBackupError,
         showICloudAuth,
         startBackup,
     };

package/src/lib/utils/hooks/useWalletItemActions/useHandleWalletItem/useHandleWalletItem.cjs

@@ -283,7 +283,7 @@ const useHandleWalletItem = ({ allowAlreadyConnectedWallet, onQrCodeConnect, onC
             }
             catch (error) {
                 if (error instanceof utils.UserRejectedRequestError) {
-                    setErrorMessage('connection_rejected');
+                    setErrorMessage('connection_rejected', undefined, 'wallet-account-select');
                     clearStackAndPushInitialView();
                     return;
                 }

package/src/lib/utils/hooks/useWalletItemActions/useHandleWalletItem/useHandleWalletItem.js

@@ -279,7 +279,7 @@ const useHandleWalletItem = ({ allowAlreadyConnectedWallet, onQrCodeConnect, onC
             }
             catch (error) {
                 if (error instanceof UserRejectedRequestError) {
-                    setErrorMessage('connection_rejected');
+                    setErrorMessage('connection_rejected', undefined, 'wallet-account-select');
                     clearStackAndPushInitialView();
                     return;
                 }

package/src/lib/views/EmailVerification/EmailVerification.cjs

@@ -22,6 +22,7 @@ var logger = require('../../shared/logger.cjs');
 require('@dynamic-labs/wallet-book');
 require('../../utils/constants/colors.cjs');
 require('../../utils/constants/values.cjs');
+var instrumentAuthLoginFailed = require('../../shared/utils/functions/instrumentAuthLoginFailed/instrumentAuthLoginFailed.cjs');
 require('../../shared/consts/index.cjs');
 var findEmbeddedWalletFromVerifiedCredentials = require('../../utils/functions/findEmbeddedWalletFromVerifiedCredentials/findEmbeddedWalletFromVerifiedCredentials.cjs');
 require('@dynamic-labs/multi-wallet');
@@ -352,7 +353,8 @@ const EmailVerification = ({ isEmailRecoveryFlow = false, showRetryButton: _show
         }
         catch (error) {
             logger.logger.debug(error);
-            setErrorMessage(error.code);
+            instrumentAuthLoginFailed.instrumentAuthLoginFailed(error, { authOrigin: 'email-verification' });
+            setErrorMessage(error.code, error, 'email-verification');
             if (error.code === 'too_many_email_verification_attempts') {
                 setShowRetryButton(false);
             }

package/src/lib/views/EmailVerification/EmailVerification.js

@@ -18,6 +18,7 @@ import { logger } from '../../shared/logger.js';
 import '@dynamic-labs/wallet-book';
 import '../../utils/constants/colors.js';
 import '../../utils/constants/values.js';
+import { instrumentAuthLoginFailed } from '../../shared/utils/functions/instrumentAuthLoginFailed/instrumentAuthLoginFailed.js';
 import '../../shared/consts/index.js';
 import { findEmbeddedWalletFromVerifiedCredentials } from '../../utils/functions/findEmbeddedWalletFromVerifiedCredentials/findEmbeddedWalletFromVerifiedCredentials.js';
 import '@dynamic-labs/multi-wallet';
@@ -348,7 +349,8 @@ const EmailVerification = ({ isEmailRecoveryFlow = false, showRetryButton: _show
         }
         catch (error) {
             logger.debug(error);
-            setErrorMessage(error.code);
+            instrumentAuthLoginFailed(error, { authOrigin: 'email-verification' });
+            setErrorMessage(error.code, error, 'email-verification');
             if (error.code === 'too_many_email_verification_attempts') {
                 setShowRetryButton(false);
             }