@yolo-croket-dev/core 1.9.14 → 1.10.0-jun.1

package/decorators/grpc-param.decorator.js

@@ -2,11 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GrpcParam = void 0;
 const common_1 = require("@nestjs/common");
+const grpc_param_metadata_function_1 = require("../functions/grpc-param-metadata.function");
 exports.GrpcParam = (0, common_1.createParamDecorator)((data, ctx) => {
     const metadata = ctx.switchToRpc().getContext();
-    const param = metadata.get('param');
-    if (!param || !param[0]) {
-        return null;
-    }
-    return JSON.parse(param[0]);
+    return (0, grpc_param_metadata_function_1.parseGrpcParamMetadata)(metadata);
 });

package/filters/grpc-exception.filter.js

@@ -60,6 +60,7 @@ let GrpcExceptionFilter = class GrpcExceptionFilter extends microservices_1.Base
                 message: msaException.errMessage || exception.message,
                 status: httpStatus,
                 action: msaException.errAction,
+                errOption: msaException.errOption,
             };
             metadata.set('error', Buffer.from(JSON.stringify(errInfo)).toString('base64'));
             metadata.set('status', httpStatus.toString());
@@ -130,7 +131,7 @@ let GrpcExceptionFilter = class GrpcExceptionFilter extends microservices_1.Base
         }
     }
 };
-exports.GrpcExceptionFilter = GrpcExceptionFilter;
-exports.GrpcExceptionFilter = GrpcExceptionFilter = __decorate([
+GrpcExceptionFilter = __decorate([
     (0, common_1.Catch)()
 ], GrpcExceptionFilter);
+exports.GrpcExceptionFilter = GrpcExceptionFilter;

package/functions/amqp-handler.function.js

@@ -17,18 +17,11 @@ 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, _e;
+    var _a, _b, _c, _d;
     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)(timeoutMs)));
