@sayren/storefront-sdk 0.9.0 → 0.11.0

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { C as signupRequestSchema, D as withdrawalBlockedDetailsSchema, E as withdrawRequestSchema, S as memberIdentitiesSchema, T as tokenPairSchema, _ as idpAuthorizeRequestSchema, a as AnonymousSession, b as linkIdentityRequestSchema, c as LinkIdentityRequest, d as SignupRequest, f as SocialProvider, g as anonymousSessionSchema, h as WithdrawalBlockedDetails, i as buildQuery, l as LoginRequest, m as WithdrawRequest, n as Query, o as IdpAuthorizeRequest, p as TokenPair, r as TokenSource, s as IdpTokenRequest, t as ApiError, u as MemberIdentities, v as idpAuthorizeResponseSchema, w as socialProviderSchema, x as loginRequestSchema, y as idpTokenRequestSchema } from "./http-BbFHVGBf.mjs";
-import { $ as MemberAddress, $t as easyPayProviderSchema, A as createStorefrontClient, An as claimStatusSchema, At as AvailablePaymentOption, B as ReviewSummary, Bn as cartSchema, Bt as PaymentMessage, C as analyticsBatchSchema, Cn as productFacetsSchema, Ct as CreateClaimResult, D as analyticsServerEventNameSchema, Dn as OrderItemStatus, Dt as createClaimRequestSchema, E as analyticsIdSchema, En as ClaimStatus, Et as claimTypeSchema, F as createStorefrontSession, Fn as Cart, Ft as KnownPaymentResult, G as createReviewResultSchema, Gt as PgProvider, H as UpdateReviewResult, Hn as analyticsIdsFromCookie, Ht as PaymentOption, I as CreateReviewRequest, In as CartItem, It as KnownPaymentStatus, J as reviewSummarySchema, Jt as StartPaymentRequest, K as publicReviewSchema, Kt as RetryPaymentRequest, L as CreateReviewResult, Ln as UpdateCartItemRequest, Lt as PAYMENT_RESULT_VALUES, M as SessionStorage, Mn as pageInfoSchema, Mt as CreateCheckoutRequest, N as StorefrontSession, Nn as pageSchema, Nt as EasyPayProvider, O as StorefrontClient, On as PageInfo, Ot as createClaimResultSchema, P as StorefrontSessionOptions, Pn as AddCartItemRequest, Pt as GuestInfo, Q as Member, Qt as easyPayProviderResponseSchema, R as PublicReview, Rn as addCartItemRequestSchema, Rt as PAYMENT_STATUS_VALUES, S as AnalyticsServerEventName, Sn as productDetailSchema, St as CreateClaimRequest, T as analyticsClientEventSchema, Tn as productSortSchema, Tt as claimReasonSchema, U as WritableReview, Ut as PaymentStart, V as UpdateReviewRequest, Vn as updateCartItemRequestSchema, Vt as PaymentMethod, W as createReviewRequestSchema, Wt as PaymentStatus, X as updateReviewResultSchema, Xt as checkoutSessionSchema, Y as updateReviewRequestSchema, Yt as availablePaymentOptionSchema, Z as writableReviewSchema, Zt as createCheckoutRequestSchema, _ as ANALYTICS_VISITOR_HEADER, _n as ProductPage, _t as createCustomerInquiryRequestSchema, a as MyOrderItem, an as paymentOptionListSchema, at as memberSchema, b as AnalyticsClientEventName, bn as categoryNodeSchema, bt as ClaimReason, c as deliveryTrackingSchema, cn as paymentStatusSchema, ct as CreateInquiryRequest, d as orderShippingAddressSchema, dn as shippingAddressInputSchema, dt as createInquiryRequestSchema, en as guestInfoSchema, et as MemberAddressRequest, f as purchaseDecisionResultSchema, fn as startPaymentRequestSchema, ft as createInquiryResultSchema, g as ANALYTICS_VISITOR_COOKIE, gn as ProductFacets, gt as CustomerInquiryCategory, h as ANALYTICS_SESSION_HEADER, hn as ProductDetail, ht as CustomerInquiry, i as MyOrder, in as paymentOptionKey, it as memberAddressSchema, j as STOREFRONT_SESSION_KEYS, jn as orderItemStatusSchema, jt as CheckoutSession, k as StorefrontClientOptions, kn as PageParams, kt as myClaimSchema, l as myOrderItemSchema, ln as pgProviderSchema, lt as CreateInquiryResult, m as ANALYTICS_SESSION_COOKIE, mn as ProductCard, mt as CreateCustomerInquiryRequest, n as storefrontStoreSchema, nn as paymentMessageSchema, nt as WishlistAddResult, o as OrderShippingAddress, on as paymentOptionSchema, ot as updateProfileRequestSchema, p as ANALYTICS_MAX_BATCH_BYTES, pn as CategoryNode, pt as publicInquirySchema, q as reviewPageSchema, qt as ShippingAddressInput, r as DeliveryTracking, rn as paymentMethodSchema, rt as memberAddressRequestSchema, s as PurchaseDecisionResult, sn as paymentStartSchema, st as wishlistAddResultSchema, t as StorefrontStore, tn as paymentFailureCategorySchema, tt as UpdateProfileRequest, u as myOrderSchema, un as retryPaymentRequestSchema, ut as PublicInquiry, v as AnalyticsBatch, vn as ProductSearchParams, vt as customerInquiryCategorySchema, w as analyticsClientEventNameSchema, wn as productPageSchema, wt as MyClaim, x as AnalyticsEventName, xn as productCardSchema, xt as ClaimType, y as AnalyticsClientEvent, yn as ProductSort, yt as customerInquirySchema, z as ReviewPage, zn as cartItemSchema, zt as PaymentFailureCategory } from "./index-DvHOQm2-.mjs";
-export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, AddCartItemRequest, AnalyticsBatch, AnalyticsClientEvent, AnalyticsClientEventName, AnalyticsEventName, AnalyticsServerEventName, AnonymousSession, ApiError, AvailablePaymentOption, Cart, CartItem, CategoryNode, CheckoutSession, ClaimReason, ClaimStatus, ClaimType, CreateCheckoutRequest, CreateClaimRequest, CreateClaimResult, CreateCustomerInquiryRequest, CreateInquiryRequest, CreateInquiryResult, CreateReviewRequest, CreateReviewResult, CustomerInquiry, CustomerInquiryCategory, DeliveryTracking, EasyPayProvider, GuestInfo, IdpAuthorizeRequest, IdpTokenRequest, KnownPaymentResult, KnownPaymentStatus, LinkIdentityRequest, LoginRequest, Member, MemberAddress, MemberAddressRequest, MemberIdentities, MyClaim, MyOrder, MyOrderItem, OrderItemStatus, OrderShippingAddress, PAYMENT_RESULT_VALUES, PAYMENT_STATUS_VALUES, PageInfo, PageParams, PaymentFailureCategory, PaymentMessage, PaymentMethod, PaymentOption, PaymentStart, PaymentStatus, PgProvider, ProductCard, ProductDetail, ProductFacets, ProductPage, ProductSearchParams, ProductSort, PublicInquiry, PublicReview, PurchaseDecisionResult, type Query, RetryPaymentRequest, ReviewPage, ReviewSummary, STOREFRONT_SESSION_KEYS, type SessionStorage, ShippingAddressInput, SignupRequest, SocialProvider, StartPaymentRequest, type StorefrontClient, type StorefrontClientOptions, type StorefrontSession, type StorefrontSessionOptions, StorefrontStore, TokenPair, type TokenSource, UpdateCartItemRequest, UpdateProfileRequest, UpdateReviewRequest, UpdateReviewResult, WishlistAddResult, WithdrawRequest, WithdrawalBlockedDetails, WritableReview, addCartItemRequestSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, availablePaymentOptionSchema, buildQuery, cartItemSchema, cartSchema, categoryNodeSchema, checkoutSessionSchema, claimReasonSchema, claimStatusSchema, claimTypeSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createInquiryResultSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customerInquiryCategorySchema, customerInquirySchema, deliveryTrackingSchema, easyPayProviderResponseSchema, easyPayProviderSchema, guestInfoSchema, idpAuthorizeRequestSchema, idpAuthorizeResponseSchema, idpTokenRequestSchema, linkIdentityRequestSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberIdentitiesSchema, memberSchema, myClaimSchema, myOrderItemSchema, myOrderSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentFailureCategorySchema, paymentMessageSchema, paymentMethodSchema, paymentOptionKey, paymentOptionListSchema, paymentOptionSchema, paymentStartSchema, paymentStatusSchema, pgProviderSchema, productCardSchema, productDetailSchema, productFacetsSchema, productPageSchema, productSortSchema, publicInquirySchema, publicReviewSchema, purchaseDecisionResultSchema, retryPaymentRequestSchema, reviewPageSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, socialProviderSchema, startPaymentRequestSchema, storefrontStoreSchema, tokenPairSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, updateReviewResultSchema, wishlistAddResultSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };
+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-CeRVoUGu.mjs";
+import { $ as Member, $n as productCardSchema, $t as DeliveryQuoteRequest, A as StorefrontClientOptions, An as guestInfoSchema, At as consentStateSchema, B as ReviewPage, Bn as remoteAreaSchema, Bt as claimReturnAddressSchema, C as AnalyticsServerEventName, Cn as checkoutDeliverySchema, Ct as ConsentSource, D as analyticsIdSchema, Dn as deliveryQuoteSchema, Dt as consentActionSchema, E as analyticsClientEventSchema, En as deliveryQuoteRequestSchema, Et as MemberConsents, F as StorefrontSessionOptions, Fn as paymentOptionListSchema, Ft as ClaimType, G as createReviewRequestSchema, Gn as CategoryNode, Gt as AvailablePaymentOption, H as UpdateReviewRequest, Hn as retryPaymentRequestSchema, Ht as createClaimRequestSchema, I as createStorefrontSession, In as paymentOptionSchema, It as CreateClaimRequest, J as reviewPageSchema, Jn as ProductFacets, Jt as CashReceiptRequest, K as createReviewResultSchema, Kn as ProductCard, Kt as CASH_RECEIPT_METHODS, L as CreateReviewRequest, Ln as paymentStartSchema, Lt as CreateClaimResult, M as STOREFRONT_SESSION_KEYS, Mn as paymentMessageSchema, Mt as memberConsentsSchema, N as SessionStorage, Nn as paymentMethodSchema, Nt as ClaimReason, O as analyticsServerEventNameSchema, On as easyPayProviderResponseSchema, Ot as consentKindSchema, P as StorefrontSession, Pn as paymentOptionKey, Pt as ClaimReturnAddress, Q as writableReviewSchema, Qn as categoryNodeSchema, Qt as CreateCheckoutRequest, R as CreateReviewResult, Rn as paymentStatusSchema, Rt as MyClaim, S as AnalyticsEventName, Sn as cashReceiptTypeSchema, St as ConsentKind, T as analyticsClientEventNameSchema, Tn as createCheckoutRequestSchema, Tt as ConsentUpdateRequest, U as UpdateReviewResult, Un as shippingAddressInputSchema, Ut as createClaimResultSchema, V as ReviewSummary, Vn as residentNumberLike, Vt as claimTypeSchema, W as WritableReview, Wn as startPaymentRequestSchema, Wt as myClaimSchema, X as updateReviewRequestSchema, Xn as ProductSearchParams, Xt as CheckoutDelivery, Y as reviewSummarySchema, Yn as ProductPage, Yt as CashReceiptType, Z as updateReviewResultSchema, Zn as ProductSort, Zt as CheckoutSession, _ as ANALYTICS_VISITOR_COOKIE, _n as StartPaymentRequest, _r as cartItemSchema, _t as CustomerInquiryCategory, a as MyOrderItem, an as PAYMENT_RESULT_VALUES, ar as OrderItemStatus, at as memberAddressSchema, b as AnalyticsClientEvent, bn as cashReceiptIdentityTypeOf, br as analyticsIdsFromCookie, bt as customerInquirySchema, c as deliveryTrackingSchema, cn as PaymentMessage, cr as claimStatusSchema, ct as wishlistAddResultSchema, d as orderShippingAddressSchema, dn as PaymentStart, dr as pageSchema, dt as PublicInquiry, en as DeliveryQuoteResult, er as productDetailSchema, et as MemberAddress, f as purchaseDecisionResultSchema, fn as PaymentStatus, fr as AddCartItemRequest, ft as createInquiryRequestSchema, g as ANALYTICS_SESSION_HEADER, gn as ShippingAddressInput, gr as addCartItemRequestSchema, gt as CustomerInquiry, h as ANALYTICS_SESSION_COOKIE, hn as RetryPaymentRequest, hr as UpdateCartItemRequest, ht as CreateCustomerInquiryRequest, i as MyOrder, in as KnownPaymentStatus, ir as ClaimStatus, it as memberAddressRequestSchema, j as createStorefrontClient, jn as paymentFailureCategorySchema, jt as consentUpdateRequestSchema, k as StorefrontClient, kn as easyPayProviderSchema, kt as consentSourceSchema, l as myOrderItemSchema, ln as PaymentMethod, lr as orderItemStatusSchema, lt as CreateInquiryRequest, m as ANALYTICS_MAX_BATCH_BYTES, mn as RemoteArea, mr as CartItem, mt as publicInquirySchema, n as storefrontStoreSchema, nn as GuestInfo, nr as productPageSchema, nt as UpdateProfileRequest, o as OrderShippingAddress, on as PAYMENT_STATUS_VALUES, or as PageInfo, ot as memberSchema, p as trackingStageResponseSchema, pn as PgProvider, pr as Cart, pt as createInquiryResultSchema, q as publicReviewSchema, qn as ProductDetail, qt as CashReceiptIdentityType, r as DeliveryTracking, rn as KnownPaymentResult, rr as productSortSchema, rt as WishlistAddResult, s as PurchaseDecisionResult, sn as PaymentFailureCategory, sr as PageParams, st as updateProfileRequestSchema, t as StorefrontStore, tn as EasyPayProvider, tr as productFacetsSchema, tt as MemberAddressRequest, u as myOrderSchema, un as PaymentOption, ur as pageInfoSchema, ut as CreateInquiryResult, v as ANALYTICS_VISITOR_HEADER, vn as availablePaymentOptionSchema, vr as cartSchema, vt as createCustomerInquiryRequestSchema, w as analyticsBatchSchema, wn as checkoutSessionSchema, wt as ConsentState, x as AnalyticsClientEventName, xn as cashReceiptRequestSchema, xt as ConsentAction, y as AnalyticsBatch, yn as cashReceiptAvailable, yr as updateCartItemRequestSchema, yt as customerInquiryCategorySchema, z as PublicReview, zn as pgProviderSchema, zt as claimReasonSchema } from "./index-OqvbJ6Xi.mjs";
+export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, AddCartItemRequest, AnalyticsBatch, AnalyticsClientEvent, AnalyticsClientEventName, AnalyticsEventName, AnalyticsServerEventName, AnonymousSession, ApiError, AvailablePaymentOption, CASH_RECEIPT_METHODS, Cart, CartItem, CashReceiptIdentityType, CashReceiptRequest, CashReceiptType, CategoryNode, CheckoutDelivery, CheckoutSession, ClaimReason, ClaimReturnAddress, ClaimStatus, ClaimType, ConsentAction, ConsentKind, ConsentSource, ConsentState, ConsentUpdateRequest, CreateCheckoutRequest, CreateClaimRequest, CreateClaimResult, CreateCustomerInquiryRequest, CreateInquiryRequest, CreateInquiryResult, CreateReviewRequest, CreateReviewResult, CustomerInquiry, CustomerInquiryCategory, DeliveryQuoteRequest, DeliveryQuoteResult, DeliveryTracking, EasyPayProvider, GuestInfo, IdpAgreements, IdpAuthorizeRequest, IdpTokenRequest, KnownPaymentResult, KnownPaymentStatus, LinkIdentityRequest, LoginRequest, Member, MemberAddress, MemberAddressRequest, MemberConsents, MemberIdentities, MyClaim, MyOrder, MyOrderItem, OrderItemStatus, OrderShippingAddress, PAYMENT_RESULT_VALUES, PAYMENT_STATUS_VALUES, PageInfo, PageParams, PaymentFailureCategory, PaymentMessage, PaymentMethod, PaymentOption, PaymentStart, PaymentStatus, PgProvider, ProductCard, ProductDetail, ProductFacets, ProductPage, ProductSearchParams, ProductSort, PublicInquiry, PublicReview, PurchaseDecisionResult, type Query, RemoteArea, RetryPaymentRequest, ReviewPage, ReviewSummary, STOREFRONT_SESSION_KEYS, type SessionStorage, ShippingAddressInput, SignupRequest, SocialProvider, StartPaymentRequest, type StorefrontClient, type StorefrontClientOptions, type StorefrontSession, type StorefrontSessionOptions, StorefrontStore, TokenPair, type TokenSource, UpdateCartItemRequest, UpdateProfileRequest, UpdateReviewRequest, UpdateReviewResult, WishlistAddResult, WithdrawRequest, WithdrawalBlockedDetails, WritableReview, addCartItemRequestSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, availablePaymentOptionSchema, buildQuery, cartItemSchema, cartSchema, cashReceiptAvailable, cashReceiptIdentityTypeOf, cashReceiptRequestSchema, cashReceiptTypeSchema, categoryNodeSchema, checkoutDeliverySchema, checkoutSessionSchema, claimReasonSchema, claimReturnAddressSchema, claimStatusSchema, claimTypeSchema, consentActionSchema, consentKindSchema, consentSourceSchema, consentStateSchema, consentUpdateRequestSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createInquiryResultSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customerInquiryCategorySchema, customerInquirySchema, deliveryQuoteRequestSchema, deliveryQuoteSchema, deliveryTrackingSchema, easyPayProviderResponseSchema, easyPayProviderSchema, guestInfoSchema, idpAgreementsSchema, idpAuthorizeRequestSchema, idpAuthorizeResponseSchema, idpTokenRequestSchema, linkIdentityRequestSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberConsentsSchema, memberIdentitiesSchema, memberSchema, myClaimSchema, myOrderItemSchema, myOrderSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentFailureCategorySchema, paymentMessageSchema, paymentMethodSchema, paymentOptionKey, paymentOptionListSchema, paymentOptionSchema, paymentStartSchema, paymentStatusSchema, pgProviderSchema, productCardSchema, productDetailSchema, productFacetsSchema, productPageSchema, productSortSchema, publicInquirySchema, publicReviewSchema, purchaseDecisionResultSchema, remoteAreaSchema, residentNumberLike, retryPaymentRequestSchema, reviewPageSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, socialProviderSchema, startPaymentRequestSchema, storefrontStoreSchema, tokenPairSchema, trackingStageResponseSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, updateReviewResultSchema, wishlistAddResultSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 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 signupRequestSchema, A as createClaimResultSchema, B as pageInfoSchema, C as publicInquirySchema, D as claimReasonSchema, E as customerInquirySchema, F as productFacetsSchema, G as updateCartItemRequestSchema, H as addCartItemRequestSchema, I as productPageSchema, J as idpAuthorizeResponseSchema, K as anonymousSessionSchema, L as productSortSchema, M as categoryNodeSchema, N as productCardSchema, O as claimTypeSchema, P as productDetailSchema, Q as memberIdentitiesSchema, R as claimStatusSchema, S as createInquiryResultSchema, T as customerInquiryCategorySchema, U as cartItemSchema, V as pageSchema, W as cartSchema, X as linkIdentityRequestSchema, Y as idpTokenRequestSchema, Z as loginRequestSchema, _ as memberAddressSchema, a as publicReviewSchema, at as buildQuery, b as wishlistAddResultSchema, c as updateReviewRequestSchema, d as deliveryTrackingSchema, et as socialProviderSchema, f as myOrderItemSchema, g as memberAddressRequestSchema, h as purchaseDecisionResultSchema, i as createReviewResultSchema, it as ApiError, j as myClaimSchema, k as createClaimRequestSchema, l as updateReviewResultSchema, m as orderShippingAddressSchema, n as storefrontStoreSchema, nt as withdrawRequestSchema, o as reviewPageSchema, ot as toApiError, p as myOrderSchema, q as idpAuthorizeRequestSchema, r as createReviewRequestSchema, rt as withdrawalBlockedDetailsSchema, s as reviewSummarySchema, st as unwrapData, t as createStorefrontClient, tt as tokenPairSchema, u as writableReviewSchema, v as memberSchema, w as createCustomerInquiryRequestSchema, x as createInquiryRequestSchema, y as updateProfileRequestSchema, z as orderItemStatusSchema } from "./client-D9iQIWnV.mjs";
-import { _ as pgProviderSchema, a as createCheckoutRequestSchema, b as startPaymentRequestSchema, c as guestInfoSchema, d as paymentMethodSchema, f as paymentOptionKey, g as paymentStatusSchema, h as paymentStartSchema, i as checkoutSessionSchema, l as paymentFailureCategorySchema, m as paymentOptionSchema, n as PAYMENT_STATUS_VALUES, o as easyPayProviderResponseSchema, p as paymentOptionListSchema, r as availablePaymentOptionSchema, s as easyPayProviderSchema, t as PAYMENT_RESULT_VALUES, u as paymentMessageSchema, v as retryPaymentRequestSchema, y as shippingAddressInputSchema } from "./checkout-JFk3b8RG.mjs";
+import { $ as updateCartItemRequestSchema, A as consentSourceSchema, B as categoryNodeSchema, C as createInquiryResultSchema, D as customerInquirySchema, E as customerInquiryCategorySchema, F as claimReturnAddressSchema, G as productSortSchema, H as productDetailSchema, I as claimTypeSchema, J as pageInfoSchema, K as claimStatusSchema, L as createClaimRequestSchema, M as consentUpdateRequestSchema, N as memberConsentsSchema, O as consentActionSchema, P as claimReasonSchema, Q as cartSchema, R as createClaimResultSchema, S as createInquiryRequestSchema, T as createCustomerInquiryRequestSchema, U as productFacetsSchema, V as productCardSchema, W as productPageSchema, X as addCartItemRequestSchema, Y as pageSchema, Z as cartItemSchema, _ as memberAddressRequestSchema, a as publicReviewSchema, at as linkIdentityRequestSchema, b as updateProfileRequestSchema, c as updateReviewRequestSchema, ct as signupRequestSchema, d as deliveryTrackingSchema, dt as withdrawRequestSchema, et as anonymousSessionSchema, f as myOrderItemSchema, ft as withdrawalBlockedDetailsSchema, g as trackingStageResponseSchema, gt as unwrapData, h as purchaseDecisionResultSchema, ht as toApiError, i as createReviewResultSchema, it as idpTokenRequestSchema, j as consentStateSchema, k as consentKindSchema, l as updateReviewResultSchema, lt as socialProviderSchema, m as orderShippingAddressSchema, mt as buildQuery, n as storefrontStoreSchema, nt as idpAuthorizeRequestSchema, o as reviewPageSchema, ot as loginRequestSchema, p as myOrderSchema, pt as ApiError, q as orderItemStatusSchema, r as createReviewRequestSchema, rt as idpAuthorizeResponseSchema, s as reviewSummarySchema, st as memberIdentitiesSchema, t as createStorefrontClient, tt as idpAgreementsSchema, u as writableReviewSchema, ut as tokenPairSchema, v as memberAddressSchema, w as publicInquirySchema, x as wishlistAddResultSchema, y as memberSchema, z as myClaimSchema } from "./client-CHfCafer.mjs";
+import { A as startPaymentRequestSchema, C as paymentStartSchema, D as residentNumberLike, E as remoteAreaSchema, O as retryPaymentRequestSchema, S as paymentOptionSchema, T as pgProviderSchema, _ as paymentFailureCategorySchema, a as cashReceiptAvailable, b as paymentOptionKey, c as cashReceiptTypeSchema, d as createCheckoutRequestSchema, f as deliveryQuoteRequestSchema, g as guestInfoSchema, h as easyPayProviderSchema, i as availablePaymentOptionSchema, k as shippingAddressInputSchema, l as checkoutDeliverySchema, m as easyPayProviderResponseSchema, n as PAYMENT_RESULT_VALUES, o as cashReceiptIdentityTypeOf, p as deliveryQuoteSchema, r as PAYMENT_STATUS_VALUES, s as cashReceiptRequestSchema, t as CASH_RECEIPT_METHODS, u as checkoutSessionSchema, v as paymentMessageSchema, w as paymentStatusSchema, x as paymentOptionListSchema, y as paymentMethodSchema } from "./checkout-CHpxo2Ap.mjs";
 //#region src/session.ts
 /** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */
 const STOREFRONT_SESSION_KEYS = {
@@ -125,4 +125,4 @@ function createStorefrontSession(options) {
 	};
 }
 //#endregion
