routup 5.2.0 → 6.0.0-beta.0

package/dist/index-DdsCL8RI.d.mts

@@ -1,1159 +0,0 @@
-import { FastURL, ServerRequest } from "srvx";
-import { HTTPError, HTTPErrorInput, HTTPErrorInput as HTTPErrorInput$1 } from "@ebec/http";
-import Negotiator from "negotiator";
-import { Key, ParseOptions, PathToRegexpOptions } from "path-to-regexp";
-import { IncomingMessage, ServerResponse } from "node:http";
-
-//#region src/constants.d.ts
-declare const MethodName: {
-  readonly GET: "GET";
-  readonly POST: "POST";
-  readonly PUT: "PUT";
-  readonly PATCH: "PATCH";
-  readonly DELETE: "DELETE";
-  readonly OPTIONS: "OPTIONS";
-  readonly HEAD: "HEAD";
-};
-type MethodName = typeof MethodName[keyof typeof MethodName];
-declare const HeaderName: {
-  readonly ACCEPT: "accept";
-  readonly ACCEPT_CHARSET: "accept-charset";
-  readonly ACCEPT_ENCODING: "accept-encoding";
-  readonly ACCEPT_LANGUAGE: "accept-language";
-  readonly ACCEPT_RANGES: "accept-ranges";
-  readonly ALLOW: "allow";
-  readonly CACHE_CONTROL: "cache-control";
-  readonly CONTENT_DISPOSITION: "content-disposition";
-  readonly CONTENT_ENCODING: "content-encoding";
-  readonly CONTENT_LENGTH: "content-length";
-  readonly CONTENT_RANGE: "content-range";
-  readonly CONTENT_TYPE: "content-type";
-  readonly CONNECTION: "connection";
-  readonly COOKIE: "cookie";
-  readonly ETag: "etag";
-  readonly HOST: "host";
-  readonly IF_MODIFIED_SINCE: "if-modified-since";
-  readonly IF_NONE_MATCH: "if-none-match";
-  readonly LAST_MODIFIED: "last-modified";
-  readonly LOCATION: "location";
-  readonly RANGE: "range";
-  readonly RATE_LIMIT_LIMIT: "ratelimit-limit";
-  readonly RATE_LIMIT_REMAINING: "ratelimit-remaining";
-  readonly RATE_LIMIT_RESET: "ratelimit-reset";
-  readonly RETRY_AFTER: "retry-after";
-  readonly SET_COOKIE: "set-cookie";
-  readonly TRANSFER_ENCODING: "transfer-encoding";
-  readonly X_ACCEL_BUFFERING: "x-accel-buffering";
-  readonly X_FORWARDED_HOST: "x-forwarded-host";
-  readonly X_FORWARDED_FOR: "x-forwarded-for";
-  readonly X_FORWARDED_PROTO: "x-forwarded-proto";
-};
-type HeaderName = typeof HeaderName[keyof typeof HeaderName];
-//#endregion
-//#region src/error/module.d.ts
-declare const ErrorSymbol: unique symbol;
-declare class RoutupError extends HTTPError {
-  constructor(input?: HTTPErrorInput$1);
-}
-//#endregion
-//#region src/event/types.d.ts
-type RoutupResponse = {
-  status: number;
-  headers: Headers;
-};
-type RoutupRequest = ServerRequest;
-type NextFn = (error?: Error) => unknown | Promise<unknown>;
-interface IRoutupEvent {
-  /**
-   * The srvx ServerRequest (extends Web Standard Request).
-   */
-  readonly request: RoutupRequest;
-  /**
-   * Route parameters extracted from the URL path pattern.
-   */
-  readonly params: Record<string, any>;
-  /**
-   * Current request path, adjusted relative to the mount point during router nesting.
-   */
-  readonly path: string;
-  /**
-   * HTTP method (GET, POST, PUT, etc.).
-   */
-  readonly method: string;
-  /**
-   * Accumulated mount path from nested routers.
-   */
-  readonly mountPath: string;
-  /**
-   * Web Standard Headers from the request.
-   */
-  readonly headers: Headers;
-  /**
-   * Lazily-parsed URL search parameters.
-   *
-   * For advanced query parsing (arrays, nesting), use `@routup/query`.
-   */
-  readonly searchParams: URLSearchParams;
-  /**
-   * Response accumulator — set status/headers before returning a plain value.
-   *
-   * If the handler returns a `Response` object directly, these values are
-   * ignored. They only apply when returning plain values (string, object, etc.)
-   * that go through `toResponse()`.
-   */
-  readonly response: RoutupResponse;
-  /**
-   * Per-request store for caching and plugin state.
-   *
-   * Use symbol keys (e.g., `Symbol.for('routup:body')`) to avoid collisions.
-   * Data is garbage collected with the event when the request completes.
-   */
-  readonly store: Record<string | symbol, unknown>;
-  /**
-   * Pre-resolved router options for the current dispatch context.
-   *
-   * Contains merged options from the router path stack with defaults applied.
-   */
-  readonly routerOptions: RouterOptions;
-  /**
-   * Abort signal tied to the request lifecycle.
-   *
-   * When a `timeout` router option is set, this signal aborts after the
-   * specified duration. Handlers performing long I/O (fetch, streams, DB queries)
-   * can pass this signal to those operations for cooperative cancellation.
-   */
-  readonly signal: AbortSignal;
-  /**
-   * Call the next handler in the pipeline (onion model).
-   *
-   * The result is cached — calling `next()` multiple times returns the same response.
-   * Returns the downstream `Response`, or `undefined` if no handler matched.
-   */
-  next(error?: Error): Promise<Response | undefined>;
-  /**
-   * Whether `next()` has been invoked on this event.
-   *
-   * Used by the dispatch pipeline to disambiguate an `undefined` return value:
-   * a handler that returns `undefined` after calling `next()` is forwarding the
-   * downstream result; one that returns `undefined` without calling `next()` is
-   * unresolved and will wait on `signal` (timeout-bounded).
-   */
-  readonly nextCalled: boolean;
-  /**
-   * The cached promise returned by the first `next()` call on this event,
-   * or `undefined` if `next()` has not been invoked.
-   */
-  readonly nextResult: Promise<Response | undefined> | undefined;
-  /**
-   * Returns a promise that resolves the first time `next()` is invoked on this event.
-   *
-   * If `next()` has already been called, the returned promise is already resolved.
-   * Used by the dispatch pipeline so a handler that returns `undefined` and later
-   * calls `next()` asynchronously (e.g. from a `setTimeout`) still propagates the
-   * downstream response instead of hanging until `signal` aborts.
-   */
-  whenNextCalled(): Promise<void>;
-}
-//#endregion
-//#region src/event/module.d.ts
-type RoutupEventCreateContext = {
-  request: RoutupRequest;
-  params: Record<string, any>;
-  path: string;
-  method: string;
-  mountPath: string;
-  headers: Headers;
-  searchParams: URLSearchParams;
-  response: RoutupResponse;
-  store: Record<string | symbol, unknown>;
-  signal: AbortSignal;
-  routerOptions: () => RouterOptions;
-  next: (event: IRoutupEvent, error?: Error) => Promise<Response | undefined>;
-};
-declare class RoutupEvent implements IRoutupEvent {
-  readonly request: RoutupRequest;
-  readonly params: Record<string, any>;
-  readonly path: string;
-  readonly method: string;
-  readonly mountPath: string;
-  readonly headers: Headers;
-  readonly searchParams: URLSearchParams;
-  readonly response: RoutupResponse;
-  readonly store: Record<string | symbol, unknown>;
-  readonly signal: AbortSignal;
-  protected _context: RoutupEventCreateContext;
-  protected _routerOptions?: RouterOptions;
-  protected _nextCalled: boolean;
-  protected _nextResult: Promise<Response | undefined> | undefined;
-  protected _nextCalledDeferred: {
-    promise: Promise<void>;
-    resolve: () => void;
-  } | undefined;
-  constructor(context: RoutupEventCreateContext);
-  get routerOptions(): RouterOptions;
-  get nextCalled(): boolean;
-  get nextResult(): Promise<Response | undefined> | undefined;
-  whenNextCalled(): Promise<void>;
-  next(error?: Error): Promise<Response | undefined>;
-}
-//#endregion
-//#region src/hook/constants.d.ts
-declare const HookName: {
-  readonly REQUEST: "request";
-  readonly RESPONSE: "response";
-  readonly ERROR: "error";
-  readonly CHILD_MATCH: "childMatch";
-  readonly CHILD_DISPATCH_BEFORE: "childDispatchBefore";
-  readonly CHILD_DISPATCH_AFTER: "childDispatchAfter";
-};
-type HookName = typeof HookName[keyof typeof HookName];
-//#endregion
-//#region src/dispatcher/types.d.ts
-interface IDispatcherEvent {
-  /**
-   * The srvx ServerRequest (extends Web Standard Request).
-   */
-  readonly request: RoutupRequest;
-  /**
-   * Route parameters extracted from the URL path pattern.
-   */
-  params: Record<string, any>;
-  /**
-   * Current request path, adjusted relative to the mount point during router nesting.
-   */
-  path: string;
-  /**
-   * HTTP method (GET, POST, PUT, etc.).
-   */
-  readonly method: string;
-  /**
-   * Accumulated mount path from nested routers.
-   */
-  mountPath: string;
-  /**
-   * Response accumulator — set status/headers before returning a plain value.
-   */
-  readonly response: RoutupResponse;
-  /**
-   * Whether a response has been produced.
-   */
-  dispatched: boolean;
-  /**
-   * Error that occurred during dispatch, if any.
-   */
-  error?: RoutupError;
-  /**
-   * Router stack for nesting tracking.
-   * Used internally by router options resolution.
-   */
-  routerPath: RouterPathNode[];
-  /**
-   * Abort signal for cooperative cancellation.
-   *
-   * When a `timeout` router option is set, this signal aborts after the
-   * specified duration. Handlers can pass it to fetch(), streams, or other
-   * AbortSignal-aware APIs.
-   */
-  signal: AbortSignal;
-  /**
-   * Collected allowed methods for the current path (used for OPTIONS / 405 responses).
-   */
-  methodsAllowed: Set<string>;
-  /**
-   * Set the continuation function for this event.
-   *
-   * Replaces the current continuation. The provided function receives
-   * an optional error and may return any value — it will be converted
-   * to a `Response` via `toResponse()`.
-   *
-   * Passing `undefined` clears the continuation function.
-   */
-  setNext(fn?: NextFn): void;
-  /**
-   * Build a public RoutupEvent from the current dispatch state.
-   *
-   * Creates a lightweight snapshot with shared references (store, response, headers)
-   * and pre-resolved router options. This is the event passed to handler functions.
-   *
-   * @param signal - Optional AbortSignal override. When provided, the built event
-   *                 uses this signal instead of the dispatcher event's own signal.
-   *                 Used by per-handler timeout to provide a handler-scoped signal.
-   */
-  build(signal?: AbortSignal): RoutupEvent;
-}
-interface IDispatcher {
-  dispatch(event: IDispatcherEvent): Promise<Response | undefined>;
-}
-//#endregion
-//#region src/hook/types.d.ts
-type HookErrorListener = (event: IDispatcherEvent) => Promise<unknown> | unknown;
-type HookDefaultListener = (event: IDispatcherEvent) => Promise<unknown> | unknown;
-type HookListener = HookErrorListener | HookDefaultListener;
-type HookUnsubscribeFn = () => void;
-interface IHooks {
-  addListener(name: HookName, fn: HookListener, priority?: number): HookUnsubscribeFn;
-  removeListener(name: HookName): void;
-  removeListener(name: HookName, fn: HookListener): void;
-  removeListener(name: HookName, fn?: HookListener): void;
-  clone(): IHooks;
-  trigger(name: HookName, event: IDispatcherEvent): Promise<void>;
-}
-//#endregion
-//#region src/path/type.d.ts
-type PathMatcherOptions = PathToRegexpOptions & ParseOptions;
-type PathMatcherExecResult = {
-  path: string;
-  params: Record<string, any>;
-};
-type Path = string;
-//#endregion
-//#region src/path/matcher.d.ts
-declare class PathMatcher {
-  protected path: Path;
-  protected regexp: RegExp;
-  protected regexpKeys: Key[];
-  protected regexpOptions: PathMatcherOptions;
-  constructor(path: Path, options?: PathMatcherOptions);
-  test(path: string): boolean;
-  exec(path: string): PathMatcherExecResult | undefined;
-}
-//#endregion
-//#region src/path/utils.d.ts
-declare function isPath(input: unknown): input is Path;
-//#endregion
-//#region src/handler/constants.d.ts
-declare const HandlerType: {
-  readonly CORE: "core";
-  readonly ERROR: "error";
-};
-type HandlerType = typeof HandlerType[keyof typeof HandlerType];
-declare const HandlerSymbol: unique symbol;
-//#endregion
-//#region src/handler/types-base.d.ts
-type HandlerBaseOptions = {
-  method?: Uppercase<MethodName> | Lowercase<MethodName>;
-  path?: Path;
-  /**
-   * Per-handler timeout in milliseconds.
-   *
-   * Overrides the router's `handlerTimeout` default. Whether this value
-   * can extend or only narrow the default is controlled by the router's
-   * `handlerTimeoutOverridable` option.
-   */
-  timeout?: number;
-  onError?: HookErrorListener;
-  onBefore?: HookDefaultListener;
-  onAfter?: HookDefaultListener;
-};
-//#endregion
-//#region src/handler/error/types.d.ts
-type ErrorHandler = (error: RoutupError, event: IRoutupEvent) => unknown | Promise<unknown>;
-type ErrorHandlerOptions = HandlerBaseOptions & {
-  type: typeof HandlerType.ERROR;
-  fn: ErrorHandler;
-};
-//#endregion
-//#region src/handler/error/define.d.ts
-/**
- * Create an error handler.
- *
- * Error handlers receive errors thrown by preceding handlers in the pipeline.
- *
- * @param input - Handler function `(error, event) => value` or options object `{ fn, path? }`
- *
- * @example
- * ```typescript
- * router.use(defineErrorHandler((error, event) => {
- *     return { message: error.message };
- * }));
- * ```
- */
-declare function defineErrorHandler(input: Omit<ErrorHandlerOptions, 'type'>): Handler;
-declare function defineErrorHandler(input: ErrorHandler): Handler;
-//#endregion
-//#region src/handler/types.d.ts
-type HandlerOptions = CoreHandlerOptions | ErrorHandlerOptions;
-//#endregion
-//#region src/handler/module.d.ts
-declare class Handler implements IDispatcher {
-  protected config: HandlerOptions;
-  protected hooks: IHooks;
-  protected pathMatcher: PathMatcher | undefined;
-  readonly method: MethodName | undefined;
-  constructor(handler: HandlerOptions);
-  get type(): "error" | "core";
-  get path(): string | undefined;
-  dispatch(event: IDispatcherEvent): Promise<Response | undefined>;
-  matchPath(path: string): boolean;
-  /**
-   * Resolve a handler's return value into the final value handed to `toResponse`.
-   *
-   * Contract:
-   * - non-undefined value → return as-is (becomes the response)
-   * - `undefined` + `event.next()` was called → forward downstream result
-   * - `undefined` + `event.next()` not yet called → wait until either `next()` is
-   *   invoked (e.g. from an async callback) or `signal` aborts. A global or
-   *   per-handler timeout aborts `signal` and surfaces as 408. With no timeout
-   *   configured and no eventual `next()` call, the request hangs by design.
-   */
-  protected resolveHandlerResult(invocation: unknown | Promise<unknown>, handlerEvent: IRoutupEvent): Promise<unknown>;
-  protected executeWithTimeout(fn: () => unknown | Promise<unknown>, routerOptions: RouterOptions, controller?: AbortController): Promise<unknown>;
-  protected resolveTimeout(routerOptions: RouterOptions): number | undefined;
-  protected mountHooks(): void;
-}
-//#endregion
-//#region src/handler/core/types.d.ts
-type CoreHandler = (event: IRoutupEvent) => unknown | Promise<unknown>;
-type CoreHandlerOptions = HandlerBaseOptions & {
-  type: typeof HandlerType.CORE;
-  fn: CoreHandler;
-};
-//#endregion
-//#region src/handler/core/define.d.ts
-/**
- * Create a request handler.
- *
- * @param input - Handler function `(event) => value` or options object `{ fn, path?, method? }`
- *
- * @example
- * ```typescript
- * // Shorthand — function only
- * router.get('/', defineCoreHandler((event) => 'Hello'));
- *
- * // Verbose — with path and method
- * router.use(defineCoreHandler({
- *     path: '/users/:id',
- *     method: 'GET',
- *     fn: (event) => ({ id: event.params.id }),
- * }));
- * ```
- */
-declare function defineCoreHandler(input: Omit<CoreHandlerOptions, 'type'>): Handler;
-declare function defineCoreHandler(input: CoreHandler): Handler;
-//#endregion
-//#region src/handler/adapters/node/types.d.ts
-type NodeHandler = (req: IncomingMessage, res: ServerResponse) => unknown | Promise<unknown>;
-type NodeMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => unknown | Promise<unknown>;
-//#endregion
-//#region src/handler/adapters/node/define.d.ts
-/**
- * Wraps a Node.js `(req, res)` handler for use in the routup pipeline.
- *
- * @example
- * ```typescript
- * import { fromNodeHandler } from 'routup/node';
- *
- * router.use(fromNodeHandler((req, res) => {
- *     res.end('Hello');
- * }));
- * ```
- */
-declare function fromNodeHandler(handler: NodeHandler): Handler;
-/**
- * Wraps a Node.js `(req, res, next)` middleware for use in the routup pipeline.
- *
- * @example
- * ```typescript
- * import cors from 'cors';
- * import { fromNodeMiddleware } from 'routup/node';
- *
- * router.use(fromNodeMiddleware(cors()));
- * ```
- */
-declare function fromNodeMiddleware(handler: NodeMiddleware): Handler;
-//#endregion
-//#region src/handler/adapters/web/types.d.ts
-/**
- * A plain function that follows the Web Fetch API signature.
- * Compatible with any framework that exposes a fetch-style entry point.
- */
-interface WebHandler {
-  (request: Request): Response | Promise<Response>;
-}
-/**
- * An object with a `fetch` method (e.g. another router, Hono app, etc.).
- */
-interface WebHandlerProvider {
-  fetch(request: Request): Response | Promise<Response>;
-}
-//#endregion
-//#region src/handler/adapters/web/define.d.ts
-/**
- * Create a handler from a Web Fetch API-compatible function or object.
- *
- * Wraps an external app (e.g. Hono, another Router) so it can be mounted
- * via `router.use()`. The original request is passed through as-is.
- *
- * @param input - Fetch function `(request) => Response` or object with a `fetch` method
- *
- * @experimental
- *
- * @example
- * ```ts
- * // Mount an object with a fetch method
- * router.use('/api', fromWebHandler(honoApp));
- *
- * // Mount a plain fetch function
- * router.use('/proxy', fromWebHandler((req) => fetch(req)));
- * ```
- */
-declare function fromWebHandler(input: WebHandler): Handler;
-declare function fromWebHandler(input: WebHandlerProvider): Handler;
-//#endregion
-//#region src/handler/adapters/web/is.d.ts
-declare function isWebHandlerProvider(input: unknown): input is WebHandlerProvider;
-declare function isWebHandler(input: unknown): input is WebHandler;
-//#endregion
-//#region src/handler/is.d.ts
-declare function isHandlerOptions(input: unknown): input is HandlerOptions;
-declare function isHandler(input: unknown): input is Handler;
-//#endregion
-//#region src/handler/utils.d.ts
-/**
- * Build a `PathMatcher` for a handler-side path.
- *
- * Returns `undefined` when no path is supplied. The `end` flag controls
- * whether the matcher requires a full match (`true` for method handlers
- * matching exact routes) or accepts a prefix (`false` for middleware).
- */
-declare function buildHandlerPathMatcher(path: Path | undefined, end: boolean): PathMatcher | undefined;
-/**
- * Match a request method against a handler's bound method.
- *
- * - When the handler has no method bound, matches every request method.
- * - Otherwise matches when the request method is the same.
- * - HEAD requests additionally match GET handlers.
- */
-declare function matchHandlerMethod(handlerMethod: MethodName | undefined, requestMethod: MethodName): boolean;
-//#endregion
-//#region src/plugin/error/constants.d.ts
-declare const PluginErrorCode: {
-  readonly PLUGIN: "PLUGIN";
-  readonly NOT_INSTALLED: "PLUGIN_NOT_INSTALLED";
-  readonly ALREADY_INSTALLED: "PLUGIN_ALREADY_INSTALLED";
-  readonly INSTALL: "PLUGIN_INSTALL";
-};
-type PluginErrorCode = typeof PluginErrorCode[keyof typeof PluginErrorCode];
-//#endregion
-//#region src/plugin/error/module.d.ts
-declare class PluginError extends RoutupError {
-  constructor(input?: HTTPErrorInput);
-}
-//#endregion
-//#region src/plugin/error/is.d.ts
-declare function isPluginError(input: unknown): input is PluginError;
-//#endregion
-//#region src/plugin/error/sub/already-installed.d.ts
-declare class PluginAlreadyInstalledError extends PluginError {
-  readonly pluginName: string;
-  constructor(pluginName: string);
-}
-//#endregion
-//#region src/plugin/error/sub/install.d.ts
-declare class PluginInstallError extends PluginError {
-  readonly pluginName: string;
-  constructor(pluginName: string, cause?: Error);
-}
-//#endregion
-//#region src/plugin/error/sub/not-installed.d.ts
-declare class PluginNotInstalledError extends PluginError {
-  readonly pluginName: string;
-  readonly helperName: string;
-  constructor(pluginName: string, helperName: string);
-}
-//#endregion
-//#region src/plugin/types.d.ts
-type PluginInstallFn = (router: IRouter) => any;
-type Plugin = {
-  /**
-   * The name of the plugin.
-   */
-  name: string;
-  /**
-   * The version of the plugin (semver).
-   */
-  version?: string;
-  /**
-   * The installation function called on registration.
-   */
-  install: PluginInstallFn;
-};
-type PluginInstallContext = {
-  /**
-   * By specifying a path, the plugin will be installed as a child router.
-   */
-  path?: Path;
-};
-//#endregion
-//#region src/plugin/is.d.ts
-declare function isPlugin(input: unknown): input is Plugin;
-//#endregion
-//#region src/utils/etag/types.d.ts
-type EtagOptions = {
-  /**
-   * Create a weak ETag?
-   * Output is prefixed with: /W
-   */
-  weak?: boolean;
-  /**
-   * Threshold of bytes from which an etag is generated.
-   *
-   * default: undefined
-   */
-  threshold?: number;
-};
-type EtagFn = (body: string, size?: number) => Promise<string | undefined>;
-type EtagInput = boolean | EtagOptions | EtagFn;
-//#endregion
-//#region src/utils/trust-proxy/type.d.ts
-type TrustProxyFn = (address: string, hop: number) => boolean;
-type TrustProxyInput = boolean | number | string | string[] | TrustProxyFn;
-//#endregion
-//#region src/router/constants.d.ts
-declare const RouterPipelineStep: {
-  readonly START: 0;
-  readonly LOOKUP: 1;
-  readonly CHILD_BEFORE: 2;
-  readonly CHILD_DISPATCH: 3;
-  readonly CHILD_AFTER: 4;
-  readonly FINISH: 5;
-};
-type RouterPipelineStep = typeof RouterPipelineStep[keyof typeof RouterPipelineStep];
-declare const RouterStackEntryType: {
-  readonly ROUTER: "router";
-  readonly HANDLER: "handler";
-};
-type RouterStackEntryType = typeof RouterStackEntryType[keyof typeof RouterStackEntryType];
-//#endregion
-//#region src/router/types.d.ts
-type RouterOptions = {
-  path?: Path;
-  name?: string;
-  /**
-   * Global request timeout in milliseconds.
-   *
-   * Applies to the entire dispatch pipeline in `fetch()`. When exceeded,
-   * the request is aborted and a 408 response is returned. The AbortSignal
-   * on the event is also aborted for cooperative cancellation.
-   */
-  timeout?: number;
-  /**
-   * Default per-handler timeout in milliseconds.
-   *
-   * Applies individually to each handler's `fn()` execution. Handlers can
-   * override this value via their own `timeout` option — see
-   * `handlerTimeoutOverridable` to control whether overrides can extend
-   * or only narrow this default.
-   */
-  handlerTimeout?: number;
-  /**
-   * Whether handlers can extend the `handlerTimeout` default.
-   *
-   * When `false` (default), a handler's `timeout` is clamped to
-   * `Math.min(handlerTimeout, handler.timeout)`. When `true`, the
-   * handler's `timeout` fully replaces the router default.
-   */
-  handlerTimeoutOverridable?: boolean;
-  subdomainOffset: number;
-  proxyIpMax: number;
-  etag: EtagFn;
-  trustProxy: TrustProxyFn;
-};
-type RouterOptionsInput = Omit<Partial<RouterOptions>, 'etag' | 'trustProxy'> & {
-  etag?: EtagInput;
-  trustProxy?: TrustProxyInput;
-  hooks?: IHooks;
-  plugins?: Map<string, string | undefined>;
-};
-type RouterPathNode = {
-  readonly name?: string;
-  readonly options: Partial<RouterOptions>;
-};
-type StackRouterEntry = {
-  type: typeof RouterStackEntryType.ROUTER;
-  data: IRouter;
-  /**
-   * Original mount path the entry was registered with, retained so
-   * `Router.clone()` can re-register the entry via the public API.
-   */
-  path?: Path;
-  /**
-   * Mount-specific path matcher.
-   *
-   * Set when the router was mounted under a path (e.g. `parent.use('/api', child)`).
-   * When undefined, the lookup falls back to the router's own intrinsic matcher.
-   */
-  pathMatcher?: PathMatcher;
-};
-type StackHandlerEntry = {
-  type: typeof RouterStackEntryType.HANDLER;
-  data: Handler;
-  /**
-   * Original mount path the entry was registered with, retained so
-   * `Router.clone()` can re-register the entry via the public API.
-   */
-  path?: Path;
-  /**
-   * Mount-specific path matcher.
-   *
-   * Set when the handler was registered under a path (e.g.
-   * `parent.use('/api', handler)`). When undefined, the lookup falls back
-   * to the handler's own intrinsic matcher.
-   */
-  pathMatcher?: PathMatcher;
-  /**
-   * Mount-specific HTTP method.
-   *
-   * Set when the handler was registered via a method-bound shortcut
-   * (e.g. `router.get(handler)` sets this to `GET`). When undefined,
-   * dispatch falls back to the handler's own intrinsic method.
-   */
-  method?: MethodName;
-};
-type StackEntry = StackRouterEntry | StackHandlerEntry;
-type RouterPipelineContext = {
-  step: RouterPipelineStep;
-  event: IDispatcherEvent;
-  stackIndex: number;
-  response?: Response;
-};
-interface IRouter extends IDispatcher {
-  /**
-   * Optional label for the router instance.
-   */
-  readonly name?: string;
-  /**
-   * Public entry point — processes a request through the pipeline
-   * and returns a Response (with 404/500 fallbacks).
-   */
-  fetch(request: RoutupRequest): Promise<Response>;
-  /**
-   * Test if a path matches this router's mount path.
-   */
-  matchPath(path: string): boolean;
-  /**
-   * Return a new router that mirrors this one but owns independent
-   * mountable state — fresh stack of shallow-copied entries (handlers and
-   * child routers shared by reference), fresh `Hooks` seeded with the
-   * current listeners, shallow copy of options, and a fresh plugins map.
-   *
-   * Intended for mounting the same logical router under multiple paths
-   * without sharing mutable state across mount points.
-   */
-  clone(): IRouter;
-  /**
-   * Check if a plugin with the given name is installed on this router.
-   */
-  hasPlugin(name: string): boolean;
-  /**
-   * Get the version of an installed plugin by name on this router,
-   * or `undefined` if the plugin is not installed here.
-   */
-  getPluginVersion(name: string): string | undefined;
-  /**
-   * Register a handler, router, or plugin.
-   * When a path is provided, the item is mounted at that path.
-   */
-  use(router: IRouter): this;
-  use(handler: Handler | HandlerOptions): this;
-  use(plugin: Plugin): this;
-  use(path: Path, router: IRouter): this;
-  use(path: Path, handler: Handler | HandlerOptions): this;
-  use(path: Path, plugin: Plugin): this;
-  /** Register GET handler(s). */
-  get(...handlers: (Handler | HandlerOptions)[]): this;
-  get(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /** Register POST handler(s). */
-  post(...handlers: (Handler | HandlerOptions)[]): this;
-  post(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /** Register PUT handler(s). */
-  put(...handlers: (Handler | HandlerOptions)[]): this;
-  put(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /** Register PATCH handler(s). */
-  patch(...handlers: (Handler | HandlerOptions)[]): this;
-  patch(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /** Register DELETE handler(s). */
-  delete(...handlers: (Handler | HandlerOptions)[]): this;
-  delete(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /** Register HEAD handler(s). */
-  head(...handlers: (Handler | HandlerOptions)[]): this;
-  head(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /** Register OPTIONS handler(s). */
-  options(...handlers: (Handler | HandlerOptions)[]): this;
-  options(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  /**
-   * Add a hook listener.
-   */
-  on(name: typeof HookName.REQUEST | typeof HookName.RESPONSE | typeof HookName.CHILD_DISPATCH_BEFORE | typeof HookName.CHILD_DISPATCH_AFTER, fn: HookDefaultListener): HookUnsubscribeFn;
-  on(name: typeof HookName.CHILD_MATCH, fn: HookDefaultListener): HookUnsubscribeFn;
-  on(name: typeof HookName.ERROR, fn: HookErrorListener): HookUnsubscribeFn;
-  /**
-   * Remove a specific or all hook listeners for the given hook name.
-   */
-  off(name: HookName): this;
-  off(name: HookName, fn: HookListener): this;
-}
-//#endregion
-//#region src/dispatcher/module.d.ts
-declare class DispatcherEvent implements IDispatcherEvent {
-  readonly request: RoutupRequest;
-  params: Record<string, any>;
-  path: string;
-  readonly method: string;
-  /**
-   * Collected allowed methods (for OPTIONS).
-   */
-  methodsAllowed: Set<string>;
-  mountPath: string;
-  error?: RoutupError;
-  routerPath: RouterPathNode[];
-  protected _dispatched: boolean;
-  protected _response?: RoutupResponse;
-  protected _store?: Record<string | symbol, unknown>;
-  /**
-   * Cached parsed URL (avoids double-parsing).
-   */
-  protected _url: InstanceType<typeof FastURL>;
-  /**
-   * Continuation function for middleware onion model.
-   */
-  protected _next?: (event: IRoutupEvent, error?: Error) => Promise<Response | undefined>;
-  protected _signal?: AbortSignal;
-  protected _signalCleanup?: () => void;
-  /**
-   * Whether _next has already been called (guard against double-invocation).
-   */
-  protected _nextCalled: boolean;
-  /**
-   * The cached result of the next handler.
-   */
-  protected _nextResult?: Promise<Response | undefined>;
-  constructor(request: RoutupRequest);
-  get response(): RoutupResponse;
-  get signal(): AbortSignal;
-  set signal(value: AbortSignal);
-  get dispatched(): boolean;
-  set dispatched(value: boolean);
-  protected next(event: IRoutupEvent, error?: Error): Promise<Response | undefined>;
-  setNext(fn?: NextFn): void;
-  build(signal?: AbortSignal): RoutupEvent;
-  protected get store(): Record<string | symbol, unknown>;
-  protected resolveOptions(): RouterOptions;
-}
-//#endregion
-//#region src/router/module.d.ts
-declare class Router implements IRouter {
-  /**
-   * A label for the router instance.
-   */
-  readonly name?: string;
-  /**
-   * Array of mounted layers, routes & routers, each tagged by kind so the
-   * dispatch loop can discriminate without `isRouterInstance`/`isHandler`
-   * runtime checks.
-   *
-   * @protected
-   */
-  protected stack: StackEntry[];
-  /**
-   * Path matcher for the current mount path.
-   *
-   * @protected
-   */
-  protected pathMatcher: PathMatcher | undefined;
-  /**
-   * Lifecycle hook registry.
-   *
-   * @protected
-   */
-  protected hooks: IHooks;
-  /**
-   * Normalized options for this router instance.
-   */
-  protected _options: Partial<RouterOptions>;
-  /**
-   * Registry of installed plugins (name → version) on this router.
-   *
-   * @protected
-   */
-  protected plugins: Map<string, string | undefined>;
-  constructor(input?: RouterOptionsInput);
-  matchPath(path: string): boolean;
-  /**
-   * Public entry point — creates a DispatcherEvent from the request,
-   * runs the pipeline, and returns a Response (with 404/500 fallbacks).
-   */
-  fetch(request: RoutupRequest): Promise<Response>;
-  protected buildFallbackResponse(request: RoutupRequest, event: IDispatcherEvent, status: number, message: string): Response;
-  protected executePipelineStep(context: RouterPipelineContext): Promise<void>;
-  protected executePipelineStepStart(context: RouterPipelineContext): Promise<void>;
-  protected executePipelineStepLookup(context: RouterPipelineContext): Promise<void>;
-  protected executePipelineStepChildBefore(context: RouterPipelineContext): Promise<void>;
-  protected executePipelineStepChildAfter(context: RouterPipelineContext): Promise<void>;
-  protected executePipelineStepChildDispatch(context: RouterPipelineContext): Promise<void>;
-  protected executePipelineStepFinish(context: RouterPipelineContext): Promise<void>;
-  dispatch(event: IDispatcherEvent): Promise<Response | undefined>;
-  delete(...handlers: (Handler | HandlerOptions)[]): this;
-  delete(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  get(...handlers: (Handler | HandlerOptions)[]): this;
-  get(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  post(...handlers: (Handler | HandlerOptions)[]): this;
-  post(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  put(...handlers: (Handler | HandlerOptions)[]): this;
-  put(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  patch(...handlers: (Handler | HandlerOptions)[]): this;
-  patch(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  head(...handlers: (Handler | HandlerOptions)[]): this;
-  head(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  options(...handlers: (Handler | HandlerOptions)[]): this;
-  options(path: Path, ...handlers: (Handler | HandlerOptions)[]): this;
-  protected useForMethod(method: MethodName, ...input: (Path | Handler | HandlerOptions)[]): void;
-  use(router: IRouter): this;
-  use(handler: Handler | HandlerOptions): this;
-  use(plugin: Plugin): this;
-  use(path: Path, router: IRouter): this;
-  use(path: Path, handler: Handler | HandlerOptions): this;
-  use(path: Path, plugin: Plugin): this;
-  /**
-   * Check if a plugin with the given name is installed on this router.
-   */
-  hasPlugin(name: string): boolean;
-  /**
-   * Get the version of an installed plugin by name on this router,
-   * or `undefined` if the plugin is not installed here.
-   */
-  getPluginVersion(name: string): string | undefined;
-  protected install(plugin: Plugin, context?: PluginInstallContext): this;
-  /**
-   * Return a new `Router` that mirrors this one but owns independent
-   * mountable state.
-   *
-   * The new router has:
-   * - a fresh `stack` array of shallow-copied entries (handlers and child
-   *   routers are shared by reference; only the wrapping entries are new)
-   * - the same `pathMatcher` reference (it is stateless)
-   * - a fresh `Hooks` instance seeded with the current listeners
-   * - a shallow copy of `_options`
-   * - a fresh `plugins` map with the same entries
-   *
-   * Use this when the same logical router needs to be mounted under
-   * multiple paths — each mount can receive its own clone so subsequent
-   * mutations on one mount do not bleed into the others.
-   */
-  clone(): IRouter;
-  /**
-   * Add a hook listener.
-   *
-   * @param name
-   * @param fn
-   */
-  on(name: typeof HookName.REQUEST | typeof HookName.RESPONSE | typeof HookName.CHILD_DISPATCH_BEFORE | typeof HookName.CHILD_DISPATCH_AFTER, fn: HookDefaultListener, priority?: number): HookUnsubscribeFn;
-  on(name: typeof HookName.CHILD_MATCH, fn: HookDefaultListener, priority?: number): HookUnsubscribeFn;
-  on(name: typeof HookName.ERROR, fn: HookErrorListener, priority?: number): HookUnsubscribeFn;
-  /**
-   * Remove single or all hook listeners.
-   *
-   * @param name
-   */
-  off(name: HookName): this;
-  off(name: HookName, fn: HookListener): this;
-}
-//#endregion
-//#region src/error/create.d.ts
-/**
- * Create an internal error object by
- * - an existing RoutupError (returned as-is)
- * - an HTTPError (wrapped into a RoutupError preserving status)
- * - an Error (wrapped preserving message and cause)
- * - an options object (status, message, etc.)
- * - a message string
- *
- * @param input
- */
-declare function createError(input: HTTPErrorInput | unknown): RoutupError;
-//#endregion
-//#region src/error/is.d.ts
-declare function isError(input: unknown): input is RoutupError;
-//#endregion
-//#region src/response/helpers/cache.d.ts
-type ResponseCacheHeadersOptions = {
-  maxAge?: number;
-  modifiedTime?: string | Date;
-  cacheControls?: string[];
-};
-declare function setResponseCacheHeaders(event: IRoutupEvent, options?: ResponseCacheHeadersOptions): void;
-//#endregion
-//#region src/response/helpers/event-stream/types.d.ts
-/**
- * https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#event_stream_format
- */
-type EventStreamMessage = {
-  /**
-   * The event ID to set the EventSource object's last event ID value.
-   */
-  id?: string;
-  /**
-   * The reconnection time.
-   * If the connection to the server is lost, the browser will wait for the specified time before attempting to reconnect.
-   * This must be an integer, specifying the reconnection time in milliseconds.
-   */
-  retry?: number;
-  /**
-   * The data field for the message.
-   */
-  data: string;
-  /**
-   * A string identifying the type of event described.
-   */
-  event?: string;
-};
-type EventStreamListener<T = any> = (err: Error | null, data: T) => void | Promise<void>;
-//#endregion
-//#region src/response/helpers/event-stream/module.d.ts
-type EventStreamOptions = {
-  maxMessageSize?: number;
-};
-type EventStreamHandle = {
-  write(message: string | EventStreamMessage): boolean;
-  end(): void;
-  response: Response;
-};
-declare function createEventStream(event: IRoutupEvent, options?: EventStreamOptions): EventStreamHandle;
-//#endregion
-//#region src/response/helpers/event-stream/utils.d.ts
-declare function serializeEventStreamMessage(message: EventStreamMessage): string;
-//#endregion
-//#region src/response/helpers/header.d.ts
-declare function appendResponseHeader(event: IRoutupEvent, name: string, value: string | string[]): void;
-declare function appendResponseHeaderDirective(event: IRoutupEvent, name: string, value: string | string[]): void;
-//#endregion
-//#region src/response/helpers/header-disposition.d.ts
-declare function setResponseHeaderAttachment(event: IRoutupEvent, filename?: string): void;
-declare function setResponseHeaderInline(event: IRoutupEvent, filename?: string): void;
-//#endregion
-//#region src/response/helpers/header-content-type.d.ts
-declare function setResponseHeaderContentType(event: IRoutupEvent, input: string, ifNotExists?: boolean): void;
-//#endregion
-//#region src/response/helpers/send-accepted.d.ts
-declare function sendAccepted(event: IRoutupEvent, data?: unknown): Promise<Response>;
-//#endregion
-//#region src/response/helpers/send-created.d.ts
-declare function sendCreated(event: IRoutupEvent, data?: unknown): Promise<Response>;
-//#endregion
-//#region src/response/helpers/send-file.d.ts
-type SendFileContentOptions = {
-  end?: number;
-  start?: number;
-};
-/**
- * File metadata used by {@link sendFile}. All fields are optional, but each
- * missing field disables related response features:
- *
- * - `size`  — without it, range requests, `Accept-Ranges`, `Content-Length`,
- *             `ETag`, and `Last-Modified` are all omitted (the response is sent
- *             without HTTP-level caching or seekability).
- * - `mtime` — without it, `Last-Modified` is omitted and the `ETag` is not
- *             emitted (`ETag` requires both `size` and `mtime`).
- * - `name`  — falls back to `SendFileOptions.name` when set; if both are
- *             missing, no `Content-Disposition` or extension-derived
- *             `Content-Type` is set.
- */
-type SendFileStats = {
-  size?: number;
-  mtime?: Date | number | string;
-  name?: string;
-};
-type SendFileDisposition = 'attachment' | 'inline';
-type SendFileContent = ReadableStream | ArrayBuffer | Uint8Array;
-type SendFileOptions = {
-  stats: (() => Promise<SendFileStats> | SendFileStats) | SendFileStats;
-  content: (options: SendFileContentOptions) => Promise<SendFileContent> | SendFileContent;
-  /**
-   * @deprecated Use `disposition: 'attachment'` instead. Kept for backwards
-   * compatibility — when `disposition` is set, it takes precedence.
-   */
-  attachment?: boolean;
-  disposition?: SendFileDisposition;
-  name?: string;
-};
-declare function sendFile(event: IRoutupEvent, options: SendFileOptions): Promise<Response>;
-//#endregion
-//#region src/response/helpers/send-format.d.ts
-type ResponseFormatHandler = () => Response | unknown;
-type ResponseFormats = {
-  default: ResponseFormatHandler;
-  [key: string]: ResponseFormatHandler;
-};
-declare function sendFormat(event: IRoutupEvent, input: ResponseFormats): Response | unknown | undefined;
-//#endregion
-//#region src/response/helpers/send-redirect.d.ts
-declare function sendRedirect(event: IRoutupEvent, location: string, statusCode?: number): Response;
-//#endregion
-//#region src/response/helpers/send-stream.d.ts
-declare function sendStream(event: IRoutupEvent, stream: ReadableStream): Response;
-//#endregion
-//#region src/response/helpers/utils.d.ts
-declare function setResponseContentTypeByFileName(event: IRoutupEvent, fileName: string): void;
-//#endregion
-//#region src/response/to-response.d.ts
-declare function toResponse(value: unknown, event: IRoutupEvent): Promise<Response | undefined>;
-//#endregion
-//#region src/request/helpers/cache.d.ts
-declare function isRequestCacheable(event: IRoutupEvent, modifiedTime: string | Date): boolean;
-//#endregion
-//#region src/request/helpers/header.d.ts
-declare function getRequestHeader(event: IRoutupEvent, name: string): string | null;
-//#endregion
-//#region src/request/helpers/header-accept.d.ts
-declare function getRequestAcceptableContentTypes(event: IRoutupEvent): string[];
-declare function getRequestAcceptableContentType(event: IRoutupEvent, input?: string | string[]): string | undefined;
-//#endregion
-//#region src/request/helpers/header-accept-charset.d.ts
-declare function getRequestAcceptableCharsets(event: IRoutupEvent): string[];
-declare function getRequestAcceptableCharset(event: IRoutupEvent, input: string | string[]): string | undefined;
-//#endregion
-//#region src/request/helpers/header-accept-encoding.d.ts
-declare function getRequestAcceptableEncodings(event: IRoutupEvent): string[];
-declare function getRequestAcceptableEncoding(event: IRoutupEvent, input: string | string[]): string | undefined;
-//#endregion
-//#region src/request/helpers/header-accept-language.d.ts
-declare function getRequestAcceptableLanguages(event: IRoutupEvent): string[];
-declare function getRequestAcceptableLanguage(event: IRoutupEvent, input?: string | string[]): string | undefined;
-//#endregion
-//#region src/request/helpers/header-content-type.d.ts
-declare function matchRequestContentType(event: IRoutupEvent, contentType: string): boolean;
-//#endregion
-//#region src/request/helpers/hostname.d.ts
-type RequestHostNameOptions = {
-  trustProxy?: TrustProxyInput;
-};
-declare function getRequestHostName(event: IRoutupEvent, options?: RequestHostNameOptions): string | undefined;
-//#endregion
-//#region src/request/helpers/ip.d.ts
-type RequestIpOptions = {
-  trustProxy?: TrustProxyInput;
-};
-/**
- * Get the client IP address from the request.
- *
- * When `trustProxy` is configured, walks the `X-Forwarded-For` chain
- * and returns the rightmost untrusted address (the actual client IP).
- * Falls back to `event.request.ip` (the direct connection IP).
- */
-declare function getRequestIP(event: IRoutupEvent, options?: RequestIpOptions): string | undefined;
-//#endregion
-//#region src/request/helpers/negotiator.d.ts
-declare function useRequestNegotiator(event: IRoutupEvent): Negotiator;
-//#endregion
-//#region src/request/helpers/protocol.d.ts
-type RequestProtocolOptions = {
-  trustProxy?: TrustProxyInput;
-  default?: string;
-};
-declare function getRequestProtocol(event: IRoutupEvent, options?: RequestProtocolOptions): string;
-//#endregion
-//#region src/router/options.d.ts
-declare function normalizeRouterOptions(input: RouterOptionsInput): Partial<RouterOptions>;
-//#endregion
-export { RouterPathNode as $, RoutupError as $t, sendFile as A, Handler as At, EventStreamOptions as B, Path as Bt, sendRedirect as C, fromNodeHandler as Ct, SendFileDisposition as D, defineCoreHandler as Dt, SendFileContentOptions as E, NodeMiddleware as Et, setResponseHeaderInline as F, HandlerBaseOptions as Ft, setResponseCacheHeaders as G, RoutupEvent as Gt, EventStreamListener as H, PathMatcherOptions as Ht, appendResponseHeader as I, HandlerSymbol as It, Router as J, NextFn as Jt, isError as K, RoutupEventCreateContext as Kt, appendResponseHeaderDirective as L, HandlerType as Lt, sendAccepted as M, defineErrorHandler as Mt, setResponseHeaderContentType as N, ErrorHandler as Nt, SendFileOptions as O, CoreHandler as Ot, setResponseHeaderAttachment as P, ErrorHandlerOptions as Pt, RouterOptionsInput as Q, HTTPErrorInput$1 as Qt, serializeEventStreamMessage as R, isPath as Rt, sendStream as S, WebHandlerProvider as St, SendFileContent as T, NodeHandler as Tt, EventStreamMessage as U, IDispatcher as Ut, createEventStream as V, PathMatcherExecResult as Vt, ResponseCacheHeadersOptions as W, IDispatcherEvent as Wt, IRouter as X, RoutupResponse as Xt, DispatcherEvent as Y, RoutupRequest as Yt, RouterOptions as Z, ErrorSymbol as Zt, getRequestAcceptableContentTypes as _, isHandlerOptions as _t, RequestIpOptions as a, Plugin as at, toResponse as b, fromWebHandler as bt, getRequestHostName as c, PluginNotInstalledError as ct, getRequestAcceptableLanguages as d, isPluginError as dt, HeaderName as en, RouterPipelineContext as et, getRequestAcceptableEncoding as f, PluginError as ft, getRequestAcceptableContentType as g, isHandler as gt, getRequestAcceptableCharsets as h, matchHandlerMethod as ht, useRequestNegotiator as i, isPlugin as it, sendCreated as j, HandlerOptions as jt, SendFileStats as k, CoreHandlerOptions as kt, matchRequestContentType as l, PluginInstallError as lt, getRequestAcceptableCharset as m, buildHandlerPathMatcher as mt, RequestProtocolOptions as n, StackHandlerEntry as nt, getRequestIP as o, PluginInstallContext as ot, getRequestAcceptableEncodings as p, PluginErrorCode as pt, createError as q, IRoutupEvent as qt, getRequestProtocol as r, StackRouterEntry as rt, RequestHostNameOptions as s, PluginInstallFn as st, normalizeRouterOptions as t, MethodName as tn, StackEntry as tt, getRequestAcceptableLanguage as u, PluginAlreadyInstalledError as ut, getRequestHeader as v, isWebHandler as vt, sendFormat as w, fromNodeMiddleware as wt, setResponseContentTypeByFileName as x, WebHandler as xt, isRequestCacheable as y, isWebHandlerProvider as yt, EventStreamHandle as z, PathMatcher as zt };
-//# sourceMappingURL=index-DdsCL8RI.d.mts.map