@yolo-croket-dev/entity-v2 0.3.58-beta.2 → 0.3.58-beta.4

package/buyma-order/buyma-order.entity.d.ts

@@ -0,0 +1,184 @@
+/** @author jun @description Buyma MVP의 주문·이력 영속 계약. @process 상품·사입·배송은 주문에 내장하고 변경 근거를 별도 저장한다. */
+import { Types } from 'mongoose';
+export declare const BUYMA_PAYMENT_STATUSES: readonly ["UNVERIFIED", "PENDING_PAYMENT", "PAID"];
+export type BuymaPaymentStatus = (typeof BUYMA_PAYMENT_STATUSES)[number];
+export declare const BUYMA_ORDER_STATUSES: readonly ["ORDER_CHECKING", "STOCK_CHECKING", "PREPARING_SHIPMENT", "LOCAL_IN_TRANSIT", "INTERNATIONAL_IN_TRANSIT", "DELIVERED", "REFUNDED"];
+export type BuymaOrderStatus = (typeof BUYMA_ORDER_STATUSES)[number];
+export declare const BUYMA_PROCUREMENT_WORK_STATUSES: readonly ["UNSPECIFIED", "NOT_REQUIRED", "SELLER_DIRECT_INQUIRY", "STOCK_INQUIRY", "ALTERNATIVE_STOCK_CHECK", "EXTRA_PAYMENT_INQUIRY", "OPTION_CHANGE_INQUIRY", "PROCURED", "ALTERNATIVE_PROCURED", "ISSUE"];
+export type BuymaProcurementWorkStatus = (typeof BUYMA_PROCUREMENT_WORK_STATUSES)[number];
+export interface BuymaMoney {
+    amount: number;
+    currency: string;
+}
+export interface BuymaBuyer {
+    buymaBuyerId: string | null;
+    name: string | null;
+}
+export interface BuymaRecipient {
+    name: string | null;
+    phone: string | null;
+    countryCode: string | null;
+    postalCode: string | null;
+    address1: string | null;
+    address2: string | null;
+    address3: string | null;
+    address4: string | null;
+}
+export interface BuymaProductSnapshot {
+    buymaProductId: string | null;
+    croketItemId: Types.ObjectId | null;
+    storeName: string | null;
+    sourceCountry: string | null;
+    croketName: string | null;
+    buymaName: string | null;
+    brandName: string | null;
+    optionName: string | null;
+    weightGrams: number | null;
+    croketItemUrl: string | null;
+    buymaItemUrl: string | null;
+}
+export interface BuymaPayment {
+    status: BuymaPaymentStatus;
+    reportedStatus: string | null;
+    preOrderedAt: Date | null;
+    paidAt: Date | null;
+    confirmationSource: 'BUYMA_ORDERED_AT' | 'ADMIN' | null;
+    confirmedAt: Date | null;
+    confirmedBy: Types.ObjectId | null;
+    evidence: string | null;
+}
+export interface BuymaLocalShipment {
+    invoiceRegisteredAt: Date | null;
+    carrierName: string | null;
+    trackingNumber: string | null;
+}
+/** 실제 배정만 ACTIVE로 기록한다. 기존 미검증 자료는 null을 유지한다. */
+export type BuymaProcurementAllocationStatus = 'ACTIVE' | 'RELEASED';
+export interface BuymaProcurementLockEntity {
+    _id: Types.ObjectId;
+    revision: number;
+}
+export interface BuymaProcurement {
+    allocationStatus?: BuymaProcurementAllocationStatus | null;
+    croketOptionName?: string | null;
+    source: 'CROKET' | 'MANUAL';
+    orderUrl: string;
+    croketPurchaseReceiptId: Types.ObjectId | null;
+    croketPurchasedInfoId: Types.ObjectId | null;
+    croketPurchasedInfoPublicId: string | null;
+    /** 원래 완료된 결제의 개당 기본 상품 가격. */
+    croketProductPrice: BuymaMoney | null;
+    /** 선택 구매 건에 청구한 배송비. */
+    croketShippingCost: BuymaMoney | null;
+    /** 시트 AG 대응 금액. 위 두 금액의 합으로 덮어쓰지 않는다. */
+    purchaseCost: BuymaMoney | null;
+    sellerSettlementCost: BuymaMoney | null;
+    sourceStatus: string | null;
+    localShipment: BuymaLocalShipment | null;
+}
+export interface BuymaInternationalShipment {
+    carrierName: string;
+    trackingNumber: string;
+    trackingUrl: string | null;
+    /** 운송장 전체 금액이 아닌 해당 주문에 배분한 비용. */
+    shippingCost: BuymaMoney | null;
+    deliveredAt: Date | null;
+    deliveryEvidence: string | null;
+}
+export interface BuymaCommunications {
+    stockSecuredNotified: boolean | null;
+    forwarderDispatchNotified: boolean | null;
+}
+export interface BuymaRefundRecord {
+    amount: BuymaMoney;
+    refundedAt: Date;
+    evidence: string;
+}
+export interface BuymaLegacySettlement {
+    appliedExchangeRate: string | null;
+    exchangeRateUnit: string | null;
+    feeRateText: string | null;
+    buymaFee: BuymaMoney | null;
+    sellerSettlementJPY: BuymaMoney | null;
+    productMargin: BuymaMoney | null;
+    productMarginRate: string | null;
+    shippingFee: BuymaMoney | null;
+    outboundShippingJPY: BuymaMoney | null;
+    shippingMargin: BuymaMoney | null;
+    shippingMarginRate: string | null;
+    totalMargin: BuymaMoney | null;
+    totalMarginRate: string | null;
+    memo: string | null;
+}
+export interface BuymaRecipientChange {
+    status: 'PENDING' | 'APPLIED' | 'UNVERIFIED';
+    reportedStatus: string | null;
+    sourceOrderStatus: string | null;
+    previousAddress: string | null;
+    previousPhone: string | null;
+    requestedAddress: string | null;
+    requestedPhone: string | null;
+}
+export interface BuymaLegacySheetData {
+    sourceRecordedLocalDate: string | null;
+    sourceDispatchDate: string | null;
+    sourceDeliveredDate: string | null;
+    sourceOrderStatus: string | null;
+    sourceProcurementWorkStatus: string | null;
+    legacySettlement: BuymaLegacySettlement | null;
+    recipientChange: BuymaRecipientChange | null;
+}
+export interface BuymaOrderEntity {
+    _id: Types.ObjectId;
+    buymaAccountId: string;
+    buymaOrderNumber: string;
+    buymaOrderUrl: string | null;
+    buyer: BuymaBuyer;
+    recipient: BuymaRecipient | null;
+    productSnapshot: BuymaProductSnapshot;
+    quantity: number;
+    productRevenue: BuymaMoney | null;
+    shippingRevenue: BuymaMoney | null;
+    reportedTotalRevenue: BuymaMoney | null;
+    payment: BuymaPayment;
+    /** null은 상태를 매핑하지 못한 기존 시트 주문에만 허용한다. */
+    orderStatus: BuymaOrderStatus | null;
+    procurementWorkStatus: BuymaProcurementWorkStatus;
+    procurement: BuymaProcurement | null;
+    internationalShipment: BuymaInternationalShipment | null;
+    communications: BuymaCommunications;
+    refundRecord: BuymaRefundRecord | null;
+    holdReason: string | null;
+    memo: string | null;
+    slackThreadUrls: string[];
+    revision: number;
+    createdAt: Date;
+    updatedAt: Date;
+    legacySheetData: BuymaLegacySheetData | null;
+}
+export type BuymaJsonValue = string | number | boolean | null | BuymaJsonValue[] | {
+    [key: string]: BuymaJsonValue;
+};
+export interface BuymaFieldChange {
+    field: string;
+    before: BuymaJsonValue;
+    after: BuymaJsonValue;
+}
+export interface BuymaOrderEventEntity {
+    _id: Types.ObjectId;
+    orderId: Types.ObjectId | null;
+    buymaAccountId: string;
+    buymaOrderNumber: string;
+    source: 'BUYMA_WEBHOOK' | 'ADMIN' | 'SHEET_IMPORT';
+    eventId: string;
+    eventType: string;
+    receivedAt: Date;
+    actorId: Types.ObjectId | null;
+    changes: BuymaFieldChange[];
+    reason: string | null;
+    payload: {
+        [key: string]: BuymaJsonValue;
+    } | null;
+    result: 'APPLIED' | 'FAILED' | 'EXCLUDED';
+    errorMessage: string | null;
+}

