@dynamic-labs/sdk-react-core 4.53.2 → 4.54.0

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

@@ -31,6 +31,7 @@ require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
 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');
@@ -76,8 +77,7 @@ require('qrcode');
 require('formik');
 require('../useSubdomainCheck/useSubdomainCheck.cjs');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
-var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
-var useRefreshUser = require('../useRefreshUser/useRefreshUser.cjs');
+var types = require('./types.cjs');
 require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
 require('../../../context/SocialRedirectContext/SocialRedirectContext.cjs');
 require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
@@ -94,6 +94,8 @@ require('../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
 require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
 require('../../../context/PasskeyContext/PasskeyContext.cjs');
 require('../../../context/OnrampContext/OnrampContext.cjs');
+var useRefreshUser = require('../useRefreshUser/useRefreshUser.cjs');
+var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
 require('../../../store/state/sendBalances.cjs');
 require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
 require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
@@ -107,7 +109,12 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
 var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
+var cloudProviders = require('./cloudProviders.cjs');
 
+const CLOUD_BACKUP_LOCATIONS = [
+    sdkApiCore.WaasBackupOptionsEnum.GoogleDrive,
+    sdkApiCore.WaasBackupOptionsEnum.ICloud,
+];
 const isWalletBackedUp = (cred) => {
     var _a;
     const keyShares = (_a = cred.walletProperties) === null || _a === void 0 ? void 0 : _a.keyShares;
@@ -116,15 +123,18 @@ const isWalletBackedUp = (cred) => {
     return keyShares.some((keyShare) => keyShare &&
         typeof keyShare === 'object' &&
         'backupLocation' in keyShare &&
-        keyShare.backupLocation === 'googleDrive');
+        CLOUD_BACKUP_LOCATIONS.includes(keyShare.backupLocation));
 };
 const useWalletBackup = () => {
+    var _a, _b;
     const { setShowAuthFlow } = useInternalDynamicContext.useInternalDynamicContext();
     const { pushView } = ViewContext.useViewContext();
     const user = useUser.useUser();
+    const projectSettings = useProjectSettings.useProjectSettings();
     const refresh = useRefreshUser.useRefreshUser();
     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 isGoogleLinked = React.useMemo(() => isLinked(sdkApiCore.ProviderEnum.Google), [isLinked]);
     const [backupState, setBackupState] = React.useState({
         currentIndex: 0,
@@ -153,7 +163,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 _a;
+        var _c;
         if (isGoogleLinked) {
             return true;
         }
@@ -163,7 +173,7 @@ const useWalletBackup = () => {
                 showWidgetAfterConnection: false,
             });
             const updatedUser = yield refresh();
-            const isGoogleLinkedAfterRefresh = (_a = updatedUser === null || updatedUser === void 0 ? void 0 : updatedUser.verifiedCredentials) === null || _a === void 0 ? void 0 : _a.some((cred) => cred.format === 'oauth' && cred.oauthProvider === sdkApiCore.ProviderEnum.Google);
+            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);
             return Boolean(isGoogleLinkedAfterRefresh);
         }
         catch (error) {
@@ -171,7 +181,55 @@ const useWalletBackup = () => {
             return false;
         }
     }), [isGoogleLinked, linkSocialAccount, refresh]);
