@digitaldefiance/node-express-suite 3.11.32 → 3.12.0

package/src/decorators/controller.d.ts

@@ -9,8 +9,9 @@ import { ValidationChain } from 'express-validator';
 import 'reflect-metadata';
 import { z } from 'zod';
 import { IConstants } from '../interfaces';
-export declare const CONTROLLER_METADATA: unique symbol;
-export declare const ROUTES_METADATA: unique symbol;
+import { ApiControllerOptions } from '../interfaces/openApi/decoratorOptions';
+export { CONTROLLER_METADATA, OPENAPI_CONTROLLER_METADATA, ROUTES_METADATA, } from './metadata-keys';
+export type { ApiControllerOptions } from '../interfaces/openApi/decoratorOptions';
 export type ValidationContext<TConstants extends IConstants = IConstants> = {
     constants: TConstants;
 };
@@ -30,14 +31,69 @@ export interface RouteMetadata<TLanguage extends CoreLanguageCode = CoreLanguage
     handlerName: string;
     options: RouteOptions<TLanguage>;
 }
+/**
+ * Controller metadata structure stored by @Controller and @ApiController decorators.
+ */
+export interface ControllerMetadata {
+    /** Base path for all routes in this controller */
+    basePath: string;
+    /** Optional controller name (defaults to class name) */
+    name?: string;
+}
+/**
+ * OpenAPI controller metadata structure stored by @ApiController decorator.
+ */
+export interface OpenApiControllerMetadata {
+    /** Tags to apply to all routes in this controller */
+    tags?: string[];
+    /** Description of the controller for OpenAPI documentation */
+    description?: string;
+    /** Whether all routes in this controller are deprecated */
+    deprecated?: boolean;
+}
+/**
+ * Basic controller decorator for defining route base path.
+ * Use @ApiController for OpenAPI-enabled controllers.
+ *
+ * @param basePath - Base path for all routes in this controller
+ * @returns Class decorator function
+ *
+ * @example
+ * ```typescript
+ * @Controller('/api/users')
+ * class UserController {
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ * ```
+ */
 export declare function Controller(basePath?: string): <T extends {
     new (...args: any[]): {};
 }>(constructor: T) => T;
