@sayren/storefront-sdk 0.20.12 → 0.20.14

package/dist/auth/index.mjs

@@ -1,4 +1,4 @@
-import { Ut as ApiError, t as createStorefrontClient } from "../client-CJ2oWniR.mjs";
+import { Ut as ApiError, t as createStorefrontClient } from "../client-Se5Bcaow.mjs";
 //#region src/auth/index.ts
 /** 소셜 로그인 실패 — 구매자가 취소했거나(`access_denied`) state가 맞지 않는다 */
 var IdpCallbackError = class extends Error {

package/dist/{client-CJ2oWniR.mjs → client-Se5Bcaow.mjs}

@@ -627,6 +627,15 @@ const orderStepSchema = z.object({
 	earlierAttachments: z.array(z.string()).optional().describe("앞 단계에서 올린 자료(수정 요청 뒤의 이전 시안 등)"),
 	inputs: flowStateSchema.shape.inputs,
 	actions: z.array(flowActionSchema).describe("이 단계에서 구매자가 할 행동(입력 칸 포함). `BUYER_ACTION`이면 하나 이상이다. 취소·반품 요청·구매확정은 `actions`(주문상품)에 있다"),
+	claimable: z.array(z.object({
+		action: z.enum([
+			"CANCEL",
+			"CANCEL_REQUEST",
+			"RETURN_REQUEST",
+			"EXCHANGE_REQUEST"
+		]).describe("CANCEL 바로 취소 · CANCEL_REQUEST 취소 요청(판매자 확인) · RETURN_REQUEST 반품 요청 · EXCHANGE_REQUEST 교환 요청"),
+		until: z.string().optional().describe("이 시각까지만 신청할 수 있다(ISO 8601). 없으면 이 단계 동안")
+	})).optional().default([]).describe("지금 신청할 수 있는 취소·반품·교환(#115) — 흐름 노드의 권한 표가 정한다. 화면은 이 목록으로 「지금 취소할 수 있습니다」 같은 안내를 그린다. 진행 중 클레임이 있으면 빈 목록"),
 	data: z.object({ delivery: z.object({
 		carrierName: z.string().nullable(),
 		trackingNumber: z.string().nullable(),
@@ -905,7 +914,9 @@ const myOrderSchema = z.object({
 		})).optional().default([]).describe("주문이 받은 쿠폰. 쿠폰이 없으면 빈 배열. 서버는 항상 싣는다"),
 		totalAmount: z.number().int().describe("결제 금액 (쿠폰 할인 반영)"),
 		paidAt: z.string().nullable(),
-		receiptUrl: z.url().nullable()
+		receiptUrl: z.url().nullable(),
+		refundedAmount: z.number().int().optional().default(0).describe("환불된 결제 금액 합계 (원, #115) — 결제 대행사 환불이 끝난 몫이다. 적립금 반환은 포함하지 않는다. 서버는 항상 싣는다"),
+		refundPendingAmount: z.number().int().optional().default(0).describe("환불 예정 금액 (원, #115) — 판매자가 취소·반품을 승인했지만 결제 환불이 아직 끝나지 않은 몫이다. 판매자가 처리하면 `refundedAmount`로 옮겨진다. 서버는 항상 싣는다")
 	}),
 	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 나가지 않았습니다 — 주문 화면에 테스트 결제 배지를 표시합니다")
 });

package/dist/{index-DYKDbtx6.d.mts → index-CPAkDqew.d.mts}

@@ -3243,6 +3243,10 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
               }[] | undefined;
               partialQuantity?: boolean | "UNIT" | undefined;
             }[];
+            claimable: {
+              action: "CANCEL" | "CANCEL_REQUEST" | "RETURN_REQUEST" | "EXCHANGE_REQUEST";
+              until?: string | undefined;
+            }[];
             message?: string | undefined;
             deadlineAt?: string | undefined;
             attachments?: string[] | undefined;
@@ -3299,6 +3303,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
           totalAmount: number;
           paidAt: string | null;
           receiptUrl: string | null;
+          refundedAmount: number;
+          refundPendingAmount: number;
         };
         testPayment: boolean;
         progressStatus?: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
@@ -3470,6 +3476,10 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
             }[] | undefined;
             partialQuantity?: boolean | "UNIT" | undefined;
           }[];
+          claimable: {
+            action: "CANCEL" | "CANCEL_REQUEST" | "RETURN_REQUEST" | "EXCHANGE_REQUEST";
+            until?: string | undefined;
+          }[];
           message?: string | undefined;
           deadlineAt?: string | undefined;
           attachments?: string[] | undefined;
@@ -3526,6 +3536,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         totalAmount: number;
         paidAt: string | null;
         receiptUrl: string | null;
+        refundedAmount: number;
+        refundPendingAmount: number;
       };
       testPayment: boolean;
       progressStatus?: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
@@ -3708,6 +3720,10 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
             }[] | undefined;
             partialQuantity?: boolean | "UNIT" | undefined;
           }[];
+          claimable: {
+            action: "CANCEL" | "CANCEL_REQUEST" | "RETURN_REQUEST" | "EXCHANGE_REQUEST";
+            until?: string | undefined;
+          }[];
           message?: string | undefined;
           deadlineAt?: string | undefined;
           attachments?: string[] | undefined;
@@ -3764,6 +3780,8 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
         totalAmount: number;
         paidAt: string | null;
         receiptUrl: string | null;
+        refundedAmount: number;
+        refundPendingAmount: number;
       };
       testPayment: boolean;
       progressStatus?: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
@@ -4573,6 +4591,15 @@ declare const orderStepSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     partialQuantity: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"UNIT">]>>;
   }, z.core.$strip>>;
+  claimable: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    action: z.ZodEnum<{
+      CANCEL: "CANCEL";
+      CANCEL_REQUEST: "CANCEL_REQUEST";
+      RETURN_REQUEST: "RETURN_REQUEST";
+      EXCHANGE_REQUEST: "EXCHANGE_REQUEST";
+    }>;
+    until: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>>;
   data: z.ZodOptional<z.ZodObject<{
     delivery: z.ZodOptional<z.ZodObject<{
       carrierName: z.ZodNullable<z.ZodString>;
@@ -4903,6 +4930,15 @@ declare const myOrderItemSchema: z.ZodObject<{
       }, z.core.$strip>>>;
       partialQuantity: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"UNIT">]>>;
     }, z.core.$strip>>;
