@dynamic-labs-sdk/client 0.23.3 → 0.24.0

package/dist/index.cjs.js

@@ -1,8 +1,8 @@
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-Its21Jgg.cjs.js');
-const require_InvalidParamError = require('./InvalidParamError-AGSIdKWg.cjs.js');
-const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-CExk0n4h.cjs.js');
-const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-BF6AAjX2.cjs.js');
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-Drc_xwpq.cjs.js');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-B8OjAdet.cjs.js');
+const require_InvalidParamError = require('./InvalidParamError-BgmShvv_.cjs.js');
+const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-CBJrrV08.cjs.js');
+const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-qK9GIBpr.cjs.js');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-9NDyQhHS.cjs.js');
 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");
@@ -589,6 +589,40 @@ const initializeStorageSync = async (client) => {
 	syncStateWithStorage(client);
 };
 
+//#endregion
+//#region src/modules/user/refreshUser/refreshUser.ts
+/**
+* Refreshes the current user's data from the server.
+*
+* This function fetches the latest authenticated user information from the backend
+* and updates the local user state.
+*
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise that resolves to the authenticated user.
+* @instrumented
+*/
+const refreshUser = async (client = require_InvalidParamError.getDefaultClient()) => {
+	const core = require_InvalidParamError.getCore(client);
+	const apiClient = require_InvalidParamError.__createApiClient_wrapped({}, client);
+	const previousState = { ...core.state.get() };
+	const user = await apiClient.getAuthenticatedUser({ environmentId: core.environmentId });
+	core.state.set({ user });
+	require_getVerifiedCredentialForWalletAccount.checkAndRaiseWalletAccountsChangedEvent({ previousState }, client);
+	return user;
+};
+const __refreshUser_impl = refreshUser;
+const __refreshUser_wrapped = require_InvalidParamError.instrumentFunction({
+	fn: __refreshUser_impl,
+	functionName: "refreshUser",
+	getCore: () => {
+		try {
+			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/errors/ClientAlreadyInitializedError.ts
 var ClientAlreadyInitializedError = class extends require_InvalidParamError.BaseError {
@@ -675,6 +709,16 @@ const initializeClient = async (client = require_InvalidParamError.getDefaultCli
 			} else throw error;
 		});
 	});
+	/**
+	* When a token is persisted but the user state was lost (e.g. storage cleared
+	* partially), re-fetch the user from the server. This path is skipped when
+	* cookies are enabled because the token is not stored in SDK state.
+	*/
+	const refreshUserStateFromValidTokenPromise = refreshUserStateFromCookiePromise.then(async () => {
+		if (core.state.get().token && !core.state.get().user) await __refreshUser_wrapped(client).catch(async () => {
+			await __logout_wrapped(client);
+		});
+	});
 	core.initTrack.track({
 		name: require_getNetworkProviderFromNetworkId.INITIALIZE_STORAGE_SYNC_TRACKER_KEY,
 		promise: initializeStorageSyncPromise
@@ -691,6 +735,10 @@ const initializeClient = async (client = require_InvalidParamError.getDefaultCli
 		name: require_getNetworkProviderFromNetworkId.REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY,
 		promise: refreshUserStateFromCookiePromise
 	});
+	core.initTrack.track({
+		name: require_getNetworkProviderFromNetworkId.REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY,
+		promise: refreshUserStateFromValidTokenPromise
+	});
 	try {
 		await core.initTrack.waitForAll();
 		core.state.set({ initStatus: "finished" });
@@ -2547,6 +2595,85 @@ const getCheckouts = async (client) => {
 	return projectSettings.checkouts ?? [];
 };
 
+//#endregion
+//#region src/modules/checkout/utils/createCheckoutTransactionChannelSchema/createCheckoutTransactionChannelSchema.ts
+/**
+* Zod schema for realtime events published to a checkout transaction's channel.
+* Uses z.string() for axis and state fields to remain valid when new states are
+* added to the backend without requiring a SDK update.
+*/
+const checkoutTransactionEventSchema = zod_mini.object({
+	axis: zod_mini.string(),
+	newState: zod_mini.string(),
+	previousState: zod_mini.string(),
+	timestamp: zod_mini.string(),
+	transactionId: zod_mini.string()
+});
+/**
+* Creates a typed realtime channel schema for a given checkout transaction.
+* Channel name follows the backend convention: `transaction:{transactionId}`.
+* @not-instrumented
+*/
+const createCheckoutTransactionChannelSchema = (transactionId) => require_getNetworkProviderFromNetworkId.__createRealtimeChannelSchema_wrapped({
+	channel: `transaction:${transactionId}`,
+	schema: checkoutTransactionEventSchema
+});
+
+//#endregion
+//#region src/modules/checkout/utils/subscribeToCheckoutTransaction/subscribeToCheckoutTransaction.ts
+const TERMINAL_EXECUTION_STATES = new Set([
+	"cancelled",
+	"expired",
+	"failed"
+]);
+const TERMINAL_SETTLEMENT_STATES = new Set(["completed", "failed"]);
+const isTerminalEvent = (data) => {
+	if (data.axis === "execution") return TERMINAL_EXECUTION_STATES.has(data.newState);
+	if (data.axis === "settlement") return TERMINAL_SETTLEMENT_STATES.has(data.newState);
+	return false;
+};
+/**
+* Connects to the realtime service if not already connected and subscribes to
+* all state transition events for the given checkout transaction.
+*
+* Settlement and execution axis events are forwarded as public SDK events.
+* The subscription is torn down automatically when a terminal event is received.
+* @not-instrumented
+*/
+const subscribeToCheckoutTransaction = async ({ transactionId }, client) => {
+	const { realtime } = require_InvalidParamError.getCore(client);
+	if (realtime.getConnectionState() === "idle") await realtime.connect({ client });
+	const channelSchema = createCheckoutTransactionChannelSchema(transactionId);
+	const handler = ({ data }) => {
+		if (data.axis === "execution") require_getVerifiedCredentialForWalletAccount.emitEvent({
+			args: {
+				newState: data.newState,
+				previousState: data.previousState,
+				timestamp: data.timestamp,
+				transactionId: data.transactionId
+			},
+			event: "checkoutTransactionExecutionStateChanged"
+		}, client);
+		if (data.axis === "settlement") require_getVerifiedCredentialForWalletAccount.emitEvent({
+			args: {
+				newState: data.newState,
+				previousState: data.previousState,
+				timestamp: data.timestamp,
+				transactionId: data.transactionId
+			},
+			event: "checkoutTransactionSettlementStateChanged"
+		}, client);
+		if (isTerminalEvent(data)) realtime.unsubscribe({
+			callback: handler,
+			channelSchema
+		});
+	};
+	await realtime.subscribe({
+		callback: handler,
+		channelSchema
+	});
+};
+
 //#endregion
 //#region src/modules/checkout/createCheckoutTransaction/createCheckoutTransaction.ts
 /**
@@ -2578,6 +2705,9 @@ const createCheckoutTransaction = async (params, client = require_InvalidParamEr
 		environmentId: core.environmentId
 	});
 	await core.storage.setItem(createCheckoutSessionTokenStorageKey(result.transaction.id), result.sessionToken);
+	subscribeToCheckoutTransaction({ transactionId: result.transaction.id }, client).catch((error) => {
+		core.logger.error("Failed to subscribe to checkout transaction realtime channel", error);
+	});
 	return result;
 };
 const __createCheckoutTransaction_impl = createCheckoutTransaction;
@@ -2850,6 +2980,32 @@ const __requiresConversion_wrapped = require_InvalidParamError.instrumentFunctio
 	}
 });
 
+//#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 = require_InvalidParamError.getDefaultClient()) => subscribeToCheckoutTransaction({ transactionId }, client);
+const __trackCheckoutTransaction_impl = trackCheckoutTransaction;
+const __trackCheckoutTransaction_wrapped = require_InvalidParamError.instrumentFunction({
+	fn: __trackCheckoutTransaction_impl,
+	functionName: "trackCheckoutTransaction",
+	getCore: () => {
+		try {
+			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/deviceRegistration/completeDeviceRegistration/completeDeviceRegistration.ts
 const DEVICE_REGISTRATION_TOKEN_HEADER = "x-dynamic-device-registration-token";
@@ -5639,40 +5795,6 @@ const isUserOnboardingComplete = (client = require_InvalidParamError.getDefaultC
 	return !hasMissingKycFields && !hasPendingMfaAuth && !hasPendingRecoveryCodes;
 };
 
-//#endregion
-//#region src/modules/user/refreshUser/refreshUser.ts
-/**
-* Refreshes the current user's data from the server.
-*
-* This function fetches the latest authenticated user information from the backend
-* and updates the local user state.
-*
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns A promise that resolves to the authenticated user.
-* @instrumented
-*/
-const refreshUser = async (client = require_InvalidParamError.getDefaultClient()) => {
-	const core = require_InvalidParamError.getCore(client);
-	const apiClient = require_InvalidParamError.__createApiClient_wrapped({}, client);
-	const previousState = { ...core.state.get() };
-	const user = await apiClient.getAuthenticatedUser({ environmentId: core.environmentId });
-	core.state.set({ user });
-	require_getVerifiedCredentialForWalletAccount.checkAndRaiseWalletAccountsChangedEvent({ previousState }, client);
-	return user;
-};
-const __refreshUser_impl = refreshUser;
-const __refreshUser_wrapped = require_InvalidParamError.instrumentFunction({
-	fn: __refreshUser_impl,
-	functionName: "refreshUser",
-	getCore: () => {
-		try {
-			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/modules/wallets/assertWalletAccountSigningAvailability/assertWalletAccountSigningAvailability.ts
 /**
@@ -7006,6 +7128,7 @@ exports.signMessage = __signMessage_wrapped;
 exports.submitCheckoutTransaction = __submitCheckoutTransaction_wrapped;
 exports.supportedCountries = supportedCountries;
 exports.switchActiveNetwork = __switchActiveNetwork_wrapped;
+exports.trackCheckoutTransaction = __trackCheckoutTransaction_wrapped;
 exports.transferAmount = __transferAmount_wrapped;
 exports.transferWalletAccount = __transferWalletAccount_wrapped;
 exports.unlinkSocialAccount = __unlinkSocialAccount_wrapped;