nestjs-api-forge 1.0.2 → 1.0.4

package/README.md

@@ -1,17 +1,32 @@
 # nestjs-api-forge
 
-Standardized API response formatting, structured error handling, and exception filters for [NestJS](https://nestjs.com/) applications.
+[![CI](https://img.shields.io/github/actions/workflow/status/mirzasaikatahmmed/nestjs-api-forge/publish.yml?label=build)](https://github.com/mirzasaikatahmmed/nestjs-api-forge/actions/workflows/publish.yml)
+[![npm version](https://img.shields.io/npm/v/nestjs-api-forge.svg)](https://www.npmjs.com/package/nestjs-api-forge)
+[![npm downloads](https://img.shields.io/npm/dm/nestjs-api-forge.svg)](https://www.npmjs.com/package/nestjs-api-forge)
+[![license](https://img.shields.io/npm/l/nestjs-api-forge.svg)](https://github.com/mirzasaikatahmmed/nestjs-api-forge/blob/main/LICENSE)
+
+Plug-and-play response envelope, exception filter, and error formatting for [NestJS](https://nestjs.com/) REST APIs — zero boilerplate, fully typed.
+
+---
 
 ## Features
 
-- **Uniform success response** envelope wrapping all handler return values
-- **Structured error responses** with `code`, `message`, and optional `details` array
-- **Global exception filter** that handles `HttpException`, `ValidationPipe` errors, and unexpected exceptions
-- **Built-in typed exceptions** (`NotFoundException`, `UnauthorizedException`, `ValidationException`, etc.)
-- **`@ForgeMessage`** decorator to override per-route success messages
-- **`@ForgeRawResponse`** decorator to opt a route out of wrapping
-- **`ApiForgeModule.forRoot()`** for one-line global registration
-- **`ApiForgeModule.forRootAsync()`** for config-service-driven options
+- **Uniform success envelope** — every handler response wrapped with `success`, `statusCode`, `message`, `data`, and `meta`
+- **Structured error responses** — consistent `code`, `message`, and optional `details` array for all errors
+- **Global exception filter** — handles `HttpException`, `ValidationPipe` errors, and unexpected exceptions
+- **Paginated response helper** — `ApiResponseDto.paginated()` with full pagination meta
+- **Built-in typed exceptions** — drop-in replacements for NestJS built-ins with structured error codes
+- **`@ForgeMessage`** — override per-route success message
+- **`@ForgeRawResponse`** — opt a route out of envelope wrapping
+- **`@ForgeMeta`** — merge custom fields into `meta` per route or controller
+- **`@ForgeDeprecated`** — mark a route as deprecated (adds `meta.deprecated` + `Deprecation` header)
+- **`@ApiForge`** — apply filter + interceptor to a single controller without going global
+- **`ForgeValidationPipe`** — drop-in `ValidationPipe` that throws structured `ValidationException` with typed field details
+- **`ApiForgeModule.forRoot()`** — one-line global registration
+- **`ApiForgeModule.forRootAsync()`** — config-service-driven async options
+- **Correlation ID passthrough** — read `X-Request-ID` / `X-Correlation-ID` from requests, echo on responses
+- **Response time** — optional `meta.responseTime` for every response
+- **Request ID tracing** — optional auto-generated UUID `requestId` in every response `meta`
 
 ---
 
@@ -25,7 +40,7 @@ npm install nestjs-api-forge
 
 ## Quick Start
 
-### 1. Register globally (`app.module.ts`)
+### 1. Register globally in `app.module.ts`
 
 ```typescript
 import { Module } from '@nestjs/common';
@@ -34,57 +49,70 @@ import { ApiForgeModule } from 'nestjs-api-forge';
 @Module({
   imports: [
     ApiForgeModule.forRoot({
-      version: '1.0',
-      defaultSuccessMessage: 'OK',
+      version: '1.0.0',
+      defaultSuccessMessage: 'Request successful',
       includePath: true,
       includeTimestamp: true,
+      includeRequestId: true,
+      includeResponseTime: true,
+      correlationIdHeader: 'x-request-id',
     }),
   ],
 })
 export class AppModule {}
 ```
 
-Every route in your application will now return a standardized response automatically.
+### 2. Use `ForgeValidationPipe` in `main.ts`
+
+```typescript
+import { ForgeValidationPipe } from 'nestjs-api-forge';
+
+app.useGlobalPipes(new ForgeValidationPipe());
+```
+
+`ForgeValidationPipe` extends NestJS `ValidationPipe` and throws a structured `ValidationException` with typed field-level details — no string parsing required.
 
 ---
 
-## Response Formats
+## Response Shapes
 
-### Success
+### Success (`2xx`)
 
 ```json
 {
   "success": true,
   "statusCode": 200,
-  "message": "Request successful",
-  "data": { "id": 1, "name": "Alice" },
+  "message": "User fetched successfully",
+  "data": { "id": 1, "name": "Alice Johnson", "email": "alice@example.com" },
   "meta": {
-    "timestamp": "2026-05-02T10:00:00.000Z",
+    "timestamp": "2026-05-15T10:00:00.000Z",
     "path": "/api/users/1",
-    "version": "1.0"
+    "version": "1.0.0",
+    "requestId": "a3f2c1d0-84e5-4b6a-9123-abc123def456",
+    "responseTime": "4ms"
   }
 }
 ```
 
-### Error
+### Error (`4xx` / `5xx`)
 
 ```json
 {
   "success": false,
   "statusCode": 404,
   "message": "User not found",
-  "error": {
-    "code": "NOT_FOUND"
-  },
+  "error": { "code": "NOT_FOUND" },
   "meta": {
-    "timestamp": "2026-05-02T10:00:00.000Z",
+    "timestamp": "2026-05-15T10:00:00.000Z",
     "path": "/api/users/99",
-    "version": "1.0"
+    "version": "1.0.0",
+    "requestId": "b1e2f3a4-0000-4b5c-8d9e-fedcba987654",
+    "responseTime": "2ms"
   }
 }
 ```
 
-### Validation Error (from `ValidationPipe`)
+### Validation Error
 
 ```json
 {
@@ -95,12 +123,49 @@ Every route in your application will now return a standardized response automati
     "code": "VALIDATION_ERROR",
     "details": [
       { "field": "email", "message": "must be an email" },
-      { "field": "password", "message": "must be longer than 8 characters" }
+      { "field": "address.zip", "message": "must be a string" }
     ]
   },
+  "meta": { "timestamp": "2026-05-15T10:00:00.000Z", "path": "/api/users" }
+}
+```
+
+### Paginated
+
+```json
+{
+  "success": true,
+  "statusCode": 200,
+  "message": "Users fetched successfully",
+  "data": [{ "id": 1, "name": "Alice Johnson" }],
+  "pagination": {
+    "total": 42,
+    "page": 2,
+    "limit": 10,
+    "totalPages": 5,
+    "hasNextPage": true,
+    "hasPrevPage": true
+  },
   "meta": {
-    "timestamp": "2026-05-02T10:00:00.000Z",
-    "path": "/api/auth/register"
+    "timestamp": "2026-05-15T10:00:00.000Z",
+    "path": "/api/users?page=2&limit=10",
+    "responseTime": "8ms"
+  }
+}
+```
+
+### Deprecated route
+
+```json
+{
+  "success": true,
+  "statusCode": 200,
+  "message": "OK",
+  "data": { },
+  "meta": {
+    "timestamp": "2026-05-15T10:00:00.000Z",
+    "deprecated": true,
+    "deprecationNotice": "Use /v2/users instead"
   }
 }
 ```
@@ -115,104 +180,215 @@ Every route in your application will now return a standardized response automati
 |---|---|---|---|
 | `includePath` | `boolean` | `true` | Include request path in `meta` |
 | `includeTimestamp` | `boolean` | `true` | Include ISO timestamp in `meta` |
+| `includeRequestId` | `boolean` | `false` | Auto-generate UUID `requestId` in `meta` if no correlation header found |
+| `correlationIdHeader` | `string \| string[]` | `['x-request-id', 'x-correlation-id']` | Header(s) to read request ID from; echoed back on the response |
+| `includeResponseTime` | `boolean` | `false` | Include handler duration as `meta.responseTime` (e.g. `"12ms"`) |
 | `version` | `string` | `undefined` | API version string added to `meta` |
-| `defaultSuccessMessage` | `string` | `'Request successful'` | Default success message |
+| `defaultSuccessMessage` | `string` | `'Request successful'` | Fallback success message |
+
+### `ApiForgeModule.forRootAsync(asyncOptions)`
+
+```typescript
+ApiForgeModule.forRootAsync({
+  imports: [ConfigModule],
+  inject: [ConfigService],
+  useFactory: (config: ConfigService) => ({
+    version: config.get('API_VERSION'),
+    includeRequestId: true,
+    includeResponseTime: true,
+    correlationIdHeader: config.get('CORRELATION_HEADER'),
+  }),
+})
+```
 
 ### Decorators
 
 | Decorator | Scope | Description |
 |---|---|---|
-| `@ApiForge(options?)` | Controller / Method | Apply filter + interceptor to a single controller or method |
+| `@ApiForge(options?)` | Controller / Method | Apply filter + interceptor without going global |
 | `@ForgeMessage(msg)` | Controller / Method | Override the success message for that route |
-| `@ForgeRawResponse()` | Controller / Method | Skip response wrapping; return handler value as-is |
+| `@ForgeRawResponse()` | Controller / Method | Skip envelope wrapping; return raw handler value |
+| `@ForgeMeta(extra)` | Controller / Method | Merge extra key-value pairs into `meta` |
+| `@ForgeDeprecated(notice?)` | Controller / Method | Mark route deprecated — adds `meta.deprecated`, optional `meta.deprecationNotice`, and `Deprecation: true` header |
+
+### `ForgeValidationPipe`
+
+Drop-in replacement for NestJS `ValidationPipe`. Throws `ValidationException` with structured `details` instead of a string-message array. Supports nested objects (dot-notation fields).
+
+```typescript
+// main.ts
+app.useGlobalPipes(new ForgeValidationPipe());
+
+// Override defaults
+app.useGlobalPipes(new ForgeValidationPipe({
+  whitelist: false,
+  forbidNonWhitelisted: false,
+}));
+```
+
+### `ApiResponseDto` — manual usage
+
+```typescript
+import { ApiResponseDto } from 'nestjs-api-forge';
+
+ApiResponseDto.success(data, 'OK', 200, { path: '/users/1' });
+ApiResponseDto.created(data, 'User created');
+ApiResponseDto.accepted(jobRef, 'Export queued');   // 202
+ApiResponseDto.noContent('Deleted');                // 204
+ApiResponseDto.paginated(data, total, page, limit, 'Users fetched');
+ApiResponseDto.error('Not found', 404, { code: 'NOT_FOUND' });
+```
 
 ### Built-in Exceptions
 
-All exceptions extend `ApiException` which extends NestJS's `HttpException`.
+All extend `ApiException` → `HttpException`.
 
 | Class | Status | Code |
 |---|---|---|
 | `BadRequestException` | 400 | `BAD_REQUEST` |
 | `UnauthorizedException` | 401 | `UNAUTHORIZED` |
+| `PaymentRequiredException` | 402 | `PAYMENT_REQUIRED` |
 | `ForbiddenException` | 403 | `FORBIDDEN` |
 | `NotFoundException` | 404 | `NOT_FOUND` |
+| `MethodNotAllowedException` | 405 | `METHOD_NOT_ALLOWED` |
 | `ConflictException` | 409 | `CONFLICT` |
 | `UnprocessableEntityException` | 422 | `UNPROCESSABLE_ENTITY` |
 | `TooManyRequestsException` | 429 | `TOO_MANY_REQUESTS` |
 | `InternalServerException` | 500 | `INTERNAL_SERVER_ERROR` |
 | `ServiceUnavailableException` | 503 | `SERVICE_UNAVAILABLE` |
+| `GatewayTimeoutException` | 504 | `GATEWAY_TIMEOUT` |
 | `ValidationException` | 400 | `VALIDATION_ERROR` |
 
-### `ApiResponseDto` (manual usage)
-
-```typescript
-import { ApiResponseDto } from 'nestjs-api-forge';
-
-ApiResponseDto.success(data, 'User fetched', 200, { path: '/users/1' });
-ApiResponseDto.created(data, 'User created');
-ApiResponseDto.noContent('Deleted');
-ApiResponseDto.error('Not found', 404, { code: 'NOT_FOUND' });
-```
-
 ---
 
 ## Usage Examples
 
-### Controller with custom message
+### Standard CRUD controller
 
 ```typescript
-import { Controller, Get, Param } from '@nestjs/common';
-import { ForgeMessage, NotFoundException } from 'nestjs-api-forge';
+import { Controller, Get, Post, Delete, Param, Body, HttpCode, HttpStatus } from '@nestjs/common';
+import { ForgeMessage, ForgeRawResponse, ForgeDeprecated, NotFoundException } from 'nestjs-api-forge';
 
 @Controller('users')
 export class UsersController {
   @Get(':id')
   @ForgeMessage('User fetched successfully')
-  findOne(@Param('id') id: string) {
-    const user = this.usersService.findById(+id);
+  findOne(@Param('id') id: number) {
+    const user = this.usersService.findById(id);
     if (!user) throw new NotFoundException('User');
     return user;
   }
+
+  @Delete(':id')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  remove(@Param('id') id: number) {
+    this.usersService.remove(id);
+  }
 }
 ```
 
-### Skip wrapping for a specific route
+### Deprecated route
+
+```typescript
+@Get('export')
+@ForgeDeprecated('Use POST /v2/users/export instead')
+@ForgeMessage('Export started')
+startExport() {
+  const job = this.usersService.queueExport();
+  return ApiResponseDto.accepted({ jobId: job.id }, 'Export queued');
+}
+```
+
+### Custom meta per route
+
+```typescript
+@Get()
+@ForgeMeta({ region: 'us-east-1', cache: 'miss' })
+findAll() {
+  return this.usersService.findAll();
+}
+```
+
+### Paginated list (raw response)
+
+```typescript
+@Get()
+@ForgeRawResponse()
+findAll(@Query('page') page = '1', @Query('limit') limit = '10') {
+  const p = parseInt(page, 10);
+  const l = parseInt(limit, 10);
+  const { data, total } = this.usersService.findAll(p, l);
+  return ApiResponseDto.paginated(data, total, p, l, 'Users fetched');
+}
+```
+
+### Per-controller scope (no global module)
+
+```typescript
+@Controller('products')
+@ApiForge({ version: '2.0', includeResponseTime: true })
+export class ProductsController { ... }
+```
+
+### Raw response (health check)
 
 ```typescript
 @Get('health')
 @ForgeRawResponse()
-healthCheck() {
-  return { status: 'ok' };
+health() {
+  return { status: 'ok', uptime: process.uptime() };
 }
 ```
 
-### Async module registration (with ConfigService)
+### Correlation ID tracing
+
+Send `X-Request-ID: abc-123` in the request — the same ID appears in `meta.requestId` and is echoed in the `X-Request-ID` response header. Useful for distributed tracing across microservices.
 
 ```typescript
-ApiForgeModule.forRootAsync({
-  imports: [ConfigModule],
-  inject: [ConfigService],
-  useFactory: (config: ConfigService) => ({
-    version: config.get('API_VERSION'),
-    defaultSuccessMessage: config.get('DEFAULT_SUCCESS_MSG'),
-  }),
+ApiForgeModule.forRoot({
+  correlationIdHeader: 'x-request-id',  // or an array of headers
+  includeRequestId: true,               // generate UUID if header is absent
 })
 ```
 
-### Use with `ValidationPipe`
+### Custom exception with field details
 
 ```typescript
-// main.ts
-app.useGlobalPipes(
-  new ValidationPipe({
-    whitelist: true,
-    forbidNonWhitelisted: true,
-    transform: true,
-  }),
-);
+throw new BadRequestException('Invalid input', [
+  { field: 'price', message: 'Must be a positive number', value: -5 },
+]);
+
+// From class-validator constraint map
+throw ValidationException.fromConstraints({
+  email: { isEmail: 'must be an email' },
+  age: { min: 'must be at least 1' },
+});
+```
+
+---
+
+## Peer Dependencies
+
 ```
+@nestjs/common  ^9 | ^10 | ^11
+@nestjs/core    ^9 | ^10 | ^11
+reflect-metadata ^0.1 | ^0.2
+rxjs            ^7
+```
+
+---
 
-The exception filter automatically parses `ValidationPipe` error arrays and formats them into `error.details`.
+## Changelog
+
+### 1.1.0
+- `ForgeValidationPipe` — structured validation errors with nested field support
+- `@ForgeMeta(extra)` decorator — merge custom fields into response meta
+- `@ForgeDeprecated(notice?)` decorator — deprecation flag in meta + response header
+- `ApiResponseDto.accepted()` — 202 helper
+- Correlation ID passthrough (`correlationIdHeader` option)
+- Response time measurement (`includeResponseTime` option)
+- `forRootAsync` fix — options factory now runs once instead of twice
+- 3 new exceptions: `MethodNotAllowedException`, `PaymentRequiredException`, `GatewayTimeoutException`
 
 ---
 

package/dist/api-forge.module.js

@@ -39,26 +39,30 @@ let ApiForgeModule = ApiForgeModule_1 = class ApiForgeModule {
         };
     }
     static forRootAsync(asyncOptions) {
+        const optionsProvider = {
+            provide: exports.FORGE_OPTIONS,
+            useFactory: asyncOptions.useFactory,
+            inject: asyncOptions.inject ?? [],
+        };
         const exceptionFilterProvider = {
             provide: core_1.APP_FILTER,
-            useFactory: async (...args) => {
-                const options = await asyncOptions.useFactory(...args);
-                return new global_exception_filter_1.ForgeExceptionFilter(options);
-            },
-            inject: asyncOptions.inject ?? [],
+            useFactory: (options) => new global_exception_filter_1.ForgeExceptionFilter(options),
+            inject: [exports.FORGE_OPTIONS],
         };
         const responseInterceptorProvider = {
             provide: core_1.APP_INTERCEPTOR,
-            useFactory: async (reflector, ...args) => {
-                const options = await asyncOptions.useFactory(...args);
-                return new response_interceptor_1.ForgeResponseInterceptor(reflector, options);
-            },
-            inject: [core_1.Reflector, ...(asyncOptions.inject ?? [])],
+            useFactory: (reflector, options) => new response_interceptor_1.ForgeResponseInterceptor(reflector, options),
+            inject: [core_1.Reflector, exports.FORGE_OPTIONS],
         };
         return {
             module: ApiForgeModule_1,
             imports: asyncOptions.imports ?? [],
-            providers: [exceptionFilterProvider, responseInterceptorProvider],
+            providers: [
+                optionsProvider,
+                exceptionFilterProvider,
+                responseInterceptorProvider,
+            ],
+            exports: [exports.FORGE_OPTIONS],
         };
     }
 };

package/dist/api-forge.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-forge.module.js","sourceRoot":"","sources":["../src/api-forge.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,uCAAsE;AACtE,+EAAyE;AACzE,8EAA+E;AAGlE,QAAA,aAAa,GAAG,eAAe,CAAC;AAItC,IAAM,cAAc,sBAApB,MAAM,cAAc;IAKzB,MAAM,CAAC,OAAO,CAAC,UAAwB,EAAE;QACvC,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,qBAAa;YACtB,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,MAAM,uBAAuB,GAAa;YACxC,OAAO,EAAE,iBAAU;YACnB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,8CAAoB,CAAC,OAAO,CAAC;SACpD,CAAC;QAEF,MAAM,2BAA2B,GAAa;YAC5C,OAAO,EAAE,sBAAe;YACxB,UAAU,EAAE,CAAC,SAAoB,EAAE,EAAE,CACnC,IAAI,+CAAwB,CAAC,SAAS,EAAE,OAAO,CAAC;YAClD,MAAM,EAAE,CAAC,gBAAS,CAAC;SACpB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE;gBACT,eAAe;gBACf,uBAAuB;gBACvB,2BAA2B;aAC5B;YACD,OAAO,EAAE,CAAC,qBAAa,CAAC;SACzB,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,YAAY,CAAC,YAInB;QACC,MAAM,uBAAuB,GAAa;YACxC,OAAO,EAAE,iBAAU;YACnB,UAAU,EAAE,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;gBACnC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;gBACvD,OAAO,IAAI,8CAAoB,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,EAAE;SAClC,CAAC;QAEF,MAAM,2BAA2B,GAAa;YAC5C,OAAO,EAAE,sBAAe;YACxB,UAAU,EAAE,KAAK,EAAE,SAAoB,EAAE,GAAG,IAAW,EAAE,EAAE;gBACzD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;gBACvD,OAAO,IAAI,+CAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,EAAE,CAAC,gBAAS,EAAE,GAAG,CAAC,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;SACpD,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,EAAE;YACnC,SAAS,EAAE,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;SAClE,CAAC;IACJ,CAAC;CACF,CAAA;AAlEY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CAkE1B"}
+{"version":3,"file":"api-forge.module.js","sourceRoot":"","sources":["../src/api-forge.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,uCAAsE;AACtE,+EAAyE;AACzE,8EAA+E;AAGlE,QAAA,aAAa,GAAG,eAAe,CAAC;AAItC,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,UAAwB,EAAE;QACvC,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,qBAAa;YACtB,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,MAAM,uBAAuB,GAAa;YACxC,OAAO,EAAE,iBAAU;YACnB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,8CAAoB,CAAC,OAAO,CAAC;SACpD,CAAC;QAEF,MAAM,2BAA2B,GAAa;YAC5C,OAAO,EAAE,sBAAe;YACxB,UAAU,EAAE,CAAC,SAAoB,EAAE,EAAE,CACnC,IAAI,+CAAwB,CAAC,SAAS,EAAE,OAAO,CAAC;YAClD,MAAM,EAAE,CAAC,gBAAS,CAAC;SACpB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE;gBACT,eAAe;gBACf,uBAAuB;gBACvB,2BAA2B;aAC5B;YACD,OAAO,EAAE,CAAC,qBAAa,CAAC;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,YAInB;QACC,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,qBAAa;YACtB,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,EAAE;SAClC,CAAC;QAEF,MAAM,uBAAuB,GAAa;YACxC,OAAO,EAAE,iBAAU;YACnB,UAAU,EAAE,CAAC,OAAqB,EAAE,EAAE,CAAC,IAAI,8CAAoB,CAAC,OAAO,CAAC;YACxE,MAAM,EAAE,CAAC,qBAAa,CAAC;SACxB,CAAC;QAEF,MAAM,2BAA2B,GAAa;YAC5C,OAAO,EAAE,sBAAe;YACxB,UAAU,EAAE,CAAC,SAAoB,EAAE,OAAqB,EAAE,EAAE,CAC1D,IAAI,+CAAwB,CAAC,SAAS,EAAE,OAAO,CAAC;YAClD,MAAM,EAAE,CAAC,gBAAS,EAAE,qBAAa,CAAC;SACnC,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,EAAE;YACnC,SAAS,EAAE;gBACT,eAAe;gBACf,uBAAuB;gBACvB,2BAA2B;aAC5B;YACD,OAAO,EAAE,CAAC,qBAAa,CAAC;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AAjEY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CAiE1B"}

package/dist/decorators/api-response.decorator.d.ts

@@ -1,6 +1,10 @@
 import { ForgeOptions } from '../interfaces/api-response.interface';
 export declare const FORGE_MESSAGE_KEY = "forge:response_message";
 export declare const FORGE_RAW_RESPONSE_KEY = "forge:raw_response";
+export declare const FORGE_META_KEY = "forge:extra_meta";
+export declare const FORGE_DEPRECATED_KEY = "forge:deprecated";
 export declare const ForgeMessage: (message: string) => import("@nestjs/common").CustomDecorator<string>;
 export declare const ForgeRawResponse: () => import("@nestjs/common").CustomDecorator<string>;
+export declare const ForgeMeta: (extra: Record<string, unknown>) => import("@nestjs/common").CustomDecorator<string>;
+export declare const ForgeDeprecated: (notice?: string) => import("@nestjs/common").CustomDecorator<string>;
 export declare function ApiForge(options?: ForgeOptions): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/dist/decorators/api-response.decorator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ForgeRawResponse = exports.ForgeMessage = exports.FORGE_RAW_RESPONSE_KEY = exports.FORGE_MESSAGE_KEY = void 0;
+exports.ForgeDeprecated = exports.ForgeMeta = exports.ForgeRawResponse = exports.ForgeMessage = exports.FORGE_DEPRECATED_KEY = exports.FORGE_META_KEY = exports.FORGE_RAW_RESPONSE_KEY = exports.FORGE_MESSAGE_KEY = void 0;
 exports.ApiForge = ApiForge;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
@@ -8,10 +8,16 @@ const response_interceptor_1 = require("../interceptors/response.interceptor");
 const global_exception_filter_1 = require("../filters/global-exception.filter");
 exports.FORGE_MESSAGE_KEY = 'forge:response_message';
 exports.FORGE_RAW_RESPONSE_KEY = 'forge:raw_response';
+exports.FORGE_META_KEY = 'forge:extra_meta';
+exports.FORGE_DEPRECATED_KEY = 'forge:deprecated';
 const ForgeMessage = (message) => (0, common_1.SetMetadata)(exports.FORGE_MESSAGE_KEY, message);
 exports.ForgeMessage = ForgeMessage;
 const ForgeRawResponse = () => (0, common_1.SetMetadata)(exports.FORGE_RAW_RESPONSE_KEY, true);
 exports.ForgeRawResponse = ForgeRawResponse;
+const ForgeMeta = (extra) => (0, common_1.SetMetadata)(exports.FORGE_META_KEY, extra);
+exports.ForgeMeta = ForgeMeta;
+const ForgeDeprecated = (notice) => (0, common_1.SetMetadata)(exports.FORGE_DEPRECATED_KEY, notice ?? true);
+exports.ForgeDeprecated = ForgeDeprecated;
 function ApiForge(options = {}) {
     const reflector = new core_1.Reflector();
     return (0, common_1.applyDecorators)((0, common_1.UseInterceptors)(new response_interceptor_1.ForgeResponseInterceptor(reflector, options)), (0, common_1.UseFilters)(new global_exception_filter_1.ForgeExceptionFilter(options)));

package/dist/decorators/api-response.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-response.decorator.js","sourceRoot":"","sources":["../../src/decorators/api-response.decorator.ts"],"names":[],"mappings":";;;AAoBA,4BAMC;AA1BD,2CAA2F;AAC3F,uCAAyC;AACzC,+EAAgF;AAChF,gFAA0E;AAG7D,QAAA,iBAAiB,GAAG,wBAAwB,CAAC;AAC7C,QAAA,sBAAsB,GAAG,oBAAoB,CAAC;AAGpD,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE,CAC9C,IAAA,oBAAW,EAAC,yBAAiB,EAAE,OAAO,CAAC,CAAC;AAD7B,QAAA,YAAY,gBACiB;AAGnC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,8BAAsB,EAAE,IAAI,CAAC,CAAC;AAAnE,QAAA,gBAAgB,oBAAmD;AAMhF,SAAgB,QAAQ,CAAC,UAAwB,EAAE;IACjD,MAAM,SAAS,GAAG,IAAI,gBAAS,EAAE,CAAC;IAClC,OAAO,IAAA,wBAAe,EACpB,IAAA,wBAAe,EAAC,IAAI,+CAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EACjE,IAAA,mBAAU,EAAC,IAAI,8CAAoB,CAAC,OAAO,CAAC,CAAC,CAC9C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"api-response.decorator.js","sourceRoot":"","sources":["../../src/decorators/api-response.decorator.ts"],"names":[],"mappings":";;;AA0CA,4BAMC;AAhDD,2CAA2F;AAC3F,uCAAyC;AACzC,+EAAgF;AAChF,gFAA0E;AAG7D,QAAA,iBAAiB,GAAG,wBAAwB,CAAC;AAC7C,QAAA,sBAAsB,GAAG,oBAAoB,CAAC;AAC9C,QAAA,cAAc,GAAG,kBAAkB,CAAC;AACpC,QAAA,oBAAoB,GAAG,kBAAkB,CAAC;AAGhD,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE,CAC9C,IAAA,oBAAW,EAAC,yBAAiB,EAAE,OAAO,CAAC,CAAC;AAD7B,QAAA,YAAY,gBACiB;AAGnC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,8BAAsB,EAAE,IAAI,CAAC,CAAC;AAAnE,QAAA,gBAAgB,oBAAmD;AAQzE,MAAM,SAAS,GAAG,CAAC,KAA8B,EAAE,EAAE,CAC1D,IAAA,oBAAW,EAAC,sBAAc,EAAE,KAAK,CAAC,CAAC;AADxB,QAAA,SAAS,aACe;AAU9B,MAAM,eAAe,GAAG,CAAC,MAAe,EAAE,EAAE,CACjD,IAAA,oBAAW,EAAC,4BAAoB,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;AADvC,QAAA,eAAe,mBACwB;AAMpD,SAAgB,QAAQ,CAAC,UAAwB,EAAE;IACjD,MAAM,SAAS,GAAG,IAAI,gBAAS,EAAE,CAAC;IAClC,OAAO,IAAA,wBAAe,EACpB,IAAA,wBAAe,EAAC,IAAI,+CAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EACjE,IAAA,mBAAU,EAAC,IAAI,8CAAoB,CAAC,OAAO,CAAC,CAAC,CAC9C,CAAC;AACJ,CAAC"}

package/dist/dto/api-response.dto.d.ts

@@ -2,6 +2,7 @@ import { ApiErrorPayload, ApiMeta, ApiSuccessResponse, ApiErrorResponse, ApiPagi
 export declare class ApiResponseDto {
     static success<T>(data: T, message?: string, statusCode?: number, meta?: Partial<ApiMeta>): ApiSuccessResponse<T>;
     static created<T>(data: T, message?: string, meta?: Partial<ApiMeta>): ApiSuccessResponse<T>;
+    static accepted<T>(data: T, message?: string, meta?: Partial<ApiMeta>): ApiSuccessResponse<T>;
     static noContent(message?: string, meta?: Partial<ApiMeta>): ApiSuccessResponse<null>;
     static paginated<T>(data: T[], total: number, page: number, limit: number, message?: string, meta?: Partial<ApiMeta>): ApiPaginatedResponse<T>;
     static error(message: string, statusCode: number, error: ApiErrorPayload, meta?: Partial<ApiMeta>): ApiErrorResponse;

package/dist/dto/api-response.dto.js

@@ -17,6 +17,9 @@ class ApiResponseDto {
     static created(data, message = 'Resource created successfully', meta = {}) {
         return ApiResponseDto.success(data, message, 201, meta);
     }
+    static accepted(data, message = 'Request accepted for processing', meta = {}) {
+        return ApiResponseDto.success(data, message, 202, meta);
+    }
     static noContent(message = 'No content', meta = {}) {
         return ApiResponseDto.success(null, message, 204, meta);
     }

package/dist/dto/api-response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-response.dto.js","sourceRoot":"","sources":["../../src/dto/api-response.dto.ts"],"names":[],"mappings":";;;AASA,MAAa,cAAc;IACzB,MAAM,CAAC,OAAO,CACZ,IAAO,EACP,OAAO,GAAG,oBAAoB,EAC9B,UAAU,GAAG,GAAG,EAChB,OAAyB,EAAE;QAE3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU;YACV,OAAO;YACP,IAAI;YACJ,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CACZ,IAAO,EACP,OAAO,GAAG,+BAA+B,EACzC,OAAyB,EAAE;QAE3B,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,SAAS,CACd,OAAO,GAAG,YAAY,EACtB,OAAyB,EAAE;QAE3B,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,SAAS,CACd,IAAS,EACT,KAAa,EACb,IAAY,EACZ,KAAa,EACb,OAAO,GAAG,2BAA2B,EACrC,OAAyB,EAAE;QAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAmB;YACjC,KAAK;YACL,IAAI;YACJ,KAAK;YACL,UAAU;YACV,WAAW,EAAE,IAAI,GAAG,UAAU;YAC9B,WAAW,EAAE,IAAI,GAAG,CAAC;SACtB,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,GAAG;YACf,OAAO;YACP,IAAI;YACJ,UAAU;YACV,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CACV,OAAe,EACf,UAAkB,EAClB,KAAsB,EACtB,OAAyB,EAAE;QAE3B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU;YACV,OAAO;YACP,KAAK;YACL,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR;SACF,CAAC;IACJ,CAAC;CACF;AAlFD,wCAkFC"}
+{"version":3,"file":"api-response.dto.js","sourceRoot":"","sources":["../../src/dto/api-response.dto.ts"],"names":[],"mappings":";;;AASA,MAAa,cAAc;IACzB,MAAM,CAAC,OAAO,CACZ,IAAO,EACP,OAAO,GAAG,oBAAoB,EAC9B,UAAU,GAAG,GAAG,EAChB,OAAyB,EAAE;QAE3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU;YACV,OAAO;YACP,IAAI;YACJ,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CACZ,IAAO,EACP,OAAO,GAAG,+BAA+B,EACzC,OAAyB,EAAE;QAE3B,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,QAAQ,CACb,IAAO,EACP,OAAO,GAAG,iCAAiC,EAC3C,OAAyB,EAAE;QAE3B,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,SAAS,CACd,OAAO,GAAG,YAAY,EACtB,OAAyB,EAAE;QAE3B,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,SAAS,CACd,IAAS,EACT,KAAa,EACb,IAAY,EACZ,KAAa,EACb,OAAO,GAAG,2BAA2B,EACrC,OAAyB,EAAE;QAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAmB;YACjC,KAAK;YACL,IAAI;YACJ,KAAK;YACL,UAAU;YACV,WAAW,EAAE,IAAI,GAAG,UAAU;YAC9B,WAAW,EAAE,IAAI,GAAG,CAAC;SACtB,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,GAAG;YACf,OAAO;YACP,IAAI;YACJ,UAAU;YACV,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CACV,OAAe,EACf,UAAkB,EAClB,KAAsB,EACtB,OAAyB,EAAE;QAE3B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU;YACV,OAAO;YACP,KAAK;YACL,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR;SACF,CAAC;IACJ,CAAC;CACF;AA1FD,wCA0FC"}

package/dist/exceptions/api.exception.d.ts

@@ -32,3 +32,12 @@ export declare class InternalServerException extends ApiException {
 export declare class ServiceUnavailableException extends ApiException {
     constructor(message?: string);
 }
+export declare class MethodNotAllowedException extends ApiException {
+    constructor(message?: string);
+}
+export declare class PaymentRequiredException extends ApiException {
+    constructor(message?: string);
+}
+export declare class GatewayTimeoutException extends ApiException {
+    constructor(message?: string);
+}

package/dist/exceptions/api.exception.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceUnavailableException = exports.InternalServerException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.ApiException = void 0;
+exports.GatewayTimeoutException = exports.PaymentRequiredException = exports.MethodNotAllowedException = exports.ServiceUnavailableException = exports.InternalServerException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.ApiException = void 0;
 const common_1 = require("@nestjs/common");
 class ApiException extends common_1.HttpException {
     constructor(message, statusCode, code, details) {
@@ -64,4 +64,22 @@ class ServiceUnavailableException extends ApiException {
     }
 }
 exports.ServiceUnavailableException = ServiceUnavailableException;
+class MethodNotAllowedException extends ApiException {
+    constructor(message = 'Method not allowed') {
+        super(message, common_1.HttpStatus.METHOD_NOT_ALLOWED, 'METHOD_NOT_ALLOWED');
+    }
+}
+exports.MethodNotAllowedException = MethodNotAllowedException;
+class PaymentRequiredException extends ApiException {
+    constructor(message = 'Payment required') {
+        super(message, common_1.HttpStatus.PAYMENT_REQUIRED, 'PAYMENT_REQUIRED');
+    }
+}
+exports.PaymentRequiredException = PaymentRequiredException;
+class GatewayTimeoutException extends ApiException {
+    constructor(message = 'Gateway timeout') {
+        super(message, common_1.HttpStatus.GATEWAY_TIMEOUT, 'GATEWAY_TIMEOUT');
+    }
+}
+exports.GatewayTimeoutException = GatewayTimeoutException;
 //# sourceMappingURL=api.exception.js.map

package/dist/exceptions/api.exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.exception.js","sourceRoot":"","sources":["../../src/exceptions/api.exception.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAG3D,MAAa,YAAa,SAAQ,sBAAa;IAC7C,YACE,OAAe,EACf,UAAsB,EACN,IAAY,EACZ,OAA0B;QAE1C,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;QAH9B,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAmB;IAG5C,CAAC;CACF;AATD,oCASC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAO,GAAG,aAAa,EAAE,OAA0B;QAC7D,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF;AAJD,kDAIC;AAED,MAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAO,GAAG,cAAc;QAClC,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC1D,CAAC;CACF;AAJD,sDAIC;AAED,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAJD,gDAIC;AAED,MAAa,iBAAkB,SAAQ,YAAY;IACjD,YAAY,QAAQ,GAAG,UAAU;QAC/B,KAAK,CAAC,GAAG,QAAQ,YAAY,EAAE,mBAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;CACF;AAJD,8CAIC;AAED,MAAa,iBAAkB,SAAQ,YAAY;IACjD,YAAY,OAAO,GAAG,yBAAyB;QAC7C,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;CACF;AAJD,8CAIC;AAED,MAAa,4BAA6B,SAAQ,YAAY;IAC5D,YAAY,OAAO,GAAG,sBAAsB,EAAE,OAA0B;QACtE,KAAK,CACH,OAAO,EACP,mBAAU,CAAC,oBAAoB,EAC/B,sBAAsB,EACtB,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AATD,oEASC;AAED,MAAa,wBAAyB,SAAQ,YAAY;IACxD,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;IACpE,CAAC;CACF;AAJD,4DAIC;AAED,MAAa,uBAAwB,SAAQ,YAAY;IACvD,YAAY,OAAO,GAAG,uBAAuB;QAC3C,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,qBAAqB,EAAE,uBAAuB,CAAC,CAAC;IAC5E,CAAC;CACF;AAJD,0DAIC;AAED,MAAa,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,OAAO,GAAG,qBAAqB;QACzC,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;IACxE,CAAC;CACF;AAJD,kEAIC"}
+{"version":3,"file":"api.exception.js","sourceRoot":"","sources":["../../src/exceptions/api.exception.ts"],"names":[],"mappings":"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"}

package/dist/filters/global-exception.filter.d.ts

@@ -5,6 +5,7 @@ export declare class ForgeExceptionFilter implements ExceptionFilter {
     private readonly logger;
     constructor(options?: ForgeOptions);
     catch(exception: unknown, host: ArgumentsHost): void;
+    private resolveRequestId;
     private buildMeta;
     private buildErrorResponse;
     private extractHttpExceptionMessage;