@apps-in-toss/native-modules 0.0.0-dev.1752115036458 → 0.0.0-dev.1757056983098

package/src/AppsInTossModule/native-modules/getDeviceId.ts

@@ -0,0 +1,33 @@
+import { AppsInTossModule } from './AppsInTossModule';
+
+/**
+ * @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>
+ *   );
+ * }
+ * ```
+ */
+export function getDeviceId(): string {
+  return AppsInTossModule.deviceId;
+}

package/src/AppsInTossModule/native-modules/getGameCenterGameProfile.ts

@@ -0,0 +1,68 @@
+import { AppsInTossModule } from './AppsInTossModule';
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { GAME_CENTER_MIN_VERSION } from '../constants';
+
+/**
+ * @category 게임센터
+ * @name GameCenterGameProfileResponse
+ * @description 토스게임센터 프로필을 가져온 결과 타입이에요.
+ * 앱에 프로필이 없는 경우, `statusCode`가 `'PROFILE_NOT_FOUND'`이고 다른 정보는 없어요.
+ * 프로필이 있는 경우 `statusCode`가 `'SUCCESS'`이고, 닉네임과 프로필 이미지 주소가 함께 제공돼요.
+ * @property {string} statusCode 프로필 조회 결과 상태예요. `'SUCCESS'` 또는 `'PROFILE_NOT_FOUND'` 중 하나예요.
+ * @property {string} [nickname] 프로필 닉네임이에요. `statusCode`가 `'SUCCESS'`일 때만 있어요.
+ * @property {string} [profileImageUri] 프로필 이미지 URL이에요. `statusCode`가 `'SUCCESS'`일 때만 있어요.
+ */
+export type GameCenterGameProfileResponse =
+  | { statusCode: 'PROFILE_NOT_FOUND' }
+  | {
+      statusCode: 'SUCCESS';
+      nickname: string;
+      profileImageUri: string;
+    };
+
+/**
+ * @category 게임센터
+ * @name getGameCenterGameProfile
+ * @description 토스게임센터 프로필 정보를 가져와요.
+ * 사용자가 프로필을 만들지 않았다면 `statusCode`가 `'PROFILE_NOT_FOUND'`인 응답이 반환돼요.
+ * 앱 버전이 최소 지원 버전(안드로이드 5.221.0, iOS 5.221.0)보다 낮으면 `undefined`를 반환해요.
+ * @returns {Promise<GameCenterGameProfileResponse | undefined>} 프로필 정보 또는 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 게임센터 프로필 가져오기
+ * ```tsx
+ * import { getGameCenterGameProfile } from './getGameCenterGameProfile';
+ * import { useState } from 'react';
+ * import { View, Button } from 'react-native';
+ *
+ * function GameProfile() {
+ *   const [profile, setProfile] = useState<GameCenterGameProfileResponse | null>(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const result = await getGameCenterGameProfile();
+ *       if (result) {
+ *         setProfile(result);
+ *       }
+ *     } catch (error) {
+ *       console.error('게임센터 프로필 가져오기에 실패했어요.', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       <Button title="게임센터 프로필 가져오기" onPress={handlePress} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export async function getGameCenterGameProfile() {
+  const isSupported = isMinVersionSupported(GAME_CENTER_MIN_VERSION);
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.getGameCenterGameProfile({});
+}

package/src/AppsInTossModule/native-modules/getOperationalEnvironment.ts

@@ -0,0 +1,37 @@
+import { AppsInTossModule } from './AppsInTossModule';
+
+/**
+ * @public
+ * @category 환경 확인
+ * @kind function
+ * @name getOperationalEnvironment
+ * @description
+ * 현재 실행 중인 앱의 운영 환경을 확인해요.
+ * 토스 앱에서 실행 중이라면 `'toss'`, 샌드박스 환경에서 실행 중이라면 `'sandbox'`를 반환해요.
+ *
+ * 운영 환경은 앱이 실행되는 컨텍스트를 의미하며, 특정 기능의 사용 가능 여부를 판단하는 데 활용할 수 있어요.
+ *
+ * @returns {'toss' | 'sandbox'}
+ * 현재 운영 환경을 나타내는 문자열이에요.
+ * - `'toss'`: 토스 앱에서 실행 중이에요.
+ * - `'sandbox'`: 샌드박스 환경에서 실행 중이에요.
+ *
+ * @example
+ * ### 현재 운영 환경 확인하기
+ *
+ * ```tsx
+ * import { getOperationalEnvironment } from '@apps-in-toss/framework';
+ * import { Text } from 'react-native';
+ *
+ * function EnvironmentInfo() {
+ *   const environment = getOperationalEnvironment();
+ *
+ *   return (
+ *     <Text>현재 운영 환경: {environment}</Text>
+ *   );
+ * }
+ * ```
+ */
+export function getOperationalEnvironment(): 'toss' | 'sandbox' {
+  return AppsInTossModule.operationalEnvironment;
+}

