react-native-fpay 0.1.1

package/lib/typescript/src/ui/screens/sub/ProximitySubScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProximitySubScreen.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/sub/ProximitySubScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAG3D,OAAO,EAAoF,QAAQ,EAAU,MAAM,cAAc,CAAC;AAIlI,OAAO,KAAK,EAAE,UAAU,EAAmB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA+E/F,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAatB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAEtB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAKtB,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAGxB,CAAC;AAEF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAIrB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAIzB,CAAC;AAgGF,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,2CA+IzF"}

package/lib/typescript/src/ui/screens/sub/TransferSubScreen.d.ts

@@ -0,0 +1,12 @@
+import type { FPCurrency, FPTransaction, FPError } from '../../../core/types';
+interface Props {
+    amount: number;
+    currency: FPCurrency;
+    onBack: () => void;
+    onDone: () => void;
+    onSuccess?: (tx: FPTransaction) => void;
+    onError?: (err: FPError) => void;
+}
+export declare function TransferSubScreen({ amount, currency, onBack, onDone, onSuccess, onError }: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=TransferSubScreen.d.ts.map

package/lib/typescript/src/ui/screens/sub/TransferSubScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransferSubScreen.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/screens/sub/TransferSubScreen.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI9E,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,kDAqGhG"}

package/lib/typescript/src/ui/theme/index.d.ts

@@ -0,0 +1,62 @@
+export declare const C: {
+    ink: string;
+    brand: string;
+    brandLight: string;
+    green: string;
+    greenLight: string;
+    red: string;
+    redLight: string;
+    amber: string;
+    white: string;
+    surface: string;
+    border: string;
+    muted: string;
+    ghost: string;
+};
+export declare const R: {
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    full: number;
+};
+export declare const S: {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    xxl: number;
+};
+export declare const F: {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    xxl: number;
+    hero: number;
+};
+export declare const shadow: {
+    sm: {
+        shadowColor: string;
+        shadowOffset: {
+            width: number;
+            height: number;
+        };
+        shadowOpacity: number;
+        shadowRadius: number;
+        elevation: number;
+    };
+    lg: {
+        shadowColor: string;
+        shadowOffset: {
+            width: number;
+            height: number;
+        };
+        shadowOpacity: number;
+        shadowRadius: number;
+        elevation: number;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/ui/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ui/theme/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;CAcb,CAAC;AAEF,eAAO,MAAM,CAAC;;;;;;CAA+C,CAAC;AAC9D,eAAO,MAAM,CAAC;;;;;;;CAAoD,CAAC;AACnE,eAAO,MAAM,CAAC;;;;;;;;CAAgE,CAAC;AAE/E,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;CAGlB,CAAC"}

package/lib/typescript/src/useFountainPay.d.ts

@@ -0,0 +1,3 @@
+import type { FPInstance, FPSDKOptions } from './core/types';
+export declare function useFountainPay(apiKey: string, options?: FPSDKOptions): FPInstance;
+//# sourceMappingURL=useFountainPay.d.ts.map

package/lib/typescript/src/useFountainPay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFountainPay.d.ts","sourceRoot":"","sources":["../../../src/useFountainPay.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EAKb,MAAM,cAAc,CAAC;AAEtB,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAqEjF"}

package/package.json

@@ -0,0 +1,217 @@
+{
+  "name": "react-native-fpay",
+  "version": "0.1.1",
+  "description": "Fountain Pay react-native sdk library",
+  "main": "./lib/module/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "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-fpay-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",
+    "payment",
+    "pssp",
+    "wallet",
+    "nfc",
+    "bluetooth",
+    "nqr",
+    "fintech"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Axentia-Ltd/react-native-fpay.git"
+  },
+  "author": "Adedeji RIchards <adewumiadedeji27@gmail.com> (https://github.com/adewumiadedeji)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Axentia-Ltd/react-native-fpay/issues"
+  },
+  "homepage": "https://github.com/Axentia-Ltd/react-native-fpay#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@gorhom/bottom-sheet": "^5.2.8",
+    "@react-native-async-storage/async-storage": "^2.2.0",
+    "@react-native-community/blur": "^4.4.1",
+    "@react-native-community/clipboard": "^1.5.1",
+    "@react-native-community/geolocation": "^3.4.0",
+    "@react-native/new-app-screen": "0.83.1",
+    "@react-navigation/native": "^7.1.28",
+    "@react-navigation/native-stack": "^7.10.0",
+    "@types/react-native-vector-icons": "^6.4.18",
+    "axios": "^1.13.5",
+    "buffer": "^6.0.3",
+    "md5": "^2.3.0",
+    "react": "*",
+    "react-native": "*",
+    "react-native-biometrics": "^3.0.1",
+    "react-native-ble-plx": "^3.5.0",
+    "react-native-fs": "^2.20.0",
+    "react-native-gesture-handler": "^2.30.0",
+    "react-native-html-to-pdf": "^1.3.0",
+    "react-native-image-picker": "^8.2.1",
+    "react-native-linear-gradient": "^2.8.3",
+    "react-native-multi-ble-peripheral": "^0.1.8",
+    "react-native-nfc-manager": "^3.17.2",
+    "react-native-qr-kit": "^1.1.6",
+    "react-native-qrcode-svg": "^6.3.21",
+    "react-native-safe-area-context": "^5.6.2",
+    "react-native-screens": "^4.19.0",
+    "react-native-share": "^12.2.4",
+    "react-native-static-safe-area-insets": "^2.2.0",
+    "react-native-svg": "^15.15.1",
+    "react-native-svg-transformer": "^1.5.3",
+    "react-native-toast-message": "^2.3.3",
+    "react-native-vector-icons": "^10.3.0",
+    "react-native-vision-camera": "^4.7.3",
+    "styled-components": "^6.3.11",
+    "zustand": "^5.0.10"
+  },
+  "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-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-react-native": "^5.0.0",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^3.8.1",
+    "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": "FpaySpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.fpay"
+    }
+  },
+  "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.2"
+  }
+}

