h3 2.0.1-rc.2 → 2.0.1-rc.21

package/dist/_entries/node.mjs

@@ -1,10 +1,6 @@
-import { H3, H3Core, H3Error, H3Event, HTTPError, HTTPResponse, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, basicAuth, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, freezeApp, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, removeResponseHeader, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, writeEarlyHints } from "../h3.mjs";
+import { $ as basicAuth, $t as defineLazyEventHandler, A as readFormDataBody, An as freezeApp, At as bodyLimit, B as setHeader, Bt as redirect, C as getResponseHeader, Cn as toMiddleware, Ct as parseCookies, D as isError, Dn as sanitizeStatusCode, Dt as getProxyRequestHeaders, E as getResponseStatusText, En as HTTPError, Et as fetchWithEvent, F as sendNoContent, Ft as readBody, Gt as defineNodeHandler, H as setResponseHeader, Ht as writeEarlyHints, I as sendProxy, It as readValidatedBody, J as defineJsonRpcHandler, Jt as fromWebHandler, K as toNodeListener, Kt as defineNodeMiddleware, L as sendRedirect, Lt as html, M as readRawBody, Mt as onRequest, N as removeResponseHeader, Nt as onResponse, O as lazyEventHandler, On as sanitizeStatusMessage, Ot as proxy, P as sendIterable, Pt as assertBodySize, Q as getRequestFingerprint, Qt as defineHandler, R as sendStream, Rt as iterable, S as getRequestWebStream, Sn as defineMiddleware, St as getValidatedCookies, T as getResponseStatus, Tn as toResponse, Tt as setCookie, U as setResponseHeaders, Ut as defineRoute, V as setHeaders, Vt as redirectBack, W as setResponseStatus, Wt as removeRoute, X as defineWebSocket, Xt as H3, Y as defineJsonRpcWebSocketHandler, Yt as toWebHandler, Z as defineWebSocketHandler, Zt as H3Core, _ as getHeaders, _n as getEventContext, _t as createEventStream, a as appendResponseHeaders, an as getRequestHost, at as isCorsOriginAllowed, b as getRequestHeaders, bn as mockEvent, bt as getChunkedCookie, c as createError, cn as getRequestURL, ct as sealSession, d as defineEventHandler, dn as getValidatedQuery, dt as useSession, en as defineValidatedHandler, et as requireBasicAuth, f as defineNodeListener, fn as getValidatedRouterParams, ft as withBase, g as getHeader, gn as toRequest, gt as withServerTiming, h as getBodyStream, hn as requestWithURL, ht as setServerTiming, i as appendResponseHeader, in as getQuery, it as isPreflightRequest, j as readMultipartFormData, jt as onError, k as readFormData, kn as H3Event, kt as proxyRequest, l as createRouter, ln as getRouterParam, lt as unsealSession, m as fromNodeMiddleware, mn as requestWithBaseURL, mt as handleCacheHeaders, n as appendHeader, nn as toEventHandler, nt as appendCorsPreflightHeaders, o as clearResponseHeaders, on as getRequestIP, ot as clearSession, p as eventHandler, pn as isMethod, pt as serveStatic, q as useBase, qt as fromNodeHandler, r as appendHeaders, rn as assertMethod, rt as handleCors, s as createApp, sn as getRequestProtocol, st as getSession, t as H3Error, tn as dynamicEventHandler, tt as appendCorsHeaders, u as defaultContentType, un as getRouterParams, ut as updateSession, v as getMethod, vn as isEvent, vt as deleteChunkedCookie, w as getResponseHeaders, wn as HTTPResponse, wt as setChunkedCookie, x as getRequestPath, xn as callMiddleware, xt as getCookie, y as getRequestHeader, yn as isHTTPEvent, yt as deleteCookie, z as sendWebResponse, zt as noContent } from "../h3-CRCltuUf.mjs";
+import { t as definePlugin } from "../h3-DagAgogP.mjs";
 import { serve as serve$1, toNodeHandler as toNodeHandler$1 } from "srvx/node";
