react-native-fpay 0.1.1

package/Fpay.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Fpay"
+  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/adewumiadedeji/react-native-fpay.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Adedeji RIchards
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# react-native-fpay
+
+Fountain Pay react-native sdk library
+
+## Installation
+
+
+```sh
+npm install react-native-fpay
+```
+
+
+## Usage
+
+
+```js
+import { multiply } from 'react-native-fpay';
+
+// ...
+
+const result = multiply(3, 7);
+```
+
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,67 @@
+buildscript {
+  ext.Fpay = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return Fpay[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.fpay"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/fpay/FpayModule.kt

@@ -0,0 +1,15 @@
+package com.fpay
+
+import com.facebook.react.bridge.ReactApplicationContext
+
+class FpayModule(reactContext: ReactApplicationContext) :
+  NativeFpaySpec(reactContext) {
+
+  override fun multiply(a: Double, b: Double): Double {
+    return a * b
+  }
+
+  companion object {
+    const val NAME = NativeFpaySpec.NAME
+  }
+}

package/android/src/main/java/com/fpay/FpayPackage.kt

@@ -0,0 +1,31 @@
+package com.fpay
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class FpayPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == FpayModule.NAME) {
+      FpayModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      FpayModule.NAME to ReactModuleInfo(
+        name = FpayModule.NAME,
+        className = FpayModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+    )
+  }
+}

package/ios/Fpay.h

@@ -0,0 +1,5 @@
+#import <FpaySpec/FpaySpec.h>
+
+@interface Fpay : NSObject <NativeFpaySpec>
+
+@end

package/ios/Fpay.mm

@@ -0,0 +1,21 @@
+#import "Fpay.h"
+
+@implementation Fpay
+- (NSNumber *)multiply:(double)a b:(double)b {
+    NSNumber *result = @(a * b);
+
+    return result;
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeFpaySpecJSI>(params);
+}
+
++ (NSString *)moduleName
+{
+  return @"Fpay";
+}
+
+@end

package/lib/module/FountainPayProvider.js

@@ -0,0 +1,18 @@
+"use strict";
+
+// ─────────────────────────────────────────────
+// FountainPayProvider
+// The ONLY thing the host app mounts.
+// Wraps children and mounts the invisible shell.
+// ─────────────────────────────────────────────
+import React from 'react';
+import { FPShell } from "./ui/modals/FPShell.js";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+export function FountainPayProvider({
+  children
+}) {
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [children, /*#__PURE__*/_jsx(FPShell, {})]
+  });
+}
+//# sourceMappingURL=FountainPayProvider.js.map

package/lib/module/FountainPayProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","FPShell","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","FountainPayProvider","children"],"sourceRoot":"../../src","sources":["FountainPayProvider.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,OAAOA,KAAK,MAA0B,OAAO;AAC7C,SAASC,OAAO,QAAQ,wBAAqB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,QAAA,IAAAC,SAAA,EAAAC,IAAA,IAAAC,KAAA;AAM9C,OAAO,SAASC,mBAAmBA,CAAC;EAAEC;AAAgB,CAAC,EAAE;EACvD,oBACEF,KAAA,CAAAF,SAAA;IAAAI,QAAA,GACGA,QAAQ,eAETN,IAAA,CAACF,OAAO,IAAE,CAAC;EAAA,CACX,CAAC;AAEP","ignoreList":[]}

package/lib/module/core/api/client.js