package/src/AppsInTossModule/native-modules/getPermission.ts

@@ -0,0 +1,58 @@
+import { AppsInTossModule } from './AppsInTossModule';
+import { PermissionAccess, PermissionName, PermissionStatus } from '../../types';
+
+/**
+ * @category AppsInTossModules
+ * @name getPermission
+ * @description 특정 권한의 현재 상태를 확인하는 함수예요. 사용자가 권한을 허용했는지, 거부했는지, 또는 아직 선택하지 않았는지를 알 수 있어요.
+ * @param permission.name {PermissionName} 요청할 권한의 이름이에요. 예를 들어 `clipboard`는 클립보드 접근 권한을, `camera`는 카메라 접근 권한을 나타내요.
+ * @param permission.access {PermissionAccess} 요청할 권한의 접근 유형이에요. 예를 들어 `read`는 읽기 권한, `write`는 쓰기 권한을 의미해요.
+ * @returns {Promise<'allowed' | 'denied' | 'notDetermined'>} 권한의 현재 상태를 반환해요. 반환값은 다음 중 하나예요:
+ * - `allowed`: 권한이 허용된 상태예요.
+ * - `denied`: 권한이 거부된 상태예요.
+ * - `notDetermined`: 아직 권한 요청에 대한 결정이 이루어지지 않은 상태예요.
+ *
+ * @example
+ * ### 클립보드 읽기 권한 상태 확인하기
+ *
+ * ```tsx
+ * import React, { useEffect, useState } from 'react';
+ * import { View, Text } from 'react-native';
+ * import { getPermission, type PermissionStatus } from '@apps-in-toss/framework';
+ *
+ * function PermissionCheck() {
+ *   const [permission, setPermission] = useState<PermissionStatus | null>(null);
+ *
+ *   useEffect(() => {
+ *     async function checkPermission() {
+ *       try {
+ *         // 'clipboard'는 권한 이름, 'read'는 접근 유형을 나타내요.
+ *         const status = await getPermission({
+ *           name: 'clipboard', // 클립보드 접근 권한
+ *           access: 'read', // 읽기 권한 요청
+ *         });
+ *         setPermission(status); // 권한 상태를 업데이트해요.
+ *       } catch (error) {
+ *         console.error('권한 상태를 확인하지 못했어요:', error);
+ *       }
+ *     }
+ *
+ *     checkPermission();
+ *   }, []);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         클립보드 읽기 권한 상태: {permission ? permission : '확인 중...'}
+ *       </Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function getPermission(permission: {
+  name: PermissionName;
+  access: PermissionAccess;
+}): Promise<PermissionStatus> {
+  return AppsInTossModule.getPermission(permission);
+}

package/src/AppsInTossModule/native-modules/getTossAppVersion.ts

@@ -0,0 +1,33 @@
+import { AppsInTossModule } from './AppsInTossModule';
+
+/**
+ * @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>
+ *  )
+ * }
+ * ```
+ */
+export function getTossAppVersion() {
+  return AppsInTossModule.tossAppVersion;
+}

package/src/AppsInTossModule/native-modules/getTossShareLink.ts

@@ -0,0 +1,39 @@
+import { AppsInTossModule } from './AppsInTossModule';
+
+/**
+ * @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 '@granite-js/react-native';
+ * import { getTossShareLink } from '@apps-in-toss/framework';
+ *
+ * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
+ * const tossLink = await getTossShareLink('intoss://my-app');
+ *
+ * // 생성한 링크를 메시지로 공유해요.
+ * await share({ message: tossLink });
+ * ```
+ */
+export async function getTossShareLink(path: string): Promise<string> {
+  const { shareLink } = await AppsInTossModule.getTossShareLink({});
+  const shareUrl = new URL(shareLink);
+
+  shareUrl.searchParams.set('deep_link_value', path);
+  shareUrl.searchParams.set('af_dp', path);
+  return shareUrl.toString();
+}

package/src/AppsInTossModule/native-modules/iap.ts

