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

package/lib/module/index.js

@@ -1,10 +1,15 @@
+/**
+ * Main Module
+ * @module PayEngine SDK
+ */
 import PayEngine from './components/PayEngine';
 import { NativeModules, Platform } from 'react-native';
 import { PayProvider } from './interfaces/index';
-import { PECreditCardView, PECreditCardViewMethods } from './components/v2/SecureFields/CreditCardView';
-import { PEBankAccountView, PEBankAccountViewMethods } from './components/v2/SecureFields/BankAccountView';
+import { PECreditCardView } from './components/v2/SecureFields/CreditCardView';
+import { PEBankAccountView } from './components/v2/SecureFields/BankAccountView';
 import { PayEngineProvider } from './components/v2/PayEngineProvider';
 import PayEngineNative from './components/v2/PayEngineNative';
+import { FetchAccessTokenCallback, AccessToken } from './components/v2/PayEngineNative';
 import { PEApplePayButton } from './components/v2/ApplePay/PEApplePayButton';
 import { PEGooglePayButton } from './components/v2/GooglePay/PEGooglePayButton';
 import * as PayEngineUtils from './utils/index';
@@ -22,10 +27,10 @@ const PayEngineStatic = NativeModules.Payengine ? NativeModules.Payengine : new
 
 });
 export { PayEngineStatic, PayEngine, PayProvider, // v2 starting here
-PayEngineUtils, PayEngineProvider, PayEngineNative, // securefields
+PayEngineUtils, PayEngineProvider, PayEngineNative, AccessToken, FetchAccessTokenCallback, // securefields
 PEKeyboardType, // credit card
-PECreditCardView, PECreditCardViewMethods, // bank account
-PEBankAccountView, PEBankAccountViewMethods, // Apple Pay
+PECreditCardView, // bank account
+PEBankAccountView, // Apple Pay
 PEApplePayButton, // RNPEGooglePayBillingAddressParameters,
 // RNPEGooglePayShippingAddressParameters,
 // PEPaymentRequest,

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["PayEngine","NativeModules","Platform","PayProvider","PECreditCardView","PECreditCardViewMethods","PEBankAccountView","PEBankAccountViewMethods","PayEngineProvider","PayEngineNative","PEApplePayButton","PEGooglePayButton","PayEngineUtils","PEKeyboardType","LINKING_ERROR","select","ios","default","PayEngineStatic","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,OAAOA,SAAP,MAAsB,wBAAtB;AACA,SAASC,aAAT,EAAwBC,QAAxB,QAAwC,cAAxC;AAEA,SAASC,WAAT,QAA4B,oBAA5B;AACA,SACEC,gBADF,EAEEC,uBAFF,QAGO,6CAHP;AAIA,SACEC,iBADF,EAEEC,wBAFF,QAGO,8CAHP;AAOA,SAASC,iBAAT,QAAkC,mCAAlC;AACA,OAAOC,eAAP,MAA4B,iCAA5B;AACA,SAASC,gBAAT,QAAiC,2CAAjC;AAEA,SAASC,iBAAT,QAAkC,6CAAlC;AACA,OAAO,KAAKC,cAAZ,MAAgC,eAAhC;AACA,OAAOC,cAAP,MAA2B,6CAA3B;AAIA,cAAc,kCAAd;AACA,cAAc,+CAAd;AAGA,MAAMC,aAAa,GAChB,iFAAD,GACAZ,QAAQ,CAACa,MAAT,CAAgB;EAAEC,GAAG,EAAE,gCAAP;EAAyCC,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,eAAe,GAAGjB,aAAa,CAACkB,SAAd,GACpBlB,aAAa,CAACkB,SADM,GAEpB,IAAIC,KAAJ,CACE,EADF,EAEE;EACEC,GAAG,GAAG;IACJ,MAAM,IAAIC,KAAJ,CAAUR,aAAV,CAAN;EACD;;AAHH,CAFF,CAFJ;AAWA,SACEI,eADF,EAEElB,SAFF,EAIEG,WAJF,EAKE;AACAS,cANF,EAOEJ,iBAPF,EAQEC,eARF,EASE;AACAI,cAVF,EAYE;AACAT,gBAbF,EAcEC,uBAdF,EAgBE;AACAC,iBAjBF,EAkBEC,wBAlBF,EAoBE;AACAG,gBArBF,EAyBE;AACA;AACA;AACAC,iBA5BF"}
+{"version":3,"names":["PayEngine","NativeModules","Platform","PayProvider","PECreditCardView","PEBankAccountView","PayEngineProvider","PayEngineNative","FetchAccessTokenCallback","AccessToken","PEApplePayButton","PEGooglePayButton","PayEngineUtils","PEKeyboardType","LINKING_ERROR","select","ios","default","PayEngineStatic","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":"AAAA;AACA;AACA;AACA;AAEA,OAAOA,SAAP,MAAsB,wBAAtB;AACA,SAASC,aAAT,EAAwBC,QAAxB,QAAwC,cAAxC;AAEA,SAASC,WAAT,QAA4B,oBAA5B;AAEA,SACEC,gBADF,QAIO,6CAJP;AAKA,SACEC,iBADF,QAIO,8CAJP;AAQA,SAASC,iBAAT,QAAkC,mCAAlC;AACA,OAAOC,eAAP,MAA4B,iCAA5B;AACA,SAASC,wBAAT,EAAmCC,WAAnC,QAAsD,iCAAtD;AACA,SAASC,gBAAT,QAA2F,2CAA3F;AAEA,SAASC,iBAAT,QAA8F,6CAA9F;AACA,OAAO,KAAKC,cAAZ,MAAgC,eAAhC;AACA,OAAOC,cAAP,MAA2B,6CAA3B;AAIA,cAAc,kCAAd;AACA,cAAc,+CAAd;AAGA,MAAMC,aAAa,GAChB,iFAAD,GACAZ,QAAQ,CAACa,MAAT,CAAgB;EAAEC,GAAG,EAAE,gCAAP;EAAyCC,OAAO,EAAE;AAAlD,CAAhB,CADA,GAEA,sDAFA,GAGA,6CAJF;AAMA,MAAMC,eAAe,GAAGjB,aAAa,CAACkB,SAAd,GACpBlB,aAAa,CAACkB,SADM,GAEpB,IAAIC,KAAJ,CACE,EADF,EAEE;EACEC,GAAG,GAAG;IACJ,MAAM,IAAIC,KAAJ,CAAUR,aAAV,CAAN;EACD;;AAHH,CAFF,CAFJ;AAWA,SACEI,eADF,EAEElB,SAFF,EAIEG,WAJF,EAKE;AACAS,cANF,EAOEN,iBAPF,EAQEC,eARF,EASEE,WATF,EAUED,wBAVF,EAWE;AACAK,cAZF,EAeE;AACAT,gBAhBF,EAoBE;AACAC,iBArBF,EAyBE;AACAK,gBA1BF,EAgCE;AACA;AACA;AACAC,iBAnCF"}

package/lib/module/interfaces/index.js

@@ -1,3 +1,22 @@
+/**
+ * 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
+ */
 export let PayProvider;
 
 (function (PayProvider) {

package/lib/module/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":"AAOA,WAAYA,WAAZ;;WAAYA,W;EAAAA,W,CAAAA,W;EAAAA,W,CAAAA,W;GAAAA,W,KAAAA,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;AACA,WAAYA,WAAZ;;WAAYA,W;EAAAA,W,CAAAA,W;EAAAA,W,CAAAA,W;GAAAA,W,KAAAA,W"}

package/lib/module/utils/index.js

@@ -1,15 +1,30 @@
 import axios from 'axios';
+
+/**
+ * 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.
+ */
 export class PEDeprecationError extends Error {
   constructor() {
     super('This method is obsolete and can not be used anymore. Please check out the package README');
   }
 
 }
+/**
+ * @private
+ */
+
 export const getHttpHeaders = config => {
   return {
     Authorization: `Signature key="${config.publicKey}",algorithm="hmac-sha256",identifier="secure-fields",signature=""`
   };
 };
+/**
+ * @private
+ */
+
 export const getBaseURL = config => {
   let baseUrl = config.publicKey.includes('_prod_') ? 'https://console.payengine.co' : 'https://console.payengine.dev';
 
@@ -19,12 +34,20 @@ export const getBaseURL = config => {
 
   return baseUrl;
 };
+/**
+ * @private
+ */
+
 export const createHttpClient = config => {
   return axios.create({
     baseURL: getBaseURL(config),
     headers: getHttpHeaders(config)
   });
 };
+/**
+ * @private
+ */
+
 export function getScriptURL(config) {
   if (!config.publicKey) {
     throw new Error('PayEngine Public Key is missing');
@@ -43,6 +66,10 @@ export function getScriptURL(config) {
 
   return scriptURL;
 }
+/**
+ * @private
+ */
+
 export const debuggingScript = `
 const consoleLog = (type, ...log) => window.ReactNativeWebView.postMessage(JSON.stringify({'type': 'Console', 'data': {'type': type, 'log': log}}));
 console = {

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

@@ -1 +1 @@
-{"version":3,"names":["axios","PEDeprecationError","Error","constructor","getHttpHeaders","config","Authorization","publicKey","getBaseURL","baseUrl","includes","scriptURL","replace","createHttpClient","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,OAAOA,KAAP,MAAkB,OAAlB;AAGA,OAAO,MAAMC,kBAAN,SAAiCC,KAAjC,CAAuC;EAC5CC,WAAW,GAAG;IACZ,MACE,0FADF;EAGD;;AAL2C;AAQ9C,OAAO,MAAMC,cAAc,GAAIC,MAAD,IAA8B;EAC1D,OAAO;IACLC,aAAa,EAAG,kBAAiBD,MAAM,CAACE,SAAU;EAD7C,CAAP;AAGD,CAJM;AAMP,OAAO,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,OAAO,MAAMI,gBAAgB,GAAIR,MAAD,IAA8B;EAC5D,OAAOL,KAAK,CAACc,MAAN,CAAa;IAClBC,OAAO,EAAEP,UAAU,CAACH,MAAD,CADD;IAElBW,OAAO,EAAEZ,cAAc,CAACC,MAAD;EAFL,CAAb,CAAP;AAID,CALM;AAOP,OAAO,SAASY,YAAT,CAAsBZ,MAAtB,EAAgD;EACrD,IAAI,CAACA,MAAM,CAACE,SAAZ,EAAuB;IACrB,MAAM,IAAIL,KAAJ,CAAU,iCAAV,CAAN;EACD;;EACD,IAAIS,SAAS,GAAG,EAAhB;EACA,MAAMO,WAAW,GAAGb,MAAM,CAACc,QAAP,GAAmB,aAAYd,MAAM,CAACc,QAAS,EAA/C,GAAmD,EAAvE;;EACA,IAAId,MAAM,CAACM,SAAX,EAAsB;IACpBA,SAAS,GAAI,GAAEN,MAAM,CAACM,SAAU,QAAON,MAAM,CAACE,SAAU,GAAEW,WAAY,EAAtE;EACD,CAFD,MAEO;IACL,MAAMH,OAAO,GAAGV,MAAM,CAACE,SAAP,CAAiBG,QAAjB,CAA0B,QAA1B,IACZ,8BADY,GAEZ,+BAFJ;IAGA,MAAMU,OAAO,GAAGf,MAAM,CAACe,OAAP,IAAkB,OAAlC;IACAT,SAAS,GAAI,GAAEI,OAAQ,OAAMK,OAAQ,iBAAgBf,MAAM,CAACE,SAAU,GAAEW,WAAY,EAApF;EACD;;EAED,OAAOP,SAAP;AACD;AAED,OAAO,MAAMU,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":["axios","PEDeprecationError","Error","constructor","getHttpHeaders","config","Authorization","publicKey","getBaseURL","baseUrl","includes","scriptURL","replace","createHttpClient","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,OAAOA,KAAP,MAAkB,OAAlB;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAN,SAAiCC,KAAjC,CAAuC;EAC5CC,WAAW,GAAG;IACZ,MACE,0FADF;EAGD;;AAL2C;AAQ9C;AACA;AACA;;AACA,OAAO,MAAMC,cAAc,GAAIC,MAAD,IAA8B;EAC1D,OAAO;IACLC,aAAa,EAAG,kBAAiBD,MAAM,CAACE,SAAU;EAD7C,CAAP;AAGD,CAJM;AAMP;AACA;AACA;;AACA,OAAO,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;;AACA,OAAO,MAAMI,gBAAgB,GAAIR,MAAD,IAA8B;EAC5D,OAAOL,KAAK,CAACc,MAAN,CAAa;IAClBC,OAAO,EAAEP,UAAU,CAACH,MAAD,CADD;IAElBW,OAAO,EAAEZ,cAAc,CAACC,MAAD;EAFL,CAAb,CAAP;AAID,CALM;AAOP;AACA;AACA;;AACA,OAAO,SAASY,YAAT,CAAsBZ,MAAtB,EAAgD;EACrD,IAAI,CAACA,MAAM,CAACE,SAAZ,EAAuB;IACrB,MAAM,IAAIL,KAAJ,CAAU,iCAAV,CAAN;EACD;;EACD,IAAIS,SAAS,GAAG,EAAhB;EACA,MAAMO,WAAW,GAAGb,MAAM,CAACc,QAAP,GAAmB,aAAYd,MAAM,CAACc,QAAS,EAA/C,GAAmD,EAAvE;;EACA,IAAId,MAAM,CAACM,SAAX,EAAsB;IACpBA,SAAS,GAAI,GAAEN,MAAM,CAACM,SAAU,QAAON,MAAM,CAACE,SAAU,GAAEW,WAAY,EAAtE;EACD,CAFD,MAEO;IACL,MAAMH,OAAO,GAAGV,MAAM,CAACE,SAAP,CAAiBG,QAAjB,CAA0B,QAA1B,IACZ,8BADY,GAEZ,+BAFJ;IAGA,MAAMU,OAAO,GAAGf,MAAM,CAACe,OAAP,IAAkB,OAAlC;IACAT,SAAS,GAAI,GAAEI,OAAQ,OAAMK,OAAQ,iBAAgBf,MAAM,CAACE,SAAU,GAAEW,WAAY,EAApF;EACD;;EAED,OAAOP,SAAP;AACD;AAED;AACA;AACA;;AACA,OAAO,MAAMU,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/typescript/components/PayEngine.d.ts

@@ -1,2 +1,2 @@
-declare const PayEngine: () => JSX.Element;
+declare const PayEngine: (_props: any) => JSX.Element;
 export default PayEngine;

package/lib/typescript/components/v2/ApplePay/PEApplePayButton.d.ts

@@ -2,15 +2,57 @@ import * as React from 'react';
 import { ViewProps } from 'react-native';
 import type { PEPaymentRequest, PESummaryItem } from '../PEPaymentRequest';
 import type { PEApplePayContact, PEApplePayPaymentMethod, PEApplePaySheetError, PEApplePayShippingMethod } from './PEApplePayInterfaces';
+/**
+ * Props for the Apple Pay button component.
+ *
+ * This interface defines the properties you can pass to the Apple Pay button,
+ * including the payment request and various event callbacks triggered throughout
+ * the Apple Pay flow.
+ *
+ * @category Apple Pay
+ */
 export interface PEApplePayButtonProps extends ViewProps {
+    /**
+     * The payment request containing transaction details such as the total amount,
+     * currency, supported networks, and required contact fields.
+     */
     paymentRequest: PEPaymentRequest;
+    /**
+     * Callback triggered when the Apple Pay token is successfully generated.
+     *
+     * @param token - A string representing the Apple Pay payment token.
+     * @param metadata - Optional metadata related to the transaction.
+     * @param billingContact - The billing contact information (if available).
+     * @param shippingContact - The shipping contact information (if available).
+     *
+     * Example:
+     * ```ts
+     * onTokenDidReturn: (token, metadata, billing, shipping) => {
+     *   console.log('Token:', token);
+     *   console.log('Billing contact:', billing?.givenName);
+     *   console.log('Shipping contact:', shipping?.givenName);
+     * }
+     * ```
+     */
     onTokenDidReturn?: (token: string, metadata?: any, billingContact?: PEApplePayContact, shippingContact?: PEApplePayContact) => void;
+    /**
+     * Callback triggered when the Apple Pay sheet is dismissed,
+     * either by completing the payment or canceling it.
+     */
     onPaymentSheetDismissed?: () => void;
+    /**
+     * Callback triggered when the Apple Pay process fails.
+     *
+     * @param error - The error that occurred during the payment flow.
+     */
     onPaymentFailed?: (error: Error) => void;
     /**
-     * This callback is triggered whenever the payment method changes in the Apple Pay sheet.
-     * You MUST update the Apple Pay sheet in your callback using the updatePaymentSheet function,
-     * otherwise the Apple Pay sheet will hang and the payment flow will automatically cancel.
+     * Callback triggered when the user selects or changes the payment method
+     * within the Apple Pay sheet.
+     *
+     * You MUST call `updatePaymentSheet` in response to this callback to update
+     * the Apple Pay sheet. Failing to do so will cause the sheet to hang
+     * and the transaction will automatically cancel.
      */
     onPaymentMethodSelected?: (event: {
         nativeEvent: {
@@ -18,9 +60,12 @@ export interface PEApplePayButtonProps extends ViewProps {
         };
     }) => void;
     /**
-     * This callback is triggered whenever the user selects a shipping method in the Apple Pay sheet.
-     * You MUST update the Apple Pay sheet in your callback using the updatePaymentSheet function,
-     * otherwise the Apple Pay sheet will hang and the payment flow will automatically cancel.
+     * Callback triggered when the user selects a shipping contact
+     * (e.g., their shipping address) within the Apple Pay sheet.
+     *
+     * You MUST call `updatePaymentSheet` in response to this callback to update
+     * shipping methods, summary items, or errors. Failure to do so will hang the
+     * sheet and cancel the transaction automatically.
      */
     onShippingContactSelected?: (event: {
         nativeEvent: {
@@ -28,9 +73,12 @@ export interface PEApplePayButtonProps extends ViewProps {
         };
     }) => void;
     /**
-     * This callback is triggered whenever the user selects a shipping contact in the Apple Pay sheet.
-     * You MUST update the Apple Pay sheet in your callback using the updatePaymentSheet function,
-     * otherwise the Apple Pay sheet will hang and the payment flow will automatically cancel.
+     * Callback triggered when the user selects a shipping method (e.g., standard or express)
+     * in the Apple Pay sheet.
+     *
+     * You MUST call `updatePaymentSheet` in response to this callback to reflect
+     * any changes in pricing or available options. If you don't, the Apple Pay sheet
+     * will hang and the payment will be canceled.
      */
     onShippingMethodSelected?: (event: {
         nativeEvent: {
@@ -38,12 +86,169 @@ export interface PEApplePayButtonProps extends ViewProps {
         };
     }) => void;
 }
+/**
+ * Exposes imperative methods for controlling the Apple Pay payment sheet.
+ *
+ * This interface is typically used via a `ref` to programmatically update
+ * the state of the Apple Pay sheet after certain user interactions.
+ *
+ * Specifically, the `updatePaymentSheet` method should be called in response to
+ * any of the following events:
+ * - `onPaymentMethodSelected`
+ * - `onShippingContactSelected`
+ * - `onShippingMethodSelected`
+ *
+ * @category Apple Pay
+ */
 export interface PEApplePayButtonMethods {
     /**
-     * This method must be called after either onPaymentMethodSelected, onShippingContactSelected or
-     * onShippingMethodSelected callbacks are triggered.
-     * `shippingMethods` and `errors` are only applicable for onShippingContactSelected callback
+     * Updates the Apple Pay payment sheet with new summary items, shipping methods, and validation errors.
+     *
+     * This method should be called in response to user selections made on the Apple Pay sheet,
+     * such as selecting a new payment method, shipping contact, or shipping method.
+     *
+     * ### Parameters:
+     * - `summaryItems`: The updated list of items summarizing the total payment amount (e.g., subtotal, tax, total).
+     * - `shippingMethods`: A list of available shipping methods based on the selected shipping contact.
+     *   - Only applicable when the `onShippingContactSelected` callback is triggered.
+     * - `errors`: A list of validation errors (e.g., invalid address or unsupported shipping region).
+     *   - Also only applicable for `onShippingContactSelected`.
+     *
+     * ### Returns:
+     * - A `Promise<boolean>` indicating whether the update was successful.
+     *
+     * ### Example:
+     * ```ts
+     * await ref.current?.updatePaymentSheet(
+     *   updatedSummaryItems,
+     *   availableShippingMethods,
+     *   validationErrors
+     * );
+     * ```
      */
     updatePaymentSheet: (summaryItems: PESummaryItem[], shippingMethods: PEApplePayShippingMethod[], errors: PEApplePaySheetError[]) => Promise<boolean>;
 }
+/**
+ * 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 declare const PEApplePayButton: React.ForwardRefExoticComponent<PEApplePayButtonProps & React.RefAttributes<PEApplePayButtonMethods>>;