h3 1.0.1 → 1.1.0

package/README.md

@@ -39,28 +39,32 @@ pnpm add h3
 ## Usage
 
 ```ts
-import { createServer } from 'http'
-import { createApp, eventHandler, toNodeListener } from 'h3'
+import { createServer } from "node:http";
+import { createApp, eventHandler, toNodeListener } from "h3";
 
-const app = createApp()
-app.use('/', eventHandler(() => 'Hello world!'))
+const app = createApp();
+app.use(
+  "/",
+  eventHandler(() => "Hello world!")
+);
 
-createServer(toNodeListener(app)).listen(process.env.PORT || 3000)
+createServer(toNodeListener(app)).listen(process.env.PORT || 3000);
 ```
 
-<details>
- <summary>Example using <a href="https://github.com/unjs/listhen">listhen</a> for an elegant listener.</summary>
+Example using <a href="https://github.com/unjs/listhen">listhen</a> for an elegant listener:
 
 ```ts
-import { createApp, toNodeListener } from 'h3'
-import { listen } from 'listhen'
+import { createApp, eventHandler, toNodeListener } from "h3";
+import { listen } from "listhen";
 
-const app = createApp()
-app.use('/', eventHandler(() => 'Hello world!'))
+const app = createApp();
+app.use(
+  "/",
+  eventHandler(() => "Hello world!")
+);
 
-listen(toNodeListener(app))
+listen(toNodeListener(app));
 ```
-</details>
 
 ## Router
 
