@yolo-croket-dev/amqp-access 0.7.255 → 0.7.256

package/AGENTS.md

@@ -0,0 +1,54 @@
+# AMQP-ACCESS KNOWLEDGE BASE
+
+## OVERVIEW
+
+저트래픽 레거시 RabbitMQ RPC를 위한 서비스별 DTO와 Nest injectable client를 제공한다. 신규 고부하/비동기 흐름은 이 패키지보다 `amqp-rabbit-mq`를 먼저 검토한다.
+
+## STRUCTURE
+
+```text
+amqp-access/
+├── index.ts                    # package public barrel
+├── <service>/
+│   ├── dto/                    # command/query payload/result
+│   ├── services/               # AmqpXxxService
+│   ├── amqp.<domain>.module.ts
+│   ├── *.provider.ts
+│   └── index.ts                # domain public barrel
+└── package.json
+```
+
+큰 영역은 `store-item-server`, `user-service`, `order-server`; 변경 전 해당 service의 `services`, `dto`, 모든 상위 barrel을 함께 추적한다.
+
+## WHERE TO LOOK
+
+| 작업 | 위치 | 확인 |
+|---|---|---|
+| 호출 method 추가 | `<service>/services/amqp.*.service.ts` | `AmqpManagement.call` 인자와 return type |
+| contract 추가 | `<service>/dto/<domain>/{command,query}` | validator, Payload/Result export |
+| provider/module 추가 | `<service>/*.provider.ts`, `amqp.*.module.ts` | injection token과 package barrel |
+| 상품/주문 대형 surface | `store-item-server`, `order-server` | 기존 domain naming과 route literal 검색 |
+
+## CONVENTIONS
+
+- Service class는 `AmqpXxxService`, 파일은 `amqp.<domain>.service.ts` 패턴을 유지한다.
+- DTO는 command/query와 도메인 경계를 유지하고 `class-validator` decorator를 boundary validation에 사용한다.
+- Route 변경은 `rg "<actual.route.key>"`로 caller/consumer를 함께 찾고 실제 문자열을 코드 검색 가능하게 둔다.
+- Public contract는 leaf `index.ts`부터 service, package root barrel까지 빠짐없이 export한다.
+- `AbstractParam`과 `AbstractRequest` shape를 임의 복제하지 않고 `@yolo-croket-dev/core`를 사용한다.
+
+## ANTI-PATTERNS
+
+- retry/DLQ/concurrency가 필요한 신규 작업을 편의상 legacy RPC에 추가하지 않는다.
+- Repository/consumer의 비즈니스 상태 판단을 DTO/client service로 옮기지 않는다.
+- 기존 route key를 새 wrapper constant 뒤에 숨기지 않는다.
+- `entity`, `entity-v2`, `dto-v2` 호환성을 확인하지 않고 public type을 변경하지 않는다.
+
+## VERIFY
+
+```bash
+yarn workspace @yolo-croket-dev/amqp-access build
+yarn workspace @yolo-croket-dev/amqp-access lint
+```
+
+패키지 test script는 없다. contract 변경은 실제 소비 서비스의 compile/test까지 검증한다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/amqp-access",
-  "version": "0.7.255",
+  "version": "0.7.256",
   "main": "index.js",
   "author": "Yolo Co., Ltd.",
   "description": "크로켓 amqp-access npm",

package/payment-service/dto/refund/command/index.d.ts

@@ -2,3 +2,5 @@ export * from './re-process-nicepay-billing-refund-by-refund-error.dto';
 export * from './re-process-tosspayments-refund-by-refund-error.dto';
 export * from './resolve-nicepay-billing-refund-by-refund-error.dto';
 export * from './resolve-tosspayments-refund-by-refund-error.dto';
+export * from './refund-waiting-buyer-action.dto';
+export * from './process-refund-waiting-unavailable-by-admin.dto';

package/payment-service/dto/refund/command/index.js

