@milkinteractive/react-native-age-range 1.0.4 → 1.0.6

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,WAAW,GACX,4BAA4B,GAC5B,2BAA2B,GAC3B,SAAS,CAAC;AAEd,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAID;;;;;;;;;;GAUG;AACH,MAAM,MAAM,uBAAuB,GAC/B,cAAc,GACd,kBAAkB,GAClB,sBAAsB,GACtB,8BAA8B,GAC9B,qBAAqB,GACrB,6BAA6B,GAC7B,gBAAgB,GAChB,wBAAwB,GACxB,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,oCAAoC,CAAC,EAAE,OAAO,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACrD;;OAEG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAGD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAWnC;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAQnF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAQvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milkinteractive/react-native-age-range",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "A React Native Native Module (Legacy Architecture) that provides access to store-level age signals, including Android Play Age Range and iOS Declared Age, to assist with state-level age verification compliance (e.g., Texas).",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
@@ -63,7 +63,7 @@
     "type": "git",
     "url": "git+https://github.com/valleyelectronics/react-native-age-range.git"
   },
-  "author": "Christoph Eck <christoph@milkinteractive.ch>",
+  "author": "Naga sai charan gubba <nagasaicharan7@gmail.com> (https://github.com/nagasaicharan)",
   "contributors": [
     "Christoph Eck <christoph@milkinteractive.ch>"
   ],

package/src/index.tsx

@@ -119,6 +119,70 @@ export interface DeclaredAgeEligibilityResult {
   error: string | null;
 }
 
