SDK documentation

1pluginManagement {
2    repositories {
3        google()
4        mavenCentral()
5        gradlePluginPortal()
6    }
7}
8 
9dependencyResolutionManagement {
10    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
11    repositories {
12        google()
13        mavenCentral() // the demo SDK would be published here
14    }
15}
16 
17rootProject.name = "AnumatiDemoApp"
18include(":app")

1plugins {
2    id("com.android.application") version "8.7.3" apply false
3    id("org.jetbrains.kotlin.android") version "2.1.0" apply false
4    id("org.jetbrains.kotlin.plugin.compose") version "2.1.0" apply false
5}

1plugins {
2    id("com.android.application")
3    id("org.jetbrains.kotlin.android")
4    id("org.jetbrains.kotlin.plugin.compose")
5}
6 
7android {
8    namespace = "com.example.anumatidemo"
9    compileSdk = 35
10 
11    defaultConfig {
12        applicationId = "com.example.anumatidemo"
13        minSdk = 24
14        targetSdk = 35
15        versionCode = 1
16        versionName = "1.0"
17 
18        // Demo values. In a real app, inject these per build type or flavor from CI —
19        // never hard-code production values in source.
20        buildConfigField("String", "ANUMATI_SITE_KEY", "\"demo-site-key-123\"")
21        buildConfigField("String", "ANUMATI_APPLICATION_ID", "\"demo-mobile-app-123\"")
22    }
23 
24    buildTypes {
25        release {
26            isMinifyEnabled = true
27            proguardFiles(
28                getDefaultProguardFile("proguard-android-optimize.txt"),
29                "proguard-rules.pro",
30            )
31        }
32    }
33 
34    buildFeatures {
35        compose = true
36        buildConfig = true
37    }
38}
39 
40kotlin {
41    jvmToolchain(17)
42}
43 
44dependencies {
45    // DEMO / FICTIONAL SDK coordinates
46    implementation("com.digitalanumati:consent-sdk:1.0.0")
47 
48    implementation(platform("androidx.compose:compose-bom:2024.12.01"))
49    implementation("androidx.compose.ui:ui")
50    implementation("androidx.compose.material3:material3")
51    implementation("androidx.activity:activity-compose:1.9.3")
52    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.7")
53}

1<?xml version="1.0" encoding="utf-8"?>
2<manifest xmlns:android="http://schemas.android.com/apk/res/android">
3 
4    <!-- The SDK syncs consent with the Digital Anumati service over HTTPS. -->
5    <uses-permission android:name="android.permission.INTERNET" />
6 
7    <application
8        android:name=".AnumatiDemoApplication"
9        android:label="AnumatiDemoApp"
10        android:theme="@android:style/Theme.Material.Light.NoActionBar">
11 
12        <activity
13            android:name=".MainActivity"
14            android:exported="true">
15            <intent-filter>
16                <action android:name="android.intent.action.MAIN" />
17                <category android:name="android.intent.category.LAUNCHER" />
18            </intent-filter>
19        </activity>
20    </application>
21</manifest>

1package com.example.anumatidemo
2 
3import android.app.Application
4import android.util.Log
5import com.digitalanumati.consent.ConsentError
6import com.digitalanumati.consent.DigitalAnumati
7import com.digitalanumati.consent.Environment
8 
9class AnumatiDemoApplication : Application() {
10 
11    override fun onCreate() {
12        super.onCreate()
13        try {
14            DigitalAnumati.initialize(
15                context = applicationContext,
16                siteKey = BuildConfig.ANUMATI_SITE_KEY,
17                applicationId = BuildConfig.ANUMATI_APPLICATION_ID,
18                environment = if (BuildConfig.DEBUG) Environment.UAT else Environment.PRODUCTION,
19            )
20        } catch (error: ConsentError) {
21            // Keep the app usable. Consent actions stay disabled until initialization succeeds.
22            Log.w(TAG, "Consent SDK failed to initialize: " + error.message)
23        }
24    }
25 
26    private companion object {
27        const val TAG = "AnumatiDemo"
28    }
29}

