@paydock/client-sdk 1.136.0 → 1.138.1-beta

package/README.md

@@ -4267,6 +4267,29 @@ button.onShippingAddressChange(async function(data) {
 });
 ```
 
+#### No shipping address
+
+This is the case where no shipping address is required at all in the popup (e.g., digital goods, services, or virtual products, or Shipping Address collected separately by the merchant). The "Send to" UI field will not be shown in the Apple Pay sheet, it will be hidden.
+
+**Important:**
+- No shipping address should be provided in the meta object.
+- Shipping address could be provided in the initial POST `/v1/charges/wallet` endpoint, if collected previously.
+
+The required meta parameters for this case are:
+- `required_shipping_contact_fields`: Only include contact fields if needed (phone, email), but NOT `postalAddress`.
+
+```javascript
+meta:  {
+  "amount_label": "TOTAL",
+  "country": "AU",
+  "currency": "AUD",
+  "amount": 10,
+  "shipping_editing_mode": "available",
+  "required_shipping_contact_fields": ["phone", "email"],
+  "apple_pay_capabilities": ["credentials_available", "credentials_status_unknown", "credentials_unavailable"]
+}
+```
+
 ### Paypal Wallet Button Express
 A full description of the meta parameters for [PaypalWalletButtonExpress](#PaypalWalletButtonExpress) meta parameters can be found [here](#PaypalWalletMeta). Below you will find a fully working html example.
 
@@ -4490,7 +4513,7 @@ If the determinated value is credentials_status_unknown, the payment possbily sh
 | [merchant_capabilities] | <code>Array.&lt;(&#x27;supports3DS&#x27;\|&#x27;supportsEMV&#x27;\|&#x27;supportsCredit&#x27;\|&#x27;supportsDebit&#x27;)&gt;</code> | Array of capabilities that the merchant supports, influencing the transaction processing features available. |
 | [supported_networks] | <code>Array.&lt;(&#x27;visa&#x27;\|&#x27;masterCard&#x27;\|&#x27;amex&#x27;\|&#x27;chinaUnionPay&#x27;\|&#x27;discover&#x27;\|&#x27;interac&#x27;\|&#x27;jcb&#x27;\|&#x27;privateLabel&#x27;)&gt;</code> | List of payment networks supported by the merchant for ApplePay transactions. |
 | [required_billing_contact_fields] | <code>Array.&lt;(&#x27;email&#x27;\|&#x27;name&#x27;\|&#x27;phone&#x27;\|&#x27;postalAddress&#x27;)&gt;</code> | Contact fields required from the user for billing purposes, improving transaction verification and fraud prevention. Phone and email are currently not returned by Apple. |
-| [required_shipping_contact_fields] | <code>Array.&lt;(&#x27;email&#x27;\|&#x27;phone&#x27;)&gt;</code> | Shipping contact fields that are mandatory to complete the transaction. Use email and phone to collect from customer wallet in the abscense of billing one. Required for onShippingAddressChange callback. |
+| [required_shipping_contact_fields] | <code>Array.&lt;(&#x27;email&#x27;\|&#x27;phone&#x27;\|&#x27;postalAddress&#x27;)&gt;</code> | Shipping contact fields that are mandatory to complete the transaction. Use email and phone to collect from customer wallet in the abscense of billing one. Include 'postalAddress' to show shipping address fields collection in the Apple Pay sheet. Required handling of onShippingAddressChange callback. |
 | [supported_countries] | <code>Array.&lt;string&gt;</code> | List of countries where ApplePay is supported by the merchant, restricting usage to specified regions. |
 | [style] | <code>object</code> | Styling configuration for ApplePay buttons displayed during checkout. |
 | [style.button_type] | <code>ApplePayButtonType</code> | Enum type to select the type of ApplePay button (e.g., 'buy', 'donate', etc.), providing user interface customization. |

package/bundles/index.cjs

@@ -813,7 +813,7 @@ var Browser = /*#__PURE__*/function () {
   }, {
     key: "isSupportPopUp",
     value: function isSupportPopUp() {
-      return !this.isFacebook() && !this.isInstagram();
+      return !Browser.isFacebook() && !Browser.isInstagram();
     }
   }, {
     key: "getLanguage",
@@ -869,18 +869,18 @@ var Browser = /*#__PURE__*/function () {
       var M = ua.match(/(opera|chrome|safari|firefox|msie|trident(?=\/))\/?\s*(\d+)/i) || [];
       var tem;
       if (/trident/i.test(M[1])) {
-        tem = /\brv[ :]+(\d+)/g.exec(ua) || [];
+        tem = /\brv[ :](\d+)/.exec(ua) || [];
         return {
           name: 'IE',
           version: tem[1] || ''
         };
       }
       if (M[1] === 'Chrome') {
-        tem = ua.match(/\bOPR|Edge\/(\d+)/);
+        tem = ua.match(/\b(OPR|Edge)\/(\d+)/);
         if (tem != null) {
           return {
-            name: 'Opera',
-            version: tem[1]
+            name: tem[1] === 'OPR' ? 'Opera' : 'Edge',
+            version: tem[2]
           };
         }
       }
@@ -1189,7 +1189,7 @@ SDK.headerKeys = Object.freeze({
   version: 'x-sdk-version',
   type: 'x-sdk-type'
 });
-SDK._version = 'v1.136.0';
+SDK._version = 'v1.138.1-beta';
 
 function isFunction(value) {
     return typeof value === 'function';
@@ -4413,7 +4413,7 @@ var InstrumentationAgent = /*#__PURE__*/function (_MicroAgent) {
     _classCallCheck(this, InstrumentationAgent);
     _this = _callSuper(this, InstrumentationAgent, [config]);
     _this.call = function (method) {
-      if (_this.isAvailable()) {
+      if (_this.isAvailable() && InstrumentationAgent.agent) {
         var _InstrumentationAgent;
         for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
           args[_key - 1] = arguments[_key];
@@ -4432,21 +4432,28 @@ var InstrumentationAgent = /*#__PURE__*/function (_MicroAgent) {
   }], [{
     key: "instance",
     get: function get() {
+      var _a;
       if (!InstrumentationAgent.initialized) {
         var _getConfig = getConfig(),
           available = _getConfig.available,
           options = _getConfig.options;
         InstrumentationAgent.available = available;
+        InstrumentationAgent.agent = undefined;
         if (available) {
           InstrumentationAgent.agent = new InstrumentationAgent(options);
           InstrumentationAgent.agent.start([Instrument$2.featureName, Instrument.featureName, Instrument$1.featureName]);
         }
         InstrumentationAgent.initialized = true;
       }
-      return InstrumentationAgent.agent;
+      return (_a = InstrumentationAgent.agent) !== null && _a !== void 0 ? _a : InstrumentationAgent.noopClient;
     }
   }]);
 }(MicroAgent);
+InstrumentationAgent.noopClient = {
+  call: function call() {
+    // no-op: instrumentation unavailable (missing/invalid config)
+  }
+};
 
 var ActionRepository = /*#__PURE__*/function () {
   function ActionRepository() {
@@ -10162,7 +10169,7 @@ var AppleWalletService = /*#__PURE__*/function (_WalletService) {
       });
     };
     _this.onPaymentAuthorized = function (event) {
-      var _a;
+      var _a, _b, _c, _d, _e;
       var _event$payment = event.payment,
         token = _event$payment.token,
         billingContact = _event$payment.billingContact,
@@ -10180,8 +10187,8 @@ var AppleWalletService = /*#__PURE__*/function (_WalletService) {
             }), {
               type: token.paymentMethod.type,
               card_scheme: token.paymentMethod.network,
-              address_line1: billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines[0],
-              address_line2: billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines[1],
+              address_line1: (_b = billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines) === null || _b === void 0 ? void 0 : _b[0],
+              address_line2: (_c = billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines) === null || _c === void 0 ? void 0 : _c[1],
               address_country: billingContact === null || billingContact === void 0 ? void 0 : billingContact.countryCode,
               address_city: billingContact === null || billingContact === void 0 ? void 0 : billingContact.locality,
               address_postcode: billingContact === null || billingContact === void 0 ? void 0 : billingContact.postalCode,
@@ -10195,8 +10202,8 @@ var AppleWalletService = /*#__PURE__*/function (_WalletService) {
           }), _this.hasShippingOptions() && {
             options: _this.meta.shipping_options
           }), {
-            address_line1: shippingContact.addressLines[0],
-            address_line2: shippingContact.addressLines[1],
+            address_line1: (_d = shippingContact.addressLines) === null || _d === void 0 ? void 0 : _d[0],
+            address_line2: (_e = shippingContact.addressLines) === null || _e === void 0 ? void 0 : _e[1],
             address_country: shippingContact.countryCode,
             address_city: shippingContact.locality,
             address_postcode: shippingContact.postalCode,
@@ -22652,49 +22659,75 @@ var ApplePayWalletButtonExpress = /*#__PURE__*/function (_BaseWalletButton) {
       });
     };
     _this.onPaymentAuthorized = function (event) {
-      var _event$payment = event.payment,
-        token = _event$payment.token,
-        billingContact = _event$payment.billingContact,
-        shippingContact = _event$payment.shippingContact;
-      _this.executeWalletCapture(_extends(_extends({}, shippingContact && {
-        shipping: {
-          address_line1: shippingContact.addressLines[0],
-          address_line2: shippingContact.addressLines[1],
-          address_line3: shippingContact.addressLines[2],
-          address_country: shippingContact.countryCode,
-          address_city: shippingContact.locality,
-          address_postcode: shippingContact.postalCode,
-          address_state: shippingContact.administrativeArea,
-          contact: {
-            phone: shippingContact.phoneNumber,
-            email: shippingContact.emailAddress,
-            first_name: shippingContact.givenName,
-            last_name: shippingContact.familyName
-          }
-        }
-      }), {
-        customer: {
-          first_name: billingContact === null || billingContact === void 0 ? void 0 : billingContact.givenName,
-          last_name: billingContact === null || billingContact === void 0 ? void 0 : billingContact.familyName,
-          email: (billingContact === null || billingContact === void 0 ? void 0 : billingContact.emailAddress) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.emailAddress),
-          phone: (billingContact === null || billingContact === void 0 ? void 0 : billingContact.phoneNumber) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.phoneNumber),
-          payment_source: {
-            wallet_type: WALLET_TYPE.APPLE,
-            address_line1: billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines[0],
-            address_line2: billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines[1],
-            address_country: billingContact === null || billingContact === void 0 ? void 0 : billingContact.countryCode,
-            address_city: billingContact === null || billingContact === void 0 ? void 0 : billingContact.locality,
-            address_postcode: billingContact === null || billingContact === void 0 ? void 0 : billingContact.postalCode,
-            address_state: billingContact === null || billingContact === void 0 ? void 0 : billingContact.administrativeArea,
-            ref_token: token.paymentData ? JSON.stringify(token.paymentData) : '',
-            wallet_express: true
+      var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+      try {
+        var _event$payment = event.payment,
+          token = _event$payment.token,
+          billingContact = _event$payment.billingContact,
+          shippingContact = _event$payment.shippingContact;
+        var hasShippingFields = !!(((_a = shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.addressLines) === null || _a === void 0 ? void 0 : _a.length) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.countryCode) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.postalCode) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.locality) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.administrativeArea));
+        var hasContactFields = !!((shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.phoneNumber) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.emailAddress) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.givenName) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.familyName));
+        _this.executeWalletCapture(_extends(_extends({}, (hasShippingFields || hasContactFields) && {
+          shipping: _extends(_extends(_extends(_extends(_extends(_extends(_extends(_extends({}, ((_b = shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.addressLines) === null || _b === void 0 ? void 0 : _b[0]) && {
+            address_line1: (_c = shippingContact.addressLines) === null || _c === void 0 ? void 0 : _c[0]
+          }), ((_d = shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.addressLines) === null || _d === void 0 ? void 0 : _d[1]) && {
+            address_line2: (_e = shippingContact.addressLines) === null || _e === void 0 ? void 0 : _e[1]
+          }), ((_f = shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.addressLines) === null || _f === void 0 ? void 0 : _f[2]) && {
+            address_line3: (_g = shippingContact.addressLines) === null || _g === void 0 ? void 0 : _g[2]
+          }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.countryCode) && {
+            address_country: shippingContact.countryCode
+          }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.locality) && {
+            address_city: shippingContact.locality
+          }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.postalCode) && {
+            address_postcode: shippingContact.postalCode
+          }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.administrativeArea) && {
+            address_state: shippingContact.administrativeArea
+          }), hasContactFields && {
+            contact: _extends(_extends(_extends(_extends({}, (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.phoneNumber) && {
+              phone: shippingContact.phoneNumber
+            }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.emailAddress) && {
+              email: shippingContact.emailAddress
+            }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.givenName) && {
+              first_name: shippingContact.givenName
+            }), (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.familyName) && {
+              last_name: shippingContact.familyName
+            })
+          })
+        }), {
+          customer: {
+            first_name: billingContact === null || billingContact === void 0 ? void 0 : billingContact.givenName,
+            last_name: billingContact === null || billingContact === void 0 ? void 0 : billingContact.familyName,
+            email: (billingContact === null || billingContact === void 0 ? void 0 : billingContact.emailAddress) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.emailAddress),
+            phone: (billingContact === null || billingContact === void 0 ? void 0 : billingContact.phoneNumber) || (shippingContact === null || shippingContact === void 0 ? void 0 : shippingContact.phoneNumber),
+            payment_source: {
+              wallet_type: WALLET_TYPE.APPLE,
+              address_line1: (_h = billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines) === null || _h === void 0 ? void 0 : _h[0],
+              address_line2: (_j = billingContact === null || billingContact === void 0 ? void 0 : billingContact.addressLines) === null || _j === void 0 ? void 0 : _j[1],
+              address_country: billingContact === null || billingContact === void 0 ? void 0 : billingContact.countryCode,
+              address_city: billingContact === null || billingContact === void 0 ? void 0 : billingContact.locality,
+              address_postcode: billingContact === null || billingContact === void 0 ? void 0 : billingContact.postalCode,
+              address_state: billingContact === null || billingContact === void 0 ? void 0 : billingContact.administrativeArea,
+              ref_token: token.paymentData ? JSON.stringify(token.paymentData) : '',
+              wallet_express: true
+            }
           }
-        }
-      })).then(function () {
-        _this.paymentSession.completePayment(ApplePaySession.STATUS_SUCCESS);
-      })["catch"](function () {
+        })).then(function () {
+          _this.paymentSession.completePayment(ApplePaySession.STATUS_SUCCESS);
+        })["catch"](function () {
+          _this.paymentSession.completePayment(ApplePaySession.STATUS_FAILURE);
+        });
+      } catch (error) {
+        // this ensures thatwe always call completePayment and emit error callback even if there's an uncaught exception
         _this.paymentSession.completePayment(ApplePaySession.STATUS_FAILURE);
-      });
+        _this.eventEmitter.emit(EVENT.PAYMENT_ERROR, {
+          event: EVENT.PAYMENT_ERROR,
+          chargeId: (_k = _this.chargeWalletTokenMeta) === null || _k === void 0 ? void 0 : _k.charge.id,
+          data: {
+            message: error instanceof Error ? error.message : 'Payment processing failed',
+            code: 'PAYMENT_AUTHORIZATION_ERROR'
+          }
+        });
+      }
     };
     _this.onCancelPayment = function () {
       return _this.handleCheckoutClose();
@@ -22921,24 +22954,30 @@ var ApplePayWalletButtonExpress = /*#__PURE__*/function (_BaseWalletButton) {
   }, {
     key: "parseShippingContact",
     value: function parseShippingContact() {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e, _f, _g, _h;
       if (!((_b = (_a = this.chargeWalletTokenMeta) === null || _a === void 0 ? void 0 : _a.charge) === null || _b === void 0 ? void 0 : _b.shipping) && !this.meta.shipping) {
         return {};
       }
       var shipping = ((_d = (_c = this.chargeWalletTokenMeta) === null || _c === void 0 ? void 0 : _c.charge) === null || _d === void 0 ? void 0 : _d.shipping) || this.meta.shipping;
-      return _extends(_extends({}, (shipping === null || shipping === void 0 ? void 0 : shipping.contact) && {
+      var shippingFromCharge = !!((_f = (_e = this.chargeWalletTokenMeta) === null || _e === void 0 ? void 0 : _e.charge) === null || _f === void 0 ? void 0 : _f.shipping);
+      var requiresPostalAddress = (_h = (_g = this.meta.required_shipping_contact_fields) === null || _g === void 0 ? void 0 : _g.includes('postalAddress')) !== null && _h !== void 0 ? _h : false;
+      var contact = _extends({}, (shipping === null || shipping === void 0 ? void 0 : shipping.contact) && {
         phoneNumber: shipping.contact.phone,
         emailAddress: shipping.contact.email,
         givenName: shipping.contact.first_name,
         familyName: shipping.contact.last_name
-      }), {
-        addressLines: [shipping.address_line1, shipping.address_line2, shipping.address_line3].filter(Boolean),
-        locality: shipping.address_city,
-        postalCode: shipping.address_postcode,
-        administrativeArea: shipping.address_state,
-        country: shipping.address_country,
-        countryCode: shipping.address_country_code ? shipping.address_country_code : shipping.address_country
       });
+      if (requiresPostalAddress || shippingFromCharge) {
+        return _extends(_extends({}, contact), {
+          addressLines: [shipping.address_line1, shipping.address_line2, shipping.address_line3].filter(Boolean),
+          locality: shipping.address_city,
+          postalCode: shipping.address_postcode,
+          administrativeArea: shipping.address_state,
+          country: shipping.address_country,
+          countryCode: shipping.address_country_code ? shipping.address_country_code : shipping.address_country
+        });
+      }
+      return contact;
     }
   }, {
     key: "parseShippingMethod",
@@ -22966,7 +23005,7 @@ var ApplePayWalletButtonExpress = /*#__PURE__*/function (_BaseWalletButton) {
   }, {
     key: "parseShippingContactUpdateEvent",
     value: function parseShippingContactUpdateEvent(data) {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
       return _extends(_extends(_extends({
         contact: {
           phone: (_e = (_d = (_c = (_b = (_a = this.chargeWalletTokenMeta) === null || _a === void 0 ? void 0 : _a.charge) === null || _b === void 0 ? void 0 : _b.shipping) === null || _c === void 0 ? void 0 : _c.contact) === null || _d === void 0 ? void 0 : _d.phone) !== null && _e !== void 0 ? _e : data.shippingContact.phoneNumber,
@@ -22975,9 +23014,9 @@ var ApplePayWalletButtonExpress = /*#__PURE__*/function (_BaseWalletButton) {
           last_name: (_v = (_u = (_t = (_s = (_r = this.chargeWalletTokenMeta) === null || _r === void 0 ? void 0 : _r.charge) === null || _s === void 0 ? void 0 : _s.shipping) === null || _t === void 0 ? void 0 : _t.contact) === null || _u === void 0 ? void 0 : _u.last_name) !== null && _v !== void 0 ? _v : data.shippingContact.familyName
         }
       }, ((_w = data.shippingContact.addressLines) === null || _w === void 0 ? void 0 : _w[0]) && {
-        address_line1: data.shippingContact.addressLines[0]
-      }), ((_x = data.shippingContact.addressLines) === null || _x === void 0 ? void 0 : _x[1]) && {
-        address_line2: data.shippingContact.addressLines[1]
+        address_line1: (_x = data.shippingContact.addressLines) === null || _x === void 0 ? void 0 : _x[0]
+      }), ((_y = data.shippingContact.addressLines) === null || _y === void 0 ? void 0 : _y[1]) && {
+        address_line2: (_z = data.shippingContact.addressLines) === null || _z === void 0 ? void 0 : _z[1]
       }), {
         address_city: data.shippingContact.locality,
         address_postcode: data.shippingContact.postalCode,

package/bundles/index.cjs.d.ts

@@ -139,12 +139,16 @@ type HttpRequestUrl = string | URL;
 type AgentPrototype = Pick<(typeof MicroAgent)['prototype'], 'addPageAction' | 'noticeError'>;
 type AgentMethodNames = keyof AgentPrototype;
 type AgentMethodParameters<T extends AgentMethodNames> = Parameters<AgentPrototype[T]>;
+type InstrumentationClient = {
+    call<T extends AgentMethodNames>(method: T, ...args: AgentMethodParameters<T>): void;
+};
 declare class InstrumentationAgent extends MicroAgent {
     private static agent;
     private static available;
     private static initialized;
+    private static readonly noopClient;
     private constructor();
-    static get instance(): InstrumentationAgent;
+    static get instance(): InstrumentationClient;
     isAvailable(): boolean;
     call: <T extends "addPageAction" | "noticeError">(method: T, ...args: AgentMethodParameters<T>) => void;
 }
@@ -5014,7 +5018,7 @@ interface ApplePayWalletMeta extends BaseWalletMeta {
     merchant_capabilities?: Array<'supports3DS' | 'supportsEMV' | 'supportsCredit' | 'supportsDebit'>;
     supported_networks?: Array<'visa' | 'masterCard' | 'amex' | 'chinaUnionPay' | 'discover' | 'interac' | 'jcb' | 'privateLabel'>;
     required_billing_contact_fields?: Array<'email' | 'name' | 'phone' | 'postalAddress'>;
-    required_shipping_contact_fields?: Array<'email' | 'phone'>;
+    required_shipping_contact_fields?: Array<'email' | 'phone' | 'postalAddress'>;
     apple_pay_capabilities?: Array<'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable'>;
     supported_countries?: string[];
     style?: {