fastify 4.0.0-rc.5 → 4.0.2

package/docs/Guides/Ecosystem.md

@@ -12,14 +12,22 @@ section.
   [accepts](https://www.npmjs.com/package/accepts) in your request object.
 - [`@fastify/accepts-serializer`](https://github.com/fastify/fastify-accepts-serializer)
   to serialize to output according to `Accept` header.
+- [`@fastify/any-schema`](https://github.com/fastify/any-schema-you-like) Save
+  multiple schemas and decide which one to use to serialize the payload
 - [`@fastify/auth`](https://github.com/fastify/fastify-auth) Run multiple auth
   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/aws-lambda`](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/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
-  auth plugin for Fastify.
+- [`@fastify/bearer-auth`](https://github.com/fastify/fastify-bearer-auth)
+  Bearer auth plugin for Fastify.
 - [`@fastify/caching`](https://github.com/fastify/fastify-caching) General
   server-side cache and ETag support.
 - [`@fastify/circuit-breaker`](https://github.com/fastify/fastify-circuit-breaker)
@@ -30,7 +38,8 @@ section.
   cookie headers.
 - [`@fastify/cors`](https://github.com/fastify/fastify-cors) Enables the use of
   CORS in a Fastify application.
-- [`@fastify/csrf-protection`](https://github.com/fastify/csrf-protection) A plugin for adding
+- [`@fastify/csrf-protection`](https://github.com/fastify/csrf-protection) A
+  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)
@@ -51,13 +60,16 @@ section.
   function.
 - [`@fastify/helmet`](https://github.com/fastify/fastify-helmet) Important
   security headers for Fastify.
-- [`@fastify/hotwire`](https://github.com/fastify/fastify-hotwire) Use the Hotwire pattern with Fastify.
+- [`@fastify/hotwire`](https://github.com/fastify/fastify-hotwire) Use the
+  Hotwire pattern with Fastify.
 - [`@fastify/http-proxy`](https://github.com/fastify/fastify-http-proxy) Proxy
   your HTTP requests to another server, with hooks.
-- [`@fastify/jwt`](https://github.com/fastify/fastify-jwt) JWT utils for Fastify,
-  internally uses [fast-jwt](https://github.com/nearform/fast-jwt).
+- [`@fastify/jwt`](https://github.com/fastify/fastify-jwt) JWT utils for
+  Fastify, internally uses [fast-jwt](https://github.com/nearform/fast-jwt).
 - [`@fastify/leveldb`](https://github.com/fastify/fastify-leveldb) Plugin to
   share a common LevelDB connection across Fastify.
+- [`@fastify/middie`](https://github.com/fastify/middie) Middleware engine for
+  Fastify.
 - [`@fastify/mongodb`](https://github.com/fastify/fastify-mongodb) Fastify
   MongoDB connection plugin, with which you can share the same MongoDB
   connection pool across every part of your server.
@@ -87,8 +99,11 @@ 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/sensible`](https://github.com/fastify/fastify-sensible) Defaults for
-  Fastify that everyone can agree on. It adds some useful decorators such as
+- [`@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.
 - [`@fastify/session`](https://github.com/fastify/session) a session plugin for
   Fastify.
@@ -97,26 +112,15 @@ section.
 - [`@fastify/swagger`](https://github.com/fastify/fastify-swagger) Plugin for
   serving Swagger/OpenAPI documentation for Fastify, supporting dynamic
   generation.
+- [`@fastify/under-pressure`](https://github.com/fastify/under-pressure) Measure
+  process load with automatic handling of _"Service Unavailable"_ plugin for
+  Fastify.
+- [`@fastify/url-data`](https://github.com/fastify/fastify-url-data) Decorate
+  the `Request` object with a method to access raw URL components.
+- [`@fastify/view`](https://github.com/fastify/point-of-view) Templates
+  rendering (_ejs, pug, handlebars, marko_) plugin support for Fastify.
 - [`@fastify/websocket`](https://github.com/fastify/fastify-websocket) WebSocket
   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.
-- [`under-pressure`](https://github.com/fastify/under-pressure) Measure process
-  load with automatic handling of _"Service Unavailable"_ plugin for Fastify.
 
 #### [Community](#community)
 
@@ -134,7 +138,9 @@ section.
 - [`@immobiliarelabs/fastify-metrics`](https://github.com/immobiliare/fastify-metrics)
   Minimalistic and opinionated plugin that collects usage/process metrics and
   dispatches to [statsd](https://github.com/statsd/statsd).
-- [`@immobiliarelabs/fastify-sentry`](https://github.com/immobiliare/fastify-sentry) Sentry errors handler that just works! Install, add your DSN and you're good to go!
+- [`@immobiliarelabs/fastify-sentry`](https://github.com/immobiliare/fastify-sentry)
+  Sentry errors handler that just works! Install, add your DSN and you're good
+  to go!
 - [`@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)
@@ -250,8 +256,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-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
@@ -302,8 +308,8 @@ section.
   An error handling plugin for Fastify that uses enhanced HTTP errors.
 - [`fastify-https-redirect`](https://github.com/tomsvogel/fastify-https-redirect)
   Fastify plugin for auto-redirect from HTTP to HTTPS.
-- [`fatify-impressions`](https://github.com/manju4ever/fastify-impressions) Fastify
-  plugin to track impressions of all the routes.
+- [`fatify-impressions`](https://github.com/manju4ever/fastify-impressions)
+  Fastify plugin to track impressions of all the routes.
 - [`fastify-influxdb`](https://github.com/alex-ppg/fastify-influxdb) Fastify
   InfluxDB plugin connecting to an InfluxDB instance via the Influx default
   package.
@@ -353,7 +359,8 @@ 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-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
@@ -412,7 +419,8 @@ section.
 - [`fastify-qs`](https://github.com/webdevium/fastify-qs) A plugin for Fastify
   that adds support for parsing URL query parameters with
   [qs](https://github.com/ljharb/qs).
-- [`fastify-racing`](https://github.com/metcoder95/fastify-racing) Fastify's plugin that adds support to handle an aborted request asynchronous.
+- [`fastify-racing`](https://github.com/metcoder95/fastify-racing) Fastify's
+  plugin that adds support to handle an aborted request asynchronous.
 - [`fastify-raw-body`](https://github.com/Eomm/fastify-raw-body) Add the
   `request.rawBody` field.
 - [`fastify-rbac`](https://gitlab.com/m03geek/fastify-rbac) Fastify role-based
@@ -460,7 +468,9 @@ 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-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
@@ -499,8 +509,8 @@ section.
   waterline. Decorates Fastify with waterline models.
 - [`fastify-webpack-hmr`](https://github.com/lependu/fastify-webpack-hmr)
   Webpack hot module reloading plugin for Fastify.
-- [`fastify-webpack-hot`](https://github.com/gajus/fastify-webpack-hot)
-  Webpack Hot Module Replacement for Fastify.
+- [`fastify-webpack-hot`](https://github.com/gajus/fastify-webpack-hot) Webpack
+  Hot Module Replacement for Fastify.
 - [`fastify-ws`](https://github.com/gj/fastify-ws) WebSocket integration for
   Fastify — with support for WebSocket lifecycle hooks instead of a single
   handler function. Built upon [ws](https://github.com/websockets/ws) and
@@ -531,5 +541,5 @@ section.
   and lightweight Sequelize plugin for Fastify.
 
 #### [Community Tools](#community-tools)
-- [`fast-maker`](https://github.com/imjuni/fast-maker) route configuration generator by 
-  directory structure.
+- [`fast-maker`](https://github.com/imjuni/fast-maker) route configuration
+  generator by directory structure.

package/docs/Guides/Index.md

@@ -21,6 +21,8 @@ This table of contents is in alphabetical order.
   written with a fluent API and used in Fastify.
 + [Getting Started](./Getting-Started.md): Introduction tutorial for Fastify.
   This is where beginners should start.
++ [Migration Guide (v4)](./Migration-Guide-V4.md): Details how to migrate to
+  Fastify v4 from earlier versions.
 + [Migration Guide (v3)](./Migration-Guide-V3.md): Details how to migrate to
   Fastify v3 from earlier versions.
 + [Plugins Guide](./Plugins-Guide.md): An informal introduction to writing

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

@@ -15,7 +15,7 @@ framework itself.
 
 If you use Express middleware in your application, please install and register
 the [`@fastify/express`](https://github.com/fastify/fastify-express) or
-[`middie`](https://github.com/fastify/middie) plugin before doing so.
+[`@fastify/middie`](https://github.com/fastify/middie) plugin before doing so.
 
 **v2:**
 

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

@@ -0,0 +1,55 @@
+# V4 Migration Guide
+
+This guide is intended to help with migration from Fastify v3 to v4.
+
+Before migrating to v4, please ensure that you have fixed all deprecation
+warnings from v3. All v3 deprecations have been removed and they will no longer
+work after upgrading.
+
+## Breaking Changes
+
+### Deprecation of `app.use()`
+
+Starting this version of Fastify, we have deprecated the use of `app.use()`. We
+have decided not to support the use of middlewares. Both
+[`@fastify/middie`](https://github.com/fastify/middie) and
+[`@fastify/express`](https://github.com/fastify/fastify-express) will still be
+there and maintained. Use Fastify's [hooks](../Reference/Hooks.md) instead.
+
+## Non Breaking Changes
+
+### Change of schema for multiple types
+
+
+Since Fastiy v4 has upgraded to Ajv v8. The "type" keywords with multiple types
+(other than with "null") are prohibited. Read more
+['here'](https://ajv.js.org/strict-mode.html#strict-types)
+
+You may encounter a console warning such as
+
+```
+strict mode: use allowUnionTypes to allow union type keyword at "#/properties/image" (strictTypes)
+```
+So schemas like below will need to be changed from
+```
+type: 'object',
+properties: {
+  api_key: { type: 'string' },
+  image: { type: ['object', 'array'] }
+  }
+}
+```
+to
+
+```
+type: 'object',
+properties: {
+  api_key: { type: 'string' },
+  image: {
+    anyOf: [
+      { type: 'array' },
+      { type: 'object' }
+    ]
+  }
+}
+```

package/docs/Guides/Plugins-Guide.md

@@ -458,10 +458,10 @@ console.log(new CustomError())
 
 If you want to deprecate an API, or you want to warn the user about a specific
 use case, you can use the
-[`fastify-warning`](https://github.com/fastify/fastify-warning) module.
+[`process-warning`](https://github.com/fastify/process-warning) module.
 
 ```js
-const warning = require('fastify-warning')()
+const warning = require('process-warning')()
 warning.create('FastifyDeprecation', 'FST_ERROR_CODE', 'message')
 warning.emit('FST_ERROR_CODE')
 ```
@@ -475,7 +475,7 @@ will add it to the [*ecosystem*](https://github.com/fastify/fastify#ecosystem)
 section of our documentation!
 
 If you want to see some real-world examples, check out:
-- [`point-of-view`](https://github.com/fastify/point-of-view) Templates
+- [`@fastify/view`](https://github.com/fastify/point-of-view) Templates
   rendering (*ejs, pug, handlebars, marko*) plugin support for Fastify.
 - [`@fastify/mongodb`](https://github.com/fastify/fastify-mongodb) Fastify
   MongoDB connection plugin, with this you can share the same MongoDB connection

package/docs/Guides/Prototype-Poisoning.md

@@ -359,7 +359,7 @@ address.
 We also got lucky by having full access to mitigate it at the source — didn't
 need to send emails to some unknown framework maintainer and hope for a quick
 answer. hapi's total control over all of its dependencies proved its usefulness
-and security again. Not using [hapi](http://hapijs.com)? [Maybe you
+and security again. Not using [hapi](https://hapi.dev)? [Maybe you
 should](https://hueniverse.com/why-you-should-consider-hapi-6163689bd7c2).
 
 ### The after in happy ever-after

package/docs/Guides/Recommendations.md

@@ -172,7 +172,7 @@ backend static-backend
 # with 2 primary servers distributed via round-robin
 # and one backup which is used when the first 2 are not reachable
 # This also assumes your fastify servers are listening on port 80.
-# more info: http://nginx.org/en/docs/http/ngx_http_upstream_module.html
+# more info: https://nginx.org/en/docs/http/ngx_http_upstream_module.html
 upstream fastify_app {
   server 10.10.11.1:80;
   server 10.10.11.2:80;
@@ -257,7 +257,7 @@ server {
   # trustProxy to the address of your NGINX server so the X-Forwarded
   # fields are used by fastify.
   location / {
-    # more info: http://nginx.org/en/docs/http/ngx_http_proxy_module.html
+    # more info: https://nginx.org/en/docs/http/ngx_http_proxy_module.html
     proxy_http_version 1.1;
     proxy_cache_bypass $http_upgrade;
     proxy_set_header Upgrade $http_upgrade;

package/docs/Guides/Serverless.md

@@ -36,8 +36,9 @@ The sample provided allows you to easily build serverless web
 applications/services and RESTful APIs using Fastify on top of AWS Lambda and
 Amazon API Gateway.
 
-*Note: Using [aws-lambda-fastify](https://github.com/fastify/aws-lambda-fastify)
-is just one possible way.*
+*Note: Using
+[@fastify/aws-lambda](https://github.com/fastify/aws-lambda-fastify) is just one
+possible way.*
 
 ### app.js
 
@@ -64,8 +65,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`](#lambdajs) file
-will use this export.
+[`lambda.js`](#lambdajs) file will use this export.
 
 When you execute your Fastify application like always, i.e. `node app.js` *(the
 detection for this could be `require.main === module`)*, you can normally listen
@@ -74,7 +74,7 @@ to your port, so you can still run your Fastify function locally.
 ### lambda.js
 
 ```js
-const awsLambdaFastify = require('aws-lambda-fastify')
+const awsLambdaFastify = require('@fastify/aws-lambda')
 const init = require('./app');
 
 const proxy = awsLambdaFastify(init())
@@ -91,14 +91,13 @@ exports.handler = proxy;
 ```
 
 We just require
-[aws-lambda-fastify](https://github.com/fastify/aws-lambda-fastify) (make sure
-you install the dependency `npm i aws-lambda-fastify`) and our
-[`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
-passed to the `proxy` function of
-[aws-lambda-fastify](https://github.com/fastify/aws-lambda-fastify).
+[@fastify/aws-lambda](https://github.com/fastify/aws-lambda-fastify) (make sure
+you install the dependency `npm i @fastify/aws-lambda`) and our
+[`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 passed to the `proxy` function of
+[@fastify/aws-lambda](https://github.com/fastify/aws-lambda-fastify).
 
 ### Example
 
@@ -237,7 +236,9 @@ gcloud functions logs read
 
 #### Example request to `/hello` endpoint
 ```bash
-curl -X POST https://$GOOGLE_REGION-$GOOGLE_PROJECT.cloudfunctions.net/me -H "Content-Type: application/json" -d '{ "name": "Fastify" }'
+curl -X POST https://$GOOGLE_REGION-$GOOGLE_PROJECT.cloudfunctions.net/me \
+  -H "Content-Type: application/json" \
+  -d '{ "name": "Fastify" }'
 {"message":"Hello Fastify!"}
 ```
 
@@ -443,8 +444,8 @@ 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:
+applications. To use it now, it is as simple as configuring your `vercel.json`
+file like the following:
 
 ```json
 {

package/docs/Guides/Write-Plugin.md

@@ -36,8 +36,8 @@ at:
 - [`@fastify/caching`](https://github.com/fastify/fastify-caching)
 - [`@fastify/compress`](https://github.com/fastify/fastify-compress)
 - [`@fastify/cookie`](https://github.com/fastify/fastify-cookie)
-- [`point-of-view`](https://github.com/fastify/point-of-view)
-- [`under-pressure`](https://github.com/fastify/under-pressure)
+- [`@fastify/under-pressure`](https://github.com/fastify/under-pressure)
+- [`@fastify/view`](https://github.com/fastify/point-of-view)
 
 ## License
 You can license your plugin as you prefer, we do not enforce any kind of
@@ -91,7 +91,7 @@ it to the [ecosystem](https://github.com/fastify/fastify#ecosystem) section of
 our documentation!
 
 If you want to see some real world examples, check out:
-- [`point-of-view`](https://github.com/fastify/point-of-view) Templates
+- [`@fastify/view`](https://github.com/fastify/point-of-view) Templates
   rendering (*ejs, pug, handlebars, marko*) plugin support for Fastify.
 - [`@fastify/mongodb`](https://github.com/fastify/fastify-mongodb) Fastify
   MongoDB connection plugin, with this you can share the same MongoDB connection

package/docs/Reference/ContentTypeParser.md

@@ -2,12 +2,12 @@
 
 ## `Content-Type` Parser
 Natively, Fastify only supports `'application/json'` and `'text/plain'` content
-types. If the content type is not one of these, an `FST_ERR_CTP_INVALID_MEDIA_TYPE` 
-error will be thrown.
+types. If the content type is not one of these, an
+`FST_ERR_CTP_INVALID_MEDIA_TYPE` error will be thrown.
 
-The default charset is `utf-8`. If you need to support different content
-types, you can use the `addContentTypeParser` API. *The default JSON and/or
-plain text parser can be changed or removed.*
+The default charset is `utf-8`. If you need to support different content types,
+you can use the `addContentTypeParser` API. *The default JSON and/or plain text
+parser can be changed or removed.*
 
 *Note: If you decide to specify your own content type with the `Content-Type`
 header, UTF-8 will not be the default. Be sure to include UTF-8 like this
@@ -21,8 +21,11 @@ available only in that scope and its children.
 Fastify automatically adds the parsed request payload to the [Fastify
 request](./Request.md) object which you can access with `request.body`.
 
-Note that for `GET` and `HEAD` requests the payload is never parsed. For `OPTIONS` and `DELETE` requests the payload is only parsed if 
-the content type is given in the content-type header. If it is not given, the [catch-all](#catch-all) parser is not executed as with `POST`, `PUT` and `PATCH`, but the payload is simply not parsed.
+Note that for `GET` and `HEAD` requests the payload is never parsed. For
+`OPTIONS` and `DELETE` requests the payload is only parsed if the content type
+is given in the content-type header. If it is not given, the
+[catch-all](#catch-all) parser is not executed as with `POST`, `PUT` and
+`PATCH`, but the payload is simply not parsed.
 
 ### Usage
 ```js
@@ -69,7 +72,8 @@ more specific one, like in the example below.
 fastify.addContentTypeParser('application/vnd.custom+xml', (request, body, done) => {} )
 fastify.addContentTypeParser('application/vnd.custom', (request, body, done) => {} )
 
-// Here the desired behavior is achieved because fastify first tries to match the `application/vnd.custom+xml` content type parser
+// Here the desired behavior is achieved because fastify first tries to match the
+// `application/vnd.custom+xml` content type parser
 fastify.addContentTypeParser('application/vnd.custom', (request, body, done) => {} )
 fastify.addContentTypeParser('application/vnd.custom+xml', (request, body, done) => {} )
 ```
@@ -115,9 +119,9 @@ fastify.removeContentTypeParser(['application/json', 'text/plain'])
 In the example from just above, it is noticeable that we need to specify each
 content type that we want to remove. To solve this problem Fastify provides the
 `removeAllContentTypeParsers` API. This can be used to remove all currently
-existing content type parsers. In the example below we achieve 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.
+existing content type parsers. In the example below we achieve 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
 built-in parsers should be ignored as well.
@@ -223,8 +227,8 @@ fastify.route({
 For piping file uploads you may want to check out [this
 plugin](https://github.com/fastify/fastify-multipart).
 
-If you want the content type parser to be executed on all content types
-and not only on those that don't have a specific one, you should call the
+If you want the content type parser to be executed on all content types and not
+only on those that don't have a specific one, you should call the
 `removeAllContentTypeParsers` method first.
 
 ```js

package/docs/Reference/Errors.md

@@ -54,9 +54,10 @@ When a custom error handler has been defined through
 receive the error passed to the `done()` callback (or through other supported
 automatic error handling mechanisms). If `setErrorHandler` has been used
 multiple times to define multiple handlers, the error will be routed to the most
-precedent handler defined within the error [encapsulation context](./Encapsulation.md).
-Error handlers are fully encapsulated, so a `setErrorHandler` call within a
-plugin will limit the error handler to that plugin's context.
+precedent handler defined within the error [encapsulation
+context](./Encapsulation.md). Error handlers are fully encapsulated, so a
+`setErrorHandler` call within a plugin will limit the error handler to that
+plugin's context.
 
 The root error handler is Fastify's generic error handler. This error handler
 will use the headers and status code in the `Error` object, if they exist. The
@@ -72,8 +73,8 @@ Some things to consider in your custom error handler:
   - strings, buffers, and streams are sent to the client, with appropriate
     headers (no serialization)
 
-- You can throw a new error in your custom error handler
-	- errors (new error or the received error parameter re-thrown) - will call the parent `errorHandler`.
+- You can throw a new error in your custom error handler - errors (new error or
+	the received error parameter re-thrown) - will call the parent `errorHandler`.
   - `onError` hook will be triggered once only for the first error being thrown.
   - an error will not be triggered twice from a lifecycle hook - Fastify
     internally monitors the error invocation to avoid infinite loops for errors

package/docs/Reference/Middleware.md

@@ -5,7 +5,7 @@
 Starting with Fastify v3.0.0, middleware is not supported out of the box and
 requires an external plugin such as
 [`@fastify/express`](https://github.com/fastify/fastify-express) or
-[`middie`](https://github.com/fastify/middie).
+[`@fastify/middie`](https://github.com/fastify/middie).
 
 
 An example of registering the
@@ -22,11 +22,11 @@ fastify.use(require('ienoopen')())
 fastify.use(require('x-xss-protection')())
 ```
 
-You can also use [`middie`](https://github.com/fastify/middie), which provides
+You can also use [`@fastify/middie`](https://github.com/fastify/middie), which provides
 support for simple Express-style middleware but with improved performance:
 
 ```js
-await fastify.register(require('middie'))
+await fastify.register(require('@fastify/middie'))
 fastify.use(require('cors')())
 ```
 

package/docs/Reference/Plugins.md

@@ -9,10 +9,12 @@ By default, `register` creates a *new scope*, this means that if you make some
 changes to the Fastify instance (via `decorate`), this change will not be
 reflected by the current context ancestors, but only by its descendants. This
 feature allows us to achieve plugin *encapsulation* and *inheritance*, in this
-way we create a *directed acyclic graph* (DAG) and we will not have issues caused
-by cross dependencies.
+way we create a *directed acyclic graph* (DAG) and we will not have issues
+caused by cross dependencies.
 
-You may have already seen in the [Getting Started]((../Guides/Getting-Started.md#your-first-plugin)) guide how easy it is to use this API:
+You may have already seen in the [Getting
+Started]((../Guides/Getting-Started.md#your-first-plugin)) guide how easy it is
+to use this API:
 ```
 fastify.register(plugin, [options])
 ```
@@ -96,9 +98,9 @@ If you pass an option with the key `prefix` with a `string` value, Fastify will
 use it to prefix all the routes inside the register, for more info check
 [here](./Routes.md#route-prefixing).
 
-Be aware that if you use
-[`fastify-plugin`](https://github.com/fastify/fastify-plugin) this option will
-not work.
+Be aware that if you wrap your routes with
+[`fastify-plugin`](https://github.com/fastify/fastify-plugin), this option will
+not work (there is a [workaround](./Routes.md#fastify-plugin) available).
 
 #### Error handling
 <a id="error-handling"></a>