@yolo-croket-dev/core 1.10.0-jun.2 → 1.10.0

package/AGENTS.md

@@ -0,0 +1,52 @@
+# CORE KNOWLEDGE BASE
+
+## OVERVIEW
+
+요청 context, 예외, interceptor, AMQP helper, Redis provider, graceful shutdown을 노출하는 최고 영향도 공용 패키지다. `AbstractParam`은 Codegraph 기준 1,313개 reference를 가진다.
+
+## STRUCTURE
+
+```text
+core/
+├── index.ts
+├── interfaces/       # AbstractParam/Request/Response, exceptions
+├── exceptions/       # 공용 HTTP/MSA error contract
+├── functions/        # AMQP call/publish/handler, trace/error helper
+├── interceptors/     # request/RPC logging and active-call tracking
+├── modules/          # Redis, graceful shutdown
+└── tests/            # node:test CJS integration-style tests
+```
+
+## WHERE TO LOOK
+
+| 작업 | 위치 | 확인 |
+|---|---|---|
+| Trace/request shape | `interfaces/http.ts` | 모든 서비스 metadata 호환성 |
+| Error contract | `interfaces/msa-exception.ts`, `exceptions` | AMQP ACK/NACK와 consumer 변환 |
+| AMQP behavior | `functions/amqp-*` | timeout, publish/call error handling |
+| Shutdown | `modules/graceful-shutdown` | active interceptor drain, health file |
+| Redis injection | `modules/redis.module.ts` | `REDIS_PROVIDER` contract |
+
+## CONVENTIONS
+
+- Public shape 변경 전 package 내부뿐 아니라 `amqp-access`, `amqp-rabbit-mq`, `grpc`, 실제 서비스 import를 검색한다.
+- `AbstractParam.traceId`를 호출 경계에서 보존한다. 새 context 필드는 직렬화와 metadata 전달 경로를 함께 확인한다.
+- Exception은 status/type/message/action/errInfo 변환을 기존 handler와 일치시킨다.
+- Graceful shutdown은 active request/RPC drain과 `/tmp/healthy` lifecycle을 함께 유지한다.
+- Public export는 leaf barrel, category barrel, root `index.ts`를 모두 확인한다.
+
+## ANTI-PATTERNS
+
+- 한 소비자 전용 shape나 비즈니스 판단을 core에 올리지 않는다.
+- Trace/error field를 silent fallback으로 숨기거나 하위 호환 근거 없이 rename하지 않는다.
+- AMQP timeout/ACK behavior를 실제 caller/handler 검증 없이 변경하지 않는다.
+- Generated JS/d.ts를 source로 취급하지 않는다.
+
+## VERIFY
+
+```bash
+yarn workspace @yolo-croket-dev/core test
+yarn workspace @yolo-croket-dev/core lint
+```
+
+`test`가 먼저 build한 뒤 `tests/*.test.cjs`를 실행한다. 현재 lint glob은 `src/**/*.ts`지만 source는 package root에 있어 lint 결과가 변경 파일을 실제 포함하는지 별도로 확인한다.

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 1.10.0
+
+- 비회원 인증 로그 마스킹·검증 오류 보호·재시도 정보 필드를 정식 발행합니다.
+- 기존 1.9.14의 AMQP timeout, ACK/NACK 옵션, RabbitMQ 연결 이름 설정을 보존합니다.
+- 소비 서비스에서 사용하던 1.10.0-jun.2의 gRPC metadata·예외 처리와 포트 파싱을 유지합니다.
+
+## 1.10.0-jun.2-beta.1
+
+- 현재 소비 버전 1.10.0-jun.2의 gRPC metadata 및 예외 처리 동작을 유지합니다.
+- 비회원 인증 요청 로그의 민감 값을 마스킹하고 검증 오류에서 입력값을 제외합니다.
+- 인증 실패의 남은 입력 횟수와 재시도 대기시간 필드를 추가합니다.

package/filters/grpc-exception.filter.js

@@ -152,7 +152,7 @@ let GrpcExceptionFilter = class GrpcExceptionFilter extends microservices_1.Base
         }
     }
 };
