@advenue/react-native 0.6.6 → 0.7.0

package/dist/index.cjs

@@ -221,7 +221,7 @@ function sha256Hex(message) {
 // package.json
 var package_default = {
   name: "@advenue/react-native",
-  version: "0.6.6",
+  version: "0.7.0",
   description: "Advenue MMP React Native SDK \u2014 attribution, install tracking, and deep links (bundled iOS/Android Expo native modules)",
   type: "module",
   license: "MIT",
@@ -357,6 +357,19 @@ 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)();
@@ -530,7 +543,14 @@ var Advenue = {
     installFlagStore = storage;
     secureStore = secureMod ? createSecureStore(secureMod) : createNativeSecureStore(iosMod);
     const deviceId = rest.deviceId ?? await (0, import_sdk_core.resolveDurableDeviceId)(storage, secureStore ?? void 0);
-    instance = new import_sdk_core.AdvenueClient({ ...rest, platform, deviceId, storage });
+    const osVersion = rest.osVersion ?? getOsVersion() ?? void 0;
+    instance = new import_sdk_core.AdvenueClient({
+      ...rest,
+      platform,
+      deviceId,
+      storage,
+      ...osVersion ? { osVersion } : {}
+    });
     instance.debugLog(`SDK v${package_default.version} \u2014 events -> ${configuredEndpoint}`);
     void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
     const deviceInfo = collectDeviceInfo({

package/dist/index.js

@@ -217,7 +217,7 @@ function sha256Hex(message) {
 // package.json
 var package_default = {
   name: "@advenue/react-native",
-  version: "0.6.6",
+  version: "0.7.0",
   description: "Advenue MMP React Native SDK \u2014 attribution, install tracking, and deep links (bundled iOS/Android Expo native modules)",
   type: "module",
   license: "MIT",
@@ -353,6 +353,19 @@ 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)();
@@ -526,7 +539,14 @@ var Advenue = {
     installFlagStore = storage;
     secureStore = secureMod ? createSecureStore(secureMod) : createNativeSecureStore(iosMod);
     const deviceId = rest.deviceId ?? await resolveDurableDeviceId(storage, secureStore ?? void 0);
-    instance = new AdvenueClient({ ...rest, platform, deviceId, storage });
+    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}`);
     void resolveAdvertisingId().catch((err) => reportError("enrich.advertisingId", err));
     const deviceInfo = collectDeviceInfo({

package/ios/AdvenueIos.podspec

@@ -17,4 +17,8 @@ Pod::Spec.new do |s|
   s.dependency 'ExpoModulesCore'
 
   s.source_files = '**/*.{h,m,swift}'
+  # Apple privacy manifest (required since May 2024 for SDKs that persist
+  # state / collect device info) — shipped as a resource bundle so Xcode
+  # aggregates it into the app's privacy report.
+  s.resource_bundles = { 'AdvenueIos_Privacy' => ['PrivacyInfo.xcprivacy'] }
 end

package/ios/PrivacyInfo.xcprivacy

@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <!-- The SDK itself does not track (no fingerprinting; IDFA collection is
+       app-mediated via the ATT prompt) and calls no tracking domains. -->
+  <key>NSPrivacyTracking</key>
+  <false/>
+  <key>NSPrivacyTrackingDomains</key>
+  <array/>
+  <key>NSPrivacyCollectedDataTypes</key>
+  <array>
+    <!-- Durable SDK device id (Keychain-backed) — attribution/analytics. -->
+    <dict>
+      <key>NSPrivacyCollectedDataType</key>
+      <string>NSPrivacyCollectedDataTypeDeviceID</string>
+      <key>NSPrivacyCollectedDataTypeLinked</key>
+      <true/>
+      <key>NSPrivacyCollectedDataTypeTracking</key>
+      <false/>
+      <key>NSPrivacyCollectedDataTypePurposes</key>
+      <array>
+        <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+        <string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+      </array>
+    </dict>
+    <!-- Coarse device characteristics (model, OS version, locale, screen) —
+         event enrichment / attribution corroboration. -->
+    <dict>
+      <key>NSPrivacyCollectedDataType</key>
+      <string>NSPrivacyCollectedDataTypeOtherDataTypes</string>
+      <key>NSPrivacyCollectedDataTypeLinked</key>
+      <true/>
+      <key>NSPrivacyCollectedDataTypeTracking</key>
+      <false/>
+      <key>NSPrivacyCollectedDataTypePurposes</key>
+      <array>
+        <string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+      </array>
+    </dict>
+  </array>
+  <key>NSPrivacyAccessedAPITypes</key>
+  <array>
+    <!-- CA92.1: UserDefaults is read/written only for this app's own SDK
+         state (device id mirror, install flag, consent). -->
+    <dict>
+      <key>NSPrivacyAccessedAPIType</key>
+      <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+      <key>NSPrivacyAccessedAPITypeReasons</key>
+      <array>
+        <string>CA92.1</string>
+      </array>
+    </dict>
+  </array>
+</dict>
+</plist>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@advenue/react-native",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "Advenue MMP React Native SDK — attribution, install tracking, and deep links (bundled iOS/Android Expo native modules)",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -27,6 +27,7 @@ import {
   getAppState,
   getIosNative,
   getLinking,
+  getOsVersion,
   getPlatformOS,
 } from './native';
 import { createNativeSecureStore, createNativeStorage } from './native-storage';
@@ -339,7 +340,16 @@ export const Advenue = {
     secureStore = secureMod ? createSecureStore(secureMod) : createNativeSecureStore(iosMod);
     const deviceId =
       rest.deviceId ?? (await resolveDurableDeviceId(storage, secureStore ?? undefined));
-    instance = new AdvenueClient({ ...rest, platform, deviceId, storage });
+    // Auto-collect the OS release version — it feeds the server's normalized
+    // probabilistic fingerprint (spec D1); an explicit config value wins.
+    const osVersion = rest.osVersion ?? getOsVersion() ?? undefined;
+    instance = new AdvenueClient({
+      ...rest,
+      platform,
+      deviceId,
+      storage,
+      ...(osVersion ? { osVersion } : {}),
+    });
     // One-line ground truth for "which SDK build talks to which host" — the
     // exact questions a silent integration always raises first.
     instance.debugLog(`SDK v${pkg.version} — events -> ${configuredEndpoint}`);

package/src/native.ts

@@ -44,6 +44,29 @@ export function getPlatformOS(): string | null {
   }
 }
 
+/**
+ * OS *release* version for attribution matching: iOS `Platform.Version` is the
+ * system version string ('18.2'); Android `Platform.Version` is the API LEVEL
+ * (34) — sending it would break the server's normalized fingerprint (the
+ * click-side browser UA says "Android 14"), so Android reads
+ * `Platform.constants.Release` and degrades to null when it's absent.
+ */
+export function getOsVersion(): string | null {
+  try {
+    const rn = requireReactNative() as {
+      Platform: { OS: string; Version?: unknown; constants?: { Release?: unknown } };
+    } | null;
+    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;
+  }
+}
+
 /** Subscription handle returned by AppState.addEventListener. */
 export interface AppStateSubscription {
   remove(): void;