@exodus/react-native-wallet 0.1.16

package/package.json

@@ -0,0 +1,157 @@
+{
+  "name": "@exodus/react-native-wallet",
+  "version": "0.1.16",
+  "description": "A React Native module designed for seamless integration of Card Push Provisioning into Apple Wallet and Google Wallet, enabling easy and secure addition of payment cards directly from your application.",
+  "source": "./src/index.tsx",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "files": [
+    "src",
+    "lib",
+    "assets",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .js,.ts,.tsx",
+    "lint:root": "eslint . --ext .js,.ts,.tsx --ignore-pattern '/example/**/*' --ignore-pattern '/WebExample/**/*'",
+    "lint:example": "eslint example --ext .js,.ts,.tsx",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "build:watch": "nodemon --watch src --ext .ts,.tsx,.css --exec \"rm -f .build_complete && npm run prepare && npm pack && touch .build_complete\"",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ExodusForks/react-native-wallet.git"
+  },
+  "author": "Expensify, Inc.",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Expensify/react-native-wallet/issues"
+  },
+  "homepage": "https://github.com/Expensify/react-native-wallet#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@babel/preset-env": "^7.25.3",
+    "@babel/preset-react": "^7.18.6",
+    "@commitlint/config-conventional": "^17.0.2",
+    "@evilmartians/lefthook": "^1.5.0",
+    "@lwc/eslint-plugin-lwc": "^1.7.2",
+    "@react-native-community/cli": "20.0.0",
+    "@react-native-community/cli-platform-android": "20.0.0",
+    "@react-native-community/cli-platform-ios": "20.0.0",
+    "@react-native/eslint-config": "0.81.0",
+    "@react-native/gradle-plugin": "0.81.0",
+    "@release-it/conventional-changelog": "^5.0.0",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.0",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "del-cli": "^5.0.0",
+    "eslint": "^8.57.1",
+    "eslint-config-expensify": "^2.0.24",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-import-resolver-alias": "^1.1.2",
+    "eslint-plugin-deprecation": "^2.0.0",
+    "eslint-plugin-es": "^4.1.0",
+    "eslint-plugin-filenames": "^1.3.2",
+    "eslint-plugin-header": "^3.1.1",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-jsx-a11y": "^6.8.0",
+    "eslint-plugin-prettier": "^4.0.0",
+    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-tsdoc": "^0.2.17",
+    "jest": "^29.6.3",
+    "prettier": "2.8.8",
+    "react": "19.1.0",
+    "react-native": "0.81.0",
+    "react-native-builder-bob": "^0.20.0",
+    "release-it": "^15.0.0",
+    "turbo": "^1.10.7",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "./example"
+  ],
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": "angular"
+      }
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "RNWalletSpec",
+    "type": "all",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.expensify.wallet"
+    }
+  }
+}

package/react-native-wallet.podspec

@@ -0,0 +1,36 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+$RNWallet = Object.new
+
+def $RNWallet._add_compiler_flags(sp, extra_flags)
+  exisiting_flags = sp.attributes_hash["compiler_flags"]
+  if exisiting_flags.present?
+    sp.compiler_flags = exisiting_flags + " #{extra_flags}"
+  else
+    sp.compiler_flags = extra_flags
+  end
+end
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-wallet"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/ExodusForks/react-native-wallet.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
+
+  s.dependency "React-Core"
+
+  install_modules_dependencies(s);
+  
+  if ENV['USE_FRAMEWORKS']
+    $RNWallet._add_compiler_flags(s, "-DRNWallet_USE_FRAMEWORKS=1")
+  end
+end

package/src/AddToWalletButton.tsx