1package com.example.anumatidemo
2 
3import android.os.Bundle
4import androidx.activity.ComponentActivity
5import androidx.activity.compose.setContent
6import androidx.compose.foundation.layout.Arrangement
7import androidx.compose.foundation.layout.Column
8import androidx.compose.foundation.layout.fillMaxSize
9import androidx.compose.foundation.layout.padding
10import androidx.compose.material3.Button
11import androidx.compose.material3.MaterialTheme
12import androidx.compose.material3.OutlinedButton
13import androidx.compose.material3.Scaffold
14import androidx.compose.material3.Text
15import androidx.compose.runtime.Composable
16import androidx.compose.runtime.getValue
17import androidx.compose.runtime.mutableStateOf
18import androidx.compose.runtime.setValue
19import androidx.compose.ui.Modifier
20import androidx.compose.ui.unit.dp
21import androidx.lifecycle.lifecycleScope
22import com.digitalanumati.consent.ConsentError
23import com.digitalanumati.consent.ConsentErrorCode
24import com.digitalanumati.consent.ConsentListener
25import com.digitalanumati.consent.ConsentResult
26import com.digitalanumati.consent.ConsentStatus
27import com.digitalanumati.consent.DigitalAnumati
28import kotlinx.coroutines.launch
29 
30class MainActivity : ComponentActivity() {
31 
32    private var consentStatus by mutableStateOf(ConsentStatus.NOT_DETERMINED)
33    private var errorMessage by mutableStateOf<String?>(null)
34 
35    override fun onCreate(savedInstanceState: Bundle?) {
36        super.onCreate(savedInstanceState)
37 
38        if (DigitalAnumati.isInitialized()) {
39            consentStatus = DigitalAnumati.getConsentStatus()
40            // First launch (or after a revoke): ask before continuing.
41            if (consentStatus == ConsentStatus.NOT_DETERMINED) showConsent()
42        }
43 
44        setContent {
45            MaterialTheme {
46                HomeScreen(
47                    sdkReady = DigitalAnumati.isInitialized(),
48                    status = consentStatus,
49                    error = errorMessage,
50                    onManageConsent = ::showConsent,
51                    onRevokeConsent = ::revokeConsent,
52                )
53            }
54        }
55    }
56 
57    private fun showConsent() {
58        DigitalAnumati.showConsent(
59            activity = this,
60            listener = object : ConsentListener {
61                override fun onConsentCompleted(result: ConsentResult) {
62                    consentStatus = result.status
63                    errorMessage = null
64                }
65 
66                override fun onError(error: ConsentError) {
67                    errorMessage = when (error.code) {
68                        ConsentErrorCode.USER_CANCELLED -> null // closed without choosing; keep the previous state
69                        ConsentErrorCode.NETWORK_ERROR -> "Couldn't reach the consent service. Check your connection and try again."
70                        else -> error.message
71                    }
72                }
73            },
74        )
75    }
76 
77    private fun revokeConsent() {
78        lifecycleScope.launch {
79            try {
80                DigitalAnumati.revokeConsent()
81                consentStatus = DigitalAnumati.getConsentStatus() // NOT_DETERMINED after a revoke
82                errorMessage = null
83            } catch (error: ConsentError) {
84                errorMessage = error.message
85            }
86        }
87    }
88}
89 
90@Composable
91fun HomeScreen(
92    sdkReady: Boolean,
93    status: ConsentStatus,
94    error: String?,
95    onManageConsent: () -> Unit,
96    onRevokeConsent: () -> Unit,
97) {
98    Scaffold { innerPadding ->
99        Column(
100            modifier = Modifier
101                .padding(innerPadding)
102                .padding(24.dp)
103                .fillMaxSize(),
104            verticalArrangement = Arrangement.spacedBy(16.dp),
105        ) {
106            Text("AnumatiDemoApp", style = MaterialTheme.typography.headlineMedium)
107            Text("SDK initialized: " + if (sdkReady) "Yes" else "No")
108            Text("Consent status: " + status.name)
109            if (error != null) {
110                Text(error, color = MaterialTheme.colorScheme.error)
111            }
112            Button(onClick = onManageConsent, enabled = sdkReady) {
113                Text("Manage Consent")
114            }
115            OutlinedButton(
116                onClick = onRevokeConsent,
117                enabled = sdkReady && status != ConsentStatus.NOT_DETERMINED,
118            ) {
119                Text("Revoke Consent")
120            }
121        }
122    }
123}