package/src/FountainPayProvider.tsx

@@ -0,0 +1,21 @@
+// ─────────────────────────────────────────────
+// FountainPayProvider
+// The ONLY thing the host app mounts.
+// Wraps children and mounts the invisible shell.
+// ─────────────────────────────────────────────
+import React, { type ReactNode } from 'react';
+import { FPShell } from './ui/modals/FPShell';
+
+interface Props {
+  children: ReactNode;
+}
+
+export function FountainPayProvider({ children }: Props) {
+  return (
+    <>
+      {children}
+      {/* FPShell is invisible until pay.send() or pay.receive() is called */}
+      <FPShell />
+    </>
+  );
+}

package/src/core/api/client.ts

@@ -0,0 +1,47 @@
+// FountainPay SDK — HTTP Client
+// All API communication goes through here.
+// The host app never touches this directly.
+
+import axios, { type AxiosInstance } from 'axios';
+import type { FPError } from '../types';
+
+const DEFAULT_BASE_URL = 'https://api.fountainpay.ng/sdk/detect/';
+
+let _client: AxiosInstance | null = null;
+
+export function initClient(apiKey: string, options: { baseUrl?: string; environment?: string } = {}): void {
+  _client = axios.create({
+    baseURL: options.baseUrl ?? DEFAULT_BASE_URL,
+    timeout: 30000,
+    headers: {
+      'Content-Type': 'application/json',
+      'x-api-key': apiKey,
+      'x-sdk': 'react-native-fountainpay-sdk',
+      'x-sdk-version': '1.0.0',
+      'x-env': options.environment ?? 'production',
+    },
+  });
+
+  _client.interceptors.response.use(
+    (r) => r,
+    (err) => {
+      const e: FPError = { code: 'UNKNOWN', message: 'An error occurred' };
+      if (!err.response) {
+        e.code = 'NETWORK_ERROR';
+        e.message = 'Network error. Check your connection.';
+      } else {
+        const d = err.response.data ?? {};
+        e.code = d.code ?? `HTTP_${err.response.status}`;
+        e.message = d.message ?? err.message;
+        e.statusCode = err.response.status;
+        if (err.response.status === 401) { e.code = 'INVALID_API_KEY'; e.message = 'Invalid API key.'; }
+      }
+      return Promise.reject(e);
+    }
+  );
+}
+
+export function http(): AxiosInstance {
+  if (!_client) throw new Error('[FountainPay] SDK not initialized. Call pay.initializeSDK() first.');
+  return _client;
+}

