fastify 3.25.0 → 3.25.1

package/README.md

@@ -156,7 +156,7 @@ In a similar way, all Fastify **v2.x** related changes should be based on [**`br
 
 > ## Note
 > `.listen` binds to the local host, `localhost`, interface by default (`127.0.0.1` or `::1`, depending on the operating system configuration). If you are running Fastify in a container (Docker, [GCP](https://cloud.google.com/), etc.), you may need to bind to `0.0.0.0`. Be careful when deciding to listen on all interfaces; it comes with inherent [security risks](https://web.archive.org/web/20170711105010/https://snyk.io/blog/mongodb-hack-and-secure-defaults/).
-> See [the documentation](./docs/Server.md#listen) for more information.
+> See [the documentation](./docs/Reference/Server.md#listen) for more information.
 
 ### Core features
 
@@ -192,36 +192,36 @@ matters to you.
 * <a href="./docs/Guides/Getting-Started.md"><code><b>Getting Started</b></code></a>
 * <a href="./docs/Guides/Index.md"><code><b>Guides</b></code></a>
 * <a href="./docs/Reference/Server.md"><code><b>Server</b></code></a>
-* <a href="./docs/Routes.md"><code><b>Routes</b></code></a>
+* <a href="./docs/Reference/Routes.md"><code><b>Routes</b></code></a>
 * <a href="./docs/Reference/Encapsulation.md"><code><b>Encapsulation</b></code></a>
-* <a href="./docs/Logging.md"><code><b>Logging</b></code></a>
-* <a href="./docs/Middleware.md"><code><b>Middleware</b></code></a>
-* <a href="./docs/Hooks.md"><code><b>Hooks</b></code></a>
-* <a href="./docs/Decorators.md"><code><b>Decorators</b></code></a>
-* <a href="./docs/Validation-and-Serialization.md"><code><b>Validation and Serialization</b></code></a>
-* <a href="./docs/Fluent-Schema.md"><code><b>Fluent Schema</b></code></a>
-* <a href="./docs/Lifecycle.md"><code><b>Lifecycle</b></code></a>
-* <a href="./docs/Reply.md"><code><b>Reply</b></code></a>
-* <a href="./docs/Request.md"><code><b>Request</b></code></a>
-* <a href="./docs/Errors.md"><code><b>Errors</b></code></a>
-* <a href="./docs/ContentTypeParser.md"><code><b>Content Type Parser</b></code></a>
-* <a href="./docs/Plugins.md"><code><b>Plugins</b></code></a>
-* <a href="./docs/Testing.md"><code><b>Testing</b></code></a>
-* <a href="./docs/Benchmarking.md"><code><b>Benchmarking</b></code></a>
-* <a href="./docs/Write-Plugin.md"><code><b>How to write a good plugin</b></code></a>
-* <a href="./docs/Plugins-Guide.md"><code><b>Plugins Guide</b></code></a>
-* <a href="./docs/HTTP2.md"><code><b>HTTP2</b></code></a>
-* <a href="./docs/LTS.md"><code><b>Long Term Support</b></code></a>
-* <a href="./docs/TypeScript.md"><code><b>TypeScript and types support</b></code></a>
-* <a href="./docs/Serverless.md"><code><b>Serverless</b></code></a>
-* <a href="./docs/Recommendations.md"><code><b>Recommendations</b></code></a>
+* <a href="./docs/Reference/Logging.md"><code><b>Logging</b></code></a>
+* <a href="./docs/Reference/Middleware.md"><code><b>Middleware</b></code></a>
+* <a href="./docs/Reference/Hooks.md"><code><b>Hooks</b></code></a>
+* <a href="./docs/Reference/Decorators.md"><code><b>Decorators</b></code></a>
+* <a href="./docs/Reference/Validation-and-Serialization.md"><code><b>Validation and Serialization</b></code></a>
+* <a href="./docs/Guides/Fluent-Schema.md"><code><b>Fluent Schema</b></code></a>
+* <a href="./docs/Reference/Lifecycle.md"><code><b>Lifecycle</b></code></a>
+* <a href="./docs/Reference/Reply.md"><code><b>Reply</b></code></a>
+* <a href="./docs/Reference/Request.md"><code><b>Request</b></code></a>
+* <a href="./docs/Reference/Errors.md"><code><b>Errors</b></code></a>
+* <a href="./docs/Reference/ContentTypeParser.md"><code><b>Content Type Parser</b></code></a>
+* <a href="./docs/Reference/Plugins.md"><code><b>Plugins</b></code></a>
+* <a href="./docs/Guides/Testing.md"><code><b>Testing</b></code></a>
+* <a href="./docs/Guides/Benchmarking.md"><code><b>Benchmarking</b></code></a>
+* <a href="./docs/Guides/Write-Plugin.md"><code><b>How to write a good plugin</b></code></a>
+* <a href="./docs/Guides/Plugins-Guide.md"><code><b>Plugins Guide</b></code></a>
+* <a href="./docs/Reference/HTTP2.md"><code><b>HTTP2</b></code></a>
+* <a href="./docs/Reference/LTS.md"><code><b>Long Term Support</b></code></a>
+* <a href="./docs/Reference/TypeScript.md"><code><b>TypeScript and types support</b></code></a>
+* <a href="./docs/Guides/Serverless.md"><code><b>Serverless</b></code></a>
+* <a href="./docs/Guides/Recommendations.md"><code><b>Recommendations</b></code></a>
 
 中文文档[地址](https://github.com/fastify/docs-chinese/blob/HEAD/README.md)
 
 ## Ecosystem
 
-- [Core](./docs/Ecosystem.md#core) - Core plugins maintained by the _Fastify_ [team](#team).
-- [Community](./docs/Ecosystem.md#community) - Community supported plugins.
+- [Core](./docs/Guides/Ecosystem.md#core) - Core plugins maintained by the _Fastify_ [team](#team).
+- [Community](./docs/Guides/Ecosystem.md#community) - Community supported plugins.
 - [Live Examples](https://github.com/fastify/example) - Multirepo with a broad set of real working examples.
 - [Discord](https://discord.gg/D3FZYPy) - Join our discord server and chat with the maintainers.
 

package/docs/Guides/Ecosystem.md

@@ -242,6 +242,8 @@ section.
   Fastify feature flags plugin with multiple providers support (e.g. env,
   [config](https://lorenwest.github.io/node-config/),
   [unleash](https://unleash.github.io/)).
+- [`fastify-file-routes`](https://github.com/spa5k/fastify-file-routes)
+  Get Next.js based file system routing into fastify.
 - [`fastify-file-upload`](https://github.com/huangang/fastify-file-upload)
   Fastify plugin for uploading files.
 - [`fastify-firebase`](https://github.com/now-ims/fastify-firebase) Fastify
@@ -259,6 +261,8 @@ section.
 - [`fastify-get-head`](https://github.com/MetCoder95/fastify-get-head) Small
   plugin to set a new HEAD route handler for each GET route previously
   registered in Fastify.
+- [`fastify-get-only`](https://github.com/DanieleFedeli/fastify-get-only) Small
+  plugin used to make fastify accept only GET requests
 - [`fastify-good-sessions`](https://github.com/Phara0h/fastify-good-sessions) A
   good Fastify sessions plugin focused on speed.
 - [`fastify-google-cloud-storage`](https://github.com/carlozamagni/fastify-google-cloud-storage)
@@ -440,6 +444,7 @@ section.
   client plugin for Fastify.
 - [`fastify-socket.io`](https://github.com/alemagio/fastify-socket.io) a
   Socket.io plugin for Fastify.
+- [`fastify-split-validator`](https://github.com/MetCoder95/fastify-split-validator) Small plugin to allow you use multiple validators in one route based on each HTTP part of the request.
 - [`fastify-sse`](https://github.com/lolo32/fastify-sse) to provide Server-Sent
   Events with `reply.sse( … )` to Fastify.
 - [`fastify-sse-v2`](https://github.com/nodefactoryio/fastify-sse-v2) to provide

package/docs/Guides/Fluent-Schema.md

@@ -3,7 +3,7 @@
 ## Fluent Schema
 
 The [Validation and
-Serialization](/docs/Reference/Validation-and-Serialization.md) documentation
+Serialization](../Reference/Validation-and-Serialization.md) documentation
 outlines all parameters accepted by Fastify to set up JSON Schema Validation to
 validate the input, and JSON Schema Serialization to optimize the output.
 
@@ -59,7 +59,7 @@ With `fluent-json-schema` you can manipulate your schemas more easily and
 programmatically and then reuse them thanks to the `addSchema()` method. You can
 refer to the schema in two different manners that are detailed in the
 [Validation and
-Serialization](./Validation-and-Serialization.md#adding-a-shared-schema)
+Serialization](../Reference/Validation-and-Serialization.md#adding-a-shared-schema)
 documentation.
 
 Here are some usage examples:

package/docs/Guides/Serverless.md

@@ -64,7 +64,7 @@ if (require.main === module) {
 
 When executed in your lambda function we do not need to listen to a specific
 port, so we just export the wrapper function `init` in this case. The
-[`lambda.js`](https://www.fastify.io/docs/latest/Serverless/#lambda-js) file
+[`lambda.js`](#lambdajs) file
 will use this export.
 
 When you execute your Fastify application like always, i.e. `node app.js` *(the
@@ -93,7 +93,7 @@ exports.handler = proxy;
 We just require
 [aws-lambda-fastify](https://github.com/fastify/aws-lambda-fastify) (make sure
 you install the dependency `npm i --save aws-lambda-fastify`) and our
-[`app.js`](https://www.fastify.io/docs/latest/Serverless/#app-js) file and call
+[`app.js`](#appjs) file and call
 the exported `awsLambdaFastify` function with the `app` as the only parameter.
 The resulting `proxy` function has the correct signature to be used as a lambda
 `handler` function. This way all the incoming events (API Gateway requests) are
@@ -111,7 +111,7 @@ found
 ### Considerations
 
 - API Gateway does not support streams yet, so you are not able to handle
-  [streams](https://www.fastify.io/docs/latest/Reply/#streams).
+  [streams](../Reference/Reply.md#streams).
 - API Gateway has a timeout of 29 seconds, so it is important to provide a reply
   during this time.
 

package/docs/Guides/Style-Guide.md

@@ -70,12 +70,12 @@ markdown.
 **Example**
 
 ```
-To learn more about hooks, see [Fastify hooks](https://www.fastify.io/docs/latest/Hooks).
+To learn more about hooks, see [Fastify hooks](https://www.fastify.io/docs/latest/Reference/Hooks/).
 ```
 
 Result:
 >To learn more about hooks, see [Fastify
->hooks](https://www.fastify.io/docs/latest/Hooks/).
+>hooks](https://www.fastify.io/docs/latest/Reference/Hooks/).
 
 
 

package/docs/Reference/ContentTypeParser.md

@@ -112,7 +112,7 @@ existing content type parsers. In the example below we achieve exactly the same
 as in the example above except that we do not need to specify each content type
 to delete. Just like `removeContentTypeParser`, this API supports encapsulation.
 The API is especially useful if you want to register a [catch-all content type
-parser](#Catch-All) that should be executed for every content type and the
+parser](#catch-all) that should be executed for every content type and the
 built-in parsers should be ignored as well.
 
 ```js

package/docs/Reference/Decorators.md

@@ -72,7 +72,7 @@ topic.
 #### `decorate(name, value, [dependencies])`
 <a id="decorate"></a>
 
-This method is used to customize the Fastify [server](./Reference/Server.md)
+This method is used to customize the Fastify [server](./Server.md)
 instance.
 
 For example, to attach a new method to the server instance:
@@ -100,8 +100,8 @@ fastify.utility()
 console.log(fastify.conf.db)
 ```
 
-The decorated [Fastify server](./Reference/Server.md) is bound to `this` in
-route [route](Routes.md) handlers:
+The decorated [Fastify server](./Server.md) is bound to `this` in
+route [route](./Routes.md) handlers:
 
 ```js
 fastify.decorate('db', new DbConnection())

package/docs/Reference/Errors.md

@@ -96,7 +96,7 @@ The parser for this content type was already registered.
 The request body is larger than the provided limit.
 
 This setting can be defined in the Fastify server instance:
-[`bodyLimit`](./Server.md#bodyLimit)
+[`bodyLimit`](./Server.md#bodylimit)
 
 #### FST_ERR_CTP_EMPTY_TYPE
 <a id="FST_ERR_CTP_EMPTY_TYPE"></a>

package/docs/Reference/Hooks.md

@@ -397,12 +397,20 @@ Triggered when `fastify.close()` is invoked to stop the server. It is useful
 when [plugins](./Plugins.md) need a "shutdown" event, for example, to close an
 open connection to a database.
 
-The first argument is the Fastify instance, the second one the `done` callback.
+The hook function takes the Fastify instance as a first argument, 
+and a `done` callback for synchronous hook functions.
 ```js
+// callback style
 fastify.addHook('onClose', (instance, done) => {
   // Some code
   done()
 })
+
+// or async/await style
+fastify.addHook('onClose', async (instance) => {
+  // Some async code
+  await closeDatabaseConnections()
+})
 ```
 
 ### onRoute

package/docs/Reference/Index.md

@@ -44,7 +44,7 @@ This table of contents is in alphabetical order.
   standard set of errors Fastify generates.
 + [Hooks](./Hooks.md): Details the API by which Fastify plugins can inject
   themselves into Fastify's handling of the request lifecycle.
-+ [HTTP2](/./HTTP2.md): Details Fastify's HTTP2 support.
++ [HTTP2](./HTTP2.md): Details Fastify's HTTP2 support.
 + [Lifecycle](./Lifecycle.md): Explains the Fastify request lifecycle and
   illustrates where [Hooks](./Hooks.md) are available for integrating with it.
 + [Logging](./Logging.md): Details Fastify's included logging and how to

package/docs/Reference/Plugins.md

@@ -12,7 +12,7 @@ feature allows us to achieve plugin *encapsulation* and *inheritance*, in this
 way we create a *direct acyclic graph* (DAG) and we will not have issues caused
 by cross dependencies.
 
-You already see in the [getting started](../Guides/Getting-Started.md#register)
+You already see in the [getting started](../Guides/Getting-Started.md#your-first-plugin)
 section how using this API is pretty straightforward.
 ```
 fastify.register(plugin, [options])
@@ -30,7 +30,7 @@ Fastify specific options is:
 
 + [`logLevel`](./Routes.md#custom-log-level)
 + [`logSerializers`](./Routes.md#custom-log-serializer)
-+ [`prefix`](#route-prefixing-options)
++ [`prefix`](#route-prefixing-option)
 
 **Note: Those options will be ignored when used with fastify-plugin**
 

package/docs/Reference/Reply.md

@@ -67,7 +67,7 @@ object that exposes the following functions and properties:
   from Node core.
 - `.log` - The logger instance of the incoming request.
 - `.request` - The incoming request.
-- `.context` - Access the [Request's context](./Request.md#Request) property.
+- `.context` - Access the [Request's context](./Request.md) property.
 
 ```js
 fastify.get('/', options, function (request, reply) {
@@ -510,7 +510,7 @@ fastify.setNotFoundHandler(function (request, reply) {
 <a id="payload-type"></a>
 
 The type of the sent payload (after serialization and going through any
-[`onSend` hooks](./Hooks.md#the-onsend-hook)) must be one of the following
+[`onSend` hooks](./Hooks.md#onsend)) must be one of the following
 types, otherwise, an error will be thrown:
 
 - `string`

package/docs/Reference/Routes.md

@@ -82,7 +82,7 @@ fastify.route(options)
   called. Note: using an arrow function will break the binding of `this`.
 * `errorHandler(error, request, reply)`: a custom error handler for the scope of
   the request. Overrides the default error global handler, and anything set by
-  [`setErrorHandler`](./Server.md#setErrorHandler), for requests to the route.
+  [`setErrorHandler`](./Server.md#seterrorhandler), for requests to the route.
   To access the default handler, you can access `instance.errorHandler`. Note
   that this will point to fastify's default `errorHandler` only if a plugin
   hasn't overridden it already.
@@ -107,7 +107,7 @@ fastify.route(options)
 * `logSerializers`: set serializers to log for this route.
 * `config`: object used to store custom configuration.
 * `version`: a [semver](https://semver.org/) compatible string that defined the
-  version of the endpoint. [Example](#version).
+  version of the endpoint. [Example](#version-constraints).
 * `prefixTrailingSlash`: string used to determine how to handle passing `/` as a
   route with a prefix.
   * `both` (default): Will register both `/prefix` and `/prefix/`.
@@ -437,7 +437,7 @@ the global Fastify Logger, accessible with `fastify.log`*
 
 In some context, you may need to log a large object but it could be a waste of
 resources for some routes. In this case, you can define some
-[`serializer`](https://github.com/pinojs/pino/blob/master/docs/api.md#bindingsserializers-object)
+[`serializer`](https://github.com/pinojs/pino/blob/master/docs/api.md#serializers-object)
 and attach them in the right context!
 
 ```js

package/docs/Reference/Server.md

@@ -1075,7 +1075,7 @@ used by plugins.
 #### inject
 <a id="inject"></a>
 
-Fake HTTP injection (for testing purposes) [here](../Guides/Testing.md#inject).
+Fake HTTP injection (for testing purposes) [here](../Guides/Testing.md#benefits-of-using-fastifyinject).
 
 #### addSchema
 <a id="add-schema"></a>
@@ -1291,8 +1291,8 @@ handler so requests will go through the full [Fastify
 lifecycle](./Lifecycle.md#lifecycle).
 
 You can also register
-[`preValidation`](https://www.fastify.io/docs/latest/Hooks/#route-hooks) and
-[`preHandler`](https://www.fastify.io/docs/latest/Hooks/#route-hooks) hooks for
+[`preValidation`](./Hooks.md#route-hooks) and
+[`preHandler`](./Hooks.md#route-hooks) hooks for
 the 404 handler.
 
 _Note: The `preValidation` hook registered using this method will run for a
@@ -1402,7 +1402,7 @@ fastify.ready(() => {
 the `route.store` object for each displayed route. This can be an `array` of
 keys (e.g. `['onRequest', Symbol('key')]`), or `true` to display all properties.
 A shorthand option, `fastify.printRoutes({ includeHooks: true })` will include
-all [hooks](https://www.fastify.io/docs/latest/Hooks/).
+all [hooks](./Hooks.md).
 
 ```js
   console.log(fastify.printRoutes({ includeHooks: true, includeMeta: ['metaProperty'] }))

package/docs/Reference/Validation-and-Serialization.md

@@ -713,7 +713,7 @@ fastify.setSchemaErrorFormatter(function (errors, dataVar) {
 ```
 
 You can also use
-[setErrorHandler](https://www.fastify.io/docs/latest/Server/#seterrorhandler) to
+[setErrorHandler](./Server.md#seterrorhandler) to
 define a custom response for validation errors such as
 
 ```js

package/docs/index.md

@@ -5,7 +5,7 @@ The documentation for Fastify is split into two categories:
 - [Reference documentation](./Reference/Index.md)
 - [Guides](./Guides/Index.md)
 
-The reference documenation utilizes a very formal style in an effort to document
+The reference documentation utilizes a very formal style in an effort to document
 Fastify's API and implementation details thoroughly for the developer who needs
 such. The guides category utilizes an informal, educational, style as a means to
 introduce newcomers to core, and advanced, Fastify concepts.

package/fastify.js

@@ -1,6 +1,6 @@
 'use strict'
 
-const VERSION = '3.25.0'
+const VERSION = '3.25.1'
 
 const Avvio = require('avvio')
 const http = require('http')

package/lib/decorate.js

@@ -68,7 +68,7 @@ function decorateFastify (name, fn, dependencies) {
 
 function checkExistence (instance, name) {
   if (name) {
-    return name in instance || hasKey(instance, name)
+    return name in instance || (instance.prototype && name in instance.prototype) || hasKey(instance, name)
   }
 
   return instance in this

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastify",
-  "version": "3.25.0",
+  "version": "3.25.1",
   "description": "Fast and low overhead web framework, for Node.js",
   "main": "fastify.js",
   "type": "commonjs",
@@ -184,7 +184,7 @@
     "fast-json-stringify": "^2.5.2",
     "fastify-error": "^0.3.0",
     "fastify-warning": "^0.2.0",
-    "find-my-way": "^4.1.0",
+    "find-my-way": "^4.5.0",
     "flatstr": "^1.0.12",
     "light-my-request": "^4.2.0",
     "pino": "^6.13.0",

package/test/decorator.test.js

@@ -1029,13 +1029,27 @@ test('decorateRequest with dependencies', (t) => {
   t.plan(2)
   const app = Fastify()
 
-  const decorator1 = {
-    config: {},
-    app: {}
-  }
-  const decorator2 = {
-    stuff: {}
+  const decorator1 = 'bar'
+  const decorator2 = 'foo'
+
+  app.decorate('decorator1', decorator1)
+  app.decorateRequest('decorator1', decorator1)
+
+  if (
+    app.hasDecorator('decorator1') &&
+    app.hasRequestDecorator('decorator1')
+  ) {
+    t.doesNotThrow(() => app.decorateRequest('decorator2', decorator2, ['decorator1']))
+    t.ok(app.hasRequestDecorator('decorator2'))
   }
+})
+
+test('decorateRequest with dependencies (functions)', (t) => {
+  t.plan(2)
+  const app = Fastify()
+
+  const decorator1 = () => 'bar'
+  const decorator2 = () => 'foo'
 
   app.decorate('decorator1', decorator1)
   app.decorateRequest('decorator1', decorator1)

package/test/http2/constraint.test.js

@@ -0,0 +1,91 @@
+'use strict'
+
+const t = require('tap')
+const test = t.test
+const Fastify = require('../..')
+const h2url = require('h2url')
+
+const alpha = { res: 'alpha' }
+const beta = { res: 'beta' }
+
+const { buildCertificate } = require('../build-certificate')
+t.before(buildCertificate)
+
+test('A route supports host constraints under http2 protocol and secure connection', (t) => {
+  t.plan(5)
+
+  let fastify
+  try {
+    fastify = Fastify({
+      http2: true,
+      https: {
+        key: global.context.key,
+        cert: global.context.cert
+      }
+    })
+    t.pass('Key/cert successfully loaded')
+  } catch (e) {
+    t.fail('Key/cert loading failed', e)
+  }
+
+  const constrain = 'fastify.io'
+
+  fastify.route({
+    method: 'GET',
+    url: '/',
+    handler: function (_, reply) {
+      reply.code(200).send(alpha)
+    }
+  })
+  fastify.route({
+    method: 'GET',
+    url: '/beta',
+    constraints: { host: constrain },
+    handler: function (_, reply) {
+      reply.code(200).send(beta)
+    }
+  })
+
+  fastify.listen(0, err => {
+    t.error(err)
+    fastify.server.unref()
+
+    t.test('https get request - no constrain', async (t) => {
+      t.plan(3)
+
+      const url = `https://localhost:${fastify.server.address().port}`
+      const res = await h2url.concat({ url })
+
+      t.equal(res.headers[':status'], 200)
+      t.equal(res.headers['content-length'], '' + JSON.stringify(alpha).length)
+      t.same(JSON.parse(res.body), alpha)
+    })
+
+    t.test('https get request - constrain', async (t) => {
+      t.plan(3)
+
+      const url = `https://localhost:${fastify.server.address().port}/beta`
+      const res = await h2url.concat({
+        url,
+        headers: {
+          ':authority': constrain
+        }
+      })
+
+      t.equal(res.headers[':status'], 200)
+      t.equal(res.headers['content-length'], '' + JSON.stringify(beta).length)
+      t.same(JSON.parse(res.body), beta)
+    })
+
+    t.test('https get request - constrain - not found', async (t) => {
+      t.plan(1)
+
+      const url = `https://localhost:${fastify.server.address().port}/beta`
+      const res = await h2url.concat({
+        url
+      })
+
+      t.equal(res.headers[':status'], 404)
+    })
+  })
+})

package/types/hooks.d.ts

@@ -395,5 +395,16 @@ export interface onCloseHookHandler<
   (
     instance: FastifyInstance<RawServer, RawRequest, RawReply, Logger>,
     done: HookHandlerDoneFunction
-  ): Promise<unknown> | void;
+  ): void;
+}
+
+export interface onCloseAsyncHookHandler<
+  RawServer extends RawServerBase = RawServerDefault,
+  RawRequest extends RawRequestDefaultExpression<RawServer> = RawRequestDefaultExpression<RawServer>,
+  RawReply extends RawReplyDefaultExpression<RawServer> = RawReplyDefaultExpression<RawServer>,
+  Logger = FastifyLoggerInstance
+> {
+  (
+    instance: FastifyInstance<RawServer, RawRequest, RawReply, Logger>
+  ): Promise<unknown>;
 }

package/types/instance.d.ts

@@ -4,7 +4,7 @@ import { FastifySchema, FastifySchemaCompiler, FastifySchemaValidationError, Fas
 import { RawServerBase, RawRequestDefaultExpression, RawServerDefault, RawReplyDefaultExpression, ContextConfigDefault } from './utils'
 import { FastifyLoggerInstance } from './logger'
 import { FastifyRegister } from './register'
-import { onRequestHookHandler, preParsingHookHandler, onSendHookHandler, preValidationHookHandler, preHandlerHookHandler, preSerializationHookHandler, onResponseHookHandler, onErrorHookHandler, onRouteHookHandler, onRegisterHookHandler, onCloseHookHandler, onReadyHookHandler, onTimeoutHookHandler, preParsingAsyncHookHandler, preValidationAsyncHookHandler, preHandlerAsyncHookHandler, preSerializationAsyncHookHandler, onSendAsyncHookHandler, onResponseAsyncHookHandler, onTimeoutAsyncHookHandler, onErrorAsyncHookHandler, onReadyAsyncHookHandler, onRequestAsyncHookHandler } from './hooks'
+import { onRequestHookHandler, preParsingHookHandler, onSendHookHandler, preValidationHookHandler, preHandlerHookHandler, preSerializationHookHandler, onResponseHookHandler, onErrorHookHandler, onRouteHookHandler, onRegisterHookHandler, onCloseHookHandler, onCloseAsyncHookHandler, onReadyHookHandler, onTimeoutHookHandler, preParsingAsyncHookHandler, preValidationAsyncHookHandler, preHandlerAsyncHookHandler, preSerializationAsyncHookHandler, onSendAsyncHookHandler, onResponseAsyncHookHandler, onTimeoutAsyncHookHandler, onErrorAsyncHookHandler, onReadyAsyncHookHandler, onRequestAsyncHookHandler } from './hooks'
 import { FastifyRequest } from './request'
 import { FastifyReply } from './reply'
 import { FastifyError } from 'fastify-error'
@@ -333,6 +333,11 @@ export interface FastifyInstance<
     hook: onCloseHookHandler<RawServer, RawRequest, RawReply, Logger>
   ): FastifyInstance<RawServer, RawRequest, RawReply, Logger>;
 
+  addHook(
+    name: 'onClose',
+    hook: onCloseAsyncHookHandler<RawServer, RawRequest, RawReply, Logger>
+  ): FastifyInstance<RawServer, RawRequest, RawReply, Logger>;
+
   /**
    * Set the 404 handler
    */