import { Request, Response, Handler as Handler$1, Express } from 'express';
import { Server } from 'http';
import { Server as Server$1 } from 'https';
import { AddressInfo } from 'net';
import { AsyncLocalStorage } from 'node:async_hooks';
import { OptionsJson } from 'body-parser';
import { CookieParseOptions } from 'cookie-parser';
import { CorsOptions, CorsOptionsDelegate } from 'cors';
import { HelmetOptions } from 'helmet';

declare const getStats: (port: any) => {
    set: (field: any, number?: number) => number;
    add: (field: any, number?: number) => number;
    getCounter: (field: any) => number;
    registerEvent: (eventName: any, data: any) => void;
    getEvents: (eventName: any) => any;
    logStartup: () => any;
};

interface ErrorClass<TError extends Error = Error> {
    new (...args: unknown[]): TError;
}
type Path = string;
type Config = {
    cors?: CorsOptions | CorsOptionsDelegate | false;
    jsonBodyParser?: OptionsJson | false;
    cookieParser?: [secret?: string | string[], options?: CookieParseOptions] | false;
    helmet?: HelmetOptions | false;
};
type ContextContainer<TContext extends Record<string, unknown> = Record<string, never>> = {
    get: <TKey extends keyof TContext>(key: TKey) => TContext[TKey];
    set: <TKey extends keyof TContext>(key: TKey, value: TContext[TKey]) => void;
    nativeLocalStorage: AsyncLocalStorage<TContext>;
    run: <TParams extends unknown[]>(fn: (...params: TParams) => Promise<void>, ...params: TParams) => Promise<void>;
};
type GetContextContainerHelper<TContext extends Record<string, unknown> = Record<string, never>> = () => {
    get: <TKey extends keyof TContext>(key: TKey) => TContext[TKey];
    set: <TKey extends keyof TContext>(key: TKey, value: TContext[TKey]) => void;
    nativeLocalStorage: AsyncLocalStorage<TContext>;
};
type HandlerParams<TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    body: any;
    query: any;
    params: any;
    method: string;
    originalUrl: string;
    protocol: string;
    xhr: boolean;
    getHeader: (x: string) => string;
    get: (x: string) => string;
    locals: TLocals;
    next: (error?: any) => void;
    req: Request & {
        requestTiming?: number;
    };
    res: Response;
    requestContext: TRequestContext extends false ? TRequestContext extends false ? never : never : ContextContainer<TRequestContext>;
    globalContext: TGlobalContext extends false ? TGlobalContext extends false ? never : never : ContextContainer<TGlobalContext>;
};
type Headers = {
    [headerName: string]: string;
};
type ResponseDefinition = {
    body?: string | object | Buffer;
    status?: number;
    method?: string;
    redirect?: false | string;
    headers?: Headers;
    type?: string;
};
type SingleHandler<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = (handlerParams: HandlerParams<TLocals, TRequestContext, TGlobalContext> & AdditionalRouteParams) => ResponseDefinition | Promise<ResponseDefinition> | Error | Promise<Error> | void | Promise<void> | Promise<void | ResponseDefinition | Error>;
type Handler<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = SingleHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
type SingleErrorHandler<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TError extends Error = Error> = (error: TError, handlerParams: Omit<HandlerParams<TLocals, TRequestContext, TGlobalContext>, 'params'> & AdditionalRouteParams) => ResponseDefinition | Promise<ResponseDefinition> | Error | Promise<Error> | void | Promise<void> | Promise<void | ResponseDefinition | Error>;
type ErrorHandler<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TError extends Error = Error> = SingleErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, TError> | ErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, TError>[];
type HttpMethod = 'use' | 'get' | 'post' | 'put' | 'delete' | 'del' | 'options' | 'patch' | 'head' | 'checkout' | 'copy' | 'lock' | 'merge' | 'mkactivity' | 'mkcol' | 'move' | 'm-search' | 'notify' | 'purge' | 'report' | 'search' | 'subscribe' | 'trace' | 'unlock' | 'unsubscribe';
type Handlers<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    [method in HttpMethod]?: Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
};
type PathObjectRoutes<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    [path: string]: Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handlers<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handlers<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[] | PathObjectRoutes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | PathObjectRoutes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[] | Routes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
};
type ObjectRoute<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    path: Path;
    handlers?: Handlers<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handlers<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    routes?: Routes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
};
type ArrayOfArraysRest<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = Routes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handlers<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handlers<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[] | Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[] | ArrayOfArrays<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | ArrayOfArraysRest<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
type ArrayOfArrays<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = [
    Path,
    ...ArrayOfArraysRest<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[]
];
type Routes<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = ObjectRoute<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[] | Routes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[] | ArrayOfArrays<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | ObjectRoute<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | PathObjectRoutes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
type GetHandlerParams = <AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>>(params: HandlerParams<TLocals, TRequestContext, TGlobalContext> & AdditionalRouteParams) => Record<string, any>;
type GetErrorHandlerParams = <AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>>(params: HandlerParams<TLocals, TRequestContext, TGlobalContext> & AdditionalRouteParams) => Record<string, any>;
type MapResponse = <AdditionalRouteParams extends Record<string, unknown> = Record<string, never>>(responseObject: ResponseDefinition, routeParams: AdditionalRouteParams) => Record<string, any>;
type Plugin<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = (config: SimpleExpressConfigForPlugins<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>) => {
    getHandlerParams?: GetHandlerParams;
    getErrorHandlerParams?: GetErrorHandlerParams;
    mapResponse?: MapResponse;
};
type RequestContextConfig<RequestContext extends Record<string, unknown> = Record<string, never>, AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>> = (handlerParams: HandlerParams<TLocals> & AdditionalRouteParams) => RequestContext;
type GlobalContextConfig<GlobalContext extends Record<string, unknown> = Record<string, never>> = GlobalContext;
type SimpleExpressConfig<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    port?: string | number;
    routes?: Routes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
    middleware?: Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    errorHandlers?: ErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | ErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    expressMiddleware?: Handler$1[];
    config?: Config;
    routeParams?: AdditionalRouteParams;
    app?: Express | symbol;
    server?: Server | Server$1 | symbol;
    plugins?: Plugin<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    requestContext?: RequestContextConfig<TRequestContext, AdditionalRouteParams, TLocals> | false;
    globalContext?: GlobalContextConfig<TGlobalContext> | false;
};
type SimpleExpressConfigForPlugins<AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    port?: string | number;
    routes?: Routes<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
    middleware?: Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | Handler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    errorHandlers?: ErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | ErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    expressMiddleware?: Handler$1[];
    config?: Config;
    routeParams?: AdditionalRouteParams;
    app?: Express | symbol;
    server?: Server | Server$1 | symbol;
    plugins?: Plugin<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
    requestContext?: RequestContextConfig<TRequestContext, AdditionalRouteParams, TLocals> | false;
    globalContext?: GlobalContextConfig<TGlobalContext> | false;
};
type SimpleExpressResult<TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = {
    app: Express;
    server: Server | Server$1;
    stats: ReturnType<typeof getStats>;
    port: string | number;
    address: AddressInfo | string | null;
    getRequestContext: GetContextContainerHelper<TRequestContext>;
    getGlobalContext: GetContextContainerHelper<TGlobalContext>;
};

