/**
 * Raw callback parameters from OAuth redirect
 * Contains all query parameters returned by the OAuth provider
 */
type OAuthCallbackParams = Record<string, string | undefined>;
/**
 * Default OAuth result with standard code and state
 */
interface OAuthResult {
    code: string;
    state?: string;
}
/**
 * OAuth configuration options
 */
interface OAuthConfig<T = OAuthResult> {
    oauthUrl: string;
    redirectUrl: string;
    additionalParameters?: Record<string, string>;
    /**
     * Optional transformer to convert raw callback params to desired type
     * If not provided, returns all callback params as-is (typed as T)
     */
    transformCallback?: (params: OAuthCallbackParams) => T;
}
/**
 * OAuth client interface with generic result type
 * @template T - The type returned from authorize(), defaults to OAuthResult
 */
interface OAuthClient<T = OAuthResult> {
    authorize(): Promise<T>;
}

declare class WebOAuthClient<T = OAuthResult> implements OAuthClient<T> {
    private config;
    constructor(config: OAuthConfig<T>);
    authorize(): Promise<T>;
    private checkForCallback;
    private buildOAuthUrl;
    private generateState;
}

declare function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T>;

export { type OAuthCallbackParams, type OAuthClient, type OAuthConfig, type OAuthResult, WebOAuthClient, createOAuthClient };