@advenue/react-native 0.3.1 → 0.5.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { parseInstallReferrer, extractReferrerProperties, parseMetaInstallReferrer } from '@advenue/install-referrer';
-import { DEFAULT_ENDPOINT, MemoryStorage, resolveDurableDeviceId, AdvenueClient } from '@advenue/sdk-core';
+import { DEVICE_ID_KEY, DEFAULT_ENDPOINT, MemoryStorage, resolveDurableDeviceId, AdvenueClient } from '@advenue/sdk-core';
 
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
@@ -174,10 +174,10 @@ function parseDirectLink(url) {
     const path = parsed.pathname.replace(/^\/+/, "");
     const isHttp = parsed.protocol === "http:" || parsed.protocol === "https:";
     deepLinkValue = isHttp ? path : [parsed.host, path].filter(Boolean).join("/");
-    for (const [k, v] of parsed.searchParams.entries()) {
+    parsed.searchParams.forEach((v, k) => {
       params ??= {};
       params[k] = v;
-    }
+    });
   } catch {
     deepLinkValue = url;
   }
@@ -217,14 +217,23 @@ function createMMKVStorage(mmkv) {
 // src/native.ts
 function getIosNative() {
   try {
-    return __require("@advenue/sdk-ios").AdvenueIos;
+    const core = __require("expo-modules-core");
+    return core.requireNativeModule("AdvenueIos");
   } catch {
     return null;
   }
 }
 function getAndroidNative() {
   try {
-    return __require("@advenue/sdk-android").AdvenueAndroid;
+    const core = __require("expo-modules-core");
+    return core.requireNativeModule("AdvenueAndroid");
+  } catch {
+    return null;
+  }
+}
+function getPlatformOS() {
+  try {
+    return __require("react-native").Platform.OS ?? null;
   } catch {
     return null;
   }
@@ -244,11 +253,38 @@ function getLinking() {
   }
 }
 
+// src/native-storage.ts
+function createNativeStorage(mod) {
+  const m = mod;
+  if (!m || typeof m.storageGetItem !== "function" || typeof m.storageSetItem !== "function" || typeof m.storageRemoveItem !== "function") {
+    return null;
+  }
+  return {
+    getItem: (key) => m.storageGetItem?.(key) ?? null,
+    setItem: (key, value) => m.storageSetItem?.(key, value),
+    removeItem: (key) => m.storageRemoveItem?.(key)
+  };
+}
+function createNativeSecureStore(mod) {
+  const m = mod;
+  if (!m || typeof m.secureGetItem !== "function" || typeof m.secureSetItem !== "function" || typeof m.secureRemoveItem !== "function") {
+    return null;
+  }
+  return {
+    getItemAsync: async (key) => m.secureGetItem?.(key) ?? null,
+    setItemAsync: async (key, value) => m.secureSetItem?.(key, value),
+    deleteItemAsync: async (key) => m.secureRemoveItem?.(key)
+  };
+}
+
 // src/secure-store.ts
 function createSecureStore(secureStore2) {
   return {
     getItemAsync: async (key) => await secureStore2.getItemAsync(key) ?? null,
-    setItemAsync: (key, value) => secureStore2.setItemAsync(key, value)
+    setItemAsync: (key, value) => secureStore2.setItemAsync(key, value),
+    ...secureStore2.deleteItemAsync ? {
+      deleteItemAsync: (key) => secureStore2.deleteItemAsync?.(key) ?? Promise.resolve()
+    } : {}
   };
 }
 
@@ -276,7 +312,14 @@ async function resolveAdvertisingId() {
     const r = await android.getAdvertisingId();
     const vendorId = typeof android.getAppSetId === "function" ? await android.getAppSetId() : null;
     const adFields = r ? r.limitAdTracking ? { limitAdTracking: true } : { gaid: r.id } : {};
-    client.setAdvertisingId({ ...adFields, ...vendorId ? { vendorId } : {} });
+    const hasUsableGaid = !!r && !r.limitAdTracking;
+    const rawAndroidId = !hasUsableGaid && typeof android.getAndroidId === "function" ? android.getAndroidId() : null;
+    const androidId = rawAndroidId && /^[0-9a-fA-F]{8,32}$/.test(rawAndroidId) ? rawAndroidId : null;
+    client.setAdvertisingId({
+      ...adFields,
+      ...vendorId ? { vendorId } : {},
+      ...androidId ? { androidId } : {}
+    });
     return;
   }
   client.setAdvertisingId({});
@@ -300,7 +343,14 @@ async function resolveClipboardMatch() {
   if (!ios || typeof ios.getPasteboardMatchToken !== "function") {
     return null;
   }
-  const matchId = parseMatchToken(ios.getPasteboardMatchToken());
+  let token;
+  try {
+    token = ios.getPasteboardMatchToken();
+  } catch (err) {
+    reportError("enrich.clipboardMatch", err);
+    return null;
+  }
+  const matchId = parseMatchToken(token);
   if (!matchId) return null;
   return client.exchangeClipboardMatch(matchId);
 }
@@ -318,6 +368,8 @@ var secureStore = null;
 var installFlagStore = null;
 var INSTALL_SENT_KEY = "advenue.install_sent";
 var installInFlight = false;
+var autoInstallPending = false;
+var autoInstallEnabled = true;
 var configuredAppId = null;
 var configuredApiKey = null;
 var configuredEndpoint = DEFAULT_ENDPOINT;
@@ -330,9 +382,37 @@ function active() {
 function reportError(context, cause) {
   instance?.report(context, cause);
 }
+function fireAutoInstall() {
+  void trackInstall().catch((err) => reportError("install.auto", err));
+}
+function resolvePlatform(explicit) {
+  if (explicit) {
+    return explicit;
+  }
+  const os = getPlatformOS();
+  if (os === "ios" || os === "android") {
+    return os;
+  }
+  if (os) {
+    return "web";
+  }
+  throw new Error(
+    "Advenue.initialize(): platform could not be detected (react-native unavailable) \u2014 pass platform: 'ios' | 'android' | 'web'."
+  );
+}
+function fireAutoInstallIfPending() {
+  if (!autoInstallPending) {
+    return;
+  }
+  autoInstallPending = false;
+  fireAutoInstall();
+}
 var Advenue = {
   async initialize(config) {
-    const { mmkv, secureStore: secureMod, onDeepLink, appId, ...rest } = config;
+    const { mmkv, secureStore: secureMod, onDeepLink, appId, autoTrackInstall, ...rest } = config;
+    autoInstallPending = false;
+    autoInstallEnabled = autoTrackInstall !== false;
+    const platform = resolvePlatform(rest.platform);
     configuredAppId = appId ?? null;
     configuredApiKey = config.apiKey;
     configuredEndpoint = config.endpoint ?? DEFAULT_ENDPOINT;
@@ -341,14 +421,16 @@ var Advenue = {
     deepLinkSub?.remove();
     deepLinkSub = null;
     instance?.shutdown();
-    const storage = mmkv ? createMMKVStorage(mmkv) : new MemoryStorage();
+    const iosMod = getIosNative();
+    const androidMod = getAndroidNative();
+    const storage = mmkv ? createMMKVStorage(mmkv) : createNativeStorage(iosMod ?? androidMod) ?? new MemoryStorage();
     installFlagStore = storage;
-    secureStore = secureMod ? createSecureStore(secureMod) : null;
+    secureStore = secureMod ? createSecureStore(secureMod) : createNativeSecureStore(iosMod);
     const deviceId = rest.deviceId ?? await resolveDurableDeviceId(storage, secureStore ?? void 0);
-    instance = new AdvenueClient({ ...rest, deviceId, storage });
+    instance = new AdvenueClient({ ...rest, platform, deviceId, storage });
     void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
     const deviceInfo = collectDeviceInfo({
-      platform: rest.platform,
+      platform,
       ios: getIosNative(),
       android: getAndroidNative()
     });
@@ -388,6 +470,14 @@ var Advenue = {
           resolveDeferred: async () => await resolveClipboardMatch() ?? client.resolveDeferredDeepLink(),
           onDeepLink
         });
+        deepLinkSub.ready.catch((err) => reportError("deepLink.resolve", err));
+      }
+    }
+    if (autoTrackInstall !== false) {
+      if (instance.getRequireConsent() && !instance.getTrackingConsent()) {
+        autoInstallPending = true;
+      } else {
+        fireAutoInstall();
       }
     }
     return instance;
@@ -402,142 +492,33 @@ var Advenue = {
     const status = ios ? await ios.requestTrackingAuthorization() : "authorized";
     active().setTrackingConsent(status === "authorized");
     void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
+    if (status === "authorized") {
+      fireAutoInstallIfPending();
+    }
     return status;
   },
-  /**
-   * Tracks the install event enriched with native attribution data: Play +
-   * Meta install referrers on Android, SKAdNetwork registration on iOS.
-   * Safe to call on every launch — when a `secureStore` is wired it fires at
-   * most once per device (reinstall-resilient on iOS via Keychain; Android
-   * re-fires after a reinstall, which is unavoidable post-GAID).
-   */
-  async trackInstall(properties) {
-    const client = active();
-    let sent = installFlagStore?.getItem(INSTALL_SENT_KEY) === "1";
-    if (!sent && secureStore) {
-      try {
-        sent = await secureStore.getItemAsync(INSTALL_SENT_KEY) === "1";
-      } catch (err) {
-        reportError("install.guardRead", err);
-      }
-    }
-    if (sent) {
-      return;
-    }
-    if (installInFlight) {
-      return;
-    }
-    installInFlight = true;
-    const opts = {};
-    const props = { ...properties };
-    const android = getAndroidNative();
-    if (android) {
-      try {
-        const result = await android.getInstallReferrer();
-        if (result) {
-          const parsed = parseInstallReferrer(result.referrer);
-          if (parsed.network) opts.network = parsed.network;
-          if (parsed.campaign) opts.campaign = parsed.campaign;
-          if (parsed.gclid) props.gclid = parsed.gclid;
-          if (parsed.fbclid) props.fbclid = parsed.fbclid;
-          Object.assign(props, extractReferrerProperties(result));
-        }
-      } catch (err) {
-        reportError("enrich.installReferrer", err);
-      }
-      try {
-        const meta = await android.getMetaInstallReferrer();
-        const parsedMeta = meta ? parseMetaInstallReferrer(meta) : null;
-        if (parsedMeta) {
-          props.metaInstallReferrer = parsedMeta.raw;
-          if (parsedMeta.encryptedData) props.metaReferrerData = parsedMeta.encryptedData;
-          if (parsedMeta.nonce) props.metaReferrerNonce = parsedMeta.nonce;
-          if (!opts.network && parsedMeta.isClickThrough) {
-            opts.network = "meta";
-            if (parsedMeta.campaign) opts.campaign = parsedMeta.campaign;
-          }
-        }
-      } catch (err) {
-        reportError("enrich.metaReferrer", err);
-      }
+  setTrackingConsent(granted) {
+    active().setTrackingConsent(granted);
+    if (granted) {
+      fireAutoInstallIfPending();
     }
-    const ios = getIosNative();
-    if (ios) {
-      try {
-        ios.registerAppForAttribution();
-      } catch (err) {
-        reportError("enrich.skanRegister", err);
-      }
-      try {
-        const asaToken = await ios.getAttributionToken();
-        if (asaToken) {
-          opts.adservicesToken = asaToken;
-        }
-      } catch (err) {
-        reportError("enrich.adservicesToken", err);
-      }
-    }
-    await resolveAdvertisingId();
-    const trackOpts = { type: "install", ...opts };
-    if (configuredAppId && android && typeof android.getIntegrityToken === "function") {
-      try {
-        const deviceId = client.getDeviceId();
-        const requestHash = sha256Hex(`${configuredAppId}:${deviceId}`);
-        const token = await android.getIntegrityToken(requestHash);
-        if (token) {
-          trackOpts.attestationToken = token;
-          trackOpts.attestationType = "play-integrity";
-        }
-      } catch (err) {
-        reportError("attest.playIntegrity", err);
-      }
-    }
-    if (configuredAppId && configuredApiKey && ios && typeof ios.attestKey === "function") {
-      try {
-        const deviceId = client.getDeviceId();
-        const challengeUrl = `${configuredEndpoint}/v1/attest/challenge?deviceId=${encodeURIComponent(deviceId)}`;
-        const challengeRes = await fetch(challengeUrl, {
-          headers: { "x-api-key": configuredApiKey }
-        });
-        if (!challengeRes.ok) throw new Error(`challenge HTTP ${challengeRes.status}`);
-        const { challenge } = await challengeRes.json();
-        const { keyId, attestationObject } = await ios.attestKey(challenge);
-        trackOpts.attestationToken = attestationObject;
-        trackOpts.attestationType = "app-attest";
-        trackOpts.attestationKeyId = keyId;
-        trackOpts.attestationChallenge = challenge;
-      } catch (err) {
-        reportError("attest.appAttest", err);
-      }
-    }
-    if (ios && typeof ios.getDeviceCheckToken === "function") {
-      try {
-        const token = await ios.getDeviceCheckToken();
-        if (token) {
-          trackOpts.deviceCheckToken = token;
-        }
-      } catch (err) {
-        reportError("attest.deviceCheck", err);
-      }
-    }
-    client.track("install", props, trackOpts);
+  },
+  getTrackingConsent: () => active().getTrackingConsent(),
+  /** GDPR/CCPA erasure: stop tracking and wipe local identifiers/queue. */
+  forgetMe() {
+    active().forgetMe();
     try {
-      installFlagStore?.setItem(INSTALL_SENT_KEY, "1");
+      installFlagStore?.removeItem(INSTALL_SENT_KEY);
     } catch (err) {
-      reportError("install.flagPersist", err);
+      reportError("forget.wipe", err);
     }
-    if (secureStore) {
-      try {
-        await secureStore.setItemAsync(INSTALL_SENT_KEY, "1");
-      } catch (err) {
-        reportError("install.flagPersistSecure", err);
+    const secure = secureStore;
+    if (secure?.deleteItemAsync) {
+      for (const key of [DEVICE_ID_KEY, INSTALL_SENT_KEY]) {
+        void secure.deleteItemAsync(key).catch((err) => reportError("forget.secureWipe", err));
       }
     }
   },
-  setTrackingConsent: (granted) => active().setTrackingConsent(granted),
-  getTrackingConsent: () => active().getTrackingConsent(),
-  /** GDPR/CCPA erasure: stop tracking and wipe local identifiers/queue. */
-  forgetMe: () => active().forgetMe(),
   setConsentData(consent) {
     active().setConsentData(consent);
     void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
@@ -554,10 +535,146 @@ var Advenue = {
     instance = null;
     secureStore = null;
     installInFlight = false;
+    autoInstallPending = false;
+    autoInstallEnabled = true;
     configuredAppId = null;
     configuredApiKey = null;
     configuredEndpoint = DEFAULT_ENDPOINT;
   }
 };
+async function trackInstall() {
+  const client = active();
+  if (client.getRequireConsent() && !client.getTrackingConsent()) {
+    return;
+  }
+  let sent = installFlagStore?.getItem(INSTALL_SENT_KEY) === "1";
+  if (!sent && secureStore) {
+    try {
+      sent = await secureStore.getItemAsync(INSTALL_SENT_KEY) === "1";
+    } catch (err) {
+      reportError("install.guardRead", err);
+    }
+  }
+  if (sent) {
+    return;
+  }
+  if (installInFlight) {
+    return;
+  }
+  installInFlight = true;
+  const opts = {};
+  const props = {};
+  const android = getAndroidNative();
+  if (android) {
+    try {
+      const result = await android.getInstallReferrer();
+      if (result) {
+        const parsed = parseInstallReferrer(result.referrer);
+        if (parsed.network) opts.network = parsed.network;
+        if (parsed.campaign) opts.campaign = parsed.campaign;
+        if (parsed.gclid) props.gclid = parsed.gclid;
+        if (parsed.fbclid) props.fbclid = parsed.fbclid;
+        Object.assign(props, extractReferrerProperties(result));
+      }
+    } catch (err) {
+      reportError("enrich.installReferrer", err);
+    }
+    try {
+      const meta = await android.getMetaInstallReferrer();
+      const parsedMeta = meta ? parseMetaInstallReferrer(meta) : null;
+      if (parsedMeta) {
+        props.metaInstallReferrer = parsedMeta.raw;
+        if (parsedMeta.encryptedData) props.metaReferrerData = parsedMeta.encryptedData;
+        if (parsedMeta.nonce) props.metaReferrerNonce = parsedMeta.nonce;
+        if (!opts.network && parsedMeta.isClickThrough) {
+          opts.network = "meta";
+          if (parsedMeta.campaign) opts.campaign = parsedMeta.campaign;
+        }
+      }
+    } catch (err) {
+      reportError("enrich.metaReferrer", err);
+    }
+  }
+  const ios = getIosNative();
+  if (ios) {
+    try {
+      ios.registerAppForAttribution();
+    } catch (err) {
+      reportError("enrich.skanRegister", err);
+    }
+    try {
+      const asaToken = await ios.getAttributionToken();
+      if (asaToken) {
+        opts.adservicesToken = asaToken;
+      }
+    } catch (err) {
+      reportError("enrich.adservicesToken", err);
+    }
+  }
+  await resolveAdvertisingId();
+  const trackOpts = { type: "install", ...opts };
+  if (configuredAppId && android && typeof android.getIntegrityToken === "function") {
+    try {
+      const deviceId = client.getDeviceId();
+      const requestHash = sha256Hex(`${configuredAppId}:${deviceId}`);
+      const token = await android.getIntegrityToken(requestHash);
+      if (token) {
+        trackOpts.attestationToken = token;
+        trackOpts.attestationType = "play-integrity";
+      }
+    } catch (err) {
+      reportError("attest.playIntegrity", err);
+    }
+  }
+  if (configuredAppId && configuredApiKey && ios && typeof ios.attestKey === "function") {
+    try {
+      const deviceId = client.getDeviceId();
+      const challengeUrl = `${configuredEndpoint}/v1/attest/challenge?deviceId=${encodeURIComponent(deviceId)}`;
+      const challengeRes = await fetch(challengeUrl, {
+        headers: { "x-api-key": configuredApiKey }
+      });
+      if (!challengeRes.ok) throw new Error(`challenge HTTP ${challengeRes.status}`);
+      const { challenge } = await challengeRes.json();
+      const { keyId, attestationObject } = await ios.attestKey(challenge);
+      trackOpts.attestationToken = attestationObject;
+      trackOpts.attestationType = "app-attest";
+      trackOpts.attestationKeyId = keyId;
+      trackOpts.attestationChallenge = challenge;
+    } catch (err) {
+      reportError("attest.appAttest", err);
+    }
+  }
+  if (ios && typeof ios.getDeviceCheckToken === "function") {
+    try {
+      const token = await ios.getDeviceCheckToken();
+      if (token) {
+        trackOpts.deviceCheckToken = token;
+      }
+    } catch (err) {
+      reportError("attest.deviceCheck", err);
+    }
+  }
+  const pendingBefore = client.pendingCount;
+  client.track("install", props, trackOpts);
+  if (client.pendingCount === pendingBefore) {
+    installInFlight = false;
+    if (autoInstallEnabled && client.getRequireConsent() && !client.getTrackingConsent()) {
+      autoInstallPending = true;
+    }
+    return;
+  }
+  try {
+    installFlagStore?.setItem(INSTALL_SENT_KEY, "1");
+  } catch (err) {
+    reportError("install.flagPersist", err);
+  }
+  if (secureStore) {
+    try {
+      await secureStore.setItemAsync(INSTALL_SENT_KEY, "1");
+    } catch (err) {
+      reportError("install.flagPersistSecure", err);
+    }
+  }
+}
 
-export { Advenue, applyAppState, collectDeviceInfo, createMMKVStorage, createSecureStore, getAndroidNative, getIosNative, parseDirectLink, resolveAdvertisingId, resolveClipboardMatch };
+export { Advenue, applyAppState, collectDeviceInfo, createMMKVStorage, createSecureStore, getAndroidNative, getIosNative, parseDirectLink, resolveAdvertisingId, resolveClipboardMatch, trackInstall };

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["AdvenueIosModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.advenue.AdvenueAndroidModule"]
+  }
+}

package/ios/AdvenueIos.podspec

@@ -0,0 +1,20 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name             = 'AdvenueIos'
+  s.version          = package['version']
+  s.summary          = package['description']
+  s.license          = package['license']
+  s.author           = 'Advenue'
+  s.homepage         = 'https://github.com/broverse/advenue'
+  s.platforms        = { :ios => '15.1' }
+  s.swift_version    = '5.4'
+  s.source           = { git: 'https://github.com/broverse/advenue.git' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  s.source_files = '**/*.{h,m,swift}'
+end