@apps-in-toss/native-modules 1.2.1 → 1.3.0

package/dist/bridges-meta.json

@@ -91,6 +91,10 @@
     "identifier": "saveBase64Data",
     "dts": "export interface SaveBase64DataParams {\n\tdata: string;\n\tfileName: string;\n\tmimeType: string;\n}\n/**\n * @public\n * @category 데이터\n * @name saveBase64Data\n * @description 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요. 이미지, 텍스트, PDF 등 다양한 형식의 데이터를 저장할 수 있어요.\n * @param {SaveBase64DataParams} params - 저장할 데이터와 파일 정보를 담은 객체예요.\n * @param {string} params.data - Base64 형식으로 인코딩된 데이터 문자열이에요.\n * @param {string} params.fileName - 저장할 파일 이름이에요. 확장자도 같이 붙여줘야해요. 예를 들어, 'example.png'로 저장할 수 있어요.\n * @param {string} params.mimeType - 저장할 파일의 MIME 타입이에요. 예를 들어 'image/png' 로 지정하면 이미지, 'application/pdf'는 PDF 파일이에요. 자세한 내용은 [MIME 문서](https://developer.mozilla.org/ko/docs/Web/HTTP/Guides/MIME_types)를 참고해주세요.\n *\n * @example\n * ### Base64 이미지 데이터를 사용자 기기에 저장하기\n *\n * ```tsx\n * import { Button } from 'react-native';\n * import { saveBase64Data } from '@apps-in-toss/framework';\n *\n * // '저장' 버튼을 누르면 이미지가 사용자 기기에 저장돼요.\n * function SaveButton() {\n *   const handleSave = async () => {\n *     try {\n *       await saveBase64Data({\n *         data: 'iVBORw0KGgo...',\n *         fileName: 'some-photo.png',\n *         mimeType: 'image/png',\n *       });\n *     } catch (error) {\n *       console.error('데이터 저장에 실패했어요:', error);\n *     }\n *   };\n *\n *   return <Button title=\"저장\" onPress={handleSave} />;\n * }\n * ```\n */\nexport declare function saveBase64Data(params: SaveBase64DataParams): Promise<void>;\n\nexport {};\n"
   },