@@ -0,0 +1,78 @@
+import React from 'react';
+import type {ViewStyle, GestureResponderEvent, HostComponent, StyleProp} from 'react-native';
+import {Platform, requireNativeComponent, StyleSheet, TouchableOpacity} from 'react-native';
+
+type ButtonStyle = 'black' | 'blackOutline';
+type ButtonType = 'basic' | 'badge';
+
+interface NativeWalletButtonProps {
+  style?: StyleProp<ViewStyle>;
+  buttonStyle?: ButtonStyle;
+  buttonType?: ButtonType;
+  borderRadius?: number;
+}
+
+type Props = NativeWalletButtonProps & {
+  onPress?: (e: GestureResponderEvent) => void;
+};
+
+const NativeWalletButton: HostComponent<NativeWalletButtonProps> = requireNativeComponent('RNAddToWalletButton');
+
+const BUTTON_TYPE_BREAKPOINT = 236;
+const BUTTON_DIMENSIONS = {
+  basic: {
+    ios: {width: 300, height: 40},
+    android: {width: 300, height: 48},
+  },
+  badge: {
+    ios: {width: 120, height: 40},
+    android: {width: 200, height: 56},
+  },
+};
+
+function AddToWalletButton({style, buttonStyle = 'black', buttonType = 'basic', borderRadius = 4, onPress}: Props) {
+  const flattenedStyle = StyleSheet.flatten(style) || {};
+  const safeButtonType: ButtonType = buttonType === 'badge' ? 'badge' : 'basic';
+  const currentDimensions = BUTTON_DIMENSIONS[safeButtonType][Platform.OS as 'ios' | 'android'];
+  const {width = currentDimensions.width, height = currentDimensions.height, ...rest} = flattenedStyle;
+
+  return (
+    <TouchableOpacity
+      onPress={onPress}
+      activeOpacity={0.8}
+      style={[
+        rest,
+        // Android allows us to define the type of the button, however on iOS type depends on the width.
+        // Adding this limits to ensure consistent behavior across platforms.
+        buttonType === 'badge' ? {maxWidth: BUTTON_TYPE_BREAKPOINT - 1} : {minWidth: BUTTON_TYPE_BREAKPOINT},
+        {
+          width,
+          height,
+        },
+        styles.touchable,
+      ]}
+    >
+      <NativeWalletButton
+        style={styles.fill}
+        buttonStyle={buttonStyle}
+        borderRadius={borderRadius}
+        buttonType={safeButtonType}
+      />
+    </TouchableOpacity>
+  );
+}
+
+const styles = StyleSheet.create({
+  touchable: {
+    justifyContent: 'center',
+    alignItems: 'center',
+    margin: 10,
+  },
+  fill: {
+    flex: 1,
+    width: '100%',
+    height: '100%',
+  },
+});
+
+export default AddToWalletButton;

package/src/NativeWallet.ts

@@ -0,0 +1,115 @@
+import type {TurboModule} from 'react-native';
+import {TurboModuleRegistry} from 'react-native';
+
+type AndroidWalletData = {
+  deviceID: string;
+  walletAccountID: string;
+};
+
+type CardStatus = 'not found' | 'requireActivation' | 'pending' | 'active' | 'suspended' | 'deactivated';
+
+type Platform = 'android' | 'ios';
+
+type UserAddress = {
+  name: string;
+  addressOne: string;
+  addressTwo?: string;
+  administrativeArea: string;
+  locality: string;
+  countryCode: string;
+  postalCode: string;
+  phoneNumber: string;
+};
+
+type AndroidCardData = {
+  network: string;
+  opaquePaymentCard: string;
+  cardHolderName: string;
+  lastDigits: string;
+  userAddress: UserAddress;
+};
+
+type AndroidResumeCardData = {
+  network: string;
+  tokenReferenceID: string;
+  cardHolderName?: string;
+  lastDigits?: string;
+};
+
+type IOSCardData = {
+  network: string;
+  cardHolderName: string;
+  lastDigits: string;
+  cardDescription: string;
+};
+
+type onCardActivatedPayload = {
+  tokenId: string;
+  actionStatus: 'active' | 'canceled';
+};
+
+type IOSAddPaymentPassData = {
+  status: number;
+  nonce: string;
+  nonceSignature: string;
+  certificates: string[];
+};
+
+type IOSEncryptPayload = {
+  encryptedPassData: string;
+  activationData: string;
+  ephemeralPublicKey: string;
+};
+
+type TokenizationStatus = 'canceled' | 'success' | 'error';
+
+type TokenInfo = {
+  identifier: string;
+  lastDigits: string;
+  tokenState: number;
+};
+
+export interface Spec extends TurboModule {
+  checkWalletAvailability(): Promise<boolean>;
+  ensureGoogleWalletInitialized(): Promise<boolean>;
+  getSecureWalletInfo(): Promise<AndroidWalletData>;
+  getCardStatusBySuffix(last4Digits: string): Promise<number>;
+  getCardStatusByIdentifier(identifier: string, tsp: string): Promise<number>;
+  addCardToGoogleWallet(cardData: AndroidCardData): Promise<number>;
+  resumeAddCardToGoogleWallet(cardData: AndroidResumeCardData): Promise<number>;
+  listTokens(): Promise<TokenInfo[]>;
+  IOSPresentAddPaymentPassView(cardData: IOSCardData): Promise<IOSAddPaymentPassData>;
+  IOSHandleAddPaymentPassResponse(payload: IOSEncryptPayload): Promise<IOSAddPaymentPassData | null>;
+  addListener: (eventType: string) => void;
+  removeListeners: (count: number) => void;
+}
+
+const PACKAGE_NAME = '@expensify/react-native-wallet';
+// Try catch block to prevent crashing in case the module is not linked.
+// Especialy useful for builds where Google SDK is not available
+// eslint-disable-next-line import/no-mutable-exports
+let Wallet: Spec | undefined;
+try {
+  Wallet = TurboModuleRegistry.getEnforcing<Spec>('RNWallet');
+} catch (error) {
+  if (error instanceof Error) {
+    // eslint-disable-next-line no-console
+    console.warn(`[${PACKAGE_NAME}] Failed to load Wallet module, ${error.message}`);
+  }
+}
+export default Wallet;
+export {PACKAGE_NAME};
+export type {
+  AndroidCardData,
+  AndroidResumeCardData,
+  IOSCardData,
+  AndroidWalletData,
+  CardStatus,
+  UserAddress,
+  onCardActivatedPayload,
+  Platform,
+  IOSAddPaymentPassData,
+  IOSEncryptPayload,
+  TokenizationStatus,
+  TokenInfo,
+};

