fastify 4.26.2 → 4.28.0

package/.tap/test-results/test/trust-proxy.test.js.tap

@@ -0,0 +1,109 @@
+TAP version 14
+# Subtest: trust proxy, not add properties to node req
+    1..14
+    ok 1 - should not error
+    ok 2 - ip is defined
+    ok 3 - gets ip from x-forwarded-for
+    ok 4 - host is defined
+    ok 5 - gets host from x-forwarded-host
+    ok 6 - should be equal
+    ok 7 - gets hostname from x-forwarded-host
+    ok 8 - port is defined
+    ok 9 - port is taken from x-forwarded-for or host
+    ok 10 - ip is defined
+    ok 11 - gets ip from x-forwarded-for
+    ok 12 - gets ips from x-forwarded-for
+    ok 13 - port is defined
+    ok 14 - port is taken from x-forwarded-for or host
+ok 1 - trust proxy, not add properties to node req # time=29.578ms
+
+# Subtest: trust proxy chain
+    1..9
+    ok 1 - should not error
+    ok 2 - ip is defined
+    ok 3 - gets ip from x-forwarded-for
+    ok 4 - host is defined
+    ok 5 - gets host from x-forwarded-host
+    ok 6 - should be equal
+    ok 7 - gets hostname from x-forwarded-host
+    ok 8 - port is defined
+    ok 9 - port is taken from x-forwarded-for or host
+ok 2 - trust proxy chain # time=7.178ms
+
+# Subtest: trust proxy function
+    1..9
+    ok 1 - should not error
+    ok 2 - ip is defined
+    ok 3 - gets ip from x-forwarded-for
+    ok 4 - host is defined
+    ok 5 - gets host from x-forwarded-host
+    ok 6 - should be equal
+    ok 7 - gets hostname from x-forwarded-host
+    ok 8 - port is defined
+    ok 9 - port is taken from x-forwarded-for or host
+ok 3 - trust proxy function # time=8.164ms
+
+# Subtest: trust proxy number
+    1..10
+    ok 1 - should not error
+    ok 2 - ip is defined
+    ok 3 - gets ip from x-forwarded-for
+    ok 4 - host is defined
+    ok 5 - gets host from x-forwarded-host
+    ok 6 - should be equal
+    ok 7 - gets hostname from x-forwarded-host
+    ok 8 - gets ips from x-forwarded-for
+    ok 9 - port is defined
+    ok 10 - port is taken from x-forwarded-for or host
+ok 4 - trust proxy number # time=5.26ms
+
+# Subtest: trust proxy IP addresses
+    1..10
+    ok 1 - should not error
+    ok 2 - ip is defined
+    ok 3 - gets ip from x-forwarded-for
+    ok 4 - host is defined
+    ok 5 - gets host from x-forwarded-host
+    ok 6 - should be equal
+    ok 7 - gets hostname from x-forwarded-host
+    ok 8 - gets ips from x-forwarded-for
+    ok 9 - port is defined
+    ok 10 - port is taken from x-forwarded-for or host
+ok 5 - trust proxy IP addresses # time=8.978ms
+
+# Subtest: trust proxy protocol
+    1..31
+    ok 1 - should not error
+    ok 2 - ip is defined
+    ok 3 - gets ip from x-forwarded-for
+    ok 4 - host is defined
+    ok 5 - gets host from x-forwarded-host
+    ok 6 - should be equal
+    ok 7 - gets hostname from x-forwarded-host
+    ok 8 - protocol is defined
+    ok 9 - gets protocol from x-forwarded-proto
+    ok 10 - port is defined
+    ok 11 - port is taken from x-forwarded-for or host
+    ok 12 - ip is defined
+    ok 13 - gets ip from x-forwarded-for
+    ok 14 - host is defined
+    ok 15 - gets host from x-forwarded-host
+    ok 16 - should be equal
+    ok 17 - gets hostname from x-forwarded-host
+    ok 18 - protocol is defined
+    ok 19 - gets protocol from x-forwarded-proto
+    ok 20 - port is defined
+    ok 21 - port is taken from x-forwarded-for or host
+    ok 22 - ip is defined
+    ok 23 - gets ip from x-forwarded-for
+    ok 24 - host is defined
+    ok 25 - gets host from x-forwarded-host
+    ok 26 - should be equal
+    ok 27 - gets hostname from x-forwarded-host
+    ok 28 - protocol is defined
+    ok 29 - gets protocol from x-forwarded-proto
+    ok 30 - port is defined
+    ok 31 - port is taken from x-forwarded-for or host
+ok 6 - trust proxy protocol # time=9.601ms
+
+1..6

