[Apple Pay] Deprecate enabled in favor of available in ApplePaySh…

…ippingContactEditingMode

https://bugs.webkit.org/show_bug.cgi?id=259659
rdar://113159800

Reviewed by Wenson Hsieh.

In iOS 17, PassKit is deprecating PKShippingContactEditingModeEnabled in
favor of PKShippingContactEditingModeAvailable in the
PKShippingContactEditingMode  enumeration. Reference: https://developer.apple.com/documentation/passkit/pkshippingcontacteditingmode/pkshippingcontacteditingmodeenabled?language=objc

Given our intention to reflect the PassKit public API in the Apple Pay
JS API, we should follow suit and perform a similar deprecation. We do
so by introducing `available`, the preferred enumeration value, and
logging a console warning whenever a PaymentSession is inititated with a
PaymentRequest containing the deprecated `shippingContactEditingMode`
value.

* LayoutTests/http/tests/paymentrequest/paymentrequest-shippingContactEditingMode.https.html:
* Source/WebCore/Modules/applepay/ApplePayShippingContactEditingMode.h:
* Source/WebCore/Modules/applepay/ApplePayShippingContactEditingMode.idl:
* Source/WebCore/Modules/applepay/PaymentCoordinator.cpp:
(WebCore::PaymentCoordinator::beginPaymentSession):
* Source/WebKit/Shared/ApplePay/PaymentSetupConfiguration.mm:

Drive-by fix of a mismatched namespace.

* Source/WebKit/Shared/ApplePay/cocoa/WebPaymentCoordinatorProxyCocoa.mm:
(WebKit::toPKShippingContactEditingMode):

Canonical link: https://commits.webkit.org/266493@main

LayoutTests/http/tests/paymentrequest/paymentrequest-shippingContactEditingMode.https.html

@@ -35,7 +35,7 @@
 
 user_activation_test(async (test) => {
     const method = validPaymentMethod();
-    method.data.shippingContactEditingMode = "enabled";
+    method.data.shippingContactEditingMode = "available";
 
     let request = new PaymentRequest([method], validPaymentDetails());
     request.addEventListener("merchantvalidation", (event) => {

Source/WebCore/Modules/applepay/ApplePayShippingContactEditingMode.h

@@ -27,13 +27,29 @@
 
 #if ENABLE(APPLE_PAY_SHIPPING_CONTACT_EDITING_MODE)
 
+#include <wtf/EnumTraits.h>
+
 namespace WebCore {
 
-enum class ApplePayShippingContactEditingMode : bool {
-    Enabled,
+enum class ApplePayShippingContactEditingMode : uint8_t {
+    Available,
+    Enabled, // Deprecated in favor of `Available`.
     StorePickup,
 };
 
 } // namespace WebCore
 
+namespace WTF {
+
+template<> struct EnumTraits<WebCore::ApplePayShippingContactEditingMode> {
+    using values = EnumValues<
+        WebCore::ApplePayShippingContactEditingMode,
+        WebCore::ApplePayShippingContactEditingMode::Available,
+        WebCore::ApplePayShippingContactEditingMode::Enabled,
+        WebCore::ApplePayShippingContactEditingMode::StorePickup
+    >;
+};
+
+} // namespace WTF
+
 #endif // ENABLE(APPLE_PAY_SHIPPING_CONTACT_EDITING_MODE)

Source/WebCore/Modules/applepay/ApplePayShippingContactEditingMode.idl

@@ -27,6 +27,7 @@
     Conditional=APPLE_PAY_SHIPPING_CONTACT_EDITING_MODE,
     ExportMacro=WEBCORE_EXPORT,
 ] enum ApplePayShippingContactEditingMode {
+    "available",
     "enabled",
     "storePickup"
 };

Source/WebCore/Modules/applepay/PaymentCoordinator.cpp

@@ -107,6 +107,11 @@ bool PaymentCoordinator::beginPaymentSession(Document& document, PaymentSession&
     if (!showPaymentUI)
         return false;
 
+#if ENABLE(APPLE_PAY_SHIPPING_CONTACT_EDITING_MODE)
+    if (paymentRequest.shippingContactEditingMode() == ApplePayShippingContactEditingMode::Enabled)
+        document.addConsoleMessage(MessageSource::PaymentRequest, MessageLevel::Warning, "`enabled` is a deprecated value for `shippingContactEditingMode`. Please use `available` instead."_s);
+#endif
+
     m_activeSession = &paymentSession;
     return true;
 }

Source/WebKit/Shared/ApplePay/PaymentSetupConfiguration.mm

@@ -78,6 +78,6 @@ @interface PKPaymentSetupConfiguration (WebKit)
 {
 }
 
-} // namespace WebKitAdditions
+} // namespace WebKit
 
 #endif // ENABLE(APPLE_PAY)

Source/WebKit/Shared/ApplePay/cocoa/WebPaymentCoordinatorProxyCocoa.mm

@@ -216,6 +216,7 @@ static PKShippingType toPKShippingType(WebCore::ApplePaySessionPaymentRequest::S
 static PKShippingContactEditingMode toPKShippingContactEditingMode(WebCore::ApplePayShippingContactEditingMode shippingContactEditingMode)
 {
     switch (shippingContactEditingMode) {
+    case WebCore::ApplePayShippingContactEditingMode::Available:
     case WebCore::ApplePayShippingContactEditingMode::Enabled:
 #if USE(PKSHIPPINGCONTACTEDITINGMODEENABLED)
 ALLOW_DEPRECATED_DECLARATIONS_BEGIN