+  {
+    "identifier": "appsInTossSignTossCert",
+    "dts": "export interface AppsInTossSignTossCertParams {\n\ttxId: string;\n}\n/**\n * @public\n * @category 토스인증\n * @name appsInTossSignTossCert\n * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.\n *\n * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.\n * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.\n *\n * @example\n * ```tsx\n * import { appsInTossSignTossCert } from '@apps-in-toss/framework';\n *\n *  // 서명에 필요한 파라미터를 정의해요.\n *  const params = {\n *    txId: \"f2e1a6df...\"\n *  };\n *\n * appsInTossSignTossCert(params)\n *   .then(() => {\n *     console.log('서명 작업이 성공적으로 완료되었어요.');\n *   })\n *   .catch((error) => {\n *     console.error('서명 작업 중 에러가 발생했어요:', error);\n *   });\n * ```\n */\nexport declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;\n\nexport {};\n"
+  },
   {
     "identifier": "getGameCenterGameProfile",
     "dts": "/**\n * @category 게임센터\n * @name GameCenterGameProfileResponse\n * @description 토스게임센터 프로필을 가져온 결과 타입이에요.\n * 앱에 프로필이 없는 경우, `statusCode`가 `'PROFILE_NOT_FOUND'`이고 다른 정보는 없어요.\n * 프로필이 있는 경우 `statusCode`가 `'SUCCESS'`이고, 닉네임과 프로필 이미지 주소가 함께 제공돼요.\n * @property {string} statusCode 프로필 조회 결과 상태예요. `'SUCCESS'` 또는 `'PROFILE_NOT_FOUND'` 중 하나예요.\n * @property {string} [nickname] 프로필 닉네임이에요. `statusCode`가 `'SUCCESS'`일 때만 있어요.\n * @property {string} [profileImageUri] 프로필 이미지 URL이에요. `statusCode`가 `'SUCCESS'`일 때만 있어요.\n */\nexport type GameCenterGameProfileResponse = {\n\tstatusCode: \"PROFILE_NOT_FOUND\";\n} | {\n\tstatusCode: \"SUCCESS\";\n\tnickname: string;\n\tprofileImageUri: string;\n};\n/**\n * @category 게임센터\n * @name getGameCenterGameProfile\n * @description 토스게임센터 프로필 정보를 가져와요.\n * 사용자가 프로필을 만들지 않았다면 `statusCode`가 `'PROFILE_NOT_FOUND'`인 응답이 반환돼요.\n * 앱 버전이 최소 지원 버전(안드로이드 5.221.0, iOS 5.221.0)보다 낮으면 `undefined`를 반환해요.\n * @returns {Promise<GameCenterGameProfileResponse | undefined>} 프로필 정보 또는 `undefined`를 반환해요.\n *\n * @example\n * ### 게임센터 프로필 가져오기\n * ```tsx\n * import { getGameCenterGameProfile } from './getGameCenterGameProfile';\n * import { useState } from 'react';\n * import { View, Button } from 'react-native';\n *\n * function GameProfile() {\n *   const [profile, setProfile] = useState<GameCenterGameProfileResponse | null>(null);\n *\n *   const handlePress = async () => {\n *     try {\n *       const result = await getGameCenterGameProfile();\n *       if (result) {\n *         setProfile(result);\n *       }\n *     } catch (error) {\n *       console.error('게임센터 프로필 가져오기에 실패했어요.', error);\n *     }\n *   };\n *\n *   return (\n *     <View>\n *       <Button title=\"게임센터 프로필 가져오기\" onPress={handlePress} />\n *     </View>\n *   );\n * }\n * ```\n */\nexport declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;\n\nexport {};\n"

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(index_exports, {
   TossPay: () => TossPay,
   appLogin: () => appLogin,
   appsInTossEvent: () => appsInTossEvent,
+  appsInTossSignTossCert: () => appsInTossSignTossCert,
   closeView: () => closeView,
   contactsViral: () => contactsViral,
   eventLog: () => eventLog,
@@ -839,11 +840,22 @@ async function getCompletedOrRefundedOrders(params) {
   }
   return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
 }
+async function completeProductGrant(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.233.0",
+    ios: "5.233.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.completeProductGrant(params);
+}
 var IAP = {
   createOneTimePurchaseOrder,
   getProductItemList,
   getPendingOrders,
-  getCompletedOrRefundedOrders
+  getCompletedOrRefundedOrders,
+  completeProductGrant
 };
 
 // src/AppsInTossModule/native-modules/saveBase64Data.ts
@@ -959,6 +971,19 @@ function contactsViral(params) {
   return unregisterCallbacks;
 }
 
+// src/AppsInTossModule/native-modules/appsInTossSignTossCert.ts
+async function appsInTossSignTossCert(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.233.0",
+    ios: "5.233.0"
+  });
+  if (!isSupported) {
+    console.warn("appsInTossSignTossCert is not supported in this app version");
+    return;
+  }
+  await AppsInTossModule.appsInTossSignTossCert({ params });
+}
+
 // src/AppsInTossModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -1100,6 +1125,7 @@ var INTERNAL__module = {
   TossPay,
   appLogin,
   appsInTossEvent,
+  appsInTossSignTossCert,
   closeView,
   contactsViral,
   eventLog,

package/dist/index.d.cts