-export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, ApiError, PAYMENT_RESULT_VALUES, PAYMENT_STATUS_VALUES, STOREFRONT_SESSION_KEYS, addCartItemRequestSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, availablePaymentOptionSchema, buildQuery, cartItemSchema, cartSchema, categoryNodeSchema, checkoutSessionSchema, claimReasonSchema, claimStatusSchema, claimTypeSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createInquiryResultSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customerInquiryCategorySchema, customerInquirySchema, deliveryTrackingSchema, easyPayProviderResponseSchema, easyPayProviderSchema, guestInfoSchema, idpAuthorizeRequestSchema, idpAuthorizeResponseSchema, idpTokenRequestSchema, linkIdentityRequestSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberIdentitiesSchema, memberSchema, myClaimSchema, myOrderItemSchema, myOrderSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentFailureCategorySchema, paymentMessageSchema, paymentMethodSchema, paymentOptionKey, paymentOptionListSchema, paymentOptionSchema, paymentStartSchema, paymentStatusSchema, pgProviderSchema, productCardSchema, productDetailSchema, productFacetsSchema, productPageSchema, productSortSchema, publicInquirySchema, publicReviewSchema, purchaseDecisionResultSchema, retryPaymentRequestSchema, reviewPageSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, socialProviderSchema, startPaymentRequestSchema, storefrontStoreSchema, tokenPairSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, updateReviewResultSchema, wishlistAddResultSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };
+export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, ApiError, CASH_RECEIPT_METHODS, PAYMENT_RESULT_VALUES, PAYMENT_STATUS_VALUES, STOREFRONT_SESSION_KEYS, addCartItemRequestSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, availablePaymentOptionSchema, buildQuery, cartItemSchema, cartSchema, cashReceiptAvailable, cashReceiptIdentityTypeOf, cashReceiptRequestSchema, cashReceiptTypeSchema, categoryNodeSchema, checkoutDeliverySchema, checkoutSessionSchema, claimReasonSchema, claimReturnAddressSchema, claimStatusSchema, claimTypeSchema, consentActionSchema, consentKindSchema, consentSourceSchema, consentStateSchema, consentUpdateRequestSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createInquiryResultSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customerInquiryCategorySchema, customerInquirySchema, deliveryQuoteRequestSchema, deliveryQuoteSchema, deliveryTrackingSchema, easyPayProviderResponseSchema, easyPayProviderSchema, guestInfoSchema, idpAgreementsSchema, idpAuthorizeRequestSchema, idpAuthorizeResponseSchema, idpTokenRequestSchema, linkIdentityRequestSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberConsentsSchema, memberIdentitiesSchema, memberSchema, myClaimSchema, myOrderItemSchema, myOrderSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentFailureCategorySchema, paymentMessageSchema, paymentMethodSchema, paymentOptionKey, paymentOptionListSchema, paymentOptionSchema, paymentStartSchema, paymentStatusSchema, pgProviderSchema, productCardSchema, productDetailSchema, productFacetsSchema, productPageSchema, productSortSchema, publicInquirySchema, publicReviewSchema, purchaseDecisionResultSchema, remoteAreaSchema, residentNumberLike, retryPaymentRequestSchema, reviewPageSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, socialProviderSchema, startPaymentRequestSchema, storefrontStoreSchema, tokenPairSchema, trackingStageResponseSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, updateReviewResultSchema, wishlistAddResultSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };

package/dist/payments/index.d.mts

@@ -1,4 +1,4 @@
-import { A as createStorefrontClient, Ht as PaymentOption, Pt as GuestInfo, Ut as PaymentStart, Wt as PaymentStatus, qt as ShippingAddressInput } from "../index-DvHOQm2-.mjs";
+import { Jt as CashReceiptRequest, dn as PaymentStart, fn as PaymentStatus, gn as ShippingAddressInput, j as createStorefrontClient, nn as GuestInfo, un as PaymentOption } from "../index-OqvbJ6Xi.mjs";
 //#region src/payments/index.d.ts
 /**
  * 스토어프론트 결제 — 브라우저 전용(`@sayren/storefront-sdk/payments`).
@@ -109,6 +109,8 @@ export interface StartOptions {
   option: PaymentOption;
   shippingAddress: ShippingAddressInput;
   guest?: GuestInfo;
+  /** 현금영수증 신청 — 계좌이체·가상계좌 옵션에서만 보낸다 */
+  cashReceipt?: CashReceiptRequest;
   returnUrl?: string;
   mode?: PaymentMode;
   /** 클릭 시점에 {@link Payments.prepareWindow}로 미리 연 창. 폼 검증이 비동기라 클릭 태스크를 넘길 때 쓴다 */
