feat: updated package to play-age-range-declaration

Author: Gautham495

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,8 @@
 blank_issues_enabled: false
 contact_links:
   - name: Feature Request 💡
-    url: https://github.com/Gautham495/react-native-play-age-signals/discussions/new?category=ideas
+    url: https://github.com/Gautham495/react-native-play-age-range-declaration/discussions/new?category=ideas
     about: If you have a feature request, please create a new discussion on GitHub.
   - name: Discussions on GitHub 💬
-    url: https://github.com/Gautham495/react-native-play-age-signals/discussions
+    url: https://github.com/Gautham495/react-native-play-age-range-declaration/discussions
     about: If this library works as promised but you need help, please ask questions there.

CONTRIBUTING.md

@@ -25,9 +25,9 @@ The [example app](/example/) demonstrates usage of the library. You need to run
 
 It is configured to use the local version of the library, so any changes you make to the library's source code will be reflected in the example app. Changes to the library's JavaScript code will be reflected in the example app without a rebuild, but native code changes will require a rebuild of the example app.
 
-If you want to use Android Studio or Xcode to edit the native code, you can open the `example/android` or `example/ios` directories respectively in those editors. To edit the Objective-C or Swift files, open `example/ios/PlayAgeSignalsExample.xcworkspace` in Xcode and find the source files at `Pods > Development Pods > react-native-play-age-signals`.
+If you want to use Android Studio or Xcode to edit the native code, you can open the `example/android` or `example/ios` directories respectively in those editors. To edit the Objective-C or Swift files, open `example/ios/PlayAgeRangeDeclarationExample.xcworkspace` in Xcode and find the source files at `Pods > Development Pods > react-native-play-age-range-declaration`.
 
-To edit the Java or Kotlin files, open `example/android` in Android studio and find the source files at `react-native-play-age-signals` under `Android`.
+To edit the Java or Kotlin files, open `example/android` in Android studio and find the source files at `react-native-play-age-range-declaration` under `Android`.
 
 You can use various commands from the root directory to work with the project.
 
@@ -52,7 +52,7 @@ yarn example ios
 To confirm that the app is running with the new architecture, you can check the Metro logs for a message like this:
 
 ```sh
-Running "PlayAgeSignalsExample" with {"fabric":true,"initialProps":{"concurrentRoot":true},"rootTag":1}
+Running "PlayAgeRangeDeclarationExample" with {"fabric":true,"initialProps":{"concurrentRoot":true},"rootTag":1}
 ```
 
 Note the `"fabric":true` and `"concurrentRoot":true` properties.

README.md

@@ -1,160 +1,197 @@
 <a href="https://gauthamvijay.com">
   <picture>
-    <img alt="react-native-play-age-signals" src="./docs/img/banner.png" />
+    <img alt="react-native-play-age-range-declaration" src="./docs/img/banner.png" />
   </picture>
 </a>
 
-# react-native-play-age-signals
+# react-native-play-age-range-declaration
 
-A **React Native TurboModule** that provides a bridge to the **Google Play Age Signals API**, enabling Android apps to query **user supervision and age verification status** when available via Play Services.
+A **React Native TurboModule** providing a unified API for **age-appropriate experiences** on mobile — bridging:
 
-> [!IMPORTANT]
->
-> - The Play Age Signals SDK (`com.google.android.play:age-signals`) is currently in **beta** and **not yet fully implemented** by Google.
-> - Calling `checkAgeSignals()` will currently throw: java.lang.UnsupportedOperationException: Not yet implemented
-> - This library is ready and production-safe — it will begin returning real data **automatically** once Google enables the API in upcoming Play Services updates.
+* 🟢 **Google Play Age Signals API** (Android)
+* 🔵 **Apple Declared Age Range API** (iOS 26+)
 
 ---
 
 ## 📦 Installation
 
