@advenue/react-native 0.8.0 → 1.0.0

package/dist/index.js

@@ -51,174 +51,10 @@ var require_native_require = __commonJS({
   }
 });
 
-// src/index.ts
-import {
-  extractReferrerProperties,
-  parseInstallReferrer,
-  parseMetaInstallReferrer
-} from "@advenue/install-referrer";
-import {
-  AdvenueClient,
-  DEFAULT_ENDPOINT,
-  DEVICE_ID_KEY,
-  MemoryStorage,
-  resolveDurableDeviceId,
-  tcfToConsent
-} from "@advenue/sdk-core";
-
-// ../signing/src/index.ts
-var K = new Uint32Array([
-  1116352408,
-  1899447441,
-  3049323471,
-  3921009573,
-  961987163,
-  1508970993,
-  2453635748,
-  2870763221,
-  3624381080,
-  310598401,
-  607225278,
-  1426881987,
-  1925078388,
-  2162078206,
-  2614888103,
-  3248222580,
-  3835390401,
-  4022224774,
-  264347078,
-  604807628,
-  770255983,
-  1249150122,
-  1555081692,
-  1996064986,
-  2554220882,
-  2821834349,
-  2952996808,
-  3210313671,
-  3336571891,
-  3584528711,
-  113926993,
-  338241895,
-  666307205,
-  773529912,
-  1294757372,
-  1396182291,
-  1695183700,
-  1986661051,
-  2177026350,
-  2456956037,
-  2730485921,
-  2820302411,
-  3259730800,
-  3345764771,
-  3516065817,
-  3600352804,
-  4094571909,
-  275423344,
-  430227734,
-  506948616,
-  659060556,
-  883997877,
-  958139571,
-  1322822218,
-  1537002063,
-  1747873779,
-  1955562222,
-  2024104815,
-  2227730452,
-  2361852424,
-  2428436474,
-  2756734187,
-  3204031479,
-  3329325298
-]);
-function rotr(x, n) {
-  return x >>> n | x << 32 - n;
-}
-function sha256Bytes(msg) {
-  const h = new Uint32Array([
-    1779033703,
-    3144134277,
-    1013904242,
-    2773480762,
-    1359893119,
-    2600822924,
-    528734635,
-    1541459225
-  ]);
-  const l = msg.length;
-  const bitLen = l * 8;
-  const withOne = l + 1;
-  const padTo = (56 - withOne % 64 + 64) % 64;
-  const padded = new Uint8Array(withOne + padTo + 8);
-  padded.set(msg);
-  padded[l] = 128;
-  const dv = new DataView(padded.buffer);
-  dv.setUint32(padded.length - 8, Math.floor(bitLen / 4294967296));
-  dv.setUint32(padded.length - 4, bitLen >>> 0);
-  const w = new Uint32Array(64);
-  for (let i = 0; i < padded.length; i += 64) {
-    for (let t = 0; t < 16; t++) w[t] = dv.getUint32(i + t * 4);
-    for (let t = 16; t < 64; t++) {
-      const w15 = w[t - 15];
-      const w2 = w[t - 2];
-      const s0 = rotr(w15, 7) ^ rotr(w15, 18) ^ w15 >>> 3;
-      const s1 = rotr(w2, 17) ^ rotr(w2, 19) ^ w2 >>> 10;
-      w[t] = w[t - 16] + s0 + w[t - 7] + s1 >>> 0;
-    }
-    let a = h[0];
-    let b = h[1];
-    let c = h[2];
-    let d = h[3];
-    let e = h[4];
-    let f = h[5];
-    let g = h[6];
-    let hh = h[7];
-    for (let t = 0; t < 64; t++) {
-      const S1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25);
-      const ch = e & f ^ ~e & g;
-      const temp1 = hh + S1 + ch + K[t] + w[t] >>> 0;
-      const S0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22);
-      const maj = a & b ^ a & c ^ b & c;
-      const temp2 = S0 + maj >>> 0;
-      hh = g;
-      g = f;
-      f = e;
-      e = d + temp1 >>> 0;
-      d = c;
-      c = b;
-      b = a;
-      a = temp1 + temp2 >>> 0;
-    }
-    h[0] = h[0] + a >>> 0;
-    h[1] = h[1] + b >>> 0;
-    h[2] = h[2] + c >>> 0;
-    h[3] = h[3] + d >>> 0;
-    h[4] = h[4] + e >>> 0;
-    h[5] = h[5] + f >>> 0;
-    h[6] = h[6] + g >>> 0;
-    h[7] = h[7] + hh >>> 0;
-  }
-  const out = new Uint8Array(32);
-  const odv = new DataView(out.buffer);
-  for (let i = 0; i < 8; i++) odv.setUint32(i * 4, h[i]);
-  return out;
-}
-function toHex(bytes) {
-  let s = "";
-  for (let i = 0; i < bytes.length; i++) s += bytes[i].toString(16).padStart(2, "0");
-  return s;
-}
-var enc = new TextEncoder();
-function sha256Hex(message) {
-  return toHex(sha256Bytes(enc.encode(message)));
-}
-
 // package.json
 var package_default = {
   name: "@advenue/react-native",
-  version: "0.8.0",
+  version: "1.0.0",
   description: "Advenue MMP React Native SDK \u2014 attribution, install tracking, and deep links (bundled iOS/Android Expo native modules)",
   type: "module",
   license: "MIT",
@@ -241,20 +77,20 @@ var package_default = {
     "ios",
     "android",
     "expo-module.config.json",
-    "!**/*.test.ts"
+    "!**/*.test.ts",
+    "ios/vendor",
+    "android/src/main/kotlin"
   ],
   publishConfig: {
     access: "public"
   },
   scripts: {
-    build: "tsup && node scripts/check-dist.mjs",
+    build: "node scripts/vendor-natives.mjs && node scripts/check-vendored-swift.mjs && tsup && node scripts/check-dist.mjs",
     typecheck: "tsc --noEmit",
-    test: "vitest run"
-  },
-  dependencies: {
-    "@advenue/install-referrer": "workspace:*",
-    "@advenue/sdk-core": "workspace:*"
+    test: "vitest run --minWorkers=1 --maxWorkers=2 && node --test scripts/vendor-natives.test.mjs && node scripts/vendor-natives.mjs && node scripts/check-vendored-swift.mjs",
+    vendor: "node scripts/vendor-natives.mjs"
   },
+  dependencies: {},
   peerDependencies: {
     "@expo/config-plugins": ">=8",
     react: ">=18.2",
@@ -270,8 +106,6 @@ var package_default = {
     }
   },
   devDependencies: {
-    "@advenue/shared": "workspace:*",
-    "@advenue/signing": "workspace:*",
     tsup: "^8.5.1",
     typescript: "^5.7.2",
     vitest: "^2.1.8"
@@ -279,18 +113,15 @@ var package_default = {
   "react-native": "./dist/index.cjs"
 };
 
-// src/aem.ts
-function extractAemCampaignIds(alApplinkData) {
-  try {
-    const parsed = JSON.parse(alApplinkData);
-    const value = typeof parsed.campaign_ids === "string" && parsed.campaign_ids ? parsed.campaign_ids : typeof parsed.extras?.campaign_ids === "string" && parsed.extras.campaign_ids ? parsed.extras.campaign_ids : null;
-    return value && value.length <= 2048 ? value : null;
-  } catch {
-    return null;
-  }
-}
-
 // src/deep-links.ts
+var ALLOWED_QUERY_KEYS = /* @__PURE__ */ new Set([
+  "ref",
+  "campaign",
+  "network",
+  "influencer_id",
+  "influencerId",
+  "al_applink_data"
+]);
 function parseDirectLink(url) {
   let deepLinkValue = "";
   let params;
@@ -300,6 +131,7 @@ function parseDirectLink(url) {
     const isHttp = parsed.protocol === "http:" || parsed.protocol === "https:";
     deepLinkValue = isHttp ? path : [parsed.host, path].filter(Boolean).join("/");
     parsed.searchParams.forEach((v, k) => {
+      if (!ALLOWED_QUERY_KEYS.has(k)) return;
       params ??= {};
       params[k] = v;
     });
@@ -335,15 +167,6 @@ function setupDeepLinks(setup) {
   return { remove: () => listener.remove(), ready };
 }
 
-// src/mmkv-storage.ts
-function createMMKVStorage(mmkv) {
-  return {
-    getItem: (key) => mmkv.getString(key) ?? null,
-    setItem: (key, value) => mmkv.set(key, value),
-    removeItem: (key) => mmkv.delete(key)
-  };
-}
-
 // src/native.ts
 var import_native_require = __toESM(require_native_require(), 1);
 function getIosNative() {
@@ -370,27 +193,6 @@ function getPlatformOS() {
     return null;
   }
 }
-function getOsVersion() {
-  try {
-    const rn = (0, import_native_require.requireReactNative)();
-    if (!rn) return null;
-    if (rn.Platform.OS === "android") {
-      const release = rn.Platform.constants?.Release;
-      return release != null ? String(release) : null;
-    }
-    return rn.Platform.Version != null ? String(rn.Platform.Version) : null;
-  } catch {
-    return null;
-  }
-}
-function getAppState() {
-  try {
-    const rn = (0, import_native_require.requireReactNative)();
-    return rn?.AppState ?? null;
-  } catch {
-    return null;
-  }
-}
 function getLinking() {
   try {
     const rn = (0, import_native_require.requireReactNative)();
@@ -400,489 +202,208 @@ 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),
-    ...secureStore2.deleteItemAsync ? {
-      deleteItemAsync: (key) => secureStore2.deleteItemAsync?.(key) ?? Promise.resolve()
-    } : {}
-  };
-}
-
 // src/index.ts
-async function resolveAdvertisingId() {
-  const client = active();
-  const consent = client.getConsentData();
-  if (client.getRequireConsent() && consent == null) {
-    client.setAdvertisingId({});
-    return;
-  }
-  if (consent?.isUserSubjectToGDPR === true && consent.hasConsentForDataUsage !== true) {
-    client.setAdvertisingId({});
-    return;
-  }
-  const ios = getIosNative();
-  if (ios) {
-    const idfa = ios.getTrackingAuthorizationStatus() === "authorized" ? await ios.getAdvertisingId() : null;
-    const vendorId = typeof ios.getIdentifierForVendor === "function" ? ios.getIdentifierForVendor() : null;
-    client.setAdvertisingId({ ...idfa ? { idfa } : {}, ...vendorId ? { vendorId } : {} });
-    return;
-  }
-  const android = getAndroidNative();
-  if (android && typeof android.getAdvertisingId === "function") {
-    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 } : {};
-    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({});
-}
-function consentEquals(a, b) {
-  return a.isUserSubjectToGDPR === b.isUserSubjectToGDPR && a.hasConsentForDataUsage === b.hasConsentForDataUsage && a.hasConsentForAdsPersonalization === b.hasConsentForAdsPersonalization && a.hasConsentForAdStorage === b.hasConsentForAdStorage;
+var IGNORED_OPTIONS = ["mmkv", "secureStore", "sdkConfigFetcher", "tcfDataCollection"];
+var started = false;
+var deepLinkSub = null;
+var errorSub = null;
+var onErrorHook;
+var consentCache = false;
+function bridge() {
+  return { ios: getIosNative(), android: getAndroidNative() };
 }
-function resolveDmaConsent() {
-  if (manualConsentSet) return null;
-  const native = getIosNative() ?? getAndroidNative();
-  if (!native || typeof native.getTcfData !== "function") return null;
-  let consent = null;
-  try {
-    consent = tcfToConsent(native.getTcfData());
-  } catch (err) {
-    reportError("consent.tcfRead", err);
-    return null;
+function call(name, ...args) {
+  const { ios, android } = bridge();
+  for (const mod of [ios, android]) {
+    const fn = mod?.[name];
+    if (typeof fn === "function") {
+      try {
+        return fn(...args);
+      } catch (error) {
+        report(`bridge.${name}`, error);
+        return void 0;
+      }
+    }
   }
-  if (!consent) return null;
-  const client = active();
-  const current = client.getConsentData();
-  if (current && consentEquals(current, consent)) return null;
-  client.setConsentData(consent);
-  void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
-  return consent;
+  return void 0;
 }
-function collectDeviceInfo(natives) {
+function report(context, cause) {
   try {
-    if (natives.platform === "android" && natives.android?.getDeviceInfo) {
-      return natives.android.getDeviceInfo();
-    }
-    if (natives.platform === "ios" && natives.ios?.getDeviceInfo) {
-      return natives.ios.getDeviceInfo();
-    }
+    onErrorHook?.(context, cause);
   } catch {
   }
-  return {};
-}
-function applyAppState(client, status) {
-  if (status === "active") {
-    client.notifyAppActive();
-  } else if (status === "background") {
-    client.notifyAppBackground();
-  }
-}
-var instance = null;
-var appStateSub = null;
-var deepLinkSub = null;
-var secureStore = null;
-var installFlagStore = null;
-var INSTALL_SENT_KEY = "advenue.install_sent";
-var installInFlight = false;
-var autoInstallPending = false;
-var autoInstallEnabled = true;
-var manualConsentSet = false;
-var tcfCollectionEnabled = false;
-var configuredAppId = null;
-var configuredApiKey = null;
-var configuredEndpoint = DEFAULT_ENDPOINT;
-var aemSeenUrlHashes = /* @__PURE__ */ new Set();
-function active() {
-  if (!instance) {
-    throw new Error("Advenue.initialize() must be called before tracking events.");
-  }
-  return instance;
 }
-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();
+function requireStarted() {
+  if (started) return true;
+  report("sdk.notInitialized", new Error("Advenue.initialize() has not been called"));
+  return false;
 }
 var Advenue = {
+  /**
+   * Starts the SDK. Safe to call from the app's entry point, and safe to call
+   * twice: the native side replaces its previous instance.
+   */
   async initialize(config) {
-    const {
-      mmkv,
-      secureStore: secureMod,
-      onDeepLink,
-      appId,
-      autoTrackInstall,
-      tcfDataCollection,
-      ...rest
-    } = config;
-    autoInstallPending = false;
-    manualConsentSet = false;
-    tcfCollectionEnabled = tcfDataCollection === true;
-    autoInstallEnabled = autoTrackInstall !== false;
-    const platform = resolvePlatform(rest.platform);
-    configuredAppId = appId ?? null;
-    configuredApiKey = config.apiKey;
-    configuredEndpoint = config.endpoint ?? DEFAULT_ENDPOINT;
-    appStateSub?.remove();
-    appStateSub = null;
-    deepLinkSub?.remove();
-    deepLinkSub = null;
-    instance?.shutdown();
-    const iosMod = getIosNative();
-    const androidMod = getAndroidNative();
-    const storage = mmkv ? createMMKVStorage(mmkv) : createNativeStorage(iosMod ?? androidMod) ?? new MemoryStorage();
-    installFlagStore = storage;
-    secureStore = secureMod ? createSecureStore(secureMod) : createNativeSecureStore(iosMod);
-    const deviceId = rest.deviceId ?? await resolveDurableDeviceId(storage, secureStore ?? void 0);
-    const osVersion = rest.osVersion ?? getOsVersion() ?? void 0;
-    instance = new AdvenueClient({
-      ...rest,
-      platform,
-      deviceId,
-      storage,
-      ...osVersion ? { osVersion } : {}
-    });
-    instance.debugLog(`SDK v${package_default.version} \u2014 events -> ${configuredEndpoint}`);
-    if (tcfCollectionEnabled) resolveDmaConsent();
-    void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
-    const deviceInfo = collectDeviceInfo({
-      platform,
-      ios: getIosNative(),
-      android: getAndroidNative()
-    });
-    if (Object.keys(deviceInfo).length > 0) instance.setDeviceInfo(deviceInfo);
-    if (!config.disableAutoSessions) {
-      const appState = getAppState();
-      if (appState) {
-        appStateSub?.remove();
-        let seenBackground = false;
-        const handler = (status) => {
-          if (!instance) return;
-          if (status === "background") {
-            seenBackground = true;
-            if (tcfCollectionEnabled) resolveDmaConsent();
-            applyAppState(instance, status);
-          } else if (status === "active") {
-            if (!seenBackground) return;
-            seenBackground = false;
-            if (tcfCollectionEnabled) resolveDmaConsent();
-            applyAppState(instance, status);
-            void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
-          }
-        };
-        appStateSub = appState.addEventListener("change", handler);
-        instance.notifyAppActive();
-      } else {
-        instance.notifyAppActive();
+    onErrorHook = config.onError;
+    for (const option of IGNORED_OPTIONS) {
+      if (config[option] !== void 0) {
+        report(
+          `config.ignored:${option}`,
+          new Error(`${option} is decided by the native SDK and has no effect`)
+        );
       }
     }
-    {
-      const linking = getLinking();
-      if (linking) {
-        const client = instance;
-        deepLinkSub = setupDeepLinks({
-          getInitialURL: () => linking.getInitialURL(),
-          addUrlListener: (handler) => linking.addEventListener("url", (e) => handler(e.url)),
-          // Deferred deep link: server-side conversion poll (deterministic ids
-          // where available, probabilistic otherwise).
-          resolveDeferred: () => client.resolveDeferredDeepLink(),
-          onDeepLink: onDeepLink ?? (() => {
-          }),
-          onDirectUrl: (url, link) => {
-            const raw = link.params?.al_applink_data;
-            if (typeof raw !== "string") return;
-            const campaignIds = extractAemCampaignIds(raw);
-            if (!campaignIds) return;
-            const sourceUrlHash = sha256Hex(url);
-            if (aemSeenUrlHashes.has(sourceUrlHash)) return;
-            if (client.getRequireConsent() && !client.getTrackingConsent()) return;
-            client.track("adv_meta_aem", { campaignIds, sourceUrlHash });
-            aemSeenUrlHashes.add(sourceUrlHash);
-          }
+    Advenue.shutdown();
+    call("bridgeInitialize", {
+      apiKey: config.apiKey,
+      endpoint: config.endpoint,
+      appVersion: config.appVersion,
+      requireConsent: config.requireConsent ?? false,
+      batchSize: config.batchSize,
+      flushIntervalMs: config.flushIntervalMs,
+      signingSecret: config.signingSecret,
+      fbAppId: config.fbAppId,
+      autoTrackInstall: config.autoTrackInstall !== false,
+      sdkVersion: package_default.version
+    });
+    started = true;
+    const { ios: iosForErrors, android: androidForErrors } = bridge();
+    const emitter = iosForErrors ?? androidForErrors;
+    if (typeof emitter?.addListener === "function") {
+      try {
+        errorSub = emitter.addListener("onAdvenueError", (event) => {
+          report(event.context, new Error(event.message));
         });
-        deepLinkSub.ready.catch((err) => reportError("deepLink.resolve", err));
+      } catch (error) {
+        report("diagnostics.subscribe", error);
       }
     }
-    if (autoTrackInstall !== false) {
-      if (instance.getRequireConsent() && !instance.getTrackingConsent()) {
-        autoInstallPending = true;
-        instance.debugLog("install deferred until consent is granted");
-      } else {
-        fireAutoInstall();
+    consentCache = call("bridgeGetConsent") ?? false;
+    if (config.appInstanceIdProvider) {
+      try {
+        const id = await config.appInstanceIdProvider();
+        if (id) call("bridgeSetAppInstanceId", id);
+      } catch (error) {
+        report("enrich.appInstanceId", error);
       }
     }
-    return instance;
+    const linking = getLinking();
+    if (linking) {
+      deepLinkSub = setupDeepLinks({
+        getInitialURL: () => linking.getInitialURL(),
+        addUrlListener: (handler) => linking.addEventListener("url", (e) => handler(e.url)),
+        resolveDeferred: () => Advenue.resolveDeferredDeepLink(),
+        onDeepLink: config.onDeepLink ?? (() => {
+        }),
+        onDirectUrl: (url) => {
+          call("bridgeProcessDeepLink", url);
+        }
+      });
+      deepLinkSub.ready.catch((error) => report("deepLink.resolve", error));
+    }
+  },
+  track(name, properties) {
+    if (!requireStarted()) return;
+    call("bridgeTrack", name, properties ?? null);
+  },
+  /** Adds exact local revenue to Apple's conversion-value state. iOS only. */
+  async recordSkanRevenue(input) {
+    if (!requireStarted()) return;
+    call("bridgeRecordSkanRevenue", input.amount, input.currency);
+  },
+  setAppInstanceId(id) {
+    if (!requireStarted()) return;
+    call("bridgeSetAppInstanceId", id);
   },
-  track: (name, properties, opts) => active().track(name, properties, opts),
   /**
-   * Shows the iOS ATT prompt (resolves 'authorized' immediately on Android/web,
-   * where ATT doesn't exist) and forwards the result to the consent gate.
+   * Cross-device linking: associates subsequent events with your user id.
+   * Pass null to clear.
+   *
+   * New on this object. The previous release reached it through the client
+   * `initialize()` resolved to, and that client no longer exists — so it is
+   * promoted here rather than dropped, which is what an app following the
+   * documented cross-device recipe would otherwise hit at runtime.
+   */
+  setUserId(id) {
+    if (!requireStarted()) return;
+    call("bridgeSetUserId", id);
+  },
+  /**
+   * Registers the device's push token for uninstall measurement.
+   *
+   * Advenue never requests the notification permission and never displays
+   * anything: pass the token your push library already produced, on every
+   * launch and from its refresh listener. A stale token is the one thing that
+   * makes uninstall measurement report churn that did not happen.
+   */
+  setPushToken(token, provider) {
+    if (!requireStarted()) return;
+    call("bridgeSetPushToken", token, provider ?? null);
+  },
+  /**
+   * Shows the iOS ATT prompt. Where ATT does not exist (non-iOS, or the iOS
+   * module is absent) there is no prompt to show and no signal to read, so
+   * consent is left untouched and the call resolves 'unavailable'.
    */
   async requestTrackingAuthorization() {
-    const ios = getIosNative();
-    const status = ios ? await ios.requestTrackingAuthorization() : "authorized";
-    active().setTrackingConsent(status === "authorized");
-    void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
-    if (status === "authorized") {
-      fireAutoInstallIfPending();
-    }
+    const { ios } = bridge();
+    if (!ios) return "unavailable";
+    const status = await ios.requestTrackingAuthorization();
+    Advenue.setTrackingConsent(status === "authorized");
     return status;
   },
   setTrackingConsent(granted) {
-    active().setTrackingConsent(granted);
-    if (granted) {
-      fireAutoInstallIfPending();
-    }
+    if (!requireStarted()) return;
+    consentCache = granted;
+    call("bridgeSetConsent", granted);
+  },
+  getTrackingConsent: () => consentCache,
+  setConsentData(consent) {
+    if (!requireStarted()) return;
+    call("bridgeSetConsentData", consent);
   },
-  getTrackingConsent: () => active().getTrackingConsent(),
-  /** GDPR/CCPA erasure: stop tracking and wipe local identifiers/queue. */
+  getConsentData: () => call("bridgeGetConsentData") ?? null,
+  /** GDPR/CCPA erasure: stops tracking and wipes local identifiers and queue. */
   forgetMe() {
-    active().forgetMe();
-    try {
-      installFlagStore?.removeItem(INSTALL_SENT_KEY);
-    } catch (err) {
-      reportError("forget.wipe", 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));
-      }
-    }
+    if (!requireStarted()) return;
+    call("bridgeForgetMe");
+    consentCache = false;
   },
-  setConsentData(consent) {
-    manualConsentSet = true;
-    active().setConsentData(consent);
-    void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
+  flush() {
+    if (!requireStarted()) return;
+    call("bridgeFlush");
+  },
+  getDeviceId: () => Promise.resolve(
+    call("bridgeDeviceId") ?? null
+  ),
+  /** The Advenue ID — alias of `getDeviceId`. */
+  getAdvenueId: () => Advenue.getDeviceId(),
+  /** Which app the server resolved this API key to; null until a batch lands. */
+  getResolvedAppId: () => call("bridgeResolvedAppId") ?? null,
+  /**
+   * Resolves the deferred deep link for this install, or null for an organic
+   * one — which is most of them.
+   */
+  async resolveDeferredDeepLink() {
+    if (!requireStarted()) return null;
+    const result = call("bridgeResolveDeferredDeepLink");
+    return await result ?? null;
   },
-  getConsentData: () => active().getConsentData(),
-  flush: () => active().flush(),
-  getDeviceId: () => active().getDeviceId(),
-  /** The Advenue ID — alias of getDeviceId (see AdvenueClient.getAdvenueId). */
-  getAdvenueId: () => active().getAdvenueId(),
   shutdown() {
-    appStateSub?.remove();
-    appStateSub = null;
     deepLinkSub?.remove();
     deepLinkSub = null;
-    instance?.shutdown();
-    instance = null;
-    secureStore = null;
-    installInFlight = false;
-    autoInstallPending = false;
-    autoInstallEnabled = true;
-    manualConsentSet = false;
-    tcfCollectionEnabled = false;
-    configuredAppId = null;
-    configuredApiKey = null;
-    configuredEndpoint = DEFAULT_ENDPOINT;
-    aemSeenUrlHashes.clear();
+    errorSub?.remove();
+    errorSub = null;
+    if (started) call("bridgeShutdown");
+    started = false;
+    consentCache = false;
   }
 };
-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) {
-    client.debugLog("install skipped (already sent on this device)");
-    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;
-    client.debugLog("install dropped (consent revoked mid-flight)");
-    if (autoInstallEnabled && client.getRequireConsent() && !client.getTrackingConsent()) {
-      autoInstallPending = true;
-    }
-    return;
-  }
-  client.debugLog("install fired");
-  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);
-    }
-  }
-}
+var platform = getPlatformOS;
 export {
   Advenue,
-  applyAppState,
-  collectDeviceInfo,
-  createMMKVStorage,
-  createSecureStore,
   getAndroidNative,
   getIosNative,
   parseDirectLink,
-  resolveAdvertisingId,
-  resolveDmaConsent,
-  trackInstall
+  platform
 };