1# app/proguard-rules.pro
2# A real SDK normally ships these as consumer rules inside its AAR; they're shown
3# here so release (R8) builds of the demo keep the SDK's public API intact.
4-keep class com.digitalanumati.consent.** { *; }
5-keepclassmembers enum com.digitalanumati.consent.** { *; }
6-dontwarn com.digitalanumati.consent.**

1// Public types exposed by the DEMO SDK (package com.digitalanumati.consent).
2// Shown for reference — you don't write these; they ship inside the SDK.
3// The Flutter plugin and React Native module call exactly this API.
4package com.digitalanumati.consent
5 
6enum class Environment { UAT, PRODUCTION }
7 
8enum class ConsentStatus {
9    NOT_DETERMINED, // the user hasn't answered yet (or consent was revoked)
10    GRANTED,        // every optional category accepted
11    DENIED,         // every optional category rejected
12    PARTIAL,        // some optional categories accepted
13}
14 
15enum class ConsentCategory { NECESSARY, ANALYTICS, PERSONALIZATION, ADVERTISING }
16 
17data class ConsentPreferences(
18    val analytics: Boolean = false,
19    val personalization: Boolean = false,
20    val advertising: Boolean = false,
21) {
22    val necessary: Boolean get() = true // always on; not user-editable
23}
24 
25data class ConsentResult(
26    val status: ConsentStatus,
27    val preferences: ConsentPreferences,
28    val timestamp: Long, // epoch millis
29)
30 
31enum class ConsentErrorCode {
32    INITIALIZATION_FAILED, // initialize() failed, or a call was made before initialize()
33    INVALID_CONFIGURATION,
34    INVALID_SITE_KEY,
35    INVALID_APPLICATION_ID,
36    NETWORK_ERROR,
37    CONSENT_LOAD_FAILED,
38    CONSENT_SAVE_FAILED,
39    USER_CANCELLED,
40    UNKNOWN_ERROR,
41}
42 
43class ConsentError(
44    val code: ConsentErrorCode,
45    message: String,
46    cause: Throwable? = null,
47) : Exception(message, cause)
48 
49interface ConsentListener {
50    fun onConsentCompleted(result: ConsentResult)
51    fun onError(error: ConsentError)
52}
53 
54enum class ConsentEventType {
55    SDK_INITIALIZED, CONSENT_SHOWN, CONSENT_ACCEPTED, CONSENT_REJECTED,
56    CONSENT_UPDATED, CONSENT_REVOKED, CONSENT_ERROR,
57}
58 
59data class ConsentEvent(
60    val type: ConsentEventType,
61    val result: ConsentResult? = null, // set for ACCEPTED, REJECTED and UPDATED
62    val error: ConsentError? = null,   // set for CONSENT_ERROR
63)
64 
65object DigitalAnumati {
66    // Throws ConsentError: INVALID_CONFIGURATION, INVALID_SITE_KEY, INVALID_APPLICATION_ID, INITIALIZATION_FAILED
67    fun initialize(context: Context, siteKey: String, applicationId: String, environment: Environment)
68    fun isInitialized(): Boolean
69 
70    // Presents the SDK-owned consent screen; the result or error arrives through the listener.
71    fun showConsent(activity: Activity, listener: ConsentListener)
72 
73    fun getConsentStatus(): ConsentStatus           // reads local storage, no network call
74    fun getConsentPreferences(): ConsentPreferences // reads local storage, no network call
75    suspend fun updateConsent(preferences: ConsentPreferences): ConsentResult
76    suspend fun revokeConsent()
77 
78    // One listener; events are delivered on the main thread.
79    fun setEventListener(listener: ((ConsentEvent) -> Unit)?)
80}

