@glomopay/react-native-sdk 2.0.2 → 3.1.0

package/lib/utils/analytics.js

@@ -11,6 +11,7 @@
  * Analytics failures never break the SDK.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscriptionCheckoutTrackers = exports.standardCheckoutTrackers = void 0;
 exports.trackStartSuccess = trackStartSuccess;
 exports.trackStartAttempt = trackStartAttempt;
 exports.trackStartFailure = trackStartFailure;
@@ -22,8 +23,39 @@ exports.trackPaymentFailure = trackPaymentFailure;
 exports.trackPaymentTerminate = trackPaymentTerminate;
 exports.trackConnectionError = trackConnectionError;
 exports.trackEducationStepsShown = trackEducationStepsShown;
+exports.trackEducationStepsFailedToShow = trackEducationStepsFailedToShow;
 exports.trackSdkError = trackSdkError;
+exports.trackStandardStartSuccess = trackStandardStartSuccess;
+exports.trackStandardStartAttempt = trackStandardStartAttempt;
+exports.trackStandardStartFailure = trackStandardStartFailure;
+exports.trackStandardWindowOpen = trackStandardWindowOpen;
+exports.trackStandardWindowClose = trackStandardWindowClose;
+exports.trackStandardInvalidMessageReceived = trackStandardInvalidMessageReceived;
+exports.trackStandardPaymentSuccess = trackStandardPaymentSuccess;
+exports.trackStandardPaymentFailure = trackStandardPaymentFailure;
+exports.trackStandardPaymentTerminate = trackStandardPaymentTerminate;
+exports.trackStandardConnectionError = trackStandardConnectionError;
+exports.trackStandardSdkError = trackStandardSdkError;
+exports.trackStandardBankTransferSubmitted = trackStandardBankTransferSubmitted;
+exports.trackStandardPayViaBankCompleted = trackStandardPayViaBankCompleted;
+exports.trackStandardPayViaBankBankConnectionSuccessful = trackStandardPayViaBankBankConnectionSuccessful;
+exports.trackOrderTypeDetectionStarted = trackOrderTypeDetectionStarted;
+exports.trackOrderTypeDetectionResolved = trackOrderTypeDetectionResolved;
+exports.trackOrderTypeDetectionFailed = trackOrderTypeDetectionFailed;
 exports.checkAnalyticsStatus = checkAnalyticsStatus;
+exports.trackSubscriptionStartAttempt = trackSubscriptionStartAttempt;
+exports.trackSubscriptionStartSuccess = trackSubscriptionStartSuccess;
+exports.trackSubscriptionStartFailure = trackSubscriptionStartFailure;
+exports.trackSubscriptionWindowOpen = trackSubscriptionWindowOpen;
+exports.trackSubscriptionWindowClose = trackSubscriptionWindowClose;
+exports.trackSubscriptionInvalidMessageReceived = trackSubscriptionInvalidMessageReceived;
+exports.trackSubscriptionPaymentSuccess = trackSubscriptionPaymentSuccess;
+exports.trackSubscriptionPaymentFailure = trackSubscriptionPaymentFailure;
+exports.trackSubscriptionPaymentTerminate = trackSubscriptionPaymentTerminate;
+exports.trackSubscriptionConnectionError = trackSubscriptionConnectionError;
+exports.trackSubscriptionSdkError = trackSubscriptionSdkError;
+exports.trackUseOfUnsupportedFunctionality = trackUseOfUnsupportedFunctionality;
+const react_native_1 = require("react-native");
 const segment_1 = require("../config/segment");
 /**
  * Gets the SDK version from package.json
@@ -34,7 +66,6 @@ const segment_1 = require("../config/segment");
 function getSdkVersion() {
     try {
         // Using require to dynamically import package.json
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
         const packageJson = require("../../package.json");
         return packageJson.version || "unknown";
     }
@@ -50,18 +81,23 @@ function getSdkVersion() {
  * @param publicKey - The public key of the merchant
  * @param devMode - Whether dev mode is enabled
  * @param mockMode - Whether mock mode is enabled
- * @param lrsUrl - The LRS checkout URL
+ * @param checkoutUrl - The checkout URL
+ * @param flowType - The flow type
  * @returns Common properties object
  */
