react-amwal-pay 0.1.13 → 0.1.15

package/README.md

@@ -170,7 +170,10 @@ const config: AmwalPayConfig = {
   merchantReference: 'optional-merchant-reference', // optional: merchant reference for transaction tracking
   additionValues: { // optional: custom key-value pairs for SDK configuration
     merchantIdentifier: 'merchant.applepay.amwalpay', // for Apple Pay configuration
-    customKey: 'customValue' // add more as needed
+    useBottomSheetDesign: 'true', // use bottom sheet design (v2)
+    primaryColor: '#FF5733', // custom primary color
+    secondaryColor: '#33FF57', // custom secondary color
+    ignoreReceipt: 'false' // show receipt after transaction
   },
   onCustomerId(customerId) {
     console.log('Customer ID:', customerId);
@@ -236,7 +239,32 @@ The SDK supports `additionValues` parameter for passing custom key-value pairs t
 The SDK automatically provides default values:
 - `merchantIdentifier`: "merchant.applepay.amwalpay" (used for Apple Pay configuration)
 
-### Usage
+### Available Configuration Options
+
+You can customize the SDK behavior using the following `additionValues` keys:
+
+#### UI Customization
+- **`useBottomSheetDesign`**: `'true'` | `'false'` (default: `'false'`)
+  - Controls the payment screen design
+  - `'true'`: Uses the newer bottom sheet design (v2)
+  - `'false'`: Uses the original full-screen design
+
+- **`primaryColor`**: Hex color string (e.g., `'#FF5733'`)
+  - Sets the primary theme color for the SDK UI
+
+- **`secondaryColor`**: Hex color string (e.g., `'#33FF57'`)
+  - Sets the secondary theme color for the SDK UI
+
+#### Payment Flow
+- **`ignoreReceipt`**: `'true'` | `'false'` (default: `'false'`)
+  - Controls whether to show the receipt screen after transaction
+  - `'true'`: Skips the receipt display
+  - `'false'`: Shows the receipt screen
+
+- **`merchantIdentifier`**: String (default: `'merchant.applepay.amwalpay'`)
+  - Apple Pay merchant identifier for iOS
+
+### Usage Examples
 
 ```js
 // Using default additionValues (automatically applied)
@@ -245,18 +273,31 @@ const config = {
   // additionValues will automatically include merchantIdentifier
 };
 
-// Using custom additionValues
+// Using custom additionValues with UI customization
 const customConfig = {
   // ... other configuration
   additionValues: {
-    merchantIdentifier: 'merchant.custom.identifier',
-    customKey: 'customValue'
+    useBottomSheetDesign: 'true',
+    primaryColor: '#FF5733',
+    secondaryColor: '#33FF57',
+    ignoreReceipt: 'false',
+    merchantIdentifier: 'merchant.custom.identifier'
+  }
+};
+
+// Minimal configuration with bottom sheet design
+const minimalConfig = {
+  // ... other configuration
+  additionValues: {
+    useBottomSheetDesign: 'true'
   }
 };
 ```
 
 Custom `additionValues` will be merged with defaults, with custom values taking precedence.
 
+**Note:** All boolean values should be passed as strings (`'true'` or `'false'`).
+
 ## Configuration
 
 The `AmwalPayConfig` interface includes the following properties:

package/ios/ReactAmwalPay.m

@@ -3,12 +3,10 @@
 
 @interface RCT_EXTERN_MODULE(ReactAmwalPay, RCTEventEmitter)
 
-RCT_EXTERN_METHOD(initiate:(NSDictionary *)config
-                  resolver:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(initiate:(NSDictionary *)config)
 
-RCT_EXTERN_METHOD(onResponse:(RCTResponseSenderBlock)callback)
+RCT_EXTERN_METHOD(addListener:(NSString *)eventName)
 
-RCT_EXTERN_METHOD(onCustomerId:(RCTResponseSenderBlock)callback)
+RCT_EXTERN_METHOD(removeListeners:(double)count)
 
 @end

package/ios/ReactAmwalPay.swift

@@ -1,11 +1,208 @@
 import Foundation
 import amwalsdk
 import React
+import UIKit
+
+// MARK: - Container view controller that keeps SDK alive during 3DS presentation
+/// This container wraps the SDK view controller as a child
+/// When 3DS opens its WebView, it can present on top without dismissing the SDK
+class ShareableContainerViewController: UIViewController {
+    private let sdkViewController: UIViewController
+    
+    init(sdkViewController: UIViewController) {
+        self.sdkViewController = sdkViewController
+        super.init(nibName: nil, bundle: nil)
+    }
+    
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+    
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        
+        // Add SDK view controller as child - this keeps it alive during 3DS presentation
+        addChild(sdkViewController)
+        view.addSubview(sdkViewController.view)
+        sdkViewController.view.frame = view.bounds
+        sdkViewController.view.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        sdkViewController.didMove(toParent: self)
+        
+        view.backgroundColor = .clear
+        sdkViewController.view.backgroundColor = .clear
+        
+        // Enable presentation context to handle 3DS WebView presentation
+        // This is critical: allows 3DS WebView to present on top without dismissing the SDK
+        definesPresentationContext = true
+        providesPresentationContextTransitionStyle = true
+        
+        // Ensure the SDK view controller also allows nested presentations
+        // This prevents it from being dismissed when 3DS presents its WebView
+        sdkViewController.definesPresentationContext = true
+        sdkViewController.providesPresentationContextTransitionStyle = true
+    }
+    
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        // Ensure container is ready for nested presentations
+    }
+    
+    private func topmostPresentedViewController() -> UIViewController {
+        var topController: UIViewController = self
+        while let presented = topController.presentedViewController {
+            topController = presented
+        }
+        return topController
+    }
+    
+    override func present(_ viewControllerToPresent: UIViewController, animated flag: Bool, completion: (() -> Void)? = nil) {
+        // If already presenting, present from the topmost controller
+        // This allows 3DS WebView to present on top without dismissing the SDK
+        if let presented = presentedViewController {
+            let topmost = topmostPresentedViewController()
+            topmost.present(viewControllerToPresent, animated: flag, completion: completion)
+        } else {
+            super.present(viewControllerToPresent, animated: flag, completion: completion)
+        }
+    }
+}
+
+// MARK: - Fix UIViewController presentation for share sheets
+public extension UIViewController {
+    static let swizzlePresentOnce: Void = {
+        let originalSelector = #selector(UIViewController.present(_:animated:completion:))
+        let swizzledSelector = #selector(UIViewController.swizzled_present(_:animated:completion:))
+        
+        guard let originalMethod = class_getInstanceMethod(UIViewController.self, originalSelector),
+              let swizzledMethod = class_getInstanceMethod(UIViewController.self, swizzledSelector) else {
+            return
+        }
+        
+        method_exchangeImplementations(originalMethod, swizzledMethod)
+    }()
+    
+    @objc dynamic func swizzled_present(_ viewControllerToPresent: UIViewController, animated flag: Bool, completion: (() -> Void)? = nil) {
+        // Check if this view controller's view is in the window hierarchy
+        if self.view.window == nil {
+            print("⚠️ Attempting to present on VC not in hierarchy, finding correct presenter...")
+            // Find the correct view controller to present from
+            if let topVC = UIViewController.getTopMostViewController() {
+                topVC.swizzled_present(viewControllerToPresent, animated: flag, completion: completion)
+                return
+            }
+        }
+        
+        // Special handling for ShareableContainerViewController and its children
+        // If presenting from a child of ShareableContainerViewController, forward to container
+        if let container = findShareableContainer() {
+            if container != self {
+                // We're a child of the container, forward to container
+                container.swizzled_present(viewControllerToPresent, animated: flag, completion: completion)
+                return
+            }
+            // We ARE the container - allow nested presentations
+            // Don't auto-dismiss, just present on top
+        } else if self.presentedViewController != nil && !self.definesPresentationContext {
+            // Not a container, and already presenting - auto-dismiss
+            print("⚠️ Already presenting, dismissing first...")
+            self.dismiss(animated: false) { [weak self] in
+                self?.swizzled_present(viewControllerToPresent, animated: flag, completion: completion)
+            }
+            return
+        }
+        
+        // Call original implementation
+        self.swizzled_present(viewControllerToPresent, animated: flag, completion: completion)
+    }
+    
+    // Helper to find ShareableContainerViewController in parent hierarchy
+    private func findShareableContainer() -> ShareableContainerViewController? {
+        var current: UIViewController? = self
+        while let parent = current?.parent {
+            if let container = parent as? ShareableContainerViewController {
+                return container
+            }
+            current = parent
+        }
+        if let container = self as? ShareableContainerViewController {
+            return container
+        }
+        return nil
+    }
+    
+    static func getTopMostViewController() -> UIViewController? {
+        var topController: UIViewController?
+        
+        if #available(iOS 13.0, *) {
+            let keyWindow = UIApplication.shared.connectedScenes
+                .compactMap { $0 as? UIWindowScene }
+                .flatMap { $0.windows }
+                .first { $0.isKeyWindow }
+            topController = keyWindow?.rootViewController
+        } else {
+            topController = UIApplication.shared.keyWindow?.rootViewController
+        }
+        
+        while let presented = topController?.presentedViewController {
+            topController = presented
+        }
+        
+        return topController
+    }
+}
 
 @objc(ReactAmwalPay)