-```tsx
-npm install react-native-play-age-signals
+```bash
+npm install react-native-play-age-range-declaration
 ```
 
 ### 🚀 Zero Config Setup
 
-- **No manual native setup required.**
-  This library uses **React Native TurboModules**, so it works out of the box with autolinking — even inside **Expo apps (custom dev clients)**.
+* ✅ **Autolinking supported** (no manual native setup)
+* ✅ Works with **React Native New Architecture (TurboModules)**
+* ✅ Compatible with **Expo custom dev clients**
 
 ---
 
-## 🔗 Reference Links
+## 🧠 Overview
 
-- 📘 Google Developer Docs: [Play Age Signals](https://developer.android.com/google/play/age-signals/use-age-signals-api)
-- 🧾 Google Support: [Age-Appropriate Ads Requirements](https://support.google.com/googleplay/android-developer/answer/16569691)
+| Platform    | API Used                                                     | Purpose                                            |
+| ----------- | ------------------------------------------------------------ | -------------------------------------------------- |
+| **Android** | Play Age Signals API (`com.google.android.play:age-signals`) | Detect user supervision / verified status          |
+| **iOS**     | Declared Age Range API (`AgeRangeService.requestAgeRange`)   | Get user’s declared age range (e.g., 13-15, 16-17) |
 
 ---
 
-## 🇺🇸 Why this library exists
-
-This module was built for **production use** in my work app (US-based), where new **state-level legislation** requires mobile apps to verify the user’s age before displaying certain content or ads.
-
-To help other developers comply with these same laws, I’ve **open-sourced** it here.
+## ⚙️ Usage
 
-> The **Google Play Age Signals API** will be the official, privacy-safe method to determine user supervision and age verification status across Android devices in the United States.
+```tsx
+import { getAgeData } from 'react-native-play-age-range-declaration';
+import { useEffect } from 'react';
+import { Text, View } from 'react-native';
 
----
+export default function App() {
+  useEffect(() => {
+    (async () => {
+      try {
+        const result = await getAgeData([13, 16, 18]); // iOS uses gates, Android ignores
+        console.log('Age Signals:', result);
+      } catch (err) {
+        console.error('Failed to fetch Age Signals:', err);
+      }
+    })();
+  }, []);
 
-  <picture>
-    <img alt="Age Verification Bills in US States" src="./docs/img/bills-in-us.png" />
-  </picture>
+  return (
+    <View>
+      <Text>Check console for Play Age / Declared Range output</Text>
+    </View>
+  );
+}
+```
 
 ---
 
-## 🧠 What It Does
+## 📱 Platform Outputs
 
-Once the Play Services feature is live, the module will expose the following fields via `getPlayAgeSignals()`:
+### 🟢 **Android – Play Age Signals**
 
-```
+```json
 {
-  installId: string | null;
-  userStatus: string | null;
-  error?: string | null;
+  "installId": "abcd-1234-efgh-5678",
+  "userStatus": "SUPERVISED"
 }
 ```
 
-Example (future API result):
+### 🔵 **iOS – Declared Age Range**
 
-```
+```json
 {
-  "installId": "123e4567-e89b-12d3-a456-426614174000",
-  "userStatus": "VERIFIED"
+  "status": "sharing",
+  "lowerBound": 16,
+  "upperBound": 17
 }
 ```
 
 ---
 
-## ⚙️ Usage
+## 🧩 API Reference
 
-```
-import { getPlayAgeSignals } from 'react-native-play-age-signals';
-import { useEffect } from 'react';
-import { Text, View } from 'react-native';
+### `getPlayAgeSignals(ageGates?: number[])`
 
