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

package/lib/commonjs/components/v2/SecureFields/BankAccountView.js.map

@@ -1 +1 @@
-{"version":3,"names":["RNPEEventEmitter","NativeModules","COMPONENT_NAME","RNPEBankAccountView","requireNativeComponent","RNPEBankAccountViewManager","UIManager","peEventEmitter","NativeEventEmitter","PEBankAccountView","React","forwardRef","props","ref","formRef","useRef","height","setHeight","useState","useImperativeHandle","submit","data","Promise","resolve","reject","Error","listener","addListener","args","remove","error","bankAccount","json","JSON","parse","callNativeMethod","merchantId","additionalData","showKeyboard","hideKeyboard","useCallback","methodName","params","viewId","findNodeHandle","current","commandId","Commands","toString","Platform","OS","Number","dispatchViewManagerCommand","useEffect","eventListener","width","_","frameHeight","stringify","additionalFields"],"sources":["BankAccountView.tsx"],"sourcesContent":["\nimport * as React from 'react';\nimport { requireNativeComponent, NativeModules, NativeEventEmitter, ViewProps, findNodeHandle, UIManager, ActivityIndicator, Platform } from 'react-native';\nimport type IPEField from './IPEField';\nimport type PEBankAccount from './PEBankAccount';\nimport type ITokenizationData from './ITokenizationData';\n\nconst { RNPEEventEmitter } = NativeModules;\n\ninterface NativePEBankAccountViewProps extends ViewProps {\n  additionalFields: string;\n}\n\nconst COMPONENT_NAME = 'RNPEBankAccountView'\nconst RNPEBankAccountView = requireNativeComponent<NativePEBankAccountViewProps>(COMPONENT_NAME);\n// @ts-ignore\nconst RNPEBankAccountViewManager = UIManager[COMPONENT_NAME]\n\nconst peEventEmitter = new NativeEventEmitter(RNPEEventEmitter);\n\nexport interface PEBankAccountViewProps {\n  additionalFields?: IPEField[];\n}\n\nexport interface PEBankAccountViewMethods {\n  submit: (data: ITokenizationData) => Promise<PEBankAccount>;\n  showKeyboard: () => void;\n  hideKeyboard: () => void;\n}\n\nexport const PEBankAccountView = React.forwardRef<\n  PEBankAccountViewMethods,\n  PEBankAccountViewProps\n>((props, ref) => {\n  const formRef = React.useRef<any>();\n  const [height, setHeight] = React.useState(0);\n\n  React.useImperativeHandle(ref, () => ({\n    submit: async (data: ITokenizationData = {}) => {\n      return new Promise((resolve, reject) => {\n        if (height === 0) {\n          return reject(new Error('Form is not ready'))\n        }\n        \n        const listener = peEventEmitter.addListener('onBankAccountRespond', args => {\n          listener.remove()\n\n          const { error, bankAccount: json } = args;\n          if (error) {\n            reject(new Error(error))\n          } else {\n            const bankAccount = JSON.parse(json) as PEBankAccount;\n            resolve(bankAccount)\n          }\n        });\n\n        callNativeMethod(\"submit\", [data.merchantId, data.additionalData],)\n      });\n    },\n    showKeyboard: () => {\n      callNativeMethod(\"showKeyboard\")\n    },\n    hideKeyboard: () => {\n      callNativeMethod(\"hideKeyboard\")\n    }\n  }));\n\n  const callNativeMethod = React.useCallback((methodName: string, params: any[] = []) => {\n    const viewId = findNodeHandle(formRef.current);\n    let commandId = RNPEBankAccountViewManager.Commands[methodName].toString()\n    if (Platform.OS === 'ios') {\n      commandId = Number(commandId)\n    }\n    UIManager.dispatchViewManagerCommand(\n      viewId,\n      commandId,\n      params,\n    );\n  }, [formRef.current])\n\n\n  React.useEffect(() => {\n    const eventListener = peEventEmitter.addListener('onSizeChanges', args => {\n      const { width: _, height: frameHeight } = args;\n      setHeight(frameHeight);\n    });\n    return () => eventListener.remove();\n  }, []);\n\n  return (\n    <>\n      {height === 0 && <ActivityIndicator />}\n      <RNPEBankAccountView ref={formRef} additionalFields={JSON.stringify(props.additionalFields ?? [])} style={{ height: height }}  />\n    </>\n  );\n});\n"],"mappings":"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"}
+{"version":3,"names":["RNPEEventEmitter","NativeModules","COMPONENT_NAME","RNPEBankAccountView","requireNativeComponent","RNPEBankAccountViewManager","UIManager","peEventEmitter","NativeEventEmitter","PEBankAccountView","React","forwardRef","props","ref","formRef","useRef","height","setHeight","useState","useImperativeHandle","submit","data","Promise","resolve","reject","Error","listener","addListener","args","remove","error","bankAccount","json","JSON","parse","callNativeMethod","merchantId","additionalData","showKeyboard","hideKeyboard","useCallback","methodName","params","viewId","findNodeHandle","current","commandId","Commands","toString","Platform","OS","Number","dispatchViewManagerCommand","useEffect","eventListener","width","_","frameHeight","stringify","additionalFields"],"sources":["BankAccountView.tsx"],"sourcesContent":["\nimport * as React from 'react';\nimport { requireNativeComponent, NativeModules, NativeEventEmitter, type ViewProps, findNodeHandle, UIManager, ActivityIndicator, Platform } from 'react-native';\nimport type IPEField from './IPEField';\nimport type PEBankAccount from './PEBankAccount';\nimport type ITokenizationData from './ITokenizationData';\n\nconst { RNPEEventEmitter } = NativeModules;\n\ninterface NativePEBankAccountViewProps extends ViewProps {\n  additionalFields: string;\n}\n\nconst COMPONENT_NAME = 'RNPEBankAccountView'\nconst RNPEBankAccountView = requireNativeComponent<NativePEBankAccountViewProps>(COMPONENT_NAME);\n// @ts-ignore\nconst RNPEBankAccountViewManager = UIManager[COMPONENT_NAME]\n\nconst peEventEmitter = new NativeEventEmitter(RNPEEventEmitter);\n\n/**\n * Props for the `PEBankAccountView` component.\n *\n * Allows optional configuration of additional input fields that can be rendered\n * alongside the standard bank account fields.\n *\n * These fields can be used to collect extra information such as account holder type,\n * billing address, or custom metadata required by the merchant.\n *\n * @category SecureFields\n *\n * @example\n * ```ts\n * const fields: IPEField[] = [\n *   {\n *     name: \"accountHolderType\",\n *     type: \"text\",\n *     placeholder: \"Account Holder Type\",\n *     keyboardType: PEKeyboardType.Alphabet,\n *     isRequired: false\n *   }\n * ];\n *\n * <PEBankAccountView additionalFields={fields} />\n * ```\n */\nexport interface PEBankAccountViewProps {\n  /**\n   * (Optional) A list of additional fields to be displayed in the bank account form.\n   *\n   * These are rendered below the standard account number and routing number fields.\n   */\n  additionalFields?: IPEField[];\n}\n\n\n/**\n * Provides methods to control and interact with the PayEngine Bank Account input view.\n *\n * This interface defines methods for submitting bank account details for tokenization\n * and managing keyboard visibility.\n *\n * @category SecureFields\n */\nexport interface PEBankAccountViewMethods {\n  /**\n   * Submits the entered bank account information to PayEngine for tokenization.\n   *\n   * @param data - Optional merchant info and additional metadata.\n   * @returns A promise that resolves to a tokenized bank account object (`PEBankAccount`).\n   *\n   * @example\n   * ```ts\n   * const result = await bankAccountRef.current?.submit({\n   *   merchantId: \"merchant_456\",\n   *   additionalData: { accountType: \"checking\" }\n   * });\n   * ```\n   */\n  submit: (data: ITokenizationData) => Promise<PEBankAccount>;\n\n  /**\n   * Programmatically displays the keyboard for the bank account input fields.\n   */\n  showKeyboard: () => void;\n\n  /**\n   * Programmatically hides the keyboard for the bank account input fields.\n   */\n  hideKeyboard: () => void;\n}\n\n\n/**\n * A secure form widget for entering a customer's bank account information.\n *\n * [PEBankAccountView] provides a UI component for securely collecting bank account details.\n * It does not store data locally and instead tokenizes the information using PayEngine.\n *\n * ## Features:\n * - Securely collects bank account details.\n * - Supports additional customizable fields.\n * - Provides methods to show/hide the keyboard.\n * - Allows tokenizing the entered data for safe storage.\n *\n * ## Usage Example:\n *\n * ```tsx\n * const formRef = React.createRef<PEBankAccountViewMethods>();\n *\n * return (\n *   <View style={styles.container}>\n *     <Text>Welcome to PayEngine React Native SDK example</Text>\n *     <View style={{ width: '100%' }}>\n *       <PEBankAccountView ref={formRef} />\n *       <Button disabled={submitting} onPress={() => createBankAccount()} title=\"Create Bank Account\" />\n *     </View>\n *     <ScrollView style={{ flex: 1, width: '100%', backgroundColor: 'lightyellow', padding: 10, marginVertical: 20 }}>\n *       <Text>{JSON.stringify(secureFieldsResult, null, 4)}</Text>\n *     </ScrollView>\n *   </View>\n * );\n * ```\n *\n * ## How It Works:\n * 1. Create an instance of [PEBankAccountView], optionally passing additional fields.\n * 2. Display the form inside your widget tree.\n * 3. Use [showKeyboard] and [hideKeyboard] to manage input focus.\n * 4. Call [submit] to securely send the bank account data and receive a token.\n *\n * ## Methods:\n * - **`showKeyboard()`**: Manually shows the on-screen keyboard.\n * - **`hideKeyboard()`**: Hides the on-screen keyboard.\n * - **`submit()`**: Submits the entered data and retrieves a tokenized version of the bank account data.\n *\n * @category SecureFields\n */\nexport const PEBankAccountView = React.forwardRef<\n  PEBankAccountViewMethods,\n  PEBankAccountViewProps\n>((props, ref) => {\n  const formRef = React.useRef<any>();\n  const [height, setHeight] = React.useState(0);\n\n  React.useImperativeHandle(ref, () => ({\n    submit: async (data: ITokenizationData = {}) => {\n      return new Promise((resolve, reject) => {\n        if (height === 0) {\n          return reject(new Error('Form is not ready'))\n        }\n        \n        const listener = peEventEmitter.addListener('onBankAccountRespond', args => {\n          listener.remove()\n\n          const { error, bankAccount: json } = args;\n          if (error) {\n            reject(new Error(error))\n          } else {\n            const bankAccount = JSON.parse(json) as PEBankAccount;\n            resolve(bankAccount)\n          }\n        });\n\n        callNativeMethod(\"submit\", [data.merchantId, data.additionalData],)\n      });\n    },\n    showKeyboard: () => {\n      callNativeMethod(\"showKeyboard\")\n    },\n    hideKeyboard: () => {\n      callNativeMethod(\"hideKeyboard\")\n    }\n  }));\n\n  const callNativeMethod = React.useCallback((methodName: string, params: any[] = []) => {\n    const viewId = findNodeHandle(formRef.current);\n    let commandId = RNPEBankAccountViewManager.Commands[methodName].toString()\n    if (Platform.OS === 'ios') {\n      commandId = Number(commandId)\n    }\n    UIManager.dispatchViewManagerCommand(\n      viewId,\n      commandId,\n      params,\n    );\n  }, [formRef.current])\n\n\n  React.useEffect(() => {\n    const eventListener = peEventEmitter.addListener('onSizeChanges', args => {\n      const { width: _, height: frameHeight } = args;\n      setHeight(frameHeight);\n    });\n    return () => eventListener.remove();\n  }, []);\n\n  return (\n    <>\n      {height === 0 && <ActivityIndicator />}\n      <RNPEBankAccountView ref={formRef} additionalFields={JSON.stringify(props.additionalFields ?? [])} style={{ height: height }}  />\n    </>\n  );\n});\n"],"mappings":"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"}