-GrpcExceptionFilter = __decorate([
+exports.GrpcExceptionFilter = GrpcExceptionFilter;
+exports.GrpcExceptionFilter = GrpcExceptionFilter = __decorate([
     (0, common_1.Catch)()
 ], GrpcExceptionFilter);
-exports.GrpcExceptionFilter = GrpcExceptionFilter;

package/functions/amqp-handler.function.js

@@ -17,11 +17,18 @@ class HttpExceptionCustom extends common_1.HttpException {
     }
 }
 exports.HttpExceptionCustom = HttpExceptionCustom;
+function resolveAmqpTimeout(timeoutMs) {
+    if (typeof timeoutMs !== 'number' || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        return DEFAULT_TIMEOUT;
+    }
+    return Math.min(timeoutMs, DEFAULT_TIMEOUT);
+}
 async function AmqpHandler(client, messagePattern, payload) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     let data;
+    const timeoutMs = resolveAmqpTimeout((_a = payload === null || payload === void 0 ? void 0 : payload.param) === null || _a === void 0 ? void 0 : _a.timeout);
     try {
-        data = await (0, rxjs_1.lastValueFrom)(client.send(messagePattern, payload).pipe((0, operators_1.timeout)(DEFAULT_TIMEOUT)));
+        data = await (0, rxjs_1.lastValueFrom)(client.send(messagePattern, payload).pipe((0, operators_1.timeout)(timeoutMs)));
         if (data.isError) {
             const status = data.status || 500;
             const subMessage = data.subMessage;
@@ -29,7 +36,7 @@ async function AmqpHandler(client, messagePattern, payload) {
              * 파일 객체 처리
              * 다른 서비스에서 이미 처리가 될 수 있음
              * */
-            (0, _1.reWriteFileValue)((_a = data === null || data === void 0 ? void 0 : data.arg) === null || _a === void 0 ? void 0 : _a.file);
+            (0, _1.reWriteFileValue)((_b = data === null || data === void 0 ? void 0 : data.arg) === null || _b === void 0 ? void 0 : _b.file);
             const errInfo = data.errInfo ? data.errInfo : {
                 message: data.errMessage,
                 type: data.errType,
@@ -50,7 +57,7 @@ async function AmqpHandler(client, messagePattern, payload) {
     catch (err) {
         if (typeof err === 'string' && err.includes('There is no matching message handler defined in the remote service.')) {
             msaLogger.error('NOT_EXISTS_MESSAGE_PATTERN', {
-                traceId: ((_b = payload === null || payload === void 0 ? void 0 : payload.param) === null || _b === void 0 ? void 0 : _b.traceId) || '-',
+                traceId: ((_c = payload === null || payload === void 0 ? void 0 : payload.param) === null || _c === void 0 ? void 0 : _c.traceId) || '-',
                 errInfo: {
                     errType: 'NOT_EXISTS_MESSAGE_PATTERN',
                     message: `${messagePattern} 해당 메시지 패턴은 존재하지 않습니다.`,
@@ -64,7 +71,7 @@ async function AmqpHandler(client, messagePattern, payload) {
         }
         else if (err instanceof rxjs_1.TimeoutError || err.message === DEFAULT_TIMEOUT_MESSAGE) {
             msaLogger.error('TIMEOUT_ERROR', {
-                traceId: ((_c = payload === null || payload === void 0 ? void 0 : payload.param) === null || _c === void 0 ? void 0 : _c.traceId) || '-',
+                traceId: ((_d = payload === null || payload === void 0 ? void 0 : payload.param) === null || _d === void 0 ? void 0 : _d.traceId) || '-',
                 errInfo: {
                     errType: 'TIMEOUT_ERROR',
                     message: DEFAULT_TIMEOUT_MESSAGE,
@@ -77,7 +84,7 @@ async function AmqpHandler(client, messagePattern, payload) {
             });
         }
         else {
-            msaLogger.warn('AMQP_HANDLER_ERROR', { traceId: ((_d = payload === null || payload === void 0 ? void 0 : payload.param) === null || _d === void 0 ? void 0 : _d.traceId) || '-' }, { err });
+            msaLogger.warn('AMQP_HANDLER_ERROR', { traceId: ((_e = payload === null || payload === void 0 ? void 0 : payload.param) === null || _e === void 0 ? void 0 : _e.traceId) || '-' }, { err });
             throw err;
         }
     }

package/functions/grpc-param-metadata.function.d.ts

@@ -1,7 +1,7 @@
 import { Metadata } from '@grpc/grpc-js';
 import { AbstractParam } from '../interfaces';
 export declare const GRPC_PARAM_METADATA_KEY = "param";
-export declare type GrpcParamMetadata = AbstractParam;
+export type GrpcParamMetadata = AbstractParam;
 /**
  * @author jun
  * @description gRPC metadata에 AMQP param 호환 컨텍스트를 저장합니다.

package/functions/redact-auth-data.function.d.ts

@@ -0,0 +1,2 @@
+/** @author jun @description 인증 정보 로그 마스킹 @process 원본을 변경하지 않고 중첩 객체의 민감 값을 가린다. */
+export declare function redactAuthData(value: unknown, seen?: WeakSet<object>): unknown;

package/functions/redact-auth-data.function.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactAuthData = void 0;
+const SENSITIVE_KEY = /password|secret|token|authorization|cookie|phone|verificationcode|verificationid|api.?key/i;
+/** @author jun @description 인증 정보 로그 마스킹 @process 원본을 변경하지 않고 중첩 객체의 민감 값을 가린다. */
+function redactAuthData(value, seen = new WeakSet()) {
+    if (!value || typeof value !== 'object')
+        return value;
+    if (seen.has(value))
+        return '[Circular]';
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.map(item => redactAuthData(item, seen));
+    return Object.fromEntries(Object.entries(value).map(([key, item,]) => [
+        key,
+        SENSITIVE_KEY.test(key) ? '***MASKED***' : redactAuthData(item, seen),
+    ]));
+}
+exports.redactAuthData = redactAuthData;

package/interceptors/logging-service.interceptor.js

@@ -39,6 +39,7 @@ const common_1 = require("@nestjs/common");
 const msa_logger_1 = __importStar(require("@yolo-croket-dev/msa-logger"));
 const operators_1 = require("rxjs/operators");
 const dd_trace_1 = __importDefault(require("dd-trace"));
+const redact_auth_data_function_1 = require("../functions/redact-auth-data.function");
 const grpc_param_metadata_function_1 = require("../functions/grpc-param-metadata.function");
 const { SERVER_NAME } = process.env;
 const msaLogger = new msa_logger_1.default(msa_logger_1.ServerTypeEnum.SERVICE);
@@ -130,9 +131,9 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
             traceId,
             messageBrokerInfo: {
                 messagePatten: pattern,
-                payload: JSON.stringify(this.keyCutter(JSON.stringify(payload))),
+                payload: JSON.stringify(this.keyCutter(JSON.stringify((0, redact_auth_data_function_1.redactAuthData)(payload)))),
             },
-            paramInfo: pastParam,
+            paramInfo: (0, redact_auth_data_function_1.redactAuthData)(pastParam),
             traceInfo: {
                 from: pastFrom,
                 froms: pastFroms,
@@ -159,7 +160,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
                 },
                 messageBrokerInfo: {
                     messagePatten: pattern,
-                    payload: JSON.stringify(this.keyCutter(JSON.stringify(payload))),
+                    payload: JSON.stringify(this.keyCutter(JSON.stringify((0, redact_auth_data_function_1.redactAuthData)(payload)))),
                 },
                 traceInfo: {
                     from: pastFrom,
@@ -189,7 +190,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
                 },
                 messageBrokerInfo: {
                     messagePatten: pattern,
-                    payload: JSON.stringify(this.keyCutter(JSON.stringify(payload))),
+                    payload: JSON.stringify(this.keyCutter(JSON.stringify((0, redact_auth_data_function_1.redactAuthData)(payload)))),
                 },
                 traceInfo: {
                     from: pastFrom,
@@ -205,7 +206,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
                 },
                 messageBrokerInfo: {
                     messagePatten: pattern,
-                    payload: JSON.stringify(this.keyCutter(JSON.stringify(payload))),
+                    payload: JSON.stringify(this.keyCutter(JSON.stringify((0, redact_auth_data_function_1.redactAuthData)(payload)))),
                 },
                 traceInfo: {
                     from: pastFrom,
@@ -219,7 +220,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
         }));
     }
 };
-LoggingServiceInterceptor = __decorate([
+exports.LoggingServiceInterceptor = LoggingServiceInterceptor;
+exports.LoggingServiceInterceptor = LoggingServiceInterceptor = __decorate([
     (0, common_1.Injectable)()
 ], LoggingServiceInterceptor);
-exports.LoggingServiceInterceptor = LoggingServiceInterceptor;

package/interceptors/rpc.interceptor.js

@@ -370,9 +370,9 @@ let RPCInterceptor = class RPCInterceptor {
         })));
     }
 };
-RPCInterceptor = __decorate([
+exports.RPCInterceptor = RPCInterceptor;
+exports.RPCInterceptor = RPCInterceptor = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [core_1.Reflector,
         graceful_shutdown_service_1.GracefulShutdownService])
 ], RPCInterceptor);
-exports.RPCInterceptor = RPCInterceptor;

package/interfaces/exception.d.ts

@@ -18,4 +18,6 @@ export declare class ErrInfo {
     message?: string;
     action?: ErrAction;
     errOption?: MsaExceptionOption;
+    remainingAttempts?: number;
+    retryAfterSeconds?: number;
 }

package/interfaces/exception.js

@@ -18,9 +18,10 @@ var ErrActionTypeEnum;
     ErrActionTypeEnum["LEGACY_SHOW_TOAST"] = "LEGACY_SHOW_TOAST";
     ErrActionTypeEnum["FORCE_UPDATE"] = "FORCE_UPDATE";
     ErrActionTypeEnum["UPDATE_ACCESS_TOKEN"] = "UPDATE_ACCESS_TOKEN";
-})(ErrActionTypeEnum = exports.ErrActionTypeEnum || (exports.ErrActionTypeEnum = {}));
+})(ErrActionTypeEnum || (exports.ErrActionTypeEnum = ErrActionTypeEnum = {}));
 class ErrAction {
 }
