fastify 6.0.0-alpha.4 → 6.0.0-alpha.6

package/README.md

@@ -319,6 +319,7 @@ listed in alphabetical order.
   <https://x.com/manueomm>, <https://www.npmjs.com/~eomm>
 * [__James Sumners__](https://github.com/jsumners),
   <https://x.com/jsumners79>, <https://www.npmjs.com/~jsumners>
+* [__Antonio Tripodi__](https://github.com/Tony133), <https://www.npmjs.com/~tony133>
 
 ### Fastify Plugins team
 * [__Harry Brundage__](https://github.com/airhorns/),

package/SECURITY.md

@@ -30,6 +30,12 @@ The following are **not** considered vulnerabilities in Fastify:
 
 - **Application code vulnerabilities**: XSS, SQL injection, or other flaws in
 user-written route handlers, hooks, or plugins
+- **Unvalidated template selection**: Passing untrusted input directly as a
+template name or path (for example, `reply.view(request.query.page)`) without
+validating or allowlisting it is an application-level vulnerability. A template
+root used to resolve filenames is not a security sandbox unless the API
+explicitly guarantees path containment. Bypasses of documented containment
+or built-in path validation remain in scope.
 - **Malicious application code**: Issues caused by intentionally malicious
 plugins or handlers (application code is trusted)
 - **Validation schema issues**: Weak or incorrect schemas provided by developers

package/build/build-validation.js

@@ -40,6 +40,7 @@ const defaultInitOptions = {
   routerOptions: {
     allowUnsafeRegex: false,
     caseSensitive: true,
+    compile: false,
     ignoreTrailingSlash: false,
     ignoreDuplicateSlashes: false,
     maxParamLength: 100,
@@ -102,6 +103,7 @@ const schema = {
       properties: {
         allowUnsafeRegex: { type: 'boolean', default: defaultInitOptions.routerOptions.allowUnsafeRegex },
         caseSensitive: { type: 'boolean', default: defaultInitOptions.routerOptions.caseSensitive },
+        compile: { type: 'boolean', default: defaultInitOptions.routerOptions.compile },
         constraints: {
           type: 'object',
           additionalProperties: {

package/docs/Guides/Ecosystem.md

@@ -172,8 +172,6 @@ section.
   A plugin to help with caching API responses using AWS DynamoDB.
 - [`@clerk/fastify`](https://github.com/clerk/javascript/tree/main/packages/fastify)
   Add authentication and user management to your Fastify application with Clerk.
-- [`@coobaha/typed-fastify`](https://github.com/Coobaha/typed-fastify) Strongly
-  typed routes with a runtime validation using JSON schema generated from types.
 - [`@dnlup/fastify-doc`](https://github.com/dnlup/fastify-doc) A plugin for
   sampling process metrics.
 - [`@dnlup/fastify-traps`](https://github.com/dnlup/fastify-traps) A plugin to
@@ -192,6 +190,10 @@ section.
 - [`@gquittet/graceful-server`](https://github.com/gquittet/graceful-server)
   Tiny (~5k), Fast, KISS, and dependency-free Node.js library to make your
   Fastify API graceful.
+- [`@guardcore/fastify`](https://github.com/Guard-Core/guard-core-ts/tree/master/packages/fastify)
+  Application-layer security plugin: request attack detection, IP and country
+  controls, bans, behavior rules, honeypots, security headers and per-route
+  decorators.
 - [`@h4ad/serverless-adapter`](https://github.com/H4ad/serverless-adapter)
   Run REST APIs and other web applications using your existing Node.js
   application framework (Express, Koa, Hapi and Fastify), on top of AWS Lambda,
@@ -211,6 +213,9 @@ section.
 - [`@matths/fastify-svelte-view`](https://github.com/matths/fastify-svelte-view)
   A Fastify plugin for rendering Svelte components with support for SSR
   (Server-Side Rendering), CSR (Client-Side Rendering), and SSR with hydration.
+- [`@melroy89/fastify-mariadb`](https://github.com/melroy89/fastify-mariadb)
+  Fastify MariaDB connection plugin that shares a connection pool across the
+  server.
 - [`@mgcrea/fastify-graceful-exit`](https://github.com/mgcrea/fastify-graceful-exit)
   A plugin to close the server gracefully
 - [`@mgcrea/fastify-request-logger`](https://github.com/mgcrea/fastify-request-logger)
@@ -240,6 +245,9 @@ section.
   method with a body).
 - [`@trubavuong/fastify-seaweedfs`](https://github.com/trubavuong/fastify-seaweedfs)
   SeaweedFS for Fastify
+- [`@validex/fastify`](https://github.com/chiptoma/validex/tree/main/packages/fastify)
+  Zod 4 validation plugin with 25 typed rules, structured error codes, and
+  `request.validate()` decorator.
 - [`@yeliex/fastify-problem-details`](https://github.com/yeliex/fastify-problem-details)
   RFC 9457 Problem Details implementation for Fastify, with typed HTTP errors.
 - [`@zrosenbauer/fastify-prisma`](https://github.com/zrosenbauer/fastify-prisma)
@@ -249,8 +257,6 @@ section.
   logging and monitoring tool.
 - [`arecibo`](https://github.com/ducktors/arecibo) Fastify ping responder for
   Kubernetes Liveness and Readiness Probes.
-- [`aws-xray-sdk-fastify`](https://github.com/aws/aws-xray-sdk-node/tree/master/sdk_contrib/fastify)
-  A Fastify plugin to log requests and subsegments through AWSXray.
 - [`cls-rtracer`](https://github.com/puzpuzpuz/cls-rtracer) Fastify middleware
   for CLS-based request ID generation. An out-of-the-box solution for adding
   request IDs into your logs.
@@ -274,14 +280,8 @@ section.
 - [`fastify-amqp-async`](https://github.com/kffl/fastify-amqp-async) Fastify
   AMQP plugin with a Promise-based API provided by
   [`amqplib-as-promised`](https://github.com/twawszczak/amqplib-as-promised).
-- [`fastify-angular-universal`](https://github.com/exequiel09/fastify-angular-universal)
-  Angular server-side rendering support using
-  [`@angular/platform-server`](https://github.com/angular/angular/tree/master/packages/platform-server)
-  for Fastify
 - [`fastify-api-key`](https://github.com/arkerone/fastify-api-key) Fastify
   plugin to authenticate HTTP requests based on API key and signature
-- [`fastify-appwrite`](https://github.com/maniecodes/fastify-appwrite) Fastify
-  Plugin for interacting with Appwrite server.
 - [`fastify-arktype`](https://github.com/BlairCurrey/fastify-arktype) ArkType
   type provider with validation and @fastify/swagger OpenAPI generation.
 - [`fastify-asyncforge`](https://github.com/mcollina/fastify-asyncforge) Plugin
@@ -298,15 +298,9 @@ section.
   Auth0 verification plugin for Fastify, internally uses
   [fastify-jwt](https://www.npmjs.com/package/fastify-jwt) and
   [jsonwebtoken](https://www.npmjs.com/package/jsonwebtoken).
-- [`fastify-autoroutes`](https://github.com/GiovanniCardamone/fastify-autoroutes)
-  Plugin to scan and load routes based on filesystem path from a custom
-  directory.
 - [`fastify-aws-sns`](https://github.com/gzileni/fastify-aws-sns) Fastify plugin
   for AWS Simple Notification Service (AWS SNS) that coordinates and manages
   the delivery or sending of messages to subscribing endpoints or clients.
-- [`fastify-aws-timestream`](https://github.com/gzileni/fastify-aws-timestream)
-  Fastify plugin for managing databases, tables, and querying and creating
-  scheduled queries with AWS Timestream.
 - [`fastify-axios`](https://github.com/davidedantonio/fastify-axios) Plugin to
   send HTTP requests via [axios](https://github.com/axios/axios).
 - [`fastify-babel`](https://github.com/cfware/fastify-babel) Fastify plugin for
@@ -341,9 +335,6 @@ section.
   Fastify plugin for CloudFlare Turnstile.
 - [`fastify-cloudinary`](https://github.com/Vanilla-IceCream/fastify-cloudinary)
   Plugin to share a common Cloudinary connection across Fastify.
-- [`fastify-cockroachdb`](https://github.com/alex-ppg/fastify-cockroachdb)
-  Fastify plugin to connect to a CockroachDB PostgreSQL instance via the
-  Sequelize ORM.
 - [`fastify-constraints`](https://github.com/nearform/fastify-constraints)
   Fastify plugin to add constraints to multiple routes
 - [`fastify-couchdb`](https://github.com/nigelhanlon/fastify-couchdb) Fastify
@@ -361,10 +352,6 @@ section.
 - [`fastify-disablecache`](https://github.com/Fdawgs/fastify-disablecache)
   Fastify plugin to disable client-side caching, inspired by
   [nocache](https://github.com/helmetjs/nocache).
-- [`fastify-dynamodb`](https://github.com/matrus2/fastify-dynamodb) AWS DynamoDB
-  plugin for Fastify. It exposes
-  [AWS.DynamoDB.DocumentClient()](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html)
-  object.
 - [`fastify-dynareg`](https://github.com/greguz/fastify-dynareg) Dynamic plugin
   register for Fastify.
 - [`fastify-envalid`](https://github.com/alemagio/fastify-envalid) Fastify
@@ -372,9 +359,6 @@ section.
   project.
 - [`fastify-error-page`](https://github.com/hemerajs/fastify-error-page) Fastify
   plugin to print errors in structured HTML to the browser.
-- [`fastify-esso`](https://github.com/patrickpissurno/fastify-esso) The easiest
-  authentication plugin for Fastify, with built-in support for Single sign-on
-  (and great documentation).
 - [`fastify-event-bus`](https://github.com/Shiva127/fastify-event-bus) Event bus
   support for Fastify. Built upon [js-event-bus](https://github.com/bcerati/js-event-bus).
 - [`fastify-evervault`](https://github.com/Briscoooe/fastify-evervault/) Fastify
@@ -457,14 +441,10 @@ section.
   plugin to serialize JSON responses into XML.
 - [`fastify-jwt-authz`](https://github.com/Ethan-Arrowood/fastify-jwt-authz) JWT
   user scope verifier.
-- [`fastify-jwt-webapp`](https://github.com/charlesread/fastify-jwt-webapp) JWT
-  authentication for Fastify-based web apps.
 - [`fastify-kafkajs`](https://github.com/kffl/fastify-kafkajs) Fastify plugin
   that adds support for KafkaJS - a modern Apache Kafka client library.
 - [`fastify-keycloak-adapter`](https://github.com/yubinTW/fastify-keycloak-adapter)
   A keycloak adapter for a Fastify app.
-- [`fastify-koa`](https://github.com/rozzilla/fastify-koa) Convert Koa
-middlewares into Fastify plugins
 - [`fastify-kubernetes`](https://github.com/greguz/fastify-kubernetes) Fastify
   Kubernetes client plugin.
 - [`fastify-kysely`](https://github.com/alenap93/fastify-kysely) Fastify
@@ -504,6 +484,8 @@ middlewares into Fastify plugins
 - [`fastify-mongoose-driver`](https://github.com/alex-ppg/fastify-mongoose)
   Fastify Mongoose plugin that connects to a MongoDB via the Mongoose plugin
   with support for Models.
+- [`fastify-mosquitto-dynsec`](https://github.com/LuizTakeda/fastify-mosquitto-dynsec)
+  Fastify plugin to manage Mosquitto Dynamic Security over MQTT.
 - [`fastify-mqtt`](https://github.com/love-lena/fastify-mqtt) Plugin to share
   [mqtt](https://www.npmjs.com/package/mqtt) client across Fastify.
 - [`fastify-msgpack`](https://github.com/kenriortega/fastify-msgpack) Fastify
@@ -546,8 +528,6 @@ middlewares into Fastify plugins
   [`oracledb`](https://github.com/oracle/node-oracledb) connection pool to a
   Fastify server instance.
 - [`fastify-orama`](https://github.com/mateonunez/fastify-orama)
-- [`fastify-osm`](https://github.com/gzileni/fastify-osm) Fastify
-  OSM plugin to run overpass queries by OpenStreetMap.
 - [`fastify-override`](https://github.com/matthyk/fastify-override)
   Fastify plugin to override decorators, plugins and hooks for testing purposes
 - [`fastify-param-schema-validation`](https://github.com/Player1205/fastify-param-schema-validation)
@@ -568,8 +548,6 @@ middlewares into Fastify plugins
 - [`fastify-postgraphile`](https://github.com/alemagio/fastify-postgraphile)
   Plugin to integrate [PostGraphile](https://postgraphile.org/postgraphile/4/) in
   a Fastify project.
-- [`fastify-postgres-dot-js`](https://github.com/kylerush/fastify-postgresjs) Fastify
-  PostgreSQL connection plugin that uses [Postgres.js](https://github.com/porsager/postgres).
 - [`fastify-prettier`](https://github.com/hsynlms/fastify-prettier) A Fastify
   plugin that uses [prettier](https://github.com/prettier/prettier) under the
   hood to beautify outgoing responses and/or other things in the Fastify server.
@@ -617,8 +595,6 @@ middlewares into Fastify plugins
   using name and parameters.
 - [`fastify-rob-config`](https://github.com/jeromemacias/fastify-rob-config)
   Fastify Rob-Config integration.
-- [`fastify-route-group`](https://github.com/TakNePoidet/fastify-route-group)
-  Convenient grouping and inheritance of routes.
 - [`fastify-route-preset`](https://github.com/inyourtime/fastify-route-preset)
   A Fastify plugin that enables you to create route configurations that can be
   applied to multiple routes.
@@ -626,9 +602,6 @@ middlewares into Fastify plugins
   Ensure the existence of defined S3 buckets on the application startup.
 - [`fastify-schema-constraint`](https://github.com/Eomm/fastify-schema-constraint)
   Choose the JSON schema to use based on request parameters.
-- [`fastify-schema-to-typescript`](https://github.com/thomasthiebaud/fastify-schema-to-typescript)
-  Generate typescript types based on your JSON/YAML validation schemas so they
-  are always in sync.
 - [`fastify-sentry`](https://github.com/alex-ppg/fastify-sentry) Fastify plugin
   to add the Sentry SDK error handler to requests.
 - [`fastify-sequelize`](https://github.com/lyquocnam/fastify-sequelize) Fastify
@@ -639,8 +612,6 @@ middlewares into Fastify plugins
   `fastify-caching`.
 - [`fastify-ses-mailer`](https://github.com/KaranHotwani/fastify-ses-mailer) A
   Fastify plugin for sending emails via AWS SES using AWS SDK v3.
-- [`fastify-shared-schema`](https://github.com/Adibla/fastify-shared-schema) Plugin
-  for sharing schemas between different routes.
 - [`fastify-slow-down`](https://github.com/nearform/fastify-slow-down) A plugin
   to delay the response from the server.
 - [`fastify-split-validator`](https://github.com/MetCoder95/fastify-split-validator)
@@ -665,10 +636,6 @@ middlewares into Fastify plugins
   localhost-only, TLS certificate.
 - [`fastify-totp`](https://github.com/beliven-it/fastify-totp) A plugin to handle
   TOTP (e.g. for 2FA).
-- [`fastify-type-provider-effect-schema`](https://github.com/daotl/fastify-type-provider-effect-schema)
-  Fastify
-  [type provider](https://fastify.dev/docs/latest/Reference/Type-Providers/)
-  for [@effect/schema](https://github.com/Effect-TS/effect).
 - [`fastify-type-provider-zod`](https://github.com/turkerdev/fastify-type-provider-zod)
   Fastify
   [type provider](https://fastify.dev/docs/latest/Reference/Type-Providers/)
@@ -679,10 +646,6 @@ middlewares into Fastify plugins
   request's `user-agent` header.
 - [`fastify-uws`](https://github.com/geut/fastify-uws) A Fastify plugin to
   use the web server [uWebSockets.js](https://github.com/uNetworking/uWebSockets.js).
-- [`fastify-vhost`](https://github.com/patrickpissurno/fastify-vhost) Proxy
-  subdomain HTTP requests to another server (useful if you want to point
-  multiple subdomains to the same IP address, while running different servers on
-  the same machine).
 - [`fastify-vue-plugin`](https://github.com/TheNoim/fastify-vue)
   [Nuxt.js](https://nuxt.com) plugin for Fastify. Control the routes nuxt
   should use.
@@ -725,10 +688,6 @@ middlewares into Fastify plugins
 
 #### [Community Tools](#community-tools)
 
-- [`fast-maker`](https://github.com/imjuni/fast-maker) route configuration
-  generator by directory structure.
-- [`fastify-flux`](https://github.com/Jnig/fastify-flux) Tool for building
-  Fastify APIs using decorators and convert Typescript interface to JSON Schema.
 - [`fastify-intlayer`](https://intlayer.org/doc/environment/fastify)
   i18n solution for error handling, email template
 - [`jeasx`](https://www.jeasx.dev)

package/docs/Guides/Migration-Guide-V5.md

@@ -405,7 +405,7 @@ fastify.get('/example/:file(^\\d+).png', function (request, reply) { })
 console.log(fastify.hasRoute({
   method: 'GET',
   url: '/example/12345.png'
-)); // true
+})); // true
 ```
 
 ```js
@@ -416,7 +416,7 @@ fastify.get('/example/:file(^\\d+).png', function (request, reply) { })
 console.log(fastify.hasRoute({
   method: 'GET',
   url: '/example/:file(^\\d+).png'
-)); // true
+})); // true
 ```
 
 ### Removal of some non-standard HTTP methods

package/docs/Guides/Serverless.md

@@ -127,8 +127,6 @@ on Fastify to find out how to integrate.
 [Genezio](https://genezio.com/) is a platform designed to simplify the deployment
 of serverless applications to the cloud.
 
-[Genezio has a dedicated guide for deploying a Fastify application.](https://deployapps.dev/docs/frameworks/fastify/)
-
 ## Google Cloud Functions
 
 ### Creation of Fastify instance
@@ -277,20 +275,21 @@ fastify.addHook('onResponse', async (request, reply) => {
 `request.routeOptions.url` is the route pattern, so `/users/123` and
 `/users/456` are grouped under `/users/:id`. With Fastify's logger enabled, the
 fields are emitted as structured log fields, as described in the [Cloud
-Logging structured logging documentation](https://cloud.google.com/logging/docs/structured-logging)
-and the [Cloud Functions logging guide](https://cloud.google.com/functions/docs/monitoring/logging).
+Logging structured logging documentation](https://docs.cloud.google.com/logging/docs/structured-logging)
+and the [Cloud Run logging guide](https://docs.cloud.google.com/run/docs/logging).
 In Cloud Logging, create a [log-based
-metric](https://cloud.google.com/logging/docs/logs-based-metrics) or filter on
-`jsonPayload.route` to get per-route request counts, latency, and error rates.
+metric](https://docs.cloud.google.com/logging/docs/logs-based-metrics)
+or filter on `jsonPayload.route` to get per-route request counts, latency, and
+error rates.
 
 The same hook works when deploying through Firebase Functions with `onRequest`.
 
 ### References
 - [Google Cloud Functions - Node.js Quickstart
-  ](https://cloud.google.com/run/docs/quickstarts/functions/deploy-functions-gcloud)
-- [Cloud Logging - Structured Logging](https://cloud.google.com/logging/docs/structured-logging)
-- [Cloud Logging - Log-based Metrics](https://cloud.google.com/logging/docs/logs-based-metrics)
-- [Cloud Functions - Logging](https://cloud.google.com/functions/docs/monitoring/logging)
+  ](https://docs.cloud.google.com/run/docs/quickstarts/functions/deploy-functions-gcloud)
+- [Cloud Logging - Structured Logging](https://docs.cloud.google.com/logging/docs/structured-logging)
+- [Cloud Logging - Log-based Metrics](https://docs.cloud.google.com/logging/docs/logs-based-metrics)
+- [Cloud Run - Logging](https://docs.cloud.google.com/run/docs/logging)
 
 ## Google Firebase Functions
 
@@ -384,6 +383,30 @@ Final step is to export the Fastify app instance to Firebase's own
 exports.app = onRequest(fastifyApp)
 ```
 
+### A note on per-route functions and observability
+
+When a Fastify instance is wrapped with a single `onRequest()` handler, all
+routes are handled through a single Cloud Function entry point (e.g. `app`).
+Fastify still performs internal routing as usual, but from the provider's
+perspective there is only one deployed function. As a result, logs, metrics,
+and analytics in the Cloud Console are grouped under that single function
+rather than being split per route (e.g. `app-api-v1-user`).
+
+This behavior is expected because Fastify acts as a single HTTP server with
+internal routing, while Cloud Functions exposes only function-level
+observability. This is different from architectures where each route is
+deployed as an individual Cloud Function.
+
+If per-function grouping is required, you must export multiple `onRequest()`
+handlers instead of routing everything through a single Fastify instance.
+
+Alternatively, you can keep a single Fastify application and deploy it to
+Cloud Run, where it runs as a long-lived server. In that setup, Fastify's
+built-in logging (request method, URL, and response timing) provides per-route
+observability. On Cloud Functions, similar request-level logs are still
+available, but they are grouped under the single function entry in the
+provider's console.
+
 ### Local test
 
 Install the Firebase tools functions so you can use the CLI:

package/docs/Reference/Errors.md

@@ -94,7 +94,6 @@
     - [FST_ERR_ROUTE_HANDLER_TIMEOUT_OPTION_NOT_INT](#fst_err_route_handler_timeout_option_not_int)
     - [FST_ERR_ROUTE_REWRITE_NOT_STR](#fst_err_route_rewrite_not_str)
     - [FST_ERR_ROUTE_MISSING_CONTENT_TYPE](#fst_err_route_missing_content_type)
-    - [FST_ERR_ROUTE_MISSING_CONTENT](#fst_err_route_missing_content)
     - [FST_ERR_REOPENED_CLOSE_SERVER](#fst_err_reopened_close_server)
     - [FST_ERR_REOPENED_SERVER](#fst_err_reopened_server)
     - [FST_ERR_PLUGIN_VERSION_MISMATCH](#fst_err_plugin_version_mismatch)
@@ -135,6 +134,19 @@ developer is responsible for ensuring errors are handled properly.
 Most errors result from unexpected input data, so it is recommended to
 [validate input data against a JSON schema](./Validation-and-Serialization.md).
 
+Errors that Fastify creates when it rejects an invalid request, such as a
+failed schema validation or a malformed body, do not have a stack trace, as it
+would only point at Fastify internals. These are
+[`FST_ERR_VALIDATION`](#fst_err_validation),
+[`FST_ERR_CTP_BODY_TOO_LARGE`](#fst_err_ctp_body_too_large),
+[`FST_ERR_CTP_INVALID_MEDIA_TYPE`](#fst_err_ctp_invalid_media_type),
+[`FST_ERR_CTP_INVALID_CONTENT_LENGTH`](#fst_err_ctp_invalid_content_length),
+[`FST_ERR_CTP_EMPTY_JSON_BODY`](#fst_err_ctp_empty_json_body),
+[`FST_ERR_CTP_INVALID_JSON_BODY`](#fst_err_ctp_invalid_json_body),
+[`FST_ERR_BAD_URL`](#fst_err_bad_url),
+[`FST_ERR_MAX_PARAM_LENGTH`](#fst_err_max_param_length)
+and [`FST_ERR_ROUTE_MISSING_CONTENT_TYPE`](#fst_err_route_missing_content_type).
+
 #### Catching Uncaught Errors In Fastify
 Fastify tries to catch as many uncaught errors as possible without hindering
 performance. This includes:
@@ -447,7 +459,6 @@ Below is a table with all the error codes used by Fastify.
 | <a id="fst_err_route_handler_timeout_option_not_int">FST_ERR_ROUTE_HANDLER_TIMEOUT_OPTION_NOT_INT</a> | `handlerTimeout` option must be a positive integer. | Use a positive integer for the `handlerTimeout` option. | - |
 | <a id="fst_err_route_rewrite_not_str">FST_ERR_ROUTE_REWRITE_NOT_STR</a> | `rewriteUrl` needs to be of type `string`. | Use a string for the `rewriteUrl`. | [#4554](https://github.com/fastify/fastify/pull/4554) |
 | <a id="fst_err_route_missing_content_type">FST_ERR_ROUTE_MISSING_CONTENT_TYPE</a> | `Content-Type` header is required for the request. | Send request with `Content-Type` header. | [#6832](https://github.com/fastify/fastify/pull/6832) |
-| <a id="fst_err_route_missing_content">FST_ERR_ROUTE_MISSING_CONTENT</a> | Body is required for the request. | Send request with payload. | [#6832](https://github.com/fastify/fastify/pull/6832) |
 | <a id="fst_err_reopened_close_server">FST_ERR_REOPENED_CLOSE_SERVER</a> | Fastify has already been closed and cannot be reopened. | - | [#2415](https://github.com/fastify/fastify/pull/2415) |
 | <a id="fst_err_reopened_server">FST_ERR_REOPENED_SERVER</a> | Fastify is already started. | - | [#2415](https://github.com/fastify/fastify/pull/2415) |
 | <a id="fst_err_plugin_version_mismatch">FST_ERR_PLUGIN_VERSION_MISMATCH</a> | Installed Fastify plugin mismatched expected version. | Use a compatible version of the plugin. | [#2549](https://github.com/fastify/fastify/pull/2549) |

package/docs/Reference/Hooks.md

@@ -476,6 +476,12 @@ arrive.
 
 The hook function takes the Fastify instance as a first argument,
 and a `done` callback for synchronous hook functions.
+
+Alternatively, an object implementing `Symbol.asyncDispose` or
+`Symbol.dispose` can be registered as an `onClose` hook. Fastify invokes
+the appropriate disposal method when closing the server, allowing resources
+to be cleaned up using JavaScript's Explicit Resource Management protocol.
+
 ```js
 // callback style
 fastify.addHook('onClose', (instance, done) => {
@@ -488,6 +494,13 @@ fastify.addHook('onClose', async (instance) => {
   // Some async code
   await closeDatabaseConnections()
 })
+
+// or disposable object style (Explicit Resource Management)
+fastify.addHook('onClose', {
+  async [Symbol.asyncDispose] () {
+    await closeDatabaseConnections()
+  }
+})
 ```
 
 #### Execution order