nitro 3.0.1-alpha.2 → 3.0.260415-beta

package/dist/types/index.d.mts

@@ -1,47 +1,37 @@
-import { t as commonjs } from "../_libs/pluginutils+plugin-commonjs.mjs";
-import { a as WatchConfigOptions, i as ResolvedConfig, n as ConfigWatcher, o as ChokidarOptions, r as DotenvOptions, t as C12InputConfig } from "../_libs/c12+giget+readdirp+chokidar.mjs";
+import { t as commonjs } from "../_libs/estree+pluginutils.mjs";
+import { a as WatchConfigOptions, i as ResolvedConfig, n as ConfigWatcher, o as ChokidarOptions, r as DotenvOptions, t as C12InputConfig } from "../_libs/c12+readdirp+chokidar.mjs";
 import { n as CompatibilityDates, r as DateString, t as CompatibilityDateSpec } from "../_libs/compatx.mjs";
 import { t as ProxyServerOptions } from "../_libs/httpxy.mjs";
 import { t as TSConfig } from "../_libs/pkg-types.mjs";
 import { n as Unimport, t as UnimportPluginOptions } from "../_libs/unplugin+unimport.mjs";
-import "../_libs/esbuild.mjs";
 import { t as UnwasmPluginOptions } from "../_libs/unwasm.mjs";
 import { n as RouterContext, t as RouterCompilerOptions } from "../_libs/rou3.mjs";
 import { t as ProviderName } from "../_libs/std-env.mjs";
 import { ConsolaInstance, LogLevel } from "consola";
 import { Hookable, HookableCore, NestedHooks } from "hookable";
 import { version } from "nitro/meta";
-import { IncomingMessage, OutgoingMessage } from "node:http";
-import { H3Core, HTTPError, HTTPEvent, HTTPHandler, HTTPMethod, Middleware, ProxyOptions } from "h3";
-import { Duplex } from "node:stream";
+import { EnvRunner, EnvRunnerData, FetchHandler, RunnerMessageListener, RunnerName, RunnerRPCHooks, UpgradeHandler, WorkerAddress, WorkerHooks } from "env-runner";
+import { BasicAuthOptions, H3Core, HTTPError, HTTPEvent, HTTPHandler, HTTPMethod, Middleware, ProxyOptions } from "h3";
 import { ServerRequest, ServerRequest as ServerRequest$1 } from "srvx";
-import "nitro";
-import "nitro/app";
-import "nitro/cache";
-import "nitro/context";
-import "nitro/database";
-import "nitro/h3";
-import "nitro/runtime-config";
-import "nitro/storage";
-import "nitro/task";
 import { Preset } from "unenv";
 import { ConnectorName } from "db0";
 import { BuiltinDriverName } from "unstorage";
-import { JsxOptions, TransformOptions } from "oxc-transform";
-import { MinifyOptions } from "oxc-minify";
-import { InputOptions, OutputOptions } from "rolldown";
+import { Nitro as Nitro$1 } from "nitro/types";
+import { InputOptions, MinifyOptions, OutputOptions, TransformOptions } from "rolldown";
 import { InputOptions as InputOptions$1, OutputOptions as OutputOptions$1 } from "rollup";
-import { Nitro as Nitro$1, RunnerMessageListener as RunnerMessageListener$1 } from "nitro/types";
 import { FetchOptions, FetchRequest, FetchResponse } from "ofetch";
+import * as _$ocache from "ocache";
+import { CacheEntry, CacheOptions, ResponseCacheEntry } from "ocache";
 import { ExecutionContext, ForwardableEmailMessage, MessageBatch, ScheduledController, TraceItem } from "@cloudflare/workers-types";
 import { DurableObject } from "cloudflare:workers";
-
-//#region src/types/fetch/fetch.d.ts
+import * as _$_vercel_queue0 from "@vercel/queue";
+import { send } from "@vercel/queue";
+import { ExternalsTraceOptions } from "nf3";
 interface InternalApi {}
 type RouterMethod = Lowercase<HTTPMethod>;
 type NitroFetchRequest = Exclude<keyof InternalApi, `/_${string}` | `/api/_${string}`> | Exclude<FetchRequest, string> | (string & {});
-type MiddlewareOf<Route$2 extends string, Method extends RouterMethod | "default"> = Method extends keyof InternalApi[MatchedRoutes<Route$2>] ? InternalApi[MatchedRoutes<Route$2>][Method] : never;
-type TypedInternalResponse<Route$2, Default = unknown, Method extends RouterMethod = RouterMethod> = Default extends string | boolean | number | null | void | object ? Default : Route$2 extends string ? MiddlewareOf<Route$2, Method> extends never ? MiddlewareOf<Route$2, "default"> extends never ? Default : MiddlewareOf<Route$2, "default"> : MiddlewareOf<Route$2, Method> : Default;
+type MiddlewareOf<Route extends string, Method extends RouterMethod | "default"> = Method extends keyof InternalApi[MatchedRoutes<Route>] ? InternalApi[MatchedRoutes<Route>][Method] : never;
+type TypedInternalResponse<Route, Default = unknown, Method extends RouterMethod = RouterMethod> = Default extends string | boolean | number | null | void | object ? Default : Route extends string ? MiddlewareOf<Route, Method> extends never ? MiddlewareOf<Route, "default"> extends never ? Default : MiddlewareOf<Route, "default"> : MiddlewareOf<Route, Method> : Default;
 type AvailableRouterMethod<R extends NitroFetchRequest> = R extends string ? keyof InternalApi[MatchedRoutes<R>] extends undefined ? RouterMethod : Extract<keyof InternalApi[MatchedRoutes<R>], "default"> extends undefined ? Extract<RouterMethod, keyof InternalApi[MatchedRoutes<R>]> : RouterMethod : RouterMethod;
 interface NitroFetchOptions<R extends NitroFetchRequest, M extends AvailableRouterMethod<R> = AvailableRouterMethod<R>> extends FetchOptions {
   method?: Uppercase<M> | M;
@@ -52,8 +42,6 @@ interface $Fetch<DefaultT = unknown, DefaultR extends NitroFetchRequest = NitroF
   raw<T = DefaultT, R extends NitroFetchRequest = DefaultR, O extends NitroFetchOptions<R> = NitroFetchOptions<R>>(request: R, opts?: O): Promise<FetchResponse<TypedInternalResponse<R, T, NitroFetchOptions<R> extends O ? "get" : ExtractedRouteMethod<R, O>>>>;
   create<T = DefaultT, R extends NitroFetchRequest = DefaultR>(defaults: FetchOptions): $Fetch<T, R>;
 }
