import * as http from 'http' import * as http2 from 'http2' import * as https from 'https' import { Socket } from 'net' import { Options as AjvOptions, ValidatorFactory } from '@fastify/ajv-compiler' import { FastifyError } from '@fastify/error' import { Options as FJSOptions, SerializerFactory } from '@fastify/fast-json-stringify-compiler' import { ConstraintStrategy, HTTPVersion } from 'find-my-way' import { Chain as LightMyRequestChain, InjectOptions, Response as LightMyRequestResponse, CallbackFunc as LightMyRequestCallback } from 'light-my-request' import { FastifyBodyParser, FastifyContentTypeParser, AddContentTypeParser, hasContentTypeParser, getDefaultJsonParser, ProtoAction, ConstructorAction } from './types/content-type-parser' import { FastifyRequestContext, FastifyContextConfig, FastifyReplyContext } from './types/context' import { FastifyErrorCodes } from './types/errors' import { DoneFuncWithErrOrRes, HookHandlerDoneFunction, RequestPayload, onCloseAsyncHookHandler, onCloseHookHandler, onErrorAsyncHookHandler, onErrorHookHandler, onReadyAsyncHookHandler, onReadyHookHandler, onListenAsyncHookHandler, onListenHookHandler, onRegisterHookHandler, onRequestAsyncHookHandler, onRequestHookHandler, onResponseAsyncHookHandler, onResponseHookHandler, onRouteHookHandler, onSendAsyncHookHandler, onSendHookHandler, onTimeoutAsyncHookHandler, onTimeoutHookHandler, preHandlerAsyncHookHandler, preHandlerHookHandler, preParsingAsyncHookHandler, preParsingHookHandler, preSerializationAsyncHookHandler, preSerializationHookHandler, preValidationAsyncHookHandler, preValidationHookHandler, onRequestAbortHookHandler, onRequestAbortAsyncHookHandler, preCloseAsyncHookHandler, preCloseHookHandler } from './types/hooks' import { FastifyListenOptions, FastifyInstance, PrintRoutesOptions } from './types/instance' import { FastifyBaseLogger, FastifyLoggerInstance, FastifyLoggerOptions, PinoLoggerOptions, FastifyLogFn, LogLevel } from './types/logger' import { FastifyPluginCallback, FastifyPluginAsync, FastifyPluginOptions, FastifyPlugin } from './types/plugin' import { FastifyRegister, FastifyRegisterOptions, RegisterOptions } from './types/register' import { FastifyReply } from './types/reply' import { FastifyRequest, RequestGenericInterface } from './types/request' import { RouteHandler, RouteHandlerMethod, RouteOptions, RouteShorthandMethod, RouteShorthandOptions, RouteShorthandOptionsWithHandler, RouteGenericInterface } from './types/route' import { FastifySchema, FastifySchemaCompiler, FastifySchemaValidationError, SchemaErrorDataVar, SchemaErrorFormatter } from './types/schema' import { FastifyServerFactory, FastifyServerFactoryHandler } from './types/serverFactory' import { FastifyTypeProvider, FastifyTypeProviderDefault } from './types/type-provider' import { HTTPMethods, RawServerBase, RawRequestDefaultExpression, RawReplyDefaultExpression, RawServerDefault, ContextConfigDefault, RequestBodyDefault, RequestQuerystringDefault, RequestParamsDefault, RequestHeadersDefault } from './types/utils' declare module '@fastify/error' { interface FastifyError { validationContext?: SchemaErrorDataVar; validation?: FastifySchemaValidationError[]; } } type Fastify = typeof fastify declare namespace fastify { export const errorCodes: FastifyErrorCodes; export type FastifyHttp2SecureOptions< Server extends http2.Http2SecureServer, Logger extends FastifyBaseLogger = FastifyBaseLogger > = FastifyServerOptions & { http2: true, https: http2.SecureServerOptions, http2SessionTimeout?: number } export type FastifyHttp2Options< Server extends http2.Http2Server, Logger extends FastifyBaseLogger = FastifyBaseLogger > = FastifyServerOptions & { http2: true, http2SessionTimeout?: number } export type FastifyHttpsOptions< Server extends https.Server, Logger extends FastifyBaseLogger = FastifyBaseLogger > = FastifyServerOptions & { https: https.ServerOptions | null } export type FastifyHttpOptions< Server extends http.Server, Logger extends FastifyBaseLogger = FastifyBaseLogger > = FastifyServerOptions & { http?: http.ServerOptions | null } type FindMyWayVersion = RawServer extends http.Server ? HTTPVersion.V1 : HTTPVersion.V2 export interface ConnectionError extends Error { code: string, bytesParsed: number, rawPacket: { type: string, data: number[] } } type TrustProxyFunction = (address: string, hop: number) => boolean /** * Options for a fastify server instance. Utilizes conditional logic on the generic server parameter to enforce certain https and http2 */ export type FastifyServerOptions< RawServer extends RawServerBase = RawServerDefault, Logger extends FastifyBaseLogger = FastifyBaseLogger > = { ignoreTrailingSlash?: boolean, ignoreDuplicateSlashes?: boolean, connectionTimeout?: number, keepAliveTimeout?: number, maxRequestsPerSocket?: number, forceCloseConnections?: boolean | 'idle', requestTimeout?: number, pluginTimeout?: number, bodyLimit?: number, maxParamLength?: number, disableRequestLogging?: boolean, exposeHeadRoutes?: boolean, onProtoPoisoning?: ProtoAction, onConstructorPoisoning?: ConstructorAction, logger?: boolean | FastifyLoggerOptions & PinoLoggerOptions | Logger, serializerOpts?: FJSOptions | Record, serverFactory?: FastifyServerFactory, caseSensitive?: boolean, allowUnsafeRegex?: boolean, requestIdHeader?: string | false, requestIdLogLabel?: string; useSemicolonDelimiter?: boolean, jsonShorthand?: boolean; genReqId?: (req: RawRequestDefaultExpression) => string, trustProxy?: boolean | string | string[] | number | TrustProxyFunction, querystringParser?: (str: string) => { [key: string]: unknown }, /** * @deprecated Prefer using the `constraints.version` property */ versioning?: { storage(): { get(version: string): string | null, set(version: string, store: Function): void del(version: string): void, empty(): void }, deriveVersion(req: Object, ctx?: Context): string // not a fan of using Object here. Also what is Context? Can either of these be better defined? }, constraints?: { [name: string]: ConstraintStrategy, unknown>, }, schemaController?: { bucket?: (parentSchemas?: unknown) => { add(schema: unknown): FastifyInstance; getSchema(schemaId: string): unknown; getSchemas(): Record; }; compilersFactory?: { buildValidator?: ValidatorFactory; buildSerializer?: SerializerFactory; }; }; return503OnClosing?: boolean, ajv?: { customOptions?: AjvOptions, plugins?: (Function | [Function, unknown])[] }, frameworkErrors?: ( error: FastifyError, req: FastifyRequest, FastifySchema, TypeProvider>, res: FastifyReply, RawReplyDefaultExpression, RequestGeneric, FastifyContextConfig, SchemaCompiler, TypeProvider> ) => void, rewriteUrl?: ( // The RawRequestDefaultExpression, RawReplyDefaultExpression, and FastifyTypeProviderDefault parameters // should be narrowed further but those generic parameters are not passed to this FastifyServerOptions type this: FastifyInstance, RawReplyDefaultExpression, Logger, FastifyTypeProviderDefault>, req: RawRequestDefaultExpression ) => string, schemaErrorFormatter?: SchemaErrorFormatter, /** * listener to error events emitted by client connections */ clientErrorHandler?: (error: ConnectionError, socket: Socket) => void, } /** * @deprecated use {@link FastifySchemaValidationError} */ export type ValidationResult = FastifySchemaValidationError; /* Export additional types */ export type { LightMyRequestChain, InjectOptions, LightMyRequestResponse, LightMyRequestCallback, // 'light-my-request' FastifyRequest, RequestGenericInterface, // './types/request' FastifyReply, // './types/reply' FastifyPluginCallback, FastifyPluginAsync, FastifyPluginOptions, FastifyPlugin, // './types/plugin' FastifyListenOptions, FastifyInstance, PrintRoutesOptions, // './types/instance' FastifyLoggerOptions, FastifyBaseLogger, FastifyLoggerInstance, FastifyLogFn, LogLevel, // './types/logger' FastifyRequestContext, FastifyContextConfig, FastifyReplyContext, // './types/context' RouteHandler, RouteHandlerMethod, RouteOptions, RouteShorthandMethod, RouteShorthandOptions, RouteShorthandOptionsWithHandler, RouteGenericInterface, // './types/route' FastifyRegister, FastifyRegisterOptions, RegisterOptions, // './types/register' FastifyBodyParser, FastifyContentTypeParser, AddContentTypeParser, hasContentTypeParser, getDefaultJsonParser, ProtoAction, ConstructorAction, // './types/content-type-parser' FastifyError, // '@fastify/error' FastifySchema, FastifySchemaCompiler, // './types/schema' HTTPMethods, RawServerBase, RawRequestDefaultExpression, RawReplyDefaultExpression, RawServerDefault, ContextConfigDefault, RequestBodyDefault, RequestQuerystringDefault, RequestParamsDefault, RequestHeadersDefault, // './types/utils' DoneFuncWithErrOrRes, HookHandlerDoneFunction, RequestPayload, onCloseAsyncHookHandler, onCloseHookHandler, onErrorAsyncHookHandler, onErrorHookHandler, onReadyAsyncHookHandler, onReadyHookHandler, onListenAsyncHookHandler, onListenHookHandler, onRegisterHookHandler, onRequestAsyncHookHandler, onRequestHookHandler, onResponseAsyncHookHandler, onResponseHookHandler, onRouteHookHandler, onSendAsyncHookHandler, onSendHookHandler, onTimeoutAsyncHookHandler, onTimeoutHookHandler, preHandlerAsyncHookHandler, preHandlerHookHandler, preParsingAsyncHookHandler, preParsingHookHandler, preSerializationAsyncHookHandler, preSerializationHookHandler, preValidationAsyncHookHandler, preValidationHookHandler, onRequestAbortHookHandler, onRequestAbortAsyncHookHandler, preCloseAsyncHookHandler, preCloseHookHandler, // './types/hooks' FastifyServerFactory, FastifyServerFactoryHandler, // './types/serverFactory' FastifyTypeProvider, FastifyTypeProviderDefault, // './types/type-provider' FastifyErrorCodes, // './types/errors' } // named export // import { plugin } from 'plugin' // const { plugin } = require('plugin') export const fastify: Fastify // default export // import plugin from 'plugin' export { fastify as default } } /** * Fastify factory function for the standard fastify http, https, or http2 server instance. * * The default function utilizes http * * @param opts Fastify server options * @returns Fastify server instance */ declare function fastify< Server extends http2.Http2SecureServer, Request extends RawRequestDefaultExpression = RawRequestDefaultExpression, Reply extends RawReplyDefaultExpression = RawReplyDefaultExpression, Logger extends FastifyBaseLogger = FastifyBaseLogger, TypeProvider extends FastifyTypeProvider = FastifyTypeProviderDefault, >(opts: fastify.FastifyHttp2SecureOptions): FastifyInstance & PromiseLike> declare function fastify< Server extends http2.Http2Server, Request extends RawRequestDefaultExpression = RawRequestDefaultExpression, Reply extends RawReplyDefaultExpression = RawReplyDefaultExpression, Logger extends FastifyBaseLogger = FastifyBaseLogger, TypeProvider extends FastifyTypeProvider = FastifyTypeProviderDefault, >(opts: fastify.FastifyHttp2Options): FastifyInstance & PromiseLike> declare function fastify< Server extends https.Server, Request extends RawRequestDefaultExpression = RawRequestDefaultExpression, Reply extends RawReplyDefaultExpression = RawReplyDefaultExpression, Logger extends FastifyBaseLogger = FastifyBaseLogger, TypeProvider extends FastifyTypeProvider = FastifyTypeProviderDefault, >(opts: fastify.FastifyHttpsOptions): FastifyInstance & PromiseLike> declare function fastify< Server extends http.Server, Request extends RawRequestDefaultExpression = RawRequestDefaultExpression, Reply extends RawReplyDefaultExpression = RawReplyDefaultExpression, Logger extends FastifyBaseLogger = FastifyBaseLogger, TypeProvider extends FastifyTypeProvider = FastifyTypeProviderDefault, >(opts?: fastify.FastifyHttpOptions): FastifyInstance & PromiseLike> // CJS export // const fastify = require('fastify') export = fastify