fastify 4.28.0 → 5.0.0-alpha.3

package/EXPENSE_POLICY.md

@@ -1,105 +0,0 @@
-# Expense Policy
-
-Fastify collaborators accept donations through the [Open Collective](https://opencollective.com/fastify/)
-platform and [GitHub Sponsors](https://github.com/sponsors/fastify)
-to enhance the project and support the community.
-
-This Collective is run by and for the benefit of the independent contributors to
-the Fastify open source software project.
-This Collective is not endorsed or administered by OpenJS Foundation, Inc.
-(the “OpenJS Foundation”). The OpenJS Foundation does not receive or have
-control over any funds contributed. The OpenJS Foundation does not direct or
-otherwise supervise the actions of any contributor to the Fastify project,
-and all donations made will be expended for the private benefit of or otherwise
-to reimburse individuals that do not have an employer/employee, contractor, or
-other agency relationship with the OpenJS Foundation.
-The Fastify marks used herein are used under license from the OpenJS Foundation
-for the benefit of the open source software community.
-
-The admins of the Fastify Collective are the [lead maintainers](./GOVERNANCE.md)
-of the project.
-
-This document outlines the process for requesting reimbursement or an invoice
-for expenses.
-
-## Reimbursement
-
-Reimbursement is applicable for expenses already paid, such as:
-
-- Stickers
-- Gadgets
-- Hosting
-
-**Before making any purchases**, initiate a [new discussion](https://github.com/orgs/fastify/discussions)
-in the `fastify` organization with the following information:
-
-- What is needed
-- Why it is needed
-- Cost
-- Deadline
-
-Once the discussion is approved by a lead maintainer and with no unresolved objections,
-the purchase can proceed, and an expense can be submitted to the [Open Collective][submit].
-This process takes a minimum of 3 business days from the request to allow time for
-discussion approval.
-
-The discussion helps prevent misunderstandings and ensures the expense is not rejected.
-As a project under the OpenJS Foundation, Fastify benefits from the Foundation's
-resources, including servers, domains, and [travel funds](https://github.com/openjs-foundation/community-fund/tree/main/programs/travel-fund).
-
-Always seek approval first.
-
-## Invoice
-
-Invoices are for services provided to the Fastify project, such as PR reviews,
-documentation, etc.
-A VAT number is not required to submit an invoice.
-Refer to the [Open Collective documentation][openc_docs] for details.
-
-### Adding a bounty to an issue
-
-Issues become eligible for a bounty when the core team adds the `bounty` label,
-with the amount determined by the core team based on `estimated hours * rate`
-(suggested $50 per hour).
-
-> Example: If the estimated time to fix the issue is 2 hours,
-> the bounty will be $100.
-
-To add a bounty:
-
-- Apply the `bounty` label to the issue
-- Comment on the issue with the bounty amount
-- Edit the first comment of the issue using this template:
-
-```
-## 💰 Bounty
-
-This issue has a bounty of [$AMOUNT](LINK TO THE BOUNTY COMMENT).
-_Read more about [the bounty program](./EXPENSE_POLICY.md)_
-```
-
-For discussions on bounties or determining amounts, open a [new discussion](https://github.com/orgs/fastify/discussions/new?category=bounty).
-
-### Outstanding contributions
-
-The lead team can decide to add a bounty to an issue or PR not labeled as `bounty`
-if the contribution is outstanding.
-
-### Claiming a bounty
-
-To claim a bounty:
-
-- Submit a PR that fixes the issue
-- If multiple submissions exist, a core member will choose the best solution
-- Once merged, the PR author can claim the bounty by:
-  - Submitting an expense to the [Open Collective][submit] with the PR link
-  - Adding a comment on the PR with a link to their Open Collective expense to
-    ensure the claimant is the issue resolver
-- The expense will be validated by a lead maintainer and then the payment will be
-  processed by Open Collective
-
-If the Open Collective budget is insufficient, the expense will be rejected.  
-Unclaimed bounties are available for other issues.
-
-[submit]: https://opencollective.com/fastify/expenses/new
-[openc_docs]: https://docs.oscollective.org/how-it-works/basics/invoice-and-reimbursement-examples

package/test/default-route.test.js

@@ -1,88 +0,0 @@
-'use strict'
-
-const t = require('tap')
-const test = t.test
-const Fastify = require('..')
-const { FSTDEP014 } = require('../lib/warnings')
-
-// Silence the standard warning logs. We will test the messages explicitly.
-process.removeAllListeners('warning')
-
-test('setDefaultRoute should emit a deprecation warning', t => {
-  t.plan(2)
-
-  const fastify = Fastify()
-  const defaultRoute = (req, res) => {
-    res.end('hello from defaultRoute')
-  }
-
-  process.on('warning', onWarning)
-  function onWarning (warning) {
-    t.equal(warning.name, 'DeprecationWarning')
-    t.equal(warning.code, FSTDEP014.code)
-  }
-
-  t.teardown(() => {
-    process.removeListener('warning', onWarning)
-    FSTDEP014.emitted = false
-  })
-
-  fastify.setDefaultRoute(defaultRoute)
-})
-
-test('getDefaultRoute should emit a deprecation warning', t => {
-  t.plan(2)
-
-  const fastify = Fastify()
-
-  process.on('warning', onWarning)
-  function onWarning (warning) {
-    t.equal(warning.name, 'DeprecationWarning')
-    t.equal(warning.code, FSTDEP014.code)
-  }
-
-  t.teardown(() => {
-    process.removeListener('warning', onWarning)
-    FSTDEP014.emitted = false
-  })
-
-  fastify.getDefaultRoute()
-})
-
-test('should fail if defaultRoute is not a function', t => {
-  t.plan(1)
-
-  const fastify = Fastify()
-  const defaultRoute = {}
-
-  fastify.get('/', () => {})
-
-  try {
-    fastify.setDefaultRoute(defaultRoute)
-  } catch (error) {
-    t.equal(error.code, 'FST_ERR_DEFAULT_ROUTE_INVALID_TYPE')
-  }
-})
-
-test('correctly sets, returns, and calls defaultRoute', t => {
-  t.plan(3)
-
-  const fastify = Fastify()
-  const defaultRoute = (req, res) => {
-    res.end('hello from defaultRoute')
-  }
-
-  fastify.setDefaultRoute(defaultRoute)
-  const returnedDefaultRoute = fastify.getDefaultRoute()
-  t.equal(returnedDefaultRoute, defaultRoute)
-
-  fastify.get('/', () => {})
-
-  fastify.inject({
-    method: 'GET',
-    url: '/random'
-  }, (err, res) => {
-    t.error(err)
-    t.equal(res.body, 'hello from defaultRoute')
-  })
-})

package/test/listen.deprecated.test.js

@@ -1,229 +0,0 @@
-'use strict'
-
-// Tests for deprecated `.listen` signature. This file should be
-// removed when the deprecation is complete.
-
-const { test, before } = require('tap')
-const Fastify = require('..')
-const helper = require('./helper')
-
-let localhost
-let localhostForURL
-
-process.removeAllListeners('warning')
-
-before(async () => {
-  [localhost, localhostForURL] = await helper.getLoopbackHost()
-})
-
-test('listen accepts a port and a callback', t => {
-  t.plan(2)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0, (err) => {
-    t.equal(fastify.server.address().address, localhost)
-    t.error(err)
-  })
-})
-
-test('listen accepts a port and a callback with (err, address)', t => {
-  t.plan(2)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0, (err, address) => {
-    t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    t.error(err)
-  })
-})
-
-test('listen accepts a port, address, and callback', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0, localhost, (err) => {
-    t.error(err)
-  })
-})
-
-test('listen accepts options, backlog and a callback', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen({
-    port: 0,
-    host: 'localhost'
-  }, 511, (err) => {
-    t.error(err)
-  })
-})
-
-test('listen accepts options (no port), backlog and a callback', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen({
-    host: 'localhost'
-  }, 511, (err) => {
-    t.error(err)
-  })
-})
-
-test('listen accepts options (no host), backlog and a callback', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen({
-    port: 0
-  }, 511, (err) => {
-    t.error(err)
-  })
-})
-
-test('listen accepts options (no port, no host), backlog and a callback', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen({
-    ipv6Only: false
-  }, 511, (err) => {
-    t.error(err)
-  })
-})
-
-test('listen accepts a port, address and a callback with (err, address)', t => {
-  t.plan(2)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0, localhost, (err, address) => {
-    t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    t.error(err)
-  })
-})
-
-test('listen accepts a port, address, backlog and callback', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0, localhost, 511, (err) => {
-    t.error(err)
-  })
-})
-
-test('listen accepts a port, address, backlog and callback with (err, address)', t => {
-  t.plan(2)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0, localhost, 511, (err, address) => {
-    t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    t.error(err)
-  })
-})
-
-test('listen without callback (port zero)', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(0)
-    .then(() => {
-      t.equal(fastify.server.address().address, localhost)
-    })
-})
-
-test('listen without callback (port not given)', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen()
-    .then(() => {
-      t.equal(fastify.server.address().address, localhost)
-    })
-})
-
-test('listen null without callback with (address)', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(null)
-    .then(address => {
-      t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    })
-})
-
-test('listen without port without callback with (address)', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen()
-    .then(address => {
-      t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    })
-})
-
-test('listen with undefined without callback with (address)', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen(undefined)
-    .then(address => {
-      t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    })
-})
-
-test('listen when firstArg is string(pipe) and without backlog', async t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  const address = await fastify.listen('\\\\.\\pipe\\testPipe')
-  t.equal(address, '\\\\.\\pipe\\testPipe')
-})
-
-test('listen when firstArg is string(pipe) and with backlog', async t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  const address = await fastify.listen('\\\\.\\pipe\\testPipe2', 511)
-  t.equal(address, '\\\\.\\pipe\\testPipe2')
-})
-
-test('listen when firstArg is { path: string(pipe) } and with backlog and callback', t => {
-  t.plan(2)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen({ path: '\\\\.\\pipe\\testPipe3' }, 511, (err, address) => {
-    t.error(err)
-    t.equal(address, '\\\\.\\pipe\\testPipe3')
-  })
-})
-
-test('listen accepts a port as string, and callback', t => {
-  t.plan(2)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  const port = 3000
-  fastify.listen(port.toString(), localhost, (err) => {
-    t.equal(fastify.server.address().port, port)
-    t.error(err)
-  })
-})
-
-test('listen accepts a port as string, address and callback', t => {
-  t.plan(3)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  const port = 3000
-  fastify.listen(port.toString(), localhost, (err) => {
-    t.equal(fastify.server.address().port, port)
-    t.equal(fastify.server.address().address, localhost)
-    t.error(err)
-  })
-})
-
-test('listen with invalid port string without callback with (address)', t => {
-  t.plan(1)
-  const fastify = Fastify()
-  t.teardown(fastify.close.bind(fastify))
-  fastify.listen('-1')
-    .then(address => {
-      t.equal(address, `http://${localhostForURL}:${fastify.server.address().port}`)
-    })
-})