+exports.ErrAction = ErrAction;
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: '액션 타입',
@@ -57,9 +58,9 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], ErrAction.prototype, "webViewUrl", void 0);
-exports.ErrAction = ErrAction;
 class ErrInfo {
 }
+exports.ErrInfo = ErrInfo;
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: '에러 종류 식별자',
@@ -88,4 +89,17 @@ __decorate([
     }),
     __metadata("design:type", Object)
 ], ErrInfo.prototype, "errOption", void 0);
-exports.ErrInfo = ErrInfo;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: '인증 코드의 남은 입력 횟수',
+        required: false,
+    }),
+    __metadata("design:type", Number)
+], ErrInfo.prototype, "remainingAttempts", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: '다음 요청까지 기다릴 초',
+        required: false,
+    }),
+    __metadata("design:type", Number)
+], ErrInfo.prototype, "retryAfterSeconds", void 0);

package/interfaces/log-level.enum.js

@@ -21,4 +21,4 @@ var LogLevelEnum;
     LogLevelEnum["DEBUG"] = "debug";
     LogLevelEnum["WARN"] = "warn";
     LogLevelEnum["ERROR"] = "error";
-})(LogLevelEnum = exports.LogLevelEnum || (exports.LogLevelEnum = {}));
+})(LogLevelEnum || (exports.LogLevelEnum = LogLevelEnum = {}));

