@sayren/storefront-sdk 0.9.0 → 0.11.0

package/dist/{index-DvHOQm2-.d.mts → index-OqvbJ6Xi.d.mts}

@@ -1,4 +1,4 @@
-import { c as LinkIdentityRequest, d as SignupRequest, f as SocialProvider, l as LoginRequest, m as WithdrawRequest, o as IdpAuthorizeRequest, r as TokenSource, s as IdpTokenRequest } from "./http-BbFHVGBf.mjs";
+import { c as IdpTokenRequest, f as SignupRequest, h as WithdrawRequest, l as LinkIdentityRequest, p as SocialProvider, r as TokenSource, s as IdpAuthorizeRequest, u as LoginRequest } from "./http-CeRVoUGu.mjs";
 import { z } from "zod";
 //#region src/analytics-ids.d.ts
 /**
@@ -255,6 +255,37 @@ declare const createCheckoutRequestSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type CreateCheckoutRequest = z.infer<typeof createCheckoutRequestSchema>;
+/** 지역 추가 배송비 구분 — 우편번호로 판정한다 */
+declare const remoteAreaSchema: z.ZodEnum<{
+  NONE: "NONE";
+  JEJU: "JEJU";
+  ISOLATED: "ISOLATED";
+}>;
+type RemoteArea = z.infer<typeof remoteAreaSchema>;
+/**
+ * 배송비 내역 (이슈 #29) — 배송비를 **몇 번, 왜** 부과했는지다.
+ *
+ * 배송비는 **배송 묶음**마다 붙는다. 같은 출고지 + 같은 배송 정책인 상품은 한 묶음이고 한 번만 낸다.
+ * 제주·도서산간 추가 배송비는 묶음마다 더하고, 무료배송이어도 붙는다.
+ *
+ * 주문서를 만들 때는 배송지를 모르므로 `zipCode`가 null이고 `remoteSurcharge`가 0이다.
+ * 배송지를 입력하면 `POST /storefront/v1/checkout/{checkoutId}/delivery-quote`로 다시 받고,
+ * **결제 시작이 보낸 배송지로 최종 확정한다** — 그래서 주문서 조회 금액과 실제 결제 금액이 다를 수 있다.
+ */
+declare const checkoutDeliverySchema: z.ZodObject<{
+  baseFee: z.ZodNumber;
+  remoteSurcharge: z.ZodNumber;
+  remoteArea: z.ZodEnum<{
+    NONE: "NONE";
+    JEJU: "JEJU";
+    ISOLATED: "ISOLATED";
+  }>;
+  remoteAreaLabel: z.ZodNullable<z.ZodString>;
+  bundleCount: z.ZodNumber;
+  freeByThreshold: z.ZodBoolean;
+  zipCode: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type CheckoutDelivery = z.infer<typeof checkoutDeliverySchema>;
 declare const checkoutSessionSchema: z.ZodObject<{
   checkoutId: z.ZodString;
   items: z.ZodArray<z.ZodObject<{
@@ -271,6 +302,19 @@ declare const checkoutSessionSchema: z.ZodObject<{
     deliveryFee: z.ZodNumber;
     totalAmount: z.ZodNumber;
   }, z.core.$strip>;
+  delivery: z.ZodObject<{
+    baseFee: z.ZodNumber;
+    remoteSurcharge: z.ZodNumber;
+    remoteArea: z.ZodEnum<{
+      NONE: "NONE";
+      JEJU: "JEJU";
+      ISOLATED: "ISOLATED";
+    }>;
+    remoteAreaLabel: z.ZodNullable<z.ZodString>;
+    bundleCount: z.ZodNumber;
+    freeByThreshold: z.ZodBoolean;
+    zipCode: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
   expiresAt: z.ZodString;
   paymentOptions: z.ZodLazy<z.ZodPreprocess<z.ZodArray<z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     pg: z.ZodEnum<{
@@ -315,6 +359,37 @@ declare const checkoutSessionSchema: z.ZodObject<{
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 type CheckoutSession = z.infer<typeof checkoutSessionSchema>;
+/**
+ * 배송비 미리보기 요청 — 배송지 우편번호로 배송비를 다시 계산한다. 주문서를 바꾸지 않는다(읽기 계산이다).
+ *
+ * 구매자가 배송지를 입력하거나 고칠 때 부르면 제주·도서산간 추가 배송비가 반영된 금액을 미리 보여 줄 수 있다.
+ */
+declare const deliveryQuoteRequestSchema: z.ZodObject<{
+  zipCode: z.ZodString;
+}, z.core.$strip>;
+type DeliveryQuoteRequest = z.infer<typeof deliveryQuoteRequestSchema>;
+/** 배송비 미리보기 응답 — 이 배송지로 결제하면 나갈 금액이다 */
+declare const deliveryQuoteSchema: z.ZodObject<{
+  amounts: z.ZodObject<{
+    productAmount: z.ZodNumber;
+    deliveryFee: z.ZodNumber;
+    totalAmount: z.ZodNumber;
+  }, z.core.$strip>;
+  delivery: z.ZodObject<{
+    baseFee: z.ZodNumber;
+    remoteSurcharge: z.ZodNumber;
+    remoteArea: z.ZodEnum<{
+      NONE: "NONE";
+      JEJU: "JEJU";
+      ISOLATED: "ISOLATED";
+    }>;
+    remoteAreaLabel: z.ZodNullable<z.ZodString>;
+    bundleCount: z.ZodNumber;
+    freeByThreshold: z.ZodBoolean;
+    zipCode: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type DeliveryQuoteResult = z.infer<typeof deliveryQuoteSchema>;
 declare const paymentMethodSchema: z.ZodEnum<{
   CARD: "CARD";
   EASY_PAY: "EASY_PAY";
@@ -493,6 +568,61 @@ declare const guestInfoSchema: z.ZodObject<{
   orderPassword: z.ZodString;
 }, z.core.$strip>;
 type GuestInfo = z.infer<typeof guestInfoSchema>;
+/** 현금영수증을 신청할 수 있는 결제수단 — 계좌이체·가상계좌 */
+declare const CASH_RECEIPT_METHODS: readonly ["BANK_TRANSFER", "VIRTUAL_ACCOUNT"];
+/** 이 결제수단으로 현금영수증을 신청할 수 있는가 */
+declare function cashReceiptAvailable(method: string): boolean;
+/** 현금영수증 용도 — `INCOME_DEDUCTION` 소득공제(개인) · `EXPENSE_PROOF` 지출증빙(사업자) */
+declare const cashReceiptTypeSchema: z.ZodEnum<{
+  INCOME_DEDUCTION: "INCOME_DEDUCTION";
+  EXPENSE_PROOF: "EXPENSE_PROOF";
+}>;
+type CashReceiptType = z.infer<typeof cashReceiptTypeSchema>;
+/** 현금영수증 식별 번호 종류 — 휴대폰 번호 · 현금영수증카드 번호 · 사업자등록번호 */
+type CashReceiptIdentityType = "PHONE" | "CARD" | "BUSINESS";
+/**
+ * 주민등록번호·외국인등록번호 형식인가 — 현금영수증 식별 번호로는 받지 않는다.
+ *
+ * 현금영수증카드 번호의 아래 끝(13자리)이 주민등록번호 길이와 겹친다. 개인 식별 번호는 최소로 받는다는 원칙이라
+ * 주민등록번호로 읽히는 값은 카드 번호 자리로도 받지 않는다.
+ *
+ * **13자리 숫자 전부를 막지 않는다.** 13자리 현금영수증카드를 쓰는 구매자가 신청할 수 없게 되기 때문이다.
+ * 대신 주민등록번호 형식 — 생년월일 6자리(월 01~12, 일 01~31) + 성별·세기 코드(1~8, 5~8은 외국인등록번호) — 으로
+ * 판정해 오탐을 줄인다(13자리 숫자 중 이 형식에 걸리는 비율은 약 3%다).
+ *
+ * 검증번호(뒤 1자리 mod 11)까지는 보지 않는다. 한 자리 오타가 난 주민등록번호도 생년월일을 담고 있어 막아야 하고,
+ * 2020년 10월 이후 발급된 외국인등록번호에는 검증번호 규칙이 없다.
+ *
+ * `cashReceiptIdentityTypeOf`와 같이 하이픈·공백은 빼고 판정한다.
+ */
+declare function residentNumberLike(identityNumber: string): boolean;
+/**
+ * 식별 번호 → 종류. 하이픈·공백은 빼고 판정한다. 용도에 맞지 않는 번호면 null이다.
+ * - 소득공제: 휴대폰 번호(01로 시작하는 10~11자리) 또는 현금영수증카드 번호(13~19자리)
+ * - 지출증빙: 사업자등록번호(10자리) 또는 현금영수증카드 번호(13~19자리)
+ *
+ * 자릿수 근거. PG 문서는 식별 번호의 최대 길이만 정하고 종류별 자릿수는 정하지 않는다
+ * (토스페이먼츠 `customerIdentityNumber` "최대 길이는 30자", 소득공제는 휴대폰 번호·현금영수증카드 번호,
+ * 지출증빙은 사업자등록번호: https://docs.tosspayments.com/common/apis/cash-receipt /
+ * 포트원 V2는 종류만 PHONE·CARD·BUSINESS로 나눈다: https://developers.portone.io/api/rest-v2/payment.cashReceipt).
+ * 그래서 자릿수는 국세청이 정하는 발급수단 규격을 따른다 — 홈택스 소비자 발급수단 등록의 카드 번호는
+ * 13~19자리 숫자이고(https://thisthatbase.com/cash-receipts-card-registration/ 가 옮긴 홈택스 안내,
+ * 원본은 https://www.hometax.go.kr/ 소비자 발급수단 관리), 사업자등록번호는 10자리, 휴대폰 번호는 01X + 7~8자리다.
+ * 국세청 자진발급 번호(010-000-1234)도 휴대폰 형식으로 통과한다.
+ */
+declare function cashReceiptIdentityTypeOf(type: CashReceiptType, identityNumber: string): CashReceiptIdentityType | null;
+/**
+ * 현금영수증 신청 — 계좌이체·가상계좌 결제에서만 보낼 수 있다. 결제가 승인되면 sayren이 결제한 PG로 발급하고,
+ * 환불하면 그만큼 취소한다. 식별 번호는 암호화해 저장하고 응답에는 가린 값만 나간다.
+ */
+declare const cashReceiptRequestSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    INCOME_DEDUCTION: "INCOME_DEDUCTION";
+    EXPENSE_PROOF: "EXPENSE_PROOF";
+  }>;
+  identityNumber: z.ZodString;
+}, z.core.$strip>;
+type CashReceiptRequest = z.infer<typeof cashReceiptRequestSchema>;
 /**
  * 결제 시작 — 배송지를 확정하고 고른 결제 옵션으로 결제 시도를 연다. 응답의 `payUrl`(결제 서비스)을 팝업(`mode=popup`)이나
  * 전체 페이지로 열면 결제 서비스가 PG 결제창을 띄우고 승인까지 한다. 리다이렉트 결제가 끝나면 구매자는 `returnUrl`로 돌아온다.
@@ -553,9 +683,20 @@ declare const startPaymentRequestSchema: z.ZodObject<{
     email: z.ZodEmail;
     orderPassword: z.ZodString;
   }, z.core.$strip>>;
+  cashReceipt: z.ZodOptional<z.ZodObject<{
+    type: z.ZodEnum<{
+      INCOME_DEDUCTION: "INCOME_DEDUCTION";
+      EXPENSE_PROOF: "EXPENSE_PROOF";
+    }>;
+    identityNumber: z.ZodString;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type StartPaymentRequest = z.infer<typeof startPaymentRequestSchema>;
-/** 같은 결제에서 다른 결제 옵션으로 다시 시도. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 쓴다 */
+/**
+ * 같은 결제에서 다른 결제 옵션으로 다시 시도. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 쓴다.
+ * `cashReceipt`를 보내면 현금영수증 신청을 이 값으로 바꾸고, 생략하면 결제 시작 때의 신청을 그대로 둔다
+ * (승인된 결제수단이 계좌이체·가상계좌가 아니면 발급하지 않는다)
+ */
 declare const retryPaymentRequestSchema: z.ZodObject<{
   option: z.ZodDiscriminatedUnion<[z.ZodObject<{
     pg: z.ZodEnum<{
@@ -595,6 +736,13 @@ declare const retryPaymentRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"MOBILE">;
   }, z.core.$strip>], "method">;
   returnUrl: z.ZodOptional<z.ZodURL>;
+  cashReceipt: z.ZodOptional<z.ZodObject<{
+    type: z.ZodEnum<{
+      INCOME_DEDUCTION: "INCOME_DEDUCTION";
+      EXPENSE_PROOF: "EXPENSE_PROOF";
+    }>;
+    identityNumber: z.ZodString;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type RetryPaymentRequest = z.infer<typeof retryPaymentRequestSchema>;
 declare const paymentStartSchema: z.ZodObject<{
@@ -640,6 +788,24 @@ declare const paymentStartSchema: z.ZodObject<{
   payUrl: z.ZodString;
   expiresAt: z.ZodString;
   testPayment: z.ZodBoolean;
+  amounts: z.ZodObject<{
+    productAmount: z.ZodNumber;
+    deliveryFee: z.ZodNumber;
+    totalAmount: z.ZodNumber;
+  }, z.core.$strip>;
+  delivery: z.ZodObject<{
+    baseFee: z.ZodNumber;
+    remoteSurcharge: z.ZodNumber;
+    remoteArea: z.ZodEnum<{
+      NONE: "NONE";
+      JEJU: "JEJU";
+      ISOLATED: "ISOLATED";
+    }>;
+    remoteAreaLabel: z.ZodNullable<z.ZodString>;
+    bundleCount: z.ZodNumber;
+    freeByThreshold: z.ZodBoolean;
+    zipCode: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
 }, z.core.$strip>;
 type PaymentStart = z.infer<typeof paymentStartSchema>;
 /** 결제창에서 결제하지 못한 이유 */
@@ -718,6 +884,7 @@ declare const createClaimRequestSchema: z.ZodObject<{
   reasonDetail: z.ZodOptional<z.ZodString>;
   evidenceImages: z.ZodOptional<z.ZodArray<z.ZodURL>>;
   exchangeOptionId: z.ZodOptional<z.ZodString>;
+  quantity: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type CreateClaimRequest = z.infer<typeof createClaimRequestSchema>;
 declare const createClaimResultSchema: z.ZodObject<{
@@ -725,8 +892,26 @@ declare const createClaimResultSchema: z.ZodObject<{
   status: z.ZodLiteral<"REQUESTED">;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
   claimDeliveryFee: z.ZodNumber;
+  quantity: z.ZodNumber;
+  deliveryFeeRefundAmount: z.ZodNumber;
 }, z.core.$strip>;
 type CreateClaimResult = z.infer<typeof createClaimResultSchema>;
+/**
+ * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 스토어 주소록의 기본 반품지이거나,
+ * 상품이 반품지를 따로 지정했으면 그 주소다.
+ *
+ * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 스토어도 null이다.
+ * 구매자가 직접 보내는 수거(`BUYER_SEND`)에 이 주소가 필요하다.
+ */
+declare const claimReturnAddressSchema: z.ZodObject<{
+  name: z.ZodString;
+  contactName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ClaimReturnAddress = z.infer<typeof claimReturnAddressSchema>;
 declare const myClaimSchema: z.ZodObject<{
   claimId: z.ZodString;
   type: z.ZodEnum<{
@@ -747,14 +932,125 @@ declare const myClaimSchema: z.ZodObject<{
   }>;
   orderItemId: z.ZodString;
   productName: z.ZodString;
+  quantity: z.ZodNumber;
   reason: z.ZodString;
   expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
   rejectReason: z.ZodNullable<z.ZodString>;
+  returnAddress: z.ZodNullable<z.ZodObject<{
+    name: z.ZodString;
+    contactName: z.ZodString;
+    phone: z.ZodString;
+    zipCode: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
   requestedAt: z.ZodString;
   completedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 type MyClaim = z.infer<typeof myClaimSchema>;
 //#endregion
+//#region src/schemas/consent.d.ts
+/**
+ * 동의 종류 — 이용약관(`TERMS`)·개인정보 수집이용(`PRIVACY`)은 가입 필수, 마케팅 수신(`MARKETING`)은 선택이다.
+ * 필수 동의는 철회할 수 없다(철회 = 탈퇴).
+ */
+declare const consentKindSchema: z.ZodEnum<{
+  TERMS: "TERMS";
+  PRIVACY: "PRIVACY";
+  MARKETING: "MARKETING";
+}>;
+type ConsentKind = z.infer<typeof consentKindSchema>;
+/** 동의 이력의 한 줄이 무엇인가 — 동의했거나 철회했다 */
+declare const consentActionSchema: z.ZodEnum<{
+  WITHDRAWN: "WITHDRAWN";
+  AGREED: "AGREED";
+}>;
+type ConsentAction = z.infer<typeof consentActionSchema>;
+/**
+ * 동의가 일어난 경로. 값이 추가될 수 있어 모르는 값은 그대로 보여 준다.
+ * `SIGNUP` 비밀번호 가입 · `SOCIAL_SIGNUP` 소셜 가입 · `DELEGATED` 셀러 자체 회원 연동 ·
+ * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
+ */
+declare const consentSourceSchema: z.ZodEnum<{
+  SIGNUP: "SIGNUP";
+  SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
+  DELEGATED: "DELEGATED";
+  RECONSENT: "RECONSENT";
+  MEMBER_UPDATE: "MEMBER_UPDATE";
+  SELLER: "SELLER";
+}>;
+type ConsentSource = z.infer<typeof consentSourceSchema>;
+/** 종류별 현재 동의 상태 */
+declare const consentStateSchema: 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>;
+type ConsentState = z.infer<typeof consentStateSchema>;
+/** `GET /storefront/v1/me/consents` 응답 */
+declare const memberConsentsSchema: 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>;
+type MemberConsents = z.infer<typeof memberConsentsSchema>;
+/**
+ * `POST /storefront/v1/me/consents` 본문 — 바꿀 항목만 보낸다.
+ * 필수 동의는 동의(`true`)만 보낼 수 있다. 이미 현재 버전에 동의한 항목은 이력을 더 남기지 않는다.
+ */
+declare const consentUpdateRequestSchema: z.ZodObject<{
+  terms: z.ZodOptional<z.ZodLiteral<true>>;
+  privacy: z.ZodOptional<z.ZodLiteral<true>>;
+  marketing: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ConsentUpdateRequest = z.infer<typeof consentUpdateRequestSchema>;
+//#endregion
 //#region src/schemas/customer-inquiry.d.ts
 declare const customerInquiryCategorySchema: z.ZodEnum<{
   RETURN: "RETURN";
@@ -834,6 +1130,7 @@ declare const memberSchema: z.ZodObject<{
   point: z.ZodNumber;
   marketingAgreed: z.ZodBoolean;
   joinedAt: z.ZodString;
+  reconsentRequired: z.ZodBoolean;
 }, z.core.$strip>;
 type Member = z.infer<typeof memberSchema>;
 declare const updateProfileRequestSchema: z.ZodObject<{
@@ -1055,6 +1352,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
     point: number;
     marketingAgreed: boolean;
     joinedAt: string;
+    reconsentRequired: boolean;
   } | null>;
   auth: {
     /** 비회원 익명 세션 발급 — 응답의 cartToken을 `cartToken` 옵션(X-Cart-Token)으로 쓴다 */
@@ -1340,6 +1638,15 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         deliveryFee: number;
         totalAmount: number;
       };
+      delivery: {
+        baseFee: number;
+        remoteSurcharge: number;
+        remoteArea: "NONE" | "JEJU" | "ISOLATED";
+        remoteAreaLabel: string | null;
+        bundleCount: number;
+        freeByThreshold: boolean;
+        zipCode: string | null;
+      };
       expiresAt: string;
       paymentOptions: (({
         pg: "tosspayments" | "portone";
@@ -1363,6 +1670,31 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       })[];
       testPayment: boolean;
     }>;
+    /**
+     * `POST /checkout/{checkoutId}/delivery-quote` — 배송비 미리보기. 배송지 우편번호로 배송비를 다시 계산한다.
+     *
+     * 주문서를 만들 때는 배송지를 모르므로 제주·도서산간 추가 배송비가 빠져 있다. 구매자가 배송지를 입력하거나
+     * 고칠 때 이 메서드로 금액을 갱신하면 결제 직전에 금액이 바뀌는 일을 피할 수 있다. 주문서를 바꾸지 않는
+     * 읽기 계산이고, **최종 금액은 결제 시작 응답의 `amounts`다.**
+     *
+     * 에러(`ApiError.code`): 404 `CHECKOUT_NOT_FOUND`, 409 `CHECKOUT_EXPIRED`, 409 `ALREADY_PAID`
+     */
+    quoteDelivery: (checkoutId: string, body: DeliveryQuoteRequest) => Promise<{
+      amounts: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+      delivery: {
+        baseFee: number;
+        remoteSurcharge: number;
+        remoteArea: "NONE" | "JEJU" | "ISOLATED";
+        remoteAreaLabel: string | null;
+        bundleCount: number;
+        freeByThreshold: boolean;
+        zipCode: string | null;
+      };
+    }>;
     /**
      * `POST /checkout/{checkoutId}/payment` — 결제 시작. 배송지와 결제 옵션(`paymentOptions` 항목 또는 직접 쓴 옵션)으로
      * 결제 세션·첫 시도를 만들고 결제 서비스 주소(`payUrl`)를 돌려준다. 그 주소를 열어 결제를 진행하는 것은
@@ -1398,6 +1730,20 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       payUrl: string;
       expiresAt: string;
       testPayment: boolean;
+      amounts: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+      delivery: {
+        baseFee: number;
+        remoteSurcharge: number;
+        remoteArea: "NONE" | "JEJU" | "ISOLATED";
+        remoteAreaLabel: string | null;
+        bundleCount: number;
+        freeByThreshold: boolean;
+        zipCode: string | null;
+      };
     }>;
   };
   payments: {
@@ -1449,6 +1795,20 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       payUrl: string;
       expiresAt: string;
       testPayment: boolean;
+      amounts: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+      delivery: {
+        baseFee: number;
+        remoteSurcharge: number;
+        remoteArea: "NONE" | "JEJU" | "ISOLATED";
+        remoteAreaLabel: string | null;
+        bundleCount: number;
+        freeByThreshold: boolean;
+        zipCode: string | null;
+      };
     }>;
   };
   myOrders: {
@@ -1470,6 +1830,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
           thumbnailUrl: string | null;
           optionName: string | null;
           quantity: number;
+          canceledQuantity: number;
+          activeQuantity: number;
           totalPrice: number;
           status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
           claimStatus: string | null;
@@ -1505,6 +1867,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         thumbnailUrl: string | null;
         optionName: string | null;
         quantity: number;
+        canceledQuantity: number;
+        activeQuantity: number;
         totalPrice: number;
         status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         claimStatus: string | null;
@@ -1542,6 +1906,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         thumbnailUrl: string | null;
         optionName: string | null;
         quantity: number;
+        canceledQuantity: number;
+        activeQuantity: number;
         totalPrice: number;
         status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         claimStatus: string | null;
@@ -1575,7 +1941,10 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         status: string;
         location: string;
         occurredAt: string;
+        stage: string | null;
       }[];
+      trackingStage: string | null;
+      trackingCheckedAt: string | null;
     }>;
     decidePurchase: (orderItemId: string) => Promise<void>;
   };
@@ -1585,6 +1954,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       status: "REQUESTED";
       expectedRefundAmount: number | null;
       claimDeliveryFee: number;
+      quantity: number;
+      deliveryFeeRefundAmount: number;
     }>;
     list: (params?: PageParams & {
       status?: ClaimStatus;
@@ -1599,9 +1970,19 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
         orderItemId: string;
         productName: string;
+        quantity: number;
         reason: string;
         expectedRefundAmount: number | null;
+        expectedDeliveryFeeRefundAmount: number | null;
         rejectReason: string | null;
+        returnAddress: {
+          name: string;
+          contactName: string;
+          phone: string;
+          zipCode: string;
+          address1: string;
+          address2: string | null;
+        } | null;
         requestedAt: string;
         completedAt: string | null;
       }[];
@@ -1617,8 +1998,71 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       point: number;
       marketingAgreed: boolean;
       joinedAt: string;
+      reconsentRequired: boolean;
     }>;
     updateMe: (body: UpdateProfileRequest) => Promise<void>;
+    /** 약관·개인정보·마케팅 동의의 현재 상태와 재동의 필요 여부 */
+    consents: () => Promise<{
+      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;
+    }>;
+    /** 재동의·마케팅 동의 변경 — 바꾼 뒤의 상태를 돌려준다 */
+    updateConsents: (body: ConsentUpdateRequest) => Promise<{
+      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;
+    }>;
     listAddresses: () => Promise<{
       addressId: string;
       alias: string;
@@ -1871,6 +2315,8 @@ declare const myOrderItemSchema: z.ZodObject<{
   thumbnailUrl: z.ZodNullable<z.ZodURL>;
   optionName: z.ZodNullable<z.ZodString>;
   quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  activeQuantity: z.ZodNumber;
   totalPrice: z.ZodNumber;
   status: z.ZodEnum<{
     CANCELED: "CANCELED";
@@ -1911,6 +2357,8 @@ declare const myOrderSchema: z.ZodObject<{
     thumbnailUrl: z.ZodNullable<z.ZodURL>;
     optionName: z.ZodNullable<z.ZodString>;
     quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    activeQuantity: z.ZodNumber;
     totalPrice: z.ZodNumber;
     status: z.ZodEnum<{
       CANCELED: "CANCELED";
@@ -1951,6 +2399,11 @@ declare const myOrderSchema: z.ZodObject<{
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
 type MyOrder = z.infer<typeof myOrderSchema>;
+/**
+ * 택배 추적 단계. 응답에서는 문자열로 받는다(값이 추가될 수 있다) — 현재 값은 `ACCEPTED`(접수)·`IN_TRANSIT`(이동 중)·
+ * `OUT_FOR_DELIVERY`(배송 출발)·`DELIVERED`(배송완료)다.
+ */
+declare const trackingStageResponseSchema: z.ZodString;
 declare const deliveryTrackingSchema: z.ZodObject<{
   carrierName: z.ZodString;
   trackingNumber: z.ZodString;
@@ -1964,7 +2417,10 @@ declare const deliveryTrackingSchema: z.ZodObject<{
     status: z.ZodString;
     location: z.ZodString;
     occurredAt: z.ZodString;
+    stage: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   }, z.core.$strip>>;
+  trackingStage: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+  trackingCheckedAt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, z.core.$strip>;
 type DeliveryTracking = z.infer<typeof deliveryTrackingSchema>;
 /** `POST /me/order-items/{orderItemId}/purchase-decision` 응답 */
@@ -1995,4 +2451,4 @@ declare const storefrontStoreSchema: z.ZodObject<{
 }, z.core.$strip>;
 type StorefrontStore = z.infer<typeof storefrontStoreSchema>;
 //#endregion
-export { MemberAddress as $, easyPayProviderSchema as $t, createStorefrontClient as A, claimStatusSchema as An, AvailablePaymentOption as At, ReviewSummary as B, cartSchema as Bn, PaymentMessage as Bt, analyticsBatchSchema as C, productFacetsSchema as Cn, CreateClaimResult as Ct, analyticsServerEventNameSchema as D, OrderItemStatus as Dn, createClaimRequestSchema as Dt, analyticsIdSchema as E, ClaimStatus as En, claimTypeSchema as Et, createStorefrontSession as F, Cart as Fn, KnownPaymentResult as Ft, createReviewResultSchema as G, PgProvider as Gt, UpdateReviewResult as H, analyticsIdsFromCookie as Hn, PaymentOption as Ht, CreateReviewRequest as I, CartItem as In, KnownPaymentStatus as It, reviewSummarySchema as J, StartPaymentRequest as Jt, publicReviewSchema as K, RetryPaymentRequest as Kt, CreateReviewResult as L, UpdateCartItemRequest as Ln, PAYMENT_RESULT_VALUES as Lt, SessionStorage as M, pageInfoSchema as Mn, CreateCheckoutRequest as Mt, StorefrontSession as N, pageSchema as Nn, EasyPayProvider as Nt, StorefrontClient as O, PageInfo as On, createClaimResultSchema as Ot, StorefrontSessionOptions as P, AddCartItemRequest as Pn, GuestInfo as Pt, Member as Q, easyPayProviderResponseSchema as Qt, PublicReview as R, addCartItemRequestSchema as Rn, PAYMENT_STATUS_VALUES as Rt, AnalyticsServerEventName as S, productDetailSchema as Sn, CreateClaimRequest as St, analyticsClientEventSchema as T, productSortSchema as Tn, claimReasonSchema as Tt, WritableReview as U, PaymentStart as Ut, UpdateReviewRequest as V, updateCartItemRequestSchema as Vn, PaymentMethod as Vt, createReviewRequestSchema as W, PaymentStatus as Wt, updateReviewResultSchema as X, checkoutSessionSchema as Xt, updateReviewRequestSchema as Y, availablePaymentOptionSchema as Yt, writableReviewSchema as Z, createCheckoutRequestSchema as Zt, ANALYTICS_VISITOR_HEADER as _, ProductPage as _n, createCustomerInquiryRequestSchema as _t, MyOrderItem as a, paymentOptionListSchema as an, memberSchema as at, AnalyticsClientEventName as b, categoryNodeSchema as bn, ClaimReason as bt, deliveryTrackingSchema as c, paymentStatusSchema as cn, CreateInquiryRequest as ct, orderShippingAddressSchema as d, shippingAddressInputSchema as dn, createInquiryRequestSchema as dt, guestInfoSchema as en, MemberAddressRequest as et, purchaseDecisionResultSchema as f, startPaymentRequestSchema as fn, createInquiryResultSchema as ft, ANALYTICS_VISITOR_COOKIE as g, ProductFacets as gn, CustomerInquiryCategory as gt, ANALYTICS_SESSION_HEADER as h, ProductDetail as hn, CustomerInquiry as ht, MyOrder as i, paymentOptionKey as in, memberAddressSchema as it, STOREFRONT_SESSION_KEYS as j, orderItemStatusSchema as jn, CheckoutSession as jt, StorefrontClientOptions as k, PageParams as kn, myClaimSchema as kt, myOrderItemSchema as l, pgProviderSchema as ln, CreateInquiryResult as lt, ANALYTICS_SESSION_COOKIE as m, ProductCard as mn, CreateCustomerInquiryRequest as mt, storefrontStoreSchema as n, paymentMessageSchema as nn, WishlistAddResult as nt, OrderShippingAddress as o, paymentOptionSchema as on, updateProfileRequestSchema as ot, ANALYTICS_MAX_BATCH_BYTES as p, CategoryNode as pn, publicInquirySchema as pt, reviewPageSchema as q, ShippingAddressInput as qt, DeliveryTracking as r, paymentMethodSchema as rn, memberAddressRequestSchema as rt, PurchaseDecisionResult as s, paymentStartSchema as sn, wishlistAddResultSchema as st, StorefrontStore as t, paymentFailureCategorySchema as tn, UpdateProfileRequest as tt, myOrderSchema as u, retryPaymentRequestSchema as un, PublicInquiry as ut, AnalyticsBatch as v, ProductSearchParams as vn, customerInquiryCategorySchema as vt, analyticsClientEventNameSchema as w, productPageSchema as wn, MyClaim as wt, AnalyticsEventName as x, productCardSchema as xn, ClaimType as xt, AnalyticsClientEvent as y, ProductSort as yn, customerInquirySchema as yt, ReviewPage as z, cartItemSchema as zn, PaymentFailureCategory as zt };
+export { Member as $, productCardSchema as $n, DeliveryQuoteRequest as $t, StorefrontClientOptions as A, guestInfoSchema as An, consentStateSchema as At, ReviewPage as B, remoteAreaSchema as Bn, claimReturnAddressSchema as Bt, AnalyticsServerEventName as C, checkoutDeliverySchema as Cn, ConsentSource as Ct, analyticsIdSchema as D, deliveryQuoteSchema as Dn, consentActionSchema as Dt, analyticsClientEventSchema as E, deliveryQuoteRequestSchema as En, MemberConsents as Et, StorefrontSessionOptions as F, paymentOptionListSchema as Fn, ClaimType as Ft, createReviewRequestSchema as G, CategoryNode as Gn, AvailablePaymentOption as Gt, UpdateReviewRequest as H, retryPaymentRequestSchema as Hn, createClaimRequestSchema as Ht, createStorefrontSession as I, paymentOptionSchema as In, CreateClaimRequest as It, reviewPageSchema as J, ProductFacets as Jn, CashReceiptRequest as Jt, createReviewResultSchema as K, ProductCard as Kn, CASH_RECEIPT_METHODS as Kt, CreateReviewRequest as L, paymentStartSchema as Ln, CreateClaimResult as Lt, STOREFRONT_SESSION_KEYS as M, paymentMessageSchema as Mn, memberConsentsSchema as Mt, SessionStorage as N, paymentMethodSchema as Nn, ClaimReason as Nt, analyticsServerEventNameSchema as O, easyPayProviderResponseSchema as On, consentKindSchema as Ot, StorefrontSession as P, paymentOptionKey as Pn, ClaimReturnAddress as Pt, writableReviewSchema as Q, categoryNodeSchema as Qn, CreateCheckoutRequest as Qt, CreateReviewResult as R, paymentStatusSchema as Rn, MyClaim as Rt, AnalyticsEventName as S, cashReceiptTypeSchema as Sn, ConsentKind as St, analyticsClientEventNameSchema as T, createCheckoutRequestSchema as Tn, ConsentUpdateRequest as Tt, UpdateReviewResult as U, shippingAddressInputSchema as Un, createClaimResultSchema as Ut, ReviewSummary as V, residentNumberLike as Vn, claimTypeSchema as Vt, WritableReview as W, startPaymentRequestSchema as Wn, myClaimSchema as Wt, updateReviewRequestSchema as X, ProductSearchParams as Xn, CheckoutDelivery as Xt, reviewSummarySchema as Y, ProductPage as Yn, CashReceiptType as Yt, updateReviewResultSchema as Z, ProductSort as Zn, CheckoutSession as Zt, ANALYTICS_VISITOR_COOKIE as _, StartPaymentRequest as _n, cartItemSchema as _r, CustomerInquiryCategory as _t, MyOrderItem as a, PAYMENT_RESULT_VALUES as an, OrderItemStatus as ar, memberAddressSchema as at, AnalyticsClientEvent as b, cashReceiptIdentityTypeOf as bn, analyticsIdsFromCookie as br, customerInquirySchema as bt, deliveryTrackingSchema as c, PaymentMessage as cn, claimStatusSchema as cr, wishlistAddResultSchema as ct, orderShippingAddressSchema as d, PaymentStart as dn, pageSchema as dr, PublicInquiry as dt, DeliveryQuoteResult as en, productDetailSchema as er, MemberAddress as et, purchaseDecisionResultSchema as f, PaymentStatus as fn, AddCartItemRequest as fr, createInquiryRequestSchema as ft, ANALYTICS_SESSION_HEADER as g, ShippingAddressInput as gn, addCartItemRequestSchema as gr, CustomerInquiry as gt, ANALYTICS_SESSION_COOKIE as h, RetryPaymentRequest as hn, UpdateCartItemRequest as hr, CreateCustomerInquiryRequest as ht, MyOrder as i, KnownPaymentStatus as in, ClaimStatus as ir, memberAddressRequestSchema as it, createStorefrontClient as j, paymentFailureCategorySchema as jn, consentUpdateRequestSchema as jt, StorefrontClient as k, easyPayProviderSchema as kn, consentSourceSchema as kt, myOrderItemSchema as l, PaymentMethod as ln, orderItemStatusSchema as lr, CreateInquiryRequest as lt, ANALYTICS_MAX_BATCH_BYTES as m, RemoteArea as mn, CartItem as mr, publicInquirySchema as mt, storefrontStoreSchema as n, GuestInfo as nn, productPageSchema as nr, UpdateProfileRequest as nt, OrderShippingAddress as o, PAYMENT_STATUS_VALUES as on, PageInfo as or, memberSchema as ot, trackingStageResponseSchema as p, PgProvider as pn, Cart as pr, createInquiryResultSchema as pt, publicReviewSchema as q, ProductDetail as qn, CashReceiptIdentityType as qt, DeliveryTracking as r, KnownPaymentResult as rn, productSortSchema as rr, WishlistAddResult as rt, PurchaseDecisionResult as s, PaymentFailureCategory as sn, PageParams as sr, updateProfileRequestSchema as st, StorefrontStore as t, EasyPayProvider as tn, productFacetsSchema as tr, MemberAddressRequest as tt, myOrderSchema as u, PaymentOption as un, pageInfoSchema as ur, CreateInquiryResult as ut, ANALYTICS_VISITOR_HEADER as v, availablePaymentOptionSchema as vn, cartSchema as vr, createCustomerInquiryRequestSchema as vt, analyticsBatchSchema as w, checkoutSessionSchema as wn, ConsentState as wt, AnalyticsClientEventName as x, cashReceiptRequestSchema as xn, ConsentAction as xt, AnalyticsBatch as y, cashReceiptAvailable as yn, updateCartItemRequestSchema as yr, customerInquiryCategorySchema as yt, PublicReview as z, pgProviderSchema as zn, claimReasonSchema as zt };