-function buildCommonProperties(orderId, publicKey, devMode = false, mockMode = false, lrsUrl) {
+function buildCommonProperties(orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, flowType) {
     return {
         orderId,
         publicKey,
-        lrsUrl,
+        checkoutUrl,
         devMode,
         mockMode,
+        platform: "react-native",
+        deviceOS: react_native_1.Platform.OS,
+        deviceOSVersion: String(react_native_1.Platform.Version),
         sdkVersion: getSdkVersion(),
         timestamp: new Date().toISOString(),
+        ...(flowType && { flowType }),
     };
 }
 /**
@@ -78,7 +114,7 @@ async function trackEvent(eventName, properties = {}, devMode = false) {
     // Returning early if GlomoPay Segment is not available
     if (!(0, segment_1.isSegmentAvailable)()) {
         if (devMode) {
-            console.log(`[GlomoPay RN SDK] Segment not available. Event "${eventName}" not tracked.`, properties);
+            console.log(`[Glomo-RN-SDK] Segment not available. Event "${eventName}" not tracked.`, properties);
         }
         return;
     }
@@ -88,7 +124,7 @@ async function trackEvent(eventName, properties = {}, devMode = false) {
         // Double-checking if the client exists (TypeScript safety)
         if (!client || !anonymousId) {
             if (devMode) {
-                console.log(`[GlomoPay RN SDK] Segment client is null. Event "${eventName}" not tracked.`);
+                console.log(`[Glomo-RN-SDK] Segment client is null. Event "${eventName}" not tracked.`);
             }
             return;
         }
@@ -114,13 +150,13 @@ async function trackEvent(eventName, properties = {}, devMode = false) {
         // Sending event via REST API
         await client.post("/track", payload);
         if (devMode) {
-            console.log(`[GlomoPay RN SDK] Tracked event: ${eventName}`, eventProperties);
+            console.log(`[Glomo-RN-SDK] Tracked event: ${eventName}`, eventProperties);
         }
     }
     catch (error) {
         if (devMode) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error(`[GlomoPay RN SDK] Error tracking event ${eventName}:`, errorMessage);
+            console.error(`[Glomo-RN-SDK] Error tracking event ${eventName}:`, errorMessage);
         }
         // Silently failing - GlomoPay analytics should never break the SDK
     }
@@ -146,7 +182,7 @@ function trackStartSuccess(orderId, publicKey, devMode = false, mockMode = false
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Started", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on start() success:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on start() success:`, error);
         }
     });
 }
@@ -173,7 +209,7 @@ function trackStartAttempt(status, orderId, publicKey, devMode = false, mockMode
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Start Attempted", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on start() attempt:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on start() attempt:`, error);
         }
     });
 }
@@ -200,7 +236,7 @@ function trackStartFailure(reason, orderId, publicKey, devMode = false, mockMode
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Start Failed", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on start() failure:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on start() failure:`, error);
         }
     });
 }
@@ -224,7 +260,7 @@ function trackWindowOpen(source, url, orderId, publicKey, devMode = false, mockM
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Window Open", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on window.open:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on window.open:`, error);
         }
     });
 }
@@ -246,7 +282,7 @@ function trackWindowClose(source, orderId, publicKey, devMode = false, mockMode
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Window Close", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on window.close:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on window.close:`, error);
         }
     });
 }
@@ -295,7 +331,7 @@ function trackInvalidMessageReceived(webviewType, data, url, orderId, publicKey,
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Invalid Message Received", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error for invalid message received event:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error for invalid message received event:`, error);
         }
     });
 }
@@ -317,7 +353,7 @@ function trackPaymentSuccess(orderId, paymentId, publicKey, devMode = false, moc
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Payment Success", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on payment success callback:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on payment success callback:`, error);
         }
     });
 }
@@ -339,7 +375,7 @@ function trackPaymentFailure(orderId, paymentId, publicKey, devMode = false, moc
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Payment Failure", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on payment failure callback:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on payment failure callback:`, error);
         }
     });
 }
@@ -361,7 +397,7 @@ function trackPaymentTerminate(orderId, source, publicKey, devMode = false, mock
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Payment Terminated", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on payment terminate callback:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on payment terminate callback:`, error);
         }
     });
 }
@@ -383,7 +419,7 @@ function trackConnectionError(orderId, errorCode, publicKey, devMode = false, mo
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Connection Error", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on connection error callback:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on connection error callback:`, error);
         }
     });
 }
@@ -404,7 +440,28 @@ function trackEducationStepsShown(orderId, publicKey, devMode = false, mockMode
     };
     trackEvent("LRS Has Education Steps", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on education steps shown event:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on education steps shown event:`, error);
+        }
+    });
+}
+/**
+ * Tracks when the education carousel URL is invalid and the carousel cannot be shown
+ *
+ * @param orderId - The order ID
+ * @param publicKey - The public key of the merchant
+ * @param devMode - Whether dev mode is enabled
+ * @param mockMode - Whether mock mode is enabled
+ * @param lrsUrl - The LRS checkout URL
+ * @param reason - Why the carousel failed to show
+ */
+function trackEducationStepsFailedToShow(orderId, publicKey, devMode = false, mockMode = false, lrsUrl, reason) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
+        ...(reason && { reason }),
+    };
+    trackEvent("LRS Education Steps Failed To Show", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error(`[Glomo-RN-SDK] Event tracking error on education steps failed to show event:`, error);
         }
     });
 }