@@ -0,0 +1,213 @@
+import { AppsInTossModule } from './AppsInTossModule';
+import { isMinVersionSupported } from './isMinVersionSupported';
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
+ * @property {string} productId - 주문할 상품의 ID예요.
+ */
+export interface IapCreateOneTimePurchaseOrderOptions {
+  productId: string;
+}
+
+/**
+ * @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`로 반환돼요.
+ */
+export interface IapCreateOneTimePurchaseOrderResult {
+  orderId: string;
+  displayName: string;
+  displayAmount: string;
+  amount: number;
+  currency: string;
+  fraction: number;
+  miniAppIconUrl: string | null;
+}
+
+/**
+ * @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"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ *
+ * @example
+ * ### 특정 인앱결제 주문서 페이지로 이동하기
+ *
+ * ```tsx
+ * import { IAP } from "@apps-in-toss/web-framework";
+ * import { Button } from "@toss-design-system/react-native";
+ *
+ * interface Props {
+ *   productId: string;
+ * }
+ *
+ * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
+ *   async function handleClick() {
+ *     try {
+ *       await IAP.createOneTimePurchaseOrder({
+ *         productId,
+ *       });
+ *       console.error("인앱결제에 성공했어요");
+ *     } catch (error) {
+ *       console.error('인앱결제에 실패했어요:', error);
+ *     }
+ *   }
+ *
+ *   return <Button onClick={handleClick}>구매하기</Button>;
+ * }
+ * ```
+ */
+async function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions) {
+  const isSupported = isMinVersionSupported({
+    android: '5.219.0',
+    ios: '5.219.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapProductListItem
+ * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
+ * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/native-modules/%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 - 상품에 대한 설명이에요. 설명은 앱인토스 콘솔에서 설정한 값이에요.
+ */
+export interface IapProductListItem {
+  sku: string;
+  displayAmount: string;
+  displayName: string;
+  iconUrl: string;
+  description: string;
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name iapGetProductItemList
+ * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
+ * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 구매 가능한 인앱결제 상품목록 가져오기
+ *
+ * ```tsx
+ * import { IAP, IapProductListItem } from "@apps-in-toss/framework";
+ * import { Button, List, ListRow } from "@toss-design-system/react-native";
+ * import { useEffect, useState } from "react";
+ *
+ * function IapProductList() {
+ *   const [products, setProducts] = useState<IapProductListItem[]>([]);
+ *
+ *   async function buyIapProduct(productId: string) {
+ *     try {
+ *       await IAP.createOneTimePurchaseOrder({
+ *         productId,
+ *       });
+ *
+ *       console.error("인앱결제에 성공했어요");
+ *     } catch (error) {
+ *       console.error("인앱결제에 실패했어요:", error);
+ *     }
+ *   }
+ *
+ *   useEffect(() => {
+ *     async function fetchProducts() {
+ *       try {
+ *         const response = await IAP.getProductItemList();
+ *         setProducts(response?.products ?? []);
+ *       } catch (error) {
+ *         console.error("상품 목록을 가져오는 데 실패했어요:", error);
+ *       }
+ *     }
+ *
+ *     fetchProducts();
+ *   }, []);
+ *
+ *   return (
+ *     <List>
+ *       {products.map((product) => (
+ *         <ListRow
+ *           key={product.sku}
+ *           left={
+ *             <ListRow.Image type="square" source={{ uri: product.iconUrl }} />
+ *           }
+ *           right={
+ *             <Button size="medium" onPress={() => buyIapProduct(product.sku)}>
+ *               구매하기
+ *             </Button>
+ *           }
+ *           contents={
+ *             <ListRow.Texts
+ *               type="3RowTypeA"
+ *               top={product.displayName}
+ *               middle={product.description}
+ *               bottom={product.displayAmount}
+ *             />
+ *           }
+ *         />
+ *       ))}
+ *     </List>
+ *   );
+ * }
+ * ```
+ */
+async function getProductItemList() {
+  const isSupported = isMinVersionSupported({
+    android: '5.219.0',
+    ios: '5.219.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.iapGetProductItemList({});
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name IAP
+ * @description 인앱결제 관련 기능을 모은 객체예요. 단건 인앱결제 주문서 이동과 상품 목록 조회 기능을 제공해요.
+ * @property {typeof createOneTimePurchaseOrder} [createOneTimePurchaseOrder] 특정 인앱결제 주문서 페이지로 이동해요. 자세한 내용은 [createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/native-modules/%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/native-modules/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html) 문서를 참고하세요.
+ */
+export const IAP = {
+  createOneTimePurchaseOrder,
+  getProductItemList,
+};

package/src/AppsInTossModule/native-modules/index.ts

@@ -0,0 +1,104 @@
+// AdMob (deprecated)
+import {
+  loadAdMobInterstitialAd,
+  loadAdMobRewardedAd,
+  showAdMobInterstitialAd,
+  showAdMobRewardedAd,
+  type LoadAdMobInterstitialAdEvent,
+  type LoadAdMobInterstitialAdOptions,
+  type LoadAdMobRewardedAdEvent,
+  type LoadAdMobRewardedAdOptions,
+  type ShowAdMobInterstitialAdEvent,
+  type ShowAdMobInterstitialAdOptions,
+  type ShowAdMobRewardedAdEvent,
+  type ShowAdMobRewardedAdOptions,
+} from './ads/googleAdMob';
+// AdMob V2
+import {
+  loadAppsInTossAdMob,
+  showAppsInTossAdMob,
+  type LoadAdMobParams,
+  type LoadAdMobOptions,
+  type LoadAdMobEvent,
+  type ShowAdMobParams,
+  type ShowAdMobEvent,
+  type ShowAdMobOptions,
+} from './ads/googleAdMobV2';
+// TossPay
+import { checkoutPayment, type CheckoutPaymentOptions, type CheckoutPaymentResult } from './checkoutPayment';
+
+export { AppsInTossModuleInstance as INTERNAL__AppsInTossModule } from './AppsInTossModule';
+export { AppsInTossModule } from './AppsInTossModule';
+
+export * from './appLogin';
+export * from './eventLog';
+export * from './fetchAlbumPhotos';
+export * from './fetchContacts';
+export * from './getClipboardText';
+export * from './getCurrentLocation';
+export * from './getDeviceId';
+export * from './getOperationalEnvironment';
+export * from './getTossAppVersion';
+export * from './getTossShareLink';
+export * from './iap';
+export * from './isMinVersionSupported';
+export * from './openCamera';
+export * from './saveBase64Data';
+export * from './setClipboardText';
+export * from './setDeviceOrientation';
+export * from './storage';
+export * from './openGameCenterLeaderboard';
+export * from './getGameCenterGameProfile';
+export * from './submitGameCenterLeaderBoardScore';
+export * from '../native-event-emitter/contactsViral';
+
+export type {
+  LoadAdMobInterstitialAdEvent,
+  LoadAdMobInterstitialAdOptions,
+  LoadAdMobRewardedAdEvent,
+  LoadAdMobRewardedAdOptions,
+  ShowAdMobInterstitialAdEvent,
+  ShowAdMobInterstitialAdOptions,
+  ShowAdMobRewardedAdEvent,
+  CheckoutPaymentOptions,
+  CheckoutPaymentResult,
+  ShowAdMobRewardedAdOptions,
+  LoadAdMobParams,
+  LoadAdMobOptions,
+  LoadAdMobEvent,
+  ShowAdMobParams,
+  ShowAdMobEvent,
+  ShowAdMobOptions,
+};
+
+/**
+ * @public
+ * @category 토스페이
+ * @name TossPay
+ * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
+ * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/native-modules/토스페이/checkoutPayment)를 참고하세요.
+ */
+export const TossPay = {
+  checkoutPayment,
+};
+
+/**
+ * @public
+ * @category 광고
+ * @name GoogleAdMob
+ * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
+ * @property {typeof loadAdMobInterstitialAd} [loadAdMobInterstitialAd] 전면 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobInterstitialAd](/react-native/reference/native-modules/광고/loadAdMobInterstitialAd.html)를 참고하세요.
+ * @property {typeof showAdMobInterstitialAd} [showAdMobInterstitialAd] 로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobInterstitialAd](/react-native/reference/native-modules/광고/showAdMobInterstitialAd.html)를 참고하세요.
+ * @property {typeof loadAdMobRewardedAd} [loadAdMobRewardedAd] 보상형 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobRewardedAd](/react-native/reference/native-modules/광고/loadAdMobRewardedAd.html)를 참고하세요.
+ * @property {typeof showAdMobRewardedAd} [showAdMobRewardedAd] 로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobRewardedAd](/react-native/reference/native-modules/광고/showAdMobRewardedAd.html)를 참고하세요.
+ * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요. 자세한 내용은 [loadAppsInTossAdMob](/react-native/reference/native-modules/광고/loadAppsInTossAdMob.html)를 참고하세요.
+ * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요. 자세한 내용은 [showAppsInTossAdMob](/react-native/reference/native-modules/광고/showAppsInTossAdMob.html)를 참고하세요.
+ */
+export const GoogleAdMob = {
+  loadAdMobInterstitialAd,
+  showAdMobInterstitialAd,
+  loadAdMobRewardedAd,
+  showAdMobRewardedAd,
+  loadAppsInTossAdMob,
+  showAppsInTossAdMob,
+};