import * as http from 'node:http' import { FastifyError } from '@fastify/error' import { expect } from 'tstyche' import fastify, { ContextConfigDefault, FastifyContextConfig, FastifyInstance, FastifyPluginOptions, FastifyReply, FastifyRequest, FastifySchema, FastifyTypeProviderDefault, RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault, RegisterOptions, RouteOptions, preCloseAsyncHookHandler, preCloseHookHandler } from '../../fastify.js' import { DoneFuncWithErrOrRes, HookHandlerDoneFunction, RequestPayload, preHandlerAsyncHookHandler } from '../../types/hooks.js' import { FastifyRouteConfig, RouteGenericInterface } from '../../types/route.js' const server = fastify() // Test payload generic pass through for preSerialization and onSend type TestPayloadType = { foo: string; bar: number; } // Synchronous Tests server.addHook('onRequest', function (request, reply, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('preParsing', function (request, reply, payload, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('preValidation', function (request, reply, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('preHandler', function (request, reply, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('preSerialization', function (request, reply, payload, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() // we expect this to be unknown when not specified like in the previous test expect(done(new Error())).type.toBe() expect(done(null, 'foobar')).type.toBe() expect(done()).type.toBe() expect(done).type.not.toBeCallableWith(new Error(), 'foobar') }) server.addHook('onSend', function (request, reply, payload, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() expect(done(new Error())).type.toBe() expect(done(null, 'foobar')).type.toBe() expect(done()).type.toBe() expect(done).type.not.toBeCallableWith(new Error(), 'foobar') }) server.addHook('onResponse', function (request, reply, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('onTimeout', function (request, reply, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('onError', function (request, reply, error, done) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(error).type.toBe() expect(done).type.toBe<() => void>() expect(done()).type.toBe() }) server.addHook('onRequestAbort', function (request, done) { expect(this).type.toBe() expect(request).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('onRoute', function (opts) { expect(this).type.toBe() expect(opts).type.toBe() }) server.addHook('onRegister', function (instance, opts) { expect(this).type.toBe() expect(instance).type.toBe() expect(opts).type.toBe() }) server.addHook('onReady', function (done) { expect(this).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) server.addHook('onListen', function (done) { expect(this).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() }) server.addHook('onClose', function (instance, done) { expect(this).type.toBe() expect(instance).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) // Asynchronous server.addHook('onRequest', async function (request, reply) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() }) server.addHook('preParsing', async function (request, reply, payload) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() }) server.addHook('preValidation', async function (request, reply) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() }) server.addHook('preHandler', async function (request, reply) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() }) server.addHook('preSerialization', async function (request, reply, payload) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() // we expect this to be unknown when not specified like in the previous test }) server.addHook('onSend', async function (request, reply, payload) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() }) server.addHook('onResponse', async function (request, reply) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() }) server.addHook('onTimeout', async function (request, reply) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() }) server.addHook('onError', async function (request, reply, error) { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() expect(error).type.toBe() }) server.addHook('onRequestAbort', async function (request) { expect(this).type.toBe() expect(request).type.toBe() }) server.addHook('onRegister', async (instance, opts) => { expect(instance).type.toBe() expect(opts).type.toBe() }) server.addHook('onReady', async function () { expect(this).type.toBe() }) server.addHook('onListen', async function () { expect(this).type.toBe() }) server.addHook('onClose', async function (instance) { expect(this).type.toBe() expect(instance).type.toBe() }) // Use case to monitor any regression on issue #3620 // ref.: https://github.com/fastify/fastify/issues/3620 const customTypedHook: preHandlerAsyncHookHandler< RawServerDefault, RawRequestDefaultExpression, RawReplyDefaultExpression, RouteGenericInterface, ContextConfigDefault, FastifySchema, FastifyTypeProviderDefault > = async function (request, reply): Promise { expect(this).type.toBe() expect(request).type.toBe() expect(reply).type.toBe() } server.register(async (instance) => { instance.addHook('preHandler', customTypedHook) }) // Test custom Context Config types for hooks type CustomContextConfig = FastifyContextConfig & { foo: string; bar: number; } type CustomContextConfigWithDefault = CustomContextConfig & FastifyRouteConfig server.route({ method: 'GET', url: '/', handler: () => { }, onRequest: (request, reply, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preParsing: (request, reply, payload, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preValidation: (request, reply, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preHandler: (request, reply, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preSerialization: (request, reply, payload, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onSend: (request, reply, payload, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onResponse: (request, reply, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onTimeout: (request, reply, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onError: (request, reply, error, done) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() } }) server.get('/', { onRequest: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preParsing: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preValidation: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preHandler: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preSerialization: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onSend: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onResponse: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onTimeout: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onError: async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() } }, async (request, reply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }) type CustomContextRequest = FastifyRequest type CustomContextReply = FastifyReply server.route({ method: 'GET', url: '/', handler: () => { }, onRequest: async (request: CustomContextRequest, reply: CustomContextReply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preParsing: async (request: CustomContextRequest, reply: CustomContextReply, payload: RequestPayload) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preValidation: async (request: CustomContextRequest, reply: CustomContextReply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preHandler: async (request: CustomContextRequest, reply: CustomContextReply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, preSerialization: async (request: CustomContextRequest, reply: CustomContextReply, payload: any) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onSend: async (request: CustomContextRequest, reply: CustomContextReply, payload: any) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onResponse: async (request: CustomContextRequest, reply: CustomContextReply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onTimeout: async (request: CustomContextRequest, reply: CustomContextReply) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() }, onError: async (request: CustomContextRequest, reply: CustomContextReply, error: FastifyError) => { expect(request.routeOptions.config).type.toBe() expect(reply.routeOptions.config).type.toBe() } }) type NoInferRequest = FastifyRequest> type NoInferReply = FastifyReply< RouteGenericInterface, http.Server, http.IncomingMessage, http.ServerResponse, unknown, NoInfer > server.route({ method: 'GET', url: '/', handler: (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }, onRequest: (request, reply, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBe() }, onRequestAbort: (request, done) => { expect(request).type.toBe() expect(done).type.toBe() }, preParsing: (request, reply, payload, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() expect(done).type.toBe< ( err?: TError | null | undefined, res?: RequestPayload | undefined ) => void >() }, preValidation: (request, reply, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBe() }, preHandler: (request, reply, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBe() }, preSerialization: (request, reply, payload, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() expect(done).type.toBe() }, onSend: (request, reply, payload, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() expect(done).type.toBe() }, onResponse: (request, reply, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBe() }, onTimeout: (request, reply, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(done).type.toBe() }, onError: (request, reply, error, done) => { expect(request).type.toBe() expect(reply).type.toBe() expect(error).type.toBe() expect(done).type.toBe<() => void>() } }) server.get('/', { onRequest: async (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }, onRequestAbort: async (request, done) => { expect(request).type.toBe() expect(done).type.toBe() }, preParsing: async (request, reply, payload) => { expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() }, preValidation: async (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }, preHandler: async (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }, preSerialization: async (request, reply, payload) => { expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() }, onSend: async (request, reply, payload) => { expect(request).type.toBe() expect(reply).type.toBe() expect(payload).type.toBe() }, onResponse: async (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }, onTimeout: async (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }, onError: async (request, reply, error) => { expect(request).type.toBe() expect(reply).type.toBe() expect(error).type.toBe() } }, async (request, reply) => { expect(request).type.toBe() expect(reply).type.toBe() }) // TODO: Should throw errors // server.get('/', { onRequest: async (request, reply, done) => {} }, async (request, reply) => {}) // server.get('/', { onRequestAbort: async (request, done) => {} }, async (request, reply) => {}) // server.get('/', { preParsing: async (request, reply, payload, done) => {} }, async (request, reply) => {}) // server.get('/', { preValidation: async (request, reply, done) => {} }, async (request, reply) => {}) // server.get('/', { preHandler: async (request, reply, done) => {} }, async (request, reply) => {}) // server.get('/', { preSerialization: async (request, reply, payload, done) => {} }, async (request, reply) => {}) // server.get('/', { onSend: async (request, reply, payload, done) => {} }, async (request, reply) => {}) // server.get('/', { onResponse: async (request, reply, done) => {} }, async (request, reply) => {}) // server.get('/', { onTimeout: async (request, reply, done) => {} }, async (request, reply) => {}) // server.get('/', { onError: async (request, reply, error, done) => {} }, async (request, reply) => {}) server.addHook('preClose', function (done) { expect(this).type.toBe() expect(done).type.toBeAssignableTo<(err?: FastifyError) => void>() expect(done).type.toBeAssignableTo<(err?: NodeJS.ErrnoException) => void>() expect(done(new Error())).type.toBe() }) const preCloseHandler: preCloseHookHandler = function (done) { expect(this).type.toBe() expect(done).type.toBe() } server.addHook('preClose', preCloseHandler) server.addHook('preClose', async function () { expect(this).type.toBe() }) const preCloseAsyncHandler: preCloseAsyncHookHandler = async function () { expect(this).type.toBe() } server.addHook('preClose', preCloseAsyncHandler) // @ts-expect-error No overload matches this call. server.addHook('onClose', async function (instance, done) {}) // @ts-expect-error No overload matches this call. server.addHook('onError', async function (request, reply, error, done) {}) // @ts-expect-error No overload matches this call. server.addHook('onReady', async function (done) {}) // @ts-expect-error No overload matches this call. server.addHook('onListen', async function (done) {}) // @ts-expect-error No overload matches this call. server.addHook('onRequest', async function (request, reply, done) {}) // @ts-expect-error No overload matches this call. server.addHook('onRequestAbort', async function (request, done) {}) // @ts-expect-error No overload matches this call. server.addHook('onResponse', async function (request, reply, done) {}) // @ts-expect-error No overload matches this call. server.addHook('onSend', async function (request, reply, payload, done) {}) // @ts-expect-error No overload matches this call. server.addHook('onTimeout', async function (request, reply, done) {}) // @ts-expect-error No overload matches this call. server.addHook('preClose', async function (done) {}) // @ts-expect-error No overload matches this call. server.addHook('preHandler', async function (request, reply, done) {}) // @ts-expect-error No overload matches this call. server.addHook('preSerialization', async function (request, reply, payload, done) {}) // @ts-expect-error No overload matches this call. server.addHook('preValidation', async function (request, reply, done) {})