fastify 5.8.5 → 5.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/PROJECT_CHARTER.md +1 -1
  2. package/README.md +7 -10
  3. package/SECURITY.md +1 -1
  4. package/SPONSORS.md +6 -4
  5. package/build/build-validation.js +2 -2
  6. package/docs/Guides/Database.md +0 -28
  7. package/docs/Guides/Delay-Accepting-Requests.md +1 -1
  8. package/docs/Guides/Ecosystem.md +23 -9
  9. package/docs/Guides/Getting-Started.md +2 -2
  10. package/docs/Guides/Migration-Guide-V4.md +2 -2
  11. package/docs/Guides/Migration-Guide-V5.md +1 -1
  12. package/docs/Guides/Plugins-Guide.md +1 -1
  13. package/docs/Guides/Prototype-Poisoning.md +3 -3
  14. package/docs/Guides/Serverless.md +8 -15
  15. package/docs/Guides/Style-Guide.md +1 -1
  16. package/docs/Guides/Write-Plugin.md +1 -1
  17. package/docs/Reference/Encapsulation.md +27 -26
  18. package/docs/Reference/Errors.md +12 -4
  19. package/docs/Reference/HTTP2.md +10 -10
  20. package/docs/Reference/Hooks.md +5 -5
  21. package/docs/Reference/Index.md +14 -16
  22. package/docs/Reference/LTS.md +12 -13
  23. package/docs/Reference/Lifecycle.md +9 -8
  24. package/docs/Reference/Logging.md +47 -39
  25. package/docs/Reference/Middleware.md +21 -25
  26. package/docs/Reference/Principles.md +2 -2
  27. package/docs/Reference/Reply.md +6 -1
  28. package/docs/Reference/Request.md +29 -18
  29. package/docs/Reference/Routes.md +5 -2
  30. package/docs/Reference/Server.md +138 -11
  31. package/docs/Reference/Type-Providers.md +53 -9
  32. package/docs/Reference/TypeScript.md +3 -3
  33. package/docs/Reference/Validation-and-Serialization.md +15 -2
  34. package/docs/Reference/Warnings.md +11 -6
  35. package/eslint.config.js +7 -2
  36. package/fastify.d.ts +13 -3
  37. package/fastify.js +60 -31
  38. package/lib/content-type-parser.js +2 -0
  39. package/lib/content-type.js +34 -1
  40. package/lib/context.js +0 -3
  41. package/lib/decorate.js +11 -3
  42. package/lib/error-handler.js +10 -28
  43. package/lib/error-serializer.js +59 -59
  44. package/lib/errors.js +23 -1
  45. package/lib/four-oh-four.js +22 -19
  46. package/lib/handle-request.js +12 -5
  47. package/lib/log-controller.js +169 -0
  48. package/lib/logger-factory.js +25 -4
  49. package/lib/plugin-override.js +2 -1
  50. package/lib/plugin-utils.js +5 -5
  51. package/lib/reply.js +96 -50
  52. package/lib/req-id-gen-factory.js +4 -1
  53. package/lib/request.js +16 -6
  54. package/lib/route.js +47 -41
  55. package/lib/schema-controller.js +1 -1
  56. package/lib/schemas.js +37 -30
  57. package/lib/symbols.js +4 -2
  58. package/lib/validation.js +10 -13
  59. package/lib/warnings.js +22 -4
  60. package/package.json +15 -17
  61. package/scripts/validate-ecosystem-links.js +1 -0
  62. package/test/bundler/esbuild/package.json +1 -1
  63. package/test/close-pipelining.test.js +1 -2
  64. package/test/content-type.test.js +20 -0
  65. package/test/custom-http-server.test.js +38 -0
  66. package/test/decorator-instance-properties.test.js +63 -0
  67. package/test/diagnostics-channel/async-error-handler.test.js +74 -0
  68. package/test/genReqId.test.js +24 -0
  69. package/test/hooks.test.js +94 -0
  70. package/test/http-methods/get.test.js +1 -1
  71. package/test/http2/plain.test.js +135 -0
  72. package/test/http2/secure-with-fallback.test.js +1 -1
  73. package/test/https/https.test.js +1 -2
  74. package/test/internals/errors.test.js +31 -1
  75. package/test/internals/logger.test.js +322 -0
  76. package/test/internals/plugin.test.js +3 -1
  77. package/test/internals/reply.test.js +35 -4
  78. package/test/internals/request.test.js +37 -10
  79. package/test/internals/schema-controller-perf.test.js +33 -0
  80. package/test/logger/logging.test.js +57 -1
  81. package/test/logger/options.test.js +38 -1
  82. package/test/reply-error.test.js +1 -1
  83. package/test/reply-trailers.test.js +70 -0
  84. package/test/request-media-type.test.js +105 -0
  85. package/test/route-prefix.test.js +34 -0
  86. package/test/router-options.test.js +222 -11
  87. package/test/schema-serialization.test.js +108 -0
  88. package/test/schema-validation.test.js +24 -0
  89. package/test/scripts/validate-ecosystem-links.test.js +40 -57
  90. package/test/stream.4.test.js +2 -2
  91. package/test/throw.test.js +14 -0
  92. package/test/trust-proxy.test.js +70 -30
  93. package/test/types/content-type-parser.tst.ts +70 -0
  94. package/test/types/{decorate-request-reply.test-d.ts → decorate-request-reply.tst.ts} +4 -4
  95. package/test/types/{dummy-plugin.ts → dummy-plugin.mts} +1 -1
  96. package/test/types/errors.tst.ts +91 -0
  97. package/test/types/fastify.tst.ts +351 -0
  98. package/test/types/hooks.tst.ts +578 -0
  99. package/test/types/instance.tst.ts +597 -0
  100. package/test/types/{logger.test-d.ts → logger.tst.ts} +61 -62
  101. package/test/types/plugin.tst.ts +96 -0
  102. package/test/types/register.tst.ts +245 -0
  103. package/test/types/reply.tst.ts +297 -0
  104. package/test/types/request.tst.ts +199 -0
  105. package/test/types/route.tst.ts +576 -0
  106. package/test/types/{schema.test-d.ts → schema.tst.ts} +22 -22
  107. package/test/types/{serverFactory.test-d.ts → serverFactory.tst.ts} +4 -4
  108. package/test/types/tsconfig.json +9 -0
  109. package/test/types/{type-provider.test-d.ts → type-provider.tst.ts} +256 -250
  110. package/test/types/using.tst.ts +14 -0
  111. package/types/errors.d.ts +4 -0
  112. package/types/instance.d.ts +2 -0
  113. package/types/logger.d.ts +22 -0
  114. package/types/request.d.ts +23 -2
  115. package/test/types/content-type-parser.test-d.ts +0 -72
  116. package/test/types/errors.test-d.ts +0 -90
  117. package/test/types/fastify.test-d.ts +0 -352
  118. package/test/types/hooks.test-d.ts +0 -550
  119. package/test/types/import.ts +0 -2
  120. package/test/types/instance.test-d.ts +0 -588
  121. package/test/types/plugin.test-d.ts +0 -97
  122. package/test/types/register.test-d.ts +0 -237
  123. package/test/types/reply.test-d.ts +0 -254
  124. package/test/types/request.test-d.ts +0 -188
  125. package/test/types/route.test-d.ts +0 -553
  126. package/test/types/using.test-d.ts +0 -17
