@sayren/storefront-sdk 0.11.0 → 0.11.1

package/dist/auth/index.mjs

@@ -1,10 +1,10 @@
-import { pt as ApiError, t as createStorefrontClient } from "../client-CHfCafer.mjs";
+import { pt as ApiError, t as createStorefrontClient } from "../client-Do4cw2Ez.mjs";
 //#region src/auth/index.ts
 /** 소셜 로그인 실패 — 구매자가 취소했거나(`access_denied`) state가 맞지 않는다 */
 var IdpCallbackError = class extends Error {
 	reason;
 	constructor(reason) {
-		super(`소셜 로그인을 마치지 못했어요 (${reason})`);
+		super(`소셜 로그인을 마치지 못했습니다 (${reason})`);
 		this.reason = reason;
 		this.name = "IdpCallbackError";
 	}

package/dist/{checkout-CHpxo2Ap.mjs → checkout-BeZKjYJz.mjs}

@@ -53,14 +53,14 @@ const checkoutSessionSchema = z.object({
 	delivery: checkoutDeliverySchema.describe("배송비 내역. 배송지를 입력하면 금액이 바뀔 수 있다 — 최종 금액은 결제 시작 응답의 `amounts`다"),
 	expiresAt: z.string(),
 	paymentOptions: z.lazy(() => paymentOptionListSchema).describe("이 주문서에서 고를 수 있는 결제 옵션, PG 우선순위순. 셀러가 켠 PG·결제수단·간편결제만 담긴다. 비어 있으면 지금 결제할 수 없다"),
-	testPayment: z.boolean().describe("지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않아요 — 주문서에 테스트 결제 안내를 표시해요. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`예요")
+	testPayment: z.boolean().describe("지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다")
 });
 /**
 * 배송비 미리보기 요청 — 배송지 우편번호로 배송비를 다시 계산한다. 주문서를 바꾸지 않는다(읽기 계산이다).
 *
 * 구매자가 배송지를 입력하거나 고칠 때 부르면 제주·도서산간 추가 배송비가 반영된 금액을 미리 보여 줄 수 있다.
 */
-const deliveryQuoteRequestSchema = z.object({ zipCode: z.string().regex(/^[0-9]{5}$/, "우편번호 5자리를 입력해 주세요").describe("배송지 우편번호 5자리") });
+const deliveryQuoteRequestSchema = z.object({ zipCode: z.string().regex(/^[0-9]{5}$/, "우편번호 5자리를 입력해 주십시오").describe("배송지 우편번호 5자리") });
 /** 배송비 미리보기 응답 — 이 배송지로 결제하면 나갈 금액이다 */
 const deliveryQuoteSchema = z.object({
 	amounts: checkoutSessionSchema.shape.amounts.describe("이 배송지 기준 금액"),
@@ -134,10 +134,10 @@ function paymentOptionKey(option) {
 }
 const shippingAddressInputSchema = z.object({
 	addressId: z.string().optional(),
-	receiverName: z.string().min(1, "수령인명을 입력해주세요").max(50),
+	receiverName: z.string().min(1, "수령인명을 입력해주십시오").max(50),
 	phone: z.string().regex(/^01[0-9]{8,9}$/, "연락처 형식이 아닙니다 (예: 01012345678)"),
 	zipCode: z.string().regex(/^[0-9]{5}$/, "우편번호는 5자리 숫자입니다"),
-	address1: z.string().min(1, "기본 주소를 입력해주세요"),
+	address1: z.string().min(1, "기본 주소를 입력해주십시오"),
 	address2: z.string().optional(),
 	deliveryMemo: z.string().max(100).optional(),
 	entranceCode: z.string().max(20).optional()
@@ -213,14 +213,14 @@ const cashReceiptRequestSchema = z.object({
 		ctx.addIssue({
 			code: "custom",
 			path: ["identityNumber"],
-			message: "주민등록번호는 현금영수증 식별 번호로 쓸 수 없어요. 휴대폰 번호 또는 현금영수증카드 번호를 입력해주세요 (RESIDENT_NUMBER_NOT_ALLOWED)"
+			message: "주민등록번호는 현금영수증 식별 번호로 쓸 수 없습니다. 휴대폰 번호 또는 현금영수증카드 번호를 입력해주십시오 (RESIDENT_NUMBER_NOT_ALLOWED)"
 		});
 		return;
 	}
 	if (!cashReceiptIdentityTypeOf(value.type, value.identityNumber)) ctx.addIssue({
 		code: "custom",
 		path: ["identityNumber"],
-		message: value.type === "INCOME_DEDUCTION" ? "휴대폰 번호 또는 현금영수증카드 번호를 입력해주세요" : "사업자등록번호(10자리) 또는 현금영수증카드 번호를 입력해주세요"
+		message: value.type === "INCOME_DEDUCTION" ? "휴대폰 번호 또는 현금영수증카드 번호를 입력해주십시오" : "사업자등록번호(10자리) 또는 현금영수증카드 번호를 입력해주십시오"
 	});
 });
 const cashReceiptField = cashReceiptRequestSchema.optional().describe("현금영수증 신청. 계좌이체·가상계좌 옵션에서만 보낼 수 있다(그 밖의 옵션이면 400 `CASH_RECEIPT_NOT_AVAILABLE`). 결제가 승인되면 발급한다");
@@ -284,16 +284,16 @@ const PAYMENT_RESULT_VALUES = [
 ];
 const paymentStatusSchema = z.object({
 	paymentId: z.string(),
-	status: z.string().describe("결제 상태. 현재 값은 `pending` 결제 대기 · `processing` 승인 확인 중 · `completed` 결제 완료(주문 생성) · `failed` 실패 · `expired` 만료예요. 상태가 추가될 수 있어 문자열로 받아요 — 모르는 값은 `processing`처럼 다루고 계속 조회하세요"),
-	result: z.string().describe("화면 분기용 결과. `COMPLETED` 결제 완료 · `PROCESSING` 결과 확인 중 · `CANCELED` 구매자가 결제창을 닫음 · `FAILED` 결제 실패(다른 결제 옵션으로 재시도 가능) · `EXPIRED` 결제 요청 만료 · `PENDING` 결제 전이에요. 값이 추가될 수 있어 문자열로 받아요 — 모르는 값은 `PROCESSING`처럼 다루세요"),
+	status: z.string().describe("결제 상태. 현재 값은 `pending` 결제 대기 · `processing` 승인 확인 중 · `completed` 결제 완료(주문 생성) · `failed` 실패 · `expired` 만료입니다. 상태가 추가될 수 있어 문자열로 받습니다 — 모르는 값은 `processing`처럼 다루고 계속 조회하십시오"),
+	result: z.string().describe("화면 분기용 결과. `COMPLETED` 결제 완료 · `PROCESSING` 결과 확인 중 · `CANCELED` 구매자가 결제창을 닫음 · `FAILED` 결제 실패(다른 결제 옵션으로 재시도 가능) · `EXPIRED` 결제 요청 만료 · `PENDING` 결제 전입니다. 값이 추가될 수 있어 문자열로 받습니다 — 모르는 값은 `PROCESSING`처럼 다루십시오"),
 	orderId: z.string().nullable().describe("결제가 완료됐으면 주문 번호, 그 외에는 null"),
 	lastFailure: z.object({
 		attemptId: z.string(),
 		category: z.string().describe("`PREPARE_FAILURE`·`DECLINED`·`USER_CANCELED`(값이 추가될 수 있다)"),
-		code: z.string().nullable().describe("PG가 준 실패 코드. 내부 사유는 null이에요. 화면 분기는 `category`로 하세요"),
+		code: z.string().nullable().describe("PG가 준 실패 코드. 내부 사유는 null입니다. 화면 분기는 `category`로 하십시오"),
 		message: z.string().nullable().describe("구매자에게 보여 줄 안내 문구")
 	}).nullable().describe("현재 결제 시도가 실패·취소로 끝났으면 그 내용, 아니면 null"),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않았어요"),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않았습니다"),
 	expiresAt: z.string().describe("결제 요청 만료 시각")
 });
 /**

package/dist/{client-CHfCafer.mjs → client-Do4cw2Ez.mjs}

@@ -1,5 +1,5 @@
 import { a as ANALYTICS_VISITOR_HEADER, r as ANALYTICS_SESSION_HEADER } from "./analytics-CgD70OqH.mjs";
-import { A as startPaymentRequestSchema, C as paymentStartSchema, O as retryPaymentRequestSchema, d as createCheckoutRequestSchema, f as deliveryQuoteRequestSchema, m as easyPayProviderResponseSchema, p as deliveryQuoteSchema, u as checkoutSessionSchema, w as paymentStatusSchema, y as paymentMethodSchema } from "./checkout-CHpxo2Ap.mjs";
+import { A as startPaymentRequestSchema, C as paymentStartSchema, O as retryPaymentRequestSchema, d as createCheckoutRequestSchema, f as deliveryQuoteRequestSchema, m as easyPayProviderResponseSchema, p as deliveryQuoteSchema, u as checkoutSessionSchema, w as paymentStatusSchema, y as paymentMethodSchema } from "./checkout-BeZKjYJz.mjs";
 import { z } from "zod";
 //#region src/http.ts
 /** 표준 엔벨로프의 $.error 상세 */
@@ -636,7 +636,7 @@ const myOrderSchema = z.object({
 		paidAt: z.string().nullable(),
 		receiptUrl: z.url().nullable()
 	}),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 나가지 않았어요 — 주문 화면에 테스트 결제 배지를 표시해요")
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 나가지 않았습니다 — 주문 화면에 테스트 결제 배지를 표시합니다")
 });
 /**
 * 택배 추적 단계. 응답에서는 문자열로 받는다(값이 추가될 수 있다) — 현재 값은 `ACCEPTED`(접수)·`IN_TRANSIT`(이동 중)·
@@ -697,7 +697,7 @@ const writableReviewSchema = z.object({
 });
 const createReviewRequestSchema = z.object({
 	rating: z.number().int().min(1).max(5),
-	content: z.string().min(10, "리뷰는 10자 이상 작성해주세요").max(2e3),
+	content: z.string().min(10, "리뷰는 10자 이상 작성해주십시오").max(2e3),
 	images: z.array(z.url()).max(5).optional()
 });
 const createReviewResultSchema = z.object({

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-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";
+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-Do4cw2Ez.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-BeZKjYJz.mjs";
 //#region src/session.ts
 /** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */
 const STOREFRONT_SESSION_KEYS = {

package/dist/payments/index.mjs

@@ -1,4 +1,4 @@
-import { v as paymentMessageSchema } from "../checkout-CHpxo2Ap.mjs";
+import { v as paymentMessageSchema } from "../checkout-BeZKjYJz.mjs";
 //#region src/payments/index.ts
 /** 복귀 주소에 결제 서비스가 붙이는 쿼리 */
 const RETURN_PAYMENT_ID = "sayrenPaymentId";
@@ -51,19 +51,19 @@ function paymentResultOf(status, options = {}) {
 		status: "CANCELED",
 		paymentId,
 		code: lastFailure?.code ?? "USER_CANCELED",
-		message: lastFailure?.message ?? "결제를 취소했어요"
+		message: lastFailure?.message ?? "결제를 취소했습니다"
 	};
 	if (result === "FAILED" || result === "EXPIRED") return {
 		status: "FAILED",
 		paymentId,
 		code: lastFailure?.code ?? result,
-		message: lastFailure?.message ?? (result === "EXPIRED" ? "결제 요청이 만료됐어요" : "결제에 실패했어요")
+		message: lastFailure?.message ?? (result === "EXPIRED" ? "결제 요청이 만료됐습니다" : "결제에 실패했습니다")
 	};
 	if (result === "PENDING") return options.popupClosed ? {
 		status: "CANCELED",
 		paymentId,
 		code: "POPUP_CLOSED",
-		message: "결제창을 닫았어요"
+		message: "결제창을 닫았습니다"
 	} : {
 		status: "PROCESSING",
 		paymentId
@@ -147,7 +147,7 @@ function createPayments(options) {
 		} catch {
 			return;
 		}
-		console.warn(`[sayren] returnUrl(${returnUrl})의 origin이 지금 페이지와 달라요 — 결제 서비스는 그 origin으로 결과 메시지를 보내므로 팝업 결과가 도달하지 않고 결제 상태 조회로만 끝나요`);
+		console.warn(`[sayren] returnUrl(${returnUrl})의 origin이 지금 페이지와 다릅니다 — 결제 서비스는 그 origin으로 결과 메시지를 보내므로 팝업 결과가 도달하지 않고 결제 상태 조회로만 끝납니다`);
 	}
 	function prepareWindow(prepareOptions = {}) {
 		stopWatch();
@@ -165,7 +165,7 @@ function createPayments(options) {
 	*/
 	function resolvePrepared(given, mode) {
 		if (!given) return prepareWindow({ mode });
-		if (given[PREPARED_WINDOW] !== brand) throw new TypeError("window는 같은 createPayments의 prepareWindow()가 돌려준 핸들이어야 해요");
+		if (given[PREPARED_WINDOW] !== brand) throw new TypeError("window는 같은 createPayments의 prepareWindow()가 돌려준 핸들이어야 합니다");
 		return given;
 	}
 	/**
@@ -281,7 +281,7 @@ function createPayments(options) {
 			const returnUrl = startOptions.returnUrl ?? options.returnUrl;
 			if (!returnUrl) {
 				prepared.close();
-				return Promise.reject(/* @__PURE__ */ new Error("returnUrl이 필요해요 — createPayments 또는 start에 넘겨 주세요"));
+				return Promise.reject(/* @__PURE__ */ new Error("returnUrl이 필요합니다 — createPayments 또는 start에 넘겨 주십시오"));
 			}
 			warnReturnOrigin(returnUrl, prepared.mode);
 			return startWith(prepared, () => client.checkout.startPayment(checkoutId, {
@@ -312,7 +312,7 @@ function createPayments(options) {
 			}
 			if (!paymentId) return {
 				status: "INVALID",
-				message: "결제 정보가 없는 주소예요"
+				message: "결제 정보가 없는 주소입니다"
 			};
 			return paymentResultOf(await client.payments.getStatus(paymentId));
 		}

package/package.json

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

package/src/auth/index.ts

@@ -48,7 +48,7 @@ export class IdpCallbackError extends Error {
   constructor(
     public readonly reason: "access_denied" | "state_mismatch" | "missing_code" | string,
   ) {
-    super(`소셜 로그인을 마치지 못했어요 (${reason})`);
+    super(`소셜 로그인을 마치지 못했습니다 (${reason})`);
     this.name = "IdpCallbackError";
   }
 }

package/src/payments/index.ts

@@ -168,7 +168,7 @@ export function paymentResultOf(
       status: "CANCELED",
       paymentId,
       code: lastFailure?.code ?? "USER_CANCELED",
-      message: lastFailure?.message ?? "결제를 취소했어요",
+      message: lastFailure?.message ?? "결제를 취소했습니다",
     };
   }
   if (result === "FAILED" || result === "EXPIRED") {
@@ -178,13 +178,13 @@ export function paymentResultOf(
       code: lastFailure?.code ?? result,
       message:
         lastFailure?.message ??
-        (result === "EXPIRED" ? "결제 요청이 만료됐어요" : "결제에 실패했어요"),
+        (result === "EXPIRED" ? "결제 요청이 만료됐습니다" : "결제에 실패했습니다"),
     };
   }
   if (result === "PENDING") {
     // 결제창이 닫혔는데 아직 결제 전이면 구매자가 닫은 것이다
     return options.popupClosed
-      ? { status: "CANCELED", paymentId, code: "POPUP_CLOSED", message: "결제창을 닫았어요" }
+      ? { status: "CANCELED", paymentId, code: "POPUP_CLOSED", message: "결제창을 닫았습니다" }
       : { status: "PROCESSING", paymentId };
   }
   return { status: "PROCESSING", paymentId };
@@ -340,7 +340,7 @@ export function createPayments(options: PaymentsOptions): Payments {
       return; // 주소를 읽지 못하면 검사하지 않는다
     }
     console.warn(
-      `[sayren] returnUrl(${returnUrl})의 origin이 지금 페이지와 달라요 — 결제 서비스는 그 origin으로 결과 메시지를 보내므로 팝업 결과가 도달하지 않고 결제 상태 조회로만 끝나요`,
+      `[sayren] returnUrl(${returnUrl})의 origin이 지금 페이지와 다릅니다 — 결제 서비스는 그 origin으로 결과 메시지를 보내므로 팝업 결과가 도달하지 않고 결제 상태 조회로만 끝납니다`,
     );
   }
 
@@ -369,7 +369,7 @@ export function createPayments(options: PaymentsOptions): Payments {
     if (!given) return prepareWindow({ mode });
     if ((given as Partial<PreparedWindowInternal>)[PREPARED_WINDOW] !== brand) {
       throw new TypeError(
-        "window는 같은 createPayments의 prepareWindow()가 돌려준 핸들이어야 해요",
+        "window는 같은 createPayments의 prepareWindow()가 돌려준 핸들이어야 합니다",
       );
     }
     return given as PreparedWindowInternal;
@@ -517,7 +517,7 @@ export function createPayments(options: PaymentsOptions): Payments {
       if (!returnUrl) {
         prepared.close();
         return Promise.reject(
-          new Error("returnUrl이 필요해요 — createPayments 또는 start에 넘겨 주세요"),
+          new Error("returnUrl이 필요합니다 — createPayments 또는 start에 넘겨 주십시오"),
         );
       }
       warnReturnOrigin(returnUrl, prepared.mode);
@@ -554,7 +554,7 @@ export function createPayments(options: PaymentsOptions): Payments {
       } catch {
         paymentId = null;
       }
-      if (!paymentId) return { status: "INVALID", message: "결제 정보가 없는 주소예요" };
+      if (!paymentId) return { status: "INVALID", message: "결제 정보가 없는 주소입니다" };
       return paymentResultOf(await client.payments.getStatus(paymentId));
     },
   };

package/src/schemas/checkout.ts

@@ -86,7 +86,7 @@ export const checkoutSessionSchema = z.object({
   testPayment: z
     .boolean()
     .describe(
-      "지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않아요 — 주문서에 테스트 결제 안내를 표시해요. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`예요",
+      "지금 결제하면 테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않습니다 — 주문서에 테스트 결제 안내를 표시합니다. 결제 요청 시점에 스토어 결제 설정으로 다시 정해지니 최종 값은 결제 요청 응답의 `testPayment`입니다",
     ),
 });
 
@@ -100,7 +100,7 @@ export type CheckoutSession = z.infer<typeof checkoutSessionSchema>;
 export const deliveryQuoteRequestSchema = z.object({
   zipCode: z
     .string()
-    .regex(/^[0-9]{5}$/, "우편번호 5자리를 입력해 주세요")
+    .regex(/^[0-9]{5}$/, "우편번호 5자리를 입력해 주십시오")
     .describe("배송지 우편번호 5자리"),
 });
 
@@ -190,10 +190,10 @@ export function paymentOptionKey(option: PaymentOption): string {
 
 export const shippingAddressInputSchema = z.object({
   addressId: z.string().optional(),
-  receiverName: z.string().min(1, "수령인명을 입력해주세요").max(50),
+  receiverName: z.string().min(1, "수령인명을 입력해주십시오").max(50),
   phone: z.string().regex(/^01[0-9]{8,9}$/, "연락처 형식이 아닙니다 (예: 01012345678)"),
   zipCode: z.string().regex(/^[0-9]{5}$/, "우편번호는 5자리 숫자입니다"),
-  address1: z.string().min(1, "기본 주소를 입력해주세요"),
+  address1: z.string().min(1, "기본 주소를 입력해주십시오"),
   address2: z.string().optional(),
   deliveryMemo: z.string().max(100).optional(),
   entranceCode: z.string().max(20).optional(),
@@ -302,8 +302,8 @@ export const cashReceiptRequestSchema = z
         code: "custom",
         path: ["identityNumber"],
         message:
-          "주민등록번호는 현금영수증 식별 번호로 쓸 수 없어요. " +
-          "휴대폰 번호 또는 현금영수증카드 번호를 입력해주세요 (RESIDENT_NUMBER_NOT_ALLOWED)",
+          "주민등록번호는 현금영수증 식별 번호로 쓸 수 없습니다. " +
+          "휴대폰 번호 또는 현금영수증카드 번호를 입력해주십시오 (RESIDENT_NUMBER_NOT_ALLOWED)",
       });
       return;
     }
@@ -313,8 +313,8 @@ export const cashReceiptRequestSchema = z
         path: ["identityNumber"],
         message:
           value.type === "INCOME_DEDUCTION"
-            ? "휴대폰 번호 또는 현금영수증카드 번호를 입력해주세요"
-            : "사업자등록번호(10자리) 또는 현금영수증카드 번호를 입력해주세요",
+            ? "휴대폰 번호 또는 현금영수증카드 번호를 입력해주십시오"
+            : "사업자등록번호(10자리) 또는 현금영수증카드 번호를 입력해주십시오",
       });
     }
   });
