@ait-co/devtools 0.1.32 → 0.1.34

package/dist/mock/index.js

@@ -1,23 +1,6 @@
-//#region src/mock/proxy.ts
-/**
-* 미구현 API용 Proxy 트립와이어.
-*
-* 미구현 프로퍼티에 접근하면 throw한다. 이는 "devtools에서는 멀쩡히 돌지만
-* 실 SDK에선 실제로 동작하는" 시나리오를 차단하기 위한 의도적 선택이다.
-* mock이 미구현인 API는 실 SDK에서는 존재할 수 있고, 사용자가 이를 인지하지
-* 못한 채 개발을 이어가면 배포 시점에 놀라게 된다. 에러 메시지에 이슈 URL을
-* 포함해 사용자가 mock 누락을 제보할 수 있게 한다.
-*/
-const ISSUES_URL = "https://github.com/apps-in-toss-community/devtools/issues";
-function createMockProxy(moduleName, implementations) {
-	return new Proxy(implementations, { get(target, prop) {
-		if (typeof prop === "symbol") return void 0;
-		if (prop in target) return target[prop];
-		throw new Error(`[@ait-co/devtools] ${moduleName}.${prop} is not mocked. This API may exist in @apps-in-toss/web-framework, but devtools' mock does not cover it yet. Please file an issue: ${ISSUES_URL}`);
-	} });
-}
-//#endregion
 //#region src/mock/state.ts
