@tndhuy/create-app 1.2.9 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tndhuy/create-app",
-  "version": "1.2.9",
+  "version": "1.3.0",
   "private": false,
   "bin": {
     "create-app": "dist/cli.js"

package/templates/mongo/src/common/decorators/standard-response.decorator.ts

@@ -0,0 +1,9 @@
+import { SetMetadata } from '@nestjs/common';
+
+export const STANDARD_RESPONSE_KEY = 'standard_response';
+
+/**
+ * Decorator to wrap the response in a standardized envelope:
+ * { success: true, data: T, meta?: PaginationMeta }
+ */
+export const StandardResponse = () => SetMetadata(STANDARD_RESPONSE_KEY, true);

package/templates/mongo/src/common/index.ts

@@ -2,4 +2,5 @@ export * from './filters/http-exception.filter';
 export * from './interceptors/transform.interceptor';
 export * from './interceptors/timeout.interceptor';
 export * from './decorators/raw-response.decorator';
+export * from './decorators/standard-response.decorator';
 export * from './middleware/correlation-id.middleware';

package/templates/mongo/src/common/interceptors/transform.interceptor.ts

@@ -2,7 +2,7 @@ import { CallHandler, ExecutionContext, Injectable, NestInterceptor } from '@nes
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import { map } from 'rxjs/operators';
-import { PUBLIC_API_KEY } from '../decorators/public-api.decorator';
+import { STANDARD_RESPONSE_KEY } from '../decorators/standard-response.decorator';
 
 export const RAW_RESPONSE_KEY = 'raw_response';
 
@@ -20,18 +20,17 @@ export class TransformInterceptor<T> implements NestInterceptor<T, unknown> {
       return next.handle();
     }
 
-    const isPublic = this.reflector.getAllAndOverride<boolean>(PUBLIC_API_KEY, [
+    const useStandard = this.reflector.getAllAndOverride<boolean>(STANDARD_RESPONSE_KEY, [
       context.getHandler(),
       context.getClass(),
     ]);
 
-    // If not explicitly marked as Public API (or similar decorator), return RAW data
-    // This allows internal/system calls to remain untouched while Public APIs are standardized.
-    if (!isPublic) {
+    // Internal first: If not explicitly marked for Standard Response, return RAW data
+    if (!useStandard) {
       return next.handle();
     }
 
-    // Public API: Wrap response in a standardized success object
+    // Standard Response: Wrap response in a standardized success object
     return next.handle().pipe(
       map((data) => {
         // Handle paginated results: { items: [], meta: {} }

package/templates/mongo/src/modules/example/presenter/item.controller.ts

@@ -1,7 +1,7 @@
 import { Body, Controller, Delete, Get, Param, Post, Query } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiResponse, ApiParam } from '@nestjs/swagger';
 import { CommandBus, QueryBus } from '@nestjs/cqrs';
-import { PublicApi } from '../../../common/decorators/public-api.decorator';
+import { StandardResponse } from '../../../common/decorators/standard-response.decorator';
 import { CreateItemDto } from '../application/dtos/create-item.dto';
 import { ItemResponseDto } from '../application/dtos/item.response.dto';
 import { CreateItemCommand } from '../application/commands/create-item.command';
@@ -11,7 +11,7 @@ import { ListItemsQuery } from '../application/queries/list-items.query';
 import { PaginationDto } from '../../../shared';
 
 @ApiTags('example')
-@PublicApi()
+@StandardResponse()
 @Controller('items')
 export class ItemController {
   constructor(

package/templates/postgres/src/common/decorators/standard-response.decorator.ts

@@ -0,0 +1,9 @@
+import { SetMetadata } from '@nestjs/common';
+
+export const STANDARD_RESPONSE_KEY = 'standard_response';
+
+/**
+ * Decorator to wrap the response in a standardized envelope:
+ * { success: true, data: T, meta?: PaginationMeta }
+ */
+export const StandardResponse = () => SetMetadata(STANDARD_RESPONSE_KEY, true);

package/templates/postgres/src/common/index.ts

@@ -2,4 +2,5 @@ export * from './filters/http-exception.filter';
 export * from './interceptors/transform.interceptor';
 export * from './interceptors/timeout.interceptor';
 export * from './decorators/raw-response.decorator';
+export * from './decorators/standard-response.decorator';
 export * from './middleware/correlation-id.middleware';

package/templates/postgres/src/common/interceptors/transform.interceptor.ts

@@ -2,7 +2,7 @@ import { CallHandler, ExecutionContext, Injectable, NestInterceptor } from '@nes
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import { map } from 'rxjs/operators';
-import { PUBLIC_API_KEY } from '../decorators/public-api.decorator';
+import { STANDARD_RESPONSE_KEY } from '../decorators/standard-response.decorator';
 
 export const RAW_RESPONSE_KEY = 'raw_response';
 
@@ -20,18 +20,17 @@ export class TransformInterceptor<T> implements NestInterceptor<T, unknown> {
       return next.handle();
     }
 
-    const isPublic = this.reflector.getAllAndOverride<boolean>(PUBLIC_API_KEY, [
+    const useStandard = this.reflector.getAllAndOverride<boolean>(STANDARD_RESPONSE_KEY, [
       context.getHandler(),
       context.getClass(),
     ]);
 
-    // If not explicitly marked as Public API (or similar decorator), return RAW data
-    // This allows internal/system calls to remain untouched while Public APIs are standardized.
-    if (!isPublic) {
+    // Internal first: If not explicitly marked for Standard Response, return RAW data
+    if (!useStandard) {
       return next.handle();
     }
 
-    // Public API: Wrap response in a standardized success object
+    // Standard Response: Wrap response in a standardized success object
     return next.handle().pipe(
       map((data) => {
         // Handle paginated results: { items: [], meta: {} }

package/templates/postgres/src/modules/example/presenter/item.controller.ts

@@ -1,7 +1,7 @@
 import { Body, Controller, Delete, Get, Param, Post, Query } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiResponse, ApiParam } from '@nestjs/swagger';
 import { CommandBus, QueryBus } from '@nestjs/cqrs';
-import { PublicApi } from '../../../common/decorators/public-api.decorator';
+import { StandardResponse } from '../../../common/decorators/standard-response.decorator';
 import { CreateItemDto } from '../application/dtos/create-item.dto';
 import { ItemResponseDto } from '../application/dtos/item.response.dto';
 import { CreateItemCommand } from '../application/commands/create-item.command';
@@ -11,7 +11,7 @@ import { ListItemsQuery } from '../application/queries/list-items.query';
 import { PaginationDto } from '../../../shared';
 
 @ApiTags('example')
-@PublicApi()
+@StandardResponse()
 @Controller('items')
 export class ItemController {
   constructor(

package/templates/mongo/src/common/decorators/public-api.decorator.ts

@@ -1,9 +0,0 @@
-import { SetMetadata } from '@nestjs/common';
-
-export const PUBLIC_API_KEY = 'public_api';
-/**
- * Decorator to mark an endpoint as Public API.
- * This will trigger the TransformInterceptor to wrap the response in { success: true, data: T }.
- * Without this decorator, the response remains raw.
- */
-export const PublicApi = () => SetMetadata(PUBLIC_API_KEY, true);

package/templates/postgres/src/common/decorators/public-api.decorator.ts

@@ -1,9 +0,0 @@
-import { SetMetadata } from '@nestjs/common';
-
-export const PUBLIC_API_KEY = 'public_api';
-/**
- * Decorator to mark an endpoint as Public API.
- * This will trigger the TransformInterceptor to wrap the response in { success: true, data: T }.
- * Without this decorator, the response remains raw.
- */
-export const PublicApi = () => SetMetadata(PUBLIC_API_KEY, true);