@sayren/store-sdk 0.29.3 → 0.29.5

package/dist/index.d.mts

@@ -213,11 +213,11 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
+  UNKNOWN: "UNKNOWN";
   PENDING: "PENDING";
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
   EXECUTING: "EXECUTING";
-  UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
   EXPIRED: "EXPIRED";
 }>;
@@ -225,11 +225,11 @@ export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
-    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
     EXPIRED: "EXPIRED";
   }>;
@@ -287,11 +287,11 @@ export declare const approvalRequestSchema: z.ZodObject<{
 export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
 export declare const approvalListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodEnum<{
+    UNKNOWN: "UNKNOWN";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
-    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
     EXPIRED: "EXPIRED";
   }>>>>;
@@ -306,11 +306,11 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
+      UNKNOWN: "UNKNOWN";
       PENDING: "PENDING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
-      UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
       EXPIRED: "EXPIRED";
     }>;
@@ -448,11 +448,11 @@ export declare const analyticsTotalsSchema: z.ZodObject<{
 export type AnalyticsTotals = z.infer<typeof analyticsTotalsSchema>;
 export declare const analyticsFunnelStepSchema: z.ZodObject<{
   step: z.ZodEnum<{
-    PURCHASE: "PURCHASE";
     SESSION: "SESSION";
     PRODUCT_VIEW: "PRODUCT_VIEW";
     ADD_TO_CART: "ADD_TO_CART";
     BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
+    PURCHASE: "PURCHASE";
   }>;
   sessions: z.ZodNumber;
   rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -477,11 +477,11 @@ export declare const analyticsOverviewSchema: z.ZodObject<{
   }, z.core.$strip>;
   funnel: z.ZodArray<z.ZodObject<{
     step: z.ZodEnum<{
-      PURCHASE: "PURCHASE";
       SESSION: "SESSION";
       PRODUCT_VIEW: "PRODUCT_VIEW";
       ADD_TO_CART: "ADD_TO_CART";
       BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
+      PURCHASE: "PURCHASE";
     }>;
     sessions: z.ZodNumber;
     rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -581,20 +581,20 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
-  PAID: "PAID";
   DIRECT: "DIRECT";
-  CAMPAIGN: "CAMPAIGN";
-  UNKNOWN: "UNKNOWN";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
+  PAID: "PAID";
   EMAIL: "EMAIL";
+  CAMPAIGN: "CAMPAIGN";
   REFERRAL: "REFERRAL";
+  UNKNOWN: "UNKNOWN";
 }>;
 export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
 export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
+  CAMPAIGN: "CAMPAIGN";
   CHANNEL: "CHANNEL";
   SOURCE: "SOURCE";
-  CAMPAIGN: "CAMPAIGN";
   DEVICE: "DEVICE";
 }>;
 export type AnalyticsSourceGroupBy = z.infer<typeof analyticsSourceGroupBySchema>;
@@ -606,23 +606,23 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
     false: "false";
   }>>;
   groupBy: z.ZodOptional<z.ZodEnum<{
+    CAMPAIGN: "CAMPAIGN";
     CHANNEL: "CHANNEL";
     SOURCE: "SOURCE";
-    CAMPAIGN: "CAMPAIGN";
     DEVICE: "DEVICE";
   }>>;
 }, z.core.$strip>;
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
-    PAID: "PAID";
     DIRECT: "DIRECT";
-    CAMPAIGN: "CAMPAIGN";
-    UNKNOWN: "UNKNOWN";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
+    PAID: "PAID";
     EMAIL: "EMAIL";
+    CAMPAIGN: "CAMPAIGN";
     REFERRAL: "REFERRAL";
+    UNKNOWN: "UNKNOWN";
   }>>;
   source: z.ZodNullable<z.ZodString>;
   medium: z.ZodNullable<z.ZodString>;