package/interfaces/msa-exception.d.ts

@@ -1,6 +1,10 @@
 import { HttpException } from '@nestjs/common';
 import { LogLevelEnum } from './log-level.enum';
 import type { ErrAction } from './exception';
+export declare enum MsaExceptionMessageAckBehaviorEnum {
+    ACK = "ACK",
+    NACK = "NACK"
+}
 export interface MsaExceptionOption {
     /**
      * 로그 레벨
@@ -8,6 +12,12 @@ export interface MsaExceptionOption {
      * - 기본값은 ERROR 입니다.
      * */
     logErrorLevel?: LogLevelEnum;
+    /**
+     * 메시지 consumer 실패 시 ACK/NACK override 옵션
+     * - 현재는 amqp-rabbit-mq subscribe consumer에서만 해석합니다.
+     * - option이 없으면 consumer handler의 기본 errorBehavior를 따릅니다.
+     */
+    messageAckBehavior?: MsaExceptionMessageAckBehaviorEnum;
 }
 /**
  * @author jun
@@ -27,7 +37,7 @@ export interface MsaException {
     errOption?: MsaExceptionOption;
 }
 /** HttpException과 MsaException을 결합한 타입 */
-export declare type MsaHttpException = MsaException & HttpException;
+export type MsaHttpException = MsaException & HttpException;
 /**
  * @description MsaException 타입 가드
  * @param error 검사할 에러 객체

package/interfaces/msa-exception.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMsaException = void 0;
+exports.isMsaException = exports.MsaExceptionMessageAckBehaviorEnum = void 0;
 const common_1 = require("@nestjs/common");
+var MsaExceptionMessageAckBehaviorEnum;
+(function (MsaExceptionMessageAckBehaviorEnum) {
+    MsaExceptionMessageAckBehaviorEnum["ACK"] = "ACK";
+    MsaExceptionMessageAckBehaviorEnum["NACK"] = "NACK";
+})(MsaExceptionMessageAckBehaviorEnum || (exports.MsaExceptionMessageAckBehaviorEnum = MsaExceptionMessageAckBehaviorEnum = {}));
 /**
  * @description MsaException 타입 가드
  * @param error 검사할 에러 객체

package/modules/graceful-shutdown/graceful-shutdown.module.js

@@ -48,7 +48,8 @@ let GracefulShutdownModule = class GracefulShutdownModule {
         msaLogger.info('GracefulShutdownService.onModuleDestroy: all interceptors finished, shutting down', { traceId: 'ON_MODULE_DESTROY' });
     }
 };
-GracefulShutdownModule = __decorate([
+exports.GracefulShutdownModule = GracefulShutdownModule;
+exports.GracefulShutdownModule = GracefulShutdownModule = __decorate([
     (0, common_1.Global)(),
     (0, common_1.Module)({
         providers: [graceful_shutdown_service_1.GracefulShutdownService],
@@ -56,4 +57,3 @@ GracefulShutdownModule = __decorate([
     }),
     __metadata("design:paramtypes", [graceful_shutdown_service_1.GracefulShutdownService])
 ], GracefulShutdownModule);
-exports.GracefulShutdownModule = GracefulShutdownModule;

package/modules/graceful-shutdown/graceful-shutdown.rmq.d.ts

@@ -1,10 +1,16 @@
-import { RmqOptions, ServerRMQ } from '@nestjs/microservices';
-import { Channel } from 'amqp-connection-manager';
-import { ConsumeMessage } from 'amqplib';
-export declare type GracefulRmqOptions = RmqOptions['options'] & {
+import { ServerRMQ } from '@nestjs/microservices';
+import type { RmqOptions } from '@nestjs/microservices';
+import type { Channel } from 'amqp-connection-manager';
+import type { ConsumeMessage } from 'amqplib';
+export type GracefulRmqOptions = RmqOptions['options'] & {
     waitingEndingHandlersTimeoutMs?: number;
     waitingEndingHandlersIntervalMs?: number;
 };
+/**
+ * @author jun
+ * @description RabbitMQ 연결 식별 정보와 graceful shutdown을 제공하는 RMQ 서버
+ * @process 연결 옵션에 추적 가능한 connection_name을 추가한 뒤 메시지 종료를 보장한다.
+ */
 export declare class GracefulServerRMQ extends ServerRMQ {
     protected readonly options: GracefulRmqOptions;
     protected runningMessages: number;

package/modules/graceful-shutdown/graceful-shutdown.rmq.js

@@ -1,18 +1,67 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GracefulServerRMQ = void 0;
 const microservices_1 = require("@nestjs/microservices");
+const os_1 = __importDefault(require("os"));
 const node_util_1 = require("node:util");
 const sleep = (0, node_util_1.promisify)(setTimeout);
 const RMQ_DEFAULT_WAITING_ENDING_HANDLERS_TIMEOUT_MS = 5000;
 const RMQ_DEFAULT_WAITING_ENDING_HANDLERS_INTERVAL_MS = 500;
+const RMQ_UNKNOWN_CONNECTION_IDENTITY = 'unknown';
+function createRmqConnectionName(queue) {
+    const environment = process.env.ENV || process.env.NODE_ENV || RMQ_UNKNOWN_CONNECTION_IDENTITY;
+    const owner = process.env.RMQ_OWNER || process.env.USER || process.env.USERNAME || RMQ_UNKNOWN_CONNECTION_IDENTITY;
+    return [
+        queue || RMQ_UNKNOWN_CONNECTION_IDENTITY,
+        environment,
+        owner,
+        os_1.default.hostname(),
+        `pid-${process.pid}`,
+    ].join('/');
+}
+function addRmqConnectionName(options) {
+    var _a;
+    const connectionOptions = (_a = options.socketOptions) === null || _a === void 0 ? void 0 : _a.connectionOptions;
+    const configuredClientProperties = connectionOptions === null || connectionOptions === void 0 ? void 0 : connectionOptions.clientProperties;
+    const clientProperties = configuredClientProperties
+        && typeof configuredClientProperties === 'object'
+        && !Array.isArray(configuredClientProperties)
+        ? configuredClientProperties
+        : {};
+    const configuredConnectionName = clientProperties.connection_name;
+    const connectionName = typeof configuredConnectionName === 'string' && configuredConnectionName.trim()
+        ? configuredConnectionName
+        : createRmqConnectionName(options.queue);
+    return {
+        ...options,
+        socketOptions: {
+            ...options.socketOptions,
+            connectionOptions: {
+                ...connectionOptions,
+                clientProperties: {
+                    ...clientProperties,
+                    connection_name: connectionName,
+                },
+            },
+        },
+    };
+}
+/**
+ * @author jun
+ * @description RabbitMQ 연결 식별 정보와 graceful shutdown을 제공하는 RMQ 서버
+ * @process 연결 옵션에 추적 가능한 connection_name을 추가한 뒤 메시지 종료를 보장한다.
+ */
 class GracefulServerRMQ extends microservices_1.ServerRMQ {
     constructor(options) {
-        super(options);
-        this.options = options;
+        const optionsWithConnectionName = addRmqConnectionName(options);
+        super(optionsWithConnectionName);
         this.runningMessages = 0;
         this.closing = false;
         this.consumerTag = null;
+        this.options = optionsWithConnectionName;
         this.waitingEndingHandlersTimeoutMs = this.getOptionsProp(this.options, 'waitingEndingHandlersTimeoutMs')
             || RMQ_DEFAULT_WAITING_ENDING_HANDLERS_TIMEOUT_MS;
         this.waitingEndingHandlersIntervalMs = this.getOptionsProp(this.options, 'waitingEndingHandlersIntervalMs')

package/modules/graceful-shutdown/graceful-shutdown.service.js

@@ -133,7 +133,7 @@ let GracefulShutdownService = class GracefulShutdownService {
         });
     }
 };
