@glomopay/react-native-sdk 4.0.0 → 5.0.0

package/lib/utils/analytics.js

@@ -12,6 +12,9 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.subscriptionCheckoutTrackers = exports.standardCheckoutTrackers = void 0;
+exports.setSdkSession = setSdkSession;
+exports.bindCheckoutStatus = bindCheckoutStatus;
+exports.releaseSdkSession = releaseSdkSession;
 exports.trackStartSuccess = trackStartSuccess;
 exports.trackStartAttempt = trackStartAttempt;
 exports.trackStartFailure = trackStartFailure;
@@ -54,8 +57,72 @@ exports.trackSubscriptionPaymentTerminate = trackSubscriptionPaymentTerminate;
 exports.trackSubscriptionConnectionError = trackSubscriptionConnectionError;
 exports.trackSubscriptionSdkError = trackSubscriptionSdkError;
 exports.trackUseOfUnsupportedFunctionality = trackUseOfUnsupportedFunctionality;
+exports.trackBackNavigationViaSdkBackButton = trackBackNavigationViaSdkBackButton;
+exports.trackDevicePermissionRefused = trackDevicePermissionRefused;
+exports.trackIncompletePaymentPayload = trackIncompletePaymentPayload;
+exports.trackDroppedPaymentPayload = trackDroppedPaymentPayload;
+exports.trackFileUploadRequested = trackFileUploadRequested;
+exports.trackFileSaveRequested = trackFileSaveRequested;
+exports.trackFileSaveCompleted = trackFileSaveCompleted;
 const react_native_1 = require("react-native");
 const segment_1 = require("../config/segment");