package/.tap/test-results/test/type-provider.test.js.tap

@@ -0,0 +1,12 @@
+TAP version 14
+# Subtest: Should export withTypeProvider function
+    1..1
+    ok 1 - (unnamed test)
+ok 1 - Should export withTypeProvider function # time=8.425ms
+
+# Subtest: Should return same instance
+    1..1
+    ok 1 - should be equal
+ok 2 - Should return same instance # time=0.746ms
+
+1..2

package/.tap/test-results/test/unlock.test.js.tap

@@ -0,0 +1,14 @@
+TAP version 14
+# Subtest: can be created - unlock
+    1..1
+    ok 1 - (unnamed test)
+ok 1 - can be created - unlock # time=6.734ms
+
+ok 2 - should not error
+# Subtest: request - unlock
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 3 - request - unlock # time=9.21ms
+
+1..3

package/.tap/test-results/test/upgrade.test.js.tap

@@ -0,0 +1,8 @@
+TAP version 14
+# Subtest: upgrade to both servers
+    1..2
+    ok 1 - upgrade event {"address":"127.0.0.1","family":"IPv4","port":51916}
+    ok 2 - upgrade event {"address":"::1","family":"IPv6","port":51916}
+ok 1 - upgrade to both servers # time=28.465ms
+
+1..1

package/.tap/test-results/test/url-rewriting.test.js.tap

@@ -0,0 +1,39 @@
+TAP version 14
+# Subtest: Should rewrite url
+    1..5
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should not error
+    ok 4 - should be equivalent
+    ok 5 - should be equal
+ok 1 - Should rewrite url # time=38.251ms
+
+# Subtest: Should not rewrite if the url is the same
+    1..4
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should not error
+    ok 4 - should be equal
+ok 2 - Should not rewrite if the url is the same # time=5.228ms
+
+# Subtest: Should throw an error
+    1..5
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should be equal
+    ok 5 - should be equal
+ok 3 - Should throw an error # time=8.587ms
+
+# Subtest: Should rewrite url but keep originalUrl unchanged
+    1..7
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should be equal
+    ok 5 - should not error
+    ok 6 - should be equivalent
+    ok 7 - should be equal
+ok 4 - Should rewrite url but keep originalUrl unchanged # time=4.347ms
+
+1..4

package/.tap/test-results/test/useSemicolonDelimiter.test.js.tap

@@ -0,0 +1,33 @@
+TAP version 14
+# Subtest: use semicolon delimiter default false
+    1..4
+    ok 1 - should not error
+    ok 2 - should not error
+    ok 3 - should be equal
+    ok 4 - should be equivalent
+ok 1 - use semicolon delimiter default false # time=34.406ms
+
+# Subtest: use semicolon delimiter set to true
+    1..4
+    ok 1 - should not error
+    ok 2 - should not error
+    ok 3 - should be equal
+    ok 4 - should be equivalent
+ok 2 - use semicolon delimiter set to true # time=4.572ms
+
+# Subtest: use semicolon delimiter set to false
+    1..4
+    ok 1 - should not error
+    ok 2 - should not error
+    ok 3 - should be equal
+    ok 4 - should be equivalent
+ok 3 - use semicolon delimiter set to false # time=3.693ms
+
+# Subtest: use semicolon delimiter set to false return 404
+    1..3
+    ok 1 - should not error
+    ok 2 - should not error
+    ok 3 - should be equal
+ok 4 - use semicolon delimiter set to false return 404 # time=10.561ms
+
+1..4

package/.tap/test-results/test/validation-error-handling.test.js.tap