-export default function App() {
-  useEffect(() => {
-    const fetchSignals = async () => {
-      try {
-        const result = await getPlayAgeSignals();
-        console.log('Play Age Signals:', result);
-      } catch (error) {
-        console.error('Failed to fetch Play Age Signals:', error);
-      }
-    };
+**Returns:** `Promise<PlayAgeSignalsResult | DeclaredAgeRangeResult>`
 
-    fetchSignals();
-  }, []);
+#### Android (`PlayAgeSignalsResult`)
 
-  return (
-    <View>
-      <Text>Check your logs for Play Age Signals output</Text>
-    </View>
-  );
-}
-```
+| Field        | Type    | Description |                                          |
+| ------------ | ------- | ----------- | ---------------------------------------- |
+| `installId`  | `string | null`       | Install-specific identifier              |
+| `userStatus` | `string | null`       | `"SUPERVISED"`, `"VERIFIED"`, or similar |
+| `error`      | `string | null`       | Error message if API unavailable         |
+
+#### iOS (`DeclaredAgeRangeResult`)
+
+| Field        | Type                             | Description                         |                              |
+| ------------ | -------------------------------- | ----------------------------------- | ---------------------------- |
+| `status`     | `'sharing' \| 'declinedSharing'` | Whether the user shared their range |                              |
+| `lowerBound` | `number                          | null`                               | Minimum declared age         |
+| `upperBound` | `number                          | null`                               | Maximum declared age         |
+| `error`      | `string                          | null`                               | Error message if unavailable |
+
+---
+
+## 🧾 Real-World Use Case
+
+This module enables developers to comply with **state-level digital safety laws** and **age-appropriate content regulations** in the U.S.
+
+* Android → integrates with Play Age Signals (COPPA-compliant supervision data)
+* iOS → integrates with Declared Age Range API (WWDC 2025 privacy-preserving method)
+
+---
+
+## 🔗 Reference Links
+
+* 📘 [Play Age Signals – Android Developers](https://developer.android.com/google/play/age-signals/use-age-signals-api)
+* 📘 [Declared Age Range – Apple Developer](https://developer.apple.com/documentation/declaredagerange)
+* 🧾 [U.S. Age Appropriate Design Laws (Overview)](https://support.google.com/googleplay/android-developer/answer/16569691)
 
 ---
 
 ## 🧩 Supported Platforms
 
-| Platform                          | Status                                |
-| --------------------------------- | ------------------------------------- |
-| **Android**                       | ✅ Supported (pending SDK activation) |
-| **iOS**                           | 🚫 Not applicable (returns `null`)    |
-| **Expo (Custom Dev Client)**      | ✅ Works out of the box               |
-| **AOSP Emulator (no Play Store)** | ⚠️ Not supported                      |
+| Platform                     | Status                                 |
+| ---------------------------- | -------------------------------------- |
+| **Android**                  | ✅ Supported (SDK in beta)              |
+| **iOS 26+**                  | ✅ Supported (Declared Age Range)       |
+| **Expo (Custom Dev Client)** | ✅ Works out-of-the-box                 |
+| **AOSP Emulator**            | ⚠️ Not supported (requires Play Store) |
 
 ---
 
-## 🛠️ Under the Hood
+## 🧱 Under the Hood
 
-This library uses:
+### Android
 
-```
+Implemented in Kotlin using:
+
+```kotlin
 AgeSignalsManagerFactory.create(context)
   .checkAgeSignals(AgeSignalsRequest.builder().build())
 ```
 
-to connect to the Play Services API through a native Kotlin TurboModule and forward results to JavaScript with full error propagation and stack traces.
+wrapped via a React Native TurboModule with full promise-based error handling.
+
+### iOS
+
+Implemented in Swift + Objective-C++ using:
+
+```swift
+try await AgeRangeService.requestAgeRange(ageGates: [13, 16, 18])
+```
+
+and bridged through `RCT_EXPORT_MODULE()`.
 
 ---
 
 ## 📅 Roadmap
 
-- ✅ TurboModule bridge implementation
-- ✅ Error handling with full Java → JS stack propagation
-- 🚧 Awaiting Play Services rollout of working backend
-- 🔔 Auto-watch for new SDK versions via Dependabot and GitHub Actions
+* ✅ TurboModule bridge implementation (Android + iOS)
+* ✅ iOS Declared Age Range integration
+* ✅ TypeScript + Fabric compatibility
+* 🚧 Awaiting full rollout of Google Play Age Signals API
+* 🔔 Auto-update support for new SDK versions via GitHub Actions
 
 ---
 
 ## 🤝 Contributing
 
-Pull requests are welcome — especially once Google enables this API!
+Pull requests are welcome once both APIs are live!
 
