@apps-in-toss/web-framework 0.0.22 → 0.0.23

package/dist/prebuilt/prod.json

@@ -2,13 +2,13 @@
   {
     "platform": "ios",
     "totalModuleCount": 1607,
-    "duration": 1126.545167,
-    "size": 427248
+    "duration": 994.5753750000001,
+    "size": 435419
   },
   {
     "platform": "android",
     "totalModuleCount": 1607,
-    "duration": 1137.7411670000001,
-    "size": 426627
+    "duration": 1003.9547079999998,
+    "size": 434798
   }
 ]

package/dist-web/bridge.d.ts

@@ -17,7 +17,7 @@ export * from './getCurrentLocation';
 export * from './openCamera';
 export * from './appLogin';
 export * from './checkoutPayment';
-export * from './executePayment';
+export * from './eventLog';
 export * from './getTossShareLink';
 export * from './getOperationalEnvironment';
 export * from './getTossAppVersion';

package/dist-web/bridge.js

@@ -1 +1 @@
-import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__BEDROCK_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var setClipboardText=createAsyncBridge("setClipboardText");export var getClipboardText=createAsyncBridge("getClipboardText");export var fetchContacts=createAsyncBridge("fetchContacts");export var fetchAlbumPhotos=createAsyncBridge("fetchAlbumPhotos");export var Accuracy=function(Accuracy){Accuracy[Accuracy["Lowest"]=1]="Lowest";Accuracy[Accuracy["Low"]=2]="Low";Accuracy[Accuracy["Balanced"]=3]="Balanced";Accuracy[Accuracy["High"]=4]="High";Accuracy[Accuracy["Highest"]=5]="Highest";Accuracy[Accuracy["BestForNavigation"]=6]="BestForNavigation";return Accuracy}({});export var getCurrentLocation=createAsyncBridge("getCurrentLocation");export var openCamera=createAsyncBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var executePayment=createAsyncBridge("executePayment");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__BEDROCK_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var setClipboardText=createAsyncBridge("setClipboardText");export var getClipboardText=createAsyncBridge("getClipboardText");export var fetchContacts=createAsyncBridge("fetchContacts");export var fetchAlbumPhotos=createAsyncBridge("fetchAlbumPhotos");export var Accuracy=function(Accuracy){Accuracy[Accuracy["Lowest"]=1]="Lowest";Accuracy[Accuracy["Low"]=2]="Low";Accuracy[Accuracy["Balanced"]=3]="Balanced";Accuracy[Accuracy["High"]=4]="High";Accuracy[Accuracy["Highest"]=5]="Highest";Accuracy[Accuracy["BestForNavigation"]=6]="BestForNavigation";return Accuracy}({});export var getCurrentLocation=createAsyncBridge("getCurrentLocation");export var openCamera=createAsyncBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");

package/dist-web/checkoutPayment.d.ts

@@ -2,124 +2,74 @@
  * @public
  * @category 토스페이
  * @name CheckoutPaymentOptions