+    claimable: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+      action: z.ZodEnum<{
+        CANCEL: "CANCEL";
+        CANCEL_REQUEST: "CANCEL_REQUEST";
+        RETURN_REQUEST: "RETURN_REQUEST";
+        EXCHANGE_REQUEST: "EXCHANGE_REQUEST";
+      }>;
+      until: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
     data: z.ZodOptional<z.ZodObject<{
       delivery: z.ZodOptional<z.ZodObject<{
         carrierName: z.ZodNullable<z.ZodString>;
@@ -5167,6 +5203,15 @@ declare const myOrderSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         partialQuantity: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"UNIT">]>>;
       }, z.core.$strip>>;
+      claimable: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        action: z.ZodEnum<{
+          CANCEL: "CANCEL";
+          CANCEL_REQUEST: "CANCEL_REQUEST";
+          RETURN_REQUEST: "RETURN_REQUEST";
+          EXCHANGE_REQUEST: "EXCHANGE_REQUEST";
+        }>;
+        until: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>>>;
       data: z.ZodOptional<z.ZodObject<{
         delivery: z.ZodOptional<z.ZodObject<{
           carrierName: z.ZodNullable<z.ZodString>;
@@ -5234,6 +5279,8 @@ declare const myOrderSchema: z.ZodObject<{
     totalAmount: z.ZodNumber;
     paidAt: z.ZodNullable<z.ZodString>;
     receiptUrl: z.ZodNullable<z.ZodURL>;
+    refundedAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    refundPendingAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   }, z.core.$strip>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;

package/dist/index.d.mts

@@ -1,3 +1,3 @@
 import { C as loginRequestSchema, D as tokenPairSchema, E as socialProviderSchema, O as withdrawRequestSchema, S as linkIdentityRequestSchema, T as signupRequestSchema, _ as anonymousSessionSchema, a as AnonymousSession, b as idpAuthorizeResponseSchema, c as IdpTokenRequest, d as MemberIdentities, f as SignupRequest, g as WithdrawalBlockedDetails, h as WithdrawRequest, i as buildQuery, k as withdrawalBlockedDetailsSchema, l as LinkIdentityRequest, m as TokenPair, n as Query, o as IdpAgreements, p as SocialProvider, r as TokenSource, s as IdpAuthorizeRequest, t as ApiError, u as LoginRequest, v as idpAgreementsSchema, w as memberIdentitiesSchema, x as idpTokenRequestSchema, y as idpAuthorizeRequestSchema } from "./http-1ab7tP4-.mjs";
-import { $ as ANALYTICS_VISITOR_HEADER, $i as storefrontCollectionDetailSchema, $n as storefrontCouponListQuerySchema, $r as RemoteArea, $t as customInputEntrySchema, A as FlowAction, Ai as shippingAddressInputSchema, An as createCustomerInquiryRequestSchema, Ar as CashReceiptIdentityType, At as WritableReview, B as flowActionRequestSchema, Bi as ProductSearchParams, Bn as MyCoupon, Br as KnownPaymentResult, Bt as updateReviewRequestSchema, C as myOrderSchema, Ca as CartItem, Ci as paymentStartSchema, Cn as createInquiryRequestSchema, Cr as claimReturnAddressSchema, Ct as PublicReview, D as commerceNumberField, Da as cartSchema, Di as residentNumberLike, Dn as CreateCustomerInquiryRequest, Dr as myClaimSchema, Dt as UpdateReviewRequest, E as trackingStageResponseSchema, Ea as cartItemSchema, Ei as remoteAreaSchema, En as publicInquirySchema, Er as createClaimResultSchema, Et as ReviewSummary, F as FlowState, Fi as CollectionProductSortParam, Fn as CheckoutPricingRequest, Fr as CreateCheckoutRequest, Ft as productReviewSortSchema, G as flowStateSchema, Gi as collectionProductPageSchema, Gn as checkoutPricingSchema, Gr as PAYMENT_STATUS_VALUES, Gt as AddonSelection, H as flowActionSchema, Hi as StorefrontCollection, Hn as StorefrontCouponListParams, Hr as KnownPaymentStatus, Ht as uploadTicketSchema, I as GuestFlowActionRequest, Ii as ProductCard, In as CouponApplication, Ir as DeliveryQuoteRequest, It as publicReviewSchema, J as orderStepSchema, Ji as productCardSchema, Jn as couponBenefitViewSchema, Jr as PaymentMethod, Jt as CustomInputView, K as guestFlowActionRequestSchema, Ki as collectionProductQuerySchema, Kn as couponApplicationListSchema, Kr as PaymentFailureCategory, Kt as CustomInputEntry, L as ORDER_STEP_TYPES, Li as ProductDetail, Ln as CouponResult, Lr as DeliveryQuoteResult, Lt as reviewImageUploadRequestSchema, M as FlowActionResult, Mi as CategoryNode, Mn as customerInquirySchema, Mr as CashReceiptType, Mt as createReviewResultSchema, N as FlowFieldValue, Ni as CollectionProductPage, Nn as ApplicableCoupon, Nr as CheckoutDelivery, Nt as myReviewSchema, O as formatOrderNo, Oa as updateCartItemRequestSchema, Oi as responsePaymentMethodSchema, On as CustomerInquiry, Or as AvailablePaymentOption, Ot as UpdateReviewResult, P as FlowInputField, Pi as CollectionProductParams, Pn as CheckoutPricing, Pr as CheckoutSession, Pt as productReviewQuerySchema, Q as ANALYTICS_VISITOR_COOKIE, Qi as productSortSchema, Qn as pricingAmountsSchema, Qr as PgProvider, Qt as addonSelectionSchema, R as OrderFlowActionResult, Ri as ProductFacets, Rn as MAX_COUPONS_PER_CHECKOUT, Rr as EasyPayProvider, Rt as reviewPageSchema, S as myOrderItemSchema, Sa as Cart, Si as paymentOptionSchema, Sn as PublicInquiry, Sr as claimReasonSchema, St as ProductReviewSort, T as purchaseDecisionResultSchema, Ta as addCartItemRequestSchema, Ti as pgProviderSchema, Tn as productInquiryCategorySchema, Tr as createClaimRequestSchema, Tt as ReviewPage, U as flowFieldValueSchema, Ui as StorefrontCollectionDetail, Un as applicableCouponSchema, Ur as PAYMENT_RESULT_VALUES, Ut as writableReviewSchema, V as flowActionResultSchema, Vi as ProductSort, Vn as StorefrontCoupon, Vr as KnownPaymentStartStatus, Vt as updateReviewResultSchema, W as flowInputFieldSchema, Wi as categoryNodeSchema, Wn as checkoutPricingRequestSchema, Wr as PAYMENT_START_STATUS_VALUES, Wt as AddonGroupView, X as ANALYTICS_SESSION_COOKIE, Xi as productFacetsSchema, Xn as myCouponListQuerySchema, Xr as PaymentStart, Xt as OrderInputUploadRequest, Y as ANALYTICS_MAX_BATCH_BYTES, Yi as productDetailSchema, Yn as couponResultSchema, Yr as PaymentOption, Yt as OptionSelectionView, Z as ANALYTICS_SESSION_HEADER, Zi as productPageSchema, Zn as myCouponSchema, Zr as PaymentStatus, Zt as addonGroupViewSchema, _ as MyOrder, _a as myOrderItemFulfillmentSnapshotSchema, _i as paymentFailureCategorySchema, _n as updateProfileRequestSchema, _r as ClaimType, _t as createStorefrontSession, a as StayView, aa as PageParams, ai as cashReceiptAvailable, an as normalizeCustomInputValue, ar as ConsentState, at as analyticsBatchSchema, b as PurchaseDecisionResult, ba as productFulfillmentViewSchema, bi as paymentOptionKey, bn as CreateInquiryResult, br as MyClaim, bt as MyReview, c as stayViewSchema, ca as pageInfoSchema, ci as cashReceiptTypeSchema, cn as parseCustomInputValue, cr as consentActionSchema, ct as analyticsIdSchema, d as StorefrontPointPolicy, da as MyOrderItemFulfillmentSnapshot, di as createCheckoutRequestSchema, dn as MemberAddressRequest, dr as consentStateSchema, dt as StorefrontClientOptions, ea as storefrontCollectionListQuerySchema, ei as ResponsePaymentMethod, en as customInputLength, er as storefrontCouponSchema, et as AnalyticsBatch, f as memberPointEntryPageSchema, fa as PickupLocationView, fi as deliveryQuoteRequestSchema, fn as UpdateProfileRequest, fr as consentUpdateRequestSchema, ft as createStorefrontClient, g as DeliveryTracking, ga as lineFulfillmentSchema, gi as guestInfoSchema, gn as memberSchema, gr as ClaimReturnAddress, gt as StorefrontSessionOptions, h as storefrontPointPolicySchema, ha as UnknownFulfillmentView, hi as easyPayProviderSchema, hn as memberAddressSchema, hr as ClaimReason, ht as StorefrontSession, i as StayRequest, ia as PageInfo, ii as availablePaymentOptionSchema, in as lineSelectionResponseShape, ir as ConsentSource, it as AnalyticsServerEventName, j as FlowActionRequest, ji as startPaymentRequestSchema, jn as customerInquiryCategorySchema, jr as CashReceiptRequest, jt as createReviewRequestSchema, k as parseOrderNo, ka as analyticsIdsFromCookie, ki as retryPaymentRequestSchema, kn as CustomerInquiryCategory, kr as CASH_RECEIPT_METHODS, kt as UploadTicket, l as MemberPointEntry, la as pageSchema, li as checkoutDeliverySchema, ln as Member, lr as consentKindSchema, lt as analyticsServerEventNameSchema, m as memberPointsSchema, ma as ProductFulfillmentView, mi as easyPayProviderResponseSchema, mn as memberAddressRequestSchema, mr as ClaimPreview, mt as SessionStorage, n as storefrontStoreSchema, na as ClaimStatus, ni as ShippingAddressInput, nn as customInputViewSchema, nr as ConsentAction, nt as AnalyticsClientEventName, o as calendarDayViewSchema, oa as claimStatusSchema, oi as cashReceiptIdentityTypeOf, on as optionSelectionViewSchema, or as ConsentUpdateRequest, ot as analyticsClientEventNameSchema, p as memberPointEntrySchema, pa as ProductCardFulfillment, pi as deliveryQuoteSchema, pn as WishlistAddResult, pr as memberConsentsSchema, pt as STOREFRONT_SESSION_KEYS, q as orderFlowActionResultSchema, qi as collectionProductSortSchema, qn as couponApplicationSchema, qr as PaymentMessage, qt as CustomInputValueView, r as CalendarDayView, ra as OrderItemStatus, ri as StartPaymentRequest, rn as lineSelectionRequestShape, rr as ConsentKind, rt as AnalyticsEventName, s as stayRequestSchema, sa as orderItemStatusSchema, si as cashReceiptRequestSchema, sn as orderInputUploadRequestSchema, sr as MemberConsents, st as analyticsClientEventSchema, t as StorefrontStore, ta as storefrontCollectionSchema, ti as RetryPaymentRequest, tn as customInputValueViewSchema, tr as storefrontCouponTargetSchema, tt as AnalyticsClientEvent, u as MemberPoints, ua as LineFulfillment, ui as checkoutSessionSchema, un as MemberAddress, ur as consentSourceSchema, ut as StorefrontClient, v as MyOrderItem, va as pickupLocationViewSchema, vi as paymentMessageSchema, vn as wishlistAddResultSchema, vr as CreateClaimRequest, vt as CreateReviewRequest, w as orderShippingAddressSchema, wa as UpdateCartItemRequest, wi as paymentStatusSchema, wn as createInquiryResultSchema, wr as claimTypeSchema, wt as ReviewImageUploadRequest, x as deliveryTrackingSchema, xa as AddCartItemRequest, xi as paymentOptionListSchema, xn as ProductInquiryCategory, xr as claimPreviewSchema, xt as ProductReviewParams, y as OrderShippingAddress, ya as productCardFulfillmentSchema, yi as paymentMethodSchema, yn as CreateInquiryRequest, yr as CreateClaimResult, yt as CreateReviewResult, z as OrderStep, zi as ProductPage, zn as MIN_PAYMENT_AMOUNT, zr as GuestInfo, zt as reviewSummarySchema } from "./index-DYKDbtx6.mjs";
+import { $ as ANALYTICS_VISITOR_HEADER, $i as storefrontCollectionDetailSchema, $n as storefrontCouponListQuerySchema, $r as RemoteArea, $t as customInputEntrySchema, A as FlowAction, Ai as shippingAddressInputSchema, An as createCustomerInquiryRequestSchema, Ar as CashReceiptIdentityType, At as WritableReview, B as flowActionRequestSchema, Bi as ProductSearchParams, Bn as MyCoupon, Br as KnownPaymentResult, Bt as updateReviewRequestSchema, C as myOrderSchema, Ca as CartItem, Ci as paymentStartSchema, Cn as createInquiryRequestSchema, Cr as claimReturnAddressSchema, Ct as PublicReview, D as commerceNumberField, Da as cartSchema, Di as residentNumberLike, Dn as CreateCustomerInquiryRequest, Dr as myClaimSchema, Dt as UpdateReviewRequest, E as trackingStageResponseSchema, Ea as cartItemSchema, Ei as remoteAreaSchema, En as publicInquirySchema, Er as createClaimResultSchema, Et as ReviewSummary, F as FlowState, Fi as CollectionProductSortParam, Fn as CheckoutPricingRequest, Fr as CreateCheckoutRequest, Ft as productReviewSortSchema, G as flowStateSchema, Gi as collectionProductPageSchema, Gn as checkoutPricingSchema, Gr as PAYMENT_STATUS_VALUES, Gt as AddonSelection, H as flowActionSchema, Hi as StorefrontCollection, Hn as StorefrontCouponListParams, Hr as KnownPaymentStatus, Ht as uploadTicketSchema, I as GuestFlowActionRequest, Ii as ProductCard, In as CouponApplication, Ir as DeliveryQuoteRequest, It as publicReviewSchema, J as orderStepSchema, Ji as productCardSchema, Jn as couponBenefitViewSchema, Jr as PaymentMethod, Jt as CustomInputView, K as guestFlowActionRequestSchema, Ki as collectionProductQuerySchema, Kn as couponApplicationListSchema, Kr as PaymentFailureCategory, Kt as CustomInputEntry, L as ORDER_STEP_TYPES, Li as ProductDetail, Ln as CouponResult, Lr as DeliveryQuoteResult, Lt as reviewImageUploadRequestSchema, M as FlowActionResult, Mi as CategoryNode, Mn as customerInquirySchema, Mr as CashReceiptType, Mt as createReviewResultSchema, N as FlowFieldValue, Ni as CollectionProductPage, Nn as ApplicableCoupon, Nr as CheckoutDelivery, Nt as myReviewSchema, O as formatOrderNo, Oa as updateCartItemRequestSchema, Oi as responsePaymentMethodSchema, On as CustomerInquiry, Or as AvailablePaymentOption, Ot as UpdateReviewResult, P as FlowInputField, Pi as CollectionProductParams, Pn as CheckoutPricing, Pr as CheckoutSession, Pt as productReviewQuerySchema, Q as ANALYTICS_VISITOR_COOKIE, Qi as productSortSchema, Qn as pricingAmountsSchema, Qr as PgProvider, Qt as addonSelectionSchema, R as OrderFlowActionResult, Ri as ProductFacets, Rn as MAX_COUPONS_PER_CHECKOUT, Rr as EasyPayProvider, Rt as reviewPageSchema, S as myOrderItemSchema, Sa as Cart, Si as paymentOptionSchema, Sn as PublicInquiry, Sr as claimReasonSchema, St as ProductReviewSort, T as purchaseDecisionResultSchema, Ta as addCartItemRequestSchema, Ti as pgProviderSchema, Tn as productInquiryCategorySchema, Tr as createClaimRequestSchema, Tt as ReviewPage, U as flowFieldValueSchema, Ui as StorefrontCollectionDetail, Un as applicableCouponSchema, Ur as PAYMENT_RESULT_VALUES, Ut as writableReviewSchema, V as flowActionResultSchema, Vi as ProductSort, Vn as StorefrontCoupon, Vr as KnownPaymentStartStatus, Vt as updateReviewResultSchema, W as flowInputFieldSchema, Wi as categoryNodeSchema, Wn as checkoutPricingRequestSchema, Wr as PAYMENT_START_STATUS_VALUES, Wt as AddonGroupView, X as ANALYTICS_SESSION_COOKIE, Xi as productFacetsSchema, Xn as myCouponListQuerySchema, Xr as PaymentStart, Xt as OrderInputUploadRequest, Y as ANALYTICS_MAX_BATCH_BYTES, Yi as productDetailSchema, Yn as couponResultSchema, Yr as PaymentOption, Yt as OptionSelectionView, Z as ANALYTICS_SESSION_HEADER, Zi as productPageSchema, Zn as myCouponSchema, Zr as PaymentStatus, Zt as addonGroupViewSchema, _ as MyOrder, _a as myOrderItemFulfillmentSnapshotSchema, _i as paymentFailureCategorySchema, _n as updateProfileRequestSchema, _r as ClaimType, _t as createStorefrontSession, a as StayView, aa as PageParams, ai as cashReceiptAvailable, an as normalizeCustomInputValue, ar as ConsentState, at as analyticsBatchSchema, b as PurchaseDecisionResult, ba as productFulfillmentViewSchema, bi as paymentOptionKey, bn as CreateInquiryResult, br as MyClaim, bt as MyReview, c as stayViewSchema, ca as pageInfoSchema, ci as cashReceiptTypeSchema, cn as parseCustomInputValue, cr as consentActionSchema, ct as analyticsIdSchema, d as StorefrontPointPolicy, da as MyOrderItemFulfillmentSnapshot, di as createCheckoutRequestSchema, dn as MemberAddressRequest, dr as consentStateSchema, dt as StorefrontClientOptions, ea as storefrontCollectionListQuerySchema, ei as ResponsePaymentMethod, en as customInputLength, er as storefrontCouponSchema, et as AnalyticsBatch, f as memberPointEntryPageSchema, fa as PickupLocationView, fi as deliveryQuoteRequestSchema, fn as UpdateProfileRequest, fr as consentUpdateRequestSchema, ft as createStorefrontClient, g as DeliveryTracking, ga as lineFulfillmentSchema, gi as guestInfoSchema, gn as memberSchema, gr as ClaimReturnAddress, gt as StorefrontSessionOptions, h as storefrontPointPolicySchema, ha as UnknownFulfillmentView, hi as easyPayProviderSchema, hn as memberAddressSchema, hr as ClaimReason, ht as StorefrontSession, i as StayRequest, ia as PageInfo, ii as availablePaymentOptionSchema, in as lineSelectionResponseShape, ir as ConsentSource, it as AnalyticsServerEventName, j as FlowActionRequest, ji as startPaymentRequestSchema, jn as customerInquiryCategorySchema, jr as CashReceiptRequest, jt as createReviewRequestSchema, k as parseOrderNo, ka as analyticsIdsFromCookie, ki as retryPaymentRequestSchema, kn as CustomerInquiryCategory, kr as CASH_RECEIPT_METHODS, kt as UploadTicket, l as MemberPointEntry, la as pageSchema, li as checkoutDeliverySchema, ln as Member, lr as consentKindSchema, lt as analyticsServerEventNameSchema, m as memberPointsSchema, ma as ProductFulfillmentView, mi as easyPayProviderResponseSchema, mn as memberAddressRequestSchema, mr as ClaimPreview, mt as SessionStorage, n as storefrontStoreSchema, na as ClaimStatus, ni as ShippingAddressInput, nn as customInputViewSchema, nr as ConsentAction, nt as AnalyticsClientEventName, o as calendarDayViewSchema, oa as claimStatusSchema, oi as cashReceiptIdentityTypeOf, on as optionSelectionViewSchema, or as ConsentUpdateRequest, ot as analyticsClientEventNameSchema, p as memberPointEntrySchema, pa as ProductCardFulfillment, pi as deliveryQuoteSchema, pn as WishlistAddResult, pr as memberConsentsSchema, pt as STOREFRONT_SESSION_KEYS, q as orderFlowActionResultSchema, qi as collectionProductSortSchema, qn as couponApplicationSchema, qr as PaymentMessage, qt as CustomInputValueView, r as CalendarDayView, ra as OrderItemStatus, ri as StartPaymentRequest, rn as lineSelectionRequestShape, rr as ConsentKind, rt as AnalyticsEventName, s as stayRequestSchema, sa as orderItemStatusSchema, si as cashReceiptRequestSchema, sn as orderInputUploadRequestSchema, sr as MemberConsents, st as analyticsClientEventSchema, t as StorefrontStore, ta as storefrontCollectionSchema, ti as RetryPaymentRequest, tn as customInputValueViewSchema, tr as storefrontCouponTargetSchema, tt as AnalyticsClientEvent, u as MemberPoints, ua as LineFulfillment, ui as checkoutSessionSchema, un as MemberAddress, ur as consentSourceSchema, ut as StorefrontClient, v as MyOrderItem, va as pickupLocationViewSchema, vi as paymentMessageSchema, vn as wishlistAddResultSchema, vr as CreateClaimRequest, vt as CreateReviewRequest, w as orderShippingAddressSchema, wa as UpdateCartItemRequest, wi as paymentStatusSchema, wn as createInquiryResultSchema, wr as claimTypeSchema, wt as ReviewImageUploadRequest, x as deliveryTrackingSchema, xa as AddCartItemRequest, xi as paymentOptionListSchema, xn as ProductInquiryCategory, xr as claimPreviewSchema, xt as ProductReviewParams, y as OrderShippingAddress, ya as productCardFulfillmentSchema, yi as paymentMethodSchema, yn as CreateInquiryRequest, yr as CreateClaimResult, yt as CreateReviewResult, z as OrderStep, zi as ProductPage, zn as MIN_PAYMENT_AMOUNT, zr as GuestInfo, zt as reviewSummarySchema } from "./index-CPAkDqew.mjs";
 export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, AddCartItemRequest, AddonGroupView, AddonSelection, AnalyticsBatch, AnalyticsClientEvent, AnalyticsClientEventName, AnalyticsEventName, AnalyticsServerEventName, AnonymousSession, ApiError, ApplicableCoupon, AvailablePaymentOption, CASH_RECEIPT_METHODS, CalendarDayView, Cart, CartItem, CashReceiptIdentityType, CashReceiptRequest, CashReceiptType, CategoryNode, CheckoutDelivery, CheckoutPricing, CheckoutPricingRequest, CheckoutSession, ClaimPreview, ClaimReason, ClaimReturnAddress, ClaimStatus, ClaimType, CollectionProductPage, CollectionProductParams, CollectionProductSortParam, ConsentAction, ConsentKind, ConsentSource, ConsentState, ConsentUpdateRequest, CouponApplication, CouponResult, CreateCheckoutRequest, CreateClaimRequest, CreateClaimResult, CreateCustomerInquiryRequest, CreateInquiryRequest, CreateInquiryResult, CreateReviewRequest, CreateReviewResult, CustomInputEntry, CustomInputValueView, CustomInputView, CustomerInquiry, CustomerInquiryCategory, DeliveryQuoteRequest, DeliveryQuoteResult, DeliveryTracking, EasyPayProvider, FlowAction, FlowActionRequest, FlowActionResult, FlowFieldValue, FlowInputField, FlowState, GuestFlowActionRequest, GuestInfo, IdpAgreements, IdpAuthorizeRequest, IdpTokenRequest, KnownPaymentResult, KnownPaymentStartStatus, KnownPaymentStatus, LineFulfillment, LinkIdentityRequest, LoginRequest, MAX_COUPONS_PER_CHECKOUT, MIN_PAYMENT_AMOUNT, Member, MemberAddress, MemberAddressRequest, MemberConsents, MemberIdentities, MemberPointEntry, MemberPoints, MyClaim, MyCoupon, MyOrder, MyOrderItem, MyOrderItemFulfillmentSnapshot, MyReview, ORDER_STEP_TYPES, OptionSelectionView, OrderFlowActionResult, OrderInputUploadRequest, OrderItemStatus, OrderShippingAddress, OrderStep, PAYMENT_RESULT_VALUES, PAYMENT_START_STATUS_VALUES, PAYMENT_STATUS_VALUES, PageInfo, PageParams, PaymentFailureCategory, PaymentMessage, PaymentMethod, PaymentOption, PaymentStart, PaymentStatus, PgProvider, PickupLocationView, ProductCard, ProductCardFulfillment, ProductDetail, ProductFacets, ProductFulfillmentView, ProductInquiryCategory, ProductPage, ProductReviewParams, ProductReviewSort, ProductSearchParams, ProductSort, PublicInquiry, PublicReview, PurchaseDecisionResult, type Query, RemoteArea, ResponsePaymentMethod, RetryPaymentRequest, ReviewImageUploadRequest, ReviewPage, ReviewSummary, STOREFRONT_SESSION_KEYS, type SessionStorage, ShippingAddressInput, SignupRequest, SocialProvider, StartPaymentRequest, StayRequest, StayView, type StorefrontClient, type StorefrontClientOptions, StorefrontCollection, StorefrontCollectionDetail, StorefrontCoupon, StorefrontCouponListParams, StorefrontPointPolicy, type StorefrontSession, type StorefrontSessionOptions, StorefrontStore, TokenPair, type TokenSource, UnknownFulfillmentView, UpdateCartItemRequest, UpdateProfileRequest, UpdateReviewRequest, UpdateReviewResult, UploadTicket, WishlistAddResult, WithdrawRequest, WithdrawalBlockedDetails, WritableReview, addCartItemRequestSchema, addonGroupViewSchema, addonSelectionSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, applicableCouponSchema, availablePaymentOptionSchema, buildQuery, calendarDayViewSchema, cartItemSchema, cartSchema, cashReceiptAvailable, cashReceiptIdentityTypeOf, cashReceiptRequestSchema, cashReceiptTypeSchema, categoryNodeSchema, checkoutDeliverySchema, checkoutPricingRequestSchema, checkoutPricingSchema, checkoutSessionSchema, claimPreviewSchema, claimReasonSchema, claimReturnAddressSchema, claimStatusSchema, claimTypeSchema, collectionProductPageSchema, collectionProductQuerySchema, collectionProductSortSchema, commerceNumberField, consentActionSchema, consentKindSchema, consentSourceSchema, consentStateSchema, consentUpdateRequestSchema, couponApplicationListSchema, couponApplicationSchema, couponBenefitViewSchema, couponResultSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createInquiryResultSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customInputEntrySchema, customInputLength, customInputValueViewSchema, customInputViewSchema, customerInquiryCategorySchema, customerInquirySchema, deliveryQuoteRequestSchema, deliveryQuoteSchema, deliveryTrackingSchema, easyPayProviderResponseSchema, easyPayProviderSchema, flowActionRequestSchema, flowActionResultSchema, flowActionSchema, flowFieldValueSchema, flowInputFieldSchema, flowStateSchema, formatOrderNo, guestFlowActionRequestSchema, guestInfoSchema, idpAgreementsSchema, idpAuthorizeRequestSchema, idpAuthorizeResponseSchema, idpTokenRequestSchema, lineFulfillmentSchema, lineSelectionRequestShape, lineSelectionResponseShape, linkIdentityRequestSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberConsentsSchema, memberIdentitiesSchema, memberPointEntryPageSchema, memberPointEntrySchema, memberPointsSchema, memberSchema, myClaimSchema, myCouponListQuerySchema, myCouponSchema, myOrderItemFulfillmentSnapshotSchema, myOrderItemSchema, myOrderSchema, myReviewSchema, normalizeCustomInputValue, optionSelectionViewSchema, orderFlowActionResultSchema, orderInputUploadRequestSchema, orderItemStatusSchema, orderShippingAddressSchema, orderStepSchema, pageInfoSchema, pageSchema, parseCustomInputValue, parseOrderNo, paymentFailureCategorySchema, paymentMessageSchema, paymentMethodSchema, paymentOptionKey, paymentOptionListSchema, paymentOptionSchema, paymentStartSchema, paymentStatusSchema, pgProviderSchema, pickupLocationViewSchema, pricingAmountsSchema, productCardFulfillmentSchema, productCardSchema, productDetailSchema, productFacetsSchema, productFulfillmentViewSchema, productInquiryCategorySchema, productPageSchema, productReviewQuerySchema, productReviewSortSchema, productSortSchema, publicInquirySchema, publicReviewSchema, purchaseDecisionResultSchema, remoteAreaSchema, residentNumberLike, responsePaymentMethodSchema, retryPaymentRequestSchema, reviewImageUploadRequestSchema, reviewPageSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, socialProviderSchema, startPaymentRequestSchema, stayRequestSchema, stayViewSchema, storefrontCollectionDetailSchema, storefrontCollectionListQuerySchema, storefrontCollectionSchema, storefrontCouponListQuerySchema, storefrontCouponSchema, storefrontCouponTargetSchema, storefrontPointPolicySchema, storefrontStoreSchema, tokenPairSchema, trackingStageResponseSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, updateReviewResultSchema, uploadTicketSchema, wishlistAddResultSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { a as ANALYTICS_VISITOR_HEADER, c as analyticsClientEventSchema, i as ANALYTICS_VISITOR_COOKIE, l as analyticsIdSchema, n as ANALYTICS_SESSION_COOKIE, o as analyticsBatchSchema, r as ANALYTICS_SESSION_HEADER, s as analyticsClientEventNameSchema, t as ANALYTICS_MAX_BATCH_BYTES, u as analyticsServerEventNameSchema } from "./analytics-CgD70OqH.mjs";
 import { t as analyticsIdsFromCookie } from "./analytics-ids-COElZiI3.mjs";
-import { $ as orderStepSchema, A as wishlistAddResultSchema, At as anonymousSessionSchema, B as consentSourceSchema, Bt as tokenPairSchema, C as orderShippingAddressSchema, Ct as orderItemStatusSchema, D as memberAddressSchema, Dt as cartItemSchema, E as memberAddressRequestSchema, Et as addCartItemRequestSchema, F as createCustomerInquiryRequestSchema, Ft as linkIdentityRequestSchema, G as flowActionRequestSchema, Gt as toApiError, H as consentUpdateRequestSchema, Ht as withdrawalBlockedDetailsSchema, I as customerInquiryCategorySchema, It as loginRequestSchema, J as flowFieldValueSchema, K as flowActionResultSchema, Kt as unwrapData, L as customerInquirySchema, Lt as memberIdentitiesSchema, M as createInquiryResultSchema, Mt as idpAuthorizeRequestSchema, N as productInquiryCategorySchema, Nt as idpAuthorizeResponseSchema, O as memberSchema, Ot as cartSchema, P as publicInquirySchema, Pt as idpTokenRequestSchema, Q as orderFlowActionResultSchema, R as consentActionSchema, Rt as signupRequestSchema, S as myOrderSchema, St as claimStatusSchema, T as trackingStageResponseSchema, Tt as pageSchema, U as memberConsentsSchema, Ut as ApiError, V as consentStateSchema, Vt as withdrawRequestSchema, W as ORDER_STEP_TYPES, Wt as buildQuery, X as flowStateSchema, Y as flowInputFieldSchema, Z as guestFlowActionRequestSchema, _ as memberPointEntrySchema, _t as productPageSchema, a as myReviewSchema, at as createClaimResultSchema, b as deliveryTrackingSchema, bt as storefrontCollectionListQuerySchema, c as publicReviewSchema, ct as formatOrderNo, d as reviewSummarySchema, dt as collectionProductPageSchema, et as claimPreviewSchema, f as updateReviewRequestSchema, ft as collectionProductQuerySchema, g as memberPointEntryPageSchema, gt as productFacetsSchema, h as writableReviewSchema, ht as productDetailSchema, i as createReviewResultSchema, it as createClaimRequestSchema, j as createInquiryRequestSchema, jt as idpAgreementsSchema, k as updateProfileRequestSchema, kt as updateCartItemRequestSchema, l as reviewImageUploadRequestSchema, lt as parseOrderNo, m as uploadTicketSchema, mt as productCardSchema, n as storefrontStoreSchema, nt as claimReturnAddressSchema, o as productReviewQuerySchema, ot as myClaimSchema, p as updateReviewResultSchema, pt as collectionProductSortSchema, q as flowActionSchema, r as createReviewRequestSchema, rt as claimTypeSchema, s as productReviewSortSchema, st as commerceNumberField, t as createStorefrontClient, tt as claimReasonSchema, u as reviewPageSchema, ut as categoryNodeSchema, v as memberPointsSchema, vt as productSortSchema, w as purchaseDecisionResultSchema, wt as pageInfoSchema, x as myOrderItemSchema, xt as storefrontCollectionSchema, y as storefrontPointPolicySchema, yt as storefrontCollectionDetailSchema, z as consentKindSchema, zt as socialProviderSchema } from "./client-CJ2oWniR.mjs";
+import { $ as orderStepSchema, A as wishlistAddResultSchema, At as anonymousSessionSchema, B as consentSourceSchema, Bt as tokenPairSchema, C as orderShippingAddressSchema, Ct as orderItemStatusSchema, D as memberAddressSchema, Dt as cartItemSchema, E as memberAddressRequestSchema, Et as addCartItemRequestSchema, F as createCustomerInquiryRequestSchema, Ft as linkIdentityRequestSchema, G as flowActionRequestSchema, Gt as toApiError, H as consentUpdateRequestSchema, Ht as withdrawalBlockedDetailsSchema, I as customerInquiryCategorySchema, It as loginRequestSchema, J as flowFieldValueSchema, K as flowActionResultSchema, Kt as unwrapData, L as customerInquirySchema, Lt as memberIdentitiesSchema, M as createInquiryResultSchema, Mt as idpAuthorizeRequestSchema, N as productInquiryCategorySchema, Nt as idpAuthorizeResponseSchema, O as memberSchema, Ot as cartSchema, P as publicInquirySchema, Pt as idpTokenRequestSchema, Q as orderFlowActionResultSchema, R as consentActionSchema, Rt as signupRequestSchema, S as myOrderSchema, St as claimStatusSchema, T as trackingStageResponseSchema, Tt as pageSchema, U as memberConsentsSchema, Ut as ApiError, V as consentStateSchema, Vt as withdrawRequestSchema, W as ORDER_STEP_TYPES, Wt as buildQuery, X as flowStateSchema, Y as flowInputFieldSchema, Z as guestFlowActionRequestSchema, _ as memberPointEntrySchema, _t as productPageSchema, a as myReviewSchema, at as createClaimResultSchema, b as deliveryTrackingSchema, bt as storefrontCollectionListQuerySchema, c as publicReviewSchema, ct as formatOrderNo, d as reviewSummarySchema, dt as collectionProductPageSchema, et as claimPreviewSchema, f as updateReviewRequestSchema, ft as collectionProductQuerySchema, g as memberPointEntryPageSchema, gt as productFacetsSchema, h as writableReviewSchema, ht as productDetailSchema, i as createReviewResultSchema, it as createClaimRequestSchema, j as createInquiryRequestSchema, jt as idpAgreementsSchema, k as updateProfileRequestSchema, kt as updateCartItemRequestSchema, l as reviewImageUploadRequestSchema, lt as parseOrderNo, m as uploadTicketSchema, mt as productCardSchema, n as storefrontStoreSchema, nt as claimReturnAddressSchema, o as productReviewQuerySchema, ot as myClaimSchema, p as updateReviewResultSchema, pt as collectionProductSortSchema, q as flowActionSchema, r as createReviewRequestSchema, rt as claimTypeSchema, s as productReviewSortSchema, st as commerceNumberField, t as createStorefrontClient, tt as claimReasonSchema, u as reviewPageSchema, ut as categoryNodeSchema, v as memberPointsSchema, vt as productSortSchema, w as purchaseDecisionResultSchema, wt as pageInfoSchema, x as myOrderItemSchema, xt as storefrontCollectionSchema, y as storefrontPointPolicySchema, yt as storefrontCollectionDetailSchema, z as consentKindSchema, zt as socialProviderSchema } from "./client-Se5Bcaow.mjs";
 import { $ as customInputViewSchema, A as retryPaymentRequestSchema, B as couponBenefitViewSchema, C as paymentOptionSchema, D as remoteAreaSchema, E as pgProviderSchema, F as applicableCouponSchema, G as storefrontCouponListQuerySchema, H as myCouponListQuerySchema, I as checkoutPricingRequestSchema, J as addonGroupViewSchema, K as storefrontCouponSchema, L as checkoutPricingSchema, M as startPaymentRequestSchema, N as MAX_COUPONS_PER_CHECKOUT, O as residentNumberLike, P as MIN_PAYMENT_AMOUNT, Q as customInputValueViewSchema, R as couponApplicationListSchema, S as paymentOptionListSchema, T as paymentStatusSchema, U as myCouponSchema, V as couponResultSchema, W as pricingAmountsSchema, X as customInputEntrySchema, Y as addonSelectionSchema, Z as customInputLength, _ as guestInfoSchema, a as availablePaymentOptionSchema, at as parseCustomInputValue, b as paymentMethodSchema, c as cashReceiptRequestSchema, ct as stayViewSchema, d as checkoutSessionSchema, dt as pickupLocationViewSchema, et as lineSelectionRequestShape, f as createCheckoutRequestSchema, ft as productCardFulfillmentSchema, g as easyPayProviderSchema, h as easyPayProviderResponseSchema, i as PAYMENT_STATUS_VALUES, it as orderInputUploadRequestSchema, j as shippingAddressInputSchema, k as responsePaymentMethodSchema, l as cashReceiptTypeSchema, lt as lineFulfillmentSchema, m as deliveryQuoteSchema, n as PAYMENT_RESULT_VALUES, nt as normalizeCustomInputValue, o as cashReceiptAvailable, ot as calendarDayViewSchema, p as deliveryQuoteRequestSchema, pt as productFulfillmentViewSchema, q as storefrontCouponTargetSchema, r as PAYMENT_START_STATUS_VALUES, rt as optionSelectionViewSchema, s as cashReceiptIdentityTypeOf, st as stayRequestSchema, t as CASH_RECEIPT_METHODS, tt as lineSelectionResponseShape, u as checkoutDeliverySchema, ut as myOrderItemFulfillmentSnapshotSchema, v as paymentFailureCategorySchema, w as paymentStartSchema, x as paymentOptionKey, y as paymentMessageSchema, z as couponApplicationSchema } from "./checkout-BjJ4Efbn.mjs";
 //#region src/session.ts
 /** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */

package/dist/payments/index.d.mts

@@ -1,4 +1,4 @@
-import { Xr as PaymentStart, Yr as PaymentOption, Zr as PaymentStatus, ft as createStorefrontClient, jr as CashReceiptRequest, ni as ShippingAddressInput, ri as StartPaymentRequest, zr as GuestInfo } from "../index-DYKDbtx6.mjs";
+import { Xr as PaymentStart, Yr as PaymentOption, Zr as PaymentStatus, ft as createStorefrontClient, jr as CashReceiptRequest, ni as ShippingAddressInput, ri as StartPaymentRequest, zr as GuestInfo } from "../index-CPAkDqew.mjs";
 //#region src/payments/index.d.ts
 /**
  * 스토어프론트 결제 — 브라우저 전용(`@sayren/storefront-sdk/payments`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/storefront-sdk",
-  "version": "0.20.12",
+  "version": "0.20.14",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/schemas/commerce-flow.ts

@@ -134,6 +134,25 @@ export const orderStepSchema = z.object({
     .describe(
       "이 단계에서 구매자가 할 행동(입력 칸 포함). `BUYER_ACTION`이면 하나 이상이다. 취소·반품 요청·구매확정은 `actions`(주문상품)에 있다",
     ),
+  claimable: z
+    .array(
+      z.object({
+        action: z
+          .enum(["CANCEL", "CANCEL_REQUEST", "RETURN_REQUEST", "EXCHANGE_REQUEST"])
+          .describe(
+            "CANCEL 바로 취소 · CANCEL_REQUEST 취소 요청(판매자 확인) · RETURN_REQUEST 반품 요청 · EXCHANGE_REQUEST 교환 요청",
+          ),
+        until: z
+          .string()
+          .optional()
+          .describe("이 시각까지만 신청할 수 있다(ISO 8601). 없으면 이 단계 동안"),
+      }),
+    )
+    .optional()
+    .default([])
+    .describe(
+      "지금 신청할 수 있는 취소·반품·교환(#115) — 흐름 노드의 권한 표가 정한다. 화면은 이 목록으로 「지금 취소할 수 있습니다」 같은 안내를 그린다. 진행 중 클레임이 있으면 빈 목록",
+    ),
   data: z
     .object({
       delivery: z

package/src/schemas/order.ts

@@ -183,6 +183,22 @@ export const myOrderSchema = z.object({
     totalAmount: z.number().int().describe("결제 금액 (쿠폰 할인 반영)"),
     paidAt: z.string().nullable(),
     receiptUrl: z.url().nullable(),
+    refundedAmount: z
+      .number()
+      .int()
+      .optional()
+      .default(0)
+      .describe(
+        "환불된 결제 금액 합계 (원, #115) — 결제 대행사 환불이 끝난 몫이다. 적립금 반환은 포함하지 않는다. 서버는 항상 싣는다",
+      ),
+    refundPendingAmount: z
+      .number()
+      .int()
+      .optional()
+      .default(0)
+      .describe(
+        "환불 예정 금액 (원, #115) — 판매자가 취소·반품을 승인했지만 결제 환불이 아직 끝나지 않은 몫이다. 판매자가 처리하면 `refundedAmount`로 옮겨진다. 서버는 항상 싣는다",
+      ),
   }),
   testPayment: z
     .boolean()