type ErrorClassInput = ErrorClass<any> | readonly ErrorClass<any>[] | undefined | null;
type InferErrorFromClassInput<TErrorClassInput extends ErrorClassInput> = TErrorClassInput extends readonly ErrorClass<any>[] ? InstanceType<TErrorClassInput[number]> : TErrorClassInput extends ErrorClass<any> ? InstanceType<TErrorClassInput> : Error;
type FallbackErrorHandler<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = SingleErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, Error>;
type ErrorHandlerTupleForClassInput<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TErrorClassInput extends ErrorClassInput = ErrorClassInput> = readonly [
    errorClass: TErrorClassInput,
    errorHandler: SingleErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, InferErrorFromClassInput<TErrorClassInput>>
];
type SingleErrorHandlerTuple<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = readonly [
    errorHandler: FallbackErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>
];
type ErrorHandlersList<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TClassInputs extends readonly ErrorClassInput[] = readonly ErrorClassInput[]> = {
    [K in keyof TClassInputs]: ErrorHandlerTupleForClassInput<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, TClassInputs[K]> | SingleErrorHandlerTuple<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext> | FallbackErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
};
type HandleErrorReturn<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>> = FallbackErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>[];
declare function handleErrors<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TErrorClass extends ErrorClass<any> = ErrorClass<any>>(errorClass: TErrorClass, errorHandler: SingleErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, InstanceType<TErrorClass>>): HandleErrorReturn<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
declare function handleErrors<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TErrorClasses extends readonly ErrorClass<any>[] = readonly ErrorClass<any>[]>(errorClasses: TErrorClasses, errorHandler: SingleErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, InstanceType<TErrorClasses[number]>>): HandleErrorReturn<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
declare function handleErrors<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>>(errorHandler: FallbackErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>): HandleErrorReturn<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
declare function handleErrors<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TClassInputs extends readonly ErrorClassInput[] = readonly ErrorClassInput[]>(handlers: ErrorHandlersList<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, TClassInputs>): HandleErrorReturn<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;
declare function handleErrors<AdditionalRouteParams extends Record<string, unknown>, TLocals extends Record<string, unknown>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>, TClassInputs extends readonly ErrorClassInput[] = readonly ErrorClassInput[]>(handlers: ErrorHandlersList<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext, TClassInputs>, defaultErrorHandler: FallbackErrorHandler<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>): HandleErrorReturn<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>;

declare const ensureArray: <T>(value: T) => T extends any[] ? T : T[];
declare let getRequestContext: any;
declare let getGlobalContext: any;
declare const simpleExpress: <AdditionalRouteParams extends Record<string, unknown> = Record<string, never>, TLocals extends Record<string, unknown> = Record<string, never>, TRequestContext extends Record<string, unknown> = Record<string, never>, TGlobalContext extends Record<string, unknown> = Record<string, never>>({ port, plugins: rawPlugins, requestContext: requestContextConfig, globalContext: globalContextConfig, routes, middleware: rawMiddleware, errorHandlers, expressMiddleware, config: userConfig, routeParams, app: userApp, server: userServer, }?: SimpleExpressConfig<AdditionalRouteParams, TLocals, TRequestContext, TGlobalContext>) => Promise<SimpleExpressResult<TRequestContext, TGlobalContext>>;
declare const wrapMiddleware: (...middleware: (Handler$1 | Handler$1[])[]) => (({ req, res, next }: HandlerParams<any>) => void)[];

export { type Config, type ErrorHandler, type Handler, type HandlerParams, type Plugin, type Routes, type SimpleExpressConfig, type SimpleExpressConfigForPlugins, type SimpleExpressResult, simpleExpress as default, ensureArray, getGlobalContext, getRequestContext, handleErrors as handleError, simpleExpress, wrapMiddleware };