-    const backupWallet = React.useCallback((walletToBackup) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const showICloudAuth = React.useCallback((displayContainer, walletChain) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const waasConnector = getWaasWalletConnector(walletChain);
+            if (!waasConnector) {
+                logger.logger.warn('No WaaS connector found for showing iCloud auth', {
+                    chain: walletChain,
+                });
+                return false;
+            }
+            yield waasConnector.displayICloudSignIn({ displayContainer });
+            return true;
+        }
+        catch (error) {
+            logger.logger.warn('Error showing iCloud auth', { error });
+            return false;
+        }
+    }), [getWaasWalletConnector]);
+    const checkICloudAuth = React.useCallback((walletChain) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const waasConnector = getWaasWalletConnector(walletChain);
+            if (!waasConnector) {
+                logger.logger.warn('No WaaS connector found for checking iCloud auth', {
+                    chain: walletChain,
+                });
+                return false;
+            }
+            return yield waasConnector.isICloudAuthenticated();
+        }
+        catch (error) {
+            logger.logger.warn('Error checking iCloud auth', { error });
+            return false;
+        }
+    }), [getWaasWalletConnector]);
+    const hideICloudAuth = React.useCallback((walletChain) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const waasConnector = getWaasWalletConnector(walletChain);
+            if (!waasConnector) {
+                logger.logger.warn('No WaaS connector found for hiding iCloud auth', {
+                    chain: walletChain,
+                });
+                return;
+            }
+            yield waasConnector.hideICloudSignIn();
+        }
+        catch (error) {
+            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) {
         try {
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
             if (!waasConnector) {
@@ -180,9 +238,16 @@ const useWalletBackup = () => {
                 });
                 return false;
             }
-            yield waasConnector.backupKeySharesToGoogleDrive({
-                accountAddress: walletToBackup.address,
-            });
+            if (provider === types.CloudBackupProvider.GoogleDrive) {
+                yield waasConnector.backupKeySharesToGoogleDrive({
+                    accountAddress: walletToBackup.address,
+                });
+            }
+            else if (provider === types.CloudBackupProvider.ICloud) {
+                yield waasConnector.backupKeySharesToICloud({
+                    accountAddress: walletToBackup.address,
+                });
+            }
             return true;
         }
         catch (error) {
@@ -193,14 +258,14 @@ const useWalletBackup = () => {
             return false;
         }
     }), [getWaasWalletConnector]);
-    const backupAllWallets = React.useCallback((wallets) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    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) {
         const walletsToProcess = wallets !== null && wallets !== void 0 ? wallets : getWalletsToBackup();
         for (const wallet of walletsToProcess) {
-            yield backupWallet(wallet);
+            yield backupWallet(wallet, provider, displayContainer);
         }
         yield refresh();
     }), [getWalletsToBackup, backupWallet, refresh]);
-    const startBackup = React.useCallback((onComplete_1, ...args_1) => _tslib.__awaiter(void 0, [onComplete_1, ...args_1], void 0, function* (onComplete, fromIndex = 0) {
+    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 (timeoutRef.current) {
             clearTimeout(timeoutRef.current);
             timeoutRef.current = null;
@@ -213,7 +278,7 @@ const useWalletBackup = () => {
         setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: null, hasError: false, isProcessing: true, 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]);
+            const success = yield backupWallet(walletsToBackup[i], provider, displayContainer);
             if (!success) {
                 setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: i, hasError: true, isProcessing: false })));
                 return;
@@ -235,36 +300,102 @@ const useWalletBackup = () => {
         });
         pushView('waas-backup-progress-view');
     }, [setShowAuthFlow, pushView, user]);
+    const ensureProviderLinked = React.useCallback((provider) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const config = cloudProviders.CLOUD_PROVIDER_CONFIGS[provider];
+        if (config.requiresOAuth && config.oauthProvider) {
+            return ensureGoogleLinked();
+        }
+        return true;
+    }), [ensureGoogleLinked]);
+    const isProviderLinked = React.useCallback((provider) => {
+        const config = cloudProviders.CLOUD_PROVIDER_CONFIGS[provider];
+        if (config.requiresOAuth) {
+            return isGoogleLinked;
+        }
+        return true;
+    }, [isGoogleLinked]);
+    const backupToCloudProvider = React.useCallback((options, walletToBackup) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        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;
+            }
+            if (provider === types.CloudBackupProvider.GoogleDrive) {
+                yield waasConnector.backupKeySharesToGoogleDrive({
+                    accountAddress: walletToBackup.address,
+                    password,
+                });
+            }
+            else if (provider === types.CloudBackupProvider.ICloud) {
+                yield waasConnector.backupKeySharesToICloud({
+                    accountAddress: walletToBackup.address,
+                    password,
+                });
+            }
+            return true;
+        }
+        catch (error) {
+            logger.logger.warn('Error backing up to cloud provider', { error, options });
+            return false;
+        }
+    }), [getWaasWalletConnector]);
+    const getSupportedProviders = React.useCallback(() => cloudProviders.getSupportedProviders(backupOptions), [backupOptions]);
     return {
         areAllWalletsBackedUp,
         backupAllWallets,
         backupState,
+        backupToCloudProvider,
         backupWallet,
+        checkICloudAuth,
         ensureGoogleLinked,
+        ensureProviderLinked,
+        getSupportedProviders,
         getWalletsBackupStatus,
         getWalletsToBackup,
+        hideICloudAuth,
         initBackupProcess,
         isGoogleLinked,
+        isProviderLinked,
+        showICloudAuth,
         startBackup,
     };
 };
