nimbbl-mobile-react-native-sdk 1.1.1 → 1.2.0

package/README.md

@@ -23,6 +23,14 @@ npm install nimbbl-mobile-react-native-sdk
 yarn add nimbbl-mobile-react-native-sdk
 ```
 
+## Development Setup
+
+For SDK developers and contributors:
+
+- **[BUILD.md](BUILD.md)** - Quick build and run guide
+- **[SETUP.md](SETUP.md)** - Comprehensive development setup
+- **[Sample App](../nimbbl_react_native_sample_app/)** - Complete working example
+
 
 
 ## Compatibility
@@ -38,8 +46,11 @@ The Nimbbl React Native SDK is compatible with the following npm versions:
 | `^1.0.0-alpha.2` | ✅ Supported | Enhanced error handling |
 | `^1.0.0-alpha.3` | ✅ Supported | Enhanced error handling |
 | `^1.0.0-alpha.12` | ✅ Supported | Latest alpha release |
-| `^1.0.0` | ✅ **Current Stable** | **Production ready** |
-| `^1.1.0` | 🔄 Coming Soon | Feature updates |
+| `^1.0.0` | ✅ Supported | Initial stable release |
+| `^1.0.1` | ✅ Supported | Bug fixes and improvements |
+| `^1.1.0` | ✅ Supported | Production ready with environment URL initialization |
+| `^1.1.1` | ✅ Supported | Bug fixes and improvements |
+| `^1.2.0` | ✅ **Latest Stable** | **Updated to latest native SDK versions** |
 | `^2.0.0` | 🔄 Coming Soon | Major version with breaking changes |
 
 ### React Native Version Support
@@ -104,9 +115,7 @@ import { NimbblSDK } from 'nimbbl-mobile-react-native-sdk';
 const nimbblSDK = NimbblSDK.getSharedInstance();
 
 // Initialize the SDK (no credentials required - matches iOS pattern)
-await nimbblSDK.initialize({
-  environment: 'sandbox' // or 'production'
-});
+await nimbblSDK.initialize();
 ```
 
 
