@sayren/store-sdk 0.9.0 → 0.10.0

package/dist/index.d.mts

@@ -1119,6 +1119,7 @@ export declare const claimSchema: z.ZodObject<{
   }>;
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1197,6 +1198,7 @@ export declare const claimDetailSchema: z.ZodObject<{
   }>;
   claimDeliveryFee: z.ZodNumber;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
   exchangeOption: z.ZodNullable<z.ZodObject<{
     optionId: z.ZodString;
     optionName: z.ZodString;
@@ -1256,6 +1258,9 @@ export declare const approveClaimResultSchema: z.ZodObject<{
   claimId: z.ZodString;
   refundAmount: z.ZodNumber;
   deductAmount: z.ZodNumber;
+  quantity: z.ZodNumber;
+  deliveryFeeRefundAmount: z.ZodNumber;
+  deliveryFeeChargeAmount: z.ZodNumber;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
@@ -1319,6 +1324,125 @@ export declare const customerAddressSchema: z.ZodObject<{
   address1: z.ZodString;
   address2: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/** 동의 종류 — 이용약관·개인정보 수집이용은 가입 필수, 마케팅 수신은 선택 */
+export declare const consentKindSchema: z.ZodEnum<{
+  TERMS: "TERMS";
+  PRIVACY: "PRIVACY";
+  MARKETING: "MARKETING";
+}>;
+export type ConsentKind = z.infer<typeof consentKindSchema>;
+export declare const consentActionSchema: z.ZodEnum<{
+  WITHDRAWN: "WITHDRAWN";
+  AGREED: "AGREED";
+}>;
+export type ConsentAction = z.infer<typeof consentActionSchema>;
+/**
+ * 동의가 일어난 경로. 값이 추가될 수 있어 모르는 값은 그대로 보여 준다.
+ * `SIGNUP` 비밀번호 가입 · `SOCIAL_SIGNUP` 소셜 가입 · `DELEGATED` 셀러 자체 회원 연동 ·
+ * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
+ */
+export declare const consentSourceSchema: z.ZodEnum<{
+  SELLER: "SELLER";
+  SIGNUP: "SIGNUP";
+  SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
+  DELEGATED: "DELEGATED";
+  RECONSENT: "RECONSENT";
+  MEMBER_UPDATE: "MEMBER_UPDATE";
+}>;
+export type ConsentSource = z.infer<typeof consentSourceSchema>;
+/** 동의 이력 한 줄 — 추가만 되고 지워지지 않는다(구매자 탈퇴 시에만 함께 지워진다) */
+export declare const customerConsentSchema: z.ZodObject<{
+  consentId: z.ZodString;
+  kind: z.ZodEnum<{
+    TERMS: "TERMS";
+    PRIVACY: "PRIVACY";
+    MARKETING: "MARKETING";
+  }>;
+  version: z.ZodNullable<z.ZodString>;
+  documentUrl: z.ZodNullable<z.ZodString>;
+  action: z.ZodEnum<{
+    WITHDRAWN: "WITHDRAWN";
+    AGREED: "AGREED";
+  }>;
+  source: z.ZodEnum<{
+    SELLER: "SELLER";
+    SIGNUP: "SIGNUP";
+    SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
+    DELEGATED: "DELEGATED";
+    RECONSENT: "RECONSENT";
+    MEMBER_UPDATE: "MEMBER_UPDATE";
+  }>;
+  occurredAt: z.ZodString;
+}, z.core.$strip>;
+export type CustomerConsent = z.infer<typeof customerConsentSchema>;
+/** 종류별 현재 동의 상태 */
+export declare const customerConsentStateSchema: z.ZodObject<{
+  kind: z.ZodEnum<{
+    TERMS: "TERMS";
+    PRIVACY: "PRIVACY";
+    MARKETING: "MARKETING";
+  }>;
+  agreed: z.ZodBoolean;
+  agreedVersion: z.ZodNullable<z.ZodString>;
+  currentVersion: z.ZodNullable<z.ZodString>;
+  currentDocumentUrl: z.ZodNullable<z.ZodString>;
+  updatedAt: z.ZodNullable<z.ZodString>;
+  reconsentRequired: z.ZodBoolean;
+}, z.core.$strip>;
+export type CustomerConsentState = z.infer<typeof customerConsentStateSchema>;
+export declare const customerConsentsSchema: z.ZodObject<{
+  terms: z.ZodObject<{
+    kind: z.ZodEnum<{
+      TERMS: "TERMS";
+      PRIVACY: "PRIVACY";
+      MARKETING: "MARKETING";
+    }>;
+    agreed: z.ZodBoolean;
+    agreedVersion: z.ZodNullable<z.ZodString>;
+    currentVersion: z.ZodNullable<z.ZodString>;
+    currentDocumentUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
+  privacy: z.ZodObject<{
+    kind: z.ZodEnum<{
+      TERMS: "TERMS";
+      PRIVACY: "PRIVACY";
+      MARKETING: "MARKETING";
+    }>;
+    agreed: z.ZodBoolean;
+    agreedVersion: z.ZodNullable<z.ZodString>;
+    currentVersion: z.ZodNullable<z.ZodString>;
+    currentDocumentUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
+  marketing: z.ZodObject<{
+    kind: z.ZodEnum<{
+      TERMS: "TERMS";
+      PRIVACY: "PRIVACY";
+      MARKETING: "MARKETING";
+    }>;
+    agreed: z.ZodBoolean;
+    agreedVersion: z.ZodNullable<z.ZodString>;
+    currentVersion: z.ZodNullable<z.ZodString>;
+    currentDocumentUrl: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
+  reconsentRequired: z.ZodBoolean;
+}, z.core.$strip>;
+export type CustomerConsents = z.infer<typeof customerConsentsSchema>;
+/** `GET /v1/customers/{id}/consents` 쿼리 — 최근 순이다 */
+export declare const customerConsentListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  kind: z.ZodOptional<z.ZodEnum<{
+    TERMS: "TERMS";
+    PRIVACY: "PRIVACY";
+    MARKETING: "MARKETING";
+  }>>;
+}, z.core.$strip>;
 /** 구매자 상세 — 휴대폰 전체를 보여 준다 */
 export declare const customerDetailSchema: z.ZodObject<{
   customerId: z.ZodString;
@@ -1337,6 +1461,48 @@ export declare const customerDetailSchema: z.ZodObject<{
     }>;
     linkedAt: z.ZodString;
   }, z.core.$strip>>;
+  consents: z.ZodObject<{
+    terms: z.ZodObject<{
+      kind: z.ZodEnum<{
+        TERMS: "TERMS";
+        PRIVACY: "PRIVACY";
+        MARKETING: "MARKETING";
+      }>;
+      agreed: z.ZodBoolean;
+      agreedVersion: z.ZodNullable<z.ZodString>;
+      currentVersion: z.ZodNullable<z.ZodString>;
+      currentDocumentUrl: z.ZodNullable<z.ZodString>;
+      updatedAt: z.ZodNullable<z.ZodString>;
+      reconsentRequired: z.ZodBoolean;
+    }, z.core.$strip>;
+    privacy: z.ZodObject<{
+      kind: z.ZodEnum<{
+        TERMS: "TERMS";
+        PRIVACY: "PRIVACY";
+        MARKETING: "MARKETING";
+      }>;
+      agreed: z.ZodBoolean;
+      agreedVersion: z.ZodNullable<z.ZodString>;
+      currentVersion: z.ZodNullable<z.ZodString>;
+      currentDocumentUrl: z.ZodNullable<z.ZodString>;
+      updatedAt: z.ZodNullable<z.ZodString>;
+      reconsentRequired: z.ZodBoolean;
+    }, z.core.$strip>;
+    marketing: z.ZodObject<{
+      kind: z.ZodEnum<{
+        TERMS: "TERMS";
+        PRIVACY: "PRIVACY";
+        MARKETING: "MARKETING";
+      }>;
+      agreed: z.ZodBoolean;
+      agreedVersion: z.ZodNullable<z.ZodString>;
+      currentVersion: z.ZodNullable<z.ZodString>;
+      currentDocumentUrl: z.ZodNullable<z.ZodString>;
+      updatedAt: z.ZodNullable<z.ZodString>;
+      reconsentRequired: z.ZodBoolean;
+    }, z.core.$strip>;
+    reconsentRequired: z.ZodBoolean;
+  }, z.core.$strip>;
   addresses: z.ZodArray<z.ZodObject<{
     addressId: z.ZodString;
     alias: z.ZodString;
@@ -1991,6 +2157,8 @@ export declare const orderItemSchema: z.ZodObject<{
   optionName: z.ZodNullable<z.ZodString>;
   sellerCode: z.ZodNullable<z.ZodString>;
   quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  activeQuantity: z.ZodNumber;
   unitPrice: z.ZodNumber;
   discountAmount: z.ZodNumber;
   totalPrice: z.ZodNumber;
@@ -2076,6 +2244,8 @@ export declare const orderSchema: z.ZodObject<{
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
     quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    activeQuantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
@@ -2159,6 +2329,8 @@ export declare const orderItemPageSchema: z.ZodObject<{
     optionName: z.ZodNullable<z.ZodString>;
     sellerCode: z.ZodNullable<z.ZodString>;
     quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    activeQuantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     discountAmount: z.ZodNumber;
     totalPrice: z.ZodNumber;
@@ -2352,12 +2524,17 @@ export declare const cancelBySellerRequestSchema: z.ZodObject<{
     DELIVERY_IMPOSSIBLE: "DELIVERY_IMPOSSIBLE";
   }>;
   detail: z.ZodOptional<z.ZodString>;
+  quantity: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
 /** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
 export declare const cancelBySellerResultSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   refundAmount: z.ZodNumber;
+  quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  deliveryFeeRefundAmount: z.ZodNumber;
+  deliveryFeeChargeAmount: z.ZodNumber;
   refundedAt: z.ZodString;
 }, z.core.$strip>;
 export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
@@ -3458,6 +3635,13 @@ export declare const productSchema: z.ZodObject<{
   conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
   returnFee: z.ZodOptional<z.ZodNumber>;
   exchangeFee: z.ZodOptional<z.ZodNumber>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
   shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodOptional<z.ZodString>;
@@ -3615,6 +3799,13 @@ export declare const productCreateRequestSchema: z.ZodObject<{
   conditionalFreeAmount: z.ZodOptional<z.ZodNumber>;
   returnFee: z.ZodDefault<z.ZodNumber>;
   exchangeFee: z.ZodDefault<z.ZodNumber>;
+  refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
   shippingAddressId: z.ZodOptional<z.ZodString>;
   returnAddressId: z.ZodOptional<z.ZodString>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -3731,6 +3922,16 @@ export declare const analyticsOriginSchema: z.ZodString;
 export declare const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
 /** 자동 배송완료·자동 구매확정 대기일 상한 */
 export declare const MAX_AUTO_TRANSITION_DAYS = 30;
+/**
+ * 약관 버전 — 스토어가 정하는 문자열이다(`1`·`2`·`2026-09-26`·`v1.2` 등). 형식은 강제하지 않고 값이 다르면 다른 버전이다.
+ * 올리면 그 약관에 동의한 구매자의 `reconsentRequired`가 켜지고, 재동의가 이력에 남는다. 되돌리면 재동의 요구도 풀린다.
+ */
+export declare const policyVersionSchema: z.ZodString;
+/**
+ * 약관 문서 주소 — 구매자에게 보여 주는 약관 본문의 주소다. 동의 시점 값이 이력 행에 복사되므로
+ * 나중에 주소를 바꿔도 "무엇에 동의했는지"가 남는다. `null`로 지울 수 있다.
+ */
+export declare const policyDocumentUrlSchema: z.ZodNullable<z.ZodURL>;
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
 export declare const updateStoreRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
@@ -3742,6 +3943,17 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
   guestCheckoutEnabled: z.ZodOptional<z.ZodBoolean>;
   autoDeliverDays: z.ZodOptional<z.ZodNumber>;
   autoConfirmDays: z.ZodOptional<z.ZodNumber>;
+  refundPolicy: z.ZodOptional<z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+    returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+    sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+    conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  termsVersion: z.ZodOptional<z.ZodString>;
+  privacyVersion: z.ZodOptional<z.ZodString>;
+  termsUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+  privacyUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
 }, z.core.$strip>;
 export type UpdateStoreRequest = z.infer<typeof updateStoreRequestSchema>;
 export declare const storeSchema: z.ZodObject<{
@@ -3762,6 +3974,19 @@ export declare const storeSchema: z.ZodObject<{
   guestCheckoutEnabled: z.ZodBoolean;
   autoDeliverDays: z.ZodNumber;
   autoConfirmDays: z.ZodNumber;
+  refundPolicy: z.ZodObject<{
+    preShipmentDeliveryFeeRefund: z.ZodBoolean;
+    returnDeliveryFee: z.ZodNumber;
+    exchangeDeliveryFee: z.ZodNumber;
+    sellerFaultFreeShipping: z.ZodBoolean;
+    conditionalFreeShortfallCharge: z.ZodBoolean;
+  }, z.core.$strip>;
+  termsVersion: z.ZodString;
+  privacyVersion: z.ZodString;
+  termsVersionUpdatedAt: z.ZodNullable<z.ZodString>;
+  privacyVersionUpdatedAt: z.ZodNullable<z.ZodString>;
+  termsUrl: z.ZodNullable<z.ZodString>;
+  privacyUrl: z.ZodNullable<z.ZodString>;
   memberCount: z.ZodNumber;
   createdAt: z.ZodString;
 }, z.core.$strip>;
@@ -4270,6 +4495,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
       exchangeFee?: number | undefined;
+      refundPolicy?: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
@@ -4321,6 +4553,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
       exchangeFee?: number | undefined;
+      refundPolicy?: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
@@ -4372,6 +4611,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
       exchangeFee?: number | undefined;
+      refundPolicy?: {
+        preShipmentDeliveryFeeRefund?: boolean | undefined;
+        returnDeliveryFee?: number | undefined;
+        exchangeDeliveryFee?: number | undefined;
+        sellerFaultFreeShipping?: boolean | undefined;
+        conditionalFreeShortfallCharge?: boolean | undefined;
+      } | null | undefined;
       shippingAddressId?: string | null | undefined;
       returnAddressId?: string | null | undefined;
       createdAt?: string | undefined;
@@ -4678,6 +4924,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionName: string | null;
         sellerCode: string | null;
         quantity: number;
+        canceledQuantity: number;
+        activeQuantity: number;
         unitPrice: number;
         discountAmount: number;
         totalPrice: number;
@@ -4712,6 +4960,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         optionName: string | null;
         sellerCode: string | null;
         quantity: number;
+        canceledQuantity: number;
+        activeQuantity: number;
         unitPrice: number;
         discountAmount: number;
         totalPrice: number;
@@ -4743,6 +4993,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
     cancelBySeller: (orderItemId: string, body: CancelBySellerRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
       refundAmount: number;
+      quantity: number;
+      canceledQuantity: number;
+      deliveryFeeRefundAmount: number;
+      deliveryFeeChargeAmount: number;
       refundedAt: string;
     }>;
     updateMemo: (orderItemId: string, memo: string) => Promise<void>;
@@ -4791,6 +5045,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionName: string | null;
       sellerCode: string | null;
       quantity: number;
+      canceledQuantity: number;
+      activeQuantity: number;
       unitPrice: number;
       discountAmount: number;
       totalPrice: number;
@@ -4859,6 +5115,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         responsibility: "BUYER" | "SELLER";
         claimDeliveryFee: number;
         expectedRefundAmount: number | null;
+        expectedDeliveryFeeRefundAmount: number | null;
         exchangeOption: {
           optionId: string;
           optionName: string;
@@ -4887,6 +5144,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       responsibility: "BUYER" | "SELLER";
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
+      expectedDeliveryFeeRefundAmount: number | null;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -4910,6 +5168,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimId: string;
       refundAmount: number;
       deductAmount: number;
+      quantity: number;
+      deliveryFeeRefundAmount: number;
+      deliveryFeeChargeAmount: number;
       refundedAt: string;
     }>;
     reject: (claimId: string, body: RejectClaimRequest) => Promise<void>;
@@ -4938,6 +5199,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       responsibility: "BUYER" | "SELLER";
       claimDeliveryFee: number;
       expectedRefundAmount: number | null;
+      expectedDeliveryFeeRefundAmount: number | null;
       exchangeOption: {
         optionId: string;
         optionName: string;
@@ -5130,6 +5392,36 @@ export declare function createStoreClient(options: StoreClientOptions): {
         method: "kakao" | "naver" | "google" | "password";
         linkedAt: string;
       }[];
+      consents: {
+        terms: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        privacy: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        marketing: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        reconsentRequired: boolean;
+      };
       addresses: {
         addressId: string;
         alias: string;
@@ -5169,6 +5461,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
       }[];
     }>;
+    /** 동의 이력 — 최근 순. 가입·재동의·마케팅 변경이 한 줄씩 남는다 */
+    consents: (customerId: string, params?: PageParams & {
+      kind?: ConsentKind;
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        consentId: string;
+        kind: "TERMS" | "PRIVACY" | "MARKETING";
+        version: string | null;
+        documentUrl: string | null;
+        action: "WITHDRAWN" | "AGREED";
+        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
+        occurredAt: string;
+      }[];
+    }>;
     withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
   };
   customerInquiries: {
@@ -6540,6 +6850,19 @@ export declare function createStoreClient(options: StoreClientOptions): {
       guestCheckoutEnabled: boolean;
       autoDeliverDays: number;
       autoConfirmDays: number;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund: boolean;
+        returnDeliveryFee: number;
+        exchangeDeliveryFee: number;
+        sellerFaultFreeShipping: boolean;
+        conditionalFreeShortfallCharge: boolean;
+      };
+      termsVersion: string;
+      privacyVersion: string;
+      termsVersionUpdatedAt: string | null;
+      privacyVersionUpdatedAt: string | null;
+      termsUrl: string | null;
+      privacyUrl: string | null;
       memberCount: number;
       createdAt: string;
     }>;
@@ -6561,6 +6884,19 @@ export declare function createStoreClient(options: StoreClientOptions): {
       guestCheckoutEnabled: boolean;
       autoDeliverDays: number;
       autoConfirmDays: number;
+      refundPolicy: {
+        preShipmentDeliveryFeeRefund: boolean;
+        returnDeliveryFee: number;
+        exchangeDeliveryFee: number;
+        sellerFaultFreeShipping: boolean;
+        conditionalFreeShortfallCharge: boolean;
+      };
+      termsVersion: string;
+      privacyVersion: string;
+      termsVersionUpdatedAt: string | null;
+      privacyVersionUpdatedAt: string | null;
+      termsUrl: string | null;
+      privacyUrl: string | null;
       memberCount: number;
       createdAt: string;
     }>;
@@ -6644,6 +6980,77 @@ export declare function exchangeStoreTokenViaOAuth(options: {
   role?: string;
 }>;
 //#endregion
+//#region src/schemas/refund-policy.d.ts
+/** 유효 환불 정책 — 스토어 기본 + 상품별 덮어쓰기를 합친 결과 */
+export declare const refundPolicySchema: z.ZodObject<{
+  preShipmentDeliveryFeeRefund: z.ZodBoolean;
+  returnDeliveryFee: z.ZodNumber;
+  exchangeDeliveryFee: z.ZodNumber;
+  sellerFaultFreeShipping: z.ZodBoolean;
+  conditionalFreeShortfallCharge: z.ZodBoolean;
+}, z.core.$strip>;
+export type RefundPolicy = z.infer<typeof refundPolicySchema>;
+/**
+ * 스토어가 정하지 않았을 때 서버가 쓰는 값.
+ *
+ * `as const`가 아니라 `RefundPolicy`로 타입을 좁힌다 — 리터럴 타입이면 `Partial<typeof …>`로 일부만 바꿀 때
+ * `true` 자리에 `false`를 넣을 수 없다.
+ */
+export declare const REFUND_POLICY_DEFAULTS: RefundPolicy;
+/**
+ * 부분 정책 — 스토어 설정 요청과 상품별 덮어쓰기가 쓴다. 준 항목만 바뀐다.
+ *
+ * `strictObject`라 모르는 키는 400이다. 오타(`returnFee` 등)를 조용히 무시하면 셀러는 저장됐다고
+ * 믿는데 정책은 기본값으로 남는다.
+ */
+export declare const refundPolicyPatchSchema: z.ZodObject<{
+  preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
+  returnDeliveryFee: z.ZodOptional<z.ZodNumber>;
+  exchangeDeliveryFee: z.ZodOptional<z.ZodNumber>;
+  sellerFaultFreeShipping: z.ZodOptional<z.ZodBoolean>;
+  conditionalFreeShortfallCharge: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type RefundPolicyPatch = z.infer<typeof refundPolicyPatchSchema>;
+/** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기와 레거시 배송비 필드 */
+export interface RefundPolicyProductInput {
+  /** 상품별 덮어쓰기. 없으면 스토어 기본을 그대로 쓴다 */
+  refundPolicy?: RefundPolicyPatch | null;
+  /** @deprecated 레거시 상품 반품비 — `refundPolicy`가 없는 옛 상품의 값이다 */
+  returnFee?: number | null;
+  /** @deprecated 레거시 상품 교환비 — `refundPolicy`가 없는 옛 상품의 값이다 */
+  exchangeFee?: number | null;
+}
+/**
+ * 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
+ *
+ * 반품비·교환비는 레거시 필드(`products.returnFee`·`exchangeFee`)와 **연결**한다. 상품이
+ * `refundPolicy.returnDeliveryFee`를 정하면 그 값이 원천이고(서버가 `returnFee`도 같은 값으로 맞춘다),
+ * 정하지 않았으면 레거시 값이 0보다 클 때 그 값을 쓴다. 0이면 스토어 기본을 따른다 —
+ * 정책이 생기기 전에 만든 상품(반품비 0)이 스토어 기본을 물려받게 하는 규칙이다.
+ */
+export declare function resolveRefundPolicy(storePolicy?: RefundPolicyPatch | null, product?: RefundPolicyProductInput | null): RefundPolicy;
+/**
+ * 상품의 **덮어쓰기 자체** — 레거시 반품비·교환비를 같은 형태로 승격한 값이다. 덮어쓰기가 없으면 null.
+ *
+ * `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "스토어 기본을 물려받은 값"을 가를 수 없다.
+ * 관리 API 응답의 `refundPolicy`와 콘솔 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
+ * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박히거나, 레거시 값이 조용히 사라진다.
+ */
+export declare function productRefundPolicyOverride(product?: RefundPolicyProductInput | null): RefundPolicyPatch | null;
+/**
+ * 수량 단위 부분 취소의 환불 기준액 — **누적 내림의 차분**이다.
+ *
+ * 원 단위 반올림 규칙: `floor(주문상품 금액 × 누적 수량 ÷ 전체 수량)`을 두 번 구해 그 차를 쓴다.
+ * 부분 취소를 몇 번 나눠도 합이 주문상품 금액과 정확히 같아서 1원이 남거나 넘치지 않는다.
+ * 할인은 이미 단가에 들어 있어(주문 단위 쿠폰이 없다) 별도 안분이 없다.
+ *
+ * @param totalPrice 주문상품 금액 (할인 반영 단가 × 전체 수량)
+ * @param quantity 주문상품 전체 수량
+ * @param settledQuantity 이미 취소·반품된 누적 수량
+ * @param cancelQuantity 이번에 취소·반품할 수량
+ */
+export declare function proratedRefundBase(totalPrice: number, quantity: number, settledQuantity: number, cancelQuantity: number): number;
+//#endregion
 //#region src/schemas/scope.d.ts
 /**
  * 스토어 스코프 카탈로그 (auth-spec §7) — 형식 `{리소스}:{r|rw}`, rw는 r을 함의한다.
@@ -6736,6 +7143,11 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
+  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+  deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type ClaimWebhookEventData = z.infer<typeof claimWebhookEventDataSchema>;
@@ -6809,6 +7221,11 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
+    quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;
@@ -6900,6 +7317,11 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
+    quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    deliveryFeeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryFeeChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
   id: z.ZodString;