/**
 * Route Deprecation Middleware
 * Adds RFC 8594 deprecation headers to responses for deprecated routes
 *
 * @see https://datatracker.ietf.org/doc/html/rfc8594 - The 'Deprecation' HTTP Header Field
 */
import type { DeprecationConfig, MiddlewareDefinition } from "../../types/index.js";
/**
 * Create deprecation middleware
 *
 * This middleware adds RFC 8594 compliant deprecation headers to responses
 * for routes marked as deprecated:
 *
 * - `Deprecation`: RFC 8594 header indicating the route is deprecated
 * - `Sunset`: RFC 8594 header indicating when the route will be removed
 * - `Link`: Header pointing to the alternative route (rel="successor-version")
 * - `X-Deprecation-Notice`: Custom header with a human-readable message
 *
 * @example
 * ```typescript
 * const routes: RouteDefinition[] = [
 *   {
 *     method: "GET",
 *     path: "/api/v1/users",
 *     handler: handleUsers,
 *     deprecated: {
 *       enabled: true,
 *       since: "2.0.0",
 *       removeIn: "3.0.0",
 *       alternative: "/api/v2/users",
 *       message: "Use /api/v2/users instead",
 *     },
 *   },
 * ];
 *
 * const deprecationMiddleware = createDeprecationMiddleware({ routes });
 * server.registerMiddleware(deprecationMiddleware);
 * ```
 */
export declare function createDeprecationMiddleware(config: DeprecationConfig): MiddlewareDefinition;