@sayren/store-sdk 0.29.2 → 0.29.4

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;
@@ -966,11 +966,11 @@ export type ApiLogSummary = z.infer<typeof apiLogSummarySchema>;
 //#endregion
 //#region src/schemas/category.d.ts
 export declare const categoryProductSortSchema: z.ZodEnum<{
-  NAME: "NAME";
   RECENT: "RECENT";
   POPULAR: "POPULAR";
   PRICE_LOW: "PRICE_LOW";
   PRICE_HIGH: "PRICE_HIGH";
+  NAME: "NAME";
 }>;
 export type CategoryProductSort = z.infer<typeof categoryProductSortSchema>;
 export declare const categorySchema: z.ZodObject<{
@@ -986,11 +986,11 @@ export declare const categorySchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1016,11 +1016,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1041,11 +1041,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
-      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
+      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1069,11 +1069,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1094,11 +1094,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
-      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
+      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1130,11 +1130,11 @@ export declare const categoryCreateRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1149,11 +1149,11 @@ export declare const categoryPatchRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1264,7 +1264,6 @@ 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";
@@ -1272,6 +1271,7 @@ export declare const claimStatusSchema: z.ZodEnum<{
   COLLECTED: "COLLECTED";
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
+  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1308,7 +1308,6 @@ export declare const claimSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1316,6 +1315,7 @@ export declare const claimSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1338,6 +1338,7 @@ export declare const claimSchema: z.ZodObject<{
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
   expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedPointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1396,7 +1397,6 @@ export declare const claimDetailSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1404,6 +1404,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1426,6 +1427,7 @@ export declare const claimDetailSchema: z.ZodObject<{
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
   expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedPointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1453,7 +1455,6 @@ 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";
@@ -1461,6 +1462,7 @@ export declare const claimDetailSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -1499,6 +1501,7 @@ export declare const approveClaimResultSchema: z.ZodObject<{
   deliveryFeeChargeAmount: z.ZodNumber;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
@@ -1527,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"];
@@ -1537,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";
@@ -1563,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">;
@@ -1580,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"];
@@ -1597,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의 응답 검증이 깨지지 않는다.
@@ -1614,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>]>;
@@ -1640,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<{
@@ -1668,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>]>>>;
@@ -1683,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;
@@ -1692,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;
@@ -1714,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>>;
@@ -1722,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";
@@ -1757,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>>;
@@ -1765,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";
@@ -1834,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>]>>>;
@@ -1849,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;
@@ -1906,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";
@@ -1930,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
@@ -2523,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>;
@@ -3260,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<{
-  PAID: "PAID";
   FREE: "FREE";
+  PAID: "PAID";
   CONDITIONAL_FREE: "CONDITIONAL_FREE";
 }>;
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -3272,8 +3344,8 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodOptional<z.ZodObject<{
     deliveryType: z.ZodDefault<z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>>;
     deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -3295,8 +3367,8 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3316,8 +3388,8 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3355,8 +3427,8 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3495,6 +3567,7 @@ export declare const orderItemSchema: z.ZodObject<{
   discountAmount: z.ZodNumber;
   totalPrice: z.ZodNumber;
   couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   hold: z.ZodNullable<z.ZodObject<{
     reason: z.ZodString;
     expectedDispatchDate: z.ZodString;
@@ -3567,6 +3640,7 @@ export declare const orderSchema: z.ZodObject<{
     discountAmount: z.ZodNumber;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     discounts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
       couponId: z.ZodString;
       name: z.ZodString;
@@ -3654,6 +3728,7 @@ export declare const orderSchema: z.ZodObject<{
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hold: z.ZodNullable<z.ZodObject<{
       reason: z.ZodString;
       expectedDispatchDate: z.ZodString;
@@ -3770,6 +3845,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hold: z.ZodNullable<z.ZodObject<{
       reason: z.ZodString;
       expectedDispatchDate: z.ZodString;
@@ -3871,16 +3947,16 @@ export interface OrderItemListParams extends PageParams {
   testPayment?: "true" | "false";
 }
 export declare const deliveryMethodSchema: z.ZodEnum<{
-  DIRECT: "DIRECT";
   COURIER: "COURIER";
+  DIRECT: "DIRECT";
   QUICK: "QUICK";
   NOTHING: "NOTHING";
 }>;
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 export declare const dispatchRequestSchema: z.ZodObject<{
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3892,8 +3968,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 export declare const deliveryInfoSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3919,8 +3995,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
 export declare const deliveryStatusSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -4008,6 +4084,7 @@ export declare const cancelBySellerResultSchema: z.ZodObject<{
   deliveryFeeChargeAmount: z.ZodNumber;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
@@ -4926,6 +5003,7 @@ export type PaymentAttemptRecord = z.infer<typeof paymentAttemptRecordSchema>;
 export declare const paymentRefundRecordSchema: z.ZodObject<{
   refundId: z.ZodString;
   amount: z.ZodNumber;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   reason: z.ZodString;
   kind: z.ZodString;
   status: z.ZodString;
@@ -5013,6 +5091,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   refunds: z.ZodArray<z.ZodObject<{
     refundId: z.ZodString;
     amount: z.ZodNumber;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     reason: z.ZodString;
     kind: z.ZodString;
     status: z.ZodString;
@@ -5094,6 +5173,21 @@ export declare const purchaseEarnPolicySchema: z.ZodObject<{
   rateBp: z.ZodNumber;
 }, z.core.$strip>;
 export type PurchaseEarnPolicy = z.infer<typeof purchaseEarnPolicySchema>;
+/** 사용 단위 — 1·10·100원 */
+export declare const POINT_USE_UNITS: readonly [1, 10, 100];
+/**
+ * 적립금 사용 규칙(P3) — 주문서에서 결제 금액을 줄인다. 적용 순서는 즉시할인 → 쿠폰 → 적립금이고, 상품 금액(쿠폰 뒤)에 먼저 쓰고
+ * 남으면 배송비에 쓴다(`includeDeliveryFee`). 결제 금액이 100원 아래로 내려가지 않게 적립금을 줄인다.
+ */
+export declare const pointUsePolicySchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  minBalance: z.ZodNumber;
+  minAmount: z.ZodNumber;
+  unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+  maxRatioBp: z.ZodNumber;
+  includeDeliveryFee: z.ZodBoolean;
+}, z.core.$strip>;
+export type PointUsePolicy = z.infer<typeof pointUsePolicySchema>;
 /** 저장된 상점 정책(`stores.point_policy`) — 해석은 `resolvePointPolicy` */
 export declare const pointPolicySchema: z.ZodObject<{
   reviewReward: z.ZodObject<{
@@ -5105,6 +5199,14 @@ export declare const pointPolicySchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     rateBp: z.ZodNumber;
   }, z.core.$strip>;
+  use: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    minBalance: z.ZodNumber;
+    minAmount: z.ZodNumber;
+    unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+    maxRatioBp: z.ZodNumber;
+    includeDeliveryFee: z.ZodBoolean;
+  }, z.core.$strip>;
   expiryDays: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 export type PointPolicy = z.infer<typeof pointPolicySchema>;
@@ -5137,7 +5239,7 @@ export declare function pointExpiresAtOf(earnedAt: Date, days: number | null): D
 /** 적립 묶음 출처 — 같은 출처 id에는 묶음이 하나뿐이다(DB 부분 유니크) */
 export declare const POINT_LOT_SOURCES: readonly ["REVIEW", "PURCHASE", "ADJUST", "REFUND_RESTORE", "OPENING"];
 export type PointLotSource = (typeof POINT_LOT_SOURCES)[number];
-/** 원장 항목 유형. 지금 쓰는 것은 리뷰 적립·회수이고 나머지는 다음 단계 자리다 */
+/** 원장 항목 유형 */
 export declare const POINT_ENTRY_TYPES: readonly ["EARN_REVIEW", "REVOKE_REVIEW", "EARN_PURCHASE", "USE_RESERVE", "USE_RELEASE", "REFUND_RESTORE", "EXPIRE", "ADJUST", "OPENING"];
 export type PointEntryType = (typeof POINT_ENTRY_TYPES)[number];
 /** 상점 플랫폼 알림 — `REVIEW_REWARD_PAUSED` 리뷰 자동 적립이 멈춤 · `POINTS_AVAILABLE` 적립금 설정을 쓸 수 있음 */
@@ -5159,6 +5261,15 @@ export declare const storePointPolicySchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     rateBp: z.ZodNumber;
   }, z.core.$strip>;
+  useAvailable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  use: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    minBalance: z.ZodNumber;
+    minAmount: z.ZodNumber;
+    unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+    maxRatioBp: z.ZodNumber;
+    includeDeliveryFee: z.ZodBoolean;
+  }, z.core.$strip>>>;
   expiryDays: z.ZodNullable<z.ZodNumber>;
   notice: z.ZodNullable<z.ZodEnum<{
     REVIEW_REWARD_PAUSED: "REVIEW_REWARD_PAUSED";
@@ -5180,6 +5291,14 @@ export declare const updatePointPolicyRequestSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     rateBp: z.ZodNumber;
   }, z.core.$strip>>;
+  use: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    minBalance: z.ZodNumber;
+    minAmount: z.ZodNumber;
+    unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
+    maxRatioBp: z.ZodNumber;
+    includeDeliveryFee: z.ZodBoolean;
+  }, z.core.$strip>>;
   expiryDays: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type UpdatePointPolicyRequest = z.infer<typeof updatePointPolicyRequestSchema>;
@@ -5223,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;
@@ -5242,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;
@@ -5304,6 +5423,30 @@ export declare const pointAdjustmentResultSchema: z.ZodObject<{
   balance: z.ZodNumber;
 }, z.core.$strip>;
 export type PointAdjustmentResult = z.infer<typeof pointAdjustmentResultSchema>;
+/** 결제 시작에 쓴 적립 묶음 — 해제·환불 반환이 이 값으로 되돌리고 반환 적립금의 만료를 정한다 */
+export interface PointLotUsage {
+  lotId: string;
+  amount: number;
+  expiresAt: string | null;
+}
+/**
+ * 환불로 돌려주는 적립금의 만료 — 결제에 쓴 묶음 중 가장 늦은 만료이고, 그 시각이 이미 지났으면 지금 + 30일(KST 날짜 끝)이다.
+ * 쓴 묶음 중 만료 없는 묶음(기존 잔액 등)이 있으면 만료 없음(null)이다. 쓴 기록이 없으면 지금 + 30일이다(사용자 결정 2026-10-02).
+ */
+export declare function pointRestoreExpiresAtOf(usages: readonly PointLotUsage[], now: Date): Date | null;
+/**
+ * 환불 금액 나누기 — 현금 몫·적립금 몫에서 차감(반품 배송비·쿠폰 조건 미달·추가 차감)을 **현금에서 먼저** 빼고 모자란 몫만 적립금에서 뺀다.
+ * 둘 다 모자라면 0에서 멈추고 못 받은 차감액(`uncollected`)을 돌려준다(호출부가 감사 로그에 남긴다).
+ */
+export declare function splitRefund(input: {
+  cash: number;
+  points: number;
+  charges: number;
+}): {
+  cashRefund: number;
+  pointRefund: number;
+  uncollected: number;
+};
 //#endregion
 //#region src/schemas/product.d.ts
 export declare const productStatusSchema: z.ZodEnum<{
@@ -5392,8 +5535,8 @@ export declare const VARIANT_COUNT_WARNING = 100;
  * 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
  */
 export declare const optionSortSchema: z.ZodEnum<{
-  REGISTERED: "REGISTERED";
   NAME: "NAME";
+  REGISTERED: "REGISTERED";
   PRICE_ASC: "PRICE_ASC";
   PRICE_DESC: "PRICE_DESC";
 }>;
@@ -5573,8 +5716,8 @@ export declare const productSchema: z.ZodObject<{
     sortOrder: z.ZodNumber;
   }, z.core.$strip>>>>;
   optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>>;
@@ -5582,8 +5725,8 @@ export declare const productSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -5717,8 +5860,8 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -5773,8 +5916,8 @@ export declare const optionModelSchema: z.ZodObject<{
     sortOrder: z.ZodNumber;
   }, z.core.$strip>>>>;
   optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>>;
@@ -5805,8 +5948,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodOptional<z.ZodObject<{
       deliveryType: z.ZodDefault<z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>>;
       deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -5858,8 +6001,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -5891,8 +6034,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -5944,8 +6087,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     usable: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -5985,8 +6128,8 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -6008,11 +6151,11 @@ export declare const productPatchRequestSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
+  "updatedAt.desc": "updatedAt.desc";
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
-  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -6036,11 +6179,11 @@ export declare const productListQuerySchema: z.ZodObject<{
   keyword: z.ZodOptional<z.ZodString>;
   sellerCode: z.ZodOptional<z.ZodString>;
   sort: z.ZodOptional<z.ZodEnum<{
+    "updatedAt.desc": "updatedAt.desc";
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
-    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -6096,8 +6239,8 @@ export declare const savedOptionSetSchema: z.ZodObject<{
   optionSetId: z.ZodString;
   name: z.ZodString;
   optionSort: z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>;
@@ -6151,8 +6294,8 @@ export declare const savedCustomInputRequestSchema: z.ZodObject<{
 export declare const savedOptionSetRequestSchema: z.ZodObject<{
   name: z.ZodString;
   optionSort: z.ZodDefault<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -6197,8 +6340,8 @@ export declare const savedOptionSetFromProductResultSchema: z.ZodObject<{
     optionSetId: z.ZodString;
     name: z.ZodString;
     optionSort: z.ZodEnum<{
-      REGISTERED: "REGISTERED";
       NAME: "NAME";
+      REGISTERED: "REGISTERED";
       PRICE_ASC: "PRICE_ASC";
       PRICE_DESC: "PRICE_DESC";
     }>;
@@ -6421,9 +6564,9 @@ export declare const storeMemberSchema: z.ZodObject<{
   name: z.ZodString;
   email: z.ZodEmail;
   role: z.ZodEnum<{
+    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
-    OWNER: "OWNER";
   }>;
   joinedAt: z.ZodString;
   lastActiveAt: z.ZodNullable<z.ZodString>;
@@ -6947,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;
@@ -7407,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<{
-  UNKNOWN: "UNKNOWN";
   FAILED: "FAILED";
+  UNKNOWN: "UNKNOWN";
   RUNNING: "RUNNING";
   QUEUED: "QUEUED";
   PASSED: "PASSED";
@@ -7421,8 +7564,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
   checkId: z.ZodString;
   check: z.ZodString;
   status: z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     FAILED: "FAILED";
+    UNKNOWN: "UNKNOWN";
     RUNNING: "RUNNING";
     QUEUED: "QUEUED";
     PASSED: "PASSED";
@@ -7956,9 +8099,9 @@ export type UploadTicket = z.infer<typeof uploadTicketSchema>;
 //#endregion
 //#region src/schemas/auth.d.ts
 export declare const storeRoleSchema: z.ZodEnum<{
+  OWNER: "OWNER";
   ADMIN: "ADMIN";
   STAFF: "STAFF";
-  OWNER: "OWNER";
 }>;
 export type StoreRole = z.infer<typeof storeRoleSchema>;
 export declare const myStoreSchema: z.ZodObject<{
@@ -7966,9 +8109,9 @@ export declare const myStoreSchema: z.ZodObject<{
   storeName: z.ZodString;
   storeCode: z.ZodString;
   role: z.ZodEnum<{
+    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
-    OWNER: "OWNER";
   }>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -8128,7 +8271,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storeId: string;
       storeName: string;
       storeCode: string;
-      role: "ADMIN" | "STAFF" | "OWNER";
+      role: "OWNER" | "ADMIN" | "STAFF";
       status: "SUSPENDED" | "CLOSED" | "ACTIVE";
     }[]>;
     me: () => Promise<{
@@ -8239,11 +8382,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
         sortOrder: number;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8337,11 +8480,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
         sortOrder: number;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8435,11 +8578,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
         sortOrder: number;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8536,7 +8679,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
         sortOrder: number;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /**
      * 옵션 모델 전체 교체 — variants는 valueNames로 축 값을 지목한다.
@@ -8589,7 +8732,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usable: boolean;
         sortOrder: number;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /** 재고 변경 — stockQuantity(절대값) 또는 adjustment(증감) 하나만 전달한다 */
     updateVariantStock: (productId: string, variantId: string, body: VariantStockRequest) => Promise<{
@@ -8627,7 +8770,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         optionSetId: string;
         name: string;
-        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
         groups: {
           name: string;
           kind: string;
@@ -8651,7 +8794,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (optionSetId: string) => Promise<{
       optionSetId: string;
       name: string;
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       groups: {
         name: string;
         kind: string;
@@ -8675,7 +8818,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: SavedOptionSetRequestInput) => Promise<{
       optionSetId: string;
       name: string;
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       groups: {
         name: string;
         kind: string;
@@ -8699,7 +8842,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (optionSetId: string, body: SavedOptionSetRequestInput) => Promise<{
       optionSetId: string;
       name: string;
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       groups: {
         name: string;
         kind: string;
@@ -8725,7 +8868,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionSet: {
         optionSetId: string;
         name: string;
-        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
         groups: {
           name: string;
           kind: string;
@@ -8779,6 +8922,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         } | {
           field: "discounted";
           value: true;
+        } | {
+          field: "bestSelling";
+          days: 30 | 7 | 90;
+          top: number;
         } | {
           [x: string]: unknown;
           field: string;
@@ -8790,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;
@@ -8824,6 +8972,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 30 | 7 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8835,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;
@@ -8862,6 +9015,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 30 | 7 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8873,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;
@@ -8899,6 +9057,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 30 | 7 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8910,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;
@@ -8957,6 +9120,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 30 | 7 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -8968,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;
@@ -8995,6 +9163,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | {
         field: "discounted";
         value: true;
+      } | {
+        field: "bestSelling";
+        days: 30 | 7 | 90;
+        top: number;
       } | {
         [x: string]: unknown;
         field: string;
@@ -9006,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;
@@ -9024,6 +9197,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         position: number;
         addedAt: string;
       }[];
+      salesComputedAt: string | null;
     }>;
   };
   categories: {
@@ -9042,7 +9216,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -9062,7 +9236,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -9081,7 +9255,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -9101,7 +9275,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -9120,7 +9294,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -9149,7 +9323,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -9168,7 +9342,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -9226,6 +9400,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         discountAmount: number;
         couponDiscountAmount: number;
         deliveryDiscountAmount: number;
+        pointAmount: number;
         discounts: {
           couponId: string;
           name: string;
@@ -9292,6 +9467,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         discountAmount: number;
         totalPrice: number;
         couponDiscountAmount: number;
+        pointAllocation: number;
         hold: {
           reason: string;
           expectedDispatchDate: string;
@@ -9377,6 +9553,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         discountAmount: number;
         totalPrice: number;
         couponDiscountAmount: number;
+        pointAllocation: number;
         hold: {
           reason: string;
           expectedDispatchDate: string;
@@ -9417,6 +9594,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       deliveryFeeChargeAmount: number;
       couponChargeAmount: number;
       couponChargeRefundAmount: number;
+      pointRefundAmount: number;
       refundedAt: string;
     }>;
     updateMemo: (orderItemId: string, memo: string) => Promise<void>;
@@ -9428,7 +9606,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
+      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9490,6 +9668,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       discountAmount: number;
       totalPrice: number;
       couponDiscountAmount: number;
+      pointAllocation: number;
       hold: {
         reason: string;
         expectedDispatchDate: string;
@@ -9558,6 +9737,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       discountAmount: number;
       totalPrice: number;
       couponDiscountAmount: number;
+      pointAllocation: number;
       hold: {
         reason: string;
         expectedDispatchDate: string;
@@ -9588,7 +9768,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
+      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9626,7 +9806,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         claimId: string;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -9637,6 +9817,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         claimDeliveryFee: number;
         expectedRefundAmount: number | null;
         expectedDeliveryFeeRefundAmount: number | null;
+        expectedPointRefundAmount: number;
         exchangeOption: {
           optionId: string;
           optionName: string;
@@ -9664,7 +9845,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9675,6 +9856,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
       expectedDeliveryFeeRefundAmount: number | null;
+      expectedPointRefundAmount: number;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -9698,7 +9880,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
         actor: "SYSTEM" | "BUYER" | "SELLER";
         occurredAt: string;
       }[] | undefined;
@@ -9712,6 +9894,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       deliveryFeeChargeAmount: number;
       couponChargeAmount: number;
       couponChargeRefundAmount: number;
+      pointRefundAmount: number;
       refundedAt: string;
     }>;
     reject: (claimId: string, body: RejectClaimRequest) => Promise<void>;
@@ -9730,7 +9913,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     completeExchange: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9741,6 +9924,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
       expectedDeliveryFeeRefundAmount: number | null;
+      expectedPointRefundAmount: number;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -10650,7 +10834,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         conversionRate: number | null;
       };
       funnel: {
-        step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
+        step: "PURCHASE" | "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT";
         sessions: number;
         rateFromPrevious: number | null;
       }[];
@@ -10704,9 +10888,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
     sources: (params: AnalyticsSourcesParams) => Promise<{
-      groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
+      groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
       rows: {
-        channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
+        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -10811,7 +10995,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     checkout: (params: AnalyticsRangeParams) => Promise<{
       sessions: number;
       outcomes: {
-        outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
+        outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
         sessions: number;
       }[];
       from: string;
@@ -10903,6 +11087,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       refunds: {
         refundId: string;
         amount: number;
+        pointRefundAmount: number;
         reason: string;
         kind: string;
         status: string;
@@ -11911,7 +12096,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -11961,7 +12146,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12013,7 +12198,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12061,7 +12246,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12305,7 +12490,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
     getDeployment: () => Promise<{
       siteId: string;
-      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12327,7 +12512,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
     retryDeployment: () => Promise<{
       siteId: string;
-      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12902,7 +13087,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     runCheck: (body: RunStorefrontCheckRequest) => Promise<{
       checkId: string;
       check: string;
-      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -12916,7 +13101,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getCheck: (checkId: string) => Promise<{
       checkId: string;
       check: string;
-      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -13496,6 +13681,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enabled: boolean;
         rateBp: number;
       };
+      useAvailable: boolean;
+      use: {
+        enabled: boolean;
+        minBalance: number;
+        minAmount: number;
+        unit: 1 | 100 | 10;
+        maxRatioBp: number;
+        includeDeliveryFee: boolean;
+      };
       expiryDays: number | null;
       notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
     }>;
@@ -13515,6 +13709,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enabled: boolean;
         rateBp: number;
       };
+      useAvailable: boolean;
+      use: {
+        enabled: boolean;
+        minBalance: number;
+        minAmount: number;
+        unit: 1 | 100 | 10;
+        maxRatioBp: number;
+        includeDeliveryFee: boolean;
+      };
       expiryDays: number | null;
       notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
     }>;
@@ -13522,7 +13725,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       userId: string;
       name: string;
       email: string;
-      role: "ADMIN" | "STAFF" | "OWNER";
+      role: "OWNER" | "ADMIN" | "STAFF";
       joinedAt: string;
       lastActiveAt: string | null;
     }[]>;
@@ -13799,8 +14002,29 @@ export interface PricingDelivery {
     remoteSurcharge: number;
   }>;
 }
+/**
+ * 적립금 사용 입력(#93 P3) — 쿠폰 뒤 금액에 쓴다. 규칙은 상점 정책 `use`(`PointUsePolicy`)의 값이다.
+ * 금액은 요청·잔액·최대 비율 중 작은 값을 `unit`으로 내리고, 남는 결제 금액이 100원 아래로 내려가지 않게 줄인다(적립금 전액 결제는 아직 받지 않는다).
+ */
+export interface PricingPoints {
+  /** 구매자가 쓰겠다는 금액 */
+  requested: number;
+  /** 지금 잔액 */
+  balance: number;
+  rules: {
+    minBalance: number;
+    minAmount: number;
+    unit: number;
+    maxRatioBp: number;
+    includeDeliveryFee: boolean;
+  };
+}
+/** 적립금을 쓰지 못한 이유 */
+export type PointRejectReason = "MIN_BALANCE" | "MIN_AMOUNT" | "NOT_PAYABLE";
 export interface PricingInput {
   lines: readonly PricingLine[];
+  /** 적립금 사용(#93 P3). 없으면 쓰지 않는다 — 결과는 적립금 이전과 같다 */
+  points?: PricingPoints | null;
   coupons: readonly PricingCoupon[];
   /** 배송비 견적. 없으면 배송비 0으로 계산하고 배송비 쿠폰은 할인할 금액이 없다 */
   delivery?: PricingDelivery | null;
@@ -13829,6 +14053,8 @@ export interface PricingLineResult {
   /** 이 줄에 들어간 쿠폰 할인 합계 — 상품 쿠폰 + 주문 쿠폰 배분 */
   couponDiscount: number;
   allocations: CouponAllocation[];
+  /** 이 줄에 배분한 사용 적립금(#93 P3). 적립금을 쓰지 않으면 0 */
+  pointAllocation: number;
 }
 export interface PricingCouponResult {
   couponKey: string;
@@ -13846,6 +14072,8 @@ export interface PricingCouponResult {
 export interface PricingBundleResult {
   bundleKey: string;
   couponDiscount: number;
+  /** 이 배송 묶음에 배분한 사용 적립금(#93 P3) */
+  pointAllocation: number;
 }
 export interface PricingResult {
   lines: PricingLineResult[];
@@ -13860,7 +14088,15 @@ export interface PricingResult {
   deliveryFee: number;
   /** 배송비 쿠폰 할인 */
   deliveryDiscountAmount: number;
-  /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount */
+  /** 사용 적립금(#93 P3). 쓰지 않으면 0 */
+  pointAmount: number;
+  /** 지금 쓸 수 있는 최대 적립금 — 주문서 안내값(잔액을 모두 요청했을 때의 금액). 적립금 입력이 없으면 0 */
+  pointMaxUsable: number;
+  /** 요청보다 적게 썼다면 그 이유 — `MIN_PAYMENT`: 결제 금액 100원을 남기려고 줄였다 */
+  pointAdjustReason: "MIN_PAYMENT" | null;
+  /** 요청했지만 쓰지 못했다면 그 이유 */
+  pointRejectReason: PointRejectReason | null;
+  /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount − pointAmount */
   totalAmount: number;
 }
 /**
@@ -13889,6 +14125,20 @@ export declare function isCouponTargetLine(rule: Pick<CouponRule, "target" | "co
  * 사본 중 앞 장이 만료됐으면 뒤 장이 쓰인다. 결과의 `coupons`는 입력 순서 그대로다. 입력이 같으면 결과도 같다.
  */
 export declare function quotePricing(input: PricingInput): PricingResult;
+/**
+ * 사용 적립금 금액(순수) — 요청·잔액·최대 비율·「결제 금액 100원 남기기」 중 작은 값을 단위로 내린다.
+ * 최소 보유액·최소 사용액에 못 미치면 0이다. 결제 금액이 0원이 되는 사용(적립금 전액 결제)은 아직 받지 않는다(P4).
+ */
+export declare function pointUseOf(points: PricingPoints | null, amounts: {
+  productPaid: number;
+  deliveryPaid: number;
+  total: number;
+}): {
+  amount: number;
+  maxUsable: number;
+  adjustReason: "MIN_PAYMENT" | null;
+  rejectReason: PointRejectReason | null;
+};
 /**
  * 주문이 받은 쿠폰 한 장 — 주문 시점 규칙과 대상 줄을 굳힌 값이다(`orders.discounts`의 항목).
  * 환불 정산은 이 값만 읽는다. 셀러가 쿠폰을 바꾸거나 상품의 카테고리가 바뀌어도 결과가 같다.
@@ -13988,6 +14238,16 @@ export declare function settleCouponShortfall(input: CouponSettlementInput): Cou
 export declare function proratedPaidRefundBase(item: {
   totalPrice: number;
   couponDiscountAmount?: number | null;
+  /** 주문상품에 배분된 사용 적립금(#93 P3) — 현금 환불 기준에서 뺀다. 없으면 0 */
+  pointAllocation?: number | null;
+  quantity: number;
+}, settledQuantity: number, cancelQuantity: number): number;
+/**
+ * 주문상품의 사용 적립금 중 이번 취소 수량의 몫(#93 P3) — 누적 내림의 차분이라 나눠 취소해도 합이 배분액과 같다.
+ * 현금 환불(`proratedPaidRefundBase`)과 따로 돌려준다(`pointRefundAmount`).
+ */
+export declare function proratedPointRefund(item: {
+  pointAllocation?: number | null;
   quantity: number;
 }, settledQuantity: number, cancelQuantity: number): number;
 //#endregion
@@ -14105,14 +14365,14 @@ export declare const STORE_SCOPE_RESOURCES: {
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
-  category: "category";
-  analytics: "analytics";
   product: "product";
+  category: "category";
   order: "order";
   claim: "claim";
   inquiry: "inquiry";
   review: "review";
   settlement: "settlement";
+  analytics: "analytics";
   webhook: "webhook";
   store: "store";
   member: "member";
@@ -14709,6 +14969,7 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
   }>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   orderItemId: z.ZodOptional<z.ZodString>;
   fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -14813,6 +15074,7 @@ export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
   deliveryFeeChargeAmount: z.ZodNumber;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
@@ -14826,7 +15088,6 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -14834,6 +15095,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -14843,6 +15105,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
   deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type ClaimWebhookEventData = z.infer<typeof claimWebhookEventDataSchema>;
@@ -14885,6 +15148,7 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     orderItemId: z.ZodOptional<z.ZodString>;
     fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -14992,6 +15256,7 @@ export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
     deliveryFeeChargeAmount: z.ZodNumber;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -15016,7 +15281,6 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15024,6 +15288,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15033,6 +15298,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
     deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -15098,6 +15364,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     orderItemId: z.ZodOptional<z.ZodString>;
     fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -15203,6 +15470,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deliveryFeeChargeAmount: z.ZodNumber;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -15226,7 +15494,6 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15234,6 +15501,7 @@ 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>>;
@@ -15243,6 +15511,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;