@@ -1355,6 +1355,38 @@ interface CheckoutPaymentResult {
  */
 declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
 
+interface AppsInTossSignTossCertParams {
+    txId: string;
+}
+/**
+ * @public
+ * @category 토스인증
+ * @name appsInTossSignTossCert
+ * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.
+ *
+ * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.
+ * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.
+ *
+ * @example
+ * ```tsx
+ * import { appsInTossSignTossCert } from '@apps-in-toss/framework';
+ *
+ *  // 서명에 필요한 파라미터를 정의해요.
+ *  const params = {
+ *    txId: "f2e1a6df..."
+ *  };
+ *
+ * appsInTossSignTossCert(params)
+ *   .then(() => {
+ *     console.log('서명 작업이 성공적으로 완료되었어요.');
+ *   })
+ *   .catch((error) => {
+ *     console.error('서명 작업 중 에러가 발생했어요:', error);
+ *   });
+ * ```
+ */
+declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;
+
 /**
  * @category 게임센터
  * @name GameCenterGameProfileResponse
@@ -1707,19 +1739,51 @@ interface CompletedOrRefundedOrdersResult {
 declare function getCompletedOrRefundedOrders(params?: {
     key?: string | null;
 }): Promise<CompletedOrRefundedOrdersResult | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name completeProductGrant
+ * @description 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 이 함수를 사용하면 결제가 완료된 주문의 상품 지급이 정상적으로 완료되었음을 알릴 수 있어요.
+ * @param {{ params: { orderId: string } }} params 결제가 완료된 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요. 상품 지급을 완료할 주문을 지정할 때 사용해요.
+ * @returns {Promise<boolean>} 상품 지급이 완료됐는지 여부를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.233.0, iOS 5.233.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 결제를 성공한 뒤 상품을 지급하는 예시
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function handleGrantProduct(orderId: string) {
+ *   try {
+ *     await IAP.completeProductGrant({ params: { orderId } });
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function completeProductGrant(params: {
+    params: {
+        orderId: string;
+    };
+}): Promise<boolean | undefined>;
 /**
  * @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) 문서를 참고하세요.
+ * @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/createOneTimePurchaseOrder.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/getProductItemList.html) 문서를 참고하세요.
+ * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
+ * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
+ * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
  */
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
     getProductItemList: typeof getProductItemList;
     getPendingOrders: typeof getPendingOrders;
     getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
+    completeProductGrant: typeof completeProductGrant;
 };
 
 interface SaveBase64DataParams {
@@ -1910,11 +1974,20 @@ interface Spec extends TurboModule {
     getCompletedOrRefundedOrders: (params: {
         key?: string | null;
     }) => Promise<CompletedOrRefundedOrdersResult>;
+    completeProductGrant: (params: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<boolean>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
     }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;
     contactsViral: (params: ContactsViralParams) => () => void;
+    /** 토스인증 */
+    appsInTossSignTossCert: (params: {
+        params: AppsInTossSignTossCertParams;
+    }) => void;
 }
 declare const AppsInTossModuleInstance: any;
 declare const AppsInTossModule: Spec;
@@ -3328,4 +3401,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -1355,6 +1355,38 @@ interface CheckoutPaymentResult {
  */
 declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
 
+interface AppsInTossSignTossCertParams {
+    txId: string;
+}
+/**
+ * @public
+ * @category 토스인증
+ * @name appsInTossSignTossCert
+ * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.
+ *
+ * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.
+ * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.
+ *
+ * @example
+ * ```tsx
+ * import { appsInTossSignTossCert } from '@apps-in-toss/framework';
+ *
+ *  // 서명에 필요한 파라미터를 정의해요.
+ *  const params = {
+ *    txId: "f2e1a6df..."
+ *  };
+ *
+ * appsInTossSignTossCert(params)
+ *   .then(() => {
+ *     console.log('서명 작업이 성공적으로 완료되었어요.');
+ *   })
+ *   .catch((error) => {
+ *     console.error('서명 작업 중 에러가 발생했어요:', error);
+ *   });
+ * ```
+ */
+declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;
+
 /**
  * @category 게임센터
  * @name GameCenterGameProfileResponse
@@ -1707,19 +1739,51 @@ interface CompletedOrRefundedOrdersResult {
 declare function getCompletedOrRefundedOrders(params?: {
     key?: string | null;
 }): Promise<CompletedOrRefundedOrdersResult | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name completeProductGrant
+ * @description 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 이 함수를 사용하면 결제가 완료된 주문의 상품 지급이 정상적으로 완료되었음을 알릴 수 있어요.
+ * @param {{ params: { orderId: string } }} params 결제가 완료된 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요. 상품 지급을 완료할 주문을 지정할 때 사용해요.
+ * @returns {Promise<boolean>} 상품 지급이 완료됐는지 여부를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.233.0, iOS 5.233.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 결제를 성공한 뒤 상품을 지급하는 예시
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function handleGrantProduct(orderId: string) {
+ *   try {
+ *     await IAP.completeProductGrant({ params: { orderId } });
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function completeProductGrant(params: {
+    params: {
+        orderId: string;
+    };
+}): Promise<boolean | undefined>;
 /**
  * @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) 문서를 참고하세요.
+ * @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/createOneTimePurchaseOrder.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/getProductItemList.html) 문서를 참고하세요.
+ * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
+ * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
+ * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
  */
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
     getProductItemList: typeof getProductItemList;
     getPendingOrders: typeof getPendingOrders;
     getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
+    completeProductGrant: typeof completeProductGrant;
 };
 
 interface SaveBase64DataParams {
@@ -1910,11 +1974,20 @@ interface Spec extends TurboModule {
     getCompletedOrRefundedOrders: (params: {
         key?: string | null;
     }) => Promise<CompletedOrRefundedOrdersResult>;
+    completeProductGrant: (params: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<boolean>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
     }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;
     contactsViral: (params: ContactsViralParams) => () => void;
+    /** 토스인증 */
+    appsInTossSignTossCert: (params: {
+        params: AppsInTossSignTossCertParams;
+    }) => void;
 }
 declare const AppsInTossModuleInstance: any;
 declare const AppsInTossModule: Spec;
@@ -3328,4 +3401,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -767,11 +767,22 @@ async function getCompletedOrRefundedOrders(params) {
   }
   return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
 }
+async function completeProductGrant(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.233.0",
+    ios: "5.233.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.completeProductGrant(params);
+}
 var IAP = {
   createOneTimePurchaseOrder,
   getProductItemList,
   getPendingOrders,
-  getCompletedOrRefundedOrders
+  getCompletedOrRefundedOrders,
+  completeProductGrant
 };
 
 // src/AppsInTossModule/native-modules/saveBase64Data.ts
@@ -887,6 +898,19 @@ function contactsViral(params) {
   return unregisterCallbacks;
 }
 
+// src/AppsInTossModule/native-modules/appsInTossSignTossCert.ts
+async function appsInTossSignTossCert(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.233.0",
+    ios: "5.233.0"
+  });
+  if (!isSupported) {
+    console.warn("appsInTossSignTossCert is not supported in this app version");
+    return;
+  }
+  await AppsInTossModule.appsInTossSignTossCert({ params });
+}
+
 // src/AppsInTossModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -1027,6 +1051,7 @@ export {
   TossPay,
   appLogin,
   appsInTossEvent,