@@ -69,15 +73,21 @@ The `app` instance created by `h3` uses a middleware stack (see [how it works](#
 To opt-in using a more advanced and convenient routing system, we can create a router instance and register it to app instance.
 
 ```ts
-import { createApp, eventHandler, createRouter } from 'h3'
+import { createApp, eventHandler, createRouter } from "h3";
 
-const app = createApp()
+const app = createApp();
 
 const router = createRouter()
- .get('/', eventHandler(() => 'Hello World!'))
- .get('/hello/:name', eventHandler(event => `Hello ${event.context.params.name}!`))
-
-app.use(router)
+  .get(
+    "/",
+    eventHandler(() => "Hello World!")
+  )
+  .get(
+    "/hello/:name",
+    eventHandler((event) => `Hello ${event.context.params.name}!`)
+  );
+
+app.use(router);
 ```
 
 **Tip:** We can register same route more than once with different methods.
@@ -113,13 +123,13 @@ H3 has concept of compasable utilities that accept `event` (from `eventHandler((
 
 ### Built-in
 
-- `useRawBody(event, encoding?)`
-- `useBody(event)`
-- `useCookies(event)`
-- `useCookie(event, name)`
+- `readRawBody(event, encoding?)`
+- `readBody(event)`
+- `parseCookies(event)`
+- `getCookie(event, name)`
 - `setCookie(event, name, value, opts?)`
 - `deleteCookie(event, name, opts?)`
-- `useQuery(event)`
+- `getQuery(event)`
 - `getRouterParams(event)`
 - `send(event, data, type?)`
 - `sendRedirect(event, location, code=302)`
@@ -132,23 +142,37 @@ H3 has concept of compasable utilities that accept `event` (from `eventHandler((
 - `writeEarlyHints(event, links, callback)`
 - `sendStream(event, data)`
 - `sendError(event, error, debug?)`
-- `useMethod(event, default?)`
+- `getMethod(event, default?)`
 - `isMethod(event, expected, allowHead?)`
 - `assertMethod(event, expected, allowHead?)`
 - `createError({ statusCode, statusMessage, data? })`
 - `sendProxy(event, { target, headers?, fetchOptions?, fetch?, sendStream? })`
 - `proxyRequest(event, { target, headers?, fetchOptions?, fetch?, sendStream? })`
+- `sendNoContent(event, code = 204)`
+- `setResponseStatus(event, status)`
+- `getResponseStatus(event)`
+- `getResponseStatusText(event)`
+- `readMultipartFormData(event)`
 
 👉 You can learn more about usage in [JSDocs Documentation](https://www.jsdocs.io/package/h3#package-functions).
 
-### Add-ons
+## Community Packages
+
+You can use more h3 event utilities made by the community.
+
+Please check their READMEs for more details.
 
-More composable utilities can be found in community packages.
+PRs are welcome to add your packages.
 
-- `validateBody(event, schema)` from [h3-typebox](https://github.com/kevinmarrec/h3-typebox)
-- `validateQuery(event, schema)` from [h3-typebox](https://github.com/kevinmarrec/h3-typebox)
-- `useValidatedBody(event, schema)` from [h3-zod](https://github.com/wobsoriano/h3-zod)
-- `useValidatedQuery(event, schema)` from [h3-zod](https://github.com/wobsoriano/h3-zod)
+- [h3-cors](https://github.com/NozomuIkuta/h3-cors)
+  - `defineCorsEventHandler(options)`
+  - `isPreflight(event)`
+- [h3-typebox](https://github.com/kevinmarrec/h3-typebox)
+  - `validateBody(event, schema)`
+  - `validateQuery(event, schema)`
+- [h3-zod](https://github.com/wobsoriano/h3-zod)
+  - `useValidatedBody(event, schema)`
+  - `useValidatedQuery(event, schema)`
 
 ## License
 

package/dist/index.cjs

@@ -17,6 +17,83 @@ function useBase(base, handler) {
   });
 }
 
+function parse(multipartBodyBuffer, boundary) {
+  let lastline = "";
+  let state = 0 /* INIT */;
+  let buffer = [];
+  const allParts = [];
+  let currentPartHeaders = [];
+  for (let i = 0; i < multipartBodyBuffer.length; i++) {
+    const prevByte = i > 0 ? multipartBodyBuffer[i - 1] : null;
+    const currByte = multipartBodyBuffer[i];
+    const newLineChar = currByte === 10 || currByte === 13;
+    if (!newLineChar) {
+      lastline += String.fromCodePoint(currByte);
+    }
+    const newLineDetected = currByte === 10 && prevByte === 13;
+    if (0 /* INIT */ === state && newLineDetected) {
+      if ("--" + boundary === lastline) {
+        state = 1 /* READING_HEADERS */;
+      }
+      lastline = "";
+    } else if (1 /* READING_HEADERS */ === state && newLineDetected) {
+      if (lastline.length > 0) {
+        const i2 = lastline.indexOf(":");
+        if (i2 > 0) {
+          const name = lastline.slice(0, i2).toLowerCase();
+          const value = lastline.slice(i2 + 1).trim();
+          currentPartHeaders.push([name, value]);
+        }
+      } else {
+        state = 2 /* READING_DATA */;
+        buffer = [];
+      }
+      lastline = "";
+    } else if (2 /* READING_DATA */ === state) {
+      if (lastline.length > boundary.length + 4) {
+        lastline = "";
+      }
+      if ("--" + boundary === lastline) {
+        const j = buffer.length - lastline.length;
+        const part = buffer.slice(0, j - 1);
+        allParts.push(process(part, currentPartHeaders));
+        buffer = [];
+        currentPartHeaders = [];
+        lastline = "";
+        state = 3 /* READING_PART_SEPARATOR */;
+      } else {
+        buffer.push(currByte);
+      }
+      if (newLineDetected) {
+        lastline = "";
+      }
+    } else if (3 /* READING_PART_SEPARATOR */ === state && newLineDetected) {
+      state = 1 /* READING_HEADERS */;
+    }
+  }
+  return allParts;
+}
+function process(data, headers) {
+  const dataObj = {};
+  const contentDispositionHeader = headers.find((h) => h[0] === "content-disposition")?.[1] || "";
+  for (const i of contentDispositionHeader.split(";")) {
+    const s = i.split("=");
+    if (s.length !== 2) {
+      continue;
+    }
+    const key = (s[0] || "").trim();
+    if (key === "name" || key === "filename") {
+      dataObj[key] = (s[1] || "").trim().replace(/"/g, "");
+    }
+  }
+  const contentType = headers.find((h) => h[0] === "content-type")?.[1] || "";
+  if (contentType) {
+    dataObj.type = contentType;
+  }
+  dataObj.data = Buffer.from(data);
+  return dataObj;
+}
+
 class H3Error extends Error {
   constructor() {
     super(...arguments);
@@ -47,12 +124,18 @@ function createError(input) {
   if (isError(input)) {
     return input;
   }
-  const err = new H3Error(input.message ?? input.statusMessage, input.cause ? { cause: input.cause } : void 0);
+  const err = new H3Error(
+    input.message ?? input.statusMessage,
+    // @ts-ignore
+    input.cause ? { cause: input.cause } : void 0
+  );
   if ("stack" in input) {
     try {
-      Object.defineProperty(err, "stack", { get() {
-        return input.stack;
-      } });
+      Object.defineProperty(err, "stack", {
+        get() {
+          return input.stack;
+        }
+      });
     } catch {
       try {
         err.stack = input.stack;
@@ -178,17 +261,20 @@ function readRawBody(event, encoding = "utf8") {
   if (!Number.parseInt(event.node.req.headers["content-length"] || "")) {
     return Promise.resolve(void 0);
   }
-  const promise = event.node.req[RawBodySymbol] = new Promise((resolve, reject) => {
-    const bodyData = [];
-    event.node.req.on("error", (err) => {
-      reject(err);
-    }).on("data", (chunk) => {
-      bodyData.push(chunk);
-    }).on("end", () => {
-      resolve(Buffer.concat(bodyData));
-    });
-  });
-  return encoding ? promise.then((buff) => buff.toString(encoding)) : promise;
+  const promise = event.node.req[RawBodySymbol] = new Promise(
+    (resolve, reject) => {
+      const bodyData = [];
+      event.node.req.on("error", (err) => {
+        reject(err);
+      }).on("data", (chunk) => {
+        bodyData.push(chunk);
+      }).on("end", () => {
+        resolve(Buffer.concat(bodyData));
+      });
+    }
+  );
+  const result = encoding ? promise.then((buff) => buff.toString(encoding)) : promise;
+  return result;
 }
 async function readBody(event) {
   if (ParsedBodySymbol in event.node.req) {
@@ -196,13 +282,39 @@ async function readBody(event) {
   }
   const body = await readRawBody(event);
   if (event.node.req.headers["content-type"] === "application/x-www-form-urlencoded") {
-    const parsedForm = Object.fromEntries(new URLSearchParams(body));
+    const form = new URLSearchParams(body);
+    const parsedForm = /* @__PURE__ */ Object.create(null);
+    for (const [key, value] of form.entries()) {
+      if (key in parsedForm) {
+        if (!Array.isArray(parsedForm[key])) {
+          parsedForm[key] = [parsedForm[key]];
+        }
+        parsedForm[key].push(value);
+      } else {
+        parsedForm[key] = value;
+      }
+    }
     return parsedForm;
   }
   const json = destr(body);
   event.node.req[ParsedBodySymbol] = json;
   return json;
 }
+async function readMultipartFormData(event) {
+  const contentType = getRequestHeader(event, "content-type");
+  if (!contentType || !contentType.startsWith("multipart/form-data")) {
+    return;
+  }
+  const boundary = contentType.match(/boundary=([^;]*)(;|$)/i)?.[1];
+  if (!boundary) {
+    return;
+  }
+  const body = await readRawBody(event, false);
+  if (!body) {
+    return;
+  }
+  return parse(body, boundary);
+}
 
 function handleCacheHeaders(event, opts) {
   const cacheControls = ["public", ...opts.cacheControls || []];
@@ -251,6 +363,25 @@ function send(event, data, type) {
     });
   });
 }
+function sendNoContent(event, code = 204) {
+  event.node.res.statusCode = code;
+  if (event.node.res.statusCode === 204) {
+    event.node.res.removeHeader("content-length");
+  }
+  event.node.res.end();
+}
+function setResponseStatus(event, code, text) {
+  event.node.res.statusCode = code;
+  if (text) {
+    event.node.res.statusMessage = text;
+  }
+}
+function getResponseStatus(event) {
+  return event.node.res.statusCode;
+}
+function getResponseStatusText(event) {
+  return event.node.res.statusMessage;
+}
 function defaultContentType(event, type) {
   if (type && !event.node.res.getHeader("content-type")) {
     event.node.res.setHeader("content-type", type);
@@ -320,7 +451,9 @@ function writeEarlyHints(event, hints, cb = noop) {
   if (hints.link) {
     hints.link = Array.isArray(hints.link) ? hints.link : hints.link.split(",");
   }
-  const headers = Object.entries(hints).map((e) => [e[0].toLowerCase(), e[1]]);
+  const headers = Object.entries(hints).map(
+    (e) => [e[0].toLowerCase(), e[1]]
+  );
   if (headers.length === 0) {
     cb();
     return;
@@ -337,9 +470,17 @@ Link: ${hints.link.join(", ")}`;
     hint += `\r
 ${header}: ${value}`;
   }
-  event.node.res.socket.write(`${hint}\r
+  if (event.node.res.socket) {
+    event.node.res.socket.write(
+      `${hint}\r
 \r
-`, "utf8", cb);
+`,
+      "utf8",
+      cb
+    );
+  } else {
+    cb();
+  }
 }
 
 function parseCookies(event) {
@@ -402,7 +543,9 @@ async function proxyRequest(event, target, opts = {}) {
 async function sendProxy(event, target, opts = {}) {
   const _fetch = opts.fetch || globalThis.fetch;
   if (!_fetch) {
-    throw new Error("fetch is not available. Try importing `node-fetch-native/polyfill` for Node.js.");
+    throw new Error(
+      "fetch is not available. Try importing `node-fetch-native/polyfill` for Node.js."
+    );
   }
   const response = await _fetch(target, {
     headers: opts.headers,
@@ -442,11 +585,15 @@ class H3Headers {
     if (!init) {
       this._headers = {};
     } else if (Array.isArray(init)) {
-      this._headers = Object.fromEntries(init.map(([key, value]) => [key.toLowerCase(), value]));
+      this._headers = Object.fromEntries(
+        init.map(([key, value]) => [key.toLowerCase(), value])
+      );
     } else if (init && "append" in init) {
       this._headers = Object.fromEntries(init.entries());
     } else {
-      this._headers = Object.fromEntries(Object.entries(init).map(([key, value]) => [key.toLowerCase(), value]));
+      this._headers = Object.fromEntries(
+        Object.entries(init).map(([key, value]) => [key.toLowerCase(), value])
+      );
     }
   }
   [Symbol.iterator]() {
@@ -486,6 +633,7 @@ class H3Headers {
 
 class H3Response {
   constructor(body = null, init = {}) {
+    // TODO: yet to implement
     this.body = null;
     this.type = "default";
     this.bodyUsed = false;
@@ -530,12 +678,15 @@ class H3Event {
   get path() {
     return this.req.url;
   }
+  /** @deprecated Please use `event.node.req` instead. **/
   get req() {
     return this.node.req;
   }
+  /** @deprecated Please use `event.node.res` instead. **/
   get res() {
     return this.node.res;
   }
+  // Implementation of FetchEvent
   respondWith(r) {
     Promise.resolve(r).then((_response) => {
       if (this.res.writableEnded) {
@@ -617,7 +768,10 @@ function defineLazyEventHandler(factory) {
       _promise = Promise.resolve(factory()).then((r) => {
         const handler = r.default || r;
         if (typeof handler !== "function") {
-          throw new TypeError("Invalid lazy handler result. It should be a function:", handler);
+          throw new TypeError(
+            "Invalid lazy handler result. It should be a function:",
+            handler
+          );
         }
         _resolved = toEventHandler(r.default || r);
         return _resolved;
@@ -638,6 +792,7 @@ function createApp(options = {}) {
   const stack = [];
   const handler = createAppEventHandler(stack, options);
   const app = {
+    // @ts-ignore
     use: (arg1, arg2, arg3) => use(app, arg1, arg2, arg3),
     handler,
     stack,
@@ -655,9 +810,13 @@ function use(app, arg1, arg2, arg3) {
       use(app, arg1, i, arg3);
     }
   } else if (typeof arg1 === "string") {
-    app.stack.push(normalizeLayer({ ...arg3, route: arg1, handler: arg2 }));
+    app.stack.push(
+      normalizeLayer({ ...arg3, route: arg1, handler: arg2 })
+    );
   } else if (typeof arg1 === "function") {
-    app.stack.push(normalizeLayer({ ...arg2, route: "/", handler: arg1 }));
+    app.stack.push(
+      normalizeLayer({ ...arg2, route: "/", handler: arg1 })
+    );
   } else {
     app.stack.push(normalizeLayer({ ...arg1 }));
   }
@@ -698,7 +857,11 @@ function createAppEventHandler(stack, options) {
         } else if (val instanceof Error) {
           throw createError(val);
         } else {
-          return send(event, JSON.stringify(val, void 0, spacing), MIMES.json);
+          return send(
+            event,
+            JSON.stringify(val, void 0, spacing),
+            MIMES.json
+          );
         }
       }
     }
@@ -734,10 +897,17 @@ function fromNodeMiddleware(handler) {
     return handler;
   }
   if (typeof handler !== "function") {
-    throw new TypeError("Invalid handler. It should be a function:", handler);
+    throw new TypeError(
+      "Invalid handler. It should be a function:",
+      handler
+    );
   }
   return eventHandler((event) => {
-    return callNodeListener(handler, event.node.req, event.node.res);
+    return callNodeListener(
+      handler,
+      event.node.req,
+      event.node.res
+    );
   });
 }
 function toNodeListener(app) {
@@ -791,7 +961,17 @@ function callNodeListener(handler, req, res) {
   });
 }
 
-const RouterMethods = ["connect", "delete", "get", "head", "options", "post", "put", "trace", "patch"];
+const RouterMethods = [
+  "connect",
+  "delete",
+  "get",
+  "head",
+  "options",
+  "post",
+  "put",
+  "trace",
+  "patch"
+];
 function createRouter(opts = {}) {
   const _router = radix3.createRouter({});
   const routes = {};
@@ -822,8 +1002,8 @@ function createRouter(opts = {}) {
       path = path.slice(0, Math.max(0, qIndex));
     }
     const matched = _router.lookup(path);
-    if (!matched) {
-      if (opts.preemtive) {
+    if (!matched || !matched.handlers) {
+      if (opts.preemptive || opts.preemtive) {
         throw createError({
           statusCode: 404,
           name: "Not Found",
@@ -883,6 +1063,8 @@ exports.getRequestHeader = getRequestHeader;
 exports.getRequestHeaders = getRequestHeaders;
 exports.getResponseHeader = getResponseHeader;
 exports.getResponseHeaders = getResponseHeaders;
+exports.getResponseStatus = getResponseStatus;
+exports.getResponseStatusText = getResponseStatusText;
 exports.getRouterParam = getRouterParam;
 exports.getRouterParams = getRouterParams;
 exports.handleCacheHeaders = handleCacheHeaders;
@@ -896,9 +1078,11 @@ exports.parseCookies = parseCookies;
 exports.promisifyNodeListener = promisifyNodeListener;
 exports.proxyRequest = proxyRequest;
 exports.readBody = readBody;
+exports.readMultipartFormData = readMultipartFormData;
 exports.readRawBody = readRawBody;
 exports.send = send;
 exports.sendError = sendError;
+exports.sendNoContent = sendNoContent;
 exports.sendProxy = sendProxy;
 exports.sendRedirect = sendRedirect;
 exports.sendStream = sendStream;
@@ -907,6 +1091,7 @@ exports.setHeader = setHeader;
 exports.setHeaders = setHeaders;
 exports.setResponseHeader = setResponseHeader;
 exports.setResponseHeaders = setResponseHeaders;
+exports.setResponseStatus = setResponseStatus;
 exports.toEventHandler = toEventHandler;
 exports.toNodeListener = toNodeListener;
 exports.use = use;

package/dist/index.d.ts

@@ -3,23 +3,23 @@ export { IncomingMessage as NodeIncomingMessage, ServerResponse as NodeServerRes
 import { CookieSerializeOptions } from 'cookie-es';
 import * as ufo from 'ufo';
 
-declare type HTTPMethod = "GET" | "HEAD" | "PATCH" | "POST" | "PUT" | "DELETE" | "CONNECT" | "OPTIONS" | "TRACE";
-declare type Encoding = false | "ascii" | "utf8" | "utf-8" | "utf16le" | "ucs2" | "ucs-2" | "base64" | "latin1" | "binary" | "hex";
+type HTTPMethod = "GET" | "HEAD" | "PATCH" | "POST" | "PUT" | "DELETE" | "CONNECT" | "OPTIONS" | "TRACE";
+type Encoding = false | "ascii" | "utf8" | "utf-8" | "utf16le" | "ucs2" | "ucs-2" | "base64" | "latin1" | "binary" | "hex";
 interface H3EventContext extends Record<string, any> {
 }
-declare type EventHandlerResponse<T = any> = T | Promise<T>;
+type EventHandlerResponse<T = any> = T | Promise<T>;
 interface EventHandler<T = any> {
-    "__is_handler__"?: true;
+    __is_handler__?: true;
     (event: H3Event): EventHandlerResponse<T>;
 }
-declare type LazyEventHandler = () => EventHandler | Promise<EventHandler>;
-declare type RequestHeaders = {
+type LazyEventHandler = () => EventHandler | Promise<EventHandler>;
+type RequestHeaders = {
     [name: string]: string | undefined;
 };
 
-declare type NodeListener = (req: IncomingMessage, res: ServerResponse) => void;
-declare type NodePromisifiedHandler = (req: IncomingMessage, res: ServerResponse) => Promise<any>;
-declare type NodeMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: Error) => any) => any;
+type NodeListener = (req: IncomingMessage, res: ServerResponse) => void;
+type NodePromisifiedHandler = (req: IncomingMessage, res: ServerResponse) => Promise<any>;
+type NodeMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: Error) => any) => any;
 declare const defineNodeListener: (handler: NodeListener) => NodeListener;
 declare const defineNodeMiddleware: (middleware: NodeMiddleware) => NodeMiddleware;
 declare function fromNodeMiddleware(handler: NodeListener | NodeMiddleware): EventHandler;
@@ -72,7 +72,7 @@ declare class H3Event implements Pick<FetchEvent, "respondWith"> {
     context: H3EventContext;
     constructor(req: IncomingMessage, res: ServerResponse);
     get path(): string | undefined;
-    /** @deprecated Please use `event.node.res` instead. **/
+    /** @deprecated Please use `event.node.req` instead. **/
     get req(): IncomingMessage;
     /** @deprecated Please use `event.node.res` instead. **/
     get res(): ServerResponse<IncomingMessage>;
@@ -97,15 +97,15 @@ interface Layer {
     match?: Matcher;
     handler: EventHandler;
 }
-declare type Stack = Layer[];
+type Stack = Layer[];
 interface InputLayer {
     route?: string;
     match?: Matcher;
     handler: EventHandler;
     lazy?: boolean;
 }
-declare type InputStack = InputLayer[];
-declare type Matcher = (url: string, event?: H3Event) => boolean;
+type InputStack = InputLayer[];
+type Matcher = (url: string, event?: H3Event) => boolean;
 interface AppUse {
     (route: string | string[], handler: EventHandler | EventHandler[], options?: Partial<InputLayer>): App;
     (handler: EventHandler | EventHandler[], options?: Partial<InputLayer>): App;
@@ -139,7 +139,7 @@ declare function createAppEventHandler(stack: Stack, options: AppOptions): Event
  */
 declare class H3Error extends Error {
     static __h3_error__: boolean;
-    toJSON(): Pick<H3Error, "statusCode" | "statusMessage" | "data" | "message">;
+    toJSON(): Pick<H3Error, "data" | "statusCode" | "statusMessage" | "message">;
     statusCode: number;
     fatal: boolean;
     unhandled: boolean;
@@ -152,10 +152,10 @@ declare class H3Error extends Error {
  * @param input {Partial<H3Error>}
  * @return {H3Error} An instance of the H3Error
  */
-declare function createError(input: string | Partial<H3Error> & {
+declare function createError(input: string | (Partial<H3Error> & {
     status?: number;
     statusText?: string;
-}): H3Error;
+})): H3Error;
 /**
  * Receive an error and return the corresponding response.<br>
  *  H3 internally uses this function to handle unhandled errors.<br>
@@ -171,6 +171,13 @@ declare function isError(input: any): input is H3Error;
 
 declare function useBase(base: string, handler: EventHandler): EventHandler;
 
+interface MultiPartData {
+    data: Buffer;
+    name?: string;
+    filename?: string;
+    type?: string;
+}
+
 /**
  * Reads body of the request and returns encoded raw string (default) or `Buffer` if encoding if falsy.
  * @param event {H3Event} H3 event or req passed by h3 handler
@@ -178,7 +185,7 @@ declare function useBase(base: string, handler: EventHandler): EventHandler;
  *
  * @return {String|Buffer} Encoded raw string or raw Buffer of the body
  */
-declare function readRawBody(event: H3Event, encoding?: Encoding): Encoding extends false ? Buffer : Promise<string | Buffer | undefined>;
+declare function readRawBody<E extends Encoding = "utf8">(event: H3Event, encoding?: E): E extends false ? Promise<Buffer | undefined> : Promise<string | undefined>;
 /**
  * Reads request body and try to safely parse using [destr](https://github.com/unjs/destr)
  * @param event {H3Event} H3 event or req passed by h3 handler
@@ -191,6 +198,7 @@ declare function readRawBody(event: H3Event, encoding?: Encoding): Encoding exte
  * ```
  */
 declare function readBody<T = any>(event: H3Event): Promise<T>;
+declare function readMultipartFormData(event: H3Event): Promise<MultiPartData[] | undefined>;
 
 interface CacheConditions {
     modifiedTime?: string | Date;
@@ -272,6 +280,17 @@ declare function getRequestHeader(event: H3Event, name: string): RequestHeaders[
 declare const getHeader: typeof getRequestHeader;
 
 declare function send(event: H3Event, data?: any, type?: string): Promise<void>;
+/**
+ * Respond with an empty payload.<br>
+ * Note that calling this function will close the connection and no other data can be sent to the client afterwards.
+ *
+ * @param event H3 event
+ * @param code status code to be send. By default, it is `204 No Content`.
+ */
+declare function sendNoContent(event: H3Event, code?: number): void;
+declare function setResponseStatus(event: H3Event, code: number, text?: string): void;
+declare function getResponseStatus(event: H3Event): number;
+declare function getResponseStatusText(event: H3Event): string;
 declare function defaultContentType(event: H3Event, type?: string): void;
 declare function sendRedirect(event: H3Event, location: string, code?: number): Promise<void>;
 declare function getResponseHeaders(event: H3Event): ReturnType<H3Event["res"]["getHeaders"]>;
@@ -288,17 +307,19 @@ declare function isStream(data: any): any;
 declare function sendStream(event: H3Event, data: any): Promise<void>;
 declare function writeEarlyHints(event: H3Event, hints: string | string[] | Record<string, string | string[]>, cb?: () => void): void;
 
-declare type RouterMethod = Lowercase<HTTPMethod>;
-declare type RouterUse = (path: string, handler: EventHandler, method?: RouterMethod | RouterMethod[]) => Router;
-declare type AddRouteShortcuts = Record<RouterMethod, RouterUse>;
+type RouterMethod = Lowercase<HTTPMethod>;
+type RouterUse = (path: string, handler: EventHandler, method?: RouterMethod | RouterMethod[]) => Router;
+type AddRouteShortcuts = Record<RouterMethod, RouterUse>;
 interface Router extends AddRouteShortcuts {
     add: RouterUse;
     use: RouterUse;
     handler: EventHandler;
 }
 interface CreateRouterOptions {
+    /** @deprecated Please use `preemptive` instead. **/
     preemtive?: boolean;
+    preemptive?: boolean;
 }
 declare function createRouter(opts?: CreateRouterOptions): Router;
 
-export { AddRouteShortcuts, App, AppOptions, AppUse, CacheConditions, CreateRouterOptions, DynamicEventHandler, Encoding, EventHandler, EventHandlerResponse, H3Error, H3Event, H3EventContext, H3Headers, H3Response, HTTPMethod, InputLayer, InputStack, Layer, LazyEventHandler, MIMES, Matcher, NodeEventContext, NodeListener, NodeMiddleware, NodePromisifiedHandler, ProxyOptions, RequestHeaders, Router, RouterMethod, RouterUse, Stack, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, callNodeListener, createApp, createAppEventHandler, createError, createEvent, createRouter, defaultContentType, defineEventHandler, defineLazyEventHandler, defineNodeListener, defineNodeMiddleware, deleteCookie, dynamicEventHandler, eventHandler, fromNodeMiddleware, getCookie, getHeader, getHeaders, getMethod, getQuery, getRequestHeader, getRequestHeaders, getResponseHeader, getResponseHeaders, getRouterParam, getRouterParams, handleCacheHeaders, isError, isEvent, isEventHandler, isMethod, isStream, lazyEventHandler, parseCookies, promisifyNodeListener, proxyRequest, readBody, readRawBody, send, sendError, sendProxy, sendRedirect, sendStream, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, toEventHandler, toNodeListener, use, useBase, writeEarlyHints };
+export { AddRouteShortcuts, App, AppOptions, AppUse, CacheConditions, CreateRouterOptions, DynamicEventHandler, Encoding, EventHandler, EventHandlerResponse, H3Error, H3Event, H3EventContext, H3Headers, H3Response, HTTPMethod, InputLayer, InputStack, Layer, LazyEventHandler, MIMES, Matcher, NodeEventContext, NodeListener, NodeMiddleware, NodePromisifiedHandler, ProxyOptions, RequestHeaders, Router, RouterMethod, RouterUse, Stack, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, callNodeListener, createApp, createAppEventHandler, createError, createEvent, createRouter, defaultContentType, defineEventHandler, defineLazyEventHandler, defineNodeListener, defineNodeMiddleware, deleteCookie, dynamicEventHandler, eventHandler, fromNodeMiddleware, getCookie, getHeader, getHeaders, getMethod, getQuery, getRequestHeader, getRequestHeaders, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, handleCacheHeaders, isError, isEvent, isEventHandler, isMethod, isStream, lazyEventHandler, parseCookies, promisifyNodeListener, proxyRequest, readBody, readMultipartFormData, readRawBody, send, sendError, sendNoContent, sendProxy, sendRedirect, sendStream, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeListener, use, useBase, writeEarlyHints };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { withoutTrailingSlash, withoutBase, getQuery as getQuery$1 } from 'ufo';
 import { createRouter as createRouter$1 } from 'radix3';
 import destr from 'destr';
-import { parse, serialize } from 'cookie-es';
+import { parse as parse$1, serialize } from 'cookie-es';
 
 function useBase(base, handler) {
   base = withoutTrailingSlash(base);
@@ -15,6 +15,83 @@ function useBase(base, handler) {
   });
 }
 
+function parse(multipartBodyBuffer, boundary) {
+  let lastline = "";
+  let state = 0 /* INIT */;
+  let buffer = [];
+  const allParts = [];
+  let currentPartHeaders = [];
+  for (let i = 0; i < multipartBodyBuffer.length; i++) {
+    const prevByte = i > 0 ? multipartBodyBuffer[i - 1] : null;
+    const currByte = multipartBodyBuffer[i];
+    const newLineChar = currByte === 10 || currByte === 13;
+    if (!newLineChar) {
+      lastline += String.fromCodePoint(currByte);
+    }
+    const newLineDetected = currByte === 10 && prevByte === 13;
+    if (0 /* INIT */ === state && newLineDetected) {
+      if ("--" + boundary === lastline) {
+        state = 1 /* READING_HEADERS */;
+      }
+      lastline = "";
+    } else if (1 /* READING_HEADERS */ === state && newLineDetected) {
+      if (lastline.length > 0) {
+        const i2 = lastline.indexOf(":");
+        if (i2 > 0) {
+          const name = lastline.slice(0, i2).toLowerCase();
+          const value = lastline.slice(i2 + 1).trim();
+          currentPartHeaders.push([name, value]);
+        }
+      } else {
+        state = 2 /* READING_DATA */;
+        buffer = [];
+      }
+      lastline = "";
+    } else if (2 /* READING_DATA */ === state) {
+      if (lastline.length > boundary.length + 4) {
+        lastline = "";
+      }
+      if ("--" + boundary === lastline) {
+        const j = buffer.length - lastline.length;
+        const part = buffer.slice(0, j - 1);
+        allParts.push(process(part, currentPartHeaders));
+        buffer = [];
+        currentPartHeaders = [];
+        lastline = "";
+        state = 3 /* READING_PART_SEPARATOR */;
+      } else {
+        buffer.push(currByte);
+      }
+      if (newLineDetected) {
+        lastline = "";
+      }
+    } else if (3 /* READING_PART_SEPARATOR */ === state && newLineDetected) {
+      state = 1 /* READING_HEADERS */;
+    }
+  }
+  return allParts;
+}
+function process(data, headers) {
+  const dataObj = {};
+  const contentDispositionHeader = headers.find((h) => h[0] === "content-disposition")?.[1] || "";
+  for (const i of contentDispositionHeader.split(";")) {
+    const s = i.split("=");
+    if (s.length !== 2) {
+      continue;
+    }
+    const key = (s[0] || "").trim();
+    if (key === "name" || key === "filename") {
+      dataObj[key] = (s[1] || "").trim().replace(/"/g, "");
+    }
+  }
+  const contentType = headers.find((h) => h[0] === "content-type")?.[1] || "";
+  if (contentType) {
+    dataObj.type = contentType;
+  }
+  dataObj.data = Buffer.from(data);
+  return dataObj;
+}
+
 class H3Error extends Error {
   constructor() {
     super(...arguments);
@@ -45,12 +122,18 @@ function createError(input) {
   if (isError(input)) {
     return input;
   }
-  const err = new H3Error(input.message ?? input.statusMessage, input.cause ? { cause: input.cause } : void 0);
+  const err = new H3Error(
+    input.message ?? input.statusMessage,
+    // @ts-ignore
+    input.cause ? { cause: input.cause } : void 0
+  );
   if ("stack" in input) {
     try {
-      Object.defineProperty(err, "stack", { get() {
-        return input.stack;
-      } });
+      Object.defineProperty(err, "stack", {
+        get() {
+          return input.stack;
+        }
+      });
     } catch {
       try {
         err.stack = input.stack;
@@ -176,17 +259,20 @@ function readRawBody(event, encoding = "utf8") {
   if (!Number.parseInt(event.node.req.headers["content-length"] || "")) {
     return Promise.resolve(void 0);
   }
-  const promise = event.node.req[RawBodySymbol] = new Promise((resolve, reject) => {
-    const bodyData = [];
-    event.node.req.on("error", (err) => {
-      reject(err);
-    }).on("data", (chunk) => {
-      bodyData.push(chunk);
-    }).on("end", () => {
-      resolve(Buffer.concat(bodyData));
-    });
-  });
-  return encoding ? promise.then((buff) => buff.toString(encoding)) : promise;
+  const promise = event.node.req[RawBodySymbol] = new Promise(
+    (resolve, reject) => {
+      const bodyData = [];
+      event.node.req.on("error", (err) => {
+        reject(err);
+      }).on("data", (chunk) => {
+        bodyData.push(chunk);
+      }).on("end", () => {
+        resolve(Buffer.concat(bodyData));
+      });
+    }
+  );
+  const result = encoding ? promise.then((buff) => buff.toString(encoding)) : promise;
+  return result;
 }
 async function readBody(event) {
   if (ParsedBodySymbol in event.node.req) {
@@ -194,13 +280,39 @@ async function readBody(event) {
   }
   const body = await readRawBody(event);
   if (event.node.req.headers["content-type"] === "application/x-www-form-urlencoded") {
-    const parsedForm = Object.fromEntries(new URLSearchParams(body));
+    const form = new URLSearchParams(body);
+    const parsedForm = /* @__PURE__ */ Object.create(null);
+    for (const [key, value] of form.entries()) {
+      if (key in parsedForm) {
+        if (!Array.isArray(parsedForm[key])) {
+          parsedForm[key] = [parsedForm[key]];
+        }
+        parsedForm[key].push(value);
+      } else {
+        parsedForm[key] = value;
+      }
+    }
     return parsedForm;
   }
   const json = destr(body);
   event.node.req[ParsedBodySymbol] = json;
   return json;
 }
+async function readMultipartFormData(event) {
+  const contentType = getRequestHeader(event, "content-type");
+  if (!contentType || !contentType.startsWith("multipart/form-data")) {
+    return;
+  }
+  const boundary = contentType.match(/boundary=([^;]*)(;|$)/i)?.[1];
+  if (!boundary) {
+    return;
+  }
+  const body = await readRawBody(event, false);
+  if (!body) {
+    return;
+  }
+  return parse(body, boundary);
+}
 
 function handleCacheHeaders(event, opts) {
   const cacheControls = ["public", ...opts.cacheControls || []];
@@ -249,6 +361,25 @@ function send(event, data, type) {
     });
   });
 }
+function sendNoContent(event, code = 204) {
+  event.node.res.statusCode = code;
+  if (event.node.res.statusCode === 204) {
+    event.node.res.removeHeader("content-length");
+  }
+  event.node.res.end();
+}
+function setResponseStatus(event, code, text) {
+  event.node.res.statusCode = code;
+  if (text) {
+    event.node.res.statusMessage = text;
+  }
+}
+function getResponseStatus(event) {
+  return event.node.res.statusCode;
+}
+function getResponseStatusText(event) {
+  return event.node.res.statusMessage;
+}
 function defaultContentType(event, type) {
   if (type && !event.node.res.getHeader("content-type")) {
     event.node.res.setHeader("content-type", type);
@@ -318,7 +449,9 @@ function writeEarlyHints(event, hints, cb = noop) {
   if (hints.link) {
     hints.link = Array.isArray(hints.link) ? hints.link : hints.link.split(",");
   }
-  const headers = Object.entries(hints).map((e) => [e[0].toLowerCase(), e[1]]);
+  const headers = Object.entries(hints).map(
+    (e) => [e[0].toLowerCase(), e[1]]
+  );
   if (headers.length === 0) {
     cb();
     return;
@@ -335,13 +468,21 @@ Link: ${hints.link.join(", ")}`;
     hint += `\r
 ${header}: ${value}`;
   }
-  event.node.res.socket.write(`${hint}\r
+  if (event.node.res.socket) {
+    event.node.res.socket.write(
+      `${hint}\r
 \r
-`, "utf8", cb);
+`,
+      "utf8",
+      cb
+    );
+  } else {
+    cb();
+  }
 }
 
 function parseCookies(event) {
-  return parse(event.node.req.headers.cookie || "");
+  return parse$1(event.node.req.headers.cookie || "");
 }
 function getCookie(event, name) {
   return parseCookies(event)[name];
@@ -400,7 +541,9 @@ async function proxyRequest(event, target, opts = {}) {
 async function sendProxy(event, target, opts = {}) {
   const _fetch = opts.fetch || globalThis.fetch;
   if (!_fetch) {
-    throw new Error("fetch is not available. Try importing `node-fetch-native/polyfill` for Node.js.");
+    throw new Error(
+      "fetch is not available. Try importing `node-fetch-native/polyfill` for Node.js."
+    );
   }
   const response = await _fetch(target, {
     headers: opts.headers,
@@ -440,11 +583,15 @@ class H3Headers {
     if (!init) {
       this._headers = {};
     } else if (Array.isArray(init)) {
-      this._headers = Object.fromEntries(init.map(([key, value]) => [key.toLowerCase(), value]));
+      this._headers = Object.fromEntries(
+        init.map(([key, value]) => [key.toLowerCase(), value])
+      );
     } else if (init && "append" in init) {
       this._headers = Object.fromEntries(init.entries());
     } else {
-      this._headers = Object.fromEntries(Object.entries(init).map(([key, value]) => [key.toLowerCase(), value]));
+      this._headers = Object.fromEntries(
+        Object.entries(init).map(([key, value]) => [key.toLowerCase(), value])
+      );
     }
   }
   [Symbol.iterator]() {
@@ -484,6 +631,7 @@ class H3Headers {
 
 class H3Response {
   constructor(body = null, init = {}) {
+    // TODO: yet to implement
     this.body = null;
     this.type = "default";
     this.bodyUsed = false;
@@ -528,12 +676,15 @@ class H3Event {
   get path() {
     return this.req.url;
   }
+  /** @deprecated Please use `event.node.req` instead. **/
   get req() {
     return this.node.req;
   }
+  /** @deprecated Please use `event.node.res` instead. **/
   get res() {
     return this.node.res;
   }
+  // Implementation of FetchEvent
   respondWith(r) {
     Promise.resolve(r).then((_response) => {
       if (this.res.writableEnded) {
@@ -615,7 +766,10 @@ function defineLazyEventHandler(factory) {
       _promise = Promise.resolve(factory()).then((r) => {
         const handler = r.default || r;
         if (typeof handler !== "function") {
-          throw new TypeError("Invalid lazy handler result. It should be a function:", handler);
+          throw new TypeError(
+            "Invalid lazy handler result. It should be a function:",
+            handler
+          );
         }
         _resolved = toEventHandler(r.default || r);
         return _resolved;
@@ -636,6 +790,7 @@ function createApp(options = {}) {
   const stack = [];
   const handler = createAppEventHandler(stack, options);
   const app = {
+    // @ts-ignore
     use: (arg1, arg2, arg3) => use(app, arg1, arg2, arg3),
     handler,
     stack,
@@ -653,9 +808,13 @@ function use(app, arg1, arg2, arg3) {
       use(app, arg1, i, arg3);
     }
   } else if (typeof arg1 === "string") {
-    app.stack.push(normalizeLayer({ ...arg3, route: arg1, handler: arg2 }));
+    app.stack.push(
+      normalizeLayer({ ...arg3, route: arg1, handler: arg2 })
+    );
   } else if (typeof arg1 === "function") {
-    app.stack.push(normalizeLayer({ ...arg2, route: "/", handler: arg1 }));
+    app.stack.push(
+      normalizeLayer({ ...arg2, route: "/", handler: arg1 })
+    );
   } else {
     app.stack.push(normalizeLayer({ ...arg1 }));
   }
@@ -696,7 +855,11 @@ function createAppEventHandler(stack, options) {
         } else if (val instanceof Error) {
           throw createError(val);
         } else {
-          return send(event, JSON.stringify(val, void 0, spacing), MIMES.json);
+          return send(
+            event,
+            JSON.stringify(val, void 0, spacing),
+            MIMES.json
+          );
         }
       }
     }
@@ -732,10 +895,17 @@ function fromNodeMiddleware(handler) {
     return handler;
   }
   if (typeof handler !== "function") {
-    throw new TypeError("Invalid handler. It should be a function:", handler);
+    throw new TypeError(
+      "Invalid handler. It should be a function:",
+      handler
+    );
   }
   return eventHandler((event) => {
-    return callNodeListener(handler, event.node.req, event.node.res);
+    return callNodeListener(
+      handler,
+      event.node.req,
+      event.node.res
+    );
   });
 }
 function toNodeListener(app) {
@@ -789,7 +959,17 @@ function callNodeListener(handler, req, res) {
   });
 }
 
-const RouterMethods = ["connect", "delete", "get", "head", "options", "post", "put", "trace", "patch"];
+const RouterMethods = [
+  "connect",
+  "delete",
+  "get",
+  "head",
+  "options",
+  "post",
+  "put",
+  "trace",
+  "patch"
+];
 function createRouter(opts = {}) {
   const _router = createRouter$1({});
   const routes = {};
@@ -820,8 +1000,8 @@ function createRouter(opts = {}) {
       path = path.slice(0, Math.max(0, qIndex));
     }
     const matched = _router.lookup(path);
-    if (!matched) {
-      if (opts.preemtive) {
+    if (!matched || !matched.handlers) {
+      if (opts.preemptive || opts.preemtive) {
         throw createError({
           statusCode: 404,
           name: "Not Found",
@@ -847,4 +1027,4 @@ function createRouter(opts = {}) {
   return router;
 }
 
-export { H3Error, H3Event, H3Headers, H3Response, MIMES, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, callNodeListener, createApp, createAppEventHandler, createError, createEvent, createRouter, defaultContentType, defineEventHandler, defineLazyEventHandler, defineNodeListener, defineNodeMiddleware, deleteCookie, dynamicEventHandler, eventHandler, fromNodeMiddleware, getCookie, getHeader, getHeaders, getMethod, getQuery, getRequestHeader, getRequestHeaders, getResponseHeader, getResponseHeaders, getRouterParam, getRouterParams, handleCacheHeaders, isError, isEvent, isEventHandler, isMethod, isStream, lazyEventHandler, parseCookies, promisifyNodeListener, proxyRequest, readBody, readRawBody, send, sendError, sendProxy, sendRedirect, sendStream, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, toEventHandler, toNodeListener, use, useBase, writeEarlyHints };
+export { H3Error, H3Event, H3Headers, H3Response, MIMES, appendHeader, appendHeaders, appendResponseHeader, appendResponseHeaders, assertMethod, callNodeListener, createApp, createAppEventHandler, createError, createEvent, createRouter, defaultContentType, defineEventHandler, defineLazyEventHandler, defineNodeListener, defineNodeMiddleware, deleteCookie, dynamicEventHandler, eventHandler, fromNodeMiddleware, getCookie, getHeader, getHeaders, getMethod, getQuery, getRequestHeader, getRequestHeaders, getResponseHeader, getResponseHeaders, getResponseStatus, getResponseStatusText, getRouterParam, getRouterParams, handleCacheHeaders, isError, isEvent, isEventHandler, isMethod, isStream, lazyEventHandler, parseCookies, promisifyNodeListener, proxyRequest, readBody, readMultipartFormData, readRawBody, send, sendError, sendNoContent, sendProxy, sendRedirect, sendStream, setCookie, setHeader, setHeaders, setResponseHeader, setResponseHeaders, setResponseStatus, toEventHandler, toNodeListener, use, useBase, writeEarlyHints };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h3",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Tiny JavaScript Server",
   "repository": "unjs/h3",
   "license": "MIT",
@@ -19,41 +19,42 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "unbuild",
-    "dev": "vitest",
-    "lint": "eslint --ext ts,mjs,cjs .",
-    "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": "^0.5.0",
-    "destr": "^1.2.1",
+    "destr": "^1.2.2",
     "radix3": "^1.0.0",
-    "ufo": "^1.0.0"
+    "ufo": "^1.0.1"
   },
   "devDependencies": {
     "0x": "^5.4.1",
-    "@types/express": "^4.17.14",
-    "@types/node": "^18.11.9",
+    "@types/express": "^4.17.16",
+    "@types/node": "^18.11.18",
     "@types/supertest": "^2.0.12",
-    "@vitest/coverage-c8": "^0.25.2",
+    "@vitest/coverage-c8": "^0.28.2",
     "autocannon": "^7.10.0",
-    "changelogen": "^0.4.0",
+    "changelogen": "^0.4.1",
     "connect": "^3.7.0",
-    "eslint": "^8.27.0",
-    "eslint-config-unjs": "^0.0.2",
+    "eslint": "^8.32.0",
+    "eslint-config-unjs": "^0.1.0",
     "express": "^4.18.2",
     "get-port": "^6.1.2",
-    "jiti": "^1.16.0",
-    "listhen": "^1.0.0",
+    "jiti": "^1.16.2",
+    "listhen": "^1.0.2",
     "node-fetch-native": "^1.0.1",
-    "supertest": "^6.3.1",
-    "typescript": "^4.8.4",
-    "unbuild": "^0.9.4",
-    "vitest": "^0.25.2"
+    "prettier": "^2.8.3",
+    "supertest": "^6.3.3",
+    "typescript": "^4.9.4",
+    "unbuild": "^1.1.1",
+    "vitest": "^0.28.2"
   },
-  "packageManager": "pnpm@7.16.0"
-}
+  "packageManager": "pnpm@7.26.0",
+  "scripts": {
+    "build": "unbuild",
+    "dev": "vitest",
+    "lint": "eslint --ext ts,mjs,cjs . && prettier -c src test playground",
+    "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"
+  }
+}