@digitaldefiance/node-express-suite 3.11.32 → 3.12.1

package/src/decorators/openapi-params.d.ts

@@ -0,0 +1,192 @@
+/**
+ * @fileoverview OpenAPI parameter decorators for Express Suite.
+ * Provides @ApiParam, @ApiQuery, @ApiHeader, and @ApiRequestBody decorators
+ * for documenting API parameters with full OpenAPI metadata.
+ * These decorators merge with auto-extracted parameters from @Param, @Query, @Header.
+ * @module decorators/openapi-params
+ */
+import 'reflect-metadata';
+import { z } from 'zod';
+import { ApiParamDecoratorOptions, ApiRequestBodyDecoratorOptions } from '../interfaces/openApi/decoratorOptions';
+import { OpenAPIParameter } from '../interfaces/openApi/parameter';
+import { OpenAPIParameterSchema } from '../interfaces/openApi/parameterSchema';
+import { OpenAPIRequestBody } from '../interfaces/openApi/requestBody';
+/**
+ * Internal interface for stored request body metadata.
+ */
+export interface RequestBodyMetadata {
+    schema: string | z.ZodSchema;
+    description?: string;
+    required?: boolean;
+    example?: unknown;
+    contentType?: string;
+}
+/**
+ * Extended OpenAPI parameter schema that supports $ref for schema references.
+ * This extends the base schema to allow referencing component schemas.
+ */
+export interface ExtendedOpenAPIParameterSchema extends OpenAPIParameterSchema {
+    $ref?: string;
+    example?: unknown;
+}
+/**
+ * Extended OpenAPI parameter that supports deprecated field.
+ */
+export interface ExtendedOpenAPIParameter extends Omit<OpenAPIParameter, 'schema'> {
+    schema: ExtendedOpenAPIParameterSchema;
+    deprecated?: boolean;
+}
+/**
+ * Decorator that documents a path parameter with full OpenAPI metadata.
+ * Merges with auto-extracted parameters from @Param decorator.
+ *
+ * @param name - Name of the path parameter
+ * @param options - OpenAPI parameter options
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @ApiParam('id', {
+ *     description: 'User ID',
+ *     schema: { type: 'string', format: 'uuid' },
+ *     example: '123e4567-e89b-12d3-a456-426614174000'
+ *   })
+ *   @Get('/:id')
+ *   getUser(@Param('id') id: string) {}
+ * }
+ * ```
+ */
+export declare function ApiParam(name: string, options?: ApiParamDecoratorOptions): MethodDecorator;
+/**
+ * Decorator that documents a query parameter with full OpenAPI metadata.
+ * Merges with auto-extracted parameters from @Query decorator.
+ *
+ * @param name - Name of the query parameter
+ * @param options - OpenAPI parameter options
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @ApiQuery('page', {
+ *     description: 'Page number',
+ *     schema: { type: 'integer', minimum: 1 },
+ *     required: false,
+ *     example: 1
+ *   })
+ *   @ApiQuery('limit', {
+ *     description: 'Items per page',
+ *     schema: { type: 'integer', minimum: 1, maximum: 100 },
+ *     required: false
+ *   })
+ *   @Get('/')
+ *   listUsers(@Query('page') page: number, @Query('limit') limit: number) {}
+ * }
+ * ```
+ */
+export declare function ApiQuery(name: string, options?: ApiParamDecoratorOptions): MethodDecorator;
+/**
+ * Decorator that documents a header parameter with full OpenAPI metadata.
+ * Merges with auto-extracted parameters from @Header decorator.
+ *
+ * @param name - Name of the header
+ * @param options - OpenAPI parameter options
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * class DataController {
+ *   @ApiHeader('X-Request-ID', {
+ *     description: 'Unique request identifier for tracing',
+ *     schema: { type: 'string', format: 'uuid' },
+ *     required: true
+ *   })
+ *   @ApiHeader('Accept-Language', {
+ *     description: 'Preferred language',
+ *     schema: { type: 'string' },
+ *     enum: ['en', 'es', 'fr'],
+ *     required: false
+ *   })
+ *   @Get('/')
+ *   getData(@Header('X-Request-ID') requestId: string) {}
+ * }
+ * ```
+ */
+export declare function ApiHeader(name: string, options?: ApiParamDecoratorOptions): MethodDecorator;
+/**
+ * Decorator that documents the request body with full OpenAPI metadata.
+ * Supports both schema references and Zod schemas.
+ *
+ * @param options - Request body options including schema, description, required, example
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * // With schema reference
+ * class UserController {
+ *   @ApiRequestBody({
+ *     schema: 'CreateUserDto',
+ *     description: 'User data to create',
+ *     required: true,
+ *     example: { name: 'John Doe', email: 'john@example.com' }
+ *   })
+ *   @Post('/')
+ *   createUser(@Body() data: CreateUserDto) {}
+ * }
+ *
+ * // With Zod schema
+ * const CreateUserSchema = z.object({
+ *   name: z.string(),
+ *   email: z.string().email()
+ * });
+ *
+ * class UserController {
+ *   @ApiRequestBody({
+ *     schema: CreateUserSchema,
+ *     description: 'User data to create',
+ *     required: true
+ *   })
+ *   @Post('/')
+ *   createUser(@Body() data: z.infer<typeof CreateUserSchema>) {}
+ * }
+ * ```
+ */
+export declare function ApiRequestBody(options: ApiRequestBodyDecoratorOptions): MethodDecorator;
+/**
+ * Gets all OpenAPI parameter definitions for a method.
+ * Returns parameters from both @ApiParam/@ApiQuery/@ApiHeader decorators
+ * and auto-extracted parameters from @Param/@Query/@Header decorators.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Array of OpenAPI parameter definitions
+ */
+export declare function getOpenAPIParams(target: object, propertyKey: string | symbol): ExtendedOpenAPIParameter[];
+/**
+ * Gets the request body metadata for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Request body metadata or undefined
+ */
+export declare function getRequestBodyMetadata(target: object, propertyKey: string | symbol): RequestBodyMetadata | undefined;
+/**
+ * Converts request body metadata to OpenAPI request body definition.
+ * Handles both schema references and Zod schemas.
+ *
+ * @param metadata - Request body metadata
+ * @returns OpenAPI request body definition
+ */
+export declare function requestBodyMetadataToOpenAPI(metadata: RequestBodyMetadata): OpenAPIRequestBody;
+/**
+ * Merges OpenAPI parameters from multiple sources.
+ * Parameters from explicit @ApiParam/@ApiQuery/@ApiHeader decorators
+ * take precedence over auto-extracted parameters.
+ *
+ * @param autoExtracted - Parameters auto-extracted from @Param/@Query/@Header
+ * @param explicit - Parameters from @ApiParam/@ApiQuery/@ApiHeader
+ * @returns Merged parameters array
+ */
+export declare function mergeOpenAPIParameters(autoExtracted: ExtendedOpenAPIParameter[], explicit: ExtendedOpenAPIParameter[]): ExtendedOpenAPIParameter[];
+//# sourceMappingURL=openapi-params.d.ts.map

