@glomopay/react-native-sdk 2.0.2 → 3.1.0

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;
@@ -40,7 +39,7 @@ function checkDeviceCompliance(devMode = false) {
     const JailMonkey = getJailMonkey();
     if (!JailMonkey) {
         if (devMode) {
-            console.log("[GlomoPay RN SDK] jail-monkey not available. Device compliance check skipped. " +
+            console.log("[Glomo-RN-SDK] jail-monkey not available. Device compliance check skipped. " +
                 "Install jail-monkey for enhanced security compliance.");
         }
         // Check unavailable - allowing checkout to proceed
@@ -49,14 +48,14 @@ function checkDeviceCompliance(devMode = false) {
     try {
         const isCompromised = JailMonkey.isJailBroken();
         if (devMode) {
-            console.log(`[GlomoPay RN SDK] Device compliance check: ${isCompromised ? "FAILED (device compromised)" : "PASSED"}`);
+            console.log(`[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/lib/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAU3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM/C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAaA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAC3D,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAe,GACzB,IAAI,CAWN"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAU3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM/C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAYA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAC3D,QAAQ,EAAE,CAAC,GAAG,SAAS,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAe,GACzB,IAAI,CAWN"}

package/lib/utils/validation.js

@@ -54,12 +54,13 @@ function isValidPaymentPayload(payload) {
         return false;
     }
     const p = payload;
-    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";
 }
 /**
  * Safely executes a callback with error handling

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@glomopay/react-native-sdk",
-    "version": "2.0.2",
+    "version": "3.1.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"
     },
@@ -49,27 +50,38 @@
     },
     "homepage": "https://github.com/glomopay/glomopay-rn-sdk#readme",
     "dependencies": {
-        "axios": "^1.13.2"
+        "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/config/base.ts

@@ -3,37 +3,56 @@
  * This file contains the default base configuration variables for the GlomoPay RN SDK.
  */
 
-/** The publicly documented server environments for the SDK */
-export type GlomoLrsServer = "prod" | "staging";
+/** The publicly documented server environments for the SDK (v3 alias) */
+export type GlomoServer = "prod" | "staging";
 
-/** Internal extension that adds "local" for development use — not exported */
-type InternalGlomoLrsServer = GlomoLrsServer | "local";
+/** Internal extension that adds "local" for development use - not exported */
+type InternalGlomoServer = GlomoServer | "local";
 
 /** Base URLs for a given server environment */
-export interface GlomoLrsServerConfig {
-    checkoutBaseUrl: string;
-    educationCarouselBaseUrl: string;
+export interface GlomoServerBaseUrls {
+    lrsCheckout: string;
+    standardCheckout: string;
+    lrsEducationCarousel: string;
+    api: string;
 }
 
-export const DEFAULT_SERVER: InternalGlomoLrsServer = "prod";
+/** Server config with nested base URLs */
+export interface GlomoServerConfig {
+    baseUrl: GlomoServerBaseUrls;
+}
+
+export const DEFAULT_SERVER: InternalGlomoServer = "prod";
 
-export const SERVER_CONFIGS: Record<InternalGlomoLrsServer, GlomoLrsServerConfig> = {
+export const SERVER_CONFIGS: Record<InternalGlomoServer, GlomoServerConfig> = {
     prod: {
-        checkoutBaseUrl: "https://lrs-checkout.glomopay.com/",
-        educationCarouselBaseUrl: "https://glomopay-utilities.web.app/lrs-education-carousel/",
+        baseUrl: {
+            lrsCheckout: "https://lrs-checkout.glomopay.com/",
+            standardCheckout: "https://checkout.glomopay.com/",
+            lrsEducationCarousel: "https://glomopay-utilities.web.app/lrs-education-carousel/",
+            api: "https://api.glomopay.com",
+        },
     },
     staging: {
-        checkoutBaseUrl: "https://lrs-checkout-page-staging.web.app/",
-        educationCarouselBaseUrl: "https://glomopay-utilities-staging.web.app/lrs-education-carousel/",
+        baseUrl: {
+            lrsCheckout: "https://lrs-checkout-page-staging.web.app/",
+            standardCheckout: "https://glomopay-checkout-page-staging.web.app/",
+            lrsEducationCarousel: "https://glomopay-utilities-staging.web.app/lrs-education-carousel/",
+            api: "https://staging-api.glomopay.com",
+        },
     },
     local: {
-        checkoutBaseUrl: "http://localhost:6870/",
-        educationCarouselBaseUrl: "http://localhost:6871/lrs-education-carousel/",
+        baseUrl: {
+            lrsCheckout: "http://localhost:6870/",
+            standardCheckout: "http://localhost:4444/",
+            lrsEducationCarousel: "http://localhost:6871/lrs-education-carousel/",
+            api: "http://localhost:3000",
+        },
     },
 };
 
-/** Returns the server config for the given environment, falling back to the default (prod) server */
-export function resolveServerConfig(server?: InternalGlomoLrsServer): GlomoLrsServerConfig {
+/** Returns the full server config for the given environment, falling back to prod */
+export function resolveServerConfig(server?: InternalGlomoServer): GlomoServerConfig {
     const resolvedServer = server && server in SERVER_CONFIGS ? server : DEFAULT_SERVER;
 
     return SERVER_CONFIGS[resolvedServer];

package/src/config/segment.ts

@@ -67,7 +67,7 @@ export function initializeSegment(devMode: boolean = false): boolean {
     // Preventing multiple initialization attempts
     if (initializationAttempted) {
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Segment initialization already attempted");
+            console.log("[Glomo-RN-SDK] Segment initialization already attempted");
         }
         return segmentApiClient !== null;
     }
@@ -91,14 +91,14 @@ export function initializeSegment(devMode: boolean = false): boolean {
         });
 
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Segment Analytics initialized successfully");
+            console.log("[Glomo-RN-SDK] Segment Analytics initialized successfully");
         }
 
         return true;
     } catch (error) {
         if (devMode) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error("[GlomoPay RN SDK] Failed to initialize Segment:", errorMessage);
+            console.error("[Glomo-RN-SDK] Failed to initialize Segment:", errorMessage);
         }
 
         // Resetting the flag to allow retrying if needed

package/src/glomo-checkout.tsx

@@ -0,0 +1,147 @@
+/**
+ * The unified GlomoPay Checkout Component (v3).
+ * Detects order type (LRS vs Standard) and delegates rendering to the appropriate inner component.
+ */
+
+import React, { useImperativeHandle, useRef, useEffect, useMemo, forwardRef } from "react";
+
+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,
+        innerSubscriptionsRef,
+        props: passedProps,
+    }: UseGlomoCheckoutInternalReturn = useGlomoCheckout(props, { _suppressDeprecationWarning: true });
+
+    // Exposing start() and getStatus() via the forwarded ref for the merchant to call
+    useImperativeHandle(ref, () => ({
+        start,
+        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 booleans for the tracking effect to avoid depending on passedProps object
+    const hasBankTransferCallback = !!passedProps.onBankTransferSubmitted;
+    const hasPayViaBankCallback = !!passedProps.onPayViaBankCompleted;
+    const hasBankConnectionCallback = !!passedProps.onPayViaBankBankConnectionSuccessful;
+
+    useEffect(() => {
+        if (orderType !== "subscriptions" || hasTrackedUnsupportedRef.current) return;
+        hasTrackedUnsupportedRef.current = true;
+
+        const unsupported = [
+            hasBankTransferCallback && "onBankTransferSubmitted",
+            hasPayViaBankCallback && "onPayViaBankCompleted",
+            hasBankConnectionCallback && "onPayViaBankBankConnectionSuccessful",
+        ].filter(Boolean) as string[];
+
+        for (const name of unsupported) {
+            trackUseOfUnsupportedFunctionality(
+                name,
+                passedProps.subscriptionId,
+                passedProps.publicKey,
+                devMode,
+                mockMode,
+                ""
+            );
+        }
+    }, [
+        orderType,
+        hasBankTransferCallback,
+        hasPayViaBankCallback,
+        hasBankConnectionCallback,
+        passedProps.subscriptionId,
+        passedProps.publicKey,
+        devMode,
+        mockMode,
+    ]);
+
+    // Delegating to the LRS checkout component once order type is resolved as LRS
+    if (orderType === "lrs") {
+        return (
+            <GlomoLrsCheckout
+                ref={innerLrsRef}
+                server={passedProps.server}
+                publicKey={passedProps.publicKey}
+                orderId={passedProps.orderId!}
+                onPaymentSuccess={passedProps.onPaymentSuccess}
+                onPaymentFailure={passedProps.onPaymentFailure}
+                onConnectionError={passedProps.onConnectionError}
+                onPaymentTerminate={passedProps.onPaymentTerminate}
+                onSdkError={passedProps.onSdkError}
+                devMode={passedProps.devMode}
+            />
+        );
+    }
+
+    // Delegating to the Standard checkout component once order type is resolved as Standard
+    if (orderType === "standard") {
+        return (
+            <GlomoStandardCheckout
+                ref={innerStandardRef}
+                server={passedProps.server}
+                publicKey={passedProps.publicKey}
+                orderId={passedProps.orderId!}
+                onPaymentSuccess={passedProps.onPaymentSuccess}
+                onPaymentFailure={passedProps.onPaymentFailure}
+                onConnectionError={passedProps.onConnectionError}
+                onPaymentTerminate={passedProps.onPaymentTerminate}
+                onSdkError={passedProps.onSdkError}
+                onBankTransferSubmitted={passedProps.onBankTransferSubmitted}
+                onPayViaBankCompleted={passedProps.onPayViaBankCompleted}
+                onPayViaBankBankConnectionSuccessful={passedProps.onPayViaBankBankConnectionSuccessful}
+                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}
+                onPayViaBankBankConnectionSuccessful={passedProps.onPayViaBankBankConnectionSuccessful}
+                onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions}
+                devMode={passedProps.devMode}
+            />
+        );
+    }
+
+    /**
+     * No modal for detecting state - avoids iOS pageSheet conflict where
+     * dismissing the detecting modal interferes with the checkout modal presentation.
+     * The order type detection is fast enough that a loading indicator is not needed.
+     */
+    return null;
+}
+
+export const GlomoCheckout = forwardRef<GlomoCheckoutRef, GlomoCheckoutProps>(GlomoCheckoutComponent);
+
+GlomoCheckout.displayName = "GlomoCheckout";

package/src/glomo-lrs-checkout.tsx

@@ -57,7 +57,7 @@ function GlomoLrsCheckoutComponent(
         const resolvedMockMode = publicKey?.toLowerCase().startsWith("test_") ?? false;
         if (devMode) {
             console.log(
-                `[GlomoPay RN SDK] ${resolvedMockMode ? "Using" : "Not using"} Mock mode for publicKey: ${publicKey}`
+                `[Glomo-RN-SDK LRS] ${resolvedMockMode ? "Using" : "Not using"} Mock mode for publicKey: ${publicKey}`
             );
         }
         return resolvedMockMode;
@@ -179,7 +179,7 @@ function GlomoLrsCheckoutComponent(
             if (!injectedJavaScript) {
                 if (devMode) {
                     console.warn(
-                        `[GlomoPay RN SDK] JavaScript Injection missing for ${url}. Skipping ${identifier} Render.`
+                        `[Glomo-RN-SDK LRS] JavaScript Injection missing for ${url}. Skipping ${identifier} Render.`
                     );
                 }
                 return null;
@@ -191,14 +191,14 @@ function GlomoLrsCheckoutComponent(
                 if (!isValidUrl(url)) {
                     if (devMode) {
                         console.error(
-                            `[GlomoPay RN SDK] Invalid non-empty URL ${url} provided. Skipping ${identifier} Render.`
+                            `[Glomo-RN-SDK LRS] Invalid non-empty URL ${url} provided. Skipping ${identifier} Render.`
                         );
                     }
                     return null;
                 }
 
                 if (devMode) {
-                    console.error(`[GlomoPay RN SDK] Empty or invalid URL provided. Skipping ${identifier} Render.`);
+                    console.error(`[Glomo-RN-SDK LRS] Empty or invalid URL provided. Skipping ${identifier} Render.`);
                 }
                 return null;
             }
@@ -215,7 +215,7 @@ function GlomoLrsCheckoutComponent(
                     onNavigationStateChange={handleNavigationStateChange}
                     onLoadStart={() => {
                         if (devMode) {
-                            console.log(`[GlomoPay RN SDK] [${identifier}] WebView load started for ${url}`);
+                            console.log(`[Glomo-RN-SDK LRS] [${identifier}] WebView load started for ${url}`);
                         }
                     }}
                     onLoadEnd={() => {
@@ -223,13 +223,13 @@ function GlomoLrsCheckoutComponent(
                             ref.current.injectJavaScript(carouselViewportGuardScript);
                         }
                         if (devMode) {
-                            console.log(`[GlomoPay RN SDK] [${identifier}] WebView load ended for ${url}`);
+                            console.log(`[Glomo-RN-SDK LRS] [${identifier}] WebView load ended for ${url}`);
                         }
                     }}
                     onLoadProgress={({ nativeEvent }) => {
                         if (devMode && identifier === "educationCarousel") {
                             console.log(
-                                `[GlomoPay RN SDK] [educationCarousel] load progress=${nativeEvent.progress} url=${nativeEvent.url}`
+                                `[Glomo-RN-SDK LRS] [educationCarousel] load progress=${nativeEvent.progress} url=${nativeEvent.url}`
                             );
                         }
                     }}
@@ -304,7 +304,7 @@ function GlomoLrsCheckoutComponent(
 
         if (devMode) {
             console.log(
-                `[GlomoPay RN SDK] computed visibilityHook: ${value} for internal switch ${isVisible}, and checkout=${checkoutUrl};`
+                `[Glomo-RN-SDK LRS] computed visibilityHook: ${value} for internal switch ${isVisible}, and checkout=${checkoutUrl};`
             );
         }
         return value;
@@ -325,7 +325,7 @@ function GlomoLrsCheckoutComponent(
 
     if (devMode) {
         console.log(
-            `[GlomoPay RN SDK] Render gates: modal=${shouldShowModal}, flowOverlay=${shouldRenderFlowOverlay}, educationCarouselWebView=${shouldRenderEducationCarousel}, educationCarouselVisible=${showCarousel}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}, educationCarouselUrl=${resolvedEducationCarouselUrl || "<empty>"}`
+            `[Glomo-RN-SDK LRS] Render gates: modal=${shouldShowModal}, flowOverlay=${shouldRenderFlowOverlay}, educationCarouselWebView=${shouldRenderEducationCarousel}, educationCarouselVisible=${showCarousel}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}, educationCarouselUrl=${resolvedEducationCarouselUrl || "<empty>"}`
         );
     }