@glomopay/react-native-sdk 3.0.1 → 4.0.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;
@@ -37,11 +38,22 @@ 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");
 /**
@@ -53,7 +65,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";
     }
@@ -490,7 +501,11 @@ function trackStandardStartSuccess(orderId, publicKey, devMode = false, mockMode
             jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
         }),
     };
-    trackEvent("Standard Checkout Started", properties, devMode).catch(() => { });
+    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)
@@ -504,7 +519,11 @@ function trackStandardStartAttempt(status, orderId, publicKey, devMode = false,
             jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
         }),
     };
-    trackEvent("Standard Checkout Start Attempted", properties, devMode).catch(() => { });
+    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
@@ -518,7 +537,11 @@ function trackStandardStartFailure(reason, orderId, publicKey, devMode = false,
             jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
         }),
     };
-    trackEvent("Standard Checkout Start Failed", properties, devMode).catch(() => { });
+    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
@@ -529,7 +552,11 @@ function trackStandardWindowOpen(source, url, orderId, publicKey, devMode = fals
         source,
         url,
     };
-    trackEvent("Standard Checkout Window Open", properties, devMode).catch(() => { });
+    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
@@ -539,7 +566,11 @@ function trackStandardWindowClose(source, orderId, publicKey, devMode = false, m
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         source,
     };
-    trackEvent("Standard Checkout Window Close", properties, devMode).catch(() => { });
+    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
@@ -573,7 +604,11 @@ function trackStandardInvalidMessageReceived(webviewType, data, url, orderId, pu
         dataType: data === null ? "null" : typeof data,
         ...(url && { url }),
     };
-    trackEvent("Standard Checkout Invalid Message Received", properties, devMode).catch(() => { });
+    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
@@ -583,7 +618,11 @@ function trackStandardPaymentSuccess(orderId, paymentId, publicKey, devMode = fa
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         paymentId,
     };
-    trackEvent("Standard Payment Success", properties, devMode).catch(() => { });
+    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
@@ -593,7 +632,11 @@ function trackStandardPaymentFailure(orderId, paymentId, publicKey, devMode = fa
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         paymentId,
     };
-    trackEvent("Standard Payment Failure", properties, devMode).catch(() => { });
+    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
@@ -603,7 +646,11 @@ function trackStandardPaymentTerminate(orderId, source, publicKey, devMode = fal
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         terminationSource: source,
     };
-    trackEvent("Standard Payment Terminated", properties, devMode).catch(() => { });
+    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
@@ -613,7 +660,11 @@ function trackStandardConnectionError(orderId, errorCode, publicKey, devMode = f
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         ...(errorCode !== undefined && { errorCode }),
     };
-    trackEvent("Standard Connection Error", properties, devMode).catch(() => { });
+    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
@@ -624,27 +675,32 @@ function trackStandardSdkError(errors, orderId, publicKey, devMode = false, mock
         errors,
         errorCount: errors.length,
     };
-    trackEvent("Standard SDK Error", properties, devMode).catch(() => { });
+    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(() => { });
+    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(() => { });
-}
-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(() => { });
+    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);
+        }
+    });
 }
 // ---------------------------------------------------------------------------
 // Order Type Detection Trackers (Unified Flow)
@@ -723,3 +779,269 @@ function checkAnalyticsStatus(devMode = false) {
     }
     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,
+};
+/** 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");
+        }
+    },
+};

package/lib/utils/device-compliance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-compliance.d.ts","sourceRoot":"","sources":["../../src/utils/device-compliance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,GAAG,IAAI,CA+B9E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}
+{"version":3,"file":"device-compliance.d.ts","sourceRoot":"","sources":["../../src/utils/device-compliance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,GAAG,IAAI,CA+B9E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

package/lib/utils/device-compliance.js

@@ -16,7 +16,6 @@ exports.isComplianceCheckAvailable = isComplianceCheckAvailable;
  */
 function getJailMonkey() {
     try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
         const JailMonkey = require("jail-monkey");
         if (JailMonkey && typeof JailMonkey.isJailBroken === "function") {
             return JailMonkey;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@glomopay/react-native-sdk",
-    "version": "3.0.1",
+    "version": "4.0.0",
     "description": "The React Native SDK for GlomoPay",
     "license": "Apache-2.0",
     "main": "lib/index.js",
@@ -21,6 +21,7 @@
         "test": "jest",
         "prettier:check": "prettier --check \"**/*.{js,ts,jsx,tsx,json}\"",
         "prettier:format": "prettier --write \"**/*.{js,ts,jsx,tsx,json}\"",
+        "lint": "eslint src/",
         "clean": "rm -rf lib",
         "prepublishOnly": "npm run clean && tsc --noEmit && npm run build"
     },
@@ -51,26 +52,36 @@
     "dependencies": {
         "axios": "1.13.2"
     },
+    "peerDependenciesMeta": {
+        "jail-monkey": {
+            "optional": true
+        }
+    },
     "peerDependencies": {
+        "jail-monkey": "^2.6.0",
         "react": ">=17.0.0",
         "react-native": ">=0.68.0",
-        "react-native-webview": "^13.0.0",
-        "jail-monkey": "^2.6.0"
+        "react-native-webview": "^13.0.0"
     },
     "devDependencies": {
         "@types/react": "^18.0.0",
         "@types/react-native": "^0.73.0",
+        "@typescript-eslint/eslint-plugin": "^8.60.1",
+        "eslint": "^9.39.4",
+        "eslint-plugin-react-hooks": "^7.1.1",
         "jest": "^29.6.3",
         "prettier": "^3.0.0",
         "react": "18.2.0",
         "react-native": "0.73.5",
-        "typescript": "^5.0.0"
+        "typescript": "^5.0.0",
+        "typescript-eslint": "^8.60.1"
     },
     "files": [
         "lib",
         "src",
         "README.md",
         "CHANGELOG.md",
+        "MIGRATION.md",
         "LICENSE"
     ],
     "engines": {

package/src/glomo-checkout.tsx

@@ -1,18 +1,29 @@
 /**
- * The unified GlomoPay Checkout Component (v3).
+ * The unified GlomoPay Checkout Component (v4).
  * Detects order type (LRS vs Standard) and delegates rendering to the appropriate inner component.
+ * Enforces error handling via `onSdkError()` as a mandatory prop.
  */
 
-import React, { useImperativeHandle, forwardRef } from "react";
+import React, { useImperativeHandle, useRef, useEffect, useMemo, forwardRef } from "react";
 
-import { useGlomoCheckout } from "./use-glomo-checkout";
+import { useGlomoCheckout, type UseGlomoCheckoutInternalReturn } from "./use-glomo-checkout";
 import { type GlomoCheckoutRef, type GlomoCheckoutProps } from "./types/checkout";
+import { trackUseOfUnsupportedFunctionality } from "./utils/analytics";
 import { GlomoLrsCheckout } from "./glomo-lrs-checkout";
 import { GlomoStandardCheckout } from "./glomo-standard-checkout";
+import { GlomoSubscriptionsCheckout } from "./glomo-subscriptions-checkout";
 
 function GlomoCheckoutComponent(props: GlomoCheckoutProps, ref: React.ForwardedRef<GlomoCheckoutRef>) {
     // useGlomoCheckout handles order type detection and exposes start/getStatus for the ref
-    const { orderType, start, getStatus, innerLrsRef, innerStandardRef, props: passedProps } = useGlomoCheckout(props);
+    const {
+        orderType,
+        start,
+        getStatus,
+        innerLrsRef,
+        innerStandardRef,
+        innerSubscriptionsRef,
+        props: passedProps,
+    }: UseGlomoCheckoutInternalReturn = useGlomoCheckout(props, { _suppressDeprecationWarning: true });
 
     // Exposing start() and getStatus() via the forwarded ref for the merchant to call
     useImperativeHandle(ref, () => ({
@@ -20,6 +31,33 @@ function GlomoCheckoutComponent(props: GlomoCheckoutProps, ref: React.ForwardedR
         getStatus,
     }));
 
+    // Tracking unsupported callback props on subscription flows (fires once per mount)
+    const hasTrackedUnsupportedRef = useRef(false);
+    const devMode = passedProps.devMode ?? false;
+    const mockMode = useMemo(
+        () => passedProps.publicKey?.toLowerCase().startsWith("test_") ?? false,
+        [passedProps.publicKey]
+    );
+
+    // Extracting stable boolean for the tracking effect to avoid depending on passedProps object
+    const hasUserJourneyCallback = !!passedProps.onUserJourneyCompleted;
+
+    useEffect(() => {
+        if (orderType !== "subscriptions" || hasTrackedUnsupportedRef.current) return;
+        hasTrackedUnsupportedRef.current = true;
+
+        if (hasUserJourneyCallback) {
+            trackUseOfUnsupportedFunctionality(
+                "onUserJourneyCompleted",
+                passedProps.subscriptionId,
+                passedProps.publicKey,
+                devMode,
+                mockMode,
+                ""
+            );
+        }
+    }, [orderType, hasUserJourneyCallback, passedProps.subscriptionId, passedProps.publicKey, devMode, mockMode]);
+
     // Delegating to the LRS checkout component once order type is resolved as LRS
     if (orderType === "lrs") {
         return (
@@ -27,7 +65,7 @@ function GlomoCheckoutComponent(props: GlomoCheckoutProps, ref: React.ForwardedR
                 ref={innerLrsRef}
                 server={passedProps.server}
                 publicKey={passedProps.publicKey}
-                orderId={passedProps.orderId}
+                orderId={passedProps.orderId!}
                 onPaymentSuccess={passedProps.onPaymentSuccess}
                 onPaymentFailure={passedProps.onPaymentFailure}
                 onConnectionError={passedProps.onConnectionError}
@@ -45,15 +83,33 @@ function GlomoCheckoutComponent(props: GlomoCheckoutProps, ref: React.ForwardedR
                 ref={innerStandardRef}
                 server={passedProps.server}
                 publicKey={passedProps.publicKey}
-                orderId={passedProps.orderId}
+                orderId={passedProps.orderId!}
+                onPaymentSuccess={passedProps.onPaymentSuccess}
+                onPaymentFailure={passedProps.onPaymentFailure}
+                onConnectionError={passedProps.onConnectionError}
+                onPaymentTerminate={passedProps.onPaymentTerminate}
+                onSdkError={passedProps.onSdkError}
+                onUserJourneyCompleted={passedProps.onUserJourneyCompleted}
+                onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions}
+                devMode={passedProps.devMode}
+            />
+        );
+    }
+
+    // Delegating to the Subscriptions checkout component when subscriptionId is provided (no API call)
+    if (orderType === "subscriptions") {
+        return (
+            <GlomoSubscriptionsCheckout
+                ref={innerSubscriptionsRef}
+                server={passedProps.server}
+                publicKey={passedProps.publicKey}
+                subscriptionId={passedProps.subscriptionId!}
                 onPaymentSuccess={passedProps.onPaymentSuccess}
                 onPaymentFailure={passedProps.onPaymentFailure}
                 onConnectionError={passedProps.onConnectionError}
                 onPaymentTerminate={passedProps.onPaymentTerminate}
                 onSdkError={passedProps.onSdkError}
-                onBankTransferSubmitted={passedProps.onBankTransferSubmitted}
-                onPayViaBankCompleted={passedProps.onPayViaBankCompleted}
-                onPayViaBankBankConnectionSuccessful={passedProps.onPayViaBankBankConnectionSuccessful}
+                onUserJourneyCompleted={passedProps.onUserJourneyCompleted}
                 onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions}
                 devMode={passedProps.devMode}
             />

package/src/glomo-lrs-checkout.tsx

@@ -10,7 +10,7 @@ import { isValidUrl } from "./utils/validation";
 
 export interface GlomoLrsCheckoutProps extends UseLrsCheckoutOptions {
     visible?: boolean;
-    onSdkError?: (error: Array<SdkError>) => void;
+    onSdkError: (error: Array<SdkError>) => void;
 }
 
 export interface GlomoLrsCheckoutRef {