@@ -644,21 +644,21 @@ export declare const analyticsSourceRowSchema: z.ZodObject<{
 export type AnalyticsSourceRow = z.infer<typeof analyticsSourceRowSchema>;
 export declare const analyticsSourcesSchema: z.ZodObject<{
   groupBy: z.ZodEnum<{
+    CAMPAIGN: "CAMPAIGN";
     CHANNEL: "CHANNEL";
     SOURCE: "SOURCE";
-    CAMPAIGN: "CAMPAIGN";
     DEVICE: "DEVICE";
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
-      PAID: "PAID";
       DIRECT: "DIRECT";
-      CAMPAIGN: "CAMPAIGN";
-      UNKNOWN: "UNKNOWN";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
+      PAID: "PAID";
       EMAIL: "EMAIL";
+      CAMPAIGN: "CAMPAIGN";
       REFERRAL: "REFERRAL";
+      UNKNOWN: "UNKNOWN";
     }>>;
     source: z.ZodNullable<z.ZodString>;
     medium: z.ZodNullable<z.ZodString>;
@@ -807,12 +807,12 @@ export declare const analyticsSearchSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsSearch = z.infer<typeof analyticsSearchSchema>;
 export declare const analyticsCheckoutOutcomeSchema: z.ZodEnum<{
-  OTHER: "OTHER";
   COMPLETED: "COMPLETED";
   NOT_OPENED: "NOT_OPENED";
   USER_CANCELED: "USER_CANCELED";
   DECLINED: "DECLINED";
   PREPARE_FAILURE: "PREPARE_FAILURE";
+  OTHER: "OTHER";
   IN_PROGRESS: "IN_PROGRESS";
 }>;
 export type AnalyticsCheckoutOutcome = z.infer<typeof analyticsCheckoutOutcomeSchema>;
@@ -820,12 +820,12 @@ export declare const analyticsCheckoutSchema: z.ZodObject<{
   sessions: z.ZodNumber;
   outcomes: z.ZodArray<z.ZodObject<{
     outcome: z.ZodEnum<{
-      OTHER: "OTHER";
       COMPLETED: "COMPLETED";
       NOT_OPENED: "NOT_OPENED";
       USER_CANCELED: "USER_CANCELED";
       DECLINED: "DECLINED";
       PREPARE_FAILURE: "PREPARE_FAILURE";
+      OTHER: "OTHER";
       IN_PROGRESS: "IN_PROGRESS";
     }>;
     sessions: z.ZodNumber;
@@ -1264,6 +1264,7 @@ export declare const claimTypeSchema: z.ZodEnum<{
 }>;
 export type ClaimType = z.infer<typeof claimTypeSchema>;
 export declare const claimStatusSchema: z.ZodEnum<{
+  COMPLETED: "COMPLETED";
   REJECTED: "REJECTED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
@@ -1271,7 +1272,6 @@ export declare const claimStatusSchema: z.ZodEnum<{
   COLLECTED: "COLLECTED";
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
-  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1308,6 +1308,7 @@ export declare const claimSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1315,7 +1316,6 @@ export declare const claimSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1397,6 +1397,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1404,7 +1405,6 @@ export declare const claimDetailSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1455,6 +1455,7 @@ export declare const claimDetailSchema: z.ZodObject<{
   }, z.core.$strip>>;
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -1462,7 +1463,6 @@ export declare const claimDetailSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -1530,7 +1530,7 @@ export declare const COLLECTION_SLUG_PATTERN: RegExp;
 export declare const COLLECTION_TYPES: readonly ["MANUAL", "AUTOMATIC"];
 export type CollectionType = (typeof COLLECTION_TYPES)[number];
 /**
- * 상품 정렬 — `MANUAL`은 직접 정한 순서(직접 선택 컬렉션만)다. `BEST_SELLING`(판매량순)은 판매량 집계가 열릴 때 받는다.
+ * 상품 정렬 — `MANUAL`은 직접 정한 순서(직접 선택 컬렉션만)다. `BEST_SELLING`(판매량순)은 판매 수량이 많은 순이다(M3).
  * 저장 값 전체 목록이고, 쓰기에서 받는 값은 `collectionProductSortRequestSchema`다.
  */
 export declare const COLLECTION_PRODUCT_SORTS: readonly ["MANUAL", "LATEST", "BEST_SELLING", "PRICE_ASC", "PRICE_DESC", "REVIEW_COUNT", "RATING_DESC", "RECOMMEND"];
@@ -1540,6 +1540,7 @@ export declare const collectionProductSortRequestSchema: z.ZodEnum<{
   PRICE_DESC: "PRICE_DESC";
   MANUAL: "MANUAL";
   LATEST: "LATEST";
+  BEST_SELLING: "BEST_SELLING";
   REVIEW_COUNT: "REVIEW_COUNT";
   RATING_DESC: "RATING_DESC";
   RECOMMEND: "RECOMMEND";
@@ -1566,9 +1567,17 @@ export declare const MAX_COLLECTION_RULE_CATEGORIES = 20;
 export declare const MAX_COLLECTION_CREATED_WITHIN_DAYS = 365;
 /** 미리보기(`POST /v1/collections/preview`)가 싣는 상품 최대 개수 */
 export declare const COLLECTION_PREVIEW_SIZE = 20;
+/** 판매량 상위 조건의 기간 선택지(일, 오늘 포함 한국 날짜) */
+export declare const COLLECTION_BEST_SELLING_DAYS: readonly [7, 30, 90];
+export type CollectionBestSellingDays = (typeof COLLECTION_BEST_SELLING_DAYS)[number];
+/** 판매량 상위 조건이 담는 상품 최대 개수 */
+export declare const MAX_COLLECTION_BEST_SELLING_TOP = 100;
+/** 판매량순(`BEST_SELLING`) 정렬의 기간 — 판매량 상위 조건이 없을 때 쓴다 */
+export declare const COLLECTION_SALES_SORT_DEFAULT_DAYS: CollectionBestSellingDays;
 /**
  * 조건 하나 — `field`로 가른다. 가격은 즉시할인을 반영한 판매가(`discountedPrice ?? salePrice`)다.
- * 판매량 상위(`bestSelling`)는 판매량 집계가 열릴 때 더한다.
+ * 판매량 상위(`bestSelling`)는 술어가 아니라 순위 자르기다. 다른 조건을 모두 만족한 상품 중 판매 수량 상위 N개만 남긴다(`rankBestSelling`).
+ * 판매 수량은 실결제 주문의 결제 수량에서 취소·반품 수량을 뺀 값이고, 날짜는 주문 시각의 한국 날짜다. 집계는 최대 10분 늦다.
  */
 export declare const collectionRuleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   field: z.ZodLiteral<"createdWithinDays">;
@@ -1583,6 +1592,10 @@ export declare const collectionRuleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
 }, z.core.$strip>, z.ZodObject<{
   field: z.ZodLiteral<"discounted">;
   value: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+  field: z.ZodLiteral<"bestSelling">;
+  days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+  top: z.ZodNumber;
 }, z.core.$strip>], "field">;
 export type CollectionRule = z.infer<typeof collectionRuleSchema>;
 export type CollectionRuleField = CollectionRule["field"];
@@ -1600,6 +1613,10 @@ export declare const collectionRulesSchema: z.ZodArray<z.ZodDiscriminatedUnion<[
 }, z.core.$strip>, z.ZodObject<{
   field: z.ZodLiteral<"discounted">;
   value: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+  field: z.ZodLiteral<"bestSelling">;
+  days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+  top: z.ZodNumber;
 }, z.core.$strip>], "field">>;
 /**
  * 응답의 조건 — 이 SDK가 아는 조건이거나 뒤에 더해질 조건(`field`만 확인한다)이다. 새 조건이 생겨도 옛 SDK의 응답 검증이 깨지지 않는다.
@@ -1617,6 +1634,10 @@ export declare const collectionRuleViewSchema: z.ZodUnion<readonly [z.ZodObject<
 }, z.core.$strip>, z.ZodObject<{
   field: z.ZodLiteral<"discounted">;
   value: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+  field: z.ZodLiteral<"bestSelling">;
+  days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+  top: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
   field: z.ZodString;
 }, z.core.$loose>]>;
@@ -1643,11 +1664,33 @@ export declare function descendantCategoryIdsOf(roots: readonly string[], catego
 /**
  * 조건 판정 함수를 만든다 — 모든 조건을 만족해야 true다(AND). 카테고리 트리는 여기서 한 번만 푼다.
  * 알 수 없는 조건(`field`)은 만족하지 않는 것으로 본다. 모르는 조건을 건너뛰면 상품이 예고 없이 늘어난다.
+ * 판매량 상위(`bestSelling`)는 여기서 모두 통과시킨다. 순위 자르기는 판매량을 아는 호출부가 `rankBestSelling`으로 한다.
  * 판매 상태는 보지 않는다. 판매 중만 거르는 것은 호출부다.
  */
 export declare function collectionRulesPredicate(rules: readonly CollectionRuleView[], context: CollectionRuleContext): (product: CollectionRuleProduct) => boolean;
 /** 상품 하나가 조건을 모두 만족하는가 — 여러 상품을 판정할 때는 `collectionRulesPredicate`를 한 번 만들어 쓴다 */
 export declare function matchesCollectionRules(product: CollectionRuleProduct, rules: readonly CollectionRuleView[], context: CollectionRuleContext): boolean;
+/** 판매량 상위 조건 — 없으면 null. 같은 조건은 한 번만 쓰므로 첫 번째다 */
+export declare function bestSellingRuleOf(rules: readonly CollectionRuleView[]): {
+  days: CollectionBestSellingDays;
+  top: number;
+} | null;
+/**
+ * 판매량 비교 — 판매 수량이 많은 순, 같으면 최근 등록 순, 그것도 같으면 상품 id 순이다. 결과가 입력 순서에 기대지 않는다.
+ * `sales`에 없는 상품은 0개다.
+ */
+export declare function compareBySales<T extends {
+  productId: string;
+  createdAt: string;
+}>(sales: ReadonlyMap<string, number>): (a: T, b: T) => number;
+/**
+ * 판매량 상위 자르기 — 다른 조건을 통과한 상품 중 판매 수량이 1개 이상인 상품을 `compareBySales` 순으로 `top`개 남긴다.
+ * 판매가 없는 상품은 넣지 않는다.
+ */
+export declare function rankBestSelling<T extends {
+  productId: string;
+  createdAt: string;
+}>(products: readonly T[], sales: ReadonlyMap<string, number>, top: number): T[];
 /** 조건이 참조하는 카테고리 id — 카테고리 삭제의 참조 검사에 쓴다 */
 export declare function collectionRuleCategoryIds(rules: readonly CollectionRuleView[]): string[];
 export declare const collectionSchema: z.ZodObject<{
@@ -1671,6 +1714,10 @@ export declare const collectionSchema: z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     field: z.ZodLiteral<"discounted">;
     value: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    field: z.ZodLiteral<"bestSelling">;
+    days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+    top: z.ZodNumber;
   }, z.core.$strip>, z.ZodObject<{
     field: z.ZodString;
   }, z.core.$loose>]>>>;
@@ -1686,6 +1733,7 @@ export declare const collectionSchema: z.ZodObject<{
     SCHEDULED: "SCHEDULED";
     HIDDEN: "HIDDEN";
   }>;
+  salesComputedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
   productCount: z.ZodNumber;
   revision: z.ZodNumber;
   createdAt: z.ZodString;
@@ -1695,7 +1743,7 @@ export type Collection = z.infer<typeof collectionSchema>;
 /**
  * `POST /v1/collections` — 컬렉션을 만든다. `slug`를 생략하면 `c-{id 뒤 8자}`로 만든다.
  * 직접 선택(`MANUAL`)은 `productIds`가 처음 담을 상품과 순서다. 조건 자동(`AUTOMATIC`)은 `rules`가 있어야 하고 `productIds`를 받지 않는다.
- * `productSort`를 생략하면 직접 선택은 `MANUAL`, 조건 자동은 `LATEST`다. 조건 자동은 `MANUAL`을 쓸 수 없다.
+ * `productSort`를 생략하면 직접 선택은 `MANUAL`, 조건 자동은 `LATEST`(판매량 상위 조건이 있으면 `BEST_SELLING`)다. 조건 자동은 `MANUAL`을 쓸 수 없다.
  */
 export declare const collectionCreateRequestSchema: z.ZodObject<{
   title: z.ZodString;
@@ -1717,6 +1765,10 @@ export declare const collectionCreateRequestSchema: z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     field: z.ZodLiteral<"discounted">;
     value: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    field: z.ZodLiteral<"bestSelling">;
+    days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+    top: z.ZodNumber;
   }, z.core.$strip>], "field">>>;
   description: z.ZodDefault<z.ZodString>;
   imageUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
@@ -1725,6 +1777,7 @@ export declare const collectionCreateRequestSchema: z.ZodObject<{
     PRICE_DESC: "PRICE_DESC";
     MANUAL: "MANUAL";
     LATEST: "LATEST";
+    BEST_SELLING: "BEST_SELLING";
     REVIEW_COUNT: "REVIEW_COUNT";
     RATING_DESC: "RATING_DESC";
     RECOMMEND: "RECOMMEND";
@@ -1760,6 +1813,10 @@ export declare const collectionPatchRequestSchema: z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     field: z.ZodLiteral<"discounted">;
     value: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    field: z.ZodLiteral<"bestSelling">;
+    days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+    top: z.ZodNumber;
   }, z.core.$strip>], "field">>>;
   description: z.ZodOptional<z.ZodString>;
   imageUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
@@ -1768,6 +1825,7 @@ export declare const collectionPatchRequestSchema: z.ZodObject<{
     PRICE_DESC: "PRICE_DESC";
     MANUAL: "MANUAL";
     LATEST: "LATEST";
+    BEST_SELLING: "BEST_SELLING";
     REVIEW_COUNT: "REVIEW_COUNT";
     RATING_DESC: "RATING_DESC";
     RECOMMEND: "RECOMMEND";
@@ -1837,6 +1895,10 @@ export declare const collectionPageSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
       field: z.ZodLiteral<"discounted">;
       value: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+      field: z.ZodLiteral<"bestSelling">;
+      days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+      top: z.ZodNumber;
     }, z.core.$strip>, z.ZodObject<{
       field: z.ZodString;
     }, z.core.$loose>]>>>;
