@xfilecom/core-sdk 1.3.27 → 1.3.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfilecom/core-sdk",
-  "version": "1.3.27",
+  "version": "1.3.28",
   "description": "Core SDK for NestJS microservices - 통합 개발 키트",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,8 @@
     "build": "tsc",
     "prepublishOnly": "npm run build",
     "publish:gitlab": "node scripts/publish-to-gitlab.mjs",
-    "test:response-format": "node scripts/test-response-format.js"
+    "test:response-format": "node scripts/test-response-format.js",
+    "test:error-format": "node scripts/test-error-format.js"
   },
   "dependencies": {
     "@nestjs/common": "^10.0.0",

package/scripts/test-error-format.js

@@ -0,0 +1,134 @@
+/**
+ * 에러 응답 형식 검증: error.message는 항상 문자열 (error.message.message 중복 없음)
+ * ErrorUtils / ControllerHelpers와 동일한 규칙을 재현해 검증 (Nest 의존성 없이 실행)
+ *
+ * 실행: node scripts/test-error-format.js
+ * 또는: npm run test:error-format
+ *
+ * --- 기존(수정 전) vs 현재(수정 후) ---
+ *
+ * 기존 (error.message가 객체라서 error.message.message로 접근해야 함):
+ * {
+ *   "code": 401,
+ *   "data": [],
+ *   "error": {
+ *     "message": {
+ *       "message": "이메일 또는 비밀번호가 올바르지 않습니다.",
+ *       "error": "Unauthorized",
+ *       "statusCode": 401
+ *     }
+ *   }
+ * }
+ *
+ * 현재 (error.message는 문자열만, 한 번에 접근):
+ * {
+ *   "code": 401,
+ *   "data": [],
+ *   "error": {
+ *     "message": "이메일 또는 비밀번호가 올바르지 않습니다."
+ *   }
+ * }
+ */
+
+function normalizeMessage(message) {
+  if (typeof message === 'string') return message;
+  if (message && typeof message === 'object' && 'message' in message) {
+    const m = message.message;
+    if (typeof m === 'string') return m;
+    if (Array.isArray(m) && m.length > 0 && typeof m[0] === 'string') return m[0];
+  }
+  return typeof message === 'object' ? JSON.stringify(message) : String(message);
+}
+
+function createError(code, message) {
+  const errorCode = code === 0 ? 500 : code;
+  const messageStr = normalizeMessage(message);
+  return { code: errorCode, data: [], error: { message: messageStr } };
+}
+
+function fromException(exception) {
+  if (exception && typeof exception === 'object' && 'code' in exception && 'error' in exception && 'data' in exception) {
+    return exception;
+  }
+  if (exception && typeof exception === 'object' && 'getStatus' in exception && 'getResponse' in exception) {
+    const statusCode = exception.getStatus();
+    const response = exception.getResponse();
+    const message = typeof response === 'string' ? response : (response?.message || 'Internal server error');
+    return createError(statusCode, message);
+  }
+  if (exception instanceof Error) {
+    const statusCode = exception.status ?? 500;
+    const message = exception.message || 'Internal server error';
+    return createError(statusCode, message);
+  }
+  return createError(500, 'Internal server error');
+}
+
+function assert(condition, message) {
+  if (!condition) {
+    console.error('❌ FAIL:', message);
+    process.exit(1);
+  }
+  console.log('✅', message);
+}
+
+console.log('\n--- error.message는 항상 문자열인지 검증 ---\n');
+
+// 반환값 확인: 로그인 실패 같은 401 시 실제 반환되는 구조 (테스트 끝에 한 번 더 출력)
+function printReturnValue(label, dto) {
+  console.log(`\n[반환값] ${label}`);
+  console.log(JSON.stringify(dto, null, 2));
+  console.log('');
+}
+
+// 1. createError(코드, 문자열)
+const dto1 = createError(401, '이메일 또는 비밀번호가 올바르지 않습니다.');
+assert(dto1.code === 401, 'createError(401, string): code 401');
+assert(dto1.error && typeof dto1.error.message === 'string', 'createError(401, string): error.message는 string');
+assert(dto1.error.message === '이메일 또는 비밀번호가 올바르지 않습니다.', 'createError(401, string): 메시지 내용 일치');
+assert(typeof dto1.error.message !== 'object', 'createError(401, string): error.message가 객체가 아님');
+
+// 2. createError(코드, Nest 스타일 객체)
+const nestResponse = { message: 'Bad request', error: 'Unauthorized', statusCode: 401 };
+const dto2 = createError(400, nestResponse);
+assert(dto2.error && typeof dto2.error.message === 'string', 'createError(400, object): error.message는 string');
+assert(dto2.error.message === 'Bad request', 'createError(400, object): 객체에서 message 문자열 추출');
+
+// 3. fromException - mock HttpException (Nest getResponse() 형태)
+const mockHttpException = {
+  getStatus: () => 401,
+  getResponse: () => ({
+    message: '이메일 또는 비밀번호가 올바르지 않습니다.',
+    error: 'Unauthorized',
+    statusCode: 401,
+  }),
+};
+const dto3 = fromException(mockHttpException);
+printReturnValue('로그인 실패(401) 시 응답 body', dto3);
+assert(dto3.code === 401, 'fromException(mock HttpException): code 401');
+assert(dto3.error && typeof dto3.error.message === 'string', 'fromException: error.message는 string');
+assert(
+  dto3.error.message === '이메일 또는 비밀번호가 올바르지 않습니다.',
+  'fromException: error.message가 문자열로 한 단계만 노출'
+);
+assert(!dto3.error.message || typeof dto3.error.message !== 'object', 'fromException: error.message.message 중복 구조 없음');
+
+// 4. fromException - 일반 Error
+const dto4 = fromException(new Error('Something went wrong'));
+assert(dto4.error && typeof dto4.error.message === 'string', 'fromException(Error): error.message는 string');
+assert(dto4.error.message === 'Something went wrong', 'fromException(Error): 메시지 일치');
+
+// 5. JSON 직렬화 후 파싱해도 error.message는 문자열
+const json = JSON.stringify(dto3);
+const parsed = JSON.parse(json);
+assert(typeof parsed.error.message === 'string', 'JSON 직렬화 후에도 error.message는 string');
+assert(parsed.error.message === '이메일 또는 비밀번호가 올바르지 않습니다.', 'JSON 파싱 후 메시지 유지');
+
+// 6. 클라이언트 사용: error.message만 읽으면 됨 (error.message.message 불필요)
+const clientMessage = parsed.error.message;
+assert(clientMessage === '이메일 또는 비밀번호가 올바르지 않습니다.', '클라이언트: error.message 한 번에 접근');
+
+console.log('\n--- 최종 반환값 요약 (API 응답과 동일) ---');
+printReturnValue('401 예시', dto3);
+
+console.log('✅ 모든 에러 형식 검증 통과: error.message는 항상 문자열, 중복 구조 없음\n');