@sayren/storefront-sdk 0.13.0 → 0.14.0

package/dist/{index-BaSx86ts.d.mts → index-dIZNg-hO.d.mts}

@@ -26,6 +26,7 @@ declare const cartItemSchema: z.ZodObject<{
   quantity: z.ZodNumber;
   unitPrice: z.ZodNumber;
   totalPrice: z.ZodNumber;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   purchasable: z.ZodBoolean;
   unpurchasableReason: z.ZodNullable<z.ZodEnum<{
     SOLD_OUT: "SOLD_OUT";
@@ -45,6 +46,7 @@ declare const cartSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     unitPrice: z.ZodNumber;
     totalPrice: z.ZodNumber;
+    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     purchasable: z.ZodBoolean;
     unpurchasableReason: z.ZodNullable<z.ZodEnum<{
       SOLD_OUT: "SOLD_OUT";
@@ -56,6 +58,7 @@ declare const cartSchema: z.ZodObject<{
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     totalAmount: z.ZodNumber;
+    requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
 }, z.core.$strip>;
 type Cart = z.infer<typeof cartSchema>;
@@ -91,6 +94,7 @@ interface PageParams {
   size?: number;
 }
 declare const orderItemStatusSchema: z.ZodEnum<{
+  CANCELED: "CANCELED";
   PAYMENT_WAITING: "PAYMENT_WAITING";
   PAID: "PAID";
   CONFIRMED: "CONFIRMED";
@@ -98,10 +102,10 @@ declare const orderItemStatusSchema: z.ZodEnum<{
   DELIVERING: "DELIVERING";
   DELIVERED: "DELIVERED";
   PURCHASE_DECIDED: "PURCHASE_DECIDED";
-  CANCELED: "CANCELED";
 }>;
 type OrderItemStatus = z.infer<typeof orderItemStatusSchema>;
 declare const claimStatusSchema: z.ZodEnum<{
+  COMPLETED: "COMPLETED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
   COLLECTING: "COLLECTING";
@@ -109,10 +113,21 @@ declare const claimStatusSchema: z.ZodEnum<{
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
   REJECTED: "REJECTED";
-  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 type ClaimStatus = z.infer<typeof claimStatusSchema>;
+/**
+ * 상품 유형 (이슈 #48). 응답에서는 문자열로 받는다(값이 추가될 수 있다). 현재 값은 `SHIPPING`(배송 상품)·
+ * `DOWNLOAD`(파일 다운로드)·`CODE`(코드 발급)·`SERVICE`(이용권·서비스)·`PICKUP`(방문 수령)이다.
+ * 이 필드 이전 서버의 응답에는 없어 `SHIPPING`으로 읽는다. 서버는 항상 싣는다.
+ */
+declare const fulfillmentTypeField: () => z.ZodDefault<z.ZodOptional<z.ZodString>>;
+/**
+ * 배송 필요 여부 (이슈 #48). false면 배송지를 받지 않는다. 이 필드 이전 서버의 응답에는 없어 true로 읽는다.
+ */
+declare const requiresShippingField: (description: string) => z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+/** 배송이 필요한 상품 유형인가 — 배송 상품(`SHIPPING`)만 택배 배송이 있다. 모르는 값은 배송 상품으로 본다 */
+declare function isShippingFulfillment(fulfillmentType: string | null | undefined): boolean;
 //#endregion
 //#region src/schemas/catalog.d.ts
 interface CategoryNode {
@@ -130,6 +145,8 @@ declare const productCardSchema: z.ZodObject<{
   discountedPrice: z.ZodNullable<z.ZodNumber>;
   discountRate: z.ZodNullable<z.ZodNumber>;
   freeShipping: z.ZodBoolean;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   averageRating: z.ZodNumber;
   reviewCount: z.ZodNumber;
   soldOut: z.ZodBoolean;
@@ -143,6 +160,8 @@ declare const productDetailSchema: z.ZodObject<{
   discountedPrice: z.ZodNullable<z.ZodNumber>;
   discountRate: z.ZodNullable<z.ZodNumber>;
   freeShipping: z.ZodBoolean;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   averageRating: z.ZodNumber;
   reviewCount: z.ZodNumber;
   soldOut: z.ZodBoolean;
@@ -227,6 +246,8 @@ declare const productPageSchema: z.ZodObject<{
     discountedPrice: z.ZodNullable<z.ZodNumber>;
     discountRate: z.ZodNullable<z.ZodNumber>;
     freeShipping: z.ZodBoolean;
+    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     averageRating: z.ZodNumber;
     reviewCount: z.ZodNumber;
     soldOut: z.ZodBoolean;
@@ -301,6 +322,8 @@ declare const checkoutSessionSchema: z.ZodObject<{
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     totalAmount: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   }, z.core.$strip>;
   delivery: z.ZodObject<{
     baseFee: z.ZodNumber;
@@ -315,6 +338,11 @@ declare const checkoutSessionSchema: z.ZodObject<{
     freeByThreshold: z.ZodBoolean;
     zipCode: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
+  requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  withdrawal: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    required: z.ZodBoolean;
+    notice: 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<{
@@ -374,6 +402,8 @@ declare const deliveryQuoteSchema: z.ZodObject<{
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     totalAmount: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   }, z.core.$strip>;
   delivery: z.ZodObject<{
     baseFee: z.ZodNumber;
@@ -667,7 +697,7 @@ declare const startPaymentRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"MOBILE">;
   }, z.core.$strip>], "method">;
   returnUrl: z.ZodURL;
-  shippingAddress: z.ZodObject<{
+  shippingAddress: z.ZodOptional<z.ZodObject<{
     addressId: z.ZodOptional<z.ZodString>;
     receiverName: z.ZodString;
     phone: z.ZodString;
@@ -676,13 +706,14 @@ declare const startPaymentRequestSchema: z.ZodObject<{
     address2: z.ZodOptional<z.ZodString>;
     deliveryMemo: z.ZodOptional<z.ZodString>;
     entranceCode: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>;
+  }, z.core.$strip>>;
   guest: z.ZodOptional<z.ZodObject<{
     name: z.ZodString;
     phone: z.ZodString;
     email: z.ZodEmail;
     orderPassword: z.ZodString;
   }, z.core.$strip>>;
+  withdrawalAgreement: z.ZodOptional<z.ZodBoolean>;
   cashReceipt: z.ZodOptional<z.ZodObject<{
     type: z.ZodEnum<{
       INCOME_DEDUCTION: "INCOME_DEDUCTION";
@@ -690,6 +721,11 @@ declare const startPaymentRequestSchema: z.ZodObject<{
     }>;
     identityNumber: z.ZodString;
   }, z.core.$strip>>;
+  coupons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    issueId: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 type StartPaymentRequest = z.infer<typeof startPaymentRequestSchema>;
 /**
@@ -792,6 +828,8 @@ declare const paymentStartSchema: z.ZodObject<{
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     totalAmount: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   }, z.core.$strip>;
   delivery: z.ZodObject<{
     baseFee: z.ZodNumber;
@@ -894,6 +932,8 @@ declare const createClaimResultSchema: z.ZodObject<{
   claimDeliveryFee: z.ZodNumber;
   quantity: z.ZodNumber;
   deliveryFeeRefundAmount: z.ZodNumber;
+  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 type CreateClaimResult = z.infer<typeof createClaimResultSchema>;
 /**
@@ -920,6 +960,7 @@ declare const myClaimSchema: z.ZodObject<{
     EXCHANGE: "EXCHANGE";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -927,7 +968,6 @@ declare const myClaimSchema: z.ZodObject<{
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
     REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderItemId: z.ZodString;
@@ -1051,6 +1091,152 @@ declare const consentUpdateRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ConsentUpdateRequest = z.infer<typeof consentUpdateRequestSchema>;
 //#endregion
+//#region src/schemas/coupon.d.ts
+/**
+ * 스토어프론트 쿠폰 계약 (이슈 #47).
+ *
+ * 구매자는 주문서에서 쿠폰을 고르거나 코드를 입력한다. 금액 미리보기(`POST /checkout/{checkoutId}/pricing`)는
+ * 주문서를 바꾸지 않는 읽기 계산이고, **확정은 결제 시작(`coupons` 필드)만 한다** — 결제 시작이 쿠폰을 예약하고 그 금액으로
+ * 결제 금액을 정한다. 결제가 실패하거나 만료되면 예약이 풀려 같은 쿠폰을 다시 쓸 수 있다.
+ *
+ * 한 주문에 주문 쿠폰 1장, 주문상품 한 줄에 상품 쿠폰 1장까지다. 같은 쿠폰을 두 번 쓸 수 없다.
+ */
+/** 적용할 쿠폰 한 장 — 발급 쿠폰 id 또는 코드 중 하나 */
+declare const couponApplicationSchema: z.ZodObject<{
+  issueId: z.ZodOptional<z.ZodString>;
+  code: z.ZodOptional<z.ZodString>;
+  optionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CouponApplication = z.infer<typeof couponApplicationSchema>;
+/** 한 번에 적용할 수 있는 쿠폰 수 */
+declare const MAX_COUPONS_PER_CHECKOUT = 5;
+declare const couponApplicationListSchema: z.ZodArray<z.ZodObject<{
+  issueId: z.ZodOptional<z.ZodString>;
+  code: z.ZodOptional<z.ZodString>;
+  optionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/** 쿠폰 혜택 — 응답 표시용. 값이 늘 수 있어 방식은 문자열이다 */
+declare const couponBenefitViewSchema: z.ZodObject<{
+  type: z.ZodString;
+  value: z.ZodNumber;
+  maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/** 쿠폰 한 장의 적용 결과 */
+declare const couponResultSchema: z.ZodObject<{
+  couponId: z.ZodString;
+  issueId: z.ZodNullable<z.ZodString>;
+  code: z.ZodNullable<z.ZodString>;
+  name: z.ZodString;
+  kind: z.ZodString;
+  benefit: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  applied: z.ZodBoolean;
+  discountAmount: z.ZodNumber;
+  rejectReason: z.ZodNullable<z.ZodString>;
+  optionId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type CouponResult = z.infer<typeof couponResultSchema>;
+/** 쿠폰을 반영한 금액 — 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount */
+declare const pricingAmountsSchema: z.ZodObject<{
+  productAmount: z.ZodNumber;
+  deliveryFee: z.ZodNumber;
+  couponDiscountAmount: z.ZodNumber;
+  deliveryDiscountAmount: z.ZodNumber;
+  totalAmount: z.ZodNumber;
+}, z.core.$strip>;
+/** `POST /checkout/{checkoutId}/pricing` 요청 */
+declare const checkoutPricingRequestSchema: z.ZodObject<{
+  zipCode: z.ZodOptional<z.ZodString>;
+  coupons: z.ZodArray<z.ZodObject<{
+    issueId: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type CheckoutPricingRequest = z.infer<typeof checkoutPricingRequestSchema>;
+/** 결제 금액의 하한 — 쿠폰 적용 뒤 결제 금액이 이보다 작으면 결제를 시작할 수 없다 */
+declare const MIN_PAYMENT_AMOUNT = 100;
+declare const checkoutPricingSchema: z.ZodObject<{
+  amounts: z.ZodObject<{
+    productAmount: z.ZodNumber;
+    deliveryFee: z.ZodNumber;
+    couponDiscountAmount: z.ZodNumber;
+    deliveryDiscountAmount: z.ZodNumber;
+    totalAmount: z.ZodNumber;
+  }, z.core.$strip>;
+  coupons: z.ZodArray<z.ZodObject<{
+    couponId: z.ZodString;
+    issueId: z.ZodNullable<z.ZodString>;
+    code: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    kind: z.ZodString;
+    benefit: z.ZodObject<{
+      type: z.ZodString;
+      value: z.ZodNumber;
+      maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    applied: z.ZodBoolean;
+    discountAmount: z.ZodNumber;
+    rejectReason: z.ZodNullable<z.ZodString>;
+    optionId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  items: z.ZodArray<z.ZodObject<{
+    optionId: z.ZodNullable<z.ZodString>;
+    couponDiscountAmount: z.ZodNumber;
+  }, z.core.$strip>>;
+  payable: z.ZodBoolean;
+}, z.core.$strip>;
+type CheckoutPricing = z.infer<typeof checkoutPricingSchema>;
+/** `GET /checkout/{checkoutId}/coupons` 항목 — 이 주문서에 쓸 수 있는 내 쿠폰 */
+declare const applicableCouponSchema: z.ZodObject<{
+  issueId: z.ZodString;
+  couponId: z.ZodString;
+  name: z.ZodString;
+  description: z.ZodNullable<z.ZodString>;
+  kind: z.ZodString;
+  benefit: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  minOrderAmount: z.ZodNumber;
+  validUntil: z.ZodNullable<z.ZodString>;
+  applicable: z.ZodBoolean;
+  expectedDiscountAmount: z.ZodNumber;
+  rejectReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ApplicableCoupon = z.infer<typeof applicableCouponSchema>;
+/** `GET /me/coupons` 항목 */
+declare const myCouponSchema: z.ZodObject<{
+  issueId: z.ZodString;
+  couponId: z.ZodString;
+  name: z.ZodString;
+  description: z.ZodNullable<z.ZodString>;
+  kind: z.ZodString;
+  benefit: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodNumber;
+    maxDiscountAmount: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  minOrderAmount: z.ZodNumber;
+  status: z.ZodString;
+  validFrom: z.ZodString;
+  validUntil: z.ZodNullable<z.ZodString>;
+  usedOrderId: z.ZodNullable<z.ZodString>;
+  issuedAt: z.ZodString;
+}, z.core.$strip>;
+type MyCoupon = z.infer<typeof myCouponSchema>;
+declare const myCouponListQuerySchema: z.ZodObject<{
+  status: z.ZodOptional<z.ZodEnum<{
+    expired: "expired";
+    available: "available";
+    used: "used";
+  }>>;
+}, z.core.$strip>;
+//#endregion
 //#region src/schemas/customer-inquiry.d.ts
 declare const customerInquiryCategorySchema: z.ZodEnum<{
   RETURN: "RETURN";
@@ -1167,6 +1353,232 @@ declare const wishlistAddResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 type WishlistAddResult = z.infer<typeof wishlistAddResultSchema>;
 //#endregion
+//#region src/schemas/order.d.ts
+declare const myOrderItemSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  productId: z.ZodString;
+  productName: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodURL>;
+  optionName: z.ZodNullable<z.ZodString>;
+  quantity: z.ZodNumber;
+  canceledQuantity: z.ZodNumber;
+  activeQuantity: z.ZodNumber;
+  totalPrice: z.ZodNumber;
+  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  status: z.ZodEnum<{
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    PAID: "PAID";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>;
+  fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    status: z.ZodString;
+    fulfilledAt: z.ZodString;
+    note: z.ZodNullable<z.ZodString>;
+    codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      codeId: z.ZodString;
+      hint: z.ZodString;
+      revealedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>>;
+    download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      count: z.ZodNumber;
+      limit: z.ZodNumber;
+      expiresAt: z.ZodNullable<z.ZodString>;
+      files: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        fileName: z.ZodString;
+        sizeBytes: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>>;
+  }, z.core.$strip>>>>;
+  pickupLocation: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    name: z.ZodString;
+    zipCode: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodNullable<z.ZodString>;
+    phone: z.ZodString;
+  }, z.core.$strip>>>>;
+  claimStatus: z.ZodNullable<z.ZodString>;
+  reviewWritten: z.ZodBoolean;
+  autoDecisionDate: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type MyOrderItem = z.infer<typeof myOrderItemSchema>;
+/**
+ * 주문 응답의 배송지 — 결제 요청 시 저장된 스냅샷. 요청 스키마(`shippingAddressInputSchema`)와 분리한 응답 스키마라
+ * 형식 검증(regex·길이)을 하지 않는다. 입력하지 않은 선택 필드는 null로 오거나 빠질 수 있다.
+ */
+declare const orderShippingAddressSchema: z.ZodObject<{
+  receiverName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type OrderShippingAddress = z.infer<typeof orderShippingAddressSchema>;
+declare const myOrderSchema: z.ZodObject<{
+  orderId: z.ZodString;
+  orderedAt: z.ZodString;
+  items: z.ZodArray<z.ZodObject<{
+    orderItemId: z.ZodString;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    thumbnailUrl: z.ZodNullable<z.ZodURL>;
+    optionName: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    canceledQuantity: z.ZodNumber;
+    activeQuantity: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    status: z.ZodEnum<{
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      PAID: "PAID";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>;
+    fulfillmentType: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    withdrawalRestricted: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    fulfillment: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      status: z.ZodString;
+      fulfilledAt: z.ZodString;
+      note: z.ZodNullable<z.ZodString>;
+      codes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        codeId: z.ZodString;
+        hint: z.ZodString;
+        revealedAt: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>>;
+      download: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        count: z.ZodNumber;
+        limit: z.ZodNumber;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        files: z.ZodArray<z.ZodObject<{
+          assetId: z.ZodString;
+          fileName: z.ZodString;
+          sizeBytes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>>>;
+    }, z.core.$strip>>>>;
+    pickupLocation: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      name: z.ZodString;
+      zipCode: z.ZodString;
+      address1: z.ZodString;
+      address2: z.ZodNullable<z.ZodString>;
+      phone: z.ZodString;
+    }, z.core.$strip>>>>;
+    claimStatus: z.ZodNullable<z.ZodString>;
+    reviewWritten: z.ZodBoolean;
+    autoDecisionDate: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  requiresShipping: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  shippingAddress: z.ZodObject<{
+    receiverName: z.ZodString;
+    phone: z.ZodString;
+    zipCode: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>;
+  payment: z.ZodObject<{
+    method: z.ZodEnum<{
+      CARD: "CARD";
+      EASY_PAY: "EASY_PAY";
+      BANK_TRANSFER: "BANK_TRANSFER";
+      VIRTUAL_ACCOUNT: "VIRTUAL_ACCOUNT";
+      MOBILE: "MOBILE";
+    }>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    discounts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      couponId: z.ZodString;
+      name: z.ZodString;
+      kind: z.ZodString;
+      discountAmount: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    totalAmount: z.ZodNumber;
+    paidAt: z.ZodNullable<z.ZodString>;
+    receiptUrl: z.ZodNullable<z.ZodURL>;
+  }, z.core.$strip>;
+  withdrawalAgreedAt: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+  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;
+  trackingUrl: z.ZodURL;
+  status: z.ZodEnum<{
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+  }>;
+  trackingEvents: z.ZodArray<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` 응답 */
+declare const purchaseDecisionResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  status: z.ZodLiteral<"PURCHASE_DECIDED">;
+  decidedAt: z.ZodString;
+}, z.core.$strip>;
+type PurchaseDecisionResult = z.infer<typeof purchaseDecisionResultSchema>;
+/**
+ * 코드 열람 응답 (이슈 #48) — `POST /storefront/v1/me/order-items/{orderItemId}/fulfillment/reveal`(회원)·
+ * `POST /storefront/v1/guest/orders/{orderId}/order-items/{orderItemId}/fulfillment/reveal`(비회원).
+ * 평문 코드는 이 응답에만 있다. 화면에 보인 뒤 저장하지 않는다(응답은 `Cache-Control: no-store`).
+ * 첫 열람 시각은 청약철회 판단의 근거(제공 개시)로 남는다.
+ */
+declare const fulfillmentRevealSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  codes: z.ZodArray<z.ZodObject<{
+    codeId: z.ZodString;
+    code: z.ZodString;
+    revealedAt: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type FulfillmentReveal = z.infer<typeof fulfillmentRevealSchema>;
+/**
+ * 다운로드 요청 (이슈 #48) — `POST /storefront/v1/me/order-items/{orderItemId}/downloads`(회원)·
+ * `POST /storefront/v1/guest/orders/{orderId}/order-items/{orderItemId}/downloads`(비회원, 연락처·비밀번호를 함께 보낸다).
+ * 파일이 하나면 `assetId`를 생략할 수 있다.
+ */
+declare const downloadRequestSchema: z.ZodObject<{
+  assetId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DownloadRequest = z.infer<typeof downloadRequestSchema>;
+/** 다운로드 응답 — 수명 300초의 서명 주소. 받을 때마다 횟수가 하나 준다 */
+declare const downloadLinkSchema: z.ZodObject<{
+  url: z.ZodURL;
+  expiresAt: z.ZodString;
+  fileName: z.ZodString;
+  remaining: z.ZodNumber;
+}, z.core.$strip>;
+type DownloadLink = z.infer<typeof downloadLinkSchema>;
+//#endregion
 //#region src/schemas/review.d.ts
 declare const publicReviewSchema: z.ZodObject<{
   reviewId: z.ZodString;
@@ -1450,6 +1862,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         discountedPrice: number | null;
         discountRate: number | null;
         freeShipping: boolean;
+        fulfillmentType: string;
+        requiresShipping: boolean;
         averageRating: number;
         reviewCount: number;
         soldOut: boolean;
@@ -1474,6 +1888,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       discountedPrice: number | null;
       discountRate: number | null;
       freeShipping: boolean;
+      fulfillmentType: string;
+      requiresShipping: boolean;
       averageRating: number;
       reviewCount: number;
       soldOut: boolean;
@@ -1570,6 +1986,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         quantity: number;
         unitPrice: number;
         totalPrice: number;
+        fulfillmentType: string;
         purchasable: boolean;
         unpurchasableReason: "SOLD_OUT" | "SUSPENDED" | "CLOSED" | null;
       }[];
@@ -1577,6 +1994,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        requiresShipping: boolean;
       };
     }>;
     addItem: (body: AddCartItemRequest) => Promise<{
@@ -1590,6 +2008,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         quantity: number;
         unitPrice: number;
         totalPrice: number;
+        fulfillmentType: string;
         purchasable: boolean;
         unpurchasableReason: "SOLD_OUT" | "SUSPENDED" | "CLOSED" | null;
       }[];
@@ -1597,6 +2016,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        requiresShipping: boolean;
       };
     }>;
     updateItem: (cartItemId: string, body: UpdateCartItemRequest) => Promise<{
@@ -1610,6 +2030,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         quantity: number;
         unitPrice: number;
         totalPrice: number;
+        fulfillmentType: string;
         purchasable: boolean;
         unpurchasableReason: "SOLD_OUT" | "SUSPENDED" | "CLOSED" | null;
       }[];
@@ -1617,6 +2038,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        requiresShipping: boolean;
       };
     }>;
     removeItem: (cartItemId: string) => Promise<void>;
@@ -1637,6 +2059,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
       };
       delivery: {
         baseFee: number;
@@ -1647,6 +2071,11 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         freeByThreshold: boolean;
         zipCode: string | null;
       };
+      requiresShipping: boolean;
+      withdrawal: {
+        required: boolean;
+        notice: string | null;
+      };
       expiresAt: string;
       paymentOptions: (({
         pg: "tosspayments" | "portone";
@@ -1684,6 +2113,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
       };
       delivery: {
         baseFee: number;
@@ -1734,6 +2165,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
       };
       delivery: {
         baseFee: number;
@@ -1745,6 +2178,60 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         zipCode: string | null;
       };
     }>;
+    /**
+     * `POST /checkout/{checkoutId}/pricing` — 쿠폰 금액 미리보기(이슈 #47). 주문서를 바꾸지 않고 쿠폰을 예약하지 않는다.
+     * 확정은 결제 시작의 `coupons`다. 코드 입력은 구매자당 분당 10회까지다(429 `TOO_MANY_REQUESTS`).
+     *
+     * 에러: 404 `COUPON_NOT_FOUND`(없는 코드·남의 쿠폰) · 409 `COUPONS_UNAVAILABLE`(지금 쿠폰을 쓸 수 없음)
+     */
+    pricing: (checkoutId: string, body: CheckoutPricingRequest) => Promise<{
+      amounts: {
+        productAmount: number;
+        deliveryFee: number;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
+        totalAmount: number;
+      };
+      coupons: {
+        couponId: string;
+        issueId: string | null;
+        code: string | null;
+        name: string;
+        kind: string;
+        benefit: {
+          type: string;
+          value: number;
+          maxDiscountAmount: number | null;
+        };
+        applied: boolean;
+        discountAmount: number;
+        rejectReason: string | null;
+        optionId: string | null;
+      }[];
+      items: {
+        optionId: string | null;
+        couponDiscountAmount: number;
+      }[];
+      payable: boolean;
+    }>;
+    /** `GET /checkout/{checkoutId}/coupons` — 이 주문서에 쓸 수 있는 내 쿠폰과 예상 할인(회원 전용) */
+    applicableCoupons: (checkoutId: string) => Promise<{
+      issueId: string;
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: string;
+      benefit: {
+        type: string;
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      minOrderAmount: number;
+      validUntil: string | null;
+      applicable: boolean;
+      expectedDiscountAmount: number;
+      rejectReason: string | null;
+    }[]>;
   };
   payments: {
     /**
@@ -1799,6 +2286,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         productAmount: number;
         deliveryFee: number;
         totalAmount: number;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
       };
       delivery: {
         baseFee: number;
@@ -1833,11 +2322,42 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
           canceledQuantity: number;
           activeQuantity: number;
           totalPrice: number;
-          status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+          couponDiscountAmount: number;
+          status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+          fulfillmentType: string;
+          withdrawalRestricted: boolean;
+          fulfillment: {
+            status: string;
+            fulfilledAt: string;
+            note: string | null;
+            codes: {
+              codeId: string;
+              hint: string;
+              revealedAt: string | null;
+            }[];
+            download: {
+              count: number;
+              limit: number;
+              expiresAt: string | null;
+              files: {
+                assetId: string;
+                fileName: string;
+                sizeBytes: number | null;
+              }[];
+            } | null;
+          } | null;
+          pickupLocation: {
+            name: string;
+            zipCode: string;
+            address1: string;
+            address2: string | null;
+            phone: string;
+          } | null;
           claimStatus: string | null;
           reviewWritten: boolean;
           autoDecisionDate: string | null;
         }[];
+        requiresShipping: boolean;
         shippingAddress: {
           receiverName: string;
           phone: string;
@@ -1850,10 +2370,19 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         payment: {
           method: "CARD" | "EASY_PAY" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE";
           easyPayProvider: string | null;
+          couponDiscountAmount: number;
+          deliveryDiscountAmount: number;
+          discounts: {
+            couponId: string;
+            name: string;
+            kind: string;
+            discountAmount: number;
+          }[];
           totalAmount: number;
           paidAt: string | null;
           receiptUrl: string | null;
         };
+        withdrawalAgreedAt: string | null;
         testPayment: boolean;
       }[];
     }>;
@@ -1870,11 +2399,42 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         canceledQuantity: number;
         activeQuantity: number;
         totalPrice: number;
-        status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+        couponDiscountAmount: number;
+        status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+        fulfillmentType: string;
+        withdrawalRestricted: boolean;
+        fulfillment: {
+          status: string;
+          fulfilledAt: string;
+          note: string | null;
+          codes: {
+            codeId: string;
+            hint: string;
+            revealedAt: string | null;
+          }[];
+          download: {
+            count: number;
+            limit: number;
+            expiresAt: string | null;
+            files: {
+              assetId: string;
+              fileName: string;
+              sizeBytes: number | null;
+            }[];
+          } | null;
+        } | null;
+        pickupLocation: {
+          name: string;
+          zipCode: string;
+          address1: string;
+          address2: string | null;
+          phone: string;
+        } | null;
         claimStatus: string | null;
         reviewWritten: boolean;
         autoDecisionDate: string | null;
       }[];
+      requiresShipping: boolean;
       shippingAddress: {
         receiverName: string;
         phone: string;
@@ -1887,10 +2447,19 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       payment: {
         method: "CARD" | "EASY_PAY" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE";
         easyPayProvider: string | null;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
+        discounts: {
+          couponId: string;
+          name: string;
+          kind: string;
+          discountAmount: number;
+        }[];
         totalAmount: number;
         paidAt: string | null;
         receiptUrl: string | null;
       };
+      withdrawalAgreedAt: string | null;
       testPayment: boolean;
     }>;
     /**
@@ -1918,11 +2487,42 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         canceledQuantity: number;
         activeQuantity: number;
         totalPrice: number;
-        status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+        couponDiscountAmount: number;
+        status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+        fulfillmentType: string;
+        withdrawalRestricted: boolean;
+        fulfillment: {
+          status: string;
+          fulfilledAt: string;
+          note: string | null;
+          codes: {
+            codeId: string;
+            hint: string;
+            revealedAt: string | null;
+          }[];
+          download: {
+            count: number;
+            limit: number;
+            expiresAt: string | null;
+            files: {
+              assetId: string;
+              fileName: string;
+              sizeBytes: number | null;
+            }[];
+          } | null;
+        } | null;
+        pickupLocation: {
+          name: string;
+          zipCode: string;
+          address1: string;
+          address2: string | null;
+          phone: string;
+        } | null;
         claimStatus: string | null;
         reviewWritten: boolean;
         autoDecisionDate: string | null;
       }[];
+      requiresShipping: boolean;
       shippingAddress: {
         receiverName: string;
         phone: string;
@@ -1935,10 +2535,19 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       payment: {
         method: "CARD" | "EASY_PAY" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE";
         easyPayProvider: string | null;
+        couponDiscountAmount: number;
+        deliveryDiscountAmount: number;
+        discounts: {
+          couponId: string;
+          name: string;
+          kind: string;
+          discountAmount: number;
+        }[];
         totalAmount: number;
         paidAt: string | null;
         receiptUrl: string | null;
       };
+      withdrawalAgreedAt: string | null;
       testPayment: boolean;
     }>;
     getDelivery: (orderItemId: string) => Promise<{
@@ -1955,6 +2564,58 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       trackingStage: string | null;
       trackingCheckedAt: string | null;
     }>;
+    /**
+     * 코드 열람 (이슈 #48) — 코드 발급 상품의 평문 코드. 처음 열람한 시각이 제공 개시 증거로 남는다.
+     *
+     * 에러: 404 `ORDER_ITEM_NOT_FOUND`(없거나 남의 주문상품) · 404 `FULFILLMENT_NOT_FOUND`(제공 전·회수됨·코드 상품 아님) ·
+     * 429 `TOO_MANY_REQUESTS`
+     */
+    revealCode: (orderItemId: string) => Promise<{
+      orderItemId: string;
+      codes: {
+        codeId: string;
+        code: string;
+        revealedAt: string;
+      }[];
+    }>;
+    /**
+     * 파일 다운로드 (이슈 #48) — 수명 300초의 서명 주소를 받는다. 받을 때마다 남은 횟수가 준다.
+     *
+     * 에러: 404 `FULFILLMENT_NOT_FOUND`(제공 전·회수됨·파일 상품 아님) · 409 `DOWNLOAD_LIMIT_REACHED`(횟수 소진) ·
+     * 409 `DOWNLOAD_EXPIRED`(기한 지남) · 400 `ASSET_REQUIRED`(파일이 여러 개인데 `assetId` 없음)
+     */
+    createDownload: (orderItemId: string, body?: DownloadRequest) => Promise<{
+      url: string;
+      expiresAt: string;
+      fileName: string;
+      remaining: number;
+    }>;
+    /** 비회원 다운로드 — 비회원 주문 조회와 같은 연락처·주문 조회 비밀번호로 확인한다 */
+    createGuestDownload: (orderId: string, orderItemId: string, body: {
+      phone: string;
+      orderPassword: string;
+      assetId?: string;
+    }) => Promise<{
+      url: string;
+      expiresAt: string;
+      fileName: string;
+      remaining: number;
+    }>;
+    /**
+     * 비회원 코드 열람 — 비회원 주문 조회와 같은 연락처·주문 조회 비밀번호로 확인하고 같은 시도 한도를 쓴다.
+     * 틀리면 구분 없이 404 `ORDER_NOT_FOUND`다.
+     */
+    revealGuestCode: (orderId: string, orderItemId: string, body: {
+      phone: string;
+      orderPassword: string;
+    }) => Promise<{
+      orderItemId: string;
+      codes: {
+        codeId: string;
+        code: string;
+        revealedAt: string;
+      }[];
+    }>;
     decidePurchase: (orderItemId: string) => Promise<void>;
   };
   myClaims: {
@@ -1965,6 +2626,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       claimDeliveryFee: number;
       quantity: number;
       deliveryFeeRefundAmount: number;
+      couponChargeAmount: number;
+      couponChargeRefundAmount: number;
     }>;
     list: (params?: PageParams & {
       status?: ClaimStatus;
@@ -1976,7 +2639,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       contents: {
         claimId: string;
         type: "CANCEL" | "RETURN" | "EXCHANGE";
-        status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
+        status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
         orderItemId: string;
         productName: string;
         quantity: number;
@@ -2098,6 +2761,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         discountedPrice: number | null;
         discountRate: number | null;
         freeShipping: boolean;
+        fulfillmentType: string;
+        requiresShipping: boolean;
         averageRating: number;
         reviewCount: number;
         soldOut: boolean;
@@ -2145,6 +2810,27 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
     }>;
   };
   me: {
+    /** `GET /me/coupons` — 내 쿠폰(이슈 #47). `status`로 사용 가능·사용함·기간 지남을 거른다 */
+    coupons: (params?: {
+      status?: "available" | "used" | "expired";
+    }) => Promise<{
+      issueId: string;
+      couponId: string;
+      name: string;
+      description: string | null;
+      kind: string;
+      benefit: {
+        type: string;
+        value: number;
+        maxDiscountAmount: number | null;
+      };
+      minOrderAmount: number;
+      status: string;
+      validFrom: string;
+      validUntil: string | null;
+      usedOrderId: string | null;
+      issuedAt: string;
+    }[]>;
     customerInquiries: {
       create: (body: CreateCustomerInquiryRequest) => Promise<{
         inquiryId: string;
@@ -2316,130 +3002,6 @@ type AnalyticsBatch = z.infer<typeof analyticsBatchSchema>;
 /** 배치 본문 상한(바이트) — 서버가 넘는 요청을 거부한다 */
 declare const ANALYTICS_MAX_BATCH_BYTES: number;
 //#endregion
-//#region src/schemas/order.d.ts
-declare const myOrderItemSchema: z.ZodObject<{
-  orderItemId: z.ZodString;
-  productId: z.ZodString;
-  productName: z.ZodString;
-  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<{
-    PAYMENT_WAITING: "PAYMENT_WAITING";
-    PAID: "PAID";
-    CONFIRMED: "CONFIRMED";
-    DISPATCHED: "DISPATCHED";
-    DELIVERING: "DELIVERING";
-    DELIVERED: "DELIVERED";
-    PURCHASE_DECIDED: "PURCHASE_DECIDED";
-    CANCELED: "CANCELED";
-  }>;
-  claimStatus: z.ZodNullable<z.ZodString>;
-  reviewWritten: z.ZodBoolean;
-  autoDecisionDate: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-type MyOrderItem = z.infer<typeof myOrderItemSchema>;
-/**
- * 주문 응답의 배송지 — 결제 요청 시 저장된 스냅샷. 요청 스키마(`shippingAddressInputSchema`)와 분리한 응답 스키마라
- * 형식 검증(regex·길이)을 하지 않는다. 입력하지 않은 선택 필드는 null로 오거나 빠질 수 있다.
- */
-declare const orderShippingAddressSchema: z.ZodObject<{
-  receiverName: z.ZodString;
-  phone: z.ZodString;
-  zipCode: z.ZodString;
-  address1: z.ZodString;
-  address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-type OrderShippingAddress = z.infer<typeof orderShippingAddressSchema>;
-declare const myOrderSchema: z.ZodObject<{
-  orderId: z.ZodString;
-  orderedAt: z.ZodString;
-  items: z.ZodArray<z.ZodObject<{
-    orderItemId: z.ZodString;
-    productId: z.ZodString;
-    productName: z.ZodString;
-    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<{
-      PAYMENT_WAITING: "PAYMENT_WAITING";
-      PAID: "PAID";
-      CONFIRMED: "CONFIRMED";
-      DISPATCHED: "DISPATCHED";
-      DELIVERING: "DELIVERING";
-      DELIVERED: "DELIVERED";
-      PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
-    }>;
-    claimStatus: z.ZodNullable<z.ZodString>;
-    reviewWritten: z.ZodBoolean;
-    autoDecisionDate: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>>;
-  shippingAddress: z.ZodObject<{
-    receiverName: z.ZodString;
-    phone: z.ZodString;
-    zipCode: z.ZodString;
-    address1: z.ZodString;
-    address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  }, z.core.$strip>;
-  payment: z.ZodObject<{
-    method: z.ZodEnum<{
-      CARD: "CARD";
-      EASY_PAY: "EASY_PAY";
-      BANK_TRANSFER: "BANK_TRANSFER";
-      VIRTUAL_ACCOUNT: "VIRTUAL_ACCOUNT";
-      MOBILE: "MOBILE";
-    }>;
-    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-    totalAmount: z.ZodNumber;
-    paidAt: z.ZodNullable<z.ZodString>;
-    receiptUrl: z.ZodNullable<z.ZodURL>;
-  }, z.core.$strip>;
-  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;
-  trackingUrl: z.ZodURL;
-  status: z.ZodEnum<{
-    DISPATCHED: "DISPATCHED";
-    DELIVERING: "DELIVERING";
-    DELIVERED: "DELIVERED";
-  }>;
-  trackingEvents: z.ZodArray<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` 응답 */
-declare const purchaseDecisionResultSchema: z.ZodObject<{
-  orderItemId: z.ZodString;
-  status: z.ZodLiteral<"PURCHASE_DECIDED">;
-  decidedAt: z.ZodString;
-}, z.core.$strip>;
-type PurchaseDecisionResult = z.infer<typeof purchaseDecisionResultSchema>;
-//#endregion
 //#region src/schemas/store.d.ts
 /**
  * 스토어 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
@@ -2460,4 +3022,4 @@ declare const storefrontStoreSchema: z.ZodObject<{
 }, z.core.$strip>;
 type StorefrontStore = z.infer<typeof storefrontStoreSchema>;
 //#endregion
-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 };
+export { fulfillmentRevealSchema as $, easyPayProviderSchema as $n, consentSourceSchema as $t, ReviewSummary as A, PAYMENT_STATUS_VALUES as An, PageInfo as Ar, CouponApplication as At, updateReviewResultSchema as B, ShippingAddressInput as Bn, Cart as Br, couponBenefitViewSchema as Bt, StorefrontSession as C, DeliveryQuoteRequest as Cn, productCardSchema as Cr, CustomerInquiryCategory as Ct, CreateReviewResult as D, KnownPaymentResult as Dn, productSortSchema as Dr, ApplicableCoupon as Dt, CreateReviewRequest as E, GuestInfo as En, productPageSchema as Er, customerInquirySchema as Et, createReviewResultSchema as F, PaymentStart as Fn, orderItemStatusSchema as Fr, applicableCouponSchema as Ft, FulfillmentReveal as G, cashReceiptRequestSchema as Gn, cartSchema as Gr, ConsentAction as Gt, DeliveryTracking as H, availablePaymentOptionSchema as Hn, UpdateCartItemRequest as Hr, myCouponListQuerySchema as Ht, publicReviewSchema as I, PaymentStatus as In, pageInfoSchema as Ir, checkoutPricingRequestSchema as It, OrderShippingAddress as J, checkoutSessionSchema as Jn, ConsentState as Jt, MyOrder as K, cashReceiptTypeSchema as Kn, updateCartItemRequestSchema as Kr, ConsentKind as Kt, reviewPageSchema as L, PgProvider as Ln, pageSchema as Lr, checkoutPricingSchema as Lt, UpdateReviewResult as M, PaymentMessage as Mn, claimStatusSchema as Mr, MAX_COUPONS_PER_CHECKOUT as Mt, WritableReview as N, PaymentMethod as Nn, fulfillmentTypeField as Nr, MIN_PAYMENT_AMOUNT as Nt, PublicReview as O, KnownPaymentStatus as On, ClaimStatus as Or, CheckoutPricing as Ot, createReviewRequestSchema as P, PaymentOption as Pn, isShippingFulfillment as Pr, MyCoupon as Pt, downloadRequestSchema as Q, easyPayProviderResponseSchema as Qn, consentKindSchema as Qt, reviewSummarySchema as R, RemoteArea as Rn, requiresShippingField as Rr, couponApplicationListSchema as Rt, SessionStorage as S, CreateCheckoutRequest as Sn, categoryNodeSchema as Sr, CustomerInquiry as St, createStorefrontSession as T, EasyPayProvider as Tn, productFacetsSchema as Tr, customerInquiryCategorySchema as Tt, DownloadLink as U, cashReceiptAvailable as Un, addCartItemRequestSchema as Ur, myCouponSchema as Ut, writableReviewSchema as V, StartPaymentRequest as Vn, CartItem as Vr, couponResultSchema as Vt, DownloadRequest as W, cashReceiptIdentityTypeOf as Wn, cartItemSchema as Wr, pricingAmountsSchema as Wt, deliveryTrackingSchema as X, deliveryQuoteRequestSchema as Xn, MemberConsents as Xt, PurchaseDecisionResult as Y, createCheckoutRequestSchema as Yn, ConsentUpdateRequest as Yt, downloadLinkSchema as Z, deliveryQuoteSchema as Zn, consentActionSchema as Zt, analyticsServerEventNameSchema as _, CashReceiptIdentityType as _n, ProductDetail as _r, PublicInquiry as _t, ANALYTICS_SESSION_HEADER as a, ClaimType as an, paymentOptionListSchema as ar, Member as at, createStorefrontClient as b, CheckoutDelivery as bn, ProductSearchParams as br, publicInquirySchema as bt, AnalyticsBatch as c, MyClaim as cn, paymentStatusSchema as cr, UpdateProfileRequest as ct, AnalyticsEventName as d, claimTypeSchema as dn, residentNumberLike as dr, memberAddressSchema as dt, consentStateSchema as en, guestInfoSchema as er, myOrderItemSchema as et, AnalyticsServerEventName as f, createClaimRequestSchema as fn, retryPaymentRequestSchema as fr, memberSchema as ft, analyticsIdSchema as g, CASH_RECEIPT_METHODS as gn, ProductCard as gr, CreateInquiryResult as gt, analyticsClientEventSchema as h, AvailablePaymentOption as hn, CategoryNode as hr, CreateInquiryRequest as ht, ANALYTICS_SESSION_COOKIE as i, ClaimReturnAddress as in, paymentOptionKey as ir, trackingStageResponseSchema as it, UpdateReviewRequest as j, PaymentFailureCategory as jn, PageParams as jr, CouponResult as jt, ReviewPage as k, PAYMENT_RESULT_VALUES as kn, OrderItemStatus as kr, CheckoutPricingRequest as kt, AnalyticsClientEvent as l, claimReasonSchema as ln, pgProviderSchema as lr, WishlistAddResult as lt, analyticsClientEventNameSchema as m, myClaimSchema as mn, startPaymentRequestSchema as mr, wishlistAddResultSchema as mt, storefrontStoreSchema as n, memberConsentsSchema as nn, paymentMessageSchema as nr, orderShippingAddressSchema as nt, ANALYTICS_VISITOR_COOKIE as o, CreateClaimRequest as on, paymentOptionSchema as or, MemberAddress as ot, analyticsBatchSchema as p, createClaimResultSchema as pn, shippingAddressInputSchema as pr, updateProfileRequestSchema as pt, MyOrderItem as q, checkoutDeliverySchema as qn, analyticsIdsFromCookie as qr, ConsentSource as qt, ANALYTICS_MAX_BATCH_BYTES as r, ClaimReason as rn, paymentMethodSchema as rr, purchaseDecisionResultSchema as rt, ANALYTICS_VISITOR_HEADER as s, CreateClaimResult as sn, paymentStartSchema as sr, MemberAddressRequest as st, StorefrontStore as t, consentUpdateRequestSchema as tn, paymentFailureCategorySchema as tr, myOrderSchema as tt, AnalyticsClientEventName as u, claimReturnAddressSchema as un, remoteAreaSchema as ur, memberAddressRequestSchema as ut, StorefrontClient as v, CashReceiptRequest as vn, ProductFacets as vr, createInquiryRequestSchema as vt, StorefrontSessionOptions as w, DeliveryQuoteResult as wn, productDetailSchema as wr, createCustomerInquiryRequestSchema as wt, STOREFRONT_SESSION_KEYS as x, CheckoutSession as xn, ProductSort as xr, CreateCustomerInquiryRequest as xt, StorefrontClientOptions as y, CashReceiptType as yn, ProductPage as yr, createInquiryResultSchema as yt, updateReviewRequestSchema as z, RetryPaymentRequest as zn, AddCartItemRequest as zr, couponApplicationSchema as zt };