package/src/decorators/openapi-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-params.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/openapi-params.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,gBAAgB,EAEjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAOvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CACpD,gBAAgB,EAChB,QAAQ,CACT;IACC,MAAM,EAAE,8BAA8B,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA2GD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,eAAe,CAqBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,eAAe,CAqBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,eAAe,CAqBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,8BAA8B,GACtC,eAAe,CAmBjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,wBAAwB,EAAE,CAO5B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,mBAAmB,GAAG,SAAS,CAOjC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,mBAAmB,GAC5B,kBAAkB,CAiCpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,wBAAwB,EAAE,EACzC,QAAQ,EAAE,wBAAwB,EAAE,GACnC,wBAAwB,EAAE,CAQ5B"}

package/src/decorators/openapi-params.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * @fileoverview OpenAPI parameter decorators for Express Suite.
+ * Provides @ApiParam, @ApiQuery, @ApiHeader, and @ApiRequestBody decorators
+ * for documenting API parameters with full OpenAPI metadata.
+ * These decorators merge with auto-extracted parameters from @Param, @Query, @Header.
+ * @module decorators/openapi-params
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiParam = ApiParam;
+exports.ApiQuery = ApiQuery;
+exports.ApiHeader = ApiHeader;
+exports.ApiRequestBody = ApiRequestBody;
+exports.getOpenAPIParams = getOpenAPIParams;
+exports.getRequestBodyMetadata = getRequestBodyMetadata;
+exports.requestBodyMetadataToOpenAPI = requestBodyMetadataToOpenAPI;
+exports.mergeOpenAPIParameters = mergeOpenAPIParameters;
+require("reflect-metadata");
+const zod_1 = require("zod");
+const metadata_keys_1 = require("./metadata-keys");
+const metadata_collector_1 = require("./metadata-collector");
+/**
+ * Converts ApiParamDecoratorOptions to ExtendedOpenAPIParameterSchema.
+ * Handles both string references and inline schemas.
+ * @param options - The decorator options
+ * @returns OpenAPI parameter schema
+ */
+function optionsToSchema(options) {
+    if (options.schema) {
+        if (typeof options.schema === 'string') {
+            // Schema reference - create a schema with $ref
+            return { type: 'string', $ref: `#/components/schemas/${options.schema}` };
+        }
+        // Inline schema - return as-is with extended type
+        return options.schema;
+    }
+    // Build schema from options
+    const schema = { type: 'string' };
+    if (options.enum) {
+        schema.enum = options.enum;
+    }
+    return schema;
+}
+/**
+ * Creates an OpenAPI parameter from decorator options.
+ * @param name - Parameter name
+ * @param location - Parameter location (path, query, header)
+ * @param options - Decorator options
+ * @returns OpenAPI parameter definition
+ */
+function createOpenAPIParameter(name, location, options) {
+    const schema = optionsToSchema(options);
+    // Add example to schema if provided
+    if (options.example !== undefined) {
+        schema.example = options.example;
+    }
+    const param = {
+        name,
+        in: location,
+        schema,
+    };
+    // Path parameters are always required
+    if (location === 'path') {
+        param.required = true;
+    }
+    else if (options.required !== undefined) {
+        param.required = options.required;
+    }
+    if (options.description) {
+        param.description = options.description;
+    }
+    if (options.deprecated) {
+        param.deprecated = options.deprecated;
+    }
+    return param;
+}
+/**
+ * Merges a new parameter with existing parameters.
+ * If a parameter with the same name and location exists, it's updated.
+ * Otherwise, the new parameter is added.
+ * @param existing - Existing parameters array
+ * @param newParam - New parameter to merge
+ * @returns Updated parameters array
+ */
+function mergeParameter(existing, newParam) {
+    const result = [...existing];
+    const existingIndex = result.findIndex((p) => p.name === newParam.name && p.in === newParam.in);
+    if (existingIndex >= 0) {
+        // Merge with existing parameter - new values override
+        result[existingIndex] = {
+            ...result[existingIndex],
+            ...newParam,
+            schema: {
+                ...result[existingIndex].schema,
+                ...newParam.schema,
+            },
+        };
+    }
+    else {
+        result.push(newParam);
+    }
+    return result;
+}
+/**
+ * Decorator that documents a path parameter with full OpenAPI metadata.
+ * Merges with auto-extracted parameters from @Param decorator.
+ *
+ * @param name - Name of the path parameter
+ * @param options - OpenAPI parameter options
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @ApiParam('id', {
+ *     description: 'User ID',
+ *     schema: { type: 'string', format: 'uuid' },
+ *     example: '123e4567-e89b-12d3-a456-426614174000'
+ *   })
+ *   @Get('/:id')
+ *   getUser(@Param('id') id: string) {}
+ * }
+ * ```
+ */
+function ApiParam(name, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        const existingParams = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.OPENAPI_PARAMS_METADATA, target.constructor, propertyKey, []);
+        const newParam = createOpenAPIParameter(name, 'path', options);
+        const mergedParams = mergeParameter(existingParams, newParam);
+        (0, metadata_collector_1.setMetadata)(metadata_keys_1.OPENAPI_PARAMS_METADATA, mergedParams, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Decorator that documents a query parameter with full OpenAPI metadata.
+ * Merges with auto-extracted parameters from @Query decorator.
+ *
+ * @param name - Name of the query parameter
+ * @param options - OpenAPI parameter options
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * class UserController {
+ *   @ApiQuery('page', {
+ *     description: 'Page number',
+ *     schema: { type: 'integer', minimum: 1 },
+ *     required: false,
+ *     example: 1
+ *   })
+ *   @ApiQuery('limit', {
+ *     description: 'Items per page',
+ *     schema: { type: 'integer', minimum: 1, maximum: 100 },
+ *     required: false
+ *   })
+ *   @Get('/')
+ *   listUsers(@Query('page') page: number, @Query('limit') limit: number) {}
+ * }
+ * ```
+ */
+function ApiQuery(name, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        const existingParams = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.OPENAPI_PARAMS_METADATA, target.constructor, propertyKey, []);
+        const newParam = createOpenAPIParameter(name, 'query', options);
+        const mergedParams = mergeParameter(existingParams, newParam);
+        (0, metadata_collector_1.setMetadata)(metadata_keys_1.OPENAPI_PARAMS_METADATA, mergedParams, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Decorator that documents a header parameter with full OpenAPI metadata.
+ * Merges with auto-extracted parameters from @Header decorator.
+ *
+ * @param name - Name of the header
+ * @param options - OpenAPI parameter options
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * class DataController {
+ *   @ApiHeader('X-Request-ID', {
+ *     description: 'Unique request identifier for tracing',
+ *     schema: { type: 'string', format: 'uuid' },
+ *     required: true
+ *   })
+ *   @ApiHeader('Accept-Language', {
+ *     description: 'Preferred language',
+ *     schema: { type: 'string' },
+ *     enum: ['en', 'es', 'fr'],
+ *     required: false
+ *   })
+ *   @Get('/')
+ *   getData(@Header('X-Request-ID') requestId: string) {}
+ * }
+ * ```
+ */
+function ApiHeader(name, options = {}) {
+    return (target, propertyKey, descriptor) => {
+        const existingParams = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.OPENAPI_PARAMS_METADATA, target.constructor, propertyKey, []);
+        const newParam = createOpenAPIParameter(name, 'header', options);
+        const mergedParams = mergeParameter(existingParams, newParam);
+        (0, metadata_collector_1.setMetadata)(metadata_keys_1.OPENAPI_PARAMS_METADATA, mergedParams, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Decorator that documents the request body with full OpenAPI metadata.
+ * Supports both schema references and Zod schemas.
+ *
+ * @param options - Request body options including schema, description, required, example
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * // With schema reference
+ * class UserController {
+ *   @ApiRequestBody({
+ *     schema: 'CreateUserDto',
+ *     description: 'User data to create',
+ *     required: true,
+ *     example: { name: 'John Doe', email: 'john@example.com' }
+ *   })
+ *   @Post('/')
+ *   createUser(@Body() data: CreateUserDto) {}
+ * }
+ *
+ * // With Zod schema
+ * const CreateUserSchema = z.object({
+ *   name: z.string(),
+ *   email: z.string().email()
+ * });
+ *
+ * class UserController {
+ *   @ApiRequestBody({
+ *     schema: CreateUserSchema,
+ *     description: 'User data to create',
+ *     required: true
+ *   })
+ *   @Post('/')
+ *   createUser(@Body() data: z.infer<typeof CreateUserSchema>) {}
+ * }
+ * ```
+ */
+function ApiRequestBody(options) {
+    return (target, propertyKey, descriptor) => {
+        const metadata = {
+            schema: options.schema,
+            description: options.description,
+            required: options.required ?? true,
+            example: options.example,
+            contentType: options.contentType ?? 'application/json',
+        };
+        (0, metadata_collector_1.setMetadata)(metadata_keys_1.OPENAPI_REQUEST_BODY_METADATA, metadata, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Gets all OpenAPI parameter definitions for a method.
+ * Returns parameters from both @ApiParam/@ApiQuery/@ApiHeader decorators
+ * and auto-extracted parameters from @Param/@Query/@Header decorators.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Array of OpenAPI parameter definitions
+ */
+function getOpenAPIParams(target, propertyKey) {
+    return (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.OPENAPI_PARAMS_METADATA, target, propertyKey, []);
+}
+/**
+ * Gets the request body metadata for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Request body metadata or undefined
+ */
+function getRequestBodyMetadata(target, propertyKey) {
+    return (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.OPENAPI_REQUEST_BODY_METADATA, target, propertyKey, undefined);
+}
+/**
+ * Converts request body metadata to OpenAPI request body definition.
+ * Handles both schema references and Zod schemas.
+ *
+ * @param metadata - Request body metadata
+ * @returns OpenAPI request body definition
+ */
+function requestBodyMetadataToOpenAPI(metadata) {
+    let schemaName;
+    if (typeof metadata.schema === 'string') {
+        // Schema reference - use directly
+        schemaName = metadata.schema;
+    }
+    else if (metadata.schema instanceof zod_1.z.ZodType) {
+        // Zod schema - we need to generate a schema name
+        // The actual schema conversion should be handled by the OpenAPI builder
+        // For now, we use a placeholder that indicates it's a Zod schema
+        schemaName = 'ZodSchema';
+    }
+    else {
+        // Fallback
+        schemaName = 'Object';
+    }
+    const requestBody = {
+        schema: schemaName,
+    };
+    if (metadata.description) {
+        requestBody.description = metadata.description;
+    }
+    if (metadata.required !== undefined) {
+        requestBody.required = metadata.required;
+    }
+    if (metadata.example !== undefined) {
+        requestBody.example = metadata.example;
+    }
+    return requestBody;
+}
+/**
+ * Merges OpenAPI parameters from multiple sources.
+ * Parameters from explicit @ApiParam/@ApiQuery/@ApiHeader decorators
+ * take precedence over auto-extracted parameters.
+ *
+ * @param autoExtracted - Parameters auto-extracted from @Param/@Query/@Header
+ * @param explicit - Parameters from @ApiParam/@ApiQuery/@ApiHeader
+ * @returns Merged parameters array
+ */
+function mergeOpenAPIParameters(autoExtracted, explicit) {
+    let result = [...autoExtracted];
+    for (const param of explicit) {
+        result = mergeParameter(result, param);
+    }
+    return result;
+}
+//# sourceMappingURL=openapi-params.js.map

package/src/decorators/openapi-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-params.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/openapi-params.ts"],"names":[],"mappings":"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"}