package/test/unsupported-httpversion.test.js

@@ -1,31 +0,0 @@
-'use strict'
-
-const net = require('node:net')
-const t = require('tap')
-const Fastify = require('../fastify')
-
-t.test('Will return 505 HTTP error if HTTP version (2.0 when server is 1.1) is not supported', t => {
-  const fastify = Fastify()
-
-  t.teardown(fastify.close.bind(fastify))
-
-  fastify.get('/', (req, reply) => {
-    reply.send({ hello: 'world' })
-  })
-
-  fastify.listen({ port: 0 }, err => {
-    t.error(err)
-
-    const port = fastify.server.address().port
-    const client = net.createConnection({ port }, () => {
-      client.write('GET / HTTP/2.0\r\nHost: example.com\r\n\r\n')
-
-      client.once('data', data => {
-        t.match(data.toString(), /505 HTTP Version Not Supported/i)
-        client.end(() => {
-          t.end()
-        })
-      })
-    })
-  })
-})

package/types/.eslintrc.json

@@ -1,48 +0,0 @@
-{
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/eslint-recommended",
-    "plugin:@typescript-eslint/recommended",
-    "standard"
-  ],
-  "parser": "@typescript-eslint/parser",
-  "plugins": ["@typescript-eslint"],
-  "env": { "node": true },
-  "parserOptions": {
-    "ecmaVersion": 6,
-    "sourceType": "module",
-    "project": "./types/tsconfig.eslint.json",
-    "createDefaultProgram": true
-  },
-  "rules": {
-    "no-console": "off",
-    "@typescript-eslint/indent": ["error", 2],
-    "semi": ["error", "never"],
-    "import/export": "off" // this errors on multiple exports (overload interfaces)
-  },
-  "overrides": [
-    {
-      "files": ["*.d.ts","*.test-d.ts"],
-      "rules": {
-        "@typescript-eslint/no-explicit-any": "off"
-      }
-    },
-    {
-      "files": ["*.test-d.ts"],
-      "rules": {
-        "no-unused-vars": "off",
-        "n/handle-callback-err": "off",
-        "@typescript-eslint/no-empty-function": "off",
-        "@typescript-eslint/explicit-function-return-type": "off",
-        "@typescript-eslint/no-unused-vars": "off",
-        "@typescript-eslint/no-non-null-assertion": "off",
-        "@typescript-eslint/no-misused-promises": ["error", {
-          "checksVoidReturn": false
-        }]
-      },
-      "globals": {
-        "NodeJS": "readonly"
-      }
-    }
-  ]
-}