1AnumatiDemoApp/
2├── app/
3│   ├── src/main/
4│   │   ├── java/com/example/anumatidemo/
5│   │   │   ├── AnumatiDemoApplication.kt   # SDK initialization
6│   │   │   └── MainActivity.kt             # Home screen, consent status, manage / revoke
7│   │   └── AndroidManifest.xml
8│   ├── build.gradle.kts                    # SDK dependency + BuildConfig values
9│   └── proguard-rules.pro
10├── build.gradle.kts
11└── settings.gradle.kts

1if (DigitalAnumati.isInitialized() &&
2    DigitalAnumati.getConsentStatus() == ConsentStatus.NOT_DETERMINED) {
3    DigitalAnumati.showConsent(activity = this, listener = consentListener)
4}

1// swift-tools-version:5.9
2// Package.swift — for teams that keep app code in a local Swift package.
3// Most apps instead add the SDK in Xcode (see "Swift Package Manager in Xcode").
4import PackageDescription
5 
6let package = Package(
7    name: "AnumatiDemoApp",
8    platforms: [.iOS(.v15)],
9    products: [
10        .library(name: "AnumatiDemoApp", targets: ["AnumatiDemoApp"]),
11    ],
12    dependencies: [
13        // DEMO / FICTIONAL package URL
14        .package(url: "https://github.com/example/digital-anumati-ios-sdk", from: "1.0.0"),
15    ],
16    targets: [
17        .target(
18            name: "AnumatiDemoApp",
19            dependencies: [
20                .product(name: "DigitalAnumatiConsent", package: "digital-anumati-ios-sdk"),
21            ],
22            path: "AnumatiDemoApp"
23        ),
24    ]
25)

1# Podfile — optional, if your project uses CocoaPods instead of SPM
2platform :ios, '15.0'
3 
4target 'AnumatiDemoApp' do
5  use_frameworks!
6 
7  # DEMO / FICTIONAL pod
8  pod 'DigitalAnumatiConsent', '~> 1.0'
9end

1// Config/UAT.xcconfig — one file per environment, selected by build configuration.
2// Keep production values out of source control; inject them from CI.
3ANUMATI_SITE_KEY = demo-site-key-123
4ANUMATI_APPLICATION_ID = demo-mobile-app-123
5ANUMATI_ENVIRONMENT = uat

1<!-- Info.plist — values come from the active .xcconfig -->
2<key>DigitalAnumatiSiteKey</key>
3<string>$(ANUMATI_SITE_KEY)</string>
4<key>DigitalAnumatiApplicationId</key>
5<string>$(ANUMATI_APPLICATION_ID)</string>
6<key>DigitalAnumatiEnvironment</key>
7<string>$(ANUMATI_ENVIRONMENT)</string>

1// AnumatiDemoApp/Models/SDKConfiguration.swift
2import Foundation
3import DigitalAnumatiConsent
4 
5struct SDKConfiguration {
6    let siteKey: String
7    let applicationId: String
8    let environment: DigitalAnumati.Environment
9 
10    enum ConfigurationError: LocalizedError {
11        case missingKey(String)
12 
13        var errorDescription: String? {
14            switch self {
15            case .missingKey(let key): return "Missing \(key) in Info.plist."
16            }
17        }
18    }
19 
20    static func fromInfoPlist(_ bundle: Bundle = .main) throws -> SDKConfiguration {
21        func value(_ key: String) throws -> String {
22            guard let value = bundle.object(forInfoDictionaryKey: key) as? String, !value.isEmpty else {
23                throw ConfigurationError.missingKey(key)
24            }
25            return value
26        }
27 
28        return SDKConfiguration(
29            siteKey: try value("DigitalAnumatiSiteKey"),
30            applicationId: try value("DigitalAnumatiApplicationId"),
31            environment: try value("DigitalAnumatiEnvironment") == "production" ? .production : .uat
32        )
33    }
34}

