feat:universal links analytics handler for sdk

Author: BrtqKr

packages/react-native-detour/src/expo-router/nativeIntent.ts

@@ -1,7 +1,5 @@
-import { OPENED_VIA_UNIVERSAL_LINK } from "../analytics/const/definedEvents";
-import { analyticsEmitter } from "../analytics/utils/analyticsEmitter";
-import { checkClickLimit } from "../links/api/checkClickLimit";
 import { resolveShortLink } from "../links/api/resolveShortLink";
+import { sendUniversalLinkClick } from "../links/api/sendUniversalLinkClick";
 import type { Config } from "../links/types";
 import { getRouteFromDeepLink } from "../links/utils/urlHelpers";
 
@@ -289,28 +287,23 @@ export const createDetourNativeIntentHandler = (
       return path;
     }
 
-    analyticsEmitter.emit({
-      eventName: OPENED_VIA_UNIVERSAL_LINK,
-      data: { url: path },
-    });
-
     if (!options.config) {
       return fallbackPath;
     }
 
-    const clickLimitStatus = await checkClickLimit({
+    const clickResult = await sendUniversalLinkClick({
       apiKey: options.config.apiKey,
       appID: options.config.appID,
+      url: url.toString(),
     });
 
-    if (!clickLimitStatus.allowed) {
+    if (!clickResult.allowed) {
       console.error("🔗[Detour:CLICK_LIMIT_ERROR] Native-intent routing blocked:", {
         path,
-        status: clickLimitStatus.status,
-        error: clickLimitStatus.error,
-        code: clickLimitStatus.code,
-        clicksInPeriod: clickLimitStatus.clicksInPeriod,
-        effectiveLimit: clickLimitStatus.effectiveLimit,
+        error: clickResult.error,
+        code: clickResult.code,
+        clicksInPeriod: clickResult.clicksInPeriod,
+        effectiveLimit: clickResult.effectiveLimit,
       });
       return fallbackPath;
     }

packages/react-native-detour/src/links/api/sendUniversalLinkClick.ts

@@ -0,0 +1,73 @@
+import { SDK_HEADER_VALUE } from "../../version";
+import type { RequiredConfig } from "../types";
+
+const API_URL = "https://godetour.dev/api/link/universal-link-click";
+
+type UniversalLinkClickResponseBody = {
+  allowed?: boolean;
+  error?: string;
+  code?: string;
+  clicksInPeriod?: number;
+  effectiveLimit?: number;
+  remainingClicks?: number;
+  clickId?: string | null;
+};
+
+export type UniversalLinkClickResult =
+  | { allowed: true; clickId: string | null }
+  | {
+      allowed: false;
+      error: string;
+      code?: string;
+      clicksInPeriod?: number;
+      effectiveLimit?: number;
+    };
+
+export const sendUniversalLinkClick = async ({
+  apiKey: API_KEY,
+  appID,
+  url,
+}: Pick<RequiredConfig, "apiKey" | "appID"> & {
+  url: string;
+}): Promise<UniversalLinkClickResult> => {
+  try {
+    const response = await fetch(API_URL, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${API_KEY}`,
+        "X-App-ID": appID,
+        "X-SDK": SDK_HEADER_VALUE,
+      },
+      body: JSON.stringify({ url, timestamp: Date.now() }),
+    });
+
+    let body: UniversalLinkClickResponseBody | null = null;
+    try {
+      body = (await response.json()) as UniversalLinkClickResponseBody;
+    } catch {
+      body = null;
+    }
+
+    const isExplicitDeny = body?.allowed === false || response.status === 402;
+    if (isExplicitDeny) {
+      return {
+        allowed: false,
+        error: body?.error ?? "Click limit exceeded",
+        code: body?.code,
+        clicksInPeriod: body?.clicksInPeriod,
+        effectiveLimit: body?.effectiveLimit,
+      };
+    }
+
+    if (!response.ok) {
+      // Fail-open for temporary backend/network issues so apps keep working.
+      return { allowed: true, clickId: null };
+    }
+
+    return { allowed: true, clickId: body?.clickId ?? null };
+  } catch {
+    // Fail-open on transport errors; limit enforcement only happens on explicit deny.
+    return { allowed: true, clickId: null };
+  }
+};

packages/react-native-detour/src/links/hooks/useDetour.ts

@@ -2,8 +2,7 @@ import { useCallback, useEffect, useState } from "react";
 
 import { Linking } from "react-native";
 
-import { OPENED_VIA_UNIVERSAL_LINK } from "../../analytics/const/definedEvents";
-import { analyticsEmitter } from "../../analytics/utils/analyticsEmitter";
+import { sendUniversalLinkClick } from "../api/sendUniversalLinkClick";
 import { checkClickLimit } from "../api/checkClickLimit";
 import { getDeferredLink } from "../api/getDeferredLink";
 import { resolveShortLink } from "../api/resolveShortLink";
@@ -162,10 +161,7 @@ export const useDetour = ({
       const resolved = await resolveLink(url);
       if (resolved) {
         if (resolved.type !== "scheme") {
-          analyticsEmitter.emit({
-            eventName: OPENED_VIA_UNIVERSAL_LINK,
-            data: { url },
-          });
+          sendUniversalLinkClick({ apiKey, appID, url });
         }
         setLink(resolved);
       }
@@ -193,10 +189,7 @@ export const useDetour = ({
             const resolved = await resolveLink(initialUrl);
             if (resolved) {
               if (resolved.type !== "scheme") {
-                analyticsEmitter.emit({
-                  eventName: OPENED_VIA_UNIVERSAL_LINK,
-                  data: { url: initialUrl },
-                });
+                sendUniversalLinkClick({ apiKey, appID, url: initialUrl });
               }
               setLink(resolved);
             }