react-native-payengine 2.0.17 → 2.0.18-alpha.1

package/ios/Sources/Classes/RNPayEngineNative.swift

@@ -10,82 +10,143 @@ import PayEngineSDK
 
 @objc(RNPayEngineNative)
 class RNPayEngineNative: NSObject {
-    static var instance: PayEngine?
+  static var instance: PayEngine?
+  
+  static var applePayInstance: PEApplePay?
+  
+  
+  private var resultFromJS: [String: Any]?
+  private var semaphore: DispatchSemaphore?
+  private var accessTokenProvider: (() throws -> PEAccessTokenRepresentable)?
+  
+  @objc(setConfig:baseURL:)
+  func setConfig(_ publicKey: String, baseURL: String?) {
+    let config = PEConfig(publicKey: publicKey, baseURL: baseURL)
+    RNPayEngineNative.instance = PayEngine(config: config)
     
-    static var applePayInstance: PEApplePay?
-    
-    @objc(setConfig:baseURL:)
-    func setConfig(_ publicKey: String, baseURL: String?) {
-        let config = PEConfig(publicKey: publicKey, baseURL: baseURL)
-        RNPayEngineNative.instance = PayEngine(config: config)
-      
-      debugPrint("PayEngine Plugin setConfig successfully. Current native SDK version: \(PayEngine.getCurrentVersionString() ?? "")")
+    debugPrint("PayEngine Plugin setConfig successfully. Current native SDK version: \(PayEngine.getCurrentVersionString() ?? "")")
+  }
+  
+  func getInstance() throws -> PayEngine {
+    guard let instance = RNPayEngineNative.instance else {
+      throw RNPEError.common("Configuration is not set")
     }
     
-    func getInstance() throws -> PayEngine {
-        guard let instance = RNPayEngineNative.instance else {
-            throw RNPEError.common("Configuration is not set")
+    return instance
+  }
+  
+  @objc(createFraudMonitorSession:resolver:rejecter:)
+  func createFraudMonitorSession(merchantId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    DispatchQueue.main.async {
+      do {
+        let payengine = try self.getInstance()
+        payengine.createFraudMonitorSession(merchantId) { fraudResult in
+          switch fraudResult {
+          case .success(let sessionId):
+            return resolve(sessionId)
+          case .failure(let error):
+            return reject("error", "Unable to obtain session ID", error)
+          }
         }
-        
-        return instance
+      } catch {
+        return reject("error", error.localizedDescription, error)
+      }
     }
-    
-    @objc(createFraudMonitorSession:resolver:rejecter:)
-    func createFraudMonitorSession(merchantId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-        DispatchQueue.main.async {
-            do {
-                let payengine = try self.getInstance()
-                payengine.createFraudMonitorSession(merchantId) { fraudResult in
-                    switch fraudResult {
-                    case .success(let sessionId):
-                        return resolve(sessionId)
-                    case .failure(let error):
-                        return reject("error", "Unable to obtain session ID", error)
-                    }
-                }
-            } catch {
-                return reject("error", error.localizedDescription, error)
-            }
+  }
+  
+  @objc(getBrowserInfo:rejecter:)
+  func getBrowserInfo(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    DispatchQueue.main.async {
+      do {
+        // get current root view from react native
+        if let rootView = UIApplication.shared.keyWindow?.rootViewController?.view {
+          let payengine = try self.getInstance()
+          payengine.getBrowserInfo(view: rootView) { browserInfo in
+            return resolve(browserInfo)
+          }
+        } else {
+          return reject("error", "Unable to find current root view", nil)
         }
+      } catch {
+        return reject("error", error.localizedDescription, error)
+      }
     }
-    
-    @objc(getBrowserInfo:rejecter:)
-    func getBrowserInfo(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-        DispatchQueue.main.async {
-            do {
-                // get current root view from react native
-                if let rootView = UIApplication.shared.keyWindow?.rootViewController?.view {
-                    let payengine = try self.getInstance()
-                    payengine.getBrowserInfo(view: rootView) { browserInfo in
-                        return resolve(browserInfo)
-                    }
-                } else {
-                    return reject("error", "Unable to find current root view", nil)
-                }
-            } catch {
-                return reject("error", error.localizedDescription, error)
-            }
+  }
+  
+  @objc(isApplePaySupported:resolver:rejecter:)
+  func isApplePaySupported(merchantId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    do {
+      let payengine = try self.getInstance()
+      payengine.setupApplePay(merchantId: merchantId) { result in
+        switch result {
+        case .success(let applepay):
+          RNPayEngineNative.applePayInstance = applepay
+          return resolve(true)
+        case .failure(let error):
+          return reject("error", error.localizedDescription, error)
         }
+      }
+    } catch {
+      return reject("error", error.localizedDescription, error)
+    }
+  }
+  
+  
+  
+  @objc(configureFetchAccessTokenCallback:rejecter:)
+  func configureFetchAccessTokenCallback(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    resolve(nil)
+    accessTokenProvider = { [weak self] in
+      guard let self = self else {
+        throw NSError(domain: "com.payengine.error", code: 500, userInfo: [NSLocalizedDescriptionKey: "Instance deallocated"])
+      }
+      
+      return try self.fetchAccessTokenFromReact()
     }
     
-    @objc(isApplePaySupported:resolver:rejecter:)
-    func isApplePaySupported(merchantId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-        do {
-            let payengine = try self.getInstance()
-            payengine.setupApplePay(merchantId: merchantId) { result in
-                switch result {
-                case .success(let applepay):
-                    RNPayEngineNative.applePayInstance = applepay
-                    return resolve(true)
-                case .failure(let error):
-                    return reject("error", error.localizedDescription, error)
-                }
-            }
-        } catch {
-            return reject("error", error.localizedDescription, error)
-        }
+    PayEngine.setFetchAccessTokenCallback(accessTokenProvider!)
+  }
+  
+  @objc(provideFetchAccessTokenResult:resolver:rejecter:)
+  func provideFetchAccessTokenResult(_ value: [String: Any]?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    // Called from JS when value is ready
+    resolve(nil)
+    resultFromJS = value
+    semaphore?.signal()
+  }
+  
+  private func fetchAccessTokenFromReact() throws -> PEAccessTokenRepresentable {
+    // Step 1: Send event
+    semaphore = DispatchSemaphore(value: 0)
+    RNPEEventEmitter.emitter.sendEvent(withName: RNPEEvents.EVENT_FETCH_ACCESS_TOKEN, body: nil)
+    
+    // Step 2: Wait for JS to respond (up to 5 sec)
+    _ = semaphore?.wait(timeout: .now() + 5)
+    
+    // Step 3: Use the result or fallback
+    if let accessToken = resultFromJS?["accessToken"] as? String,
+       let expiresIn = resultFromJS?["expiresIn"] as? Int64 {
+      return AccessToken(accessToken: accessToken, expiresIn: expiresIn)
     }
+    
+    throw NSError(domain: "com.payengine.error", code: 500, userInfo: [NSLocalizedDescriptionKey: "nil values encountered"])
+  }
+  
+  @objc(logout:resolver:rejecter:)
+  func logout(_ merchantId: String, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    PayEngine.logout(merchantId: merchantId)
+    resolve(nil)
+  }
 }
 
 
+// Helper class to conform to the protocol
+private class AccessToken: PEAccessTokenRepresentable {
+    let accessToken: String
+    let expiresIn: Int64
 
+    init(accessToken: String, expiresIn: Int64) {
+        self.accessToken = accessToken
+        self.expiresIn = expiresIn
+    }
+}

package/ios/Sources/Classes/SecureFields/RNPEEvents.swift

@@ -12,4 +12,5 @@ class RNPEEvents {
     static let EVENT_BANK_ACCOUNT_RESPOND = "onBankAccountRespond"
     static let EVENT_CARD_RESPOND = "onCardRespond"
     static let EVENT_READY = "onReady"
+    static let EVENT_FETCH_ACCESS_TOKEN = "fetchAccessToken"
 }

package/ios/Sources/Payengine.m

@@ -14,6 +14,12 @@ RCT_EXTERN_METHOD(getBrowserInfo:(RCTPromiseResolveBlock)resolve rejecter:(RCTPr
 
 RCT_EXTERN_METHOD(isApplePaySupported:(NSString *)merchantId resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(configureFetchAccessTokenCallback:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(provideFetchAccessTokenResult:(NSDictionary *)value resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(logout:(NSString *)merchantId resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject)
+
 + (BOOL)requiresMainQueueSetup
 {
   return NO;

package/lib/commonjs/components/PayEngine.js

@@ -11,7 +11,7 @@ var _reactNative = require("react-native");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-const PayEngine = () => {
+const PayEngine = _props => {
   return /*#__PURE__*/_react.default.createElement(_reactNative.Text, null, "Obsolete. Please check out the package readme");
 };
 

package/lib/commonjs/components/PayEngine.js.map

@@ -1 +1 @@
-{"version":3,"names":["PayEngine"],"sources":["PayEngine.tsx"],"sourcesContent":["import React from 'react';\nimport { Text } from 'react-native';\n\nconst PayEngine = () => {\n  return <Text>Obsolete. Please check out the package readme</Text>;\n};\n\nexport default PayEngine;\n"],"mappings":";;;;;;;AAAA;;AACA;;;;AAEA,MAAMA,SAAS,GAAG,MAAM;EACtB,oBAAO,6BAAC,iBAAD,wDAAP;AACD,CAFD;;eAIeA,S"}
+{"version":3,"names":["PayEngine","_props"],"sources":["PayEngine.tsx"],"sourcesContent":["import React from 'react';\nimport { Text } from 'react-native';\n\nconst PayEngine = (_props: any) => {\n  return <Text>Obsolete. Please check out the package readme</Text>;\n};\n\nexport default PayEngine;\n"],"mappings":";;;;;;;AAAA;;AACA;;;;AAEA,MAAMA,SAAS,GAAIC,MAAD,IAAiB;EACjC,oBAAO,6BAAC,iBAAD,wDAAP;AACD,CAFD;;eAIeD,S"}

package/lib/commonjs/components/v2/ApplePay/PEApplePayButton.js

@@ -21,6 +21,130 @@ const COMPONENT_NAME = 'RNPEApplePayButton';
 const RNPEApplePayButton = (0, _reactNative.requireNativeComponent)(COMPONENT_NAME); // @ts-ignore
 
 const RNPEApplePayButtonManager = _reactNative.UIManager[COMPONENT_NAME];
+
+/**
+ * A React component for initiating an Apple Pay transaction.
+ *
+ * This button wraps the Apple Pay experience, including presenting the Apple Pay sheet,
+ * handling user interactions, processing the payment, and managing callbacks such as
+ * payment success, failure, and contact/method selection.
+ *
+ * It exposes imperative methods via `ref` to allow control over the Apple Pay sheet,
+ * such as updating summary items or shipping options in response to user input.
+ *
+ * ## Example Usage:
+ *
+ * ```tsx
+ * const paymentRequest = {
+ *   merchantId: "merchant.com.example",
+ *   countryCode: "US",
+ *   currencyCode: "USD",
+ *   paymentAmount: 10.00,
+ *   paymentSummaryItems: [
+ *     { label: "Test Item", amount: "10.00" }
+ *   ],
+ *   requiredShippingContactFields: ["name", "postalAddress"]
+ * };
+ *
+ * <PEApplePayButton
+ *   paymentRequest={paymentRequest}
+ *
+ *   // Triggered when payment fails
+ *   onPaymentFailed={(error) => console.error("Payment failed:", error)}
+ *
+ *   // Triggered when Apple Pay sheet is dismissed by the user
+ *   onPaymentSheetDismissed={() => console.log("Payment sheet dismissed")}
+ *
+ *   // Triggered when a valid token is generated after successful Apple Pay authorization
+ *   onTokenDidReturn={(token, metadata, billingContact, shippingContact) => {
+ *     console.log('Apple Pay token:', token, metadata, billingContact, shippingContact);
+ *     // TODO: Send token to your server for processing
+ *     purchaseWithToken(token);
+ *   }}
+ *
+ *   // Triggered when user selects or updates their shipping contact info
+ *   onShippingContactSelected={(event) => {
+ *     console.log('onShippingContactSelected', event.nativeEvent);
+ *
+ *     if (!event.nativeEvent.contact.postalCode) {
+ *       // Invalid postal code — update Apple Pay sheet with an error
+ *       buttonRef?.current?.updatePaymentSheet([], [], [{
+ *         errorType: PEApplePaySheetErrorType.InvalidShippingAddress,
+ *         field: PEApplePayInvalidShippingField.PostalCode,
+ *         message: 'Please update postal code to continue'
+ *       }]);
+ *     } else {
+ *       // Provide updated shipping methods if contact is valid
+ *       buttonRef?.current?.updatePaymentSheet([], [
+ *         {
+ *           identifier: 'new-shipping1',
+ *           label: 'Updated shipping 1',
+ *           amount: 3.99
+ *         },
+ *         {
+ *           identifier: 'new-shipping2',
+ *           label: 'Updated shipping 2',
+ *           amount: 5.99
+ *         }
+ *       ], []);
+ *     }
+ *   }}
+ *
+ *   // Triggered when user selects a shipping method
+ *   onShippingMethodSelected={(event) => {
+ *     console.log('onShippingMethodSelected', event.nativeEvent);
+ *
+ *     const shippingFee = event.nativeEvent.shippingMethod.amount;
+ *     const items = [
+ *       {
+ *         label: 'Product price',
+ *         amount: paymentRequest.paymentAmount
+ *       },
+ *       ...(shippingFee > 0 ? [{
+ *         label: 'Shipping Fee',
+ *         amount: shippingFee
+ *       }] : []),
+ *       {
+ *         label: 'Total',
+ *         amount: paymentRequest.paymentAmount + shippingFee
+ *       }
+ *     ];
+ *
+ *     buttonRef?.current?.updatePaymentSheet(items, [], []);
+ *   }}
+ *
+ *   // Triggered when user selects a payment method (e.g., credit, debit)
+ *   onPaymentMethodSelected={(event) => {
+ *     console.log('onPaymentMethodSelected', event.nativeEvent);
+ *
+ *     const isCredit = event.nativeEvent.paymentMethod.type === PEApplePayPaymentMethodType.credit;
+ *     const items = [
+ *       {
+ *         label: 'Product price',
+ *         amount: paymentRequest.paymentAmount
+ *       },
+ *       ...(isCredit ? [{
+ *         label: 'Credit discount',
+ *         amount: 10
+ *       }] : []),
+ *       {
+ *         label: 'Total',
+ *         amount: paymentRequest.paymentAmount - (isCredit ? 1.00 : 0.00)
+ *       }
+ *     ];
+ *
+ *     buttonRef?.current?.updatePaymentSheet(items, [], []);
+ *   }}
+ *
+ *   ref={applePayRef}
+ * />
+ * ```
+ *
+ * @param props - The props for configuring the Apple Pay button behavior.
+ * @param ref - A ref to access Apple Pay sheet update methods imperatively.
+ *
+ * @category Apple Pay
+ */
 const PEApplePayButton = /*#__PURE__*/React.forwardRef((props, ref) => {
   const buttonRef = React.useRef();
   React.useImperativeHandle(ref, () => ({

package/lib/commonjs/components/v2/ApplePay/PEApplePayButton.js.map

@@ -1 +1 @@
-{"version":3,"names":["RNPEEventEmitter","NativeModules","peEventEmitter","NativeEventEmitter","COMPONENT_NAME","RNPEApplePayButton","requireNativeComponent","RNPEApplePayButtonManager","UIManager","PEApplePayButton","React","forwardRef","props","ref","buttonRef","useRef","useImperativeHandle","updatePaymentSheet","summaryItems","shippingMethods","errors","Promise","resolve","reject","listener","addListener","args","remove","error","Error","callNativeMethod","useEffect","console","log","useCallback","methodName","params","viewId","findNodeHandle","current","commandId","Commands","toString","Platform","OS","Number","dispatchViewManagerCommand","pmError","event","onPaymentFailed","nativeEvent","pmTokenDidReturn","onTokenDidReturn","token","metadata","metadataString","billingContact","billingContactString","shippingContact","shippingContactString","JSON","parse","undefined","pmSheetDidDismiss","onPaymentSheetDismissed","height","width","style","stringify","paymentRequest","platformOptions","onPaymentMethodSelected","onShippingContactSelected","onShippingMethodSelected"],"sources":["PEApplePayButton.tsx"],"sourcesContent":["import * as React from 'react';\nimport {\n  findNodeHandle,\n  NativeEventEmitter,\n  NativeModules,\n  Platform,\n  requireNativeComponent,\n  Text,\n  UIManager,\n  ViewProps,\n} from 'react-native';\nimport type { PEPaymentRequest, PESummaryItem } from '../PEPaymentRequest';\nimport type {\n  PEApplePayContact,\n  PEApplePayPaymentMethod,\n  PEApplePaySheetError,\n  PEApplePayShippingMethod,\n} from './PEApplePayInterfaces';\n\nconst { RNPEEventEmitter } = NativeModules;\n\nconst peEventEmitter = new NativeEventEmitter(RNPEEventEmitter);\n\nconst COMPONENT_NAME = 'RNPEApplePayButton';\nconst RNPEApplePayButton =\n  requireNativeComponent<NativePEApplePayViewProps>(COMPONENT_NAME);\n\n// @ts-ignore\nconst RNPEApplePayButtonManager = UIManager[COMPONENT_NAME];\n\ntype NativePEApplePayEvent = {\n  nativeEvent: {\n    error?: string;\n    token?: string;\n    metadata?: any;\n    billingContact?: string;\n    shippingContact?: string;\n    paymentMethod?: string;\n    contact?: string;\n    shippingMethod?: string;\n  };\n};\n\ninterface NativePEApplePayViewProps extends ViewProps {\n  paymentRequest: string;\n  onPmSheetDidDismiss: (event: NativePEApplePayEvent) => void;\n  onPmTokenDidReturn: (event: NativePEApplePayEvent) => void;\n  onPmError: (event: NativePEApplePayEvent) => void;\n  onPaymentMethodSelected?: (event: {\n    nativeEvent: {\n      paymentMethod: PEApplePayPaymentMethod;\n    };\n  }) => void;\n  onShippingContactSelected?: (event: {\n    nativeEvent: {\n      contact: PEApplePayContact;\n    };\n  }) => void;\n  onShippingMethodSelected?: (event: {\n    nativeEvent: {\n      shippingMethod: PEApplePayShippingMethod;\n    };\n  }) => void;\n}\n\nexport interface PEApplePayButtonProps extends ViewProps {\n  paymentRequest: PEPaymentRequest;\n  onTokenDidReturn?: (\n    token: string,\n    metadata?: any,\n    billingContact?: PEApplePayContact,\n    shippingContact?: PEApplePayContact\n  ) => void;\n  onPaymentSheetDismissed?: () => void;\n  onPaymentFailed?: (error: Error) => void;\n  /**\n   * This callback is triggered whenever the payment method changes in the Apple Pay sheet.\n   * You MUST update the Apple Pay sheet in your callback using the updatePaymentSheet function,\n   * otherwise the Apple Pay sheet will hang and the payment flow will automatically cancel.\n   */\n  onPaymentMethodSelected?: (event: {\n    nativeEvent: {\n      paymentMethod: PEApplePayPaymentMethod;\n    };\n  }) => void;\n  /**\n   * This callback is triggered whenever the user selects a shipping method in the Apple Pay sheet.\n   * You MUST update the Apple Pay sheet in your callback using the updatePaymentSheet function,\n   * otherwise the Apple Pay sheet will hang and the payment flow will automatically cancel.\n   */\n  onShippingContactSelected?: (event: {\n    nativeEvent: {\n      contact: PEApplePayContact;\n    };\n  }) => void;\n  /**\n   * This callback is triggered whenever the user selects a shipping contact in the Apple Pay sheet.\n   * You MUST update the Apple Pay sheet in your callback using the updatePaymentSheet function,\n   * otherwise the Apple Pay sheet will hang and the payment flow will automatically cancel.\n   */\n  onShippingMethodSelected?: (event: {\n    nativeEvent: {\n      shippingMethod: PEApplePayShippingMethod;\n    };\n  }) => void;\n}\n\nexport interface PEApplePayButtonMethods {\n  /**\n   * This method must be called after either onPaymentMethodSelected, onShippingContactSelected or\n   * onShippingMethodSelected callbacks are triggered.\n   * `shippingMethods` and `errors` are only applicable for onShippingContactSelected callback\n   */\n  updatePaymentSheet: (\n    summaryItems: PESummaryItem[],\n    shippingMethods: PEApplePayShippingMethod[],\n    errors: PEApplePaySheetError[]\n  ) => Promise<boolean>;\n}\n\nexport const PEApplePayButton = React.forwardRef<\n  PEApplePayButtonMethods,\n  PEApplePayButtonProps\n>((props, ref) => {\n  const buttonRef = React.useRef<any>();\n\n  React.useImperativeHandle(ref, () => ({\n    updatePaymentSheet: async (\n      summaryItems: PESummaryItem[],\n      shippingMethods: PEApplePayShippingMethod[],\n      errors: PEApplePaySheetError[]\n    ): Promise<boolean> => {\n      return new Promise((resolve, reject) => {\n        const listener = peEventEmitter.addListener(\n          'onUpdatePaymentSheetResult',\n          (args) => {\n            listener.remove();\n\n            const { error } = args;\n            if (error) {\n              reject(new Error(error));\n            } else {\n              resolve(true);\n            }\n          }\n        );\n        callNativeMethod('updatePaymentSheet', [\n          summaryItems,\n          shippingMethods,\n          errors,\n        ]);\n      });\n    },\n  }));\n\n  React.useEffect(() => {\n    const listener = peEventEmitter.addListener(\n      'onUpdatePaymentSheetResult',\n      (args) => {\n        console.log('Received event onUpdatePaymentSheetResult', args);\n      }\n    );\n    return () => {\n      listener.remove();\n    };\n  }, []);\n\n  const callNativeMethod = React.useCallback(\n    (methodName: string, params: any[] = []) => {\n      const viewId = findNodeHandle(buttonRef.current);\n      let commandId = RNPEApplePayButtonManager.Commands[methodName].toString();\n      if (Platform.OS === 'ios') {\n        commandId = Number(commandId);\n      }\n      UIManager.dispatchViewManagerCommand(viewId, commandId, params);\n    },\n    [buttonRef.current]\n  );\n\n  const pmError = (event: NativePEApplePayEvent) => {\n    if (props.onPaymentFailed) {\n      props.onPaymentFailed(new Error(event.nativeEvent.error));\n    }\n  };\n\n  const pmTokenDidReturn = (event: NativePEApplePayEvent) => {\n    if (props.onTokenDidReturn) {\n      const {\n        token,\n        metadata: metadataString,\n        billingContact: billingContactString,\n        shippingContact: shippingContactString,\n      } = event.nativeEvent;\n      console.log(\n        'ON token',\n        token,\n        metadataString,\n        billingContactString,\n        shippingContactString\n      );\n      const metadata = metadataString ? JSON.parse(metadataString) : null;\n      const billingContact = billingContactString\n        ? (JSON.parse(billingContactString) as PEApplePayContact)\n        : null;\n      const shippingContact = shippingContactString\n        ? (JSON.parse(shippingContactString) as PEApplePayContact)\n        : null;\n\n      props.onTokenDidReturn(\n        token!,\n        metadata,\n        billingContact ?? undefined,\n        shippingContact ?? undefined\n      );\n    }\n  };\n\n  const pmSheetDidDismiss = () => {\n    if (props.onPaymentSheetDismissed) {\n      props.onPaymentSheetDismissed();\n    }\n  };\n\n  if (Platform.OS !== 'ios') {\n    return <Text>Apple Pay is not supported on this platform</Text>;\n  }\n\n  return (\n    <RNPEApplePayButton\n      ref={buttonRef}\n      style={{ height: 32, width: '100%', ...(props.style as object) }}\n      paymentRequest={JSON.stringify({\n        ...props.paymentRequest,\n        ...props.paymentRequest.platformOptions,\n      })}\n      onPmError={pmError}\n      onPmTokenDidReturn={pmTokenDidReturn}\n      onPmSheetDidDismiss={pmSheetDidDismiss}\n      onPaymentMethodSelected={props.onPaymentMethodSelected}\n      onShippingContactSelected={props.onShippingContactSelected}\n      onShippingMethodSelected={props.onShippingMethodSelected}\n    />\n  );\n});\n"],"mappings":"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"}
+{"version":3,"names":["RNPEEventEmitter","NativeModules","peEventEmitter","NativeEventEmitter","COMPONENT_NAME","RNPEApplePayButton","requireNativeComponent","RNPEApplePayButtonManager","UIManager","PEApplePayButton","React","forwardRef","props","ref","buttonRef","useRef","useImperativeHandle","updatePaymentSheet","summaryItems","shippingMethods","errors","Promise","resolve","reject","listener","addListener","args","remove","error","Error","callNativeMethod","useEffect","console","log","useCallback","methodName","params","viewId","findNodeHandle","current","commandId","Commands","toString","Platform","OS","Number","dispatchViewManagerCommand","pmError","event","onPaymentFailed","nativeEvent","pmTokenDidReturn","onTokenDidReturn","token","metadata","metadataString","billingContact","billingContactString","shippingContact","shippingContactString","JSON","parse","undefined","pmSheetDidDismiss","onPaymentSheetDismissed","height","width","style","stringify","paymentRequest","platformOptions","onPaymentMethodSelected","onShippingContactSelected","onShippingMethodSelected"],"sources":["PEApplePayButton.tsx"],"sourcesContent":["import * as React from 'react';\nimport {\n  findNodeHandle,\n  NativeEventEmitter,\n  NativeModules,\n  Platform,\n  requireNativeComponent,\n  Text,\n  UIManager,\n  ViewProps,\n} from 'react-native';\nimport type { PEPaymentRequest, PESummaryItem } from '../PEPaymentRequest';\nimport type {\n  PEApplePayContact,\n  PEApplePayPaymentMethod,\n  PEApplePaySheetError,\n  PEApplePayShippingMethod,\n} from './PEApplePayInterfaces';\n\nconst { RNPEEventEmitter } = NativeModules;\n\nconst peEventEmitter = new NativeEventEmitter(RNPEEventEmitter);\n\nconst COMPONENT_NAME = 'RNPEApplePayButton';\nconst RNPEApplePayButton =\n  requireNativeComponent<NativePEApplePayViewProps>(COMPONENT_NAME);\n\n// @ts-ignore\nconst RNPEApplePayButtonManager = UIManager[COMPONENT_NAME];\n\ntype NativePEApplePayEvent = {\n  nativeEvent: {\n    error?: string;\n    token?: string;\n    metadata?: any;\n    billingContact?: string;\n    shippingContact?: string;\n    paymentMethod?: string;\n    contact?: string;\n    shippingMethod?: string;\n  };\n};\n\ninterface NativePEApplePayViewProps extends ViewProps {\n  paymentRequest: string;\n  onPmSheetDidDismiss: (event: NativePEApplePayEvent) => void;\n  onPmTokenDidReturn: (event: NativePEApplePayEvent) => void;\n  onPmError: (event: NativePEApplePayEvent) => void;\n  onPaymentMethodSelected?: (event: {\n    nativeEvent: {\n      paymentMethod: PEApplePayPaymentMethod;\n    };\n  }) => void;\n  onShippingContactSelected?: (event: {\n    nativeEvent: {\n      contact: PEApplePayContact;\n    };\n  }) => void;\n  onShippingMethodSelected?: (event: {\n    nativeEvent: {\n      shippingMethod: PEApplePayShippingMethod;\n    };\n  }) => void;\n}\n\n/**\n * Props for the Apple Pay button component.\n *\n * This interface defines the properties you can pass to the Apple Pay button,\n * including the payment request and various event callbacks triggered throughout\n * the Apple Pay flow.\n *\n * @category Apple Pay\n */\nexport interface PEApplePayButtonProps extends ViewProps {\n  /**\n   * The payment request containing transaction details such as the total amount,\n   * currency, supported networks, and required contact fields.\n   */\n  paymentRequest: PEPaymentRequest;\n\n  /**\n   * Callback triggered when the Apple Pay token is successfully generated.\n   *\n   * @param token - A string representing the Apple Pay payment token.\n   * @param metadata - Optional metadata related to the transaction.\n   * @param billingContact - The billing contact information (if available).\n   * @param shippingContact - The shipping contact information (if available).\n   *\n   * Example:\n   * ```ts\n   * onTokenDidReturn: (token, metadata, billing, shipping) => {\n   *   console.log('Token:', token);\n   *   console.log('Billing contact:', billing?.givenName);\n   *   console.log('Shipping contact:', shipping?.givenName);\n   * }\n   * ```\n   */\n  onTokenDidReturn?: (\n    token: string,\n    metadata?: any,\n    billingContact?: PEApplePayContact,\n    shippingContact?: PEApplePayContact\n  ) => void;\n\n  /**\n   * Callback triggered when the Apple Pay sheet is dismissed,\n   * either by completing the payment or canceling it.\n   */\n  onPaymentSheetDismissed?: () => void;\n\n  /**\n   * Callback triggered when the Apple Pay process fails.\n   *\n   * @param error - The error that occurred during the payment flow.\n   */\n  onPaymentFailed?: (error: Error) => void;\n\n  /**\n   * Callback triggered when the user selects or changes the payment method\n   * within the Apple Pay sheet.\n   *\n   * You MUST call `updatePaymentSheet` in response to this callback to update\n   * the Apple Pay sheet. Failing to do so will cause the sheet to hang\n   * and the transaction will automatically cancel.\n   */\n  onPaymentMethodSelected?: (event: {\n    nativeEvent: {\n      paymentMethod: PEApplePayPaymentMethod;\n    };\n  }) => void;\n\n  /**\n   * Callback triggered when the user selects a shipping contact\n   * (e.g., their shipping address) within the Apple Pay sheet.\n   *\n   * You MUST call `updatePaymentSheet` in response to this callback to update\n   * shipping methods, summary items, or errors. Failure to do so will hang the\n   * sheet and cancel the transaction automatically.\n   */\n  onShippingContactSelected?: (event: {\n    nativeEvent: {\n      contact: PEApplePayContact;\n    };\n  }) => void;\n\n  /**\n   * Callback triggered when the user selects a shipping method (e.g., standard or express)\n   * in the Apple Pay sheet.\n   *\n   * You MUST call `updatePaymentSheet` in response to this callback to reflect\n   * any changes in pricing or available options. If you don't, the Apple Pay sheet\n   * will hang and the payment will be canceled.\n   */\n  onShippingMethodSelected?: (event: {\n    nativeEvent: {\n      shippingMethod: PEApplePayShippingMethod;\n    };\n  }) => void;\n}\n\n\n/**\n * Exposes imperative methods for controlling the Apple Pay payment sheet.\n *\n * This interface is typically used via a `ref` to programmatically update\n * the state of the Apple Pay sheet after certain user interactions.\n *\n * Specifically, the `updatePaymentSheet` method should be called in response to\n * any of the following events:\n * - `onPaymentMethodSelected`\n * - `onShippingContactSelected`\n * - `onShippingMethodSelected`\n *\n * @category Apple Pay\n */\nexport interface PEApplePayButtonMethods {\n  /**\n   * Updates the Apple Pay payment sheet with new summary items, shipping methods, and validation errors.\n   *\n   * This method should be called in response to user selections made on the Apple Pay sheet,\n   * such as selecting a new payment method, shipping contact, or shipping method.\n   *\n   * ### Parameters:\n   * - `summaryItems`: The updated list of items summarizing the total payment amount (e.g., subtotal, tax, total).\n   * - `shippingMethods`: A list of available shipping methods based on the selected shipping contact.\n   *   - Only applicable when the `onShippingContactSelected` callback is triggered.\n   * - `errors`: A list of validation errors (e.g., invalid address or unsupported shipping region).\n   *   - Also only applicable for `onShippingContactSelected`.\n   *\n   * ### Returns:\n   * - A `Promise<boolean>` indicating whether the update was successful.\n   *\n   * ### Example:\n   * ```ts\n   * await ref.current?.updatePaymentSheet(\n   *   updatedSummaryItems,\n   *   availableShippingMethods,\n   *   validationErrors\n   * );\n   * ```\n   */\n  updatePaymentSheet: (\n    summaryItems: PESummaryItem[],\n    shippingMethods: PEApplePayShippingMethod[],\n    errors: PEApplePaySheetError[]\n  ) => Promise<boolean>;\n}\n\n\n/**\n * A React component for initiating an Apple Pay transaction.\n *\n * This button wraps the Apple Pay experience, including presenting the Apple Pay sheet,\n * handling user interactions, processing the payment, and managing callbacks such as\n * payment success, failure, and contact/method selection.\n *\n * It exposes imperative methods via `ref` to allow control over the Apple Pay sheet,\n * such as updating summary items or shipping options in response to user input.\n *\n * ## Example Usage:\n *\n * ```tsx\n * const paymentRequest = {\n *   merchantId: \"merchant.com.example\",\n *   countryCode: \"US\",\n *   currencyCode: \"USD\",\n *   paymentAmount: 10.00,\n *   paymentSummaryItems: [\n *     { label: \"Test Item\", amount: \"10.00\" }\n *   ],\n *   requiredShippingContactFields: [\"name\", \"postalAddress\"]\n * };\n *\n * <PEApplePayButton\n *   paymentRequest={paymentRequest}\n *\n *   // Triggered when payment fails\n *   onPaymentFailed={(error) => console.error(\"Payment failed:\", error)}\n *\n *   // Triggered when Apple Pay sheet is dismissed by the user\n *   onPaymentSheetDismissed={() => console.log(\"Payment sheet dismissed\")}\n *\n *   // Triggered when a valid token is generated after successful Apple Pay authorization\n *   onTokenDidReturn={(token, metadata, billingContact, shippingContact) => {\n *     console.log('Apple Pay token:', token, metadata, billingContact, shippingContact);\n *     // TODO: Send token to your server for processing\n *     purchaseWithToken(token);\n *   }}\n *\n *   // Triggered when user selects or updates their shipping contact info\n *   onShippingContactSelected={(event) => {\n *     console.log('onShippingContactSelected', event.nativeEvent);\n *\n *     if (!event.nativeEvent.contact.postalCode) {\n *       // Invalid postal code — update Apple Pay sheet with an error\n *       buttonRef?.current?.updatePaymentSheet([], [], [{\n *         errorType: PEApplePaySheetErrorType.InvalidShippingAddress,\n *         field: PEApplePayInvalidShippingField.PostalCode,\n *         message: 'Please update postal code to continue'\n *       }]);\n *     } else {\n *       // Provide updated shipping methods if contact is valid\n *       buttonRef?.current?.updatePaymentSheet([], [\n *         {\n *           identifier: 'new-shipping1',\n *           label: 'Updated shipping 1',\n *           amount: 3.99\n *         },\n *         {\n *           identifier: 'new-shipping2',\n *           label: 'Updated shipping 2',\n *           amount: 5.99\n *         }\n *       ], []);\n *     }\n *   }}\n *\n *   // Triggered when user selects a shipping method\n *   onShippingMethodSelected={(event) => {\n *     console.log('onShippingMethodSelected', event.nativeEvent);\n *\n *     const shippingFee = event.nativeEvent.shippingMethod.amount;\n *     const items = [\n *       {\n *         label: 'Product price',\n *         amount: paymentRequest.paymentAmount\n *       },\n *       ...(shippingFee > 0 ? [{\n *         label: 'Shipping Fee',\n *         amount: shippingFee\n *       }] : []),\n *       {\n *         label: 'Total',\n *         amount: paymentRequest.paymentAmount + shippingFee\n *       }\n *     ];\n *\n *     buttonRef?.current?.updatePaymentSheet(items, [], []);\n *   }}\n *\n *   // Triggered when user selects a payment method (e.g., credit, debit)\n *   onPaymentMethodSelected={(event) => {\n *     console.log('onPaymentMethodSelected', event.nativeEvent);\n *\n *     const isCredit = event.nativeEvent.paymentMethod.type === PEApplePayPaymentMethodType.credit;\n *     const items = [\n *       {\n *         label: 'Product price',\n *         amount: paymentRequest.paymentAmount\n *       },\n *       ...(isCredit ? [{\n *         label: 'Credit discount',\n *         amount: 10\n *       }] : []),\n *       {\n *         label: 'Total',\n *         amount: paymentRequest.paymentAmount - (isCredit ? 1.00 : 0.00)\n *       }\n *     ];\n *\n *     buttonRef?.current?.updatePaymentSheet(items, [], []);\n *   }}\n *\n *   ref={applePayRef}\n * />\n * ```\n *\n * @param props - The props for configuring the Apple Pay button behavior.\n * @param ref - A ref to access Apple Pay sheet update methods imperatively.\n *\n * @category Apple Pay\n */\nexport const PEApplePayButton = React.forwardRef<\n  PEApplePayButtonMethods,\n  PEApplePayButtonProps\n>((props, ref) => {\n  const buttonRef = React.useRef<any>();\n\n  React.useImperativeHandle(ref, () => ({\n    updatePaymentSheet: async (\n      summaryItems: PESummaryItem[],\n      shippingMethods: PEApplePayShippingMethod[],\n      errors: PEApplePaySheetError[]\n    ): Promise<boolean> => {\n      return new Promise((resolve, reject) => {\n        const listener = peEventEmitter.addListener(\n          'onUpdatePaymentSheetResult',\n          (args) => {\n            listener.remove();\n\n            const { error } = args;\n            if (error) {\n              reject(new Error(error));\n            } else {\n              resolve(true);\n            }\n          }\n        );\n        callNativeMethod('updatePaymentSheet', [\n          summaryItems,\n          shippingMethods,\n          errors,\n        ]);\n      });\n    },\n  }));\n\n  React.useEffect(() => {\n    const listener = peEventEmitter.addListener(\n      'onUpdatePaymentSheetResult',\n      (args) => {\n        console.log('Received event onUpdatePaymentSheetResult', args);\n      }\n    );\n    return () => {\n      listener.remove();\n    };\n  }, []);\n\n  const callNativeMethod = React.useCallback(\n    (methodName: string, params: any[] = []) => {\n      const viewId = findNodeHandle(buttonRef.current);\n      let commandId = RNPEApplePayButtonManager.Commands[methodName].toString();\n      if (Platform.OS === 'ios') {\n        commandId = Number(commandId);\n      }\n      UIManager.dispatchViewManagerCommand(viewId, commandId, params);\n    },\n    [buttonRef.current]\n  );\n\n  const pmError = (event: NativePEApplePayEvent) => {\n    if (props.onPaymentFailed) {\n      props.onPaymentFailed(new Error(event.nativeEvent.error));\n    }\n  };\n\n  const pmTokenDidReturn = (event: NativePEApplePayEvent) => {\n    if (props.onTokenDidReturn) {\n      const {\n        token,\n        metadata: metadataString,\n        billingContact: billingContactString,\n        shippingContact: shippingContactString,\n      } = event.nativeEvent;\n      console.log(\n        'ON token',\n        token,\n        metadataString,\n        billingContactString,\n        shippingContactString\n      );\n      const metadata = metadataString ? JSON.parse(metadataString) : null;\n      const billingContact = billingContactString\n        ? (JSON.parse(billingContactString) as PEApplePayContact)\n        : null;\n      const shippingContact = shippingContactString\n        ? (JSON.parse(shippingContactString) as PEApplePayContact)\n        : null;\n\n      props.onTokenDidReturn(\n        token!,\n        metadata,\n        billingContact ?? undefined,\n        shippingContact ?? undefined\n      );\n    }\n  };\n\n  const pmSheetDidDismiss = () => {\n    if (props.onPaymentSheetDismissed) {\n      props.onPaymentSheetDismissed();\n    }\n  };\n\n  if (Platform.OS !== 'ios') {\n    return <Text>Apple Pay is not supported on this platform</Text>;\n  }\n\n  return (\n    <RNPEApplePayButton\n      ref={buttonRef}\n      style={{ height: 32, width: '100%', ...(props.style as object) }}\n      paymentRequest={JSON.stringify({\n        ...props.paymentRequest,\n        ...props.paymentRequest.platformOptions,\n      })}\n      onPmError={pmError}\n      onPmTokenDidReturn={pmTokenDidReturn}\n      onPmSheetDidDismiss={pmSheetDidDismiss}\n      onPaymentMethodSelected={props.onPaymentMethodSelected}\n      onShippingContactSelected={props.onShippingContactSelected}\n      onShippingMethodSelected={props.onShippingMethodSelected}\n    />\n  );\n});\n"],"mappings":";;;;;;;AAAA;;AACA;;;;;;AAkBA,MAAM;EAAEA;AAAF,IAAuBC,0BAA7B;AAEA,MAAMC,cAAc,GAAG,IAAIC,+BAAJ,CAAuBH,gBAAvB,CAAvB;AAEA,MAAMI,cAAc,GAAG,oBAAvB;AACA,MAAMC,kBAAkB,GACtB,IAAAC,mCAAA,EAAkDF,cAAlD,CADF,C,CAGA;;AACA,MAAMG,yBAAyB,GAAGC,sBAAA,CAAUJ,cAAV,CAAlC;;AAsLA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMK,gBAAgB,gBAAGC,KAAK,CAACC,UAAN,CAG9B,CAACC,KAAD,EAAQC,GAAR,KAAgB;EAChB,MAAMC,SAAS,GAAGJ,KAAK,CAACK,MAAN,EAAlB;EAEAL,KAAK,CAACM,mBAAN,CAA0BH,GAA1B,EAA+B,OAAO;IACpCI,kBAAkB,EAAE,OAClBC,YADkB,EAElBC,eAFkB,EAGlBC,MAHkB,KAIG;MACrB,OAAO,IAAIC,OAAJ,CAAY,CAACC,OAAD,EAAUC,MAAV,KAAqB;QACtC,MAAMC,QAAQ,GAAGtB,cAAc,CAACuB,WAAf,CACf,4BA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"}

package/lib/commonjs/components/v2/ApplePay/PEApplePayInterfaces.js

@@ -4,7 +4,69 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.PEApplePaySheetErrorType = exports.PEApplePayPaymentMethodType = exports.PEApplePayInvalidShippingField = void 0;
+
+/**
+ * A model representing a contact associated with Apple Pay.
+ *
+ * This interface defines the contact details that can be associated with an Apple Pay transaction,
+ * including personal and address information such as the contact's name, address, email, and phone number.
+ * The fields are optional, meaning not all fields need to be provided when creating an instance.
+ *
+ * ## Example Usage:
+ * ```ts
+ * const contact: PEApplePayContact = {
+ *   givenName: 'John',
+ *   familyName: 'Doe',
+ *   addressLines: ['123 Main St', 'Suite 400'],
+ *   locality: 'Anytown',
+ *   administrativeArea: 'CA',
+ *   postalCode: '12345',
+ *   country: 'USA',
+ *   countryCode: 'US',
+ *   subAdministrativeArea: 'SubArea',
+ *   subLocality: 'Locality',
+ *   emailAddress: 'john.doe@example.com',
+ *   phoneNumber: '+1234567890',
+ * };
+ * ```
+ *
+ * @category Apple Pay
+ */
+
+/**
+ * A model representing the selected Apple Pay payment method.
+ *
+ * This interface provides details about the payment method chosen by the user
+ * during an Apple Pay transaction. It includes the method's display name,
+ * payment network (e.g., Visa, MasterCard), and the type of payment method.
+ *
+ * ## Example Usage:
+ * ```ts
+ * const paymentMethod: PEApplePayPaymentMethod = {
+ *   displayName: 'Visa 1234',
+ *   network: 'Visa',
+ *   type: 'credit', // or 'debit', depending on your enum or string literal type
+ * };
+ * ```
+ *
+ * @category Apple Pay
+ */
+
+/**
+ * Enum representing the different types of payment methods supported by Apple Pay.
+ * Each value corresponds to a specific payment method category.
+ * 
+ * @category Apple Pay
+ */
 let PEApplePayPaymentMethodType;
+/**
+ * Represents a shipping method available during Apple Pay checkout.
+ *
+ * Includes label, amount, and identifier.
+ *
+ * @category Apple Pay
+ */
+
 exports.PEApplePayPaymentMethodType = PEApplePayPaymentMethodType;
 
 (function (PEApplePayPaymentMethodType) {
@@ -16,7 +78,23 @@ exports.PEApplePayPaymentMethodType = PEApplePayPaymentMethodType;
   PEApplePayPaymentMethodType[PEApplePayPaymentMethodType["eMoney"] = 5] = "eMoney";
 })(PEApplePayPaymentMethodType || (exports.PEApplePayPaymentMethodType = PEApplePayPaymentMethodType = {}));
 
+/**
+ * Enum representing the types of errors that can occur during the Apple Pay 
+ * sheet process. These errors typically relate to issues with the shipping 
+ * address provided by the user.
+ * 
+ * @category Apple Pay
+ */
 let PEApplePaySheetErrorType;
+/**
+ * 
+ * Enum representing the fields of shipping address that may be invalid
+ * during Apple Pay transactions. These values can be used to identify 
+ * which part of the shipping address is incorrect or missing.
+ * 
+ * @category Apple Pay
+ */
+
 exports.PEApplePaySheetErrorType = PEApplePaySheetErrorType;
 
 (function (PEApplePaySheetErrorType) {

package/lib/commonjs/components/v2/ApplePay/PEApplePayInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"names":["PEApplePayPaymentMethodType","PEApplePaySheetErrorType","PEApplePayInvalidShippingField"],"sources":["PEApplePayInterfaces.ts"],"sourcesContent":["export interface PEApplePayContact {\n  givenName?: string;\n  familyName?: string;\n  addressLines?: string[];\n  locality?: string;\n  administrativeArea?: string;\n  postalCode?: string;\n  country?: string;\n  countryCode?: string;\n  subAdministrativeArea?: string;\n  subLocality?: string;\n  emailAddress?: string;\n  phoneNumber?: string;\n}\n\nexport interface PEApplePayPaymentMethod {\n  displayName?: string;\n  network?: string;\n  type: PEApplePayPaymentMethodType;\n}\n\nexport enum PEApplePayPaymentMethodType {\n  unknown = 0,\n  debit = 1,\n  credit = 2,\n  prepaid = 3,\n  store = 4,\n  eMoney = 5\n}\n\nexport interface PEApplePayShippingMethod {\n  identifier: string;\n  amount: number;\n  label: string;\n}\n\nexport type PEApplePaySheetError =\n  | {\n      errorType: PEApplePaySheetErrorType.InvalidShippingAddress;\n      field: PEApplePayInvalidShippingField;\n      message?: string;\n    }\n  | {\n      errorType:\n        | PEApplePaySheetErrorType.UnserviceableShippingAddress\n      message?: string;\n    };\n\nexport enum PEApplePaySheetErrorType {\n  InvalidShippingAddress = 'InvalidShippingAddress',\n  UnserviceableShippingAddress = 'UnserviceableShippingAddress',\n}\n\nexport enum PEApplePayInvalidShippingField {\n  Street = 'street',\n  City = 'city',\n  SubAdministrativeArea = 'subAdministrativeArea',\n  State = 'state',\n  PostalCode = 'postalCode',\n  Country = 'country',\n  CountryCode = 'countryCode',\n  SubLocality = 'subLocality',\n}\n"],"mappings":";;;;;;IAqBYA,2B;;;WAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;GAAAA,2B,2CAAAA,2B;;IA2BAC,wB;;;WAAAA,wB;EAAAA,wB;EAAAA,wB;GAAAA,wB,wCAAAA,wB;;IAKAC,8B;;;WAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;GAAAA,8B,8CAAAA,8B"}
+{"version":3,"names":["PEApplePayPaymentMethodType","PEApplePaySheetErrorType","PEApplePayInvalidShippingField"],"sources":["PEApplePayInterfaces.ts"],"sourcesContent":["/**\n * A model representing a contact associated with Apple Pay.\n *\n * This interface defines the contact details that can be associated with an Apple Pay transaction,\n * including personal and address information such as the contact's name, address, email, and phone number.\n * The fields are optional, meaning not all fields need to be provided when creating an instance.\n *\n * ## Example Usage:\n * ```ts\n * const contact: PEApplePayContact = {\n *   givenName: 'John',\n *   familyName: 'Doe',\n *   addressLines: ['123 Main St', 'Suite 400'],\n *   locality: 'Anytown',\n *   administrativeArea: 'CA',\n *   postalCode: '12345',\n *   country: 'USA',\n *   countryCode: 'US',\n *   subAdministrativeArea: 'SubArea',\n *   subLocality: 'Locality',\n *   emailAddress: 'john.doe@example.com',\n *   phoneNumber: '+1234567890',\n * };\n * ```\n *\n * @category Apple Pay\n */\nexport interface PEApplePayContact {\n  /**\n   * The given (first) name of the contact.\n   * \n   * Example: \"John\"\n   */\n  givenName?: string;\n\n  /**\n   * The family (last) name of the contact.\n   * \n   * Example: \"Doe\"\n   */\n  familyName?: string;\n\n  /**\n   * The contact's address lines, typically representing street addresses.\n   * \n   * Example: [\"123 Main St\", \"Suite 400\"]\n   */\n  addressLines?: string[];\n\n  /**\n   * The city or locality of the contact's address.\n   * \n   * Example: \"Anytown\"\n   */\n  locality?: string;\n\n  /**\n   * The state, province, or administrative area of the contact's address.\n   * \n   * Example: \"CA\"\n   */\n  administrativeArea?: string;\n\n  /**\n   * The postal code (ZIP code) of the contact's address.\n   * \n   * Example: \"12345\"\n   */\n  postalCode?: string;\n\n  /**\n   * The full country name of the contact's address.\n   * \n   * Example: \"USA\"\n   */\n  country?: string;\n\n  /**\n   * The ISO country code (e.g., \"US\" for the United States).\n   * \n   * Example: \"US\"\n   */\n  countryCode?: string;\n\n  /**\n   * A more specific administrative area within the main administrative area.\n   * \n   * Example: \"SubArea\"\n   */\n  subAdministrativeArea?: string;\n\n  /**\n   * A more specific locality within the main locality.\n   * \n   * Example: \"Locality\"\n   */\n  subLocality?: string;\n\n  /**\n   * The contact's email address.\n   * \n   * Example: \"john.doe@example.com\"\n   */\n  emailAddress?: string;\n\n  /**\n   * The contact's phone number.\n   * \n   * Example: \"+1234567890\"\n   */\n  phoneNumber?: string;\n}\n\n\n/**\n * A model representing the selected Apple Pay payment method.\n *\n * This interface provides details about the payment method chosen by the user\n * during an Apple Pay transaction. It includes the method's display name,\n * payment network (e.g., Visa, MasterCard), and the type of payment method.\n *\n * ## Example Usage:\n * ```ts\n * const paymentMethod: PEApplePayPaymentMethod = {\n *   displayName: 'Visa 1234',\n *   network: 'Visa',\n *   type: 'credit', // or 'debit', depending on your enum or string literal type\n * };\n * ```\n *\n * @category Apple Pay\n */\nexport interface PEApplePayPaymentMethod {\n  /**\n   * A user-facing description of the payment method.\n   * \n   * This typically includes the card type and last few digits, e.g., \"Visa 1234\".\n   */\n  displayName?: string;\n\n  /**\n   * The network associated with the payment method.\n   * \n   * Common examples include \"Visa\", \"MasterCard\", \"Amex\", etc.\n   */\n  network?: string;\n\n  /**\n   * The type of payment method.\n   * \n   * This is a required field indicating whether the method is a credit card, debit card, etc.\n   */\n  type: PEApplePayPaymentMethodType;\n}\n\n\n/**\n * Enum representing the different types of payment methods supported by Apple Pay.\n * Each value corresponds to a specific payment method category.\n * \n * @category Apple Pay\n */\nexport enum PEApplePayPaymentMethodType {\n  /** Unknown payment method type. */\n  unknown = 0,\n\n  /** Debit card payment method. */\n  debit = 1,\n\n  /** Credit card payment method. */\n  credit = 2,\n\n  /** Prepaid card payment method. */\n  prepaid = 3,\n\n  /** Store card payment method. */\n  store = 4,\n\n  /** Electronic money (e-money) payment method. */\n  eMoney = 5\n}\n\n\n/**\n * Represents a shipping method available during Apple Pay checkout.\n *\n * Includes label, amount, and identifier.\n *\n * @category Apple Pay\n */\nexport interface PEApplePayShippingMethod {\n  /** Unique identifier for the shipping method. */\n  identifier: string;\n\n  /** Cost associated with this shipping method. */\n  amount: number;\n\n  /** Display label (e.g., \"Express Delivery\"). */\n  label: string;\n}\n\n/**\n * Type representing the possible errors that can occur during the Apple Pay\n * sheet process. This includes issues related to invalid or unserviceable\n * shipping addresses.\n * \n * * @category Apple Pay\n */\nexport type PEApplePaySheetError =\n  | {\n    /** The error occurs due to an invalid shipping address. */\n    errorType: PEApplePaySheetErrorType.InvalidShippingAddress;\n\n    /** The specific field in the shipping address that caused the error. */\n    field: PEApplePayInvalidShippingField;\n\n    /** An optional message providing more details about the error. */\n    message?: string;\n  }\n  | {\n    /** The error occurs due to an unserviceable shipping address. */\n    errorType: PEApplePaySheetErrorType.UnserviceableShippingAddress;\n\n    /** An optional message providing more details about the error. */\n    message?: string;\n  };\n\n/**\n * Enum representing the types of errors that can occur during the Apple Pay \n * sheet process. These errors typically relate to issues with the shipping \n * address provided by the user.\n * \n * @category Apple Pay\n */\nexport enum PEApplePaySheetErrorType {\n  /** The shipping address provided is invalid. */\n  InvalidShippingAddress = 'InvalidShippingAddress',\n\n  /** The shipping address provided is unserviceable (e.g., the address cannot be delivered to). */\n  UnserviceableShippingAddress = 'UnserviceableShippingAddress',\n}\n\n/**\n * \n * Enum representing the fields of shipping address that may be invalid\n * during Apple Pay transactions. These values can be used to identify \n * which part of the shipping address is incorrect or missing.\n * \n * @category Apple Pay\n */\nexport enum PEApplePayInvalidShippingField {\n  /** The street address is invalid or missing. */\n  Street = 'street',\n\n  /** The city is invalid or missing. */\n  City = 'city',\n\n  /** The sub-administrative area (e.g., district) is invalid or missing. */\n  SubAdministrativeArea = 'subAdministrativeArea',\n\n  /** The state or province is invalid or missing. */\n  State = 'state',\n\n  /** The postal code is invalid or missing. */\n  PostalCode = 'postalCode',\n\n  /** The country is invalid or missing. */\n  Country = 'country',\n\n  /** The country code is invalid or missing. */\n  CountryCode = 'countryCode',\n\n  /** The sub-locality (e.g., neighborhood) is invalid or missing. */\n  SubLocality = 'subLocality',\n}\n\n"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAwFA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;AACA;AACA;AACA;IACYA,2B;AAqBZ;AACA;AACA;AACA;AACA;AACA;AACA;;;;WA3BYA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;EAAAA,2B,CAAAA,2B;GAAAA,2B,2CAAAA,2B;;AAiEZ;AACA;AACA;AACA;AACA;AACA;AACA;IACYC,wB;AAQZ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;;WAfYA,wB;EAAAA,wB;EAAAA,wB;GAAAA,wB,wCAAAA,wB;;IAgBAC,8B;;;WAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;EAAAA,8B;GAAAA,8B,8CAAAA,8B"}

package/lib/commonjs/components/v2/GooglePay/PEGooglePayAddress.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["PEGooglePayAddress.ts"],"sourcesContent":["export interface PEGooglePayAddress {\n  address1?: string;\n  address2?: string;\n  address3?: string;\n  administrativeArea?: string;\n  countryCode?: string;\n  locality?: string;\n  name?: string;\n  phoneNumber?: string;\n  postalCode?: string;\n}"],"mappings":""}
+{"version":3,"names":[],"sources":["PEGooglePayAddress.ts"],"sourcesContent":["/**\n * Represents a Google Pay address containing structured user information.\n *\n * This model holds address details returned from Google Pay, including\n * name, street address lines, locality, country code, phone number, and postal code.\n *\n * ## Example Usage:\n * ```ts\n * const address: PEGooglePayAddress = {\n *   address1: \"1600 Amphitheatre Parkway\",\n *   administrativeArea: \"CA\",\n *   countryCode: \"US\",\n *   locality: \"Mountain View\",\n *   name: \"John Doe\",\n *   phoneNumber: \"+1 123-456-7890\",\n *   postalCode: \"94043\",\n * };\n * ```\n *\n * @category Google Pay\n */\nexport interface PEGooglePayAddress {\n  /** The first line of the street address (e.g., \"123 Main St\"). */\n  address1?: string;\n\n  /** The second line of the street address (e.g., apartment, suite, or unit number). */\n  address2?: string;\n\n  /** The third line of the street address (if applicable). */\n  address3?: string;\n\n  /** The state, province, or region of the address. */\n  administrativeArea?: string;\n\n  /** The two-letter country code in ISO 3166-1 alpha-2 format (e.g., \"US\", \"CA\"). */\n  countryCode?: string;\n\n  /** The city or town of the address. */\n  locality?: string;\n\n  /** The full name of the recipient. */\n  name?: string;\n\n  /** The phone number associated with the address. */\n  phoneNumber?: string;\n\n  /** The ZIP or postal code. */\n  postalCode?: string;\n}\n"],"mappings":""}

package/lib/commonjs/components/v2/GooglePay/PEGooglePayButton.js

@@ -18,6 +18,59 @@ const {
 } = _reactNative.NativeModules;
 const RNPEGooglePayButton = (0, _reactNative.requireNativeComponent)('RNPEGooglePayButton');
 const peEventEmitter = new _reactNative.NativeEventEmitter(RNPEEventEmitter);
+/**
+ * Props for rendering the Google Pay payment button.
+ *
+ * This interface defines the configuration and callback handlers
+ * used when initiating a Google Pay transaction.
+ *
+ * @category Google Pay
+ */
+
+/**
+ * A React Native component for rendering a Google Pay button.
+ *
+ * This button allows users to initiate a Google Pay transaction using the
+ * provided `paymentRequest`. The component communicates with native code
+ * and emits events through a shared event emitter (`peEventEmitter`) to
+ * notify the JavaScript layer about the payment result.
+ *
+ * ## Example Usage:
+ * ```tsx
+ * const paymentRequest = {
+ *   merchantId: 'your-merchant-id',
+ *   paymentAmount: 10.00,
+ *   paymentItems: [
+ *     { label: 'Test Item', amount: 10.00 }
+ *   ],
+ *   platformOptions: {
+ *     billingAddressRequired: true,
+ *     shippingAddressRequired: true,
+ *   },
+ * };
+ * 
+ * <PEGooglePayButton
+ *   paymentRequest={paymentRequest}
+ *   onPaymentFailed={(error) => {
+ *     console.log("Payment failed", error);
+ *   }}
+ *   onPaymentSheetDismissed={() => {
+ *     console.log("Payment sheet dismissed");
+ *   }}
+ *   onTokenDidReturn={(token, metadata, billingAddress, shippingAddress) => {
+ *     console.log("Payment successful", token, metadata, billingAddress, shippingAddress);
+ *   }}
+ * />
+ * ```
+ *
+ * ## Platform Support:
+ * - **Android only**: On iOS, this component renders a fallback message.
+ *
+ * @param props - See {@link PEGooglePayButtonProps}
+ * @returns A Google Pay button on Android or a fallback message on iOS.
+ *
+ * @category Google Pay
+ */
 const PEGooglePayButton = /*#__PURE__*/React.forwardRef((props, ref) => {
   React.useImperativeHandle(ref, () => ({}));
   React.useEffect(() => {