ts-deco 1.0.15 → 1.0.18

package/README.md

@@ -1,8 +1,10 @@
 # ts-deco
 
-TypeScript decorator utilities with **strict validation standards**
+**검증과 Swagger 작성을 동시에 처리하는 함축적인 데코레이터 라이브러리**
 
-엄격한 타입 검증과 검증 규칙을 제공하는 Node.js/TypeScript용 DTO 데코레이터 라이브러리입니다.
+TypeScript decorator utilities with **strict validation standards** and **automatic Swagger documentation**
+
+하나의 데코레이터로 **타입 검증과 Swagger API 문서화를 동시에** 처리하는 Node.js/TypeScript용 DTO 데코레이터 라이브러리입니다. **NestJS**와 **Node.js (Express, Fastify 등)** 모든 프로젝트에서 사용할 수 있습니다.
 
 ## 설치
 
@@ -12,6 +14,49 @@ npm install ts-deco
 
 ## 빠른 시작
 
+**`Property` 데코레이터 하나로 검증과 Swagger 문서 작성을 동시에** 처리할 수 있습니다:
+
+### NestJS에서 사용
+
+```typescript
+import { Property } from 'ts-deco';
+
+class CreateUserDto {
+  @Property({ type: String, optional: false })
+  name: string;
+
+  @Property({ type: Number, min: 0, max: 120, optional: false })
+  age: number;
+}
+
+// NestJS Controller에서 자동으로 Swagger 문서 생성 및 검증 수행
+@Post()
+create(@Body() dto: CreateUserDto) {
+  // 자동 검증 완료, Swagger 문서에 자동 반영
+}
+```
+
+### Node.js/Express에서 사용
+
+```typescript
+import { Property } from 'ts-deco';
+
+class CreateUserDto {
+  @Property({ type: String, optional: false })
+  name: string;
+
+  @Property({ type: Number, min: 0, max: 120, optional: false })
+  age: number;
+}
+
+// Express 라우트에서 검증 및 Swagger 문서 생성
+app.post('/users', validationMiddleware(CreateUserDto), (req, res) => {
+  // 자동 검증 완료, Swagger 문서에 자동 반영
+});
+```
+
+### 기본 사용법
+
 `Property` 데코레이터 하나로 모든 타입을 처리할 수 있습니다:
 
 ```typescript
@@ -37,9 +82,18 @@ class CreateUserDto {
 
 ## 주요 기능
 
+### ⚡ 하나의 데코레이터로 검증 + Swagger 문서화
+
+**`Property` 데코레이터는 타입에 따라 자동으로 적절한 검증을 적용하고, 동시에 Swagger API 문서를 자동 생성합니다.**
+
+- ✅ **검증**: `class-validator`를 사용한 런타임 타입 검증
+- ✅ **Swagger**: `@nestjs/swagger` 호환 메타데이터로 자동 API 문서 생성
+- ✅ **함축적**: 하나의 데코레이터로 두 가지 작업을 동시에 처리
+- ✅ **호환성**: NestJS와 Node.js (Express, Fastify 등) 모두 지원
+
 ### Property 데코레이터 (권장)
 
-`Property` 데코레이터는 타입에 따라 자동으로 적절한 검증을 적용합니다.
+`Property` 데코레이터는 타입에 따라 자동으로 적절한 검증과 Swagger 스키마를 적용합니다.
 
 #### 기본 타입
 
@@ -204,6 +258,131 @@ class UserDto {
 - **DtoBoolean**: `optional`, `isNotEmpty`, `isArray`, `validatorMessage`, `notEmptyMessage`, `arrayMessage` 및 Swagger 옵션
 - **DtoEnum**: `optional`, `isNotEmpty`, `isArray`, `exclude`, `validatorMessage`, `notEmptyMessage`, `arrayMessage` 및 Swagger 옵션
 
+## Controller 데코레이터 (NestJS 스타일)
+
+**검증과 Swagger 문서 작성을 동시에 처리하는 DTO 데코레이터** 외에도, **API 엔드포인트의 Swagger 문서를 자동 생성하는 Controller 데코레이터**를 제공합니다.
+
+### 사용 예제
+
+#### NestJS에서 사용
+
+```typescript
+import { ApiTags, ApiOperation, ApiResponse, ApiParam, ApiBody, ApiQuery } from 'ts-deco';
+
+@ApiTags('Users')
+@Controller('users')
+export class UserController {
+  @ApiOperation({ summary: '사용자 생성' })
+  @ApiResponse({ status: 200, description: '사용자 생성 성공' })
+  @ApiResponse({ status: 400, description: 'Validation 실패' })
+  @ApiBody({ type: CreateUserDto, required: true })
+  @Post()
+  create(@Body() dto: CreateUserDto) {
+    // ...
+  }
+
+  @ApiOperation({ summary: '사용자 업데이트' })
+  @ApiResponse({ status: 200, description: '사용자 업데이트 성공' })
+  @ApiParam({ name: 'id', type: String, required: true })
+  @ApiBody({ type: UpdateUserDto, required: true })
+  @Patch(':id')
+  update(@Param('id') id: string, @Body() dto: UpdateUserDto) {
+    // ...
+  }
+
+  @ApiOperation({ summary: '사용자 목록 조회' })
+  @ApiQuery({ name: 'page', type: Number, required: false, minimum: 1 })
+  @ApiQuery({ name: 'limit', type: Number, required: false, minimum: 1, maximum: 100 })
+  @Get()
+  findAll(@Query('page') page?: number, @Query('limit') limit?: number) {
+    // ...
+  }
+}
+```
+
+#### Node.js/Express에서 사용
+
+```typescript
+import { ApiTags, ApiOperation, ApiResponse, ApiParam, ApiBody, ApiQuery } from 'ts-deco';
+
+class UserRoutes {
+  @ApiTags('Users')
+  @ApiOperation({ summary: '사용자 생성' })
+  @ApiResponse({ status: 200, description: '사용자 생성 성공' })
+  @ApiResponse({ status: 400, description: 'Validation 실패' })
+  @ApiBody({ type: CreateUserDto, required: true })
+  static createUser(req: Request, res: Response) {
+    // ...
+  }
+
+  @ApiTags('Users')
+  @ApiOperation({ summary: '사용자 업데이트' })
+  @ApiResponse({ status: 200, description: '사용자 업데이트 성공' })
+  @ApiParam({ name: 'id', type: String, required: true })
+  @ApiBody({ type: UpdateUserDto, required: true })
+  static updateUser(req: Request, res: Response) {
+    // ...
+  }
+}
+
+app.post('/api/users', validationMiddleware(CreateUserDto), UserRoutes.createUser);
+app.patch('/api/users/:id', validationMiddleware(UpdateUserDto), UserRoutes.updateUser);
+```
+
+### Controller 데코레이터 목록
+
+#### ApiTags
+클래스 또는 메서드에 Swagger 태그를 설정합니다.
+
+```typescript
+@ApiTags('Users')
+@ApiTags('Admin', 'Users')  // 여러 태그
+```
+
+#### ApiOperation
+메서드에 Swagger 작업(operation) 정보를 설정합니다.
+
+```typescript
+@ApiOperation({
+  summary: '사용자 생성',
+  description: '새로운 사용자를 생성합니다',
+  operationId: 'createUser',
+  deprecated: false,
+  tags: ['Users']
+})
+```
+
+#### ApiResponse
+메서드에 Swagger 응답 정보를 설정합니다. 여러 번 사용 가능합니다.
+
+```typescript
+@ApiResponse({ status: 200, description: '성공' })
+@ApiResponse({ status: 400, description: 'Validation 실패' })
+@ApiResponse({ status: 404, description: '사용자를 찾을 수 없음' })
+```
+
+#### ApiParam
+경로 파라미터에 대한 Swagger 정보를 설정합니다.
+
+```typescript
+@ApiParam({ name: 'id', type: String, required: true, description: '사용자 ID' })
+```
+
+#### ApiQuery
+쿼리 파라미터에 대한 Swagger 정보를 설정합니다.
+
+```typescript
+@ApiQuery({ name: 'page', type: Number, required: false, minimum: 1 })
+@ApiQuery({ name: 'limit', type: Number, required: false, minimum: 1, maximum: 100 })
+```
+
+#### ApiBody
+요청 본문에 대한 Swagger 정보를 설정합니다.
+
+```typescript
+@ApiBody({ type: CreateUserDto, description: '사용자 생성 데이터' })
+```
+
 ## Property 데코레이터 옵션
 
 ### 공통 옵션
@@ -235,9 +414,25 @@ class UserDto {
 |------|------|--------|------|
 | `exclude` | `any[]` | `[]` | 제외할 enum 값들 |
 
-### Swagger 옵션 (선택적)
+### Swagger 옵션 (자동 생성)
+
+**`Property` 데코레이터는 자동으로 Swagger API 문서를 생성합니다.** `@nestjs/swagger`의 `ApiPropertyOptions`를 모두 사용할 수 있어 NestJS와 완벽하게 호환됩니다:
+
+#### 검증 + Swagger 자동 생성 예제
 
-Swagger API 문서화를 사용하는 경우, `@nestjs/swagger`의 `ApiPropertyOptions`를 모두 사용할 수 있습니다:
+```typescript
+@Property({ 
+  type: String,
+  description: '사용자 이름',  // Swagger 문서에 표시
+  example: '홍길동',           // Swagger 문서에 표시
+  optional: false              // 검증 규칙 + Swagger required
+})
+name: string;
+```
+
+이렇게 작성하면:
+- ✅ **검증**: `name`이 필수이며 문자열이어야 함
+- ✅ **Swagger**: API 문서에 `name` 필드가 필수 문자열로 자동 등록됨
 
 ```typescript
 @Property({ 
@@ -350,6 +545,43 @@ class PostDto {
 4. 타입 검증 (IsString, IsNumber, IsDate, IsBoolean, IsEnum 등)
 5. 추가 검증 (min/max, exclude 등)
 
+## 왜 ts-deco를 사용해야 할까요?
+
+### 🎯 검증과 Swagger 작성을 한 번에
+
+기존에는 검증 데코레이터와 Swagger 데코레이터를 따로 작성해야 했습니다:
+
+```typescript
+// 기존 방식 (번거로움)
+@IsString()
+@IsNotEmpty()
+@ApiProperty({ type: String, description: '사용자 이름', example: '홍길동' })
+name: string;
+```
+
+**ts-deco를 사용하면 하나의 데코레이터로 처리합니다:**
+
+```typescript
+// ts-deco 방식 (간결함)
+@Property({ 
+  type: String, 
+  optional: false, 
+  isNotEmpty: true,
+  description: '사용자 이름',
+  example: '홍길동'
+})
+name: string;
+```
+
+### 🌟 주요 장점
+
+- ✅ **함축적**: 하나의 데코레이터로 검증과 Swagger 문서화 동시 처리
+- ✅ **간결함**: 코드 중복 제거, 가독성 향상
+- ✅ **타입 안전성**: 엄격한 타입 체크로 컴파일 타임 에러 방지
+- ✅ **자동 문서화**: Swagger API 문서 자동 생성
+- ✅ **호환성**: NestJS와 Node.js (Express, Fastify 등) 모두 지원
+- ✅ **런타임 안정성**: 명확한 에러 메시지 제공
+
 ## 엄격한 검증 규칙
 
 `ts-deco`는 다음과 같은 엄격한 검증 규칙을 적용합니다:
@@ -358,6 +590,7 @@ class PostDto {
 - ✅ **명시적 검증**: 옵션과 검증 규칙이 명확하게 정의되어 있습니다
 - ✅ **일관된 동작**: 모든 데코레이터가 동일한 기준으로 동작합니다
 - ✅ **런타임 안정성**: 잘못된 타입이나 값에 대해 명확한 에러를 제공합니다
+- ✅ **자동 문서화**: 검증 규칙이 Swagger 문서에 자동으로 반영됩니다
 
 ### 검증 규칙
 
@@ -388,8 +621,16 @@ class PostDto {
 
 > **참고**: 
 > - 별도로 설치할 필요 없이 `npm install ts-deco`만 실행하면 모든 의존성이 자동으로 설치됩니다.
-> - **이 라이브러리는 NestJS에 종속되지 않습니다.** `class-validator`와 `class-transformer`는 독립적인 라이브러리이며, 모든 Node.js/TypeScript 프로젝트에서 사용할 수 있습니다.
+> - **이 라이브러리는 NestJS에 종속되지 않습니다.** `class-validator`와 `class-transformer`는 독립적인 라이브러리이며, **NestJS와 Node.js (Express, Fastify 등) 모든 프로젝트에서 사용할 수 있습니다.**
 > - `@nestjs/swagger`는 Swagger API 문서화 기능을 사용할 때만 필요합니다. 문서화 기능을 사용하지 않더라도 검증 기능은 정상적으로 동작합니다.
+> - **하나의 데코레이터로 검증과 Swagger 문서 작성을 동시에 처리**하므로 코드 중복을 줄이고 유지보수를 쉽게 만듭니다.
+
+## 지원 환경
+
+- ✅ **NestJS**: 완벽한 호환성, NestJS 프로젝트에서 바로 사용 가능
+- ✅ **Node.js**: Express, Fastify 등 모든 Node.js 프레임워크에서 사용 가능
+- ✅ **TypeScript**: TypeScript 프로젝트 필수 (타입 안전성 보장)
+- ✅ **Swagger**: 자동 API 문서 생성 지원
 
 ## 라이선스
 

package/dist/app/app.d.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+import express from 'express';
+declare const app: express.Express;
+export default app;
+//# sourceMappingURL=app.d.ts.map

package/dist/app/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../app/app.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,OAAoB,MAAM,SAAS,CAAC;AAsH3C,QAAA,MAAM,GAAG,iBAAc,CAAC;AAwCxB,eAAe,GAAG,CAAC"}

package/dist/app/app.js

@@ -0,0 +1,181 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const express_1 = __importDefault(require("express"));
+const configs_1 = require("../src/configs");
+const controllerModule = __importStar(require("./routers"));
+const env_config_1 = require("./config/env.config");
+const logger_middleware_1 = require("./middleware/logger.middleware");
+const error_handler_middleware_1 = require("./middleware/error-handler.middleware");
+const not_found_middleware_1 = require("./middleware/not-found.middleware");
+// 선택적 의존성 (설치되어 있으면 사용)
+let helmet;
+let cors;
+let compression;
+try {
+    helmet = require('helmet');
+}
+catch (e) {
+    console.warn('helmet 패키지가 설치되지 않았습니다. 보안 헤더가 적용되지 않습니다.');
+}
+try {
+    cors = require('cors');
+}
+catch (e) {
+    console.warn('cors 패키지가 설치되지 않았습니다. CORS가 적용되지 않습니다.');
+}
+try {
+    compression = require('compression');
+}
+catch (e) {
+    console.warn('compression 패키지가 설치되지 않았습니다. 압축이 적용되지 않습니다.');
+}
+/**
+ * Express 앱 생성 및 설정
+ */
+function createApp() {
+    const app = (0, express_1.default)();
+    // Trust proxy (리버스 프록시 사용 시)
+    app.set('trust proxy', true);
+    // 보안 미들웨어 (선택적)
+    if (helmet) {
+        app.use(helmet({
+            contentSecurityPolicy: env_config_1.env.NODE_ENV === 'production',
+            crossOriginEmbedderPolicy: false,
+        }));
+    }
+    // CORS 설정 (선택적)
+    if (cors) {
+        app.use(cors({
+            origin: env_config_1.env.CORS_ORIGIN === '*' ? true : env_config_1.env.CORS_ORIGIN.split(','),
+            credentials: true,
+            methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
+            allowedHeaders: ['Content-Type', 'Authorization', 'X-Request-ID'],
+        }));
+    }
+    // 압축 미들웨어 (선택적)
+    if (compression) {
+        app.use(compression());
+    }
+    // Body 파싱 미들웨어
+    app.use(express_1.default.json({ limit: '10mb' }));
+    app.use(express_1.default.urlencoded({ extended: true, limit: '10mb' }));
+    // 요청 로깅 미들웨어
+    app.use(logger_middleware_1.loggerMiddleware);
+    // Swagger 및 API 라우트 설정
+    if (env_config_1.env.SWAGGER_ENABLED) {
+        (0, configs_1.setupApp)({
+            app,
+            controllers: controllerModule,
+            swagger: {
+                title: 'API Documentation',
+                version: env_config_1.env.API_VERSION,
+                description: 'RESTful API with custom decorators',
+                servers: [
+                    {
+                        url: `http://localhost:${env_config_1.env.PORT}`,
+                        description: '로컬 개발 서버',
+                    },
+                    {
+                        url: `https://api.example.com`,
+                        description: '프로덕션 서버',
+                    },
+                ],
+            },
+            swaggerPath: env_config_1.env.SWAGGER_PATH,
+        });
+    }
+    else {
+        // Swagger 없이 라우트만 등록
+        const { autoRegisterRoutes } = require('../src/configs');
+        autoRegisterRoutes(app, controllerModule);
+    }
+    // Health check (Swagger 설정 전에 등록)
+    app.get('/health', (req, res) => {
+        res.json({
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+            uptime: process.uptime(),
+            environment: env_config_1.env.NODE_ENV,
+        });
+    });
+    // 에러 핸들링 미들웨어 (모든 라우트 이후)
+    app.use(error_handler_middleware_1.errorHandlerMiddleware);
+    // 404 핸들러 (모든 라우트 이후, 에러 핸들러 이전)
+    app.use(not_found_middleware_1.notFoundMiddleware);
+    return app;
+}
+// 앱 인스턴스 생성
+const app = createApp();
+// 서버 시작
+function startServer() {
+    const server = app.listen(env_config_1.env.PORT, () => {
+        console.log('='.repeat(50));
+        console.log(`🚀 Server is running`);
+        console.log(`📍 Environment: ${env_config_1.env.NODE_ENV}`);
+        console.log(`🌐 Port: ${env_config_1.env.PORT}`);
+        console.log(`📚 API Version: ${env_config_1.env.API_VERSION}`);
+        if (env_config_1.env.SWAGGER_ENABLED) {
+            console.log(`📖 Swagger UI: http://localhost:${env_config_1.env.PORT}${env_config_1.env.SWAGGER_PATH}`);
+        }
+        console.log(`❤️  Health Check: http://localhost:${env_config_1.env.PORT}/health`);
+        console.log('='.repeat(50));
+    });
+    // Graceful shutdown
+    process.on('SIGTERM', () => {
+        console.log('SIGTERM signal received: closing HTTP server');
+        server.close(() => {
+            console.log('HTTP server closed');
+            process.exit(0);
+        });
+    });
+    process.on('SIGINT', () => {
+        console.log('SIGINT signal received: closing HTTP server');
+        server.close(() => {
+            console.log('HTTP server closed');
+            process.exit(0);
+        });
+    });
+}
+// 직접 실행 시에만 서버 시작
+if (require.main === module) {
+    startServer();
+}
+exports.default = app;
+//# sourceMappingURL=app.js.map

package/dist/app/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../app/app.ts"],"names":[],"mappings":"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"}

package/dist/app/config/env.config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 환경 변수 설정
+ */
+export declare const env: {
+    readonly NODE_ENV: string;
+    readonly PORT: number;
+    readonly API_VERSION: string;
+    readonly API_PREFIX: string;
+    readonly SWAGGER_ENABLED: boolean;
+    readonly SWAGGER_PATH: string;
+    readonly CORS_ORIGIN: string;
+    readonly LOG_LEVEL: string;
+};
+//# sourceMappingURL=env.config.d.ts.map

package/dist/app/config/env.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.config.d.ts","sourceRoot":"","sources":["../../../app/config/env.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;CAkBN,CAAC"}

package/dist/app/config/env.config.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.env = void 0;
+/**
+ * 환경 변수 설정
+ */
+exports.env = {
+    // 서버 설정
+    NODE_ENV: process.env.NODE_ENV || 'development',
+    PORT: parseInt(process.env.PORT || '3000', 10),
+    // API 설정
+    API_VERSION: process.env.API_VERSION || 'v1',
+    API_PREFIX: process.env.API_PREFIX || '/api',
+    // Swagger 설정
+    SWAGGER_ENABLED: process.env.SWAGGER_ENABLED !== 'false',
+    SWAGGER_PATH: process.env.SWAGGER_PATH || '/api-docs',
+    // CORS 설정
+    CORS_ORIGIN: process.env.CORS_ORIGIN || '*',
+    // 로깅
+    LOG_LEVEL: process.env.LOG_LEVEL || 'info',
+};
+//# sourceMappingURL=env.config.js.map

package/dist/app/config/env.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.config.js","sourceRoot":"","sources":["../../../app/config/env.config.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,GAAG,GAAG;IACf,QAAQ;IACR,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;IAC/C,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;IAE9C,SAAS;IACT,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI;IAC5C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM;IAE5C,aAAa;IACb,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO;IACxD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,WAAW;IAErD,UAAU;IACV,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG;IAE3C,KAAK;IACL,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;CACpC,CAAC"}

package/dist/app/middleware/error-handler.middleware.d.ts

@@ -0,0 +1,17 @@
+import { Request, Response, NextFunction } from 'express';
+/**
+ * 에러 응답 인터페이스
+ */
+export interface ErrorResponse {
+    statusCode: number;
+    message: string;
+    error?: string;
+    requestId?: string;
+    timestamp: string;
+    path: string;
+}
+/**
+ * 글로벌 에러 핸들링 미들웨어
+ */
+export declare function errorHandlerMiddleware(err: Error | any, req: Request, res: Response, next: NextFunction): void;
+//# sourceMappingURL=error-handler.middleware.d.ts.map

package/dist/app/middleware/error-handler.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.middleware.d.ts","sourceRoot":"","sources":["../../../app/middleware/error-handler.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAClC,GAAG,EAAE,KAAK,GAAG,GAAG,EAChB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACnB,IAAI,CAoCN"}

package/dist/app/middleware/error-handler.middleware.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandlerMiddleware = errorHandlerMiddleware;
+/**
+ * 글로벌 에러 핸들링 미들웨어
+ */
+function errorHandlerMiddleware(err, req, res, next) {
+    const requestId = req.headers['x-request-id'];
+    // Validation 에러는 이미 처리됨
+    if (res.headersSent) {
+        return next(err);
+    }
+    // 에러 로깅
+    console.error('[ERROR HANDLER]', {
+        error: err.message,
+        stack: process.env.NODE_ENV === 'development' ? err.stack : undefined,
+        requestId,
+        path: req.path,
+        method: req.method,
+    });
+    // 상태 코드 결정
+    const statusCode = err.statusCode || err.status || 500;
+    const message = err.message || 'Internal server error';
+    // 에러 응답
+    const errorResponse = {
+        statusCode,
+        message: statusCode === 500 ? 'Internal server error' : message,
+        requestId,
+        timestamp: new Date().toISOString(),
+        path: req.path,
+    };
+    // 개발 환경에서만 상세 에러 정보 포함
+    if (process.env.NODE_ENV === 'development' && statusCode === 500) {
+        errorResponse.error = err.message;
+    }
+    res.status(statusCode).json(errorResponse);
+}
+//# sourceMappingURL=error-handler.middleware.js.map

package/dist/app/middleware/error-handler.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.middleware.js","sourceRoot":"","sources":["../../../app/middleware/error-handler.middleware.ts"],"names":[],"mappings":";;AAiBA,wDAyCC;AA5CD;;GAEG;AACH,SAAgB,sBAAsB,CAClC,GAAgB,EAChB,GAAY,EACZ,GAAa,EACb,IAAkB;IAElB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAW,CAAC;IAExD,wBAAwB;IACxB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,QAAQ;IACR,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;QAC7B,KAAK,EAAE,GAAG,CAAC,OAAO;QAClB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACrE,SAAS;QACT,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;KACrB,CAAC,CAAC;IAEH,WAAW;IACX,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;IACvD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,uBAAuB,CAAC;IAEvD,QAAQ;IACR,MAAM,aAAa,GAAkB;QACjC,UAAU;QACV,OAAO,EAAE,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO;QAC/D,SAAS;QACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,GAAG,CAAC,IAAI;KACjB,CAAC;IAEF,uBAAuB;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QAC/D,aAAa,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAC/C,CAAC"}

package/dist/app/middleware/logger.middleware.d.ts

@@ -0,0 +1,6 @@
+import { Request, Response, NextFunction } from 'express';
+/**
+ * 요청 로깅 미들웨어
+ */
+export declare function loggerMiddleware(req: Request, res: Response, next: NextFunction): void;
+//# sourceMappingURL=logger.middleware.d.ts.map

package/dist/app/middleware/logger.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.middleware.d.ts","sourceRoot":"","sources":["../../../app/middleware/logger.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CA6BtF"}

package/dist/app/middleware/logger.middleware.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loggerMiddleware = loggerMiddleware;
+/**
+ * 요청 로깅 미들웨어
+ */
+function loggerMiddleware(req, res, next) {
+    const start = Date.now();
+    const requestId = req.headers['x-request-id'] || `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    // 요청 ID를 헤더에 추가
+    req.headers['x-request-id'] = requestId;
+    res.setHeader('x-request-id', requestId);
+    // 응답 완료 시 로깅
+    res.on('finish', () => {
+        const duration = Date.now() - start;
+        const logMessage = {
+            method: req.method,
+            path: req.path,
+            statusCode: res.statusCode,
+            duration: `${duration}ms`,
+            requestId,
+            ip: req.ip || req.socket.remoteAddress,
+            userAgent: req.get('user-agent'),
+        };
+        if (res.statusCode >= 400) {
+            console.error('[ERROR]', logMessage);
+        }
+        else {
+            console.log('[REQUEST]', logMessage);
+        }
+    });
+    next();
+}
+//# sourceMappingURL=logger.middleware.js.map

package/dist/app/middleware/logger.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.middleware.js","sourceRoot":"","sources":["../../../app/middleware/logger.middleware.ts"],"names":[],"mappings":";;AAKA,4CA6BC;AAhCD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEhH,gBAAgB;IAChB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,SAAmB,CAAC;IAClD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,SAAmB,CAAC,CAAC;IAEnD,aAAa;IACb,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACpC,MAAM,UAAU,GAAG;YACf,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,QAAQ,IAAI;YACzB,SAAS;YACT,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa;YACtC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;SACnC,CAAC;QAEF,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,EAAE,CAAC;AACX,CAAC"}