@advenue/react-native 0.3.1 → 0.4.0

package/dist/index.d.ts

@@ -25,6 +25,8 @@ declare function createMMKVStorage(mmkv: MMKVLike): StorageAdapter;
 interface SecureStoreLike {
     getItemAsync(key: string): Promise<string | null>;
     setItemAsync(key: string, value: string): Promise<void>;
+    /** Optional — forwarded so GDPR erasure can wipe the durable entries. */
+    deleteItemAsync?(key: string): Promise<void>;
 }
 /** Wraps expo-secure-store as an Advenue SecureStorageAdapter (async, durable). */
 declare function createSecureStore(secureStore: SecureStoreLike): SecureStorageAdapter;
@@ -80,20 +82,26 @@ declare function collectDeviceInfo(natives: {
  * paste banner — the user-visible, privacy-forward deferred path.)
  */
 declare function resolveClipboardMatch(): Promise<DeepLink | null>;
-interface RNAdvenueConfig extends Omit<AdvenueConfig, 'storage'> {
+interface RNAdvenueConfig extends Omit<AdvenueConfig, 'storage' | 'platform'> {
     /**
-     * An MMKV instance for the durable offline buffer:
-     *   import { MMKV } from 'react-native-mmkv';
-     *   Advenue.initialize({ apiKey, platform: 'ios', mmkv: new MMKV() });
-     * Omit to fall back to in-memory buffering (events lost on cold start).
+     * Auto-detected from React Native's `Platform.OS` — omit it. Pass explicitly
+     * only outside a React Native runtime (tests, custom embeddings); `ios` and
+     * `android` map verbatim, any other RN target (web, desktop) reports as
+     * `web`.
+     */
+    platform?: AdvenueConfig['platform'];
+    /**
+     * @internal Storage override (tests / custom embeddings). The SDK persists
+     * via its own native modules (UserDefaults/SharedPreferences) — apps never
+     * supply storage. When set, it replaces the built-in native storage.
      */
     mmkv?: MMKVLike;
     /**
      * G3.1n — Play Integrity (Android) / App Attest (iOS) attestation.
      *
      * Your app's Advenue appId (the UUID shown in the dashboard). When set on
-     * Android, `trackInstall()` will obtain a Play Integrity Standard token and
-     * attach it to the install event. The requestHash is computed as
+     * Android, the automatic install obtains a Play Integrity Standard token and
+     * attaches it to the install event. The requestHash is computed as
      * `sha256Hex("<appId>:<deviceId>")`, matching the server's verification
      * formula exactly (see `makeDecodeAndroid` in the worker).
      *
@@ -101,10 +109,10 @@ interface RNAdvenueConfig extends Omit<AdvenueConfig, 'storage'> {
      */
     appId?: string;
     /**
-     * An expo-secure-store module for a reinstall-resilient device identity:
-     *   import * as SecureStore from 'expo-secure-store';
-     *   await Advenue.initialize({ apiKey, platform: 'ios', secureStore: SecureStore });
-     * Omit to fall back to sync storage (deviceId is not reinstall-resilient).
+     * @internal Secure-store override (tests / custom embeddings). The SDK uses
+     * its own Keychain-backed native storage on iOS for the reinstall-resilient
+     * device identity — apps never supply a secure store. When set, it replaces
+     * the built-in Keychain adapter.
      */
     secureStore?: SecureStoreLike;
     /**
@@ -115,6 +123,13 @@ interface RNAdvenueConfig extends Omit<AdvenueConfig, 'storage'> {
      * to distinguish the two. Omit to disable deep-link handling entirely.
      */
     onDeepLink?: (link: DeepLink) => void;
+    /**
+     * @internal Test hook — disables the automatic install fired by
+     * `initialize()`. Install tracking is always automatic in production (there
+     * is no public `trackInstall`); tests turn it off to exercise the internal
+     * install path deterministically.
+     */
+    autoTrackInstall?: boolean;
 }
 /**
  * Maps a React Native AppState status to the client's session lifecycle hooks.
@@ -134,18 +149,10 @@ declare const Advenue: {
      * where ATT doesn't exist) and forwards the result to the consent gate.
      */
     requestTrackingAuthorization(): Promise<TrackingAuthorizationStatus>;
-    /**
-     * 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).
-     */
-    trackInstall(properties?: Record<string, unknown>): Promise<void>;
-    setTrackingConsent: (granted: boolean) => void;
+    setTrackingConsent(granted: boolean): void;
     getTrackingConsent: () => boolean;
     /** GDPR/CCPA erasure: stop tracking and wipe local identifiers/queue. */
-    forgetMe: () => void;
+    forgetMe(): void;
     setConsentData(consent: Consent): void;
     getConsentData: () => {
         isUserSubjectToGDPR: boolean;
@@ -157,5 +164,18 @@ declare const Advenue: {
     getDeviceId: () => string;
     shutdown(): void;
 };
+/**
+ * Tracks the install event enriched with native attribution data: Play + Meta
+ * install referrers on Android, SKAdNetwork registration on iOS. Fired
+ * automatically by `initialize()` (or its consent deferral); 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).
+ *
+ * @internal Exported for tests only — install tracking is automatic and this
+ * function is deliberately NOT on the `Advenue` facade. Do not call it from
+ * app code.
+ */
+declare function trackInstall(): Promise<void>;
 
-export { Advenue, type MMKVLike, type RNAdvenueConfig, type SecureStoreLike, applyAppState, collectDeviceInfo, createMMKVStorage, createSecureStore, getAndroidNative, getIosNative, parseDirectLink, resolveAdvertisingId, resolveClipboardMatch };
+export { Advenue, type MMKVLike, type RNAdvenueConfig, type SecureStoreLike, applyAppState, collectDeviceInfo, createMMKVStorage, createSecureStore, getAndroidNative, getIosNative, parseDirectLink, resolveAdvertisingId, resolveClipboardMatch, trackInstall };

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]
@@ -229,6 +229,13 @@ function getAndroidNative() {
     return null;
   }
 }
+function getPlatformOS() {
+  try {
+    return __require("react-native").Platform.OS ?? null;
+  } catch {
+    return null;
+  }
+}
 function getAppState() {
   try {
     return __require("react-native").AppState;
@@ -244,11 +251,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 +310,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 +341,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 +366,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 +380,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 +419,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 +468,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 +490,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);
-      }
-    }
-    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);
-      }
+  setTrackingConsent(granted) {
+    active().setTrackingConsent(granted);
+    if (granted) {
+      fireAutoInstallIfPending();
     }
-    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 +533,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@advenue/react-native",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -23,16 +23,14 @@
   },
   "dependencies": {
     "@advenue/install-referrer": "0.1.1",
-    "@advenue/sdk-core": "0.2.0"
+    "@advenue/sdk-core": "0.3.0"
   },
   "peerDependencies": {
     "@advenue/sdk-android": "*",
     "@advenue/sdk-ios": "*",
     "@expo/config-plugins": ">=8",
-    "expo-secure-store": ">=12",
     "react": ">=18.2",
-    "react-native": ">=0.74",
-    "react-native-mmkv": ">=3"
+    "react-native": ">=0.74"
   },
   "peerDependenciesMeta": {
     "@expo/config-plugins": {
@@ -43,21 +41,15 @@
     },
     "@advenue/sdk-ios": {
       "optional": true
-    },
-    "expo-secure-store": {
-      "optional": true
-    },
-    "react-native-mmkv": {
-      "optional": true
     }
   },
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@advenue/sdk-ios": "0.2.0",
-    "@advenue/sdk-android": "0.2.0",
-    "@advenue/shared": "0.0.0",
+    "@advenue/sdk-android": "0.3.0",
+    "@advenue/sdk-ios": "0.3.0",
+    "@advenue/shared": "0.1.0",
     "@advenue/signing": "0.0.0"
   },
   "scripts": {

package/plugin/index.js

@@ -5,23 +5,19 @@
 // backend already serves the matching apple-app-site-association / assetlinks.json.
 //
 // Usage (app.json / app.config.js):
-//   ["@advenue/react-native/plugin", { "domains": ["go.advenue.io"] }]
+//   "@advenue/react-native/plugin"                                    — Advenue cloud (go.advenue.io)
+//   ["@advenue/react-native/plugin", { "domains": ["go.acme.com"] }]  — self-host / custom link domain
 //
 // @expo/config-plugins is resolved from the consuming app's Expo install.
 const { withEntitlementsPlist, withAndroidManifest } = require('@expo/config-plugins');
-const { addAssociatedDomains, addAppLinksIntentFilter } = require('./links');
+const { addAssociatedDomains, addAppLinksIntentFilter, resolveDomains } = require('./links');
 
 /**
  * @param {any} config
  * @param {{ domains?: string[] } | undefined} props
  */
 function withAdvenueLinks(config, props) {
-  const domains = props?.domains ?? [];
-  if (domains.length === 0) {
-    throw new Error(
-      '@advenue/react-native/plugin: provide at least one link domain, e.g. { "domains": ["go.advenue.io"] }',
-    );
-  }
+  const domains = resolveDomains(props);
 
   let result = withEntitlementsPlist(config, (cfg) => {
     cfg.modResults = addAssociatedDomains(cfg.modResults, domains);