@@ -0,0 +1,47 @@
+"use strict";
+
+// FountainPay SDK — HTTP Client
+// All API communication goes through here.
+// The host app never touches this directly.
+
+import axios from 'axios';
+const DEFAULT_BASE_URL = 'https://api.fountainpay.ng/sdk/detect/';
+let _client = null;
+export function initClient(apiKey, options = {}) {
+  _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 = {
+      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() {
+  if (!_client) throw new Error('[FountainPay] SDK not initialized. Call pay.initializeSDK() first.');
+  return _client;
+}
+//# sourceMappingURL=client.js.map

package/lib/module/core/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["axios","DEFAULT_BASE_URL","_client","initClient","apiKey","options","create","baseURL","baseUrl","timeout","headers","environment","interceptors","response","use","r","err","e","code","message","d","data","status","statusCode","Promise","reject","http","Error"],"sourceRoot":"../../../../src","sources":["core/api/client.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,OAAOA,KAAK,MAA8B,OAAO;AAGjD,MAAMC,gBAAgB,GAAG,wCAAwC;AAEjE,IAAIC,OAA6B,GAAG,IAAI;AAExC,OAAO,SAASC,UAAUA,CAACC,MAAc,EAAEC,OAAmD,GAAG,CAAC,CAAC,EAAQ;EACzGH,OAAO,GAAGF,KAAK,CAACM,MAAM,CAAC;IACrBC,OAAO,EAAEF,OAAO,CAACG,OAAO,IAAIP,gBAAgB;IAC5CQ,OAAO,EAAE,KAAK;IACdC,OAAO,EAAE;MACP,cAAc,EAAE,kBAAkB;MAClC,WAAW,EAAEN,MAAM;MACnB,OAAO,EAAE,8BAA8B;MACvC,eAAe,EAAE,OAAO;MACxB,OAAO,EAAEC,OAAO,CAACM,WAAW,IAAI;IAClC;EACF,CAAC,CAAC;EAEFT,OAAO,CAACU,YAAY,CAACC,QAAQ,CAACC,GAAG,CAC9BC,CAAC,IAAKA,CAAC,EACPC,GAAG,IAAK;IACP,MAAMC,CAAU,GAAG;MAAEC,IAAI,EAAE,SAAS;MAAEC,OAAO,EAAE;IAAoB,CAAC;IACpE,IAAI,CAACH,GAAG,CAACH,QAAQ,EAAE;MACjBI,CAAC,CAACC,IAAI,GAAG,eAAe;MACxBD,CAAC,CAACE,OAAO,GAAG,uCAAuC;IACrD,CAAC,MAAM;MACL,MAAMC,CAAC,GAAGJ,GAAG,CAACH,QAAQ,CAACQ,IAAI,IAAI,CAAC,CAAC;MACjCJ,CAAC,CAACC,IAAI,GAAGE,CAAC,CAACF,IAAI,IAAI,QAAQF,GAAG,CAACH,QAAQ,CAACS,MAAM,EAAE;MAChDL,CAAC,CAACE,OAAO,GAAGC,CAAC,CAACD,OAAO,IAAIH,GAAG,CAACG,OAAO;MACpCF,CAAC,CAACM,UAAU,GAAGP,GAAG,CAACH,QAAQ,CAACS,MAAM;MAClC,IAAIN,GAAG,CAACH,QAAQ,CAACS,MAAM,KAAK,GAAG,EAAE;QAAEL,CAAC,CAACC,IAAI,GAAG,iBAAiB;QAAED,CAAC,CAACE,OAAO,GAAG,kBAAkB;MAAE;IACjG;IACA,OAAOK,OAAO,CAACC,MAAM,CAACR,CAAC,CAAC;EAC1B,CACF,CAAC;AACH;AAEA,OAAO,SAASS,IAAIA,CAAA,EAAkB;EACpC,IAAI,CAACxB,OAAO,EAAE,MAAM,IAAIyB,KAAK,CAAC,oEAAoE,CAAC;EACnG,OAAOzB,OAAO;AAChB","ignoreList":[]}

package/lib/module/core/api/index.js

@@ -0,0 +1,35 @@
+"use strict";
+
+// FountainPay SDK — All API calls
+import { http } from "./client.js";
+export const walletAPI = {
+  generate: req => http().post("/v1/wallet/generate", req).then(r => r.data),
+  getBalance: walletId => http().get("/v1/wallet/" + walletId + "/balance").then(r => r.data)
+};
+export const transferAPI = {
+  getBanks: () => http().get("/v1/banks").then(r => r.data),
+  verifyAccount: (accountNumber, bankCode) => http().post("/v1/transfer/verify-account", {
+    accountNumber,
+    bankCode
+  }).then(r => r.data),
+  send: payload => http().post("/v1/transfer/initiate", payload).then(r => r.data),
+  status: reference => http().get("/v1/transfer/" + reference + "/status").then(r => r.data)
+};
+export const nqrAPI = {
+  generate: payload => http().post("/v1/payment/nqr/generate", payload).then(r => r.data),
+  pay: payload => http().post("/v1/payment/nqr/pay", payload).then(r => r.data)
+};
+export const proximityAPI = {
+  broadcast: payload => http().post("/v1/proximity/broadcast", payload).then(r => r.data),
+  heartbeat: (sessionId, lat, lng) => http().patch("/v1/proximity/broadcast/" + sessionId, {
+    latitude: lat,
+    longitude: lng
+  }),
+  unregister: sessionId => http().delete("/v1/proximity/broadcast/" + sessionId),
+  discover: (lat, lng, radiusMeters) => http().post("/v1/proximity/discover", {
+    latitude: lat,
+    longitude: lng,
+    radiusMeters
+  }).then(r => r.data.peers)
+};
+//# sourceMappingURL=index.js.map

package/lib/module/core/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["http","walletAPI","generate","req","post","then","r","data","getBalance","walletId","get","transferAPI","getBanks","verifyAccount","accountNumber","bankCode","send","payload","status","reference","nqrAPI","pay","proximityAPI","broadcast","heartbeat","sessionId","lat","lng","patch","latitude","longitude","unregister","delete","discover","radiusMeters","peers"],"sourceRoot":"../../../../src","sources":["core/api/index.ts"],"mappings":";;AAAA;AACA,SAASA,IAAI,QAAQ,aAAU;AAW/B,OAAO,MAAMC,SAAS,GAAG;EACvBC,QAAQ,EAAGC,GAA6B,IACtCH,IAAI,CAAC,CAAC,CAACI,IAAI,CAAmB,qBAAqB,EAAED,GAAG,CAAC,CAACE,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC;EAE7EC,UAAU,EAAGC,QAAgB,IAC3BT,IAAI,CAAC,CAAC,CAACU,GAAG,CAAwC,aAAa,GAAGD,QAAQ,GAAG,UAAU,CAAC,CAACJ,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI;AAC7G,CAAC;AAED,OAAO,MAAMI,WAAW,GAAG;EACzBC,QAAQ,EAAEA,CAAA,KACRZ,IAAI,CAAC,CAAC,CAACU,GAAG,CAAe,WAAW,CAAC,CAACL,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC;EAEzDM,aAAa,EAAEA,CAACC,aAAqB,EAAEC,QAAgB,KACrDf,IAAI,CAAC,CAAC,CAACI,IAAI,CACT,6BAA6B,EAAE;IAAEU,aAAa;IAAEC;EAAS,CAC3D,CAAC,CAACV,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC;EAErBS,IAAI,EAAGC,OAA4G,IACjHjB,IAAI,CAAC,CAAC,CAACI,IAAI,CACT,uBAAuB,EAAEa,OAC3B,CAAC,CAACZ,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC;EAErBW,MAAM,EAAGC,SAAiB,IACxBnB,IAAI,CAAC,CAAC,CAACU,GAAG,CAA4C,eAAe,GAAGS,SAAS,GAAG,SAAS,CAAC,CAACd,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI;AACnH,CAAC;AAED,OAAO,MAAMa,MAAM,GAAG;EACpBlB,QAAQ,EAAGe,OAA8F,IACvGjB,IAAI,CAAC,CAAC,CAACI,IAAI,CAAY,0BAA0B,EAAEa,OAAO,CAAC,CAACZ,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC;EAE/Ec,GAAG,EAAGJ,OAA+D,IACnEjB,IAAI,CAAC,CAAC,CAACI,IAAI,CAAgB,qBAAqB,EAAEa,OAAO,CAAC,CAACZ,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI;AAC/E,CAAC;AAED,OAAO,MAAMe,YAAY,GAAG;EAC1BC,SAAS,EAAGN,OAAgI,IAC1IjB,IAAI,CAAC,CAAC,CAACI,IAAI,CAAwB,yBAAyB,EAAEa,OAAO,CAAC,CAACZ,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC;EAE1FiB,SAAS,EAAEA,CAACC,SAAiB,EAAEC,GAAW,EAAEC,GAAW,KACrD3B,IAAI,CAAC,CAAC,CAAC4B,KAAK,CAAC,0BAA0B,GAAGH,SAAS,EAAE;IAAEI,QAAQ,EAAEH,GAAG;IAAEI,SAAS,EAAEH;EAAI,CAAC,CAAC;EAEzFI,UAAU,EAAGN,SAAiB,IAC5BzB,IAAI,CAAC,CAAC,CAACgC,MAAM,CAAC,0BAA0B,GAAGP,SAAS,CAAC;EAEvDQ,QAAQ,EAAEA,CAACP,GAAW,EAAEC,GAAW,EAAEO,YAAoB,KACvDlC,IAAI,CAAC,CAAC,CAACI,IAAI,CACT,wBAAwB,EAAE;IAAEyB,QAAQ,EAAEH,GAAG;IAAEI,SAAS,EAAEH,GAAG;IAAEO;EAAa,CAC1E,CAAC,CAAC7B,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,IAAI,CAAC4B,KAAK;AAC5B,CAAC","ignoreList":[]}

package/lib/module/core/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=index.js.map

package/lib/module/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["core/types/index.ts"],"mappings":"","ignoreList":[]}

package/lib/module/engine/BLEReceiverService.js

@@ -0,0 +1,190 @@
+"use strict";
+
+// FPay SDK — BLEReceiverService (Peripheral)
+// Ported directly from your BLEReceiverService.ts.
+// Same UUIDs, same event ordering, same write handler, same response flow.
+// Only changes: removed useBoundStore dependency, appName is 'FountainPay'.
+
+import { PermissionsAndroid, Platform } from 'react-native';
+import Peripheral, { Permission, Property } from 'react-native-multi-ble-peripheral';
+import { Buffer } from 'buffer';
+
+// ── UUIDs — shared with BLESenderService ─────────────────────
+export const FP_SERVICE_UUID = 'E8E66D12-C217-425A-AB36-DDBA22F22A5D';
+export const FP_REQUEST_CHAR_UUID = 'E1CC0349-343A-4E12-A4EF-CF69A681EE86';
+export const FP_RESPONSE_CHAR_UUID = 'DA9318CA-C740-4951-9C7C-5747FE002EF9';
+export const FP_USERINFO_CHAR_UUID = '933CA5AE-4D53-4CF4-864A-2FF51AFA05E9';
+
+// ── Types ─────────────────────────────────────────────────────
+
+// ── Class ─────────────────────────────────────────────────────
+
+class BLEReceiverService {
+  peripheral = null;
+  isAdvertising = false;
+  onRequestCallback = null;
+  userInfo = {
+    appName: 'FountainPay',
+    userName: '',
+    userId: ''
+  };
+
+  // ── Init ───────────────────────────────────────────────────
+
+  async initializeWithUserInfo(userId, userName, appName = 'FountainPay') {
+    this.userInfo = {
+      userId,
+      userName,
+      appName
+    };
+    await this._requestPermissions();
+  }
+  async _requestPermissions() {
+    if (Platform.OS !== 'android') return true;
+    if (Platform.Version >= 31) {
+      const results = await PermissionsAndroid.requestMultiple([PermissionsAndroid.PERMISSIONS.BLUETOOTH_ADVERTISE, PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT, PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION]);
+      return Object.values(results).every(r => r === PermissionsAndroid.RESULTS.GRANTED);
+    }
+    const granted = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION);
+    return granted === PermissionsAndroid.RESULTS.GRANTED;
+  }
+
+  // ── Advertising ────────────────────────────────────────────
+
+  async startAdvertising() {
+    if (this.isAdvertising) {
+      console.log('[FPay BLE Receiver] Already advertising');
+      return;
+    }
+    this.peripheral = new Peripheral();
+
+    // CRITICAL: Register event listeners BEFORE the 'ready' event fires.
+    // This mirrors your original code exactly — if you set up listeners
+    // inside the 'ready' callback, write events that fire immediately after
+    // setup can be missed.
+    this._setupEventListeners();
+    await new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => reject(new Error('[FPay BLE Receiver] Setup timeout (10s)')), 10000);
+      this.peripheral.on('ready', async () => {
+        try {
+          clearTimeout(timeout);
+          console.log('[FPay BLE Receiver] Peripheral ready');
+          await Peripheral.setDeviceName(this.userInfo.userName);
+          console.log('[FPay BLE Receiver] Device name set:', this.userInfo.userName);
+          await this.peripheral.addService(FP_SERVICE_UUID, true);
+
+          // User info characteristic — READ only.
+          // Sender reads this to get display name and userId.
+          const userInfoPayload = JSON.stringify({
+            appName: this.userInfo.appName,
+            userName: this.userInfo.userName,
+            userId: this.userInfo.userId
+          });
+          await this.peripheral.addCharacteristic(FP_SERVICE_UUID, FP_USERINFO_CHAR_UUID, Property.READ, Permission.READABLE);
+          await this.peripheral.updateValue(FP_SERVICE_UUID, FP_USERINFO_CHAR_UUID, Buffer.from(userInfoPayload));
+
+          // Payment request characteristic — WRITE / WRITE_NO_RESPONSE.
+          // Sender writes the payment request JSON here.
+          await this.peripheral.addCharacteristic(FP_SERVICE_UUID, FP_REQUEST_CHAR_UUID, Property.WRITE | Property.WRITE_NO_RESPONSE, Permission.WRITEABLE);
+
+          // Payment response characteristic — READ + NOTIFY.
+          // Receiver writes accept/decline here; sender polls or subscribes.
+          await this.peripheral.addCharacteristic(FP_SERVICE_UUID, FP_RESPONSE_CHAR_UUID, Property.READ | Property.NOTIFY, Permission.READABLE);
+          // Seed a default value so the characteristic is always readable
+          // (prevents "characteristic not found" errors on first poll)
+          await this.peripheral.updateValue(FP_SERVICE_UUID, FP_RESPONSE_CHAR_UUID, Buffer.from(JSON.stringify({
+            accepted: false,
+            timestamp: 0
+          })));
+          await this.peripheral.startAdvertising({
+            serviceUuids: [FP_SERVICE_UUID],
+            includeDeviceName: true
+          });
+          this.isAdvertising = true;
+          console.log('[FPay BLE Receiver] Advertising as "' + this.userInfo.userName + '"');
+          resolve();
+        } catch (err) {
+          clearTimeout(timeout);
+          console.error('[FPay BLE Receiver] Setup error:', err);
+          reject(err);
+        }
+      });
+    });
+  }
+
+  // ── Event handling ─────────────────────────────────────────
+
+  _setupEventListeners() {
+    if (!this.peripheral) return;
+    this.peripheral.on('write', data => {
+      console.log('[FPay BLE Receiver] Write event received');
+      if (data?.value) {
+        this._handlePaymentRequest(data);
+      } else {
+        console.warn('[FPay BLE Receiver] Write event had no value');
+      }
+    });
+    this.peripheral.on('read', () => console.log('[FPay BLE Receiver] Read event'));
+    this.peripheral.on('subscribe', () => console.log('[FPay BLE Receiver] Central subscribed'));
+    this.peripheral.on('unsubscribe', () => console.log('[FPay BLE Receiver] Central unsubscribed'));
+  }
+  _handlePaymentRequest(data) {
+    try {
+      let decoded;
+
+      // Handle all value formats the peripheral library may return
+      if (typeof data.value === 'string') {
+        decoded = Buffer.from(data.value, 'base64').toString('utf8');
+      } else if (Buffer.isBuffer(data.value)) {
+        decoded = data.value.toString('utf8');
+      } else if (Array.isArray(data.value)) {
+        decoded = Buffer.from(data.value).toString('utf8');
+      } else {
+        console.warn('[FPay BLE Receiver] Unknown value format:', typeof data.value);
+        return;
+      }
+      const request = JSON.parse(decoded);
+      const deviceId = request.senderId?.toString() ?? 'unknown';
+      console.log('[FPay BLE Receiver] Payment request parsed:', request.senderName, request.currency + request.amount);
+      if (this.onRequestCallback) {
+        this.onRequestCallback(request, deviceId);
+      } else {
+        console.warn('[FPay BLE Receiver] No callback registered — request dropped');
+      }
+    } catch (err) {
+      console.error('[FPay BLE Receiver] Failed to parse payment request:', err);
+    }
+  }
+
+  // ── Public API ─────────────────────────────────────────────
+
+  listenForPaymentRequests(callback) {
+    this.onRequestCallback = callback;
+    console.log('[FPay BLE Receiver] Payment request listener registered');
+  }
+  async sendPaymentResponse(response) {
+    if (!this.peripheral || !this.isAdvertising) {
+      throw new Error('[FPay BLE Receiver] Cannot send response — not advertising');
+    }
+    const buffer = Buffer.from(JSON.stringify(response));
+    await this.peripheral.updateValue(FP_SERVICE_UUID, FP_RESPONSE_CHAR_UUID, buffer);
+    console.log('[FPay BLE Receiver] Response sent:', response.accepted ? 'ACCEPTED' : 'DECLINED');
+  }
+  async stopAdvertising() {
+    if (this.peripheral && this.isAdvertising) {
+      await this.peripheral.stopAdvertising();
+      this.isAdvertising = false;
+      console.log('[FPay BLE Receiver] Stopped advertising');
+    }
+  }
+  getIsAdvertising() {
+    return this.isAdvertising;
+  }
+  destroy() {
+    this.stopAdvertising();
+    this.peripheral = null;
+    this.onRequestCallback = null;
+  }
+}
+export default new BLEReceiverService();
+//# sourceMappingURL=BLEReceiverService.js.map

