@sayren/mcp 0.5.0 → 0.5.2

package/dist/index.mjs

@@ -142,14 +142,14 @@ function buildPath(template, params) {
 	const used = /* @__PURE__ */ new Set();
 	const path = template.replace(/\{([^}]+)\}/g, (_match, name) => {
 		const value = params[name];
-		if (value === void 0 || value === "") throw new Error(`경로 값이 없어요: ${name}`);
+		if (value === void 0 || value === "") throw new Error(`경로 값이 없습니다: ${name}`);
 		const text$1 = String(value);
-		if (text$1 === "." || text$1 === ".." || !SAFE_SEGMENT.test(text$1)) throw new Error(`쓸 수 없는 경로 값이에요: ${name}`);
+		if (text$1 === "." || text$1 === ".." || !SAFE_SEGMENT.test(text$1)) throw new Error(`쓸 수 없는 경로 값입니다: ${name}`);
 		used.add(name);
 		return encodeURIComponent(text$1);
 	});
 	const extra = Object.keys(params).filter((name) => !used.has(name));
-	if (extra.length) throw new Error(`경로에 없는 값이에요: ${extra.join(", ")}`);
+	if (extra.length) throw new Error(`경로에 없는 값입니다: ${extra.join(", ")}`);
 	return path;
 }
 /**
@@ -163,7 +163,7 @@ function truncateData(data, maxChars) {
 		while (kept > 0 && JSON.stringify(rebuild(items.slice(0, kept))).length > maxChars) kept = Math.floor(kept / 2);
 		return {
 			data: rebuild(items.slice(0, kept)),
-			truncated: `목록 ${items.length}개 중 ${kept}개만 실었어요. size·page로 나눠 조회하세요`
+			truncated: `목록 ${items.length}개 중 ${kept}개만 실었습니다. size·page로 나눠 조회하십시오`
 		};
 	};
 	if (Array.isArray(data)) return shrink(data, (kept) => kept);
@@ -175,29 +175,29 @@ function truncateData(data, maxChars) {
 	const text$1 = JSON.stringify(data);
 	return {
 		data: `${text$1.slice(0, maxChars)}…`,
-		truncated: `응답 ${text$1.length}자 중 ${maxChars}자만 실었어요`
+		truncated: `응답 ${text$1.length}자 중 ${maxChars}자만 실었습니다`
 	};
 }
 /** 같은 멱등키의 승인이 끝났을 때 상태별 안내 — 에이전트가 다음에 할 일 */
 const DECIDED_GUIDE = {
 	SUCCEEDED: {
-		message: "이 멱등키의 요청은 셀러가 승인해서 이미 실행됐어요. 다시 실행하지 않았어요",
+		message: "이 멱등키의 요청은 셀러가 승인해서 이미 실행됐습니다. 다시 실행하지 않았습니다",
 		nextSteps: ["실행 결과는 `result`다. 같은 요청을 다시 보내지 않는다"]
 	},
 	FAILED: {
-		message: "이 멱등키의 요청은 승인 뒤 실행했지만 실패했어요",
+		message: "이 멱등키의 요청은 승인 뒤 실행했지만 실패했습니다",
 		nextSteps: ["`result.error`로 원인을 사용자에게 알린다", "고쳐서 다시 하려면 새 멱등키로 요청한다(같은 키는 이 결과만 돌려준다)"]
 	},
 	UNKNOWN: {
-		message: "이 멱등키의 요청은 승인 뒤 실행 결과를 확인하지 못했어요. 이미 실행됐을 수 있어요",
+		message: "이 멱등키의 요청은 승인 뒤 실행 결과를 확인하지 못했습니다. 이미 실행됐을 수 있습니다",
 		nextSteps: ["다시 보내지 않는다. 대상 리소스를 조회해 바뀌었는지 확인하고 사용자에게 알린다", "셀러에게 콘솔의 감사 로그에서 실행 여부를 확인해 달라고 전한다"]
 	},
 	REJECTED: {
-		message: "이 멱등키의 요청은 셀러가 거절했어요. 아무것도 바뀌지 않았어요",
+		message: "이 멱등키의 요청은 셀러가 거절했습니다. 아무것도 바뀌지 않았습니다",
 		nextSteps: ["거절 사유(`decisionNote`)를 전한다. 사용자가 원하면 새 멱등키로 다시 요청한다"]
 	},
 	EXPIRED: {
-		message: "이 멱등키의 요청은 승인 기한(24시간)이 지났어요. 아무것도 바뀌지 않았어요",
+		message: "이 멱등키의 요청은 승인 기한(24시간)이 지났습니다. 아무것도 바뀌지 않았습니다",
 		nextSteps: ["사용자가 원하면 새 멱등키로 다시 요청한다"]
 	}
 };