@@ -1852,6 +1914,7 @@ export declare const collectionPageSchema: z.ZodObject<{
       SCHEDULED: "SCHEDULED";
       HIDDEN: "HIDDEN";
     }>;
+    salesComputedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     productCount: z.ZodNumber;
     revision: z.ZodNumber;
     createdAt: z.ZodString;
@@ -1909,12 +1972,17 @@ export declare const collectionPreviewRequestSchema: z.ZodObject<{
   }, z.core.$strip>, z.ZodObject<{
     field: z.ZodLiteral<"discounted">;
     value: z.ZodLiteral<true>;
+  }, z.core.$strip>, z.ZodObject<{
+    field: z.ZodLiteral<"bestSelling">;
+    days: z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>;
+    top: z.ZodNumber;
   }, z.core.$strip>], "field">>;
   productSort: z.ZodOptional<z.ZodEnum<{
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
     MANUAL: "MANUAL";
     LATEST: "LATEST";
+    BEST_SELLING: "BEST_SELLING";
     REVIEW_COUNT: "REVIEW_COUNT";
     RATING_DESC: "RATING_DESC";
     RECOMMEND: "RECOMMEND";
@@ -1933,6 +2001,7 @@ export declare const collectionPreviewSchema: z.ZodObject<{
     position: z.ZodNumber;
     addedAt: z.ZodString;
   }, z.core.$strip>>;
+  salesComputedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type CollectionPreview = z.infer<typeof collectionPreviewSchema>;
 //#endregion
@@ -2526,10 +2595,10 @@ export type CustomerOrder = z.infer<typeof customerOrderSchema>;
 /** `POST /v1/customers/{id}/withdraw` 본문 */
 export declare const withdrawCustomerRequestSchema: z.ZodObject<{
   reason: z.ZodEnum<{
+    OTHER: "OTHER";
     BUYER_REQUEST: "BUYER_REQUEST";
     DORMANT: "DORMANT";
     ABUSE: "ABUSE";
-    OTHER: "OTHER";
   }>;
   memo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -3263,8 +3332,8 @@ export declare function requiresCollection(type: string | null | undefined): boo
 export declare const NO_SHIPPING_BUNDLE_KEY = "none";
 /** 배송비 유형 — 무료·유료·조건부 무료 */
 export declare const deliveryTypeSchema: z.ZodEnum<{
-  FREE: "FREE";
   PAID: "PAID";
+  FREE: "FREE";
   CONDITIONAL_FREE: "CONDITIONAL_FREE";
 }>;
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -3275,8 +3344,8 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodOptional<z.ZodObject<{
     deliveryType: z.ZodDefault<z.ZodEnum<{
-      FREE: "FREE";
       PAID: "PAID";
+      FREE: "FREE";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>>;
     deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -3298,8 +3367,8 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      FREE: "FREE";
       PAID: "PAID";
+      FREE: "FREE";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3319,8 +3388,8 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      FREE: "FREE";
       PAID: "PAID";
+      FREE: "FREE";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3358,8 +3427,8 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      FREE: "FREE";
       PAID: "PAID";
+      FREE: "FREE";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3878,16 +3947,16 @@ export interface OrderItemListParams extends PageParams {
   testPayment?: "true" | "false";
 }
 export declare const deliveryMethodSchema: z.ZodEnum<{
-  COURIER: "COURIER";
   DIRECT: "DIRECT";
+  COURIER: "COURIER";
   QUICK: "QUICK";
   NOTHING: "NOTHING";
 }>;
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 export declare const dispatchRequestSchema: z.ZodObject<{
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3899,8 +3968,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 export declare const deliveryInfoSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3926,8 +3995,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
 export declare const deliveryStatusSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -5273,11 +5342,11 @@ export type PointEntry = z.infer<typeof pointEntrySchema>;
 export declare const pointLotSchema: z.ZodObject<{
   lotId: z.ZodString;
   source: z.ZodUnion<readonly [z.ZodEnum<{
+    PURCHASE: "PURCHASE";
     REFUND_RESTORE: "REFUND_RESTORE";
     ADJUST: "ADJUST";
     OPENING: "OPENING";
     REVIEW: "REVIEW";
-    PURCHASE: "PURCHASE";
   }>, z.ZodString]>;
   amount: z.ZodNumber;
   remaining: z.ZodNumber;
@@ -5292,11 +5361,11 @@ export declare const customerPointsSchema: z.ZodObject<{
   lots: z.ZodArray<z.ZodObject<{
     lotId: z.ZodString;
     source: z.ZodUnion<readonly [z.ZodEnum<{
+      PURCHASE: "PURCHASE";
       REFUND_RESTORE: "REFUND_RESTORE";
       ADJUST: "ADJUST";
       OPENING: "OPENING";
       REVIEW: "REVIEW";
-      PURCHASE: "PURCHASE";
     }>, z.ZodString]>;
     amount: z.ZodNumber;
     remaining: z.ZodNumber;
@@ -5656,8 +5725,8 @@ export declare const productSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        FREE: "FREE";
         PAID: "PAID";
+        FREE: "FREE";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -5879,8 +5948,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodOptional<z.ZodObject<{
       deliveryType: z.ZodDefault<z.ZodEnum<{
-        FREE: "FREE";
         PAID: "PAID";
+        FREE: "FREE";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>>;
       deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -5965,8 +6034,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        FREE: "FREE";
         PAID: "PAID";
+        FREE: "FREE";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -6059,8 +6128,8 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        FREE: "FREE";
         PAID: "PAID";
+        FREE: "FREE";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -6084,9 +6153,9 @@ export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
-  "updatedAt.desc": "updatedAt.desc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
+  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -6112,9 +6181,9 @@ export declare const productListQuerySchema: z.ZodObject<{
   sort: z.ZodOptional<z.ZodEnum<{
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
-    "updatedAt.desc": "updatedAt.desc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
+    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -7021,9 +7090,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
 export declare const storefrontDeploymentSchema: z.ZodObject<{
   siteId: z.ZodString;
   status: z.ZodEnum<{
+    IN_PROGRESS: "IN_PROGRESS";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
-    IN_PROGRESS: "IN_PROGRESS";
   }>;
   url: z.ZodString;
   startedAt: z.ZodString;
@@ -7481,8 +7550,8 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
 export declare const storefrontCheckStatusSchema: z.ZodEnum<{
-  FAILED: "FAILED";
   UNKNOWN: "UNKNOWN";
+  FAILED: "FAILED";
   RUNNING: "RUNNING";
   QUEUED: "QUEUED";
   PASSED: "PASSED";
@@ -7495,8 +7564,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
   checkId: z.ZodString;
   check: z.ZodString;
   status: z.ZodEnum<{
-    FAILED: "FAILED";
     UNKNOWN: "UNKNOWN";
+    FAILED: "FAILED";
     RUNNING: "RUNNING";
     QUEUED: "QUEUED";
     PASSED: "PASSED";
@@ -8317,7 +8386,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8415,7 +8484,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8513,7 +8582,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
+          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8853,6 +8922,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         } | {
           field: "discounted";
           value: true;
+        } | {
+          field: "bestSelling";
+          days: 7 | 30 | 90;
+          top: number;
         } | {
           [x: string]: unknown;
           field: string;
@@ -8864,6 +8937,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         metaTitle: string | null;
         metaDescription: string | null;
         state: "ACTIVE" | "ENDED" | "SCHEDULED" | "HIDDEN";
+        salesComputedAt: string | null;
         productCount: number;
         revision: number;
         createdAt: string;
@@ -8898,6 +8972,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 7 | 30 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8909,6 +8987,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaTitle: string | null;
       metaDescription: string | null;
       state: "ACTIVE" | "ENDED" | "SCHEDULED" | "HIDDEN";
+      salesComputedAt: string | null;
       productCount: number;
       revision: number;
       createdAt: string;
@@ -8936,6 +9015,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 7 | 30 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8947,6 +9030,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaTitle: string | null;
       metaDescription: string | null;
       state: "ACTIVE" | "ENDED" | "SCHEDULED" | "HIDDEN";
+      salesComputedAt: string | null;
       productCount: number;
       revision: number;
       createdAt: string;
@@ -8973,6 +9057,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 7 | 30 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8984,6 +9072,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaTitle: string | null;
       metaDescription: string | null;
       state: "ACTIVE" | "ENDED" | "SCHEDULED" | "HIDDEN";
+      salesComputedAt: string | null;
       productCount: number;
       revision: number;
       createdAt: string;
@@ -9031,6 +9120,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 7 | 30 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -9042,6 +9135,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaTitle: string | null;
       metaDescription: string | null;
       state: "ACTIVE" | "ENDED" | "SCHEDULED" | "HIDDEN";
+      salesComputedAt: string | null;
       productCount: number;
       revision: number;
       createdAt: string;
@@ -9069,6 +9163,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 7 | 30 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -9080,6 +9178,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaTitle: string | null;
       metaDescription: string | null;
       state: "ACTIVE" | "ENDED" | "SCHEDULED" | "HIDDEN";
+      salesComputedAt: string | null;
       productCount: number;
       revision: number;
       createdAt: string;
@@ -9098,6 +9197,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         position: number;
         addedAt: string;
       }[];
+      salesComputedAt: string | null;
     }>;
   };
   categories: {
@@ -9506,7 +9606,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
+      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9668,7 +9768,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
+      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9706,7 +9806,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         claimId: string;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -9745,7 +9845,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9780,7 +9880,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
         actor: "SYSTEM" | "BUYER" | "SELLER";
         occurredAt: string;
       }[] | undefined;
@@ -9813,7 +9913,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     completeExchange: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -10734,7 +10834,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         conversionRate: number | null;
       };
       funnel: {
-        step: "PURCHASE" | "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT";
+        step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
         sessions: number;
         rateFromPrevious: number | null;
       }[];
@@ -10788,9 +10888,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
     sources: (params: AnalyticsSourcesParams) => Promise<{
-      groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
+      groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
       rows: {
-        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
+        channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -10895,7 +10995,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     checkout: (params: AnalyticsRangeParams) => Promise<{
       sessions: number;
       outcomes: {
-        outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
+        outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
         sessions: number;
       }[];
       from: string;
@@ -11996,7 +12096,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+        status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -12046,7 +12146,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12098,7 +12198,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12146,7 +12246,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12390,7 +12490,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
     getDeployment: () => Promise<{
       siteId: string;
-      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
+      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12412,7 +12512,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
     retryDeployment: () => Promise<{
       siteId: string;
-      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
+      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12987,7 +13087,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     runCheck: (body: RunStorefrontCheckRequest) => Promise<{
       checkId: string;
       check: string;
-      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -13001,7 +13101,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getCheck: (checkId: string) => Promise<{
       checkId: string;
       check: string;
-      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -13992,7 +14092,7 @@ export interface PricingResult {
   pointAmount: number;
   /** 지금 쓸 수 있는 최대 적립금 — 주문서 안내값(잔액을 모두 요청했을 때의 금액). 적립금 입력이 없으면 0 */
   pointMaxUsable: number;
-  /** 요청보다 적게 썼다면 그 이유 — `MIN_PAYMENT`: 결제 금액 100원을 남기려고 줄였다 */
+  /** 요청보다 적게 썼다면 그 이유 — `MIN_PAYMENT`: 남는 결제 금액이 1~99원이라 100원을 남기려고 줄였다(전액이면 0원 결제) */
   pointAdjustReason: "MIN_PAYMENT" | null;
   /** 요청했지만 쓰지 못했다면 그 이유 */
   pointRejectReason: PointRejectReason | null;
@@ -14026,8 +14126,10 @@ export declare function isCouponTargetLine(rule: Pick<CouponRule, "target" | "co
  */
 export declare function quotePricing(input: PricingInput): PricingResult;
 /**
- * 사용 적립금 금액(순수) — 요청·잔액·최대 비율·「결제 금액 100원 남기기」 중 작은 값을 단위로 내린다.
- * 최소 보유액·최소 사용액에 못 미치면 0이다. 결제 금액이 0원이 되는 사용(적립금 전액 결제)은 아직 받지 않는다(P4).
+ * 사용 적립금 금액(순수) — 요청·잔액·최대 비율 중 작은 값을 쓴다(#93 P3·P4).
+ * - 결제 금액 전체를 덮을 수 있으면 전액을 쓴다(0원 결제, 이때만 사용 단위를 보지 않는다)
+ * - 그 밖에는 사용 단위로 내리고, 남는 결제 금액이 1~99원이면 적립금을 줄여 100원을 남긴다(`MIN_PAYMENT`)
+ * 최소 보유액·최소 사용액에 못 미치면 0이다.
  */
 export declare function pointUseOf(points: PricingPoints | null, amounts: {
   productPaid: number;
@@ -14988,6 +15090,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -14995,7 +15098,6 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15181,6 +15283,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15188,7 +15291,6 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15394,6 +15496,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15401,7 +15504,6 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;