react-native-turbo-tracking-transparency 0.2.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Solanki Yogesh
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# react-native-turbo-tracking-transparency 🛡️
+
+A high-performance **React Native Turbo Module** for handling iOS App Tracking Transparency (ATT). Built with the new React Native architecture for maximum efficiency and seamless Type-Safety.
+
+[![npm version](https://img.shields.io/npm/v/react-native-turbo-tracking-transparency.svg?style=flat-square)](https://www.npmjs.com/package/react-native-turbo-tracking-transparency)
+[![license](https://img.shields.io/npm/l/react-native-turbo-tracking-transparency.svg?style=flat-square)](https://github.com/SolankiYogesh/react-native-turbo-tracking-transparency/blob/main/LICENSE)
+
+## ✨ Features
+
+- 🏎️ **Turbo Module Support**: Utilizes the New Architecture (JSI) for near-instant native calls.
+- 📐 **Type-Safe**: Full TypeScript support with explicit Enums for tracking status.
+- 📱 **iOS 14+ Ready**: Implements `ATTrackingManager` following Apple's privacy guidelines.
+- 🛡️ **Safe Fallbacks**: Gracefully handles non-iOS platforms.
+
+## 📦 Installation
+
+```sh
+npm install react-native-turbo-tracking-transparency
+# or
+yarn add react-native-turbo-tracking-transparency
+```
+
+Don't forget to install pods:
+
+```sh
+npx pod-install
+```
+
+## 🛠️ iOS Setup
+
+You **must** add the `NSUserTrackingUsageDescription` key to your `Info.plist` file. This message will be displayed in the permission prompt.
+
+```xml
+<key>NSUserTrackingUsageDescription</key>
+<string>We use your data to provide a personalized experience and show relevant ads.</string>
+```
+
+## 🚀 Usage
+
+```tsx
+import { 
+  getTrackingStatus, 
+  requestTrackingPermission,
+  TrackingStatusEnum 
+} from 'react-native-turbo-tracking-transparency';
+
+// 1. Get current status
+const status = getTrackingStatus();
+console.log('Current tracking status:', status);
+
+// 2. Request permission
+const requestStatus = await requestTrackingPermission();
+if (requestStatus === TrackingStatusEnum.Authorized) {
+  // Safe to use IDFA
+}
+```
+
+### Tracking Status Values
+
+| Value | Description |
+| :--- | :--- |
+| `authorized` | Permission granted. |
+| `denied` | Permission denied by user. |
+| `restricted` | Permission restricted (e.g., parental controls). |
+| `not-determined` | Permission not yet requested. |
+| `unavailable` | ATT is not available on this device/platform. |
+
+## 🧪 Testing
+
+The library includes comprehensive tests using Jest.
+
+```sh
+yarn test
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! See the [Contributing Guide](CONTRIBUTING.md) to learn how to get started.
+
+## 📄 License
+
+MIT
+
+---
+
+Made with ❤️ by [Solanki Yogesh](https://github.com/SolankiYogesh)

package/TurboTrackingTransparency.podspec

@@ -0,0 +1,23 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "TurboTrackingTransparency"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/SolankiYogesh/react-native-turbo-tracking-transparency.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  s.frameworks = "AppTrackingTransparency"
+
+  install_modules_dependencies(s)
+end
+

package/android/build.gradle

@@ -0,0 +1,67 @@
+buildscript {
+  ext.TurboTrackingTransparency = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return TurboTrackingTransparency[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.turbotrackingtransparency"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/turbotrackingtransparency/TurboTrackingTransparencyModule.kt

@@ -0,0 +1,19 @@
+package com.turbotrackingtransparency
+
+import com.facebook.react.bridge.ReactApplicationContext
+
+class TurboTrackingTransparencyModule(reactContext: ReactApplicationContext) :
+  NativeTurboTrackingTransparencySpec(reactContext) {
+
+  override fun getTrackingStatus(): String {
+    return "authorized"
+  }
+
+  override fun requestTrackingPermission(promise: com.facebook.react.bridge.Promise) {
+    promise.resolve("authorized")
+  }
+
+  companion object {
+    const val NAME = NativeTurboTrackingTransparencySpec.NAME
+  }
+}

package/android/src/main/java/com/turbotrackingtransparency/TurboTrackingTransparencyPackage.kt

@@ -0,0 +1,33 @@
+package com.turbotrackingtransparency
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class TurboTrackingTransparencyPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == TurboTrackingTransparencyModule.NAME) {
+      TurboTrackingTransparencyModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      moduleInfos[TurboTrackingTransparencyModule.NAME] = ReactModuleInfo(
+        TurboTrackingTransparencyModule.NAME,
+        TurboTrackingTransparencyModule.NAME,
+        false,  // canOverrideExistingModule
+        false,  // needsEagerInit
+        false,  // isCxxModule
+        true // isTurboModule
+      )
+      moduleInfos
+    }
+  }
+}

package/ios/TurboTrackingTransparency.h

@@ -0,0 +1,5 @@
+#import <TurboTrackingTransparencySpec/TurboTrackingTransparencySpec.h>
+
+@interface TurboTrackingTransparency : NSObject <NativeTurboTrackingTransparencySpec>
+
+@end

package/ios/TurboTrackingTransparency.mm

@@ -0,0 +1,55 @@
+#import "TurboTrackingTransparency.h"
+#import <AppTrackingTransparency/AppTrackingTransparency.h>
+#import <Foundation/Foundation.h>
+#include <memory>
+
+@implementation TurboTrackingTransparency
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<
+      facebook::react::NativeTurboTrackingTransparencySpecJSI>(params);
+}
+
++ (NSString *)moduleName {
+  return @"TurboTrackingTransparency";
+}
+
+- (NSString *)getTrackingStatus {
+  if (@available(iOS 14, *)) {
+    ATTrackingManagerAuthorizationStatus status =
+        [ATTrackingManager trackingAuthorizationStatus];
+    return [self mapStatusToString:status];
+  } else {
+    return @"unavailable";
+  }
+}
+
+- (void)requestTrackingPermission:(nonnull RCTPromiseResolveBlock)resolve
+                           reject:(nonnull RCTPromiseRejectBlock)reject {
+  if (@available(iOS 14, *)) {
+    [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(
+                           ATTrackingManagerAuthorizationStatus status) {
+      resolve([self mapStatusToString:status]);
+    }];
+  } else {
+    resolve(@"unavailable");
+  }
+}
+
+- (NSString *)mapStatusToString:(ATTrackingManagerAuthorizationStatus)status {
+  switch (status) {
+  case ATTrackingManagerAuthorizationStatusNotDetermined:
+    return @"not-determined";
+  case ATTrackingManagerAuthorizationStatusRestricted:
+    return @"restricted";
+  case ATTrackingManagerAuthorizationStatusDenied:
+    return @"denied";
+  case ATTrackingManagerAuthorizationStatusAuthorized:
+    return @"authorized";
+  default:
+    return @"unavailable";
+  }
+}
+
+@end

package/lib/module/NativeTurboTrackingTransparency.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export let TrackingStatusEnum = /*#__PURE__*/function (TrackingStatusEnum) {
+  TrackingStatusEnum["Authorized"] = "authorized";
+  TrackingStatusEnum["Denied"] = "denied";
+  TrackingStatusEnum["Restricted"] = "restricted";
+  TrackingStatusEnum["NotDetermined"] = "not-determined";
+  TrackingStatusEnum["Unavailable"] = "unavailable";
+  return TrackingStatusEnum;
+}({});
+export default TurboModuleRegistry.getEnforcing('TurboTrackingTransparency');
+//# sourceMappingURL=NativeTurboTrackingTransparency.js.map

package/lib/module/NativeTurboTrackingTransparency.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","TrackingStatusEnum","getEnforcing"],"sourceRoot":"../../src","sources":["NativeTurboTrackingTransparency.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AACpE,WAAYC,kBAAkB,0BAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAA,OAAlBA,kBAAkB;AAAA;AAY9B,eAAeD,mBAAmB,CAACE,YAAY,CAC7C,2BACF,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import TurboTrackingTransparency, { TrackingStatusEnum } from "./NativeTurboTrackingTransparency.js";
+export function getTrackingStatus() {
+  if (Platform.OS !== 'ios' || !TurboTrackingTransparency) {
+    return TrackingStatusEnum.Authorized;
+  }
+  return TurboTrackingTransparency.getTrackingStatus();
+}
+export function requestTrackingPermission() {
+  if (Platform.OS !== 'ios' || !TurboTrackingTransparency) {
+    return Promise.resolve(TrackingStatusEnum.Authorized);
+  }
+  return TurboTrackingTransparency.requestTrackingPermission();
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","TurboTrackingTransparency","TrackingStatusEnum","getTrackingStatus","OS","Authorized","requestTrackingPermission","Promise","resolve"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,yBAAyB,IAC9BC,kBAAkB,QACb,sCAAmC;AAE1C,OAAO,SAASC,iBAAiBA,CAAA,EAAG;EAClC,IAAIH,QAAQ,CAACI,EAAE,KAAK,KAAK,IAAI,CAACH,yBAAyB,EAAE;IACvD,OAAOC,kBAAkB,CAACG,UAAU;EACtC;EACA,OAAOJ,yBAAyB,CAACE,iBAAiB,CAAC,CAAC;AACtD;AAEA,OAAO,SAASG,yBAAyBA,CAAA,EAAG;EAC1C,IAAIN,QAAQ,CAACI,EAAE,KAAK,KAAK,IAAI,CAACH,yBAAyB,EAAE;IACvD,OAAOM,OAAO,CAACC,OAAO,CAACN,kBAAkB,CAACG,UAAU,CAAC;EACvD;EACA,OAAOJ,yBAAyB,CAACK,yBAAyB,CAAC,CAAC;AAC9D","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/NativeTurboTrackingTransparency.d.ts

@@ -0,0 +1,15 @@
+import { type TurboModule } from 'react-native';
+export declare enum TrackingStatusEnum {
+    Authorized = "authorized",
+    Denied = "denied",
+    Restricted = "restricted",
+    NotDetermined = "not-determined",
+    Unavailable = "unavailable"
+}
+export interface Spec extends TurboModule {
+    getTrackingStatus(): TrackingStatusEnum;
+    requestTrackingPermission(): Promise<TrackingStatusEnum>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeTurboTrackingTransparency.d.ts.map

package/lib/typescript/src/NativeTurboTrackingTransparency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeTurboTrackingTransparency.d.ts","sourceRoot":"","sources":["../../../src/NativeTurboTrackingTransparency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,oBAAY,kBAAkB;IAC5B,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,aAAa,mBAAmB;IAChC,WAAW,gBAAgB;CAC5B;AACD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,iBAAiB,IAAI,kBAAkB,CAAC;IACxC,yBAAyB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC1D;;AAED,wBAEE"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,4 @@
+import { TrackingStatusEnum } from './NativeTurboTrackingTransparency';
+export declare function getTrackingStatus(): TrackingStatusEnum;
+export declare function requestTrackingPermission(): Promise<TrackingStatusEnum>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAkC,EAChC,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAE3C,wBAAgB,iBAAiB,uBAKhC;AAED,wBAAgB,yBAAyB,gCAKxC"}

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "react-native-turbo-tracking-transparency",
+  "version": "0.2.0",
+  "description": "A React Native Library for interacting with the tracking API for ios iOS",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-turbo-tracking-transparency-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SolankiYogesh/react-native-turbo-tracking-transparency.git"
+  },
+  "author": "Solanki Yogesh <solankiyogesh3500@gmail.com> (https://github.com/SolankiYogesh)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/SolankiYogesh/react-native-turbo-tracking-transparency/issues"
+  },
+  "homepage": "https://github.com/SolankiYogesh/react-native-turbo-tracking-transparency#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "TurboTrackingTransparencySpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.turbotrackingtransparency"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.57.0"
+  }
+}

package/src/NativeTurboTrackingTransparency.ts

@@ -0,0 +1,16 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+export enum TrackingStatusEnum {
+  Authorized = 'authorized',
+  Denied = 'denied',
+  Restricted = 'restricted',
+  NotDetermined = 'not-determined',
+  Unavailable = 'unavailable',
+}
+export interface Spec extends TurboModule {
+  getTrackingStatus(): TrackingStatusEnum;
+  requestTrackingPermission(): Promise<TrackingStatusEnum>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>(
+  'TurboTrackingTransparency'
+);

package/src/index.ts

@@ -0,0 +1,18 @@
+import { Platform } from 'react-native';
+import TurboTrackingTransparency, {
+  TrackingStatusEnum,
+} from './NativeTurboTrackingTransparency';
+
+export function getTrackingStatus() {
+  if (Platform.OS !== 'ios' || !TurboTrackingTransparency) {
+    return TrackingStatusEnum.Authorized;
+  }
+  return TurboTrackingTransparency.getTrackingStatus();
+}
+
+export function requestTrackingPermission() {
+  if (Platform.OS !== 'ios' || !TurboTrackingTransparency) {
+    return Promise.resolve(TrackingStatusEnum.Authorized);
+  }
+  return TurboTrackingTransparency.requestTrackingPermission();
+}