@@ -0,0 +1,576 @@
1
+ import * as http from 'node:http'
2
+ import { FastifyError } from '@fastify/error'
3
+ import { expect } from 'tstyche'
4
+ import fastify, { FastifyInstance, FastifyReply, FastifyRequest, RouteHandlerMethod } from '../../fastify.js'
5
+ import { RequestPayload } from '../../types/hooks.js'
6
+ import { FindMyWayFindResult } from '../../types/instance.js'
7
+ import { HTTPMethods, RawServerDefault } from '../../types/utils.js'
8
+
9
+ /*
10
+ * Testing Fastify HTTP Routes and Route Shorthands.
11
+ * Verifies Request and Reply types as well.
12
+ * For the route shorthand tests the argument orders are:
13
+ * - `(path, handler)`
14
+ * - `(path, options, handler)`
15
+ * - `(path, options)`
16
+ */
17
+
18
+ declare module '../../fastify' {
19
+ interface FastifyContextConfig {
20
+ foo: string;
21
+ bar: number;
22
+ includeMessage?: boolean;
23
+ }
24
+
25
+ interface FastifyRequest<
26
+ RouteGeneric,
27
+ RawServer,
28
+ RawRequest,
29
+ SchemaCompiler,
30
+ TypeProvider,
31
+ ContextConfig,
32
+ Logger,
33
+ RequestType
34
+ > {
35
+ message: ContextConfig extends { includeMessage: true }
36
+ ? string
37
+ : null;
38
+ }
39
+ }
40
+
41
+ const routeHandler: RouteHandlerMethod = function (request, reply) {
42
+ expect(this).type.toBe<FastifyInstance>()
43
+ expect(request).type.toBe<FastifyRequest>()
44
+ expect(reply).type.toBe<FastifyReply>()
45
+ }
46
+
47
+ const routeHandlerWithReturnValue: RouteHandlerMethod = function (request, reply) {
48
+ expect(this).type.toBe<FastifyInstance>()
49
+ expect(request).type.toBe<FastifyRequest>()
50
+ expect(reply).type.toBe<FastifyReply>()
51
+
52
+ return reply.send()
53
+ }
54
+
55
+ const asyncPreHandler = async (request: FastifyRequest) => {
56
+ expect(request).type.toBe<FastifyRequest>()
57
+ }
58
+
59
+ fastify().get('/', { preHandler: asyncPreHandler }, async () => 'this is an example')
60
+
61
+ fastify().get(
62
+ '/',
63
+ { config: { foo: 'bar', bar: 100, includeMessage: true } },
64
+ (req) => {
65
+ expect(req.message).type.toBe<string>()
66
+ }
67
+ )
68
+
69
+ fastify().get(
70
+ '/',
71
+ { config: { foo: 'bar', bar: 100, includeMessage: false } },
72
+ (req) => {
73
+ expect(req.message).type.toBe<null>()
74
+ }
75
+ )
76
+
77
+ type LowerCaseHTTPMethods = 'delete' | 'get' | 'head' | 'patch' | 'post' | 'put' |
78
+ 'options' | 'propfind' | 'proppatch' | 'mkcol' | 'copy' | 'move' | 'lock' |
79
+ 'unlock' | 'trace' | 'search' | 'mkcalendar' | 'report'
80
+
81
+ ;['DELETE', 'GET', 'HEAD', 'PATCH', 'POST', 'PUT', 'OPTIONS', 'PROPFIND',
82
+ 'PROPPATCH', 'MKCOL', 'COPY', 'MOVE', 'LOCK', 'UNLOCK', 'TRACE', 'SEARCH', 'MKCALENDAR', 'REPORT'
83
+ ].forEach(method => {
84
+ // route method
85
+ expect(fastify().route({
86
+ method: method as HTTPMethods,
87
+ url: '/',
88
+ handler: routeHandler
89
+ })).type.toBe<FastifyInstance>()
90
+
91
+ const lowerCaseMethod: LowerCaseHTTPMethods = method.toLowerCase() as LowerCaseHTTPMethods
92
+
93
+ // method as method
94
+ expect(fastify()[lowerCaseMethod]('/', routeHandler)).type.toBe<FastifyInstance>()
95
+ expect(fastify()[lowerCaseMethod]('/', {}, routeHandler)).type.toBe<FastifyInstance>()
96
+ expect(fastify()[lowerCaseMethod]('/', { handler: routeHandler })).type.toBe<FastifyInstance>()
97
+
98
+ expect(fastify()[lowerCaseMethod]('/', {
99
+ handler: routeHandler,
100
+ errorHandler: (error, request, reply) => {
101
+ expect(error).type.toBe<FastifyError>()
102
+ reply.send('error')
103
+ },
104
+ childLoggerFactory: function (logger, bindings, opts) {
105
+ return logger.child(bindings, opts)
106
+ }
107
+ })).type.toBe<FastifyInstance>()
108
+
109
+ interface BodyInterface { prop: string }
110
+ interface QuerystringInterface { prop: number }
111
+ interface ParamsInterface { prop: boolean }
112
+ interface HeadersInterface { prop: string }
113
+ interface RouteSpecificContextConfigType {
114
+ extra: boolean
115
+ }
116
+ interface RouteGeneric {
117
+ Body: BodyInterface;
118
+ Querystring: QuerystringInterface;
119
+ Params: ParamsInterface;
120
+ Headers: HeadersInterface;
121
+ }
122
+
123
+ fastify()[lowerCaseMethod]<RouteGeneric, RouteSpecificContextConfigType>('/', { config: { foo: 'bar', bar: 100, extra: true } }, (req, res) => {
124
+ expect(req.body).type.toBe<BodyInterface>()
125
+ expect(req.query).type.toBe<QuerystringInterface>()
126
+ expect(req.params).type.toBe<ParamsInterface>()
127
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
128
+ expect(req.routeOptions.config.foo).type.toBe<string>()
129
+ expect(req.routeOptions.config.bar).type.toBe<number>()
130
+ expect(req.routeOptions.config.extra).type.toBe<boolean>()
131
+ expect(req.routeOptions.config.url).type.toBe<string>()
132
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
133
+ expect(res.routeOptions.config.foo).type.toBe<string>()
134
+ expect(res.routeOptions.config.bar).type.toBe<number>()
135
+ expect(res.routeOptions.config.extra).type.toBe<boolean>()
136
+ expect(req.routeOptions.config.url).type.toBe<string>()
137
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
138
+ })
139
+
140
+ fastify().route<RouteGeneric>({
141
+ url: '/',
142
+ method: method as HTTPMethods,
143
+ config: { foo: 'bar', bar: 100 },
144
+ prefixTrailingSlash: 'slash',
145
+ onRequest: (req, res, done) => { // these handlers are tested in `hooks.test-d.ts`
146
+ expect(req.body).type.toBe<BodyInterface>()
147
+ expect(req.query).type.toBe<QuerystringInterface>()
148
+ expect(req.params).type.toBe<ParamsInterface>()
149
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
150
+ expect(req.routeOptions.config.foo).type.toBe<string>()
151
+ expect(req.routeOptions.config.bar).type.toBe<number>()
152
+ expect(req.routeOptions.config.url).type.toBe<string>()
153
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
154
+ expect(res.routeOptions.config.foo).type.toBe<string>()
155
+ expect(res.routeOptions.config.bar).type.toBe<number>()
156
+ expect(req.routeOptions.config.url).type.toBe<string>()
157
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
158
+ },
159
+ preParsing: (req, res, payload, done) => {
160
+ expect(req.body).type.toBe<BodyInterface>()
161
+ expect(req.query).type.toBe<QuerystringInterface>()
162
+ expect(req.params).type.toBe<ParamsInterface>()
163
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
164
+ expect(req.routeOptions.config.foo).type.toBe<string>()
165
+ expect(req.routeOptions.config.bar).type.toBe<number>()
166
+ expect(req.routeOptions.config.url).type.toBe<string>()
167
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
168
+ expect(res.routeOptions.config.foo).type.toBe<string>()
169
+ expect(res.routeOptions.config.bar).type.toBe<number>()
170
+ expect(req.routeOptions.config.url).type.toBe<string>()
171
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
172
+ expect(payload).type.toBe<RequestPayload>()
173
+ expect(done).type.toBeAssignableTo<(err?: FastifyError | null, res?: RequestPayload) => void>()
174
+ expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>()
175
+ },
176
+ preValidation: (req, res, done) => {
177
+ expect(req.body).type.toBe<BodyInterface>()
178
+ expect(req.query).type.toBe<QuerystringInterface>()
179
+ expect(req.params).type.toBe<ParamsInterface>()
180
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
181
+ expect(req.routeOptions.config.foo).type.toBe<string>()
182
+ expect(req.routeOptions.config.bar).type.toBe<number>()
183
+ expect(req.routeOptions.config.url).type.toBe<string>()
184
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
185
+ expect(res.routeOptions.config.foo).type.toBe<string>()
186
+ expect(res.routeOptions.config.bar).type.toBe<number>()
187
+ expect(req.routeOptions.config.url).type.toBe<string>()
188
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
189
+ },
190
+ preHandler: (req, res, done) => {
191
+ expect(req.body).type.toBe<BodyInterface>()
192
+ expect(req.query).type.toBe<QuerystringInterface>()
193
+ expect(req.params).type.toBe<ParamsInterface>()
194
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
195
+ expect(req.routeOptions.config.foo).type.toBe<string>()
196
+ expect(req.routeOptions.config.bar).type.toBe<number>()
197
+ expect(req.routeOptions.config.url).type.toBe<string>()
198
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
199
+ expect(res.routeOptions.config.foo).type.toBe<string>()
200
+ expect(res.routeOptions.config.bar).type.toBe<number>()
201
+ expect(req.routeOptions.config.url).type.toBe<string>()
202
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
203
+ },
204
+ onResponse: (req, res, done) => {
205
+ expect(req.body).type.toBe<BodyInterface>()
206
+ expect(req.query).type.toBe<QuerystringInterface>()
207
+ expect(req.params).type.toBe<ParamsInterface>()
208
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
209
+ expect(req.routeOptions.config.foo).type.toBe<string>()
210
+ expect(req.routeOptions.config.bar).type.toBe<number>()
211
+ expect(req.routeOptions.config.url).type.toBe<string>()
212
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
213
+ expect(res.routeOptions.config.foo).type.toBe<string>()
214
+ expect(res.routeOptions.config.bar).type.toBe<number>()
215
+ expect(req.routeOptions.config.url).type.toBe<string>()
216
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
217
+ expect(res.statusCode).type.toBe<number>()
218
+ },
219
+ onError: (req, res, error, done) => {
220
+ expect(req.body).type.toBe<BodyInterface>()
221
+ expect(req.query).type.toBe<QuerystringInterface>()
222
+ expect(req.params).type.toBe<ParamsInterface>()
223
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
224
+ expect(req.routeOptions.config.foo).type.toBe<string>()
225
+ expect(req.routeOptions.config.bar).type.toBe<number>()
226
+ expect(req.routeOptions.config.url).type.toBe<string>()
227
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
228
+ expect(res.routeOptions.config.foo).type.toBe<string>()
229
+ expect(res.routeOptions.config.bar).type.toBe<number>()
230
+ expect(req.routeOptions.config.url).type.toBe<string>()
231
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
232
+ },
233
+ preSerialization: (req, res, payload, done) => {
234
+ expect(req.body).type.toBe<BodyInterface>()
235
+ expect(req.query).type.toBe<QuerystringInterface>()
236
+ expect(req.params).type.toBe<ParamsInterface>()
237
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
238
+ expect(req.routeOptions.config.foo).type.toBe<string>()
239
+ expect(req.routeOptions.config.bar).type.toBe<number>()
240
+ expect(req.routeOptions.config.url).type.toBe<string>()
241
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
242
+ expect(res.routeOptions.config.foo).type.toBe<string>()
243
+ expect(res.routeOptions.config.bar).type.toBe<number>()
244
+ expect(req.routeOptions.config.url).type.toBe<string>()
245
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
246
+ },
247
+ onSend: (req, res, payload, done) => {
248
+ expect(req.body).type.toBe<BodyInterface>()
249
+ expect(req.query).type.toBe<QuerystringInterface>()
250
+ expect(req.params).type.toBe<ParamsInterface>()
251
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
252
+ expect(req.routeOptions.config.foo).type.toBe<string>()
253
+ expect(req.routeOptions.config.bar).type.toBe<number>()
254
+ expect(req.routeOptions.config.url).type.toBe<string>()
255
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
256
+ expect(res.routeOptions.config.foo).type.toBe<string>()
257
+ expect(res.routeOptions.config.bar).type.toBe<number>()
258
+ expect(req.routeOptions.config.url).type.toBe<string>()
259
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
260
+ },
261
+ handler: (req, res) => {
262
+ expect(req.body).type.toBe<BodyInterface>()
263
+ expect(req.query).type.toBe<QuerystringInterface>()
264
+ expect(req.params).type.toBe<ParamsInterface>()
265
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
266
+ expect(req.routeOptions.config.foo).type.toBe<string>()
267
+ expect(req.routeOptions.config.bar).type.toBe<number>()
268
+ expect(req.routeOptions.config.url).type.toBe<string>()
269
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
270
+ expect(res.routeOptions.config.foo).type.toBe<string>()
271
+ expect(res.routeOptions.config.bar).type.toBe<number>()
272
+ expect(req.routeOptions.config.url).type.toBe<string>()
273
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
274
+ }
275
+ })
276
+
277
+ fastify().route<RouteGeneric>({
278
+ url: '/',
279
+ method: method as HTTPMethods,
280
+ config: { foo: 'bar', bar: 100 },
281
+ prefixTrailingSlash: 'slash',
282
+ onRequest: async (req, res, done) => { // these handlers are tested in `hooks.test-d.ts`
283
+ expect(req.body).type.toBe<BodyInterface>()
284
+ expect(req.query).type.toBe<QuerystringInterface>()
285
+ expect(req.params).type.toBe<ParamsInterface>()
286
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
287
+ expect(req.routeOptions.config.foo).type.toBe<string>()
288
+ expect(req.routeOptions.config.bar).type.toBe<number>()
289
+ expect(req.routeOptions.config.url).type.toBe<string>()
290
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
291
+ expect(res.routeOptions.config.foo).type.toBe<string>()
292
+ expect(res.routeOptions.config.bar).type.toBe<number>()
293
+ expect(req.routeOptions.config.url).type.toBe<string>()
294
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
295
+ },
296
+ preParsing: async (req, res, payload, done) => {
297
+ expect(req.body).type.toBe<BodyInterface>()
298
+ expect(req.query).type.toBe<QuerystringInterface>()
299
+ expect(req.params).type.toBe<ParamsInterface>()
300
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
301
+ expect(req.routeOptions.config.foo).type.toBe<string>()
302
+ expect(req.routeOptions.config.bar).type.toBe<number>()
303
+ expect(req.routeOptions.config.url).type.toBe<string>()
304
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
305
+ expect(res.routeOptions.config.foo).type.toBe<string>()
306
+ expect(res.routeOptions.config.bar).type.toBe<number>()
307
+ expect(req.routeOptions.config.url).type.toBe<string>()
308
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
309
+ expect(payload).type.toBe<RequestPayload>()
310
+ expect(done).type.toBeAssignableTo<(err?: FastifyError | null, res?: RequestPayload) => void>()
311
+ expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>()
312
+ },
313
+ preValidation: async (req, res, done) => {
314
+ expect(req.body).type.toBe<BodyInterface>()
315
+ expect(req.query).type.toBe<QuerystringInterface>()
316
+ expect(req.params).type.toBe<ParamsInterface>()
317
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
318
+ expect(req.routeOptions.config.foo).type.toBe<string>()
319
+ expect(req.routeOptions.config.bar).type.toBe<number>()
320
+ expect(req.routeOptions.config.url).type.toBe<string>()
321
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
322
+ expect(res.routeOptions.config.foo).type.toBe<string>()
323
+ expect(res.routeOptions.config.bar).type.toBe<number>()
324
+ expect(req.routeOptions.config.url).type.toBe<string>()
325
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
326
+ },
327
+ preHandler: async (req, res, done) => {
328
+ expect(req.body).type.toBe<BodyInterface>()
329
+ expect(req.query).type.toBe<QuerystringInterface>()
330
+ expect(req.params).type.toBe<ParamsInterface>()
331
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
332
+ expect(req.routeOptions.config.foo).type.toBe<string>()
333
+ expect(req.routeOptions.config.bar).type.toBe<number>()
334
+ expect(req.routeOptions.config.url).type.toBe<string>()
335
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
336
+ expect(res.routeOptions.config.foo).type.toBe<string>()
337
+ expect(res.routeOptions.config.bar).type.toBe<number>()
338
+ expect(req.routeOptions.config.url).type.toBe<string>()
339
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
340
+ },
341
+ onResponse: async (req, res, done) => {
342
+ expect(req.body).type.toBe<BodyInterface>()
343
+ expect(req.query).type.toBe<QuerystringInterface>()
344
+ expect(req.params).type.toBe<ParamsInterface>()
345
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
346
+ expect(req.routeOptions.config.foo).type.toBe<string>()
347
+ expect(req.routeOptions.config.bar).type.toBe<number>()
348
+ expect(req.routeOptions.config.url).type.toBe<string>()
349
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
350
+ expect(res.routeOptions.config.foo).type.toBe<string>()
351
+ expect(res.routeOptions.config.bar).type.toBe<number>()
352
+ expect(req.routeOptions.config.url).type.toBe<string>()
353
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
354
+ expect(res.statusCode).type.toBe<number>()
355
+ },
356
+ onError: async (req, res, error, done) => {
357
+ expect(req.body).type.toBe<BodyInterface>()
358
+ expect(req.query).type.toBe<QuerystringInterface>()
359
+ expect(req.params).type.toBe<ParamsInterface>()
360
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
361
+ expect(req.routeOptions.config.foo).type.toBe<string>()
362
+ expect(req.routeOptions.config.bar).type.toBe<number>()
363
+ expect(req.routeOptions.config.url).type.toBe<string>()
364
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
365
+ expect(res.routeOptions.config.foo).type.toBe<string>()
366
+ expect(res.routeOptions.config.bar).type.toBe<number>()
367
+ expect(req.routeOptions.config.url).type.toBe<string>()
368
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
369
+ },
370
+ preSerialization: async (req, res, payload, done) => {
371
+ expect(req.body).type.toBe<BodyInterface>()
372
+ expect(req.query).type.toBe<QuerystringInterface>()
373
+ expect(req.params).type.toBe<ParamsInterface>()
374
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
375
+ expect(req.routeOptions.config.foo).type.toBe<string>()
376
+ expect(req.routeOptions.config.bar).type.toBe<number>()
377
+ expect(req.routeOptions.config.url).type.toBe<string>()
378
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
379
+ expect(res.routeOptions.config.foo).type.toBe<string>()
380
+ expect(res.routeOptions.config.bar).type.toBe<number>()
381
+ expect(req.routeOptions.config.url).type.toBe<string>()
382
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
383
+ },
384
+ onSend: async (req, res, payload, done) => {
385
+ expect(req.body).type.toBe<BodyInterface>()
386
+ expect(req.query).type.toBe<QuerystringInterface>()
387
+ expect(req.params).type.toBe<ParamsInterface>()
388
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
389
+ expect(req.routeOptions.config.foo).type.toBe<string>()
390
+ expect(req.routeOptions.config.bar).type.toBe<number>()
391
+ expect(req.routeOptions.config.url).type.toBe<string>()
392
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
393
+ expect(res.routeOptions.config.foo).type.toBe<string>()
394
+ expect(res.routeOptions.config.bar).type.toBe<number>()
395
+ expect(req.routeOptions.config.url).type.toBe<string>()
396
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
397
+ },
398
+ handler: (req, res) => {
399
+ expect(req.body).type.toBe<BodyInterface>()
400
+ expect(req.query).type.toBe<QuerystringInterface>()
401
+ expect(req.params).type.toBe<ParamsInterface>()
402
+ expect(req.headers).type.toBe<http.IncomingHttpHeaders & HeadersInterface>()
403
+ expect(req.routeOptions.config.foo).type.toBe<string>()
404
+ expect(req.routeOptions.config.bar).type.toBe<number>()
405
+ expect(req.routeOptions.config.url).type.toBe<string>()
406
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
407
+ expect(res.routeOptions.config.foo).type.toBe<string>()
408
+ expect(res.routeOptions.config.bar).type.toBe<number>()
409
+ expect(req.routeOptions.config.url).type.toBe<string>()
410
+ expect(req.routeOptions.config.method).type.toBe<HTTPMethods | HTTPMethods[]>()
411
+ }
412
+ })
413
+ })
414
+
415
+ expect(fastify().route({
416
+ url: '/',
417
+ method: 'CONNECT', // not a valid method but could be implemented by the user
418
+ handler: routeHandler
419
+ })).type.toBe<FastifyInstance>()
420
+
421
+ expect(fastify().route({
422
+ url: '/',
423
+ method: 'OPTIONS',
424
+ handler: routeHandler
425
+ })).type.toBe<FastifyInstance>()
426
+
427
+ expect(fastify().route({
428
+ url: '/',
429
+ method: 'OPTION', // OPTION is a typo for OPTIONS
430
+ handler: routeHandler
431
+ })).type.toBe<FastifyInstance>()
432
+
433
+ expect(fastify().route({
434
+ url: '/',
435
+ method: ['GET', 'POST'],
436
+ handler: routeHandler
437
+ })).type.toBe<FastifyInstance>()
438
+
439
+ expect(fastify().route({
440
+ url: '/',
441
+ method: ['GET', 'POST', 'OPTION'], // OPTION is a typo for OPTIONS
442
+ handler: routeHandler
443
+ })).type.toBe<FastifyInstance>()
444
+
445
+ expect(fastify().route({
446
+ url: '/',
447
+ method: 'GET',
448
+ handler: routeHandler,
449
+ schemaErrorFormatter: (errors, dataVar) => new Error('')
450
+ })).type.toBe<FastifyInstance>()
451
+
452
+ expect(fastify().route).type.not.toBeCallableWith({
453
+ url: '/',
454
+ method: 'GET',
455
+ handler: routeHandler,
456
+ schemaErrorFormatter: 500
457
+ })
458
+
459
+ expect(fastify().route({
460
+ url: '/',
461
+ method: 'GET',
462
+ handler: routeHandler,
463
+ prefixTrailingSlash: 'slash'
464
+ })).type.toBe<FastifyInstance>()
465
+
466
+ expect(fastify().route({
467
+ url: '/',
468
+ method: 'GET',
469
+ handler: routeHandler,
470
+ prefixTrailingSlash: 'no-slash'
471
+ })).type.toBe<FastifyInstance>()
472
+
473
+ expect(fastify().route({
474
+ url: '/',
475
+ method: 'GET',
476
+ handler: routeHandler,
477
+ prefixTrailingSlash: 'both'
478
+ })).type.toBe<FastifyInstance>()
479
+
480
+ expect(fastify().route).type.not.toBeCallableWith({
481
+ url: '/',
482
+ method: 'GET',
483
+ handler: routeHandler,
484
+ prefixTrailingSlash: true
485
+ })
486
+
487
+ expect(fastify().route({
488
+ url: '/',
489
+ method: 'GET',
490
+ handler: routeHandlerWithReturnValue
491
+ })).type.toBe<FastifyInstance>()
492
+
493
+ expect(fastify().hasRoute({
494
+ url: '/',
495
+ method: 'GET'
496
+ })).type.toBe<boolean>()
497
+
498
+ expect(fastify().hasRoute({
499
+ url: '/',
500
+ method: 'GET',
501
+ constraints: { version: '1.2.0' }
502
+ })).type.toBe<boolean>()
503
+
504
+ expect(fastify().hasRoute({
505
+ url: '/',
506
+ method: 'GET',
507
+ constraints: { host: 'auth.fastify.test' }
508
+ })).type.toBe<boolean>()
509
+
510
+ expect(fastify().hasRoute({
511
+ url: '/',
512
+ method: 'GET',
513
+ constraints: { host: /.*\.fastify\.test$/ }
514
+ })).type.toBe<boolean>()
515
+
516
+ expect(fastify().hasRoute({
517
+ url: '/',
518
+ method: 'GET',
519
+ constraints: { host: /.*\.fastify\.test$/, version: '1.2.3' }
520
+ })).type.toBe<boolean>()
521
+
522
+ expect(fastify().hasRoute({
523
+ url: '/',
524
+ method: 'GET',
525
+ constraints: {
526
+ // constraints value should accept any value
527
+ number: 12,
528
+ date: new Date(),
529
+ boolean: true,
530
+ function: () => { },
531
+ object: { foo: 'bar' }
532
+ }
533
+ })).type.toBe<boolean>()
534
+
535
+ expect(
536
+ fastify().findRoute({
537
+ url: '/',
538
+ method: 'get'
539
+ })
540
+ ).type.toBe<Omit<FindMyWayFindResult<RawServerDefault>, 'store'>>()
541
+
542
+ // we should not expose store
543
+ expect(fastify().findRoute({
544
+ url: '/',
545
+ method: 'get'
546
+ })).type.not.toHaveProperty('store')
547
+
548
+ expect(fastify().route({
549
+ url: '/',
550
+ method: 'get',
551
+ handler: routeHandlerWithReturnValue
552
+ })).type.toBe<FastifyInstance>()
553
+
554
+ expect(fastify().route({
555
+ url: '/',
556
+ method: ['put', 'patch'],
557
+ handler: routeHandlerWithReturnValue
558
+ })).type.toBe<FastifyInstance>()
559
+
560
+ expect(fastify().route({
561
+ url: '/',
562
+ method: 'GET',
563
+ handler: (req) => {
564
+ expect(req.routeOptions.method).type.toBe<HTTPMethods | HTTPMethods[]>()
565
+ expect(req.routeOptions.method).type.toBeAssignableTo<string | Array<string>>()
566
+ }
567
+ })).type.toBe<FastifyInstance>()
568
+
569
+ expect(fastify().route({
570
+ url: '/',
571
+ method: ['HEAD', 'GET'],
572
+ handler: (req) => {
573
+ expect(req.routeOptions.method).type.toBe<HTTPMethods | HTTPMethods[]>()
574
+ expect(req.routeOptions.method).type.toBeAssignableTo<string | Array<string>>()
575
+ }
576
+ })).type.toBe<FastifyInstance>()
@@ -1,12 +1,12 @@
1
1
  import { StandaloneValidator } from '@fastify/ajv-compiler'