@@ -427,7 +484,291 @@ function trackSdkError(errors, orderId, publicKey, devMode = false, mockMode = f
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS SDK Error", properties, devMode).catch((error) => {
         if (devMode) {
-            console.error(`[GlomoPay RN SDK] Event tracking error on SDK error callback:`, error);
+            console.error(`[Glomo-RN-SDK] Event tracking error on SDK error callback:`, error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Standard Checkout Trackers
+// ---------------------------------------------------------------------------
+/**
+ * Tracks when the standard checkout start() method has been called successfully
+ */
+function trackStandardStartSuccess(orderId, publicKey, devMode = false, mockMode = false, standardUrl, jailbreakDetectionInfo) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Standard Checkout Started", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard start:", error);
+        }
+    });
+}
+/**
+ * Tracks when the standard checkout start() method is called (attempted)
+ */
+function trackStandardStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, standardUrl, jailbreakDetectionInfo) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        status,
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Standard Checkout Start Attempted", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard start attempt:", error);
+        }
+    });
+}
+/**
+ * Tracks when the standard checkout start() method fails
+ */
+function trackStandardStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, standardUrl, jailbreakDetectionInfo) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        failureReason: reason,
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Standard Checkout Start Failed", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard start failure:", error);
+        }
+    });
+}
+/**
+ * Tracks when window.open is intercepted from the standard checkout WebView
+ */
+function trackStandardWindowOpen(source, url, orderId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        source,
+        url,
+    };
+    trackEvent("Standard Checkout Window Open", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard window open:", error);
+        }
+    });
+}
+/**
+ * Tracks when window.close is intercepted from the standard checkout WebView
+ */
+function trackStandardWindowClose(source, orderId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        source,
+    };
+    trackEvent("Standard Checkout Window Close", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard window close:", error);
+        }
+    });
+}
+/**
+ * Tracks when invalid message data is received from a standard checkout WebView
+ */
+function trackStandardInvalidMessageReceived(webviewType, data, url, orderId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    let dataString;
+    try {
+        if (data === null) {
+            dataString = "null";
+        }
+        else if (data === undefined) {
+            dataString = "undefined";
+        }
+        else if (typeof data === "string") {
+            dataString = data;
+        }
+        else if (typeof data === "object") {
+            dataString = JSON.stringify(data);
+        }
+        else {
+            dataString = String(data);
+        }
+    }
+    catch (_a) {
+        dataString = "[unable to stringify]";
+    }
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        webviewType,
+        data: dataString,
+        dataType: data === null ? "null" : typeof data,
+        ...(url && { url }),
+    };
+    trackEvent("Standard Checkout Invalid Message Received", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard invalid message:", error);
+        }
+    });
+}
+/**
+ * Tracks when standard checkout onPaymentSuccess callback is invoked
+ */
+function trackStandardPaymentSuccess(orderId, paymentId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        paymentId,
+    };
+    trackEvent("Standard Payment Success", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard payment success:", error);
+        }
+    });
+}
+/**
+ * Tracks when standard checkout onPaymentFailure callback is invoked
+ */
+function trackStandardPaymentFailure(orderId, paymentId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        paymentId,
+    };
+    trackEvent("Standard Payment Failure", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard payment failure:", error);
+        }
+    });
+}
+/**
+ * Tracks when standard checkout onPaymentTerminate callback is invoked
+ */
+function trackStandardPaymentTerminate(orderId, source, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        terminationSource: source,
+    };
+    trackEvent("Standard Payment Terminated", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard payment terminate:", error);
+        }
+    });
+}
+/**
+ * Tracks when standard checkout onConnectionError callback is invoked
+ */
+function trackStandardConnectionError(orderId, errorCode, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...(errorCode !== undefined && { errorCode }),
+    };
+    trackEvent("Standard Connection Error", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard connection error:", error);
+        }
+    });
+}
+/**
+ * Tracks when standard checkout onSdkError callback is invoked
+ */
+function trackStandardSdkError(errors, orderId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        errors,
+        errorCount: errors.length,
+    };
+    trackEvent("Standard SDK Error", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard SDK error:", error);
+        }
+    });
+}
+function trackStandardBankTransferSubmitted(orderId, publicKey, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+    };
+    trackEvent("Standard Bank Transfer Submitted", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard bank transfer submitted:", error);
+        }
+    });
+}
+function trackStandardPayViaBankCompleted(orderId, publicKey, status, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        payViaBankStatus: status,
+    };
+    trackEvent("Standard Pay Via Bank Completed", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard pay via bank completed:", error);
+        }
+    });
+}
+function trackStandardPayViaBankBankConnectionSuccessful(orderId, publicKey, bankIdentifier, devMode = false, mockMode = false, standardUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        bankIdentifier,
+    };
+    trackEvent("Standard Pay Via Bank Bank Connection Successful", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on standard pay via bank connection:", error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Order Type Detection Trackers (Unified Flow)
+// ---------------------------------------------------------------------------
+/**
+ * Tracks when order type detection starts
+ *
+ * @param orderId - The order ID
+ * @param publicKey - The public key of the merchant
+ * @param devMode - Whether dev mode is enabled
+ */
+function trackOrderTypeDetectionStarted(orderId, publicKey, devMode = false) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, false, undefined, "unified"),
+    };
+    trackEvent("Order Type Detection Started", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error(`[Glomo-RN-SDK] Event tracking error on order type detection started:`, error);
+        }
+    });
+}
+/**
+ * Tracks when order type detection resolves successfully
+ *
+ * @param orderId - The order ID
+ * @param publicKey - The public key of the merchant
+ * @param resolvedType - The resolved order type ("lrs" or "standard")
+ * @param devMode - Whether dev mode is enabled
+ */
+function trackOrderTypeDetectionResolved(orderId, publicKey, resolvedType, devMode = false) {
+    const eventName = resolvedType === "lrs" ? "Order Type Resolved LRS" : "Order Type Resolved Standard";
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, false, undefined, "unified"),
+    };
+    trackEvent(eventName, properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error(`[Glomo-RN-SDK] Event tracking error on order type detection resolved:`, error);
+        }
+    });
+}
+/**
+ * Tracks when order type detection fails
+ *
+ * @param orderId - The order ID
+ * @param publicKey - The public key of the merchant
+ * @param error - The error message
+ * @param devMode - Whether dev mode is enabled
+ */
+function trackOrderTypeDetectionFailed(orderId, publicKey, error, devMode = false) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, false, undefined, "unified"),
+        error,
+    };
+    trackEvent("Order Type Detection Failed", properties, devMode).catch((trackError) => {
+        if (devMode) {
+            console.error(`[Glomo-RN-SDK] Event tracking error on order type detection failed:`, trackError);
         }
     });
 }
