@advenue/react-native 1.0.0 → 1.1.0

package/ios/vendor/AdvenuePlatform/InstallEnrichment.swift

@@ -4,6 +4,10 @@ import Foundation
 /// Spec §5: the install waits this long for enrichment and no longer. Matches
 /// the deadlines the RN SDK already uses (SKAN config 3000 ms).
 public let INSTALL_WINDOW_MS = 3_000
+/// How long past `INSTALL_WINDOW_MS` flushes stay held for a pending install —
+/// the enrichment deadline is checked by a task that still has to be
+/// scheduled and then hop through the command pipe.
+public let INSTALL_HOLD_MARGIN_MS = 2_000
 
 /// What the install event carries beyond the envelope every event has.
 public struct Enrichment: Sendable, Equatable {
@@ -13,11 +17,14 @@ public struct Enrichment: Sendable, Equatable {
   public var vendorId: String?
   public var appInstanceId: String?
   public var adservicesToken: String?
+  /// B2: reklam takibi sınırlama bayrağı — düşürülüyordu, artık olaya işlenir.
+  public var limitAdTracking: Bool
 
   public init(
     idfa: String? = nil, vendorId: String? = nil,
     appInstanceId: String? = nil, adservicesToken: String? = nil,
-    attestation: AttestationResult? = nil, attestationChallenge: String? = nil
+    attestation: AttestationResult? = nil, attestationChallenge: String? = nil,
+    limitAdTracking: Bool = false
   ) {
     self.attestation = attestation
     self.attestationChallenge = attestationChallenge
@@ -25,6 +32,7 @@ public struct Enrichment: Sendable, Equatable {
     self.vendorId = vendorId
     self.appInstanceId = appInstanceId
     self.adservicesToken = adservicesToken
+    self.limitAdTracking = limitAdTracking
   }
 }
 
@@ -34,6 +42,9 @@ public struct Enrichment: Sendable, Equatable {
 public struct EnrichmentSources: Sendable {
   public var searchAdsToken: @Sendable () async -> String?
   public var advertisingId: @Sendable () -> (idfa: String?, vendorId: String?)
+  /// B2: ATT sınırlama bayrağı. Ayrı kapanış — advertisingId demetini
+  /// değiştirmek mevcut sahte kaynakları kırardı.
+  public var limitAdTracking: @Sendable () -> Bool
   public var appInstanceId: @Sendable () async -> String?
   /// Returns the attested challenge and its result, or nil. Every failure path
   /// — unsupported device, challenge fetch, attest — yields nil, because an
@@ -46,12 +57,14 @@ public struct EnrichmentSources: Sendable {
     appInstanceId: @escaping @Sendable () async -> String?,
     attestation: @escaping @Sendable () async -> (challenge: String, result: AttestationResult)? = {
       nil
-    }
+    },
+    limitAdTracking: @escaping @Sendable () -> Bool = { false }
   ) {
     self.searchAdsToken = searchAdsToken
     self.advertisingId = advertisingId
     self.appInstanceId = appInstanceId
     self.attestation = attestation
+    self.limitAdTracking = limitAdTracking
   }
 
   /// Production wiring. `AdvertisingIdentity.advertisingId` already returns nil
@@ -68,7 +81,8 @@ public struct EnrichmentSources: Sendable {
         return (idfa: identity.advertisingId, vendorId: identity.vendorId)
       },
       appInstanceId: { await appInstanceIdProvider?() },
-      attestation: { await attestation?() })
+      attestation: { await attestation?() },
+      limitAdTracking: { AdvertisingIdentity().limitAdTracking })
   }
 }
 