@@ -118,6 +120,8 @@ export interface RetryOptions {
   option: PaymentOption;
   /** 생략하면 결제 시작 때의 복귀 주소를 쓴다 */
   returnUrl?: string;
+  /** 현금영수증 신청을 바꾼다. 생략하면 결제 시작 때의 신청을 그대로 둔다 */
+  cashReceipt?: CashReceiptRequest;
   mode?: PaymentMode;
   /** 클릭 시점에 {@link Payments.prepareWindow}로 미리 연 창 */
   window?: PreparedPaymentWindow;

package/dist/payments/index.mjs

@@ -1,4 +1,4 @@
-import { u as paymentMessageSchema } from "../checkout-JFk3b8RG.mjs";
+import { v as paymentMessageSchema } from "../checkout-CHpxo2Ap.mjs";
 //#region src/payments/index.ts
 /** 복귀 주소에 결제 서비스가 붙이는 쿼리 */
 const RETURN_PAYMENT_ID = "sayrenPaymentId";
@@ -288,6 +288,7 @@ function createPayments(options) {
 				option: startOptions.option,
 				shippingAddress: startOptions.shippingAddress,
 				guest: startOptions.guest,
+				...startOptions.cashReceipt ? { cashReceipt: startOptions.cashReceipt } : {},
 				returnUrl
 			}));
 		},