+        data = await (0, rxjs_1.lastValueFrom)(client.send(messagePattern, payload).pipe((0, operators_1.timeout)(DEFAULT_TIMEOUT)));
         if (data.isError) {
             const status = data.status || 500;
             const subMessage = data.subMessage;
@@ -36,7 +29,7 @@ async function AmqpHandler(client, messagePattern, payload) {
              * 파일 객체 처리
              * 다른 서비스에서 이미 처리가 될 수 있음
              * */
-            (0, _1.reWriteFileValue)((_b = data === null || data === void 0 ? void 0 : data.arg) === null || _b === void 0 ? void 0 : _b.file);
+            (0, _1.reWriteFileValue)((_a = data === null || data === void 0 ? void 0 : data.arg) === null || _a === void 0 ? void 0 : _a.file);
             const errInfo = data.errInfo ? data.errInfo : {
                 message: data.errMessage,
                 type: data.errType,
@@ -57,7 +50,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: ((_c = payload === null || payload === void 0 ? void 0 : payload.param) === null || _c === void 0 ? void 0 : _c.traceId) || '-',
+                traceId: ((_b = payload === null || payload === void 0 ? void 0 : payload.param) === null || _b === void 0 ? void 0 : _b.traceId) || '-',
                 errInfo: {
                     errType: 'NOT_EXISTS_MESSAGE_PATTERN',
                     message: `${messagePattern} 해당 메시지 패턴은 존재하지 않습니다.`,
@@ -71,7 +64,7 @@ async function AmqpHandler(client, messagePattern, payload) {
         }
         else if (err instanceof rxjs_1.TimeoutError || err.message === DEFAULT_TIMEOUT_MESSAGE) {
             msaLogger.error('TIMEOUT_ERROR', {
-                traceId: ((_d = payload === null || payload === void 0 ? void 0 : payload.param) === null || _d === void 0 ? void 0 : _d.traceId) || '-',
+                traceId: ((_c = payload === null || payload === void 0 ? void 0 : payload.param) === null || _c === void 0 ? void 0 : _c.traceId) || '-',
                 errInfo: {
                     errType: 'TIMEOUT_ERROR',
                     message: DEFAULT_TIMEOUT_MESSAGE,
@@ -84,7 +77,7 @@ async function AmqpHandler(client, messagePattern, payload) {
             });
         }
         else {
-            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 });
+            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 });
             throw err;
         }
     }

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

@@ -0,0 +1,22 @@
+import { Metadata } from '@grpc/grpc-js';
+import { AbstractParam } from '../interfaces';
+export declare const GRPC_PARAM_METADATA_KEY = "param";
+export declare type GrpcParamMetadata = AbstractParam;
+/**
+ * @author jun
+ * @description gRPC metadata에 AMQP param 호환 컨텍스트를 저장합니다.
+ * @process 1. AbstractParam 검증 -> 2. JSON 직렬화 -> 3. metadata param key에 저장
+ */
+export declare function setGrpcParamMetadata(metadata: Metadata, param: GrpcParamMetadata): void;
+/**
+ * @author jun
+ * @description gRPC metadata에서 AMQP param 호환 컨텍스트를 안전하게 읽습니다.
+ * @process 1. metadata param key 조회 -> 2. 문자열 검증 -> 3. JSON 파싱 실패 시 null 반환
+ */
+export declare function parseGrpcParamMetadata(metadata: Metadata): GrpcParamMetadata | null;
+/**
+ * @author jun
+ * @description gRPC metadata에서 필수 param 컨텍스트를 읽고 없거나 잘못되면 예외를 던집니다.
+ * @process 1. metadata param 파싱 -> 2. 유효성 확인 -> 3. 유효하지 않으면 BadRequest 발생
+ */
+export declare function assertGrpcParamMetadata(metadata: Metadata): GrpcParamMetadata;

package/functions/grpc-param-metadata.function.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertGrpcParamMetadata = exports.parseGrpcParamMetadata = exports.setGrpcParamMetadata = exports.GRPC_PARAM_METADATA_KEY = void 0;
+const bad_request_1 = require("../exceptions/bad-request");
+exports.GRPC_PARAM_METADATA_KEY = 'param';
+const OPTIONAL_STRING_KEYS = [
+    'userId',
+    'provider',
+    'clientId',
+    'requestIp',
+    'tossRequestId',
+    'from',
+];
+const OPTIONAL_BOOLEAN_KEYS = [
+    'isAdmin',
+    'isInternal',
+];
+const OPTIONAL_NUMBER_KEYS = [
+    'retryCount',
+    'timeout',
+];
+const OPTIONAL_OBJECT_KEYS = [
+    'device',
+    'externalTokenValue',
+    'requestLog',
+];
+/**
+ * @author jun
+ * @description gRPC param metadata 검증을 위한 record 타입 가드입니다.
+ * @process 1. object 여부 확인 -> 2. null/array 제외 -> 3. record로 좁힘
+ */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isValidOptionalStringArray(value) {
+    return value === undefined || (Array.isArray(value) && value.every(item => typeof item === 'string'));
+}
+function hasInvalidOptionalFields(param) {
+    const hasInvalidString = OPTIONAL_STRING_KEYS.some(key => param[key] !== undefined && typeof param[key] !== 'string');
+    if (hasInvalidString) {
+        return true;
+    }
+    const hasInvalidBoolean = OPTIONAL_BOOLEAN_KEYS.some(key => param[key] !== undefined && typeof param[key] !== 'boolean');
+    if (hasInvalidBoolean) {
+        return true;
+    }
+    const hasInvalidNumber = OPTIONAL_NUMBER_KEYS.some(key => (param[key] !== undefined
+        && (typeof param[key] !== 'number' || !Number.isFinite(param[key]))));
+    if (hasInvalidNumber) {
+        return true;
+    }
+    const hasInvalidObject = OPTIONAL_OBJECT_KEYS.some(key => param[key] !== undefined && !isRecord(param[key]));
+    if (hasInvalidObject) {
+        return true;
+    }
+    return !isValidOptionalStringArray(param.froms);
+}
+function toGrpcParamMetadata(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    if (typeof value.traceId !== 'string' || value.traceId.length === 0) {
+        return null;
+    }
+    if (hasInvalidOptionalFields(value)) {
+        return null;
+    }
+    return value;
+}
+function getMetadataStringValue(metadata) {
+    const values = metadata.get(exports.GRPC_PARAM_METADATA_KEY);
+    const value = values[0];
+    if (!value) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    return value.toString('utf8');
+}
+function createInvalidGrpcParamMetadataError() {
+    return new bad_request_1.BadRequest('INVALID_GRPC_PARAM_METADATA', 'gRPC param metadata가 올바르지 않습니다.');
+}
+/**
+ * @author jun
+ * @description gRPC metadata에 AMQP param 호환 컨텍스트를 저장합니다.
+ * @process 1. AbstractParam 검증 -> 2. JSON 직렬화 -> 3. metadata param key에 저장
+ */
+function setGrpcParamMetadata(metadata, param) {
+    const grpcParam = toGrpcParamMetadata(param);
+    if (!grpcParam) {
+        throw createInvalidGrpcParamMetadataError();
+    }
+    metadata.set(exports.GRPC_PARAM_METADATA_KEY, JSON.stringify(grpcParam));
+}
+exports.setGrpcParamMetadata = setGrpcParamMetadata;
+/**
+ * @author jun
+ * @description gRPC metadata에서 AMQP param 호환 컨텍스트를 안전하게 읽습니다.
+ * @process 1. metadata param key 조회 -> 2. 문자열 검증 -> 3. JSON 파싱 실패 시 null 반환
+ */
+function parseGrpcParamMetadata(metadata) {
+    const rawParam = getMetadataStringValue(metadata);
+    if (!rawParam) {
+        return null;
+    }
+    try {
+        return toGrpcParamMetadata(JSON.parse(rawParam));
+    }
+    catch (error) {
+        return null;
+    }
+}
+exports.parseGrpcParamMetadata = parseGrpcParamMetadata;
+/**
+ * @author jun
+ * @description gRPC metadata에서 필수 param 컨텍스트를 읽고 없거나 잘못되면 예외를 던집니다.
+ * @process 1. metadata param 파싱 -> 2. 유효성 확인 -> 3. 유효하지 않으면 BadRequest 발생
+ */
+function assertGrpcParamMetadata(metadata) {
+    const grpcParam = parseGrpcParamMetadata(metadata);
+    if (!grpcParam) {
+        throw createInvalidGrpcParamMetadataError();
+    }
+    return grpcParam;
+}
+exports.assertGrpcParamMetadata = assertGrpcParamMetadata;

package/functions/index.d.ts

@@ -3,6 +3,7 @@ export * from './generate-trace-id.function';
 export * from './amqp-publish.function';
 export * from './rewrite-file-value.function';
 export * from './amqp-call-manager.function';
+export * from './grpc-param-metadata.function';
 export * from './extract-redis-url.function';
 export * from './abort';
 export * from './uncaught-exception-handler';

package/functions/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./generate-trace-id.function"), exports);
 __exportStar(require("./amqp-publish.function"), exports);
 __exportStar(require("./rewrite-file-value.function"), exports);
 __exportStar(require("./amqp-call-manager.function"), exports);
+__exportStar(require("./grpc-param-metadata.function"), exports);
 __exportStar(require("./extract-redis-url.function"), exports);
 __exportStar(require("./abort"), exports);
 __exportStar(require("./uncaught-exception-handler"), exports);

package/interceptors/logging-service.interceptor.js

@@ -37,6 +37,7 @@ exports.LoggingServiceInterceptor = void 0;
 /* eslint-disable no-param-reassign */
 const common_1 = require("@nestjs/common");
 const msa_logger_1 = __importStar(require("@yolo-croket-dev/msa-logger"));
+const grpc_param_metadata_function_1 = require("@yolo-croket-dev/core/functions/grpc-param-metadata.function");
 const operators_1 = require("rxjs/operators");
 const dd_trace_1 = __importDefault(require("dd-trace"));
 const { SERVER_NAME } = process.env;
@@ -75,6 +76,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
         return data;
     }
     intercept(context, next) {
+        var _a;
         const now = Date.now();
         const args = context.getArgs();
         const rpcContext = context.switchToRpc();
@@ -87,13 +89,11 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
         let pattern; /** @xxx: Grpc: path , Mq: 메시지 패턴명 */
         let payload;
         if (isGrpc) {
-            const metadataParam = metadata.get('param')[0] || JSON.stringify({
-                param: {
-                    from: '-',
-                    froms: '-',
-                },
-            });
-            param = JSON.parse(metadataParam);
+            param = (_a = (0, grpc_param_metadata_function_1.parseGrpcParamMetadata)(metadata)) !== null && _a !== void 0 ? _a : {
+                traceId: '-',
+                from: '-',
+                froms: ['-'],
+            };
             originalMessage = args[0];
             const gRPCArg = args[2];
             pattern = gRPCArg.path;
@@ -116,11 +116,11 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
         const tmpFroms = JSON.parse(JSON.stringify(pastFroms));
         tmpFroms.push(tmpFrom);
         if (isGrpc) {
-            metadata.set('param', JSON.stringify({
+            (0, grpc_param_metadata_function_1.setGrpcParamMetadata)(metadata, {
                 ...pastParam,
                 from: tmpFrom,
                 froms: tmpFroms,
-            }));
+            });
         }
         else {
             data.param.from = tmpFrom;
@@ -219,7 +219,7 @@ let LoggingServiceInterceptor = class LoggingServiceInterceptor {
         }));
     }
 };