+  appsInTossSignTossCert,
   closeView,
   contactsViral,
   eventLog,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -30,8 +30,8 @@
   ],
   "devDependencies": {
     "@babel/runtime": "^7",
-    "@granite-js/native": "0.1.22",
-    "@granite-js/react-native": "0.1.22",
+    "@granite-js/native": "0.1.28",
+    "@granite-js/react-native": "0.1.28",
     "@types/react": "18.3.3",
     "dts-bundle-generator": "^9.5.1",
     "esbuild": "0.25.5",
@@ -43,7 +43,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "^1.2.1",
+    "@apps-in-toss/types": "^1.3.0",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "40254858b2f5f6d54bd7b228d0bc1dc96d3259aa"
+  "gitHead": "71845fd4a349b630c91f07c3ab3d14f81774335a"
 }

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

@@ -13,6 +13,7 @@ import type {
   SetClipboardTextOptions,
 } from '@apps-in-toss/types';
 import { TurboModuleRegistry, type TurboModule as __TurboModule } from 'react-native';
+import type { AppsInTossSignTossCertParams } from './appsInTossSignTossCert';
 import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './checkoutPayment';
 import type { GameCenterGameProfileResponse } from './getGameCenterGameProfile';
 import { IapCreateOneTimePurchaseOrderResult, IapProductListItem, CompletedOrRefundedOrdersResult } from './iap';
