@dynamic-labs-sdk/react-hooks 1.8.2 → 1.10.0

package/dist/index.cjs

@@ -7,7 +7,7 @@ let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
 
 //#region package.json
 var name = "@dynamic-labs-sdk/react-hooks";
-var version = "1.8.2";
+var version = "1.10.0";
 
 //#endregion
 //#region src/modules/DynamicContext/DynamicContext.ts
@@ -86,7 +86,7 @@ const useBaseMutation = ({ mutationFn, mutateParams }) => {
 };
 
 //#endregion
-//#region src/hooks/useAcknowledgeRecoveryCodes/useAcknowledgeRecoveryCodes.ts
+//#region src/hooks/wrappers/functions/useAcknowledgeRecoveryCodes/useAcknowledgeRecoveryCodes.ts
 /**
 * Marks the current user's MFA recovery codes as acknowledged. Takes no arguments — call `mutate()` after the user confirms they have stored the codes shown by {@link useMfaRecoveryCodes}.
 *
@@ -138,7 +138,7 @@ const useBaseQuery = ({ queryFn, queryKey, queryParams, enabled = true }) => {
 };
 
 //#endregion
-//#region src/hooks/useActiveNetworkData/useActiveNetworkData.ts
+//#region src/hooks/wrappers/functions/useActiveNetworkData/useActiveNetworkData.ts
 /**
 * Wraps `getActiveNetworkData` from `@dynamic-labs-sdk/client`. Returns the network the given wallet account is currently on.
 *
@@ -154,7 +154,7 @@ const useActiveNetworkData = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useAddNetwork/useAddNetwork.ts
+//#region src/hooks/wrappers/functions/useAddNetwork/useAddNetwork.ts
 /**
 * Wraps `addNetwork` from `@dynamic-labs-sdk/client`. Call `mutate({ networkData, walletAccount })` to register a custom network on the given wallet account.
 *
@@ -175,7 +175,29 @@ const useAddNetwork = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useAuthenticateMfaRecoveryCode/useAuthenticateMfaRecoveryCode.ts
+//#region src/hooks/wrappers/functions/useAttachFlowSource/useAttachFlowSource.ts
+/**
+* Attaches a payment source to a flow.
+*
+* Wraps `attachFlowSource` from `@dynamic-labs-sdk/client`. Call `mutate({ flowId, sourceType, fromAddress, fromChainId, fromChainName })`
+* to attach a payment source to a flow; the resolved `data` is an object containing
+* the flow and the session token.
+*
+* @example
+* ```tsx
+* const { mutate: attachFlowSource, isPending } = useAttachFlowSource();
+* <button onClick={() => attachFlowSource({ flowId, sourceType, fromAddress, fromChainId, fromChainName })} disabled={isPending}>
+*   Attach flow source
+* </button>
+* ```
+*/
+const useAttachFlowSource = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.attachFlowSource)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useAuthenticateMfaRecoveryCode/useAuthenticateMfaRecoveryCode.ts
 /**
 * Authenticates the current user with one of their MFA recovery codes.
 *
@@ -202,7 +224,7 @@ const useAuthenticateMfaRecoveryCode = ({ mutateParams } = {}) => useBaseMutatio
 });
 
 //#endregion
-//#region src/hooks/useAuthenticatePasskeyMfa/useAuthenticatePasskeyMfa.ts
+//#region src/hooks/wrappers/functions/useAuthenticatePasskeyMfa/useAuthenticatePasskeyMfa.ts
 /**
 * Completes an MFA challenge using the current user's passkey.
 *
@@ -225,7 +247,7 @@ const useAuthenticatePasskeyMfa = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useAuthenticateTotpMfaDevice/useAuthenticateTotpMfaDevice.ts
+//#region src/hooks/wrappers/functions/useAuthenticateTotpMfaDevice/useAuthenticateTotpMfaDevice.ts
 /**
 * Authenticates the current user with a TOTP code from an authenticator app.
 *
@@ -356,7 +378,7 @@ const useBaseState = ({ event, queryKey, queryParams, selector, defaultValue, sk
 };
 
 //#endregion
-//#region src/hooks/useAvailableWalletProvidersData/useAvailableWalletProvidersData.ts
+//#region src/hooks/wrappers/functions/useAvailableWalletProvidersData/useAvailableWalletProvidersData.ts
 /**
 * Returns the available wallet providers and their data.
 *
@@ -370,7 +392,7 @@ const useAvailableWalletProvidersData = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useBalanceForAddress/useBalanceForAddress.ts
+//#region src/hooks/wrappers/functions/useBalanceForAddress/useBalanceForAddress.ts
 /**
 * Wraps `getBalanceForAddress` from `@dynamic-labs-sdk/client`. Returns the native-token balance for an arbitrary address on the given chain/network.
 *
@@ -386,7 +408,7 @@ const useBalanceForAddress = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useCheckStepUpAuth/useCheckStepUpAuth.ts
+//#region src/hooks/wrappers/functions/useCheckStepUpAuth/useCheckStepUpAuth.ts
 /**
 * Checks whether step-up authentication is required for a given scope and
 * returns the credentials available to satisfy it.
@@ -410,7 +432,7 @@ const useCheckStepUpAuth = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useCoinbaseBuyUrl/useCoinbaseBuyUrl.ts
+//#region src/hooks/wrappers/functions/useCoinbaseBuyUrl/useCoinbaseBuyUrl.ts
 /**
 * Wraps `getCoinbaseBuyUrl` from `@dynamic-labs-sdk/client`. Returns a Coinbase onramp buy URL for the given parameters.
 *
@@ -426,7 +448,7 @@ const useCoinbaseBuyUrl = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useCoinbaseOnrampOrderEventListener/useCoinbaseOnrampOrderEventListener.ts
+//#region src/hooks/wrappers/functions/useCoinbaseOnrampOrderEventListener/useCoinbaseOnrampOrderEventListener.ts
 /**
 * Subscribes to Coinbase onramp order events for the duration of the component.
 *
@@ -451,7 +473,7 @@ const useCoinbaseOnrampOrderEventListener = ({ listener }) => {
 };
 
 //#endregion
-//#region src/hooks/useCompleteDeviceRegistration/useCompleteDeviceRegistration.ts
+//#region src/hooks/wrappers/functions/useCompleteDeviceRegistration/useCompleteDeviceRegistration.ts
 /**
 * Wraps `completeDeviceRegistration` from `@dynamic-labs-sdk/client`. Call `mutate({ deviceToken })` with the device token parsed from the redirect URL; the resolved `data` is a `VerifyResponse`.
 *
@@ -468,7 +490,7 @@ const useCompleteDeviceRegistration = ({ mutateParams } = {}) => useBaseMutation
 });
 
 //#endregion
-//#region src/hooks/useCompleteSocialRedirect/useCompleteSocialRedirect.ts
+//#region src/hooks/wrappers/functions/useCompleteSocialRedirect/useCompleteSocialRedirect.ts
 /**
 * Wraps `completeSocialRedirect` from `@dynamic-labs-sdk/client`. Call `mutate(params)` with the OAuth callback URL once the provider has redirected back to finish the sign-in; the resolved `data` is the signed-in `User` (or `null`).
 *
@@ -485,7 +507,7 @@ const useCompleteSocialRedirect = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useConfirmTransaction/useConfirmTransaction.ts
+//#region src/hooks/wrappers/functions/useConfirmTransaction/useConfirmTransaction.ts
 /**
 * Wraps `confirmTransaction` from `@dynamic-labs-sdk/client`. Call `mutate({ walletAccount, transactionHash })` to await confirmation of a submitted transaction; the resolved `data` is `void`.
 *
@@ -501,7 +523,7 @@ const useConfirmTransaction = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useConnectAndVerifyWithWalletProvider/useConnectAndVerifyWithWalletProvider.ts
+//#region src/hooks/wrappers/functions/useConnectAndVerifyWithWalletProvider/useConnectAndVerifyWithWalletProvider.ts
 /**
 * Connects to a wallet provider and verifies ownership in a single step.
 *
@@ -531,7 +553,7 @@ const useConnectAndVerifyWithWalletProvider = ({ mutateParams } = {}) => useBase
 });
 
 //#endregion
-//#region src/hooks/useConnectWithWalletProvider/useConnectWithWalletProvider.ts
+//#region src/hooks/wrappers/functions/useConnectWithWalletProvider/useConnectWithWalletProvider.ts
 /**
 * Connects to a wallet provider and returns the connected wallet account.
 *
@@ -558,7 +580,7 @@ const useConnectWithWalletProvider = ({ mutateParams } = {}) => useBaseMutation(
 });
 
 //#endregion
-//#region src/hooks/useConsumeMfaToken/useConsumeMfaToken.ts
+//#region src/hooks/wrappers/functions/useConsumeMfaToken/useConsumeMfaToken.ts
 /**
 * Consumes and clears the current MFA token from client state.
 *
@@ -579,7 +601,7 @@ const useConsumeMfaToken = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useCreateCoinbaseOnrampOrder/useCreateCoinbaseOnrampOrder.ts
+//#region src/hooks/wrappers/functions/useCreateCoinbaseOnrampOrder/useCreateCoinbaseOnrampOrder.ts
 /**
 * Wraps `createCoinbaseOnrampOrder` from `@dynamic-labs-sdk/client`. Call `mutate(orderParams)` to create a Coinbase onramp order; the resolved `data` is the order response.
 *
@@ -595,7 +617,7 @@ const useCreateCoinbaseOnrampOrder = ({ mutateParams } = {}) => useBaseMutation(
 });
 
 //#endregion
-//#region src/hooks/useCreateCryptoDotComPayment/useCreateCryptoDotComPayment.ts
+//#region src/hooks/wrappers/functions/useCreateCryptoDotComPayment/useCreateCryptoDotComPayment.ts
 /**
 * Wraps `createCryptoDotComPayment` from `@dynamic-labs-sdk/client`. Call `mutate(paymentParams)` to create a Crypto.com Pay payment; the resolved `data` is the payment response.
 *
@@ -612,7 +634,7 @@ const useCreateCryptoDotComPayment = ({ mutateParams } = {}) => useBaseMutation(
 });
 
 //#endregion
-//#region src/hooks/useCreateNewMfaRecoveryCodes/useCreateNewMfaRecoveryCodes.ts
+//#region src/hooks/wrappers/functions/useCreateNewMfaRecoveryCodes/useCreateNewMfaRecoveryCodes.ts
 /**
 * Regenerates the current user's MFA recovery codes.
 *
@@ -635,7 +657,7 @@ const useCreateNewMfaRecoveryCodes = ({ mutateParams } = {}) => useBaseMutation(
 });
 
 //#endregion
-//#region src/hooks/useDeleteMfaDevice/useDeleteMfaDevice.ts
+//#region src/hooks/wrappers/functions/useDeleteMfaDevice/useDeleteMfaDevice.ts
 /**
 * Deletes one of the current user's MFA devices.
 *
@@ -657,7 +679,7 @@ const useDeleteMfaDevice = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useDeletePasskey/useDeletePasskey.ts
+//#region src/hooks/wrappers/functions/useDeletePasskey/useDeletePasskey.ts
 /**
 * Deletes one of the current user's passkeys.
 *
@@ -679,7 +701,7 @@ const useDeletePasskey = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useDeleteUser/useDeleteUser.ts
+//#region src/hooks/wrappers/functions/useDeleteUser/useDeleteUser.ts
 /**
 * Permanently deletes the current user's account and logs them out.
 *
@@ -701,7 +723,7 @@ const useDeleteUser = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useEvent/useEvent.ts
+//#region src/hooks/wrappers/functions/useEvent/useEvent.ts
 /**
 * Subscribes to a Dynamic client event.
 *
@@ -721,7 +743,7 @@ const useEvent = ({ event, listener }) => {
 };
 
 //#endregion
-//#region src/hooks/useExecuteSwapTransaction/useExecuteSwapTransaction.ts
+//#region src/hooks/wrappers/functions/useExecuteSwapTransaction/useExecuteSwapTransaction.ts
 /**
 * Wraps `executeSwapTransaction` from `@dynamic-labs-sdk/client`. Call `mutate({ walletAccount, signingPayload })` (using a payload from {@link useSwapQuote}) to execute a swap; the resolved `data` is `{ transactionHash }`.
 *
@@ -737,66 +759,84 @@ const useExecuteSwapTransaction = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useGoogleDriveBackupReadiness/useGoogleDriveBackupReadiness.ts
+//#region src/hooks/wrappers/functions/useGetFlow/useGetFlow.ts
 /**
-* Wraps `getGoogleDriveBackupReadiness` from `@dynamic-labs-sdk/client`. Reports whether the user's Google Drive backup is set up and available.
+* Returns the flow with the given ID.
+*
+* Wraps `getFlow` from `@dynamic-labs-sdk/client`.
 *
 * @example
 * ```tsx
-* const { data: readiness, isLoading } = useGoogleDriveBackupReadiness();
+* const { data: flow, isLoading, refetch } = useGetFlow({ flowId });
 * ```
 */
