@dynamic-labs-sdk/client 1.10.0 → 1.11.0

package/dist/index.cjs

@@ -1,9 +1,9 @@
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-C9Fw0v_g.cjs');
-const require_InvalidParamError = require('./InvalidParamError-CGZRSAOn.cjs');
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-2wYAIZ6w.cjs');
-const require_getWalletProviderByKey = require('./getWalletProviderByKey-DMNpwDEn.cjs');
-const require_refreshAuth = require('./refreshAuth-DfcR3CWf.cjs');
-const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-cIj987D7.cjs');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-CxWuGsmB.cjs');
+const require_InvalidParamError = require('./InvalidParamError-CMesesy6.cjs');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-D4xzWb7w.cjs');
+const require_getWalletProviderByKey = require('./getWalletProviderByKey-1zHjzqbz.cjs');
+const require_refreshAuth = require('./refreshAuth-CKcNynMk.cjs');
+const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-D-yqOoH6.cjs');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_api_core = require("@dynamic-labs/sdk-api-core");
 let zod_mini = require("zod/mini");
@@ -363,6 +363,7 @@ const initializeStorageSync = async (client) => {
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the authenticated user.
 * @instrumented
+* @noHook Low-level refresh primitive that is not exposed as a React hook.
 */
 const refreshUser = async (client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
@@ -415,6 +416,7 @@ var ClientAlreadyInitializedError = class extends require_InvalidParamError.Base
 * @returns A promise that resolves when initialization is complete.
 * @throws ClientAlreadyInitializedError If the client is already initialized.
 * @instrumented
+* @noHook Client lifecycle management is not exposed as a React hook.
 */
 const initializeClient = async (client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
@@ -1857,6 +1859,7 @@ const __signInWithPasskey_wrapped = require_InvalidParamError.instrumentFunction
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An array of `SocialAccount` objects associated with the user.
 * @not-instrumented
+* @hook Exposed as a hook so consumers get the reactive list of social accounts, updated when the user changes.
 */
 const getUserSocialAccounts = (client = require_InvalidParamError.getDefaultClient()) => {
 	const { user } = client;
@@ -2186,6 +2189,7 @@ const __completeSocialRedirect_wrapped = require_InvalidParamError.instrumentFun
 * removed in a future major version.
 *
 * @instrumented
+* @noHook Deprecated alias; the replacement is exposed via its own hook.
 */
 const completeSocialAuthentication = (params, client = require_InvalidParamError.getDefaultClient()) => __completeSocialRedirect_wrapped(params, client);
 const __completeSocialAuthentication_impl = completeSocialAuthentication;
@@ -2231,6 +2235,7 @@ const detectSocialRedirectUrl = async ({ url }, client = require_InvalidParamErr
 * removed in a future major version.
 *
 * @not-instrumented
+* @noHook Deprecated alias; the replacement is exposed via its own hook.
 */
 const detectOAuthRedirect = (params, client = require_InvalidParamError.getDefaultClient()) => detectSocialRedirectUrl(params, client);
 
@@ -2375,6 +2380,7 @@ const getTokenBalances = async ({ walletAccount, networkId, networkIds, includeP
 * multi-chain `getMultichainTokenBalances`.
 *
 * @not-instrumented
+* @noHook Deprecated; the replacement is exposed via its own hook.
 */
 const getBalances = (params, client = require_InvalidParamError.getDefaultClient()) => getTokenBalances(params, client);
 
@@ -2410,6 +2416,7 @@ const getMultichainTokenBalances = async ({ balanceRequest }, client = require_I
 * token balances (not native-only) across multiple chains.
 *
 * @not-instrumented
+* @noHook Deprecated; the replacement is exposed via its own hook.
 */
 const getMultichainBalances = (params, client = require_InvalidParamError.getDefaultClient()) => getMultichainTokenBalances(params, client);
 
@@ -3193,6 +3200,96 @@ const __attachFlowSource_wrapped = require_InvalidParamError.instrumentFunction(
 	}
 });
 
+//#endregion
+//#region src/modules/flow/utils/createFlowApiClient/createFlowApiClient.ts
+/** @not-instrumented */
+const createFlowApiClient = async ({ flowId }, client) => {
+	const core = require_InvalidParamError.getCore(client);
+	const apiClient = require_InvalidParamError.createApiClient({}, client);
+	const sessionToken = await core.storage.getItem(createFlowSessionTokenStorageKey(flowId));
+	if (!sessionToken) throw new FlowSessionTokenMissingError({ flowId });
+	return {
+		apiClient,
+		environmentId: core.environmentId,
+		sessionToken
+	};
+};
+
+//#endregion
+//#region src/modules/flow/broadcastFlow/broadcastFlow.ts
+/**
+* Records that a flow 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 flow moves to `broadcasted`.
+*
+* @param params BroadcastFlowParams - The flow ID and optional tx hash.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The updated flow
+* @instrumented
+*/
+const broadcastFlow = async ({ flowId, txHash }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createFlowApiClient({ flowId }, client);
+	return withFlowSessionTokenCleanupOn401({
+		call: () => apiClient.broadcastFlow({
+			environmentId,
+			flowId,
+			flowRecordBroadcastRequest: { txHash },
+			xDynamicFlowSessionToken: sessionToken
+		}),
+		flowId
+	}, client);
+};
+const __broadcastFlow_impl = broadcastFlow;
+const __broadcastFlow_wrapped = require_InvalidParamError.instrumentFunction({
+	fn: __broadcastFlow_impl,
+	functionName: "broadcastFlow",
+	getCore: () => {
+		try {
+			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
+//#endregion
+//#region src/modules/flow/cancelFlow/cancelFlow.ts
+/**
+* Cancels a flow before it has been broadcasted
+*
+* @param params CancelFlowParams - The flow to cancel.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The cancelled flow
+* @instrumented
+*/
+const cancelFlow = async ({ flowId }, client = require_InvalidParamError.getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createFlowApiClient({ flowId }, client);
+	const result = await withFlowSessionTokenCleanupOn401({
+		call: () => apiClient.cancelFlow({
+			environmentId,
+			flowId,
+			xDynamicFlowSessionToken: sessionToken
+		}),
+		flowId
+	}, client);
+	await clearFlowSessionToken({ flowId }, client);
+	return result;
+};
+const __cancelFlow_impl = cancelFlow;
+const __cancelFlow_wrapped = require_InvalidParamError.instrumentFunction({
+	fn: __cancelFlow_impl,
+	functionName: "cancelFlow",
+	getCore: () => {
+		try {
+			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/flow/getFlow/getFlow.ts
 /**
@@ -3211,21 +3308,6 @@ const getFlow = async ({ flowId }, client = require_InvalidParamError.getDefault
 	});
 };
 
-//#endregion
-//#region src/modules/flow/utils/createFlowApiClient/createFlowApiClient.ts
-/** @not-instrumented */
-const createFlowApiClient = async ({ flowId }, client) => {
-	const core = require_InvalidParamError.getCore(client);
-	const apiClient = require_InvalidParamError.createApiClient({}, client);
-	const sessionToken = await core.storage.getItem(createFlowSessionTokenStorageKey(flowId));
-	if (!sessionToken) throw new FlowSessionTokenMissingError({ flowId });
-	return {
-		apiClient,
-		environmentId: core.environmentId,
-		sessionToken
-	};
-};
-
 //#endregion
 //#region src/modules/flow/getFlowQuote/getFlowQuote.ts
 /**
@@ -3293,6 +3375,52 @@ const __prepareFlowSigning_wrapped = require_InvalidParamError.instrumentFunctio
 	}
 });
 
+//#endregion
+//#region src/modules/flow/submitFlowTransaction/submitFlowTransaction.ts
+/**
+* Prepares, signs, and broadcasts a flow transaction in one call.
+*
+* Orchestrates the full submission flow:
+* 1. Calls prepareFlowSigning to advance to signing state and lock the quote
+* 2. Ensures the wallet is on the correct network for the transaction
+* 3. Delegates on-chain signing to the wallet provider's executeSwapTransaction method
+* 4. Calls broadcastFlow with the resulting txHash
+*
+* @param params SubmitFlowTransactionParams - The flow ID, wallet account, and optional step callback.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The broadcasted flow
+* @instrumented
+*/
+const submitFlowTransaction = async ({ onStepChange, flowId, walletAccount, assertBalanceForGasCost, assertBalanceForTransferAmount }, client = require_InvalidParamError.getDefaultClient()) => {
+	const signingPayload = (await __prepareFlowSigning_wrapped({
+		assertBalanceForGasCost,
+		assertBalanceForTransferAmount,
+		flowId
+	}, client)).quote?.signingPayload;
+	require_InvalidParamError.assertDefined(signingPayload, "No signing payload returned from prepare — quote may be missing transaction data");
+	const { transactionHash } = await __executeSwapTransaction_wrapped({
+		onStepChange,
+		signingPayload,
+		walletAccount
+	}, client);
+	return __broadcastFlow_wrapped({
+		flowId,
+		txHash: transactionHash
+	}, client);
+};
+const __submitFlowTransaction_impl = submitFlowTransaction;
+const __submitFlowTransaction_wrapped = require_InvalidParamError.instrumentFunction({
+	fn: __submitFlowTransaction_impl,
+	functionName: "submitFlowTransaction",
+	getCore: () => {
+		try {
+			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/funding/coinbase/addCoinbaseOnrampOrderEventListener/addCoinbaseOnrampOrderEventListener.ts
 /**
@@ -3304,6 +3432,7 @@ const __prepareFlowSigning_wrapped = require_InvalidParamError.instrumentFunctio
 * @throws {ValueMustBeDefinedError} If the window is not available.
 * @docs https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/apple-pay-onramp-api#events-names
 * @not-instrumented
+* @hook Event listeners are error-prone to wire up by hand with useEffect.
 */
 const addCoinbaseOnrampOrderEventListener = ({ listener }, client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
@@ -3688,6 +3817,7 @@ const __getMoonPayUrl_wrapped = require_InvalidParamError.instrumentFunction({
 *
 * @returns a promise that resolves once the client is fully initialized.
 * @not-instrumented
+* @noHook Client lifecycle management is not exposed as a hook; use useInitStatus.
 */
 const waitForClientInitialized = async (client = require_InvalidParamError.getDefaultClient()) => {
 	await require_InvalidParamError.getCore(client).initTrack.waitForAll();
@@ -7774,6 +7904,7 @@ const getNativeBalance = async ({ walletAccount }, client = require_InvalidParam
 * `getMultichainTokenBalances`).
 *
 * @not-instrumented
+* @noHook Deprecated; the replacement is exposed via its own hook.
 */
 const getBalance = (params, client = require_InvalidParamError.getDefaultClient()) => getNativeBalance(params, client);
 
@@ -7891,6 +8022,7 @@ const __switchActiveNetwork_wrapped = require_InvalidParamError.instrumentFuncti
 /**
 * Make the wallet account provided as the primary wallet account.
 * @instrumented
+* @noHook The primary-wallet concept is discouraged and not exposed as a hook.
 */
 const selectPrimaryWalletAccount = async ({ walletAccount }, client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
@@ -8135,6 +8267,7 @@ const offWalletProviderEvent = ({ callback, event, walletProviderKey }, client =
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A function that can be called to remove the listener.
 * @not-instrumented
+* @hook Event listeners are error-prone to wire up by hand with useEffect.
 */
 const onWalletProviderEvent = ({ callback, event, walletProviderKey }, client = require_InvalidParamError.getDefaultClient()) => {
 	const walletProvider = require_getWalletProviderByKey.getWalletProviderByKey({ walletProviderKey }, client);
@@ -8315,8 +8448,10 @@ exports.authenticatePasskeyMFA = authenticatePasskeyMFA;
 exports.authenticateTotpMfaDevice = authenticateTotpMfaDevice;
 exports.authenticateWithSocial = __authenticateWithSocial_wrapped;
 exports.broadcastCheckoutTransaction = __broadcastCheckoutTransaction_wrapped;
+exports.broadcastFlow = __broadcastFlow_wrapped;
 exports.canConnectWithHardwareWallet = canConnectWithHardwareWallet;
 exports.cancelCheckoutTransaction = __cancelCheckoutTransaction_wrapped;
+exports.cancelFlow = __cancelFlow_wrapped;
 exports.checkStepUpAuth = __checkStepUpAuth_wrapped;
 exports.completeDeviceRegistration = __completeDeviceRegistration_wrapped;
 exports.completeSocialAuthentication = __completeSocialAuthentication_wrapped;
@@ -8435,6 +8570,7 @@ exports.signInWithSocialPopUp = __signInWithSocialPopUp_wrapped;
 exports.signInWithSocialRedirect = __signInWithSocialRedirect_wrapped;
 exports.signMessage = __signMessage_wrapped;
 exports.submitCheckoutTransaction = __submitCheckoutTransaction_wrapped;
+exports.submitFlowTransaction = __submitFlowTransaction_wrapped;
 exports.supportedCountries = supportedCountries;
 exports.switchActiveNetwork = __switchActiveNetwork_wrapped;
 exports.trackCheckoutTransaction = trackCheckoutTransaction;