-const useBackupWallets = (onComplete) => {
+const useBackupWallets = (onComplete, provider = types.CloudBackupProvider.GoogleDrive, displayContainer) => {
     const { backupState, startBackup } = useWalletBackup();
     const hasStartedRef = React.useRef(false);
     const onCompleteRef = React.useRef(onComplete);
     onCompleteRef.current = onComplete;
-    React.useEffect(() => {
+    const config = cloudProviders.CLOUD_PROVIDER_CONFIGS[provider];
+    const start = React.useCallback(() => {
         if (hasStartedRef.current)
             return;
+        if (config.requiresIframe && !displayContainer) {
+            throw new Error(`${config.name} backup requires iframe to be ready`);
+        }
         hasStartedRef.current = true;
-        startBackup(() => onCompleteRef.current());
-    }, [startBackup]);
+        startBackup(() => onCompleteRef.current(), 0, provider, displayContainer);
+    }, [startBackup, provider, displayContainer, config]);
     const retry = React.useCallback(() => {
         var _a;
+        hasStartedRef.current = false;
         const fromIndex = (_a = backupState.failedIndex) !== null && _a !== void 0 ? _a : 0;
-        startBackup(() => onCompleteRef.current(), fromIndex);
-    }, [startBackup, backupState.failedIndex]);
-    return Object.assign(Object.assign({}, backupState), { retry });
+        hasStartedRef.current = true;
+        startBackup(() => onCompleteRef.current(), fromIndex, provider, displayContainer);
+    }, [startBackup, backupState.failedIndex, provider, displayContainer]);
+    // Auto-start for non-iframe providers (Google Drive)
+    // iCloud requires displayContainer to be ready first
+    React.useEffect(() => {
+        if (hasStartedRef.current)
+            return;
+        if (config.requiresIframe)
+            return;
+        start();
+    }, [config.requiresIframe, start]);
+    return Object.assign(Object.assign({}, backupState), { retry, start });
 };
 const useDownloadKeyShares = (onComplete) => {
     const { getWaasWalletConnector, getWaasWalletsByCredentials } = useDynamicWaas.useDynamicWaas();

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

@@ -1,4 +1,5 @@
 import { ChainEnum, JwtVerifiedCredential } from '@dynamic-labs/sdk-api-core';
+import { CloudBackupProvider, CloudProviderBackupOptions } from './types';
 export type WalletBackupStatus = 'backed-up' | 'pending';
 export interface WalletToBackup {
     address: string;
@@ -18,18 +19,26 @@ export interface WalletOperationState {
 export declare const isWalletBackedUp: (cred: JwtVerifiedCredential) => boolean;
 export declare const useWalletBackup: () => {
     readonly areAllWalletsBackedUp: boolean;
-    readonly backupAllWallets: (wallets?: WalletToBackup[]) => Promise<void>;
+    readonly backupAllWallets: (wallets?: WalletToBackup[], provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<void>;
     readonly backupState: WalletOperationState;
-    readonly backupWallet: (walletToBackup: WalletToBackup) => Promise<boolean>;
+    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 ensureGoogleLinked: () => Promise<boolean>;
+    readonly ensureProviderLinked: (provider: CloudBackupProvider) => Promise<boolean>;
+    readonly getSupportedProviders: () => import("./cloudProviders").CloudProviderConfigWithIcon[];
     readonly getWalletsBackupStatus: () => WalletWithBackupStatus[];
     readonly getWalletsToBackup: () => WalletToBackup[];
+    readonly hideICloudAuth: (walletChain: ChainEnum) => Promise<void>;
     readonly initBackupProcess: () => void;
     readonly isGoogleLinked: boolean;
-    readonly startBackup: (onComplete?: () => void, fromIndex?: number) => Promise<void>;
+    readonly isProviderLinked: (provider: CloudBackupProvider) => boolean;
+    readonly showICloudAuth: (displayContainer: HTMLElement, walletChain: ChainEnum) => Promise<boolean>;
+    readonly startBackup: (onComplete?: () => void, fromIndex?: number, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => Promise<void>;
 };
-export declare const useBackupWallets: (onComplete: () => void) => {
+export declare const useBackupWallets: (onComplete: () => void, provider?: CloudBackupProvider, displayContainer?: HTMLElement) => {
     retry: () => void;
+    start: () => void;
     currentIndex: number;
     failedIndex: number | null;
     hasError: boolean;

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

@@ -1,7 +1,7 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
 import { useMemo, useState, useRef, useEffect, useCallback } from 'react';
-import { ProviderEnum } from '@dynamic-labs/sdk-api-core';
+import { WaasBackupOptionsEnum, ProviderEnum } from '@dynamic-labs/sdk-api-core';
 import '@dynamic-labs-sdk/client/core';
 import '../../../client/client.js';
 import '@dynamic-labs-sdk/client';
@@ -27,6 +27,7 @@ import '../../../store/state/connectedWalletsInfo/connectedWalletsInfo.js';
 import '../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
 import '../../../events/dynamicEvents.js';
 import { useUser } from '../../../client/extension/user/useUser/useUser.js';
+import { useProjectSettings } from '../../../client/extension/projectSettings/useProjectSettings/useProjectSettings.js';
 import '../../../context/DynamicContext/DynamicContext.js';
 import '../../../store/state/loadingAndLifecycle/loadingAndLifecycle.js';
 import '../../../context/CaptchaContext/CaptchaContext.js';
@@ -72,8 +73,7 @@ import 'qrcode';
 import 'formik';
 import '../useSubdomainCheck/useSubdomainCheck.js';
 import '../../../context/WalletGroupContext/WalletGroupContext.js';
-import { useDynamicWaas } from '../useDynamicWaas/useDynamicWaas.js';
-import { useRefreshUser } from '../useRefreshUser/useRefreshUser.js';
+import { CloudBackupProvider } from './types.js';
 import '../../../context/IpConfigurationContext/IpConfigurationContext.js';
 import '../../../context/SocialRedirectContext/SocialRedirectContext.js';
 import '../../../context/ConnectWithOtpContext/ConnectWithOtpContext.js';
@@ -90,6 +90,8 @@ import '../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.js';
 import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js';
 import '../../../context/PasskeyContext/PasskeyContext.js';
 import '../../../context/OnrampContext/OnrampContext.js';
+import { useRefreshUser } from '../useRefreshUser/useRefreshUser.js';
+import { useDynamicWaas } from '../useDynamicWaas/useDynamicWaas.js';
 import '../../../store/state/sendBalances.js';
 import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
 import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
@@ -103,7 +105,12 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
+import { getSupportedProviders, CLOUD_PROVIDER_CONFIGS } from './cloudProviders.js';
 
+const CLOUD_BACKUP_LOCATIONS = [
+    WaasBackupOptionsEnum.GoogleDrive,
+    WaasBackupOptionsEnum.ICloud,
+];
 const isWalletBackedUp = (cred) => {
     var _a;
     const keyShares = (_a = cred.walletProperties) === null || _a === void 0 ? void 0 : _a.keyShares;
@@ -112,15 +119,18 @@ const isWalletBackedUp = (cred) => {
     return keyShares.some((keyShare) => keyShare &&
         typeof keyShare === 'object' &&
         'backupLocation' in keyShare &&
-        keyShare.backupLocation === 'googleDrive');
+        CLOUD_BACKUP_LOCATIONS.includes(keyShare.backupLocation));
 };
 const useWalletBackup = () => {
+    var _a, _b;
     const { setShowAuthFlow } = useInternalDynamicContext();
     const { pushView } = useViewContext();
     const user = useUser();
+    const projectSettings = useProjectSettings();
     const refresh = useRefreshUser();
     const { getWaasWalletConnector, getWaasWalletsByCredentials } = useDynamicWaas();
     const { linkSocialAccount, isLinked } = 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 isGoogleLinked = useMemo(() => isLinked(ProviderEnum.Google), [isLinked]);
     const [backupState, setBackupState] = useState({
         currentIndex: 0,
@@ -149,7 +159,7 @@ const useWalletBackup = () => {
         return (statuses.length > 0 && statuses.every((w) => w.status === 'backed-up'));
     }, [getWalletsBackupStatus]);
     const ensureGoogleLinked = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
+        var _c;
         if (isGoogleLinked) {
             return true;
         }
@@ -159,7 +169,7 @@ const useWalletBackup = () => {
                 showWidgetAfterConnection: false,
             });
             const updatedUser = yield refresh();
-            const isGoogleLinkedAfterRefresh = (_a = updatedUser === null || updatedUser === void 0 ? void 0 : updatedUser.verifiedCredentials) === null || _a === void 0 ? void 0 : _a.some((cred) => cred.format === 'oauth' && cred.oauthProvider === ProviderEnum.Google);
+            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 === ProviderEnum.Google);
             return Boolean(isGoogleLinkedAfterRefresh);
         }
         catch (error) {
@@ -167,7 +177,55 @@ const useWalletBackup = () => {
             return false;
         }
     }), [isGoogleLinked, linkSocialAccount, refresh]);
-    const backupWallet = useCallback((walletToBackup) => __awaiter(void 0, void 0, void 0, function* () {
+    const showICloudAuth = useCallback((displayContainer, walletChain) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const waasConnector = getWaasWalletConnector(walletChain);
+            if (!waasConnector) {
+                logger.warn('No WaaS connector found for showing iCloud auth', {
+                    chain: walletChain,
+                });
+                return false;
+            }
+            yield waasConnector.displayICloudSignIn({ displayContainer });
+            return true;
+        }
+        catch (error) {
+            logger.warn('Error showing iCloud auth', { error });
+            return false;
+        }
+    }), [getWaasWalletConnector]);
+    const checkICloudAuth = useCallback((walletChain) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const waasConnector = getWaasWalletConnector(walletChain);
+            if (!waasConnector) {
+                logger.warn('No WaaS connector found for checking iCloud auth', {
+                    chain: walletChain,
+                });
+                return false;
+            }
+            return yield waasConnector.isICloudAuthenticated();
+        }
+        catch (error) {
+            logger.warn('Error checking iCloud auth', { error });
+            return false;
+        }
+    }), [getWaasWalletConnector]);
+    const hideICloudAuth = useCallback((walletChain) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const waasConnector = getWaasWalletConnector(walletChain);
+            if (!waasConnector) {
+                logger.warn('No WaaS connector found for hiding iCloud auth', {
+                    chain: walletChain,
+                });
+                return;
+            }
+            yield waasConnector.hideICloudSignIn();
+        }
+        catch (error) {
+            logger.warn('Error hiding iCloud auth', { error });
+        }
+    }), [getWaasWalletConnector]);
+    const backupWallet = useCallback((walletToBackup_1, ...args_1) => __awaiter(void 0, [walletToBackup_1, ...args_1], void 0, function* (walletToBackup, provider = CloudBackupProvider.GoogleDrive, displayContainer) {
         try {
             const waasConnector = getWaasWalletConnector(walletToBackup.chain);
             if (!waasConnector) {
@@ -176,9 +234,16 @@ const useWalletBackup = () => {
                 });
                 return false;
             }
-            yield waasConnector.backupKeySharesToGoogleDrive({
-                accountAddress: walletToBackup.address,
-            });
+            if (provider === CloudBackupProvider.GoogleDrive) {
+                yield waasConnector.backupKeySharesToGoogleDrive({
+                    accountAddress: walletToBackup.address,
+                });
+            }
+            else if (provider === CloudBackupProvider.ICloud) {
+                yield waasConnector.backupKeySharesToICloud({
+                    accountAddress: walletToBackup.address,
+                });
+            }
             return true;
         }
         catch (error) {
@@ -189,14 +254,14 @@ const useWalletBackup = () => {
             return false;
         }
     }), [getWaasWalletConnector]);
