woocommerce/plugins/woocommerce-blocks/assets/js/base/context/cart-checkout/payment-methods/actions.js

/**
 * Internal dependencies
 */
import { STATUS } from './constants';

/**
 * @typedef {import('@woocommerce/type-defs/cart').CartBillingAddress} CartBillingAddress
 */

const { ERROR, FAILED, SUCCESS } = STATUS;

const SET_BILLING_DATA = 'set_billing_data';

/**
 * Used to dispatch a status update only for the given type.
 *
 * @param {string} type
 *
 * @return {Object} The action object.
 */
export const statusOnly = ( type ) => ( { type } );

/**
 * Used to dispatch an error message along with setting current payment status
 * to ERROR.
 *
 * @param {string} errorMessage Whatever error message accompanying the error
 *                              condition.
 *
 * @return {Object} The action object.
 */
export const error = ( errorMessage ) => ( {
	type: ERROR,
	errorMessage,
} );

/**
 * Used to dispatch a payment failed status update.
 *
 * @param {Object}             action                   Incoming data for the
 *                                                      action.
 * @param {string}             action.errorMessage      Any message accompanying
 *                                                      the failed payment.
 * @param {CartBillingAddress} action.billingData       Billing data used for
 *                                                      the failed payment.
 * @param {Object}             action.paymentMethodData Arbitrary extra
 *                                                      information about the
 *                                                      payment method in use
 *                                                      (varies per payment
 *                                                      method).
 *
 * @return {Object} An action object.
 */
export const failed = ( {
	errorMessage,
	billingData,
	paymentMethodData,
} ) => ( {
	type: FAILED,
	errorMessage,
	billingData,
	paymentMethodData,
} );

/**
 * Used to dispatch a payment success status update.
 *
 * @param {Object}             action                   Incoming data for the
 *                                                      action.
 * @param {CartBillingAddress} action.billingData       Billing data used for
 *                                                      the failed payment.
 * @param {Object}             action.paymentMethodData Arbitrary extra
 *                                                      information about the
 *                                                      payment method in use
 *                                                      (varies per payment
 *                                                      method).
 *
 * @return {Object} An action object.
 */
export const success = ( { billingData, paymentMethodData } ) => ( {
	type: SUCCESS,
	billingData,
	paymentMethodData,
} );

/**
 * Used to dispatch an action for updating the billing data in the state.
 *
 * @param {CartBillingAddress} billingData Billing data used for the failed
 *                                         payment.
 *
 * @return {Object} An action object.
 */
export const setBillingData = ( billingData ) => ( {
	type: SET_BILLING_DATA,
	billingData,
} );