@connexup/react-native-square-mobile-payment-sdk 0.1.0

package/package.json

@@ -0,0 +1,178 @@
+{
+  "name": "@connexup/react-native-square-mobile-payment-sdk",
+  "version": "0.1.0",
+  "description": "Mobile Payments SDK for React Native",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "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": {
+    "example": "yarn workspace react-native-square-mobile-payment-sdk-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chancetop-com/fbr-react-native-square-mobile-payment-sdk.git"
+  },
+  "author": "Luke Chen <lukechen@chancetop.com> (https://www.npmjs.com/~lukechen_ct)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/chancetop-com/fbr-react-native-square-mobile-payment-sdk/issues"
+  },
+  "homepage": "https://github.com/chancetop-com/fbr-react-native-square-mobile-payment-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "NativeSquareMobilePaymentSDKSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.connexup.square.mobilepayment"
+    },
+    "ios": {
+      "modulesProvider": {
+        "NativeMobilePaymentAuthorization": "RCTMobilePaymentAuthorization",
+        "NativeMobilePaymentSetting": "RCTMobilePaymentSetting",
+        "NativeMobilePaymentReader": "RCTMobilePaymentReader",
+        "NativeMobilePaymentPayment": "RCTMobilePaymentPayment"
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "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": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.57.0"
+  }
+}

package/src/authorization/NativeMobilePaymentAuthorization.ts