-    const backupAllWallets = useCallback((wallets) => __awaiter(void 0, void 0, void 0, function* () {
+    const backupAllWallets = useCallback((wallets_1, ...args_2) => __awaiter(void 0, [wallets_1, ...args_2], void 0, function* (wallets, provider = CloudBackupProvider.GoogleDrive, displayContainer) {
         const walletsToProcess = wallets !== null && wallets !== void 0 ? wallets : getWalletsToBackup();
         for (const wallet of walletsToProcess) {
-            yield backupWallet(wallet);
+            yield backupWallet(wallet, provider, displayContainer);
         }
         yield refresh();
     }), [getWalletsToBackup, backupWallet, refresh]);
-    const startBackup = useCallback((onComplete_1, ...args_1) => __awaiter(void 0, [onComplete_1, ...args_1], void 0, function* (onComplete, fromIndex = 0) {
+    const startBackup = useCallback((onComplete_1, ...args_3) => __awaiter(void 0, [onComplete_1, ...args_3], void 0, function* (onComplete, fromIndex = 0, provider = CloudBackupProvider.GoogleDrive, displayContainer) {
         if (timeoutRef.current) {
             clearTimeout(timeoutRef.current);
             timeoutRef.current = null;
@@ -209,7 +274,7 @@ const useWalletBackup = () => {
         setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: null, hasError: false, isProcessing: true, 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]);
+            const success = yield backupWallet(walletsToBackup[i], provider, displayContainer);
             if (!success) {
                 setBackupState((prev) => (Object.assign(Object.assign({}, prev), { failedIndex: i, hasError: true, isProcessing: false })));
                 return;
@@ -231,36 +296,102 @@ const useWalletBackup = () => {
         });
         pushView('waas-backup-progress-view');
     }, [setShowAuthFlow, pushView, user]);
+    const ensureProviderLinked = useCallback((provider) => __awaiter(void 0, void 0, void 0, function* () {
+        const config = CLOUD_PROVIDER_CONFIGS[provider];
+        if (config.requiresOAuth && config.oauthProvider) {
+            return ensureGoogleLinked();
+        }
+        return true;
+    }), [ensureGoogleLinked]);
+    const isProviderLinked = useCallback((provider) => {
+        const config = CLOUD_PROVIDER_CONFIGS[provider];
+        if (config.requiresOAuth) {
+            return isGoogleLinked;
+        }
+        return true;
+    }, [isGoogleLinked]);
+    const backupToCloudProvider = useCallback((options, walletToBackup) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            const { provider, password } = options;
+            const waasConnector = getWaasWalletConnector(walletToBackup.chain);
+            if (!waasConnector) {
+                logger.warn('No WaaS connector found for wallet', {
+                    address: walletToBackup.address,
+                });
+                return false;
+            }
+            if (provider === CloudBackupProvider.GoogleDrive) {
+                yield waasConnector.backupKeySharesToGoogleDrive({
+                    accountAddress: walletToBackup.address,
+                    password,
+                });
+            }
+            else if (provider === CloudBackupProvider.ICloud) {
+                yield waasConnector.backupKeySharesToICloud({
+                    accountAddress: walletToBackup.address,
+                    password,
+                });
+            }
+            return true;
+        }
+        catch (error) {
+            logger.warn('Error backing up to cloud provider', { error, options });
+            return false;
+        }
+    }), [getWaasWalletConnector]);
+    const getSupportedProviders$1 = useCallback(() => getSupportedProviders(backupOptions), [backupOptions]);
     return {
         areAllWalletsBackedUp,
         backupAllWallets,
         backupState,
+        backupToCloudProvider,
         backupWallet,
+        checkICloudAuth,
         ensureGoogleLinked,
+        ensureProviderLinked,
+        getSupportedProviders: getSupportedProviders$1,
         getWalletsBackupStatus,
         getWalletsToBackup,
+        hideICloudAuth,
         initBackupProcess,
         isGoogleLinked,
+        isProviderLinked,
+        showICloudAuth,
         startBackup,
     };
 };
-const useBackupWallets = (onComplete) => {
+const useBackupWallets = (onComplete, provider = CloudBackupProvider.GoogleDrive, displayContainer) => {
     const { backupState, startBackup } = useWalletBackup();
     const hasStartedRef = useRef(false);
     const onCompleteRef = useRef(onComplete);
     onCompleteRef.current = onComplete;
-    useEffect(() => {
+    const config = CLOUD_PROVIDER_CONFIGS[provider];
+    const start = useCallback(() => {
         if (hasStartedRef.current)
             return;
+        if (config.requiresIframe && !displayContainer) {
+            throw new Error(`${config.name} backup requires iframe to be ready`);
+        }
         hasStartedRef.current = true;
-        startBackup(() => onCompleteRef.current());
-    }, [startBackup]);
+        startBackup(() => onCompleteRef.current(), 0, provider, displayContainer);
+    }, [startBackup, provider, displayContainer, config]);
     const retry = useCallback(() => {
         var _a;
+        hasStartedRef.current = false;
         const fromIndex = (_a = backupState.failedIndex) !== null && _a !== void 0 ? _a : 0;
-        startBackup(() => onCompleteRef.current(), fromIndex);
-    }, [startBackup, backupState.failedIndex]);
-    return Object.assign(Object.assign({}, backupState), { retry });
+        hasStartedRef.current = true;
+        startBackup(() => onCompleteRef.current(), fromIndex, provider, displayContainer);
+    }, [startBackup, backupState.failedIndex, provider, displayContainer]);
+    // Auto-start for non-iframe providers (Google Drive)
+    // iCloud requires displayContainer to be ready first
+    useEffect(() => {
+        if (hasStartedRef.current)
+            return;
+        if (config.requiresIframe)
+            return;
+        start();
+    }, [config.requiresIframe, start]);
+    return Object.assign(Object.assign({}, backupState), { retry, start });
 };
 const useDownloadKeyShares = (onComplete) => {
     const { getWaasWalletConnector, getWaasWalletsByCredentials } = useDynamicWaas();

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

@@ -81,8 +81,8 @@ require('qrcode');
 require('formik');
 require('../useSubdomainCheck/useSubdomainCheck.cjs');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
-var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
-var useRefreshUser = require('../useRefreshUser/useRefreshUser.cjs');
+require('../useWalletBackup/useWalletBackup.cjs');
+require('../useWalletBackup/types.cjs');
 require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
 require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
 require('../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
@@ -96,6 +96,8 @@ require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cj
 require('../../../context/PasskeyContext/PasskeyContext.cjs');
 require('../../../context/OnrampContext/OnrampContext.cjs');
 var waas = require('../../../data/api/waas/waas.cjs');
+var useRefreshUser = require('../useRefreshUser/useRefreshUser.cjs');
+var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
 require('../../../store/state/sendBalances.cjs');
 require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
 require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');