@apps-in-toss/devtools 3.2.0-beta.0 → 3.3.0

package/CHANGELOG.md

@@ -1,38 +1,15 @@
 # @apps-in-toss/devtools
 
-## 3.2.0-beta.0
+## 3.2.0
 
 ### Minor Changes
 
-- IAC 앱브릿지를 추가해요.
-
-### Patch Changes
-
-- 광고 노출 실패 이벤트에 `reason` 응답 타입을 추가해요.
-- Updated dependencies
-  - @apps-in-toss/web-framework@3.2.0-beta.0
+- 1622a0e: 로컬 저장소의 여러 값을 한 번에 조회하고 저장하는 `Storage.getItems`와 `Storage.setItems` API를 추가해요.
 
 ## 3.1.1
 
 ## 3.1.0
 
-## 3.1.0-beta.1
-
-### Patch Changes
-
-- d633263: failedToShow인 경우 reason 응답 타입 추가
-
-## 3.1.0-beta.0
-
-### Minor Changes
-
-- 59b4b13: iac 앱브릿지 추가
-
-### Patch Changes
-
-- Updated dependencies [59b4b13]
-  - @apps-in-toss/web-framework@3.1.0-beta.0
-
 ## 3.0.5
 
 ## 3.0.4

package/dist/mock/2x.d.ts

@@ -131,39 +131,6 @@ declare const showFullScreenAd: ((args: {
 }) => () => void) & {
   isSupported: () => boolean;
 };
