/**
 * Builds a login URL for a given identity provider (IdP).
 *
 * This function generates a login URL by either using a predefined mapping
 * or falling back to the default server login route. It appends query parameters such as
 * `idpId`, `localePrefix`, `redirectTo`, and any additional `extraParams`.
 *
 * @param idpId - The unique identifier of the identity provider.
 * @param localePrefix - The locale prefix (e.g., "en", "fr").
 * @param redirectTo - Optional redirect target after login.
 * @param extraParams - Additional query parameters to append to the login URL.
 *
 * @returns The constructed login URL as a string, or `undefined` if `idpId` is not provided.
 *
 * @example
 * ```ts
 * buildLoginUrl('okta-123', 'oidc', 'en', undefined, '/dashboard', { prompt: 'login' });
 * // "/api/idp/login?idpId=okta-123&localePrefix=en&redirectTo=%2Fdashboard&prompt=login"
 * ```
 */
export declare function buildLoginUrl(idpId: string, localePrefix: string, redirectTo?: string, extraParams?: Record<string, string>): string | undefined;
//# sourceMappingURL=build-login-url.d.ts.map