-
-//#region src/_entries/node.ts
-/**
-* Serve the H3 app.
-*/
 function serve(app, options) {
 	freezeApp(app);
 	return serve$1({
@@ -12,12 +8,7 @@ function serve(app, options) {
 		...options
 	});
 }
-/**
-* Convert H3 app instance to a NodeHandler with (IncomingMessage, ServerResponse) => void signature.
-*/
 function toNodeHandler(app) {
 	return toNodeHandler$1(app.fetch);
 }
-
-//#endregion
-export { H3, H3Core, H3Error, H3Event, HTTPError, HTTPResponse, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, basicAuth, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, removeResponseHeader, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serve, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, writeEarlyHints };
+export { H3, H3Core, H3Error, H3Event, HTTPError, HTTPResponse, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertBodySize, assertMethod, basicAuth, bodyLimit, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineJsonRpcHandler, defineJsonRpcWebSocketHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedCookies, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, redirectBack, removeResponseHeader, removeRoute, requestWithBaseURL, requestWithURL, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serve, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, setServerTiming, toEventHandler, toMiddleware, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, withServerTiming, writeEarlyHints };

package/dist/_entries/service-worker.d.mts

@@ -1,11 +1,6 @@
-import { BasicAuthOptions, CacheConditions, CorsOptions, DynamicEventHandler, ErrorBody, ErrorDetails, ErrorInput, EventHandler, EventHandlerFetch, EventHandlerObject, EventHandlerRequest, EventHandlerResponse, EventHandlerWithFetch, EventStreamMessage, EventStreamOptions, FetchHandler, FetchableObject, H3$1 as H3, H3Config, H3Core$1 as H3Core, H3Error$1 as H3Error, H3Event$1 as H3Event, H3EventContext, H3Plugin, H3Route, H3RouteMeta, HTTPError$1 as HTTPError, HTTPEvent, HTTPHandler, HTTPMethod, HTTPResponse$1 as HTTPResponse, InferEventInput, LazyEventHandler, Middleware, MiddlewareOptions, NodeHandler, NodeMiddleware, PreparedResponse, ProxyOptions, RequestFingerprintOptions, RouteDefinition, RouteOptions, ServeStaticOptions, Session, SessionConfig, SessionData, SessionManager, StaticAssetMeta, TypedServerRequest, WebSocketHooks, WebSocketMessage, WebSocketPeer, appendCorsHeaders$1 as appendCorsHeaders, appendCorsPreflightHeaders$1 as appendCorsPreflightHeaders, appendHeader$1 as appendHeader, appendHeaders$1 as appendHeaders, appendResponseHeader$1 as appendResponseHeader, appendResponseHeaders$1 as appendResponseHeaders, assertMethod$1 as assertMethod, basicAuth$1 as basicAuth, callMiddleware$1 as callMiddleware, clearResponseHeaders$1 as clearResponseHeaders, clearSession$1 as clearSession, createApp$1 as createApp, createError$1 as createError, createEventStream$1 as createEventStream, createRouter$1 as createRouter, defaultContentType$1 as defaultContentType, defineEventHandler$1 as defineEventHandler, defineHandler$1 as defineHandler, defineLazyEventHandler$1 as defineLazyEventHandler, defineMiddleware$1 as defineMiddleware, defineNodeHandler$1 as defineNodeHandler, defineNodeListener$1 as defineNodeListener, defineNodeMiddleware$1 as defineNodeMiddleware, definePlugin$1 as definePlugin, defineRoute$1 as defineRoute, defineValidatedHandler$1 as defineValidatedHandler, defineWebSocket$1 as defineWebSocket, defineWebSocketHandler$1 as defineWebSocketHandler, deleteChunkedCookie$1 as deleteChunkedCookie, deleteCookie$1 as deleteCookie, dynamicEventHandler$1 as dynamicEventHandler, eventHandler$1 as eventHandler, fetchWithEvent$1 as fetchWithEvent, fromNodeHandler$1 as fromNodeHandler, fromNodeMiddleware$1 as fromNodeMiddleware, fromWebHandler$1 as fromWebHandler, getBodyStream$1 as getBodyStream, getChunkedCookie$1 as getChunkedCookie, getCookie$1 as getCookie, getEventContext$1 as getEventContext, getHeader$1 as getHeader, getHeaders$1 as getHeaders, getMethod$1 as getMethod, getProxyRequestHeaders$1 as getProxyRequestHeaders, getQuery$1 as getQuery, getRequestFingerprint$1 as getRequestFingerprint, getRequestHeader$1 as getRequestHeader, getRequestHeaders$1 as getRequestHeaders, getRequestHost$1 as getRequestHost, getRequestIP$1 as getRequestIP, getRequestPath$1 as getRequestPath, getRequestProtocol$1 as getRequestProtocol, getRequestURL$1 as getRequestURL, getRequestWebStream$1 as getRequestWebStream, getResponseHeader$1 as getResponseHeader, getResponseHeaders$1 as getResponseHeaders, getResponseStatus$1 as getResponseStatus, getResponseStatusText$1 as getResponseStatusText, getRouterParam$1 as getRouterParam, getRouterParams$1 as getRouterParams, getSession$1 as getSession, getValidatedQuery$1 as getValidatedQuery, getValidatedRouterParams$1 as getValidatedRouterParams, handleCacheHeaders$1 as handleCacheHeaders, handleCors$1 as handleCors, html$1 as html, isCorsOriginAllowed$1 as isCorsOriginAllowed, isError$1 as isError, isEvent$1 as isEvent, isHTTPEvent$1 as isHTTPEvent, isMethod$1 as isMethod, isPreflightRequest$1 as isPreflightRequest, iterable$1 as iterable, lazyEventHandler$1 as lazyEventHandler, mockEvent$1 as mockEvent, noContent$1 as noContent, onError$1 as onError, onRequest$1 as onRequest, onResponse$1 as onResponse, parseCookies$1 as parseCookies, proxy$1 as proxy, proxyRequest$1 as proxyRequest, readBody$1 as readBody, readFormData$1 as readFormData, readFormDataBody$1 as readFormDataBody, readMultipartFormData$1 as readMultipartFormData, readRawBody$1 as readRawBody, readValidatedBody$1 as readValidatedBody, redirect$1 as redirect, removeResponseHeader$1 as removeResponseHeader, requireBasicAuth$1 as requireBasicAuth, sanitizeStatusCode$1 as sanitizeStatusCode, sanitizeStatusMessage$1 as sanitizeStatusMessage, sealSession$1 as sealSession, sendIterable$1 as sendIterable, sendNoContent$1 as sendNoContent, sendProxy$1 as sendProxy, sendRedirect$1 as sendRedirect, sendStream$1 as sendStream, sendWebResponse$1 as sendWebResponse, serveStatic$1 as serveStatic, setChunkedCookie$1 as setChunkedCookie, setCookie$1 as setCookie, setHeader$1 as setHeader, setHeaders$1 as setHeaders, setResponseHeader$1 as setResponseHeader, setResponseHeaders$1 as setResponseHeaders, setResponseStatus$1 as setResponseStatus, toEventHandler$1 as toEventHandler, toNodeHandler$1 as toNodeHandler, toNodeListener$1 as toNodeListener, toRequest$1 as toRequest, toResponse$1 as toResponse, toWebHandler$1 as toWebHandler, unsealSession$1 as unsealSession, updateSession$1 as updateSession, useBase$1 as useBase, useSession$1 as useSession, withBase$1 as withBase, writeEarlyHints$1 as writeEarlyHints } from "../h3.mjs";
+import { A as FetchHandler, B as SessionConfig, C as DynamicEventHandler, D as EventHandlerRequest, E as EventHandlerObject, F as Middleware, G as sealSession, H as SessionManager, I as TypedServerRequest, J as useSession, K as unsealSession, M as HTTPHandler, N as InferEventInput, O as EventHandlerResponse, P as LazyEventHandler, S as HTTPError, T as EventHandlerFetch, U as clearSession, V as SessionData, W as getSession, _ as RouterContext, a as H3EventContext, b as ErrorDetails, c as H3CoreConfig, d as H3RouteMeta, f as HTTPMethod, g as RouteOptions, h as PreparedResponse, i as HTTPEvent, j as FetchableObject, k as EventHandlerWithFetch, l as H3Plugin, m as MiddlewareOptions, n as H3Core, p as MatchedRoute, q as updateSession, r as H3Event, s as H3Config, t as H3, u as H3Route, v as definePlugin, w as EventHandler, x as ErrorInput, y as ErrorBody, z as Session } from "../h3-D76FUMrE.mjs";
+import { $ as JsonRpcWebSocketMethod, $t as noContent, A as readFormDataBody, An as defineMiddleware, At as createEventStream, B as setHeader, Bn as mockEvent, Bt as readBody, C as getResponseHeader, Cn as defineNodeMiddleware, Ct as handleCacheHeaders, D as isError, Dn as HTTPResponse, Dt as withServerTiming, E as getResponseStatusText, En as toWebHandler, Et as setServerTiming, F as sendNoContent, Fn as dynamicEventHandler, Ft as getValidatedCookies, G as toNodeHandler, Gt as proxy, H as setResponseHeader, Ht as ProxyOptions, I as sendProxy, In as toEventHandler, It as parseCookies, J as JsonRpcError, Jt as onError, K as toNodeListener, Kt as proxyRequest, L as sendRedirect, Ln as getEventContext, Lt as setChunkedCookie, M as readRawBody, Mn as defineHandler, Mt as deleteCookie, N as removeResponseHeader, Nn as defineLazyEventHandler, Nt as getChunkedCookie, O as lazyEventHandler, On as toResponse, Ot as EventStreamMessage, P as sendIterable, Pn as defineValidatedHandler, Pt as getCookie, Q as JsonRpcResponse, Qt as iterable, R as sendStream, Rn as isEvent, Rt as setCookie, S as getRequestWebStream, Sn as defineNodeHandler, St as CacheConditions, T as getResponseStatus, Tn as fromWebHandler, Tt as sanitizeStatusMessage, U as setResponseHeaders, Ut as fetchWithEvent, V as setHeaders, Vt as readValidatedBody, W as setResponseStatus, Wt as getProxyRequestHeaders, X as JsonRpcParams, Xt as onResponse, Y as JsonRpcMethod, Yt as onRequest, Z as JsonRpcRequest, Zt as html, _ as getHeaders, _n as RouteDefinition, _t as isCorsOriginAllowed, a as appendResponseHeaders, an as getRequestHost, at as defineWebSocket, b as getRequestHeaders, bn as NodeHandler, bt as StaticAssetMeta, c as createError, cn as getRequestURL, ct as getRequestFingerprint, d as defineEventHandler, dn as getValidatedQuery, dt as requireBasicAuth, en as redirect, et as defineJsonRpcHandler, f as defineNodeListener, fn as getValidatedRouterParams, ft as CorsOptions, g as getHeader, gn as toRequest, gt as isPreflightRequest, h as getBodyStream, hn as requestWithURL, ht as handleCors, i as appendResponseHeader, in as getQuery, it as WebSocketPeer, j as readMultipartFormData, jn as toMiddleware, jt as deleteChunkedCookie, k as readFormData, kn as callMiddleware, kt as EventStreamOptions, l as createRouter, ln as getRouterParam, lt as BasicAuthOptions, m as fromNodeMiddleware, mn as requestWithBaseURL, mt as appendCorsPreflightHeaders, n as appendHeader, nn as writeEarlyHints, nt as WebSocketHooks, o as clearResponseHeaders, on as getRequestIP, ot as defineWebSocketHandler, p as eventHandler, pn as isMethod, pt as appendCorsHeaders, q as useBase, qt as bodyLimit, r as appendHeaders, rn as assertMethod, rt as WebSocketMessage, s as createApp, sn as getRequestProtocol, st as RequestFingerprintOptions, t as H3Error, tn as redirectBack, tt as defineJsonRpcWebSocketHandler, u as defaultContentType, un as getRouterParams, ut as basicAuth, v as getMethod, vn as defineRoute, vt as withBase, w as getResponseHeaders, wn as fromNodeHandler, wt as sanitizeStatusCode, x as getRequestPath, xn as NodeMiddleware, xt as serveStatic, y as getRequestHeader, yn as removeRoute, yt as ServeStaticOptions, z as sendWebResponse, zn as isHTTPEvent, zt as assertBodySize } from "../h3-DiSMXP1G.mjs";
 import { Server, ServerOptions } from "srvx";
 
-//#region src/_entries/service-worker.d.ts
-
-/**
-* Serve the H3 app.
-*/
 declare function serve(app: H3, options?: Omit<ServerOptions, "fetch">): Server;
-//#endregion
-export { BasicAuthOptions, CacheConditions, CorsOptions, DynamicEventHandler, ErrorBody, ErrorDetails, ErrorInput, EventHandler, EventHandlerFetch, EventHandlerObject, EventHandlerRequest, EventHandlerResponse, EventHandlerWithFetch, EventStreamMessage, EventStreamOptions, FetchHandler, FetchableObject, H3, H3Config, H3Core, H3Error, H3Event, H3EventContext, H3Plugin, H3Route, H3RouteMeta, HTTPError, HTTPEvent, HTTPHandler, HTTPMethod, HTTPResponse, InferEventInput, LazyEventHandler, Middleware, MiddlewareOptions, NodeHandler, NodeMiddleware, PreparedResponse, ProxyOptions, RequestFingerprintOptions, RouteDefinition, RouteOptions, ServeStaticOptions, Session, SessionConfig, SessionData, SessionManager, StaticAssetMeta, TypedServerRequest, WebSocketHooks, WebSocketMessage, WebSocketPeer, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, basicAuth, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, removeResponseHeader, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serve, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, writeEarlyHints };
+export { BasicAuthOptions, CacheConditions, CorsOptions, DynamicEventHandler, ErrorBody, ErrorDetails, ErrorInput, EventHandler, EventHandlerFetch, EventHandlerObject, EventHandlerRequest, EventHandlerResponse, EventHandlerWithFetch, EventStreamMessage, EventStreamOptions, FetchHandler, FetchableObject, H3, H3Config, H3Core, H3CoreConfig, H3Error, H3Event, H3EventContext, H3Plugin, H3Route, H3RouteMeta, HTTPError, HTTPEvent, HTTPHandler, HTTPMethod, HTTPResponse, InferEventInput, JsonRpcError, JsonRpcMethod, JsonRpcParams, JsonRpcRequest, JsonRpcResponse, JsonRpcWebSocketMethod, LazyEventHandler, MatchedRoute, Middleware, MiddlewareOptions, NodeHandler, NodeMiddleware, PreparedResponse, ProxyOptions, RequestFingerprintOptions, RouteDefinition, RouteOptions, RouterContext, ServeStaticOptions, Session, SessionConfig, SessionData, SessionManager, StaticAssetMeta, TypedServerRequest, WebSocketHooks, WebSocketMessage, WebSocketPeer, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertBodySize, assertMethod, basicAuth, bodyLimit, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineJsonRpcHandler, defineJsonRpcWebSocketHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedCookies, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, redirectBack, removeResponseHeader, removeRoute, requestWithBaseURL, requestWithURL, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serve, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, setServerTiming, toEventHandler, toMiddleware, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, withServerTiming, writeEarlyHints };

package/dist/_entries/service-worker.mjs

@@ -1,10 +1,6 @@
-import { H3, H3Core, H3Error, H3Event, HTTPError, HTTPResponse, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, basicAuth, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, freezeApp, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, removeResponseHeader, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, writeEarlyHints } from "../h3.mjs";
+import { $ as basicAuth, $t as defineLazyEventHandler, A as readFormDataBody, An as freezeApp, At as bodyLimit, B as setHeader, Bt as redirect, C as getResponseHeader, Cn as toMiddleware, Ct as parseCookies, D as isError, Dn as sanitizeStatusCode, Dt as getProxyRequestHeaders, E as getResponseStatusText, En as HTTPError, Et as fetchWithEvent, F as sendNoContent, Ft as readBody, G as toNodeHandler, Gt as defineNodeHandler, H as setResponseHeader, Ht as writeEarlyHints, I as sendProxy, It as readValidatedBody, J as defineJsonRpcHandler, Jt as fromWebHandler, K as toNodeListener, Kt as defineNodeMiddleware, L as sendRedirect, Lt as html, M as readRawBody, Mt as onRequest, N as removeResponseHeader, Nt as onResponse, O as lazyEventHandler, On as sanitizeStatusMessage, Ot as proxy, P as sendIterable, Pt as assertBodySize, Q as getRequestFingerprint, Qt as defineHandler, R as sendStream, Rt as iterable, S as getRequestWebStream, Sn as defineMiddleware, St as getValidatedCookies, T as getResponseStatus, Tn as toResponse, Tt as setCookie, U as setResponseHeaders, Ut as defineRoute, V as setHeaders, Vt as redirectBack, W as setResponseStatus, Wt as removeRoute, X as defineWebSocket, Xt as H3, Y as defineJsonRpcWebSocketHandler, Yt as toWebHandler, Z as defineWebSocketHandler, Zt as H3Core, _ as getHeaders, _n as getEventContext, _t as createEventStream, a as appendResponseHeaders, an as getRequestHost, at as isCorsOriginAllowed, b as getRequestHeaders, bn as mockEvent, bt as getChunkedCookie, c as createError, cn as getRequestURL, ct as sealSession, d as defineEventHandler, dn as getValidatedQuery, dt as useSession, en as defineValidatedHandler, et as requireBasicAuth, f as defineNodeListener, fn as getValidatedRouterParams, ft as withBase, g as getHeader, gn as toRequest, gt as withServerTiming, h as getBodyStream, hn as requestWithURL, ht as setServerTiming, i as appendResponseHeader, in as getQuery, it as isPreflightRequest, j as readMultipartFormData, jt as onError, k as readFormData, kn as H3Event, kt as proxyRequest, l as createRouter, ln as getRouterParam, lt as unsealSession, m as fromNodeMiddleware, mn as requestWithBaseURL, mt as handleCacheHeaders, n as appendHeader, nn as toEventHandler, nt as appendCorsPreflightHeaders, o as clearResponseHeaders, on as getRequestIP, ot as clearSession, p as eventHandler, pn as isMethod, pt as serveStatic, q as useBase, qt as fromNodeHandler, r as appendHeaders, rn as assertMethod, rt as handleCors, s as createApp, sn as getRequestProtocol, st as getSession, t as H3Error, tn as dynamicEventHandler, tt as appendCorsHeaders, u as defaultContentType, un as getRouterParams, ut as updateSession, v as getMethod, vn as isEvent, vt as deleteChunkedCookie, w as getResponseHeaders, wn as HTTPResponse, wt as setChunkedCookie, x as getRequestPath, xn as callMiddleware, xt as getCookie, y as getRequestHeader, yn as isHTTPEvent, yt as deleteCookie, z as sendWebResponse, zt as noContent } from "../h3-CRCltuUf.mjs";
+import { t as definePlugin } from "../h3-DagAgogP.mjs";
 import { serve as serve$1 } from "srvx/service-worker";
-
-//#region src/_entries/service-worker.ts
-/**
-* Serve the H3 app.
-*/
 function serve(app, options) {
 	freezeApp(app);
 	return serve$1({
@@ -12,6 +8,4 @@ function serve(app, options) {
 		...options
 	});
 }
-
-//#endregion
-export { H3, H3Core, H3Error, H3Event, HTTPError, HTTPResponse, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, basicAuth, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, removeResponseHeader, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serve, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, writeEarlyHints };
+export { H3, H3Core, H3Error, H3Event, HTTPError, HTTPResponse, appendCorsHeaders, appendCorsPreflightHeaders, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertBodySize, assertMethod, basicAuth, bodyLimit, callMiddleware, clearResponseHeaders, clearSession, createApp, createError, createEventStream, createRouter, defaultContentType, defineEventHandler, defineHandler, defineJsonRpcHandler, defineJsonRpcWebSocketHandler, defineLazyEventHandler, defineMiddleware, defineNodeHandler, defineNodeListener, defineNodeMiddleware, definePlugin, defineRoute, defineValidatedHandler, defineWebSocket, defineWebSocketHandler, deleteChunkedCookie, deleteCookie, dynamicEventHandler, eventHandler, fetchWithEvent, fromNodeHandler, fromNodeMiddleware, fromWebHandler, getBodyStream, getChunkedCookie, getCookie, getEventContext, getHeader, getHeaders, getMethod, getProxyRequestHeaders, getQuery, getRequestFingerprint, getRequestHeader, getRequestHeaders, getRequestHost, getRequestIP, getRequestPath, getRequestProtocol, getRequestURL, getRequestWebStream, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, getSession, getValidatedCookies, getValidatedQuery, getValidatedRouterParams, handleCacheHeaders, handleCors, html, isCorsOriginAllowed, isError, isEvent, isHTTPEvent, isMethod, isPreflightRequest, iterable, lazyEventHandler, mockEvent, noContent, onError, onRequest, onResponse, parseCookies, proxy, proxyRequest, readBody, readFormData, readFormDataBody, readMultipartFormData, readRawBody, readValidatedBody, redirect, redirectBack, removeResponseHeader, removeRoute, requestWithBaseURL, requestWithURL, requireBasicAuth, sanitizeStatusCode, sanitizeStatusMessage, sealSession, sendIterable, sendNoContent, sendProxy, sendRedirect, sendStream, sendWebResponse, serve, serveStatic, setChunkedCookie, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, setServerTiming, toEventHandler, toMiddleware, toNodeHandler, toNodeListener, toRequest, toResponse, toWebHandler, unsealSession, updateSession, useBase, useSession, withBase, withServerTiming, writeEarlyHints };

package/dist/docs/0.guide/0.index/index.md

@@ -0,0 +1,117 @@
+# Getting Started
+
+> Get started with H3.
+
+> [!IMPORTANT]
+> You are currently reading H3 v2 docs. See [v1.h3.dev](https://v1.h3.dev/) for legacy docs.
+
+## Overview
+
+⚡ H3 (short for H(TTP), pronounced as /eɪtʃθriː/, like h-3) is a lightweight, fast, and composable server framework for modern JavaScript runtimes. It is based on web standard primitives such as [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request), [Response](https://developer.mozilla.org/en-US/docs/Web/API/Response), [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL), and [Headers](https://developer.mozilla.org/en-US/docs/Web/API/Headers). You can integrate H3 with any compatible runtime or [mount](/guide/api/h3#h3mount) other web-compatible handlers to H3 with almost no added latency.
+
+H3 is designed to be extendable and composable. Instead of providing one big core, you start with a lightweight [H3 instance](/guide/api/h3) and then import built-in, tree-shakable [utilities](/utils) or bring your own for more functionality.
+Composable utilities has several advantages:
+
+- The server only includes used code and runs them exactly where is needed.
+- Application size can scale better. Usage of utilities is explicit and clean, with less global impact.
+- H3 is minimally opinionated and won't limit your choices.
+All utilities, share an [H3Event](/guide/api/h3event) context.
+
+<read-more></read-more>
+
+## Quick Start
+
+> [!TIP]
+> You try H3 online [on ⚡️ Stackblitz ](https://stackblitz.com/github/h3js/h3/tree/main/playground?file=server.mjs).
+
+Install `h3` as a dependency:
+
+<pm-install></pm-install>
+
+Create a new file for server entry:
+
+```ts [server.mjs]
+import { H3, serve } from "h3";
+
+const app = new H3().get("/", (event) => "⚡️ Tadaa!");
+
+serve(app, { port: 3000 });
+```
+
+Then, run the server using your favorite runtime:
+
+<code-group>
+
+```bash [node]
+node --watch ./server.mjs
+```
+
+```bash [deno]
+deno run -A --watch ./server.mjs
+```
+
+```bash [bun]
+bun run --watch server.mjs
+```
+</code-group>
+
+And tadaa! We have a web server running locally.
+
+### What Happened?
+
+Okay, let's now break down our hello world example.
+
+We first created an [H3](/guide/api/h3) app instance using `new H3()`:
+
+```ts
+const app = new H3();
+```
+
+[H3](/guide/api/h3) is a tiny class capable of [matching routes](/guide/basics/routing), [generating responses](/guide/basics/response) and calling [middleware](/guide/basics/middleware) and [global hooks](/guide/api/h3#global-hooks).
+
+Then we add a route for handling HTTP GET requests to `/` path.
+
+```ts
+app.get("/", (event) => {
+  return { message: "⚡️ Tadaa!" };
+});
+```
+
+<read-more></read-more>
+
+We simply returned an object. H3 automatically [converts](/guide/basics/response#response-types) values into web responses.
+
+<read-more></read-more>
+
+Finally, we use `serve` method to start the server listener. Using `serve` method you can easily start an H3 server in various runtimes.
+
+```js
+serve(app, { port: 3000 });
+```
+
+> [!TIP]
+> The `serve` method is powered by [💥 srvx](https://srvx.h3.dev/), a runtime-agnostic universal server listener based on web standards that works seamlessly with [Deno](https://deno.com/), [Node.js](https://nodejs.org/) and [Bun](https://bun.sh/).
+
+We also have [`app.fetch`](/guide/api/h3#h3fetch) which can be directly used to run H3 apps in any web-compatible runtime or even directly called for testing purposes.
+
+<read-more></read-more>
+
+```js
+import { H3, serve } from "h3";
+
+const app = new H3().get("/", () => "⚡️ Tadaa!");
+
+// Test without listening
+const response = await app.request("/");
+console.log(await response.text());
+```
+
+You can directly import `h3` library from CDN alternatively. This method can be used for Bun, Deno and other runtimes such as Cloudflare Workers.
+
+```js
+import { H3 } from "https://esm.sh/h3";
+
+const app = new H3().get("/", () => "⚡️ Tadaa!");
+
+export const fetch = app.fetch;
+```

package/dist/docs/0.guide/1.basics/0.lifecycle.md

@@ -0,0 +1,68 @@
+# Request Lifecycle
+
+> H3 dispatches incoming web requests to final web responses.
+
+Below is an overview of what happens in a H3 server from when an HTTP request arrives until a response is generated.
+
+## 1. Incoming Request
+
+When An HTTP request is made by Browser or [fetch()](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API), server fetch handler receives a [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request) object.
+
+```mermaid
+%%{init: {'theme':'neutral'}}%%
+flowchart LR
+  A1["<code>fetch(request)</code>"] --> A2["<code>server.fetch(request)</code>"]
+
+click A2 "/guide/api/h3#h3fetch"
+```
+
+> [!TIP]
+> ​[💥 Srvx](https://srvx.h3.dev) provides unified `server.fetch` interface and adds [Node.js compatibility](https://srvx.h3.dev/guide/node).
+
+## 2. Accept Request
+
+H3 Initializes an [`H3Event`](/guide/api/h3event) instance from incoming request, calls [`onRequest`](/guide/api/h3#global-hooks) global hook and finally [`H3.handler`](/guide/api/h3#h3handler) with the initialized event.
+
+```mermaid
+%%{init: {'theme':'neutral'}}%%
+flowchart LR
+  B1["<code>new H3Event(request)</code>"] --> B2["<code>onRequest(event)</code>"] --> B3["<code>h3.handler(event)</code>"]
+
+click B1 "/guide/api/h3event"
+click B2 "/guide/api/h3#global-hooks"
+click B3 "/guide/api/h3#apphandler"
+```
+
+## 3. Dispatch Request
+
+H3 [matches route](/guide/basics/routing) based on `request.url` and `request.method`, calls global [middleware](/guide/basics/middleware) and finally matched route handler function with event.
+
+```mermaid
+%%{init: {'theme':'neutral'}}%%
+sequenceDiagram
+    participant MiddlewareA as Middleware1(event, next)
+    participant MiddlewareB as Middleware2(event, next)
+    participant Route as RouteHandler(event)
+
+    MiddlewareA->>+MiddlewareB: await next()
+    MiddlewareB->>+Route: await next()
+    Route-->>-MiddlewareB: rawBody
+    MiddlewareB-->>-MiddlewareA: rawBody
+
+```
+
+> [!TIP]
+> 🚀 Internally, H3 uses srvx `FastURL` instead of `new URL(req.url).pathname`.
+
+## 4. Send Response
+
+H3 [converts](/guide/basics/response#response-types) returned value and [prepared headers](/guide/basics/response#preparing-response) into a [Response](https://developer.mozilla.org/en-US/docs/Web/API/Response), calls [`onResponse`](/guide/api/h3#global-hooks) global hook and finally returns response back to the server fetch handler.
+
+```mermaid
+%%{init: {'theme':'neutral'}}%%
+flowchart LR
+ D1["Returned Value => Response"] --> D2["<code>onResponse(response)</code>"] --> D3["Response"]
+
+click D1 "/guide/basics/response"
+click D2 "/guide/api/h3#global-hooks"
+```

package/dist/docs/0.guide/1.basics/1.routing.md

@@ -0,0 +1,92 @@
+# Routing
+
+> Each request is matched to one (most specific) route handler.
+
+## Adding Routes
+
+You can register route [handlers](/guide/basics/handler) to [H3 instance](/guide/api/h3) using [`H3.on`](/guide/api/h3#h3on), [`H3.[method]`](/guide/api/h3#h3method), or [`H3.all`](/guide/api/h3#h3all).
+
+> [!TIP]
+> Router is powered by [🌳 Rou3](https://github.com/h3js/rou3), an ultra-fast and tiny route matcher engine.
+
+**Example:** Register a route to match requests to the `/hello` endpoint with HTTP **GET** method.
+
+- Using [`H3.[method]`](/guide/api/h3#h3method)
+
+  ```js
+  app.get("/hello", () => "Hello world!");
+  ```
+
+- Using [`H3.on`](/guide/api/h3#h3on)
+
+  ```js
+  app.on("GET", "/hello", () => "Hello world!");
+  ```
+
+
+You can register multiple event handlers for the same route with different methods:
+
+```js
+app
+  .get("/hello", () => "GET Hello world!")
+  .post("/hello", () => "POST Hello world!")
+  .all("/hello", () => "Any other method!");
+```
+
+You can also use [`H3.all`](/guide/api/h3#h3all) method to register a route accepting any HTTP method:
+
+```js
+app.all("/hello", (event) => `This is a ${event.req.method} request!`);
+```
+
+## Dynamic Routes
+
+You can define dynamic route parameters using `:` prefix:
+
+```js
+// [GET] /hello/Bob => "Hello, Bob!"
+app.get("/hello/:name", (event) => {
+  return `Hello, ${event.context.params.name}!`;
+});
+```
+
+Instead of named parameters, you can use `*` for unnamed **optional** parameters:
+
+```js
+app.get("/hello/*", (event) => `Hello!`);
+```
+
+## Wildcard Routes
+
+Adding `/hello/:name` route will match `/hello/world` or `/hello/123`. But it will not match `/hello/foo/bar`.
+When you need to match multiple levels of sub routes, you can use `**` prefix:
+
+```js
+app.get("/hello/**", (event) => `Hello ${event.context.params._}!`);
+```
+
+This will match `/hello`, `/hello/world`, `/hello/123`, `/hello/world/123`, etc.
+
+> [!NOTE]
+> Param `_` will store the full wildcard content as a single string.
+
+## Route Meta
+
+You can define optional route meta when registering them, accessible from any middleware.
+
+```js
+import { H3 } from "h3";
+
+const app = new H3();
+
+app.use((event) => {
+  console.log(event.context.matchedRoute?.meta); // { auth: true }
+});
+
+app.get("/", (event) => "Hi!", { meta: { auth: true } });
+```
+
+<read-more>
+
+It is also possible to add route meta when defining them using `defineHandler` object syntax.
+</read-more>

package/dist/docs/0.guide/1.basics/2.middleware.md

@@ -0,0 +1,97 @@
+# Middleware
+
+> Intercept request, response and errors using H3 middleware.
+
+> [!IMPORTANT]
+> We recommend using composable utilities whenever possible. Global middleware can complicate application logic, making it less predictable and harder to understand.
+
+Global middleware run on each request before route handler and act as wrappers to intercept request, response and errors.
+
+<read-more></read-more>
+
+You can register global middleware to [app instance](/guide/api/h3) using the [`H3.use`](/guide/api/h3#h3use).
+
+**Example:** Register a global middleware that logs every request.
+
+```js
+app.use((event) => {
+  console.log(event);
+});
+```
+
+**Example:** Register a global middleware that matches certain requests.
+
+```js
+app.use(
+  "/blog/**",
+  (event, next) => {
+    console.log("[alert] POST request on /blog paths!");
+  },
+  {
+    method: "POST",
+    // match: (event) => event.req.method === "POST",
+  },
+);
+```
+
+You can register middleware with `next` argument to intercept return values of next middleware and handler.
+
+```js
+app.use(async (event, next) => {
+  const rawBody = await next();
+  // [intercept response]
+  return rawBody;
+});
+```
+
+Example below, always responds with `Middleware 1`.
+
+```js
+app
+  .use(() => "Middleware 1")
+  .use(() => "Middleware 2")
+  .get("/", "Hello");
+```
+
+> [!IMPORTANT]
+> If middleware returns a value other than `undefined` or the result of `next()`, it immediately intercepts request handling and sends a response.
+
+When adding routes, you can register middleware that only run with them.
+
+```js
+import { basicAuth } from "h3";
+
+app.get(
+  "/secret",
+  (event) => {
+    /* ... */
+  },
+  {
+    middleware: [basicAuth({ password: "test" })],
+  },
+);
+```
+
+For convenience, H3 provides middleware factory functions `onRequest`, `onResponse`, and `onError`:
+
+```js
+import { onRequest, onResponse, onError } from "h3";
+
+app.use(
+  onRequest((event) => {
+    console.log(`[${event.req.method}] ${event.url.pathname}`);
+  }),
+);
+
+app.use(
+  onResponse((response, event) => {
+    console.log(`[${event.req.method}] ${event.url.pathname} ~>`, response.status);
+  }),
+);
+
+app.use(
+  onError((error, event) => {
+    console.log(`[${event.req.method}] ${event.url.pathname} !! ${error.message}`);
+  }),
+);
+```