@dynamic-labs/legacy-embedded-wallet-migration 0.0.0 → 5.0.0-rc.2

package/src/lib/recovery/completePasskeyRecovery/completePasskeyRecovery.js

@@ -0,0 +1,26 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { iframeElementId } from '../constants.js';
+import { recoverTurnkeyWallet } from '../recoverTurnkeyWallet/recoverTurnkeyWallet.js';
+
+const removeIframeElement = () => {
+    var _a;
+    /* istanbul ignore next -- @preserve: SSR guard, unreachable in jsdom */
+    if (typeof window === 'undefined')
+        return;
+    const elementToRemove = window.document.getElementById(iframeElementId);
+    (_a = elementToRemove === null || elementToRemove === void 0 ? void 0 : elementToRemove.parentElement) === null || _a === void 0 ? void 0 : _a.removeChild(elementToRemove);
+};
+const completePasskeyRecovery = (_a) => __awaiter(void 0, [_a], void 0, function* ({ user, wallet, }) {
+    const { connector, user: updatedUser } = yield recoverTurnkeyWallet({
+        addPasskeyAuthenticator: false,
+        user,
+        wallet,
+    });
+    // clear iframeStamper and its reference
+    connector.getAuthenticatorHandler().clear();
+    removeIframeElement();
+    return updatedUser;
+});
+
+export { completePasskeyRecovery };

package/src/lib/recovery/completePasskeyRecovery/index.d.ts

@@ -0,0 +1 @@
+export { completePasskeyRecovery } from './completePasskeyRecovery';

package/src/lib/recovery/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const iframeContainerId = "dyn-passkey-recovery-id";
+export declare const iframeElementId = "dyn-passkey-recovery-element-id";
+export declare const EMBEDDED_WALLET_SESSION_SETTINGS = "dynamic_embedded_wallet_session_settings";

package/src/lib/recovery/constants.js

@@ -0,0 +1,14 @@
+'use client'
+// These three literals are intentionally duplicated from sdk-react-core for
+// the duration of the recovery-flow migration. They must agree byte-for-byte:
+//   - iframeElementId is selected by `iframe[id*='dyn-passkey-recovery-element-id']`
+//     in sdk-react-core's `lib/styles/overrides.scss`, which hides the iframe.
+//   - EMBEDDED_WALLET_SESSION_SETTINGS is the localStorage key that
+//     sdk-react-core's useClearWalletConnectSessions clears on disconnect.
+// Once sdk-react-core's recovery surface is stripped (PR D), the migration
+// copy becomes canonical and the sdk-react-core duplicates go away.
+const iframeContainerId = 'dyn-passkey-recovery-id';
+const iframeElementId = 'dyn-passkey-recovery-element-id';
+const EMBEDDED_WALLET_SESSION_SETTINGS = 'dynamic_embedded_wallet_session_settings';
+
+export { EMBEDDED_WALLET_SESSION_SETTINGS, iframeContainerId, iframeElementId };

package/src/lib/recovery/index.d.ts

@@ -0,0 +1,13 @@
+export { addEmailRecovery } from './addEmailRecovery';
+export { addNewPasskeyAuthenticator } from './addNewPasskeyAuthenticator';
+export { canRestoreEmbeddedWalletSession } from './canRestoreEmbeddedWalletSession';
+export { completePasskeyRecovery } from './completePasskeyRecovery';
+export { initEmbeddedWalletSession } from './initEmbeddedWalletSession';
+export { passkeyRecoveryBundleValidation } from './passkeyRecoveryBundleValidation';
+export { resentRecoveryEmail } from './resentRecoveryEmail';
+export { restoreEmbeddedWalletSession } from './restoreEmbeddedWalletSession';
+export { useEmbeddedWalletAuthenticator } from './useEmbeddedWalletAuthenticator';
+export { useInitEmbeddedWalletAuthMethod, type EmbeddedWalletCurrentAction, } from './useInitEmbeddedWalletAuthMethod';
+export { usePasskeyRecovery, type UsePasskeyRecoveryProps, } from './usePasskeyRecovery';
+export { EMBEDDED_WALLET_SESSION_SETTINGS, iframeContainerId, iframeElementId, } from './constants';
+export type { EmbeddedWalletSessionSettings } from './types';

package/src/lib/recovery/initEmbeddedWalletSession/index.d.ts

@@ -0,0 +1 @@
+export { initEmbeddedWalletSession } from './initEmbeddedWalletSession';