package/lib/commonjs/components/v2/SecureFields/CreditCardView.js

@@ -21,6 +21,88 @@ const RNPECreditCardView = (0, _reactNative.requireNativeComponent)(COMPONENT_NA
 
 const RNPECreditCardViewManager = _reactNative.UIManager[COMPONENT_NAME];
 const peEventEmitter = new _reactNative.NativeEventEmitter(RNPEEventEmitter);
+/**
+ * Props for the `PECreditCardView` component.
+ *
+ * Allows optional configuration of additional input fields that can be rendered
+ * alongside the standard credit card fields.
+ *
+ * These fields can be used to collect extra information such as ZIP code, billing address,
+ * or custom metadata required by the merchant.
+ *
+ * @category SecureFields
+ *
+ * @example
+ * ```ts
+ * const fields: IPEField[] = [
+ *   {
+ *     name: "zipCode",
+ *     type: "text",
+ *     placeholder: "ZIP Code",
+ *     keyboardType: PEKeyboardType.Numeric,
+ *     isRequired: true
+ *   }
+ * ];
+ *
+ * <PECreditCardView additionalFields={fields} />
+ * ```
+ */
+
+/**
+ * A secure form for entering a customer's credit card information safely.
+ *
+ * [PECreditCardView] provides an interface for users to input their credit card details securely.
+ * It integrates with PayEngine to tokenize the card details and forward them to a PCI-compliant
+ * third party without storing sensitive information locally.
+ *
+ * ## How It Works
+ *
+ * 1. Create an instance of [PECreditCardView], optionally passing additional fields.
+ * 2. Display the form inside your UI.
+ * 3. Once the user enters their details, call [submit] to securely process and retrieve a tokenized version of the card.
+ * 4. Use [showKeyboard] and [hideKeyboard] to manually control the keyboard.
+ *
+ * ## Example Usage
+ *
+ * ```tsx
+ * const formRef = React.createRef<PECreditCardViewMethods>();
+ * 
+ * 
+ * const additionalFields = [
+ *    {
+ *      name: 'address_zip',
+ *      type: 'text',
+ *      placeholder: 'Zip code',
+ *      keyboardType: PEKeyboardType.alphabet,
+ *      isRequired: true,
+ *      pattern: '^(?:\\d{5}(?:-\\d{4})?|[ABCEGHJKLMNPRSTVXY]\\d[A-Z] ?\\d[A-Z]\\d)$'
+ *    }
+ * ]
+ *
+ * return (
+ *   <View style={styles.container}>
+ *     <Text>Welcome to PayEngine React Native SDK example</Text>
+ *     <View style={{ width: '100%' }}>
+ *       <PECreditCardView ref={formRef} additionalFields={additionalFields} />
+ *       <Button disabled={submitting} onPress={() => createCard()} title="Create Card" />
+ *       <Button onPress={() => formRef.current?.showKeyboard()} title="Show keyboard" />
+ *       <Button onPress={() => formRef.current?.hideKeyboard()} title="Hide keyboard" />
+ *     </View>
+ *     <ScrollView style={{ flex: 1, width: '100%', backgroundColor: 'lightyellow', padding: 10, marginVertical: 20 }}>
+ *       <Text>{JSON.stringify(secureFieldsResult, null, 4)}</Text>
+ *     </ScrollView>
+ *   </View>
+ * );
+ * ```
+ *
+ * ## Features:
+ * - Securely collects credit card details.
+ * - Supports additional customizable fields.
+ * - Provides methods to show/hide the keyboard.
+ * - Allows submitting the entered data for tokenization and safe storage.
+ * 
+ * @category SecureFields
+ */
 const PECreditCardView = /*#__PURE__*/React.forwardRef((props, ref) => {
   const formRef = React.useRef();
   const [height, setHeight] = React.useState(0);

package/lib/commonjs/components/v2/SecureFields/CreditCardView.js.map

@@ -1 +1 @@
-{"version":3,"names":["RNPEEventEmitter","NativeModules","COMPONENT_NAME","RNPECreditCardView","requireNativeComponent","RNPECreditCardViewManager","UIManager","peEventEmitter","NativeEventEmitter","PECreditCardView","React","forwardRef","props","ref","formRef","useRef","height","setHeight","useState","useImperativeHandle","submit","data","Promise","resolve","reject","Error","listener","addListener","args","remove","error","card","json","JSON","parse","callNativeMethod","merchantId","additionalData","showKeyboard","hideKeyboard","useCallback","methodName","params","console","log","viewId","findNodeHandle","current","commandId","Commands","toString","Platform","OS","Number","dispatchViewManagerCommand","useEffect","eventListener","width","_","frameHeight","stringify","additionalFields"],"sources":["CreditCardView.tsx"],"sourcesContent":["\nimport * as React from 'react';\nimport { requireNativeComponent, NativeModules, NativeEventEmitter, ViewProps, Platform, findNodeHandle, UIManager, ActivityIndicator } from 'react-native';\nimport type IPEField from './IPEField';\nimport type PECard from './PECard';\nimport type ITokenizationData from './ITokenizationData';\n\nconst { RNPEEventEmitter } = NativeModules;\n\ninterface NativePECreditCardViewProps extends ViewProps {\n  additionalFields: string;\n}\n\nconst COMPONENT_NAME = 'RNPECreditCardView'\nconst RNPECreditCardView = requireNativeComponent<NativePECreditCardViewProps>(COMPONENT_NAME);\n// @ts-ignore\nconst RNPECreditCardViewManager = UIManager[COMPONENT_NAME]\nconst peEventEmitter = new NativeEventEmitter(RNPEEventEmitter);\n\nexport interface PECreditCardViewProps {\n  additionalFields?: IPEField[];\n}\n\nexport interface PECreditCardViewMethods {\n  submit: (data: ITokenizationData) => Promise<PECard>;\n  showKeyboard: () => void;\n  hideKeyboard: () => void;\n}\n\nexport const PECreditCardView = React.forwardRef<\n  PECreditCardViewMethods,\n  PECreditCardViewProps\n>((props, ref) => {\n  const formRef = React.useRef<any>();\n  const [height, setHeight] = React.useState(0);\n\n  React.useImperativeHandle(ref, () => ({\n    submit: async (data: ITokenizationData = {}) => {\n      return new Promise((resolve, reject) => {\n        if (height === 0) {\n          return reject(new Error('Form is not ready'))\n        }\n\n        const listener = peEventEmitter.addListener('onCardRespond', args => {\n          listener.remove()\n\n          const { error, card: json } = args;\n          if (error) {\n            reject(new Error(error))\n          } else {\n            const card = JSON.parse(json) as PECard;\n            resolve(card)\n          }\n        });\n\n        callNativeMethod(\"submit\", [data.merchantId, data.additionalData])\n      });\n    },\n    showKeyboard: () => {\n      callNativeMethod(\"showKeyboard\")\n    },\n    hideKeyboard: () => {\n      callNativeMethod(\"hideKeyboard\")\n    }\n  }));\n\n  const callNativeMethod = React.useCallback((methodName: string, params: any[] = []) => {\n    console.log(\"callNativeMethod\", methodName, params)\n    const viewId = findNodeHandle(formRef.current);\n    let commandId = RNPECreditCardViewManager.Commands[methodName].toString()\n    if (Platform.OS === 'ios') {\n      commandId = Number(commandId)\n    }\n    UIManager.dispatchViewManagerCommand(\n      viewId,\n      commandId,\n      params,\n    );\n  }, [formRef.current])\n\n  React.useEffect(() => {\n    const eventListener = peEventEmitter.addListener('onSizeChanges', args => {\n      const { width: _, height: frameHeight } = args;\n      setHeight(frameHeight);\n    });\n\n    return () => eventListener.remove();\n  }, []);\n\n\n  return (\n    <>\n      {height === 0 && <ActivityIndicator />}\n      <RNPECreditCardView ref={formRef} additionalFields={JSON.stringify(props.additionalFields ?? [])} style={{ height: height }} />\n    </>\n  );\n});\n"],"mappings":"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"}
+{"version":3,"names":["RNPEEventEmitter","NativeModules","COMPONENT_NAME","RNPECreditCardView","requireNativeComponent","RNPECreditCardViewManager","UIManager","peEventEmitter","NativeEventEmitter","PECreditCardView","React","forwardRef","props","ref","formRef","useRef","height","setHeight","useState","useImperativeHandle","submit","data","Promise","resolve","reject","Error","listener","addListener","args","remove","error","card","json","JSON","parse","callNativeMethod","merchantId","additionalData","showKeyboard","hideKeyboard","useCallback","methodName","params","console","log","viewId","findNodeHandle","current","commandId","Commands","toString","Platform","OS","Number","dispatchViewManagerCommand","useEffect","eventListener","width","_","frameHeight","stringify","additionalFields"],"sources":["CreditCardView.tsx"],"sourcesContent":["\nimport * as React from 'react';\nimport { requireNativeComponent, NativeModules, NativeEventEmitter, type ViewProps, Platform, findNodeHandle, UIManager, ActivityIndicator } from 'react-native';\nimport type IPEField from './IPEField';\nimport type PECard from './PECard';\nimport type ITokenizationData from './ITokenizationData';\n\nconst { RNPEEventEmitter } = NativeModules;\n\ninterface NativePECreditCardViewProps extends ViewProps {\n  additionalFields: string;\n}\n\nconst COMPONENT_NAME = 'RNPECreditCardView'\nconst RNPECreditCardView = requireNativeComponent<NativePECreditCardViewProps>(COMPONENT_NAME);\n// @ts-ignore\nconst RNPECreditCardViewManager = UIManager[COMPONENT_NAME]\nconst peEventEmitter = new NativeEventEmitter(RNPEEventEmitter);\n\n/**\n * Props for the `PECreditCardView` component.\n *\n * Allows optional configuration of additional input fields that can be rendered\n * alongside the standard credit card fields.\n *\n * These fields can be used to collect extra information such as ZIP code, billing address,\n * or custom metadata required by the merchant.\n *\n * @category SecureFields\n *\n * @example\n * ```ts\n * const fields: IPEField[] = [\n *   {\n *     name: \"zipCode\",\n *     type: \"text\",\n *     placeholder: \"ZIP Code\",\n *     keyboardType: PEKeyboardType.Numeric,\n *     isRequired: true\n *   }\n * ];\n *\n * <PECreditCardView additionalFields={fields} />\n * ```\n */\nexport interface PECreditCardViewProps {\n  /**\n   * (Optional) A list of additional fields to be displayed in the credit card form.\n   *\n   * These are rendered below the standard card number, expiry, and CVV fields.\n   */\n  additionalFields?: IPEField[];\n}\n\n\n/**\n * Provides methods to control and interact with the PayEngine Credit Card input view.\n *\n * This interface defines methods for submitting credit card details for tokenization\n * and managing keyboard visibility.\n *\n * @category SecureFields\n */\nexport interface PECreditCardViewMethods {\n  /**\n   * Submits the entered credit card information to PayEngine for tokenization.\n   *\n   * @param data - Optional merchant info and additional metadata.\n   * @returns A promise that resolves to a tokenized credit card object (`PECard`).\n   *\n   * @example\n   * ```ts\n   * const result = await creditCardRef.current?.submit({\n   *   merchantId: \"merchant_123\",\n   *   additionalData: { source: \"checkout\" }\n   * });\n   * ```\n   */\n  submit: (data: ITokenizationData) => Promise<PECard>;\n\n  /**\n   * Programmatically displays the keyboard for the credit card input fields.\n   */\n  showKeyboard: () => void;\n\n  /**\n   * Programmatically hides the keyboard for the credit card input fields.\n   */\n  hideKeyboard: () => void;\n}\n\n/**\n * A secure form for entering a customer's credit card information safely.\n *\n * [PECreditCardView] provides an interface for users to input their credit card details securely.\n * It integrates with PayEngine to tokenize the card details and forward them to a PCI-compliant\n * third party without storing sensitive information locally.\n *\n * ## How It Works\n *\n * 1. Create an instance of [PECreditCardView], optionally passing additional fields.\n * 2. Display the form inside your UI.\n * 3. Once the user enters their details, call [submit] to securely process and retrieve a tokenized version of the card.\n * 4. Use [showKeyboard] and [hideKeyboard] to manually control the keyboard.\n *\n * ## Example Usage\n *\n * ```tsx\n * const formRef = React.createRef<PECreditCardViewMethods>();\n * \n * \n * const additionalFields = [\n *    {\n *      name: 'address_zip',\n *      type: 'text',\n *      placeholder: 'Zip code',\n *      keyboardType: PEKeyboardType.alphabet,\n *      isRequired: true,\n *      pattern: '^(?:\\\\d{5}(?:-\\\\d{4})?|[ABCEGHJKLMNPRSTVXY]\\\\d[A-Z] ?\\\\d[A-Z]\\\\d)$'\n *    }\n * ]\n *\n * return (\n *   <View style={styles.container}>\n *     <Text>Welcome to PayEngine React Native SDK example</Text>\n *     <View style={{ width: '100%' }}>\n *       <PECreditCardView ref={formRef} additionalFields={additionalFields} />\n *       <Button disabled={submitting} onPress={() => createCard()} title=\"Create Card\" />\n *       <Button onPress={() => formRef.current?.showKeyboard()} title=\"Show keyboard\" />\n *       <Button onPress={() => formRef.current?.hideKeyboard()} title=\"Hide keyboard\" />\n *     </View>\n *     <ScrollView style={{ flex: 1, width: '100%', backgroundColor: 'lightyellow', padding: 10, marginVertical: 20 }}>\n *       <Text>{JSON.stringify(secureFieldsResult, null, 4)}</Text>\n *     </ScrollView>\n *   </View>\n * );\n * ```\n *\n * ## Features:\n * - Securely collects credit card details.\n * - Supports additional customizable fields.\n * - Provides methods to show/hide the keyboard.\n * - Allows submitting the entered data for tokenization and safe storage.\n * \n * @category SecureFields\n */\nexport const PECreditCardView = React.forwardRef<\n  PECreditCardViewMethods,\n  PECreditCardViewProps\n>((props, ref) => {\n  const formRef = React.useRef<any>();\n  const [height, setHeight] = React.useState(0);\n\n  React.useImperativeHandle(ref, () => ({\n    submit: async (data: ITokenizationData = {}) => {\n      return new Promise((resolve, reject) => {\n        if (height === 0) {\n          return reject(new Error('Form is not ready'))\n        }\n\n        const listener = peEventEmitter.addListener('onCardRespond', args => {\n          listener.remove()\n\n          const { error, card: json } = args;\n          if (error) {\n            reject(new Error(error))\n          } else {\n            const card = JSON.parse(json) as PECard;\n            resolve(card)\n          }\n        });\n\n        callNativeMethod(\"submit\", [data.merchantId, data.additionalData])\n      });\n    },\n    showKeyboard: () => {\n      callNativeMethod(\"showKeyboard\")\n    },\n    hideKeyboard: () => {\n      callNativeMethod(\"hideKeyboard\")\n    }\n  }));\n\n  const callNativeMethod = React.useCallback((methodName: string, params: any[] = []) => {\n    console.log(\"callNativeMethod\", methodName, params)\n    const viewId = findNodeHandle(formRef.current);\n    let commandId = RNPECreditCardViewManager.Commands[methodName].toString()\n    if (Platform.OS === 'ios') {\n      commandId = Number(commandId)\n    }\n    UIManager.dispatchViewManagerCommand(\n      viewId,\n      commandId,\n      params,\n    );\n  }, [formRef.current])\n\n  React.useEffect(() => {\n    const eventListener = peEventEmitter.addListener('onSizeChanges', args => {\n      const { width: _, height: frameHeight } = args;\n      setHeight(frameHeight);\n    });\n\n    return () => eventListener.remove();\n  }, []);\n\n\n  return (\n    <>\n      {height === 0 && <ActivityIndicator />}\n      <RNPECreditCardView ref={formRef} additionalFields={JSON.stringify(props.additionalFields ?? [])} style={{ height: height }} />\n    </>\n  );\n});\n"],"mappings":"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"}

package/lib/commonjs/components/v2/SecureFields/IPEField.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["IPEField.ts"],"sourcesContent":["import type PEKeyboardType from \"./PEKeyboardType\";\n\ninterface IPEField {\n  name: string;\n  type: string;\n  placeholder: string;\n  keyboardType: PEKeyboardType;\n  isRequired: boolean;\n  pattern?: string;\n}\n\nexport default IPEField;\n"],"mappings":""}
+{"version":3,"names":[],"sources":["IPEField.ts"],"sourcesContent":["import type PEKeyboardType from \"./PEKeyboardType\";\n\n/**\n * Represents an input field in the PayEngine system.\n *\n * The `IPEField` interface defines a form field with properties such as\n * its name, type, placeholder, keyboard type, whether it is required, and\n * an optional validation pattern.\n *\n * @category SecureFields\n *\n * @example\n * ```ts\n * const emailField: IPEField = {\n *   name: \"email\",\n *   type: \"text\",\n *   placeholder: \"Enter your email\",\n *   keyboardType: PEKeyboardType.Alphabet,\n *   isRequired: true,\n *   pattern: \"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,}$\"\n * };\n * ```\n */\ninterface IPEField {\n  /**\n   * The unique identifier for the field.\n   *\n   * Typically used as the key when submitting form data.\n   */\n  name: string;\n\n  /**\n   * The type of the field (e.g., \"text\", \"password\", \"email\").\n   *\n   * Defines how the field’s value should be interpreted.\n   */\n  type: string;\n\n  /**\n   * The placeholder text shown when the field is empty.\n   */\n  placeholder: string;\n\n  /**\n   * Specifies the type of keyboard to display for this field.\n   *\n   * Example: `PEKeyboardType.Numeric`, `PEKeyboardType.Alphabet`\n   */\n  keyboardType: PEKeyboardType;\n\n  /**\n   * Indicates whether the field is required for form submission.\n   *\n   * If `true`, the field must be filled in with a valid value.\n   */\n  isRequired: boolean;\n\n  /**\n   * Optional regular expression used to validate the field's value.\n   *\n   * If omitted, no validation is enforced.\n   */\n  pattern?: string;\n}\n\n\nexport default IPEField;\n"],"mappings":""}

package/lib/commonjs/components/v2/SecureFields/ITokenizationData.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["ITokenizationData.ts"],"sourcesContent":["interface ITokenizationData {\n  merchantId?: string;\n  additionalData?: { \n    [key: string]: string \n  };\n}\n\nexport default ITokenizationData;\n"],"mappings":""}
+{"version":3,"names":[],"sources":["ITokenizationData.ts"],"sourcesContent":["/**\n * Represents the data used for tokenizing a credit card or bank account.\n *\n * This interface allows passing additional metadata or specifying the merchant\n * for whom the data is being tokenized.\n *\n * @category SecureFields\n */\ninterface ITokenizationData {\n  /**\n   * (Optional) The merchant ID on behalf of whom the tokenization is performed.\n   */\n  merchantId?: string;\n\n  /**\n   * (Optional) A key-value map of additional metadata to include in the request.\n   */\n  additionalData?: {\n    [key: string]: string;\n  };\n}\n\nexport default ITokenizationData;\n"],"mappings":""}

package/lib/commonjs/components/v2/SecureFields/PEBankAccount.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["PEBankAccount.ts"],"sourcesContent":["interface PEBankAccount {\n  id: string;\n  token: string;\n  account_data: {\n    first_name: string;\n    last_name: string;\n    routing_number: string;\n    last_4: string;\n  };\n}\n\nexport default PEBankAccount;"],"mappings":""}
+{"version":3,"names":[],"sources":["PEBankAccount.ts"],"sourcesContent":["/**\n * Represents a bank account stored within PayEngine.\n *\n * This interface contains a secure token and account details, ensuring sensitive banking\n * information is securely managed within the system.\n *\n * @category SecureFields\n */\ninterface PEBankAccount {\n  /**\n   * A unique identifier for the bank account.\n   *\n   * This may be used internally to reference the bank account object.\n   */\n  id: string;\n\n  /**\n   * A secure token representing the bank account.\n   *\n   * This token is used for referencing the account in API operations without exposing raw bank details.\n   */\n  token: string;\n\n  /**\n   * The associated bank account details.\n   *\n   * Includes essential information such as the account holder's name,\n   * the routing number, and the last four digits of the account number.\n   */\n  account_data: {\n    /**\n     * The first name of the account holder.\n     */\n    first_name: string;\n\n    /**\n     * The last name of the account holder.\n     */\n    last_name: string;\n\n    /**\n     * The bank's routing number.\n     */\n    routing_number: string;\n\n    /**\n     * The last four digits of the bank account number.\n     */\n    last_4: string;\n  };\n}\n\n\nexport default PEBankAccount;"],"mappings":""}

