@dynamic-labs-sdk/react-hooks 1.31.0 → 1.31.2

package/dist/index.esm.js

@@ -1,7 +1,7 @@
-import { a as useDynamicClient, c as version, i as useBaseMutation, n as useBaseQuery, o as DynamicProvider, r as QUERY_KEY_PREFIX, s as name, t as useBaseState } from "./useBaseState-A-g9wCVT.esm.js";
+import { a as useDynamicClient, c as version, i as useBaseMutation, n as useBaseQuery, o as DynamicProvider, r as QUERY_KEY_PREFIX, s as name, t as useBaseState } from "./useBaseState-CkWod9xl.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
-import { acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, addNetwork, assertWalletAccountSigningAvailability, attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, broadcastFlow, cancelFlow, checkStepUpAuth, claimYieldRewards, completeDeviceRegistration, completeSocialRedirect, confirmTransaction, connectAndVerifyWithWalletProvider, connectWithWalletProvider, createCoinbaseExchangeTransfer, createCoinbaseOnrampOrder, createCryptoDotComPayment, createKrakenExchangeTransfer, createNewMfaRecoveryCodes, deleteMfaDevice, deletePasskey, deleteUser, depositToYieldVault, detectSocialRedirectUrl, executeSwapTransaction, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalanceForAddress, getCoinbaseAccounts, 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, getYieldDetails, getYieldPosition, getYieldRewards, isDeviceRegistrationRequired, isMfaRequiredForAction, isPendingRecoveryCodesAcknowledgment, isUserMissingMfaAuth, isUserOnboardingComplete, listYieldVaults, logout, mergeUserAccounts, onEvent, onWalletProviderEvent, onceEvent, prepareFlowSigning, proveWalletAccountOwnership, refreshAuth, registerPasskey, registerTotpMfaDevice, removeWalletAccount, requestExternalAuthElevatedToken, revokeAllRegisteredDevices, revokeRegisteredDevice, screenTransaction, sendEmailOTP, sendSmsOTP, setDefaultMfaDevice, signInWithExternalJwt, signInWithPasskey, signInWithSocialPopUp, signInWithSocialRedirect, signMessage, submitFlowTransaction, switchActiveNetwork, transferAmount, transferWalletAccount, unlinkSocialAccount, updateUser, verifyOTP, verifyWalletAccount, withdrawFromYieldVault } from "@dynamic-labs-sdk/client";
-import { useQueryClient } from "@tanstack/react-query";
+import { acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, addNetwork, assertWalletAccountSigningAvailability, attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, broadcastFlow, cancelFlow, checkStepUpAuth, claimYieldRewards, completeDeviceRegistration, completeSocialRedirect, confirmTransaction, connectAndVerifyWithWalletProvider, connectWithWalletProvider, createCoinbaseExchangeTransfer, createCoinbaseOnrampOrder, createCryptoDotComPayment, createKrakenExchangeTransfer, createNewMfaRecoveryCodes, deleteMfaDevice, deletePasskey, deleteUser, depositToYieldVault, detectSocialRedirectUrl, executeSwapTransaction, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalanceForAddress, getCoinbaseAccounts, 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, getYieldDetails, getYieldPosition, getYieldRewards, isDeviceRegistrationRequired, isMfaRequiredForAction, isPendingRecoveryCodesAcknowledgment, isUserMissingMfaAuth, isUserOnboardingComplete, listYieldVaults, logout, mergeUserAccounts, onEvent, onWalletProviderEvent, onceEvent, prepareFlowSigning, proveWalletAccountOwnership, redirectToInAppBrowser, refreshAuth, registerPasskey, registerTotpMfaDevice, removeWalletAccount, requestExternalAuthElevatedToken, revokeAllRegisteredDevices, revokeRegisteredDevice, screenTransaction, sendEmailOTP, sendSmsOTP, setDefaultMfaDevice, signInWithExternalJwt, signInWithPasskey, signInWithSocialPopUp, signInWithSocialRedirect, signMessage, submitFlowTransaction, switchActiveNetwork, transferAmount, transferWalletAccount, unlinkSocialAccount, updateUser, verifyOTP, verifyWalletAccount, withdrawFromYieldVault } from "@dynamic-labs-sdk/client";
+import { hashKey, useQueryClient } from "@tanstack/react-query";
 import { useEffect, useRef } from "react";
 import { getCore } from "@dynamic-labs-sdk/client/core";
 import { addBusinessAccountMember, addBusinessAccountSigner, addWalletToBusinessAccount, backupWaasKeySharesToGoogleDrive, createBusinessAccount, createPolicy, createWaasOfflineRecoveryShares, createWaasWalletAccounts, createWalletForBusinessAccount, delegateWaasKeyShares, exportWaasClientKeyshares, exportWaasPrivateKey, getAccountPolicyLayer, getBusinessAccount, getPolicy, getSignerPolicyLayer, getWalletPolicyLayer, getWalletRecoveryState, importWaasPrivateKey, listBusinessAccounts, migrateFromFireblocks, refreshWaasWalletAccountShares, removeAccountPolicyRule, removeBusinessAccountMember, removeBusinessAccountSigner, removeBusinessAccountWallet, removePolicyRules, removeSignerPolicyRule, removeWalletPolicyRule, revokeWaasDelegation, setWaasWalletAccountPassword, signSerializedTransaction, transferBusinessAccountOwnership, unlockWallet, updateBusinessAccount, updateBusinessAccountMemberRole, updateWaasPassword, upsertAccountPolicyRule, upsertSignerPolicyRule, upsertWalletPolicyRule } from "@dynamic-labs-sdk/client/waas";
