@capawesome/capacitor-app-tracking-transparency 0.0.1

package/CapawesomeCapacitorAppTrackingTransparency.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapawesomeCapacitorAppTrackingTransparency'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Genz
+
+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/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapawesomeCapacitorAppTrackingTransparency",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorAppTrackingTransparency",
+            targets: ["AppTrackingTransparencyPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "AppTrackingTransparencyPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"),
+        .testTarget(
+            name: "AppTrackingTransparencyPluginTests",
+            dependencies: ["AppTrackingTransparencyPlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,229 @@
+# @capawesome/capacitor-app-tracking-transparency
+
+Capacitor plugin for the [App Tracking Transparency](https://developer.apple.com/documentation/apptrackingtransparency) framework.
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
+
+## Features
+
+We are proud to offer one of the most complete and feature-rich Capacitor plugins for App Tracking Transparency. Here are some of the key features:
+
+- 🔒 **Authorization status**: Read the current tracking authorization status.
+- 🙋 **Permission request**: Present the system tracking authorization prompt.
+- 🆔 **Advertising identifier**: Read the advertising identifier (IDFA) when authorized.
+- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.
+- 🔁 **Up-to-date**: Always supports the latest Capacitor version.
+
+Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 0.x.x          | >=8.x.x           | Active support |
+
+## Installation
+
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-app-tracking-transparency` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
+```bash
+npm install @capawesome/capacitor-app-tracking-transparency
+npx cap sync
+```
+
+This plugin is only available on **iOS**. On Android and Web, all methods reject as unimplemented.
+
+### iOS
+
+#### Privacy Descriptions
+
+The `NSUserTrackingUsageDescription` key must be added to the `Info.plist` file of your app. Otherwise, the `requestPermission(...)` method will reject with an error.
+
+```xml
+<key>NSUserTrackingUsageDescription</key>
+<string>Your data will be used to deliver personalized ads to you.</string>
+```
+
+The purpose string must clearly explain why your app is requesting permission to track the user. See the [Apple documentation](https://developer.apple.com/documentation/bundleresources/information-property-list/nsusertrackingusagedescription) for more information.
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { AppTrackingTransparency } from '@capawesome/capacitor-app-tracking-transparency';
+
+const getStatus = async () => {
+  const { status } = await AppTrackingTransparency.getStatus();
+  return status;
+};
+
+const requestPermission = async () => {
+  const { status } = await AppTrackingTransparency.requestPermission();
+  return status;
+};
+
+const getAdvertisingIdentifier = async () => {
+  const { advertisingIdentifier } =
+    await AppTrackingTransparency.getAdvertisingIdentifier();
+  return advertisingIdentifier;
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`getAdvertisingIdentifier()`](#getadvertisingidentifier)
+* [`getStatus()`](#getstatus)
+* [`requestPermission()`](#requestpermission)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### getAdvertisingIdentifier()
+
+```typescript
+getAdvertisingIdentifier() => Promise<GetAdvertisingIdentifierResult>
+```
+
+Get the advertising identifier (IDFA) of the device.
+
+The advertising identifier is only available if the tracking authorization
+status is `authorized`. Otherwise, `null` is returned.
+
+**Note**: The iOS Simulator always returns `null`, even if the tracking
+authorization status is `authorized`. Use a real device to test this method.
+
+Only available on iOS.
+
+**Returns:** <code>Promise&lt;<a href="#getadvertisingidentifierresult">GetAdvertisingIdentifierResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### getStatus()
+
+```typescript
+getStatus() => Promise<GetStatusResult>
+```
+
+Get the current tracking authorization status.
+
+Only available on iOS.
+
+**Returns:** <code>Promise&lt;<a href="#getstatusresult">GetStatusResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### requestPermission()
+
+```typescript
+requestPermission() => Promise<RequestPermissionResult>
+```
+
+Request permission to track the user.
+
+This will present the system tracking authorization prompt if the status
+has not been determined yet. The prompt is only shown once per install.
+
+The `NSUserTrackingUsageDescription` key must be added to the `Info.plist`
+file of your app.
+
+Only available on iOS.
+
+**Returns:** <code>Promise&lt;<a href="#requestpermissionresult">RequestPermissionResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### GetAdvertisingIdentifierResult
+
+| Prop                        | Type                        | Description                                                                                                                                                                                                           | Since |
+| --------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`advertisingIdentifier`** | <code>string \| null</code> | The advertising identifier (IDFA) of the device. Returns `null` if the tracking authorization status is not `authorized` or if no advertising identifier is available, which is always the case on the iOS Simulator. | 0.1.0 |
+
+
+#### GetStatusResult
+
+| Prop         | Type                                                      | Description                                | Since |
+| ------------ | --------------------------------------------------------- | ------------------------------------------ | ----- |
+| **`status`** | <code><a href="#trackingstatus">TrackingStatus</a></code> | The current tracking authorization status. | 0.1.0 |
+
+
+#### RequestPermissionResult
+
+| Prop         | Type                                                      | Description                                          | Since |
+| ------------ | --------------------------------------------------------- | ---------------------------------------------------- | ----- |
+| **`status`** | <code><a href="#trackingstatus">TrackingStatus</a></code> | The tracking authorization status after the request. | 0.1.0 |
+
+
+### Type Aliases
+
+
+#### TrackingStatus
+
+The tracking authorization status.
+
+- `authorized`: The user authorized access to app-related data for tracking.
+- `denied`: The user denied access to app-related data for tracking.
+- `notDetermined`: The user has not yet received a tracking authorization request.
+- `restricted`: Tracking authorization is restricted and cannot be changed by the user.
+
+<code>'authorized' | 'denied' | 'notDetermined' | 'restricted'</code>
+
+</docgen-api>
+
+## App Review Guidance
+
+Apple requires that any app that tracks users requests permission via the App Tracking Transparency framework. Keep the following guidelines in mind to avoid App Review rejections:
+
+- **Prompt timing**: Call `requestPermission(...)` only when the user is in a context where tracking makes sense. The system prompt is only shown once per install while the status is `notDetermined`. Calling the method again afterwards resolves with the existing status without showing the prompt.
+- **Purpose string**: The `NSUserTrackingUsageDescription` purpose string must accurately describe how the collected data is used. Vague or misleading descriptions are a common reason for rejection.
+- **Advertising identifier**: The advertising identifier (IDFA) is only available while the status is `authorized`. In all other cases, `getAdvertisingIdentifier(...)` returns `null`.
+- **Simulator**: The iOS Simulator never provides an advertising identifier, so `getAdvertisingIdentifier(...)` always returns `null` there, even if the status is `authorized`. Use a real device to test the advertising identifier.
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-tracking-transparency/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/app-tracking-transparency/LICENSE).

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "io.capawesome.capacitorjs.plugins.apptrackingtransparency"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

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/io/capawesome/capacitorjs/plugins/apptrackingtransparency/AppTrackingTransparencyPlugin.java

@@ -0,0 +1,30 @@
+package io.capawesome.capacitorjs.plugins.apptrackingtransparency;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+@CapacitorPlugin(name = "AppTrackingTransparency")
+public class AppTrackingTransparencyPlugin extends Plugin {
+
+    @PluginMethod
+    public void getAdvertisingIdentifier(PluginCall call) {
+        rejectCallAsUnimplemented(call);
+    }
+
+    @PluginMethod
+    public void getStatus(PluginCall call) {
+        rejectCallAsUnimplemented(call);
+    }
+
+    @PluginMethod
+    public void requestPermission(PluginCall call) {
+        rejectCallAsUnimplemented(call);
+    }
+
+    private void rejectCallAsUnimplemented(@NonNull PluginCall call) {
+        call.unimplemented("This method is not available on this platform.");
+    }
+}

package/dist/docs.json

@@ -0,0 +1,177 @@
+{
+  "api": {
+    "name": "AppTrackingTransparencyPlugin",
+    "slug": "apptrackingtransparencyplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "getAdvertisingIdentifier",
+        "signature": "() => Promise<GetAdvertisingIdentifierResult>",
+        "parameters": [],
+        "returns": "Promise<GetAdvertisingIdentifierResult>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Get the advertising identifier (IDFA) of the device.\n\nThe advertising identifier is only available if the tracking authorization\nstatus is `authorized`. Otherwise, `null` is returned.\n\n**Note**: The iOS Simulator always returns `null`, even if the tracking\nauthorization status is `authorized`. Use a real device to test this method.\n\nOnly available on iOS.",
+        "complexTypes": [
+          "GetAdvertisingIdentifierResult"
+        ],
+        "slug": "getadvertisingidentifier"
+      },
+      {
+        "name": "getStatus",
+        "signature": "() => Promise<GetStatusResult>",
+        "parameters": [],
+        "returns": "Promise<GetStatusResult>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Get the current tracking authorization status.\n\nOnly available on iOS.",
+        "complexTypes": [
+          "GetStatusResult"
+        ],
+        "slug": "getstatus"
+      },
+      {
+        "name": "requestPermission",
+        "signature": "() => Promise<RequestPermissionResult>",
+        "parameters": [],
+        "returns": "Promise<RequestPermissionResult>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Request permission to track the user.\n\nThis will present the system tracking authorization prompt if the status\nhas not been determined yet. The prompt is only shown once per install.\n\nThe `NSUserTrackingUsageDescription` key must be added to the `Info.plist`\nfile of your app.\n\nOnly available on iOS.",
+        "complexTypes": [
+          "RequestPermissionResult"
+        ],
+        "slug": "requestpermission"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "GetAdvertisingIdentifierResult",
+      "slug": "getadvertisingidentifierresult",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "advertisingIdentifier",
+          "tags": [
+            {
+              "text": "'6D92078A-8246-4BA4-AE5B-76104861E7DC'",
+              "name": "example"
+            },
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The advertising identifier (IDFA) of the device.\n\nReturns `null` if the tracking authorization status is not `authorized`\nor if no advertising identifier is available, which is always the case\non the iOS Simulator.",
+          "complexTypes": [],
+          "type": "string | null"
+        }
+      ]
+    },
+    {
+      "name": "GetStatusResult",
+      "slug": "getstatusresult",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "status",
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The current tracking authorization status.",
+          "complexTypes": [
+            "TrackingStatus"
+          ],
+          "type": "TrackingStatus"
+        }
+      ]
+    },
+    {
+      "name": "RequestPermissionResult",
+      "slug": "requestpermissionresult",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "status",
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The tracking authorization status after the request.",
+          "complexTypes": [
+            "TrackingStatus"
+          ],
+          "type": "TrackingStatus"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [
+    {
+      "name": "TrackingStatus",
+      "slug": "trackingstatus",
+      "docs": "The tracking authorization status.\n\n- `authorized`: The user authorized access to app-related data for tracking.\n- `denied`: The user denied access to app-related data for tracking.\n- `notDetermined`: The user has not yet received a tracking authorization request.\n- `restricted`: Tracking authorization is restricted and cannot be changed by the user.",
+      "types": [
+        {
+          "text": "'authorized'",
+          "complexTypes": []
+        },
+        {
+          "text": "'denied'",
+          "complexTypes": []
+        },
+        {
+          "text": "'notDetermined'",
+          "complexTypes": []
+        },
+        {
+          "text": "'restricted'",
+          "complexTypes": []
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,87 @@
+export interface AppTrackingTransparencyPlugin {
+    /**
+     * Get the advertising identifier (IDFA) of the device.
+     *
+     * The advertising identifier is only available if the tracking authorization
+     * status is `authorized`. Otherwise, `null` is returned.
+     *
+     * **Note**: The iOS Simulator always returns `null`, even if the tracking
+     * authorization status is `authorized`. Use a real device to test this method.
+     *
+     * Only available on iOS.
+     *
+     * @since 0.1.0
+     */
+    getAdvertisingIdentifier(): Promise<GetAdvertisingIdentifierResult>;
+    /**
+     * Get the current tracking authorization status.
+     *
+     * Only available on iOS.
+     *
+     * @since 0.1.0
+     */
+    getStatus(): Promise<GetStatusResult>;
+    /**
+     * Request permission to track the user.
+     *
+     * This will present the system tracking authorization prompt if the status
+     * has not been determined yet. The prompt is only shown once per install.
+     *
+     * The `NSUserTrackingUsageDescription` key must be added to the `Info.plist`
+     * file of your app.
+     *
+     * Only available on iOS.
+     *
+     * @since 0.1.0
+     */
+    requestPermission(): Promise<RequestPermissionResult>;
+}
+/**
+ * @since 0.1.0
+ */
+export interface GetStatusResult {
+    /**
+     * The current tracking authorization status.
+     *
+     * @since 0.1.0
+     */
+    status: TrackingStatus;
+}
+/**
+ * @since 0.1.0
+ */
+export interface RequestPermissionResult {
+    /**
+     * The tracking authorization status after the request.
+     *
+     * @since 0.1.0
+     */
+    status: TrackingStatus;
+}
+/**
+ * @since 0.1.0
+ */
+export interface GetAdvertisingIdentifierResult {
+    /**
+     * The advertising identifier (IDFA) of the device.
+     *
+     * Returns `null` if the tracking authorization status is not `authorized`
+     * or if no advertising identifier is available, which is always the case
+     * on the iOS Simulator.
+     *
+     * @example '6D92078A-8246-4BA4-AE5B-76104861E7DC'
+     * @since 0.1.0
+     */
+    advertisingIdentifier: string | null;
+}
+/**
+ * The tracking authorization status.
+ *
+ * - `authorized`: The user authorized access to app-related data for tracking.
+ * - `denied`: The user denied access to app-related data for tracking.
+ * - `notDetermined`: The user has not yet received a tracking authorization request.
+ * - `restricted`: Tracking authorization is restricted and cannot be changed by the user.
+ *
+ * @since 0.1.0
+ */
+export type TrackingStatus = 'authorized' | 'denied' | 'notDetermined' | 'restricted';

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface AppTrackingTransparencyPlugin {\n  /**\n   * Get the advertising identifier (IDFA) of the device.\n   *\n   * The advertising identifier is only available if the tracking authorization\n   * status is `authorized`. Otherwise, `null` is returned.\n   *\n   * **Note**: The iOS Simulator always returns `null`, even if the tracking\n   * authorization status is `authorized`. Use a real device to test this method.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  getAdvertisingIdentifier(): Promise<GetAdvertisingIdentifierResult>;\n  /**\n   * Get the current tracking authorization status.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  getStatus(): Promise<GetStatusResult>;\n  /**\n   * Request permission to track the user.\n   *\n   * This will present the system tracking authorization prompt if the status\n   * has not been determined yet. The prompt is only shown once per install.\n   *\n   * The `NSUserTrackingUsageDescription` key must be added to the `Info.plist`\n   * file of your app.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  requestPermission(): Promise<RequestPermissionResult>;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetStatusResult {\n  /**\n   * The current tracking authorization status.\n   *\n   * @since 0.1.0\n   */\n  status: TrackingStatus;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface RequestPermissionResult {\n  /**\n   * The tracking authorization status after the request.\n   *\n   * @since 0.1.0\n   */\n  status: TrackingStatus;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetAdvertisingIdentifierResult {\n  /**\n   * The advertising identifier (IDFA) of the device.\n   *\n   * Returns `null` if the tracking authorization status is not `authorized`\n   * or if no advertising identifier is available, which is always the case\n   * on the iOS Simulator.\n   *\n   * @example '6D92078A-8246-4BA4-AE5B-76104861E7DC'\n   * @since 0.1.0\n   */\n  advertisingIdentifier: string | null;\n}\n\n/**\n * The tracking authorization status.\n *\n * - `authorized`: The user authorized access to app-related data for tracking.\n * - `denied`: The user denied access to app-related data for tracking.\n * - `notDetermined`: The user has not yet received a tracking authorization request.\n * - `restricted`: Tracking authorization is restricted and cannot be changed by the user.\n *\n * @since 0.1.0\n */\nexport type TrackingStatus =\n  | 'authorized'\n  | 'denied'\n  | 'notDetermined'\n  | 'restricted';\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { AppTrackingTransparencyPlugin } from './definitions';
+declare const AppTrackingTransparency: AppTrackingTransparencyPlugin;
+export * from './definitions';
+export { AppTrackingTransparency };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const AppTrackingTransparency = registerPlugin('AppTrackingTransparency', {
+    web: () => import('./web').then(m => new m.AppTrackingTransparencyWeb()),
+});
+export * from './definitions';
+export { AppTrackingTransparency };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,uBAAuB,GAAG,cAAc,CAC5C,yBAAyB,EACzB;IACE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,0BAA0B,EAAE,CAAC;CACzE,CACF,CAAC;AAEF,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { AppTrackingTransparencyPlugin } from './definitions';\n\nconst AppTrackingTransparency = registerPlugin<AppTrackingTransparencyPlugin>(\n  'AppTrackingTransparency',\n  {\n    web: () => import('./web').then(m => new m.AppTrackingTransparencyWeb()),\n  },\n);\n\nexport * from './definitions';\nexport { AppTrackingTransparency };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,7 @@
+import { WebPlugin } from '@capacitor/core';
+import type { AppTrackingTransparencyPlugin, GetAdvertisingIdentifierResult, GetStatusResult, RequestPermissionResult } from './definitions';
+export declare class AppTrackingTransparencyWeb extends WebPlugin implements AppTrackingTransparencyPlugin {
+    getAdvertisingIdentifier(): Promise<GetAdvertisingIdentifierResult>;
+    getStatus(): Promise<GetStatusResult>;
+    requestPermission(): Promise<RequestPermissionResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,13 @@
+import { WebPlugin } from '@capacitor/core';
+export class AppTrackingTransparencyWeb extends WebPlugin {
+    async getAdvertisingIdentifier() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getStatus() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async requestPermission() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,0BACX,SAAQ,SAAS;IAGjB,KAAK,CAAC,wBAAwB;QAC5B,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  AppTrackingTransparencyPlugin,\n  GetAdvertisingIdentifierResult,\n  GetStatusResult,\n  RequestPermissionResult,\n} from './definitions';\n\nexport class AppTrackingTransparencyWeb\n  extends WebPlugin\n  implements AppTrackingTransparencyPlugin\n{\n  async getAdvertisingIdentifier(): Promise<GetAdvertisingIdentifierResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getStatus(): Promise<GetStatusResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async requestPermission(): Promise<RequestPermissionResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const AppTrackingTransparency = core.registerPlugin('AppTrackingTransparency', {
+    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.AppTrackingTransparencyWeb()),
+});
+
+class AppTrackingTransparencyWeb extends core.WebPlugin {
+    async getAdvertisingIdentifier() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async getStatus() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async requestPermission() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    AppTrackingTransparencyWeb: AppTrackingTransparencyWeb
+});
+
+exports.AppTrackingTransparency = AppTrackingTransparency;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst AppTrackingTransparency = registerPlugin('AppTrackingTransparency', {\n    web: () => import('./web').then(m => new m.AppTrackingTransparencyWeb()),\n});\nexport * from './definitions';\nexport { AppTrackingTransparency };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AppTrackingTransparencyWeb extends WebPlugin {\n    async getAdvertisingIdentifier() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getStatus() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async requestPermission() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,uBAAuB,GAAGA,mBAAc,CAAC,yBAAyB,EAAE;AAC1E,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,0BAA0B,EAAE,CAAC;AAC5E,CAAC;;ACFM,MAAM,0BAA0B,SAASC,cAAS,CAAC;AAC1D,IAAI,MAAM,wBAAwB,GAAG;AACrC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,SAAS,GAAG;AACtB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,30 @@
+var capacitorAppTrackingTransparency = (function (exports, core) {
+    'use strict';
+
+    const AppTrackingTransparency = core.registerPlugin('AppTrackingTransparency', {
+        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.AppTrackingTransparencyWeb()),
+    });
+
+    class AppTrackingTransparencyWeb extends core.WebPlugin {
+        async getAdvertisingIdentifier() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async getStatus() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async requestPermission() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        AppTrackingTransparencyWeb: AppTrackingTransparencyWeb
+    });
+
+    exports.AppTrackingTransparency = AppTrackingTransparency;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst AppTrackingTransparency = registerPlugin('AppTrackingTransparency', {\n    web: () => import('./web').then(m => new m.AppTrackingTransparencyWeb()),\n});\nexport * from './definitions';\nexport { AppTrackingTransparency };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AppTrackingTransparencyWeb extends WebPlugin {\n    async getAdvertisingIdentifier() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getStatus() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async requestPermission() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,uBAAuB,GAAGA,mBAAc,CAAC,yBAAyB,EAAE;IAC1E,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,0BAA0B,EAAE,CAAC;IAC5E,CAAC;;ICFM,MAAM,0BAA0B,SAASC,cAAS,CAAC;IAC1D,IAAI,MAAM,wBAAwB,GAAG;IACrC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,SAAS,GAAG;IACtB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Plugin/AppTrackingTransparency.swift

@@ -0,0 +1,54 @@
+import Foundation
+import AdSupport
+import AppTrackingTransparency
+
+@objc public class AppTrackingTransparency: NSObject {
+    let plugin: AppTrackingTransparencyPlugin
+
+    init(plugin: AppTrackingTransparencyPlugin) {
+        self.plugin = plugin
+    }
+
+    @objc public func getAdvertisingIdentifier(completion: @escaping (GetAdvertisingIdentifierResult?, Error?) -> Void) {
+        let identifier = ASIdentifierManager.shared().advertisingIdentifier.uuidString
+        let advertisingIdentifier = identifier == Self.zeroIdentifier ? nil : identifier
+        let result = GetAdvertisingIdentifierResult(advertisingIdentifier: advertisingIdentifier)
+        completion(result, nil)
+    }
+
+    @objc public func getStatus(completion: @escaping (GetStatusResult?, Error?) -> Void) {
+        let status = Self.mapAuthorizationStatus(ATTrackingManager.trackingAuthorizationStatus)
+        let result = GetStatusResult(status: status)
+        completion(result, nil)
+    }
+
+    @objc public func requestPermission(completion: @escaping (RequestPermissionResult?, Error?) -> Void) {
+        guard Bundle.main.object(forInfoDictionaryKey: "NSUserTrackingUsageDescription") is String else {
+            completion(nil, CustomError.usageDescriptionMissing)
+            return
+        }
+        DispatchQueue.main.async {
+            ATTrackingManager.requestTrackingAuthorization { status in
+                let result = RequestPermissionResult(status: Self.mapAuthorizationStatus(status))
+                completion(result, nil)
+            }
+        }
+    }
+
+    private static let zeroIdentifier = "00000000-0000-0000-0000-000000000000"
+
+    private static func mapAuthorizationStatus(_ status: ATTrackingManager.AuthorizationStatus) -> String {
+        switch status {
+        case .authorized:
+            return "authorized"
+        case .denied:
+            return "denied"
+        case .restricted:
+            return "restricted"
+        case .notDetermined:
+            return "notDetermined"
+        @unknown default:
+            return "notDetermined"
+        }
+    }
+}

package/ios/Plugin/AppTrackingTransparencyPlugin.swift

@@ -0,0 +1,64 @@
+import Foundation
+import Capacitor
+
+@objc(AppTrackingTransparencyPlugin)
+public class AppTrackingTransparencyPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "AppTrackingTransparencyPlugin"
+    public let jsName = "AppTrackingTransparency"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "getAdvertisingIdentifier", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getStatus", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "requestPermission", returnType: CAPPluginReturnPromise)
+    ]
+
+    public static let tag = "AppTrackingTransparencyPlugin"
+
+    private var implementation: AppTrackingTransparency?
+
+    override public func load() {
+        self.implementation = AppTrackingTransparency(plugin: self)
+    }
+
+    @objc func getAdvertisingIdentifier(_ call: CAPPluginCall) {
+        implementation?.getAdvertisingIdentifier { result, error in
+            if let error = error {
+                self.rejectCall(call, error)
+                return
+            }
+            self.resolveCall(call, result)
+        }
+    }
+
+    @objc func getStatus(_ call: CAPPluginCall) {
+        implementation?.getStatus { result, error in
+            if let error = error {
+                self.rejectCall(call, error)
+                return
+            }
+            self.resolveCall(call, result)
+        }
+    }
+
+    @objc func requestPermission(_ call: CAPPluginCall) {
+        implementation?.requestPermission { result, error in
+            if let error = error {
+                self.rejectCall(call, error)
+                return
+            }
+            self.resolveCall(call, result)
+        }
+    }
+
+    private func rejectCall(_ call: CAPPluginCall, _ error: Error) {
+        CAPLog.print("[", AppTrackingTransparencyPlugin.tag, "] ", error)
+        call.reject(error.localizedDescription)
+    }
+
+    private func resolveCall(_ call: CAPPluginCall, _ result: Result?) {
+        if let result = result?.toJSObject() as? JSObject {
+            call.resolve(result)
+        } else {
+            call.resolve()
+        }
+    }
+}

package/ios/Plugin/Classes/Results/GetAdvertisingIdentifierResult.swift

@@ -0,0 +1,16 @@
+import Foundation
+import Capacitor
+
+@objc public class GetAdvertisingIdentifierResult: NSObject, Result {
+    let advertisingIdentifier: String?
+
+    init(advertisingIdentifier: String?) {
+        self.advertisingIdentifier = advertisingIdentifier
+    }
+
+    @objc public func toJSObject() -> AnyObject {
+        var result = JSObject()
+        result["advertisingIdentifier"] = advertisingIdentifier == nil ? NSNull() : advertisingIdentifier
+        return result as AnyObject
+    }
+}

package/ios/Plugin/Classes/Results/GetStatusResult.swift

@@ -0,0 +1,16 @@
+import Foundation
+import Capacitor
+
+@objc public class GetStatusResult: NSObject, Result {
+    let status: String
+
+    init(status: String) {
+        self.status = status
+    }
+
+    @objc public func toJSObject() -> AnyObject {
+        var result = JSObject()
+        result["status"] = status
+        return result as AnyObject
+    }
+}

package/ios/Plugin/Classes/Results/RequestPermissionResult.swift

@@ -0,0 +1,16 @@
+import Foundation
+import Capacitor
+
+@objc public class RequestPermissionResult: NSObject, Result {
+    let status: String
+
+    init(status: String) {
+        self.status = status
+    }
+
+    @objc public func toJSObject() -> AnyObject {
+        var result = JSObject()
+        result["status"] = status
+        return result as AnyObject
+    }
+}

package/ios/Plugin/Enums/CustomError.swift

@@ -0,0 +1,14 @@
+import Foundation
+
+public enum CustomError: Error {
+    case usageDescriptionMissing
+}
+
+extension CustomError: LocalizedError {
+    public var errorDescription: String? {
+        switch self {
+        case .usageDescriptionMissing:
+            return NSLocalizedString("NSUserTrackingUsageDescription key is missing in the Info.plist file.", comment: "usageDescriptionMissing")
+        }
+    }
+}

package/ios/Plugin/Info.plist

@@ -0,0 +1,24 @@
+<?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>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

package/ios/Plugin/Protocols/Result.swift

@@ -0,0 +1,5 @@
+import Capacitor
+
+@objc public protocol Result {
+    @objc func toJSObject() -> AnyObject
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@capawesome/capacitor-app-tracking-transparency",
+  "version": "0.0.1",
+  "description": "Capacitor plugin for the App Tracking Transparency framework.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Plugin/",
+    "CapawesomeCapacitorAppTrackingTransparency.podspec",
+    "Package.swift"
+  ],
+  "author": "Robin Genz <mail@robingenz.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/capawesome-team/capacitor-plugins.git"
+  },
+  "bugs": {
+    "url": "https://github.com/capawesome-team/capacitor-plugins/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/capawesome-team/"
+    },
+    {
+      "type": "opencollective",
+      "url": "https://opencollective.com/capawesome"
+    }
+  ],
+  "homepage": "https://capawesome.io/docs/plugins/app-tracking-transparency/",
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api AppTrackingTransparencyPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "ios:pod:install": "cd ios && pod install --repo-update && cd ..",
+    "ios:spm:install": "cd ios && swift package resolve && cd ..",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "8.0.0",
+    "@capacitor/cli": "8.0.0",
+    "@capacitor/core": "8.0.0",
+    "@capacitor/docgen": "0.3.1",
+    "@capacitor/ios": "8.0.0",
+    "@ionic/eslint-config": "0.4.0",
+    "eslint": "8.57.0",
+    "prettier-plugin-java": "2.6.7",
+    "rimraf": "6.1.2",
+    "rollup": "4.53.3",
+    "swiftlint": "2.0.0",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}