@sayren/store-sdk 0.29.0 → 0.29.1

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";
   SUCCEEDED: "SUCCEEDED";
   FAILED: "FAILED";
   PENDING: "PENDING";
   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";
     SUCCEEDED: "SUCCEEDED";
     FAILED: "FAILED";
     PENDING: "PENDING";
     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";
     SUCCEEDED: "SUCCEEDED";
     FAILED: "FAILED";
     PENDING: "PENDING";
     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";
       SUCCEEDED: "SUCCEEDED";
       FAILED: "FAILED";
       PENDING: "PENDING";
       EXECUTING: "EXECUTING";
-      UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
       EXPIRED: "EXPIRED";
     }>;
@@ -581,7 +581,6 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
-  UNKNOWN: "UNKNOWN";
   DIRECT: "DIRECT";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
@@ -589,6 +588,7 @@ export declare const analyticsChannelSchema: z.ZodEnum<{
   EMAIL: "EMAIL";
   CAMPAIGN: "CAMPAIGN";
   REFERRAL: "REFERRAL";
+  UNKNOWN: "UNKNOWN";
 }>;
 export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
 export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
@@ -615,7 +615,6 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     DIRECT: "DIRECT";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
@@ -623,6 +622,7 @@ export declare const analyticsSourceRowSchema: z.ZodObject<{
     EMAIL: "EMAIL";
     CAMPAIGN: "CAMPAIGN";
     REFERRAL: "REFERRAL";
+    UNKNOWN: "UNKNOWN";
   }>>;
   source: z.ZodNullable<z.ZodString>;
   medium: z.ZodNullable<z.ZodString>;