@@ -0,0 +1,180 @@
+TAP version 14
+# Subtest: should work with valid payload
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 1 - should work with valid payload # time=42.047ms
+
+# Subtest: should fail immediately with invalid payload
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 2 - should fail immediately with invalid payload # time=12.976ms
+
+# Subtest: should be able to use setErrorHandler specify custom validation error
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 3 - should be able to use setErrorHandler specify custom validation error # time=8.806ms
+
+# Subtest: validation error has 400 statusCode set
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 4 - validation error has 400 statusCode set # time=7.87ms
+
+# Subtest: error inside custom error handler should have validationContext
+    1..1
+    ok 1 - should be equal
+ok 5 - error inside custom error handler should have validationContext # time=1.389ms
+
+# Subtest: error inside custom error handler should have validationContext if specified by custom error handler
+    1..1
+    ok 1 - should be equal
+ok 6 - error inside custom error handler should have validationContext if specified by custom error handler # time=1.284ms
+
+# Subtest: should be able to attach validation to request
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 7 - should be able to attach validation to request # time=12.039ms
+
+# Subtest: should respect when attachValidation is explicitly set to false
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 8 - should respect when attachValidation is explicitly set to false # time=6.77ms
+
+# Subtest: Attached validation error should take precedence over setErrorHandler
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 9 - Attached validation error should take precedence over setErrorHandler # time=6.239ms
+
+# Subtest: should handle response validation error
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 10 - should handle response validation error # time=4.118ms
+
+# Subtest: should handle response validation error with promises
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 11 - should handle response validation error with promises # time=2.008ms
+
+# Subtest: should return a defined output message parsing AJV errors
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 12 - should return a defined output message parsing AJV errors # time=6.6ms
+
+# Subtest: should return a defined output message parsing JOI errors
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 13 - should return a defined output message parsing JOI errors # time=5.083ms
+
+# Subtest: should return a defined output message parsing JOI error details
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 14 - should return a defined output message parsing JOI error details # time=1.832ms
+
+# Subtest: the custom error formatter context must be the server instance
+    1..4
+    ok 1 - should be equivalent
+    ok 2 - should not error
+    ok 3 - should be equivalent
+    ok 4 - should be equal
+ok 15 - the custom error formatter context must be the server instance # time=6.03ms
+
+# Subtest: the custom error formatter context must be the server instance in options
+    1..4
+    ok 1 - should be equivalent
+    ok 2 - should not error
+    ok 3 - should be equivalent
+    ok 4 - should be equal
+ok 16 - the custom error formatter context must be the server instance in options # time=5.754ms
+
+# Subtest: should call custom error formatter
+    1..9
+    ok 1 - should be equal
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should be equal
+    ok 5 - should be equivalent
+    ok 6 - should be equal
+    ok 7 - should not error
+    ok 8 - should be equivalent
+    ok 9 - should be equal
+ok 17 - should call custom error formatter # time=6.88ms
+
+# Subtest: should catch error inside formatter and return message
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 18 - should catch error inside formatter and return message # time=7.526ms
+
+# Subtest: cannot create a fastify instance with wrong type of errorFormatter
+    1..3
+    ok 1 - should be equal
+    ok 2 - should be equal
+    ok 3 - should be equal
+ok 19 - cannot create a fastify instance with wrong type of errorFormatter # time=1.017ms
+
+# Subtest: should register a route based schema error formatter
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 20 - should register a route based schema error formatter # time=5.838ms
+
+# Subtest: prefer route based error formatter over global one
+    1..9
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equivalent
+    ok 6 - should be equal
+    ok 7 - should not error
+    ok 8 - should be equivalent
+    ok 9 - should be equal
+ok 21 - prefer route based error formatter over global one # time=7.855ms
+
+# Subtest: adding schemaErrorFormatter
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 22 - adding schemaErrorFormatter # time=6.377ms
+
+# Subtest: plugin override
+    1..15
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equivalent
+    ok 6 - should be equal
+    ok 7 - should not error
+    ok 8 - should be equivalent
+    ok 9 - should be equal
+    ok 10 - should not error
+    ok 11 - should be equivalent
+    ok 12 - should be equal
+    ok 13 - should not error
+    ok 14 - should be equivalent
+    ok 15 - should be equal
+ok 23 - plugin override # time=10.139ms
+
+1..23

package/.tap/test-results/test/versioned-routes.test.js.tap

