/**
* Shared browser-OAuth ceremony for auth providers: an
* {@link Interaction.browserLogin} that waits for the provider's local
* callback listener, with manual code entry as the fallback.
*
* {@link deviceOAuth} is the device-code (RFC 8628) counterpart.
*
* Built-in providers (Planetscale, Cloudflare) and custom stack-provided
* auth providers should all route their browser flows through these so the
* login UX stays uniform.
*/
import * as Effect from "effect/Effect";
import * as Interaction from "../Interaction.ts";
import { type DeviceAuthorization } from "./OAuthFlow.ts";
export interface BrowserOAuthOptions {
/** Display name, e.g. "Cloudflare" — used in the prompt title. */
provider: string;
/** The authorization URL the browser was pointed at. */
url: string;
/** Resolves when the local callback listener receives the redirect. */
callback: Effect.Effect;
/** Exchanges a manually pasted code / callback URL for credentials. */
exchange: (input: string) => Effect.Effect;
/** Spinner label. @default "waiting for browser authorization (up to 5 minutes)…" */
waitingLabel?: string;
}
export declare const browserOAuth: (options: BrowserOAuthOptions) => Effect.Effect;
export interface DeviceOAuthOptions {
/** Display name, e.g. "Cloudflare" — used in the prompt title. */
provider: string;
/** The pending device authorization to show the user. */
authorization: DeviceAuthorization;
/** Polls until the user approves; usually `client.deviceToken(authorization)`. */
token: Effect.Effect;
}
/**
* Shared device-authorization (RFC 8628) ceremony: open the verification
* URL, show the user code, and wait for the token poll. The prompt only
* renders the URL/code and re-opens the browser; the poll always wins.
*/
export declare const deviceOAuth: (options: DeviceOAuthOptions) => Effect.Effect;
//# sourceMappingURL=BrowserOAuth.d.ts.map