import type { SecurityAvailability } from '../sensitive-info.nitro';
import type { AsyncState } from './types';
/**
 * Tunables for {@link useSecurityAvailability}.
 *
 * @public
 */
export interface UseSecurityAvailabilityOptions {
    /**
     * When `true`, automatically calls {@link UseSecurityAvailabilityResult.refetch} whenever the
     * app transitions to the `active` state. Recommended for screens that gate UI on biometric
     * enrollment — covers the common flow where the user leaves to system settings, enrolls/removes
     * a biometric, and returns to the app.
     *
     * @remarks Back-to-back `active` transitions within ~500 ms are debounced to avoid double
     * fetches when iOS briefly inactivates the app for system overlays (Control Center, Face ID
     * sheet, etc.). Listener is detached on unmount.
     *
     * @defaultValue `false`
     */
    readonly refreshOnForeground?: boolean;
}
/**
 * Result returned by {@link useSecurityAvailability}.
 *
 * @public
 */
export interface UseSecurityAvailabilityResult extends AsyncState<SecurityAvailability> {
    /** Forces a fresh native call, bypassing the per-instance cache. */
    readonly refetch: () => Promise<void>;
}
/**
 * Queries which security primitives are available on the current device and caches the outcome.
 *
 * @param options - Optional {@link UseSecurityAvailabilityOptions}; pass
 *   `{ refreshOnForeground: true }` to auto-refresh when the app returns to foreground.
 * @returns A {@link UseSecurityAvailabilityResult} with `data` (the latest snapshot),
 * `error`/`isLoading`/`isPending` flags, and a `refetch` helper that bypasses the cache.
 *
 * @remarks
 * - The hook caches the first successful response **per component instance** — subsequent
 *   renders of that same component reuse the cached value without hitting the native module.
 *   Multiple component instances each maintain their own cache.
 * - `refetch()` forces a fresh native call — use it after the user changes biometric enrollment
 *   in system settings.
 * - On error, the previously cached `data` is preserved so you can render fallback UI without
 *   losing capability info.
 * - When `refreshOnForeground` is enabled, the hook subscribes to `AppState` and refetches on
 *   `active` transitions (debounced). The subscription is created lazily inside `useEffect` so
 *   the hook remains tree-shakable and side-effect-free at the module level.
 *
 * @example
 * ```tsx
 * const { data: caps, isLoading } = useSecurityAvailability({ refreshOnForeground: true })
 *
 * if (isLoading || !caps) return null
 * if (caps.biometryStatus === 'notEnrolled') return <SetupFaceIdCta />
 * return caps.biometry
 *   ? <EnableFaceIdToggle />
 *   : <Text>Biometrics unavailable on this device.</Text>
 * ```
 *
 * @see {@link getSupportedSecurityLevels}
 * @see {@link useBiometryStatusWatcher}
 * @public
 */
export declare function useSecurityAvailability(options?: UseSecurityAvailabilityOptions): UseSecurityAvailabilityResult;
//# sourceMappingURL=useSecurityAvailability.d.ts.map