@dynamic-labs-sdk/client 1.11.0 → 1.12.1

package/dist/index.esm.js

@@ -1,9 +1,10 @@
-import { $ as extractSessionId, A as createApiClient, B as InvalidExternalAuthError, D as onceEvent, E as onEvent, F as getNonce, G as ValueMustBeDefinedError, I as SandboxMaximumThresholdReachedError, J as scrubParameters, K as __getElevatedAccessToken_wrapped, L as MfaRateLimitedError, Q as getOperatingSystem, R as MfaInvalidOtpError, S as splitWalletProviderKey, T as offEvent, U as isCookieEnabled, V as APIError, W as assertDefined, X as getUserAgent, Y as DEFAULT_PII_FIELDS, Z as getPlatform, at as setDefaultClient, b as formatWalletAccountId, ct as getCore, d as getWalletProviderRegistry, et as randomString, it as getDefaultClient, j as UnauthorizedError, k as fetchAndStoreNonces, l as getWalletProviderFromWalletAccount, lt as name, m as getWalletAccounts, o as DYNAMIC_ICONIC_SPRITE_URL, p as NoWalletProviderFoundError, q as instrumentFunction, rt as NONCE_POOL_SIZE, s as SDK_API_CORE_VERSION, st as BaseError, t as InvalidParamError, u as WalletProviderPriority, ut as version, v as getChainFromVerifiedCredentialChain, w as emitEvent, x as normalizeAddress, y as CHAINS_INFO_MAP, z as LinkCredentialError } from "./InvalidParamError-BazEwozw.esm.js";
-import { A as GENERATE_SESSION_KEYS_TRACKER_KEY, B as isEqualShallow, C as createKeychainService, D as CannotTrackError, F as getBuffer, I as createStorage, M as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, N as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, O as createDeferredPromise, P as isServerSideRendering, R as createLocalStorageAdapter, S as createRealtimeService, T as createCrossTabBroadcast, _ as consumeCaptchaToken, a as verifyMessageSignatureOwnership, b as NoNetworkProvidersError, c as formatSignInMessage, d as updateWalletProviderKeysForVerifiedCredentials, f as setUnverifiedWalletAccounts, g as MethodNotImplementedError, h as __setCaptchaToken_wrapped, i as getNetworksData, j as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, k as FETCH_PROJECT_SETTINGS_TRACKER_KEY, l as getAppMetadata, m as hasExtension, o as removeUnverifiedWalletAccount, p as createVisit, s as createSignInMessageStatement, t as getNetworkProviderFromNetworkId, u as reconcileWalletAccountsAgainstClient, v as isCaptchaRequired, w as createLogger, x as getKeychainIndexedDBName, y as WalletAlreadyLinkedToAnotherUserError, z as subscribeWithSelector } from "./getNetworkProviderFromNetworkId-BfBE-dei.esm.js";
-import { a as generateSessionKeys, c as isSignedIn, i as __logoutWithReason_wrapped, l as retryOnFail, n as getMfaMethods, o as fetchProjectSettings, r as __consumeMfaToken_wrapped, s as createStorageKeySchema, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-DZVNUtPY.esm.js";
-import { a as parseElevatedAccessToken, d as checkAndRaiseWalletAccountsChangedEvent, i as upsertElevatedAccessToken, l as getWalletProviders, n as getVerifiedCredentialForWalletAccount, o as restoreUserSharesForAllWalletAccounts, r as updateAuthFromVerifyResponse, t as getWalletProviderByKey, u as isUserMissingMfaAuth } from "./getWalletProviderByKey-BXGcVzkf.esm.js";
-import { t as __refreshAuth_wrapped } from "./refreshAuth-DlQw3Dky.esm.js";
-import { t as NotWaasWalletAccountError } from "./NotWaasWalletAccountError-CIjFmQ_l.esm.js";
+import { $ as extractSessionId, A as createApiClient, B as InvalidExternalAuthError, D as onceEvent, E as onEvent, F as getNonce, G as ValueMustBeDefinedError, I as SandboxMaximumThresholdReachedError, J as scrubParameters, K as __getElevatedAccessToken_wrapped, L as MfaRateLimitedError, Q as getOperatingSystem, R as MfaInvalidOtpError, S as splitWalletProviderKey, T as offEvent, U as isCookieEnabled, V as APIError, W as assertDefined, X as getUserAgent, Y as DEFAULT_PII_FIELDS, Z as getPlatform, at as setDefaultClient, b as formatWalletAccountId, ct as getCore, d as getWalletProviderRegistry, et as randomString, it as getDefaultClient, j as UnauthorizedError, k as fetchAndStoreNonces, l as getWalletProviderFromWalletAccount, lt as name, m as getWalletAccounts, o as DYNAMIC_ICONIC_SPRITE_URL, p as NoWalletProviderFoundError, q as instrumentFunction, rt as NONCE_POOL_SIZE, s as SDK_API_CORE_VERSION, st as BaseError, t as InvalidParamError, u as WalletProviderPriority, ut as version, v as getChainFromVerifiedCredentialChain, w as emitEvent, x as normalizeAddress, y as CHAINS_INFO_MAP, z as LinkCredentialError } from "./InvalidParamError-I6NfUdQL.esm.js";
+import { A as GENERATE_SESSION_KEYS_TRACKER_KEY, B as isEqualShallow, C as createKeychainService, D as CannotTrackError, F as getBuffer, I as createStorage, M as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, N as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, O as createDeferredPromise, P as isServerSideRendering, R as createLocalStorageAdapter, S as createRealtimeService, T as createCrossTabBroadcast, _ as consumeCaptchaToken, a as verifyMessageSignatureOwnership, b as NoNetworkProvidersError, c as formatSignInMessage, d as updateWalletProviderKeysForVerifiedCredentials, f as setUnverifiedWalletAccounts, g as MethodNotImplementedError, h as __setCaptchaToken_wrapped, i as getNetworksData, j as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, k as FETCH_PROJECT_SETTINGS_TRACKER_KEY, l as getAppMetadata, m as hasExtension, o as removeUnverifiedWalletAccount, p as createVisit, s as createSignInMessageStatement, t as getNetworkProviderFromNetworkId, u as reconcileWalletAccountsAgainstClient, v as isCaptchaRequired, w as createLogger, x as getKeychainIndexedDBName, y as WalletAlreadyLinkedToAnotherUserError, z as subscribeWithSelector } from "./getNetworkProviderFromNetworkId-D6ABmeNQ.esm.js";
+import { a as generateSessionKeys, c as isSignedIn, i as __logoutWithReason_wrapped, l as retryOnFail, n as getMfaMethods, o as fetchProjectSettings, r as __consumeMfaToken_wrapped, s as createStorageKeySchema, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-C1-1spV9.esm.js";
+import { a as parseElevatedAccessToken, d as checkAndRaiseWalletAccountsChangedEvent, i as upsertElevatedAccessToken, l as getWalletProviders, n as getVerifiedCredentialForWalletAccount, o as initializeWaasClientsForEagerRecovery, r as updateAuthFromVerifyResponse, t as getWalletProviderByKey, u as isUserMissingMfaAuth } from "./getWalletProviderByKey-DsTEubkT.esm.js";
+import { t as __refreshAuth_wrapped } from "./refreshAuth-BWQWl4uA.esm.js";
+import { n as NotWaasWalletAccountError } from "./isDynamicWaasEnabled-vRyWP-1l.esm.js";
+import { t as preconnectWaasIframe } from "./preconnectWaasIframe-Dn3RrrHd.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { AuthModeEnum, ExchangeKeyEnum, JwtVerifiedCredentialFormatEnum, MFAAction, MfaBackupCodeAcknowledgement, ProviderEnum, TokenScope, WaasBackupOptionsEnum, WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
 import * as z from "zod/mini";
@@ -516,7 +517,7 @@ const initializeClient = async (client = getDefaultClient()) => {
 		});
 		throw error;
 	}
