h3 1.6.6 → 1.7.1

package/README.md

@@ -68,7 +68,7 @@ listen(toNodeListener(app));
 
 ## Router
 
-The `app` instance created by `h3` uses a middleware stack (see [how it works](#how-it-works)) with the ability to match route prefix and apply matched middleware.
+The `app` instance created by `h3` uses a middleware stack (see [how it works](./src/app.ts)) with the ability to match route prefix and apply matched middleware.
 
 To opt-in using a more advanced and convenient routing system, we can create a router instance and register it to app instance.
 
@@ -98,36 +98,60 @@ Routes are internally stored in a [Radix Tree](https://en.wikipedia.org/wiki/Rad
 
 ```js
 // Handle can directly return object or Promise<object> for JSON response
-app.use('/api', eventHandler((event) => ({ url: event.node.req.url })))
+app.use(
+  "/api",
+  eventHandler((event) => ({ url: event.node.req.url }))
+);
 
 // We can have better matching other than quick prefix match
-app.use('/odd', eventHandler(() => 'Is odd!'), { match: url => url.substr(1) % 2 })
+app.use(
+  "/odd",
+  eventHandler(() => "Is odd!"),
+  { match: (url) => url.substr(1) % 2 }
+);
 
 // Handle can directly return string for HTML response
-app.use(eventHandler(() => '<h1>Hello world!</h1>'))
+app.use(eventHandler(() => "<h1>Hello world!</h1>"));
 
 // We can chain calls to .use()
-app.use('/1', eventHandler(() => '<h1>Hello world!</h1>'))
-   .use('/2', eventHandler(() => '<h1>Goodbye!</h1>'))
+app
+  .use(
+    "/1",
+    eventHandler(() => "<h1>Hello world!</h1>")
+  )
+  .use(
+    "/2",
+    eventHandler(() => "<h1>Goodbye!</h1>")
+  );
 
 // We can proxy requests and rewrite cookie's domain and path
-app.use('/api', eventHandler((event) => proxyRequest('https://example.com', {
-  // f.e. keep one domain unchanged, rewrite one domain and remove other domains
-  cookieDomainRewrite: {
-    "example.com": "example.com",
-    "example.com": "somecompany.co.uk",
-    "*": "",
-  },
-  cookiePathRewrite: {
-    "/": "/api"
-  },
-})))
+app.use(
+  "/api",
+  eventHandler((event) =>
+    proxyRequest(event, "https://example.com", {
+      // f.e. keep one domain unchanged, rewrite one domain and remove other domains
+      cookieDomainRewrite: {
+        "example.com": "example.com",
+        "example.com": "somecompany.co.uk",
+        "*": "",
+      },
+      cookiePathRewrite: {
+        "/": "/api",
+      },
+    })
+  )
+);
 
 // Legacy middleware with 3rd argument are automatically promisified
-app.use(fromNodeMiddleware((req, res, next) => { req.setHeader('x-foo', 'bar'); next() }))
+app.use(
+  fromNodeMiddleware((req, res, next) => {
+    req.setHeader("x-foo", "bar");
+    next();
+  })
+);
 
 // Lazy loaded routes using { lazy: true }
-app.use('/big', () => import('./big-handler'), { lazy: true })
+app.use("/big", () => import("./big-handler"), { lazy: true });
 ```
 
 ## Utilities

package/dist/index.cjs

@@ -108,7 +108,6 @@ class H3Error extends Error {
     this.statusCode = 500;
     this.fatal = false;
     this.unhandled = false;
-    this.statusMessage = void 0;
   }
   toJSON() {
     const obj = {
@@ -133,8 +132,8 @@ function createError(input) {
     return input;
   }
   const err = new H3Error(
-    input.message ?? input.statusMessage,
-    // @ts-ignore
+    input.message ?? input.statusMessage ?? "",
+    // @ts-ignore https://v8.dev/features/error-cause
     input.cause ? { cause: input.cause } : void 0
   );
   if ("stack" in input) {
@@ -169,7 +168,7 @@ function createError(input) {
     const sanitizedMessage = sanitizeStatusMessage(err.statusMessage);
     if (sanitizedMessage !== originalMessage) {
       console.warn(
-        "[h3] Please prefer using `message` for longer error messages instead of `statusMessage`. In the future `statusMessage` will be sanitized by default."
+        "[h3] Please prefer using `message` for longer error messages instead of `statusMessage`. In the future, `statusMessage` will be sanitized by default."
       );
     }
   }
@@ -182,7 +181,7 @@ function createError(input) {
   return err;
 }
 function sendError(event, error, debug) {
-  if (event.node.res.writableEnded) {
+  if (event.handled) {
     return;
   }
   const h3Error = isError(error) ? error : createError(error);
@@ -195,7 +194,7 @@ function sendError(event, error, debug) {
   if (debug) {
     responseBody.stack = (h3Error.stack || "").split("\n").map((l) => l.trim());
   }
-  if (event.node.res.writableEnded) {
+  if (event.handled) {
     return;
   }
   const _code = Number.parseInt(h3Error.statusCode);
@@ -291,9 +290,15 @@ function readRawBody(event, encoding = "utf8") {
   assertMethod(event, PayloadMethods$1);
   const _rawBody = event.node.req[RawBodySymbol] || event.node.req.body;
   if (_rawBody) {
-    const promise2 = Promise.resolve(_rawBody).then(
-      (_resolved) => Buffer.isBuffer(_resolved) ? _resolved : Buffer.from(_resolved)
-    );
+    const promise2 = Promise.resolve(_rawBody).then((_resolved) => {
+      if (Buffer.isBuffer(_resolved)) {
+        return _resolved;
+      }
+      if (_resolved.constructor === Object) {
+        return Buffer.from(JSON.stringify(_resolved));
+      }
+      return Buffer.from(_resolved);
+    });
     return encoding ? promise2.then((buff) => buff.toString(encoding)) : promise2;
   }
   if (!Number.parseInt(event.node.req.headers["content-length"] || "")) {
@@ -378,7 +383,9 @@ function handleCacheHeaders(event, opts) {
   event.node.res.setHeader("cache-control", cacheControls.join(", "));
   if (cacheMatched) {
     event.node.res.statusCode = 304;
-    event.node.res.end();
+    if (!event.handled) {
+      event.node.res.end();
+    }
     return true;
   }
   return false;
@@ -527,6 +534,7 @@ async function sendProxy(event, target, opts = {}) {
     event.node.res.statusCode
   );
   event.node.res.statusMessage = sanitizeStatusMessage(response.statusText);
+  const cookies = [];
   for (const [key, value] of response.headers.entries()) {
     if (key === "content-encoding") {
       continue;
@@ -535,7 +543,15 @@ async function sendProxy(event, target, opts = {}) {
       continue;
     }
     if (key === "set-cookie") {
-      const cookies = splitCookiesString(value).map((cookie) => {
+      cookies.push(...splitCookiesString(value));
+      continue;
+    }
+    event.node.res.setHeader(key, value);
+  }
+  if (cookies.length > 0) {
+    event.node.res.setHeader(
+      "set-cookie",
+      cookies.map((cookie) => {
         if (opts.cookieDomainRewrite) {
           cookie = rewriteCookieProperty(
             cookie,
@@ -551,15 +567,18 @@ async function sendProxy(event, target, opts = {}) {
           );
         }
         return cookie;
-      });
-      event.node.res.setHeader("set-cookie", cookies);
-      continue;
-    }
-    event.node.res.setHeader(key, value);
+      })
+    );
+  }
+  if (opts.onResponse) {
+    await opts.onResponse(event, response);
   }
   if (response._data !== void 0) {
     return response._data;
   }
+  if (event.handled) {
+    return;
+  }
   if (opts.sendStream === false) {
     const data = new Uint8Array(await response.arrayBuffer());
     return event.node.res.end(data);
@@ -618,14 +637,16 @@ function rewriteCookieProperty(header, map, property) {
   );
 }
 
-const defer = typeof setImmediate !== "undefined" ? setImmediate : (fn) => fn();
+const defer = typeof setImmediate === "undefined" ? (fn) => fn() : setImmediate;
 function send(event, data, type) {
   if (type) {
     defaultContentType(event, type);
   }
   return new Promise((resolve) => {
     defer(() => {
-      event.node.res.end(data);
+      if (!event.handled) {
+        event.node.res.end(data);
+      }
       resolve();
     });
   });
@@ -635,7 +656,9 @@ function sendNoContent(event, code = 204) {
   if (event.node.res.statusCode === 204) {
     event.node.res.removeHeader("content-length");
   }
-  event.node.res.end();
+  if (!event.handled) {
+    event.node.res.end();
+  }
 }
 function setResponseStatus(event, code, text) {
   if (code) {
@@ -818,7 +841,7 @@ async function getSession(event, config) {
     Object.assign(session, unsealed);
   }
   if (!session.id) {
-    session.id = (config.crypto || crypto__default).randomUUID();
+    session.id = config.generateId?.() ?? (config.crypto || crypto__default).randomUUID();
     session.createdAt = Date.now();
     await updateSession(event, config);
   }
@@ -1089,12 +1112,16 @@ class H3Response {
 class H3Event {
   constructor(req, res) {
     this["__is_event__"] = true;
+    this._handled = false;
     this.context = {};
     this.node = { req, res };
   }
   get path() {
     return getRequestPath(this);
   }
+  get handled() {
+    return this._handled || this.node.res.writableEnded || this.node.res.headersSent;
+  }
   /** @deprecated Please use `event.node.req` instead. **/
   get req() {
     return this.node.req;
@@ -1106,35 +1133,37 @@ class H3Event {
   // Implementation of FetchEvent
   respondWith(r) {
     Promise.resolve(r).then((_response) => {
-      if (this.res.writableEnded) {
+      if (this.handled) {
         return;
       }
       const response = _response instanceof H3Response ? _response : new H3Response(_response);
       for (const [key, value] of response.headers.entries()) {
-        this.res.setHeader(key, value);
+        this.node.res.setHeader(key, value);
       }
       if (response.status) {
-        this.res.statusCode = sanitizeStatusCode(
+        this.node.res.statusCode = sanitizeStatusCode(
           response.status,
-          this.res.statusCode
+          this.node.res.statusCode
         );
       }
       if (response.statusText) {
-        this.res.statusMessage = sanitizeStatusMessage(response.statusText);
+        this.node.res.statusMessage = sanitizeStatusMessage(
+          response.statusText
+        );
       }
       if (response.redirected) {
-        this.res.setHeader("location", response.url);
+        this.node.res.setHeader("location", response.url);
       }
       if (!response._body) {
-        return this.res.end();
+        return this.node.res.end();
       }
       if (typeof response._body === "string" || "buffer" in response._body || "byteLength" in response._body) {
-        return this.res.end(response._body);
+        return this.node.res.end(response._body);
       }
       if (!response.headers.has("content-type")) {
         response.headers.set("content-type", MIMES.json);
       }
-      this.res.end(JSON.stringify(response._body));
+      this.node.res.end(JSON.stringify(response._body));
     });
   }
 }
@@ -1260,7 +1289,7 @@ function createAppEventHandler(stack, options) {
         continue;
       }
       const val = await layer.handler(event);
-      if (event.node.res.writableEnded) {
+      if (event.handled) {
         return;
       }
       const type = typeof val;
@@ -1285,10 +1314,10 @@ function createAppEventHandler(stack, options) {
         }
       }
     }
-    if (!event.node.res.writableEnded) {
+    if (!event.handled) {
       throw createError({
         statusCode: 404,
-        statusMessage: `Cannot find any route matching ${event.node.req.url || "/"}.`
+        statusMessage: `Cannot find any path matching ${event.node.req.url || "/"}.`
       });
     }
   });
@@ -1436,15 +1465,25 @@ function createRouter(opts = {}) {
     const method = (event.node.req.method || "get").toLowerCase();
     const handler = matched.handlers[method] || matched.handlers.all;
     if (!handler) {
-      throw createError({
-        statusCode: 405,
-        name: "Method Not Allowed",
-        statusMessage: `Method ${method} is not allowed on this route.`
-      });
+      if (opts.preemptive || opts.preemtive) {
+        throw createError({
+          statusCode: 405,
+          name: "Method Not Allowed",
+          statusMessage: `Method ${method} is not allowed on this route.`
+        });
+      } else {
+        return;
+      }
     }
     const params = matched.params || {};
     event.context.params = params;
-    return handler(event);
+    return Promise.resolve(handler(event)).then((res) => {
+      if (res === void 0 && (opts.preemptive || opts.preemtive)) {
+        setResponseStatus(event, 204);
+        return "";
+      }
+      return res;
+    });
   });
   return router;
 }

package/dist/index.d.ts

@@ -24,6 +24,8 @@ interface SessionConfig {
     sessionHeader?: false | string;
     seal?: SealOptions;
     crypto?: Crypto;
+    /** Default is Crypto.randomUUID */
+    generateId?: () => string;
 }
 declare function useSession<T extends SessionDataT = SessionDataT>(event: H3Event, config: SessionConfig): Promise<{
     readonly id: string | undefined;
@@ -105,10 +107,12 @@ interface NodeEventContext {
 }
 declare class H3Event implements Pick<FetchEvent, "respondWith"> {
     "__is_event__": boolean;
+    _handled: boolean;
     node: NodeEventContext;
     context: H3EventContext;
     constructor(req: IncomingMessage, res: ServerResponse);
     get path(): string;
+    get handled(): boolean;
     /** @deprecated Please use `event.node.req` instead. **/
     get req(): IncomingMessage;
     /** @deprecated Please use `event.node.res` instead. **/
@@ -166,44 +170,50 @@ declare function createAppEventHandler(stack: Stack, options: AppOptions): Event
  * H3 Runtime Error
  * @class
  * @extends Error
- * @property {Number} statusCode An Integer indicating the HTTP response status code.
- * @property {String} statusMessage A String representing the HTTP status message
- * @property {String} fatal Indicates if the error is a fatal error.
- * @property {String} unhandled Indicates if the error was unhandled and auto captured.
- * @property {Any} data An extra data that will includes in the response.<br>
- *  This can be used to pass additional information about the error.
- * @property {Boolean} internal Setting this property to <code>true</code> will mark error as an internal error
+ * @property {number} statusCode - An integer indicating the HTTP response status code.
+ * @property {string} statusMessage - A string representing the HTTP status message.
+ * @property {boolean} fatal - Indicates if the error is a fatal error.
+ * @property {boolean} unhandled - Indicates if the error was unhandled and auto captured.
+ * @property {any} 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 extends Error {
     static __h3_error__: boolean;
-    toJSON(): Pick<H3Error, "data" | "statusCode" | "statusMessage" | "message">;
     statusCode: number;
     fatal: boolean;
     unhandled: boolean;
     statusMessage?: string;
     data?: any;
+    toJSON(): Pick<H3Error, "data" | "statusCode" | "statusMessage" | "message">;
 }
 /**
- * Creates new `Error` that can be used to handle both internal and runtime errors.
+ * Creates a new `Error` that can be used to handle both internal and runtime errors.
  *
- * @param input {Partial<H3Error>}
- * @return {H3Error} An instance of the H3Error
+ * @param input {string | (Partial<H3Error> & { status?: number; statusText?: string })} - The error message or an object containing error properties.
+ * @return {H3Error} - An instance of H3Error.
  */
 declare function createError(input: string | (Partial<H3Error> & {
     status?: number;
     statusText?: string;
 })): H3Error;
 /**
- * Receive an error and return the corresponding response.<br>
- *  H3 internally uses this function to handle unhandled errors.<br>
- *  Note that calling this function will close the connection and no other data will be sent to client afterwards.
+ * Receives an error and returns the corresponding response.
+ * H3 internally uses this function to handle unhandled errors.
+ * Note that calling this function will close the connection and no other data will be sent to the client afterwards.
  *
- @param event {H3Event} H3 event or req passed by h3 handler
- * @param error {H3Error|Error} Raised error
- * @param debug {Boolean} Whether application is in debug mode.<br>
- *  In the debug mode the stack trace of errors will be return in response.
+ * @param event {H3Event} - H3 event or req passed by h3 handler.
+ * @param error {Error | H3Error} - The raised error.
+ * @param debug {boolean} - Whether the application is in debug mode.
+ * In the debug mode, the stack trace of errors will be returned in the response.
  */
 declare function sendError(event: H3Event, error: Error | H3Error, debug?: boolean): void;
+/**
+ * Checks if the given input is an instance of H3Error.
+ *
+ * @param input {*} - The input to check.
+ * @return {boolean} - Returns true if the input is an instance of H3Error, false otherwise.
+ */
 declare function isError(input: any): input is H3Error;
 
 declare function useBase(base: string, handler: EventHandler): EventHandler;
@@ -313,19 +323,20 @@ interface ProxyOptions {
     sendStream?: boolean;
     cookieDomainRewrite?: string | Record<string, string>;
     cookiePathRewrite?: string | Record<string, string>;
+    onResponse?: (event: H3Event, response: Response) => void;
 }
 declare function proxyRequest(event: H3Event, target: string, opts?: ProxyOptions): Promise<any>;
 declare function sendProxy(event: H3Event, target: string, opts?: ProxyOptions): Promise<any>;
 declare function getProxyRequestHeaders(event: H3Event): any;
-declare function fetchWithEvent(event: H3Event, req: RequestInfo | URL, init?: RequestInit & {
+declare function fetchWithEvent<T = unknown, _R = any, F extends (req: RequestInfo | URL, opts?: any) => any = typeof fetch>(event: H3Event, req: RequestInfo | URL, init?: RequestInit & {
     context?: H3EventContext;
 }, options?: {
-    fetch: typeof fetch;
-}): Promise<Response>;
+    fetch: F;
+}): unknown extends T ? ReturnType<F> : T;
 
 declare function getQuery(event: H3Event): ufo.QueryObject;
-declare function getRouterParams(event: H3Event): H3Event["context"];
-declare function getRouterParam(event: H3Event, name: string): H3Event["context"][string];
+declare function getRouterParams(event: H3Event): NonNullable<H3Event["context"]["params"]>;
+declare function getRouterParam(event: H3Event, name: string): string | undefined;
 declare function getMethod(event: H3Event, defaultMethod?: HTTPMethod): HTTPMethod;
 declare function isMethod(event: H3Event, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): boolean;
 declare function assertMethod(event: H3Event, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): void;

package/dist/index.mjs

@@ -101,7 +101,6 @@ class H3Error extends Error {
     this.statusCode = 500;
     this.fatal = false;
     this.unhandled = false;
-    this.statusMessage = void 0;
   }
   toJSON() {
     const obj = {
@@ -126,8 +125,8 @@ function createError(input) {
     return input;
   }
   const err = new H3Error(
-    input.message ?? input.statusMessage,
-    // @ts-ignore
+    input.message ?? input.statusMessage ?? "",
+    // @ts-ignore https://v8.dev/features/error-cause
     input.cause ? { cause: input.cause } : void 0
   );
   if ("stack" in input) {
@@ -162,7 +161,7 @@ function createError(input) {
     const sanitizedMessage = sanitizeStatusMessage(err.statusMessage);
     if (sanitizedMessage !== originalMessage) {
       console.warn(
-        "[h3] Please prefer using `message` for longer error messages instead of `statusMessage`. In the future `statusMessage` will be sanitized by default."
+        "[h3] Please prefer using `message` for longer error messages instead of `statusMessage`. In the future, `statusMessage` will be sanitized by default."
       );
     }
   }
@@ -175,7 +174,7 @@ function createError(input) {
   return err;
 }
 function sendError(event, error, debug) {
-  if (event.node.res.writableEnded) {
+  if (event.handled) {
     return;
   }
   const h3Error = isError(error) ? error : createError(error);
@@ -188,7 +187,7 @@ function sendError(event, error, debug) {
   if (debug) {
     responseBody.stack = (h3Error.stack || "").split("\n").map((l) => l.trim());
   }
-  if (event.node.res.writableEnded) {
+  if (event.handled) {
     return;
   }
   const _code = Number.parseInt(h3Error.statusCode);
@@ -284,9 +283,15 @@ function readRawBody(event, encoding = "utf8") {
   assertMethod(event, PayloadMethods$1);
   const _rawBody = event.node.req[RawBodySymbol] || event.node.req.body;
   if (_rawBody) {
-    const promise2 = Promise.resolve(_rawBody).then(
-      (_resolved) => Buffer.isBuffer(_resolved) ? _resolved : Buffer.from(_resolved)
-    );
+    const promise2 = Promise.resolve(_rawBody).then((_resolved) => {
+      if (Buffer.isBuffer(_resolved)) {
+        return _resolved;
+      }
+      if (_resolved.constructor === Object) {
+        return Buffer.from(JSON.stringify(_resolved));
+      }
+      return Buffer.from(_resolved);
+    });
     return encoding ? promise2.then((buff) => buff.toString(encoding)) : promise2;
   }
   if (!Number.parseInt(event.node.req.headers["content-length"] || "")) {
@@ -371,7 +376,9 @@ function handleCacheHeaders(event, opts) {
   event.node.res.setHeader("cache-control", cacheControls.join(", "));
   if (cacheMatched) {
     event.node.res.statusCode = 304;
-    event.node.res.end();
+    if (!event.handled) {
+      event.node.res.end();
+    }
     return true;
   }
   return false;
@@ -520,6 +527,7 @@ async function sendProxy(event, target, opts = {}) {
     event.node.res.statusCode
   );
   event.node.res.statusMessage = sanitizeStatusMessage(response.statusText);
+  const cookies = [];
   for (const [key, value] of response.headers.entries()) {
     if (key === "content-encoding") {
       continue;
@@ -528,7 +536,15 @@ async function sendProxy(event, target, opts = {}) {
       continue;
     }
     if (key === "set-cookie") {
-      const cookies = splitCookiesString(value).map((cookie) => {
+      cookies.push(...splitCookiesString(value));
+      continue;
+    }
+    event.node.res.setHeader(key, value);
+  }
+  if (cookies.length > 0) {
+    event.node.res.setHeader(
+      "set-cookie",
+      cookies.map((cookie) => {
         if (opts.cookieDomainRewrite) {
           cookie = rewriteCookieProperty(
             cookie,
@@ -544,15 +560,18 @@ async function sendProxy(event, target, opts = {}) {
           );
         }
         return cookie;
-      });
-      event.node.res.setHeader("set-cookie", cookies);
-      continue;
-    }
-    event.node.res.setHeader(key, value);
+      })
+    );
+  }
+  if (opts.onResponse) {
+    await opts.onResponse(event, response);
   }
   if (response._data !== void 0) {
     return response._data;
   }
+  if (event.handled) {
+    return;
+  }
   if (opts.sendStream === false) {
     const data = new Uint8Array(await response.arrayBuffer());
     return event.node.res.end(data);
@@ -611,14 +630,16 @@ function rewriteCookieProperty(header, map, property) {
   );
 }
 
-const defer = typeof setImmediate !== "undefined" ? setImmediate : (fn) => fn();
+const defer = typeof setImmediate === "undefined" ? (fn) => fn() : setImmediate;
 function send(event, data, type) {
   if (type) {
     defaultContentType(event, type);
   }
   return new Promise((resolve) => {
     defer(() => {
-      event.node.res.end(data);
+      if (!event.handled) {
+        event.node.res.end(data);
+      }
       resolve();
     });
   });
@@ -628,7 +649,9 @@ function sendNoContent(event, code = 204) {
   if (event.node.res.statusCode === 204) {
     event.node.res.removeHeader("content-length");
   }
-  event.node.res.end();
+  if (!event.handled) {
+    event.node.res.end();
+  }
 }
 function setResponseStatus(event, code, text) {
   if (code) {
@@ -811,7 +834,7 @@ async function getSession(event, config) {
     Object.assign(session, unsealed);
   }
   if (!session.id) {
-    session.id = (config.crypto || crypto).randomUUID();
+    session.id = config.generateId?.() ?? (config.crypto || crypto).randomUUID();
     session.createdAt = Date.now();
     await updateSession(event, config);
   }
@@ -1082,12 +1105,16 @@ class H3Response {
 class H3Event {
   constructor(req, res) {
     this["__is_event__"] = true;
+    this._handled = false;
     this.context = {};
     this.node = { req, res };
   }
   get path() {
     return getRequestPath(this);
   }
+  get handled() {
+    return this._handled || this.node.res.writableEnded || this.node.res.headersSent;
+  }
   /** @deprecated Please use `event.node.req` instead. **/
   get req() {
     return this.node.req;
@@ -1099,35 +1126,37 @@ class H3Event {
   // Implementation of FetchEvent
   respondWith(r) {
     Promise.resolve(r).then((_response) => {
-      if (this.res.writableEnded) {
+      if (this.handled) {
         return;
       }
       const response = _response instanceof H3Response ? _response : new H3Response(_response);
       for (const [key, value] of response.headers.entries()) {
-        this.res.setHeader(key, value);
+        this.node.res.setHeader(key, value);
       }
       if (response.status) {
-        this.res.statusCode = sanitizeStatusCode(
+        this.node.res.statusCode = sanitizeStatusCode(
           response.status,
-          this.res.statusCode
+          this.node.res.statusCode
         );
       }
       if (response.statusText) {
-        this.res.statusMessage = sanitizeStatusMessage(response.statusText);
+        this.node.res.statusMessage = sanitizeStatusMessage(
+          response.statusText
+        );
       }
       if (response.redirected) {
-        this.res.setHeader("location", response.url);
+        this.node.res.setHeader("location", response.url);
       }
       if (!response._body) {
-        return this.res.end();
+        return this.node.res.end();
       }
       if (typeof response._body === "string" || "buffer" in response._body || "byteLength" in response._body) {
-        return this.res.end(response._body);
+        return this.node.res.end(response._body);
       }
       if (!response.headers.has("content-type")) {
         response.headers.set("content-type", MIMES.json);
       }
-      this.res.end(JSON.stringify(response._body));
+      this.node.res.end(JSON.stringify(response._body));
     });
   }
 }
@@ -1253,7 +1282,7 @@ function createAppEventHandler(stack, options) {
         continue;
       }
       const val = await layer.handler(event);
-      if (event.node.res.writableEnded) {
+      if (event.handled) {
         return;
       }
       const type = typeof val;
@@ -1278,10 +1307,10 @@ function createAppEventHandler(stack, options) {
         }
       }
     }
-    if (!event.node.res.writableEnded) {
+    if (!event.handled) {
       throw createError({
         statusCode: 404,
-        statusMessage: `Cannot find any route matching ${event.node.req.url || "/"}.`
+        statusMessage: `Cannot find any path matching ${event.node.req.url || "/"}.`
       });
     }
   });
@@ -1429,15 +1458,25 @@ function createRouter(opts = {}) {
     const method = (event.node.req.method || "get").toLowerCase();
     const handler = matched.handlers[method] || matched.handlers.all;
     if (!handler) {
-      throw createError({
-        statusCode: 405,
-        name: "Method Not Allowed",
-        statusMessage: `Method ${method} is not allowed on this route.`
-      });
+      if (opts.preemptive || opts.preemtive) {
+        throw createError({
+          statusCode: 405,
+          name: "Method Not Allowed",
+          statusMessage: `Method ${method} is not allowed on this route.`
+        });
+      } else {
+        return;
+      }
     }
     const params = matched.params || {};
     event.context.params = params;
-    return handler(event);
+    return Promise.resolve(handler(event)).then((res) => {
+      if (res === void 0 && (opts.preemptive || opts.preemtive)) {
+        setResponseStatus(event, 204);
+        return "";
+      }
+      return res;
+    });
   });
   return router;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h3",
-  "version": "1.6.6",
+  "version": "1.7.1",
   "description": "Tiny JavaScript Server",
   "repository": "unjs/h3",
   "license": "MIT",
@@ -19,46 +19,46 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "unbuild",
-    "dev": "vitest",
-    "lint": "eslint --cache --ext .ts,.js,.mjs,.cjs . && prettier -c src test playground",
-    "lint:fix": "eslint --cache --ext .ts,.js,.mjs,.cjs . --fix && prettier -c src test playground -w",
-    "play": "jiti ./playground/index.ts",
-    "profile": "0x -o -D .profile -P 'autocannon -c 100 -p 10 -d 40 http://localhost:$PORT' ./playground/server.cjs",
-    "release": "pnpm test && pnpm build && changelogen --release && pnpm publish && git push --follow-tags",
-    "test": "pnpm lint && vitest run --coverage"
-  },
   "dependencies": {
     "cookie-es": "^1.0.0",
     "defu": "^6.1.2",
-    "destr": "^1.2.2",
+    "destr": "^2.0.0",
     "iron-webcrypto": "^0.7.0",
     "radix3": "^1.0.1",
     "ufo": "^1.1.2",
-    "uncrypto": "^0.1.2"
+    "uncrypto": "^0.1.3"
   },
   "devDependencies": {
     "0x": "^5.5.0",
     "@types/express": "^4.17.17",
-    "@types/node": "^20.1.4",
+    "@types/node": "^20.3.1",
     "@types/supertest": "^2.0.12",
-    "@vitest/coverage-c8": "^0.31.0",
+    "@vitest/coverage-v8": "^0.32.2",
     "autocannon": "^7.11.0",
     "changelogen": "^0.5.3",
     "connect": "^3.7.0",
-    "eslint": "^8.40.0",
-    "eslint-config-unjs": "^0.1.0",
+    "eslint": "^8.43.0",
+    "eslint-config-unjs": "^0.2.1",
     "express": "^4.18.2",
-    "get-port": "^6.1.2",
+    "get-port": "^7.0.0",
     "jiti": "^1.18.2",
     "listhen": "^1.0.4",
-    "node-fetch-native": "^1.1.1",
+    "node-fetch-native": "^1.2.0",
     "prettier": "^2.8.8",
     "supertest": "^6.3.3",
-    "typescript": "^5.0.4",
+    "typescript": "^5.1.3",
     "unbuild": "^1.2.1",
-    "vitest": "^0.31.0"
+    "vitest": "^0.32.2"
   },
-  "packageManager": "pnpm@8.5.1"
+  "packageManager": "pnpm@8.6.3",
+  "scripts": {
+    "build": "unbuild",
+    "dev": "vitest",
+    "lint": "eslint --cache --ext .ts,.js,.mjs,.cjs . && prettier -c src test playground",
+    "lint:fix": "eslint --cache --ext .ts,.js,.mjs,.cjs . --fix && prettier -c src test playground -w",
+    "play": "jiti ./playground/index.ts",
+    "profile": "0x -o -D .profile -P 'autocannon -c 100 -p 10 -d 40 http://localhost:$PORT' ./playground/server.cjs",
+    "release": "pnpm test && pnpm build && changelogen --release && pnpm publish && git push --follow-tags",
+    "test": "pnpm lint && vitest run --coverage"
+  }
 }