-declare const Ads: {
-  showTossAdOrShoppingAds: ((args: {
-    options: {
-      spaceUnitId: string;
-      adSpaceId: string;
-    };
-    onEvent: (event: {
-      type: string;
-      data?: {
-        unitType: string;
-        unitAmount: number;
-      };
-    }) => void;
-    onError: (error: unknown) => void;
-  }) => () => void) & {
-    isSupported: () => boolean;
-  };
-  showTossShoppingAds: ((args: {
-    options: {
-      adSpaceId: string;
-    };
-    onEvent: (event: {
-      type: string;
-      data?: {
-        unitType: string;
-        unitAmount: number;
-      };
-    }) => void;
-    onError: (error: unknown) => void;
-  }) => () => void) & {
-    isSupported: () => boolean;
-  };
-};
 //#endregion
 //#region src/mock/analytics/index.d.ts
 /**
@@ -512,16 +479,6 @@ declare const openPDFViewer: ((params: OpenPDFViewerParams) => Promise<OpenPDFVi
 };
 //#endregion
 //#region src/mock/device/storage.d.ts
-/**
- * Storage mock
- * localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
- *
- * 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
- * `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
- * 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
- * `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
- * `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
- */
 declare const Storage: {
   getItem: (key: string) => Promise<string | null>;
   setItem: (key: string, value: string) => Promise<void>;
@@ -647,6 +604,39 @@ declare const requestTossPayPaysBilling: ((options: {
   isSupported: () => true;
 };
 //#endregion
+//#region src/mock/viral/index.d.ts
+/** 바이럴 캠페인 조회 mock이에요. */
+declare function getViralCampaign(params: {
+  campaignId: string;
+}): Promise<{
+  campaignId: string;
+  benefitName: string;
+  display: {
+    title: string | null;
+    benefitText: string | null;
+    conditionText: string | null;
+    ctaText: string | null;
+  };
+  active: boolean;
+  campaignStatus: "WAITING" | "IN_PROGRESS" | "ENDED";
+  participationAvailable: boolean;
+  participationUnavailableReason: "INACTIVE" | "NOT_STARTED" | "ENDED" | "ALL_RULES_ACHIEVED" | null;
+  rules: Array<{
+    ruleId: string;
+    ruleKey: string;
+    revision: number;
+    title: string;
+    currentValue: number;
+    targetValue: number;
+    status: "IN_PROGRESS" | "ACHIEVED" | "EXPIRED";
+    achievedAt: string | null;
+  }>;
+}>;
+/** 바이럴 캠페인 공유 mock이에요. */
+declare function shareViralCampaign(params: {
+  campaignId: string;
+}): Promise<void>;
+//#endregion
 //#region src/mock/navigation/index.d.ts
 declare function closeView(): Promise<void>;
 declare function openURL(url: string): Promise<void>;
@@ -1186,4 +1176,4 @@ declare function listUserPresets(): MockPreset[];
 declare function saveUserPreset(label: string, state: MockPresetState, description?: string): MockPreset;
 declare function deleteUserPreset(id: string): void;
 //#endregion
-export { Accuracy, Ads, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, type DeviceApiMode, type DeviceModes, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, type NetworkStatus, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, SetClipboardTextPermissionError, StartUpdateLocationPermissionError, Storage, TossAds, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, type DeviceApiMode, type DeviceModes, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, type NetworkStatus, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, SetClipboardTextPermissionError, StartUpdateLocationPermissionError, Storage, TossAds, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, getViralCampaign, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareViralCampaign, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };

package/dist/mock/2x.js

@@ -768,39 +768,6 @@ const showFullScreenAd = withIsSupported(observe("showFullScreenAd", "faithful",
 	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
 	return () => {};
 }));
-const Ads = createMockProxy("Ads", {
-	showTossAdOrShoppingAds: withIsSupported(observe("Ads.showTossAdOrShoppingAds", "faithful", (args) => {
-		if (!aitState.state.ads.isLoaded) {
-			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
-			return () => {};
-		}
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => {
-			args.onEvent({ type: "dismissed" });
-			aitState.patch("ads", { isLoaded: false });
-		}, 1500);
-		return () => {};
-	})),
-	showTossShoppingAds: withIsSupported(observe("Ads.showTossShoppingAds", "faithful", (args) => {
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
-		return () => {};
-	}))
-});
 //#endregion
 //#region src/mock/analytics/index.ts
 /**
@@ -1611,20 +1578,21 @@ const openPDFViewer = Object.assign(_openPDFViewerImpl, { isSupported: () => tru
 * `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
 * `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
 */
+const STORAGE_PREFIX = "__ait_storage:";
 const Storage = createMockProxy("Storage", {
 	getItem: async (key) => {
-		return localStorage.getItem(`__ait_storage:${key}`);
+		return localStorage.getItem(`${STORAGE_PREFIX}${key}`);
 	},
 	setItem: async (key, value) => {
-		localStorage.setItem(`__ait_storage:${key}`, value);
+		localStorage.setItem(`${STORAGE_PREFIX}${key}`, value);
 		return null;
 	},
 	removeItem: async (key) => {
-		localStorage.removeItem(`__ait_storage:${key}`);
+		localStorage.removeItem(`${STORAGE_PREFIX}${key}`);
 		return null;
 	},
 	clearItems: async () => {
-		const keys = Object.keys(localStorage).filter((k) => k.startsWith("__ait_storage:"));
+		const keys = Object.keys(localStorage).filter((k) => k.startsWith(STORAGE_PREFIX));
 		for (const k of keys) localStorage.removeItem(k);
 		return null;
 	}
@@ -1964,6 +1932,40 @@ function getSafeAreaInsets() {
 	return Promise.resolve({ ...aitState.state.safeAreaInsets });
 }
 //#endregion
+//#region src/mock/viral/index.ts
+/** 바이럴 캠페인 조회 mock이에요. */
+async function getViralCampaign(params) {
+	console.log("[@apps-in-toss/devtools] getViralCampaign:", params.campaignId);
+	return {
+		campaignId: params.campaignId,
+		benefitName: "mock-benefit",
+		display: {
+			title: "바이럴 캠페인 제목",
+			benefitText: "친구를 초대하면 리워드를 받아요",
+			conditionText: "3명 초대 시 달성",
+			ctaText: "공유하기"
+		},
+		active: true,
+		campaignStatus: "IN_PROGRESS",
+		participationAvailable: true,
+		participationUnavailableReason: null,
+		rules: [{
+			ruleId: "rule-1",
+			ruleKey: "invite",
+			revision: 1,
+			title: "친구 3명 초대",
+			currentValue: 1,
+			targetValue: 3,
+			status: "IN_PROGRESS",
+			achievedAt: null
+		}]
+	};
+}
+/** 바이럴 캠페인 공유 mock이에요. */
+async function shareViralCampaign(params) {
+	console.log("[@apps-in-toss/devtools] shareViralCampaign:", params.campaignId);
+}
+//#endregion
 //#region src/mock/bridge-factories.ts
 /** Generic bridge escape hatches exposed by both SDK lines. */
 const asyncBridgeRegistry = {
@@ -1977,11 +1979,13 @@ const asyncBridgeRegistry = {
 	getDeclaredAgeRange,
 	getNetworkStatus,
 	getServerTime,
+	getViralCampaign,
 	openPDFViewer,
 	openURL,
 	requestReview,
 	saveBase64Data,
-	share
+	share,
+	shareViralCampaign
 };
 function createAsyncBridge(method) {
 	return async (...args) => {
@@ -2419,4 +2423,4 @@ function captureCurrentState(snapshot) {
 	};
 }
 //#endregion
-export { Accuracy, Ads, Analytics, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, OpenCameraPermissionError, PermissionError, SafeAreaInsets, SetClipboardTextPermissionError, StartUpdateLocationPermissionError, Storage, TossAds, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, Analytics, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, OpenCameraPermissionError, PermissionError, SafeAreaInsets, SetClipboardTextPermissionError, StartUpdateLocationPermissionError, Storage, TossAds, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, getViralCampaign, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareViralCampaign, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };

package/dist/mock/3x.d.ts

@@ -156,7 +156,6 @@ declare const isMinVersionSupported: typeof SDK.isMinVersionSupported;
 declare const GoogleAdMob: typeof SDK.GoogleAdMob;
 declare const loadFullScreenAd: typeof SDK.loadFullScreenAd;
 declare const showFullScreenAd: typeof SDK.showFullScreenAd;
-declare const Ads: typeof SDK.Ads;
 declare const IAP: typeof SDK.IAP;
 declare const Analytics: typeof SDK.Analytics;
 declare const Clipboard: typeof SDK.Clipboard;
@@ -194,9 +193,11 @@ declare const Review: typeof SDK.Review;
 declare const SafeArea: typeof SDK.SafeArea;
 declare const Screen: typeof SDK.Screen;
 declare const Share: typeof SDK.Share;
+declare const Storage: typeof SDK.Storage;
 declare const TossAuth: typeof SDK.TossAuth;
 declare const TossPay: typeof SDK.TossPay;
 declare const User: typeof SDK.User;
+declare const Viral: typeof SDK.Viral;
 //#endregion
 //#region src/mock/ads/index.d.ts
 declare const TossAds: {
@@ -557,24 +558,6 @@ declare const startUpdateLocation: ((eventParams: StartUpdateLocationEventParams
   openPermissionDialog: () => Promise<"allowed" | "denied">;
 };
 //#endregion
-//#region src/mock/device/storage.d.ts
-/**
- * Storage mock
- * localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
- *
- * 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
- * `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
- * 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
- * `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
- * `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
- */
-declare const Storage: {
-  getItem: (key: string) => Promise<string | null>;
-  setItem: (key: string, value: string) => Promise<void>;
-  removeItem: (key: string) => Promise<void>;
-  clearItems: () => Promise<void>;
-};
-//#endregion
 //#region src/mock/iap/index.d.ts
 declare function checkoutPayment(options: {
   params: {
@@ -585,6 +568,39 @@ declare function checkoutPayment(options: {
   reason?: string;
 }>;
 //#endregion
+//#region src/mock/viral/index.d.ts
+/** 바이럴 캠페인 조회 mock이에요. */
+declare function getViralCampaign(params: {
+  campaignId: string;
+}): Promise<{
+  campaignId: string;
+  benefitName: string;
+  display: {
+    title: string | null;
+    benefitText: string | null;
+    conditionText: string | null;
+    ctaText: string | null;
+  };
+  active: boolean;
+  campaignStatus: "WAITING" | "IN_PROGRESS" | "ENDED";
+  participationAvailable: boolean;
+  participationUnavailableReason: "INACTIVE" | "NOT_STARTED" | "ENDED" | "ALL_RULES_ACHIEVED" | null;
+  rules: Array<{
+    ruleId: string;
+    ruleKey: string;
+    revision: number;
+    title: string;
+    currentValue: number;
+    targetValue: number;
+    status: "IN_PROGRESS" | "ACHIEVED" | "EXPIRED";
+    achievedAt: string | null;
+  }>;
+}>;
+/** 바이럴 캠페인 공유 mock이에요. */
+declare function shareViralCampaign(params: {
+  campaignId: string;
+}): Promise<void>;
+//#endregion
 //#region src/mock/navigation/index.d.ts
 declare function closeView(): Promise<void>;
 declare function openURL(url: string): Promise<void>;
@@ -1051,4 +1067,4 @@ declare function listUserPresets(): MockPreset[];
 declare function saveUserPreset(label: string, state: MockPresetState, description?: string): MockPreset;
 declare function deleteUserPreset(id: string): void;
 //#endregion
-export { Accuracy, Ads, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, Clipboard, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, Device, type DeviceApiMode, type DeviceModes, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, Migration, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, type NetworkStatus, Notification, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, Promotion, Review, SafeArea, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, Clipboard, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, Device, type DeviceApiMode, type DeviceModes, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, Migration, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, type NetworkStatus, Notification, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, Promotion, Review, SafeArea, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, Viral, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, getViralCampaign, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareViralCampaign, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };

package/dist/mock/3x.js

@@ -328,6 +328,86 @@ 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/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(`[@apps-in-toss/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(`[@apps-in-toss/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/device/storage.ts
+/**
+* Storage mock
+* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
+*
+* 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
+* `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
+* 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
+* `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
+* `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
+*/
+const STORAGE_PREFIX = "__ait_storage:";
+async function getItems(keys) {
+	return Object.fromEntries(keys.map((key) => [key, localStorage.getItem(`${STORAGE_PREFIX}${key}`)]));
+}
+async function setItems(items) {
+	for (const [key, value] of Object.entries(items)) localStorage.setItem(`${STORAGE_PREFIX}${key}`, value);
+	return null;
+}
+const Storage$1 = createMockProxy("Storage", {
+	getItem: async (key) => {
+		return localStorage.getItem(`${STORAGE_PREFIX}${key}`);
+	},
+	setItem: async (key, value) => {
+		localStorage.setItem(`${STORAGE_PREFIX}${key}`, value);
+		return null;
+	},
+	removeItem: async (key) => {
+		localStorage.removeItem(`${STORAGE_PREFIX}${key}`);
+		return null;
+	},
+	clearItems: async () => {
+		const keys = Object.keys(localStorage).filter((k) => k.startsWith(STORAGE_PREFIX));
+		for (const k of keys) localStorage.removeItem(k);
+		return null;
+	}
+});
+//#endregion
 //#region src/mock/native-error.ts
 /**
 * 실패-모드 다이얼 — 네이티브 에러 envelope 조립 (devtools#770).
@@ -499,48 +579,6 @@ function safeSerialize(value) {
 	}
 }
 //#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(`[@apps-in-toss/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(`[@apps-in-toss/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/throttle.ts
 /**
 * THROTTLED 시뮬레이션 (devtools#834 — #770 §3 분리).
@@ -768,39 +806,6 @@ const showFullScreenAd$1 = withIsSupported(observe("showFullScreenAd", "faithful
 	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
 	return () => {};
 }));
-const Ads$1 = createMockProxy("Ads", {
-	showTossAdOrShoppingAds: withIsSupported(observe("Ads.showTossAdOrShoppingAds", "faithful", (args) => {
-		if (!aitState.state.ads.isLoaded) {
-			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
-			return () => {};
-		}
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => {
-			args.onEvent({ type: "dismissed" });
-			aitState.patch("ads", { isLoaded: false });
-		}, 1500);
-		return () => {};
-	})),
-	showTossShoppingAds: withIsSupported(observe("Ads.showTossShoppingAds", "faithful", (args) => {
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
-		return () => {};
-	}))
-});
 //#endregion
 //#region src/mock/analytics/index.ts
 /**
@@ -1600,36 +1605,6 @@ const _openPDFViewerImpl = async (_params) => {
 };
 const openPDFViewer$1 = Object.assign(_openPDFViewerImpl, { isSupported: () => true });
 //#endregion
-//#region src/mock/device/storage.ts
-/**
-* Storage mock
-* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
-*
-* 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
-* `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
-* 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
-* `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
-* `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
-*/
-const Storage = createMockProxy("Storage", {
-	getItem: async (key) => {
-		return localStorage.getItem(`__ait_storage:${key}`);
-	},
-	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
 //#region src/mock/iap/index.ts
 let orderCounter = 0;
 function generateOrderId() {
@@ -1890,6 +1865,40 @@ const SafeAreaInsets = {
 	}
 };
 //#endregion
+//#region src/mock/viral/index.ts
+/** 바이럴 캠페인 조회 mock이에요. */
+async function getViralCampaign(params) {
+	console.log("[@apps-in-toss/devtools] getViralCampaign:", params.campaignId);
+	return {
+		campaignId: params.campaignId,
+		benefitName: "mock-benefit",
+		display: {
+			title: "바이럴 캠페인 제목",
+			benefitText: "친구를 초대하면 리워드를 받아요",
+			conditionText: "3명 초대 시 달성",
+			ctaText: "공유하기"
+		},
+		active: true,
+		campaignStatus: "IN_PROGRESS",
+		participationAvailable: true,
+		participationUnavailableReason: null,
+		rules: [{
+			ruleId: "rule-1",
+			ruleKey: "invite",
+			revision: 1,
+			title: "친구 3명 초대",
+			currentValue: 1,
+			targetValue: 3,
+			status: "IN_PROGRESS",
+			achievedAt: null
+		}]
+	};
+}
+/** 바이럴 캠페인 공유 mock이에요. */
+async function shareViralCampaign(params) {
+	console.log("[@apps-in-toss/devtools] shareViralCampaign:", params.campaignId);
+}
+//#endregion
 //#region src/mock/bridge-factories.ts
 /** Generic bridge escape hatches exposed by both SDK lines. */
 const asyncBridgeRegistry = {
@@ -1903,11 +1912,13 @@ const asyncBridgeRegistry = {
 	getDeclaredAgeRange: getDeclaredAgeRange$1,
 	getNetworkStatus,
 	getServerTime: getServerTime$1,
+	getViralCampaign,
 	openPDFViewer: openPDFViewer$1,
 	openURL,
 	requestReview: requestReview$1,
 	saveBase64Data: saveBase64Data$1,
-	share
+	share,
+	shareViralCampaign
 };
 function createAsyncBridge(method) {
 	return async (...args) => {
@@ -2427,6 +2438,10 @@ const V = {
 		android: "5.233.0",
 		ios: "5.233.0"
 	},
+	storageBatch: {
+		android: "5.270.0",
+		ios: "5.270.0"
+	},
 	tossLogin: {
 		android: "5.237.0",
 		ios: "5.237.0"
@@ -2505,14 +2520,6 @@ const showFullScreenAd = Object.assign((args) => showFullScreenAd$1({
 	options: args.options ?? { adGroupId: "mock-ad-group" },
 	onError: (error) => args.onError(error instanceof Error ? error : new Error(String(error)))
 }), { isSupported: () => true });
-const shoppingAdsMin = {
-	android: "5.273.0",
-	ios: "5.273.0"
-};
-const Ads = {
-	showTossAdOrShoppingAds: supported(Ads$1.showTossAdOrShoppingAds, shoppingAdsMin),
-	showTossShoppingAds: supported(Ads$1.showTossShoppingAds, shoppingAdsMin)
-};
 const IAP = {
 	createOneTimePurchaseOrder: supported(IAP$1.createOneTimePurchaseOrder, V.iapOneTime),
 	createSubscriptionPurchaseOrder: supported(IAP$1.createSubscriptionPurchaseOrder, V.iapSubscription),
@@ -2574,10 +2581,15 @@ const File = {
 	saveBase64: saveBase64Data,
 	openPDFViewer
 };
+const subscribeInfoOverlayHidden = ({ onEvent }) => {
+	const timeoutId = window.setTimeout(onEvent, 0);
+	return () => window.clearTimeout(timeoutId);
+};
 const Game = {
 	openLeaderboard: openGameCenterLeaderboard,
 	setLeaderboardScore: submitGameCenterLeaderBoardScore,
-	getUserProfile: getGameCenterGameProfile
+	getUserProfile: getGameCenterGameProfile,
+	subscribeInfoOverlayHidden
 };
 const Migration = { getOriginStorage: async () => {
 	const createEmptyDump = () => ({
@@ -2613,6 +2625,11 @@ const Share = {
 	createLink: ({ path, ogImageUrl }) => getTossShareLink(path, ogImageUrl),
 	sendMessage: share
 };
+const Storage = {
+	...Storage$1,
+	getItems: supported(getItems, V.storageBatch),
+	setItems: supported(setItems, V.storageBatch)
+};
 const TossAuth = {
 	login: appLogin,
 	isIntegrated: getIsTossLoginIntegratedService,
@@ -2633,5 +2650,9 @@ const User = {
 	getConsentedData: getConsentedUserData,
 	getDeclaredAgeRange
 };
+const Viral = {
+	getCampaign: getViralCampaign,
+	share: shareViralCampaign
+};
 //#endregion
-export { Accuracy, Ads, Analytics, Clipboard, Device, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, Migration, Notification, OpenCameraPermissionError, PermissionError, Promotion, Review, SafeArea, SafeAreaInsets, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, Analytics, Clipboard, Device, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, Migration, Notification, OpenCameraPermissionError, PermissionError, Promotion, Review, SafeArea, SafeAreaInsets, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, Viral, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, getViralCampaign, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareViralCampaign, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };

package/dist/mock/index.d.ts

@@ -156,7 +156,6 @@ declare const isMinVersionSupported: typeof SDK.isMinVersionSupported;
 declare const GoogleAdMob: typeof SDK.GoogleAdMob;
 declare const loadFullScreenAd: typeof SDK.loadFullScreenAd;
 declare const showFullScreenAd: typeof SDK.showFullScreenAd;
-declare const Ads: typeof SDK.Ads;
 declare const IAP: typeof SDK.IAP;
 declare const Analytics: typeof SDK.Analytics;
 declare const Clipboard: typeof SDK.Clipboard;
@@ -194,9 +193,11 @@ declare const Review: typeof SDK.Review;
 declare const SafeArea: typeof SDK.SafeArea;
 declare const Screen: typeof SDK.Screen;
 declare const Share: typeof SDK.Share;
+declare const Storage: typeof SDK.Storage;
 declare const TossAuth: typeof SDK.TossAuth;
 declare const TossPay: typeof SDK.TossPay;
 declare const User: typeof SDK.User;
+declare const Viral: typeof SDK.Viral;
 //#endregion
 //#region src/mock/ads/index.d.ts
 declare const TossAds: {
@@ -557,24 +558,6 @@ declare const startUpdateLocation: ((eventParams: StartUpdateLocationEventParams
   openPermissionDialog: () => Promise<"allowed" | "denied">;
 };
 //#endregion
-//#region src/mock/device/storage.d.ts
-/**
- * Storage mock
- * localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
- *
- * 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
- * `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
- * 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
- * `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
- * `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
- */
-declare const Storage: {
-  getItem: (key: string) => Promise<string | null>;
-  setItem: (key: string, value: string) => Promise<void>;
-  removeItem: (key: string) => Promise<void>;
-  clearItems: () => Promise<void>;
-};
-//#endregion
 //#region src/mock/iap/index.d.ts
 declare function checkoutPayment(options: {
   params: {
@@ -585,6 +568,39 @@ declare function checkoutPayment(options: {
   reason?: string;
 }>;
 //#endregion
+//#region src/mock/viral/index.d.ts
+/** 바이럴 캠페인 조회 mock이에요. */
+declare function getViralCampaign(params: {
+  campaignId: string;
+}): Promise<{
+  campaignId: string;
+  benefitName: string;
+  display: {
+    title: string | null;
+    benefitText: string | null;
+    conditionText: string | null;
+    ctaText: string | null;
+  };
+  active: boolean;
+  campaignStatus: "WAITING" | "IN_PROGRESS" | "ENDED";
+  participationAvailable: boolean;
+  participationUnavailableReason: "INACTIVE" | "NOT_STARTED" | "ENDED" | "ALL_RULES_ACHIEVED" | null;
+  rules: Array<{
+    ruleId: string;
+    ruleKey: string;
+    revision: number;
+    title: string;
+    currentValue: number;
+    targetValue: number;
+    status: "IN_PROGRESS" | "ACHIEVED" | "EXPIRED";
+    achievedAt: string | null;
+  }>;
+}>;
+/** 바이럴 캠페인 공유 mock이에요. */
+declare function shareViralCampaign(params: {
+  campaignId: string;
+}): Promise<void>;
+//#endregion
 //#region src/mock/navigation/index.d.ts
 declare function closeView(): Promise<void>;
 declare function openURL(url: string): Promise<void>;
@@ -1051,4 +1067,4 @@ declare function listUserPresets(): MockPreset[];
 declare function saveUserPreset(label: string, state: MockPresetState, description?: string): MockPreset;
 declare function deleteUserPreset(id: string): void;
 //#endregion
-export { Accuracy, Ads, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, Clipboard, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, Device, type DeviceApiMode, type DeviceModes, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, Migration, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, type NetworkStatus, Notification, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, Promotion, Review, SafeArea, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, type AitDevtoolsState, Analytics, type AnalyticsLogEntry, Clipboard, type ConsentedUserData, type ConsentedUserDataKey, type DeclaredAgeRange, Device, type DeviceApiMode, type DeviceModes, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, type HapticFeedbackType, IAP, type IapNextResult, type LocationCoords, Migration, type MockContact, type MockData, type MockIapProduct, type MockLocation, type MockPreset, type MockPresetState, type NetworkStatus, Notification, OpenCameraPermissionError, type OperationalEnvironment, PermissionError, type PermissionName, type PermissionStatus, type PlatformOS, type Primitive, Promotion, Review, SafeArea, SafeAreaInsets, type SafeAreaInsets$1 as SafeAreaInsetsType, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, Viral, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, getViralCampaign, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareViralCampaign, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };

package/dist/mock/index.js

@@ -328,6 +328,86 @@ 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/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(`[@apps-in-toss/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(`[@apps-in-toss/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/device/storage.ts
+/**
+* Storage mock
+* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
+*
+* 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
+* `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
+* 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
+* `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
+* `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
+*/
+const STORAGE_PREFIX = "__ait_storage:";
+async function getItems(keys) {
+	return Object.fromEntries(keys.map((key) => [key, localStorage.getItem(`${STORAGE_PREFIX}${key}`)]));
+}
+async function setItems(items) {
+	for (const [key, value] of Object.entries(items)) localStorage.setItem(`${STORAGE_PREFIX}${key}`, value);
+	return null;
+}
+const Storage$1 = createMockProxy("Storage", {
+	getItem: async (key) => {
+		return localStorage.getItem(`${STORAGE_PREFIX}${key}`);
+	},
+	setItem: async (key, value) => {
+		localStorage.setItem(`${STORAGE_PREFIX}${key}`, value);
+		return null;
+	},
+	removeItem: async (key) => {
+		localStorage.removeItem(`${STORAGE_PREFIX}${key}`);
+		return null;
+	},
+	clearItems: async () => {
+		const keys = Object.keys(localStorage).filter((k) => k.startsWith(STORAGE_PREFIX));
+		for (const k of keys) localStorage.removeItem(k);
+		return null;
+	}
+});
+//#endregion
 //#region src/mock/native-error.ts
 /**
 * 실패-모드 다이얼 — 네이티브 에러 envelope 조립 (devtools#770).
@@ -499,48 +579,6 @@ function safeSerialize(value) {
 	}
 }
 //#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(`[@apps-in-toss/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(`[@apps-in-toss/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/throttle.ts
 /**
 * THROTTLED 시뮬레이션 (devtools#834 — #770 §3 분리).
@@ -768,39 +806,6 @@ const showFullScreenAd$1 = withIsSupported(observe("showFullScreenAd", "faithful
 	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
 	return () => {};
 }));
-const Ads$1 = createMockProxy("Ads", {
-	showTossAdOrShoppingAds: withIsSupported(observe("Ads.showTossAdOrShoppingAds", "faithful", (args) => {
-		if (!aitState.state.ads.isLoaded) {
-			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
-			return () => {};
-		}
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => {
-			args.onEvent({ type: "dismissed" });
-			aitState.patch("ads", { isLoaded: false });
-		}, 1500);
-		return () => {};
-	})),
-	showTossShoppingAds: withIsSupported(observe("Ads.showTossShoppingAds", "faithful", (args) => {
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
-		return () => {};
-	}))
-});
 //#endregion
 //#region src/mock/analytics/index.ts
 /**
@@ -1600,36 +1605,6 @@ const _openPDFViewerImpl = async (_params) => {
 };
 const openPDFViewer$1 = Object.assign(_openPDFViewerImpl, { isSupported: () => true });
 //#endregion
-//#region src/mock/device/storage.ts
-/**
-* Storage mock
-* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
-*
-* 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
-* `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
-* 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
-* `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
-* `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
-*/
-const Storage = createMockProxy("Storage", {
-	getItem: async (key) => {
-		return localStorage.getItem(`__ait_storage:${key}`);
-	},
-	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
 //#region src/mock/iap/index.ts
 let orderCounter = 0;
 function generateOrderId() {
@@ -1890,6 +1865,40 @@ const SafeAreaInsets = {
 	}
 };
 //#endregion
+//#region src/mock/viral/index.ts
+/** 바이럴 캠페인 조회 mock이에요. */
+async function getViralCampaign(params) {
+	console.log("[@apps-in-toss/devtools] getViralCampaign:", params.campaignId);
+	return {
+		campaignId: params.campaignId,
+		benefitName: "mock-benefit",
+		display: {
+			title: "바이럴 캠페인 제목",
+			benefitText: "친구를 초대하면 리워드를 받아요",
+			conditionText: "3명 초대 시 달성",
+			ctaText: "공유하기"
+		},
+		active: true,
+		campaignStatus: "IN_PROGRESS",
+		participationAvailable: true,
+		participationUnavailableReason: null,
+		rules: [{
+			ruleId: "rule-1",
+			ruleKey: "invite",
+			revision: 1,
+			title: "친구 3명 초대",
+			currentValue: 1,
+			targetValue: 3,
+			status: "IN_PROGRESS",
+			achievedAt: null
+		}]
+	};
+}
+/** 바이럴 캠페인 공유 mock이에요. */
+async function shareViralCampaign(params) {
+	console.log("[@apps-in-toss/devtools] shareViralCampaign:", params.campaignId);
+}
+//#endregion
 //#region src/mock/bridge-factories.ts
 /** Generic bridge escape hatches exposed by both SDK lines. */
 const asyncBridgeRegistry = {
@@ -1903,11 +1912,13 @@ const asyncBridgeRegistry = {
 	getDeclaredAgeRange: getDeclaredAgeRange$1,
 	getNetworkStatus,
 	getServerTime: getServerTime$1,
+	getViralCampaign,
 	openPDFViewer: openPDFViewer$1,
 	openURL,
 	requestReview: requestReview$1,
 	saveBase64Data: saveBase64Data$1,
-	share
+	share,
+	shareViralCampaign
 };
 function createAsyncBridge(method) {
 	return async (...args) => {
@@ -2427,6 +2438,10 @@ const V = {
 		android: "5.233.0",
 		ios: "5.233.0"
 	},
+	storageBatch: {
+		android: "5.270.0",
+		ios: "5.270.0"
+	},
 	tossLogin: {
 		android: "5.237.0",
 		ios: "5.237.0"
@@ -2505,14 +2520,6 @@ const showFullScreenAd = Object.assign((args) => showFullScreenAd$1({
 	options: args.options ?? { adGroupId: "mock-ad-group" },
 	onError: (error) => args.onError(error instanceof Error ? error : new Error(String(error)))
 }), { isSupported: () => true });
-const shoppingAdsMin = {
-	android: "5.273.0",
-	ios: "5.273.0"
-};
-const Ads = {
-	showTossAdOrShoppingAds: supported(Ads$1.showTossAdOrShoppingAds, shoppingAdsMin),
-	showTossShoppingAds: supported(Ads$1.showTossShoppingAds, shoppingAdsMin)
-};
 const IAP = {
 	createOneTimePurchaseOrder: supported(IAP$1.createOneTimePurchaseOrder, V.iapOneTime),
 	createSubscriptionPurchaseOrder: supported(IAP$1.createSubscriptionPurchaseOrder, V.iapSubscription),
@@ -2574,10 +2581,15 @@ const File = {
 	saveBase64: saveBase64Data,
 	openPDFViewer
 };
+const subscribeInfoOverlayHidden = ({ onEvent }) => {
+	const timeoutId = window.setTimeout(onEvent, 0);
+	return () => window.clearTimeout(timeoutId);
+};
 const Game = {
 	openLeaderboard: openGameCenterLeaderboard,
 	setLeaderboardScore: submitGameCenterLeaderBoardScore,
-	getUserProfile: getGameCenterGameProfile
+	getUserProfile: getGameCenterGameProfile,
+	subscribeInfoOverlayHidden
 };
 const Migration = { getOriginStorage: async () => {
 	const createEmptyDump = () => ({
@@ -2613,6 +2625,11 @@ const Share = {
 	createLink: ({ path, ogImageUrl }) => getTossShareLink(path, ogImageUrl),
 	sendMessage: share
 };
+const Storage = {
+	...Storage$1,
+	getItems: supported(getItems, V.storageBatch),
+	setItems: supported(setItems, V.storageBatch)
+};
 const TossAuth = {
 	login: appLogin,
 	isIntegrated: getIsTossLoginIntegratedService,
@@ -2633,5 +2650,9 @@ const User = {
 	getConsentedData: getConsentedUserData,
 	getDeclaredAgeRange
 };
+const Viral = {
+	getCampaign: getViralCampaign,
+	share: shareViralCampaign
+};
 //#endregion
-export { Accuracy, Ads, Analytics, Clipboard, Device, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, Migration, Notification, OpenCameraPermissionError, PermissionError, Promotion, Review, SafeArea, SafeAreaInsets, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };
+export { Accuracy, Analytics, Clipboard, Device, Environment, FetchAlbumPhotosPermissionError, FetchContactsPermissionError, File, Game, GetClipboardTextPermissionError, GetCurrentLocationPermissionError, GoogleAdMob, IAP, Migration, Notification, OpenCameraPermissionError, PermissionError, Promotion, Review, SafeArea, SafeAreaInsets, Screen, SetClipboardTextPermissionError, Share, StartUpdateLocationPermissionError, Storage, TossAds, TossAuth, TossPay, User, Viral, aitState, appLogin, applyPreset, appsInTossEvent, appsInTossSignTossCert, builtInPresets, captureCurrentState, checkoutPayment, closeView, contactsViral, createAsyncBridge, createConstantBridge, createEventBridge, deleteUserPreset, env, eventLog, fetchAlbumItems, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getAppsInTossGlobals, getClipboardText, getConsentedUserData, getCurrentLocation, getDeclaredAgeRange, getDefaultPlaceholderImages, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPermission, getPlatformOS, getSafeAreaInsets, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, getViralCampaign, graniteEvent, grantPromotionReward, grantPromotionRewardForGame, isMinVersionSupported, listUserPresets, loadFullScreenAd, matchesPreset, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openPDFViewer, openPermissionDialog, openURL, partner, requestNotificationAgreement, requestPermission, requestReview, requestTossPayPaysBilling, saveBase64Data, saveUserPreset, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareViralCampaign, showFullScreenAd, startUpdateLocation, submitGameCenterLeaderBoardScore, tdsEvent };

package/dist/panel/index.js

@@ -27325,20 +27325,33 @@ function createMockProxy(moduleName, implementations) {
 		throw new Error(`[@apps-in-toss/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/device/storage.ts
+/**
+* Storage mock
+* localStorage에 `__ait_storage:` prefix로 저장하여 앱 자체 localStorage와 분리
+*
+* 실기기(2.x×iOS) capture는 `setItem`/`removeItem`/`clearItems` 세 메서드가
+* `undefined`가 아니라 `null`로 resolve됨을 보였다(devtools#770). 원본 SDK 타입
+* 선언은 여전히 `Promise<void>`이므로 시그니처는 그대로 두고, 런타임 반환값만
+* `null`로 캐스트해 실측과 동치시킨다 — Analytics·setClipboardText와 같은 처리(#775).
+* `getItem`은 이미 `string | null`이라 실측과 일치하므로 손대지 않는다.
+*/
+const STORAGE_PREFIX = "__ait_storage:";
 createMockProxy("Storage", {
 	getItem: async (key) => {
-		return localStorage.getItem(`__ait_storage:${key}`);
+		return localStorage.getItem(`${STORAGE_PREFIX}${key}`);
 	},
 	setItem: async (key, value) => {
-		localStorage.setItem(`__ait_storage:${key}`, value);
+		localStorage.setItem(`${STORAGE_PREFIX}${key}`, value);
 		return null;
 	},
 	removeItem: async (key) => {
-		localStorage.removeItem(`__ait_storage:${key}`);
+		localStorage.removeItem(`${STORAGE_PREFIX}${key}`);
 		return null;
 	},
 	clearItems: async () => {
-		const keys = Object.keys(localStorage).filter((k) => k.startsWith("__ait_storage:"));
+		const keys = Object.keys(localStorage).filter((k) => k.startsWith(STORAGE_PREFIX));
 		for (const k of keys) localStorage.removeItem(k);
 		return null;
 	}
@@ -27848,39 +27861,6 @@ const showFullScreenAd = withIsSupported(observe("showFullScreenAd", "faithful",
 	setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
 	return () => {};
 }));
-createMockProxy("Ads", {
-	showTossAdOrShoppingAds: withIsSupported(observe("Ads.showTossAdOrShoppingAds", "faithful", (args) => {
-		if (!aitState.state.ads.isLoaded) {
-			args.onError(/* @__PURE__ */ new Error("Ad not loaded"));
-			return () => {};
-		}
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => {
-			args.onEvent({ type: "dismissed" });
-			aitState.patch("ads", { isLoaded: false });
-		}, 1500);
-		return () => {};
-	})),
-	showTossShoppingAds: withIsSupported(observe("Ads.showTossShoppingAds", "faithful", (args) => {
-		const { rewardUnitType, rewardAmount } = aitState.state.ads;
-		setTimeout(() => args.onEvent({
-			type: "userEarnedReward",
-			data: {
-				unitType: rewardUnitType,
-				unitAmount: rewardAmount
-			}
-		}), 1e3);
-		setTimeout(() => args.onEvent({ type: "dismissed" }), 1500);
-		return () => {};
-	}))
-});
 //#endregion
 //#region src/panel/tabs/ads.ts
 function recordEvent(type) {
@@ -30634,7 +30614,7 @@ function Panel() {
 								color: "#666",
 								fontWeight: 400
 							},
-							children: ["v", "3.2.0-beta.0"]
+							children: ["v", "3.3.0"]
 						}),
 						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", {
 							type: "button",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apps-in-toss/devtools",
-  "version": "3.2.0-beta.0",
+  "version": "3.3.0",
   "description": "Browser development tools for Apps in Toss mini-apps — mock SDK, floating devtools panel, and universal bundler plugin. devDependency only; contributes nothing to a production bundle",
   "keywords": [
     "apps-in-toss",
@@ -67,7 +67,7 @@
     "unplugin": "^3.2.0"
   },
   "devDependencies": {
-    "@apps-in-toss/web-framework": "^3.2.0-beta.0",
+    "@apps-in-toss/web-framework": "^3.3.0",
     "@apps-in-toss/web-framework-2x": "npm:@apps-in-toss/web-framework@2.10.8",
     "@testing-library/dom": "10.4.1",
     "@testing-library/react": "16.3.2",
@@ -84,7 +84,7 @@
     "vitest": "4.1.9"
   },
   "peerDependencies": {
-    "@apps-in-toss/web-framework": ">=3.2.0-beta.0"
+    "@apps-in-toss/web-framework": ">=2.6.0 <3.0.0 || >=3.0.1 <4.0.0"
   },
   "peerDependenciesMeta": {
     "@apps-in-toss/web-framework": {