👔 Add new check for unsupported countries

Author: stracker-phil

modules/ppcp-store-sync/src/CartValidation/ShippingValidator.php

@@ -16,6 +16,7 @@
 
 namespace WooCommerce\PayPalCommerce\StoreSync\CartValidation;
 
+use WC_Countries;
 use WC_Validation;
 use WC_Product;
 
@@ -31,6 +32,14 @@
 
 class ShippingValidator implements ValidatorInterface {
 
+	/**
+	 * List of shipping countries that are supported by the agentic integration.
+	 * Managed on plugin-side for extra code and test stability.
+	 *
+	 * If this list is expanded, also update the message in {@see validate_country()}
+	 */
+	private const PAYPAL_SUPPORTED_COUNTRIES = array( 'US' );
+
 	private ProductManager $product_manager;
 
 	public function __construct( ProductManager $product_manager ) {
@@ -114,15 +123,15 @@ private function validate_address_completeness( Address $address ): array {
 					->user_message( 'Please provide a complete street address.' )
 					->for_field( 'shipping_address.address_line_1' )
 					->add_resolution(
-					ResolutionOption::create_provide_missing_field()
-						->label( 'Provide street address' )
-						->set_meta( 'field', 'address_line_1' )
-				)
-				->add_resolution(
-					ResolutionOption::create_update_address()
-						->label( 'Update shipping address' )
-						->priority( Priority::LOW )
-				);
+						ResolutionOption::create_provide_missing_field()
+							->label( 'Provide street address' )
+							->set_meta( 'field', 'address_line_1' )
+					)
+					->add_resolution(
+						ResolutionOption::create_update_address()
+							->label( 'Update shipping address' )
+							->priority( Priority::LOW )
+					);
 		}
 
 		if ( ! $address->admin_area_2() ) {
@@ -131,15 +140,15 @@ private function validate_address_completeness( Address $address ): array {
 					->user_message( 'Please provide a city.' )
 					->for_field( 'shipping_address.admin_area_2' )
 					->add_resolution(
-					ResolutionOption::create_provide_missing_field()
-						->label( 'Provide city' )
-						->set_meta( 'field', 'admin_area_2' )
-				)
-				->add_resolution(
-					ResolutionOption::create_update_address()
-						->label( 'Update shipping address' )
-						->priority( Priority::LOW )
-				);
+						ResolutionOption::create_provide_missing_field()
+							->label( 'Provide city' )
+							->set_meta( 'field', 'admin_area_2' )
+					)
+					->add_resolution(
+						ResolutionOption::create_update_address()
+							->label( 'Update shipping address' )
+							->priority( Priority::LOW )
+					);
 		}
 
 		$postal_code = $address->postal_code();
@@ -149,15 +158,15 @@ private function validate_address_completeness( Address $address ): array {
 					->user_message( 'Please provide a postal code.' )
 					->for_field( 'shipping_address.postal_code' )
 					->add_resolution(
-					ResolutionOption::create_provide_missing_field()
-						->label( 'Provide postal code' )
-						->set_meta( 'field', 'postal_code' )
-				)
-				->add_resolution(
-					ResolutionOption::create_update_address()
-						->label( 'Update shipping address' )
-						->priority( Priority::LOW )
-				);
+						ResolutionOption::create_provide_missing_field()
+							->label( 'Provide postal code' )
+							->set_meta( 'field', 'postal_code' )
+					)
+					->add_resolution(
+						ResolutionOption::create_update_address()
+							->label( 'Update shipping address' )
+							->priority( Priority::LOW )
+					);
 		} else {
 			$postal_validation =
 				$this->validate_postal_code_format( $postal_code, $address->country_code() );
@@ -339,6 +348,17 @@ private function validate_country( ?string $country_code ): ?ValidationIssue {
 				);
 		}
 
+		if ( $this->get_wc_countries() && ! $this->is_paypal_supported_country( $country_code ) ) {
+			return ValidationIssue::create_shipping_unavailable( sprintf( 'Shipping to %s is not supported by PayPal', $country_code ) )
+				->user_message( 'PayPal currently only supports shipping to the United States.' )
+				->for_field( 'shipping_address.country_code' )
+				->add_resolution(
+					ResolutionOption::create_update_address()
+						->label( 'Use a supported shipping country' )
+						->priority( Priority::HIGH )
+				);
+		}
+
 		return null;
 	}
 
@@ -380,17 +400,18 @@ private function get_country_name( string $country_code ): string {
 		return $countries[ $country_code ] ?? $country_code;
 	}
 
-	/**
-	 * @return \WC_Countries|null
-	 */
-	private function get_wc_countries() {
+	private function get_wc_countries(): ?WC_Countries {
 		if ( ! function_exists( 'WC' ) ) {
 			return null;
 		}
 
 		// The only place in the class that has a `WC()` dependency.
 		$wc = WC();
 
-		return $wc ? $wc->countries : null;
+		return $wc->countries;
+	}
+
+	private function is_paypal_supported_country( string $country_code ): bool {
+		return in_array( $country_code, self::PAYPAL_SUPPORTED_COUNTRIES, true );
 	}
 }