+// ========== PERMISSIONKIT TYPES (iOS 26+) ==========
+
+/**
+ * Status of significant change approval request.
+ * - approved: Parent/guardian approved the change
+ * - denied: Parent/guardian denied the change
+ * - pending: Request has been sent, awaiting response
+ */
+export type SignificantChangeStatus = 'approved' | 'denied' | 'pending' | null;
+
+/**
+ * Result of significant change approval request.
+ */
+export interface SignificantChangeResult {
+  status: SignificantChangeStatus;
+  error: string | null;
+}
+
+/**
+ * Handle type for communication contacts.
+ * - phoneNumber: Phone number identifier
+ * - email: Email address identifier
+ * - custom: Custom identifier (username, handle, etc.)
+ */
+export type CommunicationHandleKind = 'phoneNumber' | 'email' | 'custom';
+
+/**
+ * Contact information for communication permission request.
+ */
+export interface CommunicationContact {
+  /** Unique identifier (phone, email, username) */
+  handle: string;
+  /** Type of handle */
+  handleKind: CommunicationHandleKind;
+  /** Optional display name shown to parent/guardian */
+  displayName?: string;
+}
+
+/**
+ * Communication actions that can be requested.
+ * - message: Text/chat messaging
+ * - call: Voice calls
+ * - video: Video calls
+ */
+export type CommunicationAction = 'message' | 'call' | 'video';
+
+/**
+ * Result of communication permission request.
+ */
+export interface CommunicationPermissionResult {
+  /** Whether the permission request was successfully shown */
+  granted: boolean;
+  error: string | null;
+}
+
+/**
+ * Result of known handles check.
+ */
+export interface KnownHandlesResult {
+  /** Handles that are recognized by the system (known contacts) */
+  knownHandles: string[];
+  error: string | null;
+}
+
 export interface AndroidAgeRangeConfig {
   /**
    * Enable mock mode to simulate results without calling Google Play API.
@@ -170,17 +234,21 @@ export function getAndroidPlayAgeRangeStatus(
   );
 }
 
+// Minimum iOS version required for DeclaredAgeRange API
+const IOS_MIN_VERSION_DECLARED_AGE_RANGE = 26;
+
 /**
  * Requests age range declaration from iOS Declared Age Range API.
  * @platform ios
- * @param firstThresholdAge First age threshold (e.g., 13)
- * @param secondThresholdAge Second age threshold (e.g., 17)
- * @param thirdThresholdAge Third age threshold (e.g., 21)
+ * @param firstThresholdAge First age threshold (required, e.g., 13)
+ * @param secondThresholdAge Second age threshold (optional, e.g., 17)
+ * @param thirdThresholdAge Third age threshold (optional, e.g., 21)
+ * @remarks Requires iOS 26.0+. Returns error on older iOS versions.
  */
 export function requestIOSDeclaredAgeRange(
   firstThresholdAge: number,
-  secondThresholdAge: number,
-  thirdThresholdAge: number
+  secondThresholdAge?: number,
+  thirdThresholdAge?: number
 ): Promise<DeclaredAgeRangeResult> {
   if (Platform.OS !== 'ios') {
     return Promise.resolve({
@@ -192,19 +260,36 @@ export function requestIOSDeclaredAgeRange(
       error: 'This method is only available on iOS',
     });
   }
+
+  // Early return for iOS versions below 26 to prevent native bridge errors
+  const iosVersion = parseInt(String(Platform.Version), 10);
+  if (iosVersion < IOS_MIN_VERSION_DECLARED_AGE_RANGE) {
+    return Promise.resolve({
+      status: null,
+      lowerBound: null,
+      upperBound: null,
+      ageRangeDeclaration: null,
+      parentalControls: null,
+      error: `Requires iOS ${IOS_MIN_VERSION_DECLARED_AGE_RANGE}.0+. Current version: iOS ${iosVersion}`,
+    });
+  }
+
   return StoreAgeSignalsNativeModules.requestIOSDeclaredAgeRange(
     firstThresholdAge,
-    secondThresholdAge,
-    thirdThresholdAge
+    secondThresholdAge ?? null,
+    thirdThresholdAge ?? null
   );
 }
 
+// Minimum iOS version required for isEligibleForAgeFeatures API
+const IOS_MIN_VERSION_ELIGIBLE_CHECK = 26;
+
 /**
  * Checks if the current user is eligible for age verification features on iOS.
  * This determines if age checks need to be applied (e.g., user is in an applicable region like Texas).
  * @platform ios
  * @returns Promise<DeclaredAgeEligibilityResult> - Object containing isEligible boolean and error string
- * @remarks Requires iOS 26.0+. Returns isEligible: false with error message if not available.
+ * @remarks Requires iOS 26.2+. Returns isEligible: false with error message if not available.
  */
 export function isIOSEligibleForAgeFeatures(): Promise<DeclaredAgeEligibilityResult> {
   if (Platform.OS !== 'ios') {
@@ -213,6 +298,16 @@ export function isIOSEligibleForAgeFeatures(): Promise<DeclaredAgeEligibilityRes
       error: 'This method is only available on iOS',
     });
   }
+
+  // Early return for iOS versions below 26 to prevent native bridge errors
+  const iosVersion = parseInt(String(Platform.Version), 10);
+  if (iosVersion < IOS_MIN_VERSION_ELIGIBLE_CHECK) {
+    return Promise.resolve({
+      isEligible: false,
+      error: `Requires iOS ${IOS_MIN_VERSION_ELIGIBLE_CHECK}.0+. Current version: iOS ${iosVersion}`,
+    });
+  }
+
   return StoreAgeSignalsNativeModules.isEligibleForAgeFeatures();
 }
 
@@ -232,3 +327,121 @@ export function isAndroidEligibleForAgeFeatures(): Promise<DeclaredAgeEligibilit
   }
   return StoreAgeSignalsNativeModules.isEligibleForAgeFeatures();
 }
