@dynamic-labs-sdk/react-hooks 1.17.1 → 1.18.0

package/dist/index.esm.js

@@ -1,5 +1,5 @@
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
-import { BaseError, acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, addNetwork, assertWalletAccountSigningAvailability, attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, broadcastFlow, cancelFlow, checkStepUpAuth, completeDeviceRegistration, completeSocialRedirect, confirmTransaction, connectAndVerifyWithWalletProvider, connectWithWalletProvider, createCoinbaseOnrampOrder, createCryptoDotComPayment, createKrakenExchangeTransfer, createNewMfaRecoveryCodes, deleteMfaDevice, deletePasskey, deleteUser, executeSwapTransaction, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalanceForAddress, getCoinbaseBuyUrl, getConnectedAddresses, getFlow, getFlowQuote, getGoogleDriveBackupReadiness, getKrakenAccounts, getKrakenWhitelistedAddresses, getMfaDevices, getMfaMethods, getMfaRecoveryCodes, getMoonPayCurrencies, getMoonPayUrl, getMultichainTokenBalances, getNativeBalance, getPasskeys, getRegisteredDevices, getSwapQuote, getSwapStatus, getTokenBalances, getTransactionHistory, getUserSocialAccounts, getWalletAccounts, getWalletConnectCatalog, getWalletConnectCatalogWalletByWalletProviderKey, getWalletOptionsCatalogue, isMfaRequiredForAction, logout, onEvent, onWalletProviderEvent, onceEvent, prepareFlowSigning, proveWalletAccountOwnership, refreshAuth, registerPasskey, registerTotpMfaDevice, removeWalletAccount, requestExternalAuthElevatedToken, revokeAllRegisteredDevices, revokeRegisteredDevice, sendEmailOTP, sendSmsOTP, setDefaultMfaDevice, signInWithExternalJwt, signInWithPasskey, signInWithSocialPopUp, signInWithSocialRedirect, signMessage, submitFlowTransaction, switchActiveNetwork, transferAmount, transferWalletAccount, unlinkSocialAccount, updateUser, verifyOTP, verifyWalletAccount, waitForClientInitialized } from "@dynamic-labs-sdk/client";
+import { BaseError, acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, addNetwork, assertWalletAccountSigningAvailability, attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, broadcastFlow, cancelFlow, checkStepUpAuth, completeDeviceRegistration, completeSocialRedirect, confirmTransaction, connectAndVerifyWithWalletProvider, connectWithWalletProvider, createCoinbaseOnrampOrder, createCryptoDotComPayment, createKrakenExchangeTransfer, createNewMfaRecoveryCodes, deleteMfaDevice, deletePasskey, deleteUser, executeSwapTransaction, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalanceForAddress, getCoinbaseBuyUrl, getConnectedAddresses, getFlow, getFlowQuote, getGoogleDriveBackupReadiness, getKrakenAccounts, getKrakenWhitelistedAddresses, getMfaDevices, getMfaMethods, getMfaRecoveryCodes, getMoonPayCurrencies, getMoonPayUrl, getMultichainTokenBalances, getNativeBalance, getPasskeys, getRegisteredDevices, getSwapQuote, getSwapStatus, getTokenBalances, getTransactionHistory, getUserSocialAccounts, getWalletAccounts, getWalletConnectCatalog, getWalletConnectCatalogWalletByWalletProviderKey, getWalletOptionsCatalogue, getWalletProviderDataByKey, isDeviceRegistrationRequired, isMfaRequiredForAction, isPendingRecoveryCodesAcknowledgment, isUserMissingMfaAuth, isUserOnboardingComplete, logout, onEvent, onWalletProviderEvent, onceEvent, prepareFlowSigning, proveWalletAccountOwnership, refreshAuth, registerPasskey, registerTotpMfaDevice, removeWalletAccount, requestExternalAuthElevatedToken, revokeAllRegisteredDevices, revokeRegisteredDevice, sendEmailOTP, sendSmsOTP, setDefaultMfaDevice, signInWithExternalJwt, signInWithPasskey, signInWithSocialPopUp, signInWithSocialRedirect, signMessage, submitFlowTransaction, switchActiveNetwork, transferAmount, transferWalletAccount, unlinkSocialAccount, updateUser, verifyOTP, verifyWalletAccount, waitForClientInitialized } from "@dynamic-labs-sdk/client";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { createContext, useContext, useEffect, useMemo, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
@@ -7,7 +7,7 @@ import { getCore } from "@dynamic-labs-sdk/client/core";
 
 //#region package.json
 var name = "@dynamic-labs-sdk/react-hooks";
-var version = "1.17.1";
+var version = "1.18.0";
 
 //#endregion
 //#region src/modules/DynamicContext/DynamicContext.ts
@@ -176,7 +176,10 @@ const useBaseQuery = ({ enabled = true, middlewares = EMPTY_MIDDLEWARES, queryFn
 * Wraps `onWalletProviderEvent` from `@dynamic-labs-sdk/client`. Uses a ref to
 * always call the latest callback without re-subscribing, and cleans up the
 * subscription on unmount or when `event` / `walletProviderKey` change. When
-* `walletProviderKey` is `undefined` the hook subscribes to nothing.
+* `walletProviderKey` is `undefined` the hook subscribes to nothing. When the
+* provider cannot be subscribed to (not registered on this client, or it does
+* not expose `events`), the hook logs and subscribes to nothing rather than
+* throwing — an effect throw would unmount the entire app.
 *
 * @example
 * ```tsx
@@ -193,13 +196,22 @@ const useOnWalletProviderEvent = ({ callback, event, walletProviderKey }) => {
 	callbackRef.current = callback;
 	useEffect(() => {
 		if (walletProviderKey === void 0) return;
-		return onWalletProviderEvent({
-			callback: ((...args) => {
-				callbackRef.current(...args);
-			}),
-			event,
-			walletProviderKey
-		}, client);
+		try {
+			return onWalletProviderEvent({
+				callback: ((...args) => {
+					callbackRef.current(...args);
+				}),
+				event,
+				walletProviderKey
+			}, client);
+		} catch (error) {
+			getCore(client).logger.debug("[useOnWalletProviderEvent] failed to subscribe to wallet provider event", {
+				error,
+				event,
+				walletProviderKey
+			});
+			return;
+		}
 	}, [
 		event,
 		walletProviderKey,
@@ -2090,13 +2102,15 @@ const useUpdateUser = ({ mutateParams } = {}) => useBaseMutation({
 /**
 * Returns the current user's linked social accounts.
 *
-* Re-renders when the user changes.
+* Re-renders when the user changes. Resolves to an empty list while no user is
+* authenticated — the guard is required because the selector runs synchronously
+* and `getUserSocialAccounts` throws (`assertDefined`) when there is no user.
 */
 const useGetUserSocialAccounts = () => useBaseState({
 	defaultValue: [],
 	event: "userChanged",
 	queryKey: ["useGetUserSocialAccounts"],
-	selector: (client) => getUserSocialAccounts(client)
+	selector: (client) => client.user ? getUserSocialAccounts(client) : []
 });
 
 //#endregion
@@ -2247,6 +2261,100 @@ const useGetWalletOptionsCatalogue = ({ queryParams, ...args } = {}) => useBaseQ
 	}
 });
 
+//#endregion
+//#region src/hooks/wrappers/functions/useGetWalletProviderDataByKey/useGetWalletProviderDataByKey.ts
+/**
+* Wraps `getWalletProviderDataByKey` from `@dynamic-labs-sdk/client`. Returns
+* the display/connection data for a single wallet provider, by key.
+*
+* The underlying data is read from the in-memory wallet provider registry,
+* which EIP-6963 wallets fill asynchronously after mount. The registry emits
+* `walletProviderChanged` on register / priority update, so wiring it keeps the
+* provider data in sync without consumers pairing the hook with a manual
+* `useOnEvent` + `refetch` listener.
+*
+* `walletProviderUnregistered` is intentionally not wired here: this hook reads
+* a single key, and once that key is removed there is no replacement data to
+* fetch — refetching would only make `getWalletProviderDataByKey` throw
+* `NoWalletProviderFoundError`. Skipping it keeps the last-known data instead of
+* forcing the query into an error state.
+*
+* @example
+* ```tsx
+* const { data: walletProviderData } = useGetWalletProviderDataByKey({
+*   walletProviderKey,
+* });
+* ```
+*/
+const useGetWalletProviderDataByKey = ({ queryParams, ...args }) => useBaseQuery({
+	middlewares: [invalidateOnEvent({ event: "walletProviderChanged" })],
+	queryFn: (client) => Promise.resolve(getWalletProviderDataByKey(args, client)),
+	queryKey: ["useGetWalletProviderDataByKey", args],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useIsDeviceRegistrationRequired/useIsDeviceRegistrationRequired.ts
+/**
+* Returns whether the current user still needs to register this device.
+*
+* Re-renders when the user changes (login, logout, completing device
+* registration). Resolves to `false` while no user is authenticated.
+*/
+const useIsDeviceRegistrationRequired = () => useBaseState({
+	defaultValue: false,
+	event: "userChanged",
+	queryKey: ["useIsDeviceRegistrationRequired"],
+	selector: (client) => client.user ? isDeviceRegistrationRequired(client.user) : false
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useIsUserMissingMfaAuth/useIsUserMissingMfaAuth.ts
+/**
+* Returns whether the current user still needs to complete an MFA challenge.
+*
+* Re-renders when the user changes (login, logout, completing the MFA
+* challenge). Resolves to `false` while no user is authenticated.
+*/
+const useIsUserMissingMfaAuth = () => useBaseState({
+	defaultValue: false,
+	event: "userChanged",
+	queryKey: ["useIsUserMissingMfaAuth"],
+	selector: (client) => client.user ? isUserMissingMfaAuth(client) : false
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useIsPendingRecoveryCodesAcknowledgment/useIsPendingRecoveryCodesAcknowledgment.ts
+/**
+* Returns whether the current user still needs to acknowledge their MFA
+* recovery codes.
+*
+* Re-renders when the user changes (login, logout, acknowledging the recovery
+* codes). Resolves to `false` while no user is authenticated.
+*/
+const useIsPendingRecoveryCodesAcknowledgment = () => useBaseState({
+	defaultValue: false,
+	event: "userChanged",
+	queryKey: ["useIsPendingRecoveryCodesAcknowledgment"],
+	selector: (client) => client.user ? isPendingRecoveryCodesAcknowledgment(client) : false
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useIsUserOnboardingComplete/useIsUserOnboardingComplete.ts
+/**
+* Returns whether the current user has completed every onboarding requirement
+* (KYC fields, MFA, recovery codes acknowledgment, device registration).
+*
+* Re-renders when the user changes (login, logout, completing any onboarding
+* step). Resolves to `false` while no user is authenticated.
+*/
+const useIsUserOnboardingComplete = () => useBaseState({
+	defaultValue: false,
+	event: "userChanged",
+	queryKey: ["useIsUserOnboardingComplete"],
+	selector: (client) => client.user ? isUserOnboardingComplete(client) : false
+});
+
 //#endregion
 //#region src/hooks/wrappers/state/useInitStatus/useInitStatus.ts
 /**
@@ -2323,5 +2431,5 @@ const useUser = () => useBaseState({
 assertPackageVersion(name, version);
 
 //#endregion
-export { DynamicProvider, useAcknowledgeRecoveryCodes, useAddCoinbaseOnrampOrderEventListener, useAddNetwork, useAssertWalletAccountSigningAvailability, useAttachFlowSource, useAuthenticateMfaRecoveryCode, useAuthenticatePasskeyMFA, useAuthenticateTotpMfaDevice, useBroadcastFlow, useCancelFlow, useCheckStepUpAuth, useCompleteDeviceRegistration, useCompleteSocialRedirect, useConfirmTransaction, useConnectAndVerifyWithWalletProvider, useConnectWithWalletProvider, useCreateCoinbaseOnrampOrder, useCreateCryptoDotComPayment, useCreateKrakenExchangeTransfer, useCreateNewMfaRecoveryCodes, useDeleteMfaDevice, useDeletePasskey, useDeleteUser, useDynamicClient, useExecuteSwapTransaction, useGetActiveNetworkData, useGetActiveNetworkId, useGetAvailableWalletProvidersData, useGetBalanceForAddress, useGetCoinbaseBuyUrl, useGetConnectedAddresses, useGetFlow, useGetFlowQuote, useGetGoogleDriveBackupReadiness, useGetKrakenAccounts, useGetKrakenWhitelistedAddresses, useGetMfaDevices, useGetMfaMethods, useGetMfaRecoveryCodes, useGetMoonPayCurrencies, useGetMoonPayUrl, useGetMultichainTokenBalances, useGetNativeBalance, useGetPasskeys, useGetRegisteredDevices, useGetSwapQuote, useGetSwapStatus, useGetTokenBalances, useGetTransactionHistory, useGetUserSocialAccounts, useGetWalletAccounts, useGetWalletConnectCatalog, useGetWalletConnectCatalogWalletByWalletProviderKey, useGetWalletOptionsCatalogue, useInitStatus, useIsMfaRequiredForAction, useLogout, useOnEvent, useOnWalletProviderEvent, useOnceEvent, usePrepareFlowSigning, useProveWalletAccountOwnership, useRefreshAuth, useRegisterPasskey, useRegisterTotpMfaDevice, useRemoveWalletAccount, useRequestExternalAuthElevatedToken, useRevokeAllRegisteredDevices, useRevokeRegisteredDevice, useSendEmailOTP, useSendSmsOTP, useSessionExpiresAt, useSetDefaultMfaDevice, useSignInWithExternalJwt, useSignInWithPasskey, useSignInWithSocialPopUp, useSignInWithSocialRedirect, useSignMessage, useSubmitFlowTransaction, useSwitchActiveNetwork, useTransferAmount, useTransferWalletAccount, useUnlinkSocialAccount, useUpdateUser, useUser, useVerifyOTP, useVerifyWalletAccount };
+export { DynamicProvider, useAcknowledgeRecoveryCodes, useAddCoinbaseOnrampOrderEventListener, useAddNetwork, useAssertWalletAccountSigningAvailability, useAttachFlowSource, useAuthenticateMfaRecoveryCode, useAuthenticatePasskeyMFA, useAuthenticateTotpMfaDevice, useBroadcastFlow, useCancelFlow, useCheckStepUpAuth, useCompleteDeviceRegistration, useCompleteSocialRedirect, useConfirmTransaction, useConnectAndVerifyWithWalletProvider, useConnectWithWalletProvider, useCreateCoinbaseOnrampOrder, useCreateCryptoDotComPayment, useCreateKrakenExchangeTransfer, useCreateNewMfaRecoveryCodes, useDeleteMfaDevice, useDeletePasskey, useDeleteUser, useDynamicClient, useExecuteSwapTransaction, useGetActiveNetworkData, useGetActiveNetworkId, useGetAvailableWalletProvidersData, useGetBalanceForAddress, useGetCoinbaseBuyUrl, useGetConnectedAddresses, useGetFlow, useGetFlowQuote, useGetGoogleDriveBackupReadiness, useGetKrakenAccounts, useGetKrakenWhitelistedAddresses, useGetMfaDevices, useGetMfaMethods, useGetMfaRecoveryCodes, useGetMoonPayCurrencies, useGetMoonPayUrl, useGetMultichainTokenBalances, useGetNativeBalance, useGetPasskeys, useGetRegisteredDevices, useGetSwapQuote, useGetSwapStatus, useGetTokenBalances, useGetTransactionHistory, useGetUserSocialAccounts, useGetWalletAccounts, useGetWalletConnectCatalog, useGetWalletConnectCatalogWalletByWalletProviderKey, useGetWalletOptionsCatalogue, useGetWalletProviderDataByKey, useInitStatus, useIsDeviceRegistrationRequired, useIsMfaRequiredForAction, useIsPendingRecoveryCodesAcknowledgment, useIsUserMissingMfaAuth, useIsUserOnboardingComplete, useLogout, useOnEvent, useOnWalletProviderEvent, useOnceEvent, usePrepareFlowSigning, useProveWalletAccountOwnership, useRefreshAuth, useRegisterPasskey, useRegisterTotpMfaDevice, useRemoveWalletAccount, useRequestExternalAuthElevatedToken, useRevokeAllRegisteredDevices, useRevokeRegisteredDevice, useSendEmailOTP, useSendSmsOTP, useSessionExpiresAt, useSetDefaultMfaDevice, useSignInWithExternalJwt, useSignInWithPasskey, useSignInWithSocialPopUp, useSignInWithSocialRedirect, useSignMessage, useSubmitFlowTransaction, useSwitchActiveNetwork, useTransferAmount, useTransferWalletAccount, useUnlinkSocialAccount, useUpdateUser, useUser, useVerifyOTP, useVerifyWalletAccount };
 //# sourceMappingURL=index.esm.js.map