@@ -1487,6 +1487,34 @@ const useProveWalletAccountOwnership = ({ mutateParams } = {}) => useBaseMutatio
 	mutationFn: ({ client, variables }) => proveWalletAccountOwnership(variables, client)
 });
 
+//#endregion
+//#region src/hooks/wrappers/functions/useRedirectToInAppBrowser/useRedirectToInAppBrowser.ts
+/**
+* Leaves your app for a wallet's in-app browser, which reloads your app
+* inside it.
+*
+* Wraps `redirectToInAppBrowser` from `@dynamic-labs-sdk/client`. Call
+* `mutate({ appUrl, walletKey })` with the page the wallet's browser should
+* reload; the wallet's in-app-browser entry point is read from the wallet
+* options catalogue.
+*
+* @example
+* ```tsx
+* const { mutate: redirect } = useRedirectToInAppBrowser();
+*
+* redirect({ appUrl: window.location.href, walletKey: 'coinbase' });
+* ```
+*
+* @returns The react-query mutation result for the redirect.
+*
+* @see UseRedirectToInAppBrowserParams
+* @see useGetWalletOptionsCatalogue
+*/
+const useRedirectToInAppBrowser = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => redirectToInAppBrowser(variables, client)
+});
+
 //#endregion
 //#region src/hooks/wrappers/functions/useRefreshAuth/useRefreshAuth.ts
 /**
@@ -2538,21 +2566,62 @@ const CATALOGUE_STALE_TIME_MS = 36e5;
 * `walletProviderUnregistered` (on removal). Wiring both keeps the catalogue in
 * sync without consumers pairing the hook with a manual listener.
 *
+* Also refetches on `networkProviderBuilderRegistered`: the catalogue is scoped
+* to the chains the client has an extension for, and an extension added after
+* the first fetch emits no wallet provider event of its own.
+*
+* With `includeMobileOptions: true` the installed wallets are returned as
+* react-query placeholder data while the wallet book loads, so `data` is
+* populated before the full catalogue resolves and `status` is `'success'`
+* from the start — `isPlaceholderData` is what tells a partial catalogue from
+* the complete one.
+*
 * @example
 * ```tsx
 * const { data: catalogue, isLoading } = useGetWalletOptionsCatalogue();
 * ```
 */
