@glomopay/react-native-sdk 2.0.2 → 3.0.1

package/src/utils/analytics.ts

@@ -10,8 +10,14 @@
  * Analytics failures never break the SDK.
  */
 
+import { Platform } from "react-native";
 import { getSegmentClient, isSegmentAvailable, getAnonymousId, getSegmentWriteKey } from "../config/segment";
 
+/**
+ * Flow type for checkout
+ */
+export type FlowType = "lrs" | "standard" | "unified";
+
 /**
  * Common properties that should be included with every event
  */
@@ -21,7 +27,11 @@ export interface CommonEventProperties {
     mockMode?: boolean;
     orderId?: string;
     publicKey?: string;
-    lrsUrl?: string;
+    checkoutUrl?: string;
+    platform: "react-native";
+    deviceOS: "ios" | "android" | string;
+    deviceOSVersion: string;
+    flowType?: FlowType;
     timestamp?: string;
     [key: string]: unknown;
 }
@@ -58,7 +68,8 @@ function getSdkVersion(): string {
  * @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(
@@ -66,16 +77,21 @@ function buildCommonProperties(
     publicKey?: string,
     devMode: boolean = false,
     mockMode: boolean = false,
-    lrsUrl?: string
+    checkoutUrl?: string,
+    flowType?: FlowType
 ): CommonEventProperties {
     return {
         orderId,
         publicKey,
-        lrsUrl,
+        checkoutUrl,
         devMode,
         mockMode,
+        platform: "react-native",
+        deviceOS: Platform.OS,
+        deviceOSVersion: String(Platform.Version),
         sdkVersion: getSdkVersion(),
         timestamp: new Date().toISOString(),
+        ...(flowType && { flowType }),
     };
 }
 
@@ -97,7 +113,7 @@ async function trackEvent(
     // Returning early if GlomoPay Segment is not available
     if (!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;
     }
@@ -109,7 +125,7 @@ async function trackEvent(
         // 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;
         }
@@ -139,12 +155,12 @@ async function trackEvent(
         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
     }
@@ -181,7 +197,7 @@ export function trackStartSuccess(
     // 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);
         }
     });
 }
@@ -220,7 +236,7 @@ export function trackStartAttempt(
     // 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);
         }
     });
 }
@@ -259,7 +275,7 @@ export function trackStartFailure(
     // 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);
         }
     });
 }
@@ -292,7 +308,7 @@ export function trackWindowOpen(
     // 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);
         }
     });
 }
@@ -322,7 +338,7 @@ export function trackWindowClose(
     // 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);
         }
     });
 }
@@ -377,7 +393,7 @@ export function trackInvalidMessageReceived(
     // 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);
         }
     });
 }
@@ -407,7 +423,7 @@ export function trackPaymentSuccess(
     // 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);
         }
     });
 }
@@ -437,7 +453,7 @@ export function trackPaymentFailure(
     // 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);
         }
     });
 }
@@ -467,7 +483,7 @@ export function trackPaymentTerminate(
     // 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);
         }
     });
 }
@@ -497,7 +513,7 @@ export function trackConnectionError(
     // 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);
         }
     });
 }
@@ -526,7 +542,36 @@ export function trackEducationStepsShown(
     };
     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
+ */
+export function trackEducationStepsFailedToShow(
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    lrsUrl?: string,
+    reason?: string
+): void {
+    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);
         }
     });
 }