package/src/lib/recovery/initEmbeddedWalletSession/initEmbeddedWalletSession.d.ts

@@ -0,0 +1,11 @@
+import { SdkUser } from '@dynamic-labs/sdk-api-core';
+import { UserProfile } from '@dynamic-labs/types';
+import { AuthenticatorType, Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const initEmbeddedWalletSession: ({ authenticatorType, iframeContainer, iframeElementId, user, wallet, sessionExpiration, }: {
+    authenticatorType: AuthenticatorType;
+    iframeContainer: HTMLElement;
+    iframeElementId: string;
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+    sessionExpiration?: number;
+}) => Promise<SdkUser | undefined>;

package/src/lib/recovery/initEmbeddedWalletSession/initEmbeddedWalletSession.js

@@ -0,0 +1,56 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { getDefaultClient, getCore, createApiClient } from '@dynamic-labs-sdk/client/core';
+import { DynamicError, InvalidPrimaryWalletOrConnectorError } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+import { addNewPasskeyAuthenticator } from '../addNewPasskeyAuthenticator/addNewPasskeyAuthenticator.js';
+
+const initEmbeddedWalletSession = (_a) => __awaiter(void 0, [_a], void 0, function* ({ authenticatorType, iframeContainer, iframeElementId, user, wallet, sessionExpiration, }) {
+    var _b;
+    if (!user) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    const turnkeyRecoveryHandler = (_b = wallet.connector) === null || _b === void 0 ? void 0 : _b.getAuthenticatorHandler();
+    if (authenticatorType === 'passkey' &&
+        turnkeyRecoveryHandler.isSessionActive()) {
+        return addNewPasskeyAuthenticator({
+            user,
+            wallet,
+        });
+    }
+    const publicKey = yield turnkeyRecoveryHandler.initRecovery(authenticatorType, iframeContainer, iframeElementId, sessionExpiration);
+    if (!publicKey) {
+        throw new DynamicError('Something went wrong', 'init_embedded_wallet_session_failed');
+    }
+    const client = getDefaultClient();
+    const core = getCore(client);
+    const apiClient = createApiClient({}, client);
+    const response = authenticatorType === 'passkey'
+        ? yield apiClient.initPasskeyRecovery({
+            environmentId: core.environmentId,
+            initPasskeyRecoveryRequest: {
+                turnkeyRecoveryTargetPublicKey: publicKey,
+                walletId: wallet.id,
+            },
+        })
+        : yield apiClient.initEmailAuth({
+            environmentId: core.environmentId,
+            initEmailAuthRequest: {
+                turnkeyEmailAuthTargetPublicKey: publicKey,
+                walletId: wallet.id,
+            },
+        });
+    turnkeyRecoveryHandler.recoveryUserId =
+        authenticatorType === 'passkey'
+            ? response.turnkeyRecoveryUserId
+            : response.turnkeyUserId;
+    return;
+});
+
+export { initEmbeddedWalletSession };

package/src/lib/recovery/passkeyRecoveryBundleValidation/index.d.ts

@@ -0,0 +1 @@
+export { passkeyRecoveryBundleValidation } from './passkeyRecoveryBundleValidation';

package/src/lib/recovery/passkeyRecoveryBundleValidation/passkeyRecoveryBundleValidation.d.ts

@@ -0,0 +1,7 @@
+import { UserProfile } from '@dynamic-labs/types';
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const passkeyRecoveryBundleValidation: ({ user, bundleInput, wallet, }: {
+    user: UserProfile | undefined;
+    bundleInput: string | undefined;
+    wallet: Wallet | null;
+}) => Promise<void>;

package/src/lib/recovery/passkeyRecoveryBundleValidation/passkeyRecoveryBundleValidation.js

@@ -0,0 +1,32 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { DynamicError, InvalidPrimaryWalletOrConnectorError, StorageService } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+import { EMBEDDED_WALLET_SESSION_SETTINGS } from '../constants.js';
+
+const passkeyRecoveryBundleValidation = (_a) => __awaiter(void 0, [_a], void 0, function* ({ user, bundleInput, wallet, }) {
+    var _b, _c, _d, _e, _f;
+    if (!bundleInput) {
+        throw new DynamicError('Code must be informed', 'missing_code');
+    }
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    if (!user) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    const organizationId = (_e = (_d = (_c = (_b = user.verifiedCredentials) === null || _b === void 0 ? void 0 : _b.find(({ walletName, id }) => (walletName === null || walletName === void 0 ? void 0 : walletName.startsWith('turnkey')) && id === wallet.id)) === null || _c === void 0 ? void 0 : _c.walletProperties) === null || _d === void 0 ? void 0 : _d.turnkeySubOrganizationId) !== null && _e !== void 0 ? _e : undefined;
+    const turnkeyRecoveryHandler = (_f = wallet.connector) === null || _f === void 0 ? void 0 : _f.getAuthenticatorHandler();
+    yield turnkeyRecoveryHandler.verifyRecoveryCode(bundleInput, organizationId !== null && organizationId !== void 0 ? organizationId : undefined);
+    const sessionSettings = {
+        createdAt: new Date().getTime(),
+        emailCode: bundleInput,
+        userId: turnkeyRecoveryHandler.recoveryUserId,
+    };
+    StorageService.setItem(EMBEDDED_WALLET_SESSION_SETTINGS, sessionSettings);
+});
+
+export { passkeyRecoveryBundleValidation };

package/src/lib/recovery/recoverTurnkeyWallet/index.d.ts

@@ -0,0 +1 @@
+export { recoverTurnkeyWallet } from './recoverTurnkeyWallet';

package/src/lib/recovery/recoverTurnkeyWallet/recoverTurnkeyWallet.d.ts

@@ -0,0 +1,11 @@
+import { SdkUser } from '@dynamic-labs/sdk-api-core';
+import { UserProfile } from '@dynamic-labs/types';
+import { IEmailWalletConnector, IPasskeyWalletConnector, Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const recoverTurnkeyWallet: ({ wallet, user, addPasskeyAuthenticator, }: {
+    wallet: Wallet | null;
+    user: UserProfile | undefined;
+    addPasskeyAuthenticator: boolean;
+}) => Promise<{
+    connector: IEmailWalletConnector & IPasskeyWalletConnector;
+    user: SdkUser;
+}>;

package/src/lib/recovery/recoverTurnkeyWallet/recoverTurnkeyWallet.js

@@ -0,0 +1,72 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { getDefaultClient, getCore, createApiClient, updateAuthFromVerifyResponse } from '@dynamic-labs-sdk/client/core';
+import { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';
+import { DynamicError, InvalidPrimaryWalletOrConnectorError } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+
+const hasEmbeddedWalletCredential = (user) => {
+    var _a;
+    return Boolean((_a = user.verifiedCredentials) === null || _a === void 0 ? void 0 : _a.some(({ walletProvider }) => walletProvider === WalletProviderEnum.EmbeddedWallet));
+};
+const recoverTurnkeyWallet = (_a) => __awaiter(void 0, [_a], void 0, function* ({ wallet, user, addPasskeyAuthenticator, }) {
+    var _b, _c, _d;
+    if (!user) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    if (!wallet ||
+        !wallet.connector ||
+        !wallet.id ||
+        !isPasskeyWalletConnector(wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    const connector = wallet.connector;
+    connector.setEmail(user.email);
+    const turnkeySubOrganizationId = (_d = (_c = (_b = user.verifiedCredentials) === null || _b === void 0 ? void 0 : _b.find(({ walletName, id }) => (walletName === null || walletName === void 0 ? void 0 : walletName.startsWith('turnkey')) && id === wallet.id)) === null || _c === void 0 ? void 0 : _c.walletProperties) === null || _d === void 0 ? void 0 : _d.turnkeySubOrganizationId;
+    if (!turnkeySubOrganizationId) {
+        throw new DynamicError('The authentication token is invalid - turnkeySubOrganizationId is missing', 'invalid_authentication_token');
+    }
+    const turnkeyRecoveryHandler = wallet.connector.getAuthenticatorHandler();
+    const { attestation, challenge } = yield connector.getWebAuthnAttestation();
+    if (addPasskeyAuthenticator) {
+        yield turnkeyRecoveryHandler.addPasskeyAuthenticator({
+            attestation,
+            challenge,
+            turnkeySubOrganizationId,
+        });
+    }
+    else {
+        yield turnkeyRecoveryHandler.completeRecovery({
+            attestation,
+            challenge,
+            turnkeySubOrganizationId,
+        });
+    }
+    const client = getDefaultClient();
+    const core = getCore(client);
+    const apiClient = createApiClient({}, client);
+    const response = yield apiClient.completePasskeyRecovery({
+        completePasskeyRecoveryRequest: {
+            attestation: attestation,
+            challenge,
+            walletId: wallet.id,
+        },
+        environmentId: core.environmentId,
+    });
+    updateAuthFromVerifyResponse({ response }, client);
+    const updatedUser = response.user;
+    if (!updatedUser) {
+        throw new DynamicError('No user returned from passkey recovery', 'passkey_recovery_failed');
+    }
+    if (!hasEmbeddedWalletCredential(updatedUser)) {
+        throw new DynamicError('EmbeddedWalletVerifiedCredential not found', 'embedded_wallet_credential_not_found');
+    }
+    connector.setVerifiedCredentials(updatedUser.verifiedCredentials);
+    return {
+        connector,
+        user: updatedUser,
+    };
+});
+
+export { recoverTurnkeyWallet };

package/src/lib/recovery/resentRecoveryEmail/index.d.ts

@@ -0,0 +1 @@
+export { resentRecoveryEmail } from './resentRecoveryEmail';

package/src/lib/recovery/resentRecoveryEmail/resentRecoveryEmail.d.ts

@@ -0,0 +1,7 @@
+import { UserProfile } from '@dynamic-labs/types';
+import { AuthenticatorType, Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const resentRecoveryEmail: ({ authenticatorType, user, wallet, }: {
+    authenticatorType: AuthenticatorType;
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+}) => Promise<import("@dynamic-labs/sdk-api-core").InitPasskeyRecoveryResponse | import("@dynamic-labs/sdk-api-core").InitEmailAuthResponse>;

package/src/lib/recovery/resentRecoveryEmail/resentRecoveryEmail.js

@@ -0,0 +1,43 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { getDefaultClient, getCore, createApiClient } from '@dynamic-labs-sdk/client/core';
+import { DynamicError, InvalidPrimaryWalletOrConnectorError } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+
+const resentRecoveryEmail = (_a) => __awaiter(void 0, [_a], void 0, function* ({ authenticatorType, user, wallet, }) {
+    var _b;
+    if (!user) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    const publicKey = (_b = wallet.connector) === null || _b === void 0 ? void 0 : _b.getAuthenticatorHandler().publicKey;
+    if (!publicKey) {
+        throw new DynamicError('Could not proceed with your request. Please restart the process.', 'resend_recovery_email_failed');
+    }
+    const client = getDefaultClient();
+    const core = getCore(client);
+    const apiClient = createApiClient({}, client);
+    if (authenticatorType === 'passkey') {
+        return apiClient.initPasskeyRecovery({
+            environmentId: core.environmentId,
+            initPasskeyRecoveryRequest: {
+                turnkeyRecoveryTargetPublicKey: publicKey,
+                walletId: wallet.id,
+            },
+        });
+    }
+    return apiClient.initEmailAuth({
+        environmentId: core.environmentId,
+        initEmailAuthRequest: {
+            turnkeyEmailAuthTargetPublicKey: publicKey,
+            walletId: wallet.id,
+        },
+    });
+});
+
+export { resentRecoveryEmail };

package/src/lib/recovery/restoreEmbeddedWalletSession/index.d.ts

@@ -0,0 +1 @@
+export { restoreEmbeddedWalletSession } from './restoreEmbeddedWalletSession';

package/src/lib/recovery/restoreEmbeddedWalletSession/restoreEmbeddedWalletSession.d.ts

@@ -0,0 +1,9 @@
+import { UserProfile } from '@dynamic-labs/types';
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const restoreEmbeddedWalletSession: ({ user, iframeContainer, iframeElementId, wallet, sessionExpiration, }: {
+    user: UserProfile | undefined;
+    iframeContainer: HTMLElement;
+    iframeElementId: string;
+    wallet: Wallet | null;
+    sessionExpiration?: number;
+}) => Promise<boolean>;

package/src/lib/recovery/restoreEmbeddedWalletSession/restoreEmbeddedWalletSession.js

@@ -0,0 +1,33 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { DynamicError, InvalidPrimaryWalletOrConnectorError, StorageService } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+import { EMBEDDED_WALLET_SESSION_SETTINGS } from '../constants.js';
+
+const restoreEmbeddedWalletSession = (_a) => __awaiter(void 0, [_a], void 0, function* ({ user, iframeContainer, iframeElementId, wallet, sessionExpiration, }) {
+    var _b, _c, _d, _e, _f;
+    if (!user) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    const sessionSettings = StorageService.getItem(EMBEDDED_WALLET_SESSION_SETTINGS);
+    const turnkeyRecoveryHandler = (_b = wallet.connector) === null || _b === void 0 ? void 0 : _b.getAuthenticatorHandler();
+    if (!sessionSettings || Boolean(turnkeyRecoveryHandler.recoveryUserId)) {
+        return false;
+    }
+    const publicKey = yield turnkeyRecoveryHandler.initRecovery('email', iframeContainer, iframeElementId, sessionExpiration);
+    if (!publicKey) {
+        throw new DynamicError('Could not open embedded wallet connection communication', 'restore_embedded_wallet_session_failed');
+    }
+    turnkeyRecoveryHandler.recoveryUserId = sessionSettings.userId;
+    const organizationId = (_f = (_e = (_d = (_c = user.verifiedCredentials) === null || _c === void 0 ? void 0 : _c.find(({ walletName, id }) => (walletName === null || walletName === void 0 ? void 0 : walletName.startsWith('turnkey')) && id === wallet.id)) === null || _d === void 0 ? void 0 : _d.walletProperties) === null || _e === void 0 ? void 0 : _e.turnkeySubOrganizationId) !== null && _f !== void 0 ? _f : undefined;
+    yield turnkeyRecoveryHandler.verifyRecoveryCode(sessionSettings.emailCode, organizationId !== null && organizationId !== void 0 ? organizationId : undefined);
+    return true;
+});
+
+export { restoreEmbeddedWalletSession };

package/src/lib/recovery/types.d.ts

@@ -0,0 +1,5 @@
+export type EmbeddedWalletSessionSettings = {
+    emailCode: string;
+    userId: string;
+    createdAt: number;
+};

package/src/lib/recovery/useEmbeddedWalletAuthenticator/index.d.ts

@@ -0,0 +1 @@
+export { useEmbeddedWalletAuthenticator } from './useEmbeddedWalletAuthenticator';

package/src/lib/recovery/useEmbeddedWalletAuthenticator/useEmbeddedWalletAuthenticator.d.ts

@@ -0,0 +1,11 @@
+import { AuthenticatorType, Wallet } from '@dynamic-labs/wallet-connector-core';
+type UseEmbeddedWalletAuthenticatorProps = {
+    initPasskeyRecoveryProcess: (authenticatorType?: AuthenticatorType) => Promise<Wallet>;
+    shouldInitRecovery: () => Promise<boolean>;
+    onAddRecoveryEmail: () => void;
+};
+export declare const useEmbeddedWalletAuthenticator: ({ initPasskeyRecoveryProcess, shouldInitRecovery, onAddRecoveryEmail, }: UseEmbeddedWalletAuthenticatorProps) => {
+    addEmbeddedWalletRecoveryEmail: () => Promise<void>;
+    createOrRefreshAuthenticatorSession: (authenticatorType?: AuthenticatorType) => Promise<Wallet<import("@dynamic-labs/wallet-connector-core").WalletConnectorCore.WalletConnector> | undefined>;
+};
+export {};

package/src/lib/recovery/useInitEmbeddedWalletAuthMethod/index.d.ts

@@ -0,0 +1 @@
+export { useInitEmbeddedWalletAuthMethod, type EmbeddedWalletCurrentAction, } from './useInitEmbeddedWalletAuthMethod';

package/src/lib/recovery/useInitEmbeddedWalletAuthMethod/useInitEmbeddedWalletAuthMethod.d.ts

@@ -0,0 +1,29 @@
+import { UserProfile } from '@dynamic-labs/types';
+import { AuthenticatorType, Wallet } from '@dynamic-labs/wallet-connector-core';
+export type EmbeddedWalletCurrentAction = {
+    type: 'signMessage' | 'sendTransaction' | 'helpSession' | 'signTransaction' | 'reveal';
+    settings?: {
+        goBack?: () => void;
+    };
+};
+type InitAuthenticatorMethodProps = {
+    authenticatorType: AuthenticatorType;
+    iframeContainer: HTMLElement;
+    currentAction?: EmbeddedWalletCurrentAction;
+};
+type UseInitEmbeddedWalletAuthMethodProps = {
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+    sessionExpiration?: number;
+    onShowEmailBundle: (args: {
+        authenticatorType: AuthenticatorType;
+        currentAction?: EmbeddedWalletCurrentAction;
+    }) => void;
+    onComplete: () => void;
+};
+export declare const useInitEmbeddedWalletAuthMethod: ({ user, wallet, sessionExpiration, onShowEmailBundle, onComplete, }: UseInitEmbeddedWalletAuthMethodProps) => {
+    error: unknown;
+    initAuthMethod: ({ authenticatorType, iframeContainer, currentAction, }: InitAuthenticatorMethodProps) => Promise<void>;
+    isLoading: boolean;
+};
+export {};

package/src/lib/recovery/useInitEmbeddedWalletAuthMethod/useInitEmbeddedWalletAuthMethod.js

@@ -0,0 +1,50 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { useState } from 'react';
+import { logger } from '@dynamic-labs/wallet-connector-core';
+import { iframeElementId } from '../constants.js';
+import { initEmbeddedWalletSession } from '../initEmbeddedWalletSession/initEmbeddedWalletSession.js';
+
+// This hook needs to be async that's why it's not using useMutation
+const useInitEmbeddedWalletAuthMethod = ({ user, wallet, sessionExpiration, onShowEmailBundle, onComplete, }) => {
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState();
+    const initAuthMethod = (_a) => __awaiter(void 0, [_a], void 0, function* ({ authenticatorType, iframeContainer, currentAction, }) {
+        setIsLoading(true);
+        const showEmailBundle = authenticatorType === 'email' ||
+            !wallet ||
+            !wallet.connector
+                .getAuthenticatorHandler()
+                .isSessionActive();
+        try {
+            yield initEmbeddedWalletSession({
+                authenticatorType,
+                iframeContainer,
+                iframeElementId,
+                sessionExpiration,
+                user,
+                wallet,
+            });
+            if (showEmailBundle) {
+                onShowEmailBundle({ authenticatorType, currentAction });
+            }
+            else {
+                onComplete();
+            }
+        }
+        catch (err) {
+            setError(err);
+            logger.error('Failed to create embedded wallet session', err);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    });
+    return {
+        error,
+        initAuthMethod,
+        isLoading,
+    };
+};
+
+export { useInitEmbeddedWalletAuthMethod };

package/src/lib/recovery/usePasskeyRecovery/index.d.ts

@@ -0,0 +1 @@
+export { usePasskeyRecovery, type UsePasskeyRecoveryProps, } from './usePasskeyRecovery';

package/src/lib/recovery/usePasskeyRecovery/usePasskeyRecovery.d.ts

@@ -0,0 +1,32 @@
+import { Duration, SupportedSecurityMethods } from '@dynamic-labs/sdk-api-core';
+import { UserProfile } from '@dynamic-labs/types';
+import { AuthenticatorType, Wallet } from '@dynamic-labs/wallet-connector-core';
+import { EmbeddedWalletCurrentAction } from '../useInitEmbeddedWalletAuthMethod';
+export type UsePasskeyRecoveryProps = {
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+    primaryWallet: Wallet | null;
+    sessionKeyDuration: Duration | undefined;
+    supportedSecurityMethods: SupportedSecurityMethods | undefined;
+    isTurnkeyWalletWithoutAuthenticator: boolean;
+    hasRecoveryEmail: boolean;
+    iframeContainer: HTMLElement | null;
+    onShowAddRecoveryEmail: () => void;
+    onShowAuthChoice: (currentAction?: EmbeddedWalletCurrentAction) => void;
+    awaitEmailVerification: (args: {
+        email: string;
+        verificationUUID: string | undefined;
+    }) => Promise<boolean>;
+    onShowEmailBundle: (args: {
+        authenticatorType: AuthenticatorType;
+        currentAction?: EmbeddedWalletCurrentAction;
+    }) => void;
+    onAuthMethodComplete: () => void;
+    onEmailRecoveryComplete?: () => void;
+    onEmailRecoveryFailed?: (error: unknown) => void;
+};
+export declare const usePasskeyRecovery: ({ user, wallet, primaryWallet, sessionKeyDuration, supportedSecurityMethods, isTurnkeyWalletWithoutAuthenticator, hasRecoveryEmail, iframeContainer, onShowAddRecoveryEmail, onShowAuthChoice, awaitEmailVerification, onShowEmailBundle, onAuthMethodComplete, onEmailRecoveryComplete, onEmailRecoveryFailed, }: UsePasskeyRecoveryProps) => {
+    readonly addRecoveryEmail: (emailInput: string) => Promise<void>;
+    readonly initPasskeyRecoveryProcess: (authenticatorType?: AuthenticatorType, currentAction?: EmbeddedWalletCurrentAction) => Promise<void>;
+    readonly shouldInitRecovery: () => Promise<boolean>;
+};