h3 1.13.0 → 1.14.0

package/README.md

@@ -3,7 +3,7 @@
 <!-- automd:badges -->
 
 [![npm version](https://img.shields.io/npm/v/h3)](https://npmjs.com/package/h3)
-[![npm downloads](https://img.shields.io/npm/dm/h3)](https://npmjs.com/package/h3)
+[![npm downloads](https://img.shields.io/npm/dm/h3)](https://npm.chart.dev/h3)
 
 <!-- /automd -->
 

package/dist/index.cjs

@@ -41,21 +41,16 @@ function hasProp(obj, prop) {
   }
 }
 
-var __defProp$2 = Object.defineProperty;
-var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$2 = (obj, key, value) => {
-  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
 class H3Error extends Error {
+  static __h3_error__ = true;
+  statusCode = 500;
+  fatal = false;
+  unhandled = false;
+  statusMessage;
+  data;
+  cause;
   constructor(message, opts = {}) {
     super(message, opts);
-    __publicField$2(this, "statusCode", 500);
-    __publicField$2(this, "fatal", false);
-    __publicField$2(this, "unhandled", false);
-    __publicField$2(this, "statusMessage");
-    __publicField$2(this, "data");
-    __publicField$2(this, "cause");
     if (opts.cause && !this.cause) {
       this.cause = opts.cause;
     }
@@ -68,13 +63,12 @@ class H3Error extends Error {
     if (this.statusMessage) {
       obj.statusMessage = sanitizeStatusMessage(this.statusMessage);
     }
-    if (this.data !== void 0) {
+    if (this.data !== undefined) {
       obj.data = this.data;
     }
     return obj;
   }
 }
-__publicField$2(H3Error, "__h3_error__", true);
 function createError(input) {
   if (typeof input === "string") {
     return new H3Error(input);
@@ -121,10 +115,10 @@ function createError(input) {
       );
     }
   }
-  if (input.fatal !== void 0) {
+  if (input.fatal !== undefined) {
     err.fatal = input.fatal;
   }
-  if (input.unhandled !== void 0) {
+  if (input.unhandled !== undefined) {
     err.unhandled = input.unhandled;
   }
   return err;
@@ -149,7 +143,7 @@ function sendError(event, error, debug) {
   const _code = Number.parseInt(h3Error.statusCode);
   setResponseStatus(event, _code, h3Error.statusMessage);
   event.node.res.setHeader("content-type", MIMES.json);
-  event.node.res.end(JSON.stringify(responseBody, void 0, 2));
+  event.node.res.end(JSON.stringify(responseBody, undefined, 2));
 }
 function isError(input) {
   return input?.constructor?.__h3_error__ === true;
@@ -422,7 +416,7 @@ function readRawBody(event, encoding = "utf8") {
     return encoding ? promise2.then((buff) => buff.toString(encoding)) : promise2;
   }
   if (!Number.parseInt(event.node.req.headers["content-length"] || "") && !String(event.node.req.headers["transfer-encoding"] ?? "").split(",").map((e) => e.trim()).filter(Boolean).includes("chunked")) {
-    return Promise.resolve(void 0);
+    return Promise.resolve(undefined);
   }
   const promise = event.node.req[RawBodySymbol] = new Promise(
     (resolve, reject) => {
@@ -517,7 +511,7 @@ function getRequestWebStream(event) {
 }
 function _parseJSON(body = "", strict) {
   if (!body) {
-    return void 0;
+    return undefined;
   }
   try {
     return destr__default(body, { strict });
@@ -548,7 +542,7 @@ function _parseURLEncodedBody(body) {
 function handleCacheHeaders(event, opts) {
   const cacheControls = ["public", ...opts.cacheControls || []];
   let cacheMatched = false;
-  if (opts.maxAge !== void 0) {
+  if (opts.maxAge !== undefined) {
     cacheControls.push(`max-age=${+opts.maxAge}`, `s-maxage=${+opts.maxAge}`);
   }
   if (opts.modifiedTime) {
@@ -693,7 +687,7 @@ function serializeIterableValue(value) {
     }
     case "function":
     case "undefined": {
-      return void 0;
+      return undefined;
     }
     case "object": {
       if (value instanceof Uint8Array) {
@@ -966,9 +960,9 @@ function sendIterable(event, iterable, options) {
     new ReadableStream({
       async pull(controller) {
         const { value, done } = await iterator.next();
-        if (value !== void 0) {
+        if (value !== undefined) {
           const chunk = serializer(value);
-          if (chunk !== void 0) {
+          if (chunk !== undefined) {
             controller.enqueue(chunk);
           }
         }
@@ -1130,6 +1124,7 @@ async function getRequestFingerprint(event, opts = {}) {
 const PayloadMethods = /* @__PURE__ */ new Set(["PATCH", "POST", "PUT", "DELETE"]);
 const ignoredHeaders = /* @__PURE__ */ new Set([
   "transfer-encoding",
+  "accept-encoding",
   "connection",
   "keep-alive",
   "upgrade",
@@ -1145,12 +1140,12 @@ async function proxyRequest(event, target, opts = {}) {
       body = getRequestWebStream(event);
       duplex = "half";
     } else {
-      body = await readRawBody(event, false).catch(() => void 0);
+      body = await readRawBody(event, false).catch(() => undefined);
     }
   }
   const method = opts.fetchOptions?.method || event.method;
   const fetchHeaders = mergeHeaders(
-    getProxyRequestHeaders(event),
+    getProxyRequestHeaders(event, { host: target.startsWith("/") }),
     opts.fetchOptions?.headers,
     opts.headers
   );
@@ -1225,7 +1220,7 @@ async function sendProxy(event, target, opts = {}) {
   if (opts.onResponse) {
     await opts.onResponse(event, response);
   }
-  if (response._data !== void 0) {
+  if (response._data !== undefined) {
     return response._data;
   }
   if (event.handled) {
@@ -1242,11 +1237,11 @@ async function sendProxy(event, target, opts = {}) {
   }
   return event.node.res.end();
 }
-function getProxyRequestHeaders(event) {
+function getProxyRequestHeaders(event, opts) {
   const headers = /* @__PURE__ */ Object.create(null);
   const reqHeaders = getRequestHeaders(event);
   for (const name in reqHeaders) {
-    if (!ignoredHeaders.has(name)) {
+    if (!ignoredHeaders.has(name) || name === "host" && opts?.host) {
       headers[name] = reqHeaders[name];
     }
   }
@@ -1257,7 +1252,9 @@ function fetchWithEvent(event, req, init, options) {
     ...init,
     context: init?.context || event.context,
     headers: {
-      ...getProxyRequestHeaders(event),
+      ...getProxyRequestHeaders(event, {
+        host: typeof req === "string" && req.startsWith("/")
+      }),
       ...init?.headers
     }
   });
@@ -1298,7 +1295,7 @@ function mergeHeaders(defaults, ...inputs) {
   const merged = new Headers(defaults);
   for (const input of _inputs) {
     for (const [key, value] of Object.entries(input)) {
-      if (value !== void 0) {
+      if (value !== undefined) {
         merged.set(key, value);
       }
     }
@@ -1324,10 +1321,16 @@ async function useSession(event, config) {
       return event.context.sessions?.[sessionName]?.data || {};
     },
     update: async (update) => {
+      if (!isEvent(event)) {
+        throw new Error("[h3] Cannot update read-only session.");
+      }
       await updateSession(event, config, update);
       return sessionManager;
     },
     clear: () => {
+      if (!isEvent(event)) {
+        throw new Error("[h3] Cannot clear read-only session.");
+      }
       clearSession(event, config);
       return Promise.resolve(sessionManager);
     }
@@ -1352,13 +1355,16 @@ async function getSession(event, config) {
   let sealedSession;
   if (config.sessionHeader !== false) {
     const headerName = typeof config.sessionHeader === "string" ? config.sessionHeader.toLowerCase() : `x-${sessionName.toLowerCase()}-session`;
-    const headerValue = event.node.req.headers[headerName];
+    const headerValue = _getReqHeader(event, headerName);
     if (typeof headerValue === "string") {
       sealedSession = headerValue;
     }
   }
   if (!sealedSession) {
-    sealedSession = getCookie(event, sessionName);
+    const cookieHeader = _getReqHeader(event, "cookie");
+    if (cookieHeader) {
+      sealedSession = cookieEs.parse(cookieHeader + "")[sessionName];
+    }
   }
   if (sealedSession) {
     const promise = unsealSession(event, config, sealedSession).catch(() => {
@@ -1371,12 +1377,28 @@ async function getSession(event, config) {
     await promise;
   }
   if (!session.id) {
+    if (!isEvent(event)) {
+      throw new Error(
+        "Cannot initialize a new session. Make sure using `useSession(event)` in main handler."
+      );
+    }
     session.id = config.generateId?.() ?? (config.crypto || crypto__default).randomUUID();
     session.createdAt = Date.now();
     await updateSession(event, config);
   }
   return session;
 }
+function _getReqHeader(event, name) {
+  if (event.node) {
+    return event.node?.req.headers[name];
+  }
+  if (event.request) {
+    return event.request.headers?.get(name);
+  }
+  if (event.headers) {
+    return event.headers.get(name);
+  }
+}
 async function updateSession(event, config, update) {
   const sessionName = config.name || DEFAULT_NAME;
   const session = event.context.sessions?.[sessionName] || await getSession(event, config);
@@ -1390,7 +1412,7 @@ async function updateSession(event, config, update) {
     const sealed = await sealSession(event, config);
     setCookie(event, sessionName, sealed, {
       ...DEFAULT_COOKIE,
-      expires: config.maxAge ? new Date(session.createdAt + config.maxAge * 1e3) : void 0,
+      expires: config.maxAge ? new Date(session.createdAt + config.maxAge * 1e3) : undefined,
       ...config.cookie
     });
   }
@@ -1476,26 +1498,20 @@ function setEventStreamHeaders(event) {
   setResponseHeaders(event, headers);
 }
 function isHttp2Request(event) {
-  return getHeader(event, ":path") !== void 0 && getHeader(event, ":method") !== void 0;
+  return getHeader(event, ":path") !== undefined && getHeader(event, ":method") !== undefined;
 }
 
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => {
-  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
 class EventStream {
+  _h3Event;
+  _transformStream = new TransformStream();
+  _writer;
+  _encoder = new TextEncoder();
+  _writerIsClosed = false;
+  _paused = false;
+  _unsentData;
+  _disposed = false;
+  _handled = false;
   constructor(event, opts = {}) {
-    __publicField$1(this, "_h3Event");
-    __publicField$1(this, "_transformStream", new TransformStream());
-    __publicField$1(this, "_writer");
-    __publicField$1(this, "_encoder", new TextEncoder());
-    __publicField$1(this, "_writerIsClosed", false);
-    __publicField$1(this, "_paused", false);
-    __publicField$1(this, "_unsentData");
-    __publicField$1(this, "_disposed", false);
-    __publicField$1(this, "_handled", false);
     this._h3Event = event;
     this._writer = this._transformStream.writable.getWriter();
     this._writer.closed.then(() => {
@@ -1572,7 +1588,7 @@ class EventStream {
     }
     if (this._unsentData?.length) {
       await this._writer.write(this._encoder.encode(this._unsentData));
-      this._unsentData = void 0;
+      this._unsentData = undefined;
     }
   }
   /**
@@ -1682,7 +1698,7 @@ async function serveStatic(event, options) {
   if (meta.encoding && !getResponseHeader(event, "content-encoding")) {
     setResponseHeader(event, "content-encoding", meta.encoding);
   }
-  if (meta.size !== void 0 && meta.size > 0 && !getResponseHeader(event, "content-length")) {
+  if (meta.size !== undefined && meta.size > 0 && !getResponseHeader(event, "content-length")) {
     setResponseHeader(event, "content-length", meta.size);
   }
   if (event.method === "HEAD") {
@@ -1722,32 +1738,26 @@ function defineWebSocketHandler(hooks) {
   });
 }
 
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
 class H3Event {
+  "__is_event__" = true;
+  // Context
+  node;
+  // Node
+  web;
+  // Web
+  context = {};
+  // Shared
+  // Request
+  _method;
+  _path;
+  _headers;
+  _requestBody;
+  // Response
+  _handled = false;
+  // Hooks
+  _onBeforeResponseCalled;
+  _onAfterResponseCalled;
   constructor(req, res) {
-    __publicField(this, "__is_event__", true);
-    // Context
-    __publicField(this, "node");
-    // Node
-    __publicField(this, "web");
-    // Web
-    __publicField(this, "context", {});
-    // Shared
-    // Request
-    __publicField(this, "_method");
-    __publicField(this, "_path");
-    __publicField(this, "_headers");
-    __publicField(this, "_requestBody");
-    // Response
-    __publicField(this, "_handled", false);
-    // Hooks
-    __publicField(this, "_onBeforeResponseCalled");
-    __publicField(this, "_onAfterResponseCalled");
     this.node = { req, res };
   }
   // --- Request ---
@@ -1830,7 +1840,7 @@ function defineEventHandler(handler) {
   return _handler;
 }
 function _normalizeArray(input) {
-  return input ? Array.isArray(input) ? input : [input] : void 0;
+  return input ? Array.isArray(input) ? input : [input] : undefined;
 }
 async function _callHandler(event, handler, hooks) {
   if (hooks.onRequest) {
@@ -1960,7 +1970,7 @@ function use(app, arg1, arg2, arg3) {
   return app;
 }
 function createAppEventHandler(stack, options) {
-  const spacing = options.debug ? 2 : void 0;
+  const spacing = options.debug ? 2 : undefined;
   return eventHandler(async (event) => {
     event.node.req.originalUrl = event.node.req.originalUrl || event.node.req.url || "/";
     const _reqPath = event._path || event.node.req.url || "/";
@@ -1983,8 +1993,8 @@ function createAppEventHandler(stack, options) {
       event._path = _layerPath;
       event.node.req.url = _layerPath;
       const val = await layer.handler(event);
-      const _body = val === void 0 ? void 0 : await val;
-      if (_body !== void 0) {
+      const _body = val === undefined ? undefined : await val;
+      if (_body !== undefined) {
         const _response = { body: _body };
         if (options.onBeforeResponse) {
           event._onBeforeResponseCalled = true;
@@ -2000,7 +2010,7 @@ function createAppEventHandler(stack, options) {
       if (event.handled) {
         if (options.onAfterResponse) {
           event._onAfterResponseCalled = true;
-          await options.onAfterResponse(event, void 0);
+          await options.onAfterResponse(event, undefined);
         }
         return;
       }
@@ -2013,7 +2023,7 @@ function createAppEventHandler(stack, options) {
     }
     if (options.onAfterResponse) {
       event._onAfterResponseCalled = true;
-      await options.onAfterResponse(event, void 0);
+      await options.onAfterResponse(event, undefined);
     }
   });
 }
@@ -2028,7 +2038,7 @@ function createResolver(stack) {
         continue;
       }
       _layerPath = path.slice(layer.route.length) || "/";
-      if (layer.match && !layer.match(_layerPath, void 0)) {
+      if (layer.match && !layer.match(_layerPath, undefined)) {
         continue;
       }
       let res = { route: layer.route, handler: layer.handler };
@@ -2055,7 +2065,7 @@ function normalizeLayer(input) {
   if (input.lazy) {
     handler = lazyEventHandler(handler);
   } else if (!isEventHandler(handler)) {
-    handler = toEventHandler(handler, void 0, input.route);
+    handler = toEventHandler(handler, undefined, input.route);
   }
   return {
     route: ufo.withoutTrailingSlash(input.route),
@@ -2094,7 +2104,7 @@ function handleHandlerResponse(event, val, jsonSpace) {
     return send(event, val, MIMES.html);
   }
   if (valType === "object" || valType === "boolean" || valType === "number") {
-    return send(event, JSON.stringify(val, void 0, jsonSpace), MIMES.json);
+    return send(event, JSON.stringify(val, undefined, jsonSpace), MIMES.json);
   }
   if (valType === "bigint") {
     return send(event, val.toString(), MIMES.json);
@@ -2152,7 +2162,7 @@ function createRouter(opts = {}) {
         addRoute(path, handler, m);
       }
     } else {
-      route.handlers[method] = toEventHandler(handler, void 0, path);
+      route.handlers[method] = toEventHandler(handler, undefined, path);
     }
     return router;
   };
@@ -2222,7 +2232,7 @@ function createRouter(opts = {}) {
     const params = match.matched.params || {};
     event.context.params = params;
     return Promise.resolve(match.handler(event)).then((res) => {
-      if (res === void 0 && isPreemptive) {
+      if (res === undefined && isPreemptive) {
         return null;
       }
       return res;
@@ -2314,7 +2324,7 @@ function callNodeListener(handler, req, res) {
         res.off("close", next);
         res.off("error", next);
       }
-      return err ? reject(createError(err)) : resolve(void 0);
+      return err ? reject(createError(err)) : resolve(undefined);
     };
     try {
       const returned = handler(req, res, next);
@@ -2414,7 +2424,7 @@ function _normalizeUnenvHeaders(input) {
       for (const _value of value) {
         headers.push([key, _value]);
       }
-    } else if (value !== void 0) {
+    } else if (value !== undefined) {
       headers.push([key, String(value)]);
     }
   }

package/dist/index.d.cts

@@ -133,20 +133,28 @@ interface SessionConfig {
     /** Default is Crypto.randomUUID */
     generateId?: () => string;
 }
+type CompatEvent = {
+    request: {
+        headers: Headers;
+    };
+    context: any;
+} | {
+    headers: Headers;
+    context: any;
+};
 /**
  * Create a session manager for the current request.
- *
  */
-declare function useSession<T extends SessionDataT = SessionDataT>(event: H3Event, config: SessionConfig): Promise<{
-    readonly id: string | undefined;
+declare function useSession<T extends SessionDataT = SessionDataT>(event: H3Event | CompatEvent, config: SessionConfig): Promise<{
+    readonly id: any;
     readonly data: T;
-    update: (update: SessionUpdate<T>) => Promise<any>;
-    clear: () => Promise<any>;
+    update: (update: SessionUpdate<T>) => Promise</*elided*/ any>;
+    clear: () => Promise</*elided*/ any>;
 }>;
 /**
  * Get the session for the current request.
  */
-declare function getSession<T extends SessionDataT = SessionDataT>(event: H3Event, config: SessionConfig): Promise<Session<T>>;
+declare function getSession<T extends SessionDataT = SessionDataT>(event: H3Event | CompatEvent, config: SessionConfig): Promise<Session<T>>;
 type SessionUpdate<T extends SessionDataT = SessionDataT> = Partial<SessionData<T>> | ((oldData: SessionData<T>) => Partial<SessionData<T>> | undefined);
 /**
  * Update the session data for the current request.
@@ -155,11 +163,11 @@ declare function updateSession<T extends SessionDataT = SessionDataT>(event: H3E
 /**
  * Encrypt and sign the session data for the current request.
  */
-declare function sealSession<T extends SessionDataT = SessionDataT>(event: H3Event, config: SessionConfig): Promise<string>;
+declare function sealSession<T extends SessionDataT = SessionDataT>(event: H3Event | CompatEvent, config: SessionConfig): Promise<string>;
 /**
  * Decrypt and verify the session data for the current request.
  */
-declare function unsealSession(_event: H3Event, config: SessionConfig, sealed: string): Promise<Partial<Session<SessionDataT>>>;
+declare function unsealSession(_event: H3Event | CompatEvent, config: SessionConfig, sealed: string): Promise<Partial<Session<SessionDataT>>>;
 /**
  * Clear the session data for the current request.
  */
@@ -311,7 +319,6 @@ type LazyEventHandler = () => EventHandler | Promise<EventHandler>;
  * @property {boolean} unhandled - Indicates if the error was unhandled and auto captured.
  * @property {DataT} data - An extra data that will be included in the response.
  *                         This can be used to pass additional information about the error.
- * @property {boolean} internal - Setting this property to `true` will mark the error as an internal error.
  */
 declare class H3Error<DataT = unknown> extends Error {
     static __h3_error__: boolean;
@@ -513,7 +520,7 @@ declare function readBody<T, Event extends H3Event = H3Event, _T = InferEventInp
  */
 declare function readValidatedBody<T, Event extends H3Event = H3Event, _T = InferEventInput<"body", Event, T>>(event: Event, validate: ValidateFunction<_T>): Promise<_T>;
 /**
- * Tries to read and parse the body of a an H3Event as multipart form.
+ * Tries to read and parse the body of an H3Event as multipart form.
  *
  * @example
  * export default defineEventHandler(async (event) => {
@@ -615,7 +622,7 @@ interface H3CorsOptions {
 declare function handleCors(event: H3Event, options: H3CorsOptions): boolean;
 
 /**
- * Get query the params object from the request URL parsed with [unjs/ufo](https://ufo.unjs.io).
+ * Get the query params object from the request URL parsed with [unjs/ufo](https://ufo.unjs.io).
  *
  * @example
  * export default defineEventHandler((event) => {
@@ -624,7 +631,7 @@ declare function handleCors(event: H3Event, options: H3CorsOptions): boolean;
  */
 declare function getQuery<T, Event extends H3Event = H3Event, _T = Exclude<InferEventInput<"query", Event, T>, undefined>>(event: Event): _T;
 /**
- * Get the query param from the request URL parsed with [unjs/ufo](https://ufo.unjs.io) and validated with validate function.
+ * Get the query params object from the request URL parsed with [unjs/ufo](https://ufo.unjs.io) and validated with validate function.
  *
  * You can use a simple function to validate the query object or a library like `zod` to define a schema.
  *
@@ -796,7 +803,7 @@ declare function getRequestProtocol(event: H3Event, opts?: {
 /** @deprecated Use `event.path` instead */
 declare function getRequestPath(event: H3Event): string;
 /**
- * Generated the full incoming request URL using `getRequestProtocol`, `getRequestHost` and `event.path`.
+ * Generate the full incoming request URL using `getRequestProtocol`, `getRequestHost` and `event.path`.
  *
  * If `xForwardedHost` is `true`, it will use the `x-forwarded-host` header if it exists.
  *
@@ -820,7 +827,9 @@ declare function toWebRequest(event: H3Event): Request;
 /**
  * Try to get the client IP address from the incoming request.
  *
- * If `xForwardedFor` is `true`, it will use the `x-forwarded-for` header if it exists.
+ * If `xForwardedFor` is `true`, it will use the `x-forwarded-for` header set by proxies if it exists.
+ *
+ * Note: Make sure that this header can be trusted (your application running behind a CDN or reverse proxy) before enabling.
  *
  * If IP cannot be determined, it will default to `undefined`.
  *
@@ -830,11 +839,6 @@ declare function toWebRequest(event: H3Event): Request;
  * });
  */
 declare function getRequestIP(event: H3Event, opts?: {
-    /**
-     * Use the X-Forwarded-For HTTP header set by proxies.
-     *
-     * Note: Make sure that this header can be trusted (your application running behind a CDN or reverse proxy) before enabling.
-     */
     xForwardedFor?: boolean;
 }): string | undefined;
 
@@ -856,7 +860,7 @@ declare function appendCorsPreflightHeaders(event: H3Event, options: H3CorsOptio
 declare function appendCorsHeaders(event: H3Event, options: H3CorsOptions): void;
 
 /**
- * Parse the request to get HTTP Cookie header string and returning an object of all cookie name-value pairs.
+ * Parse the request to get HTTP Cookie header string and return an object of all cookie name-value pairs.
  * @param event {H3Event} H3 event or req passed by h3 handler
  * @returns Object of cookie name-value pairs
  * ```ts
@@ -957,7 +961,9 @@ declare function sendProxy(event: H3Event, target: string, opts?: ProxyOptions):
 /**
  * Get the request headers object without headers known to cause issues when proxying.
  */
-declare function getProxyRequestHeaders(event: H3Event): any;
+declare function getProxyRequestHeaders(event: H3Event, opts?: {
+    host?: boolean;
+}): any;
 /**
  * Make a fetch request with the event's context and headers.
  */
@@ -979,7 +985,7 @@ type IteratorSerializer<Value> = (value: Value) => SendableValue | undefined;
  */
 declare function send(event: H3Event, data?: any, type?: MimeType): Promise<void>;
 /**
- * Respond with an empty payload.<br>
+ * Respond with an empty payload.
  *
  * Note that calling this function will close the connection and no other data can be sent to the client afterwards.
  *
@@ -1059,7 +1065,7 @@ declare function sendRedirect(event: H3Event, location: string, code?: StatusCod
  */
 declare function getResponseHeaders(event: H3Event): ReturnType<H3Event["node"]["res"]["getHeaders"]>;
 /**
- * Alias for `getResponseHeaders`.
+ * Get a response header by name.
  *
  * @example
  * export default defineEventHandler((event) => {
@@ -1147,7 +1153,7 @@ declare function clearResponseHeaders(event: H3Event, headerNames?: HTTPHeaderNa
  */
 declare function removeResponseHeader(event: H3Event, name: HTTPHeaderName): void;
 /**
- * Checks if the data is a stream. (Node.js Readable Stream, React Pipeable Stream, or Web Stream)
+ * Checks if the data is a stream (Node.js Readable Stream, React Pipeable Stream, or Web Stream).
  */
 declare function isStream(data: any): data is Readable | ReadableStream;
 /**