fastify 4.0.0-rc.3 → 4.0.0-rc.4

package/README.md

@@ -265,6 +265,7 @@ Team members are listed in alphabetical order.
 * [__Maksim Sinik__](https://github.com/fox1t), <https://twitter.com/maksimsinik>, <https://www.npmjs.com/~fox1t>
 * [__Frazer Smith__](https://github.com/Fdawgs), <https://www.npmjs.com/~fdawgs>
 * [__Manuel Spigolon__](https://github.com/eomm), <https://twitter.com/manueomm>, <https://www.npmjs.com/~eomm>
+* [__Rafael Gonzaga__](https://github.com/rafaelgss), <https://twitter.com/_rafaelgss>, <https://www.npmjs.com/~rafaelgss>
 
 ### Great Contributors
 Great contributors on a specific area in the Fastify ecosystem will be invited to join this group by Lead Maintainers.

package/build/build-validation.js

@@ -33,6 +33,7 @@ const defaultInitOptions = {
   disableRequestLogging: false,
   jsonShorthand: true,
   ignoreTrailingSlash: false,
+  ignoreDuplicateSlashes: false,
   maxParamLength: 100,
   onProtoPoisoning: 'error',
   onConstructorPoisoning: 'error',
@@ -76,6 +77,7 @@ const schema = {
       then: { setDefaultValue: true }
     },
     ignoreTrailingSlash: { type: 'boolean', default: defaultInitOptions.ignoreTrailingSlash },
+    ignoreDuplicateSlashes: { type: 'boolean', default: defaultInitOptions.ignoreDuplicateSlashes },
     disableRequestLogging: {
       type: 'boolean',
       default: false

package/docs/Guides/Ecosystem.md

@@ -8,9 +8,6 @@ section.
 
 #### [Core](#core)
 
-- [`aws-lambda-fastify`](https://github.com/fastify/aws-lambda-fastify) allows you to
-  easily build serverless web applications/services and RESTful APIs using Fastify
-  on top of AWS Lambda and Amazon API Gateway.
 - [`@fastify/accepts`](https://github.com/fastify/fastify-accepts) to have
   [accepts](https://www.npmjs.com/package/accepts) in your request object.
 - [`@fastify/accepts-serializer`](https://github.com/fastify/fastify-accepts-serializer)
@@ -19,9 +16,6 @@ section.
   functions in Fastify.
 - [`@fastify/autoload`](https://github.com/fastify/fastify-autoload) Require all
   plugins in a directory.
-- [`fastify-awilix`](https://github.com/fastify/fastify-awilix) Dependency
-  injection support for Fastify, based on
-  [awilix](https://github.com/jeffijoe/awilix).
 - [`@fastify/basic-auth`](https://github.com/fastify/fastify-basic-auth) Basic
   auth plugin for Fastify.
 - [`@fastify/bearer-auth`](https://github.com/fastify/fastify-bearer-auth) Bearer
@@ -93,9 +87,6 @@ section.
   to forward the current HTTP request to another server.
 - [`@fastify/routes`](https://github.com/fastify/fastify-routes) Plugin that
   provides a `Map` of routes.
-- [`fastify-schedule`](https://github.com/fastify/fastify-schedule) Plugin for
-  scheduling periodic jobs, based on
-  [toad-scheduler](https://github.com/kibertoad/toad-scheduler).
 - [`@fastify/sensible`](https://github.com/fastify/fastify-sensible) Defaults for
   Fastify that everyone can agree on. It adds some useful decorators such as
   HTTP errors and assertions, but also more request and reply methods.
@@ -110,6 +101,17 @@ section.
   support for Fastify. Built upon [ws](https://github.com/websockets/ws).
 - [`@fastify/url-data`](https://github.com/fastify/fastify-url-data) Decorate the
   `Request` object with a method to access raw URL components.
+- [`any-schema-you-like`](https://github.com/fastify/any-schema-you-like) Save multiple
+  schemas and decide which one to use to serialize the payload 
+- [`aws-lambda-fastify`](https://github.com/fastify/aws-lambda-fastify) allows you to
+  easily build serverless web applications/services and RESTful APIs using Fastify
+  on top of AWS Lambda and Amazon API Gateway.
+- [`fastify-awilix`](https://github.com/fastify/fastify-awilix) Dependency
+  injection support for Fastify, based on
+  [awilix](https://github.com/jeffijoe/awilix).
+- [`fastify-schedule`](https://github.com/fastify/fastify-schedule) Plugin for
+  scheduling periodic jobs, based on
+  [toad-scheduler](https://github.com/kibertoad/toad-scheduler).
 - [`middie`](https://github.com/fastify/middie) Middleware engine for Fastify.
 - [`point-of-view`](https://github.com/fastify/point-of-view) Templates
   rendering (_ejs, pug, handlebars, marko_) plugin support for Fastify.
@@ -163,6 +165,9 @@ section.
 - [`fastify-amqp`](https://github.com/RafaelGSS/fastify-amqp) Fastify AMQP
   connection plugin, to use with RabbitMQ or another connector. Just a wrapper
   to [`amqplib`](https://github.com/squaremo/amqp.node).
+- [`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)
@@ -306,6 +311,8 @@ section.
   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-knexjs`](https://github.com/chapuletta/fastify-knexjs) Fastify
   plugin for support KnexJS Query Builder.
 - [`fastify-knexjs-mock`](https://github.com/chapuletta/fastify-knexjs-mock)
@@ -346,6 +353,7 @@ section.
   for handling multipart/form-data, which is primarily used for uploading files.
 - [`fastify-nats`](https://github.com/mahmed8003/fastify-nats) Plugin to share
   [NATS](https://nats.io) client across Fastify.
+- [`fastify-next-auth`](https://github.com/wobsoriano/fastify-next-auth) NextAuth.js plugin for Fastify.
 - [`fastify-no-additional-properties`](https://github.com/greguz/fastify-no-additional-properties)
   Add `additionalProperties: false` by default to your JSON Schemas.
 - [`fastify-no-icon`](https://github.com/jsumners/fastify-no-icon) Plugin to
@@ -521,3 +529,7 @@ section.
   Fastify.
 - [`sequelize-fastify`](https://github.com/hsynlms/sequelize-fastify) A simple
   and lightweight Sequelize plugin for Fastify.
+
+#### [Community Tools](#community-tools)
+- [`fast-maker`](https://github.com/imjuni/fast-maker) route configuration generator by 
+  directory structure.

package/docs/Guides/Testing.md

@@ -43,7 +43,9 @@ module.exports = build
 const server = require('./app')({
   logger: {
     level: 'info',
-    prettyPrint: true
+    transport: {
+      target: 'pino-pretty'
+    }
   }
 })
 

package/docs/Reference/Logging.md

@@ -26,13 +26,16 @@ and production environment requires bit more configuration:
 ```js
 const fastify = require('fastify')({
   logger: {
-      prettyPrint:
+      transport:
         environment === 'development'
           ? {
-              translateTime: 'HH:MM:ss Z',
-              ignore: 'pid,hostname'
+              target: 'pino-pretty',
+              options: {
+                translateTime: 'HH:MM:ss Z',
+                ignore: 'pid,hostname'
+              }
             }
-          : false
+          : undefined
     }
 })
 ```
@@ -119,7 +122,9 @@ below (even if it is *not recommended*):
 ```js
 const fastify = require('fastify')({
   logger: {
-    prettyPrint: true,
+    transport: {
+      target: 'pino-pretty'
+    },
     serializers: {
       res (reply) {
         // The default

package/docs/Reference/Routes.md

@@ -114,7 +114,7 @@ fastify.route(options)
   * `slash`: Will register only `/prefix/`.
   * `no-slash`: Will register only `/prefix`.
 
-  Note: this option does not override `ignoreTrailingSlashes` in [Server](./Server.md) configuration.
+  Note: this option does not override `ignoreTrailingSlash` in [Server](./Server.md) configuration.
 
 * `request` is defined in [Request](./Request.md).
 

package/docs/Reference/Server.md

@@ -17,6 +17,7 @@ describes the properties available in that options object.
   - [`maxRequestsPerSocket`](#maxrequestspersocket)
   - [`requestTimeout`](#requesttimeout)
   - [`ignoreTrailingSlash`](#ignoretrailingslash)
+  - [`ignoreDuplicateSlashes`](#ignoreduplicateslashes)
   - [`maxParamLength`](#maxparamlength)
   - [`bodyLimit`](#bodylimit)
   - [`onProtoPoisoning`](#onprotopoisoning)
@@ -203,6 +204,29 @@ fastify.get('/bar', function (req, reply) {
 })
 ```
 
+### `ignoreDuplicateSlashes`
+<a id="factory-ignore-duplicate-slashes"></a>
+
+Fastify uses [find-my-way](https://github.com/delvedor/find-my-way) to handle
+routing. You can use `ignoreDuplicateSlashes` option to remove duplicate slashes
+from the path. It removes duplicate slashes in the route path and in the request
+URL. This option applies to *all* route registrations for the resulting server instance.
+
+Note that when `ignoreTrailingSlash` and `ignoreDuplicateSlashes` are both set to true, Fastify will remove duplicate slashes, and then trailing slashes, meaning //a//b//c// will be converted to /a/b/c.
+
++ Default: `false`
+
+```js
+const fastify = require('fastify')({
+  ignoreDuplicateSlashes: true
+})
+
+// registers "/foo/bar/"
+fastify.get('///foo//bar//', function (req, reply) {
+  reply.send('foo')
+})
+```
+
 ### `maxParamLength`
 <a id="factory-max-param-length"></a>
 
@@ -1061,7 +1085,8 @@ fastify.register(function (instance, opts, done) {
 #### pluginName
 <a id="pluginName"></a>
 
-Name of the current plugin. There are three ways to define a name (in order).
+Name of the current plugin. The root plugin is called `'fastify'`.
+There are three ways to define a name (in order).
 
 1. If you use [fastify-plugin](https://github.com/fastify/fastify-plugin) the
    metadata `name` is used.
@@ -1078,7 +1103,7 @@ Important: If you have to deal with nested plugins, the name differs with the
 usage of the [fastify-plugin](https://github.com/fastify/fastify-plugin) because
 no new scope is created and therefore we have no place to attach contextual
 data. In that case, the plugin name will represent the boot order of all
-involved plugins in the format of `plugin-A -> plugin-B`.
+involved plugins in the format of `fastify -> plugin-A -> plugin-B`.
 
 #### log
 <a id="log"></a>

package/docs/Reference/TypeScript.md

@@ -1284,7 +1284,7 @@ handlers respectfully.
 
 [src](https://github.com/fastify/fastify/blob/main/types/route.d.ts#L78)
 
-An interface than extends RouteShorthandOptions and adds the follow three
+An interface that extends RouteShorthandOptions and adds the following three
 required properties:
 1. `method` which corresponds to a singular [HTTPMethod][HTTPMethods] or a list
    of [HTTPMethods][HTTPMethods]

package/fastify.d.ts

@@ -106,6 +106,7 @@ export type FastifyServerOptions<
   Logger extends FastifyBaseLogger = FastifyLoggerInstance
 > = {
   ignoreTrailingSlash?: boolean,
+  ignoreDuplicateSlashes?: boolean,
   connectionTimeout?: number,
   keepAliveTimeout?: number,
   maxRequestsPerSocket?: number,

package/fastify.js

@@ -1,6 +1,6 @@
 'use strict'
 
-const VERSION = '4.0.0-rc.3'
+const VERSION = '4.0.0-rc.4'
 
 const Avvio = require('avvio')
 const http = require('http')
@@ -166,6 +166,7 @@ function fastify (options) {
       onBadUrl,
       constraints,
       ignoreTrailingSlash: options.ignoreTrailingSlash || defaultInitOptions.ignoreTrailingSlash,
+      ignoreDuplicateSlashes: options.ignoreDuplicateSlashes || defaultInitOptions.ignoreDuplicateSlashes,
       maxParamLength: options.maxParamLength || defaultInitOptions.maxParamLength,
       caseSensitive: options.caseSensitive,
       allowUnsafeRegex: options.allowUnsafeRegex || defaultInitOptions.allowUnsafeRegex,
@@ -218,7 +219,7 @@ function fastify (options) {
     [kRequest]: Request.buildRequest(Request, options.trustProxy),
     [kFourOhFour]: fourOhFour,
     [pluginUtils.registeredPlugins]: [],
-    [kPluginNameChain]: [],
+    [kPluginNameChain]: ['fastify'],
     [kAvvioBoot]: null,
     // routing method
     routing: httpHandler,