@@ -0,0 +1,151 @@
+TAP version 14
+# Subtest: Should register a versioned route
+    1..11
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equivalent
+    ok 6 - should be equal
+    ok 7 - should not error
+    ok 8 - should be equivalent
+    ok 9 - should be equal
+    ok 10 - should not error
+    ok 11 - should be equal
+ok 1 - Should register a versioned route # time=20.923ms
+
+# Subtest: Should register a versioned route via route constraints
+    1..6
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equivalent
+    ok 6 - should be equal
+ok 2 - Should register a versioned route via route constraints # time=1.942ms
+
+# Subtest: Should register the same route with different versions
+    1..8
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equal
+    ok 6 - should be equal
+    ok 7 - should not error
+    ok 8 - should be equal
+ok 3 - Should register the same route with different versions # time=2.04ms
+
+# Subtest: The versioned route should take precedence
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+ok 4 - The versioned route should take precedence # time=1.453ms
+
+# Subtest: Versioned route but not version header should return a 404
+    1..2
+    ok 1 - should not error
+    ok 2 - should be equal
+ok 5 - Versioned route but not version header should return a 404 # time=1.25ms
+
+# Subtest: Should register a versioned route
+    1..6
+    ok 1 - should not error
+    ok 2 - should not error
+    ok 3 - should be equal
+    ok 4 - should be equivalent
+    ok 5 - should not error
+    ok 6 - should be equal
+ok 6 - Should register a versioned route # time=13.091ms
+
+# Subtest: Shorthand route declaration
+    1..5
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equal
+ok 7 - Shorthand route declaration # time=3.041ms
+
+# Subtest: The not found handler should not erase the Accept-Version header
+    1..13
+    ok 1 - should be equivalent
+    ok 2 - should be equivalent
+    ok 3 - should be equivalent
+    ok 4 - should be equivalent
+    ok 5 - should be equivalent
+    ok 6 - should be equivalent
+    ok 7 - should be equivalent
+    ok 8 - should be equivalent
+    ok 9 - should be equivalent
+    ok 10 - should be equivalent
+    ok 11 - should not error
+    ok 12 - should be equivalent
+    ok 13 - should be equal
+ok 8 - The not found handler should not erase the Accept-Version header # time=2.467ms
+
+# Subtest: Bad accept version (inject)
+    1..4
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should not error
+    ok 4 - should be equal
+ok 9 - Bad accept version (inject) # time=1.613ms
+
+# Subtest: Bad accept version (server)
+    1..5
+    ok 1 - should not error
+    ok 2 - should not error
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equal
+ok 10 - Bad accept version (server) # time=4.188ms
+
+# Subtest: test log stream
+    1..3
+    ok 1 - should not error
+    ok 2 - should be equal
+    ok 3 - should be equal
+ok 11 - test log stream # time=5.422ms
+
+# Subtest: Should register a versioned route with custom versioning strategy
+    1..8
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should not error
+    ok 5 - should be equivalent
+    ok 6 - should be equal
+    ok 7 - should not error
+    ok 8 - should be equal
+ok 12 - Should register a versioned route with custom versioning strategy # time=3.232ms
+
+# Subtest: Should get error using an invalid a versioned route, using default validation (deprecated versioning option)
+    1..3
+    ok 1 - should be equal
+    ok 2 - should not error
+    ok 3 - should be equal
+ok 13 - Should get error using an invalid a versioned route, using default validation (deprecated versioning option) # time=1.832ms
+
+# Subtest: Vary header check (for documentation example)
+    1..8
+    ok 1 - should not error
+    ok 2 - should be equivalent
+    ok 3 - should be equal
+    ok 4 - should be equal
+    ok 5 - should not error
+    ok 6 - should be equivalent
+    ok 7 - should be equal
+    ok 8 - should be equal
+ok 14 - Vary header check (for documentation example) # time=2.336ms
+
+# Subtest: Should trigger a warning when a versioned route is registered via version option
+    1..4
+    ok 1 - FSTDEP008 has been emitted
+    ok 2 - should not error
+    ok 3 - should be equivalent
+    ok 4 - should be equal
+ok 15 - Should trigger a warning when a versioned route is registered via version option # time=10.462ms
+
+1..15

package/.tap/test-results/test/web-api.test.js.tap