@@ -114,7 +123,7 @@ await nimbblSDK.initialize({
 ### 2. Process Payment
 
 ```javascript
-// Process payment using checkout method (matching iOS pattern)
+// Process payment using checkout method
 const checkoutResult = await nimbblSDK.checkout({
   orderToken: 'YOUR_ORDER_TOKEN', // Order token received from your server
   paymentModeCode: '', // Leave empty for all payment modes
@@ -137,40 +146,36 @@ The main SDK class that provides all payment functionality.
 #### Methods
 
 - `getSharedInstance()` - Get shared SDK instance (singleton pattern)
-- `initialize(config)` - Initialize the SDK with configuration and auto-setup event listeners
+- `initialize()` - Initialize the SDK with default configuration
 - `checkout(options)` - Process payment with order token
-- `testNativeModule()` - Test native module availability
-- `addEventListener(eventName, callback)` - Add event listener (SDK manages lifecycle automatically)
-- `removeEventListener(eventName, callback)` - Remove event listener
-- `removeAllEventListeners()` - Remove all event listeners
+- `addCheckoutResponseListener(callback)` - Add unified checkout response listener (recommended)
+- `removeCheckoutResponseListener(callback)` - Remove checkout response listener
 
 ### Event Handling
 
-The SDK automatically manages event listeners for optimal performance. Event listeners are automatically set up during initialization and cleaned up when needed.
+The SDK uses a unified event handling approach for payment responses:
 
 ```javascript
-import { NimbblSDK, EVENTS } from 'nimbbl-mobile-react-native-sdk';
+import { NimbblSDK } from 'nimbbl-mobile-react-native-sdk';
 
 const nimbblSDK = NimbblSDK.getSharedInstance();
 
-// Initialize SDK (automatically sets up event listeners)
-await nimbblSDK.initialize({
-  environment: 'sandbox'
-});
-
-// Listen for payment events (SDK manages listener lifecycle)
-nimbblSDK.addEventListener(EVENTS.PAYMENT_SUCCESS, (data) => {
-  console.log('Payment successful:', data);
-  // Handle success - navigate to success screen
-});
-
-nimbblSDK.addEventListener(EVENTS.PAYMENT_FAILED, (data) => {
-  console.log('Payment failed:', data);
-  // Handle failure - show error message
+// Initialize SDK
+await nimbblSDK.initialize();
+
+// Use unified checkout response listener
+nimbblSDK.addCheckoutResponseListener((data) => {
+  if (data.status === 'success') {
+    // Handle successful payment
+    // Handle success - navigate to success screen
+  } else {
+    // Handle failed payment
+    // Handle failure - show error message
+  }
 });
 
-// Optional: Clean up listeners when done (SDK also handles this automatically)
-// nimbblSDK.removeAllEventListeners();
+// Optional: Clean up listeners when done
+// nimbblSDK.removeCheckoutResponseListener(callback);
 ```
 
 ## Configuration
@@ -179,30 +184,16 @@ nimbblSDK.addEventListener(EVENTS.PAYMENT_FAILED, (data) => {
 
 ```javascript
 const config = {
-  environment: 'sandbox', // 'sandbox' or 'production'
+  environment: 'production', // 'production' (default) or 'sandbox'
   options: {
     timeout: 30000,
-    enable_logging: true,
+    enable_logging: false,
     enable_analytics: true,
     api_base_url: 'https://api.nimbbl.tech/' // Optional: override default URL
   }
 };
 ```
 
-## Constants
-
-The SDK provides various constants for better development experience:
-
-```javascript
-import {
-  EVENTS,
-  ENVIRONMENTS,
-  ERROR_CODES,
-  ERROR_MESSAGES,
-  DEFAULT_CONFIG,
-  SDK_VERSION
-} from 'nimbbl-mobile-react-native-sdk';
-```
 
 ## Error Handling
 
@@ -216,7 +207,7 @@ try {
     paymentFlow: ''
   });
 } catch (error) {
-  console.error('Error processing payment:', error.message);
+  // Handle payment error
   
   // Check error codes
   if (error.code === ERROR_CODES.PAYMENT_FAILED) {
@@ -276,22 +267,19 @@ class PaymentManager {
   }
 
   async initialize() {
-    await this.nimbblSDK.initialize({
-      environment: 'sandbox'
-    });
+    await this.nimbblSDK.initialize();
   }
 
   setupEventListeners() {
-    // Event listeners are automatically managed by the SDK
-    // You can add custom listeners for your app's specific needs
-    this.nimbblSDK.addEventListener(EVENTS.PAYMENT_SUCCESS, (data) => {
-      console.log('Payment successful:', data);
-      // Navigate to success screen
-    });
-
-    this.nimbblSDK.addEventListener(EVENTS.PAYMENT_FAILED, (data) => {
-      console.log('Payment failed:', data);
-      // Show error message
+    // Use unified checkout response listener
+    this.nimbblSDK.addCheckoutResponseListener((data) => {
+      if (data.status === 'success') {
+        // Handle successful payment
+        // Navigate to success screen
+      } else {
+        // Handle failed payment
+        // Show error message
+      }
     });
   }
 
@@ -383,12 +371,10 @@ For debugging purposes, you can check the SDK initialization status and handle e
 const nimbblSDK = NimbblSDK.getSharedInstance();
 
 try {
-  await nimbblSDK.initialize({
-    environment: 'sandbox'
-  });
-  console.log('SDK initialized successfully');
+  await nimbblSDK.initialize();
+  // SDK initialized successfully
 } catch (error) {
-  console.error('SDK initialization failed:', error);
+  // Handle initialization error
 }
 ```
 
@@ -459,7 +445,7 @@ For production applications, consider locking to specific versions:
 ```json
 {
   "dependencies": {
-    "nimbbl-mobile-react-native-sdk": "1.0.0-alpha.3"
+    "nimbbl-mobile-react-native-sdk": "1.1.1"
   }
 }
 ```
@@ -472,7 +458,57 @@ For production applications, consider locking to specific versions:
 
 ## Changelog
 
-### v1.0.0 (Current Stable Release)
+### v1.2.0 (Latest Stable Release)
+
+**🚀 Updated to Latest Native SDK Versions!**
+
+#### ✨ New Features
+- **Latest iOS SDK**: Updated to `nimbbl_mobile_kit_ios_webview_sdk: ~> 2.0.4`
+- **Latest Android SDK**: Updated to `nimbbl_mobile_kit_android_webview_sdk: v4.0.3`
+- **Enhanced Compatibility**: Full compatibility with latest native SDK features
+- **Unified Event Handling**: New `addCheckoutResponseListener()` method for simplified event handling
+- **Clean API**: Removed legacy `payment_success` and `payment_failed` events for cleaner codebase
+- **iOS-Android Parity**: Complete feature parity between iOS and Android modules
+- **Callback Support**: Direct callback support for better production reliability
+
+#### 🔧 Improvements
+- **Better Performance**: Leverages latest optimizations from native SDKs
+- **Enhanced Security**: Includes latest security updates from native SDKs
+- **Improved Stability**: Bug fixes and stability improvements from native SDKs
+- **Future-Ready**: Prepared for upcoming native SDK features
+- **Cross-Platform Consistency**: iOS and Android modules now have identical APIs
+- **Production Ready**: Enhanced callback system for production environments
+
+#### 🐛 Bug Fixes
+- Resolved compatibility issues with older native SDK versions
+- Fixed potential memory leaks in native bridge communication
+- Improved error handling for edge cases
+- Fixed iOS `setCheckoutCallback is not a function` error
+- Resolved method signature conflicts in iOS native module
+- Enhanced callback-based communication for better reliability
+
+### v1.1.1
+
+**🚀 Production Ready with Enhanced Features!**
+
+#### ✨ New Features
+- **Production Default**: SDK now defaults to production environment instead of sandbox
+- **Automatic Event Listener Management**: SDK automatically manages event listeners for optimal performance
+
+#### 🔧 Improvements
+- **Simplified Integration**: No need to manually manage event listeners
+- **Enhanced Error Handling**: Improved error messages and debugging capabilities
+- **Performance Optimization**: Better memory management and event handling
+- **TypeScript Support**: Comprehensive type definitions for better development experience
+
+#### 🐛 Bug Fixes
+- Resolved event listener memory leaks
+- Fixed iOS native module integration issues
+- Improved error handling for network failures
+
+---
+
+### v1.0.0 (Stable Release)
 
 **🎉 First Stable Release - Production Ready!**
 

package/android/build.gradle

@@ -24,7 +24,7 @@ allprojects {
 }
 
 group = 'com.nimbbl.reactnative'
-version = '1.0.0'
+version = '1.2.0'
 
 android {
     namespace 'com.nimbbl.reactnative'
@@ -35,7 +35,7 @@ android {
         minSdkVersion 24
         targetSdkVersion 36
         versionCode 1
-        versionName "1.0.0"
+        versionName "1.2.0"
     }
 
     buildTypes {
@@ -65,7 +65,7 @@ dependencies {
     implementation 'androidx.appcompat:appcompat:1.6.1'
     
     // Nimbbl WebView SDK dependency (includes all necessary dependencies)
-    implementation 'com.github.nimbbl-tech:nimbbl_mobile_kit_android_webview_sdk:3.0.12'
+    implementation 'org.bitbucket.nimbbl-tech:nimbbl_mobile_kit_android_webview_sdk:v4.0.3'
     
     // Add Retrofit and Coroutines dependencies for Android SDK
     implementation 'com.squareup.retrofit2:retrofit:2.9.0'
@@ -79,7 +79,7 @@ afterEvaluate {
                 from components.release
                 groupId = 'com.nimbbl.reactnative'
                 artifactId = 'nimbbl-react-native-sdk'
-                version = '1.0.0'
+                version = '1.2.0'
             }
         }
     }

package/android/src/main/java/com/nimbbl/reactnative/NimbblCheckoutActivity.kt

@@ -3,16 +3,10 @@ package com.nimbbl.reactnative
 import android.app.Activity
 import android.content.Intent
 import android.os.Bundle
-import android.util.Log
-import android.widget.TextView
-import android.view.ViewGroup
-import android.widget.LinearLayout
-import android.graphics.Color
 import tech.nimbbl.webviewsdk.core.NimbblCheckoutSDK
 import tech.nimbbl.webviewsdk.models.NimbblCheckoutOptions
 import tech.nimbbl.webviewsdk.models.interfaces.NimbblCheckoutPaymentListener
-import com.facebook.react.bridge.Arguments
-import com.facebook.react.modules.core.DeviceEventManagerModule
+import org.json.JSONObject
 
 class NimbblCheckoutActivity : Activity(), NimbblCheckoutPaymentListener {
     
@@ -32,9 +26,6 @@ class NimbblCheckoutActivity : Activity(), NimbblCheckoutPaymentListener {
             walletCode: String = "",
             paymentFlow: String = ""
         ) {
-            Log.d(TAG, "startCheckout method called with orderToken: $orderToken")
-            println("startCheckout method called with orderToken: $orderToken")
-            
             val intent = Intent(activity, NimbblCheckoutActivity::class.java).apply {
                 putExtra(EXTRA_ORDER_TOKEN, orderToken)
                 putExtra(EXTRA_PAYMENT_MODE_CODE, paymentModeCode)
@@ -43,43 +34,13 @@ class NimbblCheckoutActivity : Activity(), NimbblCheckoutPaymentListener {
                 putExtra(EXTRA_PAYMENT_FLOW, paymentFlow)
             }
             
-            Log.d(TAG, "Intent created, starting activity...")
-            println("Intent created, starting activity...")
             activity.startActivity(intent)
-            Log.d(TAG, "Activity startActivity() called")
-            println("Activity startActivity() called")
         }
     }
     
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         
-        Log.d(TAG, "NimbblCheckoutActivity created")
-        println("NimbblCheckoutActivity onCreate called")
-        
-        // Create a simple UI to show the activity is launching
-        val layout = LinearLayout(this).apply {
-            orientation = LinearLayout.VERTICAL
-            layoutParams = ViewGroup.LayoutParams(
-                ViewGroup.LayoutParams.MATCH_PARENT,
-                ViewGroup.LayoutParams.MATCH_PARENT
-            )
-            setBackgroundColor(Color.WHITE)
-        }
-        
-        val textView = TextView(this).apply {
-            text = "NimbblCheckoutActivity is loading...\nOrder Token: ${intent.getStringExtra(EXTRA_ORDER_TOKEN)}"
-            textSize = 16f
-            setTextColor(Color.BLACK)
-            setPadding(50, 100, 50, 50)
-        }
-        
-        layout.addView(textView)
-        setContentView(layout)
-        
-        Log.d(TAG, "Simple UI set up")
-        println("Simple UI set up")
-        
         try {
             // Get the checkout options from intent
             val orderToken = intent.getStringExtra(EXTRA_ORDER_TOKEN)
@@ -88,25 +49,12 @@ class NimbblCheckoutActivity : Activity(), NimbblCheckoutPaymentListener {
             val walletCode = intent.getStringExtra(EXTRA_WALLET_CODE) ?: ""
             val paymentFlow = intent.getStringExtra(EXTRA_PAYMENT_FLOW) ?: ""
             
-            Log.d(TAG, "Received order token: $orderToken")
-            Log.d(TAG, "Received payment mode code: $paymentModeCode")
-            Log.d(TAG, "Received bank code: $bankCode")
-            Log.d(TAG, "Received wallet code: $walletCode")
-            Log.d(TAG, "Received payment flow: $paymentFlow")
             
             if (orderToken.isNullOrEmpty()) {
-                Log.e(TAG, "Order token is required")
                 finish()
                 return
             }
             
-            Log.d(TAG, "Starting checkout with order token: $orderToken")
-            println("Starting checkout with order token: $orderToken")
-            
-            // Use direct method calls instead of reflection
-            Log.d(TAG, "Using direct Android SDK calls...")
-            println("Using direct Android SDK calls...")
-            
             try {
                 // Create checkout options first (matching native sample app pattern)
                 val checkoutOptions = NimbblCheckoutOptions.Builder()
@@ -117,108 +65,104 @@ class NimbblCheckoutActivity : Activity(), NimbblCheckoutPaymentListener {
                     .setWalletCode(walletCode)
                     .build()
                 
-                Log.d(TAG, "Checkout options created successfully")
-                println("Checkout options created successfully")
-                
                 // Initialize SDK and call checkout (matching native sample app pattern)
-                Log.d(TAG, "About to init SDK and call checkout...")
-                println("About to init SDK and call checkout...")
-                
-                NimbblCheckoutSDK.instance?.init(this)
-                NimbblCheckoutSDK.instance?.checkout(checkoutOptions)
-                
-                Log.d(TAG, "NimbblCheckoutSDK init and checkout called successfully")
-                println("NimbblCheckoutSDK init and checkout called successfully")
-                
-                Log.d(TAG, "Webview should appear now...")
-                println("Webview should appear now...")
+                NimbblCheckoutSDK.getInstance().init(this)
+                NimbblCheckoutSDK.getInstance().checkout(checkoutOptions)
                 
             } catch (e: Exception) {
-                Log.e(TAG, "Error calling Android SDK: ${e.message}", e)
-                println("Error calling Android SDK: ${e.message}")
-                e.printStackTrace()
                 finish()
             }
             
         } catch (e: Exception) {
-            Log.e(TAG, "Error in onCreate: ${e.message}", e)
-            println("Error in onCreate: ${e.message}")
-            e.printStackTrace()
             finish()
         }
     }
     
 
 
-    override fun onPaymentSuccess(data: MutableMap<String, Any>) {
+    override fun onCheckoutResponse(data: MutableMap<String, Any>) {
+        
+        // Convert the data to proper JSON format
+        val jsonData = try {
+            val jsonObject = JSONObject()
+            data.forEach { (key, value) ->
+                when (value) {
+                    is String -> {
+                        // Replace "null" string with empty string
+                        val cleanValue = if (value == "null") "" else value
+                        jsonObject.put(key, cleanValue)
+                    }
+                    is Number -> jsonObject.put(key, value)
+                    is Boolean -> jsonObject.put(key, value)
+                    is Map<*, *> -> {
+                        val nestedJson = JSONObject()
+                        (value as Map<String, Any>).forEach { (nestedKey, nestedValue) ->
+                            when (nestedValue) {
+                                is String -> {
+                                    // Replace "null" string with empty string
+                                    val cleanValue = if (nestedValue == "null") "" else nestedValue
+                                    nestedJson.put(nestedKey, cleanValue)
+                                }
+                                is Number -> nestedJson.put(nestedKey, nestedValue)
+                                is Boolean -> nestedJson.put(nestedKey, nestedValue)
+                                else -> {
+                                    val cleanValue = if (nestedValue.toString() == "null") "" else nestedValue.toString()
+                                    nestedJson.put(nestedKey, cleanValue)
+                                }
+                            }
+                        }
+                        jsonObject.put(key, nestedJson)
+                    }
+                    else -> {
+                        val cleanValue = if (value.toString() == "null") "" else value.toString()
+                        jsonObject.put(key, cleanValue)
+                    }
+                }
+            }
+            jsonObject.toString()
+        } catch (e: Exception) {
+            data.toString() // Fallback to original format
+        }
+        
         // Set result for the calling activity (NimbblReactNativeSDKModule)
         val intent = Intent().apply {
-            putExtra("status", "success")
+            putExtra("status", data["status"]?.toString() ?: "failed")
             putExtra("order_id", data["order_id"]?.toString() ?: "")
             putExtra("payment_id", data["payment_id"]?.toString() ?: "")
-            putExtra("response", data.toString())
+            putExtra("response", jsonData)
         }
-        setResult(Activity.RESULT_OK, intent)
         
-        finish()
-    }
-
-    override fun onPaymentFailed(data: String) {
-        // Set result for the calling activity (NimbblReactNativeSDKModule)
-        val intent = Intent().apply {
-            putExtra("status", "failed")
-            putExtra("response", data)
-        }
-        setResult(Activity.RESULT_CANCELED, intent)
+        setResult(Activity.RESULT_OK, intent)
         
         finish()
     }
     
+    
     override fun onBackPressed() {
-        Log.d(TAG, "Back pressed - blocked to prevent accidental cancellation")
-        println("Back pressed - blocked to prevent accidental cancellation")
-        
         // Block the back button completely
         // The WebView should handle its own back navigation internally
         // Only success and failure events should be sent to the sample app
     }
     
-    override fun onPause() {
-        super.onPause()
-        Log.d(TAG, "onPause called - cleaning up resources")
-        println("onPause called - cleaning up resources")
-        
-        // Clean up any resources that might be causing leaks
-        try {
-            // The NimbblCheckoutSDK should handle its own cleanup
-            // but we can add additional cleanup here if needed
-        } catch (e: Exception) {
-            Log.e(TAG, "Error during onPause cleanup", e)
-        }
-    }
-    
     override fun onDestroy() {
         super.onDestroy()
-        Log.d(TAG, "onDestroy called - final cleanup")
-        println("onDestroy called - final cleanup")
         
         // Final cleanup to prevent memory leaks
         try {
             // Call cleanup on NimbblCheckoutSDK to properly unregister broadcast receivers
-            NimbblCheckoutSDK.instance?.let { sdk ->
+            NimbblCheckoutSDK.getInstance().let { sdk ->
                 try {
                     // Try to call any cleanup method if available
                     val cleanupMethod = sdk.javaClass.getMethod("cleanup")
                     cleanupMethod.invoke(sdk)
-                    Log.d(TAG, "NimbblCheckoutSDK cleanup called successfully")
                 } catch (e: NoSuchMethodException) {
-                    Log.d(TAG, "NimbblCheckoutSDK cleanup method not found, skipping")
+                    // Cleanup method not found, skipping
                 } catch (e: Exception) {
-                    Log.e(TAG, "Error calling NimbblCheckoutSDK cleanup", e)
+                    // Error calling cleanup, ignore
                 }
             }
         } catch (e: Exception) {
-            Log.e(TAG, "Error during onDestroy cleanup", e)
+            // Error during cleanup, ignore
         }
     }
 }