fastify 5.3.2 → 5.3.3

package/.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+  "workbench.colorCustomizations": {
+    "[GitHub Dark]": {
+      "tab.activeBackground": "#0d0d0d",
+      "tab.activeBorder": "#ffff00"
+    },
+    "activityBar.background": "#7AC6C8",
+    "activityBar.foreground": "#0B2A34",
+    "activityBar.inactiveForeground": "#1e2021",
+    "activityBar.activeBorder": "#853937",
+    "activityBar.activeBackground": "#3F7F81",
+    "activityBar.border": "#3F7F81",
+    "titleBar.activeBackground": "#549B9D",
+    "titleBar.activeForeground": "#0B2A34",
+    "titleBar.inactiveBackground": "#727f7f",
+    "titleBar.inactiveForeground": "#1e2021",
+    "titleBar.border": "#3F7F81",
+    "statusBar.background": "#71ACAD",
+    "statusBar.foreground": "#0B2A34",
+    "statusBar.border": "#3F7F81"
+  }
+}

package/docs/Guides/Ecosystem.md

@@ -40,8 +40,6 @@ section.
   plugin for adding
   [CSRF](https://en.wikipedia.org/wiki/Cross-site_request_forgery) protection to
   Fastify.
-- [`@fastify/diagnostics-channel`](https://github.com/fastify/fastify-diagnostics-channel)
-  Plugin to deal with `diagnostics_channel` on Fastify.
 - [`@fastify/elasticsearch`](https://github.com/fastify/fastify-elasticsearch)
   Plugin to share the same ES client.
 - [`@fastify/env`](https://github.com/fastify/fastify-env) Load and check
@@ -200,6 +198,9 @@ section.
   to go!
   A plugin to implement [Lyra](https://github.com/nearform/lyra) search engine
   on Fastify
+- [`@inaiat/fastify-papr`](https://github.com/inaiat/fastify-papr)
+  A plugin to integrate [Papr](https://github.com/plexinc/papr), 
+  the MongoDB ORM for TypeScript & MongoDB, with Fastify.
 - [`@jerome1337/fastify-enforce-routes-pattern`](https://github.com/Jerome1337/fastify-enforce-routes-pattern)
   A Fastify plugin that enforces naming pattern for routes path.
 - [`@joggr/fastify-prisma`](https://github.com/joggrdocs/fastify-prisma)
@@ -737,9 +738,13 @@ middlewares into Fastify plugins
   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.
+- [`jeasx`](https://www.jeasx.dev)
+  A flexible server-rendering framework built on Fastify
+  that leverages asynchronous JSX to simplify web development.
 - [`simple-tjscli`](https://github.com/imjuni/simple-tjscli) CLI tool to
   generate JSON Schema from TypeScript interfaces.
 - [`vite-plugin-fastify`](https://github.com/Vanilla-IceCream/vite-plugin-fastify)
   Fastify plugin for Vite with Hot-module Replacement.
 - [`vite-plugin-fastify-routes`](https://github.com/Vanilla-IceCream/vite-plugin-fastify-routes)
   File-based routing for Fastify applications using Vite.
+  

package/docs/Guides/Serverless.md

@@ -1,20 +1,20 @@
 <h1 align="center">Serverless</h1>
 
 Run serverless applications and REST APIs using your existing Fastify
-application. By default, Fastify will not work on your serverless platform of
-choice, you will need to make some small changes to fix this. This document
-contains a small guide for the most popular serverless providers and how to use
+application. You may need to make code changes to work on your
+serverless platform of choice. This document contains a small guide
+for the most popular serverless providers and how to use
 Fastify with them.
 
 #### Should you use Fastify in a serverless platform?
 
-That is up to you! Keep in mind that functions as a service should always use
+That is up to you! Keep in mind, functions as a service should always use
 small and focused functions, but you can also run an entire web application with
 them. It is important to remember that the bigger the application the slower the
 initial boot will be. The best way to run Fastify applications in serverless
-environments is to use platforms like Google Cloud Run, AWS Fargate, and Azure
-Container Instances, where the server can handle multiple requests at the same
-time and make full use of Fastify's features.
+environments is to use platforms like Google Cloud Run, AWS Fargate, Azure
+Container Instances, and Vercel where the server can handle multiple requests
+at the same time and make full use of Fastify's features.
 
 One of the best features of using Fastify in serverless applications is the ease
 of development. In your local environment, you will always run the Fastify
@@ -136,7 +136,6 @@ of serverless applications to the cloud.
 
 [Genezio has a dedicated guide for deploying a Fastify application.](https://genezio.com/docs/frameworks/fastify/)
 
-
 ## Google Cloud Functions
 
 ### Creation of Fastify instance
@@ -238,14 +237,13 @@ npx @google-cloud/functions-framework --target=fastifyFunction
 Or add this command to your `package.json` scripts:
 ```json
 "scripts": {
-...
-"dev": "npx @google-cloud/functions-framework --target=fastifyFunction"
-...
+  ...
+  "dev": "npx @google-cloud/functions-framework --target=fastifyFunction"
+  ...
 }
 ```
 and run it with `npm run dev`.
 
-
 ### Deploy
 ```bash
 gcloud functions deploy fastifyFunction \
@@ -326,7 +324,7 @@ async function registerRoutes (fastify) {
   })
 
   // define your endpoints here...
-  fastify.post("/some-route-here", async (request, reply) => {}
+  fastify.post("/some-route-here", async (request, reply) => {})
 
   fastify.get('/', async (request, reply) => {
     reply.send({message: 'Hello World!'})
@@ -377,7 +375,6 @@ firebase functions:log
 - [Fastify on Firebase Functions](https://github.com/lirantal/lemon-squeezy-firebase-webhook-fastify/blob/main/package.json)
 - [An article about HTTP webhooks on Firebase Functions and Fastify: A Practical Case Study with Lemon Squeezy](https://lirantal.com/blog/http-webhooks-firebase-functions-fastify-practical-case-study-lemon-squeezy)
 
-
 ## Google Cloud Run
 
 Unlike AWS Lambda or Google Cloud Functions, Google Cloud Run is a serverless
@@ -463,7 +460,7 @@ CMD [ "npm", "start" ]
 To keep build artifacts out of your container (which keeps it small and improves
 build times) add a `.dockerignore` file like the one below:
 
-```.dockerignore
+```dockerignore
 Dockerfile
 README.md
 node_modules
@@ -490,12 +487,11 @@ gcloud beta run deploy --image gcr.io/PROJECT-ID/APP-NAME --platform managed
 
 Your app will be accessible from the URL GCP provides.
 
-
 ## netlify-lambda
 
 First, please perform all preparation steps related to **AWS Lambda**.
 
-Create a folder called `functions`,  then create `server.js` (and your endpoint
+Create a folder called `functions`, then create `server.js` (and your endpoint
 path will be `server.js`) inside the `functions` folder.
 
 ### functions/server.js
@@ -564,9 +560,9 @@ Add this command to your `package.json` *scripts*
 
 ```json
 "scripts": {
-...
-"build:functions": "netlify-lambda build functions --config ./webpack.config.netlify.js"
-...
+  ...
+  "build:functions": "netlify-lambda build functions --config ./webpack.config.netlify.js"
+  ...
 }
 ```
 
@@ -574,54 +570,17 @@ Then it should work fine.
 
 ## Vercel
 
-[Vercel](https://vercel.com) provides zero-configuration deployment for Node.js
-applications. To use it now, it is as simple as configuring your `vercel.json`
-file like the following:
-
-```json
-{
-    "rewrites": [
-        {
-            "source": "/(.*)",
-            "destination": "/api/serverless.js"
-        }
-    ]
-}
-```
-
-Then, write `api/serverless.js` like so:
-
-```js
-"use strict";
-
-// Read the .env file.
-import * as dotenv from "dotenv";
-dotenv.config();
+[Vercel](https://vercel.com) fully supports deploying Fastify applications.
+Additionally, with Vercel's
+[Fluid compute](https://vercel.com/docs/functions/fluid-compute), you can combine
+server-like concurrency with the autoscaling properties of traditional
+serverless functions.
 
-// Require the framework
-import Fastify from "fastify";
+Get started with the
+[Fastify Node.js template on Vercel](
+https://vercel.com/templates/other/fastify-serverless-function).
 
-// Instantiate Fastify with some config
-const app = Fastify({
-  logger: true,
-});
-
-// Register your application as a normal plugin.
-app.register(import("../src/app.js"));
-
-export default async (req, res) => {
-    await app.ready();
-    app.server.emit('request', req, res);
-}
-```
-
-In `src/app.js` define the plugin.
-```js
-async function routes (fastify, options) {
-  fastify.get('/', async (request, reply) => {
-    return { hello: 'world' }
-  })
-}
-
-export default routes;
-```
+[Fluid compute](https://vercel.com/docs/functions/fluid-compute) currently
+requires an explicit opt-in. Learn more about enabling Fluid compute
+[here](
+https://vercel.com/docs/functions/fluid-compute#how-to-enable-fluid-compute).

package/docs/Reference/Errors.md

@@ -69,7 +69,6 @@
     - [FST_ERR_SCH_VALIDATION_BUILD](#fst_err_sch_validation_build)
     - [FST_ERR_SCH_SERIALIZATION_BUILD](#fst_err_sch_serialization_build)
     - [FST_ERR_SCH_RESPONSE_SCHEMA_NOT_NESTED_2XX](#fst_err_sch_response_schema_not_nested_2xx)
-    - [FST_ERR_HTTP2_INVALID_VERSION](#fst_err_http2_invalid_version)
     - [FST_ERR_INIT_OPTS_INVALID](#fst_err_init_opts_invalid)
     - [FST_ERR_FORCE_CLOSE_CONNECTIONS_IDLE_NOT_AVAILABLE](#fst_err_force_close_connections_idle_not_available)
     - [FST_ERR_DUPLICATED_ROUTE](#fst_err_duplicated_route)
@@ -340,7 +339,6 @@ Below is a table with all the error codes used by Fastify.
 | <a id="fst_err_sch_validation_build">FST_ERR_SCH_VALIDATION_BUILD</a> | The JSON schema provided for validation to a route is not valid. | Fix the JSON schema. | [#2023](https://github.com/fastify/fastify/pull/2023) |
 | <a id="fst_err_sch_serialization_build">FST_ERR_SCH_SERIALIZATION_BUILD</a> | The JSON schema provided for serialization of a route response is not valid. | Fix the JSON schema. | [#2023](https://github.com/fastify/fastify/pull/2023) |
 | <a id="fst_err_sch_response_schema_not_nested_2xx">FST_ERR_SCH_RESPONSE_SCHEMA_NOT_NESTED_2XX</a> | Response schemas should be nested under a valid status code (2XX). | Use a valid status code. | [#4554](https://github.com/fastify/fastify/pull/4554) |
-| <a id="fst_err_http2_invalid_version">FST_ERR_HTTP2_INVALID_VERSION</a> | HTTP2 is available only from node >= 8.8.1. | Use a higher version of node. | [#1346](https://github.com/fastify/fastify/pull/1346) |
 | <a id="fst_err_init_opts_invalid">FST_ERR_INIT_OPTS_INVALID</a> | Invalid initialization options. | Use valid initialization options. | [#1471](https://github.com/fastify/fastify/pull/1471) |
 | <a id="fst_err_force_close_connections_idle_not_available">FST_ERR_FORCE_CLOSE_CONNECTIONS_IDLE_NOT_AVAILABLE</a> | Cannot set forceCloseConnections to `idle` as your HTTP server does not support `closeIdleConnections` method. | Use a different value for `forceCloseConnections`. | [#3925](https://github.com/fastify/fastify/pull/3925) |
 | <a id="fst_err_duplicated_route">FST_ERR_DUPLICATED_ROUTE</a> | The HTTP method already has a registered controller for that URL. | Use a different URL or register the controller for another HTTP method. | [#2954](https://github.com/fastify/fastify/pull/2954) |

package/docs/Reference/Server.md

@@ -1529,7 +1529,7 @@ plugins.
 > 🛈 Note:
 > Some config properties from the request object will be
 > undefined inside the custom not found handler. E.g.:
-> `request.routerPath`, `routerMethod` and `context.config`.
+> `request.routeOptions.url`, `routeOptions.method` and `routeOptions.config`.
 > This method design goal is to allow calling the common not found route.
 > To return a per-route customized 404 response, you can do it in
 > the response itself.
@@ -1574,6 +1574,22 @@ if (statusCode >= 500) {
   log.error(error)
 }
 ```
+
+> ⚠ Warning:
+> Avoid calling setErrorHandler multiple times in the same scope.
+> Only the last handler will take effect, and previous ones will be silently overridden.
+>
+> Incorrect usage:
+> ```js
+> app.setErrorHandler(function freeSomeResources () {
+>   // Never executed, memory leaks
+> })
+> 
+> app.setErrorHandler(function anotherErrorHandler () {
+>   // Overrides the previous handler
+> })
+> ```
+
 #### setChildLoggerFactory
 <a id="set-child-logger-factory"></a>
 

package/eslint.config.js

@@ -1,11 +1,19 @@
 'use strict'
+const neostandard = require('neostandard')
 
-module.exports = require('neostandard')({
-  ignores: [
-    'lib/configValidator.js',
-    'lib/error-serializer.js',
-    'test/same-shape.test.js',
-    'test/types/import.js'
-  ],
-  ts: true
-})
+module.exports = [
+  ...neostandard({
+    ignores: [
+      'lib/configValidator.js',
+      'lib/error-serializer.js',
+      'test/same-shape.test.js',
+      'test/types/import.js'
+    ],
+    ts: true
+  }),
+  {
+    rules: {
+      'comma-dangle': ['error', 'never']
+    }
+  }
+]

package/fastify.js

@@ -681,8 +681,12 @@ function fastify (options) {
       this[kHooks].add(name, fn)
     } else {
       this.after((err, done) => {
-        _addHook.call(this, name, fn)
-        done(err)
+        try {
+          _addHook.call(this, name, fn)
+          done(err)
+        } catch (err) {
+          done(err)
+        }
       })
     }
     return this

package/lib/decorate.js

@@ -4,7 +4,7 @@ const {
   kReply,
   kRequest,
   kState,
-  kHasBeenDecorated,
+  kHasBeenDecorated
 } = require('./symbols.js')
 
 const {
@@ -13,7 +13,7 @@ const {
   FST_ERR_DEC_AFTER_START,
   FST_ERR_DEC_REFERENCE_TYPE,
   FST_ERR_DEC_DEPENDENCY_INVALID_TYPE,
-  FST_ERR_DEC_UNDECLARED,
+  FST_ERR_DEC_UNDECLARED
 } = require('./errors')
 
 function decorate (instance, name, fn, dependencies) {

package/lib/errors.js

@@ -328,14 +328,6 @@ const codes = {
     'response schemas should be nested under a valid status code, e.g { 2xx: { type: "object" } }'
   ),
 
-  /**
-   * http2
-   */
-  FST_ERR_HTTP2_INVALID_VERSION: createError(
-    'FST_ERR_HTTP2_INVALID_VERSION',
-    'HTTP2 is available only from node >= 8.8.1'
-  ),
-
   /**
    * initialConfig
    */

package/lib/logger-factory.js

@@ -132,5 +132,5 @@ module.exports = {
   defaultChildLoggerFactory,
   createLogger,
   validateLogger,
-  now,
+  now
 }

package/lib/logger-pino.js

@@ -9,7 +9,7 @@
 const pino = require('pino')
 const { serializersSym } = pino.symbols
 const {
-  FST_ERR_LOG_INVALID_DESTINATION,
+  FST_ERR_LOG_INVALID_DESTINATION
 } = require('./errors')
 
 function createPinoLogger (opts) {
@@ -64,5 +64,5 @@ const serializers = {
 
 module.exports = {
   serializers,
-  createPinoLogger,
+  createPinoLogger
 }

package/lib/reply.js

@@ -22,7 +22,7 @@ const {
   kReplyCacheSerializeFns,
   kSchemaController,
   kOptions,
-  kRouteContext,
+  kRouteContext
 } = require('./symbols.js')
 const {
   onSendHookRunner,
@@ -53,7 +53,7 @@ const {
   FST_ERR_BAD_TRAILER_VALUE,
   FST_ERR_MISSING_SERIALIZATION_FN,
   FST_ERR_MISSING_CONTENTTYPE_SERIALIZATION_FN,
-  FST_ERR_DEC_UNDECLARED,
+  FST_ERR_DEC_UNDECLARED
 } = require('./errors')
 const decorators = require('./decorate')
 

package/lib/request.js

@@ -11,7 +11,7 @@ const {
   kOptions,
   kRequestCacheValidateFns,
   kRouteContext,
-  kRequestOriginalUrl,
+  kRequestOriginalUrl
 } = require('./symbols')
 const { FST_ERR_REQ_INVALID_VALIDATION_INVOCATION, FST_ERR_DEC_UNDECLARED } = require('./errors')
 const decorators = require('./decorate')

package/lib/server.js

@@ -2,6 +2,7 @@
 
 const http = require('node:http')
 const https = require('node:https')
+const http2 = require('node:http2')
 const dns = require('node:dns')
 const os = require('node:os')
 
@@ -9,7 +10,6 @@ const { kState, kOptions, kServerBindings } = require('./symbols')
 const { FSTWRN003 } = require('./warnings')
 const { onListenHookRunner } = require('./hooks')
 const {
-  FST_ERR_HTTP2_INVALID_VERSION,
   FST_ERR_REOPENED_CLOSE_SERVER,
   FST_ERR_REOPENED_SERVER,
   FST_ERR_LISTEN_OPTIONS_INVALID
@@ -98,7 +98,6 @@ function createServer (options, httpHandler) {
 
     if (cb === undefined) {
       const listening = listenPromise.call(this, server, listenOptions)
-      /* istanbul ignore else */
       return listening.then(address => {
         return new Promise((resolve, reject) => {
           if (host === 'localhost') {
@@ -192,7 +191,6 @@ function multipleBindings (mainServer, httpHandler, serverOpts, listenOptions, o
     // to the secondary servers. It is valid only when the user is
     // listening on localhost
     const originUnref = mainServer.unref
-    /* c8 ignore next 4 */
     mainServer.unref = function () {
       originUnref.call(mainServer)
       mainServer.emit('unref')
@@ -218,7 +216,8 @@ function listenCallback (server, listenOptions) {
 
     if (this[kState].listening && this[kState].closing) {
       return listenOptions.cb(new FST_ERR_REOPENED_CLOSE_SERVER(), null)
-    } else if (this[kState].listening) {
+    }
+    if (this[kState].listening) {
       return listenOptions.cb(new FST_ERR_REOPENED_SERVER(), null)
     }
 
@@ -234,7 +233,8 @@ function listenCallback (server, listenOptions) {
 function listenPromise (server, listenOptions) {
   if (this[kState].listening && this[kState].closing) {
     return Promise.reject(new FST_ERR_REOPENED_CLOSE_SERVER())
-  } else if (this[kState].listening) {
+  }
+  if (this[kState].listening) {
     return Promise.reject(new FST_ERR_REOPENED_SERVER())
   }
 
@@ -272,41 +272,38 @@ function listenPromise (server, listenOptions) {
 }
 
 function getServerInstance (options, httpHandler) {
-  let server = null
-  // node@20 do not accepts options as boolean
-  // we need to provide proper https option
-  const httpsOptions = options.https === true ? {} : options.https
   if (options.serverFactory) {
-    server = options.serverFactory(httpHandler, options)
-  } else if (options.http2) {
-    if (typeof httpsOptions === 'object') {
-      server = http2().createSecureServer(httpsOptions, httpHandler)
-    } else {
-      server = http2().createServer(httpHandler)
-    }
-    server.on('session', sessionTimeout(options.http2SessionTimeout))
-  } else {
-    // this is http1
-    if (httpsOptions) {
-      server = https.createServer(httpsOptions, httpHandler)
-    } else {
-      server = http.createServer(options.http, httpHandler)
-    }
-    server.keepAliveTimeout = options.keepAliveTimeout
-    server.requestTimeout = options.requestTimeout
-    // we treat zero as null
-    // and null is the default setting from nodejs
-    // so we do not pass the option to server
-    if (options.maxRequestsPerSocket > 0) {
-      server.maxRequestsPerSocket = options.maxRequestsPerSocket
-    }
+    // User provided server instance
+    return options.serverFactory(httpHandler, options)
   }
 
-  if (!options.serverFactory) {
+  // We have accepted true as a valid way to init https but node requires an options obj
+  const httpsOptions = options.https === true ? {} : options.https
+
+  if (options.http2) {
+    const server = typeof httpsOptions === 'object' ? http2.createSecureServer(httpsOptions, httpHandler) : http2.createServer(options.http, httpHandler)
+    server.on('session', (session) => session.setTimeout(options.http2SessionTimeout, function closeSession () {
+      this.close()
+    }))
+
     server.setTimeout(options.connectionTimeout)
+
+    return server
   }
+
+  // HTTP1 server instance
+  const server = httpsOptions ? https.createServer(httpsOptions, httpHandler) : http.createServer(options.http, httpHandler)
+  server.keepAliveTimeout = options.keepAliveTimeout
+  server.requestTimeout = options.requestTimeout
+  server.setTimeout(options.connectionTimeout)
+  // We treat zero as null(node default) so we do not pass zero to the server instance
+  if (options.maxRequestsPerSocket > 0) {
+    server.maxRequestsPerSocket = options.maxRequestsPerSocket
+  }
+
   return server
 }
+
 /**
  * Inspects the provided `server.address` object and returns a
  * normalized list of IP address strings. Normalization in this
@@ -355,21 +352,3 @@ function logServerAddress (server, listenTextResolver) {
   }
   return addresses[0]
 }
-
-function http2 () {
-  try {
-    return require('node:http2')
-  } catch (err) {
-    throw new FST_ERR_HTTP2_INVALID_VERSION()
-  }
-}
-
-function sessionTimeout (timeout) {
-  return function (session) {
-    session.setTimeout(timeout, close)
-  }
-}
-
-function close () {
-  this.close()
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastify",
-  "version": "5.3.2",
+  "version": "5.3.3",
   "description": "Fast and low overhead web framework, for Node.js",
   "main": "fastify.js",
   "type": "commonjs",
@@ -172,14 +172,14 @@
     "ajv-i18n": "^4.2.0",
     "ajv-merge-patch": "^5.0.1",
     "autocannon": "^8.0.0",
-    "borp": "^0.19.0",
+    "borp": "^0.20.0",
     "branch-comparer": "^1.1.0",
     "concurrently": "^9.1.2",
     "cross-env": "^7.0.3",
     "eslint": "^9.0.0",
     "fast-json-body": "^1.1.0",
     "fastify-plugin": "^5.0.0",
-    "fluent-json-schema": "^5.0.0",
+    "fluent-json-schema": "^6.0.0",
     "h2url": "^0.2.0",
     "http-errors": "^2.0.0",
     "joi": "^17.12.3",
@@ -192,7 +192,7 @@
     "simple-get": "^4.0.1",
     "split2": "^4.2.0",
     "tap": "^21.0.0",
-    "tsd": "^0.31.0",
+    "tsd": "^0.32.0",
     "typescript": "~5.8.2",
     "undici": "^6.13.0",
     "vary": "^1.1.2",

package/test/close-pipelining.test.js

@@ -59,10 +59,11 @@ test('Should close the socket abruptly - pipelining - return503OnClosing: false'
     instance.request({ path: '/', method: 'GET' })
   ])
 
-  t.assert.strictEqual(responses[0].status, 'fulfilled')
-  t.assert.strictEqual(responses[1].status, 'fulfilled')
-  t.assert.strictEqual(responses[2].status, 'rejected')
-  t.assert.strictEqual(responses[3].status, 'rejected')
+  const fulfilled = responses.filter(r => r.status === 'fulfilled')
+  const rejected = responses.filter(r => r.status === 'rejected')
+
+  t.assert.strictEqual(fulfilled.length, 2)
+  t.assert.strictEqual(rejected.length, 2)
 
   await instance.close()
 })