feat(openapi): Add OpenAPI module: decorators, spec generator, runtime validation and Swagger UI

ts/core/smartserve.interfaces.ts

@@ -5,6 +5,7 @@
 
 import type { TypedRouter } from '@api.global/typedrequest';
 import type { ICompressionConfig } from '../compression/index.js';
+import type { IOpenApiOptions } from '../openapi/openapi.types.js';
 
 // =============================================================================
 // HTTP Types
@@ -338,6 +339,8 @@ export interface ISmartServeOptions {
   onError?: (error: Error, request?: Request) => Response | Promise<Response>;
   /** Compression configuration (enabled by default) */
   compression?: ICompressionConfig | boolean;
+  /** OpenAPI documentation and validation configuration */
+  openapi?: IOpenApiOptions;
 }
 
 // =============================================================================