1// AnumatiDemoApp/App/AnumatiDemoApp.swift
2import SwiftUI
3 
4@main
5struct AnumatiDemoApp: App {
6    // Creating the service initializes the SDK once, at launch.
7    @StateObject private var consent = ConsentService()
8 
9    var body: some Scene {
10        WindowGroup {
11            HomeView()
12                .environmentObject(consent)
13        }
14    }
15}

1// AnumatiDemoApp/Services/ConsentService.swift
2import UIKit
3import DigitalAnumatiConsent
4 
5@MainActor
6final class ConsentService: ObservableObject {
7    @Published private(set) var isInitialized = false
8    @Published private(set) var status: ConsentStatus = .notDetermined
9    @Published var errorMessage: String?
10 
11    init() {
12        do {
13            let config = try SDKConfiguration.fromInfoPlist()
14            try DigitalAnumati.initialize(
15                siteKey: config.siteKey,
16                applicationId: config.applicationId,
17                environment: config.environment
18            )
19            isInitialized = true
20            status = DigitalAnumati.getConsentStatus()
21        } catch {
22            // Keep the app usable. Consent actions stay disabled until initialization succeeds.
23            errorMessage = "Consent SDK failed to initialize: \(error.localizedDescription)"
24        }
25    }
26 
27    /// Presents the SDK's consent screen and records the result.
28    func showConsent() async {
29        guard let presenter = UIApplication.shared.topViewController else { return }
30        do {
31            let result = try await DigitalAnumati.showConsent(from: presenter)
32            status = result.status
33            errorMessage = nil
34        } catch let error as ConsentError where error.code == .userCancelled {
35            // Closed without choosing; keep the previous state.
36        } catch {
37            errorMessage = message(for: error)
38        }
39    }
40 
41    func revokeConsent() async {
42        do {
43            try await DigitalAnumati.revokeConsent()
44            status = DigitalAnumati.getConsentStatus() // .notDetermined after a revoke
45            errorMessage = nil
46        } catch {
47            errorMessage = message(for: error)
48        }
49    }
50 
51    private func message(for error: Error) -> String {
52        switch (error as? ConsentError)?.code {
53        case .networkError?:
54            return "Couldn't reach the consent service. Check your connection and try again."
55        case .initializationFailed?:
56            return "The consent SDK isn't initialized."
57        default:
58            return error.localizedDescription
59        }
60    }
61}

1// AnumatiDemoApp/Services/UIApplication+TopViewController.swift
2import UIKit
3 
4extension UIApplication {
5    /// The view controller currently on screen — used to present the SDK's consent screen from SwiftUI.
6    var topViewController: UIViewController? {
7        let scene = connectedScenes
8            .compactMap { $0 as? UIWindowScene }
9            .first { $0.activationState == .foregroundActive }
10        var top = scene?.windows.first { $0.isKeyWindow }?.rootViewController
11        while let presented = top?.presentedViewController {
12            top = presented
13        }
14        return top
15    }
16}

1// AnumatiDemoApp/Views/HomeView.swift
2import SwiftUI
3import DigitalAnumatiConsent
4 
5struct HomeView: View {
6    @EnvironmentObject private var consent: ConsentService
7 
8    var body: some View {
9        NavigationView {
10            List {
11                Section("SDK") {
12                    row("Initialized", consent.isInitialized ? "Yes" : "No")
13                    row("Consent status", consent.status.rawValue)
14                }
15 
16                if let message = consent.errorMessage {
17                    Section {
18                        Text(message).foregroundStyle(.red)
19                    }
20                }
21 
22                Section {
23                    Button("Manage Consent") {
24                        Task { await consent.showConsent() }
25                    }
26                    Button("Revoke Consent", role: .destructive) {
27                        Task { await consent.revokeConsent() }
28                    }
29                    .disabled(consent.status == .notDetermined)
30                }
31                .disabled(!consent.isInitialized)
32            }
33            .navigationTitle("AnumatiDemoApp")
34            .task {
35                // First launch (or after a revoke): ask before continuing.
36                if consent.isInitialized && consent.status == .notDetermined {
37                    await consent.showConsent()
38                }
39            }
40        }
41    }
42 
43    private func row(_ title: String, _ value: String) -> some View {
44        HStack {
45            Text(title)
46            Spacer()
47            Text(value).foregroundStyle(.secondary)
48        }
49    }
50}