-const useGetWalletOptionsCatalogue = ({ queryParams, ...args } = {}) => useBaseQuery({
-	middlewares: [invalidateOnEvent({ event: "walletProviderChanged" }), invalidateOnEvent({ event: "walletProviderUnregistered" })],
-	queryFn: (client) => getWalletOptionsCatalogue(args, client),
-	queryKey: ["useGetWalletOptionsCatalogue", args],
-	queryParams: {
-		retry: false,
-		staleTime: CATALOGUE_STALE_TIME_MS,
-		...queryParams
-	}
-});
+const useGetWalletOptionsCatalogue = ({ queryParams, returnInstalledOptionsWhileLoading = true, ...args } = {}) => {
+	const wantsInstalledPlaceholder = (args.includeMobileOptions ?? false) && returnInstalledOptionsWhileLoading && queryParams?.enabled !== false;
+	const middlewares = [
+		invalidateOnEvent({ event: "walletProviderChanged" }),
+		invalidateOnEvent({ event: "walletProviderUnregistered" }),
+		invalidateOnEvent({ event: "networkProviderBuilderRegistered" })
+	];
+	const catalogueArgs = {
+		...args,
+		includeMobileOptions: args.includeMobileOptions ?? false
+	};
+	const installedOnlyArgs = {
+		...args,
+		includeMobileOptions: false
+	};
+	const catalogueCacheKey = hashKey([catalogueArgs]);
+	const loadedCatalogueCacheKeyRef = useRef(void 0);
+	const installedOnlyResult = useBaseQuery({
+		enabled: wantsInstalledPlaceholder && loadedCatalogueCacheKeyRef.current !== catalogueCacheKey,
+		middlewares,
+		queryFn: (client) => getWalletOptionsCatalogue(installedOnlyArgs, client),
+		queryKey: ["useGetWalletOptionsCatalogue", installedOnlyArgs],
+		queryParams: {
+			retry: false,
+			staleTime: CATALOGUE_STALE_TIME_MS
+		}
+	});
+	const fullCatalogueResult = useBaseQuery({
+		middlewares,
+		queryFn: (client) => getWalletOptionsCatalogue(catalogueArgs, client),
+		queryKey: ["useGetWalletOptionsCatalogue", catalogueArgs],
+		queryParams: {
+			retry: false,
+			staleTime: CATALOGUE_STALE_TIME_MS,
+			...wantsInstalledPlaceholder ? { placeholderData: () => installedOnlyResult.data } : {},
+			...queryParams
+		}
+	});
+	loadedCatalogueCacheKeyRef.current = fullCatalogueResult.data !== void 0 && !fullCatalogueResult.isPlaceholderData ? catalogueCacheKey : void 0;
+	return fullCatalogueResult;
+};
 
 //#endregion
 //#region src/hooks/wrappers/functions/useGetWalletPolicyLayer/useGetWalletPolicyLayer.ts
