@apps-in-toss/web-bridge 0.0.39 → 1.0.0

package/built/index.d.cts

@@ -0,0 +1,657 @@
+export * from './bridge';
+export * from '@apps-in-toss/bridge-core';
+import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions } from '@apps-in-toss/framework';
+
+/**
+ * @public
+ * @category 저장소
+ * @name Storage
+ * @description 네이티브의 저장소를 사용해요.
+ * @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem)을 참고하세요.
+ * @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem)을 참고하세요.
+ * @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem)을 참고하세요.
+ * @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems)을 참고하세요.
+ */
+declare const Storage: {
+    /**
+     * @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'
+     * ```
+     */
+    getItem: (args_0: 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');
+     * ```
+     */
+    setItem: (args_0: string, args_1: 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');
+     * ```
+     */
+    removeItem: (args_0: string) => Promise<void>;
+    /**
+     * @public
+     * @category 저장소
+     * @name clearItems
+     * @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
+     * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
+     * @example
+     *
+     * ### 저장소 초기화하기
+     * ```ts
+     * import { Storage } from '@apps-in-toss/framework';
+     *
+     * await Storage.clearItems();
+     * ```
+     */
+    clearItems: (args_0: void) => Promise<void>;
+};
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderResult
+ * @description 인앱결제 1건이 완료되면 결제 세부 정보와 상품 정보를 담아 반환해요. 반환된 정보로 결제한 상품의 정보를 화면에 표시할 수 있어요.
+ * @property {string} orderId - 결제 주문 ID이에요. 결제 완료 후 [결제 상태를 조회](https://developers-apps-in-toss.toss.im/api/getIapOrderStatus.html)할 때 사용해요.
+ * @property {string} displayName - 화면에 표시할 상품 이름이에요.
+ * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
+ * @property {number} amount - 상품 가격 숫자 값이에요. 화폐 단위와 쉼표를 제외한 순수 숫자예요. 예를 들어 `1000`으로 표시돼요.
+ * @property {string} currency - [ISO 4217 표준](https://ko.wikipedia.org/wiki/ISO_4217)에 따른 상품 가격 통화 단위예요. 예를 들어 원화는 `KRW`, 달러는 `USD`로 표시돼요.
+ * @property {number} fraction - 가격을 표시할 때 소수점 아래 몇 자리까지 보여줄지 정하는 값이에요. 예를 들어 달러는 소수점 둘째 자리까지 보여줘서 `2`, 원화는 소수점이 필요 없어서 `0`이에요
+ * @property {string | null} miniAppIconUrl - 미니앱 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요. 콘솔에서 아이콘을 등록하지 않았다면 `null`로 반환돼요.
+ */
+interface IapCreateOneTimePurchaseOrderResult {
+    orderId: string;
+    displayName: string;
+    displayAmount: string;
+    amount: number;
+    currency: string;
+    fraction: number;
+    miniAppIconUrl: string | null;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapProductListItem
+ * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
+ * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html)를 호출할때 사용하는 `productId`와 동일한 값이에요.
+ * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
+ * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
+ * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
+ * @property {string} description - 상품에 대한 설명이에요. 설명은 앱인토스 콘솔에서 설정한 값이에요.
+ */
+interface IapProductListItem {
+    sku: string;
+    displayAmount: string;
+    displayName: string;
+    iconUrl: string;
+    description: string;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IAP
+ * @description 인앱결제 관련 기능을 모은 객체예요. 단건 인앱결제 주문서 이동과 상품 목록 조회 기능을 제공해요.
+ * @property {typeof createOneTimePurchaseOrder} [createOneTimePurchaseOrder] 특정 인앱결제 주문서 페이지로 이동해요. 자세한 내용은 [createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getProductItemList.html) 문서를 참고하세요.
+ * @property {typeof getProductItemList} [getProductItemList] 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 자세한 내용은 [getProductItemList](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html) 문서를 참고하세요.
+ */
+declare const IAP: {
+    /**
+     * @public
+     * @category 인앱결제
+     * @name iapCreateOneTimePurchaseOrder
+     * @description
+     * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
+     * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
+     * @param {string} params.productId - 주문할 상품의 ID예요.
+     * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+     *
+     * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
+     * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
+     * @throw {code: "NETWORK_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
+     * @throw {code: "INVALID_USER_ENVIRONMENT"} - 특정 기기, 계정 또는 설정 환경에서 구매할 수 없는 상품일 때 발생해요.
+     * @throw {code: "ITEM_ALREADY_OWNED"} - 사용자가 이미 구매한 상품을 다시 구매하려고 할 때 발생해요.
+     * @throw {code: "APP_MARKET_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 앱스토어에서 사용자 정보 검증에 실패했을 때 발생해요. 사용자가 앱스토어에 문의해서 환불을 요청해야해요.
+     * @throw {code: "TOSS_SERVER_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 서버 전송에 실패해서 결제 정보를 저장할 수 없을 때 발생해요.
+     * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
+     * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
+     * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+     */
+    createOneTimePurchaseOrder: (args_0: {
+        productId: string;
+    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    /**
+     * @public
+     * @category 인앱결제
+     * @name iapGetProductItemList
+     * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
+     * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
+     */
+    getProductItemList: () => Promise<{
+        products: IapProductListItem[];
+    }>;
+};
+
+declare function getSafeAreaInsets(): {
+    top: number;
+    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: LoadAdMobInterstitialAdEvent) => 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} title="광고 보기" />
+     *   );
+     * }
+     * ```
+     */
+    showAdMobInterstitialAd: ((args: {
+        onEvent: (data: ShowAdMobInterstitialAdEvent) => 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: LoadAdMobRewardedAdEvent) => 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} title="광고 보기" />
+     *   );
+     * }
+     * ```
+     */
+    showAdMobRewardedAd: ((args: {
+        onEvent: (data: ShowAdMobRewardedAdEvent) => void;
+        onError: (error: Error) => void;
+        options?: ShowAdMobRewardedAdOptions | undefined;
+    }) => () => void) & {
+        isSupported: () => boolean;
+    };
+};
+
+type GraniteEvent = {
+    backEvent: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options?: void;
+    };
+};
+declare const graniteEvent: {
+    addEventListener: <K extends keyof GraniteEvent>(event: K, { onEvent, onError, options, }: {
+        onEvent: GraniteEvent[K]["onEvent"];
+        onError?: GraniteEvent[K]["onError"];
+        options?: GraniteEvent[K]["options"];
+    }) => () => void;
+};
+
+/**
+ * @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"];
+        options?: AppsInTossEvent[K]["options"];
+    }) => () => void;
+};
+
+declare const env: {
+    getDeploymentId: () => string;
+};
+
+interface AppsInTossGlobals {
+    deploymentId: string;
+    brandDisplayName: string;
+    brandIcon: string;
+    brandPrimaryColor: string;
+    brandBridgeColorMode: 'basic' | 'inverted';
+}
+declare const getAppsInTossGlobals: () => AppsInTossGlobals;
+
+type TdsEvent = {
+    navigationAccessoryEvent: {
+        onEvent: (data: {
+            id: string;
+        }) => void;
+        onError?: (error: Error) => void;
+        options: undefined;
+    };
+};
+/**
+ * @public
+ * @category TDS
+ * @name tdsEvent
+ * @description 토스 이벤트를 사용해요.
+ * @property {typeof addEventListener} [addEventListener] 이벤트를 추가해요.
+ */
+declare const tdsEvent: {
+    /**
+     * @public
+     * @category TDS
+     * @name addEventListener
+     * @description 이벤트를 추가해요.
+     * @param {string} event 이벤트 이름예요.
+     * @param {TdsEvent[K]['onEvent']} onEvent 이벤트 핸들러예요.
+     * @param {TdsEvent[K]['onError']} onError 이벤트 에러 핸들러예요.
+     * @param {TdsEvent[K]['options']} options 이벤트 옵션예요.
+     * @returns {void} 이벤트를 추가했을 때 아무 값도 반환하지 않아요.
+     * @example
+     * ### 네비게이션 악세서리 이벤트 추가하기
+     * ```tsx
+     * import { tdsEvent } from '@apps-in-toss/framework';
+     *
+     * tdsEvent.addEventListener('navigationAccessoryEvent', {
+     *   onEvent: ({ id }) => {
+     *     if(id === 'heart') {
+     *       router.push('/heart');
+     *     }
+     *   },
+     * });
+     * ```
+     */
+    addEventListener: <K extends keyof TdsEvent>(event: K, { onEvent, onError, options, }: {
+        onEvent: TdsEvent[K]["onEvent"];
+        onError?: TdsEvent[K]["onError"];
+        options?: TdsEvent[K]["options"];
+    }) => () => void;
+};
+
+type AddAccessoryButtonOptions = {
+    id: string;
+    type: 'icon';
+    name: string;
+    alt: string;
+} | {
+    type: 'icon-double';
+    color?: string;
+    leftIconName: string;
+    leftIconAlt: string;
+    rightIconName: string;
+    rightIconAlt: string;
+    id: [string, string];
+};
+/**
+ * @public
+ * @category 파트너
+ * @name partner
+ * @description 파트너 기능을 사용해요.
+ * @property {typeof addAccessoryButton} [addAccessoryButton] 상단 네비게이션의 악세서리 버튼을 추가해요.
+ */
+declare const partner: {
+    /**
+     * @public
+     * @category 파트너
+     * @name addAccessoryButton
+     * @description 상단 네비게이션의 악세서리 버튼을 추가해요. callback에 대한 정의는 `tdsEvent.addEventListener("navigationAccessoryEvent", callback)`를 참고해주세요.
+     * @param {AddAccessoryButtonOptions} options - 악세서리 버튼의 고유 ID예요.
+     * @returns {void} 악세서리 버튼을 추가했을 때 아무 값도 반환하지 않아요.
+     * @example
+     * ```tsx
+     * import { partner } from '@apps-in-toss/framework';
+     *
+     * partner.addAccessoryButton({
+     *   id: 'heart',
+     *   type: 'icon',
+     *   name: 'icon-heart-mono',
+     *   alt: '하트',
+     * });
+     *
+     * partner.addAccessoryButton({
+     *   id: ['heart', 'heart2'],
+     *   type: 'icon-double',
+     *   leftIconName: 'icon-heart-mono',
+     *   leftIconAlt: '하트',
+     *   rightIconName: 'icon-heart-mono',
+     *   rightIconAlt: '하트',
+     * });
+     * ```
+     */
+    addAccessoryButton: (args_0: AddAccessoryButtonOptions) => Promise<void>;
+    /**
+     * @public
+     * @category 파트너
+     * @name removeAccessoryButton
+     * @description 상단 네비게이션의 악세서리 버튼을 제거해요.
+     * @returns {void} 악세서리 버튼을 제거했을 때 아무 값도 반환하지 않아요.
+     * @example
+     * ```tsx
+     * import { partner } from '@apps-in-toss/framework';
+     *
+     * partner.removeAccessoryButton();
+     * ```
+     */
+    removeAccessoryButton: () => Promise<void>;
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, getAppsInTossGlobals, getSafeAreaInsets, graniteEvent, isMinVersionSupported, partner, tdsEvent };