@@ -651,7 +651,6 @@ export declare const analyticsSourcesSchema: z.ZodObject<{
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
-      UNKNOWN: "UNKNOWN";
       DIRECT: "DIRECT";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
@@ -659,6 +658,7 @@ export declare const analyticsSourcesSchema: z.ZodObject<{
       EMAIL: "EMAIL";
       CAMPAIGN: "CAMPAIGN";
       REFERRAL: "REFERRAL";
+      UNKNOWN: "UNKNOWN";
     }>>;
     source: z.ZodNullable<z.ZodString>;
     medium: z.ZodNullable<z.ZodString>;
@@ -1264,8 +1264,8 @@ export declare const claimTypeSchema: z.ZodEnum<{
 }>;
 export type ClaimType = z.infer<typeof claimTypeSchema>;
 export declare const claimStatusSchema: z.ZodEnum<{
-  REJECTED: "REJECTED";
   COMPLETED: "COMPLETED";
+  REJECTED: "REJECTED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
   COLLECTING: "COLLECTING";
@@ -1308,8 +1308,8 @@ export declare const claimSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    REJECTED: "REJECTED";
     COMPLETED: "COMPLETED";
+    REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -1396,8 +1396,8 @@ export declare const claimDetailSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    REJECTED: "REJECTED";
     COMPLETED: "COMPLETED";
+    REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -1453,8 +1453,8 @@ export declare const claimDetailSchema: z.ZodObject<{
   }, z.core.$strip>>;
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
-      REJECTED: "REJECTED";
       COMPLETED: "COMPLETED";
+      REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -2618,8 +2618,8 @@ export declare const eventTypeSchema: z.ZodEnum<{
 }>;
 export type EventType = z.infer<typeof eventTypeSchema>;
 export declare const webhookStatusSchema: z.ZodEnum<{
-  SUSPENDED: "SUSPENDED";
   ACTIVE: "ACTIVE";
+  SUSPENDED: "SUSPENDED";
 }>;
 export type WebhookStatus = z.infer<typeof webhookStatusSchema>;
 export declare const webhookSchema: z.ZodObject<{
@@ -2643,8 +2643,8 @@ export declare const webhookSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
   }>>;
   status: z.ZodEnum<{
-    SUSPENDED: "SUSPENDED";
     ACTIVE: "ACTIVE";
+    SUSPENDED: "SUSPENDED";
   }>;
   secretPrefix: z.ZodString;
   suspendedAt: z.ZodNullable<z.ZodString>;
@@ -2673,8 +2673,8 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
   }>>;
   status: z.ZodEnum<{
-    SUSPENDED: "SUSPENDED";
     ACTIVE: "ACTIVE";
+    SUSPENDED: "SUSPENDED";
   }>;
   secretPrefix: z.ZodString;
   suspendedAt: z.ZodNullable<z.ZodString>;
@@ -4871,22 +4871,261 @@ export interface PaymentListParams extends PageParams {
   includeTest?: boolean;
 }
 //#endregion
+//#region src/schemas/points.d.ts
+/**
+ * 적립금 (이슈 #93) — 상점 정책·원장 유형·순수 계산. 정책 해석은 `resolvePointPolicy`, 리뷰 적립 금액은
+ * `reviewRewardPointOf`, 적립 묶음(lot) 만료 시각은 `pointExpiresAtOf` 한 곳이다. 서버·상점 플랫폼이 같은 함수를 쓴다.
+ *
+ * 정책이 없으면(null) 모든 적립이 꺼져 있다(사용자 결정 2026-10-02). 셀러가 켜야 적립이 시작된다.
+ * 구매 적립 금액은 `pointEarnOf`, 적용 적립률은 `purchaseEarnRateOf`(상품 덮어쓰기 우선)다. 사용 규칙은 다음 단계(P3)에서 가산한다.
+ */
+/** 리뷰 적립·회수 금액 상한 — 한 리뷰에 주는 금액 */
+export declare const POINT_REVIEW_REWARD_MAX = 100000;
+/** 유효 기간 범위(일) — 「소멸 없음」 선택지는 두지 않는다(사용자 결정 2026-10-02) */
+export declare const POINT_EXPIRY_DAYS_MIN = 30;
+export declare const POINT_EXPIRY_DAYS_MAX = 1825;
+/** 구매 적립률 상한(만분율) — 3000 = 30% */
+export declare const POINT_EARN_RATE_BP_MAX = 3000;
+/** 구매 적립률(만분율, 100 = 1%). 상품별 덮어쓰기도 같은 범위다 */
+export declare const pointEarnRateBpSchema: z.ZodNumber;
+export declare const reviewRewardPolicySchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  textPoint: z.ZodNumber;
+  photoPoint: z.ZodNumber;
+}, z.core.$strip>;
+export type ReviewRewardPolicy = z.infer<typeof reviewRewardPolicySchema>;
+export declare const purchaseEarnPolicySchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  rateBp: z.ZodNumber;
+}, z.core.$strip>;
+export type PurchaseEarnPolicy = z.infer<typeof purchaseEarnPolicySchema>;
+/** 저장된 상점 정책(`stores.point_policy`) — 해석은 `resolvePointPolicy` */
+export declare const pointPolicySchema: z.ZodObject<{
+  reviewReward: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    textPoint: z.ZodNumber;
+    photoPoint: z.ZodNumber;
+  }, z.core.$strip>;
+  purchaseEarn: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    rateBp: z.ZodNumber;
+  }, z.core.$strip>;
+  expiryDays: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type PointPolicy = z.infer<typeof pointPolicySchema>;
+/** 정책이 없을 때 — 모두 끔 */
+export declare const POINT_POLICY_DEFAULTS: PointPolicy;
+/**
+ * 저장된 정책 → 유효 정책. null·형식이 틀린 값은 기본(모두 끔)이다. 키 하나가 틀려도 그 묶음만 기본으로 읽는다
+ * (정책 형식이 바뀌어 옛 행이 남아 있을 때 적립을 잘못 켜지 않게 한다).
+ */
+export declare function resolvePointPolicy(stored: unknown): PointPolicy;
+/** 적립을 하나라도 켰는가 — 켜면 유효 기간이 필수다 */
+export declare function pointEarningEnabled(policy: PointPolicy): boolean;
+/**
+ * 주문상품에 적용할 구매 적립률 — 구매 적립이 꺼져 있으면 0, 상품 덮어쓰기(`products.point_earn_rate_bp`)가 있으면 그 값
+ * (0 = 적립 안 함), 없으면 상점 기본이다. 결제 확정 때 주문상품에 스냅샷한다.
+ */
+export declare function purchaseEarnRateOf(policy: PointPolicy, productRateBp: number | null): number;
+/** 구매 적립 금액 — 적립 기준 금액 × 적립률, 1원 미만은 내린다 */
+export declare function pointEarnOf(input: {
+  paidBase: number;
+  rateBp: number;
+}): number;
+/** 리뷰 하나의 적립 금액 — 정책이 꺼져 있으면 0이다. 사진은 추가분이다 */
+export declare function reviewRewardPointOf(policy: PointPolicy, hasPhoto: boolean): number;
+/**
+ * 적립 묶음의 만료 시각 — 적립 시각 + `days`일이 속한 한국 시간 날짜의 끝(23:59:59.999 KST). 구매자 안내가 날짜 단위라
+ * 시각을 날짜 끝에 맞춘다. `days`가 null이면 만료 없음(null)이다.
+ */
+export declare function pointExpiresAtOf(earnedAt: Date, days: number | null): Date | null;
+/** 적립 묶음 출처 — 같은 출처 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` 적립금 설정을 쓸 수 있음 */
+export declare const pointPolicyNoticeSchema: z.ZodNullable<z.ZodEnum<{
+  REVIEW_REWARD_PAUSED: "REVIEW_REWARD_PAUSED";
+  POINTS_AVAILABLE: "POINTS_AVAILABLE";
+}>>;
+export type PointPolicyNotice = z.infer<typeof pointPolicyNoticeSchema>;
+/** `GET /v1/store/point-policy` 응답 */
+export declare const storePointPolicySchema: z.ZodObject<{
+  available: z.ZodBoolean;
+  configured: z.ZodBoolean;
+  reviewReward: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    textPoint: z.ZodNumber;
+    photoPoint: z.ZodNumber;
+  }, z.core.$strip>;
+  purchaseEarn: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    rateBp: z.ZodNumber;
+  }, z.core.$strip>;
+  expiryDays: z.ZodNullable<z.ZodNumber>;
+  notice: z.ZodNullable<z.ZodEnum<{
+    REVIEW_REWARD_PAUSED: "REVIEW_REWARD_PAUSED";
+    POINTS_AVAILABLE: "POINTS_AVAILABLE";
+  }>>;
+}, z.core.$strip>;
+export type StorePointPolicy = z.infer<typeof storePointPolicySchema>;
+/**
+ * `PUT /v1/store/point-policy` 본문 — 준 항목만 바꾼다(생략 = 저장된 값 유지). 리뷰 적립·구매 적립 중 하나라도 켜면 유효 기간이 있어야 한다
+ * (본문이나 저장된 값, 없으면 400 `POINT_EXPIRY_REQUIRED`).
+ */
+export declare const updatePointPolicyRequestSchema: z.ZodObject<{
+  reviewReward: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    textPoint: z.ZodNumber;
+    photoPoint: z.ZodNumber;
+  }, z.core.$strip>>;
+  purchaseEarn: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    rateBp: z.ZodNumber;
+  }, z.core.$strip>>;
+  expiryDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UpdatePointPolicyRequest = z.infer<typeof updatePointPolicyRequestSchema>;
+/** 응답의 원장 유형 — 값이 추가될 수 있어 문자열로 받는다 */
+export declare const responsePointEntryTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+  EARN_REVIEW: "EARN_REVIEW";
+  REVOKE_REVIEW: "REVOKE_REVIEW";
+  EARN_PURCHASE: "EARN_PURCHASE";
+  USE_RESERVE: "USE_RESERVE";
+  USE_RELEASE: "USE_RELEASE";
+  REFUND_RESTORE: "REFUND_RESTORE";
+  EXPIRE: "EXPIRE";
+  ADJUST: "ADJUST";
+  OPENING: "OPENING";
+}>, z.ZodString]>;
+/** 원장 항목 — 셀러 조회용(사유·행위자 포함) */
+export declare const pointEntrySchema: z.ZodObject<{
+  entryId: z.ZodString;
+  memberId: z.ZodString;
+  type: z.ZodUnion<readonly [z.ZodEnum<{
+    EARN_REVIEW: "EARN_REVIEW";
+    REVOKE_REVIEW: "REVOKE_REVIEW";
+    EARN_PURCHASE: "EARN_PURCHASE";
+    USE_RESERVE: "USE_RESERVE";
+    USE_RELEASE: "USE_RELEASE";
+    REFUND_RESTORE: "REFUND_RESTORE";
+    EXPIRE: "EXPIRE";
+    ADJUST: "ADJUST";
+    OPENING: "OPENING";
+  }>, z.ZodString]>;
+  amount: z.ZodNumber;
+  balanceAfter: z.ZodNumber;
+  refType: z.ZodNullable<z.ZodString>;
+  refId: z.ZodNullable<z.ZodString>;
+  memo: z.ZodNullable<z.ZodString>;
+  actor: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+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";
+  }>, z.ZodString]>;
+  amount: z.ZodNumber;
+  remaining: z.ZodNumber;
+  expiresAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type PointLot = z.infer<typeof pointLotSchema>;
+/** `GET /v1/customers/{customerId}/points` */
+export declare const customerPointsSchema: z.ZodObject<{
+  balance: z.ZodNumber;
+  expiringSoon: z.ZodNumber;
+  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";
+    }>, z.ZodString]>;
+    amount: z.ZodNumber;
+    remaining: z.ZodNumber;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CustomerPoints = z.infer<typeof customerPointsSchema>;
+/** 원장 조회 쿼리 — 상점 전체(`GET /v1/points/history`)는 회원·유형·기간으로 거른다 */
+export declare const pointHistoryQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  size: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  type: z.ZodOptional<z.ZodString>;
+  memberId: z.ZodOptional<z.ZodString>;
+  from: z.ZodOptional<z.ZodISODateTime>;
+  to: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type PointHistoryQuery = z.infer<typeof pointHistoryQuerySchema>;
+/** 셀러 조정 금액 한도 — 한 번에 천만 원 */
+export declare const POINT_ADJUSTMENT_MAX = 10000000;
+/**
+ * `POST /v1/customers/{customerId}/points/adjustments` — 셀러 지급(+)·차감(−). 헤더 `Idempotency-Key`가 필수다.
+ * 지급의 소멸 시각은 `expiresAt`(생략하면 정책 유효 기간, 정책이 없으면 400 `POINT_EXPIRY_REQUIRED`), 차감은 소멸이 이른 적립금부터 뺀다
+ * (잔액보다 많으면 409 `POINT_BALANCE_INSUFFICIENT`).
+ */
+export declare const pointAdjustmentRequestSchema: z.ZodObject<{
+  amount: z.ZodNumber;
+  reason: z.ZodString;
+  expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type PointAdjustmentRequest = z.infer<typeof pointAdjustmentRequestSchema>;
+export declare const pointAdjustmentResultSchema: z.ZodObject<{
+  entry: z.ZodObject<{
+    entryId: z.ZodString;
+    memberId: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodEnum<{
+      EARN_REVIEW: "EARN_REVIEW";
+      REVOKE_REVIEW: "REVOKE_REVIEW";
+      EARN_PURCHASE: "EARN_PURCHASE";
+      USE_RESERVE: "USE_RESERVE";
+      USE_RELEASE: "USE_RELEASE";
+      REFUND_RESTORE: "REFUND_RESTORE";
+      EXPIRE: "EXPIRE";
+      ADJUST: "ADJUST";
+      OPENING: "OPENING";
+    }>, z.ZodString]>;
+    amount: z.ZodNumber;
+    balanceAfter: z.ZodNumber;
+    refType: z.ZodNullable<z.ZodString>;
+    refId: z.ZodNullable<z.ZodString>;
+    memo: z.ZodNullable<z.ZodString>;
+    actor: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>;
+  balance: z.ZodNumber;
+}, z.core.$strip>;
+export type PointAdjustmentResult = z.infer<typeof pointAdjustmentResultSchema>;
+//#endregion
 //#region src/schemas/product.d.ts
 export declare const productStatusSchema: z.ZodEnum<{
-  SALE: "SALE";
   SUSPENDED: "SUSPENDED";
-  OUT_OF_STOCK: "OUT_OF_STOCK";
   CLOSED: "CLOSED";
+  SALE: "SALE";
+  OUT_OF_STOCK: "OUT_OF_STOCK";
 }>;
 export type ProductStatus = z.infer<typeof productStatusSchema>;
 export declare const productSummarySchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -5070,10 +5309,10 @@ export declare const productSchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -5086,6 +5325,7 @@ export declare const productSchema: z.ZodObject<{
   description: z.ZodOptional<z.ZodString>;
   descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   originalPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  pointEarnRateBp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
   images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
   attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
     attributeId: z.ZodString;
@@ -5432,6 +5672,7 @@ export declare const productCreateRequestSchema: z.ZodObject<{
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
   originalPrice: z.ZodOptional<z.ZodNumber>;
+  pointEarnRateBp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
   description: z.ZodOptional<z.ZodString>;
   descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
@@ -5517,6 +5758,7 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
   categoryId: z.ZodString;
   salePrice: z.ZodNumber;
   originalPrice: z.ZodOptional<z.ZodNumber>;
+  pointEarnRateBp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
   description: z.ZodOptional<z.ZodString>;
   descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
@@ -5538,10 +5780,10 @@ export declare const productPatchRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
   salePrice: z.ZodOptional<z.ZodNumber>;
   status: z.ZodOptional<z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>>;
   images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
   fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -5567,6 +5809,7 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
     conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>>;
+  pointEarnRateBp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strict>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
@@ -5589,10 +5832,10 @@ export declare const productListQuerySchema: z.ZodObject<{
   page: z.ZodOptional<z.ZodString>;
   size: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>>;
   categoryId: z.ZodOptional<z.ZodString>;
   keyword: z.ZodOptional<z.ZodString>;
@@ -5969,9 +6212,9 @@ export declare const storeSchema: z.ZodObject<{
   storeCode: z.ZodString;
   storefrontUrl: z.ZodURL;
   status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
     SUSPENDED: "SUSPENDED";
     CLOSED: "CLOSED";
-    ACTIVE: "ACTIVE";
   }>;
   logoUrl: z.ZodNullable<z.ZodURL>;
   businessNumber: z.ZodNullable<z.ZodString>;
@@ -5983,9 +6226,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>;
@@ -6249,9 +6492,9 @@ export declare const storefrontVersionSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StorefrontVersion = z.infer<typeof storefrontVersionSchema>;
 export declare const storefrontSiteStatusSchema: z.ZodEnum<{
+  ACTIVE: "ACTIVE";
   SUSPENDED: "SUSPENDED";
   CLOSED: "CLOSED";
-  ACTIVE: "ACTIVE";
 }>;
 export type StorefrontSiteStatus = z.infer<typeof storefrontSiteStatusSchema>;
 export declare const storefrontVisibilitySchema: z.ZodEnum<{
@@ -6332,9 +6575,9 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     MANAGED: "MANAGED";
   }>;
   status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
     SUSPENDED: "SUSPENDED";
     CLOSED: "CLOSED";
-    ACTIVE: "ACTIVE";
   }>;
   visibility: z.ZodEnum<{
     COMING_SOON: "COMING_SOON";
@@ -6412,9 +6655,9 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       MANAGED: "MANAGED";
     }>;
     status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
       SUSPENDED: "SUSPENDED";
       CLOSED: "CLOSED";
-      ACTIVE: "ACTIVE";
     }>;
     visibility: z.ZodEnum<{
       COMING_SOON: "COMING_SOON";
@@ -6509,9 +6752,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
 export declare const storefrontDeploymentSchema: z.ZodObject<{
   siteId: z.ZodString;
   status: z.ZodEnum<{
+    IN_PROGRESS: "IN_PROGRESS";
     SUCCEEDED: "SUCCEEDED";
     FAILED: "FAILED";
-    IN_PROGRESS: "IN_PROGRESS";
   }>;
   url: z.ZodString;
   startedAt: z.ZodString;
@@ -6644,8 +6887,8 @@ export declare function storefrontCustomHostnameProblem(hostname: string, hostin
 /** 소유 확인 TXT 레코드의 전체 이름 */
 export declare function storefrontDomainTxtNameOf(hostname: string): string;
 export declare const storefrontCustomDomainStatusSchema: z.ZodEnum<{
-  FAILED: "FAILED";
   ACTIVE: "ACTIVE";
+  FAILED: "FAILED";
   PENDING_DNS: "PENDING_DNS";
   PENDING_VALIDATION: "PENDING_VALIDATION";
 }>;
@@ -6671,8 +6914,8 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
     CUSTOM: "CUSTOM";
   }>;
   status: z.ZodEnum<{
-    FAILED: "FAILED";
     ACTIVE: "ACTIVE";
+    FAILED: "FAILED";
     PENDING_DNS: "PENDING_DNS";
     PENDING_VALIDATION: "PENDING_VALIDATION";
   }>;
@@ -6690,9 +6933,9 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
     }>;
   }, z.core.$strip>>;
   certificateStatus: z.ZodNullable<z.ZodEnum<{
+    ACTIVE: "ACTIVE";
     FAILED: "FAILED";
     PENDING: "PENDING";
-    ACTIVE: "ACTIVE";
   }>>;
   failureCode: z.ZodNullable<z.ZodString>;
   verifiedAt: z.ZodNullable<z.ZodString>;
@@ -6714,8 +6957,8 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
       CUSTOM: "CUSTOM";
     }>;
     status: z.ZodEnum<{
-      FAILED: "FAILED";
       ACTIVE: "ACTIVE";
+      FAILED: "FAILED";
       PENDING_DNS: "PENDING_DNS";
       PENDING_VALIDATION: "PENDING_VALIDATION";
     }>;
@@ -6733,9 +6976,9 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
       }>;
     }, z.core.$strip>>;
     certificateStatus: z.ZodNullable<z.ZodEnum<{
+      ACTIVE: "ACTIVE";
       FAILED: "FAILED";
       PENDING: "PENDING";
-      ACTIVE: "ACTIVE";
     }>>;
     failureCode: z.ZodNullable<z.ZodString>;
     verifiedAt: z.ZodNullable<z.ZodString>;
