@dynamic-labs-sdk/client 0.23.4 → 0.24.1

package/dist/index.cjs.js

@@ -1,8 +1,8 @@
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-BZ0Yi99m.cjs.js');
-const require_InvalidParamError = require('./InvalidParamError-D2mY6bDm.cjs.js');
-const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-6iZSd5T2.cjs.js');
-const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-DKt-e0jp.cjs.js');
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-DRetUSWZ.cjs.js');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-COxYamJy.cjs.js');
+const require_InvalidParamError = require('./InvalidParamError-9IR2C0up.cjs.js');
+const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-Df_wN20i.cjs.js');
+const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-DpRIY6Pd.cjs.js');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-cfGmMd_g.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");
@@ -2595,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
 /**
@@ -2626,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;
@@ -2898,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";
@@ -7020,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;