@@ -85,7 +99,9 @@ public func collectEnrichment(
 ) async -> Enrichment {
   // Synchronous reads; no reason to race them.
   let ids = sources.advertisingId()
-  var result = Enrichment(idfa: ids.idfa, vendorId: ids.vendorId)
+  var result = Enrichment(
+    idfa: ids.idfa, vendorId: ids.vendorId,
+    limitAdTracking: sources.limitAdTracking())
 
   await withTaskGroup(of: (String, String?).self) { group in
     group.addTask { ("adservices", await sources.searchAdsToken()) }

package/ios/vendor/AdvenuePlatform/SkanConfigFetcher.swift

@@ -22,12 +22,24 @@ public struct HttpSkanConfigFetcher: SkanConfigSource {
     self.session = session
   }
 
-  public func fetch(etag: String?) async throws -> SkanConfigResult {
-    var request = URLRequest(url: URL(string: "\(endpoint)/v1/sdk-config")!)
+  /// The exact request this fetcher would send. Public so a test can assert
+  /// the wire shape without a network round trip.
+  ///
+  /// Sends `?platform=ios`: this fetcher is iOS-only by construction, and a
+  /// project-scoped key otherwise cannot resolve a listing on a normal
+  /// two-listing (iOS + Android) product — see `resolveProjectListing` in
+  /// apps/ingestion/src/app.ts, which 400s an ambiguous project key rather
+  /// than guess.
+  public func buildRequest(etag: String?) -> URLRequest {
+    var request = URLRequest(url: URL(string: "\(endpoint)/v1/sdk-config?platform=ios")!)
     request.setValue(apiKey, forHTTPHeaderField: "x-api-key")
     if let etag { request.setValue(etag, forHTTPHeaderField: "if-none-match") }
     request.timeoutInterval = Double(SKAN_CONFIG_TIMEOUT_MS) / 1000
+    return request
+  }
 
+  public func fetch(etag: String?) async throws -> SkanConfigResult {
+    let request = buildRequest(etag: etag)
     let (payload, response) = try await session.data(for: request)
     guard let http = response as? HTTPURLResponse else { throw IngestError(status: 408) }
     if http.statusCode == 304 { return .notModified }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@advenue/react-native",
-  "version": "1.0.0",
+  "version": "1.1.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,7 +27,15 @@ export type {
 } from './native-types';
 
 /** Options this package used to act on and the native SDKs now decide. */
-const IGNORED_OPTIONS = ['mmkv', 'secureStore', 'sdkConfigFetcher', 'tcfDataCollection'] as const;
+// appVersion joins them: the native SDK resolves it from the package/bundle
+// (as the 0.x JS layer did), so a config value would only shadow the real one.
+const IGNORED_OPTIONS = [
+  'mmkv',
+  'secureStore',
+  'sdkConfigFetcher',
+  'tcfDataCollection',
+  'appVersion',
+] as const;
 
 export interface RNAdvenueConfig extends AdvenueConfig {
   /** Meta app id, for the Meta install referrer on Android. */
@@ -55,6 +63,8 @@ let started = false;
 let deepLinkSub: DeepLinkHandle | null = null;
 let errorSub: { remove(): void } | null = null;
 let onErrorHook: ((context: string, cause: unknown) => void) | undefined;
+/** `config.debug`: failures are also written to the JS console. */
+let debugLogging = false;
 
 /**
  * `getTrackingConsent` is synchronous in JavaScript and the value lives in the
@@ -97,6 +107,9 @@ function report(context: string, cause: unknown): void {
   } catch {
     // A throwing diagnostics hook must never break the SDK.
   }
+  // Native failures come back through `onAdvenueError`, so this covers both
+  // sides. The native SDKs log their start and sent batches themselves.
+  if (debugLogging) console.warn(`[Advenue] ${context}`, cause);
 }
 
 function requireStarted(): boolean {
@@ -114,6 +127,7 @@ export const Advenue = {
    */
   async initialize(config: RNAdvenueConfig): Promise<void> {
     onErrorHook = config.onError;
+    debugLogging = config.debug === true;
 
     for (const option of IGNORED_OPTIONS) {
       if ((config as unknown as Record<string, unknown>)[option] !== undefined) {
@@ -131,14 +145,17 @@ export const Advenue = {
     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: pkg.version,
+      // Names the wrapper, like Flutter's `advenue_sdk/…`: a bare version reads
+      // like the native SDK's own stamp.
+      sdkVersion: `react-native/${pkg.version}`,
+      debug: config.debug === true,
+      allowInsecureHttp: config.allowInsecureHttp === true,
     });
     started = true;
 

package/src/native-types.ts

@@ -19,7 +19,6 @@ export type TrackingAuthorizationStatus =
 export interface BridgeInitOptions {
   apiKey: string;
   endpoint?: string;
-  appVersion?: string;
   requireConsent: boolean;
   batchSize?: number;
   flushIntervalMs?: number;

package/src/types.ts

@@ -59,9 +59,12 @@ export interface TrackOptions {
 export interface AdvenueConfig {
   apiKey: string;
   endpoint?: string;
-  platform?: 'ios' | 'android' | 'web' | string;
+  /**
+   * @deprecated Ignored: the native SDK resolves the app version from the
+   * package/bundle. Passing it reports `config.ignored:appVersion` via
+   * `onError`. Removed in the next major.
+   */
   appVersion?: string;
-  osVersion?: string;
   /** Gates every event on `setTrackingConsent(true)`. */
   requireConsent?: boolean;
   /** Events per request. */
@@ -74,8 +77,20 @@ export interface AdvenueConfig {
    * extracted from it.
    */
   signingSecret?: string;
-  disableAutoSessions?: boolean;
+  /**
+   * **Test only.** Allows an `http://` endpoint — a local self-hosted ingest,
+   * or a test server — which the native SDKs otherwise refuse at initialize.
+   * Never set it in a production build: everything, the API key included,
+   * then travels unencrypted.
+   */
+  allowInsecureHttp?: boolean;
   /** Called when the SDK swallows a best-effort failure. Never receives PII. */
   onError?: (context: string, cause: unknown) => void;
+  /**
+   * Development aid: the native SDKs log their start, every swallowed failure
+   * and each sent batch to Xcode's console / logcat, and every failure is also
+   * written to the JS console as `[Advenue] <context>`. Never logs an
+   * identifier or a payload. Leave off in production; use `onError`.
+   */
   debug?: boolean;
 }