@@ -297,7 +298,8 @@ function createPayments(options) {
 			warnReturnOrigin(returnUrl, prepared.mode);
 			return startWith(prepared, () => client.payments.retry(paymentId, {
 				option: retryOptions.option,
-				returnUrl
+				returnUrl,
+				...retryOptions.cashReceipt ? { cashReceipt: retryOptions.cashReceipt } : {}
 			}));
 		},
 		getStatus: (paymentId) => client.payments.getStatus(paymentId),

package/package.json

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

package/src/auth/index.ts

@@ -120,21 +120,36 @@ export function createStorefrontAuth(options: StorefrontAuthOptions) {
     /**
      * 소셜 로그인 시작 — PKCE(S256)와 state를 만들고 공급자 로그인 주소를 받는다. 반환한 `state`·`codeVerifier`를
      * 서버 세션에 보관하고 구매자를 `url`로 보낸다. 로그인을 마치면 `redirectUri`로 `?code=&state=`가 붙어 돌아온다.
-     * `redirectUri`는 스토어프론트 도메인 목록 안이어야 한다
+     * `redirectUri`는 스토어프론트 도메인 목록 안이어야 한다.
+     *
+     * 가입 화면에서 받은 약관 동의는 `agreements`로 함께 보낸다. **이 로그인으로 가입이 되는 경우에만** 이력에
+     * 남고(기존 회원의 로그인이면 무시한다), 보내지 않으면 가입은 되지만 필수 동의 이력이 없어
+     * `GET /me`의 `reconsentRequired`가 true다(첫 진입에서 `updateConsents()`로 받는다)
      */
-    async idp(provider: SocialProvider, options: { redirectUri: string }): Promise<IdpStart> {
+    async idp(
+      provider: SocialProvider,
+      options: {
+        redirectUri: string;
+        agreements?: { terms: true; privacy: true; marketing?: boolean };
+      },
+    ): Promise<IdpStart> {
       const state = randomToken(24);
       const codeVerifier = randomToken(32);
       const { url } = await client().auth.idpAuthorize(provider, {
         redirectUri: options.redirectUri,
         codeChallenge: await s256(codeVerifier),
         state,
+        agreements: options.agreements && {
+          terms: true,
+          privacy: true,
+          marketing: options.agreements.marketing ?? false,
+        },
       });
       return { url, state, codeVerifier };
     },
     /**
      * 소셜 로그인 마무리 — 돌아온 `code`를 구매자 토큰으로 바꾼다. state가 다르거나 구매자가 취소했으면
-     * `IdpCallbackError`. code는 1회용이고 1분 안에 바꿔야 한다
+     * `IdpCallbackError`. code는 1회용이고 1분 안에 바꿔야 한다. 약관 동의는 `idp()`에서 받는다
      */
     idpCallback(input: IdpCallbackInput & { error?: string | null }): Promise<TokenPair> {
       if (input.error) return Promise.reject(new IdpCallbackError(input.error));

package/src/client.ts

@@ -37,6 +37,9 @@ import {
   type CreateCheckoutRequest,
   checkoutSessionSchema,
   createCheckoutRequestSchema,
+  type DeliveryQuoteRequest,
+  deliveryQuoteRequestSchema,
+  deliveryQuoteSchema,
   paymentStartSchema,
   paymentStatusSchema,
   type RetryPaymentRequest,
@@ -56,6 +59,11 @@ import {
   type PageParams,
   pageSchema,
 } from "./schemas/common";
+import {
+  type ConsentUpdateRequest,
+  consentUpdateRequestSchema,
+  memberConsentsSchema,
+} from "./schemas/consent";
 import {
   type CreateCustomerInquiryRequest,
   type CustomerInquiryCategory,
@@ -271,6 +279,19 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
         http.request("POST", "/checkout", checkoutSessionSchema, {
           body: createCheckoutRequestSchema.parse(body),
         }),
+      /**
+       * `POST /checkout/{checkoutId}/delivery-quote` — 배송비 미리보기. 배송지 우편번호로 배송비를 다시 계산한다.
+       *
+       * 주문서를 만들 때는 배송지를 모르므로 제주·도서산간 추가 배송비가 빠져 있다. 구매자가 배송지를 입력하거나
+       * 고칠 때 이 메서드로 금액을 갱신하면 결제 직전에 금액이 바뀌는 일을 피할 수 있다. 주문서를 바꾸지 않는
+       * 읽기 계산이고, **최종 금액은 결제 시작 응답의 `amounts`다.**
+       *
+       * 에러(`ApiError.code`): 404 `CHECKOUT_NOT_FOUND`, 409 `CHECKOUT_EXPIRED`, 409 `ALREADY_PAID`
+       */
+      quoteDelivery: (checkoutId: string, body: DeliveryQuoteRequest) =>
+        http.request("POST", path`/checkout/${checkoutId}/delivery-quote`, deliveryQuoteSchema, {
+          body: deliveryQuoteRequestSchema.parse(body),
+        }),
       /**
        * `POST /checkout/{checkoutId}/payment` — 결제 시작. 배송지와 결제 옵션(`paymentOptions` 항목 또는 직접 쓴 옵션)으로
        * 결제 세션·첫 시도를 만들고 결제 서비스 주소(`payUrl`)를 돌려준다. 그 주소를 열어 결제를 진행하는 것은
@@ -335,6 +356,13 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
       me: () => http.request("GET", "/me", memberSchema),
       updateMe: (body: UpdateProfileRequest) =>
         http.requestVoid("PATCH", "/me", { body: updateProfileRequestSchema.parse(body) }),
+      /** 약관·개인정보·마케팅 동의의 현재 상태와 재동의 필요 여부 */
+      consents: () => http.request("GET", "/me/consents", memberConsentsSchema),
+      /** 재동의·마케팅 동의 변경 — 바꾼 뒤의 상태를 돌려준다 */
+      updateConsents: (body: ConsentUpdateRequest) =>
+        http.request("POST", "/me/consents", memberConsentsSchema, {
+          body: consentUpdateRequestSchema.parse(body),
+        }),
       listAddresses: () => http.request("GET", "/me/addresses", z.array(memberAddressSchema)),
       createAddress: (body: MemberAddressRequest) =>
         http.requestVoid("POST", "/me/addresses", { body: memberAddressRequestSchema.parse(body) }),

package/src/index.ts

@@ -10,6 +10,7 @@ export * from "./schemas/catalog";
 export * from "./schemas/checkout";
 export * from "./schemas/claim";
 export * from "./schemas/common";
+export * from "./schemas/consent";
 export * from "./schemas/customer-inquiry";
 export * from "./schemas/inquiry";
 export * from "./schemas/member";

package/src/payments/index.ts

@@ -1,5 +1,6 @@
 import type { createStorefrontClient } from "../client";
 import {
+  type CashReceiptRequest,
   type GuestInfo,
   type PaymentOption,
   type PaymentStart,
@@ -236,6 +237,8 @@ export interface StartOptions {
   option: PaymentOption;
   shippingAddress: ShippingAddressInput;
   guest?: GuestInfo;
+  /** 현금영수증 신청 — 계좌이체·가상계좌 옵션에서만 보낸다 */
+  cashReceipt?: CashReceiptRequest;
   returnUrl?: string;
   mode?: PaymentMode;
   /** 클릭 시점에 {@link Payments.prepareWindow}로 미리 연 창. 폼 검증이 비동기라 클릭 태스크를 넘길 때 쓴다 */
@@ -246,6 +249,8 @@ export interface RetryOptions {
   option: PaymentOption;
   /** 생략하면 결제 시작 때의 복귀 주소를 쓴다 */
   returnUrl?: string;
+  /** 현금영수증 신청을 바꾼다. 생략하면 결제 시작 때의 신청을 그대로 둔다 */
+  cashReceipt?: CashReceiptRequest;
   mode?: PaymentMode;
   /** 클릭 시점에 {@link Payments.prepareWindow}로 미리 연 창 */
   window?: PreparedPaymentWindow;
@@ -521,6 +526,7 @@ export function createPayments(options: PaymentsOptions): Payments {
           option: startOptions.option,
           shippingAddress: startOptions.shippingAddress,
           guest: startOptions.guest,
+          ...(startOptions.cashReceipt ? { cashReceipt: startOptions.cashReceipt } : {}),
           returnUrl,
         }),
       );
@@ -531,7 +537,11 @@ export function createPayments(options: PaymentsOptions): Payments {
       const returnUrl = retryOptions.returnUrl ?? options.returnUrl;
       warnReturnOrigin(returnUrl, prepared.mode);
       return startWith(prepared, () =>
-        client.payments.retry(paymentId, { option: retryOptions.option, returnUrl }),
+        client.payments.retry(paymentId, {
+          option: retryOptions.option,
+          returnUrl,
+          ...(retryOptions.cashReceipt ? { cashReceipt: retryOptions.cashReceipt } : {}),
+        }),
       );
     },
 

package/src/schemas/auth.ts

@@ -86,6 +86,20 @@ export type WithdrawalBlockedDetails = z.infer<typeof withdrawalBlockedDetailsSc
 export const socialProviderSchema = z.enum(["kakao", "naver", "google"]);
 export type SocialProvider = z.infer<typeof socialProviderSchema>;
 
+/**
+ * 소셜 가입 화면에서 받은 필수·선택 동의 — 공급자로 보내기 전에 함께 보낸다.
+ *
+ * **이 흐름으로 회원이 처음 만들어질 때만 쓴다.** 이미 있는 회원의 로그인이면 무시한다(동의는 늘어나지 않는다).
+ * 보내지 않으면 필수 동의 이력이 남지 않아 `GET /me`의 `reconsentRequired`가 true가 되고,
+ * 스토어프론트가 첫 진입에서 `POST /me/consents`로 받는다(가입 자체는 거부하지 않는다).
+ */
+export const idpAgreementsSchema = z.object({
+  terms: z.literal(true),
+  privacy: z.literal(true),
+  marketing: z.boolean().default(false),
+});
+export type IdpAgreements = z.infer<typeof idpAgreementsSchema>;
+
 /** `POST /auth/idp/{provider}/authorize` 본문 — PKCE(S256)와 state는 SDK가 만든다 */
 export const idpAuthorizeRequestSchema = z.object({
   /** 로그인을 마치고 돌아올 스토어프론트 주소. 스토어프론트 도메인 목록 안이어야 한다 */
@@ -94,6 +108,8 @@ export const idpAuthorizeRequestSchema = z.object({
   codeChallenge: z.string().regex(/^[A-Za-z0-9_-]{43}$/),
   /** 스토어프론트가 만든 값 — 돌아올 때 그대로 붙어 온다. 세션에 저장해 두고 비교한다 */
   state: z.string().min(16).max(128),
+  /** 가입이 되는 경우 남길 동의. 기존 회원 로그인이면 무시한다 */
+  agreements: idpAgreementsSchema.optional(),
 });
 export type IdpAuthorizeRequest = z.infer<typeof idpAuthorizeRequestSchema>;
 

package/src/schemas/checkout.ts

@@ -17,6 +17,44 @@ export const createCheckoutRequestSchema = z
 
 export type CreateCheckoutRequest = z.infer<typeof createCheckoutRequestSchema>;
 
+/** 지역 추가 배송비 구분 — 우편번호로 판정한다 */
+export const remoteAreaSchema = z.enum(["NONE", "JEJU", "ISOLATED"]);
+
+export type RemoteArea = z.infer<typeof remoteAreaSchema>;
+
+/**
+ * 배송비 내역 (이슈 #29) — 배송비를 **몇 번, 왜** 부과했는지다.
+ *
+ * 배송비는 **배송 묶음**마다 붙는다. 같은 출고지 + 같은 배송 정책인 상품은 한 묶음이고 한 번만 낸다.
+ * 제주·도서산간 추가 배송비는 묶음마다 더하고, 무료배송이어도 붙는다.
+ *
+ * 주문서를 만들 때는 배송지를 모르므로 `zipCode`가 null이고 `remoteSurcharge`가 0이다.
+ * 배송지를 입력하면 `POST /storefront/v1/checkout/{checkoutId}/delivery-quote`로 다시 받고,
+ * **결제 시작이 보낸 배송지로 최종 확정한다** — 그래서 주문서 조회 금액과 실제 결제 금액이 다를 수 있다.
+ */
+export const checkoutDeliverySchema = z.object({
+  baseFee: z.number().int().describe("기본 배송비 합계. 묶음마다 부과한 금액의 합이다"),
+  remoteSurcharge: z
+    .number()
+    .int()
+    .describe("제주·도서산간 추가 배송비 합계. 묶음마다 붙는다. 배송지를 모르면 0"),
+  remoteArea: remoteAreaSchema.describe("배송지 지역 구분. 배송지를 모르면 NONE"),
+  remoteAreaLabel: z
+    .string()
+    .nullable()
+    .describe("지역 안내 이름(예: 제주특별자치도). 추가 배송비 지역이 아니면 null"),
+  bundleCount: z.number().int().describe("배송 묶음 수 — 배송비를 부과한 횟수다"),
+  freeByThreshold: z
+    .boolean()
+    .describe("스토어 전체 무료배송 기준액을 넘겨 기본 배송비를 면제했는가"),
+  zipCode: z
+    .string()
+    .nullable()
+    .describe("이 금액에 반영한 배송지 우편번호. null이면 배송지 미반영(추가 배송비 0)이다"),
+});
+
+export type CheckoutDelivery = z.infer<typeof checkoutDeliverySchema>;
+
 export const checkoutSessionSchema = z.object({
   checkoutId: z.string(),
   items: z.array(
@@ -36,6 +74,9 @@ export const checkoutSessionSchema = z.object({
     deliveryFee: z.number().int(),
     totalAmount: z.number().int(),
   }),
+  delivery: checkoutDeliverySchema.describe(
+    "배송비 내역. 배송지를 입력하면 금액이 바뀔 수 있다 — 최종 금액은 결제 시작 응답의 `amounts`다",
+  ),
   expiresAt: z.string(),
   paymentOptions: z
     .lazy(() => paymentOptionListSchema)
@@ -51,6 +92,28 @@ export const checkoutSessionSchema = z.object({
 
 export type CheckoutSession = z.infer<typeof checkoutSessionSchema>;
 
+/**
+ * 배송비 미리보기 요청 — 배송지 우편번호로 배송비를 다시 계산한다. 주문서를 바꾸지 않는다(읽기 계산이다).
+ *
+ * 구매자가 배송지를 입력하거나 고칠 때 부르면 제주·도서산간 추가 배송비가 반영된 금액을 미리 보여 줄 수 있다.
+ */
+export const deliveryQuoteRequestSchema = z.object({
+  zipCode: z
+    .string()
+    .regex(/^[0-9]{5}$/, "우편번호 5자리를 입력해 주세요")
+    .describe("배송지 우편번호 5자리"),
+});
+
+export type DeliveryQuoteRequest = z.infer<typeof deliveryQuoteRequestSchema>;
+
+/** 배송비 미리보기 응답 — 이 배송지로 결제하면 나갈 금액이다 */
+export const deliveryQuoteSchema = z.object({
+  amounts: checkoutSessionSchema.shape.amounts.describe("이 배송지 기준 금액"),
+  delivery: checkoutDeliverySchema,
+});
+
+export type DeliveryQuoteResult = z.infer<typeof deliveryQuoteSchema>;
+
 export const paymentMethodSchema = z.enum([
   "CARD",
   "BANK_TRANSFER",
@@ -147,6 +210,122 @@ export const guestInfoSchema = z.object({
 
 export type GuestInfo = z.infer<typeof guestInfoSchema>;
 
+/** 현금영수증을 신청할 수 있는 결제수단 — 계좌이체·가상계좌 */
+export const CASH_RECEIPT_METHODS = ["BANK_TRANSFER", "VIRTUAL_ACCOUNT"] as const;
+
+/** 이 결제수단으로 현금영수증을 신청할 수 있는가 */
+export function cashReceiptAvailable(method: string): boolean {
+  return (CASH_RECEIPT_METHODS as readonly string[]).includes(method);
+}
+
+/** 현금영수증 용도 — `INCOME_DEDUCTION` 소득공제(개인) · `EXPENSE_PROOF` 지출증빙(사업자) */
+export const cashReceiptTypeSchema = z.enum(["INCOME_DEDUCTION", "EXPENSE_PROOF"]);
+export type CashReceiptType = z.infer<typeof cashReceiptTypeSchema>;
+
+/** 현금영수증 식별 번호 종류 — 휴대폰 번호 · 현금영수증카드 번호 · 사업자등록번호 */
+export type CashReceiptIdentityType = "PHONE" | "CARD" | "BUSINESS";
+
+/**
+ * 주민등록번호·외국인등록번호 형식인가 — 현금영수증 식별 번호로는 받지 않는다.
+ *
+ * 현금영수증카드 번호의 아래 끝(13자리)이 주민등록번호 길이와 겹친다. 개인 식별 번호는 최소로 받는다는 원칙이라
+ * 주민등록번호로 읽히는 값은 카드 번호 자리로도 받지 않는다.
+ *
+ * **13자리 숫자 전부를 막지 않는다.** 13자리 현금영수증카드를 쓰는 구매자가 신청할 수 없게 되기 때문이다.
+ * 대신 주민등록번호 형식 — 생년월일 6자리(월 01~12, 일 01~31) + 성별·세기 코드(1~8, 5~8은 외국인등록번호) — 으로
+ * 판정해 오탐을 줄인다(13자리 숫자 중 이 형식에 걸리는 비율은 약 3%다).
+ *
+ * 검증번호(뒤 1자리 mod 11)까지는 보지 않는다. 한 자리 오타가 난 주민등록번호도 생년월일을 담고 있어 막아야 하고,
+ * 2020년 10월 이후 발급된 외국인등록번호에는 검증번호 규칙이 없다.
+ *
+ * `cashReceiptIdentityTypeOf`와 같이 하이픈·공백은 빼고 판정한다.
+ */
+export function residentNumberLike(identityNumber: string): boolean {
+  const digits = identityNumber.replace(/[\s-]/g, "");
+  if (!/^[0-9]{13}$/.test(digits)) return false;
+  const month = Number(digits.slice(2, 4));
+  const day = Number(digits.slice(4, 6));
+  const genderCode = Number(digits[6]);
+  return month >= 1 && month <= 12 && day >= 1 && day <= 31 && genderCode >= 1 && genderCode <= 8;
+}
+
+/**
+ * 식별 번호 → 종류. 하이픈·공백은 빼고 판정한다. 용도에 맞지 않는 번호면 null이다.
+ * - 소득공제: 휴대폰 번호(01로 시작하는 10~11자리) 또는 현금영수증카드 번호(13~19자리)
+ * - 지출증빙: 사업자등록번호(10자리) 또는 현금영수증카드 번호(13~19자리)
+ *
+ * 자릿수 근거. PG 문서는 식별 번호의 최대 길이만 정하고 종류별 자릿수는 정하지 않는다
+ * (토스페이먼츠 `customerIdentityNumber` "최대 길이는 30자", 소득공제는 휴대폰 번호·현금영수증카드 번호,
+ * 지출증빙은 사업자등록번호: https://docs.tosspayments.com/common/apis/cash-receipt /
+ * 포트원 V2는 종류만 PHONE·CARD·BUSINESS로 나눈다: https://developers.portone.io/api/rest-v2/payment.cashReceipt).
+ * 그래서 자릿수는 국세청이 정하는 발급수단 규격을 따른다 — 홈택스 소비자 발급수단 등록의 카드 번호는
+ * 13~19자리 숫자이고(https://thisthatbase.com/cash-receipts-card-registration/ 가 옮긴 홈택스 안내,
+ * 원본은 https://www.hometax.go.kr/ 소비자 발급수단 관리), 사업자등록번호는 10자리, 휴대폰 번호는 01X + 7~8자리다.
+ * 국세청 자진발급 번호(010-000-1234)도 휴대폰 형식으로 통과한다.
+ */
+export function cashReceiptIdentityTypeOf(
+  type: CashReceiptType,
+  identityNumber: string,
+): CashReceiptIdentityType | null {
+  const digits = identityNumber.replace(/[\s-]/g, "");
+  if (!/^[0-9]+$/.test(digits)) return null;
+  if (residentNumberLike(digits)) return null;
+  if (/^[0-9]{13,19}$/.test(digits)) return "CARD";
+  if (type === "INCOME_DEDUCTION") return /^01[016789][0-9]{7,8}$/.test(digits) ? "PHONE" : null;
+  return /^[0-9]{10}$/.test(digits) ? "BUSINESS" : null;
+}
+
+/**
+ * 현금영수증 신청 — 계좌이체·가상계좌 결제에서만 보낼 수 있다. 결제가 승인되면 sayren이 결제한 PG로 발급하고,
+ * 환불하면 그만큼 취소한다. 식별 번호는 암호화해 저장하고 응답에는 가린 값만 나간다.
+ */
+export const cashReceiptRequestSchema = z
+  .object({
+    type: cashReceiptTypeSchema.describe(
+      "용도. `INCOME_DEDUCTION` 소득공제(개인) · `EXPENSE_PROOF` 지출증빙(사업자)",
+    ),
+    identityNumber: z
+      .string()
+      .max(30)
+      .describe(
+        "식별 번호. 소득공제는 휴대폰 번호(01X + 7~8자리) 또는 현금영수증카드 번호(13~19자리), 지출증빙은 " +
+          "사업자등록번호(10자리) 또는 현금영수증카드 번호(13~19자리). 하이픈은 빼고 읽는다. " +
+          "주민등록번호는 받지 않는다(`RESIDENT_NUMBER_NOT_ALLOWED`)",
+      ),
+  })
+  .superRefine((value, ctx) => {
+    // 주민등록번호는 단순 형식 오류와 가른다 — 구매자에게 다른 번호를 입력하라고 안내해야 하고,
+    // 셀러·개발자가 필드 오류 코드로 이 경로를 집계할 수 있어야 한다.
+    // 필드 오류 코드는 메시지 끝의 `(CODE)`에서 나온다(api `zod-validation.pipe.ts`의 `extractCode`).
+    if (residentNumberLike(value.identityNumber)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["identityNumber"],
+        message:
+          "주민등록번호는 현금영수증 식별 번호로 쓸 수 없어요. " +
+          "휴대폰 번호 또는 현금영수증카드 번호를 입력해주세요 (RESIDENT_NUMBER_NOT_ALLOWED)",
+      });
+      return;
+    }
+    if (!cashReceiptIdentityTypeOf(value.type, value.identityNumber)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["identityNumber"],
+        message:
+          value.type === "INCOME_DEDUCTION"
+            ? "휴대폰 번호 또는 현금영수증카드 번호를 입력해주세요"
+            : "사업자등록번호(10자리) 또는 현금영수증카드 번호를 입력해주세요",
+      });
+    }
+  });
+export type CashReceiptRequest = z.infer<typeof cashReceiptRequestSchema>;
+
+const cashReceiptField = cashReceiptRequestSchema
+  .optional()
+  .describe(
+    "현금영수증 신청. 계좌이체·가상계좌 옵션에서만 보낼 수 있다(그 밖의 옵션이면 400 `CASH_RECEIPT_NOT_AVAILABLE`). 결제가 승인되면 발급한다",
+  );
+
 /**
  * 결제 시작 — 배송지를 확정하고 고른 결제 옵션으로 결제 시도를 연다. 응답의 `payUrl`(결제 서비스)을 팝업(`mode=popup`)이나
  * 전체 페이지로 열면 결제 서비스가 PG 결제창을 띄우고 승인까지 한다. 리다이렉트 결제가 끝나면 구매자는 `returnUrl`로 돌아온다.
@@ -162,14 +341,20 @@ export const startPaymentRequestSchema = z.object({
     ),
   shippingAddress: shippingAddressInputSchema,
   guest: guestInfoSchema.optional(),
+  cashReceipt: cashReceiptField,
 });
 
 export type StartPaymentRequest = z.infer<typeof startPaymentRequestSchema>;
 
-/** 같은 결제에서 다른 결제 옵션으로 다시 시도. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 쓴다 */
+/**
+ * 같은 결제에서 다른 결제 옵션으로 다시 시도. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 쓴다.
+ * `cashReceipt`를 보내면 현금영수증 신청을 이 값으로 바꾸고, 생략하면 결제 시작 때의 신청을 그대로 둔다
+ * (승인된 결제수단이 계좌이체·가상계좌가 아니면 발급하지 않는다)
+ */
 export const retryPaymentRequestSchema = z.object({
   option: paymentOptionSchema,
   returnUrl: startPaymentRequestSchema.shape.returnUrl.optional(),
+  cashReceipt: cashReceiptField,
 });
 
 export type RetryPaymentRequest = z.infer<typeof retryPaymentRequestSchema>;
@@ -189,6 +374,12 @@ export const paymentStartSchema = z.object({
     .describe(
       "테스트 결제(샌드박스) 여부. true면 실제로 돈이 나가지 않는다 — 결제 화면에 테스트 결제 안내를 표시한다",
     ),
+  amounts: checkoutSessionSchema.shape.amounts.describe(
+    "**확정 결제 금액** — 보낸 배송지로 배송비를 다시 계산한 값이다. 주문서 조회 시점의 `amounts`와 다를 수 있다(제주·도서산간 추가 배송비)",
+  ),
+  delivery: checkoutDeliverySchema.describe(
+    "확정 배송비 내역. `zipCode`는 보낸 배송지의 우편번호다",
+  ),
 });
 
 export type PaymentStart = z.infer<typeof paymentStartSchema>;