package/buyma-order/buyma-order.entity.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUYMA_PROCUREMENT_WORK_STATUSES = exports.BUYMA_ORDER_STATUSES = exports.BUYMA_PAYMENT_STATUSES = void 0;
+exports.BUYMA_PAYMENT_STATUSES = [
+    'UNVERIFIED',
+    'PENDING_PAYMENT',
+    'PAID',
+];
+exports.BUYMA_ORDER_STATUSES = [
+    'ORDER_CHECKING',
+    'STOCK_CHECKING',
+    'PREPARING_SHIPMENT',
+    'LOCAL_IN_TRANSIT',
+    'INTERNATIONAL_IN_TRANSIT',
+    'DELIVERED',
+    'REFUNDED',
+];
+exports.BUYMA_PROCUREMENT_WORK_STATUSES = [
+    'UNSPECIFIED',
+    'NOT_REQUIRED',
+    'SELLER_DIRECT_INQUIRY',
+    'STOCK_INQUIRY',
+    'ALTERNATIVE_STOCK_CHECK',
+    'EXTRA_PAYMENT_INQUIRY',
+    'OPTION_CHANGE_INQUIRY',
+    'PROCURED',
+    'ALTERNATIVE_PROCURED',
+    'ISSUE',
+];

package/buyma-order/index.d.ts

@@ -0,0 +1 @@
+export * from './buyma-order.entity';

package/buyma-order/index.js

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./buyma-order.entity"), exports);

package/index.d.ts

@@ -86,3 +86,4 @@ export * from './store-pending-settle';
 export * from './admin-settlement-limit';
 export * from './settle-adjustment-plan';
 export * from './notification-campaign';
+export * from './buyma-order';

package/index.js

@@ -100,3 +100,4 @@ __exportStar(require("./store-pending-settle"), exports);
 __exportStar(require("./admin-settlement-limit"), exports);
 __exportStar(require("./settle-adjustment-plan"), exports);
 __exportStar(require("./notification-campaign"), exports);
+__exportStar(require("./buyma-order"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/entity-v2",
-  "version": "0.3.58-beta.2",
+  "version": "0.3.58-beta.4",
   "main": "index.js",
   "author": "Yolo Co., Ltd.",
   "description": "크로켓 nest 용 entity-v3",
@@ -23,4 +23,4 @@
   },
   "license": "UNLICENSED",
   "dependencies": {}
-}
+}