@ait-co/devtools 0.2.0 → 0.2.2

package/dist/panel/index.js

@@ -25685,6 +25685,34 @@ function useT() {
 	return t;
 }
 //#endregion
+//#region src/mock/throttle-registry.ts
+/**
+* throttle 레지스트리 (devtools#834).
+*
+* 메서드별 마지막 *허용* 호출 시각만 담는 leaf 모듈이다. `state.ts`가 `reset()`에서
+* 이걸 비워야 하는데, 로직 본체(`throttle.ts`)는 거꾸로 `state.ts`를 읽는다 —
+* 그래서 **의존이 없는 이 파일로 레지스트리를 분리해** 순환 import를 피한다.
+*
+* `state.ts`의 `AitStateManager`와 같은 이유로 `globalThis` 싱글턴이어야 한다 (#836):
+* `tsdown.config.ts`가 mock/panel/unplugin entry를 각각 self-contained로 빌드하므로,
+* 소비자가 두 entry를 동시에 import하면 이 모듈이 entry당 하나씩 복제된다. Map을
+* 모듈 지역 변수로 두면 `aitState.reset()`이 비우는 Map(싱글턴을 먼저 생성한 번들의 것)과
+* `throttleErrorFor`가 읽는 Map(mock 번들의 것)이 갈려, 리셋 직후 첫 호출이 낡은
+* 타임스탬프 때문에 거부된다 — 이 파일이 막으려던 바로 그 증상이다.
+*/
+const SINGLETON_KEY$1 = "__aitDevtoolsThrottleRegistry__";
+const globalRef$1 = globalThis;
+if (!globalRef$1[SINGLETON_KEY$1]) globalRef$1[SINGLETON_KEY$1] = /* @__PURE__ */ new Map();
+/** 메서드별 마지막 *허용* 호출 시각(ms). 페이지 안의 모든 entry가 공유한다. */
+const lastAllowedAt = globalRef$1[SINGLETON_KEY$1];
+/**
+* throttle 레지스트리를 비운다. `aitState.reset()`이 호출한다 — 상태를 되돌렸는데
+* 직전 세션의 호출 시각이 남아 있으면 첫 호출이 이유 없이 거부된다.
+*/
+function resetThrottleRegistry() {
+	lastAllowedAt.clear();
+}
+//#endregion
 //#region src/mock/state.ts
 /** SDK 호출 로그 ring buffer 상한 */
 const SDK_CALL_LOG_MAX = 200;
@@ -25914,6 +25942,7 @@ var AitStateManager = class {
 			...structuredClone(DEFAULT_STATE),
 			deviceId
 		};
+		resetThrottleRegistry();
 		this._notify();
 	}
 	_notify() {
@@ -26331,7 +26360,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 인터셉터(빌드에
@@ -26709,6 +26740,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
@@ -26716,6 +26791,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();
@@ -26726,6 +26802,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 };
@@ -26877,6 +26954,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();
@@ -27344,6 +27422,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;
@@ -27472,6 +27555,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;
@@ -30193,7 +30281,7 @@ function Panel() {
 								color: "#666",
 								fontWeight: 400
 							},
-							children: ["v", "0.2.0"]
+							children: ["v", "0.2.2"]
 						}),
 						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", {
 							type: "button",