feat: Add support for Customer & Payments sessions, thus enabling one to use the SDK UI kit

.all-contributorsrc

@@ -0,0 +1,46 @@
+{
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 100,
+  "commit": false,
+  "contributors": [
+    {
+      "login": "lukebrandonfarrell",
+      "name": "Luke Brandon Farrell",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/18139277?v=4",
+      "profile": "http://www.lukebrandonfarrell.com",
+      "contributions": [
+        "code",
+        "infra",
+        "projectManagement"
+      ]
+    },
+    {
+      "login": "ChesterSim",
+      "name": "Chester Sim",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/12388321?v=4",
+      "profile": "https://github.com/ChesterSim",
+      "contributions": [
+        "doc",
+        "code"
+      ]
+    },
+    {
+      "login": "amogh-jrules",
+      "name": "Amogh Jahagirdar",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/31567169?v=4",
+      "profile": "https://jramogh.co",
+      "contributions": [
+        "doc",
+        "code"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "projectName": "react-native-stripe-payments",
+  "projectOwner": "aspect-apps",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "skipCi": true
+}

.gitignore

@@ -8,35 +8,4 @@ node_modules/
 npm-debug.log
 yarn-error.log
 
-# Xcode
-#
-build/
-*.pbxuser
-!default.pbxuser
-*.mode1v3
-!default.mode1v3
-*.mode2v3
-!default.mode2v3
-*.perspectivev3
-!default.perspectivev3
-xcuserdata
-*.xccheckout
-*.moved-aside
-DerivedData
-*.hmap
-*.ipa
-*.xcuserstate
-project.xcworkspace
-
-# Android/IntelliJ
-#
-build/
-.idea
-.gradle
-local.properties
-*.iml
-
-# BUCK
-buck-out/
-\.buckd/
-*.keystore
+android/build/

README.md

@@ -1,4 +1,7 @@
 ![React Native Stripe payments](https://raw.githubusercontent.com/Fitpassu/react-native-stripe-payments/master/react-native-stripe-payments.png)
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 A well typed React Native library providing support for Stripe payments on both iOS and Android.
 
@@ -20,49 +23,107 @@ The library ships with platform native code that needs to be compiled together w
 
 ## Usage
 
-### Setup
-
-First of all you have to obtain Stripe account [publishabe key](https://stripe.com/docs/keys). And then you need to set it for module.
+To use the module, import it first.
 
 ```javascript
 import stripe from 'react-native-stripe-payments';
+```
+
+### Setup
+
+First of all you have to obtain a Stripe account [publishable key](https://stripe.com/docs/keys), which you need to set it for the module.
 
+```javascript
 stripe.setOptions({ publishingKey: 'STRIPE_PUBLISHING_KEY' });
 ```
 
 ### Validate the given card details
 
 ```javascript
-import stripe from 'react-native-stripe-payments';
-
 const isCardValid = stripe.isCardValid({
   number: '4242424242424242',
   expMonth: 10,
   expYear: 21,
   cvc: '888',
 });
 ```
+The argument for `isCardValid` is of type `CardParams`, which is used across the other APIs.
 
-### One-time payments
+### Set up a payment method for future payments (Setup Intent)
 
 ```javascript
-import stripe from 'react-native-stripe-payments';
+stripe.confirmSetup('client_secret_from_backend', cardParams)
+  .then(result => {
+    // result of type SetupIntentResult
+    // {
+    //    paymentMethodId,
+    //    liveMode,
+    //    last4,
+    //    created,
+    //    brand
+    // }
+  })
+  .catch(err =>
+    // error performing payment
+  )
+```
+The `brand` is the provider of the card, and we use the [module](https://www.npmjs.com/package/credit-card-type) `credit-card-type` to achieve that. 
 
+### One-time payment using the `id` of a `PaymentMethod`
+
+```javascript
+stripe.confirmPaymentWithPaymentMethodId('client_secret_from_backend', paymentMethodId)
+  .then(result => {
+    // result of type PaymentResult
+    // {
+    //    id,
+    //    paymentMethodId
+    // }
+  })
+  .catch(err =>
+    // error performing payment
+  )
+```
+
+### One-time payment using `cardParams`
+
+```javascript
 const cardDetails = {
   number: '4242424242424242',
   expMonth: 10,
   expYear: 21,
   cvc: '888',
 }
-stripe.confirmPayment('client_secret_from_backend', cardDetails)
+stripe.confirmPaymentWithCardParams('client_secret_from_backend', cardParams)
   .then(result => {
     // result of type PaymentResult
+    // {
+    //    id,
+    //    paymentMethodId
+    // }
   })
   .catch(err =>
     // error performing payment
   )
 ```
 
-### Reusing cards
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="http://www.lukebrandonfarrell.com"><img src="https://avatars3.githubusercontent.com/u/18139277?v=4" width="100px;" alt=""/><br /><sub><b>Luke Brandon Farrell</b></sub></a><br /><a href="https://github.com/aspect-apps/react-native-stripe-payments/commits?author=lukebrandonfarrell" title="Code">💻</a> <a href="#infra-lukebrandonfarrell" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#projectManagement-lukebrandonfarrell" title="Project Management">📆</a></td>
+    <td align="center"><a href="https://github.com/ChesterSim"><img src="https://avatars2.githubusercontent.com/u/12388321?v=4" width="100px;" alt=""/><br /><sub><b>Chester Sim</b></sub></a><br /><a href="https://github.com/aspect-apps/react-native-stripe-payments/commits?author=ChesterSim" title="Documentation">📖</a> <a href="https://github.com/aspect-apps/react-native-stripe-payments/commits?author=ChesterSim" title="Code">💻</a></td>
+    <td align="center"><a href="https://jramogh.co"><img src="https://avatars3.githubusercontent.com/u/31567169?v=4" width="100px;" alt=""/><br /><sub><b>Amogh Jahagirdar</b></sub></a><br /><a href="https://github.com/aspect-apps/react-native-stripe-payments/commits?author=amogh-jrules" title="Documentation">📖</a> <a href="https://github.com/aspect-apps/react-native-stripe-payments/commits?author=amogh-jrules" title="Code">💻</a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
 
-Not supported yet, though as we're highly invested in development of our product which depends on this library we'll do it as soon as possible!
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

android/build.gradle

@@ -49,6 +49,7 @@ android {
         targetSdkVersion safeExtGet('targetSdkVersion', DEFAULT_TARGET_SDK_VERSION)
         versionCode 1
         versionName "1.0"
+        multiDexEnabled true
     }
     lintOptions {
         abortOnError false
@@ -73,7 +74,8 @@ repositories {
 dependencies {
     //noinspection GradleDynamicVersion
     implementation 'com.facebook.react:react-native:+'  // From node_modules
-    implementation 'com.stripe:stripe-android:14.2.1'
+    implementation 'com.stripe:stripe-android:15.1.0'
+    implementation 'com.android.support:multidex:1.0.3'
 }
 
 def configureReactNativePom(def pom) {

android/src/main/java/com/fitpassu/stripepayments/BridgeEphemeralKeyProvider.java

@@ -0,0 +1,90 @@
+package com.fitpassu.stripepayments;
+
+import com.stripe.android.EphemeralKeyProvider;
+import com.stripe.android.EphemeralKeyUpdateListener;
+
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.UiThreadUtil;
+
+
+/** 
+ *
+ * Ephemeral Key Provider that works with the JS thread through the bridge
+ *
+ */
+public class BridgeEphemeralKeyProvider implements EphemeralKeyProvider, EphemeralKeyUpdateListener {
+    private ReactApplicationContext reactContext;
+    private EphemeralKeyUpdateListener pendingKeyUpdateListener; //will hold the key update listener between the time when the event is raised and the JS responds back with the key
+
+    //save the context for future use
+    BridgeEphemeralKeyProvider(ReactApplicationContext context) {
+        this.reactContext = context;
+    }
+
+    @Override
+    public void createEphemeralKey(
+            String apiVersion,
+            final EphemeralKeyUpdateListener keyUpdateListener) {
+
+        //build params to send to the JS thread
+        WritableMap params = Arguments.createMap();
+        params.putString("apiVersion", apiVersion);
+
+        this.pendingKeyUpdateListener = keyUpdateListener;
+
+        //async call the JS land
+        reactContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+            .emit("stripeCreateEphemeralKey", params);
+    }
+
+    /**
+     *
+     * Called from the JS land once we have the key
+     *
+     */
+    @Override
+    public void onKeyUpdate(final String stripeResponseJson){
+        if(this.pendingKeyUpdateListener != null) {
+            final EphemeralKeyUpdateListener keyUpdateListener = pendingKeyUpdateListener;
+
+            //
+            // we need to make sure the listener is updated on the UI thread
+            //
+            UiThreadUtil.runOnUiThread(new Runnable() {
+                @Override
+                public void run() {
+                    keyUpdateListener.onKeyUpdate(stripeResponseJson);
+                }});
+
+            this.pendingKeyUpdateListener = null; //avoid memory leaks. the listener is not used anymore
+        }
+    }
+
+
+    /**
+     *
+     * Called from the JS land once we have the key
+     *
+     */
+    @Override
+    public void onKeyUpdateFailure(final int responseCode, final String message) {
+        if(this.pendingKeyUpdateListener != null) {
+            final EphemeralKeyUpdateListener keyUpdateListener = pendingKeyUpdateListener;
+
+            //
+            // we need to make sure the listener is updated on the UI thread
+            //
+            UiThreadUtil.runOnUiThread(new Runnable() {
+                @Override
+                public void run() {
+                    keyUpdateListener.onKeyUpdateFailure(responseCode, message);
+                }});
+
+            this.pendingKeyUpdateListener = null; //avoid memory leaks. the listener is not used anymore
+        }
+    }
+}