@@ -3508,5 +3577,5 @@ const useUser = () => useBaseState({
 assertPackageVersion(name, version);
 
 //#endregion
-export { DynamicProvider, useAcknowledgeRecoveryCodes, useAddBusinessAccountMember, useAddBusinessAccountSigner, useAddCoinbaseOnrampOrderEventListener, useAddNetwork, useAddWalletToBusinessAccount, useAssertWalletAccountSigningAvailability, useAttachFlowSource, useAuthenticateMfaRecoveryCode, useAuthenticatePasskeyMFA, useAuthenticateTotpMfaDevice, useBackupWaasKeySharesToGoogleDrive, useBroadcastFlow, useCancelFlow, useCheckStepUpAuth, useClaimYieldRewards, useCompleteDeviceRegistration, useCompleteSocialRedirect, useConfirmTransaction, useConnectAndVerifyWithWalletProvider, useConnectWithWalletProvider, useCreateBusinessAccount, useCreateCoinbaseExchangeTransfer, useCreateCoinbaseOnrampOrder, useCreateCryptoDotComPayment, useCreateKrakenExchangeTransfer, useCreateNewMfaRecoveryCodes, useCreatePolicy, useCreateWaasOfflineRecoveryShares, useCreateWaasWalletAccounts, useCreateWalletForBusinessAccount, useDelegateWaasKeyShares, useDeleteMfaDevice, useDeletePasskey, useDeleteUser, useDepositToYieldVault, useDetectSocialRedirectUrl, useDynamicClient, useExecuteSwapTransaction, useExportWaasClientKeyshares, useExportWaasPrivateKey, useGetAccountPolicyLayer, useGetActiveNetworkData, useGetActiveNetworkId, useGetAvailableWalletProvidersData, useGetBalanceForAddress, useGetBusinessAccount, useGetCoinbaseAccounts, useGetCoinbaseBuyUrl, useGetConnectedAddresses, useGetFlow, useGetFlowQuote, useGetGoogleDriveBackupReadiness, useGetKrakenAccounts, useGetKrakenWhitelistedAddresses, useGetMfaDevices, useGetMfaMethods, useGetMfaRecoveryCodes, useGetMoonPayCurrencies, useGetMoonPayUrl, useGetMultichainTokenBalances, useGetNativeBalance, useGetPasskeys, useGetPolicy, useGetRegisteredDevices, useGetSignerPolicyLayer, useGetSwapQuote, useGetSwapStatus, useGetTokenBalances, useGetTransactionHistory, useGetUserSocialAccounts, useGetWalletAccounts, useGetWalletConnectCatalog, useGetWalletConnectCatalogWalletByWalletProviderKey, useGetWalletOptionsCatalogue, useGetWalletPolicyLayer, useGetWalletProviderDataByKey, useGetWalletRecoveryState, useGetYieldDetails, useGetYieldPosition, useGetYieldRewards, useImportWaasPrivateKey, useInitStatus, useIsDeviceRegistrationRequired, useIsMfaRequiredForAction, useIsPendingRecoveryCodesAcknowledgment, useIsUserMissingMfaAuth, useIsUserOnboardingComplete, useListBusinessAccounts, useListYieldVaults, useLogout, useMergeUserAccounts, useMigrateFromFireblocks, useOnEvent, useOnWalletProviderEvent, useOnceEvent, usePrepareFlowSigning, useProveWalletAccountOwnership, useRefreshAuth, useRefreshWaasWalletAccountShares, useRegisterPasskey, useRegisterTotpMfaDevice, useRemoveAccountPolicyRule, useRemoveBusinessAccountMember, useRemoveBusinessAccountSigner, useRemoveBusinessAccountWallet, useRemovePolicyRules, useRemoveSignerPolicyRule, useRemoveWalletAccount, useRemoveWalletPolicyRule, useRequestExternalAuthElevatedToken, useRevokeAllRegisteredDevices, useRevokeRegisteredDevice, useRevokeWaasDelegation, useScreenTransaction, useSendEmailOTP, useSendSmsOTP, useSessionExpiresAt, useSetDefaultMfaDevice, useSetWaasWalletAccountPassword, useSignInWithExternalJwt, useSignInWithPasskey, useSignInWithSocialPopUp, useSignInWithSocialRedirect, useSignMessage, useSignSerializedTransaction, useSubmitFlowTransaction, useSwitchActiveNetwork, useTransferAmount, useTransferBusinessAccountOwnership, useTransferWalletAccount, useUnlinkSocialAccount, useUnlockWallet, useUpdateBusinessAccount, useUpdateBusinessAccountMemberRole, useUpdateUser, useUpdateWaasPassword, useUpsertAccountPolicyRule, useUpsertSignerPolicyRule, useUpsertWalletPolicyRule, useUser, useVerifyOTP, useVerifyWalletAccount, useWithdrawFromYieldVault };
+export { DynamicProvider, useAcknowledgeRecoveryCodes, useAddBusinessAccountMember, useAddBusinessAccountSigner, useAddCoinbaseOnrampOrderEventListener, useAddNetwork, useAddWalletToBusinessAccount, useAssertWalletAccountSigningAvailability, useAttachFlowSource, useAuthenticateMfaRecoveryCode, useAuthenticatePasskeyMFA, useAuthenticateTotpMfaDevice, useBackupWaasKeySharesToGoogleDrive, useBroadcastFlow, useCancelFlow, useCheckStepUpAuth, useClaimYieldRewards, useCompleteDeviceRegistration, useCompleteSocialRedirect, useConfirmTransaction, useConnectAndVerifyWithWalletProvider, useConnectWithWalletProvider, useCreateBusinessAccount, useCreateCoinbaseExchangeTransfer, useCreateCoinbaseOnrampOrder, useCreateCryptoDotComPayment, useCreateKrakenExchangeTransfer, useCreateNewMfaRecoveryCodes, useCreatePolicy, useCreateWaasOfflineRecoveryShares, useCreateWaasWalletAccounts, useCreateWalletForBusinessAccount, useDelegateWaasKeyShares, useDeleteMfaDevice, useDeletePasskey, useDeleteUser, useDepositToYieldVault, useDetectSocialRedirectUrl, useDynamicClient, useExecuteSwapTransaction, useExportWaasClientKeyshares, useExportWaasPrivateKey, useGetAccountPolicyLayer, useGetActiveNetworkData, useGetActiveNetworkId, useGetAvailableWalletProvidersData, useGetBalanceForAddress, useGetBusinessAccount, useGetCoinbaseAccounts, useGetCoinbaseBuyUrl, useGetConnectedAddresses, useGetFlow, useGetFlowQuote, useGetGoogleDriveBackupReadiness, useGetKrakenAccounts, useGetKrakenWhitelistedAddresses, useGetMfaDevices, useGetMfaMethods, useGetMfaRecoveryCodes, useGetMoonPayCurrencies, useGetMoonPayUrl, useGetMultichainTokenBalances, useGetNativeBalance, useGetPasskeys, useGetPolicy, useGetRegisteredDevices, useGetSignerPolicyLayer, useGetSwapQuote, useGetSwapStatus, useGetTokenBalances, useGetTransactionHistory, useGetUserSocialAccounts, useGetWalletAccounts, useGetWalletConnectCatalog, useGetWalletConnectCatalogWalletByWalletProviderKey, useGetWalletOptionsCatalogue, useGetWalletPolicyLayer, useGetWalletProviderDataByKey, useGetWalletRecoveryState, useGetYieldDetails, useGetYieldPosition, useGetYieldRewards, useImportWaasPrivateKey, useInitStatus, useIsDeviceRegistrationRequired, useIsMfaRequiredForAction, useIsPendingRecoveryCodesAcknowledgment, useIsUserMissingMfaAuth, useIsUserOnboardingComplete, useListBusinessAccounts, useListYieldVaults, useLogout, useMergeUserAccounts, useMigrateFromFireblocks, useOnEvent, useOnWalletProviderEvent, useOnceEvent, usePrepareFlowSigning, useProveWalletAccountOwnership, useRedirectToInAppBrowser, useRefreshAuth, useRefreshWaasWalletAccountShares, useRegisterPasskey, useRegisterTotpMfaDevice, useRemoveAccountPolicyRule, useRemoveBusinessAccountMember, useRemoveBusinessAccountSigner, useRemoveBusinessAccountWallet, useRemovePolicyRules, useRemoveSignerPolicyRule, useRemoveWalletAccount, useRemoveWalletPolicyRule, useRequestExternalAuthElevatedToken, useRevokeAllRegisteredDevices, useRevokeRegisteredDevice, useRevokeWaasDelegation, useScreenTransaction, useSendEmailOTP, useSendSmsOTP, useSessionExpiresAt, useSetDefaultMfaDevice, useSetWaasWalletAccountPassword, useSignInWithExternalJwt, useSignInWithPasskey, useSignInWithSocialPopUp, useSignInWithSocialRedirect, useSignMessage, useSignSerializedTransaction, useSubmitFlowTransaction, useSwitchActiveNetwork, useTransferAmount, useTransferBusinessAccountOwnership, useTransferWalletAccount, useUnlinkSocialAccount, useUnlockWallet, useUpdateBusinessAccount, useUpdateBusinessAccountMemberRole, useUpdateUser, useUpdateWaasPassword, useUpsertAccountPolicyRule, useUpsertSignerPolicyRule, useUpsertWalletPolicyRule, useUser, useVerifyOTP, useVerifyWalletAccount, useWithdrawFromYieldVault };
 //# sourceMappingURL=index.esm.js.map