nimbbl-mobile-react-native-sdk 1.0.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nimbbl Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,374 @@
+# Nimbbl React Native SDK
+
+A comprehensive React Native SDK for integrating Nimbbl payment gateway into your mobile applications. This SDK provides a seamless bridge between React Native and native payment functionality.
+
+## Features
+
+- 🚀 **Easy Integration** - Simple setup and initialization
+- 💳 **Multiple Payment Methods** - Support for cards, UPI, netbanking, wallets, EMI, and cash
+- 🌐 **WebView Integration** - Built-in payment webview with customization options
+- 🔗 **Bridge Module** - Robust native bridge for communication
+- 📱 **Cross Platform** - Support for both iOS and Android
+- 🛡️ **Type Safety** - Comprehensive TypeScript definitions
+- 📊 **Analytics** - Built-in analytics and logging
+- 🔄 **Event Handling** - Real-time payment status updates
+
+## Installation
+
+### Option 1: Install from npm (Recommended for production)
+
+```bash
+npm install nimbbl-mobile-react-native-sdk
+# or
+yarn add nimbbl-mobile-react-native-sdk
+```
+
+
+
+## Compatibility
+
+### NPM Version Support
+
+The Nimbbl React Native SDK is compatible with the following npm versions:
+
+| NPM Version | Support Status | Notes |
+|-------------|----------------|-------|
+| `^1.0.0-alpha.0` | ✅ Supported | Initial alpha release |
+| `^1.0.0-alpha.1` | ✅ Supported | Bug fixes and improvements |
+| `^1.0.0-alpha.2` | ✅ Supported | Enhanced error handling |
+| `^1.0.0-alpha.3` | ✅ Supported | Latest alpha release |
+| `^1.0.0` | 🔄 Coming Soon | Stable release |
+| `^1.1.0` | 🔄 Coming Soon | Feature updates |
+| `^2.0.0` | 🔄 Coming Soon | Major version with breaking changes |
+
+### React Native Version Support
+
+| React Native Version | Support Status | Notes |
+|----------------------|----------------|-------|
+| `^0.70.0` | ✅ Supported | Minimum supported version |
+| `^0.71.0` | ✅ Supported | Recommended version |
+| `^0.72.0` | ✅ Supported | Recommended version |
+| `^0.73.0` | ✅ Supported | Latest stable version |
+| `^0.74.0` | ✅ Supported | Latest stable version |
+| `^0.75.0` | ✅ Supported | Latest stable version |
+| `^0.76.0` | ✅ Supported | Latest stable version |
+
+### Node.js Version Support
+
+| Node.js Version | Support Status | Notes |
+|-----------------|----------------|-------|
+| `^16.0.0` | ✅ Supported | Minimum supported version |
+| `^18.0.0` | ✅ Supported | Recommended version |
+| `^20.0.0` | ✅ Supported | Latest LTS version |
+| `^21.0.0` | ✅ Supported | Latest stable version |
+
+### Platform Support
+
+| Platform | Support Status | Minimum Version |
+|----------|----------------|-----------------|
+| **Android** | ✅ Supported | API Level 21 (Android 5.0) |
+| **iOS** | ✅ Supported | iOS 13.0+ |
+
+### Breaking Changes
+
+- **Alpha Releases**: Alpha versions may contain breaking changes between releases
+- **Stable Releases**: Breaking changes will be clearly documented in release notes
+- **Migration Guide**: Migration guides will be provided for major version updates
+
+### Versioning Strategy
+
+- **Alpha Releases** (`1.0.0-alpha.X`): For testing and early adoption
+- **Beta Releases** (`1.0.0-beta.X`): For feature-complete testing
+- **Release Candidates** (`1.0.0-rc.X`): For final testing before stable release
+- **Stable Releases** (`1.0.0`, `1.1.0`, etc.): For production use
+
+## Quick Start
+
+### Import the SDK
+
+The import statement depends on whether you're using the npm package or local development version:
+
+**For npm package (production use):**
+```javascript
+import { NimbblSDK } from 'nimbbl-mobile-react-native-sdk';
+```
+
+
+
+### 1. Initialize the SDK
+
+```javascript
+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'
+});
+```
+
+
+
+### 2. Process Payment
+
+```javascript
+// Process payment using checkout method (matching iOS pattern)
+const checkoutResult = await nimbblSDK.checkout({
+  orderToken: 'YOUR_ORDER_TOKEN', // Order token received from your server
+  paymentModeCode: '', // Leave empty for all payment modes
+  bankCode: '', // Leave empty for all banks
+  walletCode: '', // Leave empty for all wallets
+  paymentFlow: '' // Leave empty for default flow (or 'phonepe', 'collect', 'intent' for UPI)
+});
+```
+
+### 3. Handle Payment Status
+
+The SDK automatically handles payment status through event listeners. You don't need to manually check status.
+
+## API Reference
+
+### NimbblSDK
+
+The main SDK class that provides all payment functionality.
+
+#### Methods
+
+- `getSharedInstance()` - Get shared SDK instance (singleton pattern)
+- `initialize(config)` - Initialize the SDK with configuration
+- `checkout(options)` - Process payment with order token
+- `testNativeModule()` - Test native module availability
+- `addEventListener(eventName, callback)` - Add event listener
+- `removeEventListener(eventName, callback)` - Remove event listener
+- `removeAllEventListeners()` - Remove all event listeners
+
+### Event Handling
+
+```javascript
+import { NimbblSDK, EVENTS } from 'nimbbl-mobile-react-native-sdk';
+
+const nimbblSDK = NimbblSDK.getSharedInstance();
+
+// Listen for payment events
+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
+});
+```
+
+## Configuration
+
+### SDK Configuration
+
+```javascript
+const config = {
+  environment: 'sandbox', // 'sandbox' or 'production'
+  options: {
+    timeout: 30000,
+    enable_logging: true,
+    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
+
+```javascript
+try {
+  const checkoutResult = await nimbblSDK.checkout({
+    orderToken: 'YOUR_ORDER_TOKEN',
+    paymentModeCode: '',
+    bankCode: '',
+    walletCode: '',
+    paymentFlow: ''
+  });
+} catch (error) {
+  console.error('Error processing payment:', error.message);
+  
+  // Check error codes
+  if (error.code === ERROR_CODES.PAYMENT_FAILED) {
+    // Handle payment failure
+  }
+}
+```
+
+## Platform Setup
+
+### iOS
+
+1. Install pods:
+```bash
+cd ios && pod install
+```
+
+2. Add to your `Info.plist`:
+```xml
+<key>NSAppTransportSecurity</key>
+<dict>
+    <key>NSAllowsArbitraryLoads</key>
+    <true/>
+</dict>
+```
+
+**Note:** The iOS implementation is written in Swift for modern, type-safe development.
+
+### Android
+
+1. Add to your `android/app/build.gradle`:
+```gradle
+android {
+    defaultConfig {
+        minSdkVersion 21
+    }
+}
+```
+
+2. Add to your `android/app/src/main/AndroidManifest.xml`:
+```xml
+<uses-permission android:name="android.permission.INTERNET" />
+```
+
+**Note:** The Android implementation is written in Kotlin for modern, type-safe development.
+
+## Examples
+
+### Complete Payment Flow
+
+```javascript
+import { NimbblSDK, EVENTS } from 'nimbbl-mobile-react-native-sdk';
+
+class PaymentManager {
+  constructor() {
+    this.nimbblSDK = NimbblSDK.getSharedInstance();
+  }
+
+  async initialize() {
+    await this.nimbblSDK.initialize({
+      environment: 'sandbox'
+    });
+  }
+
+  setupEventListeners() {
+    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
+    });
+  }
+
+  async processPayment(orderToken) {
+    try {
+      // Process payment using the order token
+      const result = await this.nimbblSDK.checkout({
+        orderToken: orderToken,
+        paymentModeCode: '',
+        bankCode: '',
+        walletCode: '',
+        paymentFlow: ''
+      });
+      
+      return { success: true, result };
+    } catch (error) {
+      return { success: false, error: error.message };
+    }
+  }
+}
+```
+
+
+
+
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Support
+
+For support, email support@nimbbl.biz or join our Slack channel.
+
+## Version Migration
+
+### Upgrading Between Alpha Versions
+
+When upgrading between alpha versions, check the changelog for breaking changes:
+
+```bash
+# Check current version
+npm list nimbbl-mobile-react-native-sdk
+
+# Upgrade to latest alpha
+npm install nimbbl-mobile-react-native-sdk@latest
+
+# Or upgrade to specific version
+npm install nimbbl-mobile-react-native-sdk@1.0.0-alpha.3
+```
+
+### Migration from Alpha to Stable
+
+When the stable version is released:
+
+```bash
+# Upgrade from alpha to stable
+npm install nimbbl-mobile-react-native-sdk@^1.0.0
+
+# Update your package.json
+# Change from: "nimbbl-mobile-react-native-sdk": "^1.0.0-alpha.3"
+# To: "nimbbl-mobile-react-native-sdk": "^1.0.0"
+```
+
+### Breaking Changes Migration
+
+For major version updates (e.g., 1.x to 2.x):
+
+1. Check the migration guide in the release notes
+2. Update your code according to the breaking changes
+3. Test thoroughly before deploying to production
+
+### Version Locking
+
+For production applications, consider locking to specific versions:
+
+```json
+{
+  "dependencies": {
+    "nimbbl-mobile-react-native-sdk": "1.0.0-alpha.3"
+  }
+}
+```
+
+### Deprecation Policy
+
+- **Alpha versions**: Features may be deprecated without notice
+- **Stable versions**: Deprecated features will be marked with warnings for at least one minor version
+- **Major versions**: Breaking changes will be clearly documented
+
+## Changelog
+
+*This section will be updated with future releases.*

package/android/build.gradle

@@ -0,0 +1,86 @@
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.1.0'
+        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'org.jetbrains.kotlin.android'
+apply plugin: 'maven-publish'
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+        maven { url 'https://jitpack.io' }
+        maven { url 'https://oss.sonatype.org/content/repositories/snapshots/' }
+        maven { url "$rootDir/../node_modules/react-native/android" }
+    }
+}
+
+group = 'com.nimbbl.reactnative'
+version = '1.0.0'
+
+android {
+    namespace 'com.nimbbl.reactnative'
+    compileSdkVersion 36
+    buildToolsVersion "36.0.0"
+
+    defaultConfig {
+        minSdkVersion 24
+        targetSdkVersion 36
+        versionCode 1
+        versionName "1.0.0"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+    
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+
+    lintOptions {
+        abortOnError false
+    }
+}
+
+dependencies {
+    // React Native dependencies (required for bridge)
+    compileOnly 'com.facebook.react:react-native:+'
+    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'
+    
+    // Add Retrofit and Coroutines dependencies for Android SDK
+    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4'
+}
+
+afterEvaluate {
+    publishing {
+        publications {
+            release(MavenPublication) {
+                from components.release
+                groupId = 'com.nimbbl.reactnative'
+                artifactId = 'nimbbl-react-native-sdk'
+                version = '1.0.0'
+            }
+        }
+    }
+}

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+#Tue Aug 05 20:11:30 IST 2025
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/android/gradle.properties

@@ -0,0 +1,4 @@
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+android.useAndroidX=true
+android.enableJetifier=true
+android.suppressUnsupportedCompileSdk=36

package/android/gradlew

@@ -0,0 +1,185 @@
+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=`expr $i + 1`
+    done
+    case $i in
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=`save "$@"`
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"