node-fastify 5.8.3

package/docs/Reference/Warnings.md

@@ -0,0 +1,58 @@
+
+<h1 align="center">Fastify</h1>
+
+**Table of contents**
+- [Warnings](#warnings)
+  - [Warnings In Fastify](#warnings-in-fastify)
+  - [Fastify Warning Codes](#fastify-warning-codes)
+    - [FSTWRN001](#FSTWRN001)
+    - [FSTWRN002](#FSTWRN002)
+  - [Fastify Deprecation Codes](#fastify-deprecation-codes)
+    - [FSTDEP022](#FSTDEP022)
+
+## Warnings
+
+### Warnings In Fastify
+
+Fastify uses Node.js's [warning event](https://nodejs.org/api/process.html#event-warning)
+API to notify users of deprecated features and coding mistakes. Fastify's
+warnings are recognizable by the `FSTWRN` and `FSTDEP` prefixes. When
+encountering such a warning, it is highly recommended to determine the cause
+using the [`--trace-warnings`](https://nodejs.org/api/cli.html#--trace-warnings)
+and [`--trace-deprecation`](https://nodejs.org/api/cli.html#--trace-deprecation)
+flags. These produce stack traces pointing to where the issue occurs in the
+application's code. Issues opened about warnings without this information will
+be closed due to lack of details.
+
+Warnings can also be disabled, though it is not recommended. If necessary, use
+one of the following methods:
+
+- Set the `NODE_NO_WARNINGS` environment variable to `1`
+- Pass the `--no-warnings` flag to the node process
+- Set `no-warnings` in the `NODE_OPTIONS` environment variable
+
+For more information on disabling warnings, see [Node's documentation](https://nodejs.org/api/cli.html).
+
+Disabling warnings may cause issues when upgrading Fastify versions. Only
+experienced users should consider disabling warnings.
+
+### Fastify Warning Codes
+
+| Code | Description | How to solve | Discussion |
+| ---- | ----------- | ------------ | ---------- |
+| <a id="FSTWRN001">FSTWRN001</a> | The specified schema for a route is missing. This may indicate the schema is not well specified. | Check the schema for the route. | [#4647](https://github.com/fastify/fastify/pull/4647) |
+| <a id="FSTWRN002">FSTWRN002</a> | The %s plugin being registered mixes async and callback styles, which will result in an error in `fastify@5`. | Do not mix async and callback style. | [#5139](https://github.com/fastify/fastify/pull/5139) |
+
+
+### Fastify Deprecation Codes
+
+Deprecation codes are supported by the Node.js CLI options:
+
+- [--no-deprecation](https://nodejs.org/api/cli.html#--no-deprecation)
+- [--throw-deprecation](https://nodejs.org/api/cli.html#--throw-deprecation)
+- [--trace-deprecation](https://nodejs.org/api/cli.html#--trace-deprecation)
+
+
+| Code | Description | How to solve | Discussion |
+| ---- | ----------- | ------------ | ---------- |
+| <a id="FSTDEP022">FSTDEP022</a> | You are trying to access the deprecated router options on top option properties. | Use `options.routerOptions`. | [#5985](https://github.com/fastify/fastify/pull/5985)

package/docs/index.md

@@ -0,0 +1,24 @@
+<h1 align="center">Fastify</h1>
+
+The documentation for Fastify is split into two categories:
+
+- [Reference documentation](./Reference/Index.md)
+- [Guides](./Guides/Index.md)
+
+The reference documentation utilizes a very formal style in an effort to document
+Fastify's API and implementation details thoroughly for the developer who needs
+such. The guides category utilizes an informal educational style as a means to
+introduce newcomers to core and advanced Fastify concepts.
+
+## Where To Start
+
+Complete newcomers to Fastify should first read our [Getting
+Started](./Guides/Getting-Started.md) guide.
+
+Developers experienced with Fastify should consult the [reference
+documentation](./Reference/Index.md) directly to find the topic they are seeking
+more information about.
+
+## Additional Documentation
+
+- Fastify's [Long Term Support (LTS)](./Reference/LTS.md) policy

package/docs/resources/encapsulation_context.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2020-12-06T18:51:58.018Z" agent="5.0 (Macintosh; Intel Mac OS X 10_15_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36" etag="vyaguDTT1c9e-NqGeV_7" version="13.10.9" type="device"><diagram id="hZ89Y7exsLGRT07QCK17" name="Page-1">7ZpPk5owGMY/jcd2SCKIx0q3todOO+thjzsRAmQ2Eopx1f30DRKUNLCrncXN6uKMA0/+EN5feJNndICCxWZa4Dz9ySPCBtCJNgP0dQDhaDiS36WwrQQfOJWQFDSqJHAQZvSJKLGutqIRWWoVBedM0FwXQ55lJBSahouCr/VqMWf6XXOcEEOYhZiZ6h2NRKqewnUO+ndCk7S+M3BUyQLXlZWwTHHE1w0J3QxQUHAuqrPFJiCsjF0dl6rdt47S/cAKkoljGjyhO8+Z3U9YQP3bP1PHvc9+fFK9PGK2Ug98Ww4IOgHPBNkINXSxreOxTqkgsxyH5fVaIh+gSSoWTF4BeYqXeUUhphsibzyJKWMBZ7zYNUexW36k/kgKQWWYvzCaZLJM8LKngq+yqGy362wpCv5AGq293VH2KkfX0KtD6mZM6geUtyObhqRiNCV8QUSxlVVU6VDh2uqX6wN8d6y0tAF+L2I14ZJ9zwcm8kRhOQER6kL0m60SmhmE5DzLy9O84CFZytFMXmA2x+FDsov8r5VgNCNK12H8CzKOYRi2QYq8ued6rwMDOq5Gwzdp+C0wUF8shtfMYmwXC/eKWSDfLhbATFJG/MtQ5sc/+35Jx/O6B+fZmABPz9wAmUFBXktU+guLZ0QlSKncgHQvr/rcemGCdk299rX1lAn5POSXp+nbhXzUGfI3TQsRJn7cmha80CfzuBcKdan+XrS8FmfNFf4HIZOQXYjGBiJp7rIo7DF57cN/ZPLqHwrUmdQrbjO1wRYoALp9LbKOnW8OAZFLRm2Qxt4I4X5WmNqtjT7rOyEA3norZFrqq6cEkH2Y4AcmI+MhaB0m03EbYM5tLFCL2zrzLheY5vddO4thByubnAXodnOXsnE9HoOd1gJcvvv7D0SWMTL93/s3FydTsc9cmJ7PilfnFfdDJ0Oyz1zAy7eApyc4+8wFvHwPeHrGO6e5kJeHH9Z3ZY1/J6Cbvw==</diagram></mxfile>

package/docs/resources/encapsulation_context.svg

@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="591px" height="591px" viewBox="-0.5 -0.5 591 591" content="&lt;mxfile host=&quot;app.diagrams.net&quot; modified=&quot;2020-12-06T18:52:11.078Z&quot; agent=&quot;5.0 (Macintosh; Intel Mac OS X 10_15_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36&quot; etag=&quot;_w1zgMmeoq0M6WH2W2QF&quot; version=&quot;13.10.9&quot; type=&quot;device&quot;&gt;&lt;diagram id=&quot;hZ89Y7exsLGRT07QCK17&quot; name=&quot;Page-1&quot;&gt;7ZpPk5owGMY/jcd2SCKIx0q3todOO+thjzsRAmQ2Eopx1f30DRKUNLCrncXN6uKMA0/+EN5feJNndICCxWZa4Dz9ySPCBtCJNgP0dQDhaDiS36WwrQQfOJWQFDSqJHAQZvSJKLGutqIRWWoVBedM0FwXQ55lJBSahouCr/VqMWf6XXOcEEOYhZiZ6h2NRKqewnUO+ndCk7S+M3BUyQLXlZWwTHHE1w0J3QxQUHAuqrPFJiCsjF0dl6rdt47S/cAKkoljGjyhO8+Z3U9YQP3bP1PHvc9+fFK9PGK2Ug98Ww4IOgHPBNkINXSxreOxTqkgsxyH5fVaIh+gSSoWTF4BeYqXeUUhphsibzyJKWMBZ7zYNUexW36k/kgKQWWYvzCaZLJM8LKngq+yqGy362wpCv5AGq293VH2KkfX0KtD6mZM6geUtyObhqRiNCV8QUSxlVVU6VDh2uqX6wN8d6y0tAF+L2I14ZJ9zwcm8kRhOQER6kL0m60SmhmE5DzLy9O84CFZytFMXmA2x+FDsov8r5VgNCNK12H8CzKOYRi2QYq8ued6rwMDOq5Gwzdp+C0wUF8shtfMYmwXC/eKWSDfLhbATFJG/MtQ5sc/+35Jx/O6B+fZmABPz9wAmUFBXktU+guLZ0QlSKncgHQvr/rcemGCdk299rX1lAn5POSXp+nbhXzUGfI3TQsRJn7cmha80CfzuBcKdan+XrS8FmfNFf4HIZOQXYjGBiJp7rIo7DF57cN/ZPLqHwrUmdQrbjO1wRYoALp9LbKOnW8OAZFLRm2Qxt4I4X5WmNqtjT7rOyEA3norZFrqq6cEkH2Y4AcmI+MhaB0m03EbYM5tLFCL2zrzLheY5vddO4thByubnAXodnOXsnE9HoOd1gJcvvv7D0SWMTL93/s3FydTsc9cmJ7PilfnFfdDJ0Oyz1zAy7eApyc4+8wFvHwPeHrGO6e5kJeHH9Z3ZY1/J6Cbvw==&lt;/diagram&gt;&lt;/mxfile&gt;"><defs/><g><rect x="0" y="0" width="590" height="590" rx="88.5" ry="88.5" fill="#f5f5f5" stroke="#666666" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 588px; height: 1px; padding-top: 7px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #333333; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Root Context</div></div></div></foreignObject><text x="295" y="19" fill="#333333" font-family="Helvetica" font-size="12px" text-anchor="middle">Root Context</text></switch></g><rect x="165" y="40" width="80" height="30" rx="4.5" ry="4.5" fill="#fff2cc" stroke="#d6b656" pointer-events="all"/><path d="M 173 40 L 173 70 M 237 40 L 237 70" fill="none" stroke="#d6b656" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 55px; margin-left: 174px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Root Plugin</div></div></div></foreignObject><text x="205" y="59" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Root Plugin</text></switch></g><rect x="255" y="40" width="80" height="30" rx="4.5" ry="4.5" fill="#fff2cc" stroke="#d6b656" pointer-events="all"/><path d="M 263 40 L 263 70 M 327 40 L 327 70" fill="none" stroke="#d6b656" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 55px; margin-left: 264px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Root Plugin</div></div></div></foreignObject><text x="295" y="59" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Root Plugin</text></switch></g><rect x="345" y="40" width="80" height="30" rx="4.5" ry="4.5" fill="#fff2cc" stroke="#d6b656" pointer-events="all"/><path d="M 353 40 L 353 70 M 417 40 L 417 70" fill="none" stroke="#d6b656" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 55px; margin-left: 354px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Root Plugin</div></div></div></foreignObject><text x="385" y="59" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Root Plugin</text></switch></g><rect x="120" y="90" width="360" height="230" rx="34.5" ry="34.5" fill="#fff2cc" stroke="#d6b656" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 358px; height: 1px; padding-top: 97px; margin-left: 121px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Context</div></div></div></foreignObject><text x="300" y="109" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Context</text></switch></g><rect x="130" y="120" width="80" height="30" rx="4.5" ry="4.5" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><path d="M 138 120 L 138 150 M 202 120 L 202 150" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 135px; margin-left: 139px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="170" y="139" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="220" y="120" width="80" height="30" rx="4.5" ry="4.5" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><path d="M 228 120 L 228 150 M 292 120 L 292 150" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 135px; margin-left: 229px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="260" y="139" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="140" y="175" width="320" height="125" rx="18.75" ry="18.75" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 318px; height: 1px; padding-top: 182px; margin-left: 141px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Grandchild Context</div></div></div></foreignObject><text x="300" y="194" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Grandchild Context</text></switch></g><rect x="167.5" y="200" width="80" height="30" rx="4.5" ry="4.5" fill="#e1d5e7" stroke="#9673a6" pointer-events="all"/><path d="M 175.5 200 L 175.5 230 M 239.5 200 L 239.5 230" fill="none" stroke="#9673a6" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 215px; margin-left: 177px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="208" y="219" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="257.5" y="200" width="80" height="30" rx="4.5" ry="4.5" fill="#e1d5e7" stroke="#9673a6" pointer-events="all"/><path d="M 265.5 200 L 265.5 230 M 329.5 200 L 329.5 230" fill="none" stroke="#9673a6" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 215px; margin-left: 267px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="298" y="219" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="352.5" y="200" width="80" height="30" rx="4.5" ry="4.5" fill="#e1d5e7" stroke="#9673a6" pointer-events="all"/><path d="M 360.5 200 L 360.5 230 M 424.5 200 L 424.5 230" fill="none" stroke="#9673a6" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 215px; margin-left: 362px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="393" y="219" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="120" y="340" width="360" height="230" rx="34.5" ry="34.5" fill="#fff2cc" stroke="#d6b656" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 358px; height: 1px; padding-top: 347px; margin-left: 121px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Context</div></div></div></foreignObject><text x="300" y="359" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Context</text></switch></g><rect x="130" y="370" width="80" height="30" rx="4.5" ry="4.5" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><path d="M 138 370 L 138 400 M 202 370 L 202 400" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 385px; margin-left: 139px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="170" y="389" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="220" y="370" width="80" height="30" rx="4.5" ry="4.5" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><path d="M 228 370 L 228 400 M 292 370 L 292 400" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 385px; margin-left: 229px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="260" y="389" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="140" y="425" width="320" height="125" rx="18.75" ry="18.75" fill="#dae8fc" stroke="#6c8ebf" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe center; width: 318px; height: 1px; padding-top: 432px; margin-left: 141px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Grandchild Context</div></div></div></foreignObject><text x="300" y="444" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Grandchild Context</text></switch></g><rect x="167.5" y="450" width="80" height="30" rx="4.5" ry="4.5" fill="#e1d5e7" stroke="#9673a6" pointer-events="all"/><path d="M 175.5 450 L 175.5 480 M 239.5 450 L 239.5 480" fill="none" stroke="#9673a6" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 465px; margin-left: 177px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="208" y="469" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="257.5" y="450" width="80" height="30" rx="4.5" ry="4.5" fill="#e1d5e7" stroke="#9673a6" pointer-events="all"/><path d="M 265.5 450 L 265.5 480 M 329.5 450 L 329.5 480" fill="none" stroke="#9673a6" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 465px; margin-left: 267px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="298" y="469" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g><rect x="352.5" y="450" width="80" height="30" rx="4.5" ry="4.5" fill="#e1d5e7" stroke="#9673a6" pointer-events="all"/><path d="M 360.5 450 L 360.5 480 M 424.5 450 L 424.5 480" fill="none" stroke="#9673a6" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 62px; height: 1px; padding-top: 465px; margin-left: 362px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">Child Plugin</div></div></div></foreignObject><text x="393" y="469" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Child Plug...</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://desk.draw.io/support/solutions/articles/16000042487" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Viewer does not support full SVG 1.1</text></a></switch></svg>

package/eslint.config.js

@@ -0,0 +1,35 @@
+'use strict'
+const neostandard = require('neostandard')
+
+module.exports = [
+  ...neostandard({
+    ignores: [
+      'lib/config-validator.js',
+      'lib/error-serializer.js',
+      'test/same-shape.test.js',
+      'test/types/import.js'
+    ],
+    ts: true
+  }),
+  {
+    rules: {
+      'comma-dangle': ['error', 'never'],
+      'max-len': ['error', {
+        code: 120,
+        tabWidth: 2,
+        ignoreUrls: true,
+        ignoreStrings: true,
+        ignoreTemplateLiterals: true,
+        ignoreRegExpLiterals: true,
+        ignoreComments: true,
+        ignoreTrailingComments: true
+      }]
+    }
+  },
+  {
+    files: ['**/*.d.ts'],
+    rules: {
+      'max-len': 'off'
+    }
+  }
+]

package/examples/asyncawait.js

@@ -0,0 +1,38 @@
+'use strict'
+
+const fastify = require('../fastify')({ logger: true })
+
+const schema = {
+  schema: {
+    response: {
+      200: {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+function result () {
+  return Promise.resolve({ hello: 'world' })
+}
+
+fastify
+  .get('/await', schema, async function (req, reply) {
+    reply.header('Content-Type', 'application/json').code(200)
+    return result()
+  })
+  .get('/', schema, async function (req, reply) {
+    reply.header('Content-Type', 'application/json').code(200)
+    return { hello: 'world' }
+  })
+
+fastify.listen({ port: 3000 }, err => {
+  if (err) {
+    throw err
+  }
+})

package/examples/benchmark/body.json

@@ -0,0 +1,3 @@
+{
+  "hello": "world"
+}

package/examples/benchmark/hooks-benchmark-async-await.js

@@ -0,0 +1,44 @@
+'use strict'
+
+const fastify = require('../../fastify')({ logger: false })
+
+const opts = {
+  schema: {
+    response: {
+      200: {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+function promiseFunction (resolve) {
+  setImmediate(resolve)
+}
+
+async function asyncHook () {
+  await new Promise(promiseFunction)
+}
+
+fastify
+  .addHook('onRequest', asyncHook)
+  .addHook('onRequest', asyncHook)
+  .addHook('preHandler', asyncHook)
+  .addHook('preHandler', asyncHook)
+  .addHook('preHandler', asyncHook)
+  .addHook('onSend', asyncHook)
+
+fastify.get('/', opts, function (request, reply) {
+  reply.send({ hello: 'world' })
+})
+
+fastify.listen({ port: 3000 }, function (err) {
+  if (err) {
+    throw err
+  }
+})

package/examples/benchmark/hooks-benchmark.js

@@ -0,0 +1,52 @@
+'use strict'
+
+const fastify = require('../../fastify')({ logger: false })
+
+const opts = {
+  schema: {
+    response: {
+      200: {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+fastify
+  .addHook('onRequest', function (request, reply, done) {
+    done()
+  })
+  .addHook('onRequest', function (request, reply, done) {
+    done()
+  })
+
+fastify
+  .addHook('preHandler', function (request, reply, done) {
+    done()
+  })
+  .addHook('preHandler', function (request, reply, done) {
+    setImmediate(done)
+  })
+  .addHook('preHandler', function (request, reply, done) {
+    done()
+  })
+
+fastify
+  .addHook('onSend', function (request, reply, payload, done) {
+    done()
+  })
+
+fastify.get('/', opts, function (request, reply) {
+  reply.send({ hello: 'world' })
+})
+
+fastify.listen({ port: 3000 }, function (err) {
+  if (err) {
+    throw err
+  }
+})

package/examples/benchmark/parser.js

@@ -0,0 +1,47 @@
+'use strict'
+
+const fastify = require('../../fastify')({
+  logger: false
+})
+
+const jsonParser = require('fast-json-body')
+const querystring = require('node:querystring')
+
+// Handled by fastify
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/json' http://localhost:3000/
+
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/jsoff' http://localhost:3000/
+fastify.addContentTypeParser('application/jsoff', function (request, payload, done) {
+  jsonParser(payload, function (err, body) {
+    done(err, body)
+  })
+})
+
+// curl -X POST -d 'hello=world' -H'Content-type: application/x-www-form-urlencoded' http://localhost:3000/
+fastify.addContentTypeParser('application/x-www-form-urlencoded', function (request, payload, done) {
+  let body = ''
+  payload.on('data', function (data) {
+    body += data
+  })
+  payload.on('end', function () {
+    try {
+      const parsed = querystring.parse(body)
+      done(null, parsed)
+    } catch (e) {
+      done(e)
+    }
+  })
+  payload.on('error', done)
+})
+
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/vnd.custom+json' http://localhost:3000/
+fastify.addContentTypeParser(/^application\/.+\+json$/, { parseAs: 'string' }, fastify.getDefaultJsonParser('error', 'ignore'))
+
+fastify
+  .post('/', function (req, reply) {
+    reply.send(req.body)
+  })
+
+fastify.listen({ port: 3000 }, (err, address) => {
+  if (err) throw err
+})

package/examples/benchmark/simple.js

@@ -0,0 +1,30 @@
+'use strict'
+
+const fastify = require('../../fastify')({
+  logger: false
+})
+
+const schema = {
+  schema: {
+    response: {
+      200: {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+fastify
+  .get('/', schema, function (req, reply) {
+    reply
+      .send({ hello: 'world' })
+  })
+
+fastify.listen({ port: 3000 }, (err, address) => {
+  if (err) throw err
+})

package/examples/benchmark/webstream.js

@@ -0,0 +1,27 @@
+'use strict'
+
+const fastify = require('../../fastify')({
+  logger: false
+})
+
+const payload = JSON.stringify({ hello: 'world' })
+
+fastify.get('/', function (req, reply) {
+  const stream = new ReadableStream({
+    start (controller) {
+      controller.enqueue(payload)
+      controller.close()
+    }
+  })
+  return new Response(stream, {
+    status: 200,
+    headers: {
+      'content-type': 'application/json; charset=utf-8'
+    }
+  })
+})
+
+fastify.listen({ port: 3000 }, (err, address) => {
+  if (err) throw err
+  console.log(`Server listening on ${address}`)
+})

package/examples/hooks.js

@@ -0,0 +1,91 @@
+'use strict'
+
+const fastify = require('../fastify')({ logger: true })
+
+const opts = {
+  schema: {
+    response: {
+      '2xx': {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+const optsPost = {
+  schema: {
+    body: {
+      type: 'object',
+      required: ['hello'],
+      properties: {
+        hello: {
+          type: 'string'
+        }
+      }
+    },
+    response: opts.response
+  }
+}
+
+fastify
+  .addHook('onRequest', function (request, reply, done) {
+    console.log('onRequest')
+    done()
+  })
+  .addHook('preParsing', function (request, reply, payload, done) {
+    console.log('preParsing')
+    done()
+  })
+  .addHook('preValidation', function (request, reply, done) {
+    console.log('preValidation')
+    done()
+  })
+  .addHook('preHandler', function (request, reply, done) {
+    console.log('preHandler')
+    done()
+  })
+  .addHook('preSerialization', function (request, reply, payload, done) {
+    console.log('preSerialization', payload)
+    done()
+  })
+  .addHook('onError', function (request, reply, error, done) {
+    console.log('onError', error.message)
+    done()
+  })
+  .addHook('onSend', function (request, reply, payload, done) {
+    console.log('onSend', payload)
+    done()
+  })
+  .addHook('onResponse', function (request, reply, done) {
+    console.log('onResponse')
+    done()
+  })
+  .addHook('onRoute', function (routeOptions) {
+    console.log('onRoute')
+  })
+  .addHook('onListen', async function () {
+    console.log('onListen')
+  })
+  .addHook('onClose', function (instance, done) {
+    console.log('onClose')
+    done()
+  })
+
+fastify.get('/', opts, function (req, reply) {
+  reply.send({ hello: 'world' })
+})
+
+fastify.post('/', optsPost, function (req, reply) {
+  reply.send({ hello: 'world' })
+})
+
+fastify.listen({ port: 3000 }, function (err) {
+  if (err) {
+    throw err
+  }
+})

package/examples/http2.js

@@ -0,0 +1,39 @@
+'use strict'
+
+const fs = require('node:fs')
+const path = require('node:path')
+const fastify = require('../fastify')({
+  http2: true,
+  https: {
+    key: fs.readFileSync(path.join(__dirname, '../test/https/fastify.key')),
+    cert: fs.readFileSync(path.join(__dirname, '../test/https/fastify.cert'))
+  },
+  logger: true
+})
+
+const opts = {
+  schema: {
+    response: {
+      '2xx': {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+fastify
+  .get('/', opts, function (req, reply) {
+    reply.header('Content-Type', 'application/json').code(200)
+    reply.send({ hello: 'world' })
+  })
+
+fastify.listen({ port: 3000 }, err => {
+  if (err) {
+    throw err
+  }
+})

package/examples/https.js

@@ -0,0 +1,38 @@
+'use strict'
+
+const fs = require('node:fs')
+const path = require('node:path')
+const fastify = require('../fastify')({
+  https: {
+    key: fs.readFileSync(path.join(__dirname, '../test/https/fastify.key')),
+    cert: fs.readFileSync(path.join(__dirname, '../test/https/fastify.cert'))
+  },
+  logger: true
+})
+
+const opts = {
+  schema: {
+    response: {
+      '2xx': {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      }
+    }
+  }
+}
+
+fastify
+  .get('/', opts, function (req, reply) {
+    reply.header('Content-Type', 'application/json').code(200)
+    reply.send({ hello: 'world' })
+  })
+
+fastify.listen({ port: 3000 }, err => {
+  if (err) {
+    throw err
+  }
+})

package/examples/parser.js

@@ -0,0 +1,53 @@
+'use strict'
+
+const fastify = require('../fastify')({ logger: true })
+const jsonParser = require('fast-json-body')
+const querystring = require('node:querystring')
+
+// Handled by fastify
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/json' http://localhost:3000/
+
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/jsoff' http://localhost:3000/
+fastify.addContentTypeParser('application/jsoff', function (request, payload, done) {
+  jsonParser(payload, function (err, body) {
+    done(err, body)
+  })
+})
+
+// curl -X POST -d 'hello=world' -H'Content-type: application/x-www-form-urlencoded' http://localhost:3000/
+fastify.addContentTypeParser('application/x-www-form-urlencoded', function (request, payload, done) {
+  let body = ''
+  payload.on('data', function (data) {
+    body += data
+  })
+  payload.on('end', function () {
+    try {
+      const parsed = querystring.parse(body)
+      done(null, parsed)
+    } catch (e) {
+      done(e)
+    }
+  })
+  payload.on('error', done)
+})
+
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/vnd.custom+json' http://localhost:3000/
+fastify.addContentTypeParser(/^application\/.+\+json$/, { parseAs: 'string' }, fastify.getDefaultJsonParser('error', 'ignore'))
+
+// remove default json parser
+// curl -X POST -d '{"hello":"world"}' -H'Content-type: application/json' http://localhost:3000/ is now no longer handled by fastify
+fastify.removeContentTypeParser('application/json')
+
+// This call would remove any content type parser
+// fastify.removeAllContentTypeParsers()
+
+fastify
+  .post('/', function (req, reply) {
+    reply.send(req.body)
+  })
+
+fastify.listen({ port: 3000 }, err => {
+  if (err) {
+    throw err
+  }
+})