import type { Context } from 'hono';
/**
 * Detect the public-facing base URL from request headers.
 *
 * On cloud GPU platforms (RunPod, Vast.ai, etc.), the application runs behind
 * a reverse proxy that sets forwarding headers. This function reads those
 * headers to determine the URL that the user's browser is actually accessing,
 * so that Stripe callbacks, magic link emails, and cookie settings use the
 * correct public URL instead of the internal localhost address.
 *
 * Priority order:
 *   1. X-Forwarded-Proto + X-Forwarded-Host (standard reverse proxy headers)
 *   2. Origin header (sent by browsers on POST/CORS requests)
 *   3. Referer header (fallback — contains the page URL)
 *   4. DASHBOARD_URL env var (internal default: http://127.0.0.1:3367)
 *
 * Returns a base URL with no trailing slash, e.g.:
 *   "https://abc123-3367.proxy.runpod.net"
 *   "http://localhost:3367"
 */
export declare function getPublicBaseUrl(c: Context): string;
/**
 * Get the cancel URL for Stripe checkout, using the detected public URL.
 */
export declare function getCheckoutCancelUrl(c: Context): string;
/**
 * Determine if the current request is coming over HTTPS
 * (for secure cookie settings).
 */
export declare function isSecureRequest(c: Context): boolean;