1// UIKit — completion-handler API
2import UIKit
3import DigitalAnumatiConsent
4 
5final class PrivacySettingsViewController: UIViewController {
6    private let statusLabel = UILabel()
7 
8    override func viewDidLoad() {
9        super.viewDidLoad()
10        view.backgroundColor = .systemBackground
11 
12        let manageButton = UIButton(type: .system)
13        manageButton.setTitle("Manage Consent", for: .normal)
14        manageButton.addTarget(self, action: #selector(manageConsent), for: .touchUpInside)
15 
16        let stack = UIStackView(arrangedSubviews: [statusLabel, manageButton])
17        stack.axis = .vertical
18        stack.spacing = 16
19        stack.translatesAutoresizingMaskIntoConstraints = false
20        view.addSubview(stack)
21        NSLayoutConstraint.activate([
22            stack.centerXAnchor.constraint(equalTo: view.centerXAnchor),
23            stack.centerYAnchor.constraint(equalTo: view.centerYAnchor),
24        ])
25 
26        statusLabel.text = "Consent status: \(DigitalAnumati.getConsentStatus().rawValue)"
27    }
28 
29    @objc private func manageConsent() {
30        DigitalAnumati.showConsent(from: self) { [weak self] result in
31            switch result {
32            case .success(let consent):
33                self?.statusLabel.text = "Consent status: \(consent.status.rawValue)"
34            case .failure(let error) where error.code == .userCancelled:
35                break // closed without choosing
36            case .failure(let error):
37                self?.statusLabel.text = "Couldn't update consent: \(error.message)"
38            }
39        }
40    }
41}

1// Public types exposed by the DEMO SDK (module DigitalAnumatiConsent).
2// Shown for reference — you don't write these; they ship inside the SDK.
3// The Flutter plugin and React Native module call exactly this API.
4import UIKit
5 
6public enum ConsentStatus: String {
7    case notDetermined = "NOT_DETERMINED" // no answer yet (or consent was revoked)
8    case granted = "GRANTED"              // every optional category accepted
9    case denied = "DENIED"                // every optional category rejected
10    case partial = "PARTIAL"              // some optional categories accepted
11}
12 
13public enum ConsentCategory: String, CaseIterable {
14    case necessary = "NECESSARY", analytics = "ANALYTICS"
15    case personalization = "PERSONALIZATION", advertising = "ADVERTISING"
16}
17 
18public struct ConsentPreferences: Equatable {
19    public var necessary: Bool { true } // always on; not user-editable
20    public var analytics: Bool
21    public var personalization: Bool
22    public var advertising: Bool
23 
24    public init(analytics: Bool = false, personalization: Bool = false, advertising: Bool = false)
25}
26 
27public struct ConsentResult {
28    public let status: ConsentStatus
29    public let preferences: ConsentPreferences
30    public let timestamp: Date
31}
32 
33public struct ConsentError: LocalizedError {
34    public enum Code: String {
35        case initializationFailed = "INITIALIZATION_FAILED" // also: called before initialize()
36        case invalidConfiguration = "INVALID_CONFIGURATION"
37        case invalidSiteKey = "INVALID_SITE_KEY"
38        case invalidApplicationId = "INVALID_APPLICATION_ID"
39        case networkError = "NETWORK_ERROR"
40        case consentLoadFailed = "CONSENT_LOAD_FAILED"
41        case consentSaveFailed = "CONSENT_SAVE_FAILED"
42        case userCancelled = "USER_CANCELLED"
43        case unknownError = "UNKNOWN_ERROR"
44    }
45 
46    public let code: Code
47    public let message: String
48    public var errorDescription: String? { message }
49}
50 
51public enum ConsentEventType: String {
52    case sdkInitialized = "SDK_INITIALIZED", consentShown = "CONSENT_SHOWN"
53    case consentAccepted = "CONSENT_ACCEPTED", consentRejected = "CONSENT_REJECTED"
54    case consentUpdated = "CONSENT_UPDATED", consentRevoked = "CONSENT_REVOKED"
55    case consentError = "CONSENT_ERROR"
56}
57 
58public struct ConsentEvent {
59    public let type: ConsentEventType
60    public let result: ConsentResult? // set for accepted, rejected and updated
61    public let error: ConsentError?   // set for consentError
62}
63 
64public enum DigitalAnumati {
65    // Nested so it doesn't clash with SwiftUI's @Environment property wrapper.
66    public enum Environment { case uat, production }
67 
68    // Throws ConsentError: invalidConfiguration, invalidSiteKey, invalidApplicationId, initializationFailed
69    public static func initialize(siteKey: String, applicationId: String, environment: Environment) throws
70    public static var isInitialized: Bool { get }
71 
72    // Presents the SDK-owned consent screen.
73    @MainActor
74    public static func showConsent(
75        from viewController: UIViewController,
76        completion: @escaping (Result<ConsentResult, ConsentError>) -> Void
77    )
78    @MainActor
79    public static func showConsent(from viewController: UIViewController) async throws -> ConsentResult
80 
81    public static func getConsentStatus() -> ConsentStatus           // local storage, no network call
82    public static func getConsentPreferences() -> ConsentPreferences // local storage, no network call
83    public static func updateConsent(_ preferences: ConsentPreferences) async throws -> ConsentResult
84    public static func revokeConsent() async throws
85 
86    // One handler; events are delivered on the main thread.
87    public static func setEventHandler(_ handler: ((ConsentEvent) -> Void)?)
88}

1AnumatiDemoApp/
2├── AnumatiDemoApp/
3│   ├── App/
4│   │   └── AnumatiDemoApp.swift                  # @main, creates ConsentService
5│   ├── Views/
6│   │   ├── HomeView.swift                        # status, Manage / Revoke buttons
7│   │   └── PrivacySettingsViewController.swift   # UIKit example
8│   ├── Services/
9│   │   ├── ConsentService.swift                  # SDK init, show / revoke, errors
10│   │   └── UIApplication+TopViewController.swift
11│   ├── Models/
12│   │   └── SDKConfiguration.swift                # reads Info.plist values
13│   └── Info.plist
14├── Config/
15│   ├── UAT.xcconfig
16│   └── Production.xcconfig
17└── Package.swift

1if DigitalAnumati.getConsentStatus() == .notDetermined {
2    let result = try await DigitalAnumati.showConsent(from: viewController)
3    print("Consent status: \(result.status)")
4}

1                         Consent Backend
2                               |
3                +--------------+--------------+
4                |                             |
5        Android Native SDK             iOS Native SDK
6     (consent logic, storage,      (consent logic, storage,
7      consent UI, networking)       consent UI, networking)
8                |                             |
9        +-------+-------+             +-------+-------+
10        |               |             |               |
11     Flutter      React Native     Flutter      React Native
12     plugin       native module    plugin       native module
13    (Kotlin)        (Kotlin)       (Swift)        (Swift)
14        |               |             |               |
15        +-------+-------+-------------+-------+-------+
16                |                             |
17          Dart API (Flutter)        TypeScript API (React Native)
18                |                             |
19                +--------- Host application --+

1Application starts
2        ↓
3SDK initialization
4        ↓
5Check existing consent  (getConsentStatus)
6        ↓
7If consent exists ──────────────→ Continue application
8        ↓
9If consent does not exist
10        ↓
11Display consent UI  (showConsent)
12        ↓
13User selects preferences
14        ↓
15SDK stores consent
16        ↓
17Return ConsentResult
18        ↓
19Application continues