@@ -557,7 +602,371 @@ export function trackSdkError(
     // 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
+ */
+export function trackStandardStartSuccess(
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string,
+    jailbreakDetectionInfo?: {
+        jailbreakDetectionLibraryInstalled: boolean;
+        jailbreakDetected: boolean | null;
+    }
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...(jailbreakDetectionInfo && {
+            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
+            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
+        }),
+    };
+    trackEvent("Standard Checkout Started", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when the standard checkout start() method is called (attempted)
+ */
+export function trackStandardStartAttempt(
+    status: string,
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string,
+    jailbreakDetectionInfo?: {
+        jailbreakDetectionLibraryInstalled: boolean;
+        jailbreakDetected: boolean | null;
+    }
+): void {
+    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(() => {});
+}
+
+/**
+ * Tracks when the standard checkout start() method fails
+ */
+export function trackStandardStartFailure(
+    reason: "device_forbidden" | "validation_error" | "payment_successful" | "invalid_status" | "invalid_url",
+    orderId?: string,
+    publicKey?: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string,
+    jailbreakDetectionInfo?: {
+        jailbreakDetectionLibraryInstalled: boolean;
+        jailbreakDetected: boolean | null;
+    }
+): void {
+    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(() => {});
+}
+
+/**
+ * Tracks when window.open is intercepted from the standard checkout WebView
+ */
+export function trackStandardWindowOpen(
+    source: "main" | "flow",
+    url: string,
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        source,
+        url,
+    };
+    trackEvent("Standard Checkout Window Open", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when window.close is intercepted from the standard checkout WebView
+ */
+export function trackStandardWindowClose(
+    source: "main" | "flow",
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        source,
+    };
+    trackEvent("Standard Checkout Window Close", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when invalid message data is received from a standard checkout WebView
+ */
+export function trackStandardInvalidMessageReceived(
+    webviewType: "main" | "flow",
+    data: unknown,
+    url: string | undefined,
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    let dataString: string;
+    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 {
+        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(() => {});
+}
+
+/**
+ * Tracks when standard checkout onPaymentSuccess callback is invoked
+ */
+export function trackStandardPaymentSuccess(
+    orderId: string,
+    paymentId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        paymentId,
+    };
+    trackEvent("Standard Payment Success", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when standard checkout onPaymentFailure callback is invoked
+ */
+export function trackStandardPaymentFailure(
+    orderId: string,
+    paymentId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        paymentId,
+    };
+    trackEvent("Standard Payment Failure", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when standard checkout onPaymentTerminate callback is invoked
+ */
+export function trackStandardPaymentTerminate(
+    orderId: string,
+    source: "user_dismiss" | "back_button" | "checkout_closed",
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        terminationSource: source,
+    };
+    trackEvent("Standard Payment Terminated", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when standard checkout onConnectionError callback is invoked
+ */
+export function trackStandardConnectionError(
+    orderId: string,
+    errorCode: number | undefined,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...(errorCode !== undefined && { errorCode }),
+    };
+    trackEvent("Standard Connection Error", properties, devMode).catch(() => {});
+}
+
+/**
+ * Tracks when standard checkout onSdkError callback is invoked
+ */
+export function trackStandardSdkError(
+    errors: Array<SdkError>,
+    orderId?: string,
+    publicKey?: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        errors,
+        errorCount: errors.length,
+    };
+    trackEvent("Standard SDK Error", properties, devMode).catch(() => {});
+}
+
+export function trackStandardBankTransferSubmitted(
+    orderId: string,
+    publicKey: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+    };
+    trackEvent("Standard Bank Transfer Submitted", properties, devMode).catch(() => {});
+}
+
+export function trackStandardPayViaBankCompleted(
+    orderId: string,
+    publicKey: string,
+    status: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        payViaBankStatus: status,
+    };
+    trackEvent("Standard Pay Via Bank Completed", properties, devMode).catch(() => {});
+}
+
+export function trackStandardPayViaBankBankConnectionSuccessful(
+    orderId: string,
+    publicKey: string,
+    bankIdentifier: string,
+    devMode: boolean = false,
+    mockMode: boolean = false,
+    standardUrl?: string
+): void {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        bankIdentifier,
+    };
+    trackEvent("Standard Pay Via Bank Bank Connection Successful", properties, devMode).catch(() => {});
+}
+
+// ---------------------------------------------------------------------------
+// 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
+ */
+export function trackOrderTypeDetectionStarted(orderId: string, publicKey: string, devMode: boolean = false): void {
+    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
+ */
+export function trackOrderTypeDetectionResolved(
+    orderId: string,
+    publicKey: string,
+    resolvedType: "lrs" | "standard",
+    devMode: boolean = false
+): void {
+    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
+ */
+export function trackOrderTypeDetectionFailed(
+    orderId: string,
+    publicKey: string,
+    error: string,
+    devMode: boolean = false
+): void {
+    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);
         }
     });
 }
@@ -574,9 +983,9 @@ export function checkAnalyticsStatus(devMode: boolean = false): boolean {
 
     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");
         }
     }
 

package/src/utils/device-compliance.ts

@@ -39,7 +39,7 @@ export function checkDeviceCompliance(devMode: boolean = false): boolean | null
     if (!JailMonkey) {
         if (devMode) {
             console.log(
-                "[GlomoPay RN SDK] jail-monkey not available. Device compliance check skipped. " +
+                "[Glomo-RN-SDK] jail-monkey not available. Device compliance check skipped. " +
                     "Install jail-monkey for enhanced security compliance."
             );
         }
@@ -52,14 +52,14 @@ export function checkDeviceCompliance(devMode: boolean = false): boolean | null
         const isCompromised = JailMonkey.isJailBroken();
         if (devMode) {
             console.log(
-                `[GlomoPay RN SDK] Device compliance check: ${isCompromised ? "FAILED (device compromised)" : "PASSED"}`
+                `[Glomo-RN-SDK] Device compliance check: ${isCompromised ? "FAILED (device compromised)" : "PASSED"}`
             );
         }
         return isCompromised;
     } catch (error) {
         if (devMode) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error("[GlomoPay RN SDK] Error checking device compliance:", errorMessage);
+            console.error("[Glomo-RN-SDK] Error checking device compliance:", errorMessage);
         }
         // On error, allowing checkout to proceed (fail open strategy)
         return null;

package/src/utils/validation.ts

@@ -60,14 +60,13 @@ export function isValidPaymentPayload(payload: unknown): payload is {
         return false;
     }
     const p = payload as Record<string, unknown>;
-    return (
-        typeof p.orderId === "string" &&
-        p.orderId.length > 0 &&
-        typeof p.paymentId === "string" &&
-        p.paymentId.length > 0 &&
-        typeof p.signature === "string" &&
-        p.signature.length > 0
-    );
+    /**
+     * Accept payloads where orderId, paymentId, and signature are strings.
+     * Empty strings are allowed because some flows (e.g. open banking / pay via bank)
+     * send payment.success with empty fields when the payment completes on the
+     * bank's side before the checkout backend has resolved ids.
+     */
+    return typeof p.orderId === "string" && typeof p.paymentId === "string" && typeof p.signature === "string";
 }
 
 /**