@ait-co/devtools 0.1.144 → 0.2.1

package/dist/panel/index.js

@@ -25339,57 +25339,6 @@ const en = {
 	"notifications.option.newAgreement": "newAgreement (first-time agree)",
 	"notifications.option.alreadyAgreed": "alreadyAgreed (already opted-in)",
 	"notifications.option.agreementRejected": "agreementRejected (user declined)",
-	"dashboard.lang.ko": "한국어",
-	"dashboard.lang.en": "English",
-	"dashboard.title": "AIT Debug Dashboard",
-	"dashboard.updated": "Last updated: {ts}",
-	"dashboard.tunnel.section": "Tunnel status",
-	"dashboard.tunnel.up": "Connected",
-	"dashboard.tunnel.down": "Disconnected",
-	"dashboard.attach.section": "Attach QR",
-	"dashboard.attach.hint": "Call the start_attach MCP tool to show the QR here.",
-	"dashboard.attach.tunnelDown": "Relay disconnected — this QR is no longer valid. Restart the relay, then regenerate the QR.",
-	"dashboard.pages.section": "Connected Pages",
-	"dashboard.pages.empty": "No attached pages",
-	"dashboard.url.copy": "Copy",
-	"dashboard.url.copied": "Copied",
-	"dashboard.inspector.section": "Inspector",
-	"dashboard.inspector.open": "Open DevTools",
-	"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",
-	"dashboard.conn.lost": "Connection lost — reconnecting…",
-	"dashboard.session.completeTitle": "Test run complete",
-	"dashboard.session.completeBody": "The runner exited cleanly. See your terminal for results.",
-	"dashboard.session.shutdownTitle": "Debug server stopped",
-	"dashboard.session.shutdownBody": "The MCP server has shut down; this session is no longer live. You can close this tab.",
-	"attach.title": "AIT Debug Session — QR Scan",
-	"attach.deployment": "deployment: {label}",
-	"attach.steps.section": "How to scan",
-	"attach.faq.section": "Troubleshooting checklist",
-	"attach.url.section": "URL (fallback)",
-	"attach.mode.sandbox": "env 2 — AITC Sandbox App (PWA)",
-	"attach.mode.intossDev": "env 3 — intoss-private relay dev",
-	"attach.sandbox.step1": "Launch the launcher PWA icon on your home screen (if the Safari address bar is visible, it is not standalone).",
-	"attach.sandbox.step2": "Scan this QR code with <strong>\"Scan QR with camera\"</strong> inside the launcher.",
-	"attach.sandbox.step3": "The mini-app opens fullscreen and the debug session attaches automatically.",
-	"attach.sandbox.step4": "<strong>Keep the app in the foreground until the test run finishes</strong> — backgrounding it will drop the debug session.",
-	"attach.sandbox.faq.notInstalled": "<strong>Launcher is not installed</strong> — open <code>devtools.aitc.dev/launcher/</code> once and add it to your home screen",
-	"attach.sandbox.faq.cameraApp": "<strong>Scanning with the camera app opens a Safari tab (bottom tab bar visible)</strong> — relaunch from the launcher icon and use the in-app scanner",
-	"attach.sandbox.faq.totp": "<strong>QR expired (TOTP — 30-second step, ±6 steps (~3 min) accepted)</strong> — scan a fresh QR code",
-	"attach.sandbox.faq.chii": "<strong>Chii injection failure / console is empty</strong> — verify the mini-app bundle has an <code>in-app</code> debug import",
-	"attach.intoss.step1": "Open the Toss app.",
-	"attach.intoss.step2": "Scan the QR code with your phone camera app.",
-	"attach.intoss.step3": "Tap <strong>\"Open in Toss\"</strong> when the popup appears.",
-	"attach.intoss.step4": "The mini-app opens and the debug session attaches automatically.",
-	"attach.intoss.step5": "<strong>Keep the Toss app in the foreground until the test run finishes</strong> — backgrounding it will drop the debug session.",
-	"attach.intoss.faq.appNotOpen": "<strong>Toss app does not open</strong> — check app version; scan with the system camera app (not the Toss in-app QR reader)",
-	"attach.intoss.faq.prepare": "<strong>Mini-app stuck in PREPARE state</strong> — verify the deep-link has a <code>_deploymentId</code> parameter",
-	"attach.intoss.faq.chii": "<strong>Chii injection failure / console is empty</strong> — verify the mini-app bundle has an <code>in-app</code> debug import",
-	"attach.intoss.faq.totp": "<strong>TOTP gate Layer C is inactive</strong> — check that <code>AIT_DEBUG_TOTP_SECRET</code> is set on the relay server",
 	"launcher.title": "AITC DevTools Launcher",
 	"launcher.description": "Scan the terminal QR code or paste the tunnel URL.",
 	"launcher.installCta": "Install launcher to your phone",
@@ -25568,57 +25517,6 @@ const ko = {
 	"notifications.option.newAgreement": "newAgreement (최초 동의)",
 	"notifications.option.alreadyAgreed": "alreadyAgreed (이미 동의됨)",
 	"notifications.option.agreementRejected": "agreementRejected (사용자 거절)",
-	"dashboard.lang.ko": "한국어",
-	"dashboard.lang.en": "English",
-	"dashboard.title": "AIT 디버그 Dashboard",
-	"dashboard.updated": "마지막 갱신: {ts}",
-	"dashboard.tunnel.section": "터널 상태",
-	"dashboard.tunnel.up": "연결됨",
-	"dashboard.tunnel.down": "끊어짐",
-	"dashboard.attach.section": "Attach QR",
-	"dashboard.attach.hint": "start_attach MCP tool을 호출하면 QR이 여기에 표시됩니다.",
-	"dashboard.attach.tunnelDown": "relay 연결이 끊겼습니다 — 이 QR은 더 이상 유효하지 않습니다. relay를 재시작한 뒤 QR을 다시 생성하세요.",
-	"dashboard.pages.section": "연결된 Pages",
-	"dashboard.pages.empty": "attach된 페이지 없음",
-	"dashboard.url.copy": "복사",
-	"dashboard.url.copied": "복사됨",
-	"dashboard.inspector.section": "인스펙터",
-	"dashboard.inspector.open": "디버그 툴 열기",
-	"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": "탭 닫기",
-	"dashboard.conn.lost": "연결 끊김 — 재연결 시도 중…",
-	"dashboard.session.completeTitle": "테스트 실행 완료",
-	"dashboard.session.completeBody": "러너가 정상 종료되었습니다. 결과는 터미널에서 확인하세요.",
-	"dashboard.session.shutdownTitle": "디버그 서버가 종료되었습니다",
-	"dashboard.session.shutdownBody": "MCP server가 종료되어 이 세션이 더 이상 유효하지 않습니다. 이 탭을 닫아도 됩니다.",
-	"attach.title": "AIT 디버그 세션 — QR 스캔",
-	"attach.deployment": "deployment: {label}",
-	"attach.steps.section": "스캔 절차",
-	"attach.faq.section": "진단 체크리스트",
-	"attach.url.section": "URL (fallback)",
-	"attach.mode.sandbox": "환경 2 — AITC Sandbox App (PWA)",
-	"attach.mode.intossDev": "환경 3 — intoss-private relay dev",
-	"attach.sandbox.step1": "홈 화면의 launcher PWA 아이콘으로 실행하세요 (Safari 주소창이 보이면 standalone이 아닙니다).",
-	"attach.sandbox.step2": "launcher 안의 <strong>\"QR 카메라로 스캔\"</strong>으로 이 QR 코드를 스캔하세요.",
-	"attach.sandbox.step3": "미니앱이 풀스크린으로 열리고 디버그 세션이 자동으로 attach됩니다.",
-	"attach.sandbox.step4": "<strong>테스트가 끝날 때까지 앱을 화면 앞에 유지하세요</strong> — 백그라운드로 전환하면 디버그 세션이 끊어집니다.",
-	"attach.sandbox.faq.notInstalled": "<strong>launcher가 설치돼 있지 않은 경우</strong> — <code>devtools.aitc.dev/launcher/</code>를 한 번 열어 홈 화면에 추가하세요",
-	"attach.sandbox.faq.cameraApp": "<strong>카메라 앱으로 스캔하면 Safari 탭으로 열립니다 (하단 탭 바 노출)</strong> — launcher 아이콘으로 다시 실행해 인앱 스캔을 사용하세요",
-	"attach.sandbox.faq.totp": "<strong>QR이 만료된 경우 (TOTP — 코드 1개는 30초 창, 만료 후 ~3분(±6 step) 이내 소급 허용)</strong> — 새 QR을 다시 스캔하세요",
-	"attach.sandbox.faq.chii": "<strong>Chii 주입 실패 / 콘솔이 비어 있는 경우</strong> — 미니앱 번들에 <code>in-app</code> debug import가 있는지 확인",
-	"attach.intoss.step1": "토스 앱을 실행하세요.",
-	"attach.intoss.step2": "폰 카메라 앱으로 QR 코드를 스캔하세요.",
-	"attach.intoss.step3": "팝업이 뜨면 <strong>\"토스로 열기\"</strong>를 탭하세요.",
-	"attach.intoss.step4": "미니앱이 열리고 디버그 세션이 자동으로 attach됩니다.",
-	"attach.intoss.step5": "<strong>테스트가 끝날 때까지 토스 앱을 화면 앞에 유지하세요</strong> — 백그라운드로 전환하면 디버그 세션이 끊어집니다.",
-	"attach.intoss.faq.appNotOpen": "<strong>토스 앱이 안 열리는 경우</strong> — 앱 버전 확인, 카메라 앱으로 스캔 (토스 앱 내 QR 리더 X)",
-	"attach.intoss.faq.prepare": "<strong>미니앱이 PREPARE 상태에서 멈추는 경우</strong> — deep-link에 <code>_deploymentId</code> 파라미터가 있는지 확인",
-	"attach.intoss.faq.chii": "<strong>Chii 주입 실패 / 콘솔이 비어 있는 경우</strong> — 미니앱 번들에 <code>in-app</code> debug import가 있는지 확인",
-	"attach.intoss.faq.totp": "<strong>TOTP gate Layer C가 비활성인 경우</strong> — relay 서버에 <code>AIT_DEBUG_TOTP_SECRET</code>이 설정돼 있는지 확인",
 	"launcher.title": "AITC DevTools Launcher",
 	"launcher.description": "터미널 QR을 스캔하거나 URL을 입력하세요.",
 	"launcher.installCta": "폰에 런처 설치하기",
@@ -25787,6 +25685,24 @@ function useT() {
 	return t;
 }
 //#endregion
+//#region src/mock/throttle-registry.ts
+/**
+* throttle 레지스트리 (devtools#834).
+*
+* 메서드별 마지막 *허용* 호출 시각만 담는 leaf 모듈이다. `state.ts`가 `reset()`에서
+* 이걸 비워야 하는데, 로직 본체(`throttle.ts`)는 거꾸로 `state.ts`를 읽는다 —
+* 그래서 **의존이 없는 이 파일로 레지스트리를 분리해** 순환 import를 피한다.
+*/
+/** 메서드별 마지막 *허용* 호출 시각(ms). */
+const lastAllowedAt = /* @__PURE__ */ new Map();
+/**
+* throttle 레지스트리를 비운다. `aitState.reset()`이 호출한다 — 상태를 되돌렸는데
+* 직전 세션의 호출 시각이 남아 있으면 첫 호출이 이유 없이 거부된다.
+*/
+function resetThrottleRegistry() {
+	lastAllowedAt.clear();
+}
+//#endregion
 //#region src/mock/state.ts
 /** SDK 호출 로그 ring buffer 상한 */
 const SDK_CALL_LOG_MAX = 200;
@@ -26016,6 +25932,7 @@ var AitStateManager = class {
 			...structuredClone(DEFAULT_STATE),
 			deviceId
 		};
+		resetThrottleRegistry();
 		this._notify();
 	}
 	_notify() {
@@ -26433,7 +26350,9 @@ function waitForPromptResponse(type) {
 * - 3.x 라인: 같은 실패가 "맨 Error"(위 envelope 필드 없음)로 평탄화된다 —
 *   sdk-example#284 "패턴 ① 오류 envelope 평탄화" 표.
 *
-* `src/test-runner/bridge-stub.ts`의 `NativeBridgeErrorShape`/`makeNativeError`가
+* `@ait-co/debugger`의 `packages/debugger/src/test-runner/bridge-stub.ts`(분리 전
+* 이 repo의 `src/test-runner/bridge-stub.ts`)에 있는
+* `NativeBridgeErrorShape`/`makeNativeError`가
 * 같은 shape을 이미 CI 러너 쪽에서 재현하고 있다(devtools#740) — 이 모듈은 그
 * shape을 mock 소비자 표면(`src/mock/**`)에 대해 재사용 가능한 형태로 옮긴 것이다.
 * 두 모듈은 레이어가 다르다: test-runner 쪽은 env3 blocking-call 인터셉터(빌드에
@@ -26811,6 +26730,50 @@ const _fetchAlbumItems = async (options) => {
 const _fetchAlbumItemsWithPermission = withPermission(_fetchAlbumItems, "photos");
 Object.assign(_fetchAlbumItemsWithPermission, { isSupported: () => true });
 //#endregion
+//#region src/mock/throttle.ts
+/**
+* THROTTLED 시뮬레이션 (devtools#834 — #770 §3 분리).
+*
+* 실기기 네이티브 브리지는 같은 메서드를 짧은 간격으로 연타하면
+* `APP_BRIDGE_THROTTLED`로 거부한다. 이 모듈은 그 per-method rate limit을
+* env1(mock)에서 **opt-in으로** 재현한다 — 다이얼(`failureModes.throttled`)이
+* 미설정이면 아무 일도 하지 않으므로 zero behavior change다.
+*
+* 설계 메모 두 가지:
+*
+* 1. **거부된 호출은 창을 갱신하지 않는다.** 마지막 *허용된* 호출 시각만 기록하므로,
+*    `intervalMs` 안에서 계속 연타해도 창이 밀려나지 않고 최초 허용 시점 기준으로
+*    풀린다. 네이티브 rate limit의 통상 동작이자, 연타 중 영원히 막히는(창이 계속
+*    갱신되는) 반-패턴을 피한다.
+* 2. **`observe()`에 걸지 않는다.** `observe()`는 `fn`을 호출하기 *전에* 감싸므로
+*    거기서 throw하면 원래 Promise를 반환하는 API가 **동기 throw**로 바뀐다.
+*    `threwSync`는 env1↔env3 동치 diff의 관측 축이라 그 차이가 곧 가짜 불일치가 된다.
+*    그래서 각 mock 구현 본문 안(= 그 API 자신의 sync/async 계약 안)에 수동 삽입한다.
+*/
+/**
+* `method`가 지금 throttle에 걸리면 네이티브 실패 에러를 돌려주고, 아니면
+* 호출 시각을 기록한 뒤 `undefined`를 돌려준다.
+*
+* 반환된 에러를 **호출부가 자신의 계약대로** 흘려보낸다 — async mock은 `throw`
+* (= reject), 콜백형 mock은 `onError(err)`. 그래서 이 함수 자체는 던지지 않는다.
+*/
+function throttleErrorFor(method) {
+	const dial = aitState.state.failureModes.throttled;
+	if (!dial?.methods.includes(method)) return void 0;
+	const now = Date.now();
+	const prev = lastAllowedAt.get(method);
+	if (prev !== void 0 && now - prev < dial.intervalMs) return buildNativeError("APP_BRIDGE_THROTTLED");
+	lastAllowedAt.set(method, now);
+}
+/**
+* `throttleErrorFor`의 throw 버전 — async mock 본문에서 한 줄로 쓴다.
+* async 함수 안에서 던지므로 호출자에게는 rejection으로 도달한다.
+*/
+function checkThrottle(method) {
+	const err = throttleErrorFor(method);
+	if (err) throw err;
+}
+//#endregion
 //#region src/mock/device/clipboard.ts
 /**
 * Clipboard mock
@@ -26818,6 +26781,7 @@ Object.assign(_fetchAlbumItemsWithPermission, { isSupported: () => true });
 */
 const _getClipboardText = async () => {
 	checkPermission("clipboard", "getClipboardText");
+	checkThrottle("getClipboardText");
 	if (aitState.state.deviceModes.clipboard === "mock") return aitState.state.mockData.clipboardText;
 	try {
 		return await navigator.clipboard.readText();
@@ -26828,6 +26792,7 @@ const _getClipboardText = async () => {
 withPermission(_getClipboardText, "clipboard");
 const _setClipboardText = async (text) => {
 	checkPermission("clipboard", "setClipboardText");
+	checkThrottle("setClipboardText");
 	if (aitState.state.deviceModes.clipboard === "mock") {
 		aitState.patch("mockData", { clipboardText: text });
 		return { text };
@@ -26979,6 +26944,7 @@ async function getCurrentLocationPrompt() {
 }
 const _getCurrentLocation = async (_options) => {
 	checkPermission("geolocation", "getCurrentLocation");
+	checkThrottle("getCurrentLocation");
 	const mode = aitState.state.deviceModes.location;
 	if (mode === "web") return getCurrentLocationWeb();
 	if (mode === "prompt") return getCurrentLocationPrompt();
@@ -27446,6 +27412,11 @@ const GoogleAdMob = createMockProxy("GoogleAdMob", {
 				args.onError(buildNativeError(failureCode));
 				return;
 			}
+			const throttleError = throttleErrorFor("loadAppsInTossAdMob");
+			if (throttleError) {
+				args.onError(throttleError);
+				return;
+			}
 			if (aitState.state.ads.forceNoFill) {
 				args.onError(/* @__PURE__ */ new Error("No fill"));
 				return;
@@ -27574,6 +27545,11 @@ const loadFullScreenAd = observe("loadFullScreenAd", "faithful", (args) => {
 			args.onError(buildNativeError(failureCode));
 			return;
 		}
+		const throttleError = throttleErrorFor("loadFullScreenAd");
+		if (throttleError) {
+			args.onError(throttleError);
+			return;
+		}
 		if (aitState.state.ads.forceNoFill) {
 			args.onError(/* @__PURE__ */ new Error("No fill"));
 			return;
@@ -30295,7 +30271,7 @@ function Panel() {
 								color: "#666",
 								fontWeight: 400
 							},
-							children: ["v", "0.1.144"]
+							children: ["v", "0.2.1"]
 						}),
 						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", {
 							type: "button",