@apps-in-toss/framework 0.0.0-dev.1743135526084 → 0.0.0-dev.1747216176095

package/dist/index.d.cts

@@ -1,12 +1,23 @@
+import * as react from 'react';
 import { ComponentType, PropsWithChildren } from 'react';
-import { InitialProps, BedrockProps } from 'react-native-bedrock';
-import { EmitterSubscription } from 'react-native';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _apps_in_toss_analytics from '@apps-in-toss/analytics';
+export * from '@apps-in-toss/analytics';
+import { InitialProps, BedrockProps, BedrockEventDefinition, BedrockEvent } from 'react-native-bedrock';
+import { EmitterSubscription } from 'react-native';
 import { PartnerWebViewScreenProps, ExternalWebViewScreenProps } from '@toss-design-system/react-native';
 import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';
 
-type AppsInTossProps = Pick<BedrockProps, 'context'>;
-declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
+interface AppsInTossProps {
+    context: BedrockProps['context'];
+    analytics?: {
+        /**
+         * 분석 로그 출력 여부를 설정해요. 기본값은 `__DEV__` 예요.
+         */
+        debug?: boolean;
+    };
+}
+declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context, analytics }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
 
 declare const AppsInToss: {
     registerApp: typeof registerApp;
@@ -70,7 +81,7 @@ interface Location {
      */
     timestamp: number;
     /**
-     * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/reference/framework/Types/LocationCoords.html)을 참고해주세요.
+     * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/react-native/reference/framework/Types/LocationCoords.html)을 참고해주세요.
      */
     coords: LocationCoords;
 }
@@ -116,7 +127,7 @@ interface ImageResponse {
     dataUri: string;
 }
 
-interface StartUpdateLocationOptions {
+interface StartUpdateLocationOptions$1 {
     /**
      * 위치 정확도를 설정해요.
      */
@@ -138,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 위치 정보
@@ -154,7 +163,7 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
  * @param {number} [options.accuracy] 위치 정확도를 설정해요.
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
- * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
+ * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기
@@ -204,397 +213,751 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
 declare function startUpdateLocation(eventParams: {
     onEvent: (response: Location) => void;
     onError: (error: unknown) => void;
-    options: StartUpdateLocationOptions;
+    options: StartUpdateLocationOptions$1;
 }): () => void;
 
 /**
  * @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: 할부 미사용)
+ * @category 광고
+ * @name AdMobFullScreenEvent
+ * @description 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
+ * @example
+ * ### 광고 이벤트 처리하기
+ * ```ts
+ * function handleEvent(event: AdMobFullScreenEvent) {
+ *   switch (event.type) {
+ *     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;
+ *   }
+ * }
+ * ```
  */
-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;
+type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
+type AdClicked = {
+    type: 'clicked';
+};
+type AdDismissed = {
+    type: 'dismissed';
+};
+type AdFailedToShow = {
+    type: 'failedToShow';
+};
+type AdImpression = {
+    type: 'impression';
+};
+type AdShow = {
+    type: 'show';
+};
+interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
+    options: Options;
+    onEvent: (event: Event) => void;
+    onError: (error: unknown) => void;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ResponseInfo
+ * @description 광고 로드 응답 정보를 담고 있는 객체예요.
+ * @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
+ * @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
+ * @property {string | null} responseId 광고 응답 ID예요.
+ */
+interface ResponseInfo {
+    adNetworkInfoArray: Array<AdNetworkResponseInfo>;
+    loadedAdNetworkInfo: AdNetworkResponseInfo | null;
+    responseId: string | null;
+}
+/**
+ * @public
+ * @category 광고
+ * @name AdNetworkResponseInfo
+ * @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
+ * @property {string} adSourceId 광고 소스 ID예요.
+ * @property {string} adSourceName 광고 소스 이름이예요.
+ * @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
+ * @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
+ * @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
+ */
+interface AdNetworkResponseInfo {
+    adSourceId: string;
+    adSourceName: string;
+    adSourceInstanceId: string;
+    adSourceInstanceName: string;
+    adNetworkClassName: string | null;
+}
+/**
+ * @public
+ * @category 광고
+ * @name InterstitialAd
+ * @description 전면 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
+ * @property {string} adUnitId 광고 ID예요.
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
+ */
+interface InterstitialAd {
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+/**
+ * @public
+ * @category 광고
+ * @name RewardedAd
+ * @description 보상형 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
+ * @property {string} adUnitId 광고 ID예요.
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
+ */
+interface RewardedAd {
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
+
+interface LoadAdMobInterstitialAdOptions {
     /**
-     * 현금영수증 발급 가능 여부예요.
+     * 광고 단위 ID
      */
-    cashReceipt?: boolean;
+    adUnitId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobInterstitialAdEvent
+ * @description 전면 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [InterstitialAd](/react-native/reference/framework/광고/InterstitialAd.html) 객체가 함께 반환돼요.
+ */
+type LoadAdMobInterstitialAdEvent = AdMobFullScreenEvent | {
+    type: 'loaded';
+    data: InterstitialAd;
+};
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobInterstitialAdParams
+ * @description 전면 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdOptions, LoadAdMobInterstitialAdEvent>;
+/**
+ * @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 { 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 = '<AD_UNIT_ID>';
+ *
+ * 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;
+ *     }
+ *
+ *     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>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function loadAdMobInterstitialAd(params: LoadAdMobInterstitialAdParams): () => void;
+declare namespace loadAdMobInterstitialAd {
+    var isSupported: () => boolean;
+}
+interface ShowAdMobInterstitialAdOptions {
     /**
-     * 현금영수증 발급 타입이에요.
-     *
-     * - 'CULTURE': 문화비
-     * - 'GENERAL': 일반(기본값)
-     * - 'PUBLIC_TP': 교통비
+     * 광고 단위 ID
      */
-    cashReceiptTradeOption?: 'CULTURE' | 'GENERAL' | 'PUBLIC_TP';
+    adUnitId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobInterstitialAdEvent
+ * @description 전면 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+type ShowAdMobInterstitialAdEvent = {
+    type: 'requested';
+};
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobInterstitialAdParams
+ * @description 불러온 전면 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent>;
+/**
+ * @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 { 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 = '<AD_UNIT_ID>';
+ *
+ * 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;
+ *     }
+ *
+ *     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>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function showAdMobInterstitialAd(params: ShowAdMobInterstitialAdParams): () => void;
+declare namespace showAdMobInterstitialAd {
+    var isSupported: () => boolean;
+}
+interface LoadAdMobRewardedAdOptions {
     /**
-     * 할부를 사용할 지 말 지 여부에요.
-     *
-     * - 'USE': 사용(기본값)
-     * - 'NO_USE': 할부 미사용
+     * 광고 단위 ID
      */
-    installment?: 'USE' | 'NO_USE';
+    adUnitId: string;
 }
 /**
  * @public
- * @category 토스페이
- * @name checkoutPayment
- * @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 }>} 결제 인증 후 발급된 결제 토큰 값이 포함된 객체를 반환해요.
+ * @category 광고
+ * @name LoadAdMobInterstitialAdEvent
+ * @description 보상형 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [RewardedAd](/react-native/reference/framework/광고/RewardedAd.html) 객체가 함께 반환돼요. `userEarnedReward` 이벤트는 사용자가 광고를 끝까지 시청해, 보상 조건을 충족했을 때 발생해요.
+ */
+type LoadAdMobRewardedAdEvent = AdMobFullScreenEvent | {
+    type: 'loaded';
+    data: RewardedAd;
+} | {
+    type: 'userEarnedReward';
+};
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobRewardedAdParams
+ * @description 보상형 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions, LoadAdMobRewardedAdEvent>;
+/**
+ * @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 { TossPay } from '@apps-in-toss/framework';
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
  *
- * 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'
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ *
+ * 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);
+ *       },
  *     });
  *
- *     console.log('결제 토큰:', result.payToken);
- *   } catch (error) {
- *     console.error('결제 생성에 실패했어요:', error);
- *   }
+ *     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>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
  * }
  * ```
  */
-declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<{
-    payToken: string;
-}>;
-
+declare function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams): () => void;
+declare namespace loadAdMobRewardedAd {
+    var isSupported: () => boolean;
+}
+interface ShowAdMobRewardedAdOptions {
+    /**
+     * 광고 단위 ID
+     */
+    adUnitId: string;
+}
 /**
  * @public
- * @category 토스페이
- * @name ExecutePaymentOptions
- * @description 생성한 토스페이 결제를 실행할 때 필요한 옵션이에요.
- * @property {string} orderNo 결제를 생성할 때 사용한 주문번호예요.
- * @property {string} payToken 결제 인증 과정에서 전달받은 결제 토큰이에요. 결제를 실행할 때 사용해요.
+ * @category 광고
+ * @name ShowAdMobRewardedAdEvent
+ * @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
  */
-interface ExecutePaymentOptions {
-    /**
-     * 결제를 생성할 때 사용한 주문번호예요.
-     */
-    orderNo: string;
-    /**
-     * 결제 인증 과정에서 전달받은 Pay 토큰이에요.
-     */
-    payToken: string;
+type ShowAdMobRewardedAdEvent = {
+    type: 'requested';
+};
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobRewardedAdParams
+ * @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
+/**
+ * @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 { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ *
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ *
+ * 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;
+ *     }
+ *
+ *     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>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams): () => void;
+declare namespace showAdMobRewardedAd {
+    var isSupported: () => boolean;
 }
+
 /**
  * @public
  * @category 토스페이
- * @name CardExecutePaymentResult
- * @description 카드로 결제 요청을 실행한 뒤 돌아오는 결제 결과 객체예요. 결제 승인 여부, 결제된 금액, 주문 정보 등을 담고 있어요.
- * @property {'CARD'} payMethod 결제 수단이에요.
- * @property {number} code 결제 요청의 결과 코드예요.
- * @property {'LIVE' | 'TEST'} mode 현재 결제 환경이에요.
- * @property {string} orderNo 주문번호예요.
- * @property {number} amount 총 결제 금액이에요.
- * @property {string} approvalTime 결제가 승인된 시간이에요. (ISO 8601 형식)
- * @property {string} stateMsg 결제 상태 메시지예요.
- * @property {number} discountedAmount 적용된 할인 금액이에요.
- * @property {number} paidAmount 실제 결제된 금액이에요.
- * @property {string} payToken 결제 요청 시 사용한 Pay 토큰이에요.
- * @property {string} transactionId 거래 ID예요.
- * @property {number} cardCompanyCode 카드사 코드예요.
- * @property {string} cardCompanyName 카드사 이름이에요.
- * @property {string} cardAuthorizationNo 카드사 승인 번호예요. (라이브 결제 환경에서만 확인 가능해요)
- * @property {number} spreadOut 할부 개월 수예요. (5만원 미만 금액 및 일시불 결제의 경우에는 `0`)
- * @property {boolean} noInterest 무이자 할부 여부예요.
- * @property {string} salesCheckLinkUrl 결제 내역을 확인할 수 있는 매출전표 URL이에요.
- * @property {'CREDIT' | 'CHECK' | 'PREPAYMENT'} cardMethodType 카드 유형이에요.
- * @property {string} cardNumber 마스킹된 카드 번호예요. (`****-****-****-1234` 형식)
- * @property {string} cardNum4Print 카드 번호의 마지막 4자리예요.
- * @property {string} cardBinNumber 카드 BIN 번호예요.
+ * @name CheckoutPaymentOptions
+ * @description 토스페이 결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} payToken 결제 토큰이에요.
  */
-interface CardExecutePaymentResult {
-    /**
-     * 결제 수단이에요.
-     */
-    payMethod: 'CARD';
-    /**
-     * 결제 요청의 결과 코드예요.
-     */
-    code: number;
-    /**
-     * 현재 결제 환경이에요.
-     *
-     * - `LIVE`: 실제 환경
-     * - `TEST`: 테스트 환경
-     */
-    mode: 'LIVE' | 'TEST';
-    /**
-     * 주문번호예요.
-     */
-    orderNo: string;
-    /**
-     * 총 결제 금액이에요.
-     */
-    amount: number;
-    /**
-     * 결제가 승인된 시간이에요. (ISO 8601 형식)
-     */
-    approvalTime: string;
-    /**
-     * 결제 상태 메시지예요.
-     */
-    stateMsg: string;
-    /**
-     * 적용된 할인 금액이에요.
-     */
-    discountedAmount: number;
-    /**
-     * 실제 결제된 금액이에요.
-     */
-    paidAmount: number;
+interface CheckoutPaymentOptions {
     /**
-     * 결제 요청 시 사용한 Pay 토큰이에요.
+     * 결제 토큰이에요.
      */
     payToken: string;
-    /**
-     * 거래 ID예요.
-     */
-    transactionId: string;
-    /**
-     * 카드사 코드예요.
-     */
-    cardCompanyCode: number;
-    /**
-     * 카드사 이름이에요.
-     */
-    cardCompanyName: string;
-    /**
-     * 카드사 승인 번호예요. (라이브 결제 환경에서만 확인 가능해요)
-     */
-    cardAuthorizationNo: string;
-    /**
-     * 할부 개월 수예요. (5만원 미만 금액 및 일시불 결제의 경우에는 `0`)
-     */
-    spreadOut: number;
-    /**
-     * 무이자 할부 여부예요.
-     */
-    noInterest: boolean;
-    /**
-     * 결제 내역을 확인할 수 있는 매출전표 URL이에요.
-     */
-    salesCheckLinkUrl: string;
-    /**
-     * 카드 유형이에요.
-     *
-     * - 'CREDIT': 신용카드
-     * - 'CHECK': 체크카드
-     * - 'PREPAYMENT': 선불카드
-     */
-    cardMethodType: 'CREDIT' | 'CHECK' | 'PREPAYMENT';
-    /**
-     * 마스킹된 카드 번호예요. (`****-****-****-1234` 형식)
-     */
-    cardNumber: string;
-    /**
-     * 카드 사용자 구분을 나타내는 값이에요.
-     *
-     * - 'PERSONAL': 개인 카드
-     * - 'PERSONAL_FAMILY': 가족 카드
-     * - 'CORP_PERSONAL': 법인지정 결제계좌 (임직원)
-     * - 'CORP_PRIVATE': 법인 공용
-     * - 'CORP_COMPANY': 법인지정 결제계좌 회사 (하나카드 Only)
-     */
-    cardUserType: 'PERSONAL' | 'PERSONAL_FAMILY' | 'CORP_PERSONAL' | 'CORP_PRIVATE' | 'CORP_COMPANY';
-    /**
-     * 카드 번호의 마지막 4자리예요.
-     */
-    cardNum4Print: string;
-    /**
-     * 카드 BIN 번호예요.
-     */
-    cardBinNumber: string;
 }
 /**
  * @public
  * @category 토스페이
- * @name TossMoneyExecutePaymentResult
- * @description 토스머니로 결제 요청을 실행한 뒤 돌아오는 결제 결과 객체예요. 결제 승인 여부, 결제된 금액, 주문 정보 등을 담고 있어요.
- * @property {'TOSS_MONEY'} payMethod 결제 수단이에요.
- * @property {number} code 결제 요청의 결과 코드예요.
- * @property {'LIVE' | 'TEST'} mode 현재 결제 환경이에요.
- * @property {string} orderNo 주문번호예요.
- * @property {number} amount 총 결제 금액이에요.
- * @property {string} approvalTime 결제가 승인된 시간이에요. (ISO 8601 형식)
- * @property {string} stateMsg 결제 상태 메시지예요.
- * @property {number} discountedAmount 적용된 할인 금액이에요.
- * @property {number} paidAmount 실제 결제된 금액이에요.
- * @property {string} payToken 결제 요청 시 사용한 Pay 토큰이에요.
- * @property {string} transactionId 거래 ID예요.
- * @property {string} cashReceiptMgtKey 현금영수증 관리번호 식별값이에요.
- * @property {string} accountBankName 결제된 은행의 코드예요.
- * @property {string} accountNumber 결제된 계좌번호예요.
+ * @name CheckoutPaymentResult
+ * @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
  */
-interface TossMoneyExecutePaymentResult {
-    /**
-     * 결제에 사용된 결제 수단이에요.
-     */
-    payMethod: 'TOSS_MONEY';
-    /**
-     * 결제 요청의 결과 코드예요.
-     */
-    code: number;
+interface CheckoutPaymentResult {
     /**
-     * 현재 결제 환경이에요.
-     *
-     * - `LIVE`: 실제 환경
-     * - `TEST`: 테스트 환경
+     * 인증이 성공했는지 여부예요.
      */
-    mode: 'LIVE' | 'TEST';
+    success: boolean;
     /**
-     * 결제 승인된 상품의 주문번호예요.
+     * 인증이 실패했을 경우의 이유예요.
      */
-    orderNo: string;
-    /**
-     * 결제 승인된 상품의 총 결제 금액이에요.
-     */
-    amount: number;
-    /**
-     * 결제가 승인된 시간이에요. (ISO 8601 형식)
-     */
-    approvalTime: string;
-    /**
-     * 결제 상태 메시지예요.
-     */
-    stateMsg: string;
-    /**
-     * 적용된 할인 금액이에요.
-     */
-    discountedAmount: number;
-    /**
-     * 실제 결제 승인된 금액이에요.
-     */
-    paidAmount: number;
-    /**
-     * 결제 요청 시 사용한 Pay 토큰이에요.
-     */
-    payToken: string;
-    /**
-     * 거래 ID예요.
-     */
-    transactionId: string;
-    /**
-     * 현금영수증 관리번호 식별값이에요.
-     */
-    cashReceiptMgtKey: string;
-    /**
-     * 결제된 은행의 코드예요.
-     */
-    accountBankName: string;
-    /**
-     * 결제된 계좌번호예요.
-     */
-    accountNumber: string;
+    reason?: string;
 }
 /**
  * @public
  * @category 토스페이
- * @name executePayment
- * @description 구매자가 결제를 시도하면, 먼저 결제 정보를 생성하고 인증을 받아요. 이때 결제 상태는 '대기' 중이에요. 이후 결제를 실제로 승인하려면 주어진 주문번호와 결제 토큰을 사용해서 이 함수로 생성된 결제를 승인해요. 결제 승인이 완료되면, 구매자의 결제 수단(예: 카드, 계좌)에서 실제로 금액이 출금돼요. 이 함수를 호출하지 않으면 결제가 자동으로 만료되고, 출금도 발생하지 않아요.
+ * @name checkoutPayment
+ * @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
  *
- * @param {ExecutePaymentOptions} options 결제를 실행할 때 필요한 옵션이에요.
- * @param {string} options.orderNo 결제를 생성할 때 사용한 주문번호예요.
- * @param {string} options.payToken 결제 인증 과정에서 전달받은 결제 토큰이에요. 결제를 실행할 때 사용해요.
- * @returns {Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>} 결제 결과 객체를 반환해요. 자세한 내용은 [카드 결제 결과](reference/framework/토스페이/CardExecutePaymentResult.html) 또는 [토스머니 결제 결과](reference/framework/토스페이/TossMoneyExecutePaymentResult.html)를 참고하세요.
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
+ *
+ * @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.
  *
  * @example
  *
- * ### 카드 결제 실행하기
+ * ### 토스페이 결제창 띄우고 인증 처리하기
  *
  * ```tsx
  * import { TossPay } from '@apps-in-toss/framework';
  *
  * async function handlePayment() {
  *   try {
- *     const payToken = 'PAY_TOKEN_12345'; // 결제 인증 후 받은 토큰
+ *     // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());
  *
- *     const result = await TossPay.executePayment({
- *       orderNo: 'ORDER_12345',
- *       payToken,
- *     });
+ *     const { success, reason } = await TossPay.checkoutPayment({ payToken });
  *
- *     console.log('결제가 완료되었어요:', result);
+ *     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);
  *   }
  * }
  * ```
  */
-declare function executePayment(options: ExecutePaymentOptions): Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>;
+declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
 
 /**
  * @public
@@ -858,7 +1221,7 @@ interface GetCurrentLocationOptions {
  *
  * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
  * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
- * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
+ * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 디바이스의 현재 위치 정보 가져오기
@@ -1027,17 +1390,293 @@ declare function appLogin(): Promise<{
  */
 declare function getOperationalEnvironment(): 'toss' | 'sandbox';
 
+/**
+ * @public
+ * @category 환경 확인
+ * @name getTossAppVersion
+ * @description 토스 앱 버전을 가져옵니다. 예를 들어, `5.206.0`과 같은 형태로 반환돼요. 토스 앱 버전을 로그로 남기거나, 특정 기능이 특정 버전 이상에서만 실행될 때 사용돼요.
+ * @signature
+ * ```typescript
+ * function getTossAppVersion(): string
+ * ```
+ *
+ * @returns {string} 토스 앱 버전
+ *
+ * @example
+ *
+ *
+ * ### 토스 앱 버전 확인하기
+ *
+ * ```tsx
+ * import { getTossAppVersion } from '@apps-in-toss/framework';
+ * import { Text } from 'react-native';
+ *
+ * export function TossAppVersionPage() {
+ *  return (
+ *   <Text>{getTossAppVersion()}</Text>
+ *  )
+ * }
+ * ```
+ */
+declare function getTossAppVersion(): string;
+
+/**
+ * @public
+ * @category 환경 확인
+ * @kind function
+ * @name getDeviceId
+ * @description
+ * 사용 중인 기기의 고유 식별자를 문자열로 반환해요.
+ *
+ * 이 함수는 현재 사용 중인 기기의 고유 식별자를 문자열로 반환해요. 기기별로 설정이나 데이터를 저장하거나 사용자의 기기를 식별해서 로그를 기록하고 분석하는 데 사용할 수 있어요. 같은 사용자의 여러 기기를 구분하는 데도 유용해요.
+ *
+ * @returns {string} 기기의 고유 식별자를 나타내는 문자열이에요.
+ *
+ * @example
+ * ### 기기 고유 식별자 가져오기
+ *
+ * ```tsx
+ * import { getDeviceId } from '@apps-in-toss/framework';
+ * import { Text } from 'react-native';
+ *
+ * function MyPage() {
+ *   const id = getDeviceId();
+ *
+ *   return (
+ *     <Text>사용자의 기기 고유 식별자: {id}</Text>
+ *   );
+ * }
+ * ```
+ */
+declare function getDeviceId(): string;
+
+/**
+ * @public
+ * @category 저장소
+ * @name getItem
+ * @description 모바일 앱의 로컬 저장소에서 문자열 데이터를 가져와요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
+ * @param {string} key - 가져올 아이템의 키를 입력해요.
+ * @returns {Promise<string | null>} 지정한 키에 저장된 문자열 값을 반환해요. 값이 없으면 `null`을 반환해요.
+ * @example
+ *
+ * ### `my-key`에 저장된 아이템 가져오기
+ * ```ts
+ * const value = await Storage.getItem('my-key');
+ * console.log(value); // 'value'
+ * ```
+ */
+declare function getItem(key: string): Promise<string | null>;
+/**
+ * @public
+ * @category 저장소
+ * @name setItem
+ * @description 모바일 앱의 로컬 저장소에 문자열 데이터를 저장해요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
+ * @param {string} key - 저장할 아이템의 키를 입력해요.
+ * @param {string} value - 저장할 아이템의 값을 입력해요.
+ * @returns {Promise<void>} 아이템을 성공적으로 저장하면 아무 값도 반환하지 않아요.
+ * @example
+ *
+ * ### `my-key`에 아이템 저장하기
+ * ```ts
+ * import { Storage } from '@apps-in-toss/framework';
+ *
+ * await Storage.setItem('my-key', 'value');
+ * ```
+ */
+declare function setItem(key: string, value: string): Promise<void>;
+/**
+ * @public
+ * @category 저장소
+ * @name removeItem
+ * @description 모바일 앱의 로컬 저장소에서 특정 키에 해당하는 아이템을 삭제해요.
+ * @param {string} key - 삭제할 아이템의 키를 입력해요.
+ * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않아요.
+ * @example
+ *
+ * ### `my-key`에 저장된 아이템 삭제하기
+ * ```ts
+ * import { Storage } from '@apps-in-toss/framework';
+ *
+ * await Storage.removeItem('my-key');
+ * ```
+ */
+declare function removeItem(key: string): Promise<void>;
+/**
+ * @public
+ * @category 저장소
+ * @name clearItems
+ * @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
+ * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
+ * @example
+ *
+ * ### 저장소 초기화하기
+ * ```ts
+ * import { Storage } from '@apps-in-toss/framework';
+ *
+ * await Storage.clearItems();
+ * ```
+ */
+declare function clearItems(): Promise<void>;
+/**
+ * @public
+ * @category 저장소
+ * @name Storage
+ * @description 네이티브의 저장소를 사용해요.
+ * @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem.html)을 참고하세요.
+ * @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem.html)을 참고하셰요.
+ * @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem.html)을 참고하세요.
+ * @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems.html)을 참고하세요.
+ */
+declare const Storage: {
+    getItem: typeof getItem;
+    setItem: typeof setItem;
+    removeItem: typeof removeItem;
+    clearItems: typeof clearItems;
+};
+
+/**
+ * @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 Primitive = string | number | boolean | null | undefined | symbol;
+
+interface EventLogParams {
+    log_name: string;
+    log_type: 'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click';
+    params: Record<string, Primitive>;
+}
+/**
+ * @category 로깅
+ * @kind function
+ * @name eventLog
+ * @description
+ * 이벤트 로그를 기록하는 함수예요.
+ *
+ * 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.
+ *
+ * @param {Object} params 로그 기록에 필요한 매개변수 객체예요.
+ * @param {string} params.log_name 로그의 이름이에요.
+ * @param {'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click'} params.log_type 로그의 유형이에요.
+ * @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.
+ *
+ * @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.
+ *
+ * @example
+ * ### 이벤트 로그 기록하기
+ *
+ * ```tsx
+ * import { eventLog } from '@apps-in-toss/framework';
+ *
+ * function logUserAction() {
+ *   eventLog({
+ *     log_name: 'user_action',
+ *     log_type: 'info',
+ *     params: {
+ *       action: 'button_click',
+ *       screen: 'main',
+ *       userId: 12345
+ *     }
+ *   });
+ * }
+ * ```
+ */
+declare function eventLog(params: EventLogParams): Promise<void>;
+
+/**
+ * @public
+ * @category 공유
+ * @kind function
+ * @name getTossShareLink
+ * @description
+ * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
+ * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
+ *
+ * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
+ * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
+ *
+ * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
+ *
+ * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
+ * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
+ *
+ * @example
+ * ```tsx
+ * import { share } from 'react-native-bedrock';
+ * import { getTossShareLink } from '@apps-in-toss/framework';
+ *
+ * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
+ * const tossLink = await getTossShareLink('intoss://my-app');
+ *
+ * // 생성한 링크를 메시지로 공유해요.
+ * await share({ message: tossLink });
+ * ```
+ */
+declare function getTossShareLink(path: string): Promise<string>;
+
 /**
  * @public
  * @category 토스페이
  * @name TossPay
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
- * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 생성하는 함수예요. 자세한 내용은 [checkoutPayment](reference/framework/토스페이/checkoutPayment)를 참고하세요.
- * @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](reference/framework/토스페이/executePayment)를 참고하세요.
+ * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
  */
 declare const TossPay: {
     checkoutPayment: typeof checkoutPayment;
-    executePayment: typeof executePayment;
+};
+/**
+ * @public
+ * @category 광고
+ * @name GoogleAdMob
+ * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
+ * @property {typeof loadAdMobInterstitialAd} [loadAdMobInterstitialAd] 전면 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobInterstitialAd](/react-native/reference/framework/광고/loadAdMobInterstitialAd.html)를 참고하세요.
+ * @property {typeof showAdMobInterstitialAd} [showAdMobInterstitialAd] 로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobInterstitialAd](/react-native/reference/framework/광고/showAdMobInterstitialAd.html)를 참고하세요.
+ * @property {typeof loadAdMobRewardedAd} [loadAdMobRewardedAd] 보상형 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobRewardedAd](/react-native/reference/framework/광고/loadAdMobRewardedAd.html)를 참고하세요.
+ * @property {typeof showAdMobRewardedAd} [showAdMobRewardedAd] 로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobRewardedAd](/react-native/reference/framework/광고/showAdMobRewardedAd.html)를 참고하세요.
+ */
+declare const GoogleAdMob: {
+    loadAdMobInterstitialAd: typeof loadAdMobInterstitialAd;
+    showAdMobInterstitialAd: typeof showAdMobInterstitialAd;
+    loadAdMobRewardedAd: typeof loadAdMobRewardedAd;
+    showAdMobRewardedAd: typeof showAdMobRewardedAd;
 };
 
 type GameWebViewProps$1 = WebViewProps$1;
@@ -1062,7 +1701,7 @@ interface LocalNetwork {
 type InternalProps = 'source' | 'cacheEnabled' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded';
 declare function WebView({ type, local, onMessage, ...props }: WebViewProps): react_jsx_runtime.JSX.Element;
 
-type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
+type UseGeolocationOptions = Omit<StartUpdateLocationOptions$1, 'callback'>;
 /**
  * @public
  * @category 위치 정보
@@ -1076,7 +1715,7 @@ type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
  * @param {Accuracy} [options.accuracy] 위치 정확도를 설정해요. `Accuracy.Lowest`: 오차범위 3KM 이내, `Accuracy.Low`: 오차범위 1KM 이내, `Accuracy.Balanced`: 오차범위 몇 백미터 이내, `Accuracy.High`: 오차범위 10M 이내, `Accuracy.Highest`: 가장 높은 정확도, `Accuracy.BestForNavigation`: 네비게이션을 위한 최고 정확도
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
- * @returns {Location | null} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
+ * @returns {Location | null} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기
@@ -1112,4 +1751,57 @@ declare const env: {
     getDeploymentId: () => string | undefined;
 };
 
-export { Accuracy, AppsInToss, type ContactEntity, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getOperationalEnvironment, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+declare class EntryMessageExitedEvent extends BedrockEventDefinition<undefined, undefined> {
+    name: "entryMessageExited";
+    remove(): void;
+    listener(_: undefined): void;
+}
+
+interface StartUpdateLocationOptions {
+    /**
+     * 위치 정확도를 설정해요.
+     */
+    accuracy: Accuracy;
+    /**
+     * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
+     */
+    timeInterval: number;
+    /**
+     * 위치 변경 거리를 미터(m) 단위로 설정해요.
+     */
+    distanceInterval: number;
+}
+declare class UpdateLocationEvent extends BedrockEventDefinition<StartUpdateLocationOptions, Location> {
+    name: "updateLocationEvent";
+    subscriptionCount: number;
+    ref: {
+        remove: () => void;
+    };
+    remove(): void;
+    listener(options: StartUpdateLocationOptions, onEvent: (response: Location) => void, onError: (error: unknown) => void): void;
+}
+
+interface AppBridgeCallbackResult {
+    name: string;
+    params?: any;
+}
+declare class AppBridgeCallbackEvent extends BedrockEventDefinition<void, AppBridgeCallbackResult> {
+    private static INTERNAL__appBridgeSubscription?;
+    name: "appBridgeCallbackEvent";
+    constructor();
+    remove(): void;
+    listener(): void;
+    private registerAppBridgeCallbackEventListener;
+    private ensureInvokeAppBridgeCallback;
+}
+
+declare const appsInTossEvent: BedrockEvent<EntryMessageExitedEvent | AppBridgeCallbackEvent | UpdateLocationEvent>;
+
+declare const Analytics: {
+    init: (options: _apps_in_toss_analytics.AnalyticsConfig) => void;
+    Impression: ({ enabled, impression: impressionType, ...props }: _apps_in_toss_analytics.LoggingImpressionProps) => react_jsx_runtime.JSX.Element;
+    Press: react.ForwardRefExoticComponent<_apps_in_toss_analytics.LoggingPressProps & react.RefAttributes<unknown>>;
+    Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
+};
+
+export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, startUpdateLocation, useGeolocation };