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

package/dist/index.cjs

@@ -4,10 +4,11 @@ let _tanstack_react_query = require("@tanstack/react-query");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
+let _dynamic_labs_sdk_client_waas = require("@dynamic-labs-sdk/client/waas");
 
 //#region package.json
 var name = "@dynamic-labs-sdk/react-hooks";
-var version = "1.18.0";
+var version = "1.19.0";
 
 //#endregion
 //#region src/modules/DynamicContext/DynamicContext.ts
@@ -759,6 +760,35 @@ const useCompleteSocialRedirect = ({ mutateParams } = {}) => useBaseMutation({
 	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.completeSocialRedirect)(variables, client)
 });
 
+//#endregion
+//#region src/hooks/wrappers/functions/useDetectSocialRedirectUrl/useDetectSocialRedirectUrl.ts
+/**
+* Wraps `detectSocialRedirectUrl` from `@dynamic-labs-sdk/client`. Resolves to
+* `true` when the given URL is an OAuth redirect back from a social provider
+* (started by `signInWithSocialRedirect`), so you can decide whether to run
+* `completeSocialRedirect`.
+*
+* @param params - See {@link UseDetectSocialRedirectUrlParams}.
+* @returns A react-query result whose `data` is `true` when the URL is a social
+* OAuth callback, plus the usual `isLoading`/`error` fields.
+*
+* @example
+* ```tsx
+* const { data: isReturningFromProvider, isLoading } =
+*   useDetectSocialRedirectUrl({ url });
+* ```
+*
+* @see {@link useCompleteSocialRedirect} to finish the redirect sign-in once
+* this returns `true`.
+* @see {@link clearSocialRedirectParams} to clean the OAuth parameters from the
+* URL after completion.
+*/
+const useDetectSocialRedirectUrl = ({ queryParams, ...args }) => useBaseQuery({
+	queryFn: (client) => (0, _dynamic_labs_sdk_client.detectSocialRedirectUrl)(args, client),
+	queryKey: ["useDetectSocialRedirectUrl", { url: args.url.href }],
+	queryParams
+});
+
 //#endregion
 //#region src/hooks/wrappers/functions/useConfirmTransaction/useConfirmTransaction.ts
 /**
@@ -1279,6 +1309,38 @@ const useLogout = ({ mutateParams } = {}) => useBaseMutation({
 	mutationFn: ({ client }) => (0, _dynamic_labs_sdk_client.logout)(client)
 });
 
+//#endregion
+//#region src/hooks/wrappers/functions/useMergeUserAccounts/useMergeUserAccounts.ts
+/**
+* Completes an account merge after a credential was found to already belong to
+* another user (surfaced as `MergeAccountsConfirmationError` during
+* verification / linking).
+*
+* Wraps `mergeUserAccounts` from `@dynamic-labs-sdk/client`. Call `mutate()`
+* with no arguments to merge directly when there are no conflicts, or
+* `mutate({ conflictResolutions })` with the user's per-field choices when the
+* merge surfaced conflicts. The resolved `data` is the merged user.
+*
+* @example
+* ```tsx
+* const { mutate: mergeAccounts, isPending } = useMergeUserAccounts();
+*
+* // No conflicts — merge directly:
+* mergeAccounts({});
+*
+* // With conflicts the user resolved:
+* mergeAccounts({ conflictResolutions });
+* ```
+* @returns A react-query mutation whose `mutate`/`mutateAsync` completes the
+* merge and whose `data` is the merged user.
+* @see mergeUserAccounts
+* @see UseMergeUserAccountsParams
+*/
+const useMergeUserAccounts = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client.mergeUserAccounts)(variables, client)
+});
+
 //#endregion
 //#region src/hooks/wrappers/functions/useGetMfaDevices/useGetMfaDevices.ts
 /**
@@ -2355,6 +2417,307 @@ const useIsUserOnboardingComplete = () => useBaseState({
 	selector: (client) => client.user ? (0, _dynamic_labs_sdk_client.isUserOnboardingComplete)(client) : false
 });
 
+//#endregion
+//#region src/hooks/wrappers/functions/useBackupWaasKeySharesToGoogleDrive/useBackupWaasKeySharesToGoogleDrive.ts
+/**
+* Wraps `backupWaasKeySharesToGoogleDrive` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* back up an embedded wallet's key shares to the user's Google Drive.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useBackupWaasKeySharesToGoogleDrive();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `backupWaasKeySharesToGoogleDrive` and whose `data` is its resolved value.
+* @see backupWaasKeySharesToGoogleDrive
+* @see UseBackupWaasKeySharesToGoogleDriveParams
+*/
+const useBackupWaasKeySharesToGoogleDrive = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.backupWaasKeySharesToGoogleDrive)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useCreateWaasWalletAccounts/useCreateWaasWalletAccounts.ts
+/**
+* Wraps `createWaasWalletAccounts` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* create embedded wallet accounts for the signed-in user.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useCreateWaasWalletAccounts();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `createWaasWalletAccounts` and whose `data` is its resolved value.
+* @see createWaasWalletAccounts
+* @see UseCreateWaasWalletAccountsParams
+*/
+const useCreateWaasWalletAccounts = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.createWaasWalletAccounts)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useDelegateWaasKeyShares/useDelegateWaasKeyShares.ts
+/**
+* Wraps `delegateWaasKeyShares` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* delegate signing access for an embedded wallet to your server.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useDelegateWaasKeyShares();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `delegateWaasKeyShares` and whose `data` is its resolved value.
+* @see delegateWaasKeyShares
+* @see UseDelegateWaasKeySharesParams
+*/
+const useDelegateWaasKeyShares = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.delegateWaasKeyShares)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useExportWaasClientKeyshares/useExportWaasClientKeyshares.ts
+/**
+* Wraps `exportWaasClientKeyshares` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* export an embedded wallet's client key shares.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useExportWaasClientKeyshares();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `exportWaasClientKeyshares` and whose `data` is its resolved value.
+* @see exportWaasClientKeyshares
+* @see UseExportWaasClientKeysharesParams
+*/
+const useExportWaasClientKeyshares = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.exportWaasClientKeyshares)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useExportWaasPrivateKey/useExportWaasPrivateKey.ts
+/**
+* Wraps `exportWaasPrivateKey` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* export an embedded wallet's private key.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useExportWaasPrivateKey();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `exportWaasPrivateKey` and whose `data` is its resolved value.
+* @see exportWaasPrivateKey
+* @see UseExportWaasPrivateKeyParams
+*/
+const useExportWaasPrivateKey = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.exportWaasPrivateKey)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useGetWalletRecoveryState/useGetWalletRecoveryState.ts
+/**
+* Returns the recovery state of an embedded wallet account — whether the user
+* still needs to set a password, back up their key shares, etc.
+*
+* Wraps `getWalletRecoveryState` from `@dynamic-labs-sdk/client/waas`. The hook
+* stays disabled until `walletAccount` is defined.
+*
+* @example
+* ```tsx
+* const { data, isLoading } = useGetWalletRecoveryState({ walletAccount });
+* ```
+*
+* @returns A react-query result whose `data` is the wallet account's recovery state; it stays disabled until `walletAccount` is defined.
+* @see getWalletRecoveryState
+* @see UseGetWalletRecoveryStateParams
+*/
+const useGetWalletRecoveryState = ({ queryParams, walletAccount }) => useBaseQuery({
+	enabled: walletAccount !== void 0,
+	queryFn: (client) => (0, _dynamic_labs_sdk_client_waas.getWalletRecoveryState)({ walletAccount }, client),
+	queryKey: ["useGetWalletRecoveryState", walletAccount?.id],
+	queryParams
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useImportWaasPrivateKey/useImportWaasPrivateKey.ts
+/**
+* Wraps `importWaasPrivateKey` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* import a private key into a new embedded wallet account.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useImportWaasPrivateKey();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `importWaasPrivateKey` and whose `data` is its resolved value.
+* @see importWaasPrivateKey
+* @see UseImportWaasPrivateKeyParams
+*/
+const useImportWaasPrivateKey = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.importWaasPrivateKey)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useMigrateFromFireblocks/useMigrateFromFireblocks.ts
+/**
+* Wraps `migrateFromFireblocks` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* migrate a user's legacy Fireblocks wallet to an embedded wallet.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useMigrateFromFireblocks();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `migrateFromFireblocks` and whose `data` is its resolved value.
+* @see migrateFromFireblocks
+* @see UseMigrateFromFireblocksParams
+*/
+const useMigrateFromFireblocks = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.migrateFromFireblocks)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useRefreshWaasWalletAccountShares/useRefreshWaasWalletAccountShares.ts
+/**
+* Wraps `refreshWaasWalletAccountShares` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* refresh an embedded wallet account's key shares.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useRefreshWaasWalletAccountShares();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `refreshWaasWalletAccountShares` and whose `data` is its resolved value.
+* @see refreshWaasWalletAccountShares
+* @see UseRefreshWaasWalletAccountSharesParams
+*/
+const useRefreshWaasWalletAccountShares = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.refreshWaasWalletAccountShares)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useRevokeWaasDelegation/useRevokeWaasDelegation.ts
+/**
+* Wraps `revokeWaasDelegation` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* revoke an embedded wallet's previously granted delegated signing access.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useRevokeWaasDelegation();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `revokeWaasDelegation` and whose `data` is its resolved value.
+* @see revokeWaasDelegation
+* @see UseRevokeWaasDelegationParams
+*/
+const useRevokeWaasDelegation = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.revokeWaasDelegation)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useSetWaasWalletAccountPassword/useSetWaasWalletAccountPassword.ts
+/**
+* Wraps `setWaasWalletAccountPassword` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* set a password on an embedded wallet account.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useSetWaasWalletAccountPassword();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `setWaasWalletAccountPassword` and whose `data` is its resolved value.
+* @see setWaasWalletAccountPassword
+* @see UseSetWaasWalletAccountPasswordParams
+*/
+const useSetWaasWalletAccountPassword = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.setWaasWalletAccountPassword)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useUnlockWallet/useUnlockWallet.ts
+/**
+* Wraps `unlockWallet` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* unlock an embedded wallet account with its password.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useUnlockWallet();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `unlockWallet` and whose `data` is its resolved value.
+* @see unlockWallet
+* @see UseUnlockWalletParams
+*/
+const useUnlockWallet = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.unlockWallet)(variables, client)
+});
+
+//#endregion
+//#region src/hooks/wrappers/functions/useUpdateWaasPassword/useUpdateWaasPassword.ts
+/**
+* Wraps `updateWaasPassword` from `@dynamic-labs-sdk/client/waas`. Call `mutate(variables)` to
+* update the password protecting an embedded wallet account.
+*
+* @example
+* ```tsx
+* const { mutate, isPending } = useUpdateWaasPassword();
+* <button onClick={() => mutate(variables)} disabled={isPending}>
+*   Continue
+* </button>
+* ```
+*
+* @returns A react-query mutation whose `mutate`/`mutateAsync` calls `updateWaasPassword` and whose `data` is its resolved value.
+* @see updateWaasPassword
+* @see UseUpdateWaasPasswordParams
+*/
+const useUpdateWaasPassword = ({ mutateParams } = {}) => useBaseMutation({
+	mutateParams,
+	mutationFn: ({ client, variables }) => (0, _dynamic_labs_sdk_client_waas.updateWaasPassword)(variables, client)
+});
+
 //#endregion
 //#region src/hooks/wrappers/state/useInitStatus/useInitStatus.ts
 /**
@@ -2440,6 +2803,7 @@ exports.useAttachFlowSource = useAttachFlowSource;
 exports.useAuthenticateMfaRecoveryCode = useAuthenticateMfaRecoveryCode;
 exports.useAuthenticatePasskeyMFA = useAuthenticatePasskeyMFA;
 exports.useAuthenticateTotpMfaDevice = useAuthenticateTotpMfaDevice;
+exports.useBackupWaasKeySharesToGoogleDrive = useBackupWaasKeySharesToGoogleDrive;
 exports.useBroadcastFlow = useBroadcastFlow;
 exports.useCancelFlow = useCancelFlow;
 exports.useCheckStepUpAuth = useCheckStepUpAuth;
@@ -2452,11 +2816,16 @@ exports.useCreateCoinbaseOnrampOrder = useCreateCoinbaseOnrampOrder;
 exports.useCreateCryptoDotComPayment = useCreateCryptoDotComPayment;
 exports.useCreateKrakenExchangeTransfer = useCreateKrakenExchangeTransfer;
 exports.useCreateNewMfaRecoveryCodes = useCreateNewMfaRecoveryCodes;
+exports.useCreateWaasWalletAccounts = useCreateWaasWalletAccounts;
+exports.useDelegateWaasKeyShares = useDelegateWaasKeyShares;
 exports.useDeleteMfaDevice = useDeleteMfaDevice;
 exports.useDeletePasskey = useDeletePasskey;
 exports.useDeleteUser = useDeleteUser;
+exports.useDetectSocialRedirectUrl = useDetectSocialRedirectUrl;
 exports.useDynamicClient = useDynamicClient;
 exports.useExecuteSwapTransaction = useExecuteSwapTransaction;
+exports.useExportWaasClientKeyshares = useExportWaasClientKeyshares;
+exports.useExportWaasPrivateKey = useExportWaasPrivateKey;
 exports.useGetActiveNetworkData = useGetActiveNetworkData;
 exports.useGetActiveNetworkId = useGetActiveNetworkId;
 exports.useGetAvailableWalletProvidersData = useGetAvailableWalletProvidersData;
@@ -2487,6 +2856,8 @@ exports.useGetWalletConnectCatalog = useGetWalletConnectCatalog;
 exports.useGetWalletConnectCatalogWalletByWalletProviderKey = useGetWalletConnectCatalogWalletByWalletProviderKey;
 exports.useGetWalletOptionsCatalogue = useGetWalletOptionsCatalogue;
 exports.useGetWalletProviderDataByKey = useGetWalletProviderDataByKey;
+exports.useGetWalletRecoveryState = useGetWalletRecoveryState;
+exports.useImportWaasPrivateKey = useImportWaasPrivateKey;
 exports.useInitStatus = useInitStatus;
 exports.useIsDeviceRegistrationRequired = useIsDeviceRegistrationRequired;
 exports.useIsMfaRequiredForAction = useIsMfaRequiredForAction;
@@ -2494,22 +2865,27 @@ exports.useIsPendingRecoveryCodesAcknowledgment = useIsPendingRecoveryCodesAckno
 exports.useIsUserMissingMfaAuth = useIsUserMissingMfaAuth;
 exports.useIsUserOnboardingComplete = useIsUserOnboardingComplete;
 exports.useLogout = useLogout;
+exports.useMergeUserAccounts = useMergeUserAccounts;
+exports.useMigrateFromFireblocks = useMigrateFromFireblocks;
 exports.useOnEvent = useOnEvent;
 exports.useOnWalletProviderEvent = useOnWalletProviderEvent;
 exports.useOnceEvent = useOnceEvent;
 exports.usePrepareFlowSigning = usePrepareFlowSigning;
 exports.useProveWalletAccountOwnership = useProveWalletAccountOwnership;
 exports.useRefreshAuth = useRefreshAuth;
+exports.useRefreshWaasWalletAccountShares = useRefreshWaasWalletAccountShares;
 exports.useRegisterPasskey = useRegisterPasskey;
 exports.useRegisterTotpMfaDevice = useRegisterTotpMfaDevice;
 exports.useRemoveWalletAccount = useRemoveWalletAccount;
 exports.useRequestExternalAuthElevatedToken = useRequestExternalAuthElevatedToken;
 exports.useRevokeAllRegisteredDevices = useRevokeAllRegisteredDevices;
 exports.useRevokeRegisteredDevice = useRevokeRegisteredDevice;
+exports.useRevokeWaasDelegation = useRevokeWaasDelegation;
 exports.useSendEmailOTP = useSendEmailOTP;
 exports.useSendSmsOTP = useSendSmsOTP;
 exports.useSessionExpiresAt = useSessionExpiresAt;
 exports.useSetDefaultMfaDevice = useSetDefaultMfaDevice;
+exports.useSetWaasWalletAccountPassword = useSetWaasWalletAccountPassword;
 exports.useSignInWithExternalJwt = useSignInWithExternalJwt;
 exports.useSignInWithPasskey = useSignInWithPasskey;
 exports.useSignInWithSocialPopUp = useSignInWithSocialPopUp;
@@ -2520,7 +2896,9 @@ exports.useSwitchActiveNetwork = useSwitchActiveNetwork;
 exports.useTransferAmount = useTransferAmount;
 exports.useTransferWalletAccount = useTransferWalletAccount;
 exports.useUnlinkSocialAccount = useUnlinkSocialAccount;
+exports.useUnlockWallet = useUnlockWallet;
 exports.useUpdateUser = useUpdateUser;
+exports.useUpdateWaasPassword = useUpdateWaasPassword;
 exports.useUser = useUser;
 exports.useVerifyOTP = useVerifyOTP;
 exports.useVerifyWalletAccount = useVerifyWalletAccount;