-export declare function Get<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteOptions<TLanguage>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-export declare function Post<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteOptions<TLanguage>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-export declare function Put<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteOptions<TLanguage>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-export declare function Delete<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteOptions<TLanguage>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-export declare function Patch<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteOptions<TLanguage>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Enhanced controller decorator with OpenAPI support.
+ * Registers the controller with both base path and OpenAPI metadata.
+ *
+ * @param basePath - Base path for all routes in this controller
+ * @param options - Optional OpenAPI configuration (tags, description, deprecated, name)
+ * @returns Class decorator function
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users', {
+ *   tags: ['Users'],
+ *   description: 'User management endpoints',
+ * })
+ * class UserController {
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ * ```
+ */
+export declare function ApiController(basePath?: string, options?: ApiControllerOptions): <T extends {
+    new (...args: any[]): {};
+}>(constructor: T) => T;
+export { Delete, Get, Patch, Post, Put } from './http-methods';
 export declare function Auth(_cryptoAuth?: boolean): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare function Validate<TLanguage extends CoreLanguageCode = CoreLanguageCode>(_validation: ValidationChain[] | ((lang: TLanguage) => ValidationChain[])): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 //# sourceMappingURL=controller.d.ts.map

package/src/decorators/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/controller.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,eAAO,MAAM,mBAAmB,eAAuB,CAAC;AACxD,eAAO,MAAM,eAAe,eAAmB,CAAC;AAIhD,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,IAAI;IAC1E,SAAS,EAAE,UAAU,CAAC;CACvB,CAAC;AAGF,MAAM,WAAW,YAAY,CAC3B,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACrD,UAAU,SAAS,UAAU,GAAG,UAAU;IAE1C,UAAU,CAAC,EACP,eAAe,EAAE,GACjB,CAAC,CACC,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACnC,IAAI,EAAE,SAAS,KACZ,eAAe,EAAE,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,aAAa,CAC5B,SAAS,SAAS,gBAAgB,GAAG,gBAAgB;IAErD,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;CAClC;AAGD,wBAAgB,UAAU,CAAC,QAAQ,GAAE,MAAW,IAE7B,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,aAAa,CAAC,OAIxE;AAGD,wBAAgB,GAAG,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACvE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,CAAC,SAAS,CAAM,YA0C3B,GAAG,eACE,MAAM,cACP,kBAAkB,wBAzCjC;AAED,wBAAgB,IAAI,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACxE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,CAAC,SAAS,CAAM,YAmC3B,GAAG,eACE,MAAM,cACP,kBAAkB,wBAlCjC;AAED,wBAAgB,GAAG,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACvE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,CAAC,SAAS,CAAM,YA4B3B,GAAG,eACE,MAAM,cACP,kBAAkB,wBA3BjC;AAED,wBAAgB,MAAM,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EAC1E,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,CAAC,SAAS,CAAM,YAqB3B,GAAG,eACE,MAAM,cACP,kBAAkB,wBApBjC;AAED,wBAAgB,KAAK,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACzE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,CAAC,SAAS,CAAM,YAc3B,GAAG,eACE,MAAM,cACP,kBAAkB,wBAbjC;AAiCD,wBAAgB,IAAI,CAAC,WAAW,GAAE,OAAe,IAE7C,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBAKjC;AAED,wBAAgB,QAAQ,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EAC5E,WAAW,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,eAAe,EAAE,CAAC,IAGvE,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBAKjC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/controller.ts"],"names":[],"mappings":"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"}

package/src/decorators/controller.js

@@ -5,58 +5,89 @@
  * @module decorators/controller
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROUTES_METADATA = exports.CONTROLLER_METADATA = void 0;
+exports.Put = exports.Post = exports.Patch = exports.Get = exports.Delete = exports.ROUTES_METADATA = exports.OPENAPI_CONTROLLER_METADATA = exports.CONTROLLER_METADATA = void 0;
 exports.Controller = Controller;
-exports.Get = Get;
-exports.Post = Post;
-exports.Put = Put;
-exports.Delete = Delete;
-exports.Patch = Patch;
+exports.ApiController = ApiController;
 exports.Auth = Auth;
 exports.Validate = Validate;
 require("reflect-metadata");
-// Metadata keys for storing decorator information
-exports.CONTROLLER_METADATA = Symbol('controller');
-exports.ROUTES_METADATA = Symbol('routes');
-// Controller decorator
+const metadata_keys_1 = require("./metadata-keys");
+// Re-export metadata keys for backward compatibility
+var metadata_keys_2 = require("./metadata-keys");
+Object.defineProperty(exports, "CONTROLLER_METADATA", { enumerable: true, get: function () { return metadata_keys_2.CONTROLLER_METADATA; } });
+Object.defineProperty(exports, "OPENAPI_CONTROLLER_METADATA", { enumerable: true, get: function () { return metadata_keys_2.OPENAPI_CONTROLLER_METADATA; } });
+Object.defineProperty(exports, "ROUTES_METADATA", { enumerable: true, get: function () { return metadata_keys_2.ROUTES_METADATA; } });
+/**
+ * Basic controller decorator for defining route base path.
+ * Use @ApiController for OpenAPI-enabled controllers.
+ *
+ * @param basePath - Base path for all routes in this controller
+ * @returns Class decorator function
+ *
+ * @example
+ * ```typescript
+ * @Controller('/api/users')
+ * class UserController {
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ * ```
+ */
 function Controller(basePath = '') {
     // eslint-disable-next-line @typescript-eslint/no-empty-object-type
     return function (constructor) {
-        Reflect.defineMetadata(exports.CONTROLLER_METADATA, { basePath }, constructor);
+        const metadata = { basePath };
+        Reflect.defineMetadata(metadata_keys_1.CONTROLLER_METADATA, metadata, constructor);
         return constructor;
     };
 }
-// HTTP method decorators
-function Get(path, options = {}) {
-    return createRouteDecorator('get', path, options);
-}
-function Post(path, options = {}) {
-    return createRouteDecorator('post', path, options);
-}
-function Put(path, options = {}) {
-    return createRouteDecorator('put', path, options);
-}
-function Delete(path, options = {}) {
-    return createRouteDecorator('delete', path, options);
-}
-function Patch(path, options = {}) {
-    return createRouteDecorator('patch', path, options);
-}
-// Helper to create route decorators
-function createRouteDecorator(method, path, options) {
-    return function (target, propertyKey, descriptor) {
-        const existingRoutes = Reflect.getMetadata(exports.ROUTES_METADATA, target.constructor) || [];
-        const route = {
-            method,
-            path,
-            handlerName: propertyKey,
-            options: options,
+/**
+ * Enhanced controller decorator with OpenAPI support.
+ * Registers the controller with both base path and OpenAPI metadata.
+ *
+ * @param basePath - Base path for all routes in this controller
+ * @param options - Optional OpenAPI configuration (tags, description, deprecated, name)
+ * @returns Class decorator function
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users', {
+ *   tags: ['Users'],
+ *   description: 'User management endpoints',
+ * })
+ * class UserController {
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ * ```
+ */
+function ApiController(basePath = '', options = {}) {
+    // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+    return function (constructor) {
+        // Store base controller metadata (basePath and optional name)
+        const controllerMetadata = {
+            basePath,
+            name: options.name ?? constructor.name,
         };
-        existingRoutes.push(route);
-        Reflect.defineMetadata(exports.ROUTES_METADATA, existingRoutes, target.constructor);
-        return descriptor;
+        Reflect.defineMetadata(metadata_keys_1.CONTROLLER_METADATA, controllerMetadata, constructor);
+        // Store OpenAPI-specific controller metadata
+        const openApiMetadata = {
+            tags: options.tags,
+            description: options.description,
+            deprecated: options.deprecated,
+        };
+        Reflect.defineMetadata(metadata_keys_1.OPENAPI_CONTROLLER_METADATA, openApiMetadata, constructor);
+        return constructor;
     };
 }
+// Re-export enhanced HTTP method decorators from http-methods.ts
+// These provide OpenAPI metadata support while maintaining backward compatibility
+var http_methods_1 = require("./http-methods");
+Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return http_methods_1.Delete; } });
+Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return http_methods_1.Get; } });
+Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return http_methods_1.Patch; } });
+Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return http_methods_1.Post; } });
+Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return http_methods_1.Put; } });
 // Convenience decorators
 function Auth(_cryptoAuth = false) {
     return function (target, propertyKey, descriptor) {

package/src/decorators/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/controller.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAkDH,gCAMC;AAGD,kBAKC;AAED,oBAKC;AAED,kBAKC;AAED,wBAKC;AAED,sBAKC;AAiCD,oBASC;AAED,4BAWC;AA9ID,4BAA0B;AAI1B,kDAAkD;AACrC,QAAA,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAC3C,QAAA,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAsChD,uBAAuB;AACvB,SAAgB,UAAU,CAAC,WAAmB,EAAE;IAC9C,mEAAmE;IACnE,OAAO,UAAkD,WAAc;QACrE,OAAO,CAAC,cAAc,CAAC,2BAAmB,EAAE,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC;QACvE,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED,yBAAyB;AACzB,SAAgB,GAAG,CACjB,IAAY,EACZ,UAAmC,EAAE;IAErC,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,IAAI,CAClB,IAAY,EACZ,UAAmC,EAAE;IAErC,OAAO,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,GAAG,CACjB,IAAY,EACZ,UAAmC,EAAE;IAErC,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,MAAM,CACpB,IAAY,EACZ,UAAmC,EAAE;IAErC,OAAO,oBAAoB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,KAAK,CACnB,IAAY,EACZ,UAAmC,EAAE;IAErC,OAAO,oBAAoB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,oCAAoC;AACpC,SAAS,oBAAoB,CAG3B,MAAmD,EACnD,IAAY,EACZ,OAAgC;IAEhC,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,uBAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEjE,MAAM,KAAK,GAAoC;YAC7C,MAAM;YACN,IAAI;YACJ,WAAW,EAAE,WAAW;YACxB,OAAO,EAAE,OAAyC;SACnD,CAAC;QAEF,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,cAAc,CAAC,uBAAe,EAAE,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE5E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,yBAAyB;AACzB,SAAgB,IAAI,CAAC,cAAuB,KAAK;IAC/C,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,+CAA+C;QAC/C,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,QAAQ,CACtB,WAAyE;IAEzE,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,+CAA+C;QAC/C,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/controller.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAkGH,gCAOC;AAsBD,sCA+BC;AAOD,oBASC;AAED,4BAWC;AAtLD,4BAA0B;AAI1B,mDAGyB;AAEzB,qDAAqD;AACrD,iDAIyB;AAHvB,oHAAA,mBAAmB,OAAA;AACnB,4HAAA,2BAA2B,OAAA;AAC3B,gHAAA,eAAe,OAAA;AAgEjB;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,UAAU,CAAC,WAAmB,EAAE;IAC9C,mEAAmE;IACnE,OAAO,UAAkD,WAAc;QACrE,MAAM,QAAQ,GAAuB,EAAE,QAAQ,EAAE,CAAC;QAClD,OAAO,CAAC,cAAc,CAAC,mCAAmB,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACnE,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,aAAa,CAC3B,WAAmB,EAAE,EACrB,UAAgC,EAAE;IAElC,mEAAmE;IACnE,OAAO,UAAkD,WAAc;QACrE,8DAA8D;QAC9D,MAAM,kBAAkB,GAAuB;YAC7C,QAAQ;YACR,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI;SACvC,CAAC;QACF,OAAO,CAAC,cAAc,CACpB,mCAAmB,EACnB,kBAAkB,EAClB,WAAW,CACZ,CAAC;QAEF,6CAA6C;QAC7C,MAAM,eAAe,GAA8B;YACjD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;QACF,OAAO,CAAC,cAAc,CACpB,2CAA2B,EAC3B,eAAe,EACf,WAAW,CACZ,CAAC;QAEF,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,kFAAkF;AAClF,+CAA+D;AAAtD,sGAAA,MAAM,OAAA;AAAE,mGAAA,GAAG,OAAA;AAAE,qGAAA,KAAK,OAAA;AAAE,oGAAA,IAAI,OAAA;AAAE,mGAAA,GAAG,OAAA;AAEtC,yBAAyB;AACzB,SAAgB,IAAI,CAAC,cAAuB,KAAK;IAC/C,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,+CAA+C;QAC/C,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,QAAQ,CACtB,WAAyE;IAEzE,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,+CAA+C;QAC/C,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/src/decorators/handler-args.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Handler arguments decorator for Express Suite.
+ * Provides @HandlerArgs decorator for passing additional arguments to handler methods.
+ * @module decorators/handler-args
+ */
+import 'reflect-metadata';
+/**
+ * Metadata stored for handler arguments.
+ */
+export interface HandlerArgsMetadata {
+    /**
+     * Additional arguments to pass to the handler method.
+     */
+    args: unknown[];
+}
+/**
+ * Decorator that specifies additional arguments to pass to a route handler method.
+ * These arguments are passed to the handler after the standard request parameter.
+ *
+ * @param args - Additional arguments to pass to the handler
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/items')
+ * class ItemController {
+ *   // Pass a configuration object to the handler
+ *   @HandlerArgs({ maxItems: 100 })
+ *   @Get('/')
+ *   listItems(req: Request, config: { maxItems: number }) {
+ *     // config.maxItems === 100
+ *   }
+ *
+ *   // Pass multiple arguments
+ *   @HandlerArgs('prefix', 42, { option: true })
+ *   @Post('/')
+ *   createItem(req: Request, prefix: string, count: number, options: { option: boolean }) {
+ *     // prefix === 'prefix', count === 42, options.option === true
+ *   }
+ * }
+ * ```
+ */
+export declare function HandlerArgs(...args: unknown[]): MethodDecorator;
+/**
+ * Gets handler args metadata for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Handler args metadata or undefined if not set
+ */
+export declare function getHandlerArgsMetadata(target: object, propertyKey: string | symbol): HandlerArgsMetadata | undefined;
+/**
+ * Gets the handler arguments array for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Array of handler arguments or empty array if not set
+ */
+export declare function getHandlerArgs(target: object, propertyKey: string | symbol): unknown[];
+/**
+ * Checks if a method has handler args defined.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns True if the method has handler args
+ */
+export declare function hasHandlerArgs(target: object, propertyKey: string | symbol): boolean;
+//# sourceMappingURL=handler-args.d.ts.map

package/src/decorators/handler-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-args.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/handler-args.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kBAAkB,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAmB/D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,mBAAmB,GAAG,SAAS,CAMjC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,EAAE,CAGX;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAGT"}

package/src/decorators/handler-args.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * @fileoverview Handler arguments decorator for Express Suite.
+ * Provides @HandlerArgs decorator for passing additional arguments to handler methods.
+ * @module decorators/handler-args
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerArgs = HandlerArgs;
+exports.getHandlerArgsMetadata = getHandlerArgsMetadata;
+exports.getHandlerArgs = getHandlerArgs;
+exports.hasHandlerArgs = hasHandlerArgs;
+require("reflect-metadata");
+const metadata_keys_1 = require("./metadata-keys");
+const metadata_collector_1 = require("./metadata-collector");
+/**
+ * Decorator that specifies additional arguments to pass to a route handler method.
+ * These arguments are passed to the handler after the standard request parameter.
+ *
+ * @param args - Additional arguments to pass to the handler
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/items')
+ * class ItemController {
+ *   // Pass a configuration object to the handler
+ *   @HandlerArgs({ maxItems: 100 })
+ *   @Get('/')
+ *   listItems(req: Request, config: { maxItems: number }) {
+ *     // config.maxItems === 100
+ *   }
+ *
+ *   // Pass multiple arguments
+ *   @HandlerArgs('prefix', 42, { option: true })
+ *   @Post('/')
+ *   createItem(req: Request, prefix: string, count: number, options: { option: boolean }) {
+ *     // prefix === 'prefix', count === 42, options.option === true
+ *   }
+ * }
+ * ```
+ */
+function HandlerArgs(...args) {
+    return function (target, propertyKey, descriptor) {
+        const metadata = {
+            args,
+        };
+        (0, metadata_collector_1.setMetadata)(metadata_keys_1.HANDLER_ARGS_METADATA, metadata, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Gets handler args metadata for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Handler args metadata or undefined if not set
+ */
+function getHandlerArgsMetadata(target, propertyKey) {
+    return (0, metadata_collector_1.getMetadata)(metadata_keys_1.HANDLER_ARGS_METADATA, target, propertyKey);
+}
+/**
+ * Gets the handler arguments array for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Array of handler arguments or empty array if not set
+ */
+function getHandlerArgs(target, propertyKey) {
+    const metadata = getHandlerArgsMetadata(target, propertyKey);
+    return metadata?.args ?? [];
+}
+/**
+ * Checks if a method has handler args defined.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns True if the method has handler args
+ */
+function hasHandlerArgs(target, propertyKey) {
+    const metadata = getHandlerArgsMetadata(target, propertyKey);
+    return metadata !== undefined && metadata.args.length > 0;
+}
+//# sourceMappingURL=handler-args.js.map

package/src/decorators/handler-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-args.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/handler-args.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA2CH,kCAmBC;AASD,wDASC;AASD,wCAMC;AASD,wCAMC;AA5GD,4BAA0B;AAC1B,mDAAwD;AACxD,6DAAgE;AAYhE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,WAAW,CAAC,GAAG,IAAe;IAC5C,OAAO,UACL,MAAc,EACd,WAA4B,EAC5B,UAA8B;QAE9B,MAAM,QAAQ,GAAwB;YACpC,IAAI;SACL,CAAC;QAEF,IAAA,gCAAW,EACT,qCAAqB,EACrB,QAAQ,EACR,MAAM,CAAC,WAAW,EAClB,WAAW,CACZ,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,MAAc,EACd,WAA4B;IAE5B,OAAO,IAAA,gCAAW,EAChB,qCAAqB,EACrB,MAAM,EACN,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,MAAc,EACd,WAA4B;IAE5B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7D,OAAO,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,MAAc,EACd,WAA4B;IAE5B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7D,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/src/decorators/http-methods.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Enhanced HTTP method decorators with OpenAPI support.
+ * Provides @Get, @Post, @Put, @Delete, @Patch decorators with inline OpenAPI metadata.
+ * @module decorators/http-methods
+ */
+import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
+import 'reflect-metadata';
+import { RouteDecoratorOptions } from '../interfaces/openApi/decoratorOptions';
+/**
+ * Route metadata structure stored by HTTP method decorators.
+ */
+export interface EnhancedRouteMetadata<TLanguage extends CoreLanguageCode = CoreLanguageCode> {
+    /** HTTP method */
+    method: 'get' | 'post' | 'put' | 'delete' | 'patch';
+    /** Route path */
+    path: string;
+    /** Handler method name */
+    handlerName: string;
+    /** Route options including validation, middleware, auth, etc. */
+    options: RouteDecoratorOptions<TLanguage>;
+}
+/**
+ * GET method decorator with OpenAPI support.
+ * Registers a GET route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Get('/:id', {
+ *     summary: 'Get user by ID',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async getUser(@Param('id') id: string) {
+ *     return this.userService.findById(id);
+ *   }
+ * }
+ * ```
+ */
+export declare function Get<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteDecoratorOptions<TLanguage>): MethodDecorator;
+/**
+ * POST method decorator with OpenAPI support.
+ * Registers a POST route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Post('/', {
+ *     summary: 'Create a new user',
+ *     tags: ['Users'],
+ *     schema: createUserSchema,
+ *   })
+ *   async createUser(@Body() data: CreateUserDto) {
+ *     return this.userService.create(data);
+ *   }
+ * }
+ * ```
+ */
+export declare function Post<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteDecoratorOptions<TLanguage>): MethodDecorator;
+/**
+ * PUT method decorator with OpenAPI support.
+ * Registers a PUT route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Put('/:id', {
+ *     summary: 'Update user',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async updateUser(@Param('id') id: string, @Body() data: UpdateUserDto) {
+ *     return this.userService.update(id, data);
+ *   }
+ * }
+ * ```
+ */
+export declare function Put<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteDecoratorOptions<TLanguage>): MethodDecorator;
+/**
+ * DELETE method decorator with OpenAPI support.
+ * Registers a DELETE route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Delete('/:id', {
+ *     summary: 'Delete user',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async deleteUser(@Param('id') id: string) {
+ *     return this.userService.delete(id);
+ *   }
+ * }
+ * ```
+ */
+export declare function Delete<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteDecoratorOptions<TLanguage>): MethodDecorator;
+/**
+ * PATCH method decorator with OpenAPI support.
+ * Registers a PATCH route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Patch('/:id', {
+ *     summary: 'Partially update user',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async patchUser(@Param('id') id: string, @Body() data: PatchUserDto) {
+ *     return this.userService.patch(id, data);
+ *   }
+ * }
+ * ```
+ */
+export declare function Patch<TLanguage extends CoreLanguageCode = CoreLanguageCode>(path: string, options?: RouteDecoratorOptions<TLanguage>): MethodDecorator;
+export type { RouteDecoratorOptions } from '../interfaces/openApi/decoratorOptions';
+//# sourceMappingURL=http-methods.d.ts.map

package/src/decorators/http-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-methods.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/http-methods.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAK/E;;GAEG;AACH,MAAM,WAAW,qBAAqB,CACpC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB;IAErD,kBAAkB;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CAC3C;AA8JD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,GAAG,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACvE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC7C,eAAe,CAEjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,IAAI,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACxE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC7C,eAAe,CAEjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,GAAG,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACvE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC7C,eAAe,CAEjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EAC1E,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC7C,eAAe,CAEjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB,EACzE,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC7C,eAAe,CAEjB;AAGD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC"}