@dynamic-labs/sdk-react-core 4.83.0 → 4.83.2-alpha.0

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

@@ -32,88 +32,14 @@ require('../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
 require('../../../events/dynamicEvents.cjs');
 var useUser = require('../../../client/extension/user/useUser/useUser.cjs');
 var useProjectSettings = require('../../../client/extension/projectSettings/useProjectSettings/useProjectSettings.cjs');
-require('../../../context/DynamicContext/DynamicContext.cjs');
-require('../../../store/state/loadingAndLifecycle/loadingAndLifecycle.cjs');
-require('../../../context/CaptchaContext/CaptchaContext.cjs');
-require('../../../context/ErrorContext/ErrorContext.cjs');
-require('../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
-require('../../../context/AccountExistsContext/AccountExistsContext.cjs');
-require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
-require('../../../store/state/authMode/authMode.cjs');
-require('../../../context/VerificationContext/VerificationContext.cjs');
-require('react-dom');
-require('../../functions/compareChains/compareChains.cjs');
-require('../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.cjs');
-require('../../../context/ThemeContext/ThemeContext.cjs');
-require('../useUserUpdateRequest/useUpdateUser/userFieldsSchema.cjs');
-require('bs58');
-var useSocialAccounts = require('../useSocialAccounts/useSocialAccounts.cjs');
-require('yup');
-require('../../../context/MockContext/MockContext.cjs');
-require('../../../views/CollectUserDataView/useFields.cjs');
-require('../../../context/FieldsStateContext/FieldsStateContext.cjs');
-require('../../../context/UserFieldEditorContext/UserFieldEditorContext.cjs');
-require('@dynamic-labs/rpc-providers');
-require('../../../store/state/walletOptions/walletOptions.cjs');
-require('react-i18next');
-require('../../../components/Accordion/components/AccordionItem/AccordionItem.cjs');
-require('../../../components/Alert/Alert.cjs');
-require('../../../context/WalletContext/WalletContext.cjs');
-require('../../../components/ShadowDOM/ShadowDOM.cjs');
-require('../../../components/IconButton/IconButton.cjs');
-require('../../../components/InlineWidget/InlineWidget.cjs');
-require('../../../components/Input/Input.cjs');
-require('../../../components/IsBrowser/IsBrowser.cjs');
-require('../../../components/MenuList/Dropdown/Dropdown.cjs');
-require('../../../components/OverlayCard/OverlayCard.cjs');
-require('../../../components/Transition/ZoomTransition/ZoomTransition.cjs');
-require('../../../components/Transition/SlideInUpTransition/SlideInUpTransition.cjs');
-require('../../../components/Transition/OpacityTransition/OpacityTransition.cjs');
-require('../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.cjs');
-require('../../../components/Popper/Popper/Popper.cjs');
-require('../../../components/Popper/PopperContext/PopperContext.cjs');
-require('react-focus-lock');
-require('qrcode');
-require('formik');
-require('../useSubdomainCheck/useSubdomainCheck.cjs');
-require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
-require('../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
+require('../../../context/DynamicContext/useDynamicContext/useDynamicContext.cjs');
+var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
 var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
 var useRefreshAuth = require('../useRefreshAuth/useRefreshAuth.cjs');
-var types = require('./types.cjs');
+var useSocialAccounts = require('../useSocialAccounts/useSocialAccounts.cjs');
+var BackupError = require('./BackupError.cjs');
 var cloudProviders = require('./cloudProviders.cjs');
-require('@dynamic-labs/types');
-require('../../../context/LoadingContext/LoadingContext.cjs');
-require('../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
-require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
-require('../../../context/SocialRedirectContext/SocialRedirectContext.cjs');
-require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
-require('../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
-require('@hcaptcha/react-hcaptcha');
-require('../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.cjs');
-require('../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.cjs');
-require('../../../context/ErrorContext/hooks/useErrorText/useErrorText.cjs');
-require('../../../context/FooterAnimationContext/index.cjs');
-require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
-require('../../../context/PasskeyContext/PasskeyContext.cjs');
-require('../../../context/OnrampContext/OnrampContext.cjs');
-require('../../../store/state/sendBalances.cjs');
-require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
-require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
-require('../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.cjs');
-require('../../../views/TransactionConfirmationView/TransactionConfirmationView.cjs');
-require('../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.cjs');
-require('../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.cjs');
-require('../../../../index.cjs');
-require('../../../widgets/DynamicWidget/views/ManagePasskeysMfaWidgetView/ManagePasskeysMfaWidgetView.cjs');
-require('../../../widgets/DynamicWidget/views/ManageTotpMfaWidgetView/ManageTotpMfaWidgetView.cjs');
-require('../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.cjs');
-require('../useGetMfaToken/useGetMfaToken.cjs');
-require('../../../store/state/tokenBalances.cjs');
-require('../../../store/state/multichainBalances.cjs');
-require('@dynamic-labs/store');
-require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
-var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
+var types = require('./types.cjs');
 
 const CLOUD_BACKUP_LOCATIONS = [
     sdkApiCore.WaasBackupOptionsEnum.GoogleDrive,
@@ -129,8 +55,9 @@ const isWalletBackedUp = (cred) => {
         'backupLocation' in keyShare &&
         CLOUD_BACKUP_LOCATIONS.includes(keyShare.backupLocation));
 };
-const useWalletBackup = () => {
-    var _a, _b;
+const useWalletBackup = (options) => {
+    var _a, _b, _c;
+    const throwOnError = (_a = options === null || options === void 0 ? void 0 : options.throwOnError) !== null && _a !== void 0 ? _a : false;
     const { setShowAuthFlow } = useInternalDynamicContext.useInternalDynamicContext();
     const { pushView } = ViewContext.useViewContext();
     const user = useUser.useUser();
@@ -138,7 +65,7 @@ const useWalletBackup = () => {
     const refresh = useRefreshAuth.useRefreshAuth();
     const { getWaasWalletConnector, getWaasWalletsByCredentials } = useDynamicWaas.useDynamicWaas();
     const { linkSocialAccount, isLinked } = useSocialAccounts.useSocialAccounts();
-    const backupOptions = (_b = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _a === void 0 ? void 0 : _a.waas) === null || _b === void 0 ? void 0 : _b.backupOptions;
+    const backupOptions = (_c = (_b = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _b === void 0 ? void 0 : _b.waas) === null || _c === void 0 ? void 0 : _c.backupOptions;
     const isGoogleLinked = React.useMemo(() => isLinked(sdkApiCore.ProviderEnum.Google), [isLinked]);
     const [backupState, setBackupState] = React.useState({
         currentIndex: 0,
@@ -146,6 +73,7 @@ const useWalletBackup = () => {
         hasError: false,
         isComplete: false,
         isProcessing: false,
+        lastError: undefined,
         totalWallets: 0,
     });
     const [lastBackupError, setLastBackupError] = React.useState(undefined);
@@ -169,7 +97,7 @@ const useWalletBackup = () => {
         return (statuses.length > 0 && statuses.every((w) => w.status === 'backed-up'));
     }, [getWalletsBackupStatus]);
     const ensureGoogleLinked = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
-        var _c;
+        var _d;
         if (isGoogleLinked) {
             return true;
         }
@@ -179,7 +107,7 @@ const useWalletBackup = () => {
                 showWidgetAfterConnection: false,
             });
             const updatedUser = yield refresh();
-            const isGoogleLinkedAfterRefresh = (_c = updatedUser === null || updatedUser === void 0 ? void 0 : updatedUser.verifiedCredentials) === null || _c === void 0 ? void 0 : _c.some((cred) => cred.format === 'oauth' && cred.oauthProvider === sdkApiCore.ProviderEnum.Google);
+            const isGoogleLinkedAfterRefresh = (_d = updatedUser === null || updatedUser === void 0 ? void 0 : updatedUser.verifiedCredentials) === null || _d === void 0 ? void 0 : _d.some((cred) => cred.format === 'oauth' && cred.oauthProvider === sdkApiCore.ProviderEnum.Google);
             return Boolean(isGoogleLinkedAfterRefresh);
         }
         catch (error) {
@@ -235,15 +163,17 @@ const useWalletBackup = () => {
             logger.logger.warn('Error hiding iCloud auth', { error });
         }
     }), [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);
+    // Throwing core used by startBackup/backupAllWallets internally. The
+    // public `backupWallet` wraps this with the legacy/opt-in error-surfacing
+    // behavior controlled by `options.throwOnError`.
+    const backupWalletCore = React.useCallback((walletToBackup_1, ...args_1) => _tslib.__awaiter(void 0, [walletToBackup_1, ...args_1], void 0, function* (walletToBackup, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
         try {
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
             if (!waasConnector) {
                 logger.logger.warn('No WaaS connector found for wallet', {
                     address: walletToBackup.address,
                 });
-                return false;
+                throw new Error(`No WaaS connector found for wallet ${walletToBackup.address}`);
             }
             if (provider === types.CloudBackupProvider.GoogleDrive) {
                 yield waasConnector.backupKeySharesToGoogleDrive({
@@ -255,25 +185,62 @@ const useWalletBackup = () => {
                     accountAddress: walletToBackup.address,
                 });
             }
-            return true;
         }
         catch (error) {
             logger.logger.warn('Error backing up wallet', {
                 address: walletToBackup.address,
                 error,
             });
+            throw error;
+        }
+    }), [getWaasWalletConnector]);
+    const backupWallet = React.useCallback((walletToBackup_2, ...args_2) => _tslib.__awaiter(void 0, [walletToBackup_2, ...args_2], void 0, function* (walletToBackup, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
+        setLastBackupError(undefined);
+        try {
+            yield backupWalletCore(walletToBackup, provider, displayContainer);
+            return true;
+        }
+        catch (error) {
+            if (throwOnError) {
+                throw error;
+            }
             setLastBackupError(error);
             return false;
         }
-    }), [getWaasWalletConnector]);
-    const backupAllWallets = React.useCallback((wallets_1, ...args_2) => _tslib.__awaiter(void 0, [wallets_1, ...args_2], void 0, function* (wallets, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
+    }), [backupWalletCore, throwOnError]);
+    const backupAllWallets = React.useCallback((wallets_1, ...args_3) => _tslib.__awaiter(void 0, [wallets_1, ...args_3], void 0, function* (wallets, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
         const walletsToProcess = wallets !== null && wallets !== void 0 ? wallets : getWalletsToBackup();
+        if (!throwOnError) {
+            // Legacy: each call to backupWallet sets lastBackupError on failure
+            // and returns false. Iterate without surfacing an aggregate error,
+            // matching pre-#11183 behavior.
+            for (const wallet of walletsToProcess) {
+                yield backupWallet(wallet, provider, displayContainer);
+            }
+            yield refresh();
+            return;
+        }
+        const successfulWallets = [];
+        const failedWallets = [];
         for (const wallet of walletsToProcess) {
-            yield backupWallet(wallet, provider, displayContainer);
+            try {
+                yield backupWalletCore(wallet, provider, displayContainer);
+                successfulWallets.push(wallet);
+            }
+            catch (cause) {
+                failedWallets.push({ cause, wallet });
+            }
         }
         yield refresh();
-    }), [getWalletsToBackup, backupWallet, refresh]);
-    const startBackup = React.useCallback((onComplete_1, ...args_3) => _tslib.__awaiter(void 0, [onComplete_1, ...args_3], void 0, function* (onComplete, fromIndex = 0, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
+        if (failedWallets.length > 0) {
+            throw new BackupError.BackupError({
+                failedWallets,
+                provider,
+                successfulWallets,
+            });
+        }
+    }), [getWalletsToBackup, backupWallet, backupWalletCore, refresh, throwOnError]);
+    const startBackup = React.useCallback((onComplete_1, ...args_4) => _tslib.__awaiter(void 0, [onComplete_1, ...args_4], void 0, function* (onComplete, fromIndex = 0, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) {
         if (timeoutRef.current) {
             clearTimeout(timeoutRef.current);
             timeoutRef.current = null;
@@ -283,12 +250,14 @@ const useWalletBackup = () => {
             onComplete === null || onComplete === void 0 ? void 0 : onComplete();
             return;
         }
-        setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: null, hasError: false, isProcessing: true, totalWallets: walletsToBackup.length })));
+        setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: null, hasError: false, isProcessing: true, lastError: undefined, totalWallets: walletsToBackup.length })));
         for (let i = fromIndex; i < walletsToBackup.length; i++) {
             setBackupState((prev) => (Object.assign(Object.assign({}, prev), { currentIndex: i + 1 })));
-            const success = yield backupWallet(walletsToBackup[i], provider, displayContainer);
-            if (!success) {
-                setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: i, hasError: true, isProcessing: false })));
+            try {
+                yield backupWalletCore(walletsToBackup[i], provider, displayContainer);
+            }
+            catch (error) {
+                setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: i, hasError: true, isProcessing: false, lastError: error })));
                 return;
             }
         }
