@ait-co/devtools 0.1.113 → 0.1.115

package/dist/bundle-KFs4t-wc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-KFs4t-wc.d.ts","names":[],"sources":["../src/test-runner/bundle.ts"],"mappings":";;AAqEA;;;;;AAmBA;;;;;AAuPA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA1QiB,aAAA;;;;;;;EAOf,cAAA;;;;;EAKA,UAAA;AAAA;;;;;UAOe,YAAA;EACf,IAAA;EACA,QAAA;AAAA;;;;;;;;;;;;;;;iBAqPoB,cAAA,CAAe,OAAA,UAAiB,IAAA,GAAO,aAAA,GAAgB,OAAA,CAAQ,YAAA"}
+{"version":3,"file":"bundle-KFs4t-wc.d.ts","names":[],"sources":["../src/test-runner/bundle.ts"],"mappings":";;AAqEA;;;;;AAmBA;;;;;AA8TA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAjViB,aAAA;;;;;;;EAOf,cAAA;;;;;EAKA,UAAA;AAAA;;;;;UAOe,YAAA;EACf,IAAA;EACA,QAAA;AAAA;;;;;;;;;;;;;;;iBA4ToB,cAAA,CAAe,OAAA,UAAiB,IAAA,GAAO,aAAA,GAAgB,OAAA,CAAQ,YAAA"}

package/dist/mcp/cli.js

