react-native-fpay 0.1.1 → 0.2.2

package/lib/module/FountainPayProvider.js

@@ -1,17 +1,133 @@
 "use strict";
 
-// ─────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────────────────────────
 // FountainPayProvider
-// The ONLY thing the host app mounts.
-// Wraps children and mounts the invisible shell.
-// ─────────────────────────────────────────────
-import React from 'react';
+//
+// Mount once at the root of your app and pass your API key here.
+// Every component can then call useFountainPay() (no arguments) and get
+// the SAME instance — no re-initialization, no prop drilling.
+//
+// Usage:
+//   <FountainPayProvider apiKey="fp_live_...">
+//     <YourApp />
+//   </FountainPayProvider>
+// ─────────────────────────────────────────────────────────────────────────────
+import React, { createContext, useContext, useMemo, useRef } from 'react';
 import { FPShell } from "./ui/modals/FPShell.js";
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { FPEngine } from "./engine/FPEngine.js";
+import { initClient } from "./core/api/client.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// ── Context ───────────────────────────────────────────────────────────────────
+
+const FountainPayContext = /*#__PURE__*/createContext(null);
+
+// ── Hook — the only thing components import ───────────────────────────────────
+
+/**
+ * Returns the shared FountainPay instance created by the nearest
+ * <FountainPayProvider>. No API key needed here — it was given to the provider.
+ *
+ * Call from any component:
+ *   const pay = useFountainPay();
+ *   await pay.initializeSDK(user, callbacks);  // call once after login
+ *   pay.send(500, 'NGN');                       // call anywhere, anytime
+ */
+export function useFountainPay() {
+  const instance = useContext(FountainPayContext);
+  if (!instance) {
+    throw new Error('[FountainPay] useFountainPay() must be called inside <FountainPayProvider>.\n' + 'Make sure you have wrapped your app root with <FountainPayProvider apiKey="...">.');
+  }
+  return instance;
+}
+
+// ── Provider ──────────────────────────────────────────────────────────────────
+
 export function FountainPayProvider({
+  apiKey,
+  options,
   children
 }) {
-  return /*#__PURE__*/_jsxs(_Fragment, {
+  // Boot the HTTP client as soon as the provider mounts —
+  // this means generateAccountNumber works even before initializeSDK
+  const clientBooted = useRef(false);
+  if (!clientBooted.current) {
+    initClient(apiKey, {
+      baseUrl: options?.baseUrl,
+      environment: options?.environment
+    });
+    clientBooted.current = true;
+    console.log('[FountainPay] Provider mounted. HTTP client ready.');
+  }
+
+  // Build the instance once per provider lifetime.
+  // All components that call useFountainPay() share this exact object.
+  const instance = useMemo(() => {
+    console.log('[FountainPay] Creating shared FPInstance for apiKey:', apiKey.slice(0, 8) + '...');
+    return {
+      /**
+       * Call once after the user logs in.
+       * Starts BLE advertising, proximity broadcast, and the payment listener.
+       */
+      async initializeSDK(user, callbacks) {
+        console.log('[FountainPay] initializeSDK() called for user:', user.accountName);
+        try {
+          await FPEngine.initialize(apiKey, user, options ?? {}, callbacks ?? {});
+          console.log('[FountainPay] initializeSDK() complete. SDK is ready.');
+        } catch (err) {
+          console.error('[FountainPay] initializeSDK() FAILED:', err);
+          throw err;
+        }
+      },
+      /** Open the Send Money bottom sheet. */
+      send(amount, currency) {
+        console.log('[FountainPay] send() called:', amount, currency);
+        if (!FPEngine.isReady()) {
+          console.warn('[FountainPay] send() called before initializeSDK() — call initializeSDK first.');
+        }
+        FPEngine.showSend(amount, currency);
+      },
+      /** Open the Receive Money bottom sheet. */
+      receive(amount, currency = 'NGN') {
+        console.log('[FountainPay] receive() called:', amount, currency);
+        if (!FPEngine.isReady()) {
+          console.warn('[FountainPay] receive() called before initializeSDK().');
+        }
+        FPEngine.showReceive(amount, currency);
+      },
+      /** Generate a virtual account number (no UI shown). */
+      async generateAccountNumber(request) {
+        console.log('[FountainPay] generateAccountNumber() called:', request.accountName);
+        return FPEngine.generateAccount(request);
+      },
+      /**
+       * Activate the incoming Bluetooth payment request listener.
+       * When a nearby device sends a payment request, the Accept/Decline
+       * modal will appear automatically.
+       */
+      listen() {
+        console.log('[FountainPay] listen() called — activating BT payment listener.');
+        if (!FPEngine.isReady()) {
+          console.warn('[FountainPay] listen() called before initializeSDK().');
+        }
+        FPEngine.startListening();
+      },
+      /** Stop all background services. Call on logout. */
+      async destroy() {
+        console.log('[FountainPay] destroy() called — stopping all services.');
+        await FPEngine.destroy();
+        console.log('[FountainPay] All services stopped.');
+      },
+      get isReady() {
+        return FPEngine.isReady();
+      },
+      get currentUser() {
+        return FPEngine.getUser();
+      }
+    };
+    // Re-create instance only if the apiKey changes (which should never happen at runtime)
+  }, [apiKey]);
+  return /*#__PURE__*/_jsxs(FountainPayContext.Provider, {
+    value: instance,
     children: [children, /*#__PURE__*/_jsx(FPShell, {})]
   });
 }

package/lib/module/FountainPayProvider.js.map

@@ -1 +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":[]}
+{"version":3,"names":["React","createContext","useContext","useMemo","useRef","FPShell","FPEngine","initClient","jsx","_jsx","jsxs","_jsxs","FountainPayContext","useFountainPay","instance","Error","FountainPayProvider","apiKey","options","children","clientBooted","current","baseUrl","environment","console","log","slice","initializeSDK","user","callbacks","accountName","initialize","err","error","send","amount","currency","isReady","warn","showSend","receive","showReceive","generateAccountNumber","request","generateAccount","listen","startListening","destroy","currentUser","getUser","Provider","value"],"sourceRoot":"../../src","sources":["FountainPayProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/useFountainPay.js

@@ -1,82 +1,6 @@
 "use strict";
 
-// ─────────────────────────────────────────────────────────────
-// useFountainPay — The ONLY hook the host app ever uses.
-//
-// Usage:
-//   const pay = useFountainPay('your-api-key');
-//   await pay.initializeSDK(userInfo, callbacks);
-//   pay.send(500, 'NGN');
-//   pay.receive(200, 'NGN');
-//   const acct = await pay.generateAccountNumber({ accountName: 'John' });
-//   pay.listen();
-//   pay.destroy();
-// ─────────────────────────────────────────────────────────────
-import { useMemo } from 'react';
-import { FPEngine } from "./engine/FPEngine.js";
-import { initClient } from "./core/api/client.js";
-export function useFountainPay(apiKey, options) {
-  // Initialize HTTP client immediately so API calls can be made
-  // even before initializeSDK (e.g. generateAccountNumber for onboarding)
-  useMemo(() => {
-    initClient(apiKey, {
-      baseUrl: options?.baseUrl,
-      environment: options?.environment
-    });
-  }, [apiKey]);
-  const instance = useMemo(() => ({
-    /**
-     * Call this once after the user logs in.
-     * Starts proximity broadcasting, BLE peripheral, and BT listener.
-     */
-    async initializeSDK(user, callbacks) {
-      await FPEngine.initialize(apiKey, user, options ?? {}, callbacks ?? {});
-    },
-    /**
-     * Open the Send Money sheet.
-     * @param amount  Major denomination (e.g. 500 for NGN 500)
-     * @param currency e.g. 'NGN', 'USD'
-     */
-    send(amount, currency) {
-      FPEngine.showSend(amount, currency);
-    },
-    /**
-     * Open the Receive Money sheet.
-     * @param amount  Expected amount (optional)
-     * @param currency e.g. 'NGN'
-     */
-    receive(amount, currency = 'NGN') {
-      FPEngine.showReceive(amount, currency);
-    },
-    /**
-     * Generate a virtual account number.
-     * No UI is shown — returns the account directly.
-     */
-    async generateAccountNumber(request) {
-      return FPEngine.generateAccount(request);
-    },
-    /**
-     * Start listening for incoming Bluetooth payment requests.
-     * When one arrives, the SDK auto-shows the Accept/Decline modal.
-     * The result fires onPaymentReceived / onPaymentDeclined callbacks
-     * that were passed into initializeSDK.
-     */
-    listen() {
-      FPEngine.startListening();
-    },
-    /**
-     * Stop all background services. Call on logout.
-     */
-    destroy() {
-      FPEngine.destroy();
-    },
-    get isReady() {
-      return FPEngine.isReady();
-    },
-    get currentUser() {
-      return FPEngine.getUser();
-    }
-  }), [apiKey]);
-  return instance;
-}
+// useFountainPay re-exported from FountainPayProvider.
+// The hook lives in FountainPayProvider.tsx now.
+export { useFountainPay } from "./FountainPayProvider.js";
 //# sourceMappingURL=useFountainPay.js.map

package/lib/module/useFountainPay.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","FPEngine","initClient","useFountainPay","apiKey","options","baseUrl","environment","instance","initializeSDK","user","callbacks","initialize","send","amount","currency","showSend","receive","showReceive","generateAccountNumber","request","generateAccount","listen","startListening","destroy","isReady","currentUser","getUser"],"sourceRoot":"../../src","sources":["useFountainPay.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,QAAQ,QAAQ,sBAAmB;AAC5C,SAASC,UAAU,QAAQ,sBAAmB;AAW9C,OAAO,SAASC,cAAcA,CAACC,MAAc,EAAEC,OAAsB,EAAc;EACjF;EACA;EACAL,OAAO,CAAC,MAAM;IACZE,UAAU,CAACE,MAAM,EAAE;MAAEE,OAAO,EAAED,OAAO,EAAEC,OAAO;MAAEC,WAAW,EAAEF,OAAO,EAAEE;IAAY,CAAC,CAAC;EACtF,CAAC,EAAE,CAACH,MAAM,CAAC,CAAC;EAEZ,MAAMI,QAAQ,GAAGR,OAAO,CAAa,OAAO;IAC1C;AACJ;AACA;AACA;IACI,MAAMS,aAAaA,CAACC,IAAgB,EAAEC,SAAuB,EAAiB;MAC5E,MAAMV,QAAQ,CAACW,UAAU,CAACR,MAAM,EAAEM,IAAI,EAAEL,OAAO,IAAI,CAAC,CAAC,EAAEM,SAAS,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;AACJ;AACA;AACA;AACA;IACIE,IAAIA,CAACC,MAAc,EAAEC,QAAoB,EAAQ;MAC/Cd,QAAQ,CAACe,QAAQ,CAACF,MAAM,EAAEC,QAAQ,CAAC;IACrC,CAAC;IAED;AACJ;AACA;AACA;AACA;IACIE,OAAOA,CAACH,MAAe,EAAEC,QAAoB,GAAG,KAAK,EAAQ;MAC3Dd,QAAQ,CAACiB,WAAW,CAACJ,MAAM,EAAEC,QAAQ,CAAC;IACxC,CAAC;IAED;AACJ;AACA;AACA;IACI,MAAMI,qBAAqBA,CAACC,OAAiC,EAA6B;MACxF,OAAOnB,QAAQ,CAACoB,eAAe,CAACD,OAAO,CAAC;IAC1C,CAAC;IAED;AACJ;AACA;AACA;AACA;AACA;IACIE,MAAMA,CAAA,EAAS;MACbrB,QAAQ,CAACsB,cAAc,CAAC,CAAC;IAC3B,CAAC;IAED;AACJ;AACA;IACIC,OAAOA,CAAA,EAAS;MACdvB,QAAQ,CAACuB,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,IAAIC,OAAOA,CAAA,EAAY;MACrB,OAAOxB,QAAQ,CAACwB,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,IAAIC,WAAWA,CAAA,EAAsB;MACnC,OAAOzB,QAAQ,CAAC0B,OAAO,CAAC,CAAC;IAC3B;EACF,CAAC,CAAC,EAAE,CAACvB,MAAM,CAAC,CAAC;EAEb,OAAOI,QAAQ;AACjB","ignoreList":[]}
+{"version":3,"names":["useFountainPay"],"sourceRoot":"../../src","sources":["useFountainPay.ts"],"mappings":";;AAAA;AACA;AACA,SAASA,cAAc,QAAQ,0BAAuB","ignoreList":[]}

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

@@ -1,7 +1,20 @@
 import { type ReactNode } from 'react';
-interface Props {
+import type { FPInstance, FPSDKOptions } from './core/types';
+/**
+ * Returns the shared FountainPay instance created by the nearest
+ * <FountainPayProvider>. No API key needed here — it was given to the provider.
+ *
+ * Call from any component:
+ *   const pay = useFountainPay();
+ *   await pay.initializeSDK(user, callbacks);  // call once after login
+ *   pay.send(500, 'NGN');                       // call anywhere, anytime
+ */
+export declare function useFountainPay(): FPInstance;
+interface ProviderProps {
+    apiKey: string;
+    options?: FPSDKOptions;
     children: ReactNode;
 }
-export declare function FountainPayProvider({ children }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function FountainPayProvider({ apiKey, options, children }: ProviderProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=FountainPayProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FountainPayProvider.d.ts","sourceRoot":"","sources":["../../../src/FountainPayProvider.tsx"],"names":[],"mappings":"AAKA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG9C,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,2CAQtD"}
+{"version":3,"file":"FountainPayProvider.d.ts","sourceRoot":"","sources":["../../../src/FountainPayProvider.tsx"],"names":[],"mappings":"AAYA,OAAc,EACZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EAKb,MAAM,cAAc,CAAC;AAQtB;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAS3C;AAID,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,aAAa,2CA6F/E"}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"useFountainPay.d.ts","sourceRoot":"","sources":["../../../src/useFountainPay.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-fpay",
-  "version": "0.1.1",
+  "version": "0.2.2",
   "description": "Fountain Pay react-native sdk library",
   "main": "./lib/module/index.js",
   "module": "./lib/module/index.js",

package/src/FountainPayProvider.tsx

@@ -1,21 +1,156 @@
-// ─────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────────────────────────
 // FountainPayProvider
-// The ONLY thing the host app mounts.
-// Wraps children and mounts the invisible shell.
-// ─────────────────────────────────────────────
-import React, { type ReactNode } from 'react';
+//
+// Mount once at the root of your app and pass your API key here.
+// Every component can then call useFountainPay() (no arguments) and get
+// the SAME instance — no re-initialization, no prop drilling.
+//
+// Usage:
+//   <FountainPayProvider apiKey="fp_live_...">
+//     <YourApp />
+//   </FountainPayProvider>
+// ─────────────────────────────────────────────────────────────────────────────
+import React, {
+  type ReactNode, createContext, useContext, useMemo, useRef,
+} from 'react';
 import { FPShell } from './ui/modals/FPShell';
+import { FPEngine } from './engine/FPEngine';
+import { initClient } from './core/api/client';
+import type {
+  FPInstance, 
+  FPUserInfo, 
+  FPSDKOptions, 
+  FPCallbacks,
+  FPCurrency, 
+  FPGenerateAccountRequest, 
+  FPVirtualAccount,
+} from './core/types';
 
-interface Props {
+// ── Context ───────────────────────────────────────────────────────────────────
+
+const FountainPayContext = createContext<FPInstance | null>(null);
+
+// ── Hook — the only thing components import ───────────────────────────────────
+
+/**
+ * Returns the shared FountainPay instance created by the nearest
+ * <FountainPayProvider>. No API key needed here — it was given to the provider.
+ *
+ * Call from any component:
+ *   const pay = useFountainPay();
+ *   await pay.initializeSDK(user, callbacks);  // call once after login
+ *   pay.send(500, 'NGN');                       // call anywhere, anytime
+ */
+export function useFountainPay(): FPInstance {
+  const instance = useContext(FountainPayContext);
+  if (!instance) {
+    throw new Error(
+      '[FountainPay] useFountainPay() must be called inside <FountainPayProvider>.\n' +
+      'Make sure you have wrapped your app root with <FountainPayProvider apiKey="...">.'
+    );
+  }
+  return instance;
+}
+
+// ── Provider ──────────────────────────────────────────────────────────────────
+
+interface ProviderProps {
+  apiKey: string;
+  options?: FPSDKOptions;
   children: ReactNode;
 }
 
-export function FountainPayProvider({ children }: Props) {
+export function FountainPayProvider({ apiKey, options, children }: ProviderProps) {
+  // Boot the HTTP client as soon as the provider mounts —
+  // this means generateAccountNumber works even before initializeSDK
+  const clientBooted = useRef(false);
+  if (!clientBooted.current) {
+    initClient(apiKey, { baseUrl: options?.baseUrl, environment: options?.environment });
+    clientBooted.current = true;
+    console.log('[FountainPay] Provider mounted. HTTP client ready.');
+  }
+
+  // Build the instance once per provider lifetime.
+  // All components that call useFountainPay() share this exact object.
+  const instance = useMemo<FPInstance>(() => {
+    console.log('[FountainPay] Creating shared FPInstance for apiKey:', apiKey.slice(0, 8) + '...');
+
+    return {
+      /**
+       * Call once after the user logs in.
+       * Starts BLE advertising, proximity broadcast, and the payment listener.
+       */
+      async initializeSDK(user: FPUserInfo, callbacks?: FPCallbacks): Promise<void> {
+        console.log('[FountainPay] initializeSDK() called for user:', user.accountName);
+        try {
+          await FPEngine.initialize(apiKey, user, options ?? {}, callbacks ?? {});
+          console.log('[FountainPay] initializeSDK() complete. SDK is ready.');
+        } catch (err) {
+          console.error('[FountainPay] initializeSDK() FAILED:', err);
+          throw err;
+        }
+      },
+
+      /** Open the Send Money bottom sheet. */
+      send(amount: number, currency: FPCurrency): void {
+        console.log('[FountainPay] send() called:', amount, currency);
+        if (!FPEngine.isReady()) {
+          console.warn('[FountainPay] send() called before initializeSDK() — call initializeSDK first.');
+        }
+        FPEngine.showSend(amount, currency);
+      },
+
+      /** Open the Receive Money bottom sheet. */
+      receive(amount?: number, currency: FPCurrency = 'NGN'): void {
+        console.log('[FountainPay] receive() called:', amount, currency);
+        if (!FPEngine.isReady()) {
+          console.warn('[FountainPay] receive() called before initializeSDK().');
+        }
+        FPEngine.showReceive(amount, currency);
+      },
+
+      /** Generate a virtual account number (no UI shown). */
+      async generateAccountNumber(request: FPGenerateAccountRequest): Promise<FPVirtualAccount> {
+        console.log('[FountainPay] generateAccountNumber() called:', request.accountName);
+        return FPEngine.generateAccount(request);
+      },
+
+      /**
+       * Activate the incoming Bluetooth payment request listener.
+       * When a nearby device sends a payment request, the Accept/Decline
+       * modal will appear automatically.
+       */
+      listen(): void {
+        console.log('[FountainPay] listen() called — activating BT payment listener.');
+        if (!FPEngine.isReady()) {
+          console.warn('[FountainPay] listen() called before initializeSDK().');
+        }
+        FPEngine.startListening();
+      },
+
+      /** Stop all background services. Call on logout. */
+      async destroy(): Promise<void> {
+        console.log('[FountainPay] destroy() called — stopping all services.');
+        await FPEngine.destroy();
+        console.log('[FountainPay] All services stopped.');
+      },
+
+      get isReady(): boolean {
+        return FPEngine.isReady();
+      },
+
+      get currentUser(): FPUserInfo | null {
+        return FPEngine.getUser();
+      },
+    };
+  // Re-create instance only if the apiKey changes (which should never happen at runtime)
+  }, [apiKey]);
+
   return (
-    <>
+    <FountainPayContext.Provider value={instance}>
       {children}
-      {/* FPShell is invisible until pay.send() or pay.receive() is called */}
+      {/* FPShell is invisible until pay.send() or pay.receive() fires */}
       <FPShell />
-    </>
+    </FountainPayContext.Provider>
   );
 }

package/src/useFountainPay.ts

@@ -1,95 +1,3 @@
-// ─────────────────────────────────────────────────────────────
-// useFountainPay — The ONLY hook the host app ever uses.
-//
-// Usage:
-//   const pay = useFountainPay('your-api-key');
-//   await pay.initializeSDK(userInfo, callbacks);
-//   pay.send(500, 'NGN');
-//   pay.receive(200, 'NGN');
-//   const acct = await pay.generateAccountNumber({ accountName: 'John' });
-//   pay.listen();
-//   pay.destroy();
-// ─────────────────────────────────────────────────────────────
-import { useMemo } from 'react';
-import { FPEngine } from './engine/FPEngine';
-import { initClient } from './core/api/client';
-import type {
-  FPInstance, 
-  FPUserInfo, 
-  FPSDKOptions, 
-  FPCallbacks,
-  FPCurrency, 
-  FPGenerateAccountRequest, 
-  FPVirtualAccount,
-} from './core/types';
-
-export function useFountainPay(apiKey: string, options?: FPSDKOptions): FPInstance {
-  // Initialize HTTP client immediately so API calls can be made
-  // even before initializeSDK (e.g. generateAccountNumber for onboarding)
-  useMemo(() => {
-    initClient(apiKey, { baseUrl: options?.baseUrl, environment: options?.environment });
-  }, [apiKey]);
-
-  const instance = useMemo<FPInstance>(() => ({
-    /**
-     * Call this once after the user logs in.
-     * Starts proximity broadcasting, BLE peripheral, and BT listener.
-     */
-    async initializeSDK(user: FPUserInfo, callbacks?: FPCallbacks): Promise<void> {
-      await FPEngine.initialize(apiKey, user, options ?? {}, callbacks ?? {});
-    },
-
-    /**
-     * Open the Send Money sheet.
-     * @param amount  Major denomination (e.g. 500 for NGN 500)
-     * @param currency e.g. 'NGN', 'USD'
-     */
-    send(amount: number, currency: FPCurrency): void {
-      FPEngine.showSend(amount, currency);
-    },
-
-    /**
-     * Open the Receive Money sheet.
-     * @param amount  Expected amount (optional)
-     * @param currency e.g. 'NGN'
-     */
-    receive(amount?: number, currency: FPCurrency = 'NGN'): void {
-      FPEngine.showReceive(amount, currency);
-    },
-
-    /**
-     * Generate a virtual account number.
-     * No UI is shown — returns the account directly.
-     */
-    async generateAccountNumber(request: FPGenerateAccountRequest): Promise<FPVirtualAccount> {
-      return FPEngine.generateAccount(request);
-    },
-
-    /**
-     * Start listening for incoming Bluetooth payment requests.
-     * When one arrives, the SDK auto-shows the Accept/Decline modal.
-     * The result fires onPaymentReceived / onPaymentDeclined callbacks
-     * that were passed into initializeSDK.
-     */
-    listen(): void {
-      FPEngine.startListening();
-    },
-
-    /**
-     * Stop all background services. Call on logout.
-     */
-    destroy(): void {
-      FPEngine.destroy();
-    },
-
-    get isReady(): boolean {
-      return FPEngine.isReady();
-    },
-
-    get currentUser(): FPUserInfo | null {
-      return FPEngine.getUser();
-    },
-  }), [apiKey]);
-
-  return instance;
-}
+// useFountainPay re-exported from FountainPayProvider.
+// The hook lives in FountainPayProvider.tsx now.
+export { useFountainPay } from './FountainPayProvider';