balda 0.0.9 → 0.0.10

package/lib/index.d.cts

@@ -1,5 +1,6 @@
 import { schedule, TaskContext } from 'node-cron';
-import { ZodType, ZodAny } from 'zod';
+import { ZodType, z } from 'zod';
+import { TSchema, Static } from '@sinclair/typebox';
 import { Ajv } from 'ajv';
 import { ServerResponse, IncomingMessage, Server as Server$2 } from 'node:http';
 import { Http2Server } from 'node:http2';
@@ -11,7 +12,6 @@ import { RequestHandler, Router as Router$1, IRouter } from 'express';
 export { ErrorRequestHandler as ExpressErrorMiddleware, RequestHandler as ExpressMiddleware, NextFunction as ExpressNextFunction, Request as ExpressRequest, Response as ExpressResponse } from 'express';
 import * as pino from 'pino';
 import pino__default, { pino as pino$1 } from 'pino';
-import { TSchema } from '@sinclair/typebox';
 import { IClientSubscribeOptions, IClientOptions, IClientPublishOptions, MqttClient } from 'mqtt';
 import { SQSClientConfig, SendMessageCommandInput } from '@aws-sdk/client-sqs';
 import { Queue, JobsOptions, Job } from 'bullmq';
@@ -301,14 +301,11 @@ type OpenIdConnectOptions = {
  */
 declare const controller: (path?: string, swaggerOptions?: SwaggerRouteOptions) => (target: any) => void;
 
-type AjvInstance = InstanceType<typeof Ajv>;
-type AjvCompileParams = Parameters<AjvInstance["compile"]>;
-
 type SyncOrAsync<T = void> = T | Promise<T>;
 
 interface AsyncLocalStorageContext {
 }
-type AsyncLocalStorageContextSetters<K extends keyof AsyncLocalStorageContext = keyof AsyncLocalStorageContext> = Record<K, (req: Request$1) => SyncOrAsync<AsyncLocalStorageContext[K]>>;
+type AsyncLocalStorageContextSetters<K extends keyof AsyncLocalStorageContext = keyof AsyncLocalStorageContext> = Record<K, (req: Request) => SyncOrAsync<AsyncLocalStorageContext[K]>>;
 
 type StaticPluginOptions = {
     /**
@@ -367,13 +364,33 @@ type FilePluginOptions = {
     allowedMimeTypes?: (FileAllowedMimeType | (string & {}))[];
 };
 
-declare global {
-    interface Request {
-        params: Record<string, string>;
-        query: Record<string, string>;
-    }
+type AjvInstance = InstanceType<typeof Ajv>;
+type AjvCompileParams = Parameters<AjvInstance["compile"]>;
+
+type RequestSchema = ZodType | TSchema | AjvCompileParams[0];
+type ValidatedData<T extends RequestSchema> = T extends ZodType ? z.infer<T> : T extends TSchema ? Static<T> : T extends AjvCompileParams[0] ? any : any;
+interface CustomValidationError {
+    status?: number;
+    message?: string;
 }
-declare class NativeRequest extends Request {
+interface ValidationOptions {
+    /**
+     * The schema to validate the request body against (Zod, TypeBox, or plain JSON schema)
+     */
+    body?: RequestSchema;
+    /**
+     * The schema to validate the query parameters against (Zod, TypeBox, or plain JSON schema)
+     */
+    query?: RequestSchema;
+    /**
+     * The schema to validate both body and query against (Zod, TypeBox, or plain JSON schema)
+     */
+    all?: RequestSchema;
+    /**
+     * Whether to use safe validation (returns original data if validation fails instead of throwing)
+     * @default false
+     */
+    safe?: boolean;
 }
 
 /**
@@ -382,13 +399,31 @@ declare class NativeRequest extends Request {
  * It contains the request body, query parameters, files, cookies, etc.
  * It also contains the validation methods.
  */
-declare class Request$1<Params extends Record<string, string> = any> extends NativeRequest {
-    static fromRequest(request: Request$1 | NativeRequest): Request$1;
+declare class Request<Params extends Record<string, string> = any> extends globalThis.Request {
+    /**
+     * Creates a new request object from a Web API Request object.
+     * @param request - The Web API Request object to create a new request object from.
+     * @returns The new request object.
+     */
+    static fromRequest(request: globalThis.Request): Request;
+    /**
+     * Compiles and validates the request data against the input schema.
+     * @param inputSchema - The schema to validate the request data against (Zod, TypeBox, or plain JSON schema).
+     * @param data - The request data to validate.
+     * @param safe - If true, the function will return the original data if the validation fails instead of throwing an error.
+     * @returns The validated data.
+     */
     private static compileAndValidate;
     /**
-     * Enrich native request with validation methods.
+     * The raw Web API Request body.
+     * @warning if using body parser middleware, this property will be read and the parsed body will be set to the `parsedBody` property.
+     * @warning this body can be read once so be careful not to use it after the body parser middleware has been applied.
+     */
+    readonly body: globalThis.Request["body"];
+    /**
+     * The parsed body of the request from the body parser middleware.
      */
-    static enrichRequest(request: Request$1): Request$1;
+    parsedBody: any;
     /**
      * The context of the request. Can be augmented extending AsyncLocalStorageContext interface
      * @asyncLocalStorage middleware is required
@@ -460,38 +495,30 @@ declare class Request$1<Params extends Record<string, string> = any> extends Nat
      * The query parameters of the request.
      */
     query: Record<string, string>;
-    /**
-     * The raw body of the request. Only available for POST, PUT, PATCH and DELETE requests.
-     */
-    rawBody?: ArrayBuffer;
     private _id;
     /**
      * The id of the request.
      */
     get id(): string;
     set id(value: string);
-    /**
-     * The parsed body of the request
-     */
-    body: any;
     /**
      * The validated body of the request.
      * @param inputSchema - The schema to validate the body against (Zod schema or JSON Schema).
      * @param safe - If true, the function will return the original body if the validation fails instead of throwing an error.
      */
-    validate(inputSchema: ZodAny | AjvCompileParams[0], safe?: boolean): any;
+    validate<T extends RequestSchema>(inputSchema: T, safe?: boolean): ValidatedData<T>;
     /**
      * Validates the query string of the request.
      * @param inputSchema - The schema to validate the query against (Zod schema or JSON Schema).
      * @param safe - If true, the function will return undefined if the validation fails instead of throwing an error.
      */
-    validateQuery(inputSchema: ZodAny | AjvCompileParams[0], safe?: boolean): any;
+    validateQuery<T extends RequestSchema>(inputSchema: T, safe?: boolean): ValidatedData<T>;
     /**
      * Validates the body and query string of the request.
      * @param inputSchema - The schema to validate against (Zod schema or JSON Schema).
      * @param safe - If true, the function will return undefined if the validation fails instead of throwing an error.
      */
-    validateAll(inputSchema: ZodAny | AjvCompileParams[0], safe?: boolean): any;
+    validateAll<T extends RequestSchema>(inputSchema: T, safe?: boolean): ValidatedData<T>;
 }
 
 /**
@@ -790,7 +817,7 @@ declare class Response$1 {
     getBody(): any;
 }
 
-type DelHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
+type DelHandler = (req: Request, res: Response$1, ...args: any[]) => any;
 /**
  * Decorator to mark an handler for a DELETE request
  * @param path - The path of the route
@@ -811,7 +838,7 @@ type DelHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
  */
 declare const del: (path: string, options?: SwaggerRouteOptions) => <T extends DelHandler>(target: any, propertyKey: string, descriptor: PropertyDescriptor) => TypedPropertyDescriptor<T>;
 
-type GetHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
+type GetHandler = (req: Request, res: Response$1, ...args: any[]) => any;
 /**
  * Decorator to mark an handler for a GET request
  * @param path - The path of the route
@@ -832,7 +859,7 @@ type GetHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
  */
 declare const get: (path: string, options?: SwaggerRouteOptions) => <T extends GetHandler>(target: any, propertyKey: string, descriptor: PropertyDescriptor) => TypedPropertyDescriptor<T>;
 
-type PatchHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
+type PatchHandler = (req: Request, res: Response$1, ...args: any[]) => any;
 /**
  * Decorator to mark an handler for a PATCH request
  * @param path - The path of the route
@@ -853,7 +880,7 @@ type PatchHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
  */
 declare const patch: (path: string, options?: SwaggerRouteOptions) => <T extends PatchHandler>(target: any, propertyKey: string, descriptor: PropertyDescriptor) => TypedPropertyDescriptor<T>;
 
-type PostHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
+type PostHandler = (req: Request, res: Response$1, ...args: any[]) => any;
 /**
  * Decorator to mark an handler for a POST request
  * @param path - The path of the route
@@ -874,7 +901,7 @@ type PostHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
  */
 declare const post: (path: string, options?: SwaggerRouteOptions) => <T extends PostHandler>(target: any, propertyKey: string, descriptor: PropertyDescriptor) => TypedPropertyDescriptor<T>;
 
-type PutHandler = (req: Request$1, res: Response$1, ...args: any[]) => any;
+type PutHandler = (req: Request, res: Response$1, ...args: any[]) => any;
 /**
  * Decorator to mark an handler for a PUT request
  * @param path - The path of the route
@@ -1318,38 +1345,6 @@ interface HelmetOptions {
     contentSecurityPolicy?: false | string;
 }
 
-interface JsonOptions {
-    /**
-     * The maximum size of the JSON body in bytes.
-     * If the body is larger than this limit, the request will be rejected.
-     * Default: 100kb
-     */
-    sizeLimit?: `${number}mb` | `${number}kb`;
-    /**
-     * If true, the JSON body will be parsed as an empty object if it is empty.
-     * Default: false (body will be undefined)
-     */
-    parseEmptyBodyAsObject?: boolean;
-    /**
-     * The encoding to use when decoding the request body.
-     * Default: "utf-8"
-     */
-    encoding?: TextDecoderEncoding;
-    /**
-     * The custom error message to return when the JSON body is too large.
-     * Default: response with status 413 and body { message: "ERR_REQUEST_BODY_TOO_LARGE" }
-     */
-    customErrorMessage?: {
-        status?: number;
-        message?: string;
-    };
-}
-/**
- * Supported text encodings for TextDecoder.
- * Based on the WHATWG Encoding Standard.
- */
-type TextDecoderEncoding = "utf-8" | "utf-16le" | "utf-16be" | "gbk" | "gb18030" | "big5" | "euc-jp" | "iso-2022-jp" | "shift-jis" | "euc-kr" | "iso-2022-kr" | "iso-8859-1" | "iso-8859-2" | "iso-8859-3" | "iso-8859-4" | "iso-8859-5" | "iso-8859-6" | "iso-8859-7" | "iso-8859-8" | "iso-8859-9" | "iso-8859-10" | "iso-8859-13" | "iso-8859-14" | "iso-8859-15" | "iso-8859-16" | "windows-1250" | "windows-1251" | "windows-1252" | "windows-1253" | "windows-1254" | "windows-1255" | "windows-1256" | "windows-1257" | "windows-1258" | "x-mac-cyrillic" | "x-mac-greek" | "x-mac-icelandic" | "x-mac-latin2" | "x-mac-roman" | "x-mac-turkish" | "koi8-r" | "koi8-u";
-
 type LoggerOptions = Parameters<typeof pino$1>[0];
 
 interface LogOptions {
@@ -1444,7 +1439,7 @@ type CustomRateLimiterOptions = {
     /**
      * Generate a key for the rate limiter from the request (e.g. user id, email, etc.)
      */
-    key: (req: Request$1) => string;
+    key: (req: Request) => string;
     /**
      * The storage strategy to use
      * @default "memory"
@@ -1533,6 +1528,35 @@ type TrustProxyOptions = {
     hop?: "first" | "last";
 };
 
+/**
+ * The next function.
+ * This is the function that is passed to the handler function.
+ * It has a pointer to the next middleware or handler function of the middleware chain.
+ */
+type NextFunction = () => SyncOrAsync;
+
+interface JsonOptions {
+    /**
+     * The maximum size of the JSON body in bytes.
+     * If the body is larger than this limit, the request will be rejected.
+     * Default: 100kb
+     */
+    sizeLimit?: `${number}mb` | `${number}kb`;
+    /**
+     * If true, the JSON body will be parsed as an empty object if it is empty.
+     * Default: false (body will be undefined)
+     */
+    parseEmptyBodyAsObject?: boolean;
+    /**
+     * The custom error message to return when the JSON body is too large.
+     * Default: response with status 413 and body { message: "ERR_REQUEST_BODY_TOO_LARGE" }
+     */
+    customErrorMessage?: {
+        status?: number;
+        message?: string;
+    };
+}
+
 /**
  * Options for URL-encoded middleware
  */
@@ -1561,22 +1585,19 @@ type UrlEncodedOptions = {
     parameterLimit?: number;
 };
 
-/**
- * The next function.
- * This is the function that is passed to the handler function.
- * It has a pointer to the next middleware or handler function of the middleware chain.
- */
-type NextFunction = () => SyncOrAsync;
+type BodyParserOptions = {
+    json?: JsonOptions;
+    urlencoded?: UrlEncodedOptions;
+    fileParser?: FilePluginOptions;
+};
 
 type ServerPlugin = {
+    bodyParser?: BodyParserOptions;
     cors?: CorsOptions;
-    json?: JsonOptions;
     static?: StaticPluginOptions;
-    fileParser?: FilePluginOptions;
     helmet?: HelmetOptions;
     cookie?: CookieMiddlewareOptions;
     log?: LogOptions;
-    urlencoded?: UrlEncodedOptions;
     rateLimiter?: {
         keyOptions?: RateLimiterKeyOptions;
         storageOptions?: StorageOptions$1;
@@ -1602,8 +1623,6 @@ type ServerOptions<H extends NodeHttpClient = NodeHttpClient> = {
     plugins?: ServerPlugin;
     /** The tap options to interact with the underlying server connector before it is used to listen for incoming requests */
     tapOptions?: ServerTapOptions;
-    /** Whether to use the body parser plugin, by default it is true, it is really recommended to use it */
-    useBodyParser?: boolean;
     /**
      * The swagger options to apply to the server, by default swagger plugin is applied with standard options, you can pass a boolean to enable or disable the plugin or you can pass an object to apply custom options to the plugin
      * @example
@@ -1651,11 +1670,10 @@ type ResolvedServerOptions = {
     controllerPatterns: string[];
     plugins: ServerPlugin;
     tapOptions: ServerTapOptions;
-    useBodyParser: boolean;
     swagger: Parameters<typeof swagger>[0] | boolean;
     graphql?: GraphQLOptions;
 };
-type ServerErrorHandler = (req: Request$1, res: Response$1, next: NextFunction, error: Error) => SyncOrAsync;
+type ServerErrorHandler = (req: Request, res: Response$1, next: NextFunction, error: Error) => SyncOrAsync;
 interface ServerInterface {
     /**
      * Identifier for the balda server instance
@@ -1932,8 +1950,8 @@ type ServerConnectInput<H extends NodeHttpClient = NodeHttpClient> = {
     /** The graphql options to apply to the server */
     graphql?: GraphQL;
 } & (H extends "https" ? HttpsOptions<H> : {});
-type ServerRouteMiddleware = (req: Request$1, res: Response$1, next: NextFunction) => SyncOrAsync;
-type ServerRouteHandler = (req: Request$1, res: Response$1) => SyncOrAsync;
+type ServerRouteMiddleware = (req: Request, res: Response$1, next: NextFunction) => SyncOrAsync;
+type ServerRouteHandler = (req: Request, res: Response$1) => SyncOrAsync;
 interface ServerRoute {
     /** The path for the route */
     path: string;
@@ -1952,7 +1970,7 @@ type ServerListenCallback = ({ port, host, url, }: {
 /**
  * Custom bun fetch call to be used as an hook inside Bun.serve method
  */
-type CustomBunFetch = (req: Request$1, server: Bun.Server<any>) => SyncOrAsync;
+type CustomBunFetch = (req: Request, server: Bun.Server<any>) => SyncOrAsync;
 /**
  * Custom deno fetch call to be used as an hook inside Deno.serve method
  */
@@ -1998,39 +2016,15 @@ interface SerializeOptions {
     safe?: boolean;
 }
 
-declare const serialize: <T extends ZodType | TSchema | AjvCompileParams[0]>(schema: T, options?: SerializeOptions) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
-
-interface CustomValidationError {
-    status?: number;
-    message?: string;
-}
-interface ValidationOptions {
-    /**
-     * The schema to validate the request body against (Zod, TypeBox, or plain JSON schema)
-     */
-    body?: ZodType | TSchema | AjvCompileParams[0];
-    /**
-     * The schema to validate the query parameters against (Zod, TypeBox, or plain JSON schema)
-     */
-    query?: ZodType | TSchema | AjvCompileParams[0];
-    /**
-     * The schema to validate both body and query against (Zod, TypeBox, or plain JSON schema)
-     */
-    all?: ZodType | TSchema | AjvCompileParams[0];
-    /**
-     * Whether to use safe validation (returns original data if validation fails instead of throwing)
-     * @default false
-     */
-    safe?: boolean;
-}
+declare const serialize: <T extends RequestSchema>(schema: T, options?: SerializeOptions) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 
 declare const validate: {
     (options: ValidationOptions & {
         customError?: CustomValidationError;
     }): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-    query(schema: ZodType | AjvCompileParams[0], customError?: CustomValidationError): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-    body(schema: ZodType | AjvCompileParams[0], customError?: CustomValidationError): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-    all(schema: ZodType | AjvCompileParams[0], customError?: CustomValidationError): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+    query(schema: RequestSchema, customError?: CustomValidationError): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+    body(schema: RequestSchema, customError?: CustomValidationError): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+    all(schema: RequestSchema, customError?: CustomValidationError): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 };
 
 /**
@@ -2207,6 +2201,25 @@ declare class BaseQueue {
     protected readonly logger: pino.Logger<string, boolean>;
 }
 
+declare class BullMQPubSub implements GenericPubSub {
+    private queues;
+    private workers;
+    private bullmqClient;
+    publish<TPayload>(topic: string, payload: TPayload, options?: PublishOptions<"bullmq">): Promise<{
+        id: string;
+    }>;
+    subscribe<TPayload>(topic: string, handler: (payload: TPayload) => Promise<void>): Promise<void>;
+    private getQueue;
+    private getBullMQClient;
+    publishWithConfig<TPayload>(topic: string, payload: TPayload, options?: PublishOptions<"bullmq">, queueConfig?: BullMQQueueOptions): Promise<{
+        id: string;
+    }>;
+    subscribeWithConfig<TPayload>(topic: string, handler: (payload: TPayload) => Promise<void>, queueConfig?: BullMQQueueOptions): Promise<void>;
+    private getQueueWithConfig;
+    private getQueueKey;
+    private getWorkerKey;
+}
+
 declare class PGBossPubSub implements GenericPubSub {
     private boss;
     private createdQueues;
@@ -2271,141 +2284,6 @@ interface QueueProvider {
 }
 type QueueProviderKey = keyof QueueProvider;
 
-declare class BullMQPubSub implements GenericPubSub {
-    private queues;
-    private workers;
-    private bullmqClient;
-    publish<TPayload>(topic: string, payload: TPayload, options?: PublishOptions<"bullmq">): Promise<{
-        id: string;
-    }>;
-    subscribe<TPayload>(topic: string, handler: (payload: TPayload) => Promise<void>): Promise<void>;
-    private getQueue;
-    private getBullMQClient;
-    publishWithConfig<TPayload>(topic: string, payload: TPayload, options?: PublishOptions<"bullmq">, queueConfig?: BullMQQueueOptions): Promise<{
-        id: string;
-    }>;
-    subscribeWithConfig<TPayload>(topic: string, handler: (payload: TPayload) => Promise<void>, queueConfig?: BullMQQueueOptions): Promise<void>;
-    private getQueueWithConfig;
-    private getQueueKey;
-    private getWorkerKey;
-}
-
-/**
- * Options for BullMQ configuration
- * @param options - The options for BullMQ
- * @param errorHandler - Custom error handler that will be triggered when a job fails, for logging or debug purposes
- */
-type BullMQConfigurationOptions = ConstructorParameters<typeof Queue>[1] & {
-    errorHandler?: (job: Job, error: Error) => SyncOrAsync;
-};
-declare class BullMQConfiguration {
-    static options: BullMQConfigurationOptions;
-}
-/**
- * Define globally custom BullMQ configuration
- * @param options - The BullMQ configuration options
- */
-declare const defineBullMQConfiguration: (options: BullMQConfigurationOptions) => void;
-
-type CustomQueueConfiguration = GenericPubSub;
-
-type PGBossConfigurationOptions = {
-    connectionString?: string;
-    boss?: unknown;
-    errorHandler?: (error: Error) => SyncOrAsync;
-};
-declare class PGBossConfiguration {
-    static options: PGBossConfigurationOptions;
-}
-declare const definePGBossConfiguration: (options: PGBossConfigurationOptions) => void;
-
-type SQSConfigurationOptions = {
-    client?: SQSClientConfig;
-    consumer?: {
-        batchSize?: number;
-        visibilityTimeout?: number;
-        waitTimeSeconds?: number;
-        queueUrlMap: Record<string, string>;
-    };
-    errorHandler?: (error: Error) => SyncOrAsync;
-};
-declare class SQSConfiguration {
-    static options: SQSConfigurationOptions;
-}
-declare const defineSQSConfiguration: (options: SQSConfigurationOptions) => void;
-
-declare class QueueManager {
-    static map: Map<QueueProviderKey, GenericPubSub>;
-    static getProvider<P extends QueueProviderKey>(provider: P): GenericPubSub<P>;
-    static setProvider(provider: QueueProviderKey, pubsub: GenericPubSub<QueueProviderKey>): void;
-}
-
-/**
- * Main entry point to define the queue configuration, meant to be called only once in the application bootstrap
- * @bullmq - The BullMQ configuration options
- * @pgboss - The PGBoss configuration options
- * @sqs - The SQS configuration options
- * @string - The custom queue provider name with it's PubSub implementation
- * @example
- * defineQueueConfiguration({
- *   bullmq: {
- *     connection: {
- *       host: "127.0.0.1",
- *       password: "root",
- *       username: "default",
- *       db: 0,
- *     },
- *   },
- *   pgboss: {
- *     connectionString: "postgres://root:root@localhost:5432/database",
- *   },
- *   sqs: {
- *     client: { region: "us-east-1" },
- *   },
- *   custom: new CustomPubSub(),
- * });
- * @example
- * defineQueueConfiguration({
- *   custom: new CustomPubSub(),
- * });
- */
-declare const defineQueueConfiguration: (options: {
-    bullmq?: Parameters<typeof defineBullMQConfiguration>[0];
-    pgboss?: Parameters<typeof definePGBossConfiguration>[0];
-    sqs?: Parameters<typeof defineSQSConfiguration>[0];
-} & { [key in Exclude<QueueProviderKey, "bullmq" | "pgboss" | "sqs">]?: CustomQueueConfiguration; }) => void;
-
-type QueueHandler = (payload: unknown) => Promise<void>;
-type TypedQueueRegistration = {
-    name: string;
-    topic: string;
-    handler: QueueHandler;
-    provider: BuiltInProviderKey;
-    queueOptions?: unknown;
-};
-type CustomQueueRegistration = {
-    name: string;
-    topic: string;
-    handler: QueueHandler;
-    pubsub: GenericPubSub;
-};
-declare class QueueService {
-    static typedQueueSubscribers: Map<string, TypedQueueRegistration>;
-    static customQueueSubscribers: Map<string, CustomQueueRegistration>;
-    /**
-     * Factory function for creating handler instances.
-     * Can be overridden to provide custom dependency injection.
-     * @default Creates new instance using constructor
-     */
-    static instanceFactory: (ctor: Function) => object;
-    static registerTypedQueue(name: string, topic: string, handler: QueueHandler, provider: BuiltInProviderKey, queueOptions?: unknown): void;
-    static registerCustomQueue(name: string, topic: string, handler: QueueHandler, pubsub: GenericPubSub): void;
-    static run(): Promise<void>;
-    static massiveImportQueues(queueHandlerPatterns: string[], options?: {
-        throwOnError?: boolean;
-    }): Promise<void>;
-}
-
 type QueueOptionsForProvider<P extends BuiltInProviderKey> = P extends "sqs" ? SQSQueueOptions : P extends "bullmq" ? BullMQQueueOptions : P extends "pgboss" ? PGBossQueueOptions : never;
 /**
  * TypedQueue for built-in providers (sqs, bullmq, pgboss)
@@ -2556,6 +2434,122 @@ declare function pgbossQueue<TPayload>(topic: string, options?: PGBossQueueOptio
  */
 declare function createQueue<TPayload, TOptions = Record<string, unknown>>(topic: string, pubsub: GenericPubSub<TPayload>): CustomTypedQueue<TPayload, TOptions>;
 
+/**
+ * Options for BullMQ configuration
+ * @param options - The options for BullMQ
+ * @param errorHandler - Custom error handler that will be triggered when a job fails, for logging or debug purposes
+ */
+type BullMQConfigurationOptions = ConstructorParameters<typeof Queue>[1] & {
+    errorHandler?: (job: Job, error: Error) => SyncOrAsync;
+};
+declare class BullMQConfiguration {
+    static options: BullMQConfigurationOptions;
+}
+/**
+ * Define globally custom BullMQ configuration
+ * @param options - The BullMQ configuration options
+ */
+declare const defineBullMQConfiguration: (options: BullMQConfigurationOptions) => void;
+
+type CustomQueueConfiguration = GenericPubSub;
+
+type PGBossConfigurationOptions = {
+    connectionString?: string;
+    boss?: unknown;
+    errorHandler?: (error: Error) => SyncOrAsync;
+};
+declare class PGBossConfiguration {
+    static options: PGBossConfigurationOptions;
+}
+declare const definePGBossConfiguration: (options: PGBossConfigurationOptions) => void;
+
+type SQSConfigurationOptions = {
+    client?: SQSClientConfig;
+    consumer?: {
+        batchSize?: number;
+        visibilityTimeout?: number;
+        waitTimeSeconds?: number;
+        queueUrlMap: Record<string, string>;
+    };
+    errorHandler?: (error: Error) => SyncOrAsync;
+};
+declare class SQSConfiguration {
+    static options: SQSConfigurationOptions;
+}
+declare const defineSQSConfiguration: (options: SQSConfigurationOptions) => void;
+
+declare class QueueManager {
+    static map: Map<QueueProviderKey, GenericPubSub>;
+    static getProvider<P extends QueueProviderKey>(provider: P): GenericPubSub<P>;
+    static setProvider(provider: QueueProviderKey, pubsub: GenericPubSub<QueueProviderKey>): void;
+}
+
+/**
+ * Main entry point to define the queue configuration, meant to be called only once in the application bootstrap
+ * @bullmq - The BullMQ configuration options
+ * @pgboss - The PGBoss configuration options
+ * @sqs - The SQS configuration options
+ * @string - The custom queue provider name with it's PubSub implementation
+ * @example
+ * defineQueueConfiguration({
+ *   bullmq: {
+ *     connection: {
+ *       host: "127.0.0.1",
+ *       password: "root",
+ *       username: "default",
+ *       db: 0,
+ *     },
+ *   },
+ *   pgboss: {
+ *     connectionString: "postgres://root:root@localhost:5432/database",
+ *   },
+ *   sqs: {
+ *     client: { region: "us-east-1" },
+ *   },
+ *   custom: new CustomPubSub(),
+ * });
+ * @example
+ * defineQueueConfiguration({
+ *   custom: new CustomPubSub(),
+ * });
+ */
+declare const defineQueueConfiguration: (options: {
+    bullmq?: Parameters<typeof defineBullMQConfiguration>[0];
+    pgboss?: Parameters<typeof definePGBossConfiguration>[0];
+    sqs?: Parameters<typeof defineSQSConfiguration>[0];
+} & { [key in Exclude<QueueProviderKey, "bullmq" | "pgboss" | "sqs">]?: CustomQueueConfiguration; }) => void;
+
+type QueueHandler = (payload: unknown) => Promise<void>;
+type TypedQueueRegistration = {
+    name: string;
+    topic: string;
+    handler: QueueHandler;
+    provider: BuiltInProviderKey;
+    queueOptions?: unknown;
+};
+type CustomQueueRegistration = {
+    name: string;
+    topic: string;
+    handler: QueueHandler;
+    pubsub: GenericPubSub;
+};
+declare class QueueService {
+    static typedQueueSubscribers: Map<string, TypedQueueRegistration>;
+    static customQueueSubscribers: Map<string, CustomQueueRegistration>;
+    /**
+     * Factory function for creating handler instances.
+     * Can be overridden to provide custom dependency injection.
+     * @default Creates new instance using constructor
+     */
+    static instanceFactory: (ctor: Function) => object;
+    static registerTypedQueue(name: string, topic: string, handler: QueueHandler, provider: BuiltInProviderKey, queueOptions?: unknown): void;
+    static registerCustomQueue(name: string, topic: string, handler: QueueHandler, pubsub: GenericPubSub): void;
+    static run(): Promise<void>;
+    static massiveImportQueues(queueHandlerPatterns: string[], options?: {
+        throwOnError?: boolean;
+    }): Promise<void>;
+}
+
 /**
  * The logger instance, can be overridden by the `defineLoggerConfig` function
  */
@@ -3167,30 +3161,12 @@ declare function createExpressAdapter(server: {
     use(pathOrMiddleware: string | RequestHandler | Router$1, maybeMiddleware?: RequestHandler | Router$1): void;
 };
 
-/**
- * Middleware to handle multipart/form-data file uploads with security validations.
- *  - Validates files against `FilePluginOptions`: size limits, file count, MIME types.
- *  - Sanitizes filenames to prevent path traversal attacks.
- *  - Uses cryptographically secure random filenames (UUID) in temporary storage.
- *  - Stores uploaded files in a runtime-agnostic temporary directory and exposes them via `req.files`.
- *  - Automatically cleans up temporary files after request completion or on error.
- *  - Can be used as global middleware or route-specific middleware.
- */
-declare const fileParser: (options?: FilePluginOptions) => ServerRouteMiddleware;
-
 /**
  * Sets common HTTP security headers
  * @param options Helmet options (all optional)
  */
 declare const helmet: (options?: HelmetOptions) => ServerRouteMiddleware;
 
-/**
- * Middleware to parse the JSON body of the request. GET, DELETE and OPTIONS requests are not parsed.
- * @param options - The options for the JSON middleware.
- * @param options.sizeLimit - The maximum size of the JSON body. Default: 100kb
- */
-declare const json: (options?: JsonOptions) => ServerRouteMiddleware;
-
 /**
  * Logs the request and response of the handler, can be set both on a specific route or on a global middleware.
  * @warning Only json objects and strings are logged from the request and response.
@@ -3259,18 +3235,6 @@ declare const timeout: (options: TimeoutOptions) => ServerRouteMiddleware;
  */
 declare const trustProxy: (options?: TrustProxyOptions) => ServerRouteMiddleware;
 
-/**
- * URL-encoded form data parser middleware
- * Parses application/x-www-form-urlencoded bodies and populates req.body
- * @param options URL-encoded parsing options
- * @param options.limit The maximum size of the URL-encoded body. Supports "5mb", "100kb" format. Defaults to "1mb".
- * @param options.extended Whether to parse extended syntax (objects and arrays). Defaults to false.
- * @param options.charset The character encoding to use when parsing. Defaults to 'utf8'.
- * @param options.allowEmpty Whether to allow empty values. Defaults to true.
- * @param options.parameterLimit Maximum number of parameters to parse. Defaults to 1000.
- */
-declare const urlencoded: (options?: UrlEncodedOptions) => ServerRouteMiddleware;
-
 type PolicyProvider = {
     [K: string]: (...args: any[]) => Promise<boolean> | boolean;
 };
@@ -3304,4 +3268,4 @@ declare const createPolicyDecorator: <T extends Record<string, PolicyProvider>>(
  */
 declare const router: ClientRouter;
 
-export { ARG_SYMBOL, AzureBlobStorageProvider, BaseCron, BaseMqtt, BasePlugin, BaseQueue, type BaseStorageProviderOptions, type BlobStorageProviderOptions, BullMQConfiguration, type BullMQConfigurationOptions, BullMQPubSub, type BunTapOptions, Command, type CommandOptions, CommandRegistry, type CronSchedule, type CronScheduleParams, CronService, type CustomQueueConfiguration, type CustomStorageProviderOptions, CustomTypedQueue, type CustomValidationError, type DenoTapOptions, type ExpressAdapterOptions, type ExpressHandler, type ExpressRouter, type FileAllowedMimeType, GraphQL, type GraphQLContext, type GraphQLOptions, type GraphQLResolverFunction, type GraphQLResolverMap, type GraphQLResolverType, type GraphQLResolvers, type GraphQLSchemaInput, type GraphQLTypeDef, type HttpMethod, type HttpsOptions, LocalStorageProvider, type LocalStorageProviderOptions, type LoggerOptions, MockServer, type MockServerOptions, type MqttConnectionOptions, type MqttHandler, type MqttPublishOptions, MqttService, type MqttSubscribeOptions, type MqttSubscription, type MqttTopics, type NextFunction, type NodeHttpClient, type NodeServer, type NodeTapOptions, PGBossConfiguration, type PGBossConfigurationOptions, PGBossPubSub, type PolicyDecorator, PolicyManager, type PolicyMetadata, type PolicyProvider, QueueManager, QueueService, Request$1 as Request, type ResolvedServerOptions, Response$1 as Response, type ReturnType$1 as ReturnType, type ReturnTypeMap, type RuntimeServer, type RuntimeServerMap, S3StorageProvider, type S3StorageProviderOptions, SQSConfiguration, type SQSConfigurationOptions, SQSPubSub, type SerializeOptions, Server, type ServerConnectInput, type ServerErrorHandler, type ServerInterface, type ServerListenCallback, type ServerOptions, type ServerPlugin, type ServerRoute, type ServerRouteHandler, type ServerRouteMiddleware, type ServerTapOptions, type ServerTapOptionsBuilder, type SignalEvent, type StandardMethodOptions, type StaticPluginOptions, Storage, type StorageInterface, type StorageOptions, type StorageProviderOptions, TypedQueue, VALIDATION_ERROR_SYMBOL, type ValidationOptions, arg, asyncLocalStorage, asyncStorage, baseCommands, bullmqQueue, commandRegistry, compression, controller, cookie, cors, createExpressAdapter, createPolicyDecorator, createQueue, cron, defineLoggerConfig, defineQueueConfiguration, del, expressHandler, expressMiddleware, fileParser, flag, get, getContentType, hash, helmet, json, log, logger, methodOverride, middleware, mountExpressRouter, mqtt, patch, pgbossQueue, post, put, rateLimiter, router, serialize, serveStatic, session, setCronGlobalErrorHandler, setMqttGlobalErrorHandler, sqsQueue, timeout, trustProxy, urlencoded, validate };
+export { ARG_SYMBOL, AzureBlobStorageProvider, BaseCron, BaseMqtt, BasePlugin, BaseQueue, type BaseStorageProviderOptions, type BlobStorageProviderOptions, BullMQConfiguration, type BullMQConfigurationOptions, BullMQPubSub, type BunTapOptions, Command, type CommandOptions, CommandRegistry, type CronSchedule, type CronScheduleParams, CronService, type CustomQueueConfiguration, type CustomStorageProviderOptions, CustomTypedQueue, type CustomValidationError, type DenoTapOptions, type ExpressAdapterOptions, type ExpressHandler, type ExpressRouter, type FileAllowedMimeType, GraphQL, type GraphQLContext, type GraphQLOptions, type GraphQLResolverFunction, type GraphQLResolverMap, type GraphQLResolverType, type GraphQLResolvers, type GraphQLSchemaInput, type GraphQLTypeDef, type HttpMethod, type HttpsOptions, LocalStorageProvider, type LocalStorageProviderOptions, type LoggerOptions, MockServer, type MockServerOptions, type MqttConnectionOptions, type MqttHandler, type MqttPublishOptions, MqttService, type MqttSubscribeOptions, type MqttSubscription, type MqttTopics, type NextFunction, type NodeHttpClient, type NodeServer, type NodeTapOptions, PGBossConfiguration, type PGBossConfigurationOptions, PGBossPubSub, type PolicyDecorator, PolicyManager, type PolicyMetadata, type PolicyProvider, QueueManager, QueueService, Request, type RequestSchema, type ResolvedServerOptions, Response$1 as Response, type ReturnType$1 as ReturnType, type ReturnTypeMap, type RuntimeServer, type RuntimeServerMap, S3StorageProvider, type S3StorageProviderOptions, SQSConfiguration, type SQSConfigurationOptions, SQSPubSub, type SerializeOptions, Server, type ServerConnectInput, type ServerErrorHandler, type ServerInterface, type ServerListenCallback, type ServerOptions, type ServerPlugin, type ServerRoute, type ServerRouteHandler, type ServerRouteMiddleware, type ServerTapOptions, type ServerTapOptionsBuilder, type SignalEvent, type StandardMethodOptions, type StaticPluginOptions, Storage, type StorageInterface, type StorageOptions, type StorageProviderOptions, TypedQueue, VALIDATION_ERROR_SYMBOL, type ValidatedData, type ValidationOptions, arg, asyncLocalStorage, asyncStorage, baseCommands, bullmqQueue, commandRegistry, compression, controller, cookie, cors, createExpressAdapter, createPolicyDecorator, createQueue, cron, defineLoggerConfig, defineQueueConfiguration, del, expressHandler, expressMiddleware, flag, get, getContentType, hash, helmet, log, logger, methodOverride, middleware, mountExpressRouter, mqtt, patch, pgbossQueue, post, put, rateLimiter, router, serialize, serveStatic, session, setCronGlobalErrorHandler, setMqttGlobalErrorHandler, sqsQueue, timeout, trustProxy, validate };