-- [Development workflow](CONTRIBUTING.md#development-workflow)
-- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
-- [Code of conduct](CODE_OF_CONDUCT.md)
+* [Development Workflow](CONTRIBUTING.md#development-workflow)
+* [Sending a PR](CONTRIBUTING.md#sending-a-pull-request)
+* [Code of Conduct](CODE_OF_CONDUCT.md)
 
 ---
 
 ## 🪪 License
 
-MIT © [Gautham Vijayan](https://gauthamvijay.com)
+MIT © [**Gautham Vijayan**](https://gauthamvijay.com)
 
 ---
 
-Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)
+Made with [**create-react-native-library**](https://github.com/callstack/react-native-builder-bob)
 
 ---

android/build.gradle

@@ -1,6 +1,6 @@
 buildscript {
   ext.getExtOrDefault = {name ->
-    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['PlayAgeSignals_' + name]
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['PlayAgeRangeDeclaration_' + name]
   }
 
   repositories {
@@ -22,11 +22,11 @@ apply plugin: "kotlin-android"
 apply plugin: "com.facebook.react"
 
 def getExtOrIntegerDefault(name) {
-  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["PlayAgeSignals_" + name]).toInteger()
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["PlayAgeRangeDeclaration_" + name]).toInteger()
 }
 
 android {
-  namespace "com.gautham.playagesignals"
+  namespace "com.gautham.playagerangedeclaration"
 
   compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 

android/gradle.properties

@@ -1,5 +1,5 @@
-PlayAgeSignals_kotlinVersion=2.0.21
-PlayAgeSignals_minSdkVersion=24
-PlayAgeSignals_targetSdkVersion=34
-PlayAgeSignals_compileSdkVersion=35
-PlayAgeSignals_ndkVersion=27.1.12297006
+PlayAgeRangeDeclaration_kotlinVersion=2.0.21
+PlayAgeRangeDeclaration_minSdkVersion=24
+PlayAgeRangeDeclaration_targetSdkVersion=34
+PlayAgeRangeDeclaration_compileSdkVersion=35
+PlayAgeRangeDeclaration_ndkVersion=27.1.12297006

android/src/main/java/com/playagesignals/PlayAgeSignalsModule.kt renamed to android/src/main/java/com/playagerangedeclaration/PlayAgeRangeDeclarationModule.kt

@@ -1,4 +1,4 @@
-package com.gautham.playagesignals
+package com.gautham.playagerangedeclaration
 
 import android.util.Log
 import com.facebook.react.bridge.Arguments
@@ -11,21 +11,21 @@ import com.facebook.react.module.annotations.ReactModule
 import com.google.android.play.agesignals.AgeSignalsManagerFactory
 import com.google.android.play.agesignals.AgeSignalsRequest
 
-@ReactModule(name = PlayAgeSignalsModule.NAME)
-class PlayAgeSignalsModule(
+@ReactModule(name = PlayAgeRangeDeclarationModule.NAME)
+class PlayAgeRangeDeclarationModule(
   private val reactContext: ReactApplicationContext
 ) : NativeModule, TurboModule {
 
   companion object {
-    const val NAME = "PlayAgeSignals"
+    const val NAME = "PlayAgeRangeDeclaration"
   }
 
   override fun getName(): String = NAME
   override fun initialize() {}
   override fun invalidate() {}
 
   @ReactMethod
-  fun getPlayAgeSignals(promise: Promise) {
+  fun getPlayAgeRangeDeclaration(promise: Promise) {
     try {
       val manager = AgeSignalsManagerFactory.create(reactContext.applicationContext)
       val request = AgeSignalsRequest.builder().build()
@@ -40,7 +40,7 @@ class PlayAgeSignalsModule(
         }
         .addOnFailureListener { e ->
           val msg = e.message ?: "Unknown error"
-          Log.e("PlayAgeSignals", "Failed to fetch Age Signals: $msg", e)
+          Log.e("PlayAgeRangeDeclaration", "Failed to fetch Age Signals: $msg", e)
 
           // Reject so JS sees the *real* native exception
           promise.reject(
@@ -51,7 +51,7 @@ class PlayAgeSignalsModule(
         }
 
     } catch (e: Exception) {
-      Log.e("PlayAgeSignals", "Initialization error", e)
+      Log.e("PlayAgeRangeDeclaration", "Initialization error", e)
       promise.reject("AGE_SIGNALS_INIT_ERROR", e.message, e)
     }
   }