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

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,86 @@
+/* eslint-disable import/order */
+
+// AdMob
+import {
+  loadAdMobInterstitialAd,
+  loadAdMobRewardedAd,
+  showAdMobInterstitialAd,
+  showAdMobRewardedAd,
+  type LoadAdMobInterstitialAdEvent,
+  type LoadAdMobInterstitialAdOptions,
+  type LoadAdMobRewardedAdEvent,
+  type LoadAdMobRewardedAdOptions,
+  type ShowAdMobInterstitialAdEvent,
+  type ShowAdMobInterstitialAdOptions,
+  type ShowAdMobRewardedAdEvent,
+  type ShowAdMobRewardedAdOptions,
+} from './ads/googleAdMob';
+
+// 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,
+};
+
+/**
+ * @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)를 참고하세요.
+ */
+export const GoogleAdMob = {
+  loadAdMobInterstitialAd,
+  showAdMobInterstitialAd,
+  loadAdMobRewardedAd,
+  showAdMobRewardedAd,
+};

package/src/AppsInTossModule/native-modules/isMinVersionSupported.spec.ts

@@ -0,0 +1,190 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+describe('isMinVersionSupported per-test mocks with dynamic import', () => {
+  beforeEach(() => {
+    // 각 테스트 전 모듈 캐시 초기화
+    vi.resetModules();
+  });
+
+  it('iOS 환경 테스트: 현재 버전이 최소 버전보다 낮을 때', async () => {
+    // doMock을 사용하여 모킹이 해당 테스트에 국한되도록 함
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'ios' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: '1.0.0',
+      ios: '2.0.0',
+    });
+    expect(result).toBe(false);
+  });
+
+  it('Android 환경 테스트: 현재 버전이 최소 버전보다 높을 때', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '3.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'android' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: '2.0.0',
+      ios: '1.0.0',
+    });
+    expect(result).toBe(true);
+  });
+
+  it('iOS 환경 테스트: 현재 버전이 최소 버전과 같을 때', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '2.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'ios' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: '1.0.0',
+      ios: '2.0.0',
+    });
+    expect(result).toBe(true);
+  });
+
+  it('iOS 환경 테스트: minVersion이 "always"일 때', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'ios' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: '1.0.0',
+      ios: 'always',
+    });
+    expect(result).toBe(true);
+  });
+
+  it('Android 환경 테스트: minVersion이 "always"일 때', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'android' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: 'always',
+      ios: '1.0.0',
+    });
+    expect(result).toBe(true);
+  });
+
+  it('iOS 환경 테스트: minVersion이 "never"일 때', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'ios' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: '1.0.0',
+      ios: 'never',
+    });
+    expect(result).toBe(false);
+  });
+
+  it('Android 환경 테스트: minVersion이 "never"일 때', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'android' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: 'never',
+      ios: '1.0.0',
+    });
+    expect(result).toBe(false);
+  });
+
+  it('minVersion이 없을 때 false를 반환', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'toss',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'ios' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-expect-error: ios 값 누락 의도
+    const result = isMinVersionSupported({
+      android: '1.0.0',
+    });
+    expect(result).toBe(false);
+  });
+
+  it('sandbox 환경 테스트: 버전에 상관없이 항상 true를 반환', async () => {
+    vi.doMock('./AppsInTossModule.js', () => ({
+      AppsInTossModule: {
+        tossAppVersion: '1.0.0',
+        operationalEnvironment: 'sandbox',
+      },
+    }));
+
+    vi.doMock('react-native', () => ({
+      Platform: { OS: 'ios' },
+    }));
+
+    const { isMinVersionSupported } = await import('./isMinVersionSupported.js');
+    const result = isMinVersionSupported({
+      android: '5.0.0',
+      ios: '5.0.0',
+    });
+    expect(result).toBe(true);
+  });
+});

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

@@ -0,0 +1,68 @@
+import { Platform } from 'react-native';
+import { AppsInTossModule } from './AppsInTossModule';
+import { compareVersions } from '../../utils/compareVersion';
+
+/**
+ * @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>
+ *   );
+ * }
+ * ```
+ */
+export function isMinVersionSupported(minVersions: {
+  android: `${number}.${number}.${number}` | 'always' | 'never';
+  ios: `${number}.${number}.${number}` | 'always' | 'never';
+}): boolean {
+  const operationalEnvironment = AppsInTossModule.operationalEnvironment;
+  if (operationalEnvironment === 'sandbox') {
+    return true;
+  }
+
+  const currentVersion = AppsInTossModule.tossAppVersion;
+  const isIOS = Platform.OS === 'ios';
+  const minVersion = isIOS ? minVersions.ios : minVersions.android;
+
+  if (minVersion === undefined) {
+    return false;
+  }
+
+  if (minVersion === 'always') {
+    return true;
+  }
+  if (minVersion === 'never') {
+    return false;
+  }
+
+  return compareVersions(currentVersion, minVersion) >= 0;
+}

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