package/src/core/api/index.ts

@@ -0,0 +1,61 @@
+// FountainPay SDK — All API calls
+import { http } from "./client";
+import type {
+  FPVirtualAccount,
+  FPGenerateAccountRequest,
+  FPBankItem,
+  FPTransaction, 
+  FPNQRData, 
+  FPTxStatus, 
+  FPProximityPeer,
+} from "../types";
+
+export const walletAPI = {
+  generate: (req: FPGenerateAccountRequest) =>
+    http().post<FPVirtualAccount>("/v1/wallet/generate", req).then(r => r.data),
+
+  getBalance: (walletId: string) =>
+    http().get<{ balance: number; currency: string }>("/v1/wallet/" + walletId + "/balance").then(r => r.data),
+};
+
+export const transferAPI = {
+  getBanks: () =>
+    http().get<FPBankItem[]>("/v1/banks").then(r => r.data),
+
+  verifyAccount: (accountNumber: string, bankCode: string) =>
+    http().post<{ accountName: string; accountNumber: string; bankName: string; bankCode: string }>(
+      "/v1/transfer/verify-account", { accountNumber, bankCode }
+    ).then(r => r.data),
+
+  send: (payload: { accountNumber: string; bankCode: string; amount: number; narration?: string; reference?: string }) =>
+    http().post<{ reference: string; status: FPTxStatus; amount: number; currency: string; recipient: { accountName: string }; message: string; createdAt: string }>(
+      "/v1/transfer/initiate", payload
+    ).then(r => r.data),
+
+  status: (reference: string) =>
+    http().get<{ status: FPTxStatus; reference: string }>("/v1/transfer/" + reference + "/status").then(r => r.data),
+};
+
+export const nqrAPI = {
+  generate: (payload: { amount?: number; reference?: string; currency?: string; expiresInMinutes?: number }) =>
+    http().post<FPNQRData>("/v1/payment/nqr/generate", payload).then(r => r.data),
+
+  pay: (payload: { qrString: string; amount: number; currency: string }) =>
+    http().post<FPTransaction>("/v1/payment/nqr/pay", payload).then(r => r.data),
+};
+
+export const proximityAPI = {
+  broadcast: (payload: { latitude: number; longitude: number; accountName: string; accountNumber: string; bankCode: string; bankName: string }) =>
+    http().post<{ sessionId: string }>("/v1/proximity/broadcast", payload).then(r => r.data),
+
+  heartbeat: (sessionId: string, lat: number, lng: number) =>
+    http().patch("/v1/proximity/broadcast/" + sessionId, { latitude: lat, longitude: lng }),
+
+  unregister: (sessionId: string) =>
+    http().delete("/v1/proximity/broadcast/" + sessionId),
+
+  discover: (lat: number, lng: number, radiusMeters: number) =>
+    http().post<{ peers: FPProximityPeer[] }>(
+      "/v1/proximity/discover", { latitude: lat, longitude: lng, radiusMeters }
+    ).then(r => r.data.peers),
+};

package/src/core/types/index.ts

