restore original files to avoid issues with linting

client/tokenized-payment-request/cart-api.js

@@ -0,0 +1,208 @@
+/* global jQuery */
+
+/**
+ * External dependencies
+ */
+import apiFetch from '@wordpress/api-fetch';
+import { applyFilters } from '@wordpress/hooks';
+import { addQueryArgs } from '@wordpress/url';
+
+/**
+ * Internal dependencies
+ */
+import { getPaymentRequestData } from './frontend-utils';
+
+export default class PaymentRequestCartApi {
+	// Used on product pages to interact with an anonymous cart.
+	// This anonymous cart is separate from the customer's cart, which might contain additional products.
+	// This functionality is also useful to calculate product/shipping pricing (and shipping needs)
+	// for compatibility scenarios with other plugins (like WC Bookings, Product Add-Ons, WC Deposits, etc.).
+	cartRequestHeaders = {};
+
+	/**
+	 * Makes a request to the API.
+	 *
+	 * @param {Object} options The options to pass to `apiFetch`.
+	 * @return {Promise} Result from `apiFetch`.
+	 */
+	async _request( options ) {
+		const response = await apiFetch( {
+			...options,
+			parse: false,
+			path: addQueryArgs( options.path, {
+				// `wcpayPaymentRequestParams` will always be defined if this file is needed.
+				// If there's an issue with it, ask yourself why this file is queued and `wcpayPaymentRequestParams` isn't present.
+				currency: getPaymentRequestData(
+					'checkout'
+				).currency_code.toUpperCase(),
+			} ),
+			headers: {
+				// the Store API nonce, which could later be overwritten in subsequent requests.
+				Nonce: getPaymentRequestData( 'nonce' ).store_api_nonce,
+				// needed for validation of address data, etc.
+				'X-WooPayments-Tokenized-Cart-Nonce':
+					getPaymentRequestData( 'nonce' ).tokenized_cart_nonce ||
+					undefined,
+				// necessary to validate any request made to the backend from the PDP.
+				'X-WooPayments-Tokenized-Cart-Session-Nonce':
+					getPaymentRequestData( 'button_context' ) === 'product'
+						? getPaymentRequestData( 'nonce' )
+								.tokenized_cart_session_nonce
+						: undefined,
+				...this.cartRequestHeaders,
+				...options.headers,
+			},
+		} );
+
+		this.cartRequestHeaders = {
+			// used as a reference on shortcode cart/checkout pages, where the Nonce might not be automatically added to the request.
+			Nonce: response.headers.get( 'Nonce' ),
+			// saving the received value as a cart reference for future usage. This value could be updated multiple times.
+			'X-WooPayments-Tokenized-Cart-Session': response.headers.get(
+				'X-WooPayments-Tokenized-Cart-Session'
+			),
+		};
+
+		return response.json();
+	}
+
+	/**
+	 * Creates an order from the cart object.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/checkout.md#process-order-and-payment
+	 *
+	 * @param {{
+	 *          billing_address: Object,
+	 *          shipping_address: Object,
+	 *          customer_note: string?,
+	 *          payment_method: string,
+	 *          payment_data: Array,
+	 *        }} paymentData Additional payment data to place the order.
+	 * @return {Promise} Result of the order creation request.
+	 */
+	async placeOrder( paymentData ) {
+		return await this._request( {
+			method: 'POST',
+			path: '/wc/store/v1/checkout',
+			headers: {
+				'X-WooPayments-Tokenized-Cart': true,
+				...this.cartRequestHeaders,
+			},
+			data: paymentData,
+		} );
+	}
+
+	/**
+	 * Returns the customer's cart object.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/cart.md#get-cart
+	 *
+	 * @return {Promise} Cart response object.
+	 */
+	async getCart() {
+		return await this._request( {
+			method: 'GET',
+			path: '/wc/store/v1/cart',
+		} );
+	}
+
+	/**
+	 * Creates and returns a new cart object. The response type is the same as `getCart()`.
+	 */
+	useSeparateCart() {
+		this.cartRequestHeaders = {
+			// sending an empty value w/ the next request, so that the custom session handler is leveraged to create a separate cart.
+			'X-WooPayments-Tokenized-Cart-Session': '',
+		};
+	}
+
+	/**
+	 * Update customer data and return the full cart response, or an error.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/cart.md#update-customer
+	 *
+	 * @param {{
+	 *          billing_address: Object?,
+	 *          shipping_address: Object?,
+	 *        }} customerData Customer data to update.
+	 * @return {Promise} Cart Response on success, or an Error Response on failure.
+	 */
+	async updateCustomer( customerData ) {
+		return await this._request( {
+			method: 'POST',
+			path: '/wc/store/v1/cart/update-customer',
+			headers: {
+				'X-WooPayments-Tokenized-Cart': true,
+				...this.cartRequestHeaders,
+			},
+			data: customerData,
+		} );
+	}
+
+	/**
+	 * Selects an available shipping rate for a package, then returns the full cart response, or an error
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/cart.md#select-shipping-rate
+	 *
+	 * @param {{rate_id: string, package_id: integer}} shippingRate The selected shipping rate.
+	 * @return {Promise} Cart Response on success, or an Error Response on failure.
+	 */
+	async selectShippingRate( shippingRate ) {
+		return await this._request( {
+			method: 'POST',
+			path: '/wc/store/v1/cart/select-shipping-rate',
+			data: shippingRate,
+		} );
+	}
+
+	/**
+	 * Add an item to the cart and return the full cart response, or an error.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/cart.md#add-item
+	 *
+	 * @return {Promise} Cart Response on success, or an Error Response on failure.
+	 */
+	async addProductToCart() {
+		const productData = {
+			// can be modified in case of variable products, WC bookings plugin, etc.
+			id: jQuery( '.single_add_to_cart_button' ).val(),
+			quantity: parseInt( jQuery( '.quantity .qty' ).val(), 10 ) || 1,
+			// can be modified in case of variable products, WC bookings plugin, etc.
+			variation: [],
+		};
+
+		return await this._request( {
+			method: 'POST',
+			path: '/wc/store/v1/cart/add-item',
+			data: applyFilters(
+				'wcpay.payment-request.cart-add-item',
+				productData
+			),
+		} );
+	}
+
+	/**
+	 * Removes all items from the cart and clears the cart headers.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/cart.md#remove-item
+	 *
+	 * @return {undefined}
+	 */
+	async emptyCart() {
+		try {
+			// TODO: this could be optimized, if we could cache the previous request of cart data for later reference.
+			const cartData = await this._request( {
+				method: 'GET',
+				path: '/wc/store/v1/cart',
+			} );
+
+			const removeItemsPromises = cartData.items.map( ( item ) => {
+				return this._request( {
+					method: 'POST',
+					path: '/wc/store/v1/cart/remove-item',
+					data: {
+						key: item.key,
+					},
+				} );
+			} );
+
+			await Promise.all( removeItemsPromises );
+		} catch ( e ) {
+			// let's ignore the error, it's likely not going to be relevant.
+		}
+	}
+}

