@gmisoftware/react-native-pay 0.0.4

package/lib/utils/paymentHelpers.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Utility functions for payment operations
+ *
+ * This module provides helper functions for creating and formatting
+ * payment requests and related data structures.
+ *
+ * @module paymentHelpers
+ *
+ * @example
+ * ```typescript
+ * import { createPaymentRequest, calculateTotal } from 'react-native-pay'
+ *
+ * const request = createPaymentRequest({
+ *   merchantIdentifier: 'merchant.com.example',
+ *   amount: 29.99,
+ *   label: 'Coffee Subscription'
+ * })
+ * ```
+ */
+import type { PaymentItem, PaymentRequest, PaymentNetwork } from '../types';
+/**
+ * Payment networks supported by both Apple Pay and Google Pay
+ */
+export declare const CommonNetworks: {
+    readonly VISA: "visa";
+    readonly MASTERCARD: "mastercard";
+    readonly AMEX: "amex";
+    readonly DISCOVER: "discover";
+};
+/**
+ * Creates a payment item with the specified label, amount, and type.
+ *
+ * @param label - Display label for the payment item
+ * @param amount - Amount in the payment currency
+ * @param type - Item type: 'final' for confirmed amounts, 'pending' for estimates
+ * @returns A PaymentItem object
+ *
+ * @example
+ * ```typescript
+ * const item = createPaymentItem('Subscription', 29.99, 'final')
+ * const shipping = createPaymentItem('Shipping', 5.00, 'pending')
+ * ```
+ */
+export declare function createPaymentItem(label: string, amount: number, type?: 'final' | 'pending'): PaymentItem;
+/**
+ * Calculates the total amount from an array of payment items.
+ *
+ * @param items - Array of payment items to sum
+ * @returns Total amount
+ *
+ * @example
+ * ```typescript
+ * const items = [
+ *   createPaymentItem('Product', 29.99),
+ *   createPaymentItem('Tax', 2.40)
+ * ]
+ * const total = calculateTotal(items) // 32.39
+ * ```
+ */
+export declare function calculateTotal(items: PaymentItem[]): number;
+/**
+ * Creates a payment request with sensible defaults.
+ *
+ * Default values:
+ * - countryCode: 'US'
+ * - currencyCode: 'USD'
+ * - supportedNetworks: ['visa', 'mastercard', 'amex', 'discover']
+ * - merchantCapabilities: ['3DS']
+ *
+ * @param options - Payment request options (merchantIdentifier, amount, label required)
+ * @returns Complete PaymentRequest object
+ *
+ * @example
+ * ```typescript
+ * const request = createPaymentRequest({
+ *   merchantIdentifier: 'merchant.com.example',
+ *   amount: 29.99,
+ *   label: 'Coffee Subscription',
+ *   countryCode: 'CA', // override default
+ *   currencyCode: 'CAD' // override default
+ * })
+ * ```
+ */
+export declare function createPaymentRequest(options: Partial<PaymentRequest> & {
+    merchantIdentifier: string;
+    amount: number;
+    label: string;
+}): PaymentRequest;
+/**
+ * Formats an amount to 2 decimal places.
+ *
+ * @param amount - Numeric amount to format
+ * @returns Formatted amount string
+ *
+ * @example
+ * ```typescript
+ * formatAmount(29.9) // "29.90"
+ * formatAmount(100) // "100.00"
+ * ```
+ */
+export declare function formatAmount(amount: number): string;
+/**
+ * Parses an amount string to a number.
+ *
+ * @param amountString - String representation of amount
+ * @returns Parsed numeric amount
+ *
+ * @example
+ * ```typescript
+ * parseAmount("29.99") // 29.99
+ * parseAmount("100") // 100
+ * ```
+ */
+export declare function parseAmount(amountString: string): number;
+/**
+ * Checks if a payment network is supported.
+ * Case-insensitive comparison.
+ *
+ * @param network - Network to check
+ * @param supportedNetworks - Array of supported networks
+ * @returns True if network is supported
+ *
+ * @example
+ * ```typescript
+ * isNetworkSupported('visa', ['visa', 'mastercard']) // true
+ * isNetworkSupported('AMEX', ['visa', 'amex']) // true
+ * isNetworkSupported('discover', ['visa', 'mastercard']) // false
+ * ```
+ */
+export declare function isNetworkSupported(network: string, supportedNetworks: string[]): boolean;
+/**
+ * Formats a payment network identifier for human-readable display.
+ *
+ * @param network - Payment network identifier
+ * @returns Formatted network name
+ *
+ * @example
+ * ```typescript
+ * formatNetworkName('visa') // "Visa"
+ * formatNetworkName('amex') // "American Express"
+ * formatNetworkName('mastercard') // "Mastercard"
+ * ```
+ */
+export declare function formatNetworkName(network: PaymentNetwork): string;

