@yolo-croket-dev/core 1.8.7 → 1.8.8-jun.0

package/exceptions/bad-request.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class BadRequest extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class BadRequest extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/conflict.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class Conflict extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class Conflict extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/forbidden.d.ts

@@ -1,13 +1,16 @@
 import { HttpException } from '@nestjs/common';
+import { ErrAction } from '../interfaces/exception';
+import { MsaException } from '../interfaces/msa-exception';
 /**
  * Forbidden 지원
  * Type O
  * ErrAction X
  */
-export declare class Forbidden extends HttpException {
+export declare class Forbidden extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;
+    errAction: ErrAction | null;
     /** 해당 에러시 재시도 여부 */
     isRetry?: boolean;
     constructor(errType: string, errMessage?: string, isRetry?: boolean);

package/exceptions/forbidden.js

@@ -15,10 +15,12 @@ class Forbidden extends common_1.HttpException {
         // new
         this.errType = null;
         this.errMessage = null;
+        this.errAction = null;
         this.subMessage = errMessage || null;
         // new
         this.errType = errType || null;
         this.errMessage = errMessage || null;
+        this.errAction = null;
         this.isRetry = isRetry;
     }
 }

package/exceptions/gone.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class Gone extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class Gone extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/internal-server-error.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class InternalServerError extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class InternalServerError extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/method-not-allowed.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class MethodNotAllowed extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class MethodNotAllowed extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/not-acceptable.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class NotAcceptable extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class NotAcceptable extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/not-found.d.ts