package/lib/commonjs/components/v2/SecureFields/PECard.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["PECard.ts"],"sourcesContent":["interface PECard {\n  token: string;\n  card_data: {\n    id: string;\n    brand: string;\n    last_4: string;\n    exp_year: string;\n    exp_month: string;\n    name: string;\n    address_zip?: string;\n  };\n}\n\nexport default PECard;"],"mappings":""}
+{"version":3,"names":[],"sources":["PECard.ts"],"sourcesContent":["/**\n * Represents a payment card stored with PayEngine.\n *\n * This interface contains a secure token and associated card details,\n * ensuring sensitive payment information is securely managed within the system.\n *\n * @category SecureFields\n */\ninterface PECard {\n  /**\n   * A secure token representing the card.\n   *\n   * This token is used to safely reference the card in API operations without exposing raw card data.\n   */\n  token: string;\n\n  /**\n   * The associated card details.\n   *\n   * Includes essential information such as brand, expiration date,\n   * the last four digits, cardholder name, and optional billing ZIP code.\n   */\n  card_data: {\n    /**\n     * A unique identifier for the card.\n     *\n     * This ID is typically used to reference the card object in system operations.\n     */\n    id: string;\n\n    /**\n     * The brand of the card (e.g., Visa, MasterCard).\n     */\n    brand: string;\n\n    /**\n     * The last four digits of the card number.\n     *\n     * Useful for displaying or confirming the card to the user.\n     */\n    last_4: string;\n\n    /**\n     * The expiration year of the card.\n     */\n    exp_year: string;\n\n    /**\n     * The expiration month of the card.\n     */\n    exp_month: string;\n\n    /**\n     * The name of the cardholder.\n     */\n    name: string;\n\n    /**\n     * The ZIP code associated with the card's billing address (optional).\n     */\n    address_zip?: string;\n  };\n}\n\n\nexport default PECard;"],"mappings":""}