- * @description 토스페이 결제를 생성할 때 필요한 옵션 객체예요.
- * @property {string} orderNo 가맹점의 상품 주문번호예요.
- * @property {string} productDesc 상품 설명이에요.
- * @property {number} amount 결제 금액이에요.
- * @property {number} amountTaxFree 결제 금액 중 비과세 금액이에요.
- * @property {number} [amountTaxable] 결제 금액 중 과세 금액이에요.
- * @property {number} [amountVat] 결제 금액 중 부가세예요.
- * @property {number} [amountServiceFee] 결제 금액 중 봉사료예요.
- * @property {'TOSS_MONEY' | 'CARD' | null} [enablePayMethods] 결제수단 구분 변수예요. (TOSS_MONEY: 토스머니만, CARD: 카드만, null: 기본 결제수단)
- * @property {boolean} [cashReceipt] 현금영수증 발급 가능 여부예요.
- * @property {'CULTURE' | 'GENERAL' | 'PUBLIC_TP'} [cashReceiptTradeOption] 현금영수증 발급 타입이에요. (CULTURE: 문화비, GENERAL: 일반, PUBLIC_TP: 교통비)
- * @property {'USE' | 'NO_USE'} [installment] 할부를 사용할 지 말 지 여부에요. (USE: 사용, NO_USE: 할부 미사용)
+ * @description 토스페이 결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} payToken 결제 토큰이에요.
  */
 export interface CheckoutPaymentOptions {
 	/**
-	 * 가맹점의 상품 주문번호에요.
+	 * 결제 토큰이에요.
 	 */
-	orderNo: string;
-	/**
-	 * 상품 설명이에요.
-	 */
-	productDesc: string;
-	/**
-	 * 결제 금액이예요.
-	 */
-	amount: number;
-	/**
-	 * 결제 금액 중 비과세 금액이에요.
-	 */
-	amountTaxFree: number;
-	/**
-	 * 결제 금액 중 과세 금액이에요.
-	 */
-	amountTaxable?: number;
-	/**
-	 * 결제 금액 중 부가세예요.
-	 */
-	amountVat?: number;
-	/**
-	 * 결제 금액 중 봉사료예요.
-	 */
-	amountServiceFee?: number;
-	/**
-	 * 결제수단 구분 변수예요.
-	 *
-	 * - 'TOSS_MONEY': 결제수단 중 토스머니만 노출
-	 * - 'CARD': 결제수단 중 카드만 노출
-	 * - null: 상점에 설정된 기본 결제 수단 노출
-	 */
-	enablePayMethods?: "TOSS_MONEY" | "CARD" | null;
-	/**
-	 * 현금영수증 발급 가능 여부예요.
-	 */
-	cashReceipt?: boolean;
+	payToken: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name CheckoutPaymentResult
+ * @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
+ */
+export interface CheckoutPaymentResult {
 	/**
-	 * 현금영수증 발급 타입이에요.
-	 *
-	 * - 'CULTURE': 문화비
-	 * - 'GENERAL': 일반(기본값)
-	 * - 'PUBLIC_TP': 교통비
+	 * 인증이 성공했는지 여부예요.
 	 */
-	cashReceiptTradeOption?: "CULTURE" | "GENERAL" | "PUBLIC_TP";
+	success: boolean;
 	/**
-	 * 할부를 사용할 지 말 지 여부에요.
-	 *
-	 * - 'USE': 사용(기본값)
-	 * - 'NO_USE': 할부 미사용
+	 * 인증이 실패했을 경우의 이유예요.
 	 */
-	installment?: "USE" | "NO_USE";
+	reason?: string;
 }
 /**
  * @public
  * @category 토스페이
  * @name checkoutPayment
- * @description 토스페이 결제를 생성하는 함수예요.
+ * @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
+ *
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
  *
- * @param {CheckoutPaymentOptions} options 결제를 생성할 때 필요한 옵션 객체예요.
- * @param {string} options.orderNo 가맹점의 상품 주문번호예요.
- * @param {string} options.productDesc 상품 설명이에요.
- * @param {number} options.amount 결제 금액이에요.
- * @param {number} options.amountTaxFree 결제 금액 중 비과세 금액이에요.
- * @param {number} [options.amountTaxable] 결제 금액 중 과세 금액이에요.
- * @param {number} [options.amountVat] 결제 금액 중 부가세예요.
- * @param {number} [options.amountServiceFee] 결제 금액 중 봉사료예요.
- * @param {'TOSS_MONEY' | 'CARD' | null} [options.enablePayMethods] 결제수단 구분 변수예요. (TOSS_MONEY: 토스머니만, CARD: 카드만, null: 기본 결제수단)
- * @param {boolean} [options.cashReceipt] 현금영수증 발급 가능 여부예요.
- * @param {'CULTURE' | 'GENERAL' | 'PUBLIC_TP'} [options.cashReceiptTradeOption] 현금영수증 발급 타입이에요. (CULTURE: 문화비, GENERAL: 일반, PUBLIC_TP: 교통비)
- * @param {'USE' | 'NO_USE'} [options.installment] 할부를 사용할 지 말 지 여부에요. (USE: 사용, NO_USE: 할부 미사용)
- * @returns {Promise<{ payToken: string }>} 결제 인증 후 발급된 결제 토큰 값이 포함된 객체를 반환해요.
+ * @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.
  *
  * @example
- * ### 결제 생성하기
+ *
+ * ### 토스페이 결제창 띄우고 인증 처리하기
  *
  * ```tsx
  * import { TossPay } from '@apps-in-toss/web-framework';
  *
  * async function handlePayment() {
  *   try {
- *     const result = await TossPay.checkoutPayment({
- *       orderNo: 'ORDER_12345',
- *       productDesc: '티셔츠',
- *       amount: 15000,
- *       amountTaxFree: 0,
- *       amountTaxable: 13636,
- *       amountVat: 1364,
- *       enablePayMethods: 'CARD',
- *       installment: 'USE'
- *     });
+ *     // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());
+ *
+ *     const { success, reason } = await TossPay.checkoutPayment({ payToken });
  *
- *     console.log('결제 토큰:', result.payToken);
+ *     if (success) {
+ *       // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해주세요.
+ *       await fetch('/my-api/payment/execute', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ payToken }),
+ *         headers: { 'Content-Type': 'application/json' },
+ *       });
+ *     } else {
+ *       console.log('인증 실패:', reason);
+ *     }
  *   } catch (error) {
- *     console.error('결제 생성에 실패했어요:', error);
+ *     console.error('결제 인증 중 오류가 발생했어요:', error);
  *   }
  * }
  * ```
  */
-export declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<{
-	payToken: string;
-}>;
+export declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
 
 export {};

package/dist-web/eventLog.d.ts

@@ -0,0 +1,43 @@
+export type Primitive = string | number | boolean | null | undefined | symbol;
+/**
+ * @category 로깅
+ * @kind function
+ * @name eventLog
+ * @description
+ * 이벤트 로그를 기록하는 함수예요.
+ *
+ * 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.
+ *
+ * @param {Object} params 로그 기록에 필요한 매개변수 객체예요.
+ * @param {string} params.log_name 로그의 이름이에요.
+ * @param {'debug' | 'info' | 'warn' | 'error'} params.log_type 로그의 유형이에요.
+ * @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.
+ *
+ * @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.
+ *
+ * @example
+ * ### 이벤트 로그 기록하기
+ *
+ * ```tsx
+ * import { eventLog } from '@apps-in-toss/web-framework';
+ *
+ * function logUserAction() {
+ *   eventLog({
+ *     log_name: 'user_action',
+ *     log_type: 'info',
+ *     params: {
+ *       action: 'button_click',
+ *       screen: 'main',
+ *       userId: 12345
+ *     }
+ *   });
+ * }
+ * ```
+ */
+export declare function eventLog(params: {
+	log_name: string;
+	log_type: "debug" | "info" | "warn" | "error";
+	params: Record<string, Primitive>;
+}): Promise<void>;
+
+export {};

package/dist-web/getTossShareLink.d.ts

@@ -4,7 +4,7 @@
  * @kind function
  * @name getTossShareLink
  * @description
- * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 공유 링크를 반환해요.
+ * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
  * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
  *
  * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
@@ -17,7 +17,8 @@
  *
  * @example
  * ```tsx
- * import { getTossShareLink, share } from '@apps-in-toss/web-framework';
+ * import { share } from '@apps-in-toss/web-framework';
+ * import { getTossShareLink } from '@apps-in-toss/web-framework';
  *
  * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
  * const tossLink = await getTossShareLink('intoss://my-app');

package/dist-web/index.d.ts

@@ -1,5 +1,6 @@
 export * from './bridge';
 export * from '@apps-in-toss/bridge-core';
+import { LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdOptions } from '@apps-in-toss/framework';
 
 /**
  * @public
@@ -86,6 +87,291 @@ declare function getSafeAreaInsets(): {
     bottom: number;
 };
 
+declare const GoogleAdMob: {
+    /**
+     * @public
+     * @category 광고
+     * @name loadAdMobInterstitialAd
+     * @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+     * @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+     * @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+     * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
+     * @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/framework/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
+     * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+     * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+     *
+     * @example
+     * ### 뷰 진입 시 전면광고 불러오기
+     * ```tsx
+     * import { GoogleAdMob } from '@apps-in-toss/framework';
+     * import { useEffect } from 'react';
+     * import { View, Text } from 'react-native';
+     *
+     * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+     *
+     * function Page() {
+     *   useEffect(() => {
+     *     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);
+     *             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;
+     *         }
+     *       },
+     *       onError: (error) => {
+     *         console.error('광고 불러오기 실패', error);
+     *       },
+     *     });
+     *
+     *     return cleanup;
+     *   }, []);
+     *
+     *   return (
+     *     <View>
+     *       <Text>Page</Text>
+     *     </View>
+     *   );
+     * }
+     * ```
+     */
+    loadAdMobInterstitialAd: ((args: {
+        onEvent: (data: void) => void;
+        onError: (error: Error) => void;
+        options?: LoadAdMobInterstitialAdOptions | undefined;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+    /**
+     * @public
+     * @category 광고
+     * @name showAdMobInterstitialAd
+     * @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+     * @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
+     * @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+     * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
+     * @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/framework/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
+     * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+     * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+     *
+     * @example
+     * ### 버튼 눌러 불러온 전면 광고 보여주기
+     * ```tsx
+     * import { GoogleAdMob } from '@apps-in-toss/framework';
+     * import { View, Text, Button } from 'react-native';
+     *
+     * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+     *
+     * function Page() {
+     *   const handlePress = () => {
+     *     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);
+     *       },
+     *     });
+     *   }
+     *
+     *   return (
+     *     <Button onPress={handlePress}>
+     *       <Text>광고 보기</Text>
+     *     </Button>
+     *   );
+     * }
+     * ```
+     */
+    showAdMobInterstitialAd: ((args: {
+        onEvent: (data: void) => void;
+        onError: (error: Error) => void;
+        options?: ShowAdMobInterstitialAdOptions | undefined;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+    /**
+     * @public
+     * @category 광고
+     * @name loadAdMobRewardedAd
+     * @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+     * @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+     * @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+     * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
+     * @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/framework/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
+     * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+     * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+     *
+     * @example
+     * ### 뷰 진입 시 보상형 광고 불러오기
+     * ```tsx
+     * import { GoogleAdMob } from '@apps-in-toss/framework';
+     * import { useEffect } from 'react';
+     * import { View, Text } from 'react-native';
+     *
+     * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+     *
+     * function Page() {
+     *   useEffect(() => {
+     *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+     *       return;
+     *     }
+     *
+     *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+     *       options: {
+     *         adUnitId: AD_UNIT_ID,
+     *       },
+     *       onEvent: (event) => {
+     *         switch (event.type) {
+     *           case 'loaded':
+     *             console.log('광고 로드 성공', event.data);
+     *             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;
+     *   }, []);
+     *
+     *   return (
+     *     <View>
+     *       <Text>Page</Text>
+     *     </View>
+     *   );
+     * }
+     * ```
+     */
+    loadAdMobRewardedAd: ((args: {
+        onEvent: (data: void) => void;
+        onError: (error: Error) => void;
+        options?: LoadAdMobRewardedAdOptions | undefined;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+    /**
+     * @public
+     * @category 광고
+     * @name showAdMobRewardedAd
+     * @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+     * @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+     * @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+     * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
+     * @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/framework/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
+     * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+     * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+     *
+     * @example
+     * ### 버튼 눌러 불러온 보상형 광고 보여주기
+     * ```tsx
+     * import { GoogleAdMob } from '@apps-in-toss/framework';
+     * import { View, Text, Button } from 'react-native';
+     *
+     * const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
+     *
+     * function Page() {
+     *   const handlePress = () => {
+     *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+     *       return;
+     *     }
+     *
+     *     GoogleAdMob.showAdMobRewardedAd({
+     *       options: {
+     *         adUnitId: AD_UNIT_ID,
+     *       },
+     *       onEvent: (event) => {
+     *         switch (event.type) {
+     *           case 'requested':
+     *             console.log('광고 보여주기 요청 완료');
+     *             break;
+     *         }
+     *       },
+     *       onError: (error) => {
+     *         console.error('광고 보여주기 실패', error);
+     *       },
+     *     });
+     *   }
+     *
+     *   return (
+     *     <Button onPress={handlePress}>
+     *       <Text>광고 보기</Text>
+     *     </Button>
+     *   );
+     * }
+     * ```
+     */
+    showAdMobRewardedAd: ((args: {
+        onEvent: (data: void) => void;
+        onError: (error: Error) => void;
+        options?: ShowAdMobRewardedAdOptions | undefined;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+};
+
 type BedrockEvent = {
     backEvent: {
         onEvent: () => void;
@@ -101,4 +387,62 @@ declare const bedrockEvent: {
     }) => () => void;
 };
 
-export { type BedrockEvent, Storage, bedrockEvent, getSafeAreaInsets };
+/**
+ * @public
+ * @category 환경 확인
+ * @kind function
+ * @name isMinVersionSupported
+ * @description
+ * 현재 토스 앱 버전이 지정한 최소 버전 이상인지 확인해요.
+ *
+ * 이 함수는 현재 실행 중인 토스 앱의 버전이 파라미터로 전달된 최소 버전 요구사항을 충족하는지 확인해요. 특정 기능이 최신 버전에서만 동작할 때, 사용자에게 앱 업데이트를 안내할 수 있어요.
+ *
+ * @param {Object} minVersions 플랫폼별 최소 버전 요구사항을 지정하는 객체예요.
+ * @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.android 안드로이드 플랫폼의 최소 버전 요구사항이에요.
+ * @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.ios iOS 플랫폼의 최소 버전 요구사항이에요.
+ * @returns {boolean} 현재 앱 버전이 최소 버전 이상이면 true, 그렇지 않으면 false를 반환해요.
+ *
+ * @example
+ * ### 앱 버전 확인하기
+ *
+ * ```tsx
+ * import { isMinVersionSupported } from '@apps-in-toss/framework';
+ * import { Text, View } from 'react-native';
+ *
+ * function VersionCheck() {
+ *   const isSupported = isMinVersionSupported({
+ *     android: '1.2.0',
+ *     ios: '1.3.0'
+ *   });
+ *
+ *   return (
+ *     <View>
+ *       {!isSupported && (
+ *         <Text>최신 버전으로 업데이트가 필요해요.</Text>
+ *       )}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function isMinVersionSupported(minVersions: {
+    android: `${number}.${number}.${number}` | 'always' | 'never';
+    ios: `${number}.${number}.${number}` | 'always' | 'never';
+}): boolean;
+
+type AppsInTossEvent = {
+    entryMessageExited: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options: undefined;
+    };
+};
+declare const appsInTossEvent: {
+    addEventListener: <K extends keyof AppsInTossEvent>(event: K, { onEvent, onError, options, }: {
+        onEvent: AppsInTossEvent[K]["onEvent"];
+        onError?: AppsInTossEvent[K]["onError"] | undefined;
+        options?: AppsInTossEvent[K]["options"] | undefined;
+    }) => () => void;
+};
+
+export { type AppsInTossEvent, type BedrockEvent, GoogleAdMob, Storage, appsInTossEvent, bedrockEvent, getSafeAreaInsets, isMinVersionSupported };