@glomopay/react-native-sdk 2.0.2 → 3.0.1

package/lib/use-lrs-checkout.d.ts

@@ -1,11 +1,16 @@
 /** Main SDK hook for the GlomoPay LRS Checkout flow */
 import React from "react";
 import { type NativeSyntheticEvent } from "react-native";
-import { WebViewNavigation, WebViewMessageEvent, type WebView } from "react-native-webview";
-import { type GlomoLrsServer } from "./config/base";
+import { type WebViewNavigation, type WebViewMessageEvent, type WebView } from "react-native-webview";
+import { type GlomoServer } from "./config/base";
 import { type SdkError } from "./utils/analytics";
 /** LRS checkout statuses */
-export type LrsCheckoutStatus = "ready" | "payment_in_progress" | "payment_successful" | "payment_failed" | "payment_cancelled";
+export type LrsCheckoutStatus = "ready" | "payment_in_progress" | "payment_successful" | "payment_failed" | "payment_cancelled"
+/**
+ * These are not currently emitted by LRS flows, but I'm intentionally including them so that the SDK is forwards compatible.
+ * The SDK would also then effectively handle these events without a patch if LRS gains bank transfer / pay-via-bank support in the future.
+ */
+ | "bank_transfer_submitted" | "pay_via_bank_completed";
 /**
  * Tracks whether the education carousel WebView has signalled that it has content to show.
  * - "pending": waiting for the carousel to report its state (default/reset value)
@@ -20,7 +25,7 @@ export interface GlomoLrsCheckoutPayload {
 }
 /** The options for the useLrsCheckout hook */
 export interface UseLrsCheckoutOptions {
-    server?: GlomoLrsServer;
+    server?: GlomoServer;
     publicKey: string;
     orderId: string;
     onPaymentSuccess: (payload: GlomoLrsCheckoutPayload) => void;

package/lib/use-lrs-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-lrs-checkout.d.ts","sourceRoot":"","sources":["../src/use-lrs-checkout.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-lrs-checkout.d.ts","sourceRoot":"","sources":["../src/use-lrs-checkout.tsx"],"names":[],"mappings":"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"}

package/lib/use-lrs-checkout.js

@@ -18,7 +18,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
     const educationCarouselWebViewRef = (0, react_1.useRef)(null);
     // Resolving checkout and carousel URLs from the selected SDK server
     const serverConfig = (0, react_1.useMemo)(() => (0, base_1.resolveServerConfig)(server), [server]);
-    const baseCheckoutUrl = serverConfig.checkoutBaseUrl;
+    const baseCheckoutUrl = serverConfig.baseUrl.lrsCheckout;
     /**
      * The main checkout URL for the LRS flow
      * In future, this needs to come from the LRS Checkout SDK.
@@ -36,80 +36,50 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             // Validating the final URL
             if (!(0, validation_1.isValidUrl)(finalUrl)) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Generated invalid checkout URL:", finalUrl);
+                    console.error("[Glomo-RN-SDK LRS] Generated invalid checkout URL:", finalUrl);
                 }
-                const errors = [
-                    {
-                        type: "validation_error",
-                        message: "Generated invalid checkout URL",
-                    },
-                ];
-                (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
-                (0, analytics_1.trackSdkError)(errors, orderId, publicKey, devMode, mockMode, finalUrl ? finalUrl : finalUrl === null ? "null" : "undefined");
                 return "";
             }
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Checkout URL:", finalUrl);
+                console.log("[Glomo-RN-SDK LRS] Checkout URL:", finalUrl);
             }
             return finalUrl;
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error building checkout URL:", error);
+                console.error("[Glomo-RN-SDK LRS] Error building checkout URL:", error);
             }
-            const errors = [
-                {
-                    type: "validation_error",
-                    message: `Error building checkout URL: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ];
-            (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
-            (0, analytics_1.trackSdkError)(errors, orderId, publicKey, devMode, mockMode, "");
             return "";
         }
-    }, [baseCheckoutUrl, orderId, publicKey, mockMode, devMode, onSdkError]);
+    }, [baseCheckoutUrl, orderId, publicKey, mockMode, devMode]);
     /**
      * The education carousel URL, built from the server config with the current orderId and publicKey.
      * Loaded in a hidden WebView alongside the flow WebView; shown only once the carousel signals it has content.
      */
     const educationCarouselUrl = (0, react_1.useMemo)(() => {
         try {
-            const baseEducationCarouselUrl = serverConfig.educationCarouselBaseUrl;
+            const baseEducationCarouselUrl = serverConfig.baseUrl.lrsEducationCarousel;
             const separator = baseEducationCarouselUrl.includes("?") ? "&" : "?";
             const finalUrl = `${baseEducationCarouselUrl}${separator}orderId=${encodeURIComponent(orderId)}` +
                 `&publicKey=${encodeURIComponent(publicKey)}`;
             if (!(0, validation_1.isValidUrl)(finalUrl)) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Generated invalid education carousel URL:", finalUrl);
+                    console.error("[Glomo-RN-SDK LRS] Generated invalid education carousel URL:", finalUrl);
                 }
-                const errors = [
-                    {
-                        type: "validation_error",
-                        message: "Generated invalid education carousel URL",
-                    },
-                ];
-                (0, analytics_1.trackSdkError)(errors, orderId, publicKey, devMode, mockMode, finalUrl ? finalUrl : finalUrl === null ? "null" : "undefined");
                 return "";
             }
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Education Carousel URL:", finalUrl);
+                console.log("[Glomo-RN-SDK LRS] Education Carousel URL:", finalUrl);
             }
             return finalUrl;
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error building education carousel URL:", error);
+                console.error("[Glomo-RN-SDK LRS] Error building education carousel URL:", error);
             }