-	if (client.user) restoreUserSharesForAllWalletAccounts(client);
+	if (client.user) initializeWaasClientsForEagerRecovery(client);
 };
 const __initializeClient_impl = initializeClient;
 const __initializeClient_wrapped = instrumentFunction({
@@ -2060,6 +2061,7 @@ const __signInWithSocialRedirect_wrapped = instrumentFunction({
 * removed in a future major version.
 *
 * @instrumented
+* @noHook Deprecated alias that is not exposed as a React hook.
 */
 const authenticateWithSocial = (params, client = getDefaultClient()) => __signInWithSocialRedirect_wrapped(params, client);
 const __authenticateWithSocial_impl = authenticateWithSocial;
@@ -2109,6 +2111,7 @@ const processSocialCallback = async ({ url, requestedScopes }, client) => {
 	if (storedSocialRedirectState.state !== dynamicOauthState) throw new InvalidRedirectStorageStateError();
 	const { provider, codeVerifier } = storedSocialRedirectState;
 	await core.storage.removeItem(redirectStateStorageKeySchema);
+	preconnectWaasIframe(client);
 	let response;
 	if (client.user) response = await apiClient.oauthVerify({
 		environmentId: core.environmentId,
@@ -2216,6 +2219,7 @@ const __completeSocialAuthentication_wrapped = instrumentFunction({
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to true if the URL is an OAuth redirect, false otherwise.
 * @not-instrumented
+* @noHook Low-level redirect-detection primitive that is not exposed as a React hook.
 */
 const detectSocialRedirectUrl = async ({ url }, client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -2498,10 +2502,13 @@ const withCheckoutSessionTokenCleanupOn401 = async ({ call, transactionId }, cli
 * exchange source record. The response includes `exchangeSource.metadata.url`
 * which can be embedded in an iframe for the user to complete payment.
 *
+* @deprecated Use {@link attachFlowSource} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params AttachCheckoutTransactionSourceParams - The source details to attach.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction (with exchangeSource if sourceType is 'exchange')
 * @instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const attachCheckoutTransactionSource = async (params, client = getDefaultClient()) => {
 	const { transactionId, sourceType = "wallet" } = params;
@@ -2545,10 +2552,13 @@ const __attachCheckoutTransactionSource_wrapped = instrumentFunction({
 * For exchange sources, `txHash` can be omitted — the user confirms
 * they completed the payment and the transaction moves to `broadcasted`.
 *
+* @deprecated Use {@link broadcastFlow} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params BroadcastCheckoutTransactionParams - The transaction ID and optional tx hash.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction
 * @instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const broadcastCheckoutTransaction = async ({ transactionId, txHash }, client = getDefaultClient()) => {
 	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
@@ -2580,10 +2590,13 @@ const __broadcastCheckoutTransaction_wrapped = instrumentFunction({
 /**
 * Cancels a checkout transaction before it has been broadcasted
 *
+* @deprecated Use {@link cancelFlow} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params CancelCheckoutTransactionParams - The transaction to cancel.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The cancelled checkout transaction
 * @instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const cancelCheckoutTransaction = async ({ transactionId }, client = getDefaultClient()) => {
 	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
@@ -2625,10 +2638,13 @@ const getCheckouts = async (client) => {
 /**
 * Creates a new checkout transaction and stores the session token for subsequent calls
 *
+* @deprecated Use the Flow API instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params CreateCheckoutTransactionParams - The parameters for the checkout transaction.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The created transaction with session token
 * @instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const createCheckoutTransaction = async (params, client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -2671,10 +2687,13 @@ const __createCheckoutTransaction_wrapped = instrumentFunction({
 /**
 * Fetches the current state of a checkout transaction
 *
+* @deprecated Use {@link getFlow} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params GetCheckoutTransactionParams - The parameters for fetching the transaction.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The checkout transaction
 * @not-instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const getCheckoutTransaction = async ({ transactionId }, client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -2689,10 +2708,13 @@ const getCheckoutTransaction = async ({ transactionId }, client = getDefaultClie
 /**
 * Fetches a quote for a checkout transaction
 *
+* @deprecated Use {@link getFlowQuote} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params GetCheckoutTransactionQuoteParams - The quote parameters.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction with quote data
 * @not-instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const getCheckoutTransactionQuote = async ({ fromChainId, fromTokenAddress, slippage, transactionId }, client = getDefaultClient()) => {
 	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
@@ -2718,10 +2740,13 @@ const getCheckoutTransactionQuote = async ({ fromChainId, fromTokenAddress, slip
 * This should be called immediately before triggering the transaction signing.
 * It will confirm the quote is still valid, the risk state is cleared, and the transaction is ready to be signed.
 *
+* @deprecated Use {@link prepareFlowSigning} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params PrepareCheckoutTransactionParams - The transaction to prepare.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction
 * @instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const prepareCheckoutTransaction = async ({ assertBalanceForGasCost, assertBalanceForTransferAmount, transactionId }, client = getDefaultClient()) => {
 	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
@@ -2865,10 +2890,13 @@ const __executeSwapTransaction_wrapped = instrumentFunction({
 * 3. Delegates on-chain signing to the wallet provider's executeSwapTransaction method
 * 4. Calls broadcastCheckoutTransaction with the resulting txHash
 *
+* @deprecated Use {@link submitFlowTransaction} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params SubmitCheckoutTransactionParams - The transaction ID, wallet account, and optional step callback.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The broadcasted checkout transaction
 * @instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const submitCheckoutTransaction = async ({ onStepChange, transactionId, walletAccount, assertBalanceForGasCost, assertBalanceForTransferAmount }, client = getDefaultClient()) => {
 	const signingPayload = (await __prepareCheckoutTransaction_wrapped({
@@ -2916,9 +2944,12 @@ const __submitCheckoutTransaction_wrapped = instrumentFunction({
 * the realtime checkout transaction channel. Will be re-enabled once the
 * dashboard-api environment has the Ably wiring in place.
 *
+* @deprecated Use the Flow API instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params.transactionId - The ID of the checkout transaction to track.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @not-instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const trackCheckoutTransaction = (_params, client = getDefaultClient()) => {
 	return Promise.resolve();
@@ -2935,10 +2966,13 @@ const trackCheckoutTransaction = (_params, client = getDefaultClient()) => {
 * Returns `false` when the from token already matches a settlement token, so no
 * conversion is needed.
 *
+* @deprecated Use the Flow API instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params - The from token details and the checkout's settlement config.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns Whether a token conversion is required
 * @not-instrumented
+* @noHook Legacy checkout function not exposed as a React hook; the checkout product is being renamed to flow.
 */
 const requiresConversion = async ({ transaction }, client = getDefaultClient()) => {
 	if (!transaction.fromChainId || !transaction.fromChainName || !transaction.fromToken) throw new InvalidParamError("Transaction is missing source information. Make sure that attachCheckoutTransactionSource has been called before calling this function.");
@@ -4830,7 +4864,9 @@ const __setDefaultMfaDevice_wrapped = instrumentFunction({
 */
 const sendEmailOTP = async ({ email }, client = getDefaultClient()) => {
 	const core = getCore(client);
-	const { verificationUUID } = await createApiClient({}, client).createEmailVerification({
+	const apiClient = createApiClient({}, client);
+	preconnectWaasIframe(client);
+	const { verificationUUID } = await apiClient.createEmailVerification({
 		emailVerificationCreateRequest: {
 			captchaToken: consumeCaptchaToken(client),
 			email
@@ -5793,6 +5829,7 @@ const sendSmsOTP = async ({ isoCountryCode, phoneNumber }, client = getDefaultCl
 	const core = getCore(client);
 	const apiClient = createApiClient({}, client);
 	const phoneCountryCode = supportedCountries[isoCountryCode].code;
+	preconnectWaasIframe(client);
 	const { verificationUUID } = await apiClient.createSmsVerification({
 		environmentId: core.environmentId,
 		smsVerificationCreateRequest: {
@@ -5880,6 +5917,7 @@ const verifyOTPForUserUpdate = async ({ otpVerification, verificationToken, requ
 * @redact-params
 */
 const verifyOTP = async ({ otpVerification, verificationToken, requestedScopes }, client = getDefaultClient()) => {
+	preconnectWaasIframe(client);
 	let response;
 	if (client.user) response = await verifyOTPForUserUpdate({
 		otpVerification,
@@ -7676,6 +7714,7 @@ const __connectAndVerifyWithWalletProvider_wrapped = instrumentFunction({
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An array of wallet provider data including chain, keys, and metadata.
 * @not-instrumented
+* @hook Exposed as a hook so consumers get the reactive list of available wallet providers, updated when wallet providers change.
 */
 const getAvailableWalletProvidersData = (client = getDefaultClient()) => {
 	return getWalletProviders(client).filter((walletProvider) => hasWalletProviderConnectMethod({ walletProvider })).map((walletProvider) => ({