/**
 * Age range verification result from platform APIs
 */
export interface AgeRangeResult {
  /**
   * Status of the age verification
   * - "verified": User meets age requirements
   * - "not_verified": User does not meet age requirements
   * - "unknown": Age verification status unknown
   * - "not_available_yet": API not available (iOS < 26.0 or Android < 15)
   * - "error": An error occurred
   */
  status: 'verified' | 'not_verified' | 'unknown' | 'not_available_yet' | 'error';

  /**
   * Human-readable message about the verification result
   */
  message?: string;

  /**
   * The age thresholds that were used for verification
   */
  thresholds?: number[];

  /**
   * iOS only: Age range category if available
   */
  ageRange?: string;

  /**
   * iOS only: Lower bound of the age range
   */
  lowerBound?: number;

  /**
   * iOS only: Upper bound of the age range
   */
  upperBound?: number;
}

/**
 * Configuration for age thresholds
 */
export interface SetThresholdsResult {
  /**
   * Whether the thresholds were successfully set
   */
  success: boolean;
}

/**
 * Age Declaration Module interface
 */
export interface AgeDeclarationModuleType {
  /**
   * Sets the age range thresholds for the application
   *
   * @param thresholds - Array of age thresholds (1-18, ascending, 2-year separation)
   * @returns Promise that resolves when thresholds are set
   *
   * @example
   * ```typescript
   * await setAgeThresholds([13, 15, 18]);
   * ```
   */
  setAgeThresholds(thresholds: number[]): Promise<SetThresholdsResult>;

  /**
   * Requests age range information from the platform
   *
   * **Important:**
   * - On iOS: Requires iOS 26.0+ with DeclaredAgeRange framework
   * - On Android: Requires Android 15+ with Google Play Services
   * - Thresholds must be set first using setAgeThresholds()
   *
   * @returns Promise that resolves with age verification result
   *
   * @example
   * ```typescript
   * const result = await requestAgeRange();
   * if (result.status === 'verified') {
   *   console.log('User meets age requirements');
   * }
   * ```
   */
  requestAgeRange(): Promise<AgeRangeResult>;

  /**
   * Checks if age range API is supported on this device
   *
   * @returns Promise that resolves to true if supported
   *
   * @example
   * ```typescript
   * const supported = await isSupported();
   * if (supported) {
   *   await setAgeThresholds([13, 18]);
   * }
   * ```
   */
  isSupported(): Promise<boolean>;
}