@@ -442,11 +783,284 @@ function checkAnalyticsStatus(devMode = false) {
     const available = (0, segment_1.isSegmentAvailable)();
     if (devMode) {
         if (available) {
-            console.log("[GlomoPay RN SDK] Analytics: ENABLED");
+            console.log("[Glomo-RN-SDK] Analytics: ENABLED");
         }
         else {
-            console.log("[GlomoPay RN SDK] Analytics: DISABLED");
+            console.log("[Glomo-RN-SDK] Analytics: DISABLED");
         }
     }
     return available;
 }
+// ---------------------------------------------------------------------------
+// Subscription Checkout Trackers
+// ---------------------------------------------------------------------------
+/**
+ * Tracks when the subscription checkout start() method is called (attempted)
+ */
+function trackSubscriptionStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, jailbreakDetectionInfo) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        status,
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Subscription Checkout Start Attempted", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription start attempt:", error);
+        }
+    });
+}
+/**
+ * Tracks when the subscription checkout start() method has been called successfully
+ */
+function trackSubscriptionStartSuccess(orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, jailbreakDetectionInfo) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Subscription Checkout Started", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription start:", error);
+        }
+    });
+}
+/**
+ * Tracks when the subscription checkout start() method fails
+ */
+function trackSubscriptionStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, jailbreakDetectionInfo) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        failureReason: reason,
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Subscription Checkout Start Failed", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription start failure:", error);
+        }
+    });
+}
+/**
+ * Tracks when window.open is intercepted from the subscription checkout WebView
+ */
+function trackSubscriptionWindowOpen(source, url, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        source,
+        url,
+    };
+    trackEvent("Subscription Checkout Window Open", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription window open:", error);
+        }
+    });
+}
+/**
+ * Tracks when window.close is intercepted from the subscription checkout WebView
+ */
+function trackSubscriptionWindowClose(source, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        source,
+    };
+    trackEvent("Subscription Checkout Window Close", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription window close:", error);
+        }
+    });
+}
+/**
+ * Tracks when invalid message data is received from a subscription checkout WebView
+ */
+function trackSubscriptionInvalidMessageReceived(webviewType, data, url, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    let dataString;
+    try {
+        if (data === null) {
+            dataString = "null";
+        }
+        else if (data === undefined) {
+            dataString = "undefined";
+        }
+        else if (typeof data === "string") {
+            dataString = data;
+        }
+        else if (typeof data === "object") {
+            dataString = JSON.stringify(data);
+        }
+        else {
+            dataString = String(data);
+        }
+    }
+    catch (_a) {
+        dataString = "[unable to stringify]";
+    }
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        webviewType,
+        data: dataString,
+        dataType: data === null ? "null" : typeof data,
+        ...(url && { url }),
+    };
+    trackEvent("Subscription Checkout Invalid Message Received", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription invalid message:", error);
+        }
+    });
+}
+/**
+ * Tracks when subscription checkout onPaymentSuccess callback is invoked
+ */
+function trackSubscriptionPaymentSuccess(orderId, paymentId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        paymentId,
+    };
+    trackEvent("Subscription Payment Success", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription payment success:", error);
+        }
+    });
+}
+/**
+ * Tracks when subscription checkout onPaymentFailure callback is invoked
+ */
+function trackSubscriptionPaymentFailure(orderId, paymentId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        paymentId,
+    };
+    trackEvent("Subscription Payment Failure", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription payment failure:", error);
+        }
+    });
+}
+/**
+ * Tracks when subscription checkout onPaymentTerminate callback is invoked
+ */
+function trackSubscriptionPaymentTerminate(orderId, source, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        terminationSource: source,
+    };
+    trackEvent("Subscription Payment Terminated", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription payment terminate:", error);
+        }
+    });
+}
+/**
+ * Tracks when subscription checkout onConnectionError callback is invoked
+ */
+function trackSubscriptionConnectionError(orderId, errorCode, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        ...(errorCode !== undefined && { errorCode }),
+    };
+    trackEvent("Subscription Connection Error", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription connection error:", error);
+        }
+    });
+}
+/**
+ * Tracks when subscription checkout onSdkError callback is invoked
+ */
+function trackSubscriptionSdkError(errors, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: orderId,
+        errors,
+        errorCount: errors.length,
+    };
+    trackEvent("Subscription SDK Error", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on subscription SDK error:", error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Unsupported Functionality Telemetry
+// ---------------------------------------------------------------------------
+/**
+ * Internal telemetry - fires when a merchant uses functionality that is
+ * unsupported in the current context or deprecated.
+ * Fires at most once per detection site (callers use a ref guard).
+ */
+function trackUseOfUnsupportedFunctionality(name, orderId, publicKey, devMode, mockMode, checkoutUrl) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl),
+        name,
+    };
+    trackEvent("Use of Unsupported Functionality", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on unsupported functionality:", error);
+        }
+    });
+}
+/** Standard checkout tracker map - delegates to trackStandard* functions */
+exports.standardCheckoutTrackers = {
+    trackStartAttempt: trackStandardStartAttempt,
+    trackStartSuccess: trackStandardStartSuccess,
+    trackStartFailure: trackStandardStartFailure,
+    trackWindowOpen: trackStandardWindowOpen,
+    trackWindowClose: trackStandardWindowClose,
+    trackInvalidMessageReceived: trackStandardInvalidMessageReceived,
+    trackPaymentSuccess: trackStandardPaymentSuccess,
+    trackPaymentFailure: trackStandardPaymentFailure,
+    trackPaymentTerminate: trackStandardPaymentTerminate,
+    trackConnectionError: trackStandardConnectionError,
+    trackSdkError: trackStandardSdkError,
+    trackBankTransferSubmitted: trackStandardBankTransferSubmitted,
+    trackPayViaBankCompleted: trackStandardPayViaBankCompleted,
+    trackPayViaBankBankConnectionSuccessful: trackStandardPayViaBankBankConnectionSuccessful,
+};
+/** Subscription checkout tracker map - delegates to trackSubscription* functions, no-ops for bank transfer */
+exports.subscriptionCheckoutTrackers = {
+    trackStartAttempt: trackSubscriptionStartAttempt,
+    trackStartSuccess: trackSubscriptionStartSuccess,
+    trackStartFailure: trackSubscriptionStartFailure,
+    trackWindowOpen: trackSubscriptionWindowOpen,
+    trackWindowClose: trackSubscriptionWindowClose,
+    trackInvalidMessageReceived: trackSubscriptionInvalidMessageReceived,
+    trackPaymentSuccess: trackSubscriptionPaymentSuccess,
+    trackPaymentFailure: trackSubscriptionPaymentFailure,
+    trackPaymentTerminate: trackSubscriptionPaymentTerminate,
+    trackConnectionError: trackSubscriptionConnectionError,
+    trackSdkError: trackSubscriptionSdkError,
+    trackBankTransferSubmitted: (...args) => {
+        const devMode = args[2];
+        if (devMode) {
+            console.warn("[Glomo-RN-SDK] Unexpected bank transfer event in subscription flow");
+        }
+    },
+    trackPayViaBankCompleted: (...args) => {
+        const devMode = args[3];
+        if (devMode) {
+            console.warn("[Glomo-RN-SDK] Unexpected pay via bank completed event in subscription flow");
+        }
+    },
+    trackPayViaBankBankConnectionSuccessful: (...args) => {
+        const devMode = args[3];
+        if (devMode) {
+            console.warn("[Glomo-RN-SDK] Unexpected pay via bank connection event in subscription flow");
+        }
+    },
+};