import type { Plugin } from './app';
/** Options for the {@link requestId} plugin. */
export interface RequestIdOptions {
    /**
     * Header carrying the id on the request and echoed on the response. Matched
     * case-insensitively; an inbound value is reused verbatim (never validated or
     * sanitized), so treat it as untrusted where the id reaches logs or storage.
     * Default `x-request-id`.
     */
    header?: string;
    /** Generate an id when the request carries none. Default `crypto.randomUUID`. */
    generate?: () => string;
}
/**
 * Plugin: give every request a correlation id. Reuses an inbound `x-request-id`
 * header (so an id set by a gateway or upstream service flows through) or mints
 * one, exposes it via {@link getRequestId} for handlers, services, and logs, and
 * echoes it on the response.
 *
 * ```ts
 * const app = await createApp({ plugins: [requestId()] })
 * // every response carries `x-request-id`; getRequestId() reads it anywhere
 * ```
 *
 * @param options - Header name and id generator overrides.
 * @returns A plugin that assigns and echoes a per-request correlation id.
 */
export declare function requestId(options?: RequestIdOptions): Plugin;
//# sourceMappingURL=request-id.d.ts.map