@@ -0,0 +1,297 @@
+import {
+  type CodegenTypes,
+  type TurboModule,
+  TurboModuleRegistry,
+} from 'react-native';
+
+export interface Spec extends TurboModule {
+  /**
+   * accessToken A Square access token
+   * ●	An OAuth access token. See the OAuth API documentation (https://developer.squareup.com/docs/oauth-api/how-it-works) for instructions on how to get an access token.
+   * ●	When requesting an OAuth access token, you will need to ask for the following permissions:
+   * ○	MERCHANT_PROFILE_READ is required get a list of all a merchant’s locations
+   * ○	PAYMENTS_WRITE and PAYMENTS_WRITE_IN_PERSON are required to take payments in ReaderSDK
+   * ○	PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS is required to collect application fees (optional)
+   */
+  authorize(accessToken: string, locationID: string): Promise<void>;
+
+  deauthorize(): Promise<void>;
+
+  state(): AuthorizationState;
+
+  location(): Location | null;
+
+  readonly onAuthorizationStateChange: CodegenTypes.EventEmitter<AuthorizationState>;
+}
+
+export const NativeMobilePaymentAuthorization =
+  TurboModuleRegistry.getEnforcing<Spec>('NativeMobilePaymentAuthorization');
+
+export type AuthorizationState =
+  | 'NOT_AUTHORIZED'
+  | 'AUTHORIZING'
+  | 'AUTHORIZED'
+  | 'UNKNOWN';
+
+export interface Location {
+  id: string;
+  name: string;
+  mcc?: string; //only iOS
+  currency: Currency;
+  merchantId?: string; //only android
+  nickName?: string; //only android
+  cardProcessingActivated?: boolean; //only android
+}
+
+export type Currency =
+  | 'AUD'
+  | 'CAD'
+  | 'EUR'
+  | 'GBP'
+  | 'JPY'
+  | 'USD'
+  | 'AED'
+  | 'AFN'
+  | 'ALL'
+  | 'AMD'
+  | 'ANG'
+  | 'AOA'
+  | 'ARS'
+  | 'AWG'
+  | 'AZN'
+  | 'BAM'
+  | 'BBD'
+  | 'BDT'
+  | 'BGN'
+  | 'BHD'
+  | 'BIF'
+  | 'BMD'
+  | 'BND'
+  | 'BOB'
+  | 'BOV'
+  | 'BRL'
+  | 'BSD'
+  | 'BTN'
+  | 'BWP'
+  | 'BYR'
+  | 'BZD'
+  | 'CDF'
+  | 'CHE'
+  | 'CHF'
+  | 'CHW'
+  | 'CLF'
+  | 'CLP'
+  | 'CNY'
+  | 'COP'
+  | 'COU'
+  | 'CRC'
+  | 'CUC'
+  | 'CUP'
+  | 'CVE'
+  | 'CZK'
+  | 'DJF'
+  | 'DKK'
+  | 'DOP'
+  | 'DZD'
+  | 'EGP'
+  | 'ERN'
+  | 'ETB'
+  | 'FJD'
+  | 'FKP'
+  | 'GEL'
+  | 'GHS'
+  | 'GIP'
+  | 'GMD'
+  | 'GNF'
+  | 'GTQ'
+  | 'GYD'
+  | 'HKD'
+  | 'HNL'
+  | 'HRK'
+  | 'HTG'
+  | 'HUF'
+  | 'IDR'
+  | 'ILS'
+  | 'INR'
+  | 'IQD'
+  | 'IRR'
+  | 'ISK'
+  | 'JMD'
+  | 'JOD'
+  | 'KES'
+  | 'KGS'
+  | 'KHR'
+  | 'KMF'
+  | 'KPW'
+  | 'KRW'
+  | 'KWD'
+  | 'KYD'
+  | 'KZT'
+  | 'LAK'
+  | 'LBP'
+  | 'LKR'
+  | 'LRD'
+  | 'LSL'
+  | 'LTL'
+  | 'LVL'
+  | 'LYD'
+  | 'MAD'
+  | 'MDL'
+  | 'MGA'
+  | 'MKD'
+  | 'MMK'
+  | 'MNT'
+  | 'MOP'
+  | 'MRO'
+  | 'MUR'
+  | 'MVR'
+  | 'MWK'
+  | 'MXN'
+  | 'MXV'
+  | 'MYR'
+  | 'MZN'
+  | 'NAD'
+  | 'NGN'
+  | 'NIO'
+  | 'NOK'
+  | 'NPR'
+  | 'NZD'
+  | 'OMR'
+  | 'PAB'
+  | 'PEN'
+  | 'PGK'
+  | 'PHP'
+  | 'PKR'
+  | 'PLN'
+  | 'PYG'
+  | 'QAR'
+  | 'RON'
+  | 'RSD'
+  | 'RUB'
+  | 'RWF'
+  | 'SAR'
+  | 'SBD'
+  | 'SCR'
+  | 'SDG'
+  | 'SEK'
+  | 'SGD'
+  | 'SHP'
+  | 'SLL'
+  | 'SOS'
+  | 'SRD'
+  | 'SSP'
+  | 'STD'
+  | 'SVC'
+  | 'SYP'
+  | 'SZL'
+  | 'THB'
+  | 'TJS'
+  | 'TMT'
+  | 'TND'
+  | 'TOP'
+  | 'TRY'
+  | 'TTD'
+  | 'TWD'
+  | 'TZS'
+  | 'UAH'
+  | 'UGX'
+  | 'USN'
+  | 'USS'
+  | 'UYI'
+  | 'UYU'
+  | 'UZS'
+  | 'VEF'
+  | 'VND'
+  | 'VUV'
+  | 'WST'
+  | 'XAF'
+  | 'XAG'
+  | 'XAU'
+  | 'XBA'
+  | 'XBB'
+  | 'XBC'
+  | 'XBD'
+  | 'XCD'
+  | 'XDR'
+  | 'XOF'
+  | 'XPD'
+  | 'XPF'
+  | 'XPT'
+  | 'XTS'
+  | 'XXX'
+  | 'YER'
+  | 'ZAR'
+  | 'ZMK'
+  | 'ZMW'
+  | 'BTC'
+  | 'XUS'
+  | 'SLE'
+  | 'UNKNOWN';
+
+export const AuthorizationErrorNoNetwork = 'AUTHORIZATION_ERROR_NO_NETWORK';
+/**
+ * Device is already authorized with a Square account.
+ */
+export const AuthorizationErrorAlreadyAuthorized =
+  'AUTHORIZATION_ERROR_ALREADY_AUTHORIZED';
+/**
+ * An unexpected error occurred. See the debug code and message for more information.
+ */
+export const AuthorizationErrorAlreadyInProgress =
+  'AUTHORIZATION_ERROR_ALREADY_IN_PROGRESS';
+
+/**
+ * Authorization code has already been redeemed.
+ */
+export const AuthorizationErrorAuthorizationCodeAlreadyRedeemed =
+  'AUTHORIZATION_ERROR_AUTHORIZATION_CODE_ALREADY_REDEEMED';
+
+/**
+ * Authorization code has expired.
+ */
+export const AuthorizationErrorExpiredAuthorizationCode =
+  'AUTHORIZATION_ERROR_EXPIRED_AUTHORIZATION_CODE';
+/**
+ * Authorization code is invalid.
+ */
+export const AuthorizationErrorInvalidAuthorizationCode =
+  'AUTHORIZATION_ERROR_INVALID_AUTHORIZATION_CODE';
+/**
+ *  Access token is invalid.
+ */
+export const AuthorizationErrorInvalidAccessToken =
+  'AUTHORIZATION_ERROR_INVALID_ACCESS_TOKEN';
+/**
+ *  Access code is empty.
+ */
+export const AuthorizationErrorEmptyAccessToken =
+  'AUTHORIZATION_ERROR_EMPTY_ACCESS_TOKEN';
+/**
+ * LocationID is invalid.
+ */
+export const AuthorizationErrorInvalidLocationID =
+  'AUTHORIZATION_ERROR_INVALID_LOCATION_ID';
+/**
+ * Location is not authorized for card processing
+ */
+export const AuthorizationErrorLocationNotActivatedForCardProcessing =
+  'AUTHORIZATION_ERROR_LOCATION_NOT_ACTIVATED_FOR_CARD_PROCESSING';
+/**
+ *  LocationID is empty.
+ */
+export const AuthorizationErrorEmptyLocationID =
+  'AUTHORIZATION_ERROR_EMPTY_LOCATION_ID';
+/**
+ *  Country is not supported
+ */
+export const AuthorizationErrorUnsupportedCountry =
+  'AUTHORIZATION_ERROR_UNSUPPORTED_COUNTRY';
+/**
+ *  There is a discrepancy between the device time and the server time.
+ */
+export const AuthorizationErrorDeviceTimeDoesNotMatchServerTime =
+  'AUTHORIZATION_ERROR_DEVICE_TIME_DOES_NOT_MATCH_SERVER_TIME';
+/**
+ * Unexpected authorization error.
+ */
+export const AuthorizationErrorUnexpected = 'AUTHORIZATION_ERROR_UNEXPECTED';

