/**
 * URL construction helpers for dashboard and API URLs.
 *
 * These functions ensure consistent URL construction across the codebase
 * and derive the API URL from the dashboard URL to avoid duplicate env vars.
 */
/**
 * Get the base dashboard URL from environment
 * @returns Dashboard base URL (e.g., 'http://localhost:4000')
 * @throws Error if neither NEXT_PUBLIC_DASHBOARD_URL nor NEXT_PUBLIC_CMS_API_URL is configured
 */
export declare function getDashboardBaseUrl(): string;
/**
 * Get the CMS API URL by appending /api to the dashboard URL
 * @returns API base URL (e.g., 'http://localhost:4000/api' or '/api' in browser)
 * @throws Error if neither NEXT_PUBLIC_DASHBOARD_URL nor NEXT_PUBLIC_CMS_API_URL is configured (server-side only)
 */
export declare function getCmsApiUrl(): string;
/**
 * Get a full dashboard URL for a path within the authenticated dashboard surface (`/dashboard/*`).
 *
 * Uses `getDashboardBaseUrl()` to determine the dashboard host, then appends `/dashboard`.
 *
 * Prefer the `getAbsoluteDashboardUrl` name at call sites where both relative dashboard paths
 * and absolute dashboard URLs are in play, to avoid confusing it with the client-side helper in
 * `apps/dashboard/src/utils/routes/getDashboardUrl.ts`.
 *
 * @example
 * ```ts
 * getAbsoluteDashboardUrl() // -> 'http://localhost:4000/dashboard'
 * getAbsoluteDashboardUrl('sites/site-123/content/event/entry-456') // -> 'http://localhost:4000/dashboard/sites/site-123/content/event/entry-456'
 * ```
 */
export declare function getAbsoluteDashboardUrl(path?: string): string;
/**
 * @deprecated Prefer `getAbsoluteDashboardUrl()` at new call sites so its semantics are explicit.
 */
export declare const getDashboardUrl: typeof getAbsoluteDashboardUrl;
/**
 * Legacy: Get API URL, supporting old NEXT_PUBLIC_CMS_API_URL env var
 * @deprecated Use getCmsApiUrl() instead - this function is maintained for backwards compatibility
 */
export declare function resolveApiBaseUrl(): string;
