@glomopay/react-native-sdk 2.0.1 → 3.0.1

package/lib/use-standard-checkout.js

@@ -0,0 +1,832 @@
+"use strict";
+/** Main SDK hook for the GlomoPay Standard Checkout flow */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStandardCheckout = useStandardCheckout;
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const index_1 = require("./injections/index");
+const segment_1 = require("./config/segment");
+const base_1 = require("./config/base");
+const validation_1 = require("./utils/validation");
+const device_compliance_1 = require("./utils/device-compliance");
+const analytics_1 = require("./utils/analytics");
+/** The main SDK hook for the GlomoPay Standard Checkout flow */
+function useStandardCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode = false, }, mockMode) {
+    // Refs for the WebViews
+    const mainWebViewRef = (0, react_1.useRef)(null);
+    const flowWebViewRef = (0, react_1.useRef)(null);
+    // Deduplication guard - prevents firing onPayViaBankCompleted twice when both main and flow WebViews emit the event
+    const payViaBankCompletedHandledRef = (0, react_1.useRef)(false);
+    // Resolving checkout URL from the selected SDK server
+    const serverConfig = (0, react_1.useMemo)(() => (0, base_1.resolveServerConfig)(server), [server]);
+    const baseCheckoutUrl = serverConfig.baseUrl.standardCheckout;
+    /**
+     * The main checkout URL for the standard flow
+     */
+    const checkoutUrl = (0, react_1.useMemo)(() => {
+        try {
+            // Building the query string manually since URLSearchParams is not fully supported in React Native
+            const baseParams = [`orderId=${encodeURIComponent(orderId)}`];
+            const mode = mockMode ? "mock" : "live";
+            const params = baseParams.concat(`mode=${encodeURIComponent(mode)}`, `publicKey=${encodeURIComponent(publicKey)}`);
+            const queryString = params.join("&");
+            // Handling base URL with or without existing query parameters
+            const separator = baseCheckoutUrl.includes("?") ? "&" : "?";
+            const finalUrl = `${baseCheckoutUrl}${separator}${queryString}`;
+            // Validating the final URL
+            if (!(0, validation_1.isValidUrl)(finalUrl)) {
+                if (devMode) {
+                    console.error("[Glomo-RN-SDK Standard] Generated invalid checkout URL:", finalUrl);
+                }
+                return "";
+            }
+            if (devMode) {
+                console.log("[Glomo-RN-SDK Standard] Checkout URL:", finalUrl);
+            }
+            return finalUrl;
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Error building checkout URL:", error);
+            }
+            return "";
+        }
+    }, [baseCheckoutUrl, orderId, publicKey, mockMode, devMode]);
+    // Checkout status state
+    const [status, setStatus] = (0, react_1.useState)("ready");
+    // Visibility state for the main checkout modal
+    const [showCheckout, setShowCheckout] = (0, react_1.useState)(false);
+    const [showFlowWebView, setShowFlowWebView] = (0, react_1.useState)(false);
+    const [flowWebViewUrl, setFlowWebViewUrl] = (0, react_1.useState)("");
+    (0, react_1.useEffect)(() => {
+        if (devMode) {
+            console.log(`[Glomo-RN-SDK Standard] State snapshot: status=${status}, showCheckout=${showCheckout}, showFlowWebView=${showFlowWebView}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}`);
+        }
+    }, [devMode, status, showCheckout, showFlowWebView, flowWebViewUrl]);
+    // Handler for the WebView errors
+    const handleError = (0, react_1.useCallback)((syntheticEvent) => {
+        try {
+            const { nativeEvent } = syntheticEvent;
+            // Now checking for connection errors
+            // iOS: NSURLErrorDomain errors
+            const isIOSConnectionError = (nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.domain) === "NSURLErrorDomain" &&
+                ((nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.code) === -1004 || // Could not connect to the server
+                    (nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.code) === -1009 || // The Internet connection appears to be offline
+                    (nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.code) === -1001 || // The request timed out
+                    (nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.code) === -1003); // Cannot find host
+            // Android: Network errors
+            const description = (nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.description) || "";
+            const isAndroidConnectionError = typeof description === "string" &&
+                (description.includes("ERR_EMPTY_RESPONSE") || // Server unreachable
+                    description.includes("ERR_CONNECTION_REFUSED") || // Connection refused
+                    description.includes("ERR_NAME_NOT_RESOLVED") || // DNS resolution failed
+                    description.includes("ERR_INTERNET_DISCONNECTED") || // No internet
+                    description.includes("ERR_CONNECTION_TIMED_OUT") || // Connection timeout
+                    description.includes("ERR_NETWORK_CHANGED")); // Network changed
+            if (isIOSConnectionError || isAndroidConnectionError) {
+                if (devMode) {
+                    console.error("[Glomo-RN-SDK Standard] Connection error:", nativeEvent);
+                }
+                // Closing the checkout modal
+                setShowCheckout(false);
+                setShowFlowWebView(false);
+                setFlowWebViewUrl("");
+                // Calling onConnectionError callback if provided
+                (0, validation_1.safeCallback)(onConnectionError, [nativeEvent], "onConnectionError", devMode);
+                // Tracking connection error
+                (0, analytics_1.trackStandardConnectionError)(orderId, nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.code, publicKey, devMode, mockMode, checkoutUrl);
+            }
+            else {
+                if (devMode) {
+                    console.error("[Glomo-RN-SDK Standard] WebView error:", nativeEvent);
+                }
+            }
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Error in handleError:", error);
+            }
+        }
+    }, [devMode, onConnectionError, checkoutUrl, orderId, publicKey, mockMode]);
+    // Handler for the WebView HTTP errors
+    const handleHttpError = (0, react_1.useCallback)((syntheticEvent) => {
+        try {
+            const { nativeEvent } = syntheticEvent;
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] WebView HTTP error:", nativeEvent);
+            }
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Error in handleHttpError:", error);
+            }
+        }
+    }, [devMode]);
+    /**
+     * Handler for the main WebView messages.
+     * The main WebView hosts the checkout page. Messages arrive as JSON strings from the injected
+     * JavaScript bridge and include console logs, window.open/close interceptions, and payment
+     * lifecycle events (success, failure, terminate, bank transfer, pay via bank).
+     */
+    const handleMainWebViewMessage = (0, react_1.useCallback)((event) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        try {
+            // Extracting and validating the raw message data from the WebView event
+            const data = (_a = event.nativeEvent) === null || _a === void 0 ? void 0 : _a.data;
+            if (!data || typeof data !== "string") {
+                if (devMode) {
+                    console.warn("[Glomo-RN-SDK Standard] Invalid message data from MainWebView");
+                }
+                // Tracking invalid message received
+                (0, analytics_1.trackStandardInvalidMessageReceived)("main", data, checkoutUrl, orderId, publicKey, devMode, mockMode, checkoutUrl);
+                return;
+            }
+            const message = JSON.parse(data);
+            if (devMode) {
+                console.log("[Glomo-RN-SDK Standard] MainWebView Message received:", message.type, message);
+            }
+            // Forwarding console messages from the injected script to the React Native console
+            if (message.type === "console") {
+                if (devMode) {
+                    const level = message.level || "log";
+                    console.log(`[Glomo-RN-SDK Standard] [WebView ${level.toUpperCase()}]`, message.message);
+                }
+                return;
+            }
+            // Intercepting window.open calls - opening the target URL in the flow WebView overlay
+            if (message.type === "window.open") {
+                const url = message.url;
+                if (url && typeof url === "string" && (0, validation_1.isValidUrl)(url)) {
+                    if (devMode) {
+                        console.log(`[Glomo-RN-SDK Standard] window.open called from MainWebView: ${url}`);
+                    }
+                    setFlowWebViewUrl(url);
+                    setShowFlowWebView(true);
+                    // Tracking window.open interception
+                    (0, analytics_1.trackStandardWindowOpen)("main", url, orderId, publicKey, devMode, mockMode, checkoutUrl);
+                }
+                else {
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Invalid URL in window.open from MainWebView:", url, typeof url === "undefined" ? "undefined" : "");
+                    }
+                }
+                return;
+            }
+            // Intercepting window.close calls - closing the flow WebView overlay
+            if (message.type === "window.close") {
+                if (devMode) {
+                    console.log("[Glomo-RN-SDK Standard] Child window close requested from MainWebView");
+                }
+                setShowFlowWebView(false);
+                setFlowWebViewUrl("");
+                // Tracking window.close interception
+                (0, analytics_1.trackStandardWindowClose)("main", orderId, publicKey, devMode, mockMode, checkoutUrl);
+                return;
+            }
+            // Handling merchant JS callbacks on flow completion (payment events, lifecycle events)
+            if (message.type === "message" && message.message) {
+                const messageData = message.message;
+                const messageType = messageData === null || messageData === void 0 ? void 0 : messageData.type;
+                // Handling payment success - closing checkout and notifying the merchant
+                if (messageType === "payment.success" || messageType === "payment.complete") {
+                    const paymentMessage = messageData;
+                    const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
+                    if ((0, validation_1.isValidPaymentPayload)(payload)) {
+                        if (devMode) {
+                            console.log("[Glomo-RN-SDK Standard] Payment successful via merchant callback!");
+                        }
+                        setShowCheckout(false);
+                        setShowFlowWebView(false);
+                        setFlowWebViewUrl("");
+                        setStatus("payment_successful");
+                        (0, validation_1.safeCallback)(onPaymentSuccess, [payload], "onPaymentSuccess", devMode);
+                        // Tracking payment success callback
+                        (0, analytics_1.trackStandardPaymentSuccess)(payload.orderId, payload.paymentId, publicKey, devMode, mockMode, checkoutUrl);
+                    }
+                    else {
+                        if (devMode) {
+                            console.error("[Glomo-RN-SDK Standard] Invalid payment success payload:", payload);
+                        }
+                    }
+                    return;
+                }
+                // Handling payment failure - closing checkout and notifying the merchant
+                if (messageType === "payment.failure" || messageType === "payment.error") {
+                    const paymentMessage = messageData;
+                    const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
+                    if ((0, validation_1.isValidPaymentPayload)(payload)) {
+                        if (devMode) {
+                            console.error("[Glomo-RN-SDK Standard] Payment failed via merchant callback");
+                        }
+                        setShowCheckout(false);
+                        setShowFlowWebView(false);
+                        setFlowWebViewUrl("");
+                        setStatus("payment_failed");
+                        (0, validation_1.safeCallback)(onPaymentFailure, [payload], "onPaymentFailure", devMode);
+                        // Tracking payment failure callback
+                        (0, analytics_1.trackStandardPaymentFailure)(payload.orderId, payload.paymentId, publicKey, devMode, mockMode, checkoutUrl);
+                    }
+                    else {
+                        if (devMode) {
+                            console.error("[Glomo-RN-SDK Standard] Invalid payment failure payload:", payload);
+                        }
+                    }
+                    return;
+                }
+                // Handling bank transfer submission - user has submitted transfer details
+                if (messageType === "payment.bank_transfer_submitted") {
+                    const payload = messageData === null || messageData === void 0 ? void 0 : messageData.payload;
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Bank transfer submitted:", payload);
+                    }
+                    setShowCheckout(false);
+                    setShowFlowWebView(false);
+                    setFlowWebViewUrl("");
+                    setStatus("bank_transfer_submitted");
+                    (0, validation_1.safeCallback)(onBankTransferSubmitted, [
+                        {
+                            orderId: (_b = payload === null || payload === void 0 ? void 0 : payload.orderId) !== null && _b !== void 0 ? _b : "",
+                            senderAccountNumber: (_c = payload === null || payload === void 0 ? void 0 : payload.senderAccountNumber) !== null && _c !== void 0 ? _c : "",
+                            transactionReference: (_d = payload === null || payload === void 0 ? void 0 : payload.transactionReference) !== null && _d !== void 0 ? _d : "",
+                        },
+                    ], "onBankTransferSubmitted", devMode);
+                    (0, analytics_1.trackStandardBankTransferSubmitted)(orderId, publicKey, devMode, mockMode, checkoutUrl);
+                    return;
+                }
+                // Handling pay via bank - bank connection successful event (informational, no status change)
+                if (messageType === "pay_via_bank.bank.connection_successful") {
+                    const payload = messageData === null || messageData === void 0 ? void 0 : messageData.payload;
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Pay via bank - bank connection successful:", payload);
+                    }
+                    (0, validation_1.safeCallback)(onPayViaBankBankConnectionSuccessful, [
+                        {
+                            bankIdentifier: (_e = payload === null || payload === void 0 ? void 0 : payload.bankIdentifier) !== null && _e !== void 0 ? _e : "",
+                            cooldownPeriodInMinutes: (_f = payload === null || payload === void 0 ? void 0 : payload.cooldownPeriodInMinutes) !== null && _f !== void 0 ? _f : 0,
+                            bankName: (_g = payload === null || payload === void 0 ? void 0 : payload.bankName) !== null && _g !== void 0 ? _g : "",
+                            bankImageSrc: (_h = payload === null || payload === void 0 ? void 0 : payload.bankImageSrc) !== null && _h !== void 0 ? _h : "",
+                            bankImageAlt: (_j = payload === null || payload === void 0 ? void 0 : payload.bankImageAlt) !== null && _j !== void 0 ? _j : "",
+                        },
+                    ], "onPayViaBankBankConnectionSuccessful", devMode);
+                    (0, analytics_1.trackStandardPayViaBankBankConnectionSuccessful)(orderId, publicKey, (_k = payload === null || payload === void 0 ? void 0 : payload.bankIdentifier) !== null && _k !== void 0 ? _k : "", devMode, mockMode, checkoutUrl);
+                    return;
+                }
+                /**
+                 * Handling the generic glomoCheckoutJourneyTerminate event.
+                 * This event is fired by the checkout page when the pay via bank (lean/open finance)
+                 * flow completes. The deduplication ref prevents firing the callback twice when both
+                 * main and flow WebViews emit this event.
+                 */
+                if (messageType === "glomoCheckoutJourneyTerminate") {
+                    // Deduplication - both main and flow WebViews can emit this event
+                    if (payViaBankCompletedHandledRef.current) {
+                        if (devMode) {
+                            console.log("[Glomo-RN-SDK Standard] Pay via bank completed already handled, ignoring duplicate");
+                        }
+                        return;
+                    }
+                    payViaBankCompletedHandledRef.current = true;
+                    const payload = messageData === null || messageData === void 0 ? void 0 : messageData.payload;
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Pay via bank completed via MainWebView:", payload);
+                    }
+                    setShowFlowWebView(false);
+                    setShowCheckout(false);
+                    setFlowWebViewUrl("");
+                    setStatus("pay_via_bank_completed");
+                    (0, validation_1.safeCallback)(onPayViaBankCompleted, [{ status: (_l = payload === null || payload === void 0 ? void 0 : payload.status) !== null && _l !== void 0 ? _l : "unknown" }], "onPayViaBankCompleted", devMode);
+                    (0, analytics_1.trackStandardPayViaBankCompleted)(orderId, publicKey, (_m = payload === null || payload === void 0 ? void 0 : payload.status) !== null && _m !== void 0 ? _m : "unknown", devMode, mockMode, checkoutUrl);
+                    return;
+                }
+                // Handling checkout.closed events
+                if (messageType === "checkout.closed") {
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Checkout closed event received");
+                    }
+                    setShowCheckout(false);
+                    setShowFlowWebView(false);
+                    setFlowWebViewUrl("");
+                    (0, validation_1.safeCallback)(onPaymentTerminate, [], "onPaymentTerminate", devMode);
+                    // Tracking payment terminate callback
+                    (0, analytics_1.trackStandardPaymentTerminate)(orderId, "checkout_closed", publicKey, devMode, mockMode, checkoutUrl);
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Error parsing MainWebView message:", error);
+            }
+        }
+    }, [
+        onPaymentSuccess,
+        onPaymentFailure,
+        onPaymentTerminate,
+        onBankTransferSubmitted,
+        onPayViaBankCompleted,
+        onPayViaBankBankConnectionSuccessful,
+        devMode,
+        mockMode,
+        orderId,
+        publicKey,
+        checkoutUrl,
+    ]);
+    /**
+     * Handler for the flow WebView messages.
+     * The flow WebView hosts child pages opened via window.open (e.g. 3DS, bank redirects).
+     * Message structure mirrors the main WebView handler but operates on the overlay WebView.
+     */
+    const handleFlowWebViewMessage = (0, react_1.useCallback)((event) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        try {
+            // Extracting and validating the raw message data from the flow WebView event
+            const data = (_a = event.nativeEvent) === null || _a === void 0 ? void 0 : _a.data;
+            if (!data || typeof data !== "string") {
+                if (devMode) {
+                    console.warn("[Glomo-RN-SDK Standard] Invalid message data from FlowWebView");
+                }
+                // Tracking invalid message received
+                (0, analytics_1.trackStandardInvalidMessageReceived)("flow", data, flowWebViewUrl, orderId, publicKey, devMode, mockMode, checkoutUrl);
+                return;
+            }
+            const message = JSON.parse(data);
+            if (devMode) {
+                console.log("[Glomo-RN-SDK Standard] FlowWebView Message received:", message.type, message);
+            }
+            // Forwarding console messages from the flow WebView's injected script
+            if (message.type === "console") {
+                if (devMode) {
+                    console.log(`[Glomo-RN-SDK Standard] [Flow] ${message.message}`);
+                }
+                return;
+            }
+            // Intercepting window.open calls from the flow WebView - navigating within the same overlay
+            if (message.type === "window.open") {
+                const url = message.url;
+                if (url && typeof url === "string" && (0, validation_1.isValidUrl)(url)) {
+                    if (devMode) {
+                        console.log(`[Glomo-RN-SDK Standard] window.open called from FlowWebView: ${url}`);
+                    }
+                    setFlowWebViewUrl(url);
+                    // Tracking window.open interception
+                    (0, analytics_1.trackStandardWindowOpen)("flow", url, orderId, publicKey, devMode, mockMode, checkoutUrl);
+                }
+                else {
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Invalid URL in window.open from FlowWebView:", url, typeof url === "undefined" ? "undefined" : "");
+                    }
+                }
+                return;
+            }
+            // Intercepting window.close calls from the flow WebView - closing the overlay
+            if (message.type === "window.close") {
+                if (devMode) {
+                    console.log("[Glomo-RN-SDK Standard] FlowWebView close requested");
+                }
+                setShowFlowWebView(false);
+                setFlowWebViewUrl("");
+                // Tracking window.close interception
+                (0, analytics_1.trackStandardWindowClose)("flow", orderId, publicKey, devMode, mockMode, checkoutUrl);
+                return;
+            }
+            // Handling merchant JS callbacks from the flow WebView (payment events, lifecycle events)
+            if (message.type === "message" && message.message) {
+                const messageData = message.message;
+                const messageType = messageData === null || messageData === void 0 ? void 0 : messageData.type;
+                // Handling payment success from the flow WebView
+                if (messageType === "payment.success" || messageType === "payment.complete") {
+                    const paymentMessage = messageData;
+                    const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
+                    if ((0, validation_1.isValidPaymentPayload)(payload)) {
+                        if (devMode) {
+                            console.log("[Glomo-RN-SDK Standard] Payment successful via FlowWebView callback!");
+                        }
+                        setShowFlowWebView(false);
+                        setShowCheckout(false);
+                        setFlowWebViewUrl("");
+                        setStatus("payment_successful");
+                        (0, validation_1.safeCallback)(onPaymentSuccess, [payload], "onPaymentSuccess", devMode);
+                        // Tracking payment success callback
+                        (0, analytics_1.trackStandardPaymentSuccess)(payload.orderId, payload.paymentId, publicKey, devMode, mockMode, checkoutUrl);
+                    }
+                    else {
+                        if (devMode) {
+                            console.error("[Glomo-RN-SDK Standard] Invalid payment success payload from FlowWebView:", payload);
+                        }
+                    }
+                    return;
+                }
+                // Handling payment failure from the flow WebView
+                if (messageType === "payment.failure" || messageType === "payment.error") {
+                    const paymentMessage = messageData;
+                    const payload = paymentMessage === null || paymentMessage === void 0 ? void 0 : paymentMessage.payload;
+                    if ((0, validation_1.isValidPaymentPayload)(payload)) {
+                        if (devMode) {
+                            console.error("[Glomo-RN-SDK Standard] Payment failed via FlowWebView callback");
+                        }
+                        setShowFlowWebView(false);
+                        setShowCheckout(false);
+                        setFlowWebViewUrl("");
+                        setStatus("payment_failed");
+                        (0, validation_1.safeCallback)(onPaymentFailure, [payload], "onPaymentFailure", devMode);
+                        // Tracking payment failure callback
+                        (0, analytics_1.trackStandardPaymentFailure)(payload.orderId, payload.paymentId, publicKey, devMode, mockMode, checkoutUrl);
+                    }
+                    else {
+                        if (devMode) {
+                            console.error("[Glomo-RN-SDK Standard] Invalid payment failure payload from FlowWebView:", payload);
+                        }
+                    }
+                    return;
+                }
+                // Handling pay via bank - bank connection successful event from the flow WebView
+                if (messageType === "pay_via_bank.bank.connection_successful") {
+                    const payload = messageData === null || messageData === void 0 ? void 0 : messageData.payload;
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Pay via bank - bank connection successful via FlowWebView:", payload);
+                    }
+                    (0, validation_1.safeCallback)(onPayViaBankBankConnectionSuccessful, [
+                        {
+                            bankIdentifier: (_b = payload === null || payload === void 0 ? void 0 : payload.bankIdentifier) !== null && _b !== void 0 ? _b : "",
+                            cooldownPeriodInMinutes: (_c = payload === null || payload === void 0 ? void 0 : payload.cooldownPeriodInMinutes) !== null && _c !== void 0 ? _c : 0,
+                            bankName: (_d = payload === null || payload === void 0 ? void 0 : payload.bankName) !== null && _d !== void 0 ? _d : "",
+                            bankImageSrc: (_e = payload === null || payload === void 0 ? void 0 : payload.bankImageSrc) !== null && _e !== void 0 ? _e : "",
+                            bankImageAlt: (_f = payload === null || payload === void 0 ? void 0 : payload.bankImageAlt) !== null && _f !== void 0 ? _f : "",
+                        },
+                    ], "onPayViaBankBankConnectionSuccessful", devMode);
+                    (0, analytics_1.trackStandardPayViaBankBankConnectionSuccessful)(orderId, publicKey, (_g = payload === null || payload === void 0 ? void 0 : payload.bankIdentifier) !== null && _g !== void 0 ? _g : "", devMode, mockMode, checkoutUrl);
+                    return;
+                }
+                // Handling glomoCheckoutJourneyTerminate from the flow WebView (pay via bank completion)
+                if (messageType === "glomoCheckoutJourneyTerminate") {
+                    // Deduplication - both main and flow WebViews can emit this event
+                    if (payViaBankCompletedHandledRef.current) {
+                        if (devMode) {
+                            console.log("[Glomo-RN-SDK Standard] Pay via bank completed already handled, ignoring duplicate");
+                        }
+                        return;
+                    }
+                    payViaBankCompletedHandledRef.current = true;
+                    const payload = messageData === null || messageData === void 0 ? void 0 : messageData.payload;
+                    if (devMode) {
+                        console.log("[Glomo-RN-SDK Standard] Pay via bank completed via FlowWebView:", payload);
+                    }
+                    setShowFlowWebView(false);
+                    setShowCheckout(false);
+                    setFlowWebViewUrl("");
+                    setStatus("pay_via_bank_completed");
+                    (0, validation_1.safeCallback)(onPayViaBankCompleted, [{ status: (_h = payload === null || payload === void 0 ? void 0 : payload.status) !== null && _h !== void 0 ? _h : "unknown" }], "onPayViaBankCompleted", devMode);
+                    (0, analytics_1.trackStandardPayViaBankCompleted)(orderId, publicKey, (_j = payload === null || payload === void 0 ? void 0 : payload.status) !== null && _j !== void 0 ? _j : "unknown", devMode, mockMode, checkoutUrl);
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Error parsing FlowWebView message:", error);
+            }
+        }
+    }, [
+        onPaymentSuccess,
+        onPaymentFailure,
+        onPayViaBankCompleted,
+        onPayViaBankBankConnectionSuccessful,
+        devMode,
+        mockMode,
+        orderId,
+        publicKey,
+        flowWebViewUrl,
+        checkoutUrl,
+    ]);
+    // Handler for the navigation state changes
+    const handleNavigationStateChange = (0, react_1.useCallback)((navState) => {
+        if (devMode) {
+            console.log("[Glomo-RN-SDK Standard] Navigation state:", navState);
+        }
+    }, [devMode]);
+    // Handler for the modal back button press events
+    const handleModalBackButton = (0, react_1.useCallback)(() => {
+        try {
+            if (devMode) {
+                console.log("[Glomo-RN-SDK Standard] Modal dismissed/back button pressed");
+            }
+            if (showFlowWebView) {
+                setShowFlowWebView(false);
+                setFlowWebViewUrl("");
+            }
+            setShowCheckout(false);
+            if (status === "payment_in_progress") {
+                if (devMode) {
+                    console.log("[Glomo-RN-SDK Standard] In progress payment cancelled");
+                }
+                setStatus("payment_cancelled");
+            }
+            else {
+                if (devMode) {
+                    console.log("[Glomo-RN-SDK Standard] Ignoring checkout status update for: " + status);
+                }
+            }
+            (0, validation_1.safeCallback)(onPaymentTerminate, [], "onPaymentTerminate", devMode);
+            // Tracking payment terminate callback (user dismiss/back button)
+            const terminateSource = react_native_1.Platform.OS === "ios" ? "user_dismiss" : "back_button";
+            (0, analytics_1.trackStandardPaymentTerminate)(orderId, terminateSource, publicKey, devMode, mockMode, checkoutUrl);
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] 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("[Glomo-RN-SDK Standard] Flow WebView back button pressed");
+        }
+        setShowFlowWebView(false);
+        setFlowWebViewUrl("");
+        (0, analytics_1.trackStandardWindowClose)("flow", orderId, publicKey, devMode, mockMode, checkoutUrl);
+    }, [devMode, orderId, publicKey, mockMode, checkoutUrl]);
+    /**
+     * Handler for WebView permission requests (e.g. camera access for bank authentication).
+     * On Android, prompts the user for camera permission via PermissionsAndroid.
+     * On iOS, grants camera access automatically (iOS handles its own permission prompt).
+     * Non-camera permissions are denied by default.
+     */
+    const handlePermissionRequest = (0, react_1.useCallback)(async (request) => {
+        try {
+            const { resources } = request.nativeEvent;
+            // Checking if the requested permission is camera-related
+            const isCameraPermissionRequest = resources.some((resource) => resource === "camera" || resource.toLowerCase().includes("camera"));
+            if (!isCameraPermissionRequest) {
+                if (devMode) {
+                    console.log("[Glomo-RN-SDK Standard] Non-camera permission requested, denying:", resources);
+                }
+                request.deny();
+                return;
+            }
+            if (devMode) {
+                console.log("[Glomo-RN-SDK Standard] Camera permission requested by webpage");
+            }
+            if (react_native_1.Platform.OS === "android") {
+                try {
+                    const granted = await react_native_1.PermissionsAndroid.request(react_native_1.PermissionsAndroid.PERMISSIONS.CAMERA, {
+                        title: "Camera Permission",
+                        message: "This app needs camera access for identity verification during checkout",
+                        buttonNeutral: "Ask Me Later",
+                        buttonNegative: "Cancel",
+                        buttonPositive: "OK",
+                    });
+                    if (granted === react_native_1.PermissionsAndroid.RESULTS.GRANTED) {
+                        if (devMode) {
+                            console.log("[Glomo-RN-SDK Standard] Camera permission granted");
+                        }
+                        request.grant(resources);
+                    }
+                    else {
+                        if (devMode) {
+                            console.log("[Glomo-RN-SDK Standard] Camera permission denied by user");
+                        }
+                        setShowCheckout(false);
+                        if (status === "payment_in_progress") {
+                            setStatus("payment_cancelled");
+                        }
+                        (0, validation_1.safeCallback)(onUserRefusedCameraPermissions, [], "onUserRefusedCameraPermissions", devMode);
+                        request.deny();
+                    }
+                }
+                catch (err) {
+                    if (devMode) {
+                        console.error("[Glomo-RN-SDK Standard] Error requesting camera permission:", err);
+                    }
+                    setShowCheckout(false);
+                    if (status === "payment_in_progress") {
+                        setStatus("payment_cancelled");
+                    }
+                    (0, validation_1.safeCallback)(onUserRefusedCameraPermissions, [], "onUserRefusedCameraPermissions", devMode);
+                    request.deny();
+                }
+            }
+            else if (react_native_1.Platform.OS === "ios") {
+                if (devMode) {
+                    console.log("[Glomo-RN-SDK Standard] Granting camera permission request on iOS");
+                }
+                request.grant(resources);
+            }
+            else {
+                if (devMode) {
+                    console.warn("[Glomo-RN-SDK Standard] Unsupported platform for camera permissions");
+                }
+                request.deny();
+            }
+        }
+        catch (error) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Error in handlePermissionRequest:", error);
+            }
+            request.deny();
+        }
+    }, [devMode, status, onUserRefusedCameraPermissions]);
+    /**
+     * Initiator method for the Standard Checkout flow.
+     * Using a ref, the standard flow can be started by calling this method.
+     * Example:
+     *   const checkoutRef = useRef<GlomoStandardCheckoutRef>(null);
+     *   checkoutRef.current?.start();
+     *
+     * The standard checkout can only be started if
+     * - The status is "ready", "payment_cancelled", or "payment_failed"
+     * - The status is NOT "payment_successful"
+     * - Input validation passes
+     */
+    const start = (0, react_1.useCallback)(() => {
+        /**
+         * Checking device security compliance (if peerDependencies are available)
+         * A null value indicates that recommended security dependencies were not installed and compliance checks will be skipped in this case
+         */
+        const deviceComplianceCheck = (0, device_compliance_1.checkDeviceCompliance)(devMode);
+        const jailbreakDetectionLibraryInstalled = (0, device_compliance_1.isComplianceCheckAvailable)();
+        const jailbreakDetectionInfo = {
+            jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: deviceComplianceCheck,
+        };
+        if (devMode) {
+            console.log(`[Glomo-RN-SDK Standard] Attempting to start checkout of ${checkoutUrl} from status: ${status}`);
+        }
+        // Tracking start attempt with current status
+        (0, analytics_1.trackStandardStartAttempt)(status, orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+        if (deviceComplianceCheck === true) {
+            // Device detected as compromised
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Cannot start checkout. Device is rooted or jailbroken.");
+            }
+            const errors = [
+                {
+                    type: "device_forbidden",
+                    message: "Standard checkout is not allowed on rooted or jailbroken devices.",
+                },
+            ];
+            (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
+            // Tracking start() failure
+            (0, analytics_1.trackStandardStartFailure)("device_forbidden", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+            setShowCheckout(false);
+            return false;
+        }
+        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("[Glomo-RN-SDK Standard] 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 standard checkouts from compromised devices.");
+        }
+        // Enforcing devMode requirement for development servers
+        const resolvedServer = server || "prod";
+        if (!devMode && resolvedServer !== "prod") {
+            const errors = [
+                {
+                    type: "validation_error",
+                    message: "Development servers can only be used when devMode is enabled.",
+                },
+            ];
+            (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
+            (0, analytics_1.trackStandardSdkError)(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
+            (0, analytics_1.trackStandardStartFailure)("validation_error", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+            setShowCheckout(false);
+            return false;
+        }
+        // Checking validation errors with detailed field-level messages
+        const errors = [];
+        if (!(0, validation_1.isValidPublicKey)(publicKey)) {
+            const error = {
+                type: "validation_error",
+                message: "Invalid publicKey: must start with 'live_', 'mock_', or 'test_' and be a valid string",
+                field: "publicKey",
+            };
+            errors.push(error);
+        }
+        if (!(0, validation_1.isValidOrderId)(orderId)) {
+            const error = {
+                type: "validation_error",
+                message: "Invalid orderId: must start with 'order_' and be a valid string",
+                field: "orderId",
+            };
+            errors.push(error);
+        }
+        if (!(0, validation_1.isValidUrl)(checkoutUrl)) {
+            const error = !(0, validation_1.isValidUrl)(baseCheckoutUrl)
+                ? {
+                    type: "validation_error",
+                    message: "Invalid baseCheckoutUrl: must be a valid HTTP or HTTPS URL",
+                    field: "baseCheckoutUrl",
+                }
+                : {
+                    type: "validation_error",
+                    message: "Invalid checkoutUrl: must be a valid HTTP or HTTPS URL",
+                    field: "generatedCheckoutUrl",
+                };
+            errors.push(error);
+        }
+        if (errors.length > 0) {
+            if (devMode) {
+                console.error(`[Glomo-RN-SDK Standard] Cannot start checkout. Validation failed.`);
+            }
+            (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
+            // Tracking start() failure
+            (0, analytics_1.trackStandardSdkError)(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
+            (0, analytics_1.trackStandardStartFailure)("validation_error", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+            setShowCheckout(false);
+            return false;
+        }
+        if (status === "payment_successful") {
+            if (devMode) {
+                console.log(`[Glomo-RN-SDK Standard] Cannot start checkout. Current status: ${status}. Payment already successful.`);
+            }
+            // Tracking start() failure
+            (0, analytics_1.trackStandardStartFailure)("payment_successful", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+            setShowCheckout(false);
+            return false;
+        }
+        if (status !== "ready" &&
+            status !== "payment_cancelled" &&
+            status !== "payment_failed" &&
+            status !== "payment_in_progress" &&
+            status !== "bank_transfer_submitted" &&
+            status !== "pay_via_bank_completed") {
+            if (devMode) {
+                console.log(`[Glomo-RN-SDK Standard] Cannot start checkout. Unknown status: ${status}.`);
+            }
+            // Tracking start() failure
+            (0, analytics_1.trackStandardStartFailure)("invalid_status", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+            setShowCheckout(false);
+            return false;
+        }
+        if (!checkoutUrl) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK Standard] Cannot start checkout. Invalid checkout URL.");
+            }
+            // Tracking start() failure
+            (0, analytics_1.trackStandardStartFailure)("invalid_url", orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+            setShowCheckout(false);
+            return false;
+        }
+        if (devMode) {
+            console.log("[Glomo-RN-SDK Standard] Starting checkout from previous state: " + status);
+        }
+        // Resetting any stale state from a previous checkout attempt before starting a new one
+        setShowFlowWebView(false);
+        setFlowWebViewUrl("");
+        payViaBankCompletedHandledRef.current = false;
+        setStatus("payment_in_progress");
+        // Tracking successful start
+        (0, analytics_1.trackStandardStartSuccess)(orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+        // Opening the checkout modal
+        setShowCheckout(true);
+        return true;
+    }, [devMode, status, publicKey, orderId, baseCheckoutUrl, checkoutUrl, mockMode, onSdkError, server]);
+    // Initializing Segment analytics
+    (0, react_1.useEffect)(() => {
+        (0, segment_1.initializeSegment)(devMode);
+    }, [devMode]);
+    // Resetting checkout flow if orderId or publicKey are changed
+    (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" ||
+                status === "bank_transfer_submitted" ||
+                status === "pay_via_bank_completed") {
+                if (devMode) {
+                    console.log(`[Glomo-RN-SDK Standard] Resetting checkout status ${status} for new orderId ${orderId} and publicKey ${publicKey}`);
+                }
+                setStatus("ready");
+            }
+        }
+    }, [orderId, publicKey, status, devMode]);
+    // Cleaning up on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            // Cleaning up - resetting state on unmount
+            setStatus("ready");
+            setShowCheckout(false);
+            setShowFlowWebView(false);
+            setFlowWebViewUrl("");
+        };
+    }, []);
+    return {
+        start,
+        status,
+        showCheckout,
+        flowWebViewUrl,
+        showFlowWebView,
+        checkoutUrl,
+        mainWebViewRef,
+        flowWebViewRef,
+        handleMainWebViewMessage,
+        handleFlowWebViewMessage,
+        handleError,
+        handleHttpError,
+        handlePermissionRequest,
+        handleNavigationStateChange,
+        handleModalBackButton,
+        handleFlowBack,
+        injectedMain: index_1.InjectionScripts.standard,
+        injectedFlow: index_1.InjectionScripts.flow,
+    };
+}