@@ -1,6 +1,7 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class NotFound extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class NotFound extends HttpException implements MsaException {
     subMessage: string | null;
     errType: string | null;
     errMessage: string | null;

package/exceptions/server-pause-exception.d.ts

@@ -1,6 +1,9 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
-export declare class ServerPauseException extends HttpException {
+import { MsaException } from '../interfaces/msa-exception';
+export declare class ServerPauseException extends HttpException implements MsaException {
+    errType: string | null;
+    errMessage: string | null;
     errAction: ErrAction | null;
     constructor(serverPauseTitle: string, serverPauseMessage: string);
 }

package/exceptions/server-pause-exception.js

@@ -6,7 +6,11 @@ const exception_1 = require("../interfaces/exception");
 class ServerPauseException extends common_1.HttpException {
     constructor(serverPauseTitle, serverPauseMessage) {
         super('SERVER_PAUSE_EXCEPTION', common_1.HttpStatus.SERVICE_UNAVAILABLE);
+        this.errType = null;
+        this.errMessage = null;
         this.errAction = null;
+        this.errType = 'SERVER_PAUSE_EXCEPTION';
+        this.errMessage = serverPauseMessage;
         this.errAction = {
             type: exception_1.ErrActionTypeEnum.SERVER_PAUSE,
             serverPauseTitle,

package/exceptions/unauthorized.d.ts

@@ -1,12 +1,14 @@
 import { HttpException } from '@nestjs/common';
 import { ErrAction } from '../interfaces/exception';
+import { MsaException } from '../interfaces/msa-exception';
 /**
  * UnAuthorized 지원
  * Type X
  * ErrAction X
  */
-export declare class UnAuthorized extends HttpException {
+export declare class UnAuthorized extends HttpException implements MsaException {
     subMessage: string | null;
+    errType: string | null;
     errMessage: string | null;
     errAction: ErrAction | null;
     constructor(errMessage?: string, errAction?: ErrAction);

package/exceptions/unauthorized.js

@@ -13,10 +13,12 @@ class UnAuthorized extends common_1.HttpException {
         // legacy
         this.subMessage = null;
         // new
+        this.errType = null;
         this.errMessage = null;
         this.errAction = null;
         this.subMessage = errMessage || null;
         // new
+        this.errType = 'USER_AUTHENTICATION_FAIL';
         this.errMessage = errMessage || null;
         this.errAction = errAction || null;
     }

package/functions/amqp-handler.function.js

@@ -6,7 +6,7 @@ const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const msa_logger_1 = require("@yolo-croket-dev/msa-logger");
 const _1 = require(".");
-const DEFAULT_TIMEOUT = 1000 * 60 * 29; // 29분 타임아웃
+const DEFAULT_TIMEOUT = 1000 * 60 * 60 * 6; // 6시간 타임아웃
 const DEFAULT_TIMEOUT_MESSAGE = '요청이 타임아웃되었습니다.';
 const msaLogger = new msa_logger_1.MsaLogger(msa_logger_1.ServerTypeEnum.SERVICE);
 class HttpExceptionCustom extends common_1.HttpException {

package/functions/index.d.ts

@@ -5,3 +5,5 @@ export * from './rewrite-file-value.function';
 export * from './amqp-call-manager.function';
 export * from './extract-redis-url.function';
 export * from './abort';
+export * from './uncaught-exception-handler';
+export * from './unhandled-rejection-handler';

package/functions/index.js

@@ -21,3 +21,5 @@ __exportStar(require("./rewrite-file-value.function"), exports);
 __exportStar(require("./amqp-call-manager.function"), exports);
 __exportStar(require("./extract-redis-url.function"), exports);
 __exportStar(require("./abort"), exports);
+__exportStar(require("./uncaught-exception-handler"), exports);
+__exportStar(require("./unhandled-rejection-handler"), exports);

package/functions/uncaught-exception-handler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @author jun
+ * @description uncaughtException 핸들러 - 에러 로깅 및 모니터링
+ * @process
+ * 1. 에러 로그 기록 (MsaLogger, Datadog)
+ * 2. 개발팀에서 로그 확인 후 즉시 대응
+ *
+ * @note
+ * - uncaughtException 발생 시 즉시 로그를 기록하여 모니터링
+ * - 개발팀에서 알림을 받고 바로 대응 예정
+ * - MsaLogger 실패 시에도 console.error로 fallback 처리
+ */
+export declare function uncaughtExceptionHandler(err: any): void;

package/functions/uncaught-exception-handler.js

@@ -0,0 +1,62 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uncaughtExceptionHandler = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const msa_logger_1 = __importStar(require("@yolo-croket-dev/msa-logger"));
+const msaLogger = new msa_logger_1.default(msa_logger_1.ServerTypeEnum.GATEWAY);
+/**
+ * @author jun
+ * @description uncaughtException 핸들러 - 에러 로깅 및 모니터링
+ * @process
+ * 1. 에러 로그 기록 (MsaLogger, Datadog)
+ * 2. 개발팀에서 로그 확인 후 즉시 대응
+ *
+ * @note
+ * - uncaughtException 발생 시 즉시 로그를 기록하여 모니터링
+ * - 개발팀에서 알림을 받고 바로 대응 예정
+ * - MsaLogger 실패 시에도 console.error로 fallback 처리
+ */
+function uncaughtExceptionHandler(err) {
+    try {
+        msaLogger.error('uncaughtException', {
+            traceId: 'uncaughtException',
+            errInfo: {
+                errType: err.name || 'Error',
+                status: err.status || 500,
+                message: err.message,
+                stack: err.stack,
+            },
+        });
+    }
+    catch (logError) {
+        // MsaLogger 실패 시 최후의 수단
+        // eslint-disable-next-line no-console
+        console.error('Failed to log uncaughtException:', logError);
+        // eslint-disable-next-line no-console
+        console.error('Original error:', err);
+    }
+}
+exports.uncaughtExceptionHandler = uncaughtExceptionHandler;

package/functions/unhandled-rejection-handler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @author jun
+ * @description unhandledRejection 핸들러 - 에러 로깅 및 모니터링
+ * @process
+ * 1. Promise rejection 에러 로그 기록
+ * 2. 개발팀에서 로그 확인 후 즉시 대응
+ *
+ * @note
+ * - unhandledRejection 발생 시 즉시 로그를 기록하여 모니터링
+ * - 개발팀에서 알림을 받고 바로 대응 예정
+ * - MsaLogger 실패 시에도 console.error로 fallback 처리
+ */
+export declare function unhandledRejectionHandler(err: any): void;

package/functions/unhandled-rejection-handler.js

@@ -0,0 +1,62 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unhandledRejectionHandler = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const msa_logger_1 = __importStar(require("@yolo-croket-dev/msa-logger"));
+const msaLogger = new msa_logger_1.default(msa_logger_1.ServerTypeEnum.SERVICE);
+/**
+ * @author jun
+ * @description unhandledRejection 핸들러 - 에러 로깅 및 모니터링
+ * @process
+ * 1. Promise rejection 에러 로그 기록
+ * 2. 개발팀에서 로그 확인 후 즉시 대응
+ *
+ * @note
+ * - unhandledRejection 발생 시 즉시 로그를 기록하여 모니터링
+ * - 개발팀에서 알림을 받고 바로 대응 예정
+ * - MsaLogger 실패 시에도 console.error로 fallback 처리
+ */
+function unhandledRejectionHandler(err) {
+    try {
+        msaLogger.error('unhandledRejection', {
+            traceId: 'unhandledRejection',
+            errInfo: {
+                errType: (err === null || err === void 0 ? void 0 : err.name) || 'UnhandledRejection',
+                status: (err === null || err === void 0 ? void 0 : err.status) || 500,
+                message: (err === null || err === void 0 ? void 0 : err.message) || String(err),
+                stack: err === null || err === void 0 ? void 0 : err.stack,
+            },
+        });
+    }
+    catch (logError) {
+        // MsaLogger 실패 시 최후의 수단
+        // eslint-disable-next-line no-console
+        console.error('Failed to log unhandledRejection:', logError);
+        // eslint-disable-next-line no-console
+        console.error('Original error:', err);
+    }
+}
+exports.unhandledRejectionHandler = unhandledRejectionHandler;

package/index.d.ts

@@ -1,3 +1,4 @@
 export * from './exceptions';
 export * from './interceptors';
 export * from './interfaces';
+export * from './functions';

package/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./exceptions"), exports);
 __exportStar(require("./interceptors"), exports);
 __exportStar(require("./interfaces"), exports);
+__exportStar(require("./functions"), exports);

package/interceptors/logging-service.interceptor.js

@@ -110,9 +110,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
         const currentSpan = dd_trace_1.default.scope().active();
         let loggingSpan = null;
         if (currentSpan) {
-            loggingSpan = dd_trace_1.default.startSpan(`logging-service-interceptor-${content.pattern}`, {
-                childOf: currentSpan.context(),
-            });
+            loggingSpan = dd_trace_1.default.startSpan(`logging-service-interceptor-${content.pattern}`, { childOf: currentSpan.context() });
         }
         if (loggingSpan) {
             loggingSpan.setTag('traceId', traceId);
@@ -151,9 +149,9 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
             msaLogger.printExceptionFliterService({
                 traceId,
                 errInfo: {
-                    errType: error.message,
+                    errType: error.subMessage ? error.message : error.name,
+                    message: error.subMessage ? error.subMessage : error.message,
                     status: error.status,
-                    message: error.subMessage,
                     stack: error.stack,
                 },
                 messageBrokerInfo: {

package/interfaces/index.d.ts

@@ -2,3 +2,4 @@ export * from './http';
 export * from './decorator';
 export * from './exception';
 export * from './amqp';
+export * from './msa-exception';

package/interfaces/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./http"), exports);
 __exportStar(require("./decorator"), exports);
 __exportStar(require("./exception"), exports);
 __exportStar(require("./amqp"), exports);
+__exportStar(require("./msa-exception"), exports);

package/interfaces/msa-exception.d.ts

@@ -0,0 +1,25 @@
+import { HttpException } from '@nestjs/common';
+import { ErrAction } from './exception';
+/**
+ * @author jun
+ * @description MSA 아키텍처에서 사용하는 공통 예외 인터페이스
+ * @process 커스텀 예외 클래스들이 구현하여 일관된 에러 처리 가능
+ */
+export interface MsaException {
+    /** 에러 유형 코드 */
+    errType: string | null;
+    /** 에러 메시지 */
+    errMessage: string | null;
+    /** 클라이언트 액션 정보 */
+    errAction: ErrAction | null;
+    /** 재시도 가능 여부 */
+    isRetry?: boolean;
+}
+/** HttpException과 MsaException을 결합한 타입 */
+export type MsaHttpException = MsaException & HttpException;
+/**
+ * @description MsaException 타입 가드
+ * @param error 검사할 에러 객체
+ * @returns MsaHttpException 타입 여부
+ */
+export declare function isMsaException(error: unknown): error is MsaHttpException;

package/interfaces/msa-exception.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMsaException = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * @description MsaException 타입 가드
+ * @param error 검사할 에러 객체
+ * @returns MsaHttpException 타입 여부
+ */
+function isMsaException(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const err = error;
+    return ('errType' in err
+        && 'errMessage' in err
+        && 'errAction' in err
+        && error instanceof common_1.HttpException);
+}
+exports.isMsaException = isMsaException;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/core",
-  "version": "1.8.7",
+  "version": "1.8.8-jun.0",
   "author": "Yolo Co., Ltd.",
   "description": "Yolo commonization module",
   "main": "index.js",
@@ -17,14 +17,14 @@
     "@nestjs/common": "^11.0.0",
     "@nestjs/swagger": "^11.0.0",
     "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.0"
+    "class-validator": "^0.14.0",
+    "dd-trace": "^5.0.0"
   },
   "dependencies": {
     "@yolo-croket-dev/logger": "^1.0.15",
-    "@yolo-croket-dev/msa-logger": "^3.3.1",
+    "@yolo-croket-dev/msa-logger": "^3.4.2",
     "@yolo-croket-dev/redis": "^1.0.25",
     "axios": "^1.1.3",
-    "dd-trace": "^5.46.0",
     "randomstring": "^1.2.2",
     "rxjs": "^7.4.0",
     "uuid": "^8.3.2"

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm run lint)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}