+/** SDK 호출 로그 ring buffer 상한 */
+const SDK_CALL_LOG_MAX = 200;
 const DEFAULT_STATE = {
 	platform: "ios",
 	environment: "sandbox",
@@ -95,7 +78,9 @@ const DEFAULT_STATE = {
 		isLoaded: false,
 		nextEvent: "loaded",
 		forceNoFill: false,
-		lastEvent: null
+		lastEvent: null,
+		rewardUnitType: "coins",
+		rewardAmount: 10
 	},
 	game: {
 		profile: {
@@ -105,6 +90,7 @@ const DEFAULT_STATE = {
 		leaderboardScores: []
 	},
 	analyticsLog: [],
+	sdkCallLog: [],
 	deviceModes: {
 		camera: "mock",
 		photos: "mock",
@@ -217,6 +203,19 @@ var AitStateManager = class {
 		};
 		this._notify();
 	}
+	/**
+	* SDK 호출 로그 추가 (ring buffer, 상한 SDK_CALL_LOG_MAX).
+	* `observe()`가 호출하고, proxy의 KNOWN_UNIMPLEMENTED 경로도 직접 호출한다.
+	*/
+	logSdkCall(entry) {
+		const log = this._state.sdkCallLog;
+		const next = log.length >= SDK_CALL_LOG_MAX ? log.slice(1 - SDK_CALL_LOG_MAX) : log;
+		this._state = {
+			...this._state,
+			sdkCallLog: [...next, entry]
+		};
+		this._notify();
+	}
 	/** 이벤트 트리거 (backEvent, homeEvent 등) */
 	trigger(event) {
 		window.dispatchEvent(new CustomEvent(`__ait:${event}`));
@@ -240,16 +239,142 @@ if (!globalRef[SINGLETON_KEY]) globalRef[SINGLETON_KEY] = new AitStateManager();
 const aitState = globalRef[SINGLETON_KEY];
 if (typeof window !== "undefined") window.__ait = aitState;
 //#endregion
+//#region src/mock/observe.ts
+/**
+* fn을 observe로 감싼다.
+*
+* @param apiName  - 로그에 기록할 SDK 메서드 이름 (예: `'setScreenAwakeMode'`)
+* @param fidelity - 이 mock의 fidelity grade ('faithful' | 'partial' | 'inert')
+* @param fn       - 실제 mock 구현체. 시그니처를 그대로 통과시킨다.
+* @returns fn과 동일한 타입의 래퍼 함수
+*/
+function observe(apiName, fidelity, fn) {
+	return (...args) => {
+		const timestamp = Date.now();
+		const safeArgs = args.map((a) => safeSerialize(a));
+		const result = fn(...args);
+		if (result instanceof Promise) {
+			aitState.logSdkCall({
+				method: apiName,
+				args: safeArgs,
+				timestamp,
+				status: "pending",
+				fidelity
+			});
+			result.then((value) => {
+				aitState.logSdkCall({
+					method: apiName,
+					args: safeArgs,
+					timestamp,
+					status: "resolved",
+					result: safeSerialize(value),
+					fidelity
+				});
+			}, (err) => {
+				aitState.logSdkCall({
+					method: apiName,
+					args: safeArgs,
+					timestamp,
+					status: "rejected",
+					error: err instanceof Error ? err.message : String(err),
+					fidelity
+				});
+			});
+			return result;
+		}
+		aitState.logSdkCall({
+			method: apiName,
+			args: safeArgs,
+			timestamp,
+			status: "resolved",
+			result: safeSerialize(result),
+			fidelity
+		});
+		return result;
+	};
+}
+/**
+* 값을 JSON-safe한 형태로 변환한다.
+* - null / primitive — 그대로.
+* - 함수 — `'[Function: name]'` 문자열.
+* - 기타 객체 — JSON.stringify 실패 시 `'[unserializable]'`.
+*/
+function safeSerialize(value) {
+	if (value === null || value === void 0) return value;
+	if (typeof value === "function") return `[Function: ${value.name || "anonymous"}]`;
+	if (typeof value !== "object") return value;
+	try {
+		return JSON.parse(JSON.stringify(value));
+	} catch {
+		return "[unserializable]";
+	}
+}
+//#endregion
+//#region src/mock/proxy.ts
+/**
+* 미구현 API용 Proxy 트립와이어.
+*
+* 미구현 프로퍼티에 접근하면 throw한다. 이는 "devtools에서는 멀쩡히 돌지만
+* 실 SDK에선 실제로 동작하는" 시나리오를 차단하기 위한 의도적 선택이다.
+* mock이 미구현인 API는 실 SDK에서는 존재할 수 있고, 사용자가 이를 인지하지
+* 못한 채 개발을 이어가면 배포 시점에 놀라게 된다. 에러 메시지에 이슈 URL을
+* 포함해 사용자가 mock 누락을 제보할 수 있게 한다.
+*
+* ## KNOWN_UNIMPLEMENTED 정책
+* SDK에 존재하는 것으로 알려져 있으나 현재 mock이 없는 API 이름만 이 집합에 둔다.
+* 이 경우에만 throw 대신 🔴 inert no-op을 반환하고 sdkCallLog에 기록한다.
+* 완전히 미지의 이름은 여전히 throw — "잘 되는 척" 방지.
+*/
+const ISSUES_URL = "https://github.com/apps-in-toss-community/devtools/issues";
+/**
+* SDK에 존재하나 mock이 아직 없는 것으로 확인된 이름 목록.
+* 새 API가 SDK에 추가되면 여기에 추가하고 별도 PR에서 mock 구현으로 이동한다.
+* 확인되지 않은 이름은 절대 여기에 추가하지 않는다 — throw가 더 안전하다.
+*/
+const KNOWN_UNIMPLEMENTED = /* @__PURE__ */ new Set([]);
+function createMockProxy(moduleName, implementations) {
+	return new Proxy(implementations, { get(target, prop) {
+		if (typeof prop === "symbol") return void 0;
+		if (prop in target) return target[prop];
+		const name = String(prop);
+		if (KNOWN_UNIMPLEMENTED.has(name)) return (...args) => {
+			console.warn(`[@ait-co/devtools] ${moduleName}.${name} is known-unimplemented (🔴 inert). Returning undefined. Please file or upvote an issue: ${ISSUES_URL}`);
+			aitState.logSdkCall({
+				method: `${moduleName}.${name}`,
+				args,
+				timestamp: Date.now(),
+				status: "resolved",
+				result: void 0,
+				fidelity: "inert"
+			});
+		};
+		throw new Error(`[@ait-co/devtools] ${moduleName}.${prop} is not mocked. This API may exist in @apps-in-toss/web-framework, but devtools' mock does not cover it yet. Please file an issue: ${ISSUES_URL}`);
+	} });
+}
+//#endregion
 //#region src/mock/ads/index.ts
 /**
 * 광고 mock (GoogleAdMob, TossAds, FullScreenAd)
+*
+* 변경 이력 (#196):
+* - slot 레지스트리로 TossAds destroy/destroyAll 누수 수정 (🟡→🟢)
+* - attachBanner BannerSlotCallbacks 발화 (onAdRendered/onAdImpression/onNoFill 등)
+* - initialize onInitialized/onInitializationFailed 발화
+* - AdMob reward 파라미터화 (state.ads.rewardUnitType/rewardAmount)
+* - 모든 호출 observe()로 sdkCallLog에 기록
 */
 function withIsSupported(fn) {
 	fn.isSupported = () => true;
 	return fn;
 }
+const _slotRegistry = /* @__PURE__ */ new Map();
+let _slotCounter = 0;
+function _nextSlotId(adGroupId) {
+	_slotCounter += 1;
+	return `mock-slot-${adGroupId}-${_slotCounter}`;
+}
 const GoogleAdMob = createMockProxy("GoogleAdMob", {
-	loadAppsInTossAdMob: withIsSupported((args) => {
+	loadAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.loadAppsInTossAdMob", "faithful", (args) => {
 		setTimeout(() => {
 			if (aitState.state.ads.forceNoFill) {
 				args.onError(/* @__PURE__ */ new Error("No fill"));
@@ -262,8 +387,8 @@ const GoogleAdMob = createMockProxy("GoogleAdMob", {
 			});
 		}, 200);
 		return () => {};
-	}),
-	showAppsInTossAdMob: withIsSupported((args) => {
+	})),
+	showAppsInTossAdMob: withIsSupported(observe("GoogleAdMob.showAppsInTossAdMob", "faithful", (args) => {
 		if (!aitState.state.ads.isLoaded) {
 			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
 			return () => {};
@@ -272,11 +397,12 @@ const GoogleAdMob = createMockProxy("GoogleAdMob", {
 		setTimeout(() => args.onEvent({ type: "show" }), 100);
 		setTimeout(() => args.onEvent({ type: "impression" }), 150);
 		setTimeout(() => {
+			const { rewardUnitType, rewardAmount } = aitState.state.ads;
 			args.onEvent({
 				type: "userEarnedReward",
 				data: {
-					unitType: "coins",
-					unitAmount: 10
+					unitType: rewardUnitType,
+					unitAmount: rewardAmount
 				}
 			});
 		}, 1e3);
@@ -285,14 +411,18 @@ const GoogleAdMob = createMockProxy("GoogleAdMob", {
 			aitState.patch("ads", { isLoaded: false });
 		}, 1500);
 		return () => {};
-	}),
-	isAppsInTossAdMobLoaded: withIsSupported(async (_options) => aitState.state.ads.isLoaded)
+	})),
+	isAppsInTossAdMobLoaded: withIsSupported(observe("GoogleAdMob.isAppsInTossAdMobLoaded", "faithful", async (_options) => aitState.state.ads.isLoaded))
 });
 const TossAds = createMockProxy("TossAds", {
-	initialize: withIsSupported((_options) => {
-		console.log("[@ait-co/devtools] TossAds.initialize (mock)");
-	}),
-	attach: withIsSupported((_adGroupId, target, _options) => {
+	initialize: withIsSupported(observe("TossAds.initialize", "partial", (options) => {
+		if (aitState.state.ads.forceNoFill) {
+			options.callbacks?.onInitializationFailed?.(/* @__PURE__ */ new Error("No fill"));
+			return;
+		}
+		options.callbacks?.onInitialized?.();
+	})),
+	attach: withIsSupported(observe("TossAds.attach", "partial", (_adGroupId, target, _options) => {
 		const el = typeof target === "string" ? document.querySelector(target) : target;
 		if (el) {
 			const placeholder = document.createElement("div");
@@ -300,21 +430,76 @@ const TossAds = createMockProxy("TossAds", {
 			placeholder.textContent = "[@ait-co/devtools] TossAds Placeholder";
 			el.appendChild(placeholder);
 		}
-	}),
-	attachBanner: withIsSupported((_adGroupId, target, _options) => {
+	})),
+	attachBanner: withIsSupported(observe("TossAds.attachBanner", "faithful", (adGroupId, target, options) => {
 		const el = typeof target === "string" ? document.querySelector(target) : target;
+		const slotId = _nextSlotId(adGroupId);
+		const placeholder = document.createElement("div");
+		const theme = options?.theme ?? "auto";
+		const variant = options?.variant ?? "card";
+		const isDark = theme === "dark" || theme === "auto" && typeof window !== "undefined" && window.matchMedia?.("(prefers-color-scheme: dark)").matches;
+		const bg = isDark ? "#1a1a1a" : "#f0f0f0";
+		const textColor = isDark ? "#aaa" : "#666";
+		const borderColor = isDark ? "#555" : "#999";
+		const height = variant === "expanded" ? "120px" : "60px";
+		placeholder.dataset.aitSlotId = slotId;
+		placeholder.style.cssText = `background:${bg};border:1px dashed ${borderColor};padding:8px 12px;text-align:center;color:${textColor};font-size:12px;min-height:${height};display:flex;align-items:center;justify-content:center;`;
+		placeholder.textContent = `[@ait-co/devtools] Banner Ad (${variant})`;
 		if (el) {
-			const placeholder = document.createElement("div");
-			placeholder.style.cssText = "background:#f0f0f0;border:1px dashed #999;padding:12px;text-align:center;color:#666;font-size:12px;";
-			placeholder.textContent = "[@ait-co/devtools] Banner Ad Placeholder";
 			el.appendChild(placeholder);
+			_slotRegistry.set(slotId, placeholder);
 		}
-		return { destroy: () => {} };
-	}),
-	destroy: withIsSupported((_slotId) => {}),
-	destroyAll: withIsSupported(() => {})
+		const destroySlot = () => {
+			const registered = _slotRegistry.get(slotId);
+			if (registered) {
+				registered.remove();
+				_slotRegistry.delete(slotId);
+			}
+		};
+		setTimeout(() => {
+			if (aitState.state.ads.forceNoFill) {
+				options?.callbacks?.onNoFill?.({
+					slotId,
+					adGroupId,
+					adMetadata: {}
+				});
+				options?.callbacks?.onAdFailedToRender?.({
+					slotId,
+					adGroupId,
+					adMetadata: {},
+					error: {
+						code: 0,
+						message: "No fill"
+					}
+				});
+				return;
+			}
+			const eventPayload = {
+				slotId,
+				adGroupId,
+				adMetadata: {
+					creativeId: `mock-creative-${slotId}`,
+					requestId: `mock-req-${slotId}`
+				}
+			};
+			options?.callbacks?.onAdRendered?.(eventPayload);
+			options?.callbacks?.onAdImpression?.(eventPayload);
+		}, 100);
+		return { destroy: destroySlot };
+	})),
+	destroy: withIsSupported(observe("TossAds.destroy", "faithful", (slotId) => {
+		const el = _slotRegistry.get(slotId);
+		if (el) {
+			el.remove();
+			_slotRegistry.delete(slotId);
+		}
+	})),
+	destroyAll: withIsSupported(observe("TossAds.destroyAll", "faithful", () => {
+		for (const el of _slotRegistry.values()) el.remove();
+		_slotRegistry.clear();
+	}))
 });
-const loadFullScreenAd = withIsSupported((args) => {
+const loadFullScreenAd = withIsSupported(observe("loadFullScreenAd", "faithful", (args) => {
 	setTimeout(() => {
 		if (aitState.state.ads.forceNoFill) {
 			args.onError(/* @__PURE__ */ new Error("No fill"));
@@ -327,8 +512,8 @@ const loadFullScreenAd = withIsSupported((args) => {
 		});
 	}, 200);
 	return () => {};
-});
-const showFullScreenAd = withIsSupported((args) => {
+}));
+const showFullScreenAd = withIsSupported(observe("showFullScreenAd", "faithful", (args) => {
 	if (!aitState.state.ads.isLoaded) {
 		args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
 		return () => {};
@@ -336,7 +521,7 @@ const showFullScreenAd = withIsSupported((args) => {
 	setTimeout(() => args.onEvent({ type: "show" }), 100);
 	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
 	return () => {};
-});
+}));
 //#endregion
 //#region src/mock/analytics/index.ts
 /**
@@ -735,13 +920,70 @@ const fetchContacts = withPermission(_fetchContacts, "contacts");
 //#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.
+*   - sdkCallLog에 🟡(partial)로 기록. params: { hapticType, vibrated: boolean }.
+*   - 시그니처 불변 — __typecheck.ts의 Assert<Mock, Original> 통과.
+*/
+/**
+* HapticFeedbackType 10종 → navigator.vibrate 패턴 매핑.
+* 숫자: 진동 ms. 배열: [진동, 정지, 진동, …] 교대 패턴.
 */
+const HAPTIC_VIBRATE_PATTERN = {
+	tickWeak: 10,
+	tap: 20,
+	tickMedium: 30,
+	softMedium: 40,
+	basicWeak: 15,
+	basicMedium: 50,
+	success: [
+		10,
+		40,
+		10
+	],
+	error: [
+		40,
+		30,
+		40
+	],
+	wiggle: [
+		20,
+		20,
+		20,
+		20,
+		20
+	],
+	confetti: [
+		10,
+		20,
+		10,
+		20,
+		10,
+		20,
+		10
+	]
+};
 async function generateHapticFeedback(options) {
-	console.log(`[@ait-co/devtools] haptic: ${options.type}`);
+	const timestamp = Date.now();
 	aitState.logAnalytics({
 		type: "haptic",
 		params: { hapticType: options.type }
 	});
+	const pattern = HAPTIC_VIBRATE_PATTERN[options.type] ?? 30;
+	const vibrated = typeof navigator.vibrate === "function" ? navigator.vibrate(pattern) : false;
+	aitState.logSdkCall({
+		method: "generateHapticFeedback",
+		args: [{ type: options.type }],
+		timestamp,
+		status: "resolved",
+		result: {
+			hapticType: options.type,
+			vibrated
+		},
+		fidelity: "partial"
+	});
 }
 async function saveBase64Data(params) {
 	const a = document.createElement("a");
@@ -1122,17 +1364,17 @@ async function setDeviceOrientation(options) {
 	}
 	console.warn(`[@ait-co/devtools] setDeviceOrientation(${options.type}) ignored — Panel is forcing "${current}". Change the Viewport tab's orientation to "auto" to let the app control rotation.`);
 }
-async function setScreenAwakeMode(options) {
+const setScreenAwakeMode = observe("setScreenAwakeMode", "inert", async (options) => {
 	console.log("[@ait-co/devtools] setScreenAwakeMode:", options.enabled);
 	return { enabled: options.enabled };
-}
-async function setSecureScreen(options) {
+});
+const setSecureScreen = observe("setSecureScreen", "inert", async (options) => {
 	console.log("[@ait-co/devtools] setSecureScreen:", options.enabled);
 	return { enabled: options.enabled };
-}
-async function requestReview() {
+});
+const requestReview = observe("requestReview", "inert", async () => {
 	console.log("[@ait-co/devtools] requestReview called");
-}
+});
 requestReview.isSupported = () => true;
 function getPlatformOS() {
 	return aitState.state.platform;