package/lib/commonjs/components/v2/SecureFields/PEKeyboardType.js

@@ -3,15 +3,32 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
-var PEKeyboardType;
+exports.default = exports.PEKeyboardType = void 0;
+
+/**
+ * Defines the keyboard type for a PayEngine secure input field.
+ *
+ * @remarks
+ * This enum is used in {@link IPEField.keyboardType} to control the keyboard layout
+ * shown to the user based on the input field's context.
+ *
+ * The available keyboard types are:
+ * - {@link PEKeyboardType.alphabet} — Optimized for alphabetic characters.
+ * - {@link PEKeyboardType.number} — Optimized for numeric input.
+ * - {@link PEKeyboardType.phone} — Designed for entering phone numbers.
+ * - {@link PEKeyboardType.normal} — Standard keyboard with alphanumeric characters.
+ *
+ * @category SecureFields
+ */
+let PEKeyboardType;
+exports.PEKeyboardType = PEKeyboardType;
 
 (function (PEKeyboardType) {
   PEKeyboardType["alphabet"] = "alphabet";
   PEKeyboardType["number"] = "number";
   PEKeyboardType["phone"] = "phone";
   PEKeyboardType["normal"] = "normal";
-})(PEKeyboardType || (PEKeyboardType = {}));
+})(PEKeyboardType || (exports.PEKeyboardType = PEKeyboardType = {}));
 
 var _default = PEKeyboardType;
 exports.default = _default;