@@ -74,11 +75,15 @@ interface Spec extends __TurboModule {
   processProductGrant: (params: { orderId: string; isProductGranted: boolean }) => Promise<void>;
   getPendingOrders: (params: CompatiblePlaceholderArgument) => Promise<{ orderIds: string[] }>;
   getCompletedOrRefundedOrders: (params: { key?: string | null }) => Promise<CompletedOrRefundedOrdersResult>;
+  completeProductGrant: (params: { params: { orderId: string } }) => Promise<boolean>;
 
   getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
   submitGameCenterLeaderBoardScore: (params: { score: string }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;
 
   contactsViral: (params: ContactsViralParams) => () => void;
+
+  /** 토스인증 */
+  appsInTossSignTossCert: (params: { params: AppsInTossSignTossCertParams }) => void;
 }
 
 const Module = TurboModuleRegistry.getEnforcing<Spec>('AppsInTossModule');

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

@@ -0,0 +1,48 @@
+import { AppsInTossModule } from './AppsInTossModule';
+import { isMinVersionSupported } from './isMinVersionSupported';
+
+export interface AppsInTossSignTossCertParams {
+  txId: string;
+}
+
+/**
+ * @public
+ * @category 토스인증
+ * @name appsInTossSignTossCert
+ * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.
+ *
+ * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.
+ * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.
+ *
+ * @example
+ * ```tsx
+ * import { appsInTossSignTossCert } from '@apps-in-toss/framework';
+ *
+ *  // 서명에 필요한 파라미터를 정의해요.
+ *  const params = {
+ *    txId: "f2e1a6df..."
+ *  };
+ *
+ * appsInTossSignTossCert(params)
+ *   .then(() => {
+ *     console.log('서명 작업이 성공적으로 완료되었어요.');
+ *   })
+ *   .catch((error) => {
+ *     console.error('서명 작업 중 에러가 발생했어요:', error);
+ *   });
+ * ```
+ */
+
+export async function appsInTossSignTossCert(params: AppsInTossSignTossCertParams) {
+  const isSupported = isMinVersionSupported({
+    android: '5.233.0',
+    ios: '5.233.0',
+  });
+
+  if (!isSupported) {
+    console.warn('appsInTossSignTossCert is not supported in this app version');
+    return;
+  }
+
+  await AppsInTossModule.appsInTossSignTossCert({ params });
+}

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

@@ -413,17 +413,57 @@ async function getCompletedOrRefundedOrders(params?: { key?: string | null }) {
   return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
 }
 
+/**
+ * @public
+ * @category 인앱결제
+ * @name completeProductGrant
+ * @description 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 이 함수를 사용하면 결제가 완료된 주문의 상품 지급이 정상적으로 완료되었음을 알릴 수 있어요.
+ * @param {{ params: { orderId: string } }} params 결제가 완료된 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요. 상품 지급을 완료할 주문을 지정할 때 사용해요.
+ * @returns {Promise<boolean>} 상품 지급이 완료됐는지 여부를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.233.0, iOS 5.233.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 결제를 성공한 뒤 상품을 지급하는 예시
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function handleGrantProduct(orderId: string) {
+ *   try {
+ *     await IAP.completeProductGrant({ params: { orderId } });
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function completeProductGrant(params: { params: { orderId: string } }) {
+  const isSupported = isMinVersionSupported({
+    android: '5.233.0',
+    ios: '5.233.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.completeProductGrant(params);
+}
+
 /**
  * @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) 문서를 참고하세요.
+ * @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/createOneTimePurchaseOrder.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/getProductItemList.html) 문서를 참고하세요.
+ * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
+ * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
+ * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
  */
 export const IAP = {
   createOneTimePurchaseOrder,
   getProductItemList,
   getPendingOrders,
   getCompletedOrRefundedOrders,
+  completeProductGrant,
 };

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

@@ -54,6 +54,7 @@ export * from './openGameCenterLeaderboard';
 export * from './getGameCenterGameProfile';
 export * from './submitGameCenterLeaderBoardScore';
 export * from '../native-event-emitter/contactsViral';
+export * from './appsInTossSignTossCert';
 
 export type {
   LoadAdMobInterstitialAdEvent,

package/src/async-bridges.ts

@@ -24,6 +24,7 @@ export * from './AppsInTossModule/native-modules/getTossShareLink';
 export * from './AppsInTossModule/native-modules/setDeviceOrientation';
 export * from './AppsInTossModule/native-modules/checkoutPayment';
 export * from './AppsInTossModule/native-modules/saveBase64Data';
+export * from './AppsInTossModule/native-modules/appsInTossSignTossCert';
 export * from './AppsInTossModule/native-modules/getGameCenterGameProfile';
 export * from './AppsInTossModule/native-modules/openGameCenterLeaderboard';
 export * from './AppsInTossModule/native-modules/submitGameCenterLeaderBoardScore';