@@ -422,14 +422,14 @@ export const paymentStatusSchema = z.object({
     .string()
     .describe(
       "결제 상태. 현재 값은 `pending` 결제 대기 · `processing` 승인 확인 중 · `completed` 결제 완료(주문 생성) · `failed` 실패 · " +
-        "`expired` 만료예요. 상태가 추가될 수 있어 문자열로 받아요 — 모르는 값은 `processing`처럼 다루고 계속 조회하세요",
+        "`expired` 만료입니다. 상태가 추가될 수 있어 문자열로 받습니다 — 모르는 값은 `processing`처럼 다루고 계속 조회하십시오",
     ),
   result: z
     .string()
     .describe(
       "화면 분기용 결과. `COMPLETED` 결제 완료 · `PROCESSING` 결과 확인 중 · `CANCELED` 구매자가 결제창을 닫음 · " +
-        "`FAILED` 결제 실패(다른 결제 옵션으로 재시도 가능) · `EXPIRED` 결제 요청 만료 · `PENDING` 결제 전이에요. " +
-        "값이 추가될 수 있어 문자열로 받아요 — 모르는 값은 `PROCESSING`처럼 다루세요",
+        "`FAILED` 결제 실패(다른 결제 옵션으로 재시도 가능) · `EXPIRED` 결제 요청 만료 · `PENDING` 결제 전입니다. " +
+        "값이 추가될 수 있어 문자열로 받습니다 — 모르는 값은 `PROCESSING`처럼 다루십시오",
     ),
   orderId: z.string().nullable().describe("결제가 완료됐으면 주문 번호, 그 외에는 null"),
   lastFailure: z
@@ -441,14 +441,14 @@ export const paymentStatusSchema = z.object({
       code: z
         .string()
         .nullable()
-        .describe("PG가 준 실패 코드. 내부 사유는 null이에요. 화면 분기는 `category`로 하세요"),
+        .describe("PG가 준 실패 코드. 내부 사유는 null입니다. 화면 분기는 `category`로 하십시오"),
       message: z.string().nullable().describe("구매자에게 보여 줄 안내 문구"),
     })
     .nullable()
     .describe("현재 결제 시도가 실패·취소로 끝났으면 그 내용, 아니면 null"),
   testPayment: z
     .boolean()
-    .describe("테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않았어요"),
+    .describe("테스트 결제(샌드박스)인가. true면 실제로 돈이 나가지 않았습니다"),
   expiresAt: z.string().describe("결제 요청 만료 시각"),
 });
 

package/src/schemas/order.ts

@@ -73,7 +73,7 @@ export const myOrderSchema = z.object({
   testPayment: z
     .boolean()
     .describe(
-      "테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 나가지 않았어요 — 주문 화면에 테스트 결제 배지를 표시해요",
+      "테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 나가지 않았습니다 — 주문 화면에 테스트 결제 배지를 표시합니다",
     ),
 });
 

package/src/schemas/review.ts

@@ -40,7 +40,7 @@ export type WritableReview = z.infer<typeof writableReviewSchema>;
 
 export const createReviewRequestSchema = z.object({
   rating: z.number().int().min(1).max(5),
-  content: z.string().min(10, "리뷰는 10자 이상 작성해주세요").max(2000),
+  content: z.string().min(10, "리뷰는 10자 이상 작성해주십시오").max(2000),
   images: z.array(z.url()).max(5).optional(),
 });