/**
 * Create a Supabase Edge Function handler for retrieving user auth status.
 *
 * Returns uid, email, verification status, custom claims, and ban status.
 *
 * @returns `(req: Request) => Promise<Response>` handler
 *
 * @example
 * ```typescript
 * // supabase/functions/get-user-auth-status/index.ts
 * import { createGetUserAuthStatus } from '@donotdev/functions/supabase';
 * Deno.serve(createGetUserAuthStatus());
 * ```
 *
 * @version 0.1.0
 * @since 0.6.0
 */
export declare function createGetUserAuthStatus(): (req: Request) => Promise<Response>;
