h3 0.3.0 → 0.3.4

package/README.md

@@ -1,24 +1,25 @@
-[![d](https://img.shields.io/npm/dm/h3.svg?style=flat-square)](https://npmjs.com/package/h3)
-[![v](https://img.shields.io/npm/v/h3/latest.svg?style=flat-square)](https://npmjs.com/package/h3)
-[![b](https://img.shields.io/bundlephobia/min/h3/latest.svg?style=flat-square)](https://bundlephobia.com/result?p=h3)
-[![a](https://img.shields.io/github/workflow/status/unjs/h3/ci/main?style=flat-square)](https://github.com/unjs/h3/actions)
-[![c](https://img.shields.io/codecov/c/gh/unjs/h3/main?style=flat-square)](https://codecov.io/gh/unjs/h3)
+[![npm downloads](https://img.shields.io/npm/dm/h3.svg?style=flat-square)](https://npmjs.com/package/h3)
+[![version](https://img.shields.io/npm/v/h3/latest.svg?style=flat-square)](https://npmjs.com/package/h3)
+[![bundlephobia](https://img.shields.io/bundlephobia/min/h3/latest.svg?style=flat-square)](https://bundlephobia.com/result?p=h3)
+[![build status](https://img.shields.io/github/workflow/status/unjs/h3/ci/main?style=flat-square)](https://github.com/unjs/h3/actions)
+[![coverage](https://img.shields.io/codecov/c/gh/unjs/h3/main?style=flat-square)](https://codecov.io/gh/unjs/h3)
+[![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue?style=flat-square)](https://www.jsdocs.io/package/h3)
 
 > H3 is a minimal h(ttp) framework built for high performance and portability
 
 <!-- ![h3 - Tiny JavaScript Server](.github/banner.svg) -->
 
-**Features**
+## Features
 
-✔️ **Portable:** Works perfectly in Serverless, Workers, and Node.js
+✔️ &nbsp;**Portable:** Works perfectly in Serverless, Workers, and Node.js
 
-✔️ **Compatible:** Support connect/express middleware
+✔️ &nbsp;**Compatible:** Support connect/express middleware
 
-✔️ **Minimal:** Small, tree-shakable and zero-dependency
+✔️ &nbsp;**Minimal:** Small, tree-shakable and zero-dependency
 
-✔️ **Modern:** Native promise support
+✔️ &nbsp;**Modern:** Native promise support
 
-✔️**Extendable:** Ships with a set of composable utilities but can be extended
+✔️ &nbsp;**Extendable:** Ships with a set of composable utilities but can be extended
 
 ## Install
 
@@ -42,7 +43,19 @@ app.use('/', () => 'Hello world!')
 createServer(app).listen(process.env.PORT || 3000)
 ```
 
-**Tip:** you may try [listhen](https://github.com/unjs/listhen) for a more elegant and advanced listener.
+<details>
+ <summary>Example using <a href="https://github.com/unjs/listhen">listhen</a> for an elegant listener.</summary>
+
+```ts
+import { createApp } from 'h3'
+import { listen } from 'listhen'
+
+const app = createApp()
+app.use('/', () => 'Hello world!')
+
+listen(app)
+```
+</details>
 
 ## Examples
 
@@ -78,26 +91,33 @@ Instead of adding helpers to `req` and `res`, h3 exposes them as composable util
 - `useBody(req)`
 - `useCookies(req)`
 - `useCookie(req, name)`
-- `setCookie(req, name, value, opts?)`
+- `setCookie(res, name, value, opts?)`
 - `useQuery(req)`
 - `send(res, data, type?)`
 - `sendRedirect(res, location, code=302)`
 - `appendHeader(res, name, value)`
 - `createError({ statusCode, statusMessage, data? }`
 - `sendError(res, error, debug?)`
+- `defineHandle(handle)`
+- `defineMiddleware(middlware)`
+- `useMethod(req, default?)`
+- `isMethod(req, expected, allowHead?)`
+- `assertMethod(req, expected, allowHead?)`
+
+👉 You can learn more about usage in [JSDocs Documentation](https://www.jsdocs.io/package/h3#package-functions).
 
 ## How it works?
 
-Using `createApp`, it returns a standard `(req, res)` handler function and internally an array called middleware stack. using`use()` method we can to add an item to this internal stack.
+Using `createApp`, it returns a standard `(req, res)` handler function and internally an array called middleware stack. using`use()` method we can add an item to this internal stack.
 
 When a request comes, each stack item that matches the route will be called and resolved until [`res.writableEnded`](https://nodejs.org/api/http.html#http_response_writableended) flag is set, which means the response is sent. If `writableEnded` is not set after all middleware, a `404` error will be thrown. And if one of the stack items resolves to a value, it will be serialized and sent as response as a shorthand method to sending responses.
 
 For maximum compatibility with connect/express middleware (`req, res, next?` signature), h3 converts classic middleware into a promisified version ready to use with stack runner:
 
-- If middleware has 3rd next/callback param, promise will `resolve/reject` when called
+- If middleware has 3rd next/callback param, the promise will `resolve/reject` when called
 - If middleware returns a promise, it will be **chained** to the main promise
-- If calling middleware throws an immediate error, promise will be rejected
-- On `close` and `error` events of res, promise will `resolve/reject` (to ensure if middleware simply calls `res.end`)
+- If calling middleware throws an immediate error, the promise will be rejected
+- On `close` and `error` events of res, the promise will `resolve/reject` (to ensure if middleware simply calls `res.end`)
 
 ## License
 

package/dist/index.cjs

@@ -83,8 +83,8 @@ function parseURL(input = "", defaultProto) {
     return defaultProto ? parseURL(defaultProto + input) : parsePath(input);
   }
   const [protocol = "", auth, hostAndPath] = (input.match(/([^:/]+:)?\/\/([^/@]+@)?(.*)/) || []).splice(1);
-  const [host = "", path = ""] = (hostAndPath.match(/([^/]*)(.*)?/) || []).splice(1);
-  const {pathname, search, hash} = parsePath(path);
+  const [host = "", path = ""] = (hostAndPath.match(/([^/?]*)(.*)?/) || []).splice(1);
+  const { pathname, search, hash } = parsePath(path);
   return {
     protocol,
     auth: auth ? auth.substr(0, auth.length - 1) : "",
@@ -103,6 +103,8 @@ function parsePath(input = "") {
   };
 }
 
+const defineHandle = (handler) => handler;
+const defineMiddleware = (middleware) => middleware;
 function promisifyHandle(handle) {
   return function(req, res) {
     return callHandle(handle, req, res);
@@ -346,11 +348,7 @@ function serialize(name, val, options) {
 
   if (null != opt.maxAge) {
     var maxAge = opt.maxAge - 0;
-
-    if (isNaN(maxAge) || !isFinite(maxAge)) {
-      throw new TypeError('option maxAge is invalid')
-    }
-
+    if (isNaN(maxAge)) throw new Error('maxAge should be a Number');
     str += '; Max-Age=' + Math.floor(maxAge);
   }
 
@@ -475,6 +473,31 @@ function setCookie(res, name, value, serializeOptions) {
 function useQuery(req) {
   return getQuery(req.url || "");
 }
+function useMethod(req, defaultMethod = "GET") {
+  return (req.method || defaultMethod).toUpperCase();
+}
+function isMethod(req, expected, allowHead) {
+  const method = useMethod(req);
+  if (allowHead && method === "HEAD") {
+    return true;
+  }
+  if (typeof expected === "string") {
+    if (method === expected) {
+      return true;
+    }
+  } else if (expected.includes(method)) {
+    return true;
+  }
+  return false;
+}
+function assertMethod(req, expected, allowHead) {
+  if (!isMethod(req, expected, allowHead)) {
+    throw createError({
+      statusCode: 405,
+      statusMessage: "HTTP method is not allowed."
+    });
+  }
+}
 
 class H3Error extends Error {
   constructor() {
@@ -528,7 +551,7 @@ function sendError(res, error, debug) {
 
 function createApp(options = {}) {
   const stack = [];
-  const _handle = createHandle(stack);
+  const _handle = createHandle(stack, options);
   const app = function(req, res) {
     return _handle(req, res).catch((error) => {
       if (options.onError) {
@@ -556,7 +579,8 @@ function use(app, arg1, arg2, arg3) {
   }
   return app;
 }
-function createHandle(stack) {
+function createHandle(stack, options) {
+  const spacing = options.debug ? 2 : void 0;
   return async function handle(req, res) {
     req.originalUrl = req.originalUrl || req.url || "/";
     const reqUrl = req.url || "/";
@@ -580,12 +604,12 @@ function createHandle(stack) {
       if (type === "string") {
         return send(res, val, MIMES.html);
       } else if (type === "object" && val !== void 0) {
-        if (val.buffer) {
+        if (val && val.buffer) {
           return send(res, val);
         } else if (val instanceof Error) {
           throw createError(val);
         } else {
-          return send(res, JSON.stringify(val, null, 2), MIMES.json);
+          return send(res, JSON.stringify(val, null, spacing), MIMES.json);
         }
       }
     }
@@ -608,11 +632,15 @@ function normalizeLayer(layer) {
 exports.H3Error = H3Error;
 exports.MIMES = MIMES;
 exports.appendHeader = appendHeader;
+exports.assertMethod = assertMethod;
 exports.callHandle = callHandle;
 exports.createApp = createApp;
 exports.createError = createError;
 exports.createHandle = createHandle;
 exports.defaultContentType = defaultContentType;
+exports.defineHandle = defineHandle;
+exports.defineMiddleware = defineMiddleware;
+exports.isMethod = isMethod;
 exports.lazyHandle = lazyHandle;
 exports.promisifyHandle = promisifyHandle;
 exports.send = send;
@@ -624,5 +652,6 @@ exports.useBase = useBase;
 exports.useBody = useBody;
 exports.useCookie = useCookie;
 exports.useCookies = useCookies;
+exports.useMethod = useMethod;
 exports.useQuery = useQuery;
 exports.useRawBody = useRawBody;

package/dist/index.d.ts

@@ -7,6 +7,8 @@ declare type Handle<T = any> = (req: IncomingMessage, res: ServerResponse) => T;
 declare type PHandle = Handle<Promise<any>>;
 declare type Middleware = (req: IncomingMessage, res: ServerResponse, next: (err?: Error) => any) => any;
 declare type LazyHandle = () => Handle | Promise<Handle>;
+declare const defineHandle: <T>(handler: Handle<T>) => Handle<T>;
+declare const defineMiddleware: (middleware: Middleware) => Middleware;
 declare function promisifyHandle(handle: Handle | Middleware): PHandle;
 declare function callHandle(handle: Middleware, req: IncomingMessage, res: ServerResponse): Promise<unknown>;
 declare function lazyHandle(handle: LazyHandle, promisify?: boolean): PHandle;
@@ -46,7 +48,7 @@ interface AppOptions {
 }
 declare function createApp(options?: AppOptions): App;
 declare function use(app: App, arg1: string | Handle | InputLayer | InputLayer[], arg2?: Handle | Partial<InputLayer> | Handle[] | Middleware | Middleware[], arg3?: Partial<InputLayer>): App;
-declare function createHandle(stack: Stack): PHandle;
+declare function createHandle(stack: Stack, options: AppOptions): PHandle;
 
 /**
  * H3 Runtime Error
@@ -84,20 +86,22 @@ declare function sendError(res: ServerResponse, error: Error | H3Error, debug?:
 
 /**
  * Reads body of the request and returns encoded raw string (default) or `Buffer` if encoding if falsy.
- * @param req {IncomingMessage} An IncomingMessage object is created by
- *  <a href="https://nodejs.org/api/http.html#http_class_http_server">http.Server</a>
+ * @param req {IncomingMessage} An IncomingMessage object is created by [http.Server](https://nodejs.org/api/http.html#http_class_http_server)
  * @param encoding {Encoding} encoding="utf-8" - The character encoding to use.
  *
  * @return {String|Buffer} Encoded raw string or raw Buffer of the body
  */
 declare function useRawBody(req: IncomingMessage, encoding?: Encoding): Encoding extends false ? Buffer : Promise<string>;
 /**
- * Reads request body and try to safely parse using {@link https://github.com/unjs/destr destr}
- * @param req {IncomingMessage} An IncomingMessage object is created by
- *  <a href="https://nodejs.org/api/http.html#http_class_http_server">http.Server</a>
+ * Reads request body and try to safely parse using [destr](https://github.com/unjs/destr)
+ * @param req {IncomingMessage} An IncomingMessage object created by [http.Server](https://nodejs.org/api/http.html#http_class_http_server)
  * @param encoding {Encoding} encoding="utf-8" - The character encoding to use.
  *
- * @return {*} The Object, Array, string, number, boolean, or null value corresponding to the request JSON body
+ * @return {*} The `Object`, `Array`, `String`, `Number`, `Boolean`, or `null` value corresponding to the request JSON body
+ *
+ * ```ts
+ * const body = await useBody(req)
+ * ```
  */
 declare function useBody<T = any>(req: IncomingMessage): Promise<T>;
 
@@ -192,15 +196,46 @@ interface CookieSerializeOptions {
     secure?: boolean;
 }
 
+/**
+ * Parse the request to get HTTP Cookie header string and returning an object of all cookie name-value pairs.
+ * @param req {IncomingMessage} An IncomingMessage object created by [http.Server](https://nodejs.org/api/http.html#http_class_http_server)
+ * @returns Object of cookie name-value pairs
+ * ```ts
+ * const cookies = useCookies(req)
+ * ```
+ */
 declare function useCookies(req: IncomingMessage): Record<string, string>;
+/**
+ * Get a cookie value by name.
+ * @param req {IncomingMessage} An IncomingMessage object created by [http.Server](https://nodejs.org/api/http.html#http_class_http_server)
+ * @param name Name of the cookie to get
+ * @returns {*} Value of the cookie (String or undefined)
+ * ```ts
+ * const authorization = useCookie(request, 'Authorization')
+ * ```
+ */
 declare function useCookie(req: IncomingMessage, name: string): string | undefined;
-declare function setCookie(res: ServerResponse, name: string, value: string, serializeOptions: CookieSerializeOptions): void;
+/**
+ * Set a cookie value by name.
+ * @param res {ServerResponse} A ServerResponse object created by [http.Server](https://nodejs.org/api/http.html#http_class_http_server)
+ * @param name Name of the cookie to set
+ * @param value Value of the cookie to set
+ * @param serializeOptions {CookieSerializeOptions} Options for serializing the cookie
+ * ```ts
+ * setCookie(res, 'Authorization', '1234567')
+ * ```
+ */
+declare function setCookie(res: ServerResponse, name: string, value: string, serializeOptions?: CookieSerializeOptions): void;
 
 declare function useQuery(req: IncomingMessage): ufo.QueryObject;
+declare type HTTPMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE';
+declare function useMethod(req: IncomingMessage, defaultMethod?: HTTPMethod): HTTPMethod;
+declare function isMethod(req: IncomingMessage, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): boolean;
+declare function assertMethod(req: IncomingMessage, expected: HTTPMethod | HTTPMethod[], allowHead?: boolean): void;
 
 declare function send(res: ServerResponse, data: any, type?: string): Promise<unknown>;
 declare function defaultContentType(res: ServerResponse, type?: string): void;
 declare function sendRedirect(res: ServerResponse, location: string, code?: number): Promise<unknown>;
 declare function appendHeader(res: ServerResponse, name: string, value: string): void;
 
-export { App, AppOptions, AppUse, H3Error, Handle, InputLayer, InputStack, Layer, LazyHandle, MIMES, Matcher, Middleware, PHandle, Stack, appendHeader, callHandle, createApp, createError, createHandle, defaultContentType, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useQuery, useRawBody };
+export { App, AppOptions, AppUse, H3Error, HTTPMethod, Handle, InputLayer, InputStack, Layer, LazyHandle, MIMES, Matcher, Middleware, PHandle, Stack, appendHeader, assertMethod, callHandle, createApp, createError, createHandle, defaultContentType, defineHandle, defineMiddleware, isMethod, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useMethod, useQuery, useRawBody };

package/dist/index.mjs

@@ -79,8 +79,8 @@ function parseURL(input = "", defaultProto) {
     return defaultProto ? parseURL(defaultProto + input) : parsePath(input);
   }
   const [protocol = "", auth, hostAndPath] = (input.match(/([^:/]+:)?\/\/([^/@]+@)?(.*)/) || []).splice(1);
-  const [host = "", path = ""] = (hostAndPath.match(/([^/]*)(.*)?/) || []).splice(1);
-  const {pathname, search, hash} = parsePath(path);
+  const [host = "", path = ""] = (hostAndPath.match(/([^/?]*)(.*)?/) || []).splice(1);
+  const { pathname, search, hash } = parsePath(path);
   return {
     protocol,
     auth: auth ? auth.substr(0, auth.length - 1) : "",
@@ -99,6 +99,8 @@ function parsePath(input = "") {
   };
 }
 
+const defineHandle = (handler) => handler;
+const defineMiddleware = (middleware) => middleware;
 function promisifyHandle(handle) {
   return function(req, res) {
     return callHandle(handle, req, res);
@@ -342,11 +344,7 @@ function serialize(name, val, options) {
 
   if (null != opt.maxAge) {
     var maxAge = opt.maxAge - 0;
-
-    if (isNaN(maxAge) || !isFinite(maxAge)) {
-      throw new TypeError('option maxAge is invalid')
-    }
-
+    if (isNaN(maxAge)) throw new Error('maxAge should be a Number');
     str += '; Max-Age=' + Math.floor(maxAge);
   }
 
@@ -471,6 +469,31 @@ function setCookie(res, name, value, serializeOptions) {
 function useQuery(req) {
   return getQuery(req.url || "");
 }
+function useMethod(req, defaultMethod = "GET") {
+  return (req.method || defaultMethod).toUpperCase();
+}
+function isMethod(req, expected, allowHead) {
+  const method = useMethod(req);
+  if (allowHead && method === "HEAD") {
+    return true;
+  }
+  if (typeof expected === "string") {
+    if (method === expected) {
+      return true;
+    }
+  } else if (expected.includes(method)) {
+    return true;
+  }
+  return false;
+}
+function assertMethod(req, expected, allowHead) {
+  if (!isMethod(req, expected, allowHead)) {
+    throw createError({
+      statusCode: 405,
+      statusMessage: "HTTP method is not allowed."
+    });
+  }
+}
 
 class H3Error extends Error {
   constructor() {
@@ -524,7 +547,7 @@ function sendError(res, error, debug) {
 
 function createApp(options = {}) {
   const stack = [];
-  const _handle = createHandle(stack);
+  const _handle = createHandle(stack, options);
   const app = function(req, res) {
     return _handle(req, res).catch((error) => {
       if (options.onError) {
@@ -552,7 +575,8 @@ function use(app, arg1, arg2, arg3) {
   }
   return app;
 }
-function createHandle(stack) {
+function createHandle(stack, options) {
+  const spacing = options.debug ? 2 : void 0;
   return async function handle(req, res) {
     req.originalUrl = req.originalUrl || req.url || "/";
     const reqUrl = req.url || "/";
@@ -576,12 +600,12 @@ function createHandle(stack) {
       if (type === "string") {
         return send(res, val, MIMES.html);
       } else if (type === "object" && val !== void 0) {
-        if (val.buffer) {
+        if (val && val.buffer) {
           return send(res, val);
         } else if (val instanceof Error) {
           throw createError(val);
         } else {
-          return send(res, JSON.stringify(val, null, 2), MIMES.json);
+          return send(res, JSON.stringify(val, null, spacing), MIMES.json);
         }
       }
     }
@@ -601,4 +625,4 @@ function normalizeLayer(layer) {
   };
 }
 
-export { H3Error, MIMES, appendHeader, callHandle, createApp, createError, createHandle, defaultContentType, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useQuery, useRawBody };
+export { H3Error, MIMES, appendHeader, assertMethod, callHandle, createApp, createError, createHandle, defaultContentType, defineHandle, defineMiddleware, isMethod, lazyHandle, promisifyHandle, send, sendError, sendRedirect, setCookie, use, useBase, useBody, useCookie, useCookies, useMethod, useQuery, useRawBody };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h3",
-  "version": "0.3.0",
+  "version": "0.3.4",
   "description": "Tiny JavaScript Server",
   "repository": "unjs/h3",
   "license": "MIT",
@@ -21,8 +21,8 @@
     "build": "siroc build",
     "dev": "jiti test/playground",
     "lint": "eslint --ext ts .",
-    "release": "yarn test && yarn build && standard-version && npm publish && git push --follow-tags",
     "profile": "0x -o -D .profile -P 'autocannon -c 100 -p 10 -d 40 http://localhost:$PORT' ./hello.js",
+    "release": "yarn test && yarn build && standard-version && npm publish && git push --follow-tags",
     "test": "yarn lint && jest"
   },
   "devDependencies": {
@@ -35,11 +35,11 @@
     "@types/supertest": "latest",
     "autocannon": "latest",
     "connect": "latest",
-    "cookie": "latest",
+    "cookie-es": "latest",
     "destr": "latest",
     "eslint": "latest",
     "express": "latest",
-    "get-port": "latest",
+    "get-port": "^5.0.0",
     "jest": "latest",
     "jiti": "latest",
     "listhen": "latest",

package/CHANGELOG.md

@@ -1,228 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
-
-## [0.3.0](https://github.com/unjs/h3/compare/v0.2.12...v0.3.0) (2021-07-27)
-
-
-### ⚠ BREAKING CHANGES
-
-* `useAsync` is removed. use `use` instead
-
-### Features
-
-* automatically promisify legacyMiddlware with `use` ([2805d4c](https://github.com/unjs/h3/commit/2805d4cc42d22c22c7798a41514aca5cceeb8e19)), closes [#27](https://github.com/unjs/h3/issues/27)
-* handle returned errors (closes [#28](https://github.com/unjs/h3/issues/28)) ([991fcff](https://github.com/unjs/h3/commit/991fcff606b659035d5a23bd4ae97d3750e730cd))
-
-### [0.2.12](https://github.com/unjs/h3/compare/v0.2.11...v0.2.12) (2021-07-02)
-
-
-### Features
-
-* **pkg:** add exports field ([998d872](https://github.com/unjs/h3/commit/998d8723870650a742bdeefb57c1d9acfc407692))
-
-### [0.2.11](https://github.com/unjs/h3/compare/v0.2.10...v0.2.11) (2021-06-23)
-
-
-### Bug Fixes
-
-* createError fallback to statusMessage ([#25](https://github.com/unjs/h3/issues/25)) ([2f792f5](https://github.com/unjs/h3/commit/2f792f5cf64d87aeb41e387bae6cfad1112b3d05))
-
-### [0.2.10](https://github.com/unjs/h3/compare/v0.2.9...v0.2.10) (2021-04-21)
-
-
-### Bug Fixes
-
-* fallback for setImmediate ([6cf61f6](https://github.com/unjs/h3/commit/6cf61f601d206a9d3cdcf368cb700ebd5c2e22de))
-
-### [0.2.9](https://github.com/unjs/h3/compare/v0.2.8...v0.2.9) (2021-04-06)
-
-
-### Bug Fixes
-
-* resolve handle when send was called ([fb58e5b](https://github.com/unjs/h3/commit/fb58e5b274272ba55df4bb38b874a688b617d541))
-
-### [0.2.8](https://github.com/unjs/h3/compare/v0.2.7...v0.2.8) (2021-03-27)
-
-
-### Bug Fixes
-
-* **app:** custom options passed to useAsync ([3c328a4](https://github.com/unjs/h3/commit/3c328a4dc0dbc215d2da82cd0abc1e8ede006665))
-
-### [0.2.7](https://github.com/unjs/h3/compare/v0.2.6...v0.2.7) (2021-03-27)
-
-### [0.2.6](https://github.com/unjs/h3/compare/v0.2.5...v0.2.6) (2021-03-27)
-
-### [0.2.5](https://github.com/unjs/h3/compare/v0.2.4...v0.2.5) (2021-02-19)
-
-### [0.2.4](https://github.com/unjs/h3/compare/v0.2.3...v0.2.4) (2021-01-22)
-
-
-### Bug Fixes
-
-* always restore req.url for each layer to avoid mutation ([aae5787](https://github.com/unjs/h3/commit/aae57876a1bad3972bec86cee385db308ac69764))
-
-### [0.2.3](https://github.com/unjs/h3/compare/v0.2.2...v0.2.3) (2021-01-20)
-
-
-### Bug Fixes
-
-* improve internal error handling ([b38d450](https://github.com/unjs/h3/commit/b38d450e39101104333f33516d75869cd2427f9d))
-
-### [0.2.2](https://github.com/unjs/h3/compare/v0.2.1...v0.2.2) (2021-01-20)
-
-
-### Bug Fixes
-
-* capture stacktrace from createError ([1441784](https://github.com/unjs/h3/commit/14417846554f81f44ae677bfd609517dcfd3c291))
-* handle thrown errors by each layer ([62fd25a](https://github.com/unjs/h3/commit/62fd25a572de72a1f555b8f43e5e4798c392b74b))
-
-### [0.2.1](https://github.com/unjs/h3/compare/v0.2.0...v0.2.1) (2021-01-12)
-
-## [0.2.0](https://github.com/unjs/h3/compare/v0.0.15...v0.2.0) (2020-12-15)
-
-
-### ⚠ BREAKING CHANGES
-
-* rename useBodyJSON to useBody and unexposed cached value
-
-### Features
-
-* `useCookie`, `useCookies` and `setCookie` utilities ([088f413](https://github.com/unjs/h3/commit/088f413434a619a9888bfd9d1b189e56a7d00124)), closes [#17](https://github.com/unjs/h3/issues/17)
-* appendHeader utility ([84be904](https://github.com/unjs/h3/commit/84be9040e2c52b625a47591e8f5107793da29f72))
-* rename useBodyJSON to useBody and unexposed cached value ([d8d39a0](https://github.com/unjs/h3/commit/d8d39a0eefbc22c8d3af8e7dcee5ee8964da07e3))
-
-### [0.0.15](https://github.com/unjs/h3/compare/v0.0.14...v0.0.15) (2020-12-12)
-
-
-### Features
-
-* add request and response utils ([#15](https://github.com/unjs/h3/issues/15)) ([648e9b9](https://github.com/unjs/h3/commit/648e9b9ceff3a8658a7e3705164d5139e6f95c99))
-* custom error handler ([ad3515f](https://github.com/unjs/h3/commit/ad3515f0da8bb37d3f82a6527c459aa86a63e338))
-
-
-### Bug Fixes
-
-* don't override internal flag ([a5ee318](https://github.com/unjs/h3/commit/a5ee31888101cbe7458d7a63527d0cf07845d2a6))
-* hide 404 error ([38fb027](https://github.com/unjs/h3/commit/38fb027bb5a2d3d369f7d3e333edc1342cf32914))
-* preserve error message in console ([3002b27](https://github.com/unjs/h3/commit/3002b27aace50cf6d39c289b8500bb92a065fe7a))
-
-### [0.0.14](https://github.com/unjs/h3/compare/v0.0.13...v0.0.14) (2020-12-05)
-
-
-### Bug Fixes
-
-* **app:** handle buffer ([09c9c6d](https://github.com/unjs/h3/commit/09c9c6da5bcd00ff49e815cae3c74893d4b4806d))
-* **utils:** avoid setting falsy type ([df5e92b](https://github.com/unjs/h3/commit/df5e92b07ca2c096fb078c0deff50b613245c0db))
-
-### [0.0.13](https://github.com/unjs/h3/compare/v0.0.12...v0.0.13) (2020-12-05)
-
-
-### Bug Fixes
-
-* enable debug by default ([010cdfe](https://github.com/unjs/h3/commit/010cdfe32ce80b2453489f8839c5f3d946d027a1))
-
-### [0.0.12](https://github.com/unjs/h3/compare/v0.0.11...v0.0.12) (2020-11-23)
-
-
-### Features
-
-* allow chaining use statements ([#9](https://github.com/unjs/h3/issues/9)) ([e30ea79](https://github.com/unjs/h3/commit/e30ea7911ed378866f2c61b0ece3f332e113e821)), closes [#5](https://github.com/unjs/h3/issues/5)
-
-
-### Bug Fixes
-
-* correctly expose route and middleware types ([#10](https://github.com/unjs/h3/issues/10)) ([bb6cd4c](https://github.com/unjs/h3/commit/bb6cd4c6971fc269d6a313ebc07910898b32f178)), closes [#11](https://github.com/unjs/h3/issues/11) [#11](https://github.com/unjs/h3/issues/11)
-* ensure correct url is used when used as a sub-app ([0e4770a](https://github.com/unjs/h3/commit/0e4770af89757c274b1d3e6d7c54b973a7bf9bef))
-* mark app._handle as private to avoid sub-app detection ([1439f35](https://github.com/unjs/h3/commit/1439f354a7e9238113f6d8bc7687df8a5fe7bd10))
-
-### [0.0.11](https://github.com/unjs/h3/compare/v0.0.10...v0.0.11) (2020-11-21)
-
-
-### Features
-
-* `useAsync` ([236e979](https://github.com/unjs/h3/commit/236e97953ac014dffa8977c4bf8cd6f2fa369eb7))
-* custom matcher and improved docs ([1c4f9d1](https://github.com/unjs/h3/commit/1c4f9d138dde212486d1aa7acb0e2df9a8cb8aca))
-
-### [0.0.10](https://github.com/unjs/h3/compare/v0.0.9...v0.0.10) (2020-11-20)
-
-
-### Features
-
-* rewrite with much sexier API ([0d3680e](https://github.com/unjs/h3/commit/0d3680eacab44d6a40c10b94cfba2036afc571d9))
-
-### [0.0.9](https://github.com/unjs/h3/compare/v0.0.8...v0.0.9) (2020-11-20)
-
-
-### Features
-
-* createError ([1a80bd9](https://github.com/unjs/h3/commit/1a80bd9432b0585a474d6888e7035636307eead8))
-
-
-### Bug Fixes
-
-* throw 404 only when writableEnded is not set ([1c42a07](https://github.com/unjs/h3/commit/1c42a07e3ecc175c96dff026967298a107314f5e))
-
-### [0.0.8](https://github.com/unjs/h3/compare/v0.0.7...v0.0.8) (2020-11-19)
-
-
-### Bug Fixes
-
-* don't log 404 ([541ede0](https://github.com/unjs/h3/commit/541ede03edc6526b953c8a0bb7f31f0dc5fc21d3))
-
-### [0.0.7](https://github.com/unjs/h3/compare/v0.0.6...v0.0.7) (2020-11-19)
-
-### [0.0.6](https://github.com/unjs/h3/compare/v0.0.5...v0.0.6) (2020-11-19)
-
-
-### Features
-
-* add debug option to app ([b0891cd](https://github.com/unjs/h3/commit/b0891cd13d4a7b8ed0fb981ae878185c6728b618))
-
-### [0.0.5](https://github.com/unjs/h3/compare/v0.0.4...v0.0.5) (2020-11-19)
-
-
-### Features
-
-* expose unsafeHandle ([f1245f1](https://github.com/unjs/h3/commit/f1245f13c1a4ec1f9e1ecb4b0b73c50047ee4d3a))
-
-### [0.0.4](https://github.com/unjs/h3/compare/v0.0.3...v0.0.4) (2020-11-19)
-
-
-### Features
-
-* rewrite promisify logic ([a40aa81](https://github.com/unjs/h3/commit/a40aa81aa80da3ba418061338bcaa6286357ab67))
-
-
-### Bug Fixes
-
-* keep top level trailing slash ([2fb92ef](https://github.com/unjs/h3/commit/2fb92efdf462f3c4098af3cac6594599839f7cde))
-* stop middleware when writableEnded flag is set ([d87d8e5](https://github.com/unjs/h3/commit/d87d8e5f7a426409565d1a008b8231c793ec61ef))
-
-### [0.0.3](https://github.com/unjs/h3/compare/v0.0.2...v0.0.3) (2020-11-19)
-
-
-### Features
-
-* improve error util ([5504f4e](https://github.com/unjs/h3/commit/5504f4e53dfb19cceb6580b00077f8c80d0b5dc5))
-
-### [0.0.2](https://github.com/unjs/h3/compare/v0.0.1...v0.0.2) (2020-11-19)
-
-
-### Bug Fixes
-
-* remove dependency on process.env ([eb018f5](https://github.com/unjs/h3/commit/eb018f5e23a5f797a4b5d24fdbfe591994c39aef))
-
-### 0.0.1 (2020-11-18)
-
-
-### Features
-
-* de-default loazy handles ([0cb8c0c](https://github.com/unjs/h3/commit/0cb8c0c74647278806a53f7920f8678bb47749e5))
-* update docs and caller utility ([0ef0020](https://github.com/unjs/h3/commit/0ef0020da1931b8c08344008253703b91b318559))
-
-
-### Bug Fixes
-
-* **app:** handle returning promise ([2169f92](https://github.com/unjs/h3/commit/2169f92142d2e92e143913fff945628f17203779))
-* **writable:** set writableEnded and writableFinished ([7058fdc](https://github.com/unjs/h3/commit/7058fdcf38a31edd1ce2afe4b05eb0b050adea78))