@glomopay/react-native-sdk 3.0.1 → 3.1.0

package/src/use-standard-checkout.tsx

@@ -10,23 +10,7 @@ import { initializeSegment } from "./config/segment";
 import { resolveServerConfig, type GlomoServer } from "./config/base";
 import { isValidPublicKey, isValidOrderId, isValidUrl, isValidPaymentPayload, safeCallback } from "./utils/validation";
 import { checkDeviceCompliance, isComplianceCheckAvailable } from "./utils/device-compliance";
-import {
-    trackStandardStartAttempt,
-    trackStandardStartSuccess,
-    trackStandardStartFailure,
-    trackStandardWindowOpen,
-    trackStandardWindowClose,
-    trackStandardPaymentSuccess,
-    trackStandardPaymentFailure,
-    trackStandardPaymentTerminate,
-    trackStandardConnectionError,
-    trackStandardSdkError,
-    trackStandardInvalidMessageReceived,
-    trackStandardBankTransferSubmitted,
-    trackStandardPayViaBankCompleted,
-    trackStandardPayViaBankBankConnectionSuccessful,
-    type SdkError,
-} from "./utils/analytics";
+import { type SdkError, type CheckoutAnalyticsTrackers, standardCheckoutTrackers } from "./utils/analytics";
 
 import { type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload } from "./types/checkout";
 import { type StandardCheckoutStatus, type GlomoStandardCheckoutPayload } from "./types/standard-checkout";
@@ -79,6 +63,16 @@ export interface UseStandardCheckoutReturn {
     injectedFlow?: string;
 }
 
