fastify 4.0.0-rc.5 → 4.0.0

package/README.md

@@ -292,7 +292,7 @@ This project is kindly sponsored by:
 - [nearForm](https://nearform.com)
 
 Past Sponsors:
-- [LetzDoIt](http://www.letzdoitapp.com/)
+- [LetzDoIt](https://www.letzdoitapp.com/)
 
 ## License
 

package/docs/Guides/Ecosystem.md

@@ -12,10 +12,18 @@ 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
@@ -58,6 +66,7 @@ section.
   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,6 +96,9 @@ 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.
@@ -97,26 +109,14 @@ section.
 - [`@fastify/swagger`](https://github.com/fastify/fastify-swagger) Plugin for
   serving Swagger/OpenAPI documentation for Fastify, supporting dynamic
   generation.
-- [`@fastify/websocket`](https://github.com/fastify/fastify-websocket) WebSocket
-  support for Fastify. Built upon [ws](https://github.com/websockets/ws).
+- [`@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.
-- [`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
+- [`@fastify/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.
+- [`@fastify/websocket`](https://github.com/fastify/fastify-websocket) WebSocket
+  support for Fastify. Built upon [ws](https://github.com/websockets/ws).
 
 #### [Community](#community)
 

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/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,7 +36,7 @@ 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)
+*Note: Using [@fastify/aws-lambda](https://github.com/fastify/aws-lambda-fastify)
 is just one possible way.*
 
 ### app.js
@@ -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,14 @@ 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
+[@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
-[aws-lambda-fastify](https://github.com/fastify/aws-lambda-fastify).
+[@fastify/aws-lambda](https://github.com/fastify/aws-lambda-fastify).
 
 ### Example
 

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/Migration-Guide-V4.md

@@ -9,4 +9,4 @@ All v3 deprecations have been removed and they will no longer work after upgradi
 
 ### 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 [`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.
+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.

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/Routes.md

@@ -540,7 +540,7 @@ You can provide a `version` key in the `constraints` option to a route.
 Versioned routes allow you to declare multiple handlers for the same HTTP route
 path, which will then be matched according to each request's `Accept-Version`
 header. The `Accept-Version` header value should follow the
-[semver](http://semver.org/) specification, and routes should be declared with
+[semver](https://semver.org/) specification, and routes should be declared with
 exact semver versions for matching.
 
 Fastify will require a request `Accept-Version` header to be set if the route

package/docs/Reference/Validation-and-Serialization.md

@@ -567,10 +567,20 @@ fastify.post('/the/url', { schema }, handler)
 ```
 
 As you can see, the response schema is based on the status code. If you want to
-use the same schema for multiple status codes, you can use `'2xx'`, for example:
+use the same schema for multiple status codes, you can use `'2xx'` or `default`,
+for example:
 ```js
 const schema = {
   response: {
+    default: {
+      type: 'object',
+      properties: {
+        error: { 
+          type: 'boolean', 
+          default: true 
+        }
+      }
+    },
     '2xx': {
       type: 'object',
       properties: {

package/fastify.js

@@ -1,6 +1,6 @@
 'use strict'
 
-const VERSION = '4.0.0-rc.5'
+const VERSION = '4.0.0'
 
 const Avvio = require('avvio')
 const http = require('http')

package/lib/schemas.js

@@ -143,6 +143,9 @@ function getSchemaSerializer (context, statusCode) {
   if (responseSchemaDef[fallbackStatusCode]) {
     return responseSchemaDef[fallbackStatusCode]
   }
+  if (responseSchemaDef.default) {
+    return responseSchemaDef.default
+  }
   return false
 }
 

package/lib/validation.js

@@ -7,7 +7,7 @@ const {
   kSchemaBody: bodySchema,
   kSchemaResponse: responseSchema
 } = require('./symbols')
-const scChecker = /^[1-5]{1}[0-9]{2}$|^[1-5]xx$/
+const scChecker = /^[1-5]{1}[0-9]{2}$|^[1-5]xx$|^default$/
 
 function compileSchemasForSerialization (context, compile) {
   if (!context.schema || !context.schema.response) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastify",
-  "version": "4.0.0-rc.5",
+  "version": "4.0.0",
   "description": "Fast and low overhead web framework, for Node.js",
   "main": "fastify.js",
   "type": "commonjs",

package/test/schema-serialization.test.js

@@ -738,3 +738,33 @@ test('capital X', t => {
     t.equal(res.statusCode, 200)
   })
 })
+
+test('allow default as status code and used as last fallback', t => {
+  t.plan(3)
+  const fastify = Fastify()
+
+  fastify.route({
+    url: '/',
+    method: 'GET',
+    schema: {
+      response: {
+        default: {
+          type: 'object',
+          properties: {
+            name: { type: 'string' },
+            work: { type: 'string' }
+          }
+        }
+      }
+    },
+    handler: (req, reply) => {
+      reply.code(200).send({ name: 'Foo', work: 'Bar', nick: 'Boo' })
+    }
+  })
+
+  fastify.inject('/', (err, res) => {
+    t.error(err)
+    t.same(res.json(), { name: 'Foo', work: 'Bar' })
+    t.equal(res.statusCode, 200)
+  })
+})