package/lib/utils/paymentHelpers.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Utility functions for payment operations
+ *
+ * This module provides helper functions for creating and formatting
+ * payment requests and related data structures.
+ *
+ * @module paymentHelpers
+ *
+ * @example
+ * ```typescript
+ * import { createPaymentRequest, calculateTotal } from 'react-native-pay'
+ *
+ * const request = createPaymentRequest({
+ *   merchantIdentifier: 'merchant.com.example',
+ *   amount: 29.99,
+ *   label: 'Coffee Subscription'
+ * })
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonNetworks = void 0;
+exports.createPaymentItem = createPaymentItem;
+exports.calculateTotal = calculateTotal;
+exports.createPaymentRequest = createPaymentRequest;
+exports.formatAmount = formatAmount;
+exports.parseAmount = parseAmount;
+exports.isNetworkSupported = isNetworkSupported;
+exports.formatNetworkName = formatNetworkName;
+/**
+ * Payment networks supported by both Apple Pay and Google Pay
+ */
+exports.CommonNetworks = {
+    VISA: 'visa',
+    MASTERCARD: 'mastercard',
+    AMEX: 'amex',
+    DISCOVER: 'discover',
+};
+/**
+ * Creates a payment item with the specified label, amount, and type.
+ *
+ * @param label - Display label for the payment item
+ * @param amount - Amount in the payment currency
+ * @param type - Item type: 'final' for confirmed amounts, 'pending' for estimates
+ * @returns A PaymentItem object
+ *
+ * @example
+ * ```typescript
+ * const item = createPaymentItem('Subscription', 29.99, 'final')
+ * const shipping = createPaymentItem('Shipping', 5.00, 'pending')
+ * ```
+ */
+function createPaymentItem(label, amount, type = 'final') {
+    return { label, amount, type };
+}
+/**
+ * Calculates the total amount from an array of payment items.
+ *
+ * @param items - Array of payment items to sum
+ * @returns Total amount
+ *
+ * @example
+ * ```typescript
+ * const items = [
+ *   createPaymentItem('Product', 29.99),
+ *   createPaymentItem('Tax', 2.40)
+ * ]
+ * const total = calculateTotal(items) // 32.39
+ * ```
+ */
+function calculateTotal(items) {
+    return items.reduce((sum, item) => sum + item.amount, 0);
+}
+/**
+ * Creates a payment request with sensible defaults.
+ *
+ * Default values:
+ * - countryCode: 'US'
+ * - currencyCode: 'USD'
+ * - supportedNetworks: ['visa', 'mastercard', 'amex', 'discover']
+ * - merchantCapabilities: ['3DS']
+ *
+ * @param options - Payment request options (merchantIdentifier, amount, label required)
+ * @returns Complete PaymentRequest object
+ *
+ * @example
+ * ```typescript
+ * const request = createPaymentRequest({
+ *   merchantIdentifier: 'merchant.com.example',
+ *   amount: 29.99,
+ *   label: 'Coffee Subscription',
+ *   countryCode: 'CA', // override default
+ *   currencyCode: 'CAD' // override default
+ * })
+ * ```
+ */
+function createPaymentRequest(options) {
+    const { merchantIdentifier, amount, label, countryCode = 'US', currencyCode = 'USD', supportedNetworks = [
+        exports.CommonNetworks.VISA,
+        exports.CommonNetworks.MASTERCARD,
+        exports.CommonNetworks.AMEX,
+        exports.CommonNetworks.DISCOVER,
+    ], merchantCapabilities = ['3DS'], ...rest } = options;
+    return {
+        merchantIdentifier,
+        countryCode,
+        currencyCode,
+        paymentItems: [createPaymentItem(label, amount, 'final')],
+        supportedNetworks,
+        merchantCapabilities,
+        ...rest,
+    };
+}
+/**
+ * Formats an amount to 2 decimal places.
+ *
+ * @param amount - Numeric amount to format
+ * @returns Formatted amount string
+ *
+ * @example
+ * ```typescript
+ * formatAmount(29.9) // "29.90"
+ * formatAmount(100) // "100.00"
+ * ```
+ */
+function formatAmount(amount) {
+    return amount.toFixed(2);
+}
+/**
+ * Parses an amount string to a number.
+ *
+ * @param amountString - String representation of amount
+ * @returns Parsed numeric amount
+ *
+ * @example
+ * ```typescript
+ * parseAmount("29.99") // 29.99
+ * parseAmount("100") // 100
+ * ```
+ */
+function parseAmount(amountString) {
+    return parseFloat(amountString);
+}
+/**
+ * Checks if a payment network is supported.
+ * Case-insensitive comparison.
+ *
+ * @param network - Network to check
+ * @param supportedNetworks - Array of supported networks
+ * @returns True if network is supported
+ *
+ * @example
+ * ```typescript
+ * isNetworkSupported('visa', ['visa', 'mastercard']) // true
+ * isNetworkSupported('AMEX', ['visa', 'amex']) // true
+ * isNetworkSupported('discover', ['visa', 'mastercard']) // false
+ * ```
+ */
+function isNetworkSupported(network, supportedNetworks) {
+    return supportedNetworks.some((supported) => supported.toLowerCase() === network.toLowerCase());
+}
+/**
+ * Formats a payment network identifier for human-readable display.
+ *
+ * @param network - Payment network identifier
+ * @returns Formatted network name
+ *
+ * @example
+ * ```typescript
+ * formatNetworkName('visa') // "Visa"
+ * formatNetworkName('amex') // "American Express"
+ * formatNetworkName('mastercard') // "Mastercard"
+ * ```
+ */
+function formatNetworkName(network) {
+    const networkNames = {
+        visa: 'Visa',
+        mastercard: 'Mastercard',
+        amex: 'American Express',
+        discover: 'Discover',
+        jcb: 'JCB',
+        maestro: 'Maestro',
+        electron: 'Visa Electron',
+        elo: 'Elo',
+        idcredit: 'iD Credit',
+        interac: 'Interac',
+        privateLabel: 'Private Label',
+    };
+    return networkNames[network] || network;
+}

package/nitro.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://nitro.margelo.com/nitro.schema.json",
+  "cxxNamespace": [
+    "pay"
+  ],
+  "ios": {
+    "iosModuleName": "NitroPay"
+  },
+  "android": {
+    "androidNamespace": [
+      "pay"
+    ],
+    "androidCxxLibName": "NitroPay"
+  },
+  "autolinking": {
+    "ApplePayButton": {
+      "swift": "HybridApplePayButton"
+    },
+    "GooglePayButton": {
+      "kotlin": "HybridGooglePayButton"
+    },
+    "PaymentHandler": {
+      "swift": "HybridPaymentHandler",
+      "kotlin": "HybridPaymentHandler"
+    }
+  },
+  "ignorePaths": [
+    "**/node_modules"
+  ]
+}

package/nitrogen/generated/.gitattributes

@@ -0,0 +1 @@
+** linguist-generated=true

package/nitrogen/generated/android/NitroPay+autolinking.cmake

@@ -0,0 +1,87 @@
+#
+# NitroPay+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroPay+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_NITROPAY_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  NitroPay PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/NitroPayOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridApplePayButtonSpec.cpp
+  ../nitrogen/generated/shared/c++/views/HybridApplePayButtonComponent.cpp
+  ../nitrogen/generated/shared/c++/HybridGooglePayButtonSpec.cpp
+  ../nitrogen/generated/shared/c++/views/HybridGooglePayButtonComponent.cpp
+  ../nitrogen/generated/shared/c++/HybridPaymentHandlerSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  ../nitrogen/generated/android/c++/JHybridGooglePayButtonSpec.cpp
+  ../nitrogen/generated/android/c++/views/JHybridGooglePayButtonStateUpdater.cpp
+  ../nitrogen/generated/android/c++/JHybridPaymentHandlerSpec.cpp
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  NitroPay PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        NitroPay
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        NitroPay
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        NitroPay
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/NitroPay+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// NitroPay+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/NitroPay+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 NitroPay is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/NitroPayOnLoad.cpp

@@ -0,0 +1,58 @@
+///
+/// NitroPayOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_NITROPAY_WITH_GENERATED_CMAKE_PROJECT
+#error NitroPayOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "NitroPayOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "JHybridGooglePayButtonSpec.hpp"
+#include "JFunc_void.hpp"
+#include "views/JHybridGooglePayButtonStateUpdater.hpp"
+#include "JHybridPaymentHandlerSpec.hpp"
+#include <NitroModules/DefaultConstructableObject.hpp>
+
+namespace margelo::nitro::pay {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::pay;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    margelo::nitro::pay::JHybridGooglePayButtonSpec::registerNatives();
+    margelo::nitro::pay::JFunc_void_cxx::registerNatives();
+    margelo::nitro::pay::views::JHybridGooglePayButtonStateUpdater::registerNatives();
+    margelo::nitro::pay::JHybridPaymentHandlerSpec::registerNatives();
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "GooglePayButton",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridGooglePayButtonSpec::javaobject> object("com/margelo/nitro/pay/HybridGooglePayButton");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "PaymentHandler",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridPaymentHandlerSpec::javaobject> object("com/margelo/nitro/pay/HybridPaymentHandler");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::pay

package/nitrogen/generated/android/NitroPayOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// NitroPayOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::pay {
+
+  /**
+   * Initializes the native (C++) part of NitroPay, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::pay::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::pay