package/src/index.tsx

@@ -0,0 +1,184 @@
+/* eslint-disable @lwc/lwc/no-async-await */
+import {NativeEventEmitter, Platform} from 'react-native';
+import type {EmitterSubscription} from 'react-native';
+import Wallet, {PACKAGE_NAME} from './NativeWallet';
+import type {
+  TokenizationStatus,
+  AndroidCardData,
+  AndroidResumeCardData,
+  CardStatus,
+  IOSCardData,
+  IOSEncryptPayload,
+  AndroidWalletData,
+  onCardActivatedPayload,
+  IOSAddPaymentPassData,
+  TokenInfo,
+} from './NativeWallet';
+import {getCardState, getTokenizationStatus} from './utils';
+import AddToWalletButton from './AddToWalletButton';
+
+function getModuleLinkingRejection() {
+  return Promise.reject(new Error(`Failed to load Wallet module, make sure to link ${PACKAGE_NAME} correctly`));
+}
+
+let eventEmitter: NativeEventEmitter | null = null;
+
+function getEventEmitter(): NativeEventEmitter {
+  if (!Wallet) {
+    throw new Error(`Failed to load Wallet module, make sure to link ${PACKAGE_NAME} correctly`);
+  }
+  if (!eventEmitter) {
+    eventEmitter = new NativeEventEmitter(Wallet);
+  }
+  return eventEmitter;
+}
+
+function addListener(event: string, callback: (data: onCardActivatedPayload) => void): EmitterSubscription {
+  return getEventEmitter().addListener(event, callback);
+}
+
+function removeListener(subscription: EmitterSubscription): void {
+  subscription.remove();
+}
+
+function checkWalletAvailability(): Promise<boolean> {
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+  return Wallet.checkWalletAvailability();
+}
+
+async function getSecureWalletInfo(): Promise<AndroidWalletData> {
+  if (Platform.OS === 'ios') {
+    throw new Error('getSecureWalletInfo is not available on iOS');
+  }
+
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+  const isWalletInitialized = await Wallet.ensureGoogleWalletInitialized();
+  if (!isWalletInitialized) {
+    throw new Error('Wallet could not be initialized');
+  }
+
+  return Wallet.getSecureWalletInfo();
+}
+
+async function getCardStatusBySuffix(last4Digits: string): Promise<CardStatus> {
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+
+  const cardState = await Wallet.getCardStatusBySuffix(last4Digits);
+  return getCardState(cardState);
+}
+
+/**
+ * Returns the state of a card based on a platform-specific identifier.
+ * @param identifier - The card identifier. On Android, it's `Token Reference ID` and on iOS, it's `Primary Account Identifier`
+ * @param tsp - The Token Service Provider, e.g. `VISA`, `MASTERCARD`
+ * @returns CardStatus - The card status
+ */
+async function getCardStatusByIdentifier(identifier: string, tsp: string): Promise<CardStatus> {
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+
+  const tokenState = await Wallet.getCardStatusByIdentifier(identifier, tsp.toUpperCase());
+  return getCardState(tokenState);
+}
+
+async function addCardToGoogleWallet(cardData: AndroidCardData): Promise<TokenizationStatus> {
+  if (Platform.OS === 'ios') {
+    throw new Error('addCardToGoogleWallet is not available on iOS');
+  }
+
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+  const isWalletInitialized = await Wallet.ensureGoogleWalletInitialized();
+  if (!isWalletInitialized) {
+    throw new Error('Wallet could not be initialized');
+  }
+  const tokenizationStatus = await Wallet.addCardToGoogleWallet(cardData);
+  return getTokenizationStatus(tokenizationStatus);
+}
+
+async function resumeAddCardToGoogleWallet(cardData: AndroidResumeCardData): Promise<TokenizationStatus> {
+  if (Platform.OS === 'ios') {
+    throw new Error('resumeAddCardToGoogleWallet is not available on iOS');
+  }
+
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+  const isWalletInitialized = await Wallet.ensureGoogleWalletInitialized();
+  if (!isWalletInitialized) {
+    throw new Error('Wallet could not be initialized');
+  }
+  const tokenizationStatus = await Wallet.resumeAddCardToGoogleWallet(cardData);
+  return getTokenizationStatus(tokenizationStatus);
+}
+
+async function listTokens(): Promise<TokenInfo[]> {
+  if (Platform.OS === 'ios') {
+    return Promise.resolve([]);
+  }
+
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+  const isWalletInitialized = await Wallet.ensureGoogleWalletInitialized();
+  if (!isWalletInitialized) {
+    throw new Error('Wallet could not be initialized');
+  }
+  return Wallet.listTokens();
+}
+
+async function addCardToAppleWallet(
+  cardData: IOSCardData,
+  issuerEncryptPayloadCallback: (nonce: string, nonceSignature: string, certificate: string[]) => Promise<IOSEncryptPayload>,
+): Promise<TokenizationStatus> {
+  if (Platform.OS === 'android') {
+    throw new Error('addCardToAppleWallet is not available on Android');
+  }
+
+  if (!Wallet) {
+    return getModuleLinkingRejection();
+  }
+  const wallet = Wallet;
+
+  const passData = await wallet.IOSPresentAddPaymentPassView(cardData);
+
+  if (!passData || passData.status !== 0) {
+    return getTokenizationStatus(passData?.status || -1);
+  }
+
+  async function addPaymentPassToWallet(paymentPassData: IOSAddPaymentPassData): Promise<number> {
+    const responseData = await issuerEncryptPayloadCallback(paymentPassData.nonce, paymentPassData.nonceSignature, paymentPassData.certificates);
+    const response = await wallet.IOSHandleAddPaymentPassResponse(responseData);
+    // Response is null when a pass is successfully added to the wallet or the user cancels the process
+    // In case the user presses the `Try again` option, new pass data is returned, and it should reenter the function
+    if (response) {
+      return addPaymentPassToWallet(response);
+    }
+    return 0;
+  }
+  const status = await addPaymentPassToWallet(passData);
+  return getTokenizationStatus(status);
+}
+
+export type {AndroidCardData, AndroidWalletData, CardStatus, IOSEncryptPayload, IOSCardData, IOSAddPaymentPassData, onCardActivatedPayload, TokenizationStatus, TokenInfo};
+export {
+  AddToWalletButton,
+  checkWalletAvailability,
+  getSecureWalletInfo,
+  getCardStatusBySuffix,
+  getCardStatusByIdentifier,
+  addCardToGoogleWallet,
+  resumeAddCardToGoogleWallet,
+  listTokens,
+  addCardToAppleWallet,
+  addListener,
+  removeListener,
+};

package/src/utils.ts

@@ -0,0 +1,35 @@
+import type {CardStatus, TokenizationStatus} from './NativeWallet';
+
+function getCardState(stateId: number): CardStatus {
+  switch (stateId) {
+    case -1:
+      return 'not found';
+    case 0:
+      return 'active';
+    case 1:
+      return 'requireActivation';
+    case 2:
+      return 'pending';
+    case 3:
+      return 'suspended';
+    case 4:
+      return 'deactivated';
+    default:
+      throw new Error(`Unknown card state: ${stateId}`);
+  }
+}
+
+function getTokenizationStatus(stateId: number): TokenizationStatus {
+  switch (stateId) {
+    case -1:
+      return 'error';
+    case 0:
+      return 'success';
+    case 1:
+      return 'canceled';
+    default:
+      throw new Error(`Unknown tokenization status: ${stateId}`);
+  }
+}
+
+export {getCardState, getTokenizationStatus};