@@ -18,3 +18,5 @@ __exportStar(require("./re-process-nicepay-billing-refund-by-refund-error.dto"),
 __exportStar(require("./re-process-tosspayments-refund-by-refund-error.dto"), exports);
 __exportStar(require("./resolve-nicepay-billing-refund-by-refund-error.dto"), exports);
 __exportStar(require("./resolve-tosspayments-refund-by-refund-error.dto"), exports);
+__exportStar(require("./refund-waiting-buyer-action.dto"), exports);
+__exportStar(require("./process-refund-waiting-unavailable-by-admin.dto"), exports);

package/payment-service/dto/refund/command/process-refund-waiting-unavailable-by-admin.dto.d.ts

@@ -0,0 +1,4 @@
+/** @author sj */
+export declare class ProcessRefundWaitingUnavailableByAdminPayload {
+    PInfoId: string;
+}

package/payment-service/dto/refund/command/process-refund-waiting-unavailable-by-admin.dto.js

@@ -0,0 +1,22 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessRefundWaitingUnavailableByAdminPayload = void 0;
+const class_validator_1 = require("class-validator");
+/** @author sj */
+class ProcessRefundWaitingUnavailableByAdminPayload {
+}
+exports.ProcessRefundWaitingUnavailableByAdminPayload = ProcessRefundWaitingUnavailableByAdminPayload;
+__decorate([
+    (0, class_validator_1.IsMongoId)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ProcessRefundWaitingUnavailableByAdminPayload.prototype, "PInfoId", void 0);

package/payment-service/dto/refund/command/refund-waiting-buyer-action.dto.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @author sj
+ * @description 구매자가 환불 대기 건에서 상품 기다리기 또는 환불 받기를 선택할 때 사용하는 계약이다.
+ * @process PurchasedInfo 식별 → payment-service가 구매자 권한과 환불 대기 상태를 검증 → 액션 처리
+ */
+export declare class RefundWaitingBuyerActionPayload {
+    PInfoId: string;
+}

package/payment-service/dto/refund/command/refund-waiting-buyer-action.dto.js

@@ -0,0 +1,26 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundWaitingBuyerActionPayload = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * @author sj
+ * @description 구매자가 환불 대기 건에서 상품 기다리기 또는 환불 받기를 선택할 때 사용하는 계약이다.
+ * @process PurchasedInfo 식별 → payment-service가 구매자 권한과 환불 대기 상태를 검증 → 액션 처리
+ */
+class RefundWaitingBuyerActionPayload {
+}
+exports.RefundWaitingBuyerActionPayload = RefundWaitingBuyerActionPayload;
+__decorate([
+    (0, class_validator_1.IsMongoId)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RefundWaitingBuyerActionPayload.prototype, "PInfoId", void 0);

package/payment-service/dto/refund/query/check-refund-waiting-eligibility.dto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @author sj
+ * @description 선택한 환불 사유가 환불 대기 정책으로 분기되는지 조회하기 위한 요청/응답 계약이다.
+ * @process 결제 ID와 환불 사유 코드를 전달 → payment-service가 셀러 권한 및 주문 상태를 확인 → Boolean 결과 반환
+ */
+export declare class CheckRefundWaitingApplicabilityPayload {
+    /** 환불 대기 대상 여부를 확인할 PurchasedInfo ID */
+    PInfoId: string;
+    /** 셀러가 선택한 기존 환불 사유 코드. SELLER_0~2만 환불 대기 대상이다. */
+    refundTypeCode: string;
+}
+export declare class CheckRefundWaitingApplicabilityResult {
+    /** 선택한 사유로 환불을 요청하면 환불 대기 워크플로가 적용되는지 여부 */
+    isRefundWaitingApplicable: boolean;
+}

package/payment-service/dto/refund/query/check-refund-waiting-eligibility.dto.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckRefundWaitingApplicabilityResult = exports.CheckRefundWaitingApplicabilityPayload = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * @author sj
+ * @description 선택한 환불 사유가 환불 대기 정책으로 분기되는지 조회하기 위한 요청/응답 계약이다.
+ * @process 결제 ID와 환불 사유 코드를 전달 → payment-service가 셀러 권한 및 주문 상태를 확인 → Boolean 결과 반환
+ */
+class CheckRefundWaitingApplicabilityPayload {
+}
+exports.CheckRefundWaitingApplicabilityPayload = CheckRefundWaitingApplicabilityPayload;
+__decorate([
+    (0, class_validator_1.IsMongoId)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CheckRefundWaitingApplicabilityPayload.prototype, "PInfoId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CheckRefundWaitingApplicabilityPayload.prototype, "refundTypeCode", void 0);
+class CheckRefundWaitingApplicabilityResult {
+}
+exports.CheckRefundWaitingApplicabilityResult = CheckRefundWaitingApplicabilityResult;
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CheckRefundWaitingApplicabilityResult.prototype, "isRefundWaitingApplicable", void 0);

package/payment-service/dto/refund/query/index.d.ts

@@ -1,5 +1,6 @@
 export * from './get-refunds-analytics-aggregation-refunding-top3.dto';
 export * from './check-for-immediate-refund-availability-v2.dto';
+export * from './check-refund-waiting-eligibility.dto';
 export * from './get-refund-notice.dto';
 export * from './get-refunds-for-admin.dto';
 export * from './get-refund-errors-for-admin.dto';

package/payment-service/dto/refund/query/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./get-refunds-analytics-aggregation-refunding-top3.dto"), exports);
 __exportStar(require("./check-for-immediate-refund-availability-v2.dto"), exports);
+__exportStar(require("./check-refund-waiting-eligibility.dto"), exports);
 __exportStar(require("./get-refund-notice.dto"), exports);
 __exportStar(require("./get-refunds-for-admin.dto"), exports);
 __exportStar(require("./get-refund-errors-for-admin.dto"), exports);

package/payment-service/services/amqp.refund.service.d.ts

@@ -1,7 +1,7 @@
 import { ClientProxy } from '@nestjs/microservices';
 import { AbstractParam } from '@yolo-croket-dev/core';
-import { ReProcessNicepayBillingRefundByRefundErrorPayload, ReProcessTosspaymentsRefundByRefundErrorPayload, ResolveNicepayBillingRefundByRefundErrorPayload, ResolveTosspaymentsRefundByRefundErrorPayload } from '../dto';
-import { CheckForImmediateRefundAvailabilityV2Payload, CheckForImmediateRefundAvailabilityV2Result, GetRefundErrorsForAdminPayload, GetRefundsForAdminPayload, GetRefundsForAdminResult, GetRefundsAnalyticsAggregationRefundingTop3Payload, GetRefundsAnalyticsAggregationRefundingTop3Result, GetRefundNoticePayload, GetRefundNoticeResult } from '../dto/refund/query';
+import { ReProcessNicepayBillingRefundByRefundErrorPayload, ReProcessTosspaymentsRefundByRefundErrorPayload, ResolveNicepayBillingRefundByRefundErrorPayload, ResolveTosspaymentsRefundByRefundErrorPayload, RefundWaitingBuyerActionPayload, ProcessRefundWaitingUnavailableByAdminPayload } from '../dto';
+import { CheckForImmediateRefundAvailabilityV2Payload, CheckForImmediateRefundAvailabilityV2Result, CheckRefundWaitingApplicabilityPayload, CheckRefundWaitingApplicabilityResult, GetRefundErrorsForAdminPayload, GetRefundsForAdminPayload, GetRefundsForAdminResult, GetRefundsAnalyticsAggregationRefundingTop3Payload, GetRefundsAnalyticsAggregationRefundingTop3Result, GetRefundNoticePayload, GetRefundNoticeResult } from '../dto/refund/query';
 export declare class AmqpRefundService {
     private readonly client;
     private readonly amqpManager;
@@ -15,5 +15,13 @@ export declare class AmqpRefundService {
     getRefundsForAdmin(payload: GetRefundsForAdminPayload, param: AbstractParam): Promise<GetRefundsForAdminResult>;
     getRefundErrorsForAdmin(payload: GetRefundErrorsForAdminPayload, param: AbstractParam): Promise<GetRefundsForAdminResult>;
     checkForImmediateRefundAvailabilityV2(payload: CheckForImmediateRefundAvailabilityV2Payload, param: AbstractParam): Promise<CheckForImmediateRefundAvailabilityV2Result>;
+    /** 선택한 환불 사유에 환불 대기 정책이 적용되는지 조회한다. */
+    checkRefundWaitingApplicability(payload: CheckRefundWaitingApplicabilityPayload, param: AbstractParam): Promise<CheckRefundWaitingApplicabilityResult>;
+    /** 구매자의 상품 기다리기 선택을 처리한다. */
+    waitForRefundWaitingItem(payload: RefundWaitingBuyerActionPayload, param: AbstractParam): Promise<void>;
+    /** 구매자의 환불 받기 선택을 기존 일반 환불 프로세스로 전환한다. */
+    requestRefundFromWaiting(payload: RefundWaitingBuyerActionPayload, param: AbstractParam): Promise<void>;
+    /** 관리자의 환불 대기 이관 불가 처리를 실제 환불로 전환한다. */
+    processRefundWaitingUnavailableByAdmin(payload: ProcessRefundWaitingUnavailableByAdminPayload, param: AbstractParam): Promise<void>;
     getRefundNotice(payload: GetRefundNoticePayload, param: AbstractParam): Promise<GetRefundNoticeResult>;
 }

package/payment-service/services/amqp.refund.service.js

@@ -49,6 +49,22 @@ let AmqpRefundService = class AmqpRefundService {
     async checkForImmediateRefundAvailabilityV2(payload, param) {
         return this.amqpManager.call('환불 가능 여부 조회', 'refund.check-for-immediate-refund-availability-v2', payload, param, { isErrorThrowing: true });
     }
+    /** 선택한 환불 사유에 환불 대기 정책이 적용되는지 조회한다. */
+    async checkRefundWaitingApplicability(payload, param) {
+        return this.amqpManager.call('환불 대기 정책 적용 여부 조회', 'refund.check-refund-waiting-applicability', payload, param, { isErrorThrowing: true });
+    }
+    /** 구매자의 상품 기다리기 선택을 처리한다. */
+    async waitForRefundWaitingItem(payload, param) {
+        return this.amqpManager.call('구매자 상품 기다리기 선택', 'refund.waiting.wait-for-item', payload, param, { isErrorThrowing: true });
+    }
+    /** 구매자의 환불 받기 선택을 기존 일반 환불 프로세스로 전환한다. */
+    async requestRefundFromWaiting(payload, param) {
+        return this.amqpManager.call('구매자 환불 대기 환불 요청', 'refund.waiting.request-refund', payload, param, { isErrorThrowing: true });
+    }
+    /** 관리자의 환불 대기 이관 불가 처리를 실제 환불로 전환한다. */
+    async processRefundWaitingUnavailableByAdmin(payload, param) {
+        return this.amqpManager.call('관리자 환불 대기 이관 불가 처리', 'refund.waiting.process-unavailable-by-admin', payload, param, { isErrorThrowing: true });
+    }
     async getRefundNotice(payload, param) {
         return this.amqpManager.call('환불 안내 조회', 'refund.get.notice', payload, param, { isErrorThrowing: true });
     }

package/store-item-server/dto/store-item/command/edit-store-item.dto.d.ts

@@ -21,7 +21,7 @@ export declare class EditStoreItemUsedInfo {
     conditionGrade?: StoreItemUsedConditionGradeEnum | null;
     releasePriceInfo?: EditStoreItemUsedReleasePriceInfo | null;
 }
-declare const EditStoreItemBasePayload_base: import("@nestjs/mapped-types").MappedType<Omit<RegStoreItemPayload, "itemType" | "mainSku" | "usedItemInfo">>;
+declare const EditStoreItemBasePayload_base: import("@nestjs/mapped-types").MappedType<Omit<RegStoreItemPayload, "itemType" | "usedItemInfo" | "mainSku">>;
 declare class EditStoreItemBasePayload extends EditStoreItemBasePayload_base {
 }
 /**

package/store-item-server/dto/store-item/query/atlas-search/get-store-item-ids-by-atlas-search.dto.d.ts

@@ -49,6 +49,8 @@ export declare class GetStoreItemIdsByAtlasSearchPayload {
     DType?: GetStoreItemByAtlasDTypeEnum;
     /** 검색어 */
     inputText?: string;
+    /** OR 조건으로 함께 검색할 검색어 목록 */
+    inputTexts?: string[];
     /** 검색 키워드로 검색한 상품 리스트인가 */
     searchKeywordId?: string;
     /** 최소 가격 */

package/store-item-server/dto/store-item/query/atlas-search/get-store-item-ids-by-atlas-search.dto.js

@@ -112,6 +112,16 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], GetStoreItemIdsByAtlasSearchPayload.prototype, "inputText", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(7),
+    (0, class_validator_1.ArrayUnique)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.MinLength)(1, { each: true }),
+    __metadata("design:type", Array)
+], GetStoreItemIdsByAtlasSearchPayload.prototype, "inputTexts", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),