@dynamic-labs-sdk/client 0.24.1 → 0.25.0

package/dist/index.esm.js

@@ -1,8 +1,8 @@
-import { A as ValueMustBeDefinedError, B as name, D as extractSessionId, E as getUserAgent, F as getDefaultClient, I as setDefaultClient, M as CLIENT_SDK_NAME, O as isCookieEnabled, P as NONCE_POOL_SIZE, R as BaseError, S as __getElevatedAccessToken_wrapped, T as DEFAULT_PII_FIELDS, V as version, _ as MfaRateLimitedError, a as DYNAMIC_ICONIC_SPRITE_URL, b as InvalidExternalAuthError, c as CHAINS_INFO_MAP, d as UnauthorizedError, g as SandboxMaximumThresholdReachedError, h as __getNonce_wrapped, j as randomString, k as assertDefined, l as fetchAndStoreNonces, o as SDK_API_CORE_VERSION, s as __getChainFromVerifiedCredentialChain_wrapped, t as InvalidParamError, u as __createApiClient_wrapped, v as MfaInvalidOtpError, w as instrumentFunction, x as APIError, y as LinkCredentialError, z as getCore } from "./InvalidParamError-Bq5zAFj4.esm.js";
-import { A as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, D as GENERATE_SESSION_KEYS_TRACKER_KEY, E as FETCH_PROJECT_SETTINGS_TRACKER_KEY, F as __createStorage_wrapped, L as __createLocalStorageAdapter_wrapped, M as getBuffer, N as __generateSessionKeys_wrapped, O as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, P as __createStorageKeySchema_wrapped, R as __subscribeWithSelector_wrapped, S as __createCrossTabBroadcast_wrapped, T as __createDeferredPromise_wrapped, _ as WalletAlreadyLinkedToAnotherUserError, a as __updateWalletProviderKeysForVerifiedCredentials_wrapped, b as __createIndexedDBKeychainService_wrapped, c as __createSignInMessageStatement_wrapped, d as __createVisit_wrapped, f as hasExtension, g as isCaptchaRequired, h as __consumeCaptchaToken_wrapped, i as __getNetworksData_wrapped, j as isServerSideRendering, k as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, l as formatSignInMessage, m as __setCaptchaToken_wrapped, o as __verifyMessageSignatureOwnership_wrapped, p as __createRealtimeChannelSchema_wrapped, s as __removeUnverifiedWalletAccount_wrapped, t as __getNetworkProviderFromNetworkId_wrapped, u as __setUnverifiedWalletAccounts_wrapped, v as NoNetworkProvidersError, w as CannotTrackError, x as __createLogger_wrapped, y as __createRealtimeService_wrapped, z as isEqualShallow } from "./getNetworkProviderFromNetworkId-C4aba1hS.esm.js";
-import { A as setCookie, C as normalizeAddress, D as __onEvent_wrapped, E as __offEvent_wrapped, O as __onceEvent_wrapped, S as formatWalletAccountId, a as parseElevatedAccessToken, d as checkAndRaiseWalletAccountsChangedEvent, f as emitWalletAccountsChangedEvent, i as upsertElevatedAccessToken, k as emitEvent, m as __getWalletProviderFromWalletAccount_wrapped, n as getWalletProviderByKey, o as restoreUserSharesForAllWalletAccounts, p as DYNAMIC_AUTH_COOKIE_NAME, r as __updateAuthFromVerifyResponse_wrapped, t as __getVerifiedCredentialForWalletAccount_wrapped, u as __getWalletProviders_wrapped, v as NoWalletProviderFoundError, w as splitWalletProviderKey, y as __getWalletAccounts_wrapped } from "./getVerifiedCredentialForWalletAccount-Y-aJ2rY7.esm.js";
-import { n as __refreshAuth_wrapped, t as NotWaasWalletAccountError } from "./NotWaasWalletAccountError-CIJRq-EG.esm.js";
-import { n as __getMfaMethods_wrapped, r as __consumeMfaToken_wrapped, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-Cc6jkbY5.esm.js";
+import { A as ValueMustBeDefinedError, B as name, D as extractSessionId, E as getUserAgent, F as getDefaultClient, I as setDefaultClient, M as CLIENT_SDK_NAME, O as isCookieEnabled, P as NONCE_POOL_SIZE, R as BaseError, S as __getElevatedAccessToken_wrapped, T as DEFAULT_PII_FIELDS, V as version, _ as MfaRateLimitedError, a as DYNAMIC_ICONIC_SPRITE_URL, b as InvalidExternalAuthError, c as CHAINS_INFO_MAP, d as UnauthorizedError, g as SandboxMaximumThresholdReachedError, h as __getNonce_wrapped, j as randomString, k as assertDefined, l as fetchAndStoreNonces, o as SDK_API_CORE_VERSION, s as __getChainFromVerifiedCredentialChain_wrapped, t as InvalidParamError, u as __createApiClient_wrapped, v as MfaInvalidOtpError, w as instrumentFunction, x as APIError, y as LinkCredentialError, z as getCore } from "./InvalidParamError-BiVmL7nM.esm.js";
+import { A as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, D as GENERATE_SESSION_KEYS_TRACKER_KEY, E as FETCH_PROJECT_SETTINGS_TRACKER_KEY, F as __createStorage_wrapped, L as __createLocalStorageAdapter_wrapped, M as getBuffer, N as __generateSessionKeys_wrapped, O as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, P as __createStorageKeySchema_wrapped, R as __subscribeWithSelector_wrapped, S as __createCrossTabBroadcast_wrapped, T as __createDeferredPromise_wrapped, _ as WalletAlreadyLinkedToAnotherUserError, a as __updateWalletProviderKeysForVerifiedCredentials_wrapped, b as __createIndexedDBKeychainService_wrapped, c as __createSignInMessageStatement_wrapped, d as __createVisit_wrapped, f as hasExtension, g as isCaptchaRequired, h as __consumeCaptchaToken_wrapped, i as __getNetworksData_wrapped, j as isServerSideRendering, k as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, l as formatSignInMessage, m as __setCaptchaToken_wrapped, o as __verifyMessageSignatureOwnership_wrapped, p as __createRealtimeChannelSchema_wrapped, s as __removeUnverifiedWalletAccount_wrapped, t as __getNetworkProviderFromNetworkId_wrapped, u as __setUnverifiedWalletAccounts_wrapped, v as NoNetworkProvidersError, w as CannotTrackError, x as __createLogger_wrapped, y as __createRealtimeService_wrapped, z as isEqualShallow } from "./getNetworkProviderFromNetworkId-5dK99mQR.esm.js";
+import { A as setCookie, C as normalizeAddress, D as __onEvent_wrapped, E as __offEvent_wrapped, O as __onceEvent_wrapped, S as formatWalletAccountId, a as parseElevatedAccessToken, d as checkAndRaiseWalletAccountsChangedEvent, f as emitWalletAccountsChangedEvent, i as upsertElevatedAccessToken, k as emitEvent, m as __getWalletProviderFromWalletAccount_wrapped, n as getWalletProviderByKey, o as restoreUserSharesForAllWalletAccounts, p as DYNAMIC_AUTH_COOKIE_NAME, r as __updateAuthFromVerifyResponse_wrapped, t as __getVerifiedCredentialForWalletAccount_wrapped, u as __getWalletProviders_wrapped, v as NoWalletProviderFoundError, w as splitWalletProviderKey, y as __getWalletAccounts_wrapped } from "./getVerifiedCredentialForWalletAccount-ByUSFAHs.esm.js";
+import { n as __refreshAuth_wrapped, t as NotWaasWalletAccountError } from "./NotWaasWalletAccountError-Bo4VhW4n.esm.js";
+import { n as __getMfaMethods_wrapped, r as __consumeMfaToken_wrapped, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-SFbQW5j5.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";
@@ -1232,7 +1232,8 @@ const createCore = (config) => {
 		state,
 		storage,
 		transformers: config.transformers,
-		version
+		version,
+		waas: config.waas
 	};
 };
 
@@ -1783,7 +1784,6 @@ const __requestExternalAuthElevatedToken_wrapped = instrumentFunction({
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the authentication response from the server.
 * @instrumented
-
 * @redact-params
 */
 const signInWithExternalJwt = async ({ externalJwt, sessionPublicKey } = {}, client = getDefaultClient()) => {
@@ -2485,22 +2485,29 @@ const createCheckoutApiClient = async ({ transactionId }, client) => {
 //#endregion
 //#region src/modules/checkout/attachCheckoutTransactionSource/attachCheckoutTransactionSource.ts
 /**
-* Attaches a wallet source to a checkout transaction
+* Attaches a payment source to a checkout transaction.
+*
+* For exchange sources, the backend generates the buy URL and creates the
+* exchange source record. The response includes `exchangeSource.metadata.url`
+* which can be embedded in an iframe for the user to complete payment.
 *
 * @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
+* @returns The updated checkout transaction (with exchangeSource if sourceType is 'exchange')
 * @instrumented
 */
-const attachCheckoutTransactionSource = async ({ fromAddress, fromChainId, fromChainName, transactionId }, client = getDefaultClient()) => {
+const attachCheckoutTransactionSource = async (params, client = getDefaultClient()) => {
+	const { transactionId, sourceType = "wallet" } = params;
 	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	const attachSourceRequest = { sourceType };
+	if (params.sourceType === "exchange") attachSourceRequest.exchangeProvider = params.exchangeProvider;
+	else {
+		attachSourceRequest.fromAddress = params.fromAddress;
+		attachSourceRequest.fromChainId = params.fromChainId;
+		attachSourceRequest.fromChainName = params.fromChainName;
+	}
 	return apiClient.attachSource({
-		attachSourceRequest: {
-			fromAddress,
-			fromChainId,
-			fromChainName,
-			sourceType: "wallet"
-		},
+		attachSourceRequest,
 		environmentId,
 		transactionId,
 		xDynamicCheckoutSessionToken: sessionToken
@@ -2522,9 +2529,13 @@ const __attachCheckoutTransactionSource_wrapped = instrumentFunction({
 //#endregion
 //#region src/modules/checkout/broadcastCheckoutTransaction/broadcastCheckoutTransaction.ts
 /**
-* Records the on-chain broadcast of a checkout transaction
+* Records that a checkout transaction has been broadcasted.
+*
+* For wallet sources, pass the `txHash` from the on-chain transaction.
+* For exchange sources, `txHash` can be omitted — the user confirms
+* they completed the payment and the transaction moves to `broadcasted`.
 *
-* @param params BroadcastCheckoutTransactionParams - The transaction ID and tx hash.
+* @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
@@ -2639,8 +2650,20 @@ const isTerminalEvent = (data) => {
 * @not-instrumented
 */
 const subscribeToCheckoutTransaction = async ({ transactionId }, client) => {
-	const { realtime } = getCore(client);
-	if (realtime.getConnectionState() === "idle") await realtime.connect({ client });
+	const core = getCore(client);
+	const { realtime } = core;
+	if (realtime.getConnectionState() === "idle") {
+		const sessionToken = await core.storage.getItem(createCheckoutSessionTokenStorageKey(transactionId));
+		const headers = {};
+		if (sessionToken) {
+			headers["x-dynamic-checkout-session-token"] = sessionToken;
+			headers["x-dynamic-checkout-transaction-id"] = transactionId;
+		}
+		await realtime.connect({
+			client,
+			headers
+		});
+	}
 	const channelSchema = createCheckoutTransactionChannelSchema(transactionId);
 	const handler = ({ data }) => {
 		if (data.axis === "execution") emitEvent({
@@ -2943,6 +2966,36 @@ const __submitCheckoutTransaction_wrapped = instrumentFunction({
 	}
 });
 
+//#endregion
+//#region src/modules/checkout/trackCheckoutTransaction/trackCheckoutTransaction.ts
+/**
+* Subscribes to realtime `checkoutTransactionExecutionStateChanged` and
+* `checkoutTransactionSettlementStateChanged` events for an existing
+* checkout transaction.
+*
+* This is only needed after a page refresh to re-establish the subscription.
+* Transactions created with {@link createCheckoutTransaction} are automatically
+* subscribed — calling this again for those is unnecessary unless the page
+* has been reloaded.
+*
+* @param params.transactionId - The ID of the checkout transaction to track.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @instrumented
+*/
+const trackCheckoutTransaction = ({ transactionId }, client = getDefaultClient()) => subscribeToCheckoutTransaction({ transactionId }, client);
+const __trackCheckoutTransaction_impl = trackCheckoutTransaction;
+const __trackCheckoutTransaction_wrapped = instrumentFunction({
+	fn: __trackCheckoutTransaction_impl,
+	functionName: "trackCheckoutTransaction",
+	getCore: () => {
+		try {
+			return getCore(getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/checkout/utils/requiresConversion/requiresConversion.ts
 /**
@@ -2978,32 +3031,6 @@ const __requiresConversion_wrapped = instrumentFunction({
 	}
 });
 
-//#endregion
-//#region src/modules/checkout/trackCheckoutTransaction/trackCheckoutTransaction.ts
-/**
-* Subscribes to realtime state change events for an existing checkout transaction.
-*
-* Call this after a page refresh to resume receiving transaction events
-* for a transaction that was created in a previous page session.
-*
-* @param params.transactionId - The ID of the checkout transaction to track.
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @instrumented
-*/
-const trackCheckoutTransaction = ({ transactionId }, client = getDefaultClient()) => subscribeToCheckoutTransaction({ transactionId }, client);
-const __trackCheckoutTransaction_impl = trackCheckoutTransaction;
-const __trackCheckoutTransaction_wrapped = instrumentFunction({
-	fn: __trackCheckoutTransaction_impl,
-	functionName: "trackCheckoutTransaction",
-	getCore: () => {
-		try {
-			return getCore(getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/modules/deviceRegistration/completeDeviceRegistration/completeDeviceRegistration.ts
 const DEVICE_REGISTRATION_TOKEN_HEADER = "x-dynamic-device-registration-token";
@@ -4042,7 +4069,6 @@ const __getWalletConnectCatalogWalletByWalletProviderKey_wrapped = instrumentFun
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to OTP verification details if verification is required, or undefined.
 * @instrumented
-
 * @redact-params
 */
 const updateUser = async ({ userFields }, client = getDefaultClient()) => {
@@ -4557,7 +4583,6 @@ const __setDefaultMfaDevice_wrapped = instrumentFunction({
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to an OTPVerification object containing the email and verification UUID.
 * @instrumented
-
 * @redact-params
 */
 const sendEmailOTP = async ({ email }, client = getDefaultClient()) => {
@@ -5519,7 +5544,6 @@ const supportedCountries = {
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to an OTPVerification object containing the phone details and verification UUID.
 * @instrumented
-
 * @redact-params
 */
 const sendSmsOTP = async ({ isoCountryCode, phoneNumber }, client = getDefaultClient()) => {