2
2
  import { StandaloneSerializer } from '@fastify/fast-json-stringify-compiler'
3
3
  import Ajv from 'ajv'
4
- import { expectAssignable } from 'tsd'
5
- import fastify, { FastifyInstance, FastifySchema } from '../../fastify'
4
+ import { expect } from 'tstyche'
5
+ import fastify, { FastifyInstance, FastifySchema } from '../../fastify.js'
6
6
 
7
7
  const server = fastify()
8
8
 
9
- expectAssignable<FastifyInstance>(server.get(
9
+ expect(server.get(
10
10
  '/full-schema',
11
11
  {
12
12
  schema: {
@@ -18,9 +18,9 @@ expectAssignable<FastifyInstance>(server.get(
18
18
  }
19
19
  },
20
20
  () => { }
21
- ))
21
+ )).type.toBe<FastifyInstance>()
22
22
 
23
- expectAssignable<FastifyInstance>(server.post(
23
+ expect(server.post(
24
24
  '/multiple-content-schema',
25
25
  {
26
26
  schema: {
@@ -37,31 +37,31 @@ expectAssignable<FastifyInstance>(server.post(
37
37
  }
38
38
  },
39
39
  () => { }
40
- ))
40
+ )).type.toBe<FastifyInstance>()
41
41
 
42
- expectAssignable<FastifyInstance>(server.get(
42
+ expect(server.get(
43
43
  '/empty-schema',
44
44
  {
45
45
  schema: {}
46
46
  },
47
47
  () => { }
48
- ))
48
+ )).type.toBe<FastifyInstance>()
49
49
 
50
- expectAssignable<FastifyInstance>(server.get(
50
+ expect(server.get(
51
51
  '/no-schema',
52
52
  {},
53
53
  () => { }
54
- ))
54
+ )).type.toBe<FastifyInstance>()
55
55
 
56
- expectAssignable<FastifyInstance>(server.setValidatorCompiler(({ schema }) => {
56
+ expect(server.setValidatorCompiler(({ schema }) => {
57
57
  return new Ajv().compile(schema)
58
- }))
58
+ })).type.toBe<FastifyInstance>()
59
59
 
60
- expectAssignable<FastifyInstance>(server.setSerializerCompiler(() => {
60
+ expect(server.setSerializerCompiler(() => {
61
61
  return data => JSON.stringify(data)
62
- }))
62
+ })).type.toBe<FastifyInstance>()
63
63
 
64
- expectAssignable<FastifyInstance>(server.post('/test', {
64
+ expect(server.post('/test', {
65
65
  validatorCompiler: ({ schema }) => {
66
66
  return data => {
67
67
  if (!data || data.constructor !== Object) {
@@ -70,9 +70,9 @@ expectAssignable<FastifyInstance>(server.post('/test', {
70
70
  return { value: data }
71
71
  }
72
72
  }
73
- }, async req => req.body))
73
+ }, async req => req.body)).type.toBe<FastifyInstance>()
74
74
 
75
- expectAssignable<FastifyInstance>(server.post('/test', {
75
+ expect(server.post('/test', {
76
76
  validatorCompiler: ({ schema }) => {
77
77
  return data => {
78
78
  if (!data || data.constructor !== Object) {
@@ -91,17 +91,17 @@ expectAssignable<FastifyInstance>(server.post('/test', {
91
91
  return { value: data }
92
92
  }
93
93
  }
94
- }, async req => req.body))
94
+ }, async req => req.body)).type.toBe<FastifyInstance>()
95
95
 
96
- expectAssignable<FastifyInstance>(server.setValidatorCompiler<FastifySchema & { validate: Record<string, unknown> }>(
96
+ expect(server.setValidatorCompiler<FastifySchema & { validate: Record<string, unknown> }>(
97
97
  function ({ schema }) {
98
98
  return new Ajv().compile(schema)
99
99
  }
100
- ))
100
+ )).type.toBe<FastifyInstance>()
101
101
 
102
- expectAssignable<FastifyInstance>(server.setSerializerCompiler<FastifySchema & { validate: string }>(
102
+ expect(server.setSerializerCompiler<FastifySchema & { validate: string }>(
103
103
  () => data => JSON.stringify(data)
104
- ))
104
+ )).type.toBe<FastifyInstance>()
105
105
 
106
106
  // https://github.com/fastify/ajv-compiler/issues/95
107
107
  {