@@ -6969,8 +7212,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";
@@ -6983,8 +7226,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";
@@ -7518,9 +7761,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<{
@@ -7528,14 +7771,14 @@ 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<{
+    ACTIVE: "ACTIVE";
     SUSPENDED: "SUSPENDED";
     CLOSED: "CLOSED";
-    ACTIVE: "ACTIVE";
   }>;
 }, z.core.$strip>;
 export type MyStore = z.infer<typeof myStoreSchema>;
@@ -7690,8 +7933,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storeId: string;
       storeName: string;
       storeCode: string;
-      role: "ADMIN" | "STAFF" | "OWNER";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      role: "OWNER" | "ADMIN" | "STAFF";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
     }[]>;
     me: () => Promise<{
       userId: string;
@@ -7730,7 +7973,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         productId: string;
         name: string;
-        status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+        status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
         salePrice: number;
         discountedPrice: number | null;
         stockQuantity: number;
@@ -7747,7 +7990,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (productId: string) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -7826,6 +8069,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
+      pointEarnRateBp?: number | null | undefined;
       images?: string[] | undefined;
       attributes?: {
         attributeId: string;
@@ -7844,7 +8088,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -7923,6 +8167,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
+      pointEarnRateBp?: number | null | undefined;
       images?: string[] | undefined;
       attributes?: {
         attributeId: string;
@@ -7941,7 +8186,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -8020,6 +8265,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       description?: string | undefined;
       descriptionJson?: string | null | undefined;
       originalPrice?: number | null | undefined;
+      pointEarnRateBp?: number | null | undefined;
       images?: string[] | undefined;
       attributes?: {
         attributeId: string;
@@ -9070,7 +9316,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         claimId: string;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -9108,7 +9354,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9142,7 +9388,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
         actor: "SYSTEM" | "BUYER" | "SELLER";
         occurredAt: string;
       }[] | undefined;
@@ -9174,7 +9420,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     completeExchange: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9355,7 +9601,80 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
   };
   /** 구매자 관리 — 조회 `customer:r`, 탈퇴 처리 `customer:rw`(상점 플랫폼 OWNER·ADMIN) */
+  /** 적립금 — 상점 전체 원장(#93). 스코프 `promotion:r` */
+  points: {
+    /** `GET /v1/points/history` — 회원(`memberId`)·유형(`type`)·기간(`from`·`to`)으로 거른다 */
+    listHistory: (params?: PointHistoryQuery) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        entryId: string;
+        memberId: string;
+        type: string;
+        amount: number;
+        balanceAfter: number;
+        refType: string | null;
+        refId: string | null;
+        memo: string | null;
+        actor: string | null;
+        createdAt: string;
+      }[];
+    }>;
+  };
   customers: {
+    /** `GET /v1/customers/{customerId}/points` — 잔액·30일 안 소멸 예정·남은 적립 묶음(#93) */
+    getPoints: (customerId: string) => Promise<{
+      balance: number;
+      expiringSoon: number;
+      lots: {
+        lotId: string;
+        source: string;
+        amount: number;
+        remaining: number;
+        expiresAt: string | null;
+        createdAt: string;
+      }[];
+    }>;
+    /** `GET /v1/customers/{customerId}/points/history` — 적립금 내역(최신순, 셀러 사유 포함) */
+    listPointHistory: (customerId: string, params?: Omit<PointHistoryQuery, "memberId">) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        entryId: string;
+        memberId: string;
+        type: string;
+        amount: number;
+        balanceAfter: number;
+        refType: string | null;
+        refId: string | null;
+        memo: string | null;
+        actor: string | null;
+        createdAt: string;
+      }[];
+    }>;
+    /**
+     * `POST /v1/customers/{customerId}/points/adjustments` (201) — 스코프 `promotion:rw`. 양수 지급, 음수 차감. `idempotencyKey`가 필수다.
+     * 에러: 409 `POINT_BALANCE_INSUFFICIENT`·`POINTS_UNAVAILABLE`, 400 `POINT_EXPIRY_REQUIRED`. 에이전트 요청은 승인 대상이다
+     */
+    adjustPoints: (customerId: string, body: PointAdjustmentRequest, idempotencyKey: string) => Promise<{
+      entry: {
+        entryId: string;
+        memberId: string;
+        type: string;
+        amount: number;
+        balanceAfter: number;
+        refType: string | null;
+        refId: string | null;
+        memo: string | null;
+        actor: string | null;
+        createdAt: string;
+      };
+      balance: number;
+    }>;
     list: (params?: PageParams & Omit<z.input<typeof customerListQuerySchema>, "page" | "size">) => Promise<{
       page: number;
       size: number;
@@ -10077,7 +10396,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     sources: (params: AnalyticsSourcesParams) => Promise<{
       groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
       rows: {
-        channel: "UNKNOWN" | "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | null;
+        channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -11050,7 +11369,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       webhookId: string;
       url: string;
       eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
-      status: "SUSPENDED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
       createdAt: string;
@@ -11060,7 +11379,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       webhookId: string;
       url: string;
       eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
-      status: "SUSPENDED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
       createdAt: string;
@@ -11070,7 +11389,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       webhookId: string;
       url: string;
       eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
-      status: "SUSPENDED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
       createdAt: string;
@@ -11080,7 +11399,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       webhookId: string;
       url: string;
       eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
-      status: "SUSPENDED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
       createdAt: string;
@@ -11095,7 +11414,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       webhookId: string;
       url: string;
       eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
-      status: "SUSPENDED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
       createdAt: string;
@@ -11282,7 +11601,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+        status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -11332,7 +11651,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -11384,7 +11703,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -11432,7 +11751,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
+      status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -11582,7 +11901,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         templateId: string;
         sourceMode: "CUSTOM" | "MANAGED";
-        status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+        status: "ACTIVE" | "SUSPENDED" | "CLOSED";
         visibility: "COMING_SOON" | "PUBLIC";
         publishedVersion: {
           versionId: string;
@@ -11640,7 +11959,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -11676,7 +11995,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
     getDeployment: () => Promise<{
       siteId: string;
-      status: "SUCCEEDED" | "FAILED" | "IN_PROGRESS";
+      status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -11698,7 +12017,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
     retryDeployment: () => Promise<{
       siteId: string;
-      status: "SUCCEEDED" | "FAILED" | "IN_PROGRESS";
+      status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -11736,7 +12055,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -11800,7 +12119,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -11848,7 +12167,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -11896,7 +12215,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -11944,7 +12263,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -11994,7 +12313,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         domainId: string;
         hostname: string;
         kind: "PLATFORM" | "CUSTOM";
-        status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
+        status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
         isPrimary: boolean;
         dnsRecords: {
           type: "CNAME" | "TXT";
@@ -12002,7 +12321,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           value: string;
           purpose: "ROUTING" | "OWNERSHIP";
         }[];
-        certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
+        certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
         failureCode: string | null;
         verifiedAt: string | null;
         activatedAt: string | null;
@@ -12018,7 +12337,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       domainId: string;
       hostname: string;
       kind: "PLATFORM" | "CUSTOM";
-      status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
+      status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
       isPrimary: boolean;
       dnsRecords: {
         type: "CNAME" | "TXT";
@@ -12026,7 +12345,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: string;
         purpose: "ROUTING" | "OWNERSHIP";
       }[];
-      certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
+      certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
       failureCode: string | null;
       verifiedAt: string | null;
       activatedAt: string | null;
@@ -12038,7 +12357,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       domainId: string;
       hostname: string;
       kind: "PLATFORM" | "CUSTOM";
-      status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
+      status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
       isPrimary: boolean;
       dnsRecords: {
         type: "CNAME" | "TXT";
@@ -12046,7 +12365,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: string;
         purpose: "ROUTING" | "OWNERSHIP";
       }[];
-      certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
+      certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
       failureCode: string | null;
       verifiedAt: string | null;
       activatedAt: string | null;
@@ -12062,7 +12381,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         domainId: string;
         hostname: string;
         kind: "PLATFORM" | "CUSTOM";
-        status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
+        status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
         isPrimary: boolean;
         dnsRecords: {
           type: "CNAME" | "TXT";
@@ -12070,7 +12389,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           value: string;
           purpose: "ROUTING" | "OWNERSHIP";
         }[];
-        certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
+        certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
         failureCode: string | null;
         verifiedAt: string | null;
         activatedAt: string | null;
@@ -12095,7 +12414,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       templateId: string;
       sourceMode: "CUSTOM" | "MANAGED";
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       visibility: "COMING_SOON" | "PUBLIC";
       publishedVersion: {
         versionId: string;
@@ -12273,7 +12592,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;
@@ -12287,7 +12606,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;
@@ -12798,7 +13117,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       name: string;
       storeCode: string;
       storefrontUrl: string;
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       logoUrl: string | null;
       businessNumber: string | null;
       customerCenterPhone: string | null;
@@ -12846,16 +13165,54 @@ export declare function createStoreClient(options: StoreClientOptions): {
       name: string;
       storeCode: string;
       storefrontUrl: string;
-      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
       logoUrl: string | null;
       businessNumber: string | null;
       customerCenterPhone: string | null;
     }>;
+    /**
+     * `GET /v1/store/point-policy` — 스코프 `promotion:r`. 적립금 정책(리뷰 적립·유효 기간)과 준비 여부(`available`), 상점에 보일 안내(`notice`).
+     * 정책을 정하지 않았으면 모두 끔이다(#93)
+     */
+    getPointPolicy: () => Promise<{
+      available: boolean;
+      configured: boolean;
+      reviewReward: {
+        enabled: boolean;
+        textPoint: number;
+        photoPoint: number;
+      };
+      purchaseEarn: {
+        enabled: boolean;
+        rateBp: number;
+      };
+      expiryDays: number | null;
+      notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
+    }>;
+    /**
+     * `PUT /v1/store/point-policy` — 스코프 `promotion:rw`. 준 항목만 바꾼다. 에이전트 요청은 승인 대상이다.
+     * 에러: 409 `POINTS_UNAVAILABLE`(준비 중) · 400 `POINT_EXPIRY_REQUIRED`(리뷰 적립을 켜는데 유효 기간이 없음)
+     */
+    updatePointPolicy: (body: UpdatePointPolicyRequest) => Promise<{
+      available: boolean;
+      configured: boolean;
+      reviewReward: {
+        enabled: boolean;
+        textPoint: number;
+        photoPoint: number;
+      };
+      purchaseEarn: {
+        enabled: boolean;
+        rateBp: number;
+      };
+      expiryDays: number | null;
+      notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
+    }>;
     listMembers: () => Promise<{
       userId: string;
       name: string;
       email: string;
-      role: "ADMIN" | "STAFF" | "OWNER";
+      role: "OWNER" | "ADMIN" | "STAFF";
       joinedAt: string;
       lastActiveAt: string | null;
     }[]>;
@@ -14159,8 +14516,8 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    REJECTED: "REJECTED";
     COMPLETED: "COMPLETED";
+    REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -14349,8 +14706,8 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      REJECTED: "REJECTED";
       COMPLETED: "COMPLETED";
+      REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -14559,8 +14916,8 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      REJECTED: "REJECTED";
       COMPLETED: "COMPLETED";
+      REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";