package/src/authorization/index.ts

@@ -0,0 +1,60 @@
+import { createMobilePaymentError } from '../util';
+import {
+  NativeMobilePaymentAuthorization,
+  type AuthorizationState,
+  type Location,
+  type Spec,
+} from './NativeMobilePaymentAuthorization';
+import type { EventSubscription } from 'react-native';
+
+class MobilePaymentAuthorization implements Omit<Spec, 'getConstants'> {
+  private readonly authorizationManage: Spec;
+
+  constructor(authorizationManage: Spec) {
+    this.authorizationManage = authorizationManage;
+  }
+
+  state(): AuthorizationState {
+    try {
+      return this.authorizationManage.state();
+    } catch (e) {
+      throw createMobilePaymentError(e);
+    }
+  }
+
+  async authorize(accessToken: string, locationID: string): Promise<void> {
+    try {
+      return await this.authorizationManage.authorize(accessToken, locationID);
+    } catch (e) {
+      throw createMobilePaymentError(e);
+    }
+  }
+
+  location(): Location | null {
+    try {
+      return this.authorizationManage.location();
+    } catch (e) {
+      throw createMobilePaymentError(e);
+    }
+  }
+
+  async deauthorize(): Promise<void> {
+    try {
+      return await this.authorizationManage.deauthorize();
+    } catch (e) {
+      throw createMobilePaymentError(e);
+    }
+  }
+
+  onAuthorizationStateChange(
+    listener: (state: AuthorizationState) => void
+  ): EventSubscription {
+    return this.authorizationManage.onAuthorizationStateChange((payloads) => {
+      listener(payloads);
+    });
+  }
+}
+
+export const mobilePaymentAuthorization = new MobilePaymentAuthorization(
+  NativeMobilePaymentAuthorization
+);

package/src/index.ts

@@ -0,0 +1,4 @@
+export { mobilePaymentAuthorization as MobilePaymentAuthorization } from './authorization';
+export { mobilePaymentReader as MobilePaymentReader } from './reader';
+export { mobilePaymentPayment as MobilePaymentPayment } from './payment';
+export { mobilePaymentSetting as MobilePaymentSetting } from './setting';