+
+// ========== PERMISSIONKIT FUNCTIONS (iOS 26+) ==========
+
+/**
+ * Requests parental approval for significant app changes (iOS PermissionKit).
+ *
+ * Use this when `parentalControls.significantAppChangeApprovalRequired` is `true`
+ * from the `requestIOSDeclaredAgeRange()` response.
+ *
+ * This shows a system dialog to request parental consent for significant app updates.
+ * The parent/guardian will receive a notification via Messages.
+ *
+ * @platform ios
+ * @requires iOS 26.0+
+ * @returns Promise<SignificantChangeResult> - Contains status ('pending', 'approved', 'denied') and error
+ *
+ * @example
+ * ```typescript
+ * const ageResult = await requestIOSDeclaredAgeRange(13, 17, 21);
+ * if (ageResult.parentalControls?.significantAppChangeApprovalRequired) {
+ *   const result = await requestIOSSignificantChangeApproval();
+ *   if (result.status === 'pending') {
+ *     // Request sent, await parent response
+ *   }
+ * }
+ * ```
+ */
+export function requestIOSSignificantChangeApproval(): Promise<SignificantChangeResult> {
+  if (Platform.OS !== 'ios') {
+    return Promise.resolve({
+      status: null,
+      error: 'This method is only available on iOS',
+    });
+  }
+  return StoreAgeSignalsNativeModules.requestSignificantChangeApproval();
+}
+
+/**
+ * Requests permission for a child to communicate with specified contacts (iOS PermissionKit).
+ *
+ * Use this when `parentalControls.communicationLimits` is `true`
+ * from the `requestIOSDeclaredAgeRange()` response.
+ *
+ * This shows a system dialog requesting the parent/guardian to approve
+ * communication with the specified contacts. The request is sent via Messages.
+ *
+ * @platform ios
+ * @requires iOS 26.2+
+ * @param contacts - Array of contacts to request permission for
+ * @param actions - Optional array of communication actions (defaults to ['message'])
+ * @returns Promise<CommunicationPermissionResult> - Contains granted boolean and error
+ *
+ * @example
+ * ```typescript
+ * const ageResult = await requestIOSDeclaredAgeRange(13, 17, 21);
+ * if (ageResult.parentalControls?.communicationLimits) {
+ *   const result = await requestIOSCommunicationPermission(
+ *     [{ handle: 'friend@example.com', handleKind: 'email', displayName: 'School Friend' }],
+ *     ['message', 'call']
+ *   );
+ * }
+ * ```
+ */
+export function requestIOSCommunicationPermission(
+  contacts: CommunicationContact[],
+  actions?: CommunicationAction[]
+): Promise<CommunicationPermissionResult> {
+  if (Platform.OS !== 'ios') {
+    return Promise.resolve({
+      granted: false,
+      error: 'This method is only available on iOS',
+    });
+  }
+  return StoreAgeSignalsNativeModules.requestCommunicationPermission(
+    contacts,
+    actions || ['message']
+  );
+}
+
+/**
+ * Checks which handles are recognized by the system (known contacts) (iOS PermissionKit).
+ *
+ * Use this to determine which contacts are already approved before showing
+ * a communication permission request.
+ *
+ * @platform ios
+ * @requires iOS 26.2+
+ * @param handles - Array of handles to check
+ * @returns Promise<KnownHandlesResult> - Contains array of known handle values and error
+ *
+ * @example
+ * ```typescript
+ * const result = await getIOSKnownCommunicationHandles([
+ *   { handle: 'user@example.com', handleKind: 'email' },
+ *   { handle: 'gamer123', handleKind: 'custom' }
+ * ]);
+ *
+ * const unknownContacts = handles.filter(
+ *   h => !result.knownHandles.includes(h.handle)
+ * );
+ *
+ * if (unknownContacts.length > 0) {
+ *   // Request permission for unknown contacts
+ *   await requestIOSCommunicationPermission(unknownContacts);
+ * }
+ * ```
+ */
+export function getIOSKnownCommunicationHandles(
+  handles: CommunicationContact[]
+): Promise<KnownHandlesResult> {
+  if (Platform.OS !== 'ios') {
+    return Promise.resolve({
+      knownHandles: [],
+      error: 'This method is only available on iOS',
+    });
+  }
+  return StoreAgeSignalsNativeModules.getKnownCommunicationHandles(handles);
+}