@nest-openapi/validator 0.1.0 → 0.1.1

package/README.md

@@ -4,323 +4,108 @@
 
 <h1 align="center">@nest-openapi</h1>
 
-<p align="center"><strong>OpenAPI-first validation for NestJS</strong></p>
+<p align="center"><strong>OpenAPI‑first utilities for NestJS</strong></p>
 
 <p align="center">
-  Single source of truth · Drop-in for existing controllers · Fast by design
+  Single source of truth · Drop‑in for NestJS · Fast by design
 </p>
 
-[![NPM version](https://img.shields.io/npm/v/%40nest-openapi%2Fvalidator.svg)](https://www.npmjs.com/package/%40nest-openapi%2Fvalidator)
 ![GitHub License](https://img.shields.io/github/license/ts-oas/nest-openapi)
-![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/%40nest-openapi%2Fvalidator)
 
 ## Overview
 
-`@nest-openapi` is a light-weight, focused toolkit for OpenAPI-driven NestJS apps.
-Today it ships the **request/response validator** that derives schemas from your OpenAPI spec—so you don’t duplicate DTOs or hand-roll validation rules.
+`@nest-openapi` is a modern, modular set of utilities for building OpenAPI‑driven NestJS apps.
 
-- **Single Source of Truth** — The OpenAPI spec is the contract; validation is generated from it.
-- **Drop-in for NestJS** — Add a module; existing controllers keep working.
-- **Fast by Design** — AJV under the hood, with caching and optional pre-compilation.
-- **Express & Fastify** — Platform-agnostic validation.
-- **Fine-Grained Control** — Per-route opt-out and overrides.
+- **Single Source of Truth** — The OpenAPI spec is the contract; validation and serialization derive from it.
+- **Drop‑in for NestJS** — Works with existing controllers and routes.
+- **Fast by Design** — AJV validation and fast-json-stringify serialization with caching and precompilation.
+- **Express & Fastify** — Platform‑agnostic support.
+- **Fine‑Grained Control** — Per‑route opt‑out and overrides.
 
-## Package
+### Packages
 
-- **`@nest-openapi/validator`** — Automatic request/response validation using your OpenAPI 3.x spec.
+- [**`@nest-openapi/validator`**](https://nest-openapi.github.io/validator/) — Automatic request/response validation using your OpenAPI specification.
 
-## Install
-
-```bash
-npm i @nest-openapi/validator
-```
+- [**`@nest-openapi/serializer`**](https://nest-openapi.github.io/serializer/) — High‑performance response serialization based on your OpenAPI 3.x specification.
 
 ---
 
-## Quick Start
+## Get Started
 
-### Basic Usage
+### @nest-openapi/validator
 
-```typescript
-// app.module.ts
-import { OpenApiValidatorModule } from "@nest-openapi/validator";
-import * as openApiSpec from "./openapi.json";
+[![NPM – validator](https://img.shields.io/npm/v/%40nest-openapi%2Fvalidator.svg)](https://www.npmjs.com/package/%40nest-openapi%2Fvalidator)
+![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/%40nest-openapi%2Fvalidator.svg)
 
-@Module({
-  imports: [
-    OpenApiValidatorModule.forRoot({
-      specSource: { type: "object", spec: openApiSpec },
-    }),
-  ],
-})
-export class AppModule {}
+Install:
 
-// That's it! All routes automatically validated
+```bash
+npm i @nest-openapi/validator
 ```
 
-### Advanced / Async Configuration
+Minimal setup:
 
 ```typescript
 // app.module.ts
+import { Module } from "@nestjs/common";
+import { OpenAPIValidatorModule } from "@nest-openapi/validator";
+import * as openApiSpec from "./openapi.json";
+
 @Module({
   imports: [
-    OpenApiValidatorModule.forRootAsync({
-      imports: [ConfigModule],
-      useFactory: (config: ConfigService) => ({
-        specSource: { type: "object", spec: config.getOpenApiSpec() },
-        options: {
-          ajv: {
-            options: { strict: false },
-            configure: (ajv) => {
-              addFormats(ajv); // import addFormats from 'ajv-formats';
-            },
-          },
-          requestValidation: {
-            enable: false,
-          },
-          responseValidation: {
-            enable: true,
-            onValidationFailed: (context, errors) => {
-              console.log(errors);
-            },
-          },
-        },
-      }),
-      inject: [ConfigService],
+    OpenAPIValidatorModule.forRoot({
+      specSource: { type: "object", spec: openApiSpec },
     }),
   ],
 })
 export class AppModule {}
 ```
 
-## Configuration Options
-
-| Option                                      | Type                                                                                                       | Default                          | Description                                                                                                                            |
-| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| [`specSource`](#specsource)                 | `{ type: "object"; spec: OpenAPISpec } \| { type: "url"; spec: string } \| { type: "file"; spec: string }` | —                                | Provide your OpenAPI 3.x spec as an object, or point to it via URL or file path.                                                       |
-| [`requestValidation`](#requestvalidation)   | `RequestValidationOptions`                                                                                 | see [below](#requestvalidation)  | Controls validation of incoming requests.                                                                                              |
-| [`responseValidation`](#responsevalidation) | `ResponseValidationOptions`                                                                                | see [below](#responsevalidation) | Controls validation of outgoing responses.                                                                                             |
-| [`ajv`](#ajv)                               | `Ajv \| { options?: AjvOptions; configure?: (ajv: Ajv) => void }`                                          | see [below](#ajv)                | Override the default ajv instance or configure it                                                                                      |
-| `precompileSchemas`                         | `boolean`                                                                                                  | `false`                          | Precompile all route schemas during application bootstrap. This removes the first-request latency at the cost of longer start-up time. |
-| `debug`                                     | `boolean`                                                                                                  | `false`                          | Verbose logs for troubleshooting.                                                                                                      |
-
-### `specSource`
-
-| Type       | Type          | Typical use                                      |
-| ---------- | ------------- | ------------------------------------------------ |
-| `"object"` | `OpenAPISpec` | Static spec object.                              |
-| `"url"`    | `string`      | Link to a centralized or externally hosted spec. |
-| `"file"`   | `string`      | Local file path to a json file.                  |
-
-### `requestValidation`
-
-| Option               | Type                                                                  | Default                                             | Description                                                         |
-| -------------------- | --------------------------------------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------- |
-| `enable`             | `boolean`                                                             | `true`                                              | Enable request validation globally.                                 |
-| `transform`          | `boolean`                                                             | `false`                                             | Coerce/transform inputs where schema allows (e.g., `"42"` → `42`).  |
-| `onValidationFailed` | `(ctx: ExecutionContext, errors: ValidationError[]) => void \| never` | throws `BadRequestException` with validation errors | Custom handler. Transform, throw your own exception, or log/ignore. |
-
-### `responseValidation`
-
-| Option               | Type                                                                  | Default                                                                    | Description                                                                                                                      |
-| -------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `enable`             | `boolean`                                                             | `false`                                                                    | Enable response validation globally.                                                                                             |
-| `skipErrorResponses` | `boolean`                                                             | `true`                                                                     | Skip validation for error responses (4xx/5xx status codes). Cant validate thrown errors, see [here](#error-response-validation). |
-| `onValidationFailed` | `(ctx: ExecutionContext, errors: ValidationError[]) => void \| never` | warns and throws `InternalServer ErrorException` without validation errors | Custom handler. Transform, throw your own exception, or log/ignore.                                                              |
-
-### `ajv`
+All routes are automatically validated. **For advanced configuration, see [the docs](https://nest-openapi.github.io/validator/)**.
 
-| Option      | Type                 | Default       | Description                                                             |
-| ----------- | -------------------- | ------------- | ----------------------------------------------------------------------- |
-| (itself)    | `Ajv`                | a v8 instance | Supply a fully configured AJV instance.                                 |
-| `options`   | `AjvOptions`         | —             | Initialize the internal AJV with these options (e.g., `strict: false`). |
-| `configure` | `(ajv: Ajv) => void` | —             | Hook to extend the instance (e.g., `addFormats(ajv)`).                  |
+### @nest-openapi/serializer
 
-## Decorators
+[![NPM – serializer](https://img.shields.io/npm/v/%40nest-openapi%2Fserializer.svg)](https://www.npmjs.com/package/%40nest-openapi%2Fserializer)
+![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/%40nest-openapi%2Fserializer.svg)
 
-### Per-route control (skip/override)
+Install:
 
-```typescript
-import { Validate } from "@nest-openapi/validator";
-
-@Controller("users")
-export class UsersController {
-  @Post()
-  @Validate({ request: false }) // Skip request validation for this route
-  createUser(@Body() userData: any) {
-    return this.usersService.create(userData);
-  }
-
-  @Get(":id")
-  @Validate({ request: { param: false }, response: false }) // Skip param and response validation for this route
-  getUser(@Param("id") id: string) {
-    return this.usersService.findById(id);
-  }
-}
-```
-
-## Manual Validation
-
-Inject the `OpenApiValidatorService` using the `OPENAPI_VALIDATOR` token for custom validation logic in guards, filters, services, or middleware:
-
-```typescript
-import { Injectable, Inject } from "@nestjs/common";
-import { HttpArgumentsHost } from "@nestjs/common/interfaces";
-import {
-  OPENAPI_VALIDATOR,
-  OpenApiValidatorService,
-} from "@nest-openapi/validator";
-
-@Injectable()
-export class MyService {
-  constructor(
-    @Inject(OPENAPI_VALIDATOR)
-    private readonly validator: OpenApiValidatorService
-  ) {}
-
-  validateData(httpContext: HttpArgumentsHost, responseBody) {
-    // Validate requests manually
-    const bodyOnlyErrors = this.validator.validateRequest(httpContext, {
-      body: true,
-      params: false,
-      query: false,
-    });
-
-    // Validate responses manually
-    const responseErrors = this.validator.validateResponse(
-      httpContext,
-      statusCode,
-      responseBody
-    );
-  }
-}
-```
-
-### Error Response Validation
-
-By default, the response validation interceptor only validates successful responses that flow through the normal pipeline. However, error responses (like `NotFoundException`, `BadRequestException`, etc.) bypass interceptors and go through exception filters.
-
-To validate error responses, inject the validator service in your exception filter:
-
-```typescript
-import {
-  Catch,
-  ExceptionFilter,
-  ArgumentsHost,
-  Injectable,
-  Inject,
-} from "@nestjs/common";
-import {
-  OPENAPI_VALIDATOR,
-  OpenApiValidatorService,
-} from "@nest-openapi/validator";
-
-@Catch()
-@Injectable()
-export class GlobalExceptionFilter implements ExceptionFilter {
-  constructor(
-    @Inject(OPENAPI_VALIDATOR)
-    private readonly validator: OpenApiValidatorService
-  ) {}
-
-  catch(exception: any, host: ArgumentsHost) {
-    const ctx = host.switchToHttp();
-    const response = ctx.getResponse();
-
-    const status = exception.getStatus?.() || 500;
-    const responseBody = {
-      message: exception.message,
-      statusCode: status,
-      timestamp: new Date().toISOString(),
-    };
-
-    const validationErrors = this.validator.validateResponse(
-      ctx,
-      status,
-      responseBody
-    );
-
-    if (validationErrors.length > 0) {
-      console.warn("Error response validation failed:", validationErrors);
-      // Handle validation errors as needed
-    }
-
-    response.status(status).json(responseBody);
-  }
-}
+```bash
+npm i @nest-openapi/serializer
 ```
 
-Then register your exception filter:
+Minimal setup:
 
 ```typescript
 // app.module.ts
+import { Module } from "@nestjs/common";
+import { OpenAPISerializerModule } from "@nest-openapi/serializer";
+import * as openApiSpec from "./openapi.json";
+
 @Module({
-  providers: [
-    {
-      provide: APP_FILTER,
-      useClass: GlobalExceptionFilter,
-    },
+  imports: [
+    OpenAPISerializerModule.forRoot({
+      specSource: { type: "object", spec: openApiSpec },
+      responseSerialization: { enable: true, skipErrorResponses: true },
+    }),
   ],
 })
 export class AppModule {}
 ```
 
-## Error Handling
-
-### Handle Validation Errors
-
-By default, the library throws:
+Successful responses are automatically serialized. **For advanced configuration, see [the docs](https://nest-openapi.github.io/serializer/)**.
 
-- `BadRequestException` for request validation failures, with detailed validation errors.
-- `InternalServerErrorException` for response validation failures (without detailed errors, unless you provide a custom handler).
-
-Validation errors follow the AJV `ErrorObject` format, extended with a `validationType` property:
-
-```json
-{
-  "message": "Validation failed",
-  "errors": [
-    {
-      "validationType": "body",
-      "instancePath": "/title",
-      "schemaPath": "#/properties/title/type",
-      "keyword": "type",
-      "params": { "type": "string" },
-      "message": "must be string"
-    }
-  ]
-}
-```
+---
 
-You can override this behavior using the onValidationFailed handler option in [requestValidation](#requestvalidation) or [responseValidation](#responsevalidation).
+## Compatibility
 
-Inside your handler, you can whether:
+- Works with NestJS v9+
+- Supports Express and Fastify adopters
 
-- Transform the error list and throw a custom exception.
-- Log and ignore errors (return without throwing).
+## Contributing
 
-```typescript
-OpenApiValidatorModule.forRoot({
-  specSource: { type: "object", spec: openApiSpec },
-  requestValidation: {
-    enable: true,
-    onValidationFailed: (context, errors) => {
-      // Custom error handling
-      throw new BadRequestException({
-        status: "validation_failed",
-        issues: errors.map((e) => ({
-          path: e.instancePath,
-          message: e.message,
-          received: e.data,
-        })),
-      });
-    },
-  },
-});
-```
+Issues and PRs are welcome. Please check the package folders and docs before opening an issue.
 
-## Performance and Compatibility
+## License
 
-- Optional schema [pre-compilation](#configuration-options) removes first-hit latency at the cost of longer startup.
-- Express and Fastify adopters are supported.
-- Supports NestJS version >= 9
+MIT © `@nest-openapi`

package/dist/index.cjs

@@ -40,8 +40,8 @@ var __decorateParam = (index, decorator) => (target, key) => decorator(target, k
 var index_exports = {};
 __export(index_exports, {
   OPENAPI_VALIDATOR: () => OPENAPI_VALIDATOR,
-  OpenApiValidatorModule: () => OpenApiValidatorModule,
-  OpenApiValidatorService: () => OpenApiValidatorService,
+  OpenAPIValidatorModule: () => OpenAPIValidatorModule,
+  OpenAPIValidatorService: () => OpenAPIValidatorService,
   Validate: () => Validate
 });
 module.exports = __toCommonJS(index_exports);
@@ -54,9 +54,14 @@ var import_core3 = require("@nestjs/core");
 var import_common = require("@nestjs/common");
 var import_runtime = require("@nest-openapi/runtime");
 var import_ajv = __toESM(require("ajv"), 1);
-var OPENAPI_VALIDATOR_OPTIONS = "OPENAPI_VALIDATOR_OPTIONS";
-var OPENAPI_VALIDATOR = "OPENAPI_VALIDATOR";
-var OpenApiValidatorService = class {
+
+// src/types/validator-options.interface.ts
+var OPENAPI_VALIDATOR_RUNTIME = Symbol("OPENAPI_VALIDATOR_RUNTIME");
+var OPENAPI_VALIDATOR_OPTIONS = Symbol("OPENAPI_VALIDATOR_OPTIONS");
+
+// src/services/openapi-validator.service.ts
+var OPENAPI_VALIDATOR = Symbol("OPENAPI_VALIDATOR");
+var OpenAPIValidatorService = class {
   constructor(runtime, options) {
     this.runtime = runtime;
     this.options = options;
@@ -78,7 +83,7 @@ var OpenApiValidatorService = class {
 ${JSON.stringify(opts, null, 2)}`);
     }
   }
-  logger = new import_common.Logger("OpenApiValidator");
+  logger = new import_common.Logger("OpenAPIValidator");
   ajv;
   openApiSpec;
   debugLog;
@@ -337,11 +342,11 @@ ${JSON.stringify(data, null, 2)}`);
     };
   }
 };
-OpenApiValidatorService = __decorateClass([
+OpenAPIValidatorService = __decorateClass([
   (0, import_common.Injectable)(),
-  __decorateParam(0, (0, import_common.Inject)(import_runtime.OpenApiRuntimeService)),
+  __decorateParam(0, (0, import_common.Inject)(OPENAPI_VALIDATOR_RUNTIME)),
   __decorateParam(1, (0, import_common.Inject)(OPENAPI_VALIDATOR_OPTIONS))
-], OpenApiValidatorService);
+], OpenAPIValidatorService);
 
 // src/interceptors/request-validation.interceptor.ts
 var import_common3 = require("@nestjs/common");
@@ -350,8 +355,8 @@ var import_runtime3 = require("@nest-openapi/runtime");
 
 // src/decorators/validate.decorator.ts
 var import_common2 = require("@nestjs/common");
-var VALIDATE_KEY = "VALIDATE";
-var Validate = (options = {}) => (0, import_common2.SetMetadata)(VALIDATE_KEY, options);
+var VALIDATE_OVERRIDE = Symbol("VALIDATE_OVERRIDE");
+var Validate = (options = {}) => (0, import_common2.SetMetadata)(VALIDATE_OVERRIDE, options);
 
 // src/interceptors/request-validation.interceptor.ts
 var RequestValidationInterceptor = class {
@@ -360,7 +365,7 @@ var RequestValidationInterceptor = class {
     this.reflector = reflector;
     this.debugLog = import_runtime3.DebugUtil.createDebugFn(this.logger, this.validatorService.validationOptions.debug || false);
   }
-  logger = new import_common3.Logger("OpenApiValidator");
+  logger = new import_common3.Logger("OpenAPIValidator");
   debugLog;
   async intercept(context, next) {
     if (!this.validatorService.openApiSpec) {
@@ -394,7 +399,7 @@ var RequestValidationInterceptor = class {
   }
   getValidationDecorator(context) {
     const validateMetadata = this.reflector.getAllAndOverride(
-      VALIDATE_KEY,
+      VALIDATE_OVERRIDE,
       [context.getHandler(), context.getClass()]
     );
     if (validateMetadata) {
@@ -437,7 +442,7 @@ var ResponseValidationInterceptor = class {
     this.reflector = reflector;
     this.debugLog = import_runtime5.DebugUtil.createDebugFn(this.logger, this.validatorService.validationOptions.debug || false);
   }
-  logger = new import_common4.Logger("OpenApiValidator");
+  logger = new import_common4.Logger("OpenAPIValidator");
   debugLog;
   intercept(context, next) {
     if (!this.validatorService.openApiSpec) {
@@ -477,7 +482,7 @@ var ResponseValidationInterceptor = class {
   }
   shouldValidateResponse(context) {
     const validateMetadata = this.reflector.getAllAndOverride(
-      VALIDATE_KEY,
+      VALIDATE_OVERRIDE,
       [context.getHandler(), context.getClass()]
     );
     if (validateMetadata) {
@@ -501,7 +506,7 @@ ResponseValidationInterceptor = __decorateClass([
 
 // src/modules/openapi-validator.module.ts
 var import_runtime7 = require("@nest-openapi/runtime");
-var OpenApiValidatorModule = class {
+var OpenAPIValidatorModule = class {
   /**
    * Configure the OpenAPI validator module with static options
    */
@@ -525,16 +530,12 @@ var OpenApiValidatorModule = class {
       },
       // Core services
       {
-        provide: import_runtime7.OpenApiRuntimeService,
-        useFactory: async (runtimeOptions) => {
-          const svc = new import_runtime7.OpenApiRuntimeService(runtimeOptions);
-          await svc.onModuleInit();
-          return svc;
-        },
-        inject: [import_runtime7.OPENAPI_RUNTIME_OPTIONS]
+        provide: OPENAPI_VALIDATOR_RUNTIME,
+        useFactory: async (opts) => import_runtime7.OpenAPIRuntimePool.getOrCreate({ specSource: opts.specSource, debug: opts.debug }),
+        inject: [OPENAPI_VALIDATOR_OPTIONS]
       },
-      OpenApiValidatorService,
-      { provide: OPENAPI_VALIDATOR, useExisting: OpenApiValidatorService },
+      OpenAPIValidatorService,
+      { provide: OPENAPI_VALIDATOR, useExisting: OpenAPIValidatorService },
       // Interceptors
       { provide: import_core3.APP_INTERCEPTOR, useClass: RequestValidationInterceptor }
     ];
@@ -545,13 +546,11 @@ var OpenApiValidatorModule = class {
       });
     }
     return {
-      module: OpenApiValidatorModule,
+      module: OpenAPIValidatorModule,
       providers,
       exports: [
-        OPENAPI_VALIDATOR_OPTIONS,
         OPENAPI_VALIDATOR,
-        import_runtime7.OpenApiRuntimeService,
-        OpenApiValidatorService
+        OpenAPIValidatorService
       ]
     };
   }
@@ -586,16 +585,12 @@ var OpenApiValidatorModule = class {
       },
       // Core services
       {
-        provide: import_runtime7.OpenApiRuntimeService,
-        useFactory: async (runtimeOptions) => {
-          const svc = new import_runtime7.OpenApiRuntimeService(runtimeOptions);
-          await svc.onModuleInit();
-          return svc;
-        },
-        inject: [import_runtime7.OPENAPI_RUNTIME_OPTIONS]
+        provide: OPENAPI_VALIDATOR_RUNTIME,
+        useFactory: async (opts) => import_runtime7.OpenAPIRuntimePool.getOrCreate({ specSource: opts.specSource, debug: opts.debug }),
+        inject: [OPENAPI_VALIDATOR_OPTIONS]
       },
-      OpenApiValidatorService,
-      { provide: OPENAPI_VALIDATOR, useExisting: OpenApiValidatorService },
+      OpenAPIValidatorService,
+      { provide: OPENAPI_VALIDATOR, useExisting: OpenAPIValidatorService },
       // Interceptors
       { provide: import_core3.APP_INTERCEPTOR, useClass: RequestValidationInterceptor },
       // Conditionally add response validation
@@ -607,30 +602,28 @@ var OpenApiValidatorModule = class {
           }
           return { intercept: (_ctx, next) => next.handle() };
         },
-        inject: [OPENAPI_VALIDATOR_OPTIONS, OpenApiValidatorService, import_core3.Reflector]
+        inject: [OPENAPI_VALIDATOR_OPTIONS, OpenAPIValidatorService, import_core3.Reflector]
       }
     ];
     return {
-      module: OpenApiValidatorModule,
+      module: OpenAPIValidatorModule,
       imports: options.imports || [],
       providers,
       exports: [
-        OPENAPI_VALIDATOR_OPTIONS,
         OPENAPI_VALIDATOR,
-        import_runtime7.OpenApiRuntimeService,
-        OpenApiValidatorService
+        OpenAPIValidatorService
       ]
     };
   }
 };
-OpenApiValidatorModule = __decorateClass([
+OpenAPIValidatorModule = __decorateClass([
   (0, import_common5.Global)(),
   (0, import_common5.Module)({})
-], OpenApiValidatorModule);
+], OpenAPIValidatorModule);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OPENAPI_VALIDATOR,
-  OpenApiValidatorModule,
-  OpenApiValidatorService,
+  OpenAPIValidatorModule,
+  OpenAPIValidatorService,
   Validate
 });

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as _nestjs_common from '@nestjs/common';
 import { ExecutionContext, DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
 import Ajv, { ErrorObject, Options } from 'ajv';
-import { SpecSource, OpenAPISpec, OpenApiRuntimeService } from '@nest-openapi/runtime';
+import { SpecSource, OpenAPISpec, OpenAPIRuntimeService } from '@nest-openapi/runtime';
 import { HttpArgumentsHost } from '@nestjs/common/interfaces';
 
 interface ValidationError extends ErrorObject {
@@ -88,7 +88,7 @@ interface ValidatorOptions {
     debug?: boolean;
 }
 
-declare class OpenApiValidatorModule {
+declare class OpenAPIValidatorModule {
     /**
      * Configure the OpenAPI validator module with static options
      */
@@ -103,15 +103,15 @@ declare class OpenApiValidatorModule {
     }): DynamicModule;
 }
 
-declare const OPENAPI_VALIDATOR = "OPENAPI_VALIDATOR";
-declare class OpenApiValidatorService implements OnApplicationBootstrap {
+declare const OPENAPI_VALIDATOR: unique symbol;
+declare class OpenAPIValidatorService implements OnApplicationBootstrap {
     private readonly runtime;
     private readonly options;
     private readonly logger;
     private ajv;
     openApiSpec: OpenAPISpec;
     private debugLog;
-    constructor(runtime: OpenApiRuntimeService, options: ValidatorOptions);
+    constructor(runtime: OpenAPIRuntimeService, options: ValidatorOptions);
     onApplicationBootstrap(): Promise<void>;
     private get isSpecLoaded();
     get validationOptions(): ValidatorOptions;
@@ -137,7 +137,8 @@ declare class OpenApiValidatorService implements OnApplicationBootstrap {
     private getParameterSchema;
 }
 
-interface ValidateOptions {
+declare const VALIDATE_OVERRIDE: unique symbol;
+interface ValidateOverrideOptions {
     request?: boolean | {
         params?: boolean;
         query?: boolean;
@@ -173,6 +174,6 @@ interface ValidateOptions {
  * }
  * ```
  */
-declare const Validate: (options?: ValidateOptions) => _nestjs_common.CustomDecorator<string>;
+declare const Validate: (options?: ValidateOverrideOptions) => _nestjs_common.CustomDecorator<typeof VALIDATE_OVERRIDE>;
 
-export { OPENAPI_VALIDATOR, OpenApiValidatorModule, OpenApiValidatorService, Validate, type ValidateOptions, type ValidationError, type ValidationErrorResponse, type ValidatorOptions };
+export { OPENAPI_VALIDATOR, OpenAPIValidatorModule, OpenAPIValidatorService, Validate, type ValidateOverrideOptions, type ValidationError, type ValidationErrorResponse, type ValidatorOptions };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _nestjs_common from '@nestjs/common';
 import { ExecutionContext, DynamicModule, OnApplicationBootstrap } from '@nestjs/common';
 import Ajv, { ErrorObject, Options } from 'ajv';
-import { SpecSource, OpenAPISpec, OpenApiRuntimeService } from '@nest-openapi/runtime';
+import { SpecSource, OpenAPISpec, OpenAPIRuntimeService } from '@nest-openapi/runtime';
 import { HttpArgumentsHost } from '@nestjs/common/interfaces';
 
 interface ValidationError extends ErrorObject {
@@ -88,7 +88,7 @@ interface ValidatorOptions {
     debug?: boolean;
 }
 
-declare class OpenApiValidatorModule {
+declare class OpenAPIValidatorModule {
     /**
      * Configure the OpenAPI validator module with static options
      */
@@ -103,15 +103,15 @@ declare class OpenApiValidatorModule {
     }): DynamicModule;
 }
 
-declare const OPENAPI_VALIDATOR = "OPENAPI_VALIDATOR";
-declare class OpenApiValidatorService implements OnApplicationBootstrap {
+declare const OPENAPI_VALIDATOR: unique symbol;
+declare class OpenAPIValidatorService implements OnApplicationBootstrap {
     private readonly runtime;
     private readonly options;
     private readonly logger;
     private ajv;
     openApiSpec: OpenAPISpec;
     private debugLog;
-    constructor(runtime: OpenApiRuntimeService, options: ValidatorOptions);
+    constructor(runtime: OpenAPIRuntimeService, options: ValidatorOptions);
     onApplicationBootstrap(): Promise<void>;
     private get isSpecLoaded();
     get validationOptions(): ValidatorOptions;
@@ -137,7 +137,8 @@ declare class OpenApiValidatorService implements OnApplicationBootstrap {
     private getParameterSchema;
 }
 
-interface ValidateOptions {
+declare const VALIDATE_OVERRIDE: unique symbol;
+interface ValidateOverrideOptions {
     request?: boolean | {
         params?: boolean;
         query?: boolean;
@@ -173,6 +174,6 @@ interface ValidateOptions {
  * }
  * ```
  */
-declare const Validate: (options?: ValidateOptions) => _nestjs_common.CustomDecorator<string>;
+declare const Validate: (options?: ValidateOverrideOptions) => _nestjs_common.CustomDecorator<typeof VALIDATE_OVERRIDE>;
 
-export { OPENAPI_VALIDATOR, OpenApiValidatorModule, OpenApiValidatorService, Validate, type ValidateOptions, type ValidationError, type ValidationErrorResponse, type ValidatorOptions };
+export { OPENAPI_VALIDATOR, OpenAPIValidatorModule, OpenAPIValidatorService, Validate, type ValidateOverrideOptions, type ValidationError, type ValidationErrorResponse, type ValidatorOptions };

package/dist/index.js

@@ -16,11 +16,16 @@ import { APP_INTERCEPTOR, Reflector as Reflector3 } from "@nestjs/core";
 
 // src/services/openapi-validator.service.ts
 import { Injectable, Logger, Inject } from "@nestjs/common";
-import { OpenApiRuntimeService, DebugUtil, PlatformUtil } from "@nest-openapi/runtime";
+import { DebugUtil, PlatformUtil } from "@nest-openapi/runtime";
 import Ajv from "ajv";
-var OPENAPI_VALIDATOR_OPTIONS = "OPENAPI_VALIDATOR_OPTIONS";
-var OPENAPI_VALIDATOR = "OPENAPI_VALIDATOR";
-var OpenApiValidatorService = class {
+
+// src/types/validator-options.interface.ts
+var OPENAPI_VALIDATOR_RUNTIME = Symbol("OPENAPI_VALIDATOR_RUNTIME");
+var OPENAPI_VALIDATOR_OPTIONS = Symbol("OPENAPI_VALIDATOR_OPTIONS");
+
+// src/services/openapi-validator.service.ts
+var OPENAPI_VALIDATOR = Symbol("OPENAPI_VALIDATOR");
+var OpenAPIValidatorService = class {
   constructor(runtime, options) {
     this.runtime = runtime;
     this.options = options;
@@ -42,7 +47,7 @@ var OpenApiValidatorService = class {
 ${JSON.stringify(opts, null, 2)}`);
     }
   }
-  logger = new Logger("OpenApiValidator");
+  logger = new Logger("OpenAPIValidator");
   ajv;
   openApiSpec;
   debugLog;
@@ -301,11 +306,11 @@ ${JSON.stringify(data, null, 2)}`);
     };
   }
 };
-OpenApiValidatorService = __decorateClass([
+OpenAPIValidatorService = __decorateClass([
   Injectable(),
-  __decorateParam(0, Inject(OpenApiRuntimeService)),
+  __decorateParam(0, Inject(OPENAPI_VALIDATOR_RUNTIME)),
   __decorateParam(1, Inject(OPENAPI_VALIDATOR_OPTIONS))
-], OpenApiValidatorService);
+], OpenAPIValidatorService);
 
 // src/interceptors/request-validation.interceptor.ts
 import {
@@ -319,8 +324,8 @@ import { DebugUtil as DebugUtil2 } from "@nest-openapi/runtime";
 
 // src/decorators/validate.decorator.ts
 import { SetMetadata } from "@nestjs/common";
-var VALIDATE_KEY = "VALIDATE";
-var Validate = (options = {}) => SetMetadata(VALIDATE_KEY, options);
+var VALIDATE_OVERRIDE = Symbol("VALIDATE_OVERRIDE");
+var Validate = (options = {}) => SetMetadata(VALIDATE_OVERRIDE, options);
 
 // src/interceptors/request-validation.interceptor.ts
 var RequestValidationInterceptor = class {
@@ -329,7 +334,7 @@ var RequestValidationInterceptor = class {
     this.reflector = reflector;
     this.debugLog = DebugUtil2.createDebugFn(this.logger, this.validatorService.validationOptions.debug || false);
   }
-  logger = new Logger2("OpenApiValidator");
+  logger = new Logger2("OpenAPIValidator");
   debugLog;
   async intercept(context, next) {
     if (!this.validatorService.openApiSpec) {
@@ -363,7 +368,7 @@ var RequestValidationInterceptor = class {
   }
   getValidationDecorator(context) {
     const validateMetadata = this.reflector.getAllAndOverride(
-      VALIDATE_KEY,
+      VALIDATE_OVERRIDE,
       [context.getHandler(), context.getClass()]
     );
     if (validateMetadata) {
@@ -411,7 +416,7 @@ var ResponseValidationInterceptor = class {
     this.reflector = reflector;
     this.debugLog = DebugUtil3.createDebugFn(this.logger, this.validatorService.validationOptions.debug || false);
   }
-  logger = new Logger3("OpenApiValidator");
+  logger = new Logger3("OpenAPIValidator");
   debugLog;
   intercept(context, next) {
     if (!this.validatorService.openApiSpec) {
@@ -451,7 +456,7 @@ var ResponseValidationInterceptor = class {
   }
   shouldValidateResponse(context) {
     const validateMetadata = this.reflector.getAllAndOverride(
-      VALIDATE_KEY,
+      VALIDATE_OVERRIDE,
       [context.getHandler(), context.getClass()]
     );
     if (validateMetadata) {
@@ -474,8 +479,8 @@ ResponseValidationInterceptor = __decorateClass([
 ], ResponseValidationInterceptor);
 
 // src/modules/openapi-validator.module.ts
-import { OpenApiRuntimeService as OpenApiRuntimeService2, OPENAPI_RUNTIME_OPTIONS } from "@nest-openapi/runtime";
-var OpenApiValidatorModule = class {
+import { OPENAPI_RUNTIME_OPTIONS, OpenAPIRuntimePool } from "@nest-openapi/runtime";
+var OpenAPIValidatorModule = class {
   /**
    * Configure the OpenAPI validator module with static options
    */
@@ -499,16 +504,12 @@ var OpenApiValidatorModule = class {
       },
       // Core services
       {
-        provide: OpenApiRuntimeService2,
-        useFactory: async (runtimeOptions) => {
-          const svc = new OpenApiRuntimeService2(runtimeOptions);
-          await svc.onModuleInit();
-          return svc;
-        },
-        inject: [OPENAPI_RUNTIME_OPTIONS]
+        provide: OPENAPI_VALIDATOR_RUNTIME,
+        useFactory: async (opts) => OpenAPIRuntimePool.getOrCreate({ specSource: opts.specSource, debug: opts.debug }),
+        inject: [OPENAPI_VALIDATOR_OPTIONS]
       },
-      OpenApiValidatorService,
-      { provide: OPENAPI_VALIDATOR, useExisting: OpenApiValidatorService },
+      OpenAPIValidatorService,
+      { provide: OPENAPI_VALIDATOR, useExisting: OpenAPIValidatorService },
       // Interceptors
       { provide: APP_INTERCEPTOR, useClass: RequestValidationInterceptor }
     ];
@@ -519,13 +520,11 @@ var OpenApiValidatorModule = class {
       });
     }
     return {
-      module: OpenApiValidatorModule,
+      module: OpenAPIValidatorModule,
       providers,
       exports: [
-        OPENAPI_VALIDATOR_OPTIONS,
         OPENAPI_VALIDATOR,
-        OpenApiRuntimeService2,
-        OpenApiValidatorService
+        OpenAPIValidatorService
       ]
     };
   }
@@ -560,16 +559,12 @@ var OpenApiValidatorModule = class {
       },
       // Core services
       {
-        provide: OpenApiRuntimeService2,
-        useFactory: async (runtimeOptions) => {
-          const svc = new OpenApiRuntimeService2(runtimeOptions);
-          await svc.onModuleInit();
-          return svc;
-        },
-        inject: [OPENAPI_RUNTIME_OPTIONS]
+        provide: OPENAPI_VALIDATOR_RUNTIME,
+        useFactory: async (opts) => OpenAPIRuntimePool.getOrCreate({ specSource: opts.specSource, debug: opts.debug }),
+        inject: [OPENAPI_VALIDATOR_OPTIONS]
       },
-      OpenApiValidatorService,
-      { provide: OPENAPI_VALIDATOR, useExisting: OpenApiValidatorService },
+      OpenAPIValidatorService,
+      { provide: OPENAPI_VALIDATOR, useExisting: OpenAPIValidatorService },
       // Interceptors
       { provide: APP_INTERCEPTOR, useClass: RequestValidationInterceptor },
       // Conditionally add response validation
@@ -581,29 +576,27 @@ var OpenApiValidatorModule = class {
           }
           return { intercept: (_ctx, next) => next.handle() };
         },
-        inject: [OPENAPI_VALIDATOR_OPTIONS, OpenApiValidatorService, Reflector3]
+        inject: [OPENAPI_VALIDATOR_OPTIONS, OpenAPIValidatorService, Reflector3]
       }
     ];
     return {
-      module: OpenApiValidatorModule,
+      module: OpenAPIValidatorModule,
       imports: options.imports || [],
       providers,
       exports: [
-        OPENAPI_VALIDATOR_OPTIONS,
         OPENAPI_VALIDATOR,
-        OpenApiRuntimeService2,
-        OpenApiValidatorService
+        OpenAPIValidatorService
       ]
     };
   }
 };
-OpenApiValidatorModule = __decorateClass([
+OpenAPIValidatorModule = __decorateClass([
   Global(),
   Module({})
-], OpenApiValidatorModule);
+], OpenAPIValidatorModule);
 export {
   OPENAPI_VALIDATOR,
-  OpenApiValidatorModule,
-  OpenApiValidatorService,
+  OpenAPIValidatorModule,
+  OpenAPIValidatorService,
   Validate
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nest-openapi/validator",
-  "version": "0.1.0",
-  "description": "Automatic request/response validation for NestJS using OpenAPI specifications",
+  "version": "0.1.1",
+  "description": "Automatic request/response validation for NestJS using your OpenAPI specifications",
   "sideEffects": false,
   "keywords": [
     "nest",
@@ -27,6 +27,16 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --target node20 --outDir dist --clean --external rxjs --external ajv --external @nestjs/common --external @nestjs/core",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "prepack": "node -e \"const fs=require('fs');const path=require('path');fs.copyFileSync(path.resolve(__dirname,'..','..','README.md'), path.resolve(__dirname,'README.md'));\"",
+    "postpack": "node -e \"const fs=require('fs');const path=require('path');try{fs.unlinkSync(path.resolve(__dirname,'README.md'))}catch(_){}\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
   "homepage": "https://nest-openapi.github.io/",
   "repository": {
     "type": "git",
@@ -44,7 +54,7 @@
     "@nestjs/common": "^9.0.0 || ^10.0.0 || ^11.0.0",
     "@nestjs/core": "^9.0.0 || ^10.0.0 || ^11.0.0",
     "ajv": "^8.0.0",
-    "reflect-metadata": "^0.1.13"
+    "reflect-metadata": "^0.2.2"
   },
   "peerDependenciesMeta": {
     "ajv": {
@@ -52,10 +62,12 @@
     }
   },
   "dependencies": {
-    "@nest-openapi/runtime": "^0.1.0",
-    "ajv": "^8.0.0"
+    "@nest-openapi/runtime": "^0.1.1",
+    "ajv": "^8.0.0",
+    "rxjs": "^7.2.0"
   },
   "devDependencies": {
+    "@nest-openapi/runtime": "workspace:^",
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/platform-express": "^11.1.3",
@@ -66,13 +78,11 @@
     "@typescript-eslint/parser": "^8.35.1",
     "eslint": "^9.30.1",
     "jest": "^29.0.0",
-    "reflect-metadata": "^0.1.13",
-    "rxjs": "^7.2.0",
+    "reflect-metadata": "^0.2.2",
     "supertest": "^7.1.0",
     "ts-jest": "^29.0.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.0.0",
-    "@nest-openapi/runtime": "^0.1.0"
+    "typescript": "^5.9.0"
   },
   "jest": {
     "moduleFileExtensions": [
@@ -91,13 +101,5 @@
     ],
     "coverageDirectory": "coverage",
     "testEnvironment": "node"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --target node20 --outDir dist --clean --external rxjs --external ajv --external @nestjs/common --external @nestjs/core",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:cov": "jest --coverage",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 nest-openapi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.