-            const errors = [
-                {
-                    type: "validation_error",
-                    message: `Error building education carousel URL: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ];
-            (0, analytics_1.trackSdkError)(errors, orderId, publicKey, devMode, mockMode, "");
             return "";
         }
-    }, [serverConfig, orderId, publicKey, devMode, mockMode]);
+    }, [serverConfig, orderId, publicKey, devMode]);
     // Checkout status state
     const [status, setStatus] = (0, react_1.useState)("ready");
     // Visibility state for the main checkout modal
@@ -119,9 +89,15 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
     const [educationCarouselState, setEducationCarouselState] = (0, react_1.useState)("pending");
     (0, react_1.useEffect)(() => {
         if (devMode) {
-            console.log(`[GlomoPay RN SDK] Carousel state snapshot: status=${status}, showCheckout=${showCheckout}, showFlowWebView=${showFlowWebView}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}, educationCarouselState=${educationCarouselState}, educationCarouselUrl=${educationCarouselUrl || "<empty>"}`);
+            console.log(`[Glomo-RN-SDK LRS] Carousel state snapshot: status=${status}, showCheckout=${showCheckout}, showFlowWebView=${showFlowWebView}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}, educationCarouselState=${educationCarouselState}, educationCarouselUrl=${educationCarouselUrl || "<empty>"}`);
         }
     }, [devMode, status, showCheckout, showFlowWebView, flowWebViewUrl, educationCarouselState, educationCarouselUrl]);
+    // Tracking when the education carousel URL is invalid (empty) despite having valid orderId and publicKey
+    (0, react_1.useEffect)(() => {
+        if (orderId && publicKey && !educationCarouselUrl) {
+            (0, analytics_1.trackEducationStepsFailedToShow)(orderId, publicKey, devMode, mockMode, checkoutUrl, "invalid_url");
+        }
+    }, [educationCarouselUrl, orderId, publicKey, devMode, mockMode, checkoutUrl]);
     // Handler for the WebView errors
     const handleError = (0, react_1.useCallback)((syntheticEvent) => {
         try {
@@ -144,7 +120,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     description.includes("ERR_NETWORK_CHANGED")); // Network changed
             if (isIOSConnectionError || isAndroidConnectionError) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Connection error:", nativeEvent);
+                    console.error("[Glomo-RN-SDK LRS] Connection error:", nativeEvent);
                 }
                 // Closing the checkout modal
                 setShowCheckout(false);
@@ -158,13 +134,13 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             }
             else {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] WebView error:", nativeEvent);
+                    console.error("[Glomo-RN-SDK LRS] WebView error:", nativeEvent);
                 }
             }
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error in handleError:", error);
+                console.error("[Glomo-RN-SDK LRS] Error in handleError:", error);
             }
         }
     }, [devMode, onConnectionError, checkoutUrl, orderId, publicKey, mockMode]);
@@ -173,12 +149,12 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         try {
             const { nativeEvent } = syntheticEvent;
             if (devMode) {
-                console.error("[GlomoPay RN SDK] WebView HTTP error:", nativeEvent);
+                console.error("[Glomo-RN-SDK LRS] WebView HTTP error:", nativeEvent);
             }
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error in handleHttpError:", error);
+                console.error("[Glomo-RN-SDK LRS] Error in handleHttpError:", error);
             }
         }
     }, [devMode]);
@@ -189,7 +165,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             const data = (_a = event.nativeEvent) === null || _a === void 0 ? void 0 : _a.data;
             if (!data || typeof data !== "string") {
                 if (devMode) {
-                    console.warn("[GlomoPay RN SDK] Invalid message data from MainWebView");
+                    console.warn("[Glomo-RN-SDK LRS] Invalid message data from MainWebView");
                 }
                 // Tracking invalid message received
                 (0, analytics_1.trackInvalidMessageReceived)("main", data, checkoutUrl, orderId, publicKey, devMode, mockMode, checkoutUrl);
@@ -197,12 +173,12 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             }
             const message = JSON.parse(data);
             if (devMode) {
-                console.log("[GlomoPay RN SDK] MainWebView Message received:", message.type, message);
+                console.log("[Glomo-RN-SDK LRS] MainWebView Message received:", message.type, message);
             }
             if (message.type === "console") {
                 if (devMode) {
                     const level = message.level || "log";
-                    console.log(`[GlomoPay RN SDK] [WebView ${level.toUpperCase()}]`, message.message);
+                    console.log(`[Glomo-RN-SDK LRS] [WebView ${level.toUpperCase()}]`, message.message);
                 }
                 return;
             }
@@ -210,7 +186,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                 const url = message.url;
                 if (url && typeof url === "string" && (0, validation_1.isValidUrl)(url)) {
                     if (devMode) {
-                        console.log(`[GlomoPay RN SDK] window.open called from MainWebView: ${url}`);
+                        console.log(`[Glomo-RN-SDK LRS] window.open called from MainWebView: ${url}`);
                     }
                     setFlowWebViewUrl(url);
                     setShowFlowWebView(true);
@@ -220,14 +196,14 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                 }
                 else {
                     if (devMode) {
-                        console.log("[GlomoPay RN SDK] Invalid URL in window.open from MainWebView:", url, typeof url === "undefined" ? "undefined" : "");
+                        console.log("[Glomo-RN-SDK LRS] Invalid URL in window.open from MainWebView:", url, typeof url === "undefined" ? "undefined" : "");
                     }
                 }
                 return;
             }
             if (message.type === "window.close") {
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] Child window close requested from MainWebView");
+                    console.log("[Glomo-RN-SDK LRS] Child window close requested from MainWebView");
                 }
                 setShowFlowWebView(false);
                 setFlowWebViewUrl("");
@@ -245,7 +221,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
                     if ((0, validation_1.isValidPaymentPayload)(payload)) {
                         if (devMode) {
-                            console.log("[GlomoPay RN SDK] Payment successful via merchant callback!");
+                            console.log("[Glomo-RN-SDK LRS] Payment successful via merchant callback!");
                         }
                         setShowCheckout(false);
                         setShowFlowWebView(false);
@@ -258,7 +234,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     }
                     else {
                         if (devMode) {
-                            console.error("[GlomoPay RN SDK] Invalid payment success payload:", payload);
+                            console.error("[Glomo-RN-SDK LRS] Invalid payment success payload:", payload);
                         }
                     }
                     return;
@@ -268,7 +244,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
                     if ((0, validation_1.isValidPaymentPayload)(payload)) {
                         if (devMode) {
-                            console.error("[GlomoPay RN SDK] Payment failed via merchant callback");
+                            console.error("[Glomo-RN-SDK LRS] Payment failed via merchant callback");
                         }
                         setShowCheckout(false);
                         setShowFlowWebView(false);
@@ -281,7 +257,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     }
                     else {
                         if (devMode) {
-                            console.error("[GlomoPay RN SDK] Invalid payment failure payload:", payload);
+                            console.error("[Glomo-RN-SDK LRS] Invalid payment failure payload:", payload);
                         }
                     }
                     return;
@@ -289,7 +265,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                 // Handling checkout.closed events
                 if (messageType === "checkout.closed") {
                     if (devMode) {
-                        console.log("[GlomoPay RN SDK] Checkout closed event received");
+                        console.log("[Glomo-RN-SDK LRS] Checkout closed event received");
                     }
                     setShowCheckout(false);
                     setShowFlowWebView(false);
@@ -304,7 +280,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error parsing MainWebView message:", error);
+                console.error("[Glomo-RN-SDK LRS] Error parsing MainWebView message:", error);
             }
         }
     }, [onPaymentSuccess, onPaymentFailure, onPaymentTerminate, devMode, mockMode, orderId, publicKey, checkoutUrl]);
@@ -315,7 +291,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             const data = (_a = event.nativeEvent) === null || _a === void 0 ? void 0 : _a.data;
             if (!data || typeof data !== "string") {
                 if (devMode) {
-                    console.warn("[GlomoPay RN SDK] Invalid message data from FlowWebView");
+                    console.warn("[Glomo-RN-SDK LRS] Invalid message data from FlowWebView");
                 }
                 // Tracking invalid message received
                 (0, analytics_1.trackInvalidMessageReceived)("flow", data, flowWebViewUrl, orderId, publicKey, devMode, mockMode, checkoutUrl);
@@ -323,11 +299,11 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             }
             const message = JSON.parse(data);
             if (devMode) {
-                console.log("[GlomoPay RN SDK] FlowWebView Message received:", message.type, message);
+                console.log("[Glomo-RN-SDK LRS] FlowWebView Message received:", message.type, message);
             }
             if (message.type === "console") {
                 if (devMode) {
-                    console.log(`[GlomoPay RN SDK] [Flow] ${message.message}`);
+                    console.log(`[Glomo-RN-SDK LRS] [Flow] ${message.message}`);
                 }
                 return;
             }
@@ -335,7 +311,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                 const url = message.url;
                 if (url && typeof url === "string" && (0, validation_1.isValidUrl)(url)) {
                     if (devMode) {
-                        console.log(`[GlomoPay RN SDK] window.open called from FlowWebView: ${url}`);
+                        console.log(`[Glomo-RN-SDK LRS] window.open called from FlowWebView: ${url}`);
                     }
                     setFlowWebViewUrl(url);
                     setEducationCarouselState("pending");
@@ -344,14 +320,14 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                 }
                 else {
                     if (devMode) {
-                        console.log("[GlomoPay RN SDK] Invalid URL in window.open from FlowWebView:", url, typeof url === "undefined" ? "undefined" : "");
+                        console.log("[Glomo-RN-SDK LRS] Invalid URL in window.open from FlowWebView:", url, typeof url === "undefined" ? "undefined" : "");
                     }
                 }
                 return;
             }
             if (message.type === "window.close") {
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] FlowWebView close requested");
+                    console.log("[Glomo-RN-SDK LRS] FlowWebView close requested");
                 }
                 setShowFlowWebView(false);
                 setFlowWebViewUrl("");
@@ -368,7 +344,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
                     if ((0, validation_1.isValidPaymentPayload)(payload)) {
                         if (devMode) {
-                            console.log("[GlomoPay RN SDK] Payment successful via FlowWebView callback!");
+                            console.log("[Glomo-RN-SDK LRS] Payment successful via FlowWebView callback!");
                         }
                         setShowFlowWebView(false);
                         setShowCheckout(false);
@@ -381,7 +357,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     }
                     else {
                         if (devMode) {
-                            console.error("[GlomoPay RN SDK] Invalid payment success payload from FlowWebView:", payload);
+                            console.error("[Glomo-RN-SDK LRS] Invalid payment success payload from FlowWebView:", payload);
                         }
                     }
                     return;
@@ -391,7 +367,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
                     if ((0, validation_1.isValidPaymentPayload)(payload)) {
                         if (devMode) {
-                            console.error("[GlomoPay RN SDK] Payment failed via FlowWebView callback");
+                            console.error("[Glomo-RN-SDK LRS] Payment failed via FlowWebView callback");
                         }
                         setShowFlowWebView(false);
                         setShowCheckout(false);
@@ -404,7 +380,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
                     }
                     else {
                         if (devMode) {
-                            console.error("[GlomoPay RN SDK] Invalid payment failure payload from FlowWebView:", payload);
+                            console.error("[Glomo-RN-SDK LRS] Invalid payment failure payload from FlowWebView:", payload);
                         }
                     }
                     return;
@@ -413,7 +389,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error parsing FlowWebView message:", error);
+                console.error("[Glomo-RN-SDK LRS] Error parsing FlowWebView message:", error);
             }
         }
     }, [onPaymentSuccess, onPaymentFailure, devMode, mockMode, orderId, publicKey, flowWebViewUrl, checkoutUrl]);
@@ -424,24 +400,24 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             const data = (_a = event.nativeEvent) === null || _a === void 0 ? void 0 : _a.data;
             if (!data || typeof data !== "string") {
                 if (devMode) {
-                    console.warn("[GlomoPay RN SDK] Invalid message data from EducationCarouselWebView");
+                    console.warn("[Glomo-RN-SDK LRS] Invalid message data from EducationCarouselWebView");
                 }
                 return;
             }
             const message = JSON.parse(data);
             if (devMode) {
-                console.log("[GlomoPay RN SDK] EducationCarouselWebView Message received:", message.type, message);
+                console.log("[Glomo-RN-SDK LRS] EducationCarouselWebView Message received:", message.type, message);
             }
             if (message.type === "console") {
                 if (devMode) {
-                    console.log(`[GlomoPay RN SDK] [EducationCarousel] ${message.message}`);
+                    console.log(`[Glomo-RN-SDK LRS] [EducationCarousel] ${message.message}`);
                 }
                 return;
             }
             if (message.type === "lrs.has_education_steps") {
                 const nextState = "hasContent";
                 if (devMode) {
-                    console.log(`[GlomoPay RN SDK] Education carousel signal received: value=${String(message.value)} source=${message.source || "unknown"} payload=${JSON.stringify(message.payload || {})}`);
+                    console.log(`[Glomo-RN-SDK LRS] Education carousel signal received: value=${String(message.value)} source=${message.source || "unknown"} payload=${JSON.stringify(message.payload || {})}`);
                 }
                 (0, analytics_1.trackEducationStepsShown)(orderId, publicKey, devMode, mockMode, checkoutUrl, message.source);
                 setEducationCarouselState(nextState);
@@ -450,37 +426,38 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error parsing EducationCarouselWebView message:", error);
+                console.error("[Glomo-RN-SDK LRS] Error parsing EducationCarouselWebView message:", error);
             }
         }
     }, [checkoutUrl, devMode, mockMode, orderId, publicKey]);
     // Handler for the navigation state changes
     const handleNavigationStateChange = (0, react_1.useCallback)((navState) => {
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Navigation state:", navState);
+            console.log("[Glomo-RN-SDK LRS] Navigation state:", navState);
         }
     }, [devMode]);
     // Handler for the modal back button press events
     const handleModalBackButton = (0, react_1.useCallback)(() => {
         try {
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Modal dismissed/back button pressed");
+                console.log("[Glomo-RN-SDK LRS] Modal dismissed/back button pressed");
             }
             if (showFlowWebView) {
                 setShowFlowWebView(false);
                 setFlowWebViewUrl("");
-                setEducationCarouselState("pending");
             }
+            // Resetting carousel state and closing the checkout modal regardless of flow WebView state
+            setEducationCarouselState("pending");
             setShowCheckout(false);
             if (status === "payment_in_progress") {
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] In progress payment cancelled");
+                    console.log("[Glomo-RN-SDK LRS] In progress payment cancelled");
                 }
                 setStatus("payment_cancelled");
             }
             else {
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] Ignoring checkout status update for: " + status);
+                    console.log("[Glomo-RN-SDK LRS] Ignoring checkout status update for: " + status);
                 }
             }
             (0, validation_1.safeCallback)(onPaymentTerminate, [], "onPaymentTerminate", devMode);
@@ -490,14 +467,14 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error in handleModalBackButton:", error);
+                console.error("[Glomo-RN-SDK LRS] Error in handleModalBackButton:", error);
             }
         }
     }, [showFlowWebView, devMode, onPaymentTerminate, status, orderId, publicKey, mockMode, checkoutUrl]);
     /** Closes the flow WebView and returns to the main checkout */
     const handleFlowBack = (0, react_1.useCallback)(() => {
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Flow WebView back button pressed");
+            console.log("[Glomo-RN-SDK LRS] Flow WebView back button pressed");
         }
         setShowFlowWebView(false);
         setFlowWebViewUrl("");
@@ -528,14 +505,14 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             jailbreakDetected: deviceComplianceCheck,
         };
         if (devMode) {
-            console.log(`[GlomoPay RN SDK] Attempting to start checkout of ${checkoutUrl} from status: ${status}`);
+            console.log(`[Glomo-RN-SDK LRS] Attempting to start checkout of ${checkoutUrl} from status: ${status}`);
         }
         // Tracking start attempt with current status
         (0, analytics_1.trackStartAttempt)(status, orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
         if (deviceComplianceCheck === true) {
             // Device detected as compromised
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Cannot start checkout. Device is rooted or jailbroken.");
+                console.error("[Glomo-RN-SDK LRS] Cannot start checkout. Device is rooted or jailbroken.");
             }
             const errors = [
                 {
@@ -551,7 +528,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         else if (deviceComplianceCheck === null) {
             // This warning was intentionally not gated behind a devMode check to ensure merchants are aware of the strong recommendation to install jail-monkey for enhanced security compliance.
-            console.warn("[GlomoPay RN SDK] Device security library not installed - the SDK won't be able to automatically detect rooted/jailbroken devices. It is HIGHLY recommended to install jail-monkey as per the README, and prevent LRS checkouts from compromised devices.");
+            console.warn("[Glomo-RN-SDK LRS] Device security library not installed - the SDK won't be able to automatically detect rooted/jailbroken devices. It is HIGHLY recommended to install jail-monkey as per the README, and prevent LRS checkouts from compromised devices.");
         }
         // Enforcing devMode requirement for development servers
         const resolvedServer = server || "prod";
@@ -602,7 +579,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         if (errors.length > 0) {
             if (devMode) {
-                console.error(`[GlomoPay RN SDK] Cannot start checkout. Validation failed.`);
+                console.error(`[Glomo-RN-SDK LRS] Cannot start checkout. Validation failed.`);
             }
             (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
             // Tracking start() failure
@@ -613,7 +590,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         if (status === "payment_successful") {
             if (devMode) {
-                console.log(`[GlomoPay RN SDK] Cannot start checkout. Current status: ${status}. Payment already successful.`);
+                console.log(`[Glomo-RN-SDK LRS] Cannot start checkout. Current status: ${status}. Payment already successful.`);
             }
             // Tracking start() failure
             (0, analytics_1.trackStartFailure)("payment_successful", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
@@ -623,9 +600,11 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         if (status !== "ready" &&
             status !== "payment_cancelled" &&
             status !== "payment_failed" &&
-            status !== "payment_in_progress") {
+            status !== "payment_in_progress" &&
+            status !== "bank_transfer_submitted" &&
+            status !== "pay_via_bank_completed") {
             if (devMode) {
-                console.log(`[GlomoPay RN SDK] Cannot start checkout. Unknown status: ${status}.`);
+                console.log(`[Glomo-RN-SDK LRS] Cannot start checkout. Unknown status: ${status}.`);
             }
             // Tracking start() failure
             (0, analytics_1.trackStartFailure)("invalid_status", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
@@ -634,7 +613,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         }
         if (!checkoutUrl) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Cannot start checkout. Invalid checkout URL.");
+                console.error("[Glomo-RN-SDK LRS] Cannot start checkout. Invalid checkout URL.");
             }
             // Tracking start() failure
             (0, analytics_1.trackStartFailure)("invalid_url", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
@@ -642,7 +621,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
             return false;
         }
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Starting checkout from previous state: " + status);
+            console.log("[Glomo-RN-SDK LRS] Starting checkout from previous state: " + status);
         }
         setShowFlowWebView(false);
         setFlowWebViewUrl("");
@@ -652,7 +631,7 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
         (0, analytics_1.trackStartSuccess)(orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
         setShowCheckout(true);
         return true;
-    }, [devMode, status, publicKey, orderId, baseCheckoutUrl, checkoutUrl, mockMode, onSdkError]);
+    }, [devMode, status, publicKey, orderId, baseCheckoutUrl, checkoutUrl, mockMode, onSdkError, server]);
     // Initializing Segment analytics
     (0, react_1.useEffect)(() => {
         (0, segment_1.initializeSegment)(devMode);
@@ -661,9 +640,13 @@ function useLrsCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymen
     (0, react_1.useEffect)(() => {
         if (orderId && publicKey) {
             // Only resetting the checkout flow if the current status is that of a terminal state
-            if (status === "payment_successful" || status === "payment_failed" || status === "payment_cancelled") {
+            if (status === "payment_successful" ||
+                status === "payment_failed" ||
+                status === "payment_cancelled" ||
+                status === "bank_transfer_submitted" ||
+                status === "pay_via_bank_completed") {
                 if (devMode) {
-                    console.log(`[GlomoPay RN SDK] Resetting checkout status ${status} for new orderId ${orderId} and publicKey ${publicKey}`);
+                    console.log(`[Glomo-RN-SDK LRS] Resetting checkout status ${status} for new orderId ${orderId} and publicKey ${publicKey}`);
                 }
                 setStatus("ready");
             }

package/lib/use-standard-checkout.d.ts

@@ -0,0 +1,65 @@
+/** Main SDK hook for the GlomoPay Standard Checkout flow */
+import React from "react";
+import { type NativeSyntheticEvent } from "react-native";
+import { type WebViewNavigation, type WebViewMessageEvent, type WebView } from "react-native-webview";
+import { type GlomoServer } from "./config/base";
+import { type SdkError } from "./utils/analytics";
+import { type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload } from "./types/checkout";
+import { type StandardCheckoutStatus, type GlomoStandardCheckoutPayload } from "./types/standard-checkout";
+/** Android-only WebView permission request, not yet in react-native-webview type definitions */
+export interface WebViewPermissionRequest {
+    nativeEvent: {
+        resources: string[];
+    };
+    grant: (resources: string[]) => void;
+    deny: () => void;
+}
+/** The options for the useStandardCheckout hook */
+export interface UseStandardCheckoutOptions {
+    server?: GlomoServer;
+    publicKey: string;
+    orderId: string;
+    onPaymentSuccess: (payload: GlomoStandardCheckoutPayload) => void;
+    onPaymentFailure: (payload: GlomoStandardCheckoutPayload) => void;
+    onConnectionError?: (error: unknown) => void;
+    onPaymentTerminate?: () => void;
+    onSdkError?: (error: Array<SdkError>) => void;
+    onBankTransferSubmitted?: (payload: GlomoBankTransferPayload | null | undefined) => void;
+    onPayViaBankCompleted?: (payload: {
+        status: string;
+    }) => void;
+    onPayViaBankBankConnectionSuccessful?: (payload: GlomoPayViaBankConnectionPayload | null | undefined) => void;
+    onUserRefusedCameraPermissions?: () => void;
+    devMode?: boolean;
+}
+/** The return values for the useStandardCheckout hook */
+export interface UseStandardCheckoutReturn {
+    start: () => boolean;
+    status: StandardCheckoutStatus;
+    showCheckout: boolean;
+    flowWebViewUrl: string;
+    showFlowWebView: boolean;
+    checkoutUrl: string;
+    mainWebViewRef: React.RefObject<WebView>;
+    flowWebViewRef: React.RefObject<WebView>;
+    handleMainWebViewMessage: (event: WebViewMessageEvent) => void;
+    handleFlowWebViewMessage: (event: WebViewMessageEvent) => void;
+    handleError: (syntheticEvent: NativeSyntheticEvent<{
+        code?: number;
+        domain?: string;
+        description?: string;
+    }>) => void;
+    handleHttpError: (syntheticEvent: NativeSyntheticEvent<{
+        statusCode: number;
+        description?: string;
+    }>) => void;
+    handleNavigationStateChange: (navState: WebViewNavigation) => void;
+    handlePermissionRequest: (request: WebViewPermissionRequest) => void;
+    handleModalBackButton: () => void;
+    handleFlowBack: () => void;
+    injectedMain?: string;
+    injectedFlow?: string;
+}
+/** The main SDK hook for the GlomoPay Standard Checkout flow */
+export declare function useStandardCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode, }: UseStandardCheckoutOptions, mockMode: boolean): UseStandardCheckoutReturn;
+//# sourceMappingURL=use-standard-checkout.d.ts.map