@apps-in-toss/web-bridge 0.0.0-dev.1758275837494 → 0.0.0-dev.1760943445541

package/built/appsInTossSignTossCert.d.ts

@@ -0,0 +1,33 @@
+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/web-framework';
+ *
+ *  // 서명에 필요한 파라미터를 정의해요.
+ *  const params = {
+ *    txId: "f2e1a6df..."
+ *  };
+ *
+ * appsInTossSignTossCert(params)
+ *   .then(() => {
+ *     console.log('서명 작업이 성공적으로 완료되었어요.');
+ *   })
+ *   .catch((error) => {
+ *     console.error('서명 작업 중 에러가 발생했어요:', error);
+ *   });
+ * ```
+ */
+export declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;
+
+export {};

package/built/bridge.d.ts

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

package/built/bridge.js

@@ -1 +1 @@
-import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");

package/built/index.cjs

@@ -247,7 +247,7 @@ var IAP = {
       return noop;
     }
     const isProcessProductGrantSupported = isMinVersionSupported({
-      android: "5.230.0",
+      android: "5.231.1",
       ios: "5.230.0"
     });
     const { options, onEvent, onError } = params;
@@ -297,7 +297,76 @@ var IAP = {
    * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
    * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
    */
-  getProductItemList: (0, import_bridge_core3.createAsyncBridge)("iapGetProductItemList")
+  getProductItemList: (0, import_bridge_core3.createAsyncBridge)("iapGetProductItemList"),
+  /**
+   * @public
+   * @category 인앱결제
+   * @name getPendingOrders
+   * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+   * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   *
+   * @example
+   * ### 대기 중인 주문 목록 가져오기
+   * ```typescript
+   * import { IAP } from '@apps-in-toss/web-framework';
+   *
+   * async function fetchOrders() {
+   *   try {
+   *     const pendingOrders = await IAP.getPendingOrders();
+   *     return pendingOrders;
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   * ```
+   */
+  getPendingOrders: (0, import_bridge_core3.createAsyncBridge)("getPendingOrders"),
+  /**
+   * @public
+   * @category 인앱결제
+   * @name getCompletedOrRefundedOrders
+   * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+   * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   *
+   * @example
+   * ```typescript
+   * import { IAP } from "@apps-in-toss/web-framework";
+   *
+   * async function fetchOrders() {
+   *   try {
+   *     const response =  await IAP.getCompletedOrRefundedOrders();
+   *     return response;
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   * ```
+   */
+  getCompletedOrRefundedOrders: (0, import_bridge_core3.createAsyncBridge)("getCompletedOrRefundedOrders"),
+  /**
+   * @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/web-framework';
+   *
+   * async function handleGrantProduct(orderId: string) {
+   *   try {
+   *     await IAP.completeProductGrant({ params: { orderId } });
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   * ```
+   */
+  completeProductGrant: (0, import_bridge_core3.createAsyncBridge)("completeProductGrant")
 };
 
 // src/getSafeAreaInsets.ts

package/built/index.d.cts

@@ -158,13 +158,39 @@ interface IapProductListItem {
     iconUrl: string;
     description: string;
 }
+/**
+ * @public
+ * @category 인앱결제
+ * @name CompletedOrRefundedOrdersResult
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 나타내는 객체예요. 페이지네이션 정보를 포함해요.
+ * @property {boolean} hasNext 다음 페이지가 있는지 여부예요. `true`면 더 많은 주문이 남아 있어요.
+ * @property {string | null} [nextKey] 다음 주문 목록을 조회할 때 사용할 키예요. 마지막 페이지라면 `null`이거나 생략될 수 있어요.
+ * @property {Array} orders 주문 정보를 담은 배열이에요. 각 요소는 하나의 주문을 나타내요.
+ * @property {string} orders[].orderId 주문의 고유 ID예요.
+ * @property {string} orders[].sku 주문 상품의 고유 ID예요.
+ * @property {'COMPLETED' | 'REFUNDED'} orders[].status 주문의 상태예요. 'COMPLETED'는 주문이 완료된 상태, 'REFUNDED'는 환불된 상태를 의미해요.
+ * @property {string} orders[].date 주문의 날짜 정보예요. ISO 8601 형식(YYYY-MM-DDTHH:mm:ss)을 사용해요. 예를 들어 "2025-09-22T00:00:00" 형식으로 제공돼요. 주문 상태가 `COMPLETED`라면 주문한 날짜를, `REFUNDED`라면 환불한 날짜를 나타내요.
+ */
+interface CompletedOrRefundedOrdersResult {
+    hasNext: boolean;
+    nextKey?: string | null;
+    orders: {
+        orderId: string;
+        sku: string;
+        status: 'COMPLETED' | 'REFUNDED';
+        date: 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) 문서를 참고하세요.
+ * @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: {
     /**
@@ -199,6 +225,81 @@ declare const IAP: {
     getProductItemList: () => Promise<{
         products: IapProductListItem[];
     }>;
+    /**
+     * @public
+     * @category 인앱결제
+     * @name getPendingOrders
+     * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+     * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     *
+     * @example
+     * ### 대기 중인 주문 목록 가져오기
+     * ```typescript
+     * import { IAP } from '@apps-in-toss/web-framework';
+     *
+     * async function fetchOrders() {
+     *   try {
+     *     const pendingOrders = await IAP.getPendingOrders();
+     *     return pendingOrders;
+     *   } catch (error) {
+     *     console.error(error);
+     *   }
+     * }
+     * ```
+     */
+    getPendingOrders: () => Promise<{
+        orderIds: string[];
+    }>;
+    /**
+     * @public
+     * @category 인앱결제
+     * @name getCompletedOrRefundedOrders
+     * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+     * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     *
+     * @example
+     * ```typescript
+     * import { IAP } from "@apps-in-toss/web-framework";
+     *
+     * async function fetchOrders() {
+     *   try {
+     *     const response =  await IAP.getCompletedOrRefundedOrders();
+     *     return response;
+     *   } catch (error) {
+     *     console.error(error);
+     *   }
+     * }
+     * ```
+     */
+    getCompletedOrRefundedOrders: () => Promise<CompletedOrRefundedOrdersResult>;
+    /**
+     * @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/web-framework';
+     *
+     * async function handleGrantProduct(orderId: string) {
+     *   try {
+     *     await IAP.completeProductGrant({ params: { orderId } });
+     *   } catch (error) {
+     *     console.error(error);
+     *   }
+     * }
+     * ```
+     */
+    completeProductGrant: (args_0: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<boolean>;
 };
 
 declare function getSafeAreaInsets(): {
@@ -818,4 +919,4 @@ declare const startUpdateLocation: {
     openPermissionDialog(): Promise<"denied" | "allowed">;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };

package/built/index.d.ts

@@ -158,13 +158,39 @@ interface IapProductListItem {
     iconUrl: string;
     description: string;
 }
+/**
+ * @public
+ * @category 인앱결제
+ * @name CompletedOrRefundedOrdersResult
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 나타내는 객체예요. 페이지네이션 정보를 포함해요.
+ * @property {boolean} hasNext 다음 페이지가 있는지 여부예요. `true`면 더 많은 주문이 남아 있어요.
+ * @property {string | null} [nextKey] 다음 주문 목록을 조회할 때 사용할 키예요. 마지막 페이지라면 `null`이거나 생략될 수 있어요.
+ * @property {Array} orders 주문 정보를 담은 배열이에요. 각 요소는 하나의 주문을 나타내요.
+ * @property {string} orders[].orderId 주문의 고유 ID예요.
+ * @property {string} orders[].sku 주문 상품의 고유 ID예요.
+ * @property {'COMPLETED' | 'REFUNDED'} orders[].status 주문의 상태예요. 'COMPLETED'는 주문이 완료된 상태, 'REFUNDED'는 환불된 상태를 의미해요.
+ * @property {string} orders[].date 주문의 날짜 정보예요. ISO 8601 형식(YYYY-MM-DDTHH:mm:ss)을 사용해요. 예를 들어 "2025-09-22T00:00:00" 형식으로 제공돼요. 주문 상태가 `COMPLETED`라면 주문한 날짜를, `REFUNDED`라면 환불한 날짜를 나타내요.
+ */
+interface CompletedOrRefundedOrdersResult {
+    hasNext: boolean;
+    nextKey?: string | null;
+    orders: {
+        orderId: string;
+        sku: string;
+        status: 'COMPLETED' | 'REFUNDED';
+        date: 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) 문서를 참고하세요.
+ * @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: {
     /**
@@ -199,6 +225,81 @@ declare const IAP: {
     getProductItemList: () => Promise<{
         products: IapProductListItem[];
     }>;
+    /**
+     * @public
+     * @category 인앱결제
+     * @name getPendingOrders
+     * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+     * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     *
+     * @example
+     * ### 대기 중인 주문 목록 가져오기
+     * ```typescript
+     * import { IAP } from '@apps-in-toss/web-framework';
+     *
+     * async function fetchOrders() {
+     *   try {
+     *     const pendingOrders = await IAP.getPendingOrders();
+     *     return pendingOrders;
+     *   } catch (error) {
+     *     console.error(error);
+     *   }
+     * }
+     * ```
+     */
+    getPendingOrders: () => Promise<{
+        orderIds: string[];
+    }>;
+    /**
+     * @public
+     * @category 인앱결제
+     * @name getCompletedOrRefundedOrders
+     * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+     * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     *
+     * @example
+     * ```typescript
+     * import { IAP } from "@apps-in-toss/web-framework";
+     *
+     * async function fetchOrders() {
+     *   try {
+     *     const response =  await IAP.getCompletedOrRefundedOrders();
+     *     return response;
+     *   } catch (error) {
+     *     console.error(error);
+     *   }
+     * }
+     * ```
+     */
+    getCompletedOrRefundedOrders: () => Promise<CompletedOrRefundedOrdersResult>;
+    /**
+     * @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/web-framework';
+     *
+     * async function handleGrantProduct(orderId: string) {
+     *   try {
+     *     await IAP.completeProductGrant({ params: { orderId } });
+     *   } catch (error) {
+     *     console.error(error);
+     *   }
+     * }
+     * ```
+     */
+    completeProductGrant: (args_0: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<boolean>;
 };
 
 declare function getSafeAreaInsets(): {
@@ -818,4 +919,4 @@ declare const startUpdateLocation: {
     openPermissionDialog(): Promise<"denied" | "allowed">;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };

package/built/index.js

@@ -206,7 +206,7 @@ var IAP = {
       return noop;
     }
     const isProcessProductGrantSupported = isMinVersionSupported({
-      android: "5.230.0",
+      android: "5.231.1",
       ios: "5.230.0"
     });
     const { options, onEvent, onError } = params;
@@ -256,7 +256,76 @@ var IAP = {
    * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
    * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
    */
-  getProductItemList: createAsyncBridge2("iapGetProductItemList")
+  getProductItemList: createAsyncBridge2("iapGetProductItemList"),
+  /**
+   * @public
+   * @category 인앱결제
+   * @name getPendingOrders
+   * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+   * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   *
+   * @example
+   * ### 대기 중인 주문 목록 가져오기
+   * ```typescript
+   * import { IAP } from '@apps-in-toss/web-framework';
+   *
+   * async function fetchOrders() {
+   *   try {
+   *     const pendingOrders = await IAP.getPendingOrders();
+   *     return pendingOrders;
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   * ```
+   */
+  getPendingOrders: createAsyncBridge2("getPendingOrders"),
+  /**
+   * @public
+   * @category 인앱결제
+   * @name getCompletedOrRefundedOrders
+   * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+   * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   *
+   * @example
+   * ```typescript
+   * import { IAP } from "@apps-in-toss/web-framework";
+   *
+   * async function fetchOrders() {
+   *   try {
+   *     const response =  await IAP.getCompletedOrRefundedOrders();
+   *     return response;
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   * ```
+   */
+  getCompletedOrRefundedOrders: createAsyncBridge2("getCompletedOrRefundedOrders"),
+  /**
+   * @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/web-framework';
+   *
+   * async function handleGrantProduct(orderId: string) {
+   *   try {
+   *     await IAP.completeProductGrant({ params: { orderId } });
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   * ```
+   */
+  completeProductGrant: createAsyncBridge2("completeProductGrant")
 };
 
 // src/getSafeAreaInsets.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/web-bridge",
   "type": "module",
-  "version": "0.0.0-dev.1758275837494",
+  "version": "0.0.0-dev.1760943445541",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -28,11 +28,11 @@
     "built"
   ],
   "dependencies": {
-    "@apps-in-toss/types": "0.0.0-dev.1758275837494"
+    "@apps-in-toss/types": "0.0.0-dev.1760943445541"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "0.0.0-dev.1758275837494",
-    "@apps-in-toss/framework": "0.0.0-dev.1758275837494",
+    "@apps-in-toss/bridge-core": "0.0.0-dev.1760943445541",
+    "@apps-in-toss/framework": "0.0.0-dev.1760943445541",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "b68a923a00c75af3ca66633e450370f20f025a34"
+  "gitHead": "cf764d154652145c36b92690deab07ecc6eff18d"
 }