-const useGoogleDriveBackupReadiness = ({ queryParams } = {}) => useBaseQuery({
-	queryFn: (client) => (0, _dynamic_labs_sdk_client.getGoogleDriveBackupReadiness)(client),
-	queryKey: ["useGoogleDriveBackupReadiness"],
+const useGetFlow = ({ flowId, queryParams }) => useBaseQuery({
+	enabled: flowId !== void 0,
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getFlow)({ flowId }, client),
+	queryKey: ["useGetFlow", flowId],
 	queryParams
 });
 
 //#endregion
-//#region src/hooks/useInitStatus/useInitStatus.ts
+//#region src/hooks/wrappers/functions/useGetFlowQuote/useGetFlowQuote.ts
 /**
-* Returns the current initialization status of the Dynamic client, plus the
-* error that caused initialization to fail (when it did).
+* Fetches a quote for a flow.
 *
-* Exposes only `data` (the reactive init status), `error` and `isError` —
-* see {@link UseInitStatusResult}. Possible `data` values: `'uninitialized'`,
-* `'in-progress'`, `'finished'`, `'failed'`. When `data === 'failed'`, `error`
-* carries the failure reason.
+* Wraps `getFlowQuote` from `@dynamic-labs-sdk/client`. Call `mutate({ flowId, fromTokenAddress, slippage })`
+* to fetch a quote for a flow.
 *
 * @example
 * ```tsx
-* const { data: status, error } = useInitStatus();
-* if (status === 'failed') return <InitErrorScreen message={error?.message} />;
-* if (status !== 'finished') return <LoadingScreen />;
-* return <App />;
+* const { mutate: getFlowQuote, isPending } = useGetFlowQuote();
+* <button onClick={() => getFlowQuote({ flowId, fromTokenAddress, slippage })} disabled={isPending}>
+*   Get flow quote
+* </button>
 * ```
+*/
+const useGetFlowQuote = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.getFlowQuote)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/usePrepareFlowSigning/usePrepareFlowSigning.ts
+/**
+* Prepares a flow transaction for signing.
 *
-* @not-instrumented
+* Wraps `prepareFlowSigning` from `@dynamic-labs-sdk/client`. Call `mutate({ flowId })`
+* to prepare a flow for signing.
+*
+* @example
+* ```tsx
+* const { mutate: prepareFlowSigning, isPending } = usePrepareFlowSigning();
+* <button onClick={() => prepareFlowSigning({ flowId })} disabled={isPending}>
+*   Prepare flow signing
+* </button>
+* ```
 */