-GracefulShutdownService = __decorate([
+exports.GracefulShutdownService = GracefulShutdownService;
+exports.GracefulShutdownService = GracefulShutdownService = __decorate([
     (0, common_1.Injectable)()
 ], GracefulShutdownService);
-exports.GracefulShutdownService = GracefulShutdownService;

package/modules/redis.module.js

@@ -15,10 +15,10 @@ const redisProvider = {
 };
 let RedisModule = class RedisModule {
 };
-RedisModule = __decorate([
+exports.RedisModule = RedisModule;
+exports.RedisModule = RedisModule = __decorate([
     (0, common_1.Module)({
         providers: [redisProvider],
         exports: [redisProvider],
     })
 ], RedisModule);
-exports.RedisModule = RedisModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/core",
-  "version": "1.10.0-jun.2",
+  "version": "1.10.0",
   "author": "Yolo Co., Ltd.",
   "description": "Yolo commonization module",
   "main": "index.js",
@@ -10,14 +10,15 @@
     "fix": "eslint --fix src/**/*.ts",
     "clean": "tsc --build --clean",
     "prepublishOnly": "npm run build",
-    "postpublish": "npm run clean"
+    "postpublish": "npm run clean",
+    "test": "yarn build && node --test tests/*.test.cjs"
   },
   "license": "UNLICENSED",
   "peerDependencies": {
+    "@grpc/grpc-js": "^1.14.3",
     "@nestjs/common": "^11.0.0",
     "@nestjs/microservices": "^11.0.0",
     "@nestjs/swagger": "^11.0.0",
-    "@grpc/grpc-js": "^1.14.3",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.0",
     "dd-trace": "^5.0.0"
@@ -32,10 +33,11 @@
     "uuid": "^8.3.2"
   },
   "devDependencies": {
+    "@grpc/grpc-js": "^1.14.3",
     "@nestjs/common": "^11.1.8",
-    "@nestjs/microservices": "^11.1.8",
+    "@nestjs/core": "^11.1.8",
+    "@nestjs/microservices": "11.0.13",
     "@nestjs/swagger": "^11.2.1",
-    "@grpc/grpc-js": "^1.14.3",
     "@types/node": "^24.9.1",
     "@types/randomstring": "^1.1.8",
     "@types/uuid": "^8.3.4"

package/pipes/rpc-validation.pipe.js

@@ -24,15 +24,20 @@ let ValidationPipe = class ValidationPipe {
             return value;
         }
         const object = (0, class_transformer_1.plainToInstance)(this.dto, value.payload);
-        const errors = await (0, class_validator_1.validate)(object);
+        const errors = await (0, class_validator_1.validate)(object, {
+            validationError: {
+                target: false,
+                value: false,
+            },
+        });
         if (errors.length > 0) {
             throw new exceptions_1.BadRequest('VALIDATION_ERROR', JSON.stringify(errors));
         }
         return value;
     }
 };
-ValidationPipe = __decorate([
+exports.ValidationPipe = ValidationPipe;
+exports.ValidationPipe = ValidationPipe = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [Object])
 ], ValidationPipe);
-exports.ValidationPipe = ValidationPipe;

package/tests/amqp-handler-timeout.test.cjs

@@ -0,0 +1,47 @@
+const assert = require('node:assert/strict');
+const test = require('node:test');
+const { Observable } = require('rxjs');
+
+const { AmqpHandler, HttpExceptionCustom } = require('../functions/amqp-handler.function.js');
+
+test('param.timeout이 지나면 AMQP Observable 구독을 해제한다', async () => {
+  let isUnsubscribed = false;
+  const client = {
+    send() {
+      return new Observable(() => () => {
+        isUnsubscribed = true;
+      });
+    },
+  };
+
+  await assert.rejects(
+    AmqpHandler(client, 'test.timeout', {
+      payload: {},
+      param: {
+        traceId: 'trace-id',
+        timeout: 5,
+      },
+    }),
+    (error) => {
+      assert.equal(error instanceof HttpExceptionCustom, true);
+      assert.equal(error.errInfo.type, 'TIMEOUT_ERROR');
+      return true;
+    },
+  );
+
+  assert.equal(isUnsubscribed, true);
+});
+
+test('응답이 먼저 완료되면 기존 AMQP 응답을 반환한다', async () => {
+  const client = {
+    send() {
+      return new Observable((subscriber) => {
+        subscriber.next({ isError: false, data: { ok: true } });
+        subscriber.complete();
+      });
+    },
+  };
+
+  const result = await AmqpHandler(client, 'test.success', { payload: {}, param: { traceId: 'trace-id', timeout: 50 } });
+  assert.deepEqual(result, { data: { ok: true } });
+});

package/tests/graceful-shutdown-rmq.test.cjs

@@ -0,0 +1,102 @@
+const assert = require('node:assert/strict');
+const os = require('node:os');
+const test = require('node:test');
+
+const {
+  GracefulServerRMQ,
+} = require('../modules/graceful-shutdown/graceful-shutdown.rmq.js');
+
+const CONNECTION_NAME_ENV_KEYS = [
+  'ENV',
+  'NODE_ENV',
+  'RMQ_OWNER',
+  'USER',
+  'USERNAME',
+];
+
+function getClientProperties(options) {
+  const server = new GracefulServerRMQ(options);
+  return server.options.socketOptions.connectionOptions.clientProperties;
+}
+
+function runWithEnvironment(environment, callback) {
+  const originalEnvironment = Object.fromEntries(
+    CONNECTION_NAME_ENV_KEYS.map((key) => [key, process.env[key]]),
+  );
+  try {
+    for (const key of CONNECTION_NAME_ENV_KEYS) {
+      delete process.env[key];
+    }
+    Object.assign(process.env, environment);
+    callback();
+  } finally {
+    for (const key of CONNECTION_NAME_ENV_KEYS) {
+      const originalValue = originalEnvironment[key];
+      if (originalValue === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = originalValue;
+      }
+    }
+  }
+}
+
+test('자동 connection_name에 큐와 실행 주체 정보를 포함한다', () => {
+  runWithEnvironment({ ENV: 'release', RMQ_OWNER: 'jun' }, () => {
+    const actualClientProperties = getClientProperties({ queue: 'STORE_ITEM_SERVER' });
+    const expectedConnectionName = `STORE_ITEM_SERVER/release/jun/${os.hostname()}/pid-${process.pid}`;
+    assert.equal(actualClientProperties.connection_name, expectedConnectionName);
+  });
+});
+
+test('기존 connectionOptions와 clientProperties를 보존한다', () => {
+  runWithEnvironment({ NODE_ENV: 'production', USER: 'deploy' }, () => {
+    const inputOptions = {
+      queue: 'USER_SERVICE',
+      socketOptions: {
+        noDelay: true,
+        connectionOptions: {
+          locale: 'ko_KR',
+          clientProperties: {
+            product: 'croket',
+          },
+        },
+      },
+    };
+    const server = new GracefulServerRMQ(inputOptions);
+    assert.equal(server.options.socketOptions.noDelay, true);
+    assert.equal(server.options.socketOptions.connectionOptions.locale, 'ko_KR');
+    assert.equal(server.options.socketOptions.connectionOptions.clientProperties.product, 'croket');
+  });
+});
+
+test('명시적으로 설정한 문자열 connection_name을 보존한다', () => {
+  const actualClientProperties = getClientProperties({
+    queue: 'USER_SERVICE',
+    socketOptions: {
+      connectionOptions: {
+        clientProperties: {
+          connection_name: 'custom-connection-name',
+        },
+      },
+    },
+  });
+  assert.equal(actualClientProperties.connection_name, 'custom-connection-name');
+});
+
+test('문자열이 아닌 connection_name은 자동 생성값으로 대체한다', () => {
+  runWithEnvironment({ ENV: 'release', RMQ_OWNER: 'jun' }, () => {
+    const actualClientProperties = getClientProperties({
+      queue: 'STORE_ITEM_SERVER',
+      socketOptions: {
+        connectionOptions: {
+          clientProperties: {
+            connection_name: 123,
+          },
+        },
+      },
+    });
+    const expectedConnectionName = `STORE_ITEM_SERVER/release/jun/${os.hostname()}/pid-${process.pid}`;
+    assert.equal(actualClientProperties.connection_name, expectedConnectionName);
+  });
+});

package/tests/redact-auth-data.test.cjs

@@ -0,0 +1,17 @@
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const { redactAuthData } = require('../functions/redact-auth-data.function');
+
+test('인증 요청·응답과 중첩 메타데이터를 원본 변경 없이 마스킹한다', () => {
+  const input = { payload: { verificationCode: '123456', phoneNumber: '01012345678', recaptchaToken: 'captcha' },
+    result: [{ access_token: 'jwt', refresh_token: 'refresh' }], param: { authorization: 'Bearer jwt', traceId: 'trace' } };
+  const output = redactAuthData(input);
+  assert.equal(output.payload.verificationCode, '***MASKED***');
+  assert.equal(output.payload.phoneNumber, '***MASKED***');
+  assert.equal(output.payload.recaptchaToken, '***MASKED***');
+  assert.equal(output.result[0].access_token, '***MASKED***');
+  assert.equal(output.result[0].refresh_token, '***MASKED***');
+  assert.equal(output.param.authorization, '***MASKED***');
+  assert.equal(output.param.traceId, 'trace');
+  assert.equal(input.payload.verificationCode, '123456');
+});

package/tests/rpc-validation-secrets.test.cjs

@@ -0,0 +1,17 @@
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const { IsString } = require('class-validator');
+const { ValidationPipe } = require('../pipes/rpc-validation.pipe');
+
+test('검증 실패 예외는 다른 필드의 OTP·CAPTCHA와 target/value를 포함하지 않는다', async () => {
+  class Payload {}
+  IsString()(Payload.prototype, 'verificationId');
+  const pipe = new ValidationPipe(Payload);
+  await assert.rejects(pipe.transform({ payload: { verificationId: 123, verificationCode: '123456', recaptchaToken: 'captcha-secret' } }, { metatype: Object }), e => {
+    assert.ok(!e.subMessage.includes('123456'));
+    assert.ok(!e.subMessage.includes('captcha-secret'));
+    assert.ok(!e.subMessage.includes('target'));
+    assert.ok(!e.subMessage.includes('value'));
+    return true;
+  });
+});

package/functions/abort/enhanced-promise-patch.d.ts

@@ -1,17 +0,0 @@
-declare global {
-    var Promise: PromiseConstructor;
-}
-export declare class EnhancedPromisePatch {
-    private static isPatched;
-    private static originalPromise;
-    private static originalSetTimeout;
-    static patch(): void;
-    private static patchPromise;
-    private static patchSetTimeout;
-    static unpatch(): void;
-    /**
-     * 현재 패치 상태 확인
-     * @returns 패치 여부
-     */
-    static getPatchStatus(): boolean;
-}

package/functions/abort/enhanced-promise-patch.js

@@ -1,115 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnhancedPromisePatch = void 0;
-const abort_1 = require("./abort");
-class EnhancedPromisePatch {
-    static patch() {
-        if (this.isPatched) {
-            return;
-        }
-        this.patchPromise();
-        this.patchSetTimeout();
-        this.isPatched = true;
-    }
-    static patchPromise() {
-        this.originalPromise = global.Promise;
-        // Promise 생성자 패치
-        global.Promise = new Proxy(global.Promise, {
-            construct(target, args) {
-                const abortSignal = (0, abort_1.getCurrentAbortSignal)();
-                if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
-                    return Promise.reject(new Error('REQUEST_ABORTED: Promise가 중단되었습니다'));
-                }
-                // target은 Promise 생성자이므로, new 연산자와 함께 사용해야 하며, args는 [executor] 형태의 튜플임을 명시합니다.
-                const promise = Reflect.construct(target, args);
-                if (!abortSignal) {
-                    return promise;
-                }
-                // Promise 체인에 중단 확인 추가
-                return promise.then((result) => {
-                    if (abortSignal.aborted) {
-                        throw new Error('REQUEST_ABORTED: Promise 실행 중 중단되었습니다');
-                    }
-                    return result;
-                }, (error) => {
-                    if (abortSignal.aborted) {
-                        throw new Error('REQUEST_ABORTED: Promise 실행 중 중단되었습니다');
-                    }
-                    throw error;
-                });
-            },
-        });
-        // Promise.resolve 패치
-        const originalResolve = global.Promise.resolve;
-        global.Promise.resolve = (value) => {
-            const abortSignal = (0, abort_1.getCurrentAbortSignal)();
-            if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
-                return Promise.reject(new Error('REQUEST_ABORTED: Promise.resolve가 중단되었습니다'));
-            }
-            const promise = originalResolve.call(global.Promise, value);
-            if (!abortSignal) {
-                return promise;
-            }
-            return promise.then((result) => {
-                if (abortSignal.aborted) {
-                    throw new Error('REQUEST_ABORTED: Promise.resolve 실행 중 중단되었습니다');
-                }
-                return result;
-            }, (error) => {
-                if (abortSignal.aborted) {
-                    throw new Error('REQUEST_ABORTED: Promise.resolve 실행 중 중단되었습니다');
-                }
-                throw error;
-            });
-        };
-        // Promise.reject 패치
-        const originalReject = global.Promise.reject;
-        global.Promise.reject = (reason) => {
-            const abortSignal = (0, abort_1.getCurrentAbortSignal)();
-            if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
-                return Promise.reject(new Error('REQUEST_ABORTED: Promise.reject가 중단되었습니다'));
-            }
-            return originalReject.call(global.Promise, reason);
-        };
-    }
-    static patchSetTimeout() {
-        this.originalSetTimeout = global.setTimeout;
-        // eslint-disable-next-line @typescript-eslint/ban-types
-        global.setTimeout = (callback, delay, ...args) => {
-            const abortSignal = (0, abort_1.getCurrentAbortSignal)();
-            if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
-                throw new Error('REQUEST_ABORTED: setTimeout이 중단되었습니다');
-            }
-            const timerId = this.originalSetTimeout(() => {
-                if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
-                    throw new Error('REQUEST_ABORTED: setTimeout 콜백이 중단되었습니다');
-                }
-                callback(...args);
-            }, delay);
-            if (abortSignal) {
-                const abortHandler = () => {
-                    clearTimeout(timerId);
-                };
-                abortSignal.addEventListener('abort', abortHandler, { once: true });
-            }
-            return timerId;
-        };
-    }
-    static unpatch() {
-        if (!this.isPatched) {
-            return;
-        }
-        global.Promise = this.originalPromise;
-        global.setTimeout = this.originalSetTimeout;
-        this.isPatched = false;
-    }
-    /**
-     * 현재 패치 상태 확인
-     * @returns 패치 여부
-     */
-    static getPatchStatus() {
-        return this.isPatched;
-    }
-}
-exports.EnhancedPromisePatch = EnhancedPromisePatch;
-EnhancedPromisePatch.isPatched = false;