@@ -0,0 +1,51 @@
+TAP version 14
+# Subtest: should response with a ReadableStream
+    1..2
+    ok 1 - should be equal
+    ok 2 - should be equal
+ok 1 - should response with a ReadableStream # time=22.905ms
+
+# Subtest: should response with a Response
+    1..3
+    ok 1 - should be equal
+    ok 2 - should be equal
+    ok 3 - should be equal
+ok 2 - should response with a Response # time=14.387ms
+
+# Subtest: able to use in onSend hook - ReadableStream
+    1..4
+    ok 1 - should be equal
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should be equal
+ok 3 - able to use in onSend hook - ReadableStream # time=2.646ms
+
+# Subtest: able to use in onSend hook - Response
+    1..4
+    ok 1 - should be equal
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should be equal
+ok 4 - able to use in onSend hook - Response # time=2.512ms
+
+# Subtest: Error when Response.bodyUsed
+    1..4
+    ok 1 - should be equal
+    ok 2 - should be equal
+    ok 3 - should be equal
+    ok 4 - should be equal
+ok 5 - Error when Response.bodyUsed # time=3.136ms
+
+# Subtest: allow to pipe with fetch
+    1..2
+    ok 1 - should be equal
+    ok 2 - should be equivalent
+ok 6 - allow to pipe with fetch # time=22.354ms
+
+# Subtest: allow to pipe with undici.fetch
+    1..2
+    ok 1 - should be equal
+    ok 2 - should be equivalent
+ok 7 - allow to pipe with undici.fetch # time=8.49ms
+
+1..7

package/.tap/test-results/test/wrapThenable.test.js.tap

@@ -0,0 +1,11 @@
+TAP version 14
+# Subtest: should resolve immediately when reply[kReplyHijacked] is true
+    1..0
+ok 1 - should resolve immediately when reply[kReplyHijacked] is true # time=1.028ms
+
+# Subtest: should reject immediately when reply[kReplyHijacked] is true
+    1..1
+    ok 1 - should be equal
+ok 2 - should reject immediately when reply[kReplyHijacked] is true # time=3.683ms
+
+1..2

package/.taprc

@@ -8,3 +8,4 @@ node-arg: --allow-natives-syntax
 
 files:
   - 'test/**/*.test.js'
+  - 'test/**/*.test.mjs'

package/README.md

@@ -125,6 +125,7 @@ yarn add fastify
 
 // ESM
 import Fastify from 'fastify'
+
 const fastify = Fastify({
   logger: true
 })
@@ -150,6 +151,7 @@ with async-await:
 ```js
 // ESM
 import Fastify from 'fastify'
+
 const fastify = Fastify({
   logger: true
 })
@@ -323,6 +325,8 @@ listed in alphabetical order.
   <https://twitter.com/jsumners79>, <https://www.npmjs.com/~jsumners>
 * [__Aras Abbasi__](https://github.com/uzlopak),
   <https://www.npmjs.com/~uzlopak>
+* [__Gürgün Dayıoğlu__](https://github.com/gurgunday),
+  <https://www.npmjs.com/~gurgunday>
 
 ### Fastify Plugins team
 * [__Matteo Collina__](https://github.com/mcollina),

package/SPONSORS.md

@@ -13,7 +13,7 @@ _Be the first!_
 
 ## Tier 3
 
-_Be the first!_
+- [Mercedes-Benz Group](https://github.com/mercedes-benz)
 
 ## Tier 2
 

package/docs/Guides/Database.md

@@ -237,14 +237,14 @@ development. Migrations provide a repeatable and testable way to modify a
 database's schema and prevent data loss.
 
 As stated at the beginning of the guide, Fastify is database agnostic and any
-NodeJS database migration tool can be used with it. We will give an example of
+Node.js database migration tool can be used with it. We will give an example of
 using [Postgrator](https://www.npmjs.com/package/postgrator) which has support
 for Postgres, MySQL, SQL Server and SQLite. For MongoDB migrations, please check
 [migrate-mongo](https://www.npmjs.com/package/migrate-mongo).
 
 #### [Postgrator](https://www.npmjs.com/package/postgrator)
 
-Postgrator is NodeJS SQL migration tool that uses a directory of SQL scripts to
+Postgrator is Node.js SQL migration tool that uses a directory of SQL scripts to
 alter the database schema. Each file an migrations folder need to follow the
 pattern: ` [version].[action].[optional-description].sql`.
 

package/docs/Guides/Delay-Accepting-Requests.md

@@ -49,7 +49,7 @@ That will be achieved by wrapping into a custom plugin two main features:
 
 1. the mechanism for authenticating with the provider
 [decorating](../Reference/Decorators.md) the `fastify` object with the
-authentication key (`magicKey` from here onwards)
+authentication key (`magicKey` from here onward)
 1. the mechanism for denying requests that would, otherwise, fail
 
 ### Hands-on