@@ -0,0 +1,81 @@
+import { AppsInTossModule } from './AppsInTossModule';
+import { requestPermission } from './requestPermission';
+import type { ImageResponse } from '../../types';
+
+export interface OpenCameraOptions {
+  /**
+   * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
+   *
+   * 기본값: `false`.
+   */
+  base64?: boolean;
+  /**
+   * 이미지의 최대 너비를 나타내는 숫자 값이에요.
+   *
+   * 기본값: `1024`.
+   */
+  maxWidth?: number;
+}
+
+/**
+ * @public
+ * @category 카메라
+ * @name openCamera
+ * @description 카메라를 실행해서 촬영된 이미지를 반환하는 함수예요.
+ * @param {OpenCameraOptions} options - 카메라 실행 시 사용되는 옵션 객체예요.
+ * @param {boolean} [options.base64=false] - 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요. 기본값은 `false`예요. `true`로 설정하면 `dataUri` 대신 Base64 인코딩된 문자열을 반환해요.
+ * @param {number} [options.maxWidth=1024] - 이미지의 최대 너비를 나타내는 숫자 값이에요. 기본값은 `1024`예요.
+ * @returns {Promise<ImageResponse>}
+ * 촬영된 이미지 정보를 포함한 객체를 반환해요. 반환 객체의 구성은 다음과 같아요:
+ * - `id`: 이미지의 고유 식별자예요.
+ * - `dataUri`: 이미지 데이터를 표현하는 데이터 URI예요.
+ *
+ * @example
+ * ### 카메라 실행 후 촬영된 사진 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * import { View, Text, Button, Image } from 'react-native';
+ * import { openCamera } from '@apps-in-toss/framework';
+ *
+ * const base64 = true;
+ *
+ * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
+ * function Camera() {
+ *   const [image, setImage] = useState(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await openCamera({ base64 });
+ *       setImage(response);
+ *     } catch (error) {
+ *       console.error('사진을 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   // base64 형식으로 반환된 이미지를 표시하려면 데이터 URL 스키마 Prefix를 붙여야해요.
+ *   const imageUri = base64 ? 'data:image/jpeg;base64,' + image.dataUri : image.dataUri;
+ *
+ *   return (
+ *     <View>
+ *       {image ? (
+ *         <Image source={{ uri: imageUri }} style={{ width: 200, height: 200 }} />
+ *       ) : (
+ *         <Text>사진이 없어요</Text>
+ *       )}
+ *       <Button title="사진 촬영하기" onPress={handlePress} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export async function openCamera(options?: OpenCameraOptions): Promise<ImageResponse> {
+  const permissionStatus = await requestPermission({ name: 'camera', access: 'access' });
+  if (permissionStatus === 'denied') {
+    throw new Error('카메라 권한이 거부되었어요.');
+  }
+
+  const photo = await AppsInTossModule.openCamera({ base64: false, maxWidth: 1024, ...options });
+
+  return photo;
+}

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

@@ -0,0 +1,44 @@
+import { openURL } from '@granite-js/react-native';
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { GAME_CENTER_MIN_VERSION } from '../constants';
+
+/**
+ * @public
+ * @category 게임센터
+ * @name openGameCenterLeaderboard
+ * @description 게임센터 리더보드 웹뷰를 열어요.
+ * 앱 버전이 최소 지원 버전(`5.221.0`)보다 낮으면 아무 동작도 하지 않고 `undefined`를 반환해요.
+ * 게임센터를 사용하는 사용자는 반드시 최소 지원 버전 이상이어야 게임을 실행할 수 있어요.
+ * @returns 리더보드 웹뷰를 호출해요. 앱 버전이 낮으면 아무 동작도 하지 않고 `undefined`를 반환해요.
+ *
+ * @example
+ * import { Button } from 'react-native';
+ * import { openGameCenterLeaderboard } from '@apps-in-toss/framework';
+ *
+ * // '리더보드' 버튼을 누르면 게임센터 리더보드 웹뷰가 열려요.
+ * function LeaderboardButton() {
+ *   const onPress = () => {
+ *     openGameCenterLeaderboard();
+ *   };
+ *
+ *   return <Button title="리더보드 웹뷰 호출" onPress={onPress} />;
+ * }
+ */
+export async function openGameCenterLeaderboard(): Promise<void> {
+  if (!isMinVersionSupported(GAME_CENTER_MIN_VERSION)) {
+    return;
+  }
+
+  const appName = global.__granite?.app?.name;
+
+  if (appName == null) {
+    throw new Error('Cannot get app name');
+  }
+
+  const url = new URL('servicetoss://game-center/leaderboard?_navbar=hide');
+  url.searchParams.set('appName', appName);
+  url.searchParams.set('referrer', `appsintoss.${appName}`);
+  return openURL(url.toString());
+}
+
+declare const global: { __granite: any };