@apps-in-toss/framework 0.0.24 → 0.0.26

package/dist/index.cjs

@@ -76,14 +76,19 @@ var env = {
 // src/native-modules/tossCore.ts
 var import_react_native3 = require("react-native");
 
-// src/native-modules/isMinVersionSupported.ts
-var import_react_native2 = require("react-native");
-
 // src/native-modules/AppsInTossModule.ts
 var import_react_native = require("react-native");
 var AppsInTossModuleInstance = import_react_native.NativeModules.AppsInTossModule;
 var AppsInTossModule = AppsInTossModuleInstance;
 
+// src/native-modules/getOperationalEnvironment.ts
+function getOperationalEnvironment() {
+  return AppsInTossModule.operationalEnvironment;
+}
+
+// src/native-modules/isMinVersionSupported.ts
+var import_react_native2 = require("react-native");
+
 // src/utils/compareVersion.ts
 var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
 var isWildcard = (val) => ["*", "x", "X"].includes(val);
@@ -176,7 +181,8 @@ function isMinVersionSupported(minVersions) {
 var TossCoreModule = import_react_native3.NativeModules.TossCoreModule;
 function tossCoreEventLog(params) {
   const supported = isMinVersionSupported({ ios: "5.210.0", android: "5.210.0" });
-  if (!supported) {
+  const isSandbox = getOperationalEnvironment() === "sandbox";
+  if (!supported || isSandbox) {
     return;
   }
   TossCoreModule.eventLog({
@@ -305,7 +311,9 @@ var UpdateLocationEvent = class extends import_react_native_bedrock4.BedrockEven
     }
   };
   remove() {
-    --this.subscriptionCount === 0 && AppsInTossModuleInstance.stopUpdateLocation({});
+    if (--this.subscriptionCount === 0) {
+      AppsInTossModuleInstance.stopUpdateLocation({});
+    }
     this.ref.remove();
   }
   listener(options, onEvent, onError) {
@@ -642,11 +650,6 @@ function startUpdateLocation(eventParams) {
 function noop() {
 }
 
-// src/native-modules/getOperationalEnvironment.ts
-function getOperationalEnvironment() {
-  return AppsInTossModule.operationalEnvironment;
-}
-
 // src/native-modules/ads/googleAdMob.ts
 function loadAdMobInterstitialAd(params) {
   if (!loadAdMobInterstitialAd.isSupported()) {
@@ -1192,8 +1195,6 @@ function WebView({ type, local, onMessage, ...props }) {
       loadAdMobRewardedAd: GoogleAdMob.loadAdMobRewardedAd,
       showAdMobRewardedAd: GoogleAdMob.showAdMobRewardedAd
     },
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-expect-error
     constantHandlerMap: {
       ...bedrockConstantBridges,
       ...constant_bridges_exports,
@@ -1207,8 +1208,6 @@ function WebView({ type, local, onMessage, ...props }) {
       /** env */
       getDeploymentId: env.getDeploymentId
     },
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-expect-error
     asyncHandlerMap: {
       ...bedrockAsyncBridges,
       ...async_bridges_exports,

package/dist/index.d.cts

@@ -149,10 +149,8 @@ interface StartUpdateLocationSubscription extends EmitterSubscription {
  * @kind typedef
  * @description
  * 디바이스의 위치 정보 변경을 감지해요
- * @extends {EventEmitterSchema<'updateLocation', [Location]>}
  */
-interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation', [Location]> {
-}
+type UpdateLocationEventEmitter = EventEmitterSchema<'updateLocation', [Location]>;
 /**
  * @public
  * @category 위치 정보
@@ -365,20 +363,25 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
  *
  * @example
- * ### 뷰 진입 시 전면광고 불러오기
+ * ### 버튼 눌러 불러온 전면 광고 보여주기
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useEffect } from 'react';
- * import { View, Text } from 'react-native';
+ * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ * import { useNavigation } from 'react-native-bedrock';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   useEffect(() => {
+ * export function GoogleAdmobInterstitialAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
  *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
  *       return;
  *     }
- *
+
  *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
  *       options: {
  *         adUnitId: AD_UNIT_ID,
@@ -387,6 +390,7 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *         switch (event.type) {
  *           case 'loaded':
  *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
  *             break;
  *
  *           case 'clicked':
@@ -395,6 +399,7 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *
  *           case 'dismissed':
  *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
  *             break;
  *
  *           case 'failedToShow':
@@ -416,11 +421,41 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *     });
  *
  *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
  *   }, []);
  *
+ *   useFocusEffect(loadAd);
+ *
  *   return (
  *     <View>
- *       <Text>Page</Text>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
  * }
@@ -468,12 +503,64 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  * ### 버튼 눌러 불러온 전면 광고 보여주기
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { View, Button } from 'react-native';
+ * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ * import { useNavigation } from 'react-native-bedrock';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   const handlePress = () => {
+ * export function GoogleAdmobInterstitialAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+
+ *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
  *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
  *       return;
  *     }
@@ -493,10 +580,20 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  *         console.error('광고 보여주기 실패', error);
  *       },
  *     });
- *   }
+ *   }, []);
+ *
+ *   useFocusEffect(loadAd);
  *
  *   return (
- *     <Button onPress={handlePress} title="광고 보기" />
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
  *   );
  * }
  * ```
@@ -543,16 +640,20 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
  *
  * @example
- * ### 뷰 진입 시 보상형 광고 불러오기
+ *
+ * ### 버튼 눌러 불러온 보상형 광고 보여주기
+ *
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useEffect } from 'react';
- * import { View, Text } from 'react-native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   useEffect(() => {
+ * export function GoogleAdmobRewardedAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *
+ *   const loadAd = useCallback(() => {
  *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
  *       return;
  *     }
@@ -562,9 +663,11 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *         adUnitId: AD_UNIT_ID,
  *       },
  *       onEvent: (event) => {
+ *         console.log(event.type);
  *         switch (event.type) {
  *           case 'loaded':
  *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
  *             break;
  *
  *           case 'clicked':
@@ -600,9 +703,39 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *     return cleanup;
  *   }, []);
  *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             setAdLoadStatus('not_loaded');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
+ *
  *   return (
  *     <View>
- *       <Text>Page</Text>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
  * }
@@ -648,14 +781,68 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *
  * @example
  * ### 버튼 눌러 불러온 보상형 광고 보여주기
+ *
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { View, Text, Button } from 'react-native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   const handlePress = () => {
+ * export function GoogleAdmobRewardedAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         console.log(event.type);
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *
+ *           case 'userEarnedReward':
+ *             console.log('사용자가 광고 시청을 완료했음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
+ *
+ *   const showAd = useCallback(() => {
  *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
  *       return;
  *     }
@@ -668,6 +855,7 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *         switch (event.type) {
  *           case 'requested':
  *             console.log('광고 보여주기 요청 완료');
+ *             setAdLoadStatus('not_loaded');
  *             break;
  *         }
  *       },
@@ -675,10 +863,19 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *         console.error('광고 보여주기 실패', error);
  *       },
  *     });
- *   }
+ *   }, []);
  *
  *   return (
- *     <Button onPress={handlePress} title="광고 보기" />
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
  *   );
  * }
  * ```

package/dist/index.d.ts

@@ -149,10 +149,8 @@ interface StartUpdateLocationSubscription extends EmitterSubscription {
  * @kind typedef
  * @description
  * 디바이스의 위치 정보 변경을 감지해요
- * @extends {EventEmitterSchema<'updateLocation', [Location]>}
  */
-interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation', [Location]> {
-}
+type UpdateLocationEventEmitter = EventEmitterSchema<'updateLocation', [Location]>;
 /**
  * @public
  * @category 위치 정보
@@ -365,20 +363,25 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
  *
  * @example
- * ### 뷰 진입 시 전면광고 불러오기
+ * ### 버튼 눌러 불러온 전면 광고 보여주기
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useEffect } from 'react';
- * import { View, Text } from 'react-native';
+ * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ * import { useNavigation } from 'react-native-bedrock';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   useEffect(() => {
+ * export function GoogleAdmobInterstitialAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
  *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
  *       return;
  *     }
- *
+
  *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
  *       options: {
  *         adUnitId: AD_UNIT_ID,
@@ -387,6 +390,7 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *         switch (event.type) {
  *           case 'loaded':
  *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
  *             break;
  *
  *           case 'clicked':
@@ -395,6 +399,7 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *
  *           case 'dismissed':
  *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
  *             break;
  *
  *           case 'failedToShow':
@@ -416,11 +421,41 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *     });
  *
  *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
  *   }, []);
  *
+ *   useFocusEffect(loadAd);
+ *
  *   return (
  *     <View>
- *       <Text>Page</Text>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
  * }
@@ -468,12 +503,64 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  * ### 버튼 눌러 불러온 전면 광고 보여주기
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { View, Button } from 'react-native';
+ * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ * import { useNavigation } from 'react-native-bedrock';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   const handlePress = () => {
+ * export function GoogleAdmobInterstitialAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+
+ *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
  *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
  *       return;
  *     }
@@ -493,10 +580,20 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  *         console.error('광고 보여주기 실패', error);
  *       },
  *     });
- *   }
+ *   }, []);
+ *
+ *   useFocusEffect(loadAd);
  *
  *   return (
- *     <Button onPress={handlePress} title="광고 보기" />
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
  *   );
  * }
  * ```
@@ -543,16 +640,20 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
  *
  * @example
- * ### 뷰 진입 시 보상형 광고 불러오기
+ *
+ * ### 버튼 눌러 불러온 보상형 광고 보여주기
+ *
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useEffect } from 'react';
- * import { View, Text } from 'react-native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   useEffect(() => {
+ * export function GoogleAdmobRewardedAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *
+ *   const loadAd = useCallback(() => {
  *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
  *       return;
  *     }
@@ -562,9 +663,11 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *         adUnitId: AD_UNIT_ID,
  *       },
  *       onEvent: (event) => {
+ *         console.log(event.type);
  *         switch (event.type) {
  *           case 'loaded':
  *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
  *             break;
  *
  *           case 'clicked':
@@ -600,9 +703,39 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *     return cleanup;
  *   }, []);
  *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             setAdLoadStatus('not_loaded');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
+ *
  *   return (
  *     <View>
- *       <Text>Page</Text>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
  * }
@@ -648,14 +781,68 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *
  * @example
  * ### 버튼 눌러 불러온 보상형 광고 보여주기
+ *
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { View, Text, Button } from 'react-native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
  *
- * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
  *
- * function Page() {
- *   const handlePress = () => {
+ * export function GoogleAdmobRewardedAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         console.log(event.type);
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *
+ *           case 'userEarnedReward':
+ *             console.log('사용자가 광고 시청을 완료했음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
+ *
+ *   const showAd = useCallback(() => {
  *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
  *       return;
  *     }
@@ -668,6 +855,7 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *         switch (event.type) {
  *           case 'requested':
  *             console.log('광고 보여주기 요청 완료');
+ *             setAdLoadStatus('not_loaded');
  *             break;
  *         }
  *       },
@@ -675,10 +863,19 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *         console.error('광고 보여주기 실패', error);
  *       },
  *     });
- *   }
+ *   }, []);
  *
  *   return (
- *     <Button onPress={handlePress} title="광고 보기" />
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
  *   );
  * }
  * ```

package/dist/index.js

@@ -24,14 +24,19 @@ var env = {
 // src/native-modules/tossCore.ts
 import { NativeModules as NativeModules2 } from "react-native";
 
-// src/native-modules/isMinVersionSupported.ts
-import { Platform } from "react-native";
-
 // src/native-modules/AppsInTossModule.ts
 import { NativeModules } from "react-native";
 var AppsInTossModuleInstance = NativeModules.AppsInTossModule;
 var AppsInTossModule = AppsInTossModuleInstance;
 
+// src/native-modules/getOperationalEnvironment.ts
+function getOperationalEnvironment() {
+  return AppsInTossModule.operationalEnvironment;
+}
+
+// src/native-modules/isMinVersionSupported.ts
+import { Platform } from "react-native";
+
 // src/utils/compareVersion.ts
 var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
 var isWildcard = (val) => ["*", "x", "X"].includes(val);
@@ -124,7 +129,8 @@ function isMinVersionSupported(minVersions) {
 var TossCoreModule = NativeModules2.TossCoreModule;
 function tossCoreEventLog(params) {
   const supported = isMinVersionSupported({ ios: "5.210.0", android: "5.210.0" });
-  if (!supported) {
+  const isSandbox = getOperationalEnvironment() === "sandbox";
+  if (!supported || isSandbox) {
     return;
   }
   TossCoreModule.eventLog({
@@ -253,7 +259,9 @@ var UpdateLocationEvent = class extends BedrockEventDefinition2 {
     }
   };
   remove() {
-    --this.subscriptionCount === 0 && AppsInTossModuleInstance.stopUpdateLocation({});
+    if (--this.subscriptionCount === 0) {
+      AppsInTossModuleInstance.stopUpdateLocation({});
+    }
     this.ref.remove();
   }
   listener(options, onEvent, onError) {
@@ -590,11 +598,6 @@ function startUpdateLocation(eventParams) {
 function noop() {
 }
 
-// src/native-modules/getOperationalEnvironment.ts
-function getOperationalEnvironment() {
-  return AppsInTossModule.operationalEnvironment;
-}
-
 // src/native-modules/ads/googleAdMob.ts
 function loadAdMobInterstitialAd(params) {
   if (!loadAdMobInterstitialAd.isSupported()) {
@@ -1145,8 +1148,6 @@ function WebView({ type, local, onMessage, ...props }) {
       loadAdMobRewardedAd: GoogleAdMob.loadAdMobRewardedAd,
       showAdMobRewardedAd: GoogleAdMob.showAdMobRewardedAd
     },
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-expect-error
     constantHandlerMap: {
       ...bedrockConstantBridges,
       ...constant_bridges_exports,
@@ -1160,8 +1161,6 @@ function WebView({ type, local, onMessage, ...props }) {
       /** env */
       getDeploymentId: env.getDeploymentId
     },
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-expect-error
     asyncHandlerMap: {
       ...bedrockAsyncBridges,
       ...async_bridges_exports,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/framework",
   "type": "module",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "description": "The framework for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -57,30 +57,30 @@
     "ait": "./bin/ait.js"
   },
   "dependencies": {
-    "@apps-in-toss/analytics": "0.0.24",
-    "@apps-in-toss/cli": "0.0.24",
-    "@apps-in-toss/plugins": "0.0.24",
+    "@apps-in-toss/analytics": "0.0.26",
+    "@apps-in-toss/cli": "0.0.26",
+    "@apps-in-toss/plugins": "0.0.26",
     "es-hangul": "^2.3.2"
   },
   "devDependencies": {
-    "@react-native-bedrock/mpack-next": "0.0.23",
-    "@react-native-bedrock/native": "0.0.23",
+    "@react-native-bedrock/mpack-next": "0.0.24",
+    "@react-native-bedrock/native": "0.0.24",
+    "@react-native-bedrock/plugin-core": "0.0.24",
+    "@react-native-bedrock/utils": "0.0.24",
     "@toss-design-system/react-native": "^0.5.0",
     "@types/kill-port": "^2.0.1",
     "@types/react": "18.3.3",
-    "@types/yauzl": "^2.10.3",
     "es-toolkit": "^1.34.1",
     "eslint": "^9.7.0",
     "execa": "^9.5.2",
     "kill-port": "^2.0.1",
     "react": "18.2.0",
     "react-native": "0.72.6",
-    "react-native-bedrock": "0.0.23",
+    "react-native-bedrock": "0.0.24",
     "tsup": "^8.3.5",
-    "typescript": "4.9.5",
+    "typescript": "5.8.3",
     "vitest": "^3.0.3",
-    "workspace-tools": "^0.38.2",
-    "yauzl": "^3.2.0"
+    "workspace-tools": "^0.38.2"
   },
   "peerDependencies": {
     "@react-native-bedrock/native": ">= 0.0.18",
@@ -93,5 +93,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8a48e0a264315e510cc8e15b0db89b29e679a9ce"
+  "gitHead": "8df951171a6a432852d863459d724224a0680e7d"
 }

package/src/async-bridges.ts

@@ -1,10 +1,10 @@
-export * from './native-modules/setClipboardText.js';
-export * from './native-modules/getClipboardText.js';
-export * from './native-modules/fetchContacts.js';
-export * from './native-modules/fetchAlbumPhotos.js';
-export * from './native-modules/getCurrentLocation.js';
-export * from './native-modules/openCamera.js';
-export * from './native-modules/appLogin.js';
-export * from './native-modules/checkoutPayment.js';
-export * from './native-modules/eventLog.js';
-export * from './native-modules/getTossShareLink.js';
+export * from './native-modules/setClipboardText';
+export * from './native-modules/getClipboardText';
+export * from './native-modules/fetchContacts';
+export * from './native-modules/fetchAlbumPhotos';
+export * from './native-modules/getCurrentLocation';
+export * from './native-modules/openCamera';
+export * from './native-modules/appLogin';
+export * from './native-modules/checkoutPayment';
+export * from './native-modules/eventLog';
+export * from './native-modules/getTossShareLink';

package/src/constant-bridges.ts

@@ -1,3 +1,3 @@
-export * from './native-modules/getOperationalEnvironment.js';
-export * from './native-modules/getTossAppVersion.js';
-export * from './native-modules/getDeviceId.js';
+export * from './native-modules/getOperationalEnvironment';
+export * from './native-modules/getTossAppVersion';
+export * from './native-modules/getDeviceId';

package/src/event-bridges.ts

@@ -1 +1 @@
-export * from './native-event-emitter/startUpdateLocation.js';
+export * from './native-event-emitter/startUpdateLocation';