import type { Auth } from '@microsoft/rayfin-auth';
import type { FabricAuthOptions } from './types.js';
/**
 * Initiates brokered authentication by opening the broker portal in a popup.
 *
 * **Must be called inside a user click handler** to avoid popup blockers.
 *
 * Opens the popup synchronously in the gesture (Safari/iOS block `window.open`
 * after an `await`) and delivers the PKCE challenge via the
 * `brokeredAuth.challenge` postMessage. On `brokeredAuth.handoff`, exchanges
 * the code for tokens and creates a session. `code_verifier` stays in closure.
 *
 * @param auth - Auth instance for token exchange.
 * @param options - Broker auth options (`returnOrigin` required).
 * @returns Resolves when the session is established.
 * @throws `AuthError` - On missing options, blocked popup, PKCE preparation or
 *   delivery failure (`PKCE_CHALLENGE_FAILED`, `CHALLENGE_DELIVERY_FAILED`), or
 *   auth failure.
 */
export declare function initiateFabricLogin(auth: Auth, options: FabricAuthOptions): Promise<void>;
//# sourceMappingURL=initiateFabricLogin.d.ts.map