Add nest-openapi tools (#688)

Author: alireza-malek

src/content/tools/nest-openapi-mock.md

@@ -0,0 +1,50 @@
+---
+name: '@nest-openapi/mock'
+description: Spec-driven mock server for NestJS that generates realistic mock responses from OpenAPI.
+categories:
+  - mocking-tools
+link: https://nest-openapi.github.io/mock/
+languages:
+  typescript: true
+  nodejs: true
+repo: https://github.com/ts-oas/nest-openapi
+oasVersions:
+  v2: false
+  v3: true
+  v3_1: true
+  v3_2: false
+---
+
+## Overview
+
+`@nest-openapi/mock` enables spec-driven mocking for NestJS applications. It generates realistic mock responses from your OpenAPI specification, making it ideal for development, testing, and frontend development when backend APIs are not yet available.
+
+## Features
+
+- **Spec-driven mocking**: Generates mock responses directly from your OpenAPI specification
+- **Multiple strategies**: Examples, JSON Schema Faker, response recording/reply, primitive values, or passthrough
+- **Selective mocking**: Can mock all routes by default or specific routes only
+- **Drop-in integration**: Works seamlessly with existing NestJS controllers
+- **Flexible**: Per-route overrides and request header hints
+
+## Usage
+
+Install the package and configure it in your NestJS module:
+
+```typescript
+import { OpenAPIMockModule } from '@nest-openapi/mock';
+import { Module } from '@nestjs/common';
+
+import * as openApiSpec from './openapi.json';
+
+@Module({
+  imports: [
+    OpenAPIMockModule.forRoot({
+      specSource: { type: 'object', spec: openApiSpec },
+      enable: process.env.NODE_ENV === 'development',
+      mockByDefault: true, // Mock all routes by default, like a mock server
+    }),
+  ],
+})
+export class AppModule {}
+```

src/content/tools/nest-openapi-serializer.md

@@ -0,0 +1,68 @@
+---
+name: '@nest-openapi/serializer'
+description: High-performance response serialization for NestJS based on your OpenAPI spec using fast-json-stringify.
+categories:
+  - misc
+link: https://nest-openapi.github.io/serializer/
+languages:
+  typescript: true
+  nodejs: true
+repo: https://github.com/ts-oas/nest-openapi
+oasVersions:
+  v2: false
+  v3: true
+  v3_1: true
+  v3_2: false
+---
+
+## Overview
+
+`@nest-openapi/serializer` provides high-performance response serialization for NestJS applications. It uses `fast-json-stringify` to automatically serialize responses according to your OpenAPI specification, ensuring output matches your API contract while maintaining optimal performance.
+
+## Features
+
+- **Spec-driven**: Automatically serializes responses based on your OpenAPI schema definitions
+- **Fast by default**: Uses [`fast-json-stringify`](https://github.com/fastify/fast-json-stringify) with caching and optional pre‑compilation.
+- **NestJS‑native**: Auto serializes with per‑route opt‑out and overrides.
+- **Drop-in integration**: Works seamlessly with existing NestJS controllers
+- **Platform agnostic**: Supports both Express and Fastify adapters
+
+## Usage
+
+Install the package and configure it in your NestJS module:
+
+```typescript
+import { OpenAPISerializerModule } from '@nest-openapi/serializer';
+import { Module } from '@nestjs/common';
+
+import * as openApiSpec from './openapi.json';
+
+@Module({
+  imports: [
+    OpenAPISerializerModule.forRoot({
+      specSource: { type: 'object', spec: openApiSpec },
+      responseSerialization: {
+        enable: true,
+        skipErrorResponses: true,
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+You can disable serialization for specific routes using the `@Serialize` decorator:
+
+```typescript
+import { Serialize } from '@nest-openapi/serializer';
+import { Body, Controller, Post } from '@nestjs/common';
+
+@Controller('books')
+export class BooksController {
+  @Post()
+  @Serialize({ disable: true })
+  create(@Body() dto: CreateBookDto): Book {
+    return this.booksService.create(dto);
+  }
+}
+```

src/content/tools/nest-openapi-validator.md

@@ -0,0 +1,64 @@
+---
+name: '@nest-openapi/validator'
+description: Automatic request/response validation for NestJS based on your OpenAPI spec using AJV.
+categories:
+  - data-validators
+link: https://nest-openapi.github.io/validator/
+languages:
+  typescript: true
+  nodejs: true
+repo: https://github.com/ts-oas/nest-openapi
+oasVersions:
+  v2: false
+  v3: true
+  v3_1: true
+  v3_2: false
+---
+
+## Overview
+
+`@nest-openapi/validator` provides automatic, highly configurable request and response validation for NestJS applications using your OpenAPI specification as the single source of truth. It validates incoming requests and outgoing responses against your OpenAPI spec, ensuring API contracts are enforced at runtime.
+
+## Features
+
+- **Spec‑driven**: The OpenAPI spec is the contract; validation is generated from it
+- **Fast by Design**: [AJV under the hood](https://github.com/ajv-validator/ajv), with caching and optional pre-compilation
+- **NestJS‑native**: Auto validates with per‑route opt‑out and overrides
+- **Drop-in integration**: Works seamlessly with existing NestJS controllers
+- **Platform agnostic**: Supports both Express and Fastify adapters
+
+## Usage
+
+Install the package and configure it in your NestJS module:
+
+```typescript
+import { OpenAPIValidatorModule } from '@nest-openapi/validator';
+import { Module } from '@nestjs/common';
+
+import * as openApiSpec from './openapi.json';
+
+@Module({
+  imports: [
+    OpenAPIValidatorModule.forRoot({
+      specSource: { type: 'object', spec: openApiSpec },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+You can also use per-route decorators to customize validation behavior:
+
+```typescript
+import { Validate } from '@nest-openapi/validator';
+import { Body, Controller, Post } from '@nestjs/common';
+
+@Controller('books')
+export class BooksController {
+  @Post()
+  @Validate({ request: { query: false }, response: true })
+  create(@Body() dto: CreateBookDto): Book {
+    return this.booksService.create(dto);
+  }
+}
+```