package/lib/commonjs/components/v2/SecureFields/PEKeyboardType.js.map

@@ -1 +1 @@
-{"version":3,"names":["PEKeyboardType"],"sources":["PEKeyboardType.ts"],"sourcesContent":["enum PEKeyboardType {\n  alphabet = 'alphabet',\n  number = 'number',\n  phone = 'phone',\n  normal = 'normal',\n}\n\nexport default PEKeyboardType;\n"],"mappings":";;;;;;IAAKA,c;;WAAAA,c;EAAAA,c;EAAAA,c;EAAAA,c;EAAAA,c;GAAAA,c,KAAAA,c;;eAOUA,c"}
+{"version":3,"names":["PEKeyboardType"],"sources":["PEKeyboardType.ts"],"sourcesContent":["import type IPEField from './IPEField';\n\n/**\n * Defines the keyboard type for a PayEngine secure input field.\n *\n * @remarks\n * This enum is used in {@link IPEField.keyboardType} to control the keyboard layout\n * shown to the user based on the input field's context.\n *\n * The available keyboard types are:\n * - {@link PEKeyboardType.alphabet} — Optimized for alphabetic characters.\n * - {@link PEKeyboardType.number} — Optimized for numeric input.\n * - {@link PEKeyboardType.phone} — Designed for entering phone numbers.\n * - {@link PEKeyboardType.normal} — Standard keyboard with alphanumeric characters.\n *\n * @category SecureFields\n */\nexport enum PEKeyboardType {\n  alphabet = 'alphabet',\n  number = 'number',\n  phone = 'phone',\n  normal = 'normal',\n}\n\nexport default PEKeyboardType;\n"],"mappings":";;;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACYA,c;;;WAAAA,c;EAAAA,c;EAAAA,c;EAAAA,c;EAAAA,c;GAAAA,c,8BAAAA,c;;eAOGA,c"}

package/lib/commonjs/index.js

@@ -8,44 +8,44 @@ var _exportNames = {
   PayEngine: true,
   PayProvider: true,
   PECreditCardView: true,
-  PECreditCardViewMethods: true,
   PEBankAccountView: true,
-  PEBankAccountViewMethods: true,
   PayEngineProvider: true,
   PayEngineNative: true,
+  FetchAccessTokenCallback: true,
+  AccessToken: true,
   PEApplePayButton: true,
   PEGooglePayButton: true,
   PayEngineUtils: true,
   PEKeyboardType: true
 };