-class ReactAmwalPay: RCTEventEmitter {
+open class ReactAmwalPay: RCTEventEmitter {
     private var hasListeners = false
+    private var sdkWindow: UIWindow?  // Separate window for SDK to avoid modal dismissal issues
+    
+    // Initialize swizzling when the class is first loaded
+    private static let initializeSwizzling: Void = {
+        _ = UIViewController.swizzlePresentOnce
+    }()
     
+    // Initialize swizzling when the module is loaded
+    public override init() {
+        super.init()
+        _ = ReactAmwalPay.initializeSwizzling
+    }
+
+    open override func supportedEvents() -> [String]! {
+        return ["onResponse", "onCustomerId"]
+    }
+
+    open override func startObserving() {
+        print("🔴 startObserving called - setting hasListeners = true")
+        hasListeners = true
+    }
+
+    open override func stopObserving() {
+        print("🔴 stopObserving called - setting hasListeners = false")
+        hasListeners = false
+    }
+
+    private func emitOnResponse(_ params: [String: Any]) {
+        print("🔴 emitOnResponse called with params: \(params)")
+        print("🔴 hasListeners: \(hasListeners)")
+        if hasListeners {
+            print("🔴 Sending onResponse event to JS")
+            sendEvent(withName: "onResponse", body: params)
+        } else {
+            print("🔴 NOT sending - no listeners!")
+        }
+    }
+
+    private func emitOnCustomerId(_ customerId: String?) {
+        print("🔴 emitOnCustomerId called with: \(customerId ?? "nil")")
+        print("🔴 hasListeners: \(hasListeners)")
+        if hasListeners {
+            print("🔴 Sending onCustomerId event to JS")
+            sendEvent(withName: "onCustomerId", body: customerId)
+        } else {
+            print("🔴 NOT sending - no listeners!")
+        }
+    }
+
     private func mapEnvironment(environment: String) -> Config.Environment {
         switch environment {
         case "PROD": return .PROD
@@ -39,8 +236,6 @@ class ReactAmwalPay: RCTEventEmitter {
         }
     }
     
-    private var onResponseCallback: RCTResponseSenderBlock?
-    private var onCustomerIdCallback: RCTResponseSenderBlock?
     private func prepareConfig(config: [String: Any]) -> Config {
         // Handle additionValues
         var additionValues: [String: String] = Config.generateDefaultAdditionValues()
@@ -50,7 +245,7 @@ class ReactAmwalPay: RCTEventEmitter {
                 additionValues[key] = value
             }
         }
-        
+
         return Config(
             environment: mapEnvironment(environment: config["environment"] as? String ?? "PROD"),
             sessionToken: config["sessionToken"] as? String ?? "",
@@ -68,56 +263,134 @@ class ReactAmwalPay: RCTEventEmitter {
     }
     
     @objc
-    func initiate(_ config: [String: Any],
-                 resolver resolve: @escaping RCTPromiseResolveBlock,
-                 rejecter reject: @escaping RCTPromiseRejectBlock) {
+    open func initiate(_ config: [String: Any]) {
       DispatchQueue.main.async {
            do {
                let sdkConfig = self.prepareConfig(config: config)
                let sdk = AmwalSDK()
-               
+
                guard let rootVC = UIApplication.shared.keyWindow?.rootViewController else {
-                   reject("NO_ROOT_VC", "No root view controller found", nil)
+                   let errorData: [String: Any] = [
+                       "data": [
+                           "status": "ERROR",
+                           "message": "No root view controller found"
+                       ]
+                   ]
+                   self.emitOnResponse(errorData)
                    return
                }
-               
+
                let sdkVC = try sdk.createViewController(
                    config: sdkConfig,
                    onResponse: { [weak self] response in
-                                         self?.onResponseCallback?([[
-                                             "status": response != nil ? "success" : "error",
-                                             "message": response != nil ? "Transaction completed" : "Transaction failed",
-                                             "data": response ?? ""
-                                         ]])
-                                     },
+                       print("🟠 SDK onResponse callback fired!")
+                       print("🟠 Response type: \(type(of: response))")
+                       print("🟠 Response value: \(response ?? "nil")")
+
+                       // Dismiss SDK window when payment completes
+                       DispatchQueue.main.async {
+                           self?.dismissSDKWindow()
+                       }
+
+                       // The SDK returns a JSON string, we need to parse it
+                       if let responseString = response as? String,
+                          let data = responseString.data(using: .utf8),
+                          let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
+                           print("🟠 Successfully parsed JSON string to dictionary")
+                           self?.emitOnResponse(json)
+                       } else if let responseDict = response as? [String: Any] {
+                           print("🟠 Response is already a dictionary")
+                           self?.emitOnResponse(responseDict)
+                       } else {
+                           print("🟠 Could not parse response, sending as-is")
+                           let errorData: [String: Any] = [
+                               "status": "error",
+                               "message": "Invalid response format",
+                               "rawResponse": String(describing: response)
+                           ]
+                           self?.emitOnResponse(errorData)
+                       }
+                   },
                    onCustomerId: { [weak self] customerId in
-                     self?.onCustomerIdCallback?([customerId])
-                                       }
+                       print("🟠 SDK onCustomerId callback fired with: \(customerId ?? "nil")")
+                       self?.emitOnCustomerId(customerId)
+                   }
                )
+
+               // Ensure transparency
+               sdkVC.view.backgroundColor = .clear
+               sdkVC.view.isOpaque = false
+               
+               // Wrap SDK view controller in container
+               let containerVC = ShareableContainerViewController(sdkViewController: sdkVC)
+               containerVC.view.backgroundColor = .clear
+
+               print("🟠 SDK ViewController wrapped in container")
+               print("🟠 Creating separate window for SDK...")
+
+               // Create a separate window for the SDK
+               // This prevents modal presentation issues - SDK lives in its own window
+               // 3DS can present on top without affecting the SDK
+               if #available(iOS 13.0, *) {
+                   if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene {
+                       self.sdkWindow = UIWindow(windowScene: windowScene)
+                   }
+               } else {
+                   self.sdkWindow = UIWindow(frame: UIScreen.main.bounds)
+               }
+               
+               guard let sdkWindow = self.sdkWindow else {
+                   print("🟠 Failed to create SDK window, falling back to modal presentation")
+                   rootVC.present(containerVC, animated: true)
+                   return
+               }
                
-               // Present modally (critical missing piece)
-               rootVC.present(sdkVC, animated: true)
+               sdkWindow.rootViewController = containerVC
+               sdkWindow.windowLevel = .normal + 1  // Above main window
+               sdkWindow.backgroundColor = .clear
+               sdkWindow.isOpaque = false
+               sdkWindow.makeKeyAndVisible()
                
-               resolve(true)
+               print("🟠 SDK window created and made visible")
            } catch {
                print("Presentation failed: \(error.localizedDescription)")
-               reject("PRESENTATION_ERROR", error.localizedDescription, error)
+               let errorData: [String: Any] = [
+                   "data": [
+                       "status": "ERROR",
+                       "message": error.localizedDescription
+                   ]
+               ]
+               self.emitOnResponse(errorData)
            }
        }
     }
     
-  @objc
-  func onResponse(_ callback: @escaping RCTResponseSenderBlock) {
-      onResponseCallback = callback
-  }
-  
-  @objc
-  func onCustomerId(_ callback: @escaping RCTResponseSenderBlock) {
-      onCustomerIdCallback = callback
-  }
-  
-    
-    override static func requiresMainQueueSetup() -> Bool {
+    @objc
+    open override func addListener(_ eventName: String) {
+        super.addListener(eventName)
+        print("🔴 addListener called for: \(eventName)")
+        if !hasListeners {
+            hasListeners = true
+            print("🔴 Set hasListeners = true")
+        }
+    }
+
+    @objc
+    open override func removeListeners(_ count: Double) {
+        super.removeListeners(count)
+        print("🔴 removeListeners called with count: \(count)")
+    }
+
+    @objc
+    public override static func requiresMainQueueSetup() -> Bool {
         return true
     }
+    
+    // Dismiss SDK window when payment completes
+    private func dismissSDKWindow() {
+        print("🟠 Dismissing SDK window...")
+        sdkWindow?.isHidden = true
+        sdkWindow?.rootViewController = nil
+        sdkWindow = nil
+    }
 }

package/lib/module/AmwalPaySDK.js

@@ -61,14 +61,28 @@ class AmwalPaySDK {
   setupEventListeners(config) {
     // Remove any existing listeners
     this.removeEventListeners();
+    console.log('🟢 Setting up event listeners...');
+    console.log('🟢 onResponse callback exists?', typeof config.onResponse === 'function');
+    console.log('🟢 onCustomerId callback exists?', typeof config.onCustomerId === 'function');
     this.onResponseSubscription = onResponse(response => {
+      console.log('🟢 SDK onResponse listener triggered with:', response);
       console.log('Received AmwalPayResponse:', response);
-      config.onResponse(response);
+      if (config.onResponse) {
+        config.onResponse(response);
+      } else {
+        console.error('❌ config.onResponse is not a function!');
+      }
     });
     this.onCustomerIdSubscription = onCustomerId(customerId => {
+      console.log('🟢 SDK onCustomerId listener triggered with:', customerId);
       console.log('Received customerId:', customerId);
-      config.onCustomerId(customerId);
+      if (config.onCustomerId) {
+        config.onCustomerId(customerId);
+      } else {
+        console.error('❌ config.onCustomerId is not a function!');
+      }
     });
+    console.log('🟢 Event listeners set up complete');
   }
 
   /**

package/lib/module/AmwalPaySDK.js.map

@@ -1 +1 @@
-{"version":3,"names":["initiate","onCustomerId","onResponse","NetworkClient","AmwalPaySDK","onResponseSubscription","onCustomerIdSubscription","constructor","getInstance","instance","startPayment","config","setupEventListeners","networkClient","console","log","environment","sessionToken","fetchSessionToken","merchantId","customerId","secureHash","completeConfig","JSON","stringify","error","dispose","removeEventListeners","response","remove"],"sourceRoot":"../../src","sources":["AmwalPaySDK.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,YAAY,EAAEC,UAAU,QAA6B,YAAS;AACjF,OAAOC,aAAa,MAAM,4BAAyB;AAInD,MAAMC,WAAW,CAAC;EAGRC,sBAAsB,GAA6B,IAAI;EAEvDC,wBAAwB,GAA6B,IAAI;EAEzDC,WAAWA,CAAA,EAAG;IACpB;EAAA;EAIF,OAAOC,WAAWA,CAAA,EAAgB;IAChC,IAAI,CAACJ,WAAW,CAACK,QAAQ,EAAE;MACzBL,WAAW,CAACK,QAAQ,GAAG,IAAIL,WAAW,CAAC,CAAC;IAC1C;IACA,OAAOA,WAAW,CAACK,QAAQ;EAC7B;;EAEA;AACF;AACA;AACA;EACE,MAAMC,YAAYA,CAACC,MAA4C,EAAiB;IAC9E,IAAI;MACF;MACA,IAAI,CAACC,mBAAmB,CAACD,MAAM,CAAC;;MAEhC;MACA,MAAME,aAAa,GAAGV,aAAa,CAACK,WAAW,CAAC,CAAC;;MAEjD;MACAM,OAAO,CAACC,GAAG,CAAC,yCAAyC,EAAEJ,MAAM,CAACK,WAAW,CAAC;MAC1E,MAAMC,YAAY,GAAG,MAAMJ,aAAa,CAACK,iBAAiB,CACxDP,MAAM,CAACK,WAAW,EAClBL,MAAM,CAACQ,UAAU,EACjBR,MAAM,CAACS,UAAU,EACjBT,MAAM,CAACU,UACT,CAAC;MAEDP,OAAO,CAACC,GAAG,CAAC,uBAAuB,EAAEE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;MAEzE,IAAI,CAACA,YAAY,EAAE;QACjB;QACA;MACF;;MAEA;MACA,MAAMK,cAA8B,GAAG;QACrC,GAAGX,MAAM;QACTM;MACF,CAAC;;MAED;MACAH,OAAO,CAACC,GAAG,CAAC,wCAAwC,EAAEQ,IAAI,CAACC,SAAS,CAACF,cAAc,CAAC,CAAC;MACrFtB,QAAQ,CAACsB,cAAc,CAAC;IAC1B,CAAC,CAAC,OAAOG,KAAK,EAAE;MACdX,OAAO,CAACW,KAAK,CAAC,yBAAyB,EAAEA,KAAK,CAAC;IACjD;EACF;EAEAC,OAAOA,CAAA,EAAS;IACd;IACA,IAAI,CAACC,oBAAoB,CAAC,CAAC;EAC7B;;EAEA;AACF;AACA;AACA;EACUf,mBAAmBA,CAACD,MAA4C,EAAQ;IAC9E;IACA,IAAI,CAACgB,oBAAoB,CAAC,CAAC;IAE3B,IAAI,CAACtB,sBAAsB,GAAGH,UAAU,CAAE0B,QAAQ,IAAK;MACrDd,OAAO,CAACC,GAAG,CAAC,4BAA4B,EAAEa,QAAQ,CAAC;MACnDjB,MAAM,CAACT,UAAU,CAAC0B,QAAQ,CAAC;IAC7B,CAAC,CAAC;IAEF,IAAI,CAACtB,wBAAwB,GAAGL,YAAY,CAAEmB,UAAU,IAAK;MAC3DN,OAAO,CAACC,GAAG,CAAC,sBAAsB,EAAEK,UAAU,CAAC;MAC/CT,MAAM,CAACV,YAAY,CAACmB,UAAU,CAAC;IACjC,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;EACUO,oBAAoBA,CAAA,EAAS;IACnC,IAAI,CAACtB,sBAAsB,EAAEwB,MAAM,CAAC,CAAC;IACrC,IAAI,CAACvB,wBAAwB,EAAEuB,MAAM,CAAC,CAAC;IACvC,IAAI,CAACxB,sBAAsB,GAAG,IAAI;IAClC,IAAI,CAACC,wBAAwB,GAAG,IAAI;EACtC;AACF;AAEA,eAAeF,WAAW","ignoreList":[]}
+{"version":3,"names":["initiate","onCustomerId","onResponse","NetworkClient","AmwalPaySDK","onResponseSubscription","onCustomerIdSubscription","constructor","getInstance","instance","startPayment","config","setupEventListeners","networkClient","console","log","environment","sessionToken","fetchSessionToken","merchantId","customerId","secureHash","completeConfig","JSON","stringify","error","dispose","removeEventListeners","response","remove"],"sourceRoot":"../../src","sources":["AmwalPaySDK.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/NativeReactAmwalPay.js

@@ -18,7 +18,12 @@ export let TransactionType = /*#__PURE__*/function (TransactionType) {
   return TransactionType;
 }({});
 
-// This interface is for JavaScript side only, not for the native module spec
+/**
+ * Configuration interface for Amwal Pay SDK
+ *
+ * @interface AmwalPayConfig
+ * @description Complete configuration for initializing and starting a payment session
+ */
 
 // This is the configuration that will be passed to the native module
 

package/lib/module/NativeReactAmwalPay.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","Environment","Currency","TransactionType","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactAmwalPay.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAElD,WAAYC,WAAW,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAMvB,WAAYC,QAAQ,0BAARA,QAAQ;EAARA,QAAQ;EAAA,OAARA,QAAQ;AAAA;AAIpB,WAAYC,eAAe,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;;AAY3B;;AAmBA;;AAwBA,eAAeH,mBAAmB,CAACI,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","Environment","Currency","TransactionType","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactAmwalPay.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAElD,WAAYC,WAAW,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAMvB,WAAYC,QAAQ,0BAARA,QAAQ;EAARA,QAAQ;EAAA,OAARA,QAAQ;AAAA;AAIpB,WAAYC,eAAe,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;;AAY3B;AACA;AACA;AACA;AACA;AACA;;AAsDA;;AAwBA,eAAeH,mBAAmB,CAACI,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}

package/lib/typescript/src/AmwalPaySDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AmwalPaySDK.d.ts","sourceRoot":"","sources":["../../../src/AmwalPaySDK.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAKlF,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IAErC,OAAO,CAAC,sBAAsB,CAAkC;IAEhE,OAAO,CAAC,wBAAwB,CAAkC;IAElE,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,WAAW;IAOjC;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/E,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAM7B;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"AmwalPaySDK.d.ts","sourceRoot":"","sources":["../../../src/AmwalPaySDK.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAKlF,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IAErC,OAAO,CAAC,sBAAsB,CAAkC;IAEhE,OAAO,CAAC,wBAAwB,CAAkC;IAElE,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,WAAW;IAOjC;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/E,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAM7B;AAED,eAAe,WAAW,CAAC"}

package/lib/typescript/src/NativeReactAmwalPay.d.ts

@@ -17,23 +17,64 @@ export interface AmwalPayResponse {
     message: string;
     data?: Object;
 }
+/**
+ * Configuration interface for Amwal Pay SDK
+ *
+ * @interface AmwalPayConfig
+ * @description Complete configuration for initializing and starting a payment session
+ */
 export interface AmwalPayConfig {
+    /** Target environment (SIT, UAT, or PROD) */
     environment: Environment;
+    /** Secure hash for authentication */
     secureHash: string;
+    /** Transaction currency */
     currency: Currency;
+    /** Transaction amount as string (e.g., "100.000") */
     amount: string;
+    /** Merchant identifier */
     merchantId: string;
+    /** Terminal identifier */
     terminalId: string;
+    /** Locale for UI language ('en' or 'ar') */
     locale: string;
+    /** Optional customer identifier */
     customerId: string | null;
+    /** Type of transaction (NFC, CARD_WALLET, APPLE_PAY) */
     transactionType: TransactionType;
+    /** Optional session token (auto-fetched if not provided) */
     sessionToken?: string;
+    /** Optional transaction ID (auto-generated if not provided) */
     transactionId?: string;
+    /**
+     * Optional additional configuration values
+     *
+     * Supported keys:
+     * - `useBottomSheetDesign`: 'true' | 'false' - Use bottom sheet design (v2) instead of full screen
+     * - `ignoreReceipt`: 'true' | 'false' - Skip receipt display after transaction
+     * - `primaryColor`: Hex color string (e.g., '#FF5733') - Primary theme color
+     * - `secondaryColor`: Hex color string (e.g., '#33FF57') - Secondary theme color
+     * - `merchantIdentifier`: String - Apple Pay merchant identifier (default: 'merchant.applepay.amwalpay')
+     *
+     * @example
+     * ```typescript
+     * additionValues: {
+     *   useBottomSheetDesign: 'true',
+     *   primaryColor: '#1E88E5',
+     *   secondaryColor: '#FFC107',
+     *   ignoreReceipt: 'false',
+     *   merchantIdentifier: 'merchant.applepay.amwalpay'
+     * }
+     * ```
+     */
     additionValues?: {
         [key: string]: string;
     };
+    /** Optional merchant reference for transaction tracking */
     merchantReference?: string;
+    /** Callback for payment response */
     onResponse: (response: AmwalPayResponse) => void;
+    /** Callback for customer ID updates */
     onCustomerId: (customerId: string) => void;
 }
 export interface AmwalPayNativeConfig {

package/lib/typescript/src/NativeReactAmwalPay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeReactAmwalPay.d.ts","sourceRoot":"","sources":["../../../src/NativeReactAmwalPay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,oBAAY,QAAQ;IAClB,GAAG,QAAQ;CACZ;AAED,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,WAAW,gBAAgB;IAC3B,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjD,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAGD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAuE"}
+{"version":3,"file":"NativeReactAmwalPay.d.ts","sourceRoot":"","sources":["../../../src/NativeReactAmwalPay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,oBAAY,QAAQ;IAClB,GAAG,QAAQ;CACZ;AAED,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,WAAW,gBAAgB;IAC3B,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,WAAW,EAAE,WAAW,CAAC;IACzB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,eAAe,EAAE,eAAe,CAAC;IACjC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC3C,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,UAAU,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjD,uCAAuC;IACvC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAGD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAuE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-amwal-pay",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "amwal pay",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/AmwalPaySDK.ts

@@ -77,15 +77,31 @@ class AmwalPaySDK {
     // Remove any existing listeners
     this.removeEventListeners();
 
+    console.log('🟢 Setting up event listeners...');
+    console.log('🟢 onResponse callback exists?', typeof config.onResponse === 'function');
+    console.log('🟢 onCustomerId callback exists?', typeof config.onCustomerId === 'function');
+
     this.onResponseSubscription = onResponse((response) => {
+      console.log('🟢 SDK onResponse listener triggered with:', response);
       console.log('Received AmwalPayResponse:', response);
-      config.onResponse(response);
+      if (config.onResponse) {
+        config.onResponse(response);
+      } else {
+        console.error('❌ config.onResponse is not a function!');
+      }
     });
 
     this.onCustomerIdSubscription = onCustomerId((customerId) => {
+      console.log('🟢 SDK onCustomerId listener triggered with:', customerId);
       console.log('Received customerId:', customerId);
-      config.onCustomerId(customerId);
+      if (config.onCustomerId) {
+        config.onCustomerId(customerId);
+      } else {
+        console.error('❌ config.onCustomerId is not a function!');
+      }
     });
+
+    console.log('🟢 Event listeners set up complete');
   }
 
   /**

package/src/NativeReactAmwalPay.ts

@@ -4,7 +4,7 @@ import { TurboModuleRegistry } from 'react-native';
 export enum Environment {
   SIT = 'SIT',
   UAT = 'UAT',
-  PROD = 'PROD'
+  PROD = 'PROD',
 }
 
 export enum Currency {
@@ -14,7 +14,7 @@ export enum Currency {
 export enum TransactionType {
   NFC = 'NFC',
   CARD_WALLET = 'CARD_WALLET',
-  APPLE_PAY = 'APPLE_PAY'
+  APPLE_PAY = 'APPLE_PAY',
 }
 
 export interface AmwalPayResponse {
@@ -23,22 +23,62 @@ export interface AmwalPayResponse {
   data?: Object; // Changed from 'any' to 'Object'
 }
 
-// This interface is for JavaScript side only, not for the native module spec
+/**
+ * Configuration interface for Amwal Pay SDK
+ *
+ * @interface AmwalPayConfig
+ * @description Complete configuration for initializing and starting a payment session
+ */
 export interface AmwalPayConfig {
+  /** Target environment (SIT, UAT, or PROD) */
   environment: Environment;
+  /** Secure hash for authentication */
   secureHash: string;
+  /** Transaction currency */
   currency: Currency;
+  /** Transaction amount as string (e.g., "100.000") */
   amount: string;
+  /** Merchant identifier */
   merchantId: string;
+  /** Terminal identifier */
   terminalId: string;
+  /** Locale for UI language ('en' or 'ar') */
   locale: string;
+  /** Optional customer identifier */
   customerId: string | null;
+  /** Type of transaction (NFC, CARD_WALLET, APPLE_PAY) */
   transactionType: TransactionType;
+  /** Optional session token (auto-fetched if not provided) */
   sessionToken?: string;
+  /** Optional transaction ID (auto-generated if not provided) */
   transactionId?: string;
+  /**
+   * Optional additional configuration values
+   *
+   * Supported keys:
+   * - `useBottomSheetDesign`: 'true' | 'false' - Use bottom sheet design (v2) instead of full screen
+   * - `ignoreReceipt`: 'true' | 'false' - Skip receipt display after transaction
+   * - `primaryColor`: Hex color string (e.g., '#FF5733') - Primary theme color
+   * - `secondaryColor`: Hex color string (e.g., '#33FF57') - Secondary theme color
+   * - `merchantIdentifier`: String - Apple Pay merchant identifier (default: 'merchant.applepay.amwalpay')
+   *
+   * @example
+   * ```typescript
+   * additionValues: {
+   *   useBottomSheetDesign: 'true',
+   *   primaryColor: '#1E88E5',
+   *   secondaryColor: '#FFC107',
+   *   ignoreReceipt: 'false',
+   *   merchantIdentifier: 'merchant.applepay.amwalpay'
+   * }
+   * ```
+   */
   additionValues?: { [key: string]: string };
+  /** Optional merchant reference for transaction tracking */
   merchantReference?: string;
+  /** Callback for payment response */
   onResponse: (response: AmwalPayResponse) => void;
+  /** Callback for customer ID updates */
   onCustomerId: (customerId: string) => void;
 }