@@ -0,0 +1,144 @@
+// FountainPay SDK — Master Types
+
+import type { Device } from "react-native-ble-plx";
+
+export type FPCurrency = 'NGN' | 'USD' | 'GBP' | 'EUR' | string;
+export type FPChannel  = 'transfer' | 'nqr' | 'proximity' | 'bluetooth' | 'nfc';
+export type FPTxStatus = 'pending' | 'processing' | 'successful' | 'failed' | 'reversed';
+export type FPTxType   = 'debit' | 'credit';
+
+export interface FPUserInfo {
+  accountName: string;
+  accountNumber: string;
+  bankName: string;
+  bankCode: string;
+  phone?: string;
+  email?: string;
+  userId?: string;
+}
+
+export interface FPSDKOptions {
+  baseUrl?: string;
+  environment?: 'sandbox' | 'production';
+  proximityRadius?: number;
+  bluetoothDisplayName?: string;
+}
+
+export interface FPParty {
+  accountName: string;
+  accountNumber?: string;
+  bankName?: string;
+  bankCode?: string;
+  phone?: string;
+  email?: string;
+}
+
+export interface FPTransaction {
+  id: string;
+  reference: string;
+  type: FPTxType;
+  channel: FPChannel;
+  amount: number;
+  currency: FPCurrency;
+  status: FPTxStatus;
+  description?: string;
+  sender?: FPParty;
+  recipient?: FPParty;
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+}
+
+export interface FPGenerateAccountRequest {
+  accountName: string;
+  email?: string;
+  phone?: string;
+  reference?: string;
+  amount?: number;
+  currency?: FPCurrency;
+  expiresInMinutes?: number;
+  metadata?: Record<string, unknown>;
+}
+
+export interface FPVirtualAccount {
+  accountNumber: string;
+  accountName: string;
+  bankName: string;
+  bankCode: string;
+  currency: FPCurrency;
+  balance: number;
+  reference: string;
+  walletId: string;
+  qrCode?: string;
+  expiresAt?: string;
+  createdAt: string;
+}
+
+export interface FPBluetoothPaymentRequest {
+  requestId: string;
+  sender: FPParty & { deviceId: string; deviceName?: string };
+  amount: number;
+  currency: FPCurrency;
+  narration?: string;
+  timestamp: string;
+}
+
+export interface FPProximityPeer {
+  peerId: string;
+  displayName: string;
+  accountNumber: string;
+  bankCode: string;
+  bankName: string;
+  distance?: number;
+  lastSeen: string;
+}
+
+export interface FPNQRData {
+  qrString: string;
+  qrCodeImageBase64: string;
+  reference: string;
+  amount?: number;
+  currency?: FPCurrency;
+  expiresAt?: string;
+}
+
+export interface FPBankItem {
+  name: string;
+  code: string;
+  logo?: string;
+}
+
+export interface FPCallbacks {
+  onPaymentRequest?: (request: FPBluetoothPaymentRequest) => void;
+  onPaymentReceived?: (transaction: FPTransaction) => void;
+  onPaymentDeclined?: (request: FPBluetoothPaymentRequest) => void;
+  onPaymentSent?: (transaction: FPTransaction) => void;
+  onError?: (error: FPError) => void;
+}
+
+export interface FPError {
+  code: string;
+  message: string;
+  statusCode?: number;
+}
+
+export interface FPInstance {
+  initializeSDK: (user: FPUserInfo, callbacks?: FPCallbacks) => Promise<void>;
+  send: (amount: number, currency: FPCurrency) => void;
+  receive: (amount?: number, currency?: FPCurrency) => void;
+  generateAccountNumber: (request: FPGenerateAccountRequest) => Promise<FPVirtualAccount>;
+  listen: () => void;
+  destroy: () => void;
+  isReady: boolean;
+  currentUser: FPUserInfo | null;
+}
+
+
+export interface FintechDevice {
+  id: string;
+  name: string;
+  appName: string;
+  userName?: string;
+  rssi: number;
+  rawDevice: Device;
+  waiting?: boolean;
+}