-exports.LoggingServiceInterceptor = LoggingServiceInterceptor;
-exports.LoggingServiceInterceptor = LoggingServiceInterceptor = __decorate([
+LoggingServiceInterceptor = __decorate([
     (0, common_1.Injectable)()
 ], LoggingServiceInterceptor);
+exports.LoggingServiceInterceptor = LoggingServiceInterceptor;

package/interceptors/rpc.interceptor.js

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

package/interfaces/exception.js

@@ -18,10 +18,9 @@ var ErrActionTypeEnum;
     ErrActionTypeEnum["LEGACY_SHOW_TOAST"] = "LEGACY_SHOW_TOAST";
     ErrActionTypeEnum["FORCE_UPDATE"] = "FORCE_UPDATE";
     ErrActionTypeEnum["UPDATE_ACCESS_TOKEN"] = "UPDATE_ACCESS_TOKEN";
-})(ErrActionTypeEnum || (exports.ErrActionTypeEnum = ErrActionTypeEnum = {}));
+})(ErrActionTypeEnum = exports.ErrActionTypeEnum || (exports.ErrActionTypeEnum = {}));
 class ErrAction {
 }
-exports.ErrAction = ErrAction;
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: '액션 타입',
@@ -58,9 +57,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: '에러 종류 식별자',
@@ -89,3 +88,4 @@ __decorate([
     }),
     __metadata("design:type", Object)
 ], ErrInfo.prototype, "errOption", void 0);