-//#endregion
-//#region src/types/fetch/_match.d.ts
 type MatchResult<Key extends string, Exact extends boolean = false, Score extends any[] = [], catchAll extends boolean = false> = { [k in Key]: {
   key: k;
   exact: Exact;
@@ -61,14 +49,14 @@ type MatchResult<Key extends string, Exact extends boolean = false, Score extend
   catchAll: catchAll;
 } }[Key];
 type Subtract<Minuend extends any[] = [], Subtrahend extends any[] = []> = Minuend extends [...Subtrahend, ...infer Remainder] ? Remainder : never;
-type TupleIfDiff<First extends string, Second extends string, Tuple extends any[] = []> = First extends `${Second}${infer Diff}` ? Diff extends "" ? [] : Tuple : [];
+type TupleIfDiff<First extends string, Second extends string, Tuple extends any[] = []> = First extends `${Second}${infer Diff}` ? (Diff extends "" ? [] : Tuple) : [];
 type MaxTuple<N extends any[] = [], T extends any[] = []> = {
   current: T;
   result: MaxTuple<N, ["", ...T]>;
 }[[N["length"]] extends [Partial<T>["length"]] ? "current" : "result"];
-type CalcMatchScore<Key extends string, Route$2 extends string, Score extends any[] = [], Init extends boolean = false, FirstKeySegMatcher extends string = (Init extends true ? ":Invalid:" : "")> = `${Key}/` extends `${infer KeySeg}/${infer KeyRest}` ? KeySeg extends FirstKeySegMatcher ? Subtract<[...Score, ...TupleIfDiff<Route$2, Key, ["", ""]>], TupleIfDiff<Key, Route$2, ["", ""]>> : `${Route$2}/` extends `${infer RouteSeg}/${infer RouteRest}` ? `${RouteSeg}?` extends `${infer RouteSegWithoutQuery}?${string}` ? RouteSegWithoutQuery extends KeySeg ? CalcMatchScore<KeyRest, RouteRest, [...Score, "", ""]> : KeySeg extends `:${string}` ? RouteSegWithoutQuery extends "" ? never : CalcMatchScore<KeyRest, RouteRest, [...Score, ""]> : KeySeg extends RouteSegWithoutQuery ? CalcMatchScore<KeyRest, RouteRest, [...Score, ""]> : never : never : never : never;
-type _MatchedRoutes<Route$2 extends string, MatchedResultUnion extends MatchResult<string> = MatchResult<keyof InternalApi>> = MatchedResultUnion["key"] extends infer MatchedKeys ? MatchedKeys extends string ? Route$2 extends MatchedKeys ? MatchResult<MatchedKeys, true> : MatchedKeys extends `${infer Root}/**${string}` ? MatchedKeys extends `${string}/**` ? Route$2 extends `${Root}/${string}` ? MatchResult<MatchedKeys, false, [], true> : never : MatchResult<MatchedKeys, false, CalcMatchScore<Root, Route$2, [], true>> : MatchResult<MatchedKeys, false, CalcMatchScore<MatchedKeys, Route$2, [], true>> : never : never;
-type MatchedRoutes<Route$2 extends string, MatchedKeysResult extends MatchResult<string> = MatchResult<keyof InternalApi>, Matches extends MatchResult<string> = _MatchedRoutes<Route$2, MatchedKeysResult>> = Route$2 extends "/" ? keyof InternalApi : Extract<Matches, {
+type CalcMatchScore<Key extends string, Route extends string, Score extends any[] = [], Init extends boolean = false, FirstKeySegMatcher extends string = (Init extends true ? ":Invalid:" : "")> = `${Key}/` extends `${infer KeySeg}/${infer KeyRest}` ? KeySeg extends FirstKeySegMatcher ? Subtract<[...Score, ...TupleIfDiff<Route, Key, ["", ""]>], TupleIfDiff<Key, Route, ["", ""]>> : `${Route}/` extends `${infer RouteSeg}/${infer RouteRest}` ? `${RouteSeg}?` extends `${infer RouteSegWithoutQuery}?${string}` ? RouteSegWithoutQuery extends KeySeg ? CalcMatchScore<KeyRest, RouteRest, [...Score, "", ""]> : KeySeg extends `:${string}` ? RouteSegWithoutQuery extends "" ? never : CalcMatchScore<KeyRest, RouteRest, [...Score, ""]> : KeySeg extends RouteSegWithoutQuery ? CalcMatchScore<KeyRest, RouteRest, [...Score, ""]> : never : never : never : never;
+type _MatchedRoutes<Route extends string, MatchedResultUnion extends MatchResult<string> = MatchResult<keyof InternalApi>> = MatchedResultUnion["key"] extends infer MatchedKeys ? MatchedKeys extends string ? Route extends MatchedKeys ? MatchResult<MatchedKeys, true> : MatchedKeys extends `${infer Root}/**${string}` ? MatchedKeys extends `${string}/**` ? Route extends `${Root}/${string}` ? MatchResult<MatchedKeys, false, [], true> : never : MatchResult<MatchedKeys, false, CalcMatchScore<Root, Route, [], true>> : MatchResult<MatchedKeys, false, CalcMatchScore<MatchedKeys, Route, [], true>> : never : never;
+type MatchedRoutes<Route extends string, MatchedKeysResult extends MatchResult<string> = MatchResult<keyof InternalApi>, Matches extends MatchResult<string> = _MatchedRoutes<Route, MatchedKeysResult>> = Route extends "/" ? keyof InternalApi : Extract<Matches, {
   exact: true;
 }> extends never ? Extract<Exclude<Matches, {
   score: never;
@@ -79,8 +67,6 @@ type MatchedRoutes<Route$2 extends string, MatchedKeysResult extends MatchResult
 }>["key"] : Extract<Matches, {
   exact: true;
 }>["key"];
-//#endregion
-//#region src/types/fetch/_serialize.d.ts
 /**
  * @link https://github.com/remix-run/remix/blob/2248669ed59fd716e267ea41df5d665d4781f4a9/packages/remix-server-runtime/serialize.ts
  */
@@ -99,8 +85,6 @@ type SerializeObject<T extends object> = { [k in keyof Omit<T, FilterKeys<T, Non
  * @see https://github.com/ianstormtaylor/superstruct/blob/7973400cd04d8ad92bbdc2b6f35acbfb3c934079/src/utils.ts#L323-L325
  */
 type Simplify<TType> = TType extends any[] | Date ? TType : { [K in keyof TType]: Simplify<TType[K]> };
-//#endregion
-//#region src/types/runtime/asset.d.ts
 interface PublicAsset {
   type: string;
   etag: string;
@@ -115,43 +99,7 @@ interface AssetMeta {
   etag?: string;
   mtime?: string;
 }
-//#endregion
-//#region src/types/runtime/cache.d.ts
-interface CacheEntry<T = any> {
-  value?: T;
-  expires?: number;
-  mtime?: number;
-  integrity?: string;
-}
-interface CacheOptions<T = any, ArgsT extends unknown[] = any[]> {
-  name?: string;
-  getKey?: (...args: ArgsT) => string | Promise<string>;
-  transform?: (entry: CacheEntry<T>, ...args: ArgsT) => any;
-  validate?: (entry: CacheEntry<T>, ...args: ArgsT) => boolean;
-  shouldInvalidateCache?: (...args: ArgsT) => boolean | Promise<boolean>;
-  shouldBypassCache?: (...args: ArgsT) => boolean | Promise<boolean>;
-  group?: string;
-  integrity?: any;
-  /**
-   * Number of seconds to cache the response. Defaults to 1.
-   */
-  maxAge?: number;
-  swr?: boolean;
-  staleMaxAge?: number;
-  base?: string;
-}
-interface ResponseCacheEntry {
-  status: number;
-  statusText: string | undefined;
-  headers: Record<string, string>;
-  body: string | undefined;
-}
-interface CachedEventHandlerOptions extends Omit<CacheOptions<ResponseCacheEntry, [HTTPEvent]>, "transform" | "validate"> {
-  headersOnly?: boolean;
-  varies?: string[] | readonly string[];
-}
-//#endregion
-//#region src/types/runtime/nitro.d.ts
+interface CachedEventHandlerOptions extends Omit<_$ocache.CachedEventHandlerOptions<HTTPEvent & _$ocache.HTTPEvent>, "toResponse" | "createResponse" | "handleCacheHeaders"> {}
 interface NitroApp {
   fetch: (req: Request) => Response | Promise<Response>;
   h3?: H3Core;
@@ -189,8 +137,6 @@ interface NitroRuntimeHooks {
   request: (event: HTTPEvent) => void | Promise<void>;
   response: (res: Response, event: HTTPEvent) => void | Promise<void>;
 }
-//#endregion
-//#region src/types/runtime/task.d.ts
 type MaybePromise$1<T> = T | Promise<T>;
 /** @experimental */
 interface TaskContext {}
@@ -225,8 +171,6 @@ interface TaskRunnerOptions {
   cwd?: string;
   buildDir?: string;
 }
-//#endregion
-//#region src/presets/aws-amplify/types.d.ts
 type AmplifyImageSettings = {
   /** Array of supported image widths */sizes: number[];
   /**
@@ -263,13 +207,9 @@ interface AWSAmplifyOptions {
   imageSettings?: AmplifyImageSettings;
   runtime?: "nodejs20.x" | "nodejs22.x";
 }
-//#endregion
-//#region src/presets/aws-lambda/types.d.ts
 interface AwsLambdaOptions {
   streaming?: boolean;
 }
-//#endregion
-//#region src/presets/azure/types.d.ts
 interface AzureOptions {
   config?: {
     platform?: {
@@ -283,8 +223,6 @@ interface AzureOptions {
     [key: string]: unknown;
   };
 }
-//#endregion
-//#region src/presets/cloudflare/wrangler/environment.d.ts
 /**
  * Copyright (c) 2020 Cloudflare, Inc. <wrangler@cloudflare.com>
  * https://github.com/cloudflare/workers-sdk/blob/main/LICENSE-MIT
@@ -1214,8 +1152,6 @@ interface Observability {
     invocation_logs?: boolean;
   };
 }
-//#endregion
-//#region src/presets/cloudflare/wrangler/config.d.ts
 /**
  * This is the static type definition for the configuration object.
  *
@@ -1419,8 +1355,6 @@ interface DevConfig {
   host: string | undefined;
 }
 type RawDevConfig = Partial<DevConfig>;
-//#endregion
-//#region src/presets/cloudflare/types.d.ts
 type WranglerConfig = Partial<Omit<Config, keyof ComputedFields>>;
 /**
  * https://developers.cloudflare.com/pages/platform/functions/routing/#functions-invocation-routes
@@ -1535,8 +1469,6 @@ declare module "nitro/types" {
     "cloudflare:durable:alarm": (durable: DurableObject) => void;
   }
 }
-//#endregion
-//#region src/presets/firebase/types.d.ts
 interface FirebaseOptions {
   appHosting: Partial<AppHostingOutputBundleConfig["runConfig"]>;
 }
@@ -1567,8 +1499,6 @@ interface AppHostingOutputBundleConfig {
     };
   };
 }
-//#endregion
-//#region src/presets/netlify/types.d.ts
 interface NetlifyOptions {
   /** @deprecated Use `config.images` */
   images?: NetlifyImagesConfig;
@@ -1617,8 +1547,6 @@ interface NetlifyRedirectRule {
   query?: Record<string, string>;
   [key: string]: unknown;
 }
-//#endregion
-//#region src/presets/vercel/types.d.ts
 /**
  * Vercel Build Output Configuration
  * @see https://vercel.com/docs/build-output-api/v3
@@ -1627,15 +1555,12 @@ interface VercelBuildConfigV3 {
   version: 3;
   routes?: ({
     src: string;
-    headers: {
-      "cache-control": string;
-    };
-    continue: boolean;
+    dest?: string;
+    headers?: Record<string, string>;
+    continue?: boolean;
+    status?: number;
   } | {
     handle: string;
-  } | {
-    src: string;
-    dest: string;
   })[];
   images?: {
     sizes: number[];
@@ -1661,6 +1586,9 @@ interface VercelBuildConfigV3 {
   }>;
   cache?: string[];
   bypassToken?: string;
+  framework?: {
+    version: string;
+  };
   crons?: {
     path: string;
     schedule: string;
@@ -1682,9 +1610,9 @@ interface VercelServerlessFunctionConfig {
    */
   architecture?: "x86_64" | "arm64";
   /**
-   * Maximum execution duration (in seconds) that will be allowed for the Serverless Function.
+   * Maximum execution duration (in seconds) that will be allowed for the Serverless Function. `max` automatically sets the duration to the maximum allowed value.
    */
-  maxDuration?: number;
+  maxDuration?: number | "max";
   /**
    * Map of additional environment variables that will be available to the Vercel Function,
    * in addition to the env vars specified in the Project Settings.
@@ -1710,8 +1638,19 @@ interface VercelServerlessFunctionConfig {
    * The runtime to use. Defaults to the auto-detected Node.js version.
    */
   runtime?: "nodejs20.x" | "nodejs22.x" | "bun1.x" | (string & {});
+  /**
+   * Experimental trigger configuration (e.g., Vercel Queues).
+   */
+  experimentalTriggers?: VercelFunctionTrigger[];
   [key: string]: unknown;
 }
+type VercelFunctionTrigger = {
+  type: "queue/v2beta";
+  topic: string;
+  retryAfterSeconds?: number;
+  initialDelaySeconds?: number;
+  consumer?: string;
+};
 interface VercelOptions {
   config?: VercelBuildConfigV3;
   /**
@@ -1735,9 +1674,92 @@ interface VercelOptions {
    * Possible values are: `web` (default) and `node`.
    */
   entryFormat?: "web" | "node";
+  /**
+   * The route path for the Vercel cron handler endpoint.
+   *
+   * When `experimental.tasks` and `scheduledTasks` are configured,
+   * Nitro registers a cron handler at this path that Vercel invokes
+   * on each scheduled cron trigger.
+   *
+   * @default "/_vercel/cron"
+   * @see https://vercel.com/docs/cron-jobs
+   */
+  cronHandlerRoute?: string;
+  /**
+   * Vercel Queues configuration.
+   *
+   * Messages are delivered via the `vercel:queue` runtime hook.
+   *
+   * @example
+   * ```ts
+   * // nitro.config.ts
+   * export default defineNitroConfig({
+   *   vercel: {
+   *     queues: {
+   *       triggers: [{ topic: "orders" }],
+   *     },
+   *   },
+   * });
+   * ```
+   *
+   * ```ts
+   * // server/plugins/queues.ts
+   * export default defineNitroPlugin((nitro) => {
+   *   nitro.hooks.hook("vercel:queue", ({ message, metadata }) => {
+   *     console.log(`Received message on ${metadata.topicName}:`, message);
+   *   });
+   * });
+   * ```
+   *
+   * @see https://vercel.com/docs/queues
+   */
+  queues?: {
+    /**
+     * Route path for the queue consumer handler.
+     * @default "/_vercel/queues/consumer"
+     */
+    handlerRoute?: string; /** Queue topic triggers to subscribe to. */
+    triggers: Array<{
+      topic: string;
+      retryAfterSeconds?: number;
+      initialDelaySeconds?: number;
+    }>;
+  };
+  /**
+   * Per-route function configuration overrides.
+   *
+   * Keys are route patterns (e.g., `/api/queues/*`, `/api/slow-routes/**`).
+   * Values are partial {@link VercelServerlessFunctionConfig} objects.
+   *
+   * @example
+   * ```ts
+   * functionRules: {
+   *   '/api/my-slow-routes/**': { maxDuration: 3600 },
+   *   '/api/queues/fulfill-order': {
+   *     experimentalTriggers: [{ type: 'queue/v2beta', topic: 'orders' }],
+   *   },
+   * }
+   * ```
+   */
+  functionRules?: Record<string, VercelServerlessFunctionConfig>;
+}
+declare module "nitro/types" {
+  interface NitroRuntimeHooks {
+    "vercel:queue": (_: {
+      message: unknown;
+      metadata: _$_vercel_queue0.MessageMetadata;
+      send: typeof send;
+    }) => void;
+  }
+}
+interface ZephyrOptions {
+  /**
+   * Deploy to Zephyr during `nitro build` when using the `zephyr` preset.
+   *
+   * @default false
+   */
+  deployOnBuild?: boolean;
 }
-//#endregion
-//#region src/presets/_types.gen.d.ts
 interface PresetOptions {
   awsAmplify?: AWSAmplifyOptions;
   awsLambda?: AwsLambdaOptions;
@@ -1746,11 +1768,10 @@ interface PresetOptions {
   firebase?: FirebaseOptions;
   netlify?: NetlifyOptions;
   vercel?: VercelOptions;
+  zephyr?: ZephyrOptions;
 }
-type PresetName = "alwaysdata" | "aws-amplify" | "aws-lambda" | "azure-swa" | "base-worker" | "bun" | "cleavr" | "cloudflare-dev" | "cloudflare-durable" | "cloudflare-module" | "cloudflare-pages" | "cloudflare-pages-static" | "deno" | "deno-deploy" | "deno-server" | "digital-ocean" | "firebase-app-hosting" | "flight-control" | "genezio" | "github-pages" | "gitlab-pages" | "heroku" | "iis-handler" | "iis-node" | "koyeb" | "netlify" | "netlify-edge" | "netlify-static" | "nitro-dev" | "nitro-prerender" | "node" | "node-cluster" | "node-middleware" | "node-server" | "platform-sh" | "render-com" | "standard" | "static" | "stormkit" | "vercel" | "vercel-static" | "winterjs" | "zeabur" | "zeabur-static" | "zerops" | "zerops-static";
-type PresetNameInput = "alwaysdata" | "aws-amplify" | "awsAmplify" | "aws_amplify" | "aws-lambda" | "awsLambda" | "aws_lambda" | "azure-swa" | "azureSwa" | "azure_swa" | "base-worker" | "baseWorker" | "base_worker" | "bun" | "cleavr" | "cloudflare-dev" | "cloudflareDev" | "cloudflare_dev" | "cloudflare-durable" | "cloudflareDurable" | "cloudflare_durable" | "cloudflare-module" | "cloudflareModule" | "cloudflare_module" | "cloudflare-pages" | "cloudflarePages" | "cloudflare_pages" | "cloudflare-pages-static" | "cloudflarePagesStatic" | "cloudflare_pages_static" | "deno" | "deno-deploy" | "denoDeploy" | "deno_deploy" | "deno-server" | "denoServer" | "deno_server" | "digital-ocean" | "digitalOcean" | "digital_ocean" | "firebase-app-hosting" | "firebaseAppHosting" | "firebase_app_hosting" | "flight-control" | "flightControl" | "flight_control" | "genezio" | "github-pages" | "githubPages" | "github_pages" | "gitlab-pages" | "gitlabPages" | "gitlab_pages" | "heroku" | "iis-handler" | "iisHandler" | "iis_handler" | "iis-node" | "iisNode" | "iis_node" | "koyeb" | "netlify" | "netlify-edge" | "netlifyEdge" | "netlify_edge" | "netlify-static" | "netlifyStatic" | "netlify_static" | "nitro-dev" | "nitroDev" | "nitro_dev" | "nitro-prerender" | "nitroPrerender" | "nitro_prerender" | "node" | "node-cluster" | "nodeCluster" | "node_cluster" | "node-middleware" | "nodeMiddleware" | "node_middleware" | "node-server" | "nodeServer" | "node_server" | "platform-sh" | "platformSh" | "platform_sh" | "render-com" | "renderCom" | "render_com" | "standard" | "static" | "stormkit" | "vercel" | "vercel-static" | "vercelStatic" | "vercel_static" | "winterjs" | "zeabur" | "zeabur-static" | "zeaburStatic" | "zeabur_static" | "zerops" | "zerops-static" | "zeropsStatic" | "zerops_static" | (string & {});
-//#endregion
-//#region src/types/openapi-ts.d.ts
+type PresetName = "alwaysdata" | "aws-amplify" | "aws-lambda" | "azure-swa" | "base-worker" | "bun" | "cleavr" | "cloudflare-dev" | "cloudflare-durable" | "cloudflare-module" | "cloudflare-pages" | "cloudflare-pages-static" | "deno" | "deno-deploy" | "deno-server" | "digital-ocean" | "edgeone" | "edgeone-pages" | "firebase-app-hosting" | "flight-control" | "genezio" | "github-pages" | "gitlab-pages" | "heroku" | "iis-handler" | "iis-node" | "koyeb" | "netlify" | "netlify-edge" | "netlify-static" | "nitro-dev" | "nitro-prerender" | "node" | "node-cluster" | "node-middleware" | "node-server" | "platform-sh" | "render-com" | "standard" | "static" | "stormkit" | "vercel" | "vercel-static" | "winterjs" | "zeabur" | "zeabur-static" | "zephyr" | "zerops" | "zerops-static";
+type PresetNameInput = "alwaysdata" | "aws-amplify" | "awsAmplify" | "aws_amplify" | "aws-lambda" | "awsLambda" | "aws_lambda" | "azure-swa" | "azureSwa" | "azure_swa" | "base-worker" | "baseWorker" | "base_worker" | "bun" | "cleavr" | "cloudflare-dev" | "cloudflareDev" | "cloudflare_dev" | "cloudflare-durable" | "cloudflareDurable" | "cloudflare_durable" | "cloudflare-module" | "cloudflareModule" | "cloudflare_module" | "cloudflare-pages" | "cloudflarePages" | "cloudflare_pages" | "cloudflare-pages-static" | "cloudflarePagesStatic" | "cloudflare_pages_static" | "deno" | "deno-deploy" | "denoDeploy" | "deno_deploy" | "deno-server" | "denoServer" | "deno_server" | "digital-ocean" | "digitalOcean" | "digital_ocean" | "edgeone" | "edgeone-pages" | "edgeonePages" | "edgeone_pages" | "firebase-app-hosting" | "firebaseAppHosting" | "firebase_app_hosting" | "flight-control" | "flightControl" | "flight_control" | "genezio" | "github-pages" | "githubPages" | "github_pages" | "gitlab-pages" | "gitlabPages" | "gitlab_pages" | "heroku" | "iis-handler" | "iisHandler" | "iis_handler" | "iis-node" | "iisNode" | "iis_node" | "koyeb" | "netlify" | "netlify-edge" | "netlifyEdge" | "netlify_edge" | "netlify-static" | "netlifyStatic" | "netlify_static" | "nitro-dev" | "nitroDev" | "nitro_dev" | "nitro-prerender" | "nitroPrerender" | "nitro_prerender" | "node" | "node-cluster" | "nodeCluster" | "node_cluster" | "node-middleware" | "nodeMiddleware" | "node_middleware" | "node-server" | "nodeServer" | "node_server" | "platform-sh" | "platformSh" | "platform_sh" | "render-com" | "renderCom" | "render_com" | "standard" | "static" | "stormkit" | "vercel" | "vercel-static" | "vercelStatic" | "vercel_static" | "winterjs" | "zeabur" | "zeabur-static" | "zeaburStatic" | "zeabur_static" | "zephyr" | "zerops" | "zerops-static" | "zeropsStatic" | "zerops_static" | (string & {});
 /**
 Source: (inlined because of install size concernes)
 
@@ -2330,8 +2351,6 @@ interface OAuthFlowObject extends Extensable {
  */
 type SecurityRequirementObject = { [P in keyof ComponentsObject["securitySchemes"]]?: string[] };
 type $defs = Record<string, SchemaObject>;
-//#endregion
-//#region src/types/handler.d.ts
 type MaybeArray$1<T> = T | T[];
 /** @experimental */
 interface NitroRouteMeta {
@@ -2389,37 +2408,24 @@ type NitroErrorHandler = (error: HTTPError, event: HTTPEvent, _: {
     silent?: boolean;
     json?: boolean;
   }) => MaybePromise<{
-    status: number;
-    statusText: string | undefined;
-    headers: Record<string, string>;
-    body: string | Record<string, any>;
+    status?: number;
+    statusText?: string;
+    headers?: HeadersInit;
+    body?: string | Record<string, any>;
   }>;
 }) => MaybePromise<Response | void>;
-//#endregion
-//#region src/runner/node.d.ts
-interface EnvRunnerData {
-  name?: string;
-  [key: string]: unknown;
-}
-//#endregion
-//#region src/types/prerender.d.ts
 interface PrerenderRoute {
   route: string;
   contents?: string;
   data?: ArrayBuffer;
   fileName?: string;
-  error?: Error & {
-    status: number;
-    statusText: string;
-  };
+  error?: Partial<HTTPError>;
   generateTimeMS?: number;
   skip?: boolean;
   contentType?: string;
 }
 /** @deprecated Internal type will be removed in future versions */
 type PrerenderGenerateRoute = PrerenderRoute;
-//#endregion
-//#region src/routing.d.ts
 interface Route<T = unknown> {
   route: string;
   method: string;
@@ -2440,13 +2446,9 @@ declare class Router<T> {
   match(method: string, path: string): undefined | T;
   matchAll(method: string, path: string): T[];
 }
-//#endregion
-//#region src/types/_utils.d.ts
 type Enumerate<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc["length"]]>;
 type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
 type ExcludeFunctions<G extends Record<string, any>> = Pick<G, { [P in keyof G]: NonNullable<G[P]> extends Function ? never : P }[keyof G]>;
-//#endregion
-//#region src/types/route-rules.d.ts
 type HTTPstatus = IntRange<100, 600>;
 interface NitroRouteConfig {
   cache?: ExcludeFunctions<CachedEventHandlerOptions> | false;
@@ -2460,6 +2462,7 @@ interface NitroRouteConfig {
     to: string;
   } & ProxyOptions);
   isr?: number | boolean | VercelISRConfig;
+  basicAuth?: Pick<BasicAuthOptions, "password" | "username" | "realm"> | false;
   cors?: boolean;
   swr?: boolean | number;
   static?: boolean | number;
@@ -2479,7 +2482,13 @@ type MatchedRouteRule<K extends keyof NitroRouteRules = "custom"> = {
   options: Exclude<NitroRouteRules[K], false>;
   route: string;
   params?: Record<string, string>;
-  handler?: (opts: unknown) => Middleware;
+  /**
+   * Middleware constructor. May expose an `order` property — lower runs first
+   * (default `0`).
+   */
+  handler?: ((opts: unknown) => Middleware) & {
+    order?: number;
+  };
 };
 type MatchedRouteRules = { [K in keyof NitroRouteRules]: MatchedRouteRule<K> };
 interface VercelISRConfig {
@@ -2508,11 +2517,21 @@ interface VercelISRConfig {
    * When `true`, the query string will be present on the `request` argument passed to the invoked function. The `allowQuery` filter still applies.
    */
   passQuery?: boolean;
+  /**
+   * (vercel)
+   *
+   * When `true`, expose the response body regardless of status code including error status codes. (default `false`)
+   */
+  exposeErrBody?: boolean;
 }
-//#endregion
-//#region src/types/nitro.d.ts
 type MaybeArray<T> = T | T[];
+interface NitroMeta {
+  version: string;
+  majorVersion: number;
+  [key: string]: unknown;
+}
 interface Nitro {
+  meta: NitroMeta;
   options: NitroOptions;
   scannedHandlers: NitroEventHandler[];
   vfs: Map<string, {
@@ -2566,32 +2585,26 @@ interface NitroBuildInfo {
     preview?: string;
     deploy?: string;
   };
+  serverEntry?: string;
+  publicDir?: string;
   dev?: {
     pid: number;
-    workerAddress?: {
-      host: string;
-      port: number;
-      socketPath?: string;
-    };
+    workerAddress?: WorkerAddress;
   };
   config?: Partial<PresetOptions>;
 }
-//#endregion
-//#region src/types/build.d.ts
 type RollupConfig = InputOptions$1 & {
-  output: OutputOptions$1;
+  output?: OutputOptions$1;
 };
 type RolldownConfig = InputOptions & {
-  output: OutputOptions;
+  output?: OutputOptions;
 };
 interface OXCOptions {
   minify?: MinifyOptions;
   transform?: Omit<TransformOptions, "jsx"> & {
-    jsx?: JsxOptions;
+    jsx?: Exclude<TransformOptions["jsx"], false | string>;
   };
 }
-//#endregion
-//#region src/types/hooks.d.ts
 type HookResult = void | Promise<void>;
 interface NitroHooks {
   "types:extend": (types: NitroTypes) => HookResult;
@@ -2617,8 +2630,6 @@ interface NitroHooks {
     failedRoutes: PrerenderRoute[];
   }) => HookResult;
 }
-//#endregion
-//#region src/types/module.d.ts
 type NitroModuleInput = string | NitroModule | NitroModule["setup"] | {
   nitro: NitroModule;
 };
@@ -2626,10 +2637,40 @@ interface NitroModule {
   name?: string;
   setup: (this: void, nitro: Nitro) => void | Promise<void>;
 }
-//#endregion
-//#region src/types/openapi.d.ts
+/**
+ * Swagger UI configuration options
+ *
+ * @see https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/
+ */
+interface SwaggerUIConfig {
+  deepLinking?: boolean;
+  displayOperationId?: boolean;
+  defaultModelsExpandDepth?: number;
+  defaultModelExpandDepth?: number;
+  defaultModelRendering?: "example" | "model";
+  displayRequestDuration?: boolean;
+  docExpansion?: "list" | "full" | "none";
+  filter?: boolean | string;
+  persistAuthorization?: boolean;
+  requestSnippetsEnabled?: boolean;
+  showExtensions?: boolean;
+  showCommonExtensions?: boolean;
+  /** Only "alpha" is supported (function values are not JSON-serializable). */
+  tagsSorter?: "alpha";
+  /**
+   * Note: function callbacks cannot be passed via Nitro configuration (not JSON-serializable).
+   */
+  onComplete?: never;
+  layout?: string;
+  configUrl?: string;
+  oauth2RedirectUrl?: string;
+  withCredentials?: boolean;
+  [key: string]: unknown;
+}
 /**
  * Nitro OpenAPI configuration
+ *
+ * @see https://nitro.build/docs/openapi
  */
 interface NitroOpenAPIConfig {
   /**
@@ -2667,21 +2708,21 @@ interface NitroOpenAPIConfig {
     });
     /**
      * Swagger UI configuration
+     *
+     * @see https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/
      */
-    swagger?: false | {
+    swagger?: false | (SwaggerUIConfig & {
       /**
        * Swagger UI route
        *
        * Default is `/_swagger`
        */
       route?: string;
-    };
+    });
   };
 }
-//#endregion
-//#region src/types/preset.d.ts
 type NitroPreset = NitroConfig | (() => NitroConfig);
-interface NitroPresetMeta {
+interface NitroPresetMeta$1 {
   name: string;
   stdName?: ProviderName;
   aliases?: string[];
@@ -2689,8 +2730,6 @@ interface NitroPresetMeta {
   dev?: boolean;
   compatibilityDate?: DateString;
 }
-//#endregion
-//#region src/types/config.d.ts
 type RollupCommonJSOptions = NonNullable<Parameters<typeof commonjs.default>[0]>;
 /**
  * Nitro normalized options (nitro.options)
@@ -2733,6 +2772,7 @@ interface NitroOptions extends PresetOptions {
   ssrRoutes: string[];
   serveStatic: boolean | "node" | "deno" | "inline";
   noPublicDir: boolean;
+  tracingChannel?: undefined | TracingOptions;
   manifest?: {
     deploymentId?: string;
   };
@@ -2753,8 +2793,18 @@ interface NitroOptions extends PresetOptions {
    * @see https://github.com/unjs/unwasm
    */
   wasm?: false | UnwasmPluginOptions;
+  /**
+   * OpenAPI configuration
+   *
+   * @see https://nitro.build/docs/openapi
+   */
   openAPI?: NitroOpenAPIConfig;
   experimental: {
+    /**
+     * Enable experimental OpenAPI support
+     *
+     * @see https://nitro.build/docs/openapi
+     */
     openAPI?: boolean;
     /**
      * See https://github.com/microsoft/TypeScript/pull/51669
@@ -2794,12 +2844,6 @@ interface NitroOptions extends PresetOptions {
      * @see https://nitro.build/guide/tasks
      */
     tasks?: boolean;
-    /**
-     * Infer path aliases from tsconfig.json
-     *
-     * @default true
-     */
-    tsconfigPaths?: boolean;
   };
   future: {
     nativeSWR?: boolean;
@@ -2826,6 +2870,7 @@ interface NitroOptions extends PresetOptions {
     port?: number;
     hostname?: string;
     watch?: string[];
+    runner?: RunnerName;
   };
   watchOptions: ChokidarOptions;
   devProxy: Record<string, string | ProxyServerOptions>;
@@ -2880,13 +2925,13 @@ interface NitroOptions extends PresetOptions {
   inlineDynamicImports: boolean;
   sourcemap: boolean;
   node: boolean;
-  moduleSideEffects: string[];
   oxc?: OXCOptions;
   replace: Record<string, string | ((id: string) => string)>;
   commonJS?: RollupCommonJSOptions;
   exportConditions?: string[];
   noExternals?: boolean | (string | RegExp)[];
   traceDeps?: (string | RegExp)[];
+  traceOpts?: Pick<ExternalsTraceOptions, "nft" | "traceAlias" | "chmod" | "transform" | "hooks">;
   typescript: {
     strict?: boolean;
     generateRuntimeConfigTypes?: boolean;
@@ -2919,7 +2964,7 @@ interface NitroOptions extends PresetOptions {
 /**
  * Nitro input config (nitro.config)
  */
-interface NitroConfig extends Partial<Omit<NitroOptions, "routeRules" | "rollupConfig" | "preset" | "compatibilityDate" | "unenv" | "serverDir" | "_config" | "_c12" | "serverEntry" | "renderer" | "output">>, C12InputConfig<NitroConfig> {
+interface NitroConfig extends Partial<Omit<NitroOptions, "routeRules" | "rollupConfig" | "preset" | "compatibilityDate" | "unenv" | "serverDir" | "_config" | "_c12" | "serverEntry" | "renderer" | "output" | "tracingChannel">>, C12InputConfig<NitroConfig> {
   preset?: PresetNameInput;
   extends?: string | string[] | NitroPreset;
   routeRules?: {
@@ -2932,6 +2977,7 @@ interface NitroConfig extends Partial<Omit<NitroOptions, "routeRules" | "rollupC
   serverEntry?: string | NitroOptions["serverEntry"];
   renderer?: false | NitroOptions["renderer"];
   output?: Partial<NitroOptions["output"]>;
+  tracingChannel?: boolean | TracingOptions;
 }
 interface LoadConfigOptions {
   watch?: boolean;
@@ -2954,6 +3000,7 @@ interface PublicAssetDir {
 interface CompressOptions {
   gzip?: boolean;
   brotli?: boolean;
+  zstd?: boolean;
 }
 interface ServerAssetDir {
   baseName: string;
@@ -2961,6 +3008,10 @@ interface ServerAssetDir {
   dir: string;
   ignore?: string[];
 }
+interface TracingOptions {
+  srvx?: boolean;
+  h3?: boolean;
+}
 type CustomDriverName = string & {
   _custom?: any;
 };
@@ -2992,34 +3043,6 @@ interface NitroRuntimeConfig {
   };
   [key: string]: any;
 }
-//#endregion
-//#region src/types/runner.d.ts
-type FetchHandler = (req: Request) => Promise<Response>;
-type RunnerMessageListener = (data: unknown) => void;
-type UpgradeHandler = (req: IncomingMessage, socket: OutgoingMessage<IncomingMessage> | Duplex, head: any) => void;
-interface RunnerRPCHooks {
-  sendMessage: (message: unknown) => void;
-  onMessage: (listener: RunnerMessageListener) => void;
-  offMessage: (listener: RunnerMessageListener) => void;
-}
-type WorkerAddress = {
-  host: string;
-  port: number;
-  socketPath?: string;
-};
-interface WorkerHooks {
-  onClose?: (worker: EnvRunner, cause?: unknown) => void;
-  onReady?: (worker: EnvRunner, address?: WorkerAddress) => void;
-}
-interface EnvRunner extends WorkerHooks, RunnerRPCHooks {
-  readonly ready: boolean;
-  readonly closed: boolean;
-  fetch: FetchHandler;
-  upgrade?: UpgradeHandler;
-  close(): Promise<void>;
-}
-//#endregion
-//#region src/types/global.d.ts
 interface NitroImportMeta {
   dev?: boolean;
   preset?: NitroOptions["preset"];
@@ -3036,8 +3059,6 @@ interface NitroImportMeta {
 declare global {
   interface ImportMeta extends NitroImportMeta {}
 }
-//#endregion
-//#region src/types/h3.d.ts
 type H3EventFetch = (request: NitroFetchRequest, init?: RequestInit) => Promise<Response>;
 type H3Event$Fetch = Base$Fetch<unknown, NitroFetchRequest>;
 declare module "srvx" {
@@ -3055,5 +3076,4 @@ declare module "srvx" {
     };
   }
 }
-//#endregion
-export { $Fetch, AssetMeta, AvailableRouterMethod, Base$Fetch, CacheEntry, CacheOptions, CachedEventHandlerOptions, CaptureError, CapturedErrorContext, CompressOptions, DatabaseConnectionConfig, DatabaseConnectionConfigs, DatabaseConnectionName, EnvRunner, EventHandlerFormat, ExtractedRouteMethod, FetchHandler, H3Event$Fetch, H3EventFetch, HTTPstatus, InternalApi, LoadConfigOptions, MatchedRouteRule, MatchedRouteRules, MatchedRoutes, MiddlewareOf, Nitro, NitroApp, NitroAppPlugin, NitroAsyncContext, NitroBuildInfo, NitroConfig, NitroDevEventHandler, NitroDynamicConfig, NitroErrorHandler, NitroEventHandler, NitroFetchOptions, NitroFetchRequest, NitroFrameworkInfo, NitroHooks, NitroImportMeta, NitroModule, NitroModuleInput, type NitroOpenAPIConfig, NitroOptions, NitroPreset, NitroPresetMeta, NitroRouteConfig, NitroRouteMeta, NitroRouteRules, NitroRuntimeConfig, NitroRuntimeConfigApp, NitroRuntimeHooks, NitroTypes, OXCOptions, PrerenderGenerateRoute, PrerenderRoute, PublicAsset, PublicAssetDir, RenderContext, RenderHandler, RenderResponse, ResponseCacheEntry, RolldownConfig, RollupConfig, RunnerMessageListener, RunnerRPCHooks, Serialize, SerializeObject, SerializeTuple, ServerAssetDir, type ServerRequest, Simplify, StorageMounts, Task, TaskContext, TaskEvent, TaskMeta, TaskPayload, TaskResult, TaskRunnerOptions, TypedInternalResponse, UpgradeHandler, WorkerAddress, WorkerHooks };
+export { $Fetch, AssetMeta, AvailableRouterMethod, Base$Fetch, type CacheEntry, type CacheOptions, CachedEventHandlerOptions, CaptureError, CapturedErrorContext, CompressOptions, DatabaseConnectionConfig, DatabaseConnectionConfigs, DatabaseConnectionName, type EnvRunner, EventHandlerFormat, ExtractedRouteMethod, type FetchHandler, H3Event$Fetch, H3EventFetch, HTTPstatus, InternalApi, LoadConfigOptions, MatchedRouteRule, MatchedRouteRules, MatchedRoutes, MiddlewareOf, Nitro, NitroApp, NitroAppPlugin, NitroAsyncContext, NitroBuildInfo, NitroConfig, NitroDevEventHandler, NitroDynamicConfig, NitroErrorHandler, NitroEventHandler, NitroFetchOptions, NitroFetchRequest, NitroFrameworkInfo, NitroHooks, NitroImportMeta, NitroMeta, NitroModule, NitroModuleInput, type NitroOpenAPIConfig, NitroOptions, NitroPreset, NitroPresetMeta$1 as NitroPresetMeta, NitroRouteConfig, NitroRouteMeta, NitroRouteRules, NitroRuntimeConfig, NitroRuntimeConfigApp, NitroRuntimeHooks, NitroTypes, OXCOptions, PrerenderGenerateRoute, PrerenderRoute, PublicAsset, PublicAssetDir, RenderContext, RenderHandler, RenderResponse, type ResponseCacheEntry, RolldownConfig, RollupConfig, type RunnerMessageListener, type RunnerRPCHooks, Serialize, SerializeObject, SerializeTuple, ServerAssetDir, type ServerRequest, Simplify, StorageMounts, Task, TaskContext, TaskEvent, TaskMeta, TaskPayload, TaskResult, TaskRunnerOptions, TracingOptions, TypedInternalResponse, type UpgradeHandler, VercelISRConfig, type WorkerAddress, type WorkerHooks };