@sendoracloud/sdk-react-native 0.17.2 → 0.18.0

package/dist/index.cjs

@@ -1840,6 +1840,55 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Attribution namespace — mobile install + deferred deep-link reporting.
+   * Mirrors the backend's `/attribution/{install,deferred}` SDK routes.
+   *
+   * Backend resolves `orgId` + `projectId` from the API key, so the SDK
+   * helper accepts only the device-side context (fingerprint, OS, app
+   * version). Both methods are safe to call on every cold-start —
+   * backend deduplicates installs by `deviceId` within a 24h window so
+   * a paranoid app calling `reportInstall()` on every launch sees
+   * `deduplicated: true` after the first match.
+   *
+   * Typical pairing:
+   *   await SendoraCloud.attribution.reportInstall({
+   *     deviceId,
+   *     fingerprintHash: await computeDeviceFingerprint(),
+   *     appVersion,
+   *   });
+   *   const deferred = await SendoraCloud.attribution.checkDeferred();
+   *   if (deferred?.deepLinkPath) router.replace(deferred.deepLinkPath);
+   */
+  get attribution() {
+    const self = this;
+    return {
+      reportInstall: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.reportInstall().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/attribution/install",
+          input ?? {}
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.reportInstall failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] attribution.reportInstall: bad response");
+        return parsed.data;
+      },
+      checkDeferred: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.checkDeferred().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/attribution/deferred",
+          input ?? {}
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.checkDeferred failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success) throw new Error("[sendoracloud] attribution.checkDeferred: bad response");
+        return parsed.data ?? null;
+      }
+    };
+  }
   /**
    * Clear identity + rotate the anonymous id. Call on logout. Awaits
    * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.d.cts

@@ -751,6 +751,63 @@ declare class SendoraSDK {
         registerToken: (reg: PushTokenRegistration) => Promise<PushTokenReceipt>;
         trackOpen: (sendId: string, clickAction?: string) => Promise<void>;
     };
+    /**
+     * Attribution namespace — mobile install + deferred deep-link reporting.
+     * Mirrors the backend's `/attribution/{install,deferred}` SDK routes.
+     *
+     * Backend resolves `orgId` + `projectId` from the API key, so the SDK
+     * helper accepts only the device-side context (fingerprint, OS, app
+     * version). Both methods are safe to call on every cold-start —
+     * backend deduplicates installs by `deviceId` within a 24h window so
+     * a paranoid app calling `reportInstall()` on every launch sees
+     * `deduplicated: true` after the first match.
+     *
+     * Typical pairing:
+     *   await SendoraCloud.attribution.reportInstall({
+     *     deviceId,
+     *     fingerprintHash: await computeDeviceFingerprint(),
+     *     appVersion,
+     *   });
+     *   const deferred = await SendoraCloud.attribution.checkDeferred();
+     *   if (deferred?.deepLinkPath) router.replace(deferred.deepLinkPath);
+     */
+    get attribution(): {
+        reportInstall: (input?: {
+            deviceId?: string;
+            fingerprintHash?: string;
+            appVersion?: string;
+            os?: string;
+            osVersion?: string;
+            country?: string;
+        }) => Promise<{
+            installId: string;
+            deduplicated: boolean;
+            attributed: boolean;
+            result?: {
+                matchType: string;
+                confidence?: number;
+                clickId?: string;
+                linkId?: string;
+                campaign?: string;
+                source?: string;
+                medium?: string;
+                deepLinkData?: Record<string, unknown>;
+                deepLinkPath?: string;
+            };
+        }>;
+        checkDeferred: (input?: {
+            fingerprintHash?: string;
+            deviceId?: string;
+        }) => Promise<{
+            matchType: string;
+            confidence?: number;
+            campaign?: string;
+            source?: string;
+            medium?: string;
+            deepLinkData?: Record<string, unknown>;
+            deepLinkPath?: string;
+        } | null>;
+    };
     /**
      * Clear identity + rotate the anonymous id. Call on logout. Awaits
      * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.d.ts

@@ -751,6 +751,63 @@ declare class SendoraSDK {
         registerToken: (reg: PushTokenRegistration) => Promise<PushTokenReceipt>;
         trackOpen: (sendId: string, clickAction?: string) => Promise<void>;
     };
+    /**
+     * Attribution namespace — mobile install + deferred deep-link reporting.
+     * Mirrors the backend's `/attribution/{install,deferred}` SDK routes.
+     *
+     * Backend resolves `orgId` + `projectId` from the API key, so the SDK
+     * helper accepts only the device-side context (fingerprint, OS, app
+     * version). Both methods are safe to call on every cold-start —
+     * backend deduplicates installs by `deviceId` within a 24h window so
+     * a paranoid app calling `reportInstall()` on every launch sees
+     * `deduplicated: true` after the first match.
+     *
+     * Typical pairing:
+     *   await SendoraCloud.attribution.reportInstall({
+     *     deviceId,
+     *     fingerprintHash: await computeDeviceFingerprint(),
+     *     appVersion,
+     *   });
+     *   const deferred = await SendoraCloud.attribution.checkDeferred();
+     *   if (deferred?.deepLinkPath) router.replace(deferred.deepLinkPath);
+     */
+    get attribution(): {
+        reportInstall: (input?: {
+            deviceId?: string;
+            fingerprintHash?: string;
+            appVersion?: string;
+            os?: string;
+            osVersion?: string;
+            country?: string;
+        }) => Promise<{
+            installId: string;
+            deduplicated: boolean;
+            attributed: boolean;
+            result?: {
+                matchType: string;
+                confidence?: number;
+                clickId?: string;
+                linkId?: string;
+                campaign?: string;
+                source?: string;
+                medium?: string;
+                deepLinkData?: Record<string, unknown>;
+                deepLinkPath?: string;
+            };
+        }>;
+        checkDeferred: (input?: {
+            fingerprintHash?: string;
+            deviceId?: string;
+        }) => Promise<{
+            matchType: string;
+            confidence?: number;
+            campaign?: string;
+            source?: string;
+            medium?: string;
+            deepLinkData?: Record<string, unknown>;
+            deepLinkPath?: string;
+        } | null>;
+    };
     /**
      * Clear identity + rotate the anonymous id. Call on logout. Awaits
      * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.js

@@ -1802,6 +1802,55 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Attribution namespace — mobile install + deferred deep-link reporting.
+   * Mirrors the backend's `/attribution/{install,deferred}` SDK routes.
+   *
+   * Backend resolves `orgId` + `projectId` from the API key, so the SDK
+   * helper accepts only the device-side context (fingerprint, OS, app
+   * version). Both methods are safe to call on every cold-start —
+   * backend deduplicates installs by `deviceId` within a 24h window so
+   * a paranoid app calling `reportInstall()` on every launch sees
+   * `deduplicated: true` after the first match.
+   *
+   * Typical pairing:
+   *   await SendoraCloud.attribution.reportInstall({
+   *     deviceId,
+   *     fingerprintHash: await computeDeviceFingerprint(),
+   *     appVersion,
+   *   });
+   *   const deferred = await SendoraCloud.attribution.checkDeferred();
+   *   if (deferred?.deepLinkPath) router.replace(deferred.deepLinkPath);
+   */
+  get attribution() {
+    const self = this;
+    return {
+      reportInstall: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.reportInstall().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/attribution/install",
+          input ?? {}
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.reportInstall failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] attribution.reportInstall: bad response");
+        return parsed.data;
+      },
+      checkDeferred: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before attribution.checkDeferred().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/attribution/deferred",
+          input ?? {}
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] attribution.checkDeferred failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success) throw new Error("[sendoracloud] attribution.checkDeferred: bad response");
+        return parsed.data ?? null;
+      }
+    };
+  }
   /**
    * Clear identity + rotate the anonymous id. Call on logout. Awaits
    * the AsyncStorage writes so a caller who kills the app immediately

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "0.17.2",
+  "version": "0.18.0",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
   "type": "module",
   "main": "./dist/index.cjs",