+exports.ErrInfo = ErrInfo;

package/interfaces/log-level.enum.js

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

package/interfaces/msa-exception.d.ts

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

package/interfaces/msa-exception.js

@@ -1,12 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMsaException = exports.MsaExceptionMessageAckBehaviorEnum = void 0;
+exports.isMsaException = 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,8 +48,7 @@ let GracefulShutdownModule = class GracefulShutdownModule {
         msaLogger.info('GracefulShutdownService.onModuleDestroy: all interceptors finished, shutting down', { traceId: 'ON_MODULE_DESTROY' });
     }
 };
-exports.GracefulShutdownModule = GracefulShutdownModule;
-exports.GracefulShutdownModule = GracefulShutdownModule = __decorate([
+GracefulShutdownModule = __decorate([
     (0, common_1.Global)(),
     (0, common_1.Module)({
         providers: [graceful_shutdown_service_1.GracefulShutdownService],
@@ -57,3 +56,4 @@ exports.GracefulShutdownModule = GracefulShutdownModule = __decorate([
     }),
     __metadata("design:paramtypes", [graceful_shutdown_service_1.GracefulShutdownService])
 ], GracefulShutdownModule);
+exports.GracefulShutdownModule = GracefulShutdownModule;

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

@@ -1,16 +1,10 @@
-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'] & {
+import { RmqOptions, ServerRMQ } from '@nestjs/microservices';
+import { Channel } from 'amqp-connection-manager';
+import { ConsumeMessage } from 'amqplib';
+export declare 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,67 +1,18 @@
 "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) {
-        const optionsWithConnectionName = addRmqConnectionName(options);
-        super(optionsWithConnectionName);
+        super(options);
+        this.options = options;
         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 {
         });
     }
 };
-exports.GracefulShutdownService = GracefulShutdownService;
-exports.GracefulShutdownService = GracefulShutdownService = __decorate([
+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 {
 };
-exports.RedisModule = RedisModule;
-exports.RedisModule = RedisModule = __decorate([
+RedisModule = __decorate([
     (0, common_1.Module)({
         providers: [redisProvider],
         exports: [redisProvider],
     })
 ], RedisModule);
+exports.RedisModule = RedisModule;

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@yolo-croket-dev/core",
-  "version": "1.9.14",
+  "version": "1.10.0-jun.1",
   "author": "Yolo Co., Ltd.",
   "description": "Yolo commonization module",
   "main": "index.js",
   "scripts": {
     "build": "tsc",
     "lint": "eslint src/**/*.ts",
-    "test": "yarn build && node --test tests/*.test.cjs",
     "fix": "eslint --fix src/**/*.ts",
     "clean": "tsc --build --clean",
     "prepublishOnly": "npm run build",
@@ -16,7 +15,9 @@
   "license": "UNLICENSED",
   "peerDependencies": {
     "@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,7 +33,9 @@
   },
   "devDependencies": {
     "@nestjs/common": "^11.1.8",
+    "@nestjs/microservices": "^11.1.8",
     "@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

@@ -31,8 +31,8 @@ let ValidationPipe = class ValidationPipe {
         return value;
     }
 };
-exports.ValidationPipe = ValidationPipe;
-exports.ValidationPipe = ValidationPipe = __decorate([
+ValidationPipe = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [Object])
 ], ValidationPipe);
+exports.ValidationPipe = ValidationPipe;

package/util.js

@@ -14,8 +14,10 @@ exports.generateRandom = generateRandom;
 // ex) localhost:50051 => 50051
 function getPortFromHost(host) {
     const specificHost = host.includes('://') ? host.split('://')[1] : host;
-    if (specificHost.includes(':' && specificHost.split(':')[1])) {
-        return parseInt(specificHost.split(':')[1], 10);
+    const port = specificHost.split(':')[1];
+    if (port) {
+        const parsedPort = parseInt(port, 10);
+        return Number.isNaN(parsedPort) ? undefined : parsedPort;
     }
     return undefined;
 }

package/CHANGELOG.md

@@ -1,11 +0,0 @@
-# Changelog
-
-## 1.9.13-beta.1
-
-- AMQP 요청의 `param.timeout`을 최대 29분 범위에서 적용해 timeout 시 클라이언트 Observable 구독을 해제합니다.
-
-## 1.9.12-beta.1
-
-- `GracefulServerRMQ`가 RabbitMQ 연결에 queue, environment, owner, hostname, process ID 기반 `connection_name`을 자동으로 추가합니다.
-- 호출자가 지정한 `connectionOptions`, `clientProperties`, 유효한 문자열 `connection_name`은 그대로 보존합니다.
-- 문자열이 아닌 `connection_name`은 런타임 오류 없이 자동 생성값으로 대체합니다.

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

@@ -1,47 +0,0 @@
-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

@@ -1,102 +0,0 @@
-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);
-  });
-});