package/lib/module/engine/BLEReceiverService.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PermissionsAndroid","Platform","Peripheral","Permission","Property","Buffer","FP_SERVICE_UUID","FP_REQUEST_CHAR_UUID","FP_RESPONSE_CHAR_UUID","FP_USERINFO_CHAR_UUID","BLEReceiverService","peripheral","isAdvertising","onRequestCallback","userInfo","appName","userName","userId","initializeWithUserInfo","_requestPermissions","OS","Version","results","requestMultiple","PERMISSIONS","BLUETOOTH_ADVERTISE","BLUETOOTH_CONNECT","ACCESS_FINE_LOCATION","Object","values","every","r","RESULTS","GRANTED","granted","request","startAdvertising","console","log","_setupEventListeners","Promise","resolve","reject","timeout","setTimeout","Error","on","clearTimeout","setDeviceName","addService","userInfoPayload","JSON","stringify","addCharacteristic","READ","READABLE","updateValue","from","WRITE","WRITE_NO_RESPONSE","WRITEABLE","NOTIFY","accepted","timestamp","serviceUuids","includeDeviceName","err","error","data","value","_handlePaymentRequest","warn","decoded","toString","isBuffer","Array","isArray","parse","deviceId","senderId","senderName","currency","amount","listenForPaymentRequests","callback","sendPaymentResponse","response","buffer","stopAdvertising","getIsAdvertising","destroy"],"sourceRoot":"../../../src","sources":["engine/BLEReceiverService.ts"],"mappings":"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","ignoreList":[]}