@sayren/storefront-sdk 0.17.0 → 0.18.1

package/dist/analytics/index.d.mts

@@ -14,7 +14,7 @@ export type AnalyticsConsent = "granted" | "denied" | "pending";
 export interface AnalyticsOptions {
   /** 스토어프론트 API 베이스 — 예: `https://api.sayren.app/storefront/v1` */
   baseUrl: string;
-  /** 테넌트 스토어 코드 */
+  /** 테넌트 상점 코드 */
   storeCode: string;
   /** 동의 상태. 기본 `pending` — 셀러의 동의 배너가 `setConsent`로 바꾼다 */
   consent?: AnalyticsConsent;

package/dist/auth/index.d.mts

@@ -26,7 +26,7 @@ export declare class IdpCallbackError extends Error {
 export interface StorefrontAuthOptions {
   /** 예: https://api.sayren.app/storefront/v1 */
   baseUrl: string;
-  /** 테넌트 스토어 코드 — `X-Store-Code` 헤더로 보낸다 */
+  /** 테넌트 상점 코드 — `X-Store-Code` 헤더로 보낸다 */
   storeCode: string;
   fetch?: typeof globalThis.fetch;
 }
@@ -104,7 +104,7 @@ export declare function createStorefrontAuth(options: StorefrontAuthOptions): {
   signOut(accessToken: string): Promise<void>;
   /**
    * 구매자 탈퇴 — 계정·배송지·위시리스트·장바구니·적립금을 지우고 토큰을 모두 무효로 만든다. 되돌릴 수 없다.
-   * 주문·리뷰·문의 기록은 스토어가 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
+   * 주문·리뷰·문의 기록은 상점이 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
    * 409 `WITHDRAWAL_BLOCKED`(`error.details`: `WithdrawalBlockedDetails`)다. 앱은 성공 후 보관한 토큰을 지운다.
    */
   withdraw(accessToken: string, body: WithdrawRequest): Promise<void>;

package/dist/auth/index.mjs

@@ -1,4 +1,4 @@
-import { pt as ApiError, t as createStorefrontClient } from "../client-CBAgQuTc.mjs";
+import { pt as ApiError, t as createStorefrontClient } from "../client-C91Y801B.mjs";
 //#region src/auth/index.ts
 /** 소셜 로그인 실패 — 구매자가 취소했거나(`access_denied`) state가 맞지 않는다 */
 var IdpCallbackError = class extends Error {
@@ -156,7 +156,7 @@ function createStorefrontAuth(options) {
 		},
 		/**
 		* 구매자 탈퇴 — 계정·배송지·위시리스트·장바구니·적립금을 지우고 토큰을 모두 무효로 만든다. 되돌릴 수 없다.
-		* 주문·리뷰·문의 기록은 스토어가 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
+		* 주문·리뷰·문의 기록은 상점이 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
 		* 409 `WITHDRAWAL_BLOCKED`(`error.details`: `WithdrawalBlockedDetails`)다. 앱은 성공 후 보관한 토큰을 지운다.
 		*/
 		withdraw(accessToken, body) {

package/dist/{checkout-C25liqdW.mjs → checkout-PJk8g5DY.mjs}

@@ -95,7 +95,7 @@ function normalizeCustomInputValue(value) {
 }
 /**
 * 직접 입력값의 글자 수 — 정규화한 값의 **코드 포인트 수**다(이모지 하나가 1자). 서버의 최대 글자 수 판정(`CUSTOM_INPUT_TOO_LONG`)과
-* 스토어프론트·콘솔의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
+* 스토어프론트·상점 플랫폼의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
 */
 function customInputLength(value) {
 	return [...normalizeCustomInputValue(value)].length;
@@ -264,7 +264,7 @@ const checkoutDeliverySchema = z.object({
 	remoteArea: remoteAreaSchema.describe("배송지 지역 구분. 배송지를 모르면 NONE"),
 	remoteAreaLabel: z.string().nullable().describe("지역 안내 이름(예: 제주특별자치도). 추가 배송비 지역이 아니면 null"),
 	bundleCount: z.number().int().describe("배송 묶음 수 — 배송비를 부과한 횟수다"),
-	freeByThreshold: z.boolean().describe("스토어 전체 무료배송 기준액을 넘겨 기본 배송비를 면제했는가"),
+	freeByThreshold: z.boolean().describe("상점 전체 무료배송 기준액을 넘겨 기본 배송비를 면제했는가"),
 	zipCode: z.string().nullable().describe("이 금액에 반영한 배송지 우편번호. null이면 배송지 미반영(추가 배송비 0)이다")
 });
 const checkoutSessionSchema = z.object({
@@ -297,7 +297,7 @@ const checkoutSessionSchema = z.object({
 	}).optional().describe("**Deprecated** — 항상 `{ required: false, notice: null }`이다. 청약철회 제한 고지를 없앴고(이슈 #48) storefront-sdk 0.15 이하 호환으로만 싣는다. 게시된 스토어프론트가 0.16 이상으로 넘어간 뒤 다음 릴리스에서 뺀다"),
 	expiresAt: z.string(),
 	paymentOptions: z.lazy(() => paymentOptionListSchema).describe("이 주문서에서 고를 수 있는 결제 옵션, PG 우선순위순. 셀러가 켠 PG·결제수단·간편결제만 담긴다. 비어 있으면 지금 결제할 수 없다"),
-	testPayment: z.boolean().describe("지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다")
+	testPayment: z.boolean().describe("지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 상점 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다")
 });
 /**
 * 배송비 미리보기 요청 — 배송지 우편번호로 배송비를 다시 계산한다. 주문서를 바꾸지 않는다(읽기 계산이다).
@@ -317,7 +317,7 @@ const paymentMethodSchema = z.enum([
 	"MOBILE",
 	"EASY_PAY"
 ]);
-/** 결제를 처리하는 PG. 셀러가 직접 계약하고 콘솔 설정 › 결제에서 연결한다 */
+/** 결제를 처리하는 PG. 셀러가 직접 계약하고 상점 플랫폼 설정 › 결제에서 연결한다 */
 const pgProviderSchema = z.enum(["tosspayments", "portone"]);
 /** 간편결제사. 토스페이먼츠·포트원 모두 같은 코드를 쓴다 */
 const easyPayProviderSchema = z.enum([
@@ -471,11 +471,11 @@ const cashReceiptField = cashReceiptRequestSchema.optional().describe("현금영
 /**
 * 결제 시작 — 배송지를 확정하고 고른 결제 옵션으로 결제 시도를 연다. 응답의 `payUrl`(결제 서비스)을 팝업(`mode=popup`)이나
 * 전체 페이지로 열면 결제 서비스가 PG 결제창을 띄우고 승인까지 한다. 리다이렉트 결제가 끝나면 구매자는 `returnUrl`로 돌아온다.
-* `returnUrl`의 도메인은 스토어 결제 도메인(콘솔 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
+* `returnUrl`의 도메인은 상점 결제 도메인(상점 플랫폼 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
 */
 const startPaymentRequestSchema = z.object({
 	option: paymentOptionSchema,
-	returnUrl: z.url().max(2048).describe("결제를 마치면 돌아올 스토어프론트 주소. 스토어 결제 도메인에 등록된 도메인이어야 한다"),
+	returnUrl: z.url().max(2048).describe("결제를 마치면 돌아올 스토어프론트 주소. 상점 결제 도메인에 등록된 도메인이어야 한다"),
 	shippingAddress: shippingAddressInputSchema.optional().describe("배송지. 주문서의 `requiresShipping`이 true면 필수이고 없으면 400 `SHIPPING_ADDRESS_REQUIRED`다. 배송이 필요 없는 주문(배송 없는 상품만)은 보내지 않아도 된다. 보내면 형식을 검사한 뒤 버린다"),
 	guest: guestInfoSchema.optional(),
 	cashReceipt: cashReceiptField,

package/dist/{client-CBAgQuTc.mjs → client-C91Y801B.mjs}

@@ -1,5 +1,5 @@
 import { a as ANALYTICS_VISITOR_HEADER, r as ANALYTICS_SESSION_HEADER } from "./analytics-CgD70OqH.mjs";
-import { $ as lineFulfillmentSchema, A as startPaymentRequestSchema, C as paymentStartSchema, F as checkoutPricingSchema, J as customInputViewSchema, N as applicableCouponSchema, O as retryPaymentRequestSchema, P as checkoutPricingRequestSchema, U as addonGroupViewSchema, V as myCouponSchema, X as lineSelectionResponseShape, Y as lineSelectionRequestShape, d as createCheckoutRequestSchema, et as myOrderItemFulfillmentSnapshotSchema, f as deliveryQuoteRequestSchema, m as easyPayProviderResponseSchema, nt as productFulfillmentViewSchema, p as deliveryQuoteSchema, tt as productCardFulfillmentSchema, u as checkoutSessionSchema, w as paymentStatusSchema, y as paymentMethodSchema } from "./checkout-C25liqdW.mjs";
+import { $ as lineFulfillmentSchema, A as startPaymentRequestSchema, C as paymentStartSchema, F as checkoutPricingSchema, J as customInputViewSchema, N as applicableCouponSchema, O as retryPaymentRequestSchema, P as checkoutPricingRequestSchema, U as addonGroupViewSchema, V as myCouponSchema, X as lineSelectionResponseShape, Y as lineSelectionRequestShape, d as createCheckoutRequestSchema, et as myOrderItemFulfillmentSnapshotSchema, f as deliveryQuoteRequestSchema, m as easyPayProviderResponseSchema, nt as productFulfillmentViewSchema, p as deliveryQuoteSchema, tt as productCardFulfillmentSchema, u as checkoutSessionSchema, w as paymentStatusSchema, y as paymentMethodSchema } from "./checkout-PJk8g5DY.mjs";
 import { z } from "zod";
 //#region src/http.ts
 /** 표준 엔벨로프의 $.error 상세 */
@@ -415,10 +415,10 @@ const createClaimResultSchema = z.object({
 	couponChargeRefundAmount: z.number().int().optional().default(0).describe("되돌릴 쿠폰 차감 예상액 — 앞선 취소·반품에서 뺀 쿠폰 조건 미달 차감 중 이번에 돌려받을 몫이다. 예상 환불액에 이미 반영돼 있다. 서버는 항상 싣는다")
 });
 /**
-* 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 스토어 주소록의 기본 반품지이거나,
+* 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 상점 주소록의 기본 반품지이거나,
 * 상품이 반품지를 따로 지정했으면 그 주소다.
 *
-* 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 스토어도 null이다.
+* 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 상점도 null이다.
 * 구매자가 직접 보내는 수거(`BUYER_SEND`)에 이 주소가 필요하다.
 */
 const claimReturnAddressSchema = z.object({
@@ -476,11 +476,11 @@ const consentStateSchema = z.object({
 	agreed: z.boolean(),
 	/** 동의한 약관 버전. 마케팅은 버전이 없어 null이고, 동의 이력이 없으면 null이다 */
 	agreedVersion: z.string().nullable(),
-	/** 스토어의 현재 약관 버전. 마케팅은 null */
+	/** 상점의 현재 약관 버전. 마케팅은 null */
 	currentVersion: z.string().nullable(),
 	/**
-	* 스토어가 정한 현재 약관 문서 주소. 재동의 화면에서 이 주소를 보여 준다.
-	* 스토어가 정하지 않았거나 마케팅이면 null이다(동의한 시점의 주소는 셀러가 보는 이력에 남는다).
+	* 상점이 정한 현재 약관 문서 주소. 재동의 화면에서 이 주소를 보여 준다.
+	* 상점이 정하지 않았거나 마케팅이면 null이다(동의한 시점의 주소는 셀러가 보는 이력에 남는다).
 	*/
 	currentDocumentUrl: z.string().nullable(),
 	/** 마지막으로 동의·철회한 시각. 이력이 없으면 null */
@@ -568,7 +568,7 @@ const memberSchema = z.object({
 	point: z.number().int(),
 	marketingAgreed: z.boolean(),
 	joinedAt: z.string(),
-	reconsentRequired: z.boolean().describe("약관이 개정돼 필수 동의를 다시 받아야 하는가. true면 `GET /me/consents`로 어떤 항목인지 확인하고 `POST /me/consents`로 받는다. 받기 전에도 스토어 이용은 막히지 않는다")
+	reconsentRequired: z.boolean().describe("약관이 개정돼 필수 동의를 다시 받아야 하는가. true면 `GET /me/consents`로 어떤 항목인지 확인하고 `POST /me/consents`로 받는다. 받기 전에도 상점 이용은 막히지 않는다")
 });
 const updateProfileRequestSchema = z.object({
 	name: z.string().max(50).optional(),
@@ -741,7 +741,7 @@ const updateReviewResultSchema = z.object({
 //#endregion
 //#region src/schemas/store.ts
 /**
-* 스토어 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
+* 상점 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
 */
 const storefrontStoreSchema = z.object({
 	storeCode: z.string(),
@@ -762,7 +762,19 @@ const storefrontStoreSchema = z.object({
 		"kakao",
 		"naver",
 		"google"
-	]))
+	])),
+	/**
+	* 지금 주문(결제)을 받을 수 있는가(이슈 #70). false면 결제 요청(`POST /checkout/{checkoutId}/payment`)이 409
+	* `PAYMENT_NOT_CONFIGURED`다. 장바구니·주문 버튼을 숨기거나 문의 안내로 바꾸면 된다. 장바구니 담기·주문서 생성은 막지 않는다
+	*/
+	checkoutAvailable: z.boolean().optional().default(true).describe("지금 주문(결제)을 받을 수 있는가. false면 결제 요청이 409 `PAYMENT_NOT_CONFIGURED`이므로 장바구니·주문 버튼을 숨기거나 문의 안내로 바꾸면 된다. 서버는 항상 싣는다"),
+	/** 주문을 받을 때의 결제 환경 — `TEST`면 테스트 결제(돈이 오가지 않는다)다. 주문을 받지 않으면 null */
+	checkoutMode: z.enum(["LIVE", "TEST"]).nullable().optional().default(null).describe("주문을 받을 때의 결제 환경. `TEST`면 테스트 결제라 돈이 오가지 않는다. 주문을 받지 않으면 null. 서버는 항상 싣는다"),
+	/**
+	* 주문을 받지 않는 사유 — `PAYMENT_NOT_CONFIGURED`(사용 중인 결제 수단 없음), `PAYMENT_NOT_LIVE`(공개한 쇼핑몰인데 실결제가
+	* 아직 열리지 않음). 주문을 받으면 null
+	*/
+	checkoutUnavailableReason: z.enum(["PAYMENT_NOT_CONFIGURED", "PAYMENT_NOT_LIVE"]).nullable().optional().default(null).describe("주문을 받지 않는 사유. `PAYMENT_NOT_CONFIGURED`는 사용 중인 결제 수단이 없음, `PAYMENT_NOT_LIVE`는 공개한 쇼핑몰인데 실결제가 아직 열리지 않음이다. 주문을 받으면 null. 서버는 항상 싣는다")
 });
 //#endregion
 //#region src/client.ts
@@ -832,7 +844,7 @@ function createStorefrontClient(options) {
 			unlinkIdentity: (provider) => http.request("DELETE", path`/me/identities/${provider}`, memberIdentitiesSchema)
 		},
 		store: { 
-		/** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+		/** 상점 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
 get: () => http.request("GET", "/store", storefrontStoreSchema) },
 		catalog: {
 			listCategories: () => http.request("GET", "/categories", z.array(categoryNodeSchema)),
@@ -866,10 +878,10 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 			* `@sayren/storefront-sdk/payments`의 `createPayments().start()`다 — 이 메서드는 값만 받는다.
 			*
 			* 에러(`ApiError.code`):
-			* - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 스토어에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
+			* - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 상점에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
 			* - 409 `PAYMENT_NOT_CONFIGURED`: 사용 중인 PG가 없다
 			* - 400 `RETURN_URL_NOT_ALLOWED`: `returnUrl`이 https가 아니거나(테스트 결제의 localhost는 예외),
-			*   스토어가 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
+			*   상점이 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
 			* - 503 `PAYMENT_PROVIDER_UNAVAILABLE`: 고른 PG의 결제창을 준비하지 못했다(다른 옵션으로 다시 시도)
 			*/
 			startPayment: (checkoutId, body) => http.request("POST", path`/checkout/${checkoutId}/payment`, paymentStartSchema, { body: startPaymentRequestSchema.parse(body) }),
@@ -889,7 +901,7 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 			* `expiresAt`까지 폴링한다. `completed`면 `orderId`로 완료 화면, `failed`·`expired`면 실패 안내다.
 			* TTL이 지난 `pending`은 `expired`로 보고된다. `testPayment`는 완료면 주문 플래그, 아니면 세션 환경이다.
 			*
-			* 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 스토어) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
+			* 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 상점) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
 			*/
 			getStatus: (paymentId) => http.request("GET", path`/payments/${paymentId}`, paymentStatusSchema),
 			/**
@@ -906,7 +918,7 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 			*
 			* 에러: 404 `ORDER_NOT_FOUND`(주문이 없거나 연락처·비밀번호가 다름 — 둘을 구분하지 않는다) ·
 			* 429 `TOO_MANY_REQUESTS`(주문번호마다 10분에 5번까지 확인하고, 5번째가 틀리면 30분 잠금.
-			* 주문번호마다 하루 15번, 스토어 전체 분당 한도도 있다. 남은 시간은 `ApiError.details.retryAfterSeconds`).
+			* 주문번호마다 하루 15번, 상점 전체 분당 한도도 있다. 남은 시간은 `ApiError.details.retryAfterSeconds`).
 			* 맞게 조회하면 주문번호의 횟수가 초기화된다. 본문 형식은 `guestInfoSchema`의 `phone`·`orderPassword`와 같다.
 			* 429는 연락처·비밀번호가 맞아도 난다 — 「잠시 후 다시 시도」로 안내한다.
 			*/

package/dist/{index-BsHuMzBD.d.mts → index-DJYqxHSY.d.mts}

@@ -576,7 +576,7 @@ declare const paymentMethodSchema: z.ZodEnum<{
   MOBILE: "MOBILE";
 }>;
 type PaymentMethod = z.infer<typeof paymentMethodSchema>;
-/** 결제를 처리하는 PG. 셀러가 직접 계약하고 콘솔 설정 › 결제에서 연결한다 */
+/** 결제를 처리하는 PG. 셀러가 직접 계약하고 상점 플랫폼 설정 › 결제에서 연결한다 */
 declare const pgProviderSchema: z.ZodEnum<{
   tosspayments: "tosspayments";
   portone: "portone";
@@ -804,7 +804,7 @@ type CashReceiptRequest = z.infer<typeof cashReceiptRequestSchema>;
 /**
  * 결제 시작 — 배송지를 확정하고 고른 결제 옵션으로 결제 시도를 연다. 응답의 `payUrl`(결제 서비스)을 팝업(`mode=popup`)이나
  * 전체 페이지로 열면 결제 서비스가 PG 결제창을 띄우고 승인까지 한다. 리다이렉트 결제가 끝나면 구매자는 `returnUrl`로 돌아온다.
- * `returnUrl`의 도메인은 스토어 결제 도메인(콘솔 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
+ * `returnUrl`의 도메인은 상점 결제 도메인(상점 플랫폼 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
  */
 declare const startPaymentRequestSchema: z.ZodObject<{
   option: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1085,10 +1085,10 @@ declare const createClaimResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 type CreateClaimResult = z.infer<typeof createClaimResultSchema>;
 /**
- * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 스토어 주소록의 기본 반품지이거나,
+ * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 상점 주소록의 기본 반품지이거나,
  * 상품이 반품지를 따로 지정했으면 그 주소다.
  *
- * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 스토어도 null이다.
+ * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 상점도 null이다.
  * 구매자가 직접 보내는 수거(`BUYER_SEND`)에 이 주소가 필요하다.
  */
 declare const claimReturnAddressSchema: z.ZodObject<{
@@ -1609,7 +1609,7 @@ declare const STOREFRONT_SESSION_KEYS: {
 interface StorefrontSessionOptions {
   /** 예: https://shop.api.example.com/storefront/v1 */
   baseUrl: string;
-  /** 테넌트 스토어 코드 — X-Store-Code 헤더로 전송한다 */
+  /** 테넌트 상점 코드 — X-Store-Code 헤더로 전송한다 */
   storeCode?: string;
   /** 저장 매체 어댑터 (앱 소유) */
   storage: SessionStorage;
@@ -1646,7 +1646,7 @@ interface StorefrontClientOptions {
   /** 예: https://demo.store.example.com/api/v1 */
   baseUrl: string;
   /**
-   * 테넌트 스토어 코드 — `X-Store-Code` 헤더로 전송한다. 공유 API 호스트로 접근할 때
+   * 테넌트 상점 코드 — `X-Store-Code` 헤더로 전송한다. 공유 API 호스트로 접근할 때
    * 서버가 Host 서브도메인을 추측하는 대신 명시적으로 테넌트를 지정한다(멀티테넌트 격리).
    * 함수로 전달하면 매 요청마다 재평가.
    */
@@ -1764,7 +1764,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
     }>;
   };
   store: {
-    /** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+    /** 상점 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
     get: () => Promise<{
       storeCode: string;
       name: string;
@@ -1773,6 +1773,9 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
       businessHours: string | null;
       guestCheckout: boolean;
       loginMethods: ("password" | "kakao" | "naver" | "google")[];
+      checkoutAvailable: boolean;
+      checkoutMode: "LIVE" | "TEST" | null;
+      checkoutUnavailableReason: "PAYMENT_NOT_CONFIGURED" | "PAYMENT_NOT_LIVE" | null;
     }>;
   };
   catalog: {
@@ -2140,10 +2143,10 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
      * `@sayren/storefront-sdk/payments`의 `createPayments().start()`다 — 이 메서드는 값만 받는다.
      *
      * 에러(`ApiError.code`):
-     * - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 스토어에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
+     * - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 상점에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
      * - 409 `PAYMENT_NOT_CONFIGURED`: 사용 중인 PG가 없다
      * - 400 `RETURN_URL_NOT_ALLOWED`: `returnUrl`이 https가 아니거나(테스트 결제의 localhost는 예외),
-     *   스토어가 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
+     *   상점이 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
      * - 503 `PAYMENT_PROVIDER_UNAVAILABLE`: 고른 PG의 결제창을 준비하지 못했다(다른 옵션으로 다시 시도)
      */
     startPayment: (checkoutId: string, body: StartPaymentRequest) => Promise<{
@@ -2249,7 +2252,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
      * `expiresAt`까지 폴링한다. `completed`면 `orderId`로 완료 화면, `failed`·`expired`면 실패 안내다.
      * TTL이 지난 `pending`은 `expired`로 보고된다. `testPayment`는 완료면 주문 플래그, 아니면 세션 환경이다.
      *
-     * 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 스토어) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
+     * 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 상점) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
      */
     getStatus: (paymentId: string) => Promise<{
       paymentId: string;
@@ -2461,7 +2464,7 @@ declare function createStorefrontClient(options: StorefrontClientOptions): {
      *
      * 에러: 404 `ORDER_NOT_FOUND`(주문이 없거나 연락처·비밀번호가 다름 — 둘을 구분하지 않는다) ·
      * 429 `TOO_MANY_REQUESTS`(주문번호마다 10분에 5번까지 확인하고, 5번째가 틀리면 30분 잠금.
-     * 주문번호마다 하루 15번, 스토어 전체 분당 한도도 있다. 남은 시간은 `ApiError.details.retryAfterSeconds`).
+     * 주문번호마다 하루 15번, 상점 전체 분당 한도도 있다. 남은 시간은 `ApiError.details.retryAfterSeconds`).
      * 맞게 조회하면 주문번호의 횟수가 초기화된다. 본문 형식은 `guestInfoSchema`의 `phone`·`orderPassword`와 같다.
      * 429는 연락처·비밀번호가 맞아도 난다 — 「잠시 후 다시 시도」로 안내한다.
      */
@@ -3165,7 +3168,7 @@ type CustomInputView = z.infer<typeof customInputViewSchema>;
 declare function normalizeCustomInputValue(value: string): string;
 /**
  * 직접 입력값의 글자 수 — 정규화한 값의 **코드 포인트 수**다(이모지 하나가 1자). 서버의 최대 글자 수 판정(`CUSTOM_INPUT_TOO_LONG`)과
- * 스토어프론트·콘솔의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
+ * 스토어프론트·상점 플랫폼의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
  */
 declare function customInputLength(value: string): number;
 /** 담기·바로 구매 요청의 직접 입력값 한 칸. 앞뒤 공백을 지우고, 빈 값은 입력하지 않은 것으로 본다 */
@@ -3220,7 +3223,7 @@ declare const lineSelectionResponseShape: {
 //#endregion
 //#region src/schemas/store.d.ts
 /**
- * 스토어 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
+ * 상점 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
  */
 declare const storefrontStoreSchema: z.ZodObject<{
   storeCode: z.ZodString;
@@ -3235,6 +3238,15 @@ declare const storefrontStoreSchema: z.ZodObject<{
     naver: "naver";
     google: "google";
   }>>;
+  checkoutAvailable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  checkoutMode: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    LIVE: "LIVE";
+    TEST: "TEST";
+  }>>>>;
+  checkoutUnavailableReason: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    PAYMENT_NOT_CONFIGURED: "PAYMENT_NOT_CONFIGURED";
+    PAYMENT_NOT_LIVE: "PAYMENT_NOT_LIVE";
+  }>>>>;
 }, z.core.$strip>;
 type StorefrontStore = z.infer<typeof storefrontStoreSchema>;
 //#endregion

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 CreateReviewRequest, $n as cashReceiptAvailable, $r as productCardFulfillmentSchema, $t as myCouponSchema, A as ANALYTICS_MAX_BATCH_BYTES, An as CheckoutDelivery, Ar as ProductSearchParams, At as publicInquirySchema, B as analyticsBatchSchema, Bn as PAYMENT_STATUS_VALUES, Br as PageInfo, Bt as CouponApplication, C as PurchaseDecisionResult, Cn as createClaimResultSchema, Cr as shippingAddressInputSchema, Ct as updateProfileRequestSchema, D as orderShippingAddressSchema, Dn as CashReceiptIdentityType, Dr as ProductDetail, Dt as PublicInquiry, E as myOrderSchema, En as CASH_RECEIPT_METHODS, Er as ProductCard, Et as CreateInquiryResult, F as AnalyticsBatch, Fn as EasyPayProvider, Fr as productFacetsSchema, Ft as customerInquiryCategorySchema, G as StorefrontClient, Gn as PaymentStart, Gr as pageSchema, Gt as applicableCouponSchema, H as analyticsClientEventSchema, Hn as PaymentMessage, Hr as claimStatusSchema, Ht as MAX_COUPONS_PER_CHECKOUT, I as AnalyticsClientEvent, In as GuestInfo, Ir as productPageSchema, It as customerInquirySchema, J as STOREFRONT_SESSION_KEYS, Jn as RemoteArea, Jr as ProductCardFulfillment, Jt as couponApplicationListSchema, K as StorefrontClientOptions, Kn as PaymentStatus, Kr as LineFulfillment, Kt as checkoutPricingRequestSchema, L as AnalyticsClientEventName, Ln as KnownPaymentResult, Lr as productSortSchema, Lt as ApplicableCoupon, M as ANALYTICS_SESSION_HEADER, Mn as CreateCheckoutRequest, Mr as categoryNodeSchema, Mt as CustomerInquiry, N as ANALYTICS_VISITOR_COOKIE, Nn as DeliveryQuoteRequest, Nr as productCardSchema, Nt as CustomerInquiryCategory, O as purchaseDecisionResultSchema, On as CashReceiptRequest, Or as ProductFacets, Ot as createInquiryRequestSchema, P as ANALYTICS_VISITOR_HEADER, Pn as DeliveryQuoteResult, Pr as productDetailSchema, Pt as createCustomerInquiryRequestSchema, Q as createStorefrontSession, Qn as availablePaymentOptionSchema, Qr as myOrderItemFulfillmentSnapshotSchema, Qt as myCouponListQuerySchema, R as AnalyticsEventName, Rn as KnownPaymentStatus, Rr as ClaimStatus, Rt as CheckoutPricing, S as OrderShippingAddress, Sn as createClaimRequestSchema, Sr as retryPaymentRequestSchema, St as memberSchema, T as myOrderItemSchema, Tn as AvailablePaymentOption, Tr as CategoryNode, Tt as CreateInquiryRequest, U as analyticsIdSchema, Un as PaymentMethod, Ur as orderItemStatusSchema, Ut as MIN_PAYMENT_AMOUNT, V as analyticsClientEventNameSchema, Vn as PaymentFailureCategory, Vr as PageParams, Vt as CouponResult, W as analyticsServerEventNameSchema, Wn as PaymentOption, Wr as pageInfoSchema, Wt as MyCoupon, X as StorefrontSession, Xn as ShippingAddressInput, Xr as UnknownFulfillmentView, Xt as couponBenefitViewSchema, Y as SessionStorage, Yn as RetryPaymentRequest, Yr as ProductFulfillmentView, Yt as couponApplicationSchema, Z as StorefrontSessionOptions, Zn as StartPaymentRequest, Zr as lineFulfillmentSchema, Zt as couponResultSchema, _ as normalizeCustomInputValue, _n as CreateClaimResult, _r as paymentStartSchema, _t as MemberAddressRequest, a as CustomInputEntry, ai as addCartItemRequestSchema, an as ConsentUpdateRequest, ar as createCheckoutRequestSchema, at as UpdateReviewResult, b as MyOrder, bn as claimReturnAddressSchema, br as remoteAreaSchema, bt as memberAddressRequestSchema, c as OptionSelectionView, ci as updateCartItemRequestSchema, cn as consentKindSchema, cr as easyPayProviderResponseSchema, ct as createReviewResultSchema, d as customInputEntrySchema, dn as consentUpdateRequestSchema, dr as paymentFailureCategorySchema, dt as reviewSummarySchema, ei as productFulfillmentViewSchema, en as pricingAmountsSchema, er as cashReceiptIdentityTypeOf, et as CreateReviewResult, f as customInputLength, fn as memberConsentsSchema, fr as paymentMessageSchema, ft as updateReviewRequestSchema, g as lineSelectionResponseShape, gn as CreateClaimRequest, gr as paymentOptionSchema, gt as MemberAddress, h as lineSelectionRequestShape, hn as ClaimType, hr as paymentOptionListSchema, ht as Member, i as AddonSelection, ii as UpdateCartItemRequest, in as ConsentState, ir as checkoutSessionSchema, it as UpdateReviewRequest, j as ANALYTICS_SESSION_COOKIE, jn as CheckoutSession, jr as ProductSort, jt as CreateCustomerInquiryRequest, k as trackingStageResponseSchema, kn as CashReceiptType, kr as ProductPage, kt as createInquiryResultSchema, l as addonGroupViewSchema, li as analyticsIdsFromCookie, ln as consentSourceSchema, lr as easyPayProviderSchema, lt as publicReviewSchema, m as customInputViewSchema, mn as ClaimReturnAddress, mr as paymentOptionKey, mt as writableReviewSchema, n as storefrontStoreSchema, ni as Cart, nn as ConsentKind, nr as cashReceiptTypeSchema, nt as ReviewPage, o as CustomInputValueView, oi as cartItemSchema, on as MemberConsents, or as deliveryQuoteRequestSchema, ot as WritableReview, p as customInputValueViewSchema, pn as ClaimReason, pr as paymentMethodSchema, pt as updateReviewResultSchema, q as createStorefrontClient, qn as PgProvider, qr as MyOrderItemFulfillmentSnapshot, qt as checkoutPricingSchema, r as AddonGroupView, ri as CartItem, rn as ConsentSource, rr as checkoutDeliverySchema, rt as ReviewSummary, s as CustomInputView, si as cartSchema, sn as consentActionSchema, sr as deliveryQuoteSchema, st as createReviewRequestSchema, t as StorefrontStore, ti as AddCartItemRequest, tn as ConsentAction, tr as cashReceiptRequestSchema, tt as PublicReview, u as addonSelectionSchema, un as consentStateSchema, ur as guestInfoSchema, ut as reviewPageSchema, v as optionSelectionViewSchema, vn as MyClaim, vr as paymentStatusSchema, vt as UpdateProfileRequest, w as deliveryTrackingSchema, wn as myClaimSchema, wr as startPaymentRequestSchema, wt as wishlistAddResultSchema, x as MyOrderItem, xn as claimTypeSchema, xr as residentNumberLike, xt as memberAddressSchema, y as DeliveryTracking, yn as claimReasonSchema, yr as pgProviderSchema, yt as WishlistAddResult, z as AnalyticsServerEventName, zn as PAYMENT_RESULT_VALUES, zr as OrderItemStatus, zt as CheckoutPricingRequest } from "./index-BsHuMzBD.mjs";
+import { $ as CreateReviewRequest, $n as cashReceiptAvailable, $r as productCardFulfillmentSchema, $t as myCouponSchema, A as ANALYTICS_MAX_BATCH_BYTES, An as CheckoutDelivery, Ar as ProductSearchParams, At as publicInquirySchema, B as analyticsBatchSchema, Bn as PAYMENT_STATUS_VALUES, Br as PageInfo, Bt as CouponApplication, C as PurchaseDecisionResult, Cn as createClaimResultSchema, Cr as shippingAddressInputSchema, Ct as updateProfileRequestSchema, D as orderShippingAddressSchema, Dn as CashReceiptIdentityType, Dr as ProductDetail, Dt as PublicInquiry, E as myOrderSchema, En as CASH_RECEIPT_METHODS, Er as ProductCard, Et as CreateInquiryResult, F as AnalyticsBatch, Fn as EasyPayProvider, Fr as productFacetsSchema, Ft as customerInquiryCategorySchema, G as StorefrontClient, Gn as PaymentStart, Gr as pageSchema, Gt as applicableCouponSchema, H as analyticsClientEventSchema, Hn as PaymentMessage, Hr as claimStatusSchema, Ht as MAX_COUPONS_PER_CHECKOUT, I as AnalyticsClientEvent, In as GuestInfo, Ir as productPageSchema, It as customerInquirySchema, J as STOREFRONT_SESSION_KEYS, Jn as RemoteArea, Jr as ProductCardFulfillment, Jt as couponApplicationListSchema, K as StorefrontClientOptions, Kn as PaymentStatus, Kr as LineFulfillment, Kt as checkoutPricingRequestSchema, L as AnalyticsClientEventName, Ln as KnownPaymentResult, Lr as productSortSchema, Lt as ApplicableCoupon, M as ANALYTICS_SESSION_HEADER, Mn as CreateCheckoutRequest, Mr as categoryNodeSchema, Mt as CustomerInquiry, N as ANALYTICS_VISITOR_COOKIE, Nn as DeliveryQuoteRequest, Nr as productCardSchema, Nt as CustomerInquiryCategory, O as purchaseDecisionResultSchema, On as CashReceiptRequest, Or as ProductFacets, Ot as createInquiryRequestSchema, P as ANALYTICS_VISITOR_HEADER, Pn as DeliveryQuoteResult, Pr as productDetailSchema, Pt as createCustomerInquiryRequestSchema, Q as createStorefrontSession, Qn as availablePaymentOptionSchema, Qr as myOrderItemFulfillmentSnapshotSchema, Qt as myCouponListQuerySchema, R as AnalyticsEventName, Rn as KnownPaymentStatus, Rr as ClaimStatus, Rt as CheckoutPricing, S as OrderShippingAddress, Sn as createClaimRequestSchema, Sr as retryPaymentRequestSchema, St as memberSchema, T as myOrderItemSchema, Tn as AvailablePaymentOption, Tr as CategoryNode, Tt as CreateInquiryRequest, U as analyticsIdSchema, Un as PaymentMethod, Ur as orderItemStatusSchema, Ut as MIN_PAYMENT_AMOUNT, V as analyticsClientEventNameSchema, Vn as PaymentFailureCategory, Vr as PageParams, Vt as CouponResult, W as analyticsServerEventNameSchema, Wn as PaymentOption, Wr as pageInfoSchema, Wt as MyCoupon, X as StorefrontSession, Xn as ShippingAddressInput, Xr as UnknownFulfillmentView, Xt as couponBenefitViewSchema, Y as SessionStorage, Yn as RetryPaymentRequest, Yr as ProductFulfillmentView, Yt as couponApplicationSchema, Z as StorefrontSessionOptions, Zn as StartPaymentRequest, Zr as lineFulfillmentSchema, Zt as couponResultSchema, _ as normalizeCustomInputValue, _n as CreateClaimResult, _r as paymentStartSchema, _t as MemberAddressRequest, a as CustomInputEntry, ai as addCartItemRequestSchema, an as ConsentUpdateRequest, ar as createCheckoutRequestSchema, at as UpdateReviewResult, b as MyOrder, bn as claimReturnAddressSchema, br as remoteAreaSchema, bt as memberAddressRequestSchema, c as OptionSelectionView, ci as updateCartItemRequestSchema, cn as consentKindSchema, cr as easyPayProviderResponseSchema, ct as createReviewResultSchema, d as customInputEntrySchema, dn as consentUpdateRequestSchema, dr as paymentFailureCategorySchema, dt as reviewSummarySchema, ei as productFulfillmentViewSchema, en as pricingAmountsSchema, er as cashReceiptIdentityTypeOf, et as CreateReviewResult, f as customInputLength, fn as memberConsentsSchema, fr as paymentMessageSchema, ft as updateReviewRequestSchema, g as lineSelectionResponseShape, gn as CreateClaimRequest, gr as paymentOptionSchema, gt as MemberAddress, h as lineSelectionRequestShape, hn as ClaimType, hr as paymentOptionListSchema, ht as Member, i as AddonSelection, ii as UpdateCartItemRequest, in as ConsentState, ir as checkoutSessionSchema, it as UpdateReviewRequest, j as ANALYTICS_SESSION_COOKIE, jn as CheckoutSession, jr as ProductSort, jt as CreateCustomerInquiryRequest, k as trackingStageResponseSchema, kn as CashReceiptType, kr as ProductPage, kt as createInquiryResultSchema, l as addonGroupViewSchema, li as analyticsIdsFromCookie, ln as consentSourceSchema, lr as easyPayProviderSchema, lt as publicReviewSchema, m as customInputViewSchema, mn as ClaimReturnAddress, mr as paymentOptionKey, mt as writableReviewSchema, n as storefrontStoreSchema, ni as Cart, nn as ConsentKind, nr as cashReceiptTypeSchema, nt as ReviewPage, o as CustomInputValueView, oi as cartItemSchema, on as MemberConsents, or as deliveryQuoteRequestSchema, ot as WritableReview, p as customInputValueViewSchema, pn as ClaimReason, pr as paymentMethodSchema, pt as updateReviewResultSchema, q as createStorefrontClient, qn as PgProvider, qr as MyOrderItemFulfillmentSnapshot, qt as checkoutPricingSchema, r as AddonGroupView, ri as CartItem, rn as ConsentSource, rr as checkoutDeliverySchema, rt as ReviewSummary, s as CustomInputView, si as cartSchema, sn as consentActionSchema, sr as deliveryQuoteSchema, st as createReviewRequestSchema, t as StorefrontStore, ti as AddCartItemRequest, tn as ConsentAction, tr as cashReceiptRequestSchema, tt as PublicReview, u as addonSelectionSchema, un as consentStateSchema, ur as guestInfoSchema, ut as reviewPageSchema, v as optionSelectionViewSchema, vn as MyClaim, vr as paymentStatusSchema, vt as UpdateProfileRequest, w as deliveryTrackingSchema, wn as myClaimSchema, wr as startPaymentRequestSchema, wt as wishlistAddResultSchema, x as MyOrderItem, xn as claimTypeSchema, xr as residentNumberLike, xt as memberAddressSchema, y as DeliveryTracking, yn as claimReasonSchema, yr as pgProviderSchema, yt as WishlistAddResult, z as AnalyticsServerEventName, zn as PAYMENT_RESULT_VALUES, zr as OrderItemStatus, zt as CheckoutPricingRequest } from "./index-DJYqxHSY.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, Cart, CartItem, CashReceiptIdentityType, CashReceiptRequest, CashReceiptType, CategoryNode, CheckoutDelivery, CheckoutPricing, CheckoutPricingRequest, CheckoutSession, ClaimReason, ClaimReturnAddress, ClaimStatus, ClaimType, ConsentAction, ConsentKind, ConsentSource, ConsentState, ConsentUpdateRequest, CouponApplication, CouponResult, CreateCheckoutRequest, CreateClaimRequest, CreateClaimResult, CreateCustomerInquiryRequest, CreateInquiryRequest, CreateInquiryResult, CreateReviewRequest, CreateReviewResult, CustomInputEntry, CustomInputValueView, CustomInputView, CustomerInquiry, CustomerInquiryCategory, DeliveryQuoteRequest, DeliveryQuoteResult, DeliveryTracking, EasyPayProvider, GuestInfo, IdpAgreements, IdpAuthorizeRequest, IdpTokenRequest, KnownPaymentResult, KnownPaymentStatus, LineFulfillment, LinkIdentityRequest, LoginRequest, MAX_COUPONS_PER_CHECKOUT, MIN_PAYMENT_AMOUNT, Member, MemberAddress, MemberAddressRequest, MemberConsents, MemberIdentities, MyClaim, MyCoupon, MyOrder, MyOrderItem, MyOrderItemFulfillmentSnapshot, OptionSelectionView, OrderItemStatus, OrderShippingAddress, PAYMENT_RESULT_VALUES, PAYMENT_STATUS_VALUES, PageInfo, PageParams, PaymentFailureCategory, PaymentMessage, PaymentMethod, PaymentOption, PaymentStart, PaymentStatus, PgProvider, ProductCard, ProductCardFulfillment, ProductDetail, ProductFacets, ProductFulfillmentView, 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, UnknownFulfillmentView, UpdateCartItemRequest, UpdateProfileRequest, UpdateReviewRequest, UpdateReviewResult, WishlistAddResult, WithdrawRequest, WithdrawalBlockedDetails, WritableReview, addCartItemRequestSchema, addonGroupViewSchema, addonSelectionSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, applicableCouponSchema, availablePaymentOptionSchema, buildQuery, cartItemSchema, cartSchema, cashReceiptAvailable, cashReceiptIdentityTypeOf, cashReceiptRequestSchema, cashReceiptTypeSchema, categoryNodeSchema, checkoutDeliverySchema, checkoutPricingRequestSchema, checkoutPricingSchema, checkoutSessionSchema, claimReasonSchema, claimReturnAddressSchema, claimStatusSchema, claimTypeSchema, 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, guestInfoSchema, idpAgreementsSchema, idpAuthorizeRequestSchema, idpAuthorizeResponseSchema, idpTokenRequestSchema, lineFulfillmentSchema, lineSelectionRequestShape, lineSelectionResponseShape, linkIdentityRequestSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberConsentsSchema, memberIdentitiesSchema, memberSchema, myClaimSchema, myCouponListQuerySchema, myCouponSchema, myOrderItemFulfillmentSnapshotSchema, myOrderItemSchema, myOrderSchema, normalizeCustomInputValue, optionSelectionViewSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentFailureCategorySchema, paymentMessageSchema, paymentMethodSchema, paymentOptionKey, paymentOptionListSchema, paymentOptionSchema, paymentStartSchema, paymentStatusSchema, pgProviderSchema, pricingAmountsSchema, productCardFulfillmentSchema, productCardSchema, productDetailSchema, productFacetsSchema, productFulfillmentViewSchema, 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 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-CBAgQuTc.mjs";
-import { $ as lineFulfillmentSchema, A as startPaymentRequestSchema, B as myCouponListQuerySchema, C as paymentStartSchema, D as residentNumberLike, E as remoteAreaSchema, F as checkoutPricingSchema, G as customInputEntrySchema, H as pricingAmountsSchema, I as couponApplicationListSchema, J as customInputViewSchema, K as customInputLength, L as couponApplicationSchema, M as MIN_PAYMENT_AMOUNT, N as applicableCouponSchema, O as retryPaymentRequestSchema, P as checkoutPricingRequestSchema, Q as optionSelectionViewSchema, R as couponBenefitViewSchema, S as paymentOptionSchema, T as pgProviderSchema, U as addonGroupViewSchema, V as myCouponSchema, W as addonSelectionSchema, X as lineSelectionResponseShape, Y as lineSelectionRequestShape, Z as normalizeCustomInputValue, _ as paymentFailureCategorySchema, a as cashReceiptAvailable, b as paymentOptionKey, c as cashReceiptTypeSchema, d as createCheckoutRequestSchema, et as myOrderItemFulfillmentSnapshotSchema, f as deliveryQuoteRequestSchema, g as guestInfoSchema, h as easyPayProviderSchema, i as availablePaymentOptionSchema, j as MAX_COUPONS_PER_CHECKOUT, k as shippingAddressInputSchema, l as checkoutDeliverySchema, m as easyPayProviderResponseSchema, n as PAYMENT_RESULT_VALUES, nt as productFulfillmentViewSchema, o as cashReceiptIdentityTypeOf, p as deliveryQuoteSchema, q as customInputValueViewSchema, r as PAYMENT_STATUS_VALUES, s as cashReceiptRequestSchema, t as CASH_RECEIPT_METHODS, tt as productCardFulfillmentSchema, u as checkoutSessionSchema, v as paymentMessageSchema, w as paymentStatusSchema, x as paymentOptionListSchema, y as paymentMethodSchema, z as couponResultSchema } from "./checkout-C25liqdW.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-C91Y801B.mjs";
+import { $ as lineFulfillmentSchema, A as startPaymentRequestSchema, B as myCouponListQuerySchema, C as paymentStartSchema, D as residentNumberLike, E as remoteAreaSchema, F as checkoutPricingSchema, G as customInputEntrySchema, H as pricingAmountsSchema, I as couponApplicationListSchema, J as customInputViewSchema, K as customInputLength, L as couponApplicationSchema, M as MIN_PAYMENT_AMOUNT, N as applicableCouponSchema, O as retryPaymentRequestSchema, P as checkoutPricingRequestSchema, Q as optionSelectionViewSchema, R as couponBenefitViewSchema, S as paymentOptionSchema, T as pgProviderSchema, U as addonGroupViewSchema, V as myCouponSchema, W as addonSelectionSchema, X as lineSelectionResponseShape, Y as lineSelectionRequestShape, Z as normalizeCustomInputValue, _ as paymentFailureCategorySchema, a as cashReceiptAvailable, b as paymentOptionKey, c as cashReceiptTypeSchema, d as createCheckoutRequestSchema, et as myOrderItemFulfillmentSnapshotSchema, f as deliveryQuoteRequestSchema, g as guestInfoSchema, h as easyPayProviderSchema, i as availablePaymentOptionSchema, j as MAX_COUPONS_PER_CHECKOUT, k as shippingAddressInputSchema, l as checkoutDeliverySchema, m as easyPayProviderResponseSchema, n as PAYMENT_RESULT_VALUES, nt as productFulfillmentViewSchema, o as cashReceiptIdentityTypeOf, p as deliveryQuoteSchema, q as customInputValueViewSchema, r as PAYMENT_STATUS_VALUES, s as cashReceiptRequestSchema, t as CASH_RECEIPT_METHODS, tt as productCardFulfillmentSchema, u as checkoutSessionSchema, v as paymentMessageSchema, w as paymentStatusSchema, x as paymentOptionListSchema, y as paymentMethodSchema, z as couponResultSchema } from "./checkout-PJk8g5DY.mjs";
 //#region src/session.ts
 /** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */
 const STOREFRONT_SESSION_KEYS = {

package/dist/payments/index.d.mts

@@ -1,4 +1,4 @@
-import { Gn as PaymentStart, In as GuestInfo, Kn as PaymentStatus, On as CashReceiptRequest, Wn as PaymentOption, Xn as ShippingAddressInput, Zn as StartPaymentRequest, q as createStorefrontClient } from "../index-BsHuMzBD.mjs";
+import { Gn as PaymentStart, In as GuestInfo, Kn as PaymentStatus, On as CashReceiptRequest, Wn as PaymentOption, Xn as ShippingAddressInput, Zn as StartPaymentRequest, q as createStorefrontClient } from "../index-DJYqxHSY.mjs";
 //#region src/payments/index.d.ts
 /**
  * 스토어프론트 결제 — 브라우저 전용(`@sayren/storefront-sdk/payments`).
@@ -101,7 +101,7 @@ export declare function paymentResultOf(status: PaymentStatus, options?: {
 }): PaymentResult;
 export interface PaymentsOptions {
   client: StorefrontClient;
-  /** 결제를 마치면 돌아올 주소(스토어 결제 도메인 안). `start`·`retry`에서 바꿀 수 있다 */
+  /** 결제를 마치면 돌아올 주소(상점 결제 도메인 안). `start`·`retry`에서 바꿀 수 있다 */
   returnUrl?: string;
   env?: PaymentsEnv;
 }

package/dist/payments/index.mjs

@@ -1,4 +1,4 @@
-import { v as paymentMessageSchema } from "../checkout-C25liqdW.mjs";
+import { v as paymentMessageSchema } from "../checkout-PJk8g5DY.mjs";
 //#region src/payments/index.ts
 /** 복귀 주소에 결제 서비스가 붙이는 쿼리 */
 const RETURN_PAYMENT_ID = "sayrenPaymentId";

package/package.json

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

package/src/analytics/index.ts

@@ -23,7 +23,7 @@ export type AnalyticsConsent = "granted" | "denied" | "pending";
 export interface AnalyticsOptions {
   /** 스토어프론트 API 베이스 — 예: `https://api.sayren.app/storefront/v1` */
   baseUrl: string;
-  /** 테넌트 스토어 코드 */
+  /** 테넌트 상점 코드 */
   storeCode: string;
   /** 동의 상태. 기본 `pending` — 셀러의 동의 배너가 `setConsent`로 바꾼다 */
   consent?: AnalyticsConsent;

package/src/auth/index.ts

@@ -74,7 +74,7 @@ async function s256(verifier: string): Promise<string> {
 export interface StorefrontAuthOptions {
   /** 예: https://api.sayren.app/storefront/v1 */
   baseUrl: string;
-  /** 테넌트 스토어 코드 — `X-Store-Code` 헤더로 보낸다 */
+  /** 테넌트 상점 코드 — `X-Store-Code` 헤더로 보낸다 */
   storeCode: string;
   fetch?: typeof globalThis.fetch;
 }
@@ -226,7 +226,7 @@ export function createStorefrontAuth(options: StorefrontAuthOptions) {
     },
     /**
      * 구매자 탈퇴 — 계정·배송지·위시리스트·장바구니·적립금을 지우고 토큰을 모두 무효로 만든다. 되돌릴 수 없다.
-     * 주문·리뷰·문의 기록은 스토어가 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
+     * 주문·리뷰·문의 기록은 상점이 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
      * 409 `WITHDRAWAL_BLOCKED`(`error.details`: `WithdrawalBlockedDetails`)다. 앱은 성공 후 보관한 토큰을 지운다.
      */
     withdraw(accessToken: string, body: WithdrawRequest): Promise<void> {

package/src/client.ts

@@ -103,7 +103,7 @@ export interface StorefrontClientOptions {
   /** 예: https://demo.store.example.com/api/v1 */
   baseUrl: string;
   /**
-   * 테넌트 스토어 코드 — `X-Store-Code` 헤더로 전송한다. 공유 API 호스트로 접근할 때
+   * 테넌트 상점 코드 — `X-Store-Code` 헤더로 전송한다. 공유 API 호스트로 접근할 때
    * 서버가 Host 서브도메인을 추측하는 대신 명시적으로 테넌트를 지정한다(멀티테넌트 격리).
    * 함수로 전달하면 매 요청마다 재평가.
    */
@@ -233,7 +233,7 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
     },
 
     store: {
-      /** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+      /** 상점 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
       get: () => http.request("GET", "/store", storefrontStoreSchema),
     },
 
@@ -305,10 +305,10 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
        * `@sayren/storefront-sdk/payments`의 `createPayments().start()`다 — 이 메서드는 값만 받는다.
        *
        * 에러(`ApiError.code`):
-       * - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 스토어에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
+       * - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 상점에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
        * - 409 `PAYMENT_NOT_CONFIGURED`: 사용 중인 PG가 없다
        * - 400 `RETURN_URL_NOT_ALLOWED`: `returnUrl`이 https가 아니거나(테스트 결제의 localhost는 예외),
-       *   스토어가 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
+       *   상점이 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
        * - 503 `PAYMENT_PROVIDER_UNAVAILABLE`: 고른 PG의 결제창을 준비하지 못했다(다른 옵션으로 다시 시도)
        */
       startPayment: (checkoutId: string, body: StartPaymentRequest) =>
@@ -336,7 +336,7 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
        * `expiresAt`까지 폴링한다. `completed`면 `orderId`로 완료 화면, `failed`·`expired`면 실패 안내다.
        * TTL이 지난 `pending`은 `expired`로 보고된다. `testPayment`는 완료면 주문 플래그, 아니면 세션 환경이다.
        *
-       * 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 스토어) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
+       * 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 상점) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
        */
       getStatus: (paymentId: string) =>
         http.request("GET", path`/payments/${paymentId}`, paymentStatusSchema),
@@ -359,7 +359,7 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
        *
        * 에러: 404 `ORDER_NOT_FOUND`(주문이 없거나 연락처·비밀번호가 다름 — 둘을 구분하지 않는다) ·
        * 429 `TOO_MANY_REQUESTS`(주문번호마다 10분에 5번까지 확인하고, 5번째가 틀리면 30분 잠금.
-       * 주문번호마다 하루 15번, 스토어 전체 분당 한도도 있다. 남은 시간은 `ApiError.details.retryAfterSeconds`).
+       * 주문번호마다 하루 15번, 상점 전체 분당 한도도 있다. 남은 시간은 `ApiError.details.retryAfterSeconds`).
        * 맞게 조회하면 주문번호의 횟수가 초기화된다. 본문 형식은 `guestInfoSchema`의 `phone`·`orderPassword`와 같다.
        * 429는 연락처·비밀번호가 맞아도 난다 — 「잠시 후 다시 시도」로 안내한다.
        */

package/src/payments/index.ts

@@ -229,7 +229,7 @@ function browserEnv(): PaymentsEnv {
 
 export interface PaymentsOptions {
   client: StorefrontClient;
-  /** 결제를 마치면 돌아올 주소(스토어 결제 도메인 안). `start`·`retry`에서 바꿀 수 있다 */
+  /** 결제를 마치면 돌아올 주소(상점 결제 도메인 안). `start`·`retry`에서 바꿀 수 있다 */
   returnUrl?: string;
   env?: PaymentsEnv;
 }

package/src/schemas/checkout.ts

@@ -50,7 +50,7 @@ export const checkoutDeliverySchema = z.object({
   bundleCount: z.number().int().describe("배송 묶음 수 — 배송비를 부과한 횟수다"),
   freeByThreshold: z
     .boolean()
-    .describe("스토어 전체 무료배송 기준액을 넘겨 기본 배송비를 면제했는가"),
+    .describe("상점 전체 무료배송 기준액을 넘겨 기본 배송비를 면제했는가"),
   zipCode: z
     .string()
     .nullable()
@@ -127,7 +127,7 @@ export const checkoutSessionSchema = z.object({
   testPayment: z
     .boolean()
     .describe(
-      "지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다",
+      "지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 상점 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다",
     ),
 });
 
@@ -165,7 +165,7 @@ export const paymentMethodSchema = z.enum([
 
 export type PaymentMethod = z.infer<typeof paymentMethodSchema>;
 
-/** 결제를 처리하는 PG. 셀러가 직접 계약하고 콘솔 설정 › 결제에서 연결한다 */
+/** 결제를 처리하는 PG. 셀러가 직접 계약하고 상점 플랫폼 설정 › 결제에서 연결한다 */
 export const pgProviderSchema = z.enum(["tosspayments", "portone"]);
 export type PgProvider = z.infer<typeof pgProviderSchema>;
 
@@ -373,7 +373,7 @@ const cashReceiptField = cashReceiptRequestSchema
 /**
  * 결제 시작 — 배송지를 확정하고 고른 결제 옵션으로 결제 시도를 연다. 응답의 `payUrl`(결제 서비스)을 팝업(`mode=popup`)이나
  * 전체 페이지로 열면 결제 서비스가 PG 결제창을 띄우고 승인까지 한다. 리다이렉트 결제가 끝나면 구매자는 `returnUrl`로 돌아온다.
- * `returnUrl`의 도메인은 스토어 결제 도메인(콘솔 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
+ * `returnUrl`의 도메인은 상점 결제 도메인(상점 플랫폼 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
  */
 export const startPaymentRequestSchema = z.object({
   option: paymentOptionSchema,
@@ -381,7 +381,7 @@ export const startPaymentRequestSchema = z.object({
     .url()
     .max(2048)
     .describe(
-      "결제를 마치면 돌아올 스토어프론트 주소. 스토어 결제 도메인에 등록된 도메인이어야 한다",
+      "결제를 마치면 돌아올 스토어프론트 주소. 상점 결제 도메인에 등록된 도메인이어야 한다",
     ),
   shippingAddress: shippingAddressInputSchema
     .optional()

package/src/schemas/claim.ts

@@ -76,10 +76,10 @@ export const createClaimResultSchema = z.object({
 export type CreateClaimResult = z.infer<typeof createClaimResultSchema>;
 
 /**
- * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 스토어 주소록의 기본 반품지이거나,
+ * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 상점 주소록의 기본 반품지이거나,
  * 상품이 반품지를 따로 지정했으면 그 주소다.
  *
- * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 스토어도 null이다.
+ * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 상점도 null이다.
  * 구매자가 직접 보내는 수거(`BUYER_SEND`)에 이 주소가 필요하다.
  */
 export const claimReturnAddressSchema = z.object({

package/src/schemas/consent.ts

@@ -32,11 +32,11 @@ export const consentStateSchema = z.object({
   agreed: z.boolean(),
   /** 동의한 약관 버전. 마케팅은 버전이 없어 null이고, 동의 이력이 없으면 null이다 */
   agreedVersion: z.string().nullable(),
-  /** 스토어의 현재 약관 버전. 마케팅은 null */
+  /** 상점의 현재 약관 버전. 마케팅은 null */
   currentVersion: z.string().nullable(),
   /**
-   * 스토어가 정한 현재 약관 문서 주소. 재동의 화면에서 이 주소를 보여 준다.
-   * 스토어가 정하지 않았거나 마케팅이면 null이다(동의한 시점의 주소는 셀러가 보는 이력에 남는다).
+   * 상점이 정한 현재 약관 문서 주소. 재동의 화면에서 이 주소를 보여 준다.
+   * 상점이 정하지 않았거나 마케팅이면 null이다(동의한 시점의 주소는 셀러가 보는 이력에 남는다).
    */
   currentDocumentUrl: z.string().nullable(),
   /** 마지막으로 동의·철회한 시각. 이력이 없으면 null */

package/src/schemas/member.ts

@@ -13,7 +13,7 @@ export const memberSchema = z.object({
     .boolean()
     .describe(
       "약관이 개정돼 필수 동의를 다시 받아야 하는가. true면 `GET /me/consents`로 어떤 항목인지 확인하고 " +
-        "`POST /me/consents`로 받는다. 받기 전에도 스토어 이용은 막히지 않는다",
+        "`POST /me/consents`로 받는다. 받기 전에도 상점 이용은 막히지 않는다",
     ),
 });
 

package/src/schemas/product-options.ts

@@ -52,7 +52,7 @@ export function normalizeCustomInputValue(value: string): string {
 
 /**
  * 직접 입력값의 글자 수 — 정규화한 값의 **코드 포인트 수**다(이모지 하나가 1자). 서버의 최대 글자 수 판정(`CUSTOM_INPUT_TOO_LONG`)과
- * 스토어프론트·콘솔의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
+ * 스토어프론트·상점 플랫폼의 글자 수 표시가 이 함수 하나를 쓴다. `String.length`(UTF-16)로 세면 이모지가 2자로 세어 판정이 갈린다.
  */
 export function customInputLength(value: string): number {
   return [...normalizeCustomInputValue(value)].length;

package/src/schemas/store.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 
 /**
- * 스토어 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
+ * 상점 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
  */
 export const storefrontStoreSchema = z.object({
   storeCode: z.string(),
@@ -18,6 +18,38 @@ export const storefrontStoreSchema = z.object({
    * 켜진 로그인 방법 — 화면에 이 순서대로 버튼을 그리면 된다. `password`가 없으면 이메일·비밀번호 가입·로그인이 꺼져 있다
    */
   loginMethods: z.array(z.enum(["password", "kakao", "naver", "google"])),
+  /**
+   * 지금 주문(결제)을 받을 수 있는가(이슈 #70). false면 결제 요청(`POST /checkout/{checkoutId}/payment`)이 409
+   * `PAYMENT_NOT_CONFIGURED`다. 장바구니·주문 버튼을 숨기거나 문의 안내로 바꾸면 된다. 장바구니 담기·주문서 생성은 막지 않는다
+   */
+  checkoutAvailable: z
+    .boolean()
+    .optional()
+    .default(true)
+    .describe(
+      "지금 주문(결제)을 받을 수 있는가. false면 결제 요청이 409 `PAYMENT_NOT_CONFIGURED`이므로 장바구니·주문 버튼을 숨기거나 문의 안내로 바꾸면 된다. 서버는 항상 싣는다",
+    ),
+  /** 주문을 받을 때의 결제 환경 — `TEST`면 테스트 결제(돈이 오가지 않는다)다. 주문을 받지 않으면 null */
+  checkoutMode: z
+    .enum(["LIVE", "TEST"])
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "주문을 받을 때의 결제 환경. `TEST`면 테스트 결제라 돈이 오가지 않는다. 주문을 받지 않으면 null. 서버는 항상 싣는다",
+    ),
+  /**
+   * 주문을 받지 않는 사유 — `PAYMENT_NOT_CONFIGURED`(사용 중인 결제 수단 없음), `PAYMENT_NOT_LIVE`(공개한 쇼핑몰인데 실결제가
+   * 아직 열리지 않음). 주문을 받으면 null
+   */
+  checkoutUnavailableReason: z
+    .enum(["PAYMENT_NOT_CONFIGURED", "PAYMENT_NOT_LIVE"])
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "주문을 받지 않는 사유. `PAYMENT_NOT_CONFIGURED`는 사용 중인 결제 수단이 없음, `PAYMENT_NOT_LIVE`는 공개한 쇼핑몰인데 실결제가 아직 열리지 않음이다. 주문을 받으면 null. 서버는 항상 싣는다",
+    ),
 });
 
 export type StorefrontStore = z.infer<typeof storefrontStoreSchema>;

package/src/session.ts

@@ -30,7 +30,7 @@ const REFRESH_LOCK = STOREFRONT_SESSION_KEYS.refreshToken;
 export interface StorefrontSessionOptions {
   /** 예: https://shop.api.example.com/storefront/v1 */
   baseUrl: string;
-  /** 테넌트 스토어 코드 — X-Store-Code 헤더로 전송한다 */
+  /** 테넌트 상점 코드 — X-Store-Code 헤더로 전송한다 */
   storeCode?: string;
   /** 저장 매체 어댑터 (앱 소유) */
   storage: SessionStorage;