@@ -297,7 +266,7 @@ const useWalletBackup = () => {
         if (onComplete) {
             timeoutRef.current = setTimeout(onComplete, 1000);
         }
-    }), [getWalletsToBackup, backupWallet, refresh]);
+    }), [getWalletsToBackup, backupWalletCore, refresh]);
     const initBackupProcess = React.useCallback(() => {
         if (!user) {
             throw new Error(errors.USER_NOT_LOGGED_IN);
@@ -322,16 +291,15 @@ const useWalletBackup = () => {
         }
         return true;
     }, [isGoogleLinked]);
-    const backupToCloudProvider = React.useCallback((options, walletToBackup) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
-        setLastBackupError(undefined);
+    const backupToCloudProviderCore = React.useCallback((options, walletToBackup) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const { provider, password } = options;
         try {
-            const { provider, password } = options;
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
             if (!waasConnector) {
                 logger.logger.warn('No WaaS connector found for wallet', {
                     address: walletToBackup.address,
                 });
-                return false;
+                throw new Error(`No WaaS connector found for wallet ${walletToBackup.address}`);
             }
             if (provider === types.CloudBackupProvider.GoogleDrive) {
                 yield waasConnector.backupKeySharesToGoogleDrive({
@@ -345,14 +313,26 @@ const useWalletBackup = () => {
                     password,
                 });
             }
-            return true;
         }
         catch (error) {
             logger.logger.warn('Error backing up to cloud provider', { error, options });
+            throw error;
+        }
+    }), [getWaasWalletConnector]);
+    const backupToCloudProvider = React.useCallback((options, walletToBackup) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        setLastBackupError(undefined);
+        try {
+            yield backupToCloudProviderCore(options, walletToBackup);
+            return true;
+        }
+        catch (error) {
+            if (throwOnError) {
+                throw error;
+            }
             setLastBackupError(error);
             return false;
         }
-    }), [getWaasWalletConnector]);
+    }), [backupToCloudProviderCore, throwOnError]);
     const getSupportedProviders = React.useCallback(() => cloudProviders.getSupportedProviders(backupOptions), [backupOptions]);
     return {
         areAllWalletsBackedUp,
@@ -361,6 +341,11 @@ const useWalletBackup = () => {
         backupToCloudProvider,
         backupWallet,
         checkICloudAuth,
+        /**
+         * @deprecated Pass `{ throwOnError: true }` to `useWalletBackup` and
+         * use try/catch around `backupWallet` / `backupToCloudProvider` instead.
+         * Will be removed in the next major version.
+         */
         clearBackupError,
         ensureGoogleLinked,
         ensureProviderLinked,
@@ -371,6 +356,11 @@ const useWalletBackup = () => {
         initBackupProcess,
         isGoogleLinked,
         isProviderLinked,
+        /**
+         * @deprecated Pass `{ throwOnError: true }` to `useWalletBackup` and
+         * use try/catch around `backupWallet` / `backupToCloudProvider` instead.
+         * Will be removed in the next major version.
+         */
         lastBackupError,
         showICloudAuth,
         startBackup,

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

@@ -16,14 +16,36 @@ export interface WalletOperationState {
     isProcessing: boolean;
     totalWallets: number;
 }
+export interface WalletBackupState extends WalletOperationState {
+    lastError: unknown;
+}
+export interface UseWalletBackupOptions {
+    /**
+     * If true, `backupWallet`, `backupToCloudProvider`, and `backupAllWallets`
+     * throw on failure instead of catching internally, populating
+     * `lastBackupError`, and returning `false`.
+     *
+     * Defaults to `false` for backward compatibility with the pre-#11183
+     * surface. New consumers should set `throwOnError: true` and use try/catch
+     * (or read `mutation.error` if wrapping in a mutation). `lastBackupError`
+     * and `clearBackupError` are deprecated and will be removed in the next
+     * major version.
+     */
+    throwOnError?: boolean;
+}
 export declare const isWalletBackedUp: (cred: JwtVerifiedCredential) => boolean;
-export declare const useWalletBackup: () => {
+export declare const useWalletBackup: (options?: UseWalletBackupOptions) => {
     readonly areAllWalletsBackedUp: boolean;
     readonly backupAllWallets: (wallets?: WalletToBackup[], provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<void>;
-    readonly backupState: WalletOperationState;
+    readonly backupState: WalletBackupState;
     readonly backupToCloudProvider: (options: CloudProviderBackupOptions, walletToBackup: WalletToBackup) => Promise<boolean>;
     readonly backupWallet: (walletToBackup: WalletToBackup, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<boolean>;
     readonly checkICloudAuth: (walletChain: ChainEnum) => Promise<boolean>;
+    /**
+     * @deprecated Pass `{ throwOnError: true }` to `useWalletBackup` and
+     * use try/catch around `backupWallet` / `backupToCloudProvider` instead.
+     * Will be removed in the next major version.
+     */
     readonly clearBackupError: () => void;
     readonly ensureGoogleLinked: () => Promise<boolean>;
     readonly ensureProviderLinked: (provider: CloudBackupProvider) => Promise<boolean>;
@@ -34,6 +56,11 @@ export declare const useWalletBackup: () => {
     readonly initBackupProcess: () => void;
     readonly isGoogleLinked: boolean;
     readonly isProviderLinked: (provider: CloudBackupProvider) => boolean;
+    /**
+     * @deprecated Pass `{ throwOnError: true }` to `useWalletBackup` and
+     * use try/catch around `backupWallet` / `backupToCloudProvider` instead.
+     * Will be removed in the next major version.
+     */
     readonly lastBackupError: unknown;
     readonly showICloudAuth: (displayContainer: HTMLElement, walletChain: ChainEnum) => Promise<boolean>;
     readonly startBackup: (onComplete?: () => void, fromIndex?: number, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<void>;
@@ -41,6 +68,7 @@ export declare const useWalletBackup: () => {
 export declare const useBackupWallets: (onComplete: () => void, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => {
     retry: () => void;
     start: () => void;
+    lastError: unknown;
     currentIndex: number;
     failedIndex: number | null;
     hasError: boolean;