sayren 0.3.3 → 0.3.4

package/dist/index.mjs

@@ -5953,6 +5953,85 @@ const mcp_rule_server_only_env_why = ((inputs = {}, options = {}) => {
 	return ko_mcp_rule_server_only_env_why(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_example.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_ExampleInputs */
+const ko_mcp_rule_server_only_import_example = () => {
+	return `// src/lib/my-orders.ts — 브라우저도 가져가는 파일
+import { apiFor } from "./api.server";
+import { readToken } from "./session.server";
+
+// handler 안에서만 부른다. 일반 함수(export function)로 두면 브라우저 번들에 남는다
+export const listMyOrders = createServerFn({ method: "GET" }).handler(() =>
+  apiFor({ accessToken: readToken() }).orders.list(),
+);`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_ExampleInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_example = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_example(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_fix.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_FixInputs */
+const ko_mcp_rule_server_only_import_fix = () => {
+	return `서버 API를 부르는 함수는 \`*.server.ts\` 파일로 옮기거나 \`createServerFn().handler(…)\`로 감싼다. 브라우저가 함께 가져가는 파일(컴포넌트·\`src/lib/*.ts\`)은 서버 함수만 내보내고, \`*.server.ts\`의 값은 handler 안에서만 부른다. 서버 전용 모듈을 다시 내보내지 않는다`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_FixInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_fix = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_fix(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_title.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_TitleInputs */
+const ko_mcp_rule_server_only_import_title = () => {
+	return `서버 전용 모듈(\`*.server.ts\`)에서 가져온 것은 서버 함수 안에서만 쓴다`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_TitleInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_title = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_title(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_why.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_WhyInputs */
+const ko_mcp_rule_server_only_import_why = () => {
+	return `TanStack Start는 서버 함수 handler만 브라우저 번들에서 걷어낸다. 그 밖에서 \`*.server.ts\`(\`api.server\` 등)의 값을 쓰면 import가 브라우저 번들에 남고, import 보호가 버전 빌드(\`vite build\`)를 실패시킨다. 개발 서버와 타입 검사는 이것을 잡지 않는다`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_WhyInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_why = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_why(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/mcp_rule_tenant_header_fix.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -6565,6 +6644,42 @@ const mcp_verify_server_only_env = ((inputs = {}, options = {}) => {
 	return ko_mcp_verify_server_only_env(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_verify_server_only_import.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ specifier: NonNullable<unknown>, name: NonNullable<unknown> }} Mcp_Verify_Server_Only_ImportInputs */
+const ko_mcp_verify_server_only_import = (i) => {
+	return `서버 전용 모듈 \`${i?.specifier}\`의 \`${i?.name}\`을 서버 함수(handler) 밖에서 쓴다. 브라우저 번들에 남아 버전 빌드가 import 보호로 실패한다`;
+};
+/**
+
+* @param {Mcp_Verify_Server_Only_ImportInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_verify_server_only_import = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_verify_server_only_import(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_verify_server_only_import_reexport.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ specifier: NonNullable<unknown> }} Mcp_Verify_Server_Only_Import_ReexportInputs */
+const ko_mcp_verify_server_only_import_reexport = (i) => {
+	return `서버 전용 모듈 \`${i?.specifier}\`를 부수 효과 import나 다시 내보내기로 가져온다. 브라우저 번들에 남아 버전 빌드가 import 보호로 실패한다`;
+};
+/**
+
+* @param {Mcp_Verify_Server_Only_Import_ReexportInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_verify_server_only_import_reexport = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_verify_server_only_import_reexport(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/mcp_verify_tenant_header.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -6652,7 +6767,7 @@ function takeLangFlag(argv) {
 
 //#endregion
 //#region package.json
-var version = "0.3.3";
+var version = "0.3.4";
 
 //#endregion
 //#region src/client.ts
@@ -7875,6 +7990,15 @@ const RULES = [
 		templateFile: "src/lib/ordering.ts",
 		severity: "warning"
 	}),
+	defineRule({
+		id: "server-only-import",
+		title: mcp_rule_server_only_import_title,
+		why: mcp_rule_server_only_import_why,
+		fix: mcp_rule_server_only_import_fix,
+		example: mcp_rule_server_only_import_example,
+		doc: "/guides/mcp-customize",
+		templateFile: "src/lib/api.server.ts"
+	}),
 	defineRule({
 		id: "local-import-exists",
 		title: mcp_rule_local_import_exists_title,
@@ -7988,6 +8112,7 @@ function verifySources(files, options = {}) {
 	const clientQuery = matches(/\buse(Suspense)?Query\(/);
 	if (clientQuery && !has("ensureQueryData(") && !has("prefetchQuery(")) inFile("loader-first", clientQuery, mcp_verify_loader_first_query(), /\buse(Suspense)?Query\(/);
 	if (has("createStorefrontClient(") && !has("loader")) inProject("loader-first", mcp_verify_loader_first_missing());
+	findings.push(...serverOnlyImports(cleaned));
 	if (options.paths) findings.push(...missingLocalImports(cleaned, options.paths));
 	return findings;
 }
@@ -8049,6 +8174,113 @@ function missingLocalImports(files, paths) {
 	}
 	return out;
 }
+/**
+* 서버 전용 모듈 — TanStack Start import 보호의 기본 판정과 같다(클라이언트 환경에서 `*.server.*` 파일과
+* `@tanstack/{react,solid,vue}-start/server`를 막는다). 표시 모듈 `…/server-only`는 막는 대상이 아니다.
+*/
+const SERVER_ONLY_SPECIFIER = /^(?:@tanstack\/(?:react|solid|vue)-start\/server|\.{1,2}\/(?:[^"'\n]*\/)?[^/"'\n]+\.server(?:\.[cm]?[jt]sx?)?)$/;
+/** 그 자체가 브라우저로 가지 않아 import 보호가 보지 않는 파일 — `*.server.*`와 테스트 */
+const SERVER_ONLY_IMPORTER = /\.server\.[cm]?[jt]sx?$|\.(test|spec)\.[cm]?[jt]sx?$/;
+/** 스스로 서버 전용임을 밝힌 모듈 — 브라우저가 가져가면 import 보호가 그 모듈을 막으므로 여기서는 보지 않는다 */
+const SERVER_ONLY_MARKER = /\bimport\s*["']@tanstack\/(?:react|solid|vue)-start\/server-only["']/;
+/** 정적 import 문(여러 줄 포함). 1: `type` 2: 가져오는 이름들 3: 모듈 */
+const STATIC_IMPORT = /\bimport\s+(type\s+)?([^;"'`]*?)\s*\bfrom\s*["']([^"'\n]+)["']\s*;?/g;
+/** 부수 효과 import·다시 내보내기 — 서버 전용 모듈이면 그대로 브라우저 번들에 남는다 */
+const SIDE_EFFECT_OR_REEXPORT = /\bimport\s*["']([^"'\n]+)["']|\bexport\s+(?:type\s+)?(?:\*(?:\s+as\s+[\w$]+)?|\{[^}]*\})\s*from\s*["']([^"'\n]+)["']/g;
+/**
+* 서버에서만 도는 자리 — Start 컴파일러가 클라이언트 번들에서 걷어내는 인자다. `createServerFn().handler(…)`,
+* `createMiddleware().server(…)`·`createIsomorphicFn().server(…)`, `createServerOnlyFn(…)`, 서버 라우트
+* `createFileRoute(…)({ server: { handlers } })`의 `server` 객체. 일치의 마지막 글자가 여는 괄호다
+*/
+const SERVER_CONTEXT = /\.(?:handler|server)\s*\(|\bcreateServerOnlyFn\s*\(|\bserver\s*:\s*\{/g;
+/** import 문이 가져오는 값 이름 — `type` 표시가 붙은 이름은 빼고, `a as b`는 `b`다 */
+function importedBindings(clause) {
+	const names = [];
+	const named = /\{([^}]*)\}/.exec(clause);
+	for (const part of named?.[1]?.split(",") ?? []) {
+		const item = part.trim();
+		if (!item || /^type\s/.test(item)) continue;
+		const alias = /\bas\s+([\w$]+)$/.exec(item);
+		names.push(alias ? alias[1] : item.split(/\s+/)[0]);
+	}
+	const rest = clause.replace(/\{[^}]*\}/, "");
+	const namespace = /\*\s*as\s+([\w$]+)/.exec(rest);
+	if (namespace) names.push(namespace[1]);
+	const defaultName = /^\s*([\w$]+)\s*(?:,|$)/.exec(rest.replace(/\*\s*as\s+[\w$]+/, ""));
+	if (defaultName) names.push(defaultName[1]);
+	return names.filter((name) => /^[A-Za-z_$][\w$]*$/.test(name));
+}
+/** `open` 위치의 여는 괄호와 짝이 맞는 닫는 괄호 다음 위치. 문자열·템플릿 리터럴 안의 괄호는 세지 않는다 */
+function closingBracket(source, open) {
+	let depth = 0;
+	let quote = null;
+	for (let i = open; i < source.length; i++) {
+		const ch = source[i];
+		if (quote) {
+			if (ch === "\\") i++;
+			else if (ch === quote) quote = null;
+			continue;
+		}
+		if (ch === "\"" || ch === "'" || ch === "`") quote = ch;
+		else if (ch === "(" || ch === "{" || ch === "[") depth++;
+		else if ((ch === ")" || ch === "}" || ch === "]") && --depth === 0) return i + 1;
+	}
+	return source.length;
+}
+/** 줄 수를 지키며 구간을 공백으로 지운다 — 남은 코드의 위치가 원본 줄 번호와 맞아야 한다 */
+const blank = (text) => text.replace(/[^\n]/g, " ");
+/**
+* 브라우저로 갈 수 있는 모듈이 서버 전용 모듈을 쓰는가(이슈 #88). TanStack Start는 서버 함수 handler처럼 서버에서만
+* 도는 인자를 클라이언트 번들에서 걷어내고, 그 뒤에도 `*.server.*` import가 남으면 import 보호로 빌드를 실패시킨다.
+* 그래서 import 자체가 아니라 **서버 자리 밖에서 가져온 이름을 쓰는 것**을 위반으로 본다. 템플릿은 라우트·`lib`에서
+* `apiFor`를 import하고 `createServerFn().handler(…)`·서버 라우트 `server` 안에서만 부른다. 서버 자리 밖의 일반 함수(예: 서버 API를 부르는
+* `export function wishedOf()`)는 브라우저 번들에 남으므로 위반이다 — 그 함수를 `*.server.ts`로 옮기거나 서버 함수로 감싼다.
+* 정적 검사라 서버 자리에서만 부르는 지역 함수까지 따라가지는 않는다(보수적으로 위반으로 본다).
+*/
+function serverOnlyImports(files) {
+	const out = [];
+	for (const file of files) {
+		if (!CLIENT_FILE.test(file.path) || SERVER_ONLY_IMPORTER.test(file.path)) continue;
+		if (SERVER_ONLY_MARKER.test(file.content)) continue;
+		const lineAt = (index) => file.content.slice(0, index).split("\n").length;
+		for (const match of file.content.matchAll(SIDE_EFFECT_OR_REEXPORT)) {
+			const specifier = match[1] ?? match[2];
+			if (!SERVER_ONLY_SPECIFIER.test(specifier)) continue;
+			out.push({
+				ruleId: "server-only-import",
+				file: file.path,
+				line: lineAt(match.index),
+				detail: mcp_verify_server_only_import_reexport({ specifier })
+			});
+		}
+		const bindings = /* @__PURE__ */ new Map();
+		let body = file.content.replace(STATIC_IMPORT, (statement, typeOnly, clause, specifier) => {
+			if (!typeOnly && SERVER_ONLY_SPECIFIER.test(specifier)) for (const name of importedBindings(clause)) bindings.set(name, specifier);
+			return blank(statement);
+		});
+		if (bindings.size === 0) continue;
+		for (const context of [...body.matchAll(SERVER_CONTEXT)]) {
+			const open = context.index + context[0].length - 1;
+			if (body[open] !== "(" && body[open] !== "{") continue;
+			const end = closingBracket(body, open);
+			body = body.slice(0, open) + blank(body.slice(open, end)) + body.slice(end);
+		}
+		for (const [name, specifier] of bindings) {
+			const use = (/* @__PURE__ */ new RegExp(`(?<![\\w$.])${name.replace(/\$/g, "\\$")}(?![\\w$])`)).exec(body);
+			if (!use) continue;
+			out.push({
+				ruleId: "server-only-import",
+				file: file.path,
+				line: lineAt(use.index),
+				detail: mcp_verify_server_only_import({
+					name,
+					specifier
+				})
+			});
+		}
+	}
+	return out;
+}
 
 //#endregion
 //#region ../mcp/src/verify-report.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "type": "module",
   "description": "sayren 스토어프론트 CLI — 호스팅 중인 사이트의 소스를 내려받고(pull) 로컬에서 고친 뒤 배포(deploy)합니다",
   "bin": {