@ait-co/devtools 0.1.136 → 0.1.138

package/dist/panel/index.js

@@ -25897,7 +25897,8 @@ const DEFAULT_STATE = {
 		frame: false,
 		aitNavBar: true,
 		aitNavBarType: "partner"
-	}
+	},
+	failureModes: { sdkLine: "2.x" }
 };
 function generateDeviceId() {
 	const stored = localStorage.getItem("__ait_device_id");
@@ -26409,6 +26410,104 @@ function waitForPromptResponse(type) {
 	});
 }
 //#endregion
+//#region src/mock/native-error.ts
+/**
+* 실패-모드 다이얼 — 네이티브 에러 envelope 조립 (devtools#770).
+*
+* env1(mock)이 env3(실기기)의 프로비저닝-의존 reject 계약을 재현할 수 있게 하는
+* 공용 헬퍼. `aitState.failureModes`(state.ts)에 per-API 코드를 설정하면, 각
+* mock 도메인(auth/ads 등)이 이 모듈의 {@link buildNativeError}로 실기기 캡처와
+* 필드 단위로 일치하는 에러 객체를 만들어 reject/onError한다.
+*
+* 코드 인벤토리와 envelope shape의 정본은 sdk-example#284 2.x↔3.0 diff
+* 매트릭스(2026-07-10 iOS run10 캡처 + 이후 manual 패스)다:
+*
+* - 2.x 라인: 네이티브 브리지가 `{ name, code, userInfo, moduleName, __isError }`
+*   envelope을 얹은 `Error` 인스턴스로 reject한다. `errorKeys` 관측이 이 5개
+*   필드로 고정.
+* - 3.x 라인: 같은 실패가 "맨 Error"(위 envelope 필드 없음)로 평탄화된다 —
+*   sdk-example#284 "패턴 ① 오류 envelope 평탄화" 표.
+*
+* `src/test-runner/bridge-stub.ts`의 `NativeBridgeErrorShape`/`makeNativeError`가
+* 같은 shape을 이미 CI 러너 쪽에서 재현하고 있다(devtools#740) — 이 모듈은 그
+* shape을 mock 소비자 표면(`src/mock/**`)에 대해 재사용 가능한 형태로 옮긴 것이다.
+* 두 모듈은 레이어가 다르다: test-runner 쪽은 env3 blocking-call 인터셉터(빌드에
+* 안 실림, CI 전용), 이쪽은 `@ait-co/devtools` 소비자가 `pnpm dev`에서 실제로
+* import하는 mock 런타임이다 — 서로 import하지 않는다(devtools#740이 test-runner
+* 전용 모듈임을 명시).
+*/
+/** 코드별 기본 message/moduleName — 실기기 캡처 관측값. */
+const CODE_META = {
+	APP_LOGIN: {
+		message: "Login failed",
+		moduleName: "RNTossLogin"
+	},
+	PLACEMENT_ID_FETCH_FAILED: {
+		message: "Failed to fetch placement id",
+		moduleName: "RNAdMob"
+	},
+	EXECUTION_ERROR: {
+		message: "Execution error",
+		moduleName: "RNFullScreenAd"
+	},
+	NO_PERMISSION: {
+		message: "No permission",
+		moduleName: "RNPermissions"
+	},
+	INVALID_REQUEST: {
+		message: "Invalid request",
+		moduleName: "RNPermissions"
+	},
+	INVALID_DATA: {
+		message: "Invalid data",
+		moduleName: "RNFileSystem"
+	},
+	FAILED_TO_GET_LOADED_AD: {
+		message: "Failed to get loaded ad",
+		moduleName: "RNAdMob"
+	},
+	APP_BRIDGE_THROTTLED: {
+		message: "Too many app bridge calls from this method.",
+		moduleName: "RNBridge"
+	},
+	"1006": {
+		message: "광고가 로드 중이거나 준비되지 않았습니다",
+		moduleName: "RNFullScreenAd"
+	},
+	"4000": {
+		message: "Notification agreement failed",
+		moduleName: "RNNotification"
+	}
+};
+/**
+* `aitState.failureModes.sdkLine`이 가리키는 라인으로 네이티브 실패를 조립한다.
+*
+* - `'2.x'`(기본): {@link NativeErrorEnvelope} 필드가 실린 `Error` — 실기기 2.x
+*   캡처(`{name, code, userInfo, moduleName, __isError}`)와 필드 단위 일치.
+* - `'3.x'`: 같은 실패가 "맨 Error"로 평탄화된 것을 재현 — envelope 필드 없이
+*   message만 실린 순수 `Error` 인스턴스.
+*
+* 호출부는 두 종류다:
+*
+* - **다이얼 게이트 뒤**(대부분): 프로비저닝처럼 환경에 따라 갈리는 실패는
+*   다이얼이 설정된 경우에만 재현한다 — 미설정 시 기존 동작 무변화
+*   (zero behavior change). 호출 전에 다이얼 값을 명시적으로 확인한다.
+* - **무조건**(입력 검증): 빈 `data`나 알 수 없는 haptic type처럼 환경과 무관하게
+*   실기기가 **항상** 거부하는 입력은 다이얼 없이 바로 던진다. 이건 "가끔 일어나는
+*   실패"의 시뮬레이션이 아니라 결정적 계약이므로 opt-in 대상이 아니다.
+*/
+function buildNativeError(code) {
+	const meta = CODE_META[code];
+	if (aitState.state.failureModes.sdkLine === "3.x") return new Error(meta.message);
+	const err = new Error(meta.message);
+	err.name = "Error";
+	err.code = code;
+	err.userInfo = {};
+	err.moduleName = meta.moduleName;
+	err.__isError = true;
+	return err;
+}
+//#endregion
 //#region src/mock/permissions.ts
 /**
 * web-framework 3.0+ 권한 에러 기반 클래스.
@@ -26466,9 +26565,42 @@ const permissionErrorMap = {
 	setClipboardText: SetClipboardTextPermissionError
 };
 async function getPermission(permission) {
+	const failureCode = permissionGateCode(permission);
+	if (failureCode) throw buildNativeError(failureCode);
 	return aitState.state.permissions[permission.name];
 }
+/**
+* 선언 게이트에 걸리는 이름·access 조합이면 다이얼에 등록된 native errorCode를
+* 돌려준다. 세 권한 API(`getPermission`/`requestPermission`/`openPermissionDialog`)가
+* **걸리는 조건**은 공유하지만 **떨어지는 코드**는 공유하지 않는다 — 아래 참조.
+*/
+function permissionGateCode(permission) {
+	if (permission.access === "access") return;
+	return aitState.state.failureModes.getPermission?.[permission.name];
+}
+/**
+* `openPermissionDialog`가 선언 게이트에 걸렸을 때의 코드.
+*
+* 형제 API와 갈린다 — env3 run11 실측(2.x/iOS, sdk-example#313에서 시나리오 키가
+* 통일되며 비교 대상에 들어온 값):
+*
+*   getPermission        { geolocation, read }   → rejected NO_PERMISSION
+*   requestPermission    { geolocation, read }   → rejected NO_PERMISSION
+*   openPermissionDialog { geolocation, read }   → rejected INVALID_REQUEST
+*   openPermissionDialog { camera, access }      → resolved
+*
+* 즉 **걸리는 조건은 셋이 같고(access 축 모델 그대로) 코드만 갈린다.** 처음엔
+* `requestPermission`이 `openPermissionDialog`에 위임하니 게이트도 위임하면
+* 된다고 보고 한 지점에만 배선했는데, 그 모델은 코드 층위에서 실측과 어긋났다
+* (env1 NO_PERMISSION ↔ env3 INVALID_REQUEST). 그래서 `requestPermission`은
+* 위임 **전에** 자기 게이트를 먼저 타고, 다이얼로그를 여는 호출만 이 코드를 쓴다.
+*
+* 관측이 geolocation/read 한 조합뿐이라 이름·access별 분기는 두지 않는다 —
+* 근거 없는 확장은 #783에서 이름 단위 맵을 택한 원칙에 어긋난다.
+*/
+const OPEN_DIALOG_GATE_CODE = "INVALID_REQUEST";
 async function openPermissionDialog(permission) {
+	if (permissionGateCode(permission)) throw buildNativeError(OPEN_DIALOG_GATE_CODE);
 	if (aitState.state.permissions[permission.name] === "allowed") return "allowed";
 	aitState.patch("permissions", { [permission.name]: "allowed" });
 	return "allowed";
@@ -26693,9 +26825,10 @@ const _setClipboardText = async (text) => {
 	checkPermission("clipboard", "setClipboardText");
 	if (aitState.state.deviceModes.clipboard === "mock") {
 		aitState.patch("mockData", { clipboardText: text });
-		return;
+		return { text };
 	}
 	await navigator.clipboard.writeText(text);
+	return { text };
 };
 withPermission(_setClipboardText, "clipboard");
 //#endregion
@@ -26722,19 +26855,6 @@ withPermission(_fetchContacts, "contacts");
 //#endregion
 //#region src/mock/device/haptic.ts
 /**
-* Haptic Feedback & saveBase64Data mock
-*
-* generateHapticFeedback — 영역 3 (하드웨어 API 관측):
-*   - 10종 HapticFeedbackType을 navigator.vibrate 패턴으로 매핑(근사, best-effort).
-*   - `typeof navigator.vibrate === 'function'` 가드 — API 없는 환경에서 throw 없이 skip.
-*   - @ait-co/polyfill 동시 사용 시 재귀 방지: polyfill이 navigator.vibrate를 override하고
-*     내부에서 mock의 generateHapticFeedback을 호출하므로 무한 재귀가 발생한다. polyfill이
-*     원본 vibrate를 BACKUP_KEY(Symbol.for('@ait-co/polyfill/vibrate.original'))에 저장하면
-*     그 원본을 직접 호출해 재귀를 끊는다.
-*   - sdkCallLog에 🟡(partial)로 기록. params: { hapticType, vibrated: boolean }.
-*   - 시그니처 불변 — __typecheck.ts의 Assert<Mock, Original> 통과.
-*/
-/**
 * HapticFeedbackType 10종 → navigator.vibrate 패턴 매핑.
 * 숫자: 진동 ms. 배열: [진동, 정지, 진동, …] 교대 패턴.
 */
@@ -26789,6 +26909,11 @@ function callVibrate(pattern) {
 	return typeof navigator.vibrate === "function" ? navigator.vibrate(pattern) : false;
 }
 async function generateHapticFeedback(options) {
+	if (!Object.hasOwn(HAPTIC_VIBRATE_PATTERN, options.type)) {
+		const err = /* @__PURE__ */ new Error(`[@ait-co/devtools] generateHapticFeedback: unknown haptic type "${options.type}"`);
+		err.errorCode = "EXECUTION_ERROR";
+		throw err;
+	}
 	const timestamp = Date.now();
 	aitState.logAnalytics({
 		type: "haptic",
@@ -26821,7 +26946,11 @@ function buildLocation() {
 	};
 }
 async function getCurrentLocationMock() {
-	return buildLocation();
+	const { coords, timestamp } = buildLocation();
+	return {
+		coords,
+		timestamp
+	};
 }
 async function getCurrentLocationWeb() {
 	return new Promise((resolve) => {
@@ -26840,8 +26969,7 @@ async function getCurrentLocationWeb() {
 					altitudeAccuracy: pos.coords.altitudeAccuracy ?? 0,
 					heading: pos.coords.heading ?? 0
 				},
-				timestamp: pos.timestamp,
-				accessLocation: "FINE"
+				timestamp: pos.timestamp
 			});
 		}, () => {
 			console.warn("[@ait-co/devtools] Geolocation failed, falling back to mock");
@@ -26850,7 +26978,11 @@ async function getCurrentLocationWeb() {
 	});
 }
 async function getCurrentLocationPrompt() {
-	return waitForPromptResponse("location");
+	const { coords, timestamp } = await waitForPromptResponse("location");
+	return {
+		coords,
+		timestamp
+	};
 }
 const _getCurrentLocation = async (_options) => {
 	checkPermission("geolocation", "getCurrentLocation");
@@ -26968,13 +27100,16 @@ createMockProxy("Storage", {
 	},
 	setItem: async (key, value) => {
 		localStorage.setItem(`__ait_storage:${key}`, value);
+		return null;
 	},
 	removeItem: async (key) => {
 		localStorage.removeItem(`__ait_storage:${key}`);
+		return null;
 	},
 	clearItems: async () => {
 		const keys = Object.keys(localStorage).filter((k) => k.startsWith("__ait_storage:"));
 		for (const k of keys) localStorage.removeItem(k);
+		return null;
 	}
 });
 //#endregion
@@ -27313,6 +27448,11 @@ function _nextSlotId(adGroupId) {
 const GoogleAdMob = createMockProxy("GoogleAdMob", {
 	loadAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.loadAppsInTossAdMob", "faithful", (args) => {
 		setTimeout(() => {
+			const failureCode = aitState.state.failureModes.loadAdMob;
+			if (failureCode) {
+				args.onError(buildNativeError(failureCode));
+				return;
+			}
 			if (aitState.state.ads.forceNoFill) {
 				args.onError(/* @__PURE__ */ new Error("No fill"));
 				return;
@@ -27344,7 +27484,14 @@ const GoogleAdMob = createMockProxy("GoogleAdMob", {
 		}, 1500);
 		return () => {};
 	})),
-	isAppsInTossAdMobLoaded: withIsSupported(observe("GoogleAdMob.isAppsInTossAdMobLoaded", "faithful", async (_options) => aitState.state.ads.isLoaded))
+	isAppsInTossAdMobLoaded: withIsSupported(observe("GoogleAdMob.isAppsInTossAdMobLoaded", "faithful", async (_options) => {
+		if (_options?.adGroupId !== void 0 && _options.adGroupId.trim() === "") {
+			const err = /* @__PURE__ */ new Error(`[@ait-co/devtools] GoogleAdMob.isAppsInTossAdMobLoaded: malformed adGroupId "${_options.adGroupId}"`);
+			err.errorCode = "INVALID_REQUEST";
+			throw err;
+		}
+		return aitState.state.ads.isLoaded;
+	}))
 });
 const TossAds = createMockProxy("TossAds", {
 	initialize: withIsSupported(observe("TossAds.initialize", "partial", (options) => {
@@ -27433,6 +27580,11 @@ const TossAds = createMockProxy("TossAds", {
 });
 const loadFullScreenAd = withIsSupported(observe("loadFullScreenAd", "faithful", (args) => {
 	setTimeout(() => {
+		const failureCode = aitState.state.failureModes.loadFullScreenAd;
+		if (failureCode) {
+			args.onError(buildNativeError(failureCode));
+			return;
+		}
 		if (aitState.state.ads.forceNoFill) {
 			args.onError(/* @__PURE__ */ new Error("No fill"));
 			return;
@@ -27764,12 +27916,15 @@ const IAP = createMockProxy("IAP", {
 		})) };
 	},
 	async getPendingOrders() {
-		return { orders: [...aitState.state.iap.pendingOrders] };
+		const orders = [...aitState.state.iap.pendingOrders];
+		return {
+			orders,
+			orderIds: orders.map((o) => o.orderId)
+		};
 	},
 	async getCompletedOrRefundedOrders() {
 		return {
 			hasNext: false,
-			nextKey: null,
 			orders: [...aitState.state.iap.completedOrders]
 		};
 	},
@@ -30146,7 +30301,7 @@ function Panel() {
 								color: "#666",
 								fontWeight: 400
 							},
-							children: ["v", "0.1.136"]
+							children: ["v", "0.1.138"]
 						}),
 						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", {
 							type: "button",