-const useInitStatus = () => {
-	const { data } = useBaseState({
-		defaultValue: {
-			error: null,
-			status: "uninitialized"
-		},
-		event: "initStatusChanged",
-		queryKey: ["useInitStatus"],
-		selector: (client) => ({
-			error: client.initError,
-			status: client.initStatus
-		}),
-		skipWaitForInit: true
-	});
-	const error = data?.error ?? null;
-	return {
-		data: data?.status,
-		error,
-		isError: error !== null
-	};
-};
+const usePrepareFlowSigning = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.prepareFlowSigning)(variables, client)
+});
 
 //#endregion
-//#region src/hooks/useIsCaptchaRequired/useIsCaptchaRequired.ts
+//#region src/hooks/wrappers/functions/useGoogleDriveBackupReadiness/useGoogleDriveBackupReadiness.ts
+/**
+* Wraps `getGoogleDriveBackupReadiness` from `@dynamic-labs-sdk/client`. Reports whether the user's Google Drive backup is set up and available.
+*
+* @example
+* ```tsx
+* const { data: readiness, isLoading } = useGoogleDriveBackupReadiness();
+* ```
+*/
+const useGoogleDriveBackupReadiness = ({ queryParams } = {}) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.getGoogleDriveBackupReadiness)(client),
+	queryKey: ["useGoogleDriveBackupReadiness"],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useIsCaptchaRequired/useIsCaptchaRequired.ts
 /**
 * Returns whether hCaptcha is required by the current project settings.
 *
@@ -816,7 +856,7 @@ const useIsCaptchaRequired = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useIsUserMissingMfaAuth/useIsUserMissingMfaAuth.ts
+//#region src/hooks/wrappers/functions/useIsUserMissingMfaAuth/useIsUserMissingMfaAuth.ts
 /**
 * Returns whether the current user still needs to complete additional MFA
 * authentication (i.e. their session scope contains `requiresAdditionalAuth`).
@@ -836,7 +876,7 @@ const useIsUserMissingMfaAuth = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useIsUserOnboardingComplete/useIsUserOnboardingComplete.ts
+//#region src/hooks/wrappers/functions/useIsUserOnboardingComplete/useIsUserOnboardingComplete.ts
 /**
 * Returns whether the current user has completed onboarding (no missing KYC
 * fields, MFA enrollment, or pending recovery-code acknowledgement).
@@ -860,7 +900,7 @@ const useIsUserOnboardingComplete = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useKrakenAccounts/useKrakenAccounts.ts
+//#region src/hooks/wrappers/functions/useKrakenAccounts/useKrakenAccounts.ts
 /**
 * Wraps `getKrakenAccounts` from `@dynamic-labs-sdk/client`. Returns the authenticated user's Kraken accounts (with balances), optionally filtered by chain/network.
 *
@@ -876,7 +916,7 @@ const useKrakenAccounts = ({ queryParams, ...args } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useKrakenExchangeTransfer/useKrakenExchangeTransfer.ts
+//#region src/hooks/wrappers/functions/useKrakenExchangeTransfer/useKrakenExchangeTransfer.ts
 /**
 * Wraps `createKrakenExchangeTransfer` from `@dynamic-labs-sdk/client`. Call `mutate({ accountId, ... })` to send crypto from a Kraken account (see `useKrakenAccounts`) to a whitelisted address (see `useKrakenWhitelistedAddresses`); the resolved `data` is the created transfer.
 *
@@ -892,7 +932,7 @@ const useKrakenExchangeTransfer = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useKrakenWhitelistedAddresses/useKrakenWhitelistedAddresses.ts
+//#region src/hooks/wrappers/functions/useKrakenWhitelistedAddresses/useKrakenWhitelistedAddresses.ts
 /**
 * Wraps `getKrakenWhitelistedAddresses` from `@dynamic-labs-sdk/client`. Returns the destination addresses whitelisted for Kraken withdrawals.
 *
@@ -908,7 +948,7 @@ const useKrakenWhitelistedAddresses = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useLogout/useLogout.ts
+//#region src/hooks/wrappers/functions/useLogout/useLogout.ts
 /**
 * Logs the current user out.
 *
@@ -927,7 +967,7 @@ const useLogout = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useMfaDevices/useMfaDevices.ts
+//#region src/hooks/wrappers/functions/useMfaDevices/useMfaDevices.ts
 /**
 * Returns the multi-factor authentication devices registered for the
 * current user.
@@ -946,7 +986,7 @@ const useMfaDevices = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useMfaMethods/useMfaMethods.ts
+//#region src/hooks/wrappers/functions/useMfaMethods/useMfaMethods.ts
 /**
 * Returns the multi-factor authentication methods available to the current
 * user.
@@ -965,7 +1005,7 @@ const useMfaMethods = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useMfaRecoveryCodes/useMfaRecoveryCodes.ts
+//#region src/hooks/wrappers/functions/useMfaRecoveryCodes/useMfaRecoveryCodes.ts
 /**
 * Returns the current user's MFA recovery codes.
 *
@@ -983,7 +1023,7 @@ const useMfaRecoveryCodes = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useMoonPayCurrencies/useMoonPayCurrencies.ts
+//#region src/hooks/wrappers/functions/useMoonPayCurrencies/useMoonPayCurrencies.ts
 /**
 * Wraps `getMoonPayCurrencies` from `@dynamic-labs-sdk/client`. Returns the list of currencies MoonPay supports for the given parameters.
 *
@@ -999,7 +1039,7 @@ const useMoonPayCurrencies = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useMoonPayUrl/useMoonPayUrl.ts
+//#region src/hooks/wrappers/functions/useMoonPayUrl/useMoonPayUrl.ts
 /**
 * Wraps `getMoonPayUrl` from `@dynamic-labs-sdk/client`. Returns a MoonPay widget URL for the given parameters.
 *
@@ -1015,7 +1055,7 @@ const useMoonPayUrl = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useMultichainTokenBalances/useMultichainTokenBalances.ts
+//#region src/hooks/wrappers/functions/useMultichainTokenBalances/useMultichainTokenBalances.ts
 /**
 * Returns token balances across multiple chains, networks, and addresses
 * in a single batched API request.
@@ -1040,7 +1080,7 @@ const useMultichainTokenBalances = ({ balanceRequest, queryParams }) => useBaseQ
 });
 
 //#endregion
-//#region src/hooks/useNativeBalance/useNativeBalance.ts
+//#region src/hooks/wrappers/functions/useNativeBalance/useNativeBalance.ts
 /**
 * Returns the native token balance for a wallet account.
 *
@@ -1060,7 +1100,7 @@ const useNativeBalance = ({ walletAccount, queryParams }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useNetworksData/useNetworksData.ts
+//#region src/hooks/wrappers/functions/useNetworksData/useNetworksData.ts
 /**
 * Returns the network configurations for all networks enabled in the Dynamic project.
 *
@@ -1074,7 +1114,7 @@ const useNetworksData = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useOnceEvent/useOnceEvent.ts
+//#region src/hooks/wrappers/functions/useOnceEvent/useOnceEvent.ts
 /**
 * Subscribes to a Dynamic client event for a single occurrence.
 *
@@ -1103,7 +1143,7 @@ const useOnceEvent = ({ event, listener }) => {
 };
 
 //#endregion
-//#region src/hooks/usePasskeys/usePasskeys.ts
+//#region src/hooks/wrappers/functions/usePasskeys/usePasskeys.ts
 /**
 * Returns the passkeys registered for the current user.
 *
@@ -1121,7 +1161,7 @@ const usePasskeys = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useProveWalletAccountOwnership/useProveWalletAccountOwnership.ts
+//#region src/hooks/wrappers/functions/useProveWalletAccountOwnership/useProveWalletAccountOwnership.ts
 /**
 * Wraps `proveWalletAccountOwnership` from `@dynamic-labs-sdk/client`. Call `mutate({ walletAccount })` to prove ownership of a connected wallet account by signing a challenge.
 *
@@ -1138,7 +1178,7 @@ const useProveWalletAccountOwnership = ({ mutateParams } = {}) => useBaseMutatio
 });
 
 //#endregion
-//#region src/hooks/useRefreshAuth/useRefreshAuth.ts
+//#region src/hooks/wrappers/functions/useRefreshAuth/useRefreshAuth.ts
 /**
 * Wraps `refreshAuth` from `@dynamic-labs-sdk/client`. Takes no arguments — call `mutate()` to refresh the session/JWT; the resolved `data` is a `VerifyResponse`.
 *
@@ -1156,7 +1196,7 @@ const useRefreshAuth = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useRegisteredDevices/useRegisteredDevices.ts
+//#region src/hooks/wrappers/functions/useRegisteredDevices/useRegisteredDevices.ts
 /**
 * Returns the devices registered for the current user.
 *
@@ -1176,7 +1216,7 @@ const useRegisteredDevices = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useRegisterPasskey/useRegisterPasskey.ts
+//#region src/hooks/wrappers/functions/useRegisterPasskey/useRegisterPasskey.ts
 /**
 * Registers a new passkey for the current user.
 *
@@ -1198,7 +1238,7 @@ const useRegisterPasskey = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useRegisterTotpMfaDevice/useRegisterTotpMfaDevice.ts
+//#region src/hooks/wrappers/functions/useRegisterTotpMfaDevice/useRegisterTotpMfaDevice.ts
 /**
 * Registers a new TOTP MFA device for the current user.
 *
@@ -1220,7 +1260,7 @@ const useRegisterTotpMfaDevice = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useRemoveWalletAccount/useRemoveWalletAccount.ts
+//#region src/hooks/wrappers/functions/useRemoveWalletAccount/useRemoveWalletAccount.ts
 /**
 * Removes a wallet account from the current user.
 *
@@ -1245,7 +1285,7 @@ const useRemoveWalletAccount = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useRequestExternalAuthElevatedToken/useRequestExternalAuthElevatedToken.ts
+//#region src/hooks/wrappers/functions/useRequestExternalAuthElevatedToken/useRequestExternalAuthElevatedToken.ts
 /**
 * Wraps `requestExternalAuthElevatedToken` from `@dynamic-labs-sdk/client`. Call `mutate({ externalJwt })` to exchange an externally issued JWT for an elevated-access token.
 *
@@ -1262,7 +1302,7 @@ const useRequestExternalAuthElevatedToken = ({ mutateParams } = {}) => useBaseMu
 });
 
 //#endregion
-//#region src/hooks/useRevokeAllRegisteredDevices/useRevokeAllRegisteredDevices.ts
+//#region src/hooks/wrappers/functions/useRevokeAllRegisteredDevices/useRevokeAllRegisteredDevices.ts
 /**
 * Wraps `revokeAllRegisteredDevices` from `@dynamic-labs-sdk/client`. Takes no arguments — call `mutate()` to revoke every device registered to the current user; the resolved `data` is `void`.
 *
@@ -1281,7 +1321,7 @@ const useRevokeAllRegisteredDevices = ({ mutateParams } = {}) => useBaseMutation
 });
 
 //#endregion
-//#region src/hooks/useRevokeRegisteredDevice/useRevokeRegisteredDevice.ts
+//#region src/hooks/wrappers/functions/useRevokeRegisteredDevice/useRevokeRegisteredDevice.ts
 /**
 * Revokes a previously registered device.
 *
@@ -1307,7 +1347,7 @@ const useRevokeRegisteredDevice = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSendEmailOtp/useSendEmailOtp.ts
+//#region src/hooks/wrappers/functions/useSendEmailOtp/useSendEmailOtp.ts
 /**
 * Sends a one-time password to an email address.
 *
@@ -1334,7 +1374,7 @@ const useSendEmailOtp = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSendSmsOtp/useSendSmsOtp.ts
+//#region src/hooks/wrappers/functions/useSendSmsOtp/useSendSmsOtp.ts
 /**
 * Sends a one-time password to a phone number via SMS.
 *
@@ -1363,21 +1403,7 @@ const useSendSmsOtp = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSessionExpiresAt/useSessionExpiresAt.ts
-/**
-* Returns the session expiration date, or null if no active session.
-*
-* Re-renders when the user changes (which includes session updates).
-*/
-const useSessionExpiresAt = () => useBaseState({
-	defaultValue: null,
-	event: "userChanged",
-	queryKey: ["useSessionExpiresAt"],
-	selector: (client) => client.sessionExpiresAt
-});
-
-//#endregion
-//#region src/hooks/useSetDefaultMfaDevice/useSetDefaultMfaDevice.ts
+//#region src/hooks/wrappers/functions/useSetDefaultMfaDevice/useSetDefaultMfaDevice.ts
 /**
 * Sets the current user's default MFA device.
 *
@@ -1398,7 +1424,7 @@ const useSetDefaultMfaDevice = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSignInWithExternalJwt/useSignInWithExternalJwt.ts
+//#region src/hooks/wrappers/functions/useSignInWithExternalJwt/useSignInWithExternalJwt.ts
 /**
 * Wraps `signInWithExternalJwt` from `@dynamic-labs-sdk/client`. Call `mutate({ externalJwt })` to authenticate the user with a JWT issued by an external auth provider.
 *
@@ -1414,7 +1440,7 @@ const useSignInWithExternalJwt = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSignInWithPasskey/useSignInWithPasskey.ts
+//#region src/hooks/wrappers/functions/useSignInWithPasskey/useSignInWithPasskey.ts
 /**
 * Signs the user in with a previously registered passkey.
 *
@@ -1436,7 +1462,7 @@ const useSignInWithPasskey = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSignInWithSocialPopUp/useSignInWithSocialPopUp.ts
+//#region src/hooks/wrappers/functions/useSignInWithSocialPopUp/useSignInWithSocialPopUp.ts
 /**
 * Wraps `signInWithSocialPopUp` from `@dynamic-labs-sdk/client`. Call `mutate({ provider })` to open the provider's OAuth popup; the resolved `data` is the signed-in `User` (or `null`).
 *
@@ -1453,7 +1479,7 @@ const useSignInWithSocialPopUp = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSignInWithSocialRedirect/useSignInWithSocialRedirect.ts
+//#region src/hooks/wrappers/functions/useSignInWithSocialRedirect/useSignInWithSocialRedirect.ts
 /**
 * Wraps `signInWithSocialRedirect` from `@dynamic-labs-sdk/client`. Call `mutate({ provider, redirectUrl })` to redirect the user to the provider's OAuth page; complete the flow with {@link useCompleteSocialAuthentication}.
 *
@@ -1469,7 +1495,7 @@ const useSignInWithSocialRedirect = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSignMessage/useSignMessage.ts
+//#region src/hooks/wrappers/functions/useSignMessage/useSignMessage.ts
 /**
 * Signs an arbitrary message with a wallet account.
 *
@@ -1494,7 +1520,7 @@ const useSignMessage = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSwapQuote/useSwapQuote.ts
+//#region src/hooks/wrappers/functions/useSwapQuote/useSwapQuote.ts
 /**
 * Wraps `getSwapQuote` from `@dynamic-labs-sdk/client`. Returns a swap quote (including the signing payload consumed by {@link useExecuteSwapTransaction}).
 *
@@ -1510,7 +1536,7 @@ const useSwapQuote = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useSwapStatus/useSwapStatus.ts
+//#region src/hooks/wrappers/functions/useSwapStatus/useSwapStatus.ts
 /**
 * Wraps `getSwapStatus` from `@dynamic-labs-sdk/client`. Returns the current status of a previously submitted swap.
 *
@@ -1526,7 +1552,7 @@ const useSwapStatus = ({ queryParams, ...args }) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useSwitchActiveNetwork/useSwitchActiveNetwork.ts
+//#region src/hooks/wrappers/functions/useSwitchActiveNetwork/useSwitchActiveNetwork.ts
 /**
 * Switches the active network for a wallet account.
 *
@@ -1552,7 +1578,7 @@ const useSwitchActiveNetwork = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useTokenBalances/useTokenBalances.ts
+//#region src/hooks/wrappers/functions/useTokenBalances/useTokenBalances.ts
 /**
 * Returns the ERC-20-style token balances for a wallet account on a single
 * chain.
@@ -1583,7 +1609,7 @@ const useTokenBalances = ({ walletAccount, queryParams, ...rest }) => useBaseQue
 });
 
 //#endregion
-//#region src/hooks/useTransactionHistory/useTransactionHistory.ts
+//#region src/hooks/wrappers/functions/useTransactionHistory/useTransactionHistory.ts
 /**
 * Returns the transaction history for a given wallet address, chain, and
 * network.
@@ -1622,7 +1648,7 @@ const useTransactionHistory = ({ address, chain, networkId, queryParams, ...rest
 });
 
 //#endregion
-//#region src/hooks/useTransferAmount/useTransferAmount.ts
+//#region src/hooks/wrappers/functions/useTransferAmount/useTransferAmount.ts
 /**
 * Wraps `transferAmount` from `@dynamic-labs-sdk/client`. Call `mutate({ walletAccount, amount, recipient, token })` to send tokens; the resolved `data` is `{ transactionHash }`.
 *
@@ -1638,7 +1664,7 @@ const useTransferAmount = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useTransferWalletAccount/useTransferWalletAccount.ts
+//#region src/hooks/wrappers/functions/useTransferWalletAccount/useTransferWalletAccount.ts
 /**
 * Wraps `transferWalletAccount` from `@dynamic-labs-sdk/client`. Call `mutate({ walletProviderKey })` to transfer (hand off) a wallet account to the given provider.
 *
@@ -1655,7 +1681,7 @@ const useTransferWalletAccount = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useUnlinkSocialAccount/useUnlinkSocialAccount.ts
+//#region src/hooks/wrappers/functions/useUnlinkSocialAccount/useUnlinkSocialAccount.ts
 /**
 * Unlinks a social account from the current user.
 *
@@ -1681,7 +1707,7 @@ const useUnlinkSocialAccount = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useUpdateUser/useUpdateUser.ts
+//#region src/hooks/wrappers/functions/useUpdateUser/useUpdateUser.ts
 /**
 * Updates the current user's profile information.
 *
@@ -1708,21 +1734,7 @@ const useUpdateUser = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useUser/useUser.ts
-/**
-* Returns the current authenticated user, or null if not authenticated.
-*
-* Re-renders when the user changes (login, logout, profile update).
-*/
-const useUser = () => useBaseState({
-	defaultValue: null,
-	event: "userChanged",
-	queryKey: ["useUser"],
-	selector: (client) => client.user
-});
-
-//#endregion
-//#region src/hooks/useUserSocialAccounts/useUserSocialAccounts.ts
+//#region src/hooks/wrappers/functions/useUserSocialAccounts/useUserSocialAccounts.ts
 /**
 * Returns the current user's linked social accounts.
 *
@@ -1736,7 +1748,7 @@ const useUserSocialAccounts = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useVerifyOtp/useVerifyOtp.ts
+//#region src/hooks/wrappers/functions/useVerifyOtp/useVerifyOtp.ts
 /**
 * Verifies a one-time password the user received via email or SMS.
 *
@@ -1764,7 +1776,7 @@ const useVerifyOtp = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useVerifyWalletAccount/useVerifyWalletAccount.ts
+//#region src/hooks/wrappers/functions/useVerifyWalletAccount/useVerifyWalletAccount.ts
 /**
 * Verifies ownership of a wallet account and adds it to the user's profile.
 *
@@ -1795,7 +1807,7 @@ const useVerifyWalletAccount = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useWalletAccounts/useWalletAccounts.ts
+//#region src/hooks/wrappers/functions/useWalletAccounts/useWalletAccounts.ts
 /**
 * Returns all wallet accounts connected to the current user.
 *
@@ -1812,7 +1824,7 @@ const useWalletAccounts = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useWalletConnectCatalog/useWalletConnectCatalog.ts
+//#region src/hooks/wrappers/functions/useWalletConnectCatalog/useWalletConnectCatalog.ts
 /**
 * Returns the WalletConnect catalog (groups and wallets) used for displaying
 * wallet information and building mobile wallet deeplinks.
@@ -1831,7 +1843,7 @@ const useWalletConnectCatalog = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useWalletOptionsCatalogue/useWalletOptionsCatalogue.ts
+//#region src/hooks/wrappers/functions/useWalletOptionsCatalogue/useWalletOptionsCatalogue.ts
 /**
 * Wraps `getWalletOptionsCatalogue` from `@dynamic-labs-sdk/client`. Returns the catalogue of wallet options the project supports.
 *
@@ -1847,7 +1859,7 @@ const useWalletOptionsCatalogue = ({ queryParams, ...args } = {}) => useBaseQuer
 });
 
 //#endregion
-//#region src/hooks/useWalletProviderEvent/useWalletProviderEvent.ts
+//#region src/hooks/wrappers/functions/useWalletProviderEvent/useWalletProviderEvent.ts
 /**
 * Subscribes to an event emitted by a specific wallet provider.
 *
@@ -1881,6 +1893,77 @@ const useWalletProviderEvent = ({ callback, event, walletProviderKey }) => {
 	]);
 };
 
+//#endregion
+//#region src/hooks/wrappers/state/useInitStatus/useInitStatus.ts
+/**
+* Returns the current initialization status of the Dynamic client, plus the
+* error that caused initialization to fail (when it did).
+*
+* Exposes only `data` (the reactive init status), `error` and `isError` —
+* see {@link UseInitStatusResult}. Possible `data` values: `'uninitialized'`,
+* `'in-progress'`, `'finished'`, `'failed'`. When `data === 'failed'`, `error`
+* carries the failure reason.
+*
+* @example
+* ```tsx
+* const { data: status, error } = useInitStatus();
+* if (status === 'failed') return <InitErrorScreen message={error?.message} />;
+* if (status !== 'finished') return <LoadingScreen />;
+* return <App />;
+* ```
+*
+* @not-instrumented
+*/
+const useInitStatus = () => {
+	const { data } = useBaseState({
+		defaultValue: {
+			error: null,
+			status: "uninitialized"
+		},
+		event: "initStatusChanged",
+		queryKey: ["useInitStatus"],
+		selector: (client) => ({
+			error: client.initError,
+			status: client.initStatus
+		}),
+		skipWaitForInit: true
+	});
+	const error = data?.error ?? null;
+	return {
+		data: data?.status,
+		error,
+		isError: error !== null
+	};
+};
+
+//#endregion
+//#region src/hooks/wrappers/state/useSessionExpiresAt/useSessionExpiresAt.ts
+/**
+* Returns the session expiration date, or null if no active session.
+*
+* Re-renders when the user changes (which includes session updates).
+*/
+const useSessionExpiresAt = () => useBaseState({
+	defaultValue: null,
+	event: "userChanged",
+	queryKey: ["useSessionExpiresAt"],
+	selector: (client) => client.sessionExpiresAt
+});
+
+//#endregion
+//#region src/hooks/wrappers/state/useUser/useUser.ts
+/**
+* Returns the current authenticated user, or null if not authenticated.
+*
+* Re-renders when the user changes (login, logout, profile update).
+*/
+const useUser = () => useBaseState({
+	defaultValue: null,
+	event: "userChanged",
+	queryKey: ["useUser"],
+	selector: (client) => client.user
+});
+
 //#endregion
 //#region src/exports/index.ts
 (0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(name, version);
@@ -1890,6 +1973,7 @@ exports.DynamicProvider = DynamicProvider;
 exports.useAcknowledgeRecoveryCodes = useAcknowledgeRecoveryCodes;
 exports.useActiveNetworkData = useActiveNetworkData;
 exports.useAddNetwork = useAddNetwork;
+exports.useAttachFlowSource = useAttachFlowSource;
 exports.useAuthenticateMfaRecoveryCode = useAuthenticateMfaRecoveryCode;
 exports.useAuthenticatePasskeyMfa = useAuthenticatePasskeyMfa;
 exports.useAuthenticateTotpMfaDevice = useAuthenticateTotpMfaDevice;
@@ -1913,6 +1997,8 @@ exports.useDeleteUser = useDeleteUser;
 exports.useDynamicClient = useDynamicClient;
 exports.useEvent = useEvent;
 exports.useExecuteSwapTransaction = useExecuteSwapTransaction;
+exports.useGetFlow = useGetFlow;
+exports.useGetFlowQuote = useGetFlowQuote;
 exports.useGoogleDriveBackupReadiness = useGoogleDriveBackupReadiness;
 exports.useInitStatus = useInitStatus;
 exports.useIsCaptchaRequired = useIsCaptchaRequired;
@@ -1932,6 +2018,7 @@ exports.useNativeBalance = useNativeBalance;
 exports.useNetworksData = useNetworksData;
 exports.useOnceEvent = useOnceEvent;
 exports.usePasskeys = usePasskeys;
+exports.usePrepareFlowSigning = usePrepareFlowSigning;
 exports.useProveWalletAccountOwnership = useProveWalletAccountOwnership;
 exports.useRefreshAuth = useRefreshAuth;
 exports.useRegisterPasskey = useRegisterPasskey;