+/**
+ * Internal options for useStandardCheckout.
+ * Used by subscription checkout to inject subscription-specific analytics trackers.
+ * Not exported to merchants.
+ */
+export interface UseStandardCheckoutInternalOptions {
+    analyticsTrackers?: CheckoutAnalyticsTrackers;
+    _skipOrderIdValidation?: boolean;
+}
+
 /** The main SDK hook for the GlomoPay Standard Checkout flow */
 export function useStandardCheckout(
     {
@@ -96,8 +90,11 @@ export function useStandardCheckout(
         onUserRefusedCameraPermissions,
         devMode = false,
     }: UseStandardCheckoutOptions,
-    mockMode: boolean
+    mockMode: boolean,
+    internalOptions?: UseStandardCheckoutInternalOptions
 ): UseStandardCheckoutReturn {
+    // Resolving analytics trackers - defaults to standard, subscription flow overrides
+    const trackers = internalOptions?.analyticsTrackers ?? standardCheckoutTrackers;
     // Refs for the WebViews
     const mainWebViewRef = useRef<WebView>(null);
     const flowWebViewRef = useRef<WebView>(null);
@@ -204,7 +201,14 @@ export function useStandardCheckout(
                     // Calling onConnectionError callback if provided
                     safeCallback(onConnectionError, [nativeEvent], "onConnectionError", devMode);
                     // Tracking connection error
-                    trackStandardConnectionError(orderId, nativeEvent?.code, publicKey, devMode, mockMode, checkoutUrl);
+                    trackers.trackConnectionError(
+                        orderId,
+                        nativeEvent?.code,
+                        publicKey,
+                        devMode,
+                        mockMode,
+                        checkoutUrl
+                    );
                 } else {
                     if (devMode) {
                         console.error("[Glomo-RN-SDK Standard] WebView error:", nativeEvent);
@@ -216,7 +220,7 @@ export function useStandardCheckout(
                 }
             }
         },
-        [devMode, onConnectionError, checkoutUrl, orderId, publicKey, mockMode]
+        [devMode, onConnectionError, checkoutUrl, orderId, publicKey, mockMode, trackers]
     );
 
     // Handler for the WebView HTTP errors
@@ -252,7 +256,7 @@ export function useStandardCheckout(
                         console.warn("[Glomo-RN-SDK Standard] Invalid message data from MainWebView");
                     }
                     // Tracking invalid message received
-                    trackStandardInvalidMessageReceived(
+                    trackers.trackInvalidMessageReceived(
                         "main",
                         data,
                         checkoutUrl,
@@ -289,7 +293,7 @@ export function useStandardCheckout(
                         setFlowWebViewUrl(url);
                         setShowFlowWebView(true);
                         // Tracking window.open interception
-                        trackStandardWindowOpen("main", url, orderId, publicKey, devMode, mockMode, checkoutUrl);
+                        trackers.trackWindowOpen("main", url, orderId, publicKey, devMode, mockMode, checkoutUrl);
                     } else {
                         if (devMode) {
                             console.log(
@@ -310,7 +314,7 @@ export function useStandardCheckout(
                     setShowFlowWebView(false);
                     setFlowWebViewUrl("");
                     // Tracking window.close interception
-                    trackStandardWindowClose("main", orderId, publicKey, devMode, mockMode, checkoutUrl);
+                    trackers.trackWindowClose("main", orderId, publicKey, devMode, mockMode, checkoutUrl);
                     return;
                 }
 
@@ -334,7 +338,7 @@ export function useStandardCheckout(
                             setStatus("payment_successful");
                             safeCallback(onPaymentSuccess, [payload], "onPaymentSuccess", devMode);
                             // Tracking payment success callback
-                            trackStandardPaymentSuccess(
+                            trackers.trackPaymentSuccess(
                                 payload.orderId,
                                 payload.paymentId,
                                 publicKey,
@@ -365,7 +369,7 @@ export function useStandardCheckout(
                             setStatus("payment_failed");
                             safeCallback(onPaymentFailure, [payload], "onPaymentFailure", devMode);
                             // Tracking payment failure callback
-                            trackStandardPaymentFailure(
+                            trackers.trackPaymentFailure(
                                 payload.orderId,
                                 payload.paymentId,
                                 publicKey,
@@ -403,7 +407,7 @@ export function useStandardCheckout(
                             "onBankTransferSubmitted",
                             devMode
                         );
-                        trackStandardBankTransferSubmitted(orderId, publicKey, devMode, mockMode, checkoutUrl);
+                        trackers.trackBankTransferSubmitted(orderId, publicKey, devMode, mockMode, checkoutUrl);
                         return;
                     }
 
@@ -427,7 +431,7 @@ export function useStandardCheckout(
                             "onPayViaBankBankConnectionSuccessful",
                             devMode
                         );
-                        trackStandardPayViaBankBankConnectionSuccessful(
+                        trackers.trackPayViaBankBankConnectionSuccessful(
                             orderId,
                             publicKey,
                             payload?.bankIdentifier ?? "",
@@ -470,7 +474,7 @@ export function useStandardCheckout(
                             "onPayViaBankCompleted",
                             devMode
                         );
-                        trackStandardPayViaBankCompleted(
+                        trackers.trackPayViaBankCompleted(
                             orderId,
                             publicKey,
                             payload?.status ?? "unknown",
@@ -491,7 +495,7 @@ export function useStandardCheckout(
                         setFlowWebViewUrl("");
                         safeCallback(onPaymentTerminate, [], "onPaymentTerminate", devMode);
                         // Tracking payment terminate callback
-                        trackStandardPaymentTerminate(
+                        trackers.trackPaymentTerminate(
                             orderId,
                             "checkout_closed",
                             publicKey,
@@ -520,6 +524,7 @@ export function useStandardCheckout(
             orderId,
             publicKey,
             checkoutUrl,
+            trackers,
         ]
     );
 
@@ -538,7 +543,7 @@ export function useStandardCheckout(
                         console.warn("[Glomo-RN-SDK Standard] Invalid message data from FlowWebView");
                     }
                     // Tracking invalid message received
-                    trackStandardInvalidMessageReceived(
+                    trackers.trackInvalidMessageReceived(
                         "flow",
                         data,
                         flowWebViewUrl,
@@ -573,7 +578,7 @@ export function useStandardCheckout(
                         }
                         setFlowWebViewUrl(url);
                         // Tracking window.open interception
-                        trackStandardWindowOpen("flow", url, orderId, publicKey, devMode, mockMode, checkoutUrl);
+                        trackers.trackWindowOpen("flow", url, orderId, publicKey, devMode, mockMode, checkoutUrl);
                     } else {
                         if (devMode) {
                             console.log(
@@ -594,7 +599,7 @@ export function useStandardCheckout(
                     setShowFlowWebView(false);
                     setFlowWebViewUrl("");
                     // Tracking window.close interception
-                    trackStandardWindowClose("flow", orderId, publicKey, devMode, mockMode, checkoutUrl);
+                    trackers.trackWindowClose("flow", orderId, publicKey, devMode, mockMode, checkoutUrl);
                     return;
                 }
 
@@ -618,7 +623,7 @@ export function useStandardCheckout(
                             setStatus("payment_successful");
                             safeCallback(onPaymentSuccess, [payload], "onPaymentSuccess", devMode);
                             // Tracking payment success callback
-                            trackStandardPaymentSuccess(
+                            trackers.trackPaymentSuccess(
                                 payload.orderId,
                                 payload.paymentId,
                                 publicKey,
@@ -652,7 +657,7 @@ export function useStandardCheckout(
                             setStatus("payment_failed");
                             safeCallback(onPaymentFailure, [payload], "onPaymentFailure", devMode);
                             // Tracking payment failure callback
-                            trackStandardPaymentFailure(
+                            trackers.trackPaymentFailure(
                                 payload.orderId,
                                 payload.paymentId,
                                 publicKey,
@@ -694,7 +699,7 @@ export function useStandardCheckout(
                             "onPayViaBankBankConnectionSuccessful",
                             devMode
                         );
-                        trackStandardPayViaBankBankConnectionSuccessful(
+                        trackers.trackPayViaBankBankConnectionSuccessful(
                             orderId,
                             publicKey,
                             payload?.bankIdentifier ?? "",
@@ -732,7 +737,7 @@ export function useStandardCheckout(
                             "onPayViaBankCompleted",
                             devMode
                         );
-                        trackStandardPayViaBankCompleted(
+                        trackers.trackPayViaBankCompleted(
                             orderId,
                             publicKey,
                             payload?.status ?? "unknown",
@@ -760,6 +765,7 @@ export function useStandardCheckout(
             publicKey,
             flowWebViewUrl,
             checkoutUrl,
+            trackers,
         ]
     );
 
@@ -797,13 +803,13 @@ export function useStandardCheckout(
             safeCallback(onPaymentTerminate, [], "onPaymentTerminate", devMode);
             // Tracking payment terminate callback (user dismiss/back button)
             const terminateSource = Platform.OS === "ios" ? "user_dismiss" : "back_button";
-            trackStandardPaymentTerminate(orderId, terminateSource, publicKey, devMode, mockMode, checkoutUrl);
+            trackers.trackPaymentTerminate(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]);
+    }, [showFlowWebView, devMode, onPaymentTerminate, status, orderId, publicKey, mockMode, checkoutUrl, trackers]);
 
     /** Closes the flow WebView and returns to the main checkout */
     const handleFlowBack = useCallback(() => {
@@ -812,8 +818,8 @@ export function useStandardCheckout(
         }
         setShowFlowWebView(false);
         setFlowWebViewUrl("");
-        trackStandardWindowClose("flow", orderId, publicKey, devMode, mockMode, checkoutUrl);
-    }, [devMode, orderId, publicKey, mockMode, checkoutUrl]);
+        trackers.trackWindowClose("flow", orderId, publicKey, devMode, mockMode, checkoutUrl);
+    }, [devMode, orderId, publicKey, mockMode, checkoutUrl, trackers]);
 
     /**
      * Handler for WebView permission requests (e.g. camera access for bank authentication).
@@ -931,7 +937,7 @@ export function useStandardCheckout(
         }
 
         // Tracking start attempt with current status
-        trackStandardStartAttempt(status, orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+        trackers.trackStartAttempt(status, orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
 
         if (deviceComplianceCheck === true) {
             // Device detected as compromised
@@ -946,7 +952,7 @@ export function useStandardCheckout(
             ];
             safeCallback(onSdkError, [errors], "onSdkError", devMode);
             // Tracking start() failure
-            trackStandardStartFailure(
+            trackers.trackStartFailure(
                 "device_forbidden",
                 orderId,
                 publicKey,
@@ -974,8 +980,8 @@ export function useStandardCheckout(
                 },
             ];
             safeCallback(onSdkError, [errors], "onSdkError", devMode);
-            trackStandardSdkError(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
-            trackStandardStartFailure(
+            trackers.trackSdkError(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
+            trackers.trackStartFailure(
                 "validation_error",
                 orderId,
                 publicKey,
@@ -1000,7 +1006,7 @@ export function useStandardCheckout(
             errors.push(error);
         }
 
-        if (!isValidOrderId(orderId)) {
+        if (!internalOptions?._skipOrderIdValidation && !isValidOrderId(orderId)) {
             const error: SdkError = {
                 type: "validation_error",
                 message: "Invalid orderId: must start with 'order_' and be a valid string",
@@ -1030,8 +1036,8 @@ export function useStandardCheckout(
             }
             safeCallback(onSdkError, [errors], "onSdkError", devMode);
             // Tracking start() failure
-            trackStandardSdkError(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
-            trackStandardStartFailure(
+            trackers.trackSdkError(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
+            trackers.trackStartFailure(
                 "validation_error",
                 orderId,
                 publicKey,
@@ -1051,7 +1057,7 @@ export function useStandardCheckout(
                 );
             }
             // Tracking start() failure
-            trackStandardStartFailure(
+            trackers.trackStartFailure(
                 "payment_successful",
                 orderId,
                 publicKey,
@@ -1076,7 +1082,7 @@ export function useStandardCheckout(
                 console.log(`[Glomo-RN-SDK Standard] Cannot start checkout. Unknown status: ${status}.`);
             }
             // Tracking start() failure
-            trackStandardStartFailure(
+            trackers.trackStartFailure(
                 "invalid_status",
                 orderId,
                 publicKey,
@@ -1094,7 +1100,7 @@ export function useStandardCheckout(
                 console.error("[Glomo-RN-SDK Standard] Cannot start checkout. Invalid checkout URL.");
             }
             // Tracking start() failure
-            trackStandardStartFailure(
+            trackers.trackStartFailure(
                 "invalid_url",
                 orderId,
                 publicKey,
@@ -1118,12 +1124,24 @@ export function useStandardCheckout(
         setStatus("payment_in_progress");
 
         // Tracking successful start
-        trackStandardStartSuccess(orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
+        trackers.trackStartSuccess(orderId, publicKey, devMode, mockMode, checkoutUrl, jailbreakDetectionInfo);
 
         // Opening the checkout modal
         setShowCheckout(true);
         return true;
-    }, [devMode, status, publicKey, orderId, baseCheckoutUrl, checkoutUrl, mockMode, onSdkError, server]);
+    }, [
+        devMode,
+        status,
+        publicKey,
+        orderId,
+        baseCheckoutUrl,
+        checkoutUrl,
+        mockMode,
+        onSdkError,
+        server,
+        trackers,
+        internalOptions,
+    ]);
 
     // Initializing Segment analytics
     useEffect(() => {