@@ -231,7 +231,7 @@ function describeWriteResult(result) {
 			body: {
 				status: "APPROVAL_EXECUTING",
 				applied: "unknown",
-				message: "셀러가 승인해서 서버가 이 요청을 실행하고 있어요",
+				message: "셀러가 승인해서 서버가 이 요청을 실행하고 있습니다",
 				approvalId: pending.approvalId,
 				nextSteps: ["같은 요청을 다시 보내지 않는다. 결과는 `get_approval_request`로 확인한다"]
 			}
@@ -241,7 +241,7 @@ function describeWriteResult(result) {
 			body: {
 				status: "APPROVAL_PENDING",
 				applied: false,
-				message: "승인 대기 중이에요. 아직 아무것도 바뀌지 않았어요. 셀러가 콘솔에서 승인하면 서버가 이 요청을 그대로 실행해요",
+				message: "승인 대기 중입니다. 아직 아무것도 바뀌지 않았습니다. 셀러가 콘솔에서 승인하면 서버가 이 요청을 그대로 실행합니다",
 				approvalId: pending.approvalId,
 				reason: pending.reason,
 				expiresAt: pending.expiresAt,
@@ -256,7 +256,7 @@ function describeWriteResult(result) {
 		body: {
 			status: "DRY_RUN",
 			applied: false,
-			message: "실행하지 않았어요. 서버의 판정과 영향 미리보기예요",
+			message: "실행하지 않았습니다. 서버의 판정과 영향 미리보기입니다",
 			...result.data
 		}
 	};
@@ -314,7 +314,7 @@ var AdminApi = class {
 			redirect: "error",
 			signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
 		});
-		if (!response.ok) throw new Error(`API 문서를 읽지 못했어요 (HTTP ${response.status})`);
+		if (!response.ok) throw new Error(`API 문서를 읽지 못했습니다 (HTTP ${response.status})`);
 		const document = await response.json();
 		this.spec = {
 			document,
@@ -326,7 +326,7 @@ var AdminApi = class {
 	async find(operationId) {
 		const { document, operations } = await this.load();
 		const op = operations.find((candidate) => candidate.operationId === operationId);
-		if (!op) throw new Error(`쓸 수 있는 오퍼레이션이 아니에요: ${operationId}. list_operations의 operationId를 쓰세요`);
+		if (!op) throw new Error(`쓸 수 있는 오퍼레이션이 아닙니다: ${operationId}. list_operations의 operationId를 쓰십시오`);
 		return {
 			document,
 			op
@@ -372,7 +372,7 @@ var AdminApi = class {
 const DEFAULT_API_ORIGIN = "https://api.sayren.app";
 function loadConfig(env = process.env) {
 	const token = env.SAYREN_TOKEN?.trim();
-	if (!token) throw new Error("SAYREN_TOKEN이 없어요. 셀러 콘솔 개발자 공간 › API 토큰에서 발급한 토큰을 MCP 설정의 env에 넣어주세요");
+	if (!token) throw new Error("SAYREN_TOKEN이 없습니다. 셀러 콘솔 개발자 공간 › API 토큰에서 발급한 토큰을 MCP 설정의 env에 넣어주십시오");
 	const origin = (env.SAYREN_API_ORIGIN ?? DEFAULT_API_ORIGIN).replace(/\/+$/, "");
 	return {
 		apiOrigin: origin,
@@ -390,7 +390,7 @@ async function callApi(url, init = {}) {
 	const body = await response.json().catch(() => null);
 	if (!response.ok) {
 		const code = body?.error?.code ?? String(response.status);
-		const message = body?.error?.message ?? "요청이 실패했어요";
+		const message = body?.error?.message ?? "요청이 실패했습니다";
 		throw new Error(`${code}: ${message}`);
 	}
 	return body?.data ?? body;
@@ -412,7 +412,7 @@ async function fetchStoreContext(config$1) {
 	const payment = paymentSettings ? {
 		connectedProviders: connected.map((p) => p.provider),
 		sandboxOnly: connected.length === 0 || connected.every((p) => p.sandboxMode)
-	} : { unavailable: "결제 설정은 셀러 콘솔 OWNER만 볼 수 있어 이 토큰으로는 확인하지 못했어요" };
+	} : { unavailable: "결제 설정은 셀러 콘솔 OWNER만 볼 수 있어 이 토큰으로는 확인하지 못했습니다" };
 	return {
 		storeId: store.storeId,
 		storeCode: store.storeCode,
@@ -519,12 +519,12 @@ function resolveSpec(name, spec, meta, options) {
 	if (options.link && name.startsWith("@sayren/")) return "workspace:*";
 	if (spec === "catalog:" || spec === "catalog:default") {
 		const version$1 = meta.catalog[name];
-		if (!version$1) throw new Error(`catalog에 ${name} 버전이 없어요`);
+		if (!version$1) throw new Error(`catalog에 ${name} 버전이 없습니다`);
 		return version$1;
 	}
 	if (spec.startsWith("workspace:")) {
 		const version$1 = meta.versions[name];
-		if (!version$1) throw new Error(`${name}의 배포 버전을 모르겠어요`);
+		if (!version$1) throw new Error(`${name}의 배포 버전을 모르겠습니다`);
 		return `^${version$1}`;
 	}
 	return spec;
@@ -598,7 +598,7 @@ function resolveRoot() {
 	for (const candidate of CANDIDATES) try {
 		if (statSync(candidate).isDirectory()) return candidate;
 	} catch {}
-	throw new Error("스토어프론트 템플릿을 찾지 못했어요");
+	throw new Error("스토어프론트 템플릿을 찾지 못했습니다");
 }
 const TEMPLATE_ROOT = resolveRoot();
 function walk(dir, acc) {
@@ -623,7 +623,7 @@ function listTemplateFiles() {
 */
 function readTemplateFile(path, options = {}) {
 	const normalized = path.replace(/^\.?\//, "");
-	if (!listTemplateFiles().includes(normalized)) throw new Error(`템플릿에 없는 파일이에요: ${path}`);
+	if (!listTemplateFiles().includes(normalized)) throw new Error(`템플릿에 없는 파일입니다: ${path}`);
 	let file = join(TEMPLATE_ROOT, normalized);
 	if (normalized.endsWith(".gitignore") && !existsSync(file)) file = file.replace(/\.gitignore$/, BUNDLED_GITIGNORE);
 	const raw = readFileSync(file, "utf8");
@@ -720,9 +720,9 @@ const RULES = [
 	},
 	{
 		id: "checkout-origin",
-		title: "복귀 주소는 배포된 주소(요청 origin)에서 만들고 그 도메인을 셀러 콘솔 설정 › 결제에 등록한다",
-		why: "결제 도메인 밖의 복귀 주소는 서버가 거절한다. 주소를 코드에 고정하면 로컬·스테이징·운영 중 한 곳에서만 결제가 된다",
-		fix: "서버 함수에서 `getRequestUrl()`의 origin으로 복귀 주소를 만든다. 배포 도메인은 셀러 콘솔 설정 › 결제의 결제 도메인에 등록한다(테스트 결제는 localhost가 항상 허용된다)",
+		title: "복귀 주소는 코드에 고정하지 않고 배포된 주소(요청 origin)에서 만든다",
+		why: "주소를 코드에 고정하면 로컬·스테이징·운영 중 한 곳에서만 결제가 제대로 돌아온다. 셀러 콘솔 설정 › 결제의 결제 도메인은 선택형 허용 목록이다. 비워 두면 https 복귀 주소를 모두 받고, 등록하면 목록 밖의 복귀 주소를 서버가 거절한다",
+		fix: "서버 함수에서 `getRequestUrl()`의 origin으로 복귀 주소를 만든다. 결제 도메인을 등록해 두었다면 배포 도메인도 목록에 넣는다(테스트 결제는 localhost가 항상 허용된다)",
 		example: "const returnUrl = new URL(PAYMENT_RETURN_PATH, new URL(getRequestUrl()).origin);\nawait api.checkout.startPayment(checkoutId, { option, returnUrl: returnUrl.toString() });",
 		doc: "/guides/payment-settings",
 		templateFile: "src/routes/checkout.index.tsx"
@@ -852,7 +852,7 @@ function verifySources(files) {
 	if (opensPayment && !has("prepareWindow(")) inFile("payment-popup-prepare", opensPayment, "받아 둔 결제 시작 값으로 결제창을 열지만 클릭 시점에 `payments.prepareWindow()`로 창을 먼저 여는 코드가 없다", /\bpayments\.open\(|\.open\(\s*(start|paymentStart)\b/);
 	if (opensPayment && !/amounts/.test(opensPayment.content)) inFile("payment-amounts-final", opensPayment, "결제창을 열지만 결제 시작 응답의 `amounts`(확정 금액)를 화면에 반영하지 않는다", /\bpayments\.open\(/);
 	const fixedReturnUrl = matches(/returnUrl\s*[:=]\s*["'`]https?:\/\//);
-	if (fixedReturnUrl) inFile("checkout-origin", fixedReturnUrl, "복귀 주소를 고정 문자열로 두었다. 배포된 주소(요청 origin)에서 만들고 그 도메인을 결제 도메인에 등록한다", /returnUrl\s*[:=]\s*["'`]https?:\/\//);
+	if (fixedReturnUrl) inFile("checkout-origin", fixedReturnUrl, "복귀 주소를 고정 문자열로 두었다. 배포된 주소(요청 origin)에서 만든다", /returnUrl\s*[:=]\s*["'`]https?:\/\//);
 	if (has("startPayment(") && !has(".result(")) inProject("payment-return-route", "결제 복귀 화면에서 `payments.result()`를 부르는 코드가 없다");
 	if (has(".result(") && !has("PROCESSING")) inProject("payment-processing-status", "결과 확인 중(`PROCESSING`)일 때 결제 상태를 다시 조회하는 코드가 없다");
 	if (has("startPayment(") && has("zipCode") && !has("quoteDelivery(")) inProject("delivery-quote-preview", "배송지 우편번호를 받지만 `checkout.quoteDelivery`로 배송비를 다시 계산하는 코드가 없다");
@@ -922,7 +922,7 @@ function buildReport(files) {
 		},
 		results,
 		findings: reported,
-		message: findings.length ? `규칙 ${RULES.length}개 중 ${violated}개를 어겼어요(위반 ${findings.length}건). 아래 findings의 fix대로 고친 뒤 다시 검사해주세요` : `규칙 ${RULES.length}개를 모두 지켰어요. 정적 검사가 잡지 못하는 것이 있으니 직접 띄워 결제까지 한 번 해보세요`,
+		message: findings.length ? `규칙 ${RULES.length}개 중 ${violated}개를 어겼습니다(위반 ${findings.length}건). 아래 findings의 fix대로 고친 뒤 다시 검사해주십시오` : `규칙 ${RULES.length}개를 모두 지켰습니다. 정적 검사가 잡지 못하는 것이 있으니 직접 띄워 결제까지 한 번 해보십시오`,
 		nextSteps: nextSteps(reported)
 	};
 }
@@ -995,7 +995,7 @@ async function runCreate(argv) {
 	}
 	const target = resolve(args.dir);
 	if (existsSync(target) && readdirSync(target).length > 0 && !args.force) {
-		console.error(`폴더가 비어 있지 않아요: ${target} (--force로 덮어쓸 수 있어요)`);
+		console.error(`폴더가 비어 있지 않습니다: ${target} (--force로 덮어쓸 수 있습니다)`);
 		return 1;
 	}
 	const name = args.name ?? basename(target);
@@ -1015,7 +1015,7 @@ async function runCreate(argv) {
 		const env = `SAYREN_API_URL=${store.storefrontApiBaseUrl}\nSAYREN_STORE_CODE=${store.storeCode}\n`;
 		writeFileSync(join(target, ".env"), env);
 		console.log(`.env 작성 — ${store.name} (${store.storeCode})`);
-	} else console.log("SAYREN_TOKEN이 없어 .env는 비워 뒀어요. SAYREN_API_URL과 SAYREN_STORE_CODE를 넣어주세요");
+	} else console.log("SAYREN_TOKEN이 없어 .env는 비워 뒀습니다. SAYREN_API_URL과 SAYREN_STORE_CODE를 넣어주십시오");
 	const startedAt = Date.now();
 	const report$1 = buildReport(await collectSources(target));
 	const durationMs = Date.now() - startedAt;
@@ -1026,7 +1026,7 @@ async function runCreate(argv) {
 	}
 	console.log(`\n다음:\n  cd ${args.dir}\n  pnpm install\n  pnpm dev`);
 	console.log(`
-디자인을 고친 뒤에는 MCP 도구 \`verify_storefront\`로 다시 검사해주세요. 결제·구매자 인증·방문 분석 규칙 ${report$1.summary.rules}개를 보고, 어긴 항목마다 고칠 자리와 수정 방법·예시 코드를 알려 줘요.\n결제까지 해 보려면 셀러 콘솔 설정 › 결제에서 결제 도메인에 이 쇼핑몰 주소를 등록해주세요(테스트 결제는 localhost가 항상 허용돼요).`);
+디자인을 고친 뒤에는 MCP 도구 \`verify_storefront\`로 다시 검사해주십시오. 결제·구매자 인증·방문 분석 규칙 ${report$1.summary.rules}개를 보고, 어긴 항목마다 고칠 자리와 수정 방법·예시 코드를 알려 줍니다.\n결제 도메인(셀러 콘솔 설정 › 결제)을 비워 두면 https 복귀 주소를 모두 받습니다. 도메인을 등록했다면 이 쇼핑몰을 배포한 주소도 목록에 넣어주십시오(테스트 결제는 localhost가 항상 허용됩니다).`);
 	if (config$1) await new Telemetry(config$1).reportVerify("create", report$1, durationMs);
 	return 0;
 }
@@ -1276,7 +1276,7 @@ server.registerTool("verify_storefront", {
 	const files = await collectSources(projectDir);
 	if (!files.length) return text({
 		ok: false,
-		message: `소스를 찾지 못했어요: ${projectDir}`,
+		message: `소스를 찾지 못했습니다: ${projectDir}`,
 		nextSteps: ["`projectDir`이 프로젝트 루트(package.json이 있는 폴더)의 절대 경로인지 확인한다.", "템플릿을 아직 받지 않았으면 `list_template_files`·`get_template_file`로 먼저 만든다."]
 	});
 	const report$1 = buildReport(files);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
   "bin": {
     "sayren-mcp": "./dist/index.mjs"
@@ -12,8 +12,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.22.0",
     "zod": "^4.6.5",
-    "@sayren/store-sdk": "^0.14.0",
-    "@sayren/storefront-sdk": "^0.11.0"
+    "@sayren/storefront-sdk": "^0.12.0",
+    "@sayren/store-sdk": "^0.15.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",

package/template/.template-meta.json

@@ -7,8 +7,8 @@
     "zod": "^4.6.5"
   },
   "versions": {
-    "@sayren/store-sdk": "0.14.0",
-    "@sayren/storefront-sdk": "0.11.0",
+    "@sayren/store-sdk": "0.15.1",
+    "@sayren/storefront-sdk": "0.12.0",
     "@sayren/ui": "0.1.0"
   }
 }

package/template/README.md

@@ -74,8 +74,9 @@ EU 등 분석 쿠키에 사전 동의가 필요한 지역의 구매자를 받는
 - `src/lib/session.server.ts`·`src/start.ts` — 구매자 세션 쿠키와 갱신이다. 갱신은 요청마다 한 번이고, 같은
   리프레시 토큰의 동시 갱신은 한 번으로 모은다. 리프레시 토큰은 한 번 쓰면 폐기되므로 각자 갱신하면 로그아웃된다.
 - loader가 서버 함수로 데이터를 받아 그리는 구조 — 컴포넌트에서 다시 받으면 검색 노출과 첫 화면이 죽는다.
-- 결제 도메인 — 실결제는 셀러 콘솔 설정 › 결제의 **결제 도메인**에 등록한 도메인에서만 된다. 이 쇼핑몰을 배포한 주소를
-  등록하고, 같은 주소를 PG(토스페이먼츠·포트원) 가맹 정보에도 등록한다. 테스트 결제는 localhost에서도 된다.
+- 결제 도메인 — 셀러 콘솔 설정 › 결제의 **결제 도메인**은 선택형 허용 목록이다. 비워 두면 https 복귀 주소를 모두 받고,
+  등록하면 그 도메인에서만 결제가 된다. 등록했다면 이 쇼핑몰을 배포한 주소도 넣는다. 배포 주소는 PG(토스페이먼츠·포트원)
+  가맹 정보에도 등록한다. 테스트 결제는 localhost에서도 된다.
 
 ## 주의
 

package/template/src/lib/config.server.ts

@@ -18,6 +18,6 @@ export function resolveStoreCode(): string {
   const fromHost = storeCodeFromHost(getRequestHeader("host"));
   if (fromHost) return fromHost;
   throw new Error(
-    "스토어 코드를 알 수 없어요. SAYREN_STORE_CODE 환경변수를 설정하거나 서브도메인으로 서비스해주세요",
+    "스토어 코드를 알 수 없습니다. SAYREN_STORE_CODE 환경변수를 설정하거나 서브도메인으로 서비스해주십시오",
   );
 }

package/template/src/lib/payments.ts

@@ -11,7 +11,8 @@ import type { PublicConfig } from "./config";
  * 3. 모바일이나 팝업 차단이면 같은 탭이 결제 서비스로 이동하고, 결제가 끝나면 복귀 화면(`/checkout/return`)으로
  *    돌아온다. 복귀 화면은 `payments.result()` 한 줄로 결과를 읽는다.
  * 4. 결과를 모르면(`PROCESSING`) 실패로 단정하지 말고 계속 조회한다 — 다시 결제하게 하면 이중 결제가 난다.
- * 5. 복귀 주소의 도메인을 셀러 콘솔 설정 › 결제의 결제 도메인에 등록한다(테스트 결제는 localhost 허용).
+ * 5. 셀러 콘솔 설정 › 결제의 결제 도메인을 등록했다면 복귀 주소의 도메인이 그 안에 있어야 한다(비우면 https 모두 허용,
+ *    테스트 결제는 localhost 허용).
  */
 /**
  * 설정마다 하나만 만든다. `prepareWindow()`로 연 창과 그 결과를 기다리는 감시가 같은 인스턴스에 묶여 있어서,

package/template/src/routes/__root.tsx

@@ -67,14 +67,14 @@ function Root() {
 function RootError({ error }: ErrorComponentProps) {
   return (
     <ErrorView
-      title="문제가 생겼어요"
+      title="문제가 생겼습니다"
       detail={error instanceof Error ? error.message : undefined}
     />
   );
 }
 
 function NotFound() {
-  return <ErrorView title="찾을 수 없어요" />;
+  return <ErrorView title="찾을 수 없습니다" />;
 }
 
 function ErrorView({ title, detail }: { title: string; detail?: string }) {

package/template/src/routes/account.tsx

@@ -53,7 +53,7 @@ const changeConsents = createServerFn({ method: "POST" })
   .validator(consentInput)
   .handler(async ({ data }) => {
     const accessToken = readToken();
-    if (!accessToken) return { error: "다시 로그인해 주세요" };
+    if (!accessToken) return { error: "다시 로그인해 주십시오" };
     try {
       await apiFor({ accessToken }).member.updateConsents({
         ...(data.reconsent ? { terms: true as const, privacy: true as const } : {}),
@@ -73,7 +73,7 @@ const startLink = createServerFn({ method: "POST" })
   .validator(providerInput)
   .handler(async ({ data }) => {
     const accessToken = readToken();
-    if (!accessToken) return { url: null, error: "다시 로그인해 주세요" };
+    if (!accessToken) return { url: null, error: "다시 로그인해 주십시오" };
     const origin = new URL(getRequestUrl()).origin;
     try {
       const started = await authFor().linkIdp(accessToken, data.provider, {
@@ -95,7 +95,7 @@ const unlink = createServerFn({ method: "POST" })
   .validator(providerInput)
   .handler(async ({ data }) => {
     const accessToken = readToken();
-    if (!accessToken) return { error: "다시 로그인해 주세요" };
+    if (!accessToken) return { error: "다시 로그인해 주십시오" };
     try {
       await authFor().unlinkIdp(accessToken, data.provider);
       return { error: null };
@@ -105,18 +105,18 @@ const unlink = createServerFn({ method: "POST" })
   });
 
 const ERROR_MESSAGE: Record<string, string> = {
-  IDENTITY_IN_USE: "이 계정은 이미 다른 회원에 연결돼 있어요",
+  IDENTITY_IN_USE: "이 계정은 이미 다른 회원에 연결돼 있습니다",
   PROVIDER_ALREADY_LINKED:
-    "같은 서비스의 다른 계정이 이미 연결돼 있어요. 해제한 뒤 다시 연결해 주세요",
-  LAST_LOGIN_METHOD: "마지막 로그인 수단은 해제할 수 없어요. 다른 계정을 먼저 연결해 주세요",
-  access_denied: "연결을 취소했어요",
-  state_mismatch: "연결 요청이 만료됐어요. 다시 시도해 주세요",
+    "같은 서비스의 다른 계정이 이미 연결돼 있습니다. 해제한 뒤 다시 연결해 주십시오",
+  LAST_LOGIN_METHOD: "마지막 로그인 수단은 해제할 수 없습니다. 다른 계정을 먼저 연결해 주십시오",
+  access_denied: "연결을 취소했습니다",
+  state_mismatch: "연결 요청이 만료됐습니다. 다시 시도해 주십시오",
 };
 
 function accountErrorMessage(error: unknown): string {
   if (error instanceof ApiError)
-    return ERROR_MESSAGE[error.code] ?? "처리하지 못했어요. 잠시 후 다시 시도해 주세요";
-  return "처리하지 못했어요. 잠시 후 다시 시도해 주세요";
+    return ERROR_MESSAGE[error.code] ?? "처리하지 못했습니다. 잠시 후 다시 시도해 주십시오";
+  return "처리하지 못했습니다. 잠시 후 다시 시도해 주십시오";
 }
 
 export const Route = createFileRoute("/account")({
@@ -135,7 +135,7 @@ function Account() {
   const error =
     actionError ??
     (callbackError
-      ? (ERROR_MESSAGE[callbackError] ?? "연결하지 못했어요. 다시 시도해 주세요")
+      ? (ERROR_MESSAGE[callbackError] ?? "연결하지 못했습니다. 다시 시도해 주십시오")
       : null);
 
   const changeConsent = (data: { reconsent?: boolean; marketing?: boolean }) => {
@@ -187,7 +187,7 @@ function Account() {
         <h2 className="font-bold text-lg">로그인 수단</h2>
         {linked ? (
           <p className="rounded-md bg-chip px-3 py-2 text-sm">
-            {PROVIDER_NAME[linked]} 계정을 연결했어요
+            {PROVIDER_NAME[linked]} 계정을 연결했습니다
           </p>
         ) : null}
         <form onSubmit={submit}>
@@ -240,7 +240,7 @@ function Account() {
         </form>
         {error ? <p className="text-point text-sm">{error}</p> : null}
         <p className="text-muted text-xs">
-          연결한 계정으로도 같은 회원으로 로그인해요. 마지막 로그인 수단은 해제할 수 없어요.
+          연결한 계정으로도 같은 회원으로 로그인합니다. 마지막 로그인 수단은 해제할 수 없습니다.
         </p>
       </section>
 
@@ -252,7 +252,7 @@ function Account() {
               <span className="font-medium">이용약관 · 개인정보 수집이용</span>
               <span className="text-muted text-xs">
                 {consents.reconsentRequired
-                  ? "약관이 개정됐어요. 다시 동의해 주세요"
+                  ? "약관이 개정됐습니다. 다시 동의해 주십시오"
                   : `동의 완료 · v${consents.terms.agreedVersion ?? "-"}`}
               </span>
               {/* 스토어가 약관 주소를 정했으면 열어 볼 수 있게 한다 */}

package/template/src/routes/cart.tsx

@@ -73,7 +73,7 @@ function CartPage() {
   if (!cart.items.length) {
     return (
       <div className="space-y-4 py-16 text-center">
-        <p className="text-muted">장바구니가 비었어요</p>
+        <p className="text-muted">장바구니가 비었습니다</p>
         <Link to="/products" className="inline-block rounded-md bg-ink px-5 py-3 text-white">
           상품 보러 가기
         </Link>
@@ -107,7 +107,7 @@ function CartPage() {
               ) : null}
               {!item.purchasable ? (
                 <span className="text-point text-xs">
-                  {item.unpurchasableReason === "SOLD_OUT" ? "품절이에요" : "지금은 살 수 없어요"}
+                  {item.unpurchasableReason === "SOLD_OUT" ? "품절입니다" : "지금은 살 수 없습니다"}
                 </span>
               ) : null}
               <div className="flex items-center gap-3 pt-1">
@@ -171,7 +171,7 @@ function CartPage() {
         {loginRequired ? (
           <div className="flex w-full flex-col gap-2 md:w-64">
             <p className="text-center text-muted text-xs">
-              이 스토어는 회원만 주문할 수 있어요. 담은 상품은 로그인하면 그대로 이어져요
+              이 스토어는 회원만 주문할 수 있습니다. 담은 상품은 로그인하면 그대로 이어집니다
             </p>
             <Link
               to="/login"

package/template/src/routes/checkout.complete.tsx

@@ -34,11 +34,11 @@ function CheckoutComplete() {
   return (
     <div className="space-y-6 py-10 text-center">
       <div className="space-y-2">
-        <h1 className="font-bold text-2xl">주문을 완료했어요</h1>
+        <h1 className="font-bold text-2xl">주문을 완료했습니다</h1>
         {orderId ? (
           <p className="text-muted text-sm">주문번호 {orderId}</p>
         ) : (
-          <p className="text-muted text-sm">주문 내역에서 주문을 확인해주세요</p>
+          <p className="text-muted text-sm">주문 내역에서 주문을 확인해주십시오</p>
         )}
       </div>
 

package/template/src/routes/checkout.index.tsx

@@ -64,7 +64,10 @@ const quoteDelivery = createServerFn({ method: "POST" })
       const quote = await api.checkout.quoteDelivery(data.checkoutId, { zipCode: data.zipCode });
       return { quote, error: null };
     } catch {
-      return { quote: null, error: "배송비를 확인하지 못했어요. 우편번호를 다시 확인해주세요." };
+      return {
+        quote: null,
+        error: "배송비를 확인하지 못했습니다. 우편번호를 다시 확인해주십시오.",
+      };
     }
   });
 
@@ -92,7 +95,7 @@ const startPayment = createServerFn({ method: "POST" })
   .handler(async ({ data }) => {
     const accessToken = readToken();
     const api = apiFor({ accessToken, cartToken: readCartToken() });
-    // 복귀 주소 — 이 도메인이 셀러 콘솔 결제 도메인에 있어야 한다(테스트 결제는 localhost 허용)
+    // 복귀 주소 — 결제 도메인을 등록한 스토어는 이 도메인이 목록 안이어야 한다(테스트 결제는 localhost 허용)
     const returnUrl = new URL(PAYMENT_RETURN_PATH, new URL(getRequestUrl()).origin);
     returnUrl.searchParams.set("back", data.back);
     try {
@@ -125,20 +128,21 @@ const startPayment = createServerFn({ method: "POST" })
   });
 
 function startErrorMessage(error: unknown): string {
-  if (!(error instanceof ApiError)) return "결제를 시작하지 못했어요. 잠시 후 다시 시도해주세요.";
+  if (!(error instanceof ApiError))
+    return "결제를 시작하지 못했습니다. 잠시 후 다시 시도해주십시오.";
   switch (error.code) {
     case "PAYMENT_OPTION_UNAVAILABLE":
-      return "지금 쓸 수 없는 결제수단이에요. 다른 결제수단을 골라주세요.";
+      return "지금 쓸 수 없는 결제수단입니다. 다른 결제수단을 골라주십시오.";
     case "PAYMENT_PROVIDER_UNAVAILABLE":
-      return "결제창을 준비하지 못했어요. 다른 결제수단으로 시도해주세요.";
+      return "결제창을 준비하지 못했습니다. 다른 결제수단으로 시도해주십시오.";
     case "PAYMENT_NOT_CONFIGURED":
-      return "결제 수단을 준비하고 있어요. 잠시 후 다시 시도해주세요.";
+      return "결제 수단을 준비하고 있습니다. 잠시 후 다시 시도해주십시오.";
     case "CASH_RECEIPT_NOT_AVAILABLE":
-      return "현금영수증은 계좌이체·가상계좌 결제에서만 신청할 수 있어요.";
+      return "현금영수증은 계좌이체·가상계좌 결제에서만 신청할 수 있습니다.";
     case "RETURN_URL_NOT_ALLOWED":
-      return "이 쇼핑몰 주소에서는 결제할 수 없어요. 셀러 콘솔 설정 › 결제에서 결제 도메인을 확인해주세요.";
+      return "이 쇼핑몰 주소에서는 결제할 수 없습니다. 셀러 콘솔 설정 › 결제에서 결제 도메인을 확인해주십시오.";
     default:
-      return "결제를 시작하지 못했어요. 입력한 내용을 확인하고 다시 시도해주세요.";
+      return "결제를 시작하지 못했습니다. 입력한 내용을 확인하고 다시 시도해주십시오.";
   }
 }
 
@@ -210,10 +214,10 @@ function Checkout() {
     }
     setNotice(
       result.status === "CANCELED"
-        ? "결제를 취소했어요. 다른 결제수단으로 다시 시도해주세요."
+        ? "결제를 취소했습니다. 다른 결제수단으로 다시 시도해주십시오."
         : result.status === "FAILED"
           ? result.message
-          : "결제 결과를 확인하지 못했어요. 주문 내역을 확인해주세요.",
+          : "결제 결과를 확인하지 못했습니다. 주문 내역을 확인해주십시오.",
     );
   };
 
@@ -221,7 +225,7 @@ function Checkout() {
     event.preventDefault();
     const option = options.find((item) => paymentOptionKey(item) === selected);
     if (!option) {
-      setNotice("결제수단을 골라주세요.");
+      setNotice("결제수단을 골라주십시오.");
       return;
     }
     const form = new FormData(event.currentTarget);
@@ -233,7 +237,7 @@ function Checkout() {
         identityNumber: field("cashReceiptNumber"),
       });
       if (!parsed.success) {
-        setNotice(parsed.error.issues[0]?.message ?? "현금영수증 번호를 확인해주세요.");
+        setNotice(parsed.error.issues[0]?.message ?? "현금영수증 번호를 확인해주십시오.");
         return;
       }
       cashReceipt = parsed.data;
@@ -275,7 +279,7 @@ function Checkout() {
       })
       .catch(() => {
         paymentWindow.close();
-        setNotice("결제를 시작하지 못했어요. 잠시 후 다시 시도해주세요.");
+        setNotice("결제를 시작하지 못했습니다. 잠시 후 다시 시도해주십시오.");
       })
       .finally(() => setSubmitting(false));
   };
@@ -293,7 +297,7 @@ function Checkout() {
             placeholder="04524"
             required
             onBlur={handleZipBlur}
-            hint="입력하면 지역 추가 배송비까지 반영한 배송비를 보여 줘요"
+            hint="입력하면 지역 추가 배송비까지 반영한 배송비를 보여 줍니다"
           />
           <Field label="주소" name="address1" required />
           <Field label="상세 주소" name="address2" />
@@ -310,7 +314,7 @@ function Checkout() {
               name="orderPassword"
               type="password"
               required
-              hint="주문 내역을 찾을 때 쓸 6자 이상 비밀번호예요"
+              hint="주문 내역을 찾을 때 쓸 6자 이상 비밀번호입니다"
             />
           </section>
         )}
@@ -318,7 +322,7 @@ function Checkout() {
         <fieldset className="space-y-2">
           <legend className="mb-3 font-bold text-lg">결제수단</legend>
           {options.length === 0 ? (
-            <p className="text-muted text-sm">지금 결제할 수 있는 결제수단이 없어요.</p>
+            <p className="text-muted text-sm">지금 결제할 수 있는 결제수단이 없습니다.</p>
           ) : (
             <div className="grid grid-cols-2 gap-2">
               {options.map((option) => {
@@ -438,7 +442,7 @@ function Checkout() {
         ))}
         {checkout.testPayment ? (
           <p className="rounded-md bg-chip px-3 py-2 text-xs">
-            테스트 결제예요. 실제로 돈이 오가지 않아요.
+            테스트 결제입니다. 실제로 돈이 오가지 않습니다.
           </p>
         ) : null}
         {notice ? <p className="rounded-md bg-chip px-3 py-2 text-sm">{notice}</p> : null}
@@ -451,10 +455,10 @@ function Checkout() {
 function deliveryNotes(delivery: CheckoutDelivery): string[] {
   const notes: string[] = [];
   if (delivery.bundleCount >= 2) {
-    notes.push(`배송 묶음 ${delivery.bundleCount}건 — 묶음마다 배송비가 붙어요.`);
+    notes.push(`배송 묶음 ${delivery.bundleCount}건 — 묶음마다 배송비가 붙습니다.`);
   }
-  if (delivery.freeByThreshold) notes.push("무료배송 기준 금액을 넘겨 기본 배송비가 빠졌어요.");
-  if (delivery.zipCode === null) notes.push("배송지를 입력하면 배송비가 확정돼요.");
+  if (delivery.freeByThreshold) notes.push("무료배송 기준 금액을 넘겨 기본 배송비가 빠졌습니다.");
+  if (delivery.zipCode === null) notes.push("배송지를 입력하면 배송비가 확정됩니다.");
   return notes;
 }
 

package/template/src/routes/checkout.return.tsx

@@ -107,17 +107,17 @@ function PaymentReturn() {
     <div className="mx-auto max-w-md space-y-6 py-16 text-center">
       {view.kind === "working" || view.kind === "processing" ? (
         <>
-          <h1 className="font-bold text-2xl">결제를 확인하고 있어요</h1>
+          <h1 className="font-bold text-2xl">결제를 확인하고 있습니다</h1>
           <p className="text-muted text-sm">
             {view.kind === "processing"
-              ? "결제사에서 결과를 확인하는 중이에요. 이 화면을 닫지 말고 잠시만 기다려주세요."
-              : "잠시만 기다려주세요."}
+              ? "결제사에서 결과를 확인하는 중입니다. 이 화면을 닫지 말고 잠시만 기다려주십시오."
+              : "잠시만 기다려주십시오."}
           </p>
         </>
       ) : view.kind === "failed" ? (
         <>
           <h1 className="font-bold text-2xl">
-            {view.canceled ? "결제를 취소했어요" : "결제하지 못했어요"}
+            {view.canceled ? "결제를 취소했습니다" : "결제하지 못했습니다"}
           </h1>
           {view.canceled ? null : <p className="text-muted text-sm">{view.message}</p>}
           <div className="flex justify-center gap-2">
@@ -128,10 +128,10 @@ function PaymentReturn() {
         </>
       ) : (
         <>
-          <h1 className="font-bold text-2xl">결제 결과를 확인하지 못했어요</h1>
+          <h1 className="font-bold text-2xl">결제 결과를 확인하지 못했습니다</h1>
           <p className="text-muted text-sm">
-            결제를 마쳤다면 잠시 뒤 주문 내역에 나타나요. 다시 결제하기 전에 주문 내역을 먼저
-            확인해주세요.
+            결제를 마쳤다면 잠시 뒤 주문 내역에 나타납니다. 다시 결제하기 전에 주문 내역을 먼저
+            확인해주십시오.
           </p>
           <Link to="/orders" className="inline-block rounded-md border border-ink px-5 py-3">
             주문 내역

package/template/src/routes/index.tsx

@@ -48,7 +48,7 @@ function Home() {
       ) : null}
 
       <ProductSection listId="home:recommend" title="추천 상품" products={recommended} />
-      <ProductSection listId="home:latest" title="새로 들어왔어요" products={latest} />
+      <ProductSection listId="home:latest" title="새로 들어온 상품" products={latest} />
     </div>
   );
 }

package/template/src/routes/login.tsx

@@ -74,18 +74,18 @@ const passwordLogin = createServerFn({ method: "POST" })
 
 function loginErrorMessage(error: unknown): string {
   if (error instanceof ApiError) {
-    if (error.code === "INVALID_CREDENTIALS") return "이메일이나 비밀번호가 맞지 않아요";
-    if (error.code === "PASSWORD_LOGIN_DISABLED") return "이 스토어는 소셜 로그인만 받아요";
+    if (error.code === "INVALID_CREDENTIALS") return "이메일이나 비밀번호가 맞지 않습니다";
+    if (error.code === "PASSWORD_LOGIN_DISABLED") return "이 스토어는 소셜 로그인만 받습니다";
     if (error.code === "ACCOUNT_LOCKED")
-      return "로그인을 여러 번 실패해 잠시 잠겼어요. 10분 뒤에 다시 시도해 주세요";
-    if (error.status === 400) return "이메일과 비밀번호를 확인해 주세요";
+      return "로그인을 여러 번 실패해 잠시 잠겼습니다. 10분 뒤에 다시 시도해 주십시오";
+    if (error.status === 400) return "이메일과 비밀번호를 확인해 주십시오";
   }
-  return "로그인하지 못했어요. 잠시 후 다시 시도해 주세요";
+  return "로그인하지 못했습니다. 잠시 후 다시 시도해 주십시오";
 }
 
 const CALLBACK_ERRORS: Record<string, string> = {
-  access_denied: "로그인을 취소했어요",
-  state_mismatch: "로그인 요청이 만료됐어요. 다시 시도해 주세요",
+  access_denied: "로그인을 취소했습니다",
+  state_mismatch: "로그인 요청이 만료됐습니다. 다시 시도해 주십시오",
 };
 
 export const Route = createFileRoute("/login")({
@@ -105,7 +105,7 @@ function Login() {
   const error =
     actionError ??
     (callbackError
-      ? (CALLBACK_ERRORS[callbackError] ?? "로그인하지 못했어요. 다시 시도해 주세요")
+      ? (CALLBACK_ERRORS[callbackError] ?? "로그인하지 못했습니다. 다시 시도해 주십시오")
       : null);
 
   const submitSocial = (event: React.FormEvent<HTMLFormElement>) => {
@@ -195,7 +195,7 @@ function Login() {
       ) : null}
       {error ? <p className="text-point text-sm">{error}</p> : null}
       {social.length ? (
-        <p className="text-center text-muted text-xs">처음 소셜 로그인하면 가입이 함께 돼요</p>
+        <p className="text-center text-muted text-xs">처음 소셜 로그인하면 가입이 함께 됩니다</p>
       ) : null}
     </div>
   );

package/template/src/routes/orders.$orderId.tsx

@@ -62,18 +62,18 @@ const createClaim = createServerFn({ method: "POST" })
   });
 
 function claimErrorMessage(error: unknown): string {
-  if (!(error instanceof ApiError)) return "접수하지 못했어요. 잠시 후 다시 시도해주세요.";
+  if (!(error instanceof ApiError)) return "접수하지 못했습니다. 잠시 후 다시 시도해주십시오.";
   switch (error.code) {
     case "INVALID_QUANTITY":
-      return "남은 수량보다 많이 신청했어요. 수량을 확인해주세요.";
+      return "남은 수량보다 많이 신청했습니다. 수량을 확인해주십시오.";
     case "CLAIM_IN_PROGRESS":
-      return "이미 진행 중인 신청이 있어요.";
+      return "이미 진행 중인 신청이 있습니다.";
     case "INVALID_STATUS":
-      return "지금은 신청할 수 없는 상태예요. 주문 상태를 확인해주세요.";
+      return "지금은 신청할 수 없는 상태입니다. 주문 상태를 확인해주십시오.";
     case "PERIOD_EXPIRED":
-      return "반품·교환 가능 기간이 지났어요.";
+      return "반품·교환 가능 기간이 지났습니다.";
     default:
-      return error.message || "접수하지 못했어요. 잠시 후 다시 시도해주세요.";
+      return error.message || "접수하지 못했습니다. 잠시 후 다시 시도해주십시오.";
   }
 }
 
@@ -147,7 +147,7 @@ function OrderDetail() {
 
       {result ? (
         <div className="space-y-1 rounded-md bg-chip p-4 text-sm">
-          <p className="font-semibold">신청이 접수됐어요 (수량 {result.quantity}개)</p>
+          <p className="font-semibold">신청이 접수됐습니다 (수량 {result.quantity}개)</p>
           {/* 상품 금액 환불은 수량 비율이고, 반품 배송비는 이미 빠져 있다. 배송비 환불은 따로 온다 */}
           {result.expectedRefundAmount === null ? null : (
             <p className="text-muted">
@@ -271,9 +271,9 @@ function ClaimForm({
   const quantity = Number(quantityText);
   const quantityError =
     quantityText.trim() === "" || !Number.isInteger(quantity)
-      ? "수량을 입력해주세요."
+      ? "수량을 입력해주십시오."
       : quantity < 1 || quantity > item.activeQuantity
-        ? `수량은 1개 이상 ${item.activeQuantity}개 이하로 입력해주세요.`
+        ? `수량은 1개 이상 ${item.activeQuantity}개 이하로 입력해주십시오.`
         : null;
   return (
     <form

package/template/src/routes/orders.index.tsx

@@ -20,7 +20,7 @@ function Orders() {
   const orders = Route.useLoaderData();
 
   if (!orders.contents.length) {
-    return <p className="py-16 text-center text-muted">아직 주문이 없어요</p>;
+    return <p className="py-16 text-center text-muted">아직 주문이 없습니다</p>;
   }
 
   return (

package/template/src/routes/products.$productId.tsx

@@ -107,7 +107,7 @@ function ProductDetail() {
             setError(null);
             addToCart({ data: { productId: product.productId, optionId, quantity } })
               .then(() => navigate({ to: "/cart" }))
-              .catch(() => setError("장바구니에 담지 못했어요. 다시 시도해주세요"))
+              .catch(() => setError("장바구니에 담지 못했습니다. 다시 시도해주십시오"))
               .finally(() => setSubmitting(false));
           }}
         >

package/template/src/routes/products.index.tsx

@@ -71,7 +71,7 @@ function Products() {
           type="search"
           name="keyword"
           defaultValue={applied.keyword ?? ""}
-          placeholder="상품을 검색해요"
+          placeholder="상품 검색"
           className="h-11 flex-1 rounded-md border border-line px-3"
         />
         {applied.categoryId ? (
@@ -104,7 +104,7 @@ function Products() {
       </div>
 
       {page.contents.length === 0 ? (
-        <p className="py-16 text-center text-muted">조건에 맞는 상품이 없어요</p>
+        <p className="py-16 text-center text-muted">조건에 맞는 상품이 없습니다</p>
       ) : (
         <div className="grid grid-cols-2 gap-4 md:grid-cols-4">
           {page.contents.map((product) => (