+/**
+ * The current checkout attempt, and how to read its status.
+ *
+ * Module scope because `buildCommonProperties` is spread into every event and takes no context
+ * argument. Installed by useSdkSession for as long as a checkout component is mounted, so nothing
+ * here survives a merchant's screen being torn down.
+ */
+let activeSessionId;
+let readCheckoutStatus;
+/**
+ * Installs the id that correlates every event from one checkout attempt.
+ *
+ * Nothing else does: joining on `orderId` fails the moment a merchant retries `start()`, which
+ * produces two attempts that are indistinguishable without this. Scoped per mount rather than per
+ * `start()`, so a retry reads as two start_attempted events inside one session - which is the signal
+ * worth having.
+ */
+function setSdkSession(sessionId) {
+    activeSessionId = sessionId;
+}
+/**
+ * Binds a getter for the checkout status, resolved at capture time.
+ *
+ * A getter rather than a value, deliberately. Pushing the status per call would mean touching every
+ * tracker and would go stale between transitions - which is exactly the bug the Flutter SDK fixed in
+ * KAN-8085, where `checkout_status` was null on every real event.
+ */
+function bindCheckoutStatus(read) {
+    readCheckoutStatus = read;
+}
+/**
+ * Releases the session a mount installed, and only if it is still the active one.
+ *
+ * Clearing unconditionally is wrong whenever two checkout components overlap - a merchant who keeps
+ * a previous screen mounted, or renders one per row in a list. The component unmounting would strip
+ * `sessionId` and `checkoutStatus` off every later event of a sibling that is still mid-payment, and
+ * an event missing them is indistinguishable from one sent by a pre-v5 build.
+ *
+ * It does not make the singletons safe for concurrent mounts - the last mount still wins while both
+ * are alive. It removes the case where the survivor is left reporting nothing at all.
+ */
+function releaseSdkSession(sessionId) {
+    if (activeSessionId !== sessionId) {
+        return;
+    }
+    activeSessionId = undefined;
+    readCheckoutStatus = undefined;
+}
+/** Never lets a merchant's status getter break an event */
+function currentCheckoutStatus() {
+    try {
+        return readCheckoutStatus === null || readCheckoutStatus === void 0 ? void 0 : readCheckoutStatus();
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
 /**
  * Gets the SDK version from package.json
  * Falls back to a default value if package.json cannot be read
@@ -97,6 +164,8 @@ function buildCommonProperties(orderId, publicKey, devMode = false, mockMode = f
         sdkVersion: getSdkVersion(),
         timestamp: new Date().toISOString(),
         ...(flowType && { flowType }),
+        ...(activeSessionId && { sessionId: activeSessionId }),
+        ...(currentCheckoutStatus() !== undefined && { checkoutStatus: currentCheckoutStatus() }),
     };
 }
 /**
@@ -168,15 +237,12 @@ async function trackEvent(eventName, properties = {}, devMode = false) {
  * @param devMode - Whether dev mode is enabled
  * @param mockMode - Whether mock mode is enabled
  * @param lrsUrl - The LRS checkout URL
- * @param jailbreakDetectionInfo - Optional jailbreak detection information
+ * @param dependencyInfo - Optional inventory of what this build could and could not load
  */
-function trackStartSuccess(orderId, publicKey, devMode = false, mockMode = false, lrsUrl, jailbreakDetectionInfo) {
+function trackStartSuccess(orderId, publicKey, devMode = false, mockMode = false, lrsUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Started", properties, devMode).catch((error) => {
@@ -194,16 +260,13 @@ function trackStartSuccess(orderId, publicKey, devMode = false, mockMode = false
  * @param devMode - Whether dev mode is enabled
  * @param mockMode - Whether mock mode is enabled
  * @param lrsUrl - The LRS checkout URL
- * @param jailbreakDetectionInfo - Optional jailbreak detection information
+ * @param dependencyInfo - Optional inventory of what this build could and could not load
  */
-function trackStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, lrsUrl, jailbreakDetectionInfo) {
+function trackStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, lrsUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
         status,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Start Attempted", properties, devMode).catch((error) => {
@@ -221,16 +284,13 @@ function trackStartAttempt(status, orderId, publicKey, devMode = false, mockMode
  * @param devMode - Whether dev mode is enabled
  * @param mockMode - Whether mock mode is enabled
  * @param lrsUrl - The LRS checkout URL
- * @param jailbreakDetectionInfo - Optional jailbreak detection information
+ * @param dependencyInfo - Optional inventory of what this build could and could not load
  */
-function trackStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, lrsUrl, jailbreakDetectionInfo) {
+function trackStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, lrsUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
         failureReason: reason,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Checkout Start Failed", properties, devMode).catch((error) => {
@@ -344,10 +404,10 @@ function trackInvalidMessageReceived(webviewType, data, url, orderId, publicKey,
  * @param mockMode - Whether mock mode is enabled
  * @param lrsUrl - The LRS checkout URL
  */
-function trackPaymentSuccess(orderId, paymentId, publicKey, devMode = false, mockMode = false, lrsUrl) {
+function trackPaymentSuccess(payment, publicKey, devMode = false, mockMode = false, lrsUrl) {
     const properties = {
-        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
-        paymentId,
+        ...buildCommonProperties(payment.orderId, publicKey, devMode, mockMode, lrsUrl),
+        ...payment,
     };
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Payment Success", properties, devMode).catch((error) => {
@@ -366,10 +426,10 @@ function trackPaymentSuccess(orderId, paymentId, publicKey, devMode = false, moc
  * @param mockMode - Whether mock mode is enabled
  * @param lrsUrl - The LRS checkout URL
  */
-function trackPaymentFailure(orderId, paymentId, publicKey, devMode = false, mockMode = false, lrsUrl) {
+function trackPaymentFailure(payment, publicKey, devMode = false, mockMode = false, lrsUrl) {
     const properties = {
-        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
-        paymentId,
+        ...buildCommonProperties(payment.orderId, publicKey, devMode, mockMode, lrsUrl),
+        ...payment,
     };
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Payment Failure", properties, devMode).catch((error) => {
@@ -388,10 +448,10 @@ function trackPaymentFailure(orderId, paymentId, publicKey, devMode = false, moc
  * @param mockMode - Whether mock mode is enabled
  * @param lrsUrl - The LRS checkout URL
  */
-function trackPaymentTerminate(orderId, source, publicKey, devMode = false, mockMode = false, lrsUrl) {
+function trackPaymentTerminate(orderId, termination, publicKey, devMode = false, mockMode = false, lrsUrl) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, lrsUrl),
-        terminationSource: source,
+        ...termination,
     };
     // Async tracking to avoid blocking the main thread
     trackEvent("LRS Payment Terminated", properties, devMode).catch((error) => {
@@ -493,13 +553,10 @@ function trackSdkError(errors, orderId, publicKey, devMode = false, mockMode = f
 /**
  * Tracks when the standard checkout start() method has been called successfully
  */
-function trackStandardStartSuccess(orderId, publicKey, devMode = false, mockMode = false, standardUrl, jailbreakDetectionInfo) {
+function trackStandardStartSuccess(orderId, publicKey, devMode = false, mockMode = false, standardUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     trackEvent("Standard Checkout Started", properties, devMode).catch((error) => {
         if (devMode) {
@@ -510,14 +567,11 @@ function trackStandardStartSuccess(orderId, publicKey, devMode = false, mockMode
 /**
  * Tracks when the standard checkout start() method is called (attempted)
  */
-function trackStandardStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, standardUrl, jailbreakDetectionInfo) {
+function trackStandardStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, standardUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         status,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     trackEvent("Standard Checkout Start Attempted", properties, devMode).catch((error) => {
         if (devMode) {
@@ -528,14 +582,11 @@ function trackStandardStartAttempt(status, orderId, publicKey, devMode = false,
 /**
  * Tracks when the standard checkout start() method fails
  */
-function trackStandardStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, standardUrl, jailbreakDetectionInfo) {
+function trackStandardStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, standardUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
         failureReason: reason,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     trackEvent("Standard Checkout Start Failed", properties, devMode).catch((error) => {
         if (devMode) {
@@ -613,10 +664,10 @@ function trackStandardInvalidMessageReceived(webviewType, data, url, orderId, pu
 /**
  * Tracks when standard checkout onPaymentSuccess callback is invoked
  */
-function trackStandardPaymentSuccess(orderId, paymentId, publicKey, devMode = false, mockMode = false, standardUrl) {
+function trackStandardPaymentSuccess(payment, publicKey, devMode = false, mockMode = false, standardUrl) {
     const properties = {
-        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
-        paymentId,
+        ...buildCommonProperties(payment.orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...payment,
     };
     trackEvent("Standard Payment Success", properties, devMode).catch((error) => {
         if (devMode) {
@@ -627,10 +678,10 @@ function trackStandardPaymentSuccess(orderId, paymentId, publicKey, devMode = fa
 /**
  * Tracks when standard checkout onPaymentFailure callback is invoked
  */
-function trackStandardPaymentFailure(orderId, paymentId, publicKey, devMode = false, mockMode = false, standardUrl) {
+function trackStandardPaymentFailure(payment, publicKey, devMode = false, mockMode = false, standardUrl) {
     const properties = {
-        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
-        paymentId,
+        ...buildCommonProperties(payment.orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...payment,
     };
     trackEvent("Standard Payment Failure", properties, devMode).catch((error) => {
         if (devMode) {
@@ -641,10 +692,10 @@ function trackStandardPaymentFailure(orderId, paymentId, publicKey, devMode = fa
 /**
  * Tracks when standard checkout onPaymentTerminate callback is invoked
  */
-function trackStandardPaymentTerminate(orderId, source, publicKey, devMode = false, mockMode = false, standardUrl) {
+function trackStandardPaymentTerminate(orderId, termination, publicKey, devMode = false, mockMode = false, standardUrl) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
-        terminationSource: source,
+        ...termination,
     };
     trackEvent("Standard Payment Terminated", properties, devMode).catch((error) => {
         if (devMode) {
@@ -681,9 +732,10 @@ function trackStandardSdkError(errors, orderId, publicKey, devMode = false, mock
         }
     });
 }
-function trackStandardBankTransferSubmitted(orderId, publicKey, devMode = false, mockMode = false, standardUrl) {
+function trackStandardBankTransferSubmitted(orderId, journey, publicKey, devMode = false, mockMode = false, standardUrl) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
+        ...journey,
     };
     trackEvent("Standard Bank Transfer Submitted", properties, devMode).catch((error) => {
         if (devMode) {
@@ -691,10 +743,10 @@ function trackStandardBankTransferSubmitted(orderId, publicKey, devMode = false,
         }
     });
 }
-function trackStandardPayViaBankCompleted(orderId, publicKey, status, devMode = false, mockMode = false, standardUrl) {
+function trackStandardPayViaBankCompleted(orderId, journey, publicKey, devMode = false, mockMode = false, standardUrl) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, standardUrl, "standard"),
-        payViaBankStatus: status,
+        ...journey,
     };
     trackEvent("Standard Pay Via Bank Completed", properties, devMode).catch((error) => {
         if (devMode) {
@@ -785,15 +837,12 @@ function checkAnalyticsStatus(devMode = false) {
 /**
  * Tracks when the subscription checkout start() method is called (attempted)
  */
-function trackSubscriptionStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, jailbreakDetectionInfo) {
+function trackSubscriptionStartAttempt(status, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
         subscriptionId: orderId,
         status,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     trackEvent("Subscription Checkout Start Attempted", properties, devMode).catch((error) => {
         if (devMode) {
@@ -804,14 +853,11 @@ function trackSubscriptionStartAttempt(status, orderId, publicKey, devMode = fal
 /**
  * Tracks when the subscription checkout start() method has been called successfully
  */
-function trackSubscriptionStartSuccess(orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, jailbreakDetectionInfo) {
+function trackSubscriptionStartSuccess(orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
         subscriptionId: orderId,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     trackEvent("Subscription Checkout Started", properties, devMode).catch((error) => {
         if (devMode) {
@@ -822,15 +868,12 @@ function trackSubscriptionStartSuccess(orderId, publicKey, devMode = false, mock
 /**
  * Tracks when the subscription checkout start() method fails
  */
-function trackSubscriptionStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, jailbreakDetectionInfo) {
+function trackSubscriptionStartFailure(reason, orderId, publicKey, devMode = false, mockMode = false, checkoutUrl, dependencyInfo) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
         subscriptionId: orderId,
         failureReason: reason,
-        ...(jailbreakDetectionInfo && {
-            jailbreakDetectionLibraryInstalled: jailbreakDetectionInfo.jailbreakDetectionLibraryInstalled,
-            jailbreakDetected: jailbreakDetectionInfo.jailbreakDetected,
-        }),
+        ...dependencyInfo,
     };
     trackEvent("Subscription Checkout Start Failed", properties, devMode).catch((error) => {
         if (devMode) {
@@ -911,11 +954,11 @@ function trackSubscriptionInvalidMessageReceived(webviewType, data, url, orderId
 /**
  * Tracks when subscription checkout onPaymentSuccess callback is invoked
  */
-function trackSubscriptionPaymentSuccess(orderId, paymentId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+function trackSubscriptionPaymentSuccess(payment, publicKey, devMode = false, mockMode = false, checkoutUrl) {
     const properties = {
-        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
-        subscriptionId: orderId,
-        paymentId,
+        ...buildCommonProperties(payment.orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: payment.orderId,
+        ...payment,
     };
     trackEvent("Subscription Payment Success", properties, devMode).catch((error) => {
         if (devMode) {
@@ -926,11 +969,11 @@ function trackSubscriptionPaymentSuccess(orderId, paymentId, publicKey, devMode
 /**
  * Tracks when subscription checkout onPaymentFailure callback is invoked
  */
-function trackSubscriptionPaymentFailure(orderId, paymentId, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+function trackSubscriptionPaymentFailure(payment, publicKey, devMode = false, mockMode = false, checkoutUrl) {
     const properties = {
-        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
-        subscriptionId: orderId,
-        paymentId,
+        ...buildCommonProperties(payment.orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
+        subscriptionId: payment.orderId,
+        ...payment,
     };
     trackEvent("Subscription Payment Failure", properties, devMode).catch((error) => {
         if (devMode) {
@@ -941,11 +984,11 @@ function trackSubscriptionPaymentFailure(orderId, paymentId, publicKey, devMode
 /**
  * Tracks when subscription checkout onPaymentTerminate callback is invoked
  */
-function trackSubscriptionPaymentTerminate(orderId, source, publicKey, devMode = false, mockMode = false, checkoutUrl) {
+function trackSubscriptionPaymentTerminate(orderId, termination, publicKey, devMode = false, mockMode = false, checkoutUrl) {
     const properties = {
         ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, "subscriptions"),
         subscriptionId: orderId,
-        terminationSource: source,
+        ...termination,
     };
     trackEvent("Subscription Payment Terminated", properties, devMode).catch((error) => {
         if (devMode) {
@@ -1003,6 +1046,183 @@ function trackUseOfUnsupportedFunctionality(name, orderId, publicKey, devMode, m
         }
     });
 }
+// ---------------------------------------------------------------------------
+// SDK Navigation Telemetry
+// ---------------------------------------------------------------------------
+/**
+ * Internal telemetry - fires when the user taps the SDK's back chevron over a bank flow.
+ *
+ * Its own event rather than `window.close`, which it used to reuse. The chevron is back-navigation:
+ * it returns the user to the main checkout with the session intact and the ability to pay, where
+ * `window.close` means something actually closed. Reusing it made a user pressing back
+ * indistinguishable in Segment from the page closing a window.
+ *
+ * This is the only host-invisible interaction the SDK has - the chevron deliberately does not reach
+ * onPaymentTerminate, because a merchant who cancels the order on terminate would cancel live
+ * orders every time a user backed out of one bank to try another. This event is how it stays
+ * visible to us without becoming a termination.
+ */
+function trackBackNavigationViaSdkBackButton(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType);
+    trackEvent("Back Navigation Via SDK Back Button", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on SDK back navigation:", error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Device Permission Telemetry
+// ---------------------------------------------------------------------------
+/**
+ * Internal telemetry - fires when the user refuses a device permission the bank's page asked for.
+ *
+ * This was the one callback in the SDK with no tracker at all, so a refusal was invisible: there was
+ * no way to answer how often it happens or on which flows.
+ *
+ * `source` says where the observation came from, and the two are not equivalent:
+ *
+ * - `permission_request` is the Android WebView asking us, which is also what drives
+ *   `onUserRefusedDevicePermissions`. Android only - iOS raises its own prompt inside WKWebView and
+ *   never reports the answer back.
+ * - `get_user_media` is the flow injection watching `getUserMedia` reject with `NotAllowedError`.
+ *   It reaches iOS, and it fires no callback: coverage depends on whether a given bank uses
+ *   `getUserMedia` at all, and a callback with partial coverage is a contract we cannot hold.
+ *
+ * So an absent event still means "not observable" rather than "did not happen", and `source` plus
+ * the `deviceOS` already on every event is what separates the cases.
+ */
+function trackDevicePermissionRefused(resource, source, orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType),
+        resource,
+        source,
+    };
+    trackEvent("Device Permission Refused", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on device permission refused:", error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Payment Payload Integrity Telemetry
+// ---------------------------------------------------------------------------
+/**
+ * Internal telemetry - fires when a terminal payment payload arrives without `paymentId` or
+ * `signature`.
+ *
+ * The callback still fires; this measures how often the page reports an outcome before the backend
+ * has resolved ids, which is the thing that made the old strict validation drop real payments.
+ * Names the missing fields, never their values.
+ */
+function trackIncompletePaymentPayload(event, missingFields, source, orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType),
+        event,
+        source,
+        missingFields,
+        missingFieldCount: missingFields.length,
+    };
+    trackEvent("Incomplete Payment Payload", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on incomplete payment payload:", error);
+        }
+    });
+}
+/**
+ * Internal telemetry - fires when a payment payload cannot be routed at all.
+ *
+ * Reached only when `orderId` is absent or the optional fields carry the wrong type, so there is no
+ * outcome to report to the merchant without fabricating one. Before v5 this path was a
+ * devMode-only `console.error`, which meant a dropped payment left no trace in a release build.
+ *
+ * Carries the payload's **key names** and nothing else - the values are payment identifiers.
+ */
+function trackDroppedPaymentPayload(event, payloadKeys, source, orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType),
+        event,
+        source,
+        payloadKeys,
+    };
+    trackEvent("Payment Payload Dropped", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on dropped payment payload:", error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// File Upload Telemetry
+// ---------------------------------------------------------------------------
+/**
+ * Internal telemetry - fires when the user taps a file input on a bank's page.
+ *
+ * **The attempt only.** react-native-webview runs the whole chooser natively through
+ * `onShowFileChooser` and `startPhotoPickerIntent`, so no outcome - picked, cancelled or failed -
+ * ever reaches JavaScript. Getting one would need either a patched rnw or a page-side `change`
+ * listener reporting over the bridge, and the page here is a third party's.
+ *
+ * So an absent follow-up event means "not observable", never "the upload failed". Do not build a
+ * success rate on this.
+ */
+function trackFileUploadRequested(acceptTypes, hasCapture, orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType),
+        acceptTypes,
+        hasCapture,
+    };
+    trackEvent("File Upload Requested", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on file upload requested:", error);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// File Save Telemetry
+// ---------------------------------------------------------------------------
+/**
+ * Event names carry no flow prefix, unlike every payment event above.
+ *
+ * Saving a document is not owned by a flow - the capability is advertised to every WebView the SDK
+ * opens - so a prefix would assert a distinction that does not exist. `flowType` rides the common
+ * properties for anyone who wants to slice by it. The names match the Flutter SDK's so one query
+ * spans both.
+ */
+/**
+ * Internal telemetry - fires when the page asks the SDK to put a document on the device.
+ *
+ * Paired with trackFileSaveCompleted by `saveId`, which fires for every request that got this far,
+ * including the failures and the dismissals. A requested with no completion means the handler died.
+ */
+function trackFileSaveRequested(saveId, orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType),
+        saveId,
+    };
+    trackEvent("File Save Requested", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on file save requested:", error);
+        }
+    });
+}
+/**
+ * Internal telemetry - fires once per request, whatever the outcome.
+ *
+ * `eventData` is the projection the saver builds, never the result object itself. The inputs to a
+ * save are a signed URL and a filename; the projection is what is safe to send, and taking it
+ * pre-built keeps the decision about what that means in one place next to the values it excludes.
+ */
+function trackFileSaveCompleted(saveId, eventData, orderId, publicKey, devMode, mockMode, checkoutUrl, flowType) {
+    const properties = {
+        ...buildCommonProperties(orderId, publicKey, devMode, mockMode, checkoutUrl, flowType),
+        ...eventData,
+        saveId,
+    };
+    trackEvent("File Save Completed", properties, devMode).catch((error) => {
+        if (devMode) {
+            console.error("[Glomo-RN-SDK] Event tracking error on file save completed:", error);
+        }
+    });
+}
 /** Standard checkout tracker map - delegates to trackStandard* functions */
 exports.standardCheckoutTrackers = {
     trackStartAttempt: trackStandardStartAttempt,
@@ -1032,14 +1252,12 @@ exports.subscriptionCheckoutTrackers = {
     trackPaymentTerminate: trackSubscriptionPaymentTerminate,
     trackConnectionError: trackSubscriptionConnectionError,
     trackSdkError: trackSubscriptionSdkError,
-    trackBankTransferSubmitted: (...args) => {
-        const devMode = args[2];
+    trackBankTransferSubmitted: (_orderId, _journey, _publicKey, devMode) => {
         if (devMode) {
             console.warn("[Glomo-RN-SDK] Unexpected bank transfer event in subscription flow");
         }
     },
-    trackPayViaBankCompleted: (...args) => {
-        const devMode = args[3];
+    trackPayViaBankCompleted: (_orderId, _journey, _publicKey, devMode) => {
         if (devMode) {
             console.warn("[Glomo-RN-SDK] Unexpected pay via bank completed event in subscription flow");
         }