-Object.defineProperty(exports, "PEApplePayButton", {
+Object.defineProperty(exports, "AccessToken", {
   enumerable: true,
   get: function () {
-    return _PEApplePayButton.PEApplePayButton;
+    return _PayEngineNative.AccessToken;
   }
 });
-Object.defineProperty(exports, "PEBankAccountView", {
+Object.defineProperty(exports, "FetchAccessTokenCallback", {
   enumerable: true,
   get: function () {
-    return _BankAccountView.PEBankAccountView;
+    return _PayEngineNative.FetchAccessTokenCallback;
   }
 });
-Object.defineProperty(exports, "PEBankAccountViewMethods", {
+Object.defineProperty(exports, "PEApplePayButton", {
   enumerable: true,
   get: function () {
-    return _BankAccountView.PEBankAccountViewMethods;
+    return _PEApplePayButton.PEApplePayButton;
   }
 });
-Object.defineProperty(exports, "PECreditCardView", {
+Object.defineProperty(exports, "PEBankAccountView", {
   enumerable: true,
   get: function () {
-    return _CreditCardView.PECreditCardView;
+    return _BankAccountView.PEBankAccountView;
   }
 });
-Object.defineProperty(exports, "PECreditCardViewMethods", {
+Object.defineProperty(exports, "PECreditCardView", {
   enumerable: true,
   get: function () {
-    return _CreditCardView.PECreditCardViewMethods;
+    return _CreditCardView.PECreditCardView;
   }
 });
 Object.defineProperty(exports, "PEGooglePayButton", {
@@ -98,7 +98,7 @@ var _BankAccountView = require("./components/v2/SecureFields/BankAccountView");
 
 var _PayEngineProvider = require("./components/v2/PayEngineProvider");
 
-var _PayEngineNative = _interopRequireDefault(require("./components/v2/PayEngineNative"));
+var _PayEngineNative = _interopRequireWildcard(require("./components/v2/PayEngineNative"));
 
 var _PEApplePayButton = require("./components/v2/ApplePay/PEApplePayButton");
 
@@ -144,6 +144,10 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+/**
+ * Main Module
+ * @module PayEngine SDK
+ */
 const LINKING_ERROR = `The package 'react-native-payengine' doesn't seem to be linked. Make sure: \n\n` + _reactNative.Platform.select({
   ios: "- You have run 'pod install'\n",
   default: ''

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["LINKING_ERROR","Platform","select","ios","default","PayEngineStatic","NativeModules","Payengine","Proxy","get","Error"],"sources":["index.tsx"],"sourcesContent":["import PayEngine from './components/PayEngine';\nimport { NativeModules, Platform } from 'react-native';\nimport type { IPayEngineConfig } from './interfaces/index';\nimport { PayProvider } from './interfaces/index';\nimport {\n  PECreditCardView,\n  PECreditCardViewMethods,\n} from './components/v2/SecureFields/CreditCardView';\nimport {\n  PEBankAccountView,\n  PEBankAccountViewMethods,\n} from './components/v2/SecureFields/BankAccountView';\nimport type IPEField from './components/v2/SecureFields/IPEField';\nimport type PECard from './components/v2/SecureFields/PECard';\nimport type PEBankAccount from './components/v2/SecureFields/PEBankAccount';\nimport { PayEngineProvider } from './components/v2/PayEngineProvider';\nimport PayEngineNative from './components/v2/PayEngineNative';\nimport { PEApplePayButton } from './components/v2/ApplePay/PEApplePayButton';\n\nimport { PEGooglePayButton } from './components/v2/GooglePay/PEGooglePayButton';\nimport * as PayEngineUtils from './utils/index';\nimport PEKeyboardType from './components/v2/SecureFields/PEKeyboardType';\nimport type { PEGooglePayAddress } from './components/v2/GooglePay/PEGooglePayAddress';\nimport type { PEApplePayContact } from './components/v2/ApplePay/PEApplePayInterfaces';\n\nexport * from './components/v2/PEPaymentRequest';\nexport * from './components/v2/ApplePay/PEApplePayInterfaces';\n\n\nconst LINKING_ERROR =\n  `The package 'react-native-payengine' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst PayEngineStatic = NativeModules.Payengine\n  ? NativeModules.Payengine\n  : new Proxy(\n      {},\n      {\n        get() {\n          throw new Error(LINKING_ERROR);\n        },\n      }\n    );\n\nexport {\n  PayEngineStatic,\n  PayEngine,\n  IPayEngineConfig,\n  PayProvider,\n  // v2 starting here\n  PayEngineUtils,\n  PayEngineProvider,\n  PayEngineNative,\n  // securefields\n  PEKeyboardType,\n  IPEField,\n  // credit card\n  PECreditCardView,\n  PECreditCardViewMethods,\n  PECard,\n  // bank account\n  PEBankAccountView,\n  PEBankAccountViewMethods,\n  PEBankAccount,\n  // Apple Pay\n  PEApplePayButton,\n  // RNPEApplePayOptions,\n  // RNPEContactField,\n  PEApplePayContact,\n  // RNPEGooglePayBillingAddressParameters,\n  // RNPEGooglePayShippingAddressParameters,\n  // PEPaymentRequest,\n  PEGooglePayButton,\n  PEGooglePayAddress\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;AACA;;AAEA;;AACA;;AAIA;;AAOA;;AACA;;AACA;;AAEA;;AACA;;;;AACA;;AAIA;;AAAA;EAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;AACA;;AAAA;EAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;;;;;;;AAGA,MAAMA,aAAa,GAChB,iFAAD,GACAC,qBAAA,CAASC,MAAT,CAAgB;EAAEC,GAAG,EAAE,gCAAP;EAAyCC,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,eAAe,GAAGC,0BAAA,CAAcC,SAAd,GACpBD,0BAAA,CAAcC,SADM,GAEpB,IAAIC,KAAJ,CACE,EADF,EAEE;EACEC,GAAG,GAAG;IACJ,MAAM,IAAIC,KAAJ,CAAUV,aAAV,CAAN;EACD;;AAHH,CAFF,CAFJ"}
+{"version":3,"names":["LINKING_ERROR","Platform","select","ios","default","PayEngineStatic","NativeModules","Payengine","Proxy","get","Error"],"sources":["index.tsx"],"sourcesContent":["/**\n * Main Module\n * @module PayEngine SDK\n */\n\nimport PayEngine from './components/PayEngine';\nimport { NativeModules, Platform } from 'react-native';\nimport type { IPayEngineConfig } from './interfaces/index';\nimport { PayProvider } from './interfaces/index';\nimport type ITokenizationData from './components/v2/SecureFields/ITokenizationData'\nimport {\n  PECreditCardView,\n  type PECreditCardViewProps,\n  type PECreditCardViewMethods,\n} from './components/v2/SecureFields/CreditCardView';\nimport {\n  PEBankAccountView,\n  type PEBankAccountViewProps,\n  type PEBankAccountViewMethods,\n} from './components/v2/SecureFields/BankAccountView';\nimport type IPEField from './components/v2/SecureFields/IPEField';\nimport type PECard from './components/v2/SecureFields/PECard';\nimport type PEBankAccount from './components/v2/SecureFields/PEBankAccount';\nimport { PayEngineProvider } from './components/v2/PayEngineProvider';\nimport PayEngineNative from './components/v2/PayEngineNative';\nimport { FetchAccessTokenCallback, AccessToken } from './components/v2/PayEngineNative';\nimport { PEApplePayButton, type PEApplePayButtonProps, type PEApplePayButtonMethods } from './components/v2/ApplePay/PEApplePayButton';\n\nimport { PEGooglePayButton, type PEGooglePayButtonProps, type PEGooglePayButtonMethods } from './components/v2/GooglePay/PEGooglePayButton';\nimport * as PayEngineUtils from './utils/index';\nimport PEKeyboardType from './components/v2/SecureFields/PEKeyboardType';\nimport type { PEGooglePayAddress } from './components/v2/GooglePay/PEGooglePayAddress';\nimport type { PEApplePayContact } from './components/v2/ApplePay/PEApplePayInterfaces';\n\nexport * from './components/v2/PEPaymentRequest';\nexport * from './components/v2/ApplePay/PEApplePayInterfaces';\n\n\nconst LINKING_ERROR =\n  `The package 'react-native-payengine' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst PayEngineStatic = NativeModules.Payengine\n  ? NativeModules.Payengine\n  : new Proxy(\n      {},\n      {\n        get() {\n          throw new Error(LINKING_ERROR);\n        },\n      }\n    );\n\nexport {\n  PayEngineStatic,\n  PayEngine,\n  IPayEngineConfig,\n  PayProvider,\n  // v2 starting here\n  PayEngineUtils,\n  PayEngineProvider,\n  PayEngineNative,\n  AccessToken,\n  FetchAccessTokenCallback,\n  // securefields\n  PEKeyboardType,\n  IPEField,\n  ITokenizationData,\n  // credit card\n  PECreditCardView,\n  PECreditCardViewProps,\n  PECreditCardViewMethods,\n  PECard,\n  // bank account\n  PEBankAccountView,\n  PEBankAccountViewProps,\n  PEBankAccountViewMethods,\n  PEBankAccount,\n  // Apple Pay\n  PEApplePayButton,\n  PEApplePayButtonProps,\n  PEApplePayButtonMethods,\n  // RNPEApplePayOptions,\n  // RNPEContactField,\n  PEApplePayContact,\n  // RNPEGooglePayBillingAddressParameters,\n  // RNPEGooglePayShippingAddressParameters,\n  // PEPaymentRequest,\n  PEGooglePayButton,\n  PEGooglePayAddress,\n  PEGooglePayButtonProps,\n  PEGooglePayButtonMethods\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA;;AACA;;AAEA;;AAEA;;AAKA;;AAQA;;AACA;;AAEA;;AAEA;;AACA;;;;AACA;;AAIA;;AAAA;EAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;AACA;;AAAA;EAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;;;;;;;AAnCA;AACA;AACA;AACA;AAmCA,MAAMA,aAAa,GAChB,iFAAD,GACAC,qBAAA,CAASC,MAAT,CAAgB;EAAEC,GAAG,EAAE,gCAAP;EAAyCC,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,eAAe,GAAGC,0BAAA,CAAcC,SAAd,GACpBD,0BAAA,CAAcC,SADM,GAEpB,IAAIC,KAAJ,CACE,EADF,EAEE;EACEC,GAAG,GAAG;IACJ,MAAM,IAAIC,KAAJ,CAAUV,aAAV,CAAN;EACD;;AAHH,CAFF,CAFJ"}

package/lib/commonjs/interfaces/index.js

@@ -4,6 +4,26 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.PayProvider = void 0;
+
+/**
+ * Represents the configuration settings for PayEngine.
+ *
+ * The [IPayEngineConfig] interface holds essential details such as the public key,
+ * script version, and logging level. It is used to configure the PayEngine integration
+ * for API interactions.
+ *
+ */
+
+/**
+ * Enum representing supported payment providers.
+ *
+ * @remarks
+ * This enum specifies the available payment providers supported by the PayEngine SDK.
+ * It is used to check which payment method (Apple Pay or Google Pay) is available for use.
+ *
+ * @enum {string}
+ * @category PayEngine
+ */
 let PayProvider;
 exports.PayProvider = PayProvider;
 

package/lib/commonjs/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["PayProvider"],"sources":["index.ts"],"sourcesContent":["export interface IPayEngineConfig {\n  publicKey: string;\n  version?: string;\n  scriptURL?: string;\n  logLevel?: number;\n}\n\nexport enum PayProvider {\n  googlePay,\n  applePay\n}"],"mappings":";;;;;;IAOYA,W;;;WAAAA,W;EAAAA,W,CAAAA,W;EAAAA,W,CAAAA,W;GAAAA,W,2BAAAA,W"}
+{"version":3,"names":["PayProvider"],"sources":["index.ts"],"sourcesContent":["/**\n * Represents the configuration settings for PayEngine.\n *\n * The [IPayEngineConfig] interface holds essential details such as the public key,\n * script version, and logging level. It is used to configure the PayEngine integration\n * for API interactions.\n *\n */\nexport interface IPayEngineConfig {\n  /**\n   * The public key associated with the PayEngine account.\n   * This key is required for authentication when making API requests.\n   */\n  publicKey: string;\n\n  /**\n   * The version of the PayEngine integration.\n   * If provided, this specifies the version of the script or API being used.\n   */\n  version?: string;\n\n  /**\n   * The script URL for loading the PayEngine JavaScript library.\n   * If provided, this URL is used instead of the default script URL.\n   */\n  scriptURL?: string;\n\n  /**\n   * The log level for debugging.\n   * Higher values enable more detailed logging.\n   */\n  logLevel?: number;\n}\n\n\n/**\n * Enum representing supported payment providers.\n *\n * @remarks\n * This enum specifies the available payment providers supported by the PayEngine SDK.\n * It is used to check which payment method (Apple Pay or Google Pay) is available for use.\n *\n * @enum {string}\n * @category PayEngine\n */\nexport enum PayProvider {\n  googlePay,  // Google Pay payment provider.\n  applePay    // Apple Pay payment provider.\n}"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA4BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACYA,W;;;WAAAA,W;EAAAA,W,CAAAA,W;EAAAA,W,CAAAA,W;GAAAA,W,2BAAAA,W"}

package/lib/commonjs/utils/index.js

@@ -10,12 +10,22 @@ var _axios = _interopRequireDefault(require("axios"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+/**
+ * Custom error thrown when an obsolete method is called.
+ *
+ * The `PEDeprecationError` indicates that the method being used is deprecated,
+ * and the user should check the package README for updated usage.
+ */
 class PEDeprecationError extends Error {
   constructor() {
     super('This method is obsolete and can not be used anymore. Please check out the package README');
   }
 
 }
+/**
+ * @private
+ */
+
 
 exports.PEDeprecationError = PEDeprecationError;
 
@@ -24,6 +34,10 @@ const getHttpHeaders = config => {
     Authorization: `Signature key="${config.publicKey}",algorithm="hmac-sha256",identifier="secure-fields",signature=""`
   };
 };
+/**
+ * @private
+ */
+
 
 exports.getHttpHeaders = getHttpHeaders;
 
@@ -36,6 +50,10 @@ const getBaseURL = config => {
 
   return baseUrl;
 };
+/**
+ * @private
+ */
+
 
 exports.getBaseURL = getBaseURL;
 
@@ -45,6 +63,10 @@ const createHttpClient = config => {
     headers: getHttpHeaders(config)
   });
 };
+/**
+ * @private
+ */
+
 
 exports.createHttpClient = createHttpClient;
 
@@ -66,6 +88,10 @@ function getScriptURL(config) {
 
   return scriptURL;
 }
+/**
+ * @private
+ */
+
 
 const debuggingScript = `
 const consoleLog = (type, ...log) => window.ReactNativeWebView.postMessage(JSON.stringify({'type': 'Console', 'data': {'type': type, 'log': log}}));

package/lib/commonjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["PEDeprecationError","Error","constructor","getHttpHeaders","config","Authorization","publicKey","getBaseURL","baseUrl","includes","scriptURL","replace","createHttpClient","axios","create","baseURL","headers","getScriptURL","logLevelStr","logLevel","version","debuggingScript"],"sources":["index.ts"],"sourcesContent":["import axios from 'axios';\nimport type { IPayEngineConfig } from '../interfaces/index';\n\nexport class PEDeprecationError extends Error {\n  constructor() {\n    super(\n      'This method is obsolete and can not be used anymore. Please check out the package README'\n    );\n  }\n}\n\nexport const getHttpHeaders = (config: IPayEngineConfig) => {\n  return {\n    Authorization: `Signature key=\"${config.publicKey}\",algorithm=\"hmac-sha256\",identifier=\"secure-fields\",signature=\"\"`,\n  };\n};\n\nexport const getBaseURL = (config: IPayEngineConfig) => {\n  let baseUrl = config.publicKey.includes('_prod_')\n    ? 'https://console.payengine.co'\n    : 'https://console.payengine.dev';\n\n  if (config.scriptURL) {\n    baseUrl = config.scriptURL.replace(/^((\\w+:)?\\/\\/[^\\/]+\\/?).*$/, '$1');\n  }\n  return baseUrl;\n};\n\nexport const createHttpClient = (config: IPayEngineConfig) => {\n  return axios.create({\n    baseURL: getBaseURL(config),\n    headers: getHttpHeaders(config),\n  });\n};\n\nexport function getScriptURL(config: IPayEngineConfig) {\n  if (!config.publicKey) {\n    throw new Error('PayEngine Public Key is missing');\n  }\n  let scriptURL = '';\n  const logLevelStr = config.logLevel ? `&loglevel=${config.logLevel}` : '';\n  if (config.scriptURL) {\n    scriptURL = `${config.scriptURL}?key=${config.publicKey}${logLevelStr}`;\n  } else {\n    const baseURL = config.publicKey.includes('_prod_')\n      ? 'https://console.payengine.co'\n      : 'https://console.payengine.dev';\n    const version = config.version ?? '1.0.0';\n    scriptURL = `${baseURL}/js/${version}/embed.js?key=${config.publicKey}${logLevelStr}`;\n  }\n\n  return scriptURL;\n}\n\nexport const debuggingScript = `\nconst consoleLog = (type, ...log) => window.ReactNativeWebView.postMessage(JSON.stringify({'type': 'Console', 'data': {'type': type, 'log': log}}));\nconsole = {\n    log: (...log) => consoleLog('log', ...log),\n    debug: (...log) => consoleLog('debug', ...log),\n    info: (...log) => consoleLog('info', ...log),\n    warn: (...log) => consoleLog('warn', ...log),\n    error: (...log) => consoleLog('error', ...log),\n    verbose: (...log) => consoleLog('verbose', ...log),\n};\n\nconst dispatchEvent_original = EventTarget.prototype.dispatchEvent;\nfunction dispatchEvent(event) {\n    if (event.type && !event.type.startsWith('react')) {\n      ReactNativeWebView.postMessage(JSON.stringify({\n        type: 'PayEngine',\n        event: {\n          type: event.type,\n          detail: event.detail\n        }\n      }))\n    }\n}\nEventTarget.prototype.dispatchEvent = dispatchEvent;\n`;\n"],"mappings":";;;;;;;;AAAA;;;;AAGO,MAAMA,kBAAN,SAAiCC,KAAjC,CAAuC;EAC5CC,WAAW,GAAG;IACZ,MACE,0FADF;EAGD;;AAL2C;;;;AAQvC,MAAMC,cAAc,GAAIC,MAAD,IAA8B;EAC1D,OAAO;IACLC,aAAa,EAAG,kBAAiBD,MAAM,CAACE,SAAU;EAD7C,CAAP;AAGD,CAJM;;;;AAMA,MAAMC,UAAU,GAAIH,MAAD,IAA8B;EACtD,IAAII,OAAO,GAAGJ,MAAM,CAACE,SAAP,CAAiBG,QAAjB,CAA0B,QAA1B,IACV,8BADU,GAEV,+BAFJ;;EAIA,IAAIL,MAAM,CAACM,SAAX,EAAsB;IACpBF,OAAO,GAAGJ,MAAM,CAACM,SAAP,CAAiBC,OAAjB,CAAyB,4BAAzB,EAAuD,IAAvD,CAAV;EACD;;EACD,OAAOH,OAAP;AACD,CATM;;;;AAWA,MAAMI,gBAAgB,GAAIR,MAAD,IAA8B;EAC5D,OAAOS,cAAA,CAAMC,MAAN,CAAa;IAClBC,OAAO,EAAER,UAAU,CAACH,MAAD,CADD;IAElBY,OAAO,EAAEb,cAAc,CAACC,MAAD;EAFL,CAAb,CAAP;AAID,CALM;;;;AAOA,SAASa,YAAT,CAAsBb,MAAtB,EAAgD;EACrD,IAAI,CAACA,MAAM,CAACE,SAAZ,EAAuB;IACrB,MAAM,IAAIL,KAAJ,CAAU,iCAAV,CAAN;EACD;;EACD,IAAIS,SAAS,GAAG,EAAhB;EACA,MAAMQ,WAAW,GAAGd,MAAM,CAACe,QAAP,GAAmB,aAAYf,MAAM,CAACe,QAAS,EAA/C,GAAmD,EAAvE;;EACA,IAAIf,MAAM,CAACM,SAAX,EAAsB;IACpBA,SAAS,GAAI,GAAEN,MAAM,CAACM,SAAU,QAAON,MAAM,CAACE,SAAU,GAAEY,WAAY,EAAtE;EACD,CAFD,MAEO;IACL,MAAMH,OAAO,GAAGX,MAAM,CAACE,SAAP,CAAiBG,QAAjB,CAA0B,QAA1B,IACZ,8BADY,GAEZ,+BAFJ;IAGA,MAAMW,OAAO,GAAGhB,MAAM,CAACgB,OAAP,IAAkB,OAAlC;IACAV,SAAS,GAAI,GAAEK,OAAQ,OAAMK,OAAQ,iBAAgBhB,MAAM,CAACE,SAAU,GAAEY,WAAY,EAApF;EACD;;EAED,OAAOR,SAAP;AACD;;AAEM,MAAMW,eAAe,GAAI;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAxBO"}
+{"version":3,"names":["PEDeprecationError","Error","constructor","getHttpHeaders","config","Authorization","publicKey","getBaseURL","baseUrl","includes","scriptURL","replace","createHttpClient","axios","create","baseURL","headers","getScriptURL","logLevelStr","logLevel","version","debuggingScript"],"sources":["index.ts"],"sourcesContent":["import axios from 'axios';\nimport type { IPayEngineConfig } from '../interfaces/index';\n\n/**\n * Custom error thrown when an obsolete method is called.\n *\n * The `PEDeprecationError` indicates that the method being used is deprecated,\n * and the user should check the package README for updated usage.\n */\nexport class PEDeprecationError extends Error {\n  constructor() {\n    super(\n      'This method is obsolete and can not be used anymore. Please check out the package README'\n    );\n  }\n}\n\n/**\n * @private\n */\nexport const getHttpHeaders = (config: IPayEngineConfig) => {\n  return {\n    Authorization: `Signature key=\"${config.publicKey}\",algorithm=\"hmac-sha256\",identifier=\"secure-fields\",signature=\"\"`,\n  };\n};\n\n/**\n * @private\n */\nexport const getBaseURL = (config: IPayEngineConfig) => {\n  let baseUrl = config.publicKey.includes('_prod_')\n    ? 'https://console.payengine.co'\n    : 'https://console.payengine.dev';\n\n  if (config.scriptURL) {\n    baseUrl = config.scriptURL.replace(/^((\\w+:)?\\/\\/[^\\/]+\\/?).*$/, '$1');\n  }\n  return baseUrl;\n};\n\n/**\n * @private\n */\nexport const createHttpClient = (config: IPayEngineConfig) => {\n  return axios.create({\n    baseURL: getBaseURL(config),\n    headers: getHttpHeaders(config),\n  });\n};\n\n/**\n * @private\n */\nexport function getScriptURL(config: IPayEngineConfig) {\n  if (!config.publicKey) {\n    throw new Error('PayEngine Public Key is missing');\n  }\n  let scriptURL = '';\n  const logLevelStr = config.logLevel ? `&loglevel=${config.logLevel}` : '';\n  if (config.scriptURL) {\n    scriptURL = `${config.scriptURL}?key=${config.publicKey}${logLevelStr}`;\n  } else {\n    const baseURL = config.publicKey.includes('_prod_')\n      ? 'https://console.payengine.co'\n      : 'https://console.payengine.dev';\n    const version = config.version ?? '1.0.0';\n    scriptURL = `${baseURL}/js/${version}/embed.js?key=${config.publicKey}${logLevelStr}`;\n  }\n\n  return scriptURL;\n}\n\n/**\n * @private\n */\nexport const debuggingScript = `\nconst consoleLog = (type, ...log) => window.ReactNativeWebView.postMessage(JSON.stringify({'type': 'Console', 'data': {'type': type, 'log': log}}));\nconsole = {\n    log: (...log) => consoleLog('log', ...log),\n    debug: (...log) => consoleLog('debug', ...log),\n    info: (...log) => consoleLog('info', ...log),\n    warn: (...log) => consoleLog('warn', ...log),\n    error: (...log) => consoleLog('error', ...log),\n    verbose: (...log) => consoleLog('verbose', ...log),\n};\n\nconst dispatchEvent_original = EventTarget.prototype.dispatchEvent;\nfunction dispatchEvent(event) {\n    if (event.type && !event.type.startsWith('react')) {\n      ReactNativeWebView.postMessage(JSON.stringify({\n        type: 'PayEngine',\n        event: {\n          type: event.type,\n          detail: event.detail\n        }\n      }))\n    }\n}\nEventTarget.prototype.dispatchEvent = dispatchEvent;\n`;\n"],"mappings":";;;;;;;;AAAA;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAN,SAAiCC,KAAjC,CAAuC;EAC5CC,WAAW,GAAG;IACZ,MACE,0FADF;EAGD;;AAL2C;AAQ9C;AACA;AACA;;;;;AACO,MAAMC,cAAc,GAAIC,MAAD,IAA8B;EAC1D,OAAO;IACLC,aAAa,EAAG,kBAAiBD,MAAM,CAACE,SAAU;EAD7C,CAAP;AAGD,CAJM;AAMP;AACA;AACA;;;;;AACO,MAAMC,UAAU,GAAIH,MAAD,IAA8B;EACtD,IAAII,OAAO,GAAGJ,MAAM,CAACE,SAAP,CAAiBG,QAAjB,CAA0B,QAA1B,IACV,8BADU,GAEV,+BAFJ;;EAIA,IAAIL,MAAM,CAACM,SAAX,EAAsB;IACpBF,OAAO,GAAGJ,MAAM,CAACM,SAAP,CAAiBC,OAAjB,CAAyB,4BAAzB,EAAuD,IAAvD,CAAV;EACD;;EACD,OAAOH,OAAP;AACD,CATM;AAWP;AACA;AACA;;;;;AACO,MAAMI,gBAAgB,GAAIR,MAAD,IAA8B;EAC5D,OAAOS,cAAA,CAAMC,MAAN,CAAa;IAClBC,OAAO,EAAER,UAAU,CAACH,MAAD,CADD;IAElBY,OAAO,EAAEb,cAAc,CAACC,MAAD;EAFL,CAAb,CAAP;AAID,CALM;AAOP;AACA;AACA;;;;;AACO,SAASa,YAAT,CAAsBb,MAAtB,EAAgD;EACrD,IAAI,CAACA,MAAM,CAACE,SAAZ,EAAuB;IACrB,MAAM,IAAIL,KAAJ,CAAU,iCAAV,CAAN;EACD;;EACD,IAAIS,SAAS,GAAG,EAAhB;EACA,MAAMQ,WAAW,GAAGd,MAAM,CAACe,QAAP,GAAmB,aAAYf,MAAM,CAACe,QAAS,EAA/C,GAAmD,EAAvE;;EACA,IAAIf,MAAM,CAACM,SAAX,EAAsB;IACpBA,SAAS,GAAI,GAAEN,MAAM,CAACM,SAAU,QAAON,MAAM,CAACE,SAAU,GAAEY,WAAY,EAAtE;EACD,CAFD,MAEO;IACL,MAAMH,OAAO,GAAGX,MAAM,CAACE,SAAP,CAAiBG,QAAjB,CAA0B,QAA1B,IACZ,8BADY,GAEZ,+BAFJ;IAGA,MAAMW,OAAO,GAAGhB,MAAM,CAACgB,OAAP,IAAkB,OAAlC;IACAV,SAAS,GAAI,GAAEK,OAAQ,OAAMK,OAAQ,iBAAgBhB,MAAM,CAACE,SAAU,GAAEY,WAAY,EAApF;EACD;;EAED,OAAOR,SAAP;AACD;AAED;AACA;AACA;;;AACO,MAAMW,eAAe,GAAI;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAxBO"}

package/lib/module/components/PayEngine.js

@@ -1,7 +1,7 @@
 import React from 'react';
 import { Text } from 'react-native';
 
-const PayEngine = () => {
+const PayEngine = _props => {
   return /*#__PURE__*/React.createElement(Text, null, "Obsolete. Please check out the package readme");
 };
 

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

@@ -1 +1 @@
-{"version":3,"names":["React","Text","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,OAAOA,KAAP,MAAkB,OAAlB;AACA,SAASC,IAAT,QAAqB,cAArB;;AAEA,MAAMC,SAAS,GAAG,MAAM;EACtB,oBAAO,oBAAC,IAAD,wDAAP;AACD,CAFD;;AAIA,eAAeA,SAAf"}
+{"version":3,"names":["React","Text","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,OAAOA,KAAP,MAAkB,OAAlB;AACA,SAASC,IAAT,QAAqB,cAArB;;AAEA,MAAMC,SAAS,GAAIC,MAAD,IAAiB;EACjC,oBAAO,oBAAC,IAAD,wDAAP;AACD,CAFD;;AAIA,eAAeD,SAAf"}

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

@@ -8,6 +8,130 @@ const COMPONENT_NAME = 'RNPEApplePayButton';
 const RNPEApplePayButton = requireNativeComponent(COMPONENT_NAME); // @ts-ignore
 
 const RNPEApplePayButtonManager = 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
+ */
 export const PEApplePayButton = /*#__PURE__*/React.forwardRef((props, ref) => {
   const buttonRef = React.useRef();
   React.useImperativeHandle(ref, () => ({