@dynamic-labs-sdk/react-hooks 1.8.1 → 1.9.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.1";
+var version = "1.9.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,7 @@ const useAddNetwork = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useAuthenticateMfaRecoveryCode/useAuthenticateMfaRecoveryCode.ts
+//#region src/hooks/wrappers/functions/useAuthenticateMfaRecoveryCode/useAuthenticateMfaRecoveryCode.ts
 /**
 * Authenticates the current user with one of their MFA recovery codes.
 *
@@ -202,7 +202,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 +225,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 +356,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 +370,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 +386,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 +410,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 +426,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 +451,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 +468,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 +485,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 +501,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 +531,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 +558,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 +579,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 +595,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 +612,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 +635,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 +657,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 +679,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 +701,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 +721,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,7 +737,7 @@ const useExecuteSwapTransaction = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useGoogleDriveBackupReadiness/useGoogleDriveBackupReadiness.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.
 *
@@ -753,22 +753,50 @@ const useGoogleDriveBackupReadiness = ({ queryParams } = {}) => useBaseQuery({
 });
 
 //#endregion
-//#region src/hooks/useInitStatus/useInitStatus.ts
+//#region src/hooks/wrappers/state/useInitStatus/useInitStatus.ts
 /**
-* Returns the current initialization status of the Dynamic client.
+* Returns the current initialization status of the Dynamic client, plus the
+* error that caused initialization to fail (when it did).
 *
-* Possible values: 'uninitialized', 'in-progress', 'finished', 'failed'.
+* 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 = () => useBaseState({
-	defaultValue: "uninitialized",
-	event: "initStatusChanged",
-	queryKey: ["useInitStatus"],
-	selector: (client) => client.initStatus,
-	skipWaitForInit: true
-});
+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/useIsCaptchaRequired/useIsCaptchaRequired.ts
+//#region src/hooks/wrappers/functions/useIsCaptchaRequired/useIsCaptchaRequired.ts
 /**
 * Returns whether hCaptcha is required by the current project settings.
 *
@@ -788,7 +816,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`).
@@ -808,7 +836,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).
@@ -832,7 +860,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.
 *
@@ -848,7 +876,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.
 *
@@ -864,7 +892,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.
 *
@@ -880,7 +908,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.
 *
@@ -899,7 +927,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.
@@ -918,7 +946,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.
@@ -937,7 +965,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.
 *
@@ -955,7 +983,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.
 *
@@ -971,7 +999,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.
 *
@@ -987,7 +1015,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.
@@ -1012,7 +1040,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.
 *
@@ -1032,7 +1060,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.
 *
@@ -1046,7 +1074,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.
 *
@@ -1075,7 +1103,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.
 *
@@ -1093,7 +1121,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.
 *
@@ -1110,7 +1138,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`.
 *
@@ -1128,7 +1156,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.
 *
@@ -1148,7 +1176,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.
 *
@@ -1170,7 +1198,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.
 *
@@ -1192,7 +1220,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.
 *
@@ -1217,7 +1245,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.
 *
@@ -1234,7 +1262,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`.
 *
@@ -1253,7 +1281,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.
 *
@@ -1279,7 +1307,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.
 *
@@ -1306,7 +1334,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.
 *
@@ -1335,7 +1363,7 @@ const useSendSmsOtp = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useSessionExpiresAt/useSessionExpiresAt.ts
+//#region src/hooks/wrappers/state/useSessionExpiresAt/useSessionExpiresAt.ts
 /**
 * Returns the session expiration date, or null if no active session.
 *
@@ -1349,7 +1377,7 @@ const useSessionExpiresAt = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useSetDefaultMfaDevice/useSetDefaultMfaDevice.ts
+//#region src/hooks/wrappers/functions/useSetDefaultMfaDevice/useSetDefaultMfaDevice.ts
 /**
 * Sets the current user's default MFA device.
 *
@@ -1370,7 +1398,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.
 *
@@ -1386,7 +1414,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.
 *
@@ -1408,7 +1436,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`).
 *
@@ -1425,7 +1453,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}.
 *
@@ -1441,7 +1469,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.
 *
@@ -1466,7 +1494,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}).
 *
@@ -1482,7 +1510,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.
 *
@@ -1498,7 +1526,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.
 *
@@ -1524,7 +1552,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.
@@ -1555,7 +1583,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.
@@ -1594,7 +1622,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 }`.
 *
@@ -1610,7 +1638,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.
 *
@@ -1627,7 +1655,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.
 *
@@ -1653,7 +1681,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.
 *
@@ -1680,7 +1708,7 @@ const useUpdateUser = ({ mutateParams } = {}) => useBaseMutation({
 });
 
 //#endregion
-//#region src/hooks/useUser/useUser.ts
+//#region src/hooks/wrappers/state/useUser/useUser.ts
 /**
 * Returns the current authenticated user, or null if not authenticated.
 *
@@ -1694,7 +1722,7 @@ const useUser = () => useBaseState({
 });
 
 //#endregion
-//#region src/hooks/useUserSocialAccounts/useUserSocialAccounts.ts
+//#region src/hooks/wrappers/functions/useUserSocialAccounts/useUserSocialAccounts.ts
 /**
 * Returns the current user's linked social accounts.
 *
@@ -1708,7 +1736,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.
 *
@@ -1736,7 +1764,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.
 *
@@ -1767,7 +1795,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.
 *
@@ -1784,7 +1812,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.
@@ -1803,7 +1831,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.
 *
@@ -1819,7 +1847,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.
 *