client/tokenized-payment-request/order-api.js

@@ -0,0 +1,75 @@
+/**
+ * External dependencies
+ */
+import apiFetch from '@wordpress/api-fetch';
+import { addQueryArgs } from '@wordpress/url';
+import { getPaymentRequestData } from './frontend-utils';
+
+export default class PaymentRequestOrderApi {
+	// parameters used in every request, just in different ways.
+	orderId;
+	key;
+	billingEmail = '';
+
+	// needed to replay the cart data to the `placeOrder` endpoint when placing the order.
+	cachedCartData = {};
+
+	/**
+	 * Creates an instance of class to query for order data.
+	 *
+	 * @param {string} orderId The order ID,
+	 * @param {string} key The order key, used to verify the order ID.
+	 * @param {string?} billingEmail The billing email address, used for guest orders.
+	 */
+	constructor( { orderId, key, billingEmail = '' } ) {
+		this.orderId = orderId;
+		this.key = key;
+		this.billingEmail = billingEmail;
+	}
+
+	/**
+	 * Creates an order from the cart object.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/checkout-order.md
+	 *
+	 * @param {{
+	 *          billing_address: Object,
+	 *          shipping_address: Object,
+	 *          payment_method: string,
+	 *          payment_data: Array,
+	 *        }} paymentData Additional payment data to place the order.
+	 * @return {Promise} Result of the order creation request.
+	 */
+	async placeOrder( paymentData ) {
+		return await apiFetch( {
+			method: 'POST',
+			path: `/wc/store/v1/checkout/${ this.orderId }`,
+			headers: {
+				Nonce: getPaymentRequestData( 'nonce' ).store_api_nonce,
+			},
+			data: {
+				...paymentData,
+				key: this.key,
+				billing_email: this.billingEmail,
+				// preventing billing and shipping address from being overwritten in the request to the store - we don't want to update them
+				billing_address: this.cachedCartData.billing_address,
+				shipping_address: this.cachedCartData.shipping_address,
+			},
+		} );
+	}
+
+	/**
+	 * Returns the customer's order object.
+	 * See https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/src/StoreApi/docs/order.md
+	 *
+	 * @return {Promise} Cart response object.
+	 */
+	async getCart() {
+		return ( this.cachedCartData = await apiFetch( {
+			method: 'GET',
+			path: addQueryArgs( `/wc/store/v1/order/${ this.orderId }`, {
+				key: this.key,
+				billing_email: this.billingEmail,
+			} ),
+		} ) );
+	}
+}