@kontextso/sdk-react-native 3.3.1-rc.0 → 3.4.0-rc.1

package/src/services/Att.ts

@@ -0,0 +1,117 @@
+import { Platform } from 'react-native'
+import NativeRNKontext from '../NativeRNKontext'
+
+const ZERO_UUID = '00000000-0000-0000-0000-000000000000'
+
+// Mirrors TrackingStatus enum from Flutter / ATTrackingManager raw values
+export enum TrackingStatus {
+  NotDetermined = 0,
+  Restricted = 1,
+  Denied = 2,
+  Authorized = 3,
+  NotSupported = 4, // iOS < 14 or non-iOS
+}
+
+let didRunStartupFlow = false
+let startupFlowPromise: Promise<void> | null = null
+
+/**
+ * Requests ATT authorization on iOS >= 14.5.
+ * On iOS 14.0–14.4 we intentionally skip the request: the dialog is not
+ * required to read IDFA on those versions, and asking only to get denied
+ * would permanently revoke access.
+ * Guaranteed to run only once per app session regardless of call count.
+ */
+export function requestTrackingAuthorization(): Promise<void> {
+  if (didRunStartupFlow) {
+    return startupFlowPromise ?? Promise.resolve()
+  }
+  didRunStartupFlow = true
+  startupFlowPromise = _runStartupFlow()
+  return startupFlowPromise
+}
+
+export async function getTrackingAuthorizationStatus(): Promise<TrackingStatus> {
+  if (Platform.OS !== 'ios') {
+    return TrackingStatus.NotSupported
+  }
+  try {
+    const raw = await NativeRNKontext.getTrackingAuthorizationStatus()
+    return _mapRawStatus(raw)
+  } catch (error) {
+    console.error(error)
+    return TrackingStatus.NotSupported
+  }
+}
+
+export async function getAdvertisingId(): Promise<string | null> {
+  try {
+    const id = await NativeRNKontext.getAdvertisingId()
+    return _normalizeId(id)
+  } catch (error) {
+    console.error(error)
+    return null
+  }
+}
+
+export async function getVendorId(): Promise<string | null> {
+  if (Platform.OS !== 'ios') {
+    return null
+  }
+  try {
+    const id = await NativeRNKontext.getVendorId()
+    return _normalizeId(id)
+  } catch (error) {
+    console.error(error)
+    return null
+  }
+}
+
+export async function resolveIds(fallbacks?: {
+  vendorId?: string | undefined
+  advertisingId?: string | undefined
+}): Promise<{ vendorId: string | null; advertisingId: string | null }> {
+  const [vendorId, advertisingId] = await Promise.all([getVendorId(), getAdvertisingId()])
+
+  return {
+    vendorId: vendorId ?? _normalizeId(fallbacks?.vendorId),
+    advertisingId: advertisingId ?? _normalizeId(fallbacks?.advertisingId),
+  }
+}
+
+// ─── internal ────────────────────────────────────────────────────────────────
+
+async function _runStartupFlow(): Promise<void> {
+  if (Platform.OS !== 'ios') return
+
+  try {
+    if (!_isVersionAtLeast145(Platform.Version)) return
+
+    const status = await getTrackingAuthorizationStatus()
+    if (status !== TrackingStatus.NotDetermined) return
+
+    await NativeRNKontext.requestTrackingAuthorization()
+  } catch (error) {
+    console.error(error)
+  }
+}
+
+/**
+ * iOS 14.0–14.4: ATT dialog not required for IDFA access.
+ * Requesting it risks permanent denial, so we only request on >= 14.5.
+ */
+function _isVersionAtLeast145(version: string): boolean {
+  const [major = 0, minor = 0] = version.split('.').map(Number)
+  return major > 14 || (major === 14 && minor >= 5)
+}
+
+function _mapRawStatus(raw: number): TrackingStatus {
+  if (raw >= 0 && raw <= 4) return raw as TrackingStatus
+  return TrackingStatus.NotSupported
+}
+
+function _normalizeId(id: string | null | undefined): string | null {
+  if (!id || id.trim() === '') return null
+  if (id.toLowerCase() === ZERO_UUID) return null
+  return id
+}

package/src/services/SkAdNetwork.ts

@@ -0,0 +1,75 @@
+import { Platform } from 'react-native'
+import NativeRNKontext from '../NativeRNKontext'
+
+export interface SkAdNetworkFidelity {
+  fidelity: number
+  signature: string
+  nonce: string
+  timestamp: string | number
+}
+
+export interface SkAdNetworkImpressionParams {
+  // Required
+  version: string
+  network: string
+  itunesItem: string | number
+  sourceApp: string | number
+  // Optional
+  sourceIdentifier?: string | number
+  campaign?: string | number
+  fidelities?: SkAdNetworkFidelity[]
+  nonce?: string
+  timestamp?: string | number
+  signature?: string
+}
+
+let impressionReady = false
+
+export async function initSkAdNetworkImpression(params: SkAdNetworkImpressionParams): Promise<boolean> {
+  if (Platform.OS !== 'ios') return false
+
+  try {
+    const result = await NativeRNKontext.initSkAdNetworkImpression(params)
+    impressionReady = result
+    return result
+  } catch (e) {
+    impressionReady = false
+    console.error('[SKAdNetwork] Error initializing impression:', e)
+    return false
+  }
+}
+
+export async function startSkAdNetworkImpression(): Promise<boolean> {
+  if (Platform.OS !== 'ios' || !impressionReady) return false
+
+  try {
+    return await NativeRNKontext.startSkAdNetworkImpression()
+  } catch (e) {
+    console.error('[SKAdNetwork] Error starting impression:', e)
+    return false
+  }
+}
+
+export async function endSkAdNetworkImpression(): Promise<boolean> {
+  if (Platform.OS !== 'ios' || !impressionReady) return false
+
+  try {
+    return await NativeRNKontext.endSkAdNetworkImpression()
+  } catch (e) {
+    console.error('[SKAdNetwork] Error ending impression:', e)
+    return false
+  }
+}
+
+export async function disposeSkAdNetwork(): Promise<boolean> {
+  impressionReady = false
+
+  if (Platform.OS !== 'ios') return false
+
+  try {
+    return await NativeRNKontext.disposeSkAdNetwork()
+  } catch (e) {
+    console.error('[SKAdNetwork] Error disposing:', e)
+    return false
+  }
+}