@@ -298,12 +298,31 @@ async function discoverTestFiles(patterns, cwd) {
 *
 * SECRET-HANDLING: the returned bundle code is caller-managed; never log it.
 */
+/** The SDK package name that mini-app test code imports from. */
+const SDK_PACKAGE = "@apps-in-toss/web-framework";
+/**
+* Names the runtime installs as globals before invoking the user factory.
+* The `vitest` virtual module re-exports each as a lazy getter that reads from
+* `globalThis` at access time. Keep in sync with the globals installed in
+* `runtime.ts#runTestModule`.
+*/
+const VITEST_GLOBAL_NAMES = [
+	"describe",
+	"it",
+	"test",
+	"expect",
+	"beforeAll",
+	"afterAll",
+	"beforeEach",
+	"afterEach",
+	"vi"
+];
 /**
 * Matches the bare SDK package and any sub-path import
 * (`@apps-in-toss/web-framework`, `@apps-in-toss/web-framework/foo`).
 * Built from {@link SDK_PACKAGE} so the package name has a single source.
 */
-const SDK_IMPORT_FILTER = new RegExp(`^${"@apps-in-toss/web-framework".replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`);
+const SDK_IMPORT_FILTER = new RegExp(`^${SDK_PACKAGE.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`);
 /**
 * esbuild plugin that intercepts SDK imports and redirects them to the
 * `window.__sdk` proxy that `src/in-app/auto.ts` installs at runtime.
@@ -344,6 +363,53 @@ module.exports = __proxy;
 	};
 }
 /**
+* esbuild plugin that intercepts `import … from 'vitest'` and replaces it with
+* a virtual module that delegates every named import to `globalThis` at ACCESS
+* time (not at bundle-evaluation time).
+*
+* The runtime installs `describe/it/test/expect/beforeAll/afterAll/beforeEach/
+* afterEach/vi` as globals inside `runTestModule`, which runs AFTER the bundle
+* IIFE is evaluated. A value-copy redirect (`export var describe =
+* globalThis.describe`) would therefore capture `undefined` at evaluation time
+* and the user's `describe(...)` calls would be no-ops — registering zero tests.
+*
+* The fix defers the lookup to call time using per-name **getter** exports.
+* We emit a CommonJS module that:
+*   1. sets `__esModule = true` so esbuild's `__toESM` interop maps each named
+*      import directly to a property access on the module (NOT wrapped under a
+*      `default` shim — which is what happens for a bare Proxy whose own-keys
+*      are empty, leaving every named import `undefined`);
+*   2. defines each global name as a getter that reads `globalThis[name]` on
+*      every access. So `import { describe } from 'vitest'` compiles to
+*      `import_vitest.describe`, whose getter returns the real `describe` only
+*      when the factory calls it — after `runTestModule` installs the globals.
+*
+* A plain `module.exports = new Proxy(...)` does NOT work here: esbuild routes
+* the virtual module through `__toESM`, which enumerates own-keys (none on an
+* empty Proxy target) and therefore exposes zero named exports. Explicit getter
+* properties give `__toESM` real keys to map while keeping access lazy.
+*/
+function vitestRedirectPlugin() {
+	return {
+		name: "vitest-redirect",
+		setup(build) {
+			build.onResolve({ filter: /^vitest$/ }, () => ({
+				path: "vitest",
+				namespace: "vitest-redirect"
+			}));
+			build.onLoad({
+				filter: /^vitest$/,
+				namespace: "vitest-redirect"
+			}, () => {
+				return {
+					contents: `Object.defineProperty(exports, '__esModule', { value: true });\n${VITEST_GLOBAL_NAMES.map((name) => `Object.defineProperty(exports, ${JSON.stringify(name)}, { enumerable: true, get: function() { return globalThis[${JSON.stringify(name)}]; } });`).join("\n")}\n`,
+					loader: "js"
+				};
+			});
+		}
+	};
+}
+/**
 * esbuild plugin that transforms the user test file into a module that exports
 * an async `__userFactory` function. The factory defers the user's top-level
 * test registration code (describe/it/test calls) so it only runs when
@@ -490,7 +556,11 @@ async function bundleTestFile(absPath, opts) {
 		platform: "browser",
 		target: "es2022",
 		write: false,
-		plugins: [userFactoryPlugin(absPath), sdkRedirectPlugin()],
+		plugins: [
+			userFactoryPlugin(absPath),
+			vitestRedirectPlugin(),
+			sdkRedirectPlugin()
+		],
 		external: extraExternals,
 		treeShaking: true,
 		footer: { js: `globalThis[${JSON.stringify(globalName)}] = ${globalName};` }
@@ -2767,6 +2837,9 @@ const en = {
 	"dashboard.inspector.waiting": "Attach a page to enable the \"Open DevTools\" button",
 	"inspector.error.noTarget": "No page attached. Attach a device and try again.",
 	"inspector.error.relayDown": "Relay is not active. Start a relay session first.",
+	"dashboard.watchdog.title": "Server has shut down",
+	"dashboard.watchdog.body": "The MCP server has stopped. This session is no longer active. You may close this tab.",
+	"dashboard.watchdog.close": "Close tab",
 	"attach.title": "AIT Debug Session — QR Scan",
 	"attach.deployment": "deployment: {label}",
 	"attach.steps.section": "How to scan",
@@ -3002,6 +3075,9 @@ const tables = {
 		"dashboard.inspector.waiting": "페이지를 attach하면 \"디버그 툴 열기\" 버튼이 표시됩니다",
 		"inspector.error.noTarget": "연결된 페이지가 없습니다. 기기를 attach한 후 다시 시도하세요.",
 		"inspector.error.relayDown": "relay가 활성화되지 않았습니다. start_debug로 relay를 기동하세요.",
+		"dashboard.watchdog.title": "서버가 종료되었습니다",
+		"dashboard.watchdog.body": "MCP server가 종료되어 이 세션이 더 이상 유효하지 않습니다. 이 탭을 닫아도 됩니다.",
+		"dashboard.watchdog.close": "탭 닫기",
 		"attach.title": "AIT 디버그 세션 — QR 스캔",
 		"attach.deployment": "deployment: {label}",
 		"attach.steps.section": "스캔 절차",
@@ -3549,7 +3625,7 @@ function buildLangSwitcher(path, existingParams, locale, s) {
 *   - tunnel wssUrl은 "터널 연결됨" 상태 표시에서 UP/DOWN만 노출.
 *     wssUrl 값 자체는 dashboard HTML에 넣지 않는다.
 */
-function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new URLSearchParams(), devtoolsEntryUrl = null) {
+function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new URLSearchParams(), devtoolsEntryUrl = null, sseRefreshIntervalMs = 9e4) {
 	const s = resolveLocaleStrings(locale);
 	const now = (/* @__PURE__ */ new Date()).toISOString();
 	const tunnelStatus = state.tunnel.up ? s("dashboard.tunnel.up") : s("dashboard.tunnel.down");
@@ -3568,6 +3644,7 @@ function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new U
 	const pagesSection = state.pages === null ? "" : `<hr /><section id="pages-section"><h2>${escapeHtml(s("dashboard.pages.section"))}</h2><ul id="pages-list">${state.pages.length > 0 ? state.pages.map((p) => {
 		return `<li><span class="page-id">${escapeHtml(p.id)}</span> <span class="page-url">${escapeHtml(p.url.slice(0, 120))}</span></li>`;
 	}).join("\n") : `<li class="empty">${escapeHtml(s("dashboard.pages.empty"))}</li>`}</ul></section>`;
+	const watchdogTimeoutMs = sseRefreshIntervalMs < 5e3 ? sseRefreshIntervalMs * 3 : sseRefreshIntervalMs * 2 + 3e4;
 	const sseStrings = {
 		tunnelUp: JSON.stringify(s("dashboard.tunnel.up")),
 		tunnelDown: JSON.stringify(s("dashboard.tunnel.down")),
@@ -3578,7 +3655,11 @@ function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new U
 		copiedLabel: JSON.stringify(s("dashboard.url.copied")),
 		inspectorOpenLabel: JSON.stringify(s("dashboard.inspector.open")),
 		inspectorWaitingLabel: JSON.stringify(s("dashboard.inspector.waiting")),
-		dashboardSurface: true
+		dashboardSurface: true,
+		watchdogTimeoutMs,
+		watchdogTitle: JSON.stringify(s("dashboard.watchdog.title")),
+		watchdogBody: JSON.stringify(s("dashboard.watchdog.body")),
+		watchdogCloseLabel: JSON.stringify(s("dashboard.watchdog.close"))
 	};
 	const langSwitcher = buildLangSwitcher(path, params, locale, s);
 	const filled = dashboardChromeByLocale[locale].replaceAll("__LANG_SWITCHER__", langSwitcher).replaceAll("__NOW__", escapeHtml(now)).replaceAll("__TUNNEL_CLASS__", tunnelClass).replaceAll("__TUNNEL_STATUS__", escapeHtml(tunnelStatus)).replaceAll("__ATTACH_SECTION__", attachSection).replaceAll("__INSPECTOR_SECTION__", inspectorSection).replaceAll("__PAGES_SECTION__", pagesSection);
@@ -3604,6 +3685,10 @@ function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new U
 *   - clipboard: navigator.clipboard.writeText → 실패/부재 시 textarea execCommand fallback.
 *   - 피드백: 버튼 라벨이 COPIED_LABEL로 ~1.5초 전환 후 COPY_LABEL로 복귀.
 *
+* SSE watchdog (#681): SSE 주기 갱신이 `watchdogTimeoutMs` 동안 수신되지 않으면
+* server가 종료된 것으로 판단한다. `window.close()`를 시도하고, 닫히지 않으면
+* 폴백 안내 화면으로 교체해 stale QR이 계속 보이는 오해를 항상 방지한다.
+*
 * 문자열 인자는 빌드타임에 ko/en 테이블에서 가져와 JSON.stringify로 이미 escape됨.
 *
 * SECRET-HANDLING: URL 값을 console.log 등으로 출력하지 않는다.
@@ -3623,6 +3708,14 @@ function buildSseScript(strings) {
       var INSPECTOR_OPEN_LABEL = ${strings.inspectorOpenLabel};
       var INSPECTOR_WAITING_LABEL = ${strings.inspectorWaitingLabel};
 
+      // ── SSE watchdog 상수 (#681) ──────────────────────────────────────────
+      // server의 SSE refresh 주기(기본 90s)보다 넉넉히 큰 값 — 주기 × 2 + 30s 여유.
+      // token-fill 패턴으로 server에서 계산해 주입한다.
+      var WATCHDOG_TIMEOUT_MS = ${strings.watchdogTimeoutMs};
+      var WATCHDOG_TITLE = ${strings.watchdogTitle};
+      var WATCHDOG_BODY = ${strings.watchdogBody};
+      var WATCHDOG_CLOSE_LABEL = ${strings.watchdogCloseLabel};
+
       // ── 클립보드 복사 헬퍼 ────────────────────────────────────────────────
       function copyText(text) {
         if (navigator.clipboard && navigator.clipboard.writeText) {
@@ -3677,9 +3770,65 @@ function buildSseScript(strings) {
         }
       });
 
+      // ── SSE watchdog (#681) ───────────────────────────────────────────────
+      // 마지막으로 SSE 메시지를 수신한 시각. 스크립트 로드 시각으로 초기화한다.
+      // (서버가 /events 연결 즉시 초기 상태를 push하므로 onmessage가 곧 갱신한다.)
+      var lastSeen = Date.now();
+      // watchdog이 한 번 발화하면 타이머를 clear해 중복 실행 방지.
+      var watchdogFired = false;
+      var watchdogTimer = null;
+
+      // 폴백 UI — window.close()가 무시되면 stale QR 대신 안내 화면을 표시한다.
+      function showWatchdogFallback() {
+        if (document.body) {
+          document.body.innerHTML =
+            '<div style="display:flex;flex-direction:column;align-items:center;justify-content:center;' +
+            'height:100vh;font-family:sans-serif;text-align:center;padding:2rem;box-sizing:border-box;">' +
+            '<p style="font-size:1.4rem;font-weight:bold;margin-bottom:1rem;">' + WATCHDOG_TITLE + '</p>' +
+            '<p style="color:#555;margin-bottom:2rem;">' + WATCHDOG_BODY + '</p>' +
+            '<button onclick="window.close()" ' +
+            'style="padding:0.6rem 1.4rem;font-size:1rem;cursor:pointer;border:1px solid #ccc;' +
+            'border-radius:6px;background:#f5f5f5;">' + WATCHDOG_CLOSE_LABEL + '</button>' +
+            '</div>';
+        }
+      }
+
+      function fireWatchdog() {
+        if (watchdogFired) return;
+        watchdogFired = true;
+        if (watchdogTimer) { clearInterval(watchdogTimer); watchdogTimer = null; }
+        // 폴백 UI를 먼저 표시한다 — close가 성공하면 어차피 페이지가 닫혀 보이지 않는다.
+        // close 실패(opener 없는 탭)에 대비해 stale QR 대신 안내 화면을 항상 보장한다.
+        showWatchdogFallback();
+        // window.close() 시도 — OS가 연 탭은 opener가 없어 무시될 수 있다.
+        window.close();
+      }
+
+      // 주기적으로 lastSeen을 검사 — WATCHDOG_TIMEOUT_MS 초과 시 발화.
+      // 검사 간격: WATCHDOG_TIMEOUT_MS / 6, 단 최소 1s 이상이되 timeout 자체보다 크지 않게 한다.
+      // (sseRefreshIntervalMs가 작을 때 최솟값 1s가 timeout을 초과하는 경우 방지 — 테스트 격리.)
+      var checkIntervalMs = Math.min(
+        Math.max(1000, Math.round(WATCHDOG_TIMEOUT_MS / 6)),
+        WATCHDOG_TIMEOUT_MS,
+      );
+      watchdogTimer = setInterval(function () {
+        if (watchdogFired) return;
+        if (Date.now() - lastSeen > WATCHDOG_TIMEOUT_MS) {
+          fireWatchdog();
+        }
+      }, checkIntervalMs);
+
       // ── SSE 구독 ──────────────────────────────────────────────────────────
       var src = new EventSource('/events');
+      src.onopen = function () {
+        // 연결 복구 시 lastSeen 갱신 — 일시적 끊김이 watchdog을 발화시키지 않게.
+        // watchdog이 이미 발화했으면 갱신하지 않는다(폴백 UI를 그대로 유지).
+        if (!watchdogFired) { lastSeen = Date.now(); }
+      };
       src.onmessage = function (e) {
+        // SSE 메시지 수신 — lastSeen 갱신으로 watchdog 리셋.
+        // watchdog 발화 후라면 갱신해도 타이머가 이미 clear됐으므로 효과 없음.
+        if (!watchdogFired) { lastSeen = Date.now(); }
         try {
           var s = JSON.parse(e.data);
           // 터널 상태 갱신
@@ -3786,7 +3935,7 @@ function buildSseScript(strings) {
 * SECRET-HANDLING: TOTP at= 코드는 attachUrl 캡슐 안에서만 노출 — 의도된 transport.
 * inspectorStableUrl은 /inspector 안정 URL (127.0.0.1, 시크릿 없음) — 노출 가능.
 */
-function buildAttachHtml(qrDataUrl, safeLabel, safeAttachUrl, locale, path = "/attach", params = new URLSearchParams(), mode, pagesAttached = false, inspectorStableUrl = null) {
+function buildAttachHtml(qrDataUrl, safeLabel, safeAttachUrl, locale, path = "/attach", params = new URLSearchParams(), mode, pagesAttached = false, inspectorStableUrl = null, sseRefreshIntervalMs = 9e4) {
 	const s = resolveLocaleStrings(locale);
 	const langSwitcher = buildLangSwitcher(path, params, locale, s);
 	const family = attachFamilyForMode(mode);
@@ -3794,6 +3943,7 @@ function buildAttachHtml(qrDataUrl, safeLabel, safeAttachUrl, locale, path = "/a
 	if (pagesAttached && inspectorStableUrl) inspectorSection = `<a class="inspector-link" id="inspector-link" href="${escapeHtml(inspectorStableUrl)}" target="_blank" rel="noopener noreferrer">${escapeHtml(s("dashboard.inspector.open"))}</a>`;
 	else inspectorSection = `<span class="inspector-hint" id="inspector-link">${escapeHtml(s("dashboard.inspector.waiting"))}</span>`;
 	const filled = attachChromeByLocale[locale][family].replaceAll("__LANG_SWITCHER__", langSwitcher).replaceAll("__MODE_LABEL__", buildModeLabel(mode, s)).replaceAll("__QR_DATA_URL__", qrDataUrl).replaceAll("__SAFE_LABEL__", safeLabel).replaceAll("__SAFE_ATTACH_URL__", safeAttachUrl).replaceAll("__INSPECTOR_SECTION__", inspectorSection);
+	const watchdogTimeoutMs = sseRefreshIntervalMs < 5e3 ? sseRefreshIntervalMs * 3 : sseRefreshIntervalMs * 2 + 3e4;
 	const sseScript = buildSseScript({
 		tunnelUp: JSON.stringify(s("dashboard.tunnel.up")),
 		tunnelDown: JSON.stringify(s("dashboard.tunnel.down")),
@@ -3804,7 +3954,11 @@ function buildAttachHtml(qrDataUrl, safeLabel, safeAttachUrl, locale, path = "/a
 		copiedLabel: JSON.stringify(s("dashboard.url.copied")),
 		inspectorOpenLabel: JSON.stringify(s("dashboard.inspector.open")),
 		inspectorWaitingLabel: JSON.stringify(s("dashboard.inspector.waiting")),
-		dashboardSurface: false
+		dashboardSurface: false,
+		watchdogTimeoutMs,
+		watchdogTitle: JSON.stringify(s("dashboard.watchdog.title")),
+		watchdogBody: JSON.stringify(s("dashboard.watchdog.body")),
+		watchdogCloseLabel: JSON.stringify(s("dashboard.watchdog.close"))
 	});
 	return filled.replace("</body>", `${sseScript}\n</body>`);
 }
@@ -3821,6 +3975,7 @@ async function startQrHttpServer(getDashboardState, options) {
 	const { default: QRCode } = await import("qrcode");
 	/** SSE 활성 연결 목록 — `notifyStateChange()` 시 전체 push. */
 	const sseClients = [];
+	const refreshIntervalMs = options?.sseRefreshIntervalMs ?? 9e4;
 	/** SSE 연결 하나에 상태 이벤트를 flush한다. */
 	function pushStateToClient(res, state) {
 		const payload = JSON.stringify({
@@ -3859,7 +4014,7 @@ async function startQrHttpServer(getDashboardState, options) {
 				if (!addr || typeof addr === "string") return null;
 				return `http://127.0.0.1:${addr.port}/devtools/`;
 			})();
-			const html = buildDashboardHtml(state, qrDataUrl, locale, path, params, devtoolsEntryUrl);
+			const html = buildDashboardHtml(state, qrDataUrl, locale, path, params, devtoolsEntryUrl, refreshIntervalMs);
 			res.writeHead(200, {
 				"Content-Type": "text/html; charset=utf-8",
 				"Cache-Control": "no-store"
@@ -3915,7 +4070,7 @@ async function startQrHttpServer(getDashboardState, options) {
 				type: "image/png",
 				errorCorrectionLevel: "M"
 			}).then((dataUrl) => {
-				const html = buildAttachHtml(dataUrl, escapeHtml(deploymentIdLabel), escapeHtml(attachUrl), locale, path, params, mode, pagesAttached, inspectorStableUrlForAttach);
+				const html = buildAttachHtml(dataUrl, escapeHtml(deploymentIdLabel), escapeHtml(attachUrl), locale, path, params, mode, pagesAttached, inspectorStableUrlForAttach, refreshIntervalMs);
 				res.writeHead(200, {
 					"Content-Type": "text/html; charset=utf-8",
 					"Cache-Control": "no-store"
@@ -3998,7 +4153,6 @@ async function startQrHttpServer(getDashboardState, options) {
 			pushStateToClient(client, state);
 		} catch {}
 	}
-	const refreshIntervalMs = options?.sseRefreshIntervalMs ?? 9e4;
 	const refreshHandle = setInterval(() => {
 		if (sseClients.length > 0 && getDashboardState) notifyStateChangeInternal();
 	}, refreshIntervalMs).unref();
@@ -5411,7 +5565,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	return "0.1.113";
+	return "0.1.115";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -6331,7 +6485,7 @@ function createDebugServer(deps) {
 	}
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.113"
+		version: "0.1.115"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -8231,7 +8385,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.113"
+		version: "0.1.115"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {