@symbiote-native/age-range 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+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,140 @@
+# @symbiote-native/age-range
+
+Show age-appropriate content, or meet an age-assurance law, without collecting a birth date
+yourself: ask the platform. One API for every [SymbioteNative](../../README.md) adapter (React,
+Vue, Svelte, Solid and Angular).
+
+It wraps [`expo-age-range`](https://github.com/expo/expo/tree/main/packages/expo-age-range)
+(Apple's Declared Age Range API on iOS 26+, and Google Play's Age Signals). Like
+[`@symbiote-native/application`](../application), everything here is a one-shot async call (or a
+single sync setter) with no per-instance state, so there is no hook, composable or service to wrap:
+every adapter entry point is a plain re-export of the same `core`.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --age-range
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --age-range
+```
+
+Either way: installs `@symbiote-native/age-range` and wires the native autolinking automatically,
+see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI, wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/age-range
+```
+
+`expo-age-range` and `expo-modules-core` come along as regular dependencies, pinned to exact
+versions. Never install either yourself, and never add the `expo` meta-package to your project
+(it bundles its own Metro/Babel pipeline, which conflicts with this project's own).
+
+## Required one-time step: native autolinking wiring
+
+Unlike a plain RN native module, `expo-age-range`'s native code is discovered by
+`expo-modules-autolinking`, not RN's own `react-native.config.cjs` mechanism. This needs wiring
+into the native host app **once**, covering this package and every other `expo-modules-core`
+package with zero further changes:
+
+| Platform | Touches                                                                                                                                        |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| iOS      | `ios/Podfile`, add `use_expo_modules!`                                                                                                           |
+| iOS      | `AppDelegate.swift`, Expo's runtime-bootstrap hook                                                                                                |
+| Android  | `settings.gradle` / `app/build.gradle`, resolve and include the Expo Gradle projects                                                              |
+| Android  | `MainApplication.kt`, Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
+
+Full mechanics live in the `symbiote-expo-native-module` project skill. Reference
+implementation: `examples/expo-react/ios/Podfile` and
+`examples/expo-react/android/app/src/main/java/com/canaryexpo/MainApplication.kt`.
+
+No app-level permission strings are needed. Apple's age-range prompt and Google Play's Age
+Signals consent screen are both system UI, carrying no `Info.plist`/manifest entry of their own.
+
+**iOS needs one entitlement, added by hand.** Build with Xcode 26 or later and add
+`com.apple.developer.declared-age-range` (`<true/>`) to your app's `.entitlements` file.
+`native-link.json` does not generate it.
+
+</details>
+
+## Shape
+
+```
+src/core/     requestAgeRangeAsync / isEligibleForAgeFeaturesAsync /
+              showSignificantUpdateAcknowledgmentAsync / getRequiredRegulatoryFeaturesAsync /
+              requestAgeSignalsAccessAsync / setFakeAgeSignals, plus IAgeRangeRequest /
+              IAgeRangeResponse / IAgeSignalsStatus / IFakeAgeSignals / IAgeRangeRegulatoryFeature.
+              native-module.ts resolves the native module via expo-modules-core's
+              requireNativeModule.
+src/angular/  @symbiote-native/age-range/angular, export * from '../core'
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto `src/core/`,
+no physical per-framework file, since there's nothing to subscribe to or clean up. `./angular`
+stays a physical file/subpath since Angular ships through a separate `ngc`/AOT build (`build-ngc/`).
+
+## API
+
+```ts
+requestAgeRangeAsync(options: IAgeRangeRequest): Promise<IAgeRangeResponse>
+isEligibleForAgeFeaturesAsync(): Promise<boolean | null>
+
+showSignificantUpdateAcknowledgmentAsync(updateDescription: string): Promise<void> // ios 26.4+, no-op elsewhere
+getRequiredRegulatoryFeaturesAsync(): Promise<IAgeRangeRegulatoryFeature[] | null> // ios 26.4+, null elsewhere
+
+requestAgeSignalsAccessAsync(): Promise<IAgeSignalsStatus | null> // android only, null elsewhere
+setFakeAgeSignals(fake: IFakeAgeSignals | null): void // android only, no-op elsewhere
+```
+
+```ts
+import {
+  requestAgeRangeAsync,
+  isEligibleForAgeFeaturesAsync,
+} from '@symbiote-native/age-range';
+// or the framework-scoped entry points, identical surface, re-exported verbatim:
+import { requestAgeRangeAsync } from '@symbiote-native/age-range/react';
+import { requestAgeRangeAsync } from '@symbiote-native/age-range/vue';
+import { requestAgeRangeAsync } from '@symbiote-native/age-range/angular';
+```
+
+## Notes
+
+- **Recommended pattern**: call `isEligibleForAgeFeaturesAsync`/`getRequiredRegulatoryFeaturesAsync`
+  first and only prompt with `requestAgeRangeAsync` when the result says the user actually needs
+  it. Both resolve `null` where the OS can't answer (iOS below 26.2/26.4, Android, web), and
+  `null` means "unknown", never "not required".
+- On Android, `requestAgeSignalsAccessAsync` must resolve `'SHARED'` before `requestAgeRangeAsync`
+  reports anything besides `null` fields. Play Age Signals requires the separate consent screen
+  first, unlike iOS where the consent is folded into `requestAgeRangeAsync` itself.
+- `setFakeAgeSignals` only works in a debuggable build. The native side throws otherwise unless
+  the argument is `null` (which always goes back to real signals).
+- **Test on a real device.** Simulators and emulators may not behave as expected; the canary
+  `AgeRangeScreen` in the `examples/expo-*` apps exercises every call.
+
+## Common questions
+
+- **iOS `IOS_ENTITLEMENT_ERROR`.** Add `com.apple.developer.declared-age-range`; the Simulator lacks the feature.
+- **Xcode?** 26.0 or later.
+- **Android `API_NOT_AVAILABLE` / `PLAY_STORE_NOT_FOUND` / `NETWORK_ERROR`.** Needs an up-to-date
+  Play Store, a network, and a Google Play install.
+- **No range on Android.** Reported only while the user consents to share it.
+
+Sources: [Expo docs: AgeRange](https://docs.expo.dev/versions/latest/sdk/age-range/),
+[expo/expo#46365](https://github.com/expo/expo/issues/46365),
+[AgeSignalsException](https://developer.android.com/google/play/age-signals/reference/com/google/android/play/agesignals/AgeSignalsException).
+
+## Test it
+
+No Fabric/Descriptor angle at all, every export here is a one-shot async function or a plain sync
+setter, never a view or per-instance state. Tests inject a fake native-module object in place of
+the real `requireNativeModule` resolution (`src/core/age-range.test.ts`, `vitest`), no
+`installFabric()`, no ViewConfig. Native behavior itself is verified on-device (see the parent
+[README](../../README.md) for the project's testing model).

package/build/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build/angular/index.js

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service, plain re-export
+export * from '../core/index.js';

package/build/core/age-range.d.ts

@@ -0,0 +1,12 @@
+import type { IAgeRangeRegulatoryFeature, IAgeRangeRequest, IAgeRangeResponse, IAgeSignalsStatus, IFakeAgeSignals } from './types';
+/** Prompts the user to share their age range; the OS may cache the response for later requests */
+export declare function requestAgeRangeAsync(options: IAgeRangeRequest): Promise<IAgeRangeResponse>;
+export declare function isEligibleForAgeFeaturesAsync(): Promise<boolean | null>;
+/** @platform ios, no-op elsewhere */
+export declare function showSignificantUpdateAcknowledgmentAsync(updateDescription: string): Promise<void>;
+/** @platform ios, `null` elsewhere means unknown rather than none required */
+export declare function getRequiredRegulatoryFeaturesAsync(): Promise<IAgeRangeRegulatoryFeature[] | null>;
+/** @platform android, `null` elsewhere means unknown rather than not shared */
+export declare function requestAgeSignalsAccessAsync(): Promise<IAgeSignalsStatus | null>;
+/** @platform android, no-op elsewhere; throws off a non-debuggable build unless `fake` is `null` */
+export declare function setFakeAgeSignals(fake: IFakeAgeSignals | null): void;

package/build/core/age-range.js

@@ -0,0 +1,38 @@
+import { Platform } from 'expo-modules-core';
+import { expoAgeRange } from './native-module.js';
+/** Prompts the user to share their age range; the OS may cache the response for later requests */
+export async function requestAgeRangeAsync(options) {
+    return expoAgeRange.requestAgeRangeAsync(options);
+}
+export async function isEligibleForAgeFeaturesAsync() {
+    return expoAgeRange.isEligibleForAgeFeaturesAsync();
+}
+/** @platform ios, no-op elsewhere */
+export async function showSignificantUpdateAcknowledgmentAsync(updateDescription) {
+    if (Platform.OS !== 'ios' ||
+        !expoAgeRange.showSignificantUpdateAcknowledgmentAsync) {
+        return;
+    }
+    await expoAgeRange.showSignificantUpdateAcknowledgmentAsync(updateDescription);
+}
+/** @platform ios, `null` elsewhere means unknown rather than none required */
+export async function getRequiredRegulatoryFeaturesAsync() {
+    if (Platform.OS !== 'ios' ||
+        !expoAgeRange.getRequiredRegulatoryFeaturesAsync) {
+        return null;
+    }
+    return expoAgeRange.getRequiredRegulatoryFeaturesAsync();
+}
+/** @platform android, `null` elsewhere means unknown rather than not shared */
+export async function requestAgeSignalsAccessAsync() {
+    if (Platform.OS !== 'android' || !expoAgeRange.requestAgeSignalsAccessAsync) {
+        return null;
+    }
+    return expoAgeRange.requestAgeSignalsAccessAsync();
+}
+/** @platform android, no-op elsewhere; throws off a non-debuggable build unless `fake` is `null` */
+export function setFakeAgeSignals(fake) {
+    if (Platform.OS !== 'android' || !expoAgeRange.setFakeAgeSignals)
+        return;
+    expoAgeRange.setFakeAgeSignals(fake);
+}

package/build/core/index.d.ts

@@ -0,0 +1,2 @@
+export { getRequiredRegulatoryFeaturesAsync, isEligibleForAgeFeaturesAsync, requestAgeRangeAsync, requestAgeSignalsAccessAsync, setFakeAgeSignals, showSignificantUpdateAcknowledgmentAsync, } from './age-range';
+export type { IAgeRangeRegulatoryFeature, IAgeRangeRequest, IAgeRangeResponse, IAgeSignalsStatus, IFakeAgeSignals, } from './types';

package/build/core/index.js

@@ -0,0 +1 @@
+export { getRequiredRegulatoryFeaturesAsync, isEligibleForAgeFeaturesAsync, requestAgeRangeAsync, requestAgeSignalsAccessAsync, setFakeAgeSignals, showSignificantUpdateAcknowledgmentAsync, } from './age-range.js';

package/build/core/native-module.d.ts

@@ -0,0 +1,10 @@
+import type { IAgeRangeRegulatoryFeature, IAgeRangeRequest, IAgeRangeResponse, IAgeSignalsStatus, IFakeAgeSignals } from './types';
+export type INativeAgeRangeModule = {
+    requestAgeRangeAsync(options: IAgeRangeRequest): Promise<IAgeRangeResponse>;
+    isEligibleForAgeFeaturesAsync(): Promise<boolean | null>;
+    showSignificantUpdateAcknowledgmentAsync?(updateDescription: string): Promise<void>;
+    getRequiredRegulatoryFeaturesAsync?(): Promise<IAgeRangeRegulatoryFeature[] | null>;
+    requestAgeSignalsAccessAsync?(): Promise<IAgeSignalsStatus | null>;
+    setFakeAgeSignals?(fake: IFakeAgeSignals | null): void;
+};
+export declare const expoAgeRange: INativeAgeRangeModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_AGE_RANGE_MODULE_NAME = 'ExpoAgeRange';
+export const expoAgeRange = requireNativeModule(EXPO_AGE_RANGE_MODULE_NAME);

package/build/core/types.d.ts

@@ -0,0 +1,50 @@
+/** @platform ios */
+export type IAgeRangeRequest = {
+    /** The required minimum age for your app */
+    threshold1: number;
+    threshold2?: number;
+    threshold3?: number;
+};
+export type IAgeRangeResponse = {
+    lowerBound: number | null;
+    upperBound: number | null;
+    /** @platform ios */
+    ageRangeDeclaration?: 'selfDeclared' | 'guardianDeclared' | 'confirmed' | null;
+    /** @platform ios */
+    activeParentalControls?: string[];
+    /** @platform android */
+    installId?: string | null;
+    /** @platform android */
+    ageRangeSource?: 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | null;
+    /** @platform android */
+    significantChangeStatus?: 'APPROVED' | 'PENDING' | 'DECLINED' | null;
+    /** @platform android */
+    significantChangeApprovalDate?: number | null;
+    /** Deprecated, use `significantChangeApprovalDate`. @platform android */
+    mostRecentApprovalDate?: number | null;
+};
+/** @platform android */
+export type IAgeSignalsStatus = 'SHARED' | 'NOT_SHARED' | 'VERIFICATION_REQUIRED';
+/** @platform android, omitted fields report as `null` */
+export type IFakeAgeSignals = {
+    lowerBound?: number | null;
+    upperBound?: number | null;
+    installId?: string | null;
+    ageRangeSource?: 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | null;
+    significantChangeStatus?: 'APPROVED' | 'PENDING' | 'DECLINED' | null;
+    significantChangeApprovalDate?: number | null;
+    ageSignalsStatus?: IAgeSignalsStatus | null;
+    errorCode?: never;
+} | {
+    /** https://developer.android.com/google/play/age-signals/handle-errors */
+    errorCode: number;
+    lowerBound?: never;
+    upperBound?: never;
+    installId?: never;
+    ageRangeSource?: never;
+    significantChangeStatus?: never;
+    significantChangeApprovalDate?: never;
+    ageSignalsStatus?: never;
+};
+/** @platform ios */
+export type IAgeRangeRegulatoryFeature = 'declaredAgeRangeRequired' | 'significantAppChangeRequiresAdultNotification' | 'significantAppChangeRequiresParentalConsent';

package/build/core/types.js

@@ -0,0 +1,3 @@
+// Ported verbatim from expo-age-range's ExpoAgeRange.types.ts (sdk-57), renamed with this
+// repo's `I`-prefix convention
+export {};

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service, plain re-export
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,cAAc,SAAS,CAAC"}

package/build-ngc/core/age-range.d.ts

@@ -0,0 +1,12 @@
+import type { IAgeRangeRegulatoryFeature, IAgeRangeRequest, IAgeRangeResponse, IAgeSignalsStatus, IFakeAgeSignals } from './types';
+/** Prompts the user to share their age range; the OS may cache the response for later requests */
+export declare function requestAgeRangeAsync(options: IAgeRangeRequest): Promise<IAgeRangeResponse>;
+export declare function isEligibleForAgeFeaturesAsync(): Promise<boolean | null>;
+/** @platform ios, no-op elsewhere */
+export declare function showSignificantUpdateAcknowledgmentAsync(updateDescription: string): Promise<void>;
+/** @platform ios, `null` elsewhere means unknown rather than none required */
+export declare function getRequiredRegulatoryFeaturesAsync(): Promise<IAgeRangeRegulatoryFeature[] | null>;
+/** @platform android, `null` elsewhere means unknown rather than not shared */
+export declare function requestAgeSignalsAccessAsync(): Promise<IAgeSignalsStatus | null>;
+/** @platform android, no-op elsewhere; throws off a non-debuggable build unless `fake` is `null` */
+export declare function setFakeAgeSignals(fake: IFakeAgeSignals | null): void;

package/build-ngc/core/age-range.js

@@ -0,0 +1,39 @@
+import { Platform } from 'expo-modules-core';
+import { expoAgeRange } from './native-module';
+/** Prompts the user to share their age range; the OS may cache the response for later requests */
+export async function requestAgeRangeAsync(options) {
+    return expoAgeRange.requestAgeRangeAsync(options);
+}
+export async function isEligibleForAgeFeaturesAsync() {
+    return expoAgeRange.isEligibleForAgeFeaturesAsync();
+}
+/** @platform ios, no-op elsewhere */
+export async function showSignificantUpdateAcknowledgmentAsync(updateDescription) {
+    if (Platform.OS !== 'ios' ||
+        !expoAgeRange.showSignificantUpdateAcknowledgmentAsync) {
+        return;
+    }
+    await expoAgeRange.showSignificantUpdateAcknowledgmentAsync(updateDescription);
+}
+/** @platform ios, `null` elsewhere means unknown rather than none required */
+export async function getRequiredRegulatoryFeaturesAsync() {
+    if (Platform.OS !== 'ios' ||
+        !expoAgeRange.getRequiredRegulatoryFeaturesAsync) {
+        return null;
+    }
+    return expoAgeRange.getRequiredRegulatoryFeaturesAsync();
+}
+/** @platform android, `null` elsewhere means unknown rather than not shared */
+export async function requestAgeSignalsAccessAsync() {
+    if (Platform.OS !== 'android' || !expoAgeRange.requestAgeSignalsAccessAsync) {
+        return null;
+    }
+    return expoAgeRange.requestAgeSignalsAccessAsync();
+}
+/** @platform android, no-op elsewhere; throws off a non-debuggable build unless `fake` is `null` */
+export function setFakeAgeSignals(fake) {
+    if (Platform.OS !== 'android' || !expoAgeRange.setFakeAgeSignals)
+        return;
+    expoAgeRange.setFakeAgeSignals(fake);
+}
+//# sourceMappingURL=age-range.js.map

package/build-ngc/core/age-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"age-range.js","sourceRoot":"","sources":["../../src/core/age-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS/C,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAyB;IAEzB,OAAO,YAAY,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B;IACjD,OAAO,YAAY,CAAC,6BAA6B,EAAE,CAAC;AACtD,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,iBAAyB;IAEzB,IACE,QAAQ,CAAC,EAAE,KAAK,KAAK;QACrB,CAAC,YAAY,CAAC,wCAAwC,EACtD,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,YAAY,CAAC,wCAAwC,CACzD,iBAAiB,CAClB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,kCAAkC;IAGtD,IACE,QAAQ,CAAC,EAAE,KAAK,KAAK;QACrB,CAAC,YAAY,CAAC,kCAAkC,EAChD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,YAAY,CAAC,kCAAkC,EAAE,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,YAAY,CAAC,4BAA4B,EAAE,CAAC;AACrD,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,iBAAiB,CAAC,IAA4B;IAC5D,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,iBAAiB;QAAE,OAAO;IACzE,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { getRequiredRegulatoryFeaturesAsync, isEligibleForAgeFeaturesAsync, requestAgeRangeAsync, requestAgeSignalsAccessAsync, setFakeAgeSignals, showSignificantUpdateAcknowledgmentAsync, } from './age-range';
+export type { IAgeRangeRegulatoryFeature, IAgeRangeRequest, IAgeRangeResponse, IAgeSignalsStatus, IFakeAgeSignals, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,2 @@
+export { getRequiredRegulatoryFeaturesAsync, isEligibleForAgeFeaturesAsync, requestAgeRangeAsync, requestAgeSignalsAccessAsync, setFakeAgeSignals, showSignificantUpdateAcknowledgmentAsync, } from './age-range';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,wCAAwC,GACzC,MAAM,aAAa,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,10 @@
+import type { IAgeRangeRegulatoryFeature, IAgeRangeRequest, IAgeRangeResponse, IAgeSignalsStatus, IFakeAgeSignals } from './types';
+export type INativeAgeRangeModule = {
+    requestAgeRangeAsync(options: IAgeRangeRequest): Promise<IAgeRangeResponse>;
+    isEligibleForAgeFeaturesAsync(): Promise<boolean | null>;
+    showSignificantUpdateAcknowledgmentAsync?(updateDescription: string): Promise<void>;
+    getRequiredRegulatoryFeaturesAsync?(): Promise<IAgeRangeRegulatoryFeature[] | null>;
+    requestAgeSignalsAccessAsync?(): Promise<IAgeSignalsStatus | null>;
+    setFakeAgeSignals?(fake: IFakeAgeSignals | null): void;
+};
+export declare const expoAgeRange: INativeAgeRangeModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_AGE_RANGE_MODULE_NAME = 'ExpoAgeRange';
+export const expoAgeRange = requireNativeModule(EXPO_AGE_RANGE_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASxD,MAAM,0BAA0B,GAAG,cAAc,CAAC;AAiBlD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAC7C,0BAA0B,CAC3B,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,50 @@
+/** @platform ios */
+export type IAgeRangeRequest = {
+    /** The required minimum age for your app */
+    threshold1: number;
+    threshold2?: number;
+    threshold3?: number;
+};
+export type IAgeRangeResponse = {
+    lowerBound: number | null;
+    upperBound: number | null;
+    /** @platform ios */
+    ageRangeDeclaration?: 'selfDeclared' | 'guardianDeclared' | 'confirmed' | null;
+    /** @platform ios */
+    activeParentalControls?: string[];
+    /** @platform android */
+    installId?: string | null;
+    /** @platform android */
+    ageRangeSource?: 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | null;
+    /** @platform android */
+    significantChangeStatus?: 'APPROVED' | 'PENDING' | 'DECLINED' | null;
+    /** @platform android */
+    significantChangeApprovalDate?: number | null;
+    /** Deprecated, use `significantChangeApprovalDate`. @platform android */
+    mostRecentApprovalDate?: number | null;
+};
+/** @platform android */
+export type IAgeSignalsStatus = 'SHARED' | 'NOT_SHARED' | 'VERIFICATION_REQUIRED';
+/** @platform android, omitted fields report as `null` */
+export type IFakeAgeSignals = {
+    lowerBound?: number | null;
+    upperBound?: number | null;
+    installId?: string | null;
+    ageRangeSource?: 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | null;
+    significantChangeStatus?: 'APPROVED' | 'PENDING' | 'DECLINED' | null;
+    significantChangeApprovalDate?: number | null;
+    ageSignalsStatus?: IAgeSignalsStatus | null;
+    errorCode?: never;
+} | {
+    /** https://developer.android.com/google/play/age-signals/handle-errors */
+    errorCode: number;
+    lowerBound?: never;
+    upperBound?: never;
+    installId?: never;
+    ageRangeSource?: never;
+    significantChangeStatus?: never;
+    significantChangeApprovalDate?: never;
+    ageSignalsStatus?: never;
+};
+/** @platform ios */
+export type IAgeRangeRegulatoryFeature = 'declaredAgeRangeRequired' | 'significantAppChangeRequiresAdultNotification' | 'significantAppChangeRequiresParentalConsent';

package/build-ngc/core/types.js

@@ -0,0 +1,4 @@
+// Ported verbatim from expo-age-range's ExpoAgeRange.types.ts (sdk-57), renamed with this
+// repo's `I`-prefix convention
+export {};
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,+BAA+B"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-age-range",
+    "modules": [
+      {
+        "importPath": "expo.modules.agerange.AgeRangeModule",
+        "className": "AgeRangeModule",
+        "nativeName": "ExpoAgeRange"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@symbiote-native/age-range",
+  "version": "0.1.0",
+  "description": "expo-age-range wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Apple's Declared Age Range API and Google Play's Age Signals.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-age-range",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "age-range",
+    "age-signals"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/age-range"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/age-range#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-age-range": "57.0.5",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/vue": "^3.1.0",
+    "@symbiote-native/solid": "^3.0.5"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/vue": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service, plain re-export
+export * from '../core';

package/src/core/age-range.ts

@@ -0,0 +1,62 @@
+import { Platform } from 'expo-modules-core';
+import { expoAgeRange } from './native-module';
+import type {
+  IAgeRangeRegulatoryFeature,
+  IAgeRangeRequest,
+  IAgeRangeResponse,
+  IAgeSignalsStatus,
+  IFakeAgeSignals,
+} from './types';
+
+/** Prompts the user to share their age range; the OS may cache the response for later requests */
+export async function requestAgeRangeAsync(
+  options: IAgeRangeRequest,
+): Promise<IAgeRangeResponse> {
+  return expoAgeRange.requestAgeRangeAsync(options);
+}
+
+export async function isEligibleForAgeFeaturesAsync(): Promise<boolean | null> {
+  return expoAgeRange.isEligibleForAgeFeaturesAsync();
+}
+
+/** @platform ios, no-op elsewhere */
+export async function showSignificantUpdateAcknowledgmentAsync(
+  updateDescription: string,
+): Promise<void> {
+  if (
+    Platform.OS !== 'ios' ||
+    !expoAgeRange.showSignificantUpdateAcknowledgmentAsync
+  ) {
+    return;
+  }
+  await expoAgeRange.showSignificantUpdateAcknowledgmentAsync(
+    updateDescription,
+  );
+}
+
+/** @platform ios, `null` elsewhere means unknown rather than none required */
+export async function getRequiredRegulatoryFeaturesAsync(): Promise<
+  IAgeRangeRegulatoryFeature[] | null
+> {
+  if (
+    Platform.OS !== 'ios' ||
+    !expoAgeRange.getRequiredRegulatoryFeaturesAsync
+  ) {
+    return null;
+  }
+  return expoAgeRange.getRequiredRegulatoryFeaturesAsync();
+}
+
+/** @platform android, `null` elsewhere means unknown rather than not shared */
+export async function requestAgeSignalsAccessAsync(): Promise<IAgeSignalsStatus | null> {
+  if (Platform.OS !== 'android' || !expoAgeRange.requestAgeSignalsAccessAsync) {
+    return null;
+  }
+  return expoAgeRange.requestAgeSignalsAccessAsync();
+}
+
+/** @platform android, no-op elsewhere; throws off a non-debuggable build unless `fake` is `null` */
+export function setFakeAgeSignals(fake: IFakeAgeSignals | null): void {
+  if (Platform.OS !== 'android' || !expoAgeRange.setFakeAgeSignals) return;
+  expoAgeRange.setFakeAgeSignals(fake);
+}

package/src/core/index.ts

@@ -0,0 +1,15 @@
+export {
+  getRequiredRegulatoryFeaturesAsync,
+  isEligibleForAgeFeaturesAsync,
+  requestAgeRangeAsync,
+  requestAgeSignalsAccessAsync,
+  setFakeAgeSignals,
+  showSignificantUpdateAcknowledgmentAsync,
+} from './age-range';
+export type {
+  IAgeRangeRegulatoryFeature,
+  IAgeRangeRequest,
+  IAgeRangeResponse,
+  IAgeSignalsStatus,
+  IFakeAgeSignals,
+} from './types';

package/src/core/native-module.ts

@@ -0,0 +1,29 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type {
+  IAgeRangeRegulatoryFeature,
+  IAgeRangeRequest,
+  IAgeRangeResponse,
+  IAgeSignalsStatus,
+  IFakeAgeSignals,
+} from './types';
+
+const EXPO_AGE_RANGE_MODULE_NAME = 'ExpoAgeRange';
+
+// The iOS-only and android-only methods stay optional here; age-range.ts checks Platform.OS
+// before calling through, same convention as packages/application/src/core/native-module.ts
+export type INativeAgeRangeModule = {
+  requestAgeRangeAsync(options: IAgeRangeRequest): Promise<IAgeRangeResponse>;
+  isEligibleForAgeFeaturesAsync(): Promise<boolean | null>;
+  showSignificantUpdateAcknowledgmentAsync?(
+    updateDescription: string,
+  ): Promise<void>;
+  getRequiredRegulatoryFeaturesAsync?(): Promise<
+    IAgeRangeRegulatoryFeature[] | null
+  >;
+  requestAgeSignalsAccessAsync?(): Promise<IAgeSignalsStatus | null>;
+  setFakeAgeSignals?(fake: IFakeAgeSignals | null): void;
+};
+
+export const expoAgeRange = requireNativeModule<INativeAgeRangeModule>(
+  EXPO_AGE_RANGE_MODULE_NAME,
+);

package/src/core/types.ts

@@ -0,0 +1,64 @@
+// Ported verbatim from expo-age-range's ExpoAgeRange.types.ts (sdk-57), renamed with this
+// repo's `I`-prefix convention
+
+/** @platform ios */
+export type IAgeRangeRequest = {
+  /** The required minimum age for your app */
+  threshold1: number;
+  threshold2?: number;
+  threshold3?: number;
+};
+
+export type IAgeRangeResponse = {
+  lowerBound: number | null;
+  upperBound: number | null;
+  /** @platform ios */
+  ageRangeDeclaration?:
+    'selfDeclared' | 'guardianDeclared' | 'confirmed' | null;
+  /** @platform ios */
+  activeParentalControls?: string[];
+  /** @platform android */
+  installId?: string | null;
+  /** @platform android */
+  ageRangeSource?: 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | null;
+  /** @platform android */
+  significantChangeStatus?: 'APPROVED' | 'PENDING' | 'DECLINED' | null;
+  /** @platform android */
+  significantChangeApprovalDate?: number | null;
+  /** Deprecated, use `significantChangeApprovalDate`. @platform android */
+  mostRecentApprovalDate?: number | null;
+};
+
+/** @platform android */
+export type IAgeSignalsStatus =
+  'SHARED' | 'NOT_SHARED' | 'VERIFICATION_REQUIRED';
+
+/** @platform android, omitted fields report as `null` */
+export type IFakeAgeSignals =
+  | {
+      lowerBound?: number | null;
+      upperBound?: number | null;
+      installId?: string | null;
+      ageRangeSource?: 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | null;
+      significantChangeStatus?: 'APPROVED' | 'PENDING' | 'DECLINED' | null;
+      significantChangeApprovalDate?: number | null;
+      ageSignalsStatus?: IAgeSignalsStatus | null;
+      errorCode?: never;
+    }
+  | {
+      /** https://developer.android.com/google/play/age-signals/handle-errors */
+      errorCode: number;
+      lowerBound?: never;
+      upperBound?: never;
+      installId?: never;
+      ageRangeSource?: never;
+      significantChangeStatus?: never;
+      significantChangeApprovalDate?: never;
+      ageSignalsStatus?: never;
+    };
+
+/** @platform ios */
+export type IAgeRangeRegulatoryFeature =
+  | 'declaredAgeRangeRequired'
+  | 'significantAppChangeRequiresAdultNotification'
+  | 'significantAppChangeRequiresParentalConsent';