@apps-in-toss/web-bridge 1.1.2 → 1.2.0

package/built/index.cjs

@@ -117,17 +117,112 @@ var Storage = {
 };
 
 // src/iap.ts
+var import_bridge_core3 = require("@apps-in-toss/bridge-core");
+
+// src/isMinVersionSupported.ts
 var import_bridge_core2 = require("@apps-in-toss/bridge-core");
+
+// src/utils/compareVersion.ts
+var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
+var isWildcard = (val) => ["*", "x", "X"].includes(val);
+var tryParse = (val) => {
+  const num = parseInt(val, 10);
+  return isNaN(num) ? val : num;
+};
+var coerceTypes = (a, b) => {
+  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
+};
+var compareValues = (a, b) => {
+  if (isWildcard(a) || isWildcard(b)) {
+    return 0;
+  }
+  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
+  if (aVal > bVal) {
+    return 1;
+  }
+  if (aVal < bVal) {
+    return -1;
+  }
+  return 0;
+};
+var parseVersion = (version) => {
+  if (typeof version !== "string") {
+    throw new TypeError("Invalid argument: expected a string");
+  }
+  const match = version.match(SEMVER_REGEX);
+  if (!match) {
+    throw new Error(`Invalid semver: '${version}'`);
+  }
+  const [, major, minor, patch, build, preRelease] = match;
+  return [major, minor, patch, build, preRelease];
+};
+var compareSegments = (a, b) => {
+  const maxLength = Math.max(a.length, b.length);
+  for (let i = 0; i < maxLength; i++) {
+    const segA = a[i] ?? "0";
+    const segB = b[i] ?? "0";
+    const result = compareValues(segA, segB);
+    if (result !== 0) {
+      return result;
+    }
+  }
+  return 0;
+};
+var compareVersions = (v1, v2) => {
+  const seg1 = parseVersion(v1);
+  const seg2 = parseVersion(v2);
+  const preRelease1 = seg1.pop();
+  const preRelease2 = seg2.pop();
+  const mainCompare = compareSegments(seg1, seg2);
+  if (mainCompare !== 0) {
+    return mainCompare;
+  }
+  if (preRelease1 && preRelease2) {
+    return compareSegments(preRelease1.split("."), preRelease2.split("."));
+  }
+  if (preRelease1) {
+    return -1;
+  }
+  if (preRelease2) {
+    return 1;
+  }
+  return 0;
+};
+
+// src/isMinVersionSupported.ts
+function isMinVersionSupported(minVersions) {
+  const operationalEnvironment = (0, import_bridge_core2.createConstantBridge)("getOperationalEnvironment")();
+  if (operationalEnvironment === "sandbox") {
+    return true;
+  }
+  const currentVersion = (0, import_bridge_core2.createConstantBridge)("getTossAppVersion")();
+  const isIOS = (0, import_bridge_core2.createConstantBridge)("getPlatformOS")() === "ios";
+  const minVersion = isIOS ? minVersions.ios : minVersions.android;
+  if (minVersion === void 0) {
+    return false;
+  }
+  if (minVersion === "always") {
+    return true;
+  }
+  if (minVersion === "never") {
+    return false;
+  }
+  return compareVersions(currentVersion, minVersion) >= 0;
+}
+
+// src/iap.ts
+function processProductGrant(params) {
+  return (0, import_bridge_core3.createAsyncBridge)("processProductGrant")(params);
+}
 var IAP = {
   /**
    * @public
    * @category 인앱결제
-   * @name iapCreateOneTimePurchaseOrder
+   * @name createOneTimePurchaseOrder
    * @description
    * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
    * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
-   * @param {string} params.productId - 주문할 상품의 ID예요.
-   * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+   * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
    *
    * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
    * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -139,30 +234,127 @@ var IAP = {
    * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
    * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
    * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+   * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
    */
-  createOneTimePurchaseOrder: (0, import_bridge_core2.createAsyncBridge)(
-    "iapCreateOneTimePurchaseOrder"
-  ),
+  createOneTimePurchaseOrder: (params) => {
+    const isIAPSupported = isMinVersionSupported({
+      android: "5.219.0",
+      ios: "5.219.0"
+    });
+    const noop = () => {
+    };
+    if (!isIAPSupported) {
+      return noop;
+    }
+    const isProcessProductGrantSupported = isMinVersionSupported({
+      android: "5.231.1",
+      ios: "5.230.0"
+    });
+    const { options, onEvent, onError } = params;
+    const sku = options.sku ?? options.productId;
+    if (!isProcessProductGrantSupported) {
+      const v1 = () => {
+        (0, import_bridge_core3.createAsyncBridge)(
+          "iapCreateOneTimePurchaseOrder"
+        )({
+          productId: sku
+        }).then((response) => {
+          Promise.resolve(options.processProductGrant({ orderId: response.orderId })).then(() => {
+            onEvent({ type: "success", data: response });
+          }).catch((error) => {
+            onError(error);
+          });
+        }).catch((error) => {
+          onError(error);
+        });
+        return noop;
+      };
+      return v1();
+    }
+    const unregisterCallbacks = (0, import_bridge_core3.createEventBridge)("requestOneTimePurchase")({
+      options: { sku },
+      onEvent: async (event) => {
+        if (event.type === "purchased") {
+          const isProductGranted = await options.processProductGrant({ orderId: event.data.orderId });
+          await processProductGrant({
+            orderId: event.data.orderId,
+            isProductGranted
+          }).catch(onError);
+        } else {
+          onEvent(event);
+        }
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    });
+    return unregisterCallbacks;
+  },
   /**
    * @public
    * @category 인앱결제
-   * @name iapGetProductItemList
+   * @name getProductItemList
    * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
    * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
    */
-  getProductItemList: (0, import_bridge_core2.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")
 };
 
 // src/getSafeAreaInsets.ts
-var import_bridge_core3 = require("@apps-in-toss/bridge-core");
-var getSafeAreaBottom = (0, import_bridge_core3.createConstantBridge)("getSafeAreaBottom");
-var getSafeAreaTop = (0, import_bridge_core3.createConstantBridge)("getSafeAreaTop");
+var import_bridge_core4 = require("@apps-in-toss/bridge-core");
+var getSafeAreaBottom = (0, import_bridge_core4.createConstantBridge)("getSafeAreaBottom");
+var getSafeAreaTop = (0, import_bridge_core4.createConstantBridge)("getSafeAreaTop");
 function getSafeAreaInsets() {
   return { top: getSafeAreaTop(), bottom: getSafeAreaBottom() };
 }
 
 // src/googleAdMob.ts
-var import_bridge_core4 = require("@apps-in-toss/bridge-core");
+var import_bridge_core5 = require("@apps-in-toss/bridge-core");
 var GoogleAdMob = {
   /**
    * @public
@@ -213,9 +405,9 @@ var GoogleAdMob = {
    * ```
    */
   loadAdMobInterstitialAd: Object.assign(
-    (0, import_bridge_core4.createEventBridge)("loadAdMobInterstitialAd"),
+    (0, import_bridge_core5.createEventBridge)("loadAdMobInterstitialAd"),
     {
-      isSupported: (0, import_bridge_core4.createConstantBridge)("loadAdMobInterstitialAd_isSupported")
+      isSupported: (0, import_bridge_core5.createConstantBridge)("loadAdMobInterstitialAd_isSupported")
     }
   ),
   /**
@@ -288,9 +480,9 @@ var GoogleAdMob = {
    * ```
    */
   showAdMobInterstitialAd: Object.assign(
-    (0, import_bridge_core4.createEventBridge)("showAdMobInterstitialAd"),
+    (0, import_bridge_core5.createEventBridge)("showAdMobInterstitialAd"),
     {
-      isSupported: (0, import_bridge_core4.createConstantBridge)("showAdMobInterstitialAd_isSupported")
+      isSupported: (0, import_bridge_core5.createConstantBridge)("showAdMobInterstitialAd_isSupported")
     }
   ),
   /**
@@ -342,9 +534,9 @@ var GoogleAdMob = {
    * ```
    */
   loadAdMobRewardedAd: Object.assign(
-    (0, import_bridge_core4.createEventBridge)("loadAdMobRewardedAd"),
+    (0, import_bridge_core5.createEventBridge)("loadAdMobRewardedAd"),
     {
-      isSupported: (0, import_bridge_core4.createConstantBridge)("loadAdMobRewardedAd_isSupported")
+      isSupported: (0, import_bridge_core5.createConstantBridge)("loadAdMobRewardedAd_isSupported")
     }
   ),
   /**
@@ -417,9 +609,9 @@ var GoogleAdMob = {
    * ```
    */
   showAdMobRewardedAd: Object.assign(
-    (0, import_bridge_core4.createEventBridge)("showAdMobRewardedAd"),
+    (0, import_bridge_core5.createEventBridge)("showAdMobRewardedAd"),
     {
-      isSupported: (0, import_bridge_core4.createConstantBridge)("showAdMobRewardedAd_isSupported")
+      isSupported: (0, import_bridge_core5.createConstantBridge)("showAdMobRewardedAd_isSupported")
     }
   ),
   /**
@@ -476,8 +668,8 @@ var GoogleAdMob = {
    * }
    * ```
    */
-  loadAppsInTossAdMob: Object.assign((0, import_bridge_core4.createEventBridge)("loadAppsInTossAdMob"), {
-    isSupported: (0, import_bridge_core4.createConstantBridge)("loadAppsInTossAdMob_isSupported")
+  loadAppsInTossAdMob: Object.assign((0, import_bridge_core5.createEventBridge)("loadAppsInTossAdMob"), {
+    isSupported: (0, import_bridge_core5.createConstantBridge)("loadAppsInTossAdMob_isSupported")
   }),
   /**
    * @public
@@ -554,19 +746,19 @@ var GoogleAdMob = {
    * }
    * ```
    */
-  showAppsInTossAdMob: Object.assign((0, import_bridge_core4.createEventBridge)("showAppsInTossAdMob"), {
-    isSupported: (0, import_bridge_core4.createConstantBridge)("showAppsInTossAdMob_isSupported")
+  showAppsInTossAdMob: Object.assign((0, import_bridge_core5.createEventBridge)("showAppsInTossAdMob"), {
+    isSupported: (0, import_bridge_core5.createConstantBridge)("showAppsInTossAdMob_isSupported")
   })
 };
 
 // src/graniteEvent.ts
-var import_bridge_core5 = require("@apps-in-toss/bridge-core");
+var import_bridge_core6 = require("@apps-in-toss/bridge-core");
 var graniteEvent = {
   addEventListener: (event, {
     onEvent,
     onError,
     options
-  }) => (0, import_bridge_core5.createEventBridge)(event)({
+  }) => (0, import_bridge_core6.createEventBridge)(event)({
     onEvent,
     onError: onError ?? (() => {
     }),
@@ -574,97 +766,6 @@ var graniteEvent = {
   })
 };
 
-// src/isMinVersionSupported.ts
-var import_bridge_core6 = require("@apps-in-toss/bridge-core");
-
-// src/utils/compareVersion.ts
-var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
-var isWildcard = (val) => ["*", "x", "X"].includes(val);
-var tryParse = (val) => {
-  const num = parseInt(val, 10);
-  return isNaN(num) ? val : num;
-};
-var coerceTypes = (a, b) => {
-  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
-};
-var compareValues = (a, b) => {
-  if (isWildcard(a) || isWildcard(b)) {
-    return 0;
-  }
-  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
-  if (aVal > bVal) {
-    return 1;
-  }
-  if (aVal < bVal) {
-    return -1;
-  }
-  return 0;
-};
-var parseVersion = (version) => {
-  if (typeof version !== "string") {
-    throw new TypeError("Invalid argument: expected a string");
-  }
-  const match = version.match(SEMVER_REGEX);
-  if (!match) {
-    throw new Error(`Invalid semver: '${version}'`);
-  }
-  const [, major, minor, patch, build, preRelease] = match;
-  return [major, minor, patch, build, preRelease];
-};
-var compareSegments = (a, b) => {
-  const maxLength = Math.max(a.length, b.length);
-  for (let i = 0; i < maxLength; i++) {
-    const segA = a[i] ?? "0";
-    const segB = b[i] ?? "0";
-    const result = compareValues(segA, segB);
-    if (result !== 0) {
-      return result;
-    }
-  }
-  return 0;
-};
-var compareVersions = (v1, v2) => {
-  const seg1 = parseVersion(v1);
-  const seg2 = parseVersion(v2);
-  const preRelease1 = seg1.pop();
-  const preRelease2 = seg2.pop();
-  const mainCompare = compareSegments(seg1, seg2);
-  if (mainCompare !== 0) {
-    return mainCompare;
-  }
-  if (preRelease1 && preRelease2) {
-    return compareSegments(preRelease1.split("."), preRelease2.split("."));
-  }
-  if (preRelease1) {
-    return -1;
-  }
-  if (preRelease2) {
-    return 1;
-  }
-  return 0;
-};
-
-// src/isMinVersionSupported.ts
-function isMinVersionSupported(minVersions) {
-  const operationalEnvironment = (0, import_bridge_core6.createConstantBridge)("getOperationalEnvironment")();
-  if (operationalEnvironment === "sandbox") {
-    return true;
-  }
-  const currentVersion = (0, import_bridge_core6.createConstantBridge)("getTossAppVersion")();
-  const isIOS = (0, import_bridge_core6.createConstantBridge)("getPlatformOS")() === "ios";
-  const minVersion = isIOS ? minVersions.ios : minVersions.android;
-  if (minVersion === void 0) {
-    return false;
-  }
-  if (minVersion === "always") {
-    return true;
-  }
-  if (minVersion === "never") {
-    return false;
-  }
-  return compareVersions(currentVersion, minVersion) >= 0;
-}
-
 // src/appsInTossEvent.ts
 var import_bridge_core7 = require("@apps-in-toss/bridge-core");
 var appsInTossEvent = {

package/built/index.d.cts

@@ -85,6 +85,16 @@ declare const Storage: {
     clearItems: (args_0: void) => Promise<void>;
 };
 
+type Sku = {
+    /**
+     * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+     */
+    productId: string;
+    sku?: string;
+} | {
+    productId?: never;
+    sku: string;
+};
 /**
  * @public
  * @category 인앱결제
@@ -107,6 +117,29 @@ interface IapCreateOneTimePurchaseOrderResult {
     fraction: number;
     miniAppIconUrl: string | null;
 }
+interface SuccessEvent {
+    type: 'success';
+    data: IapCreateOneTimePurchaseOrderResult;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @property {Sku} options - 결제할 상품의 정보예요.
+ * @property {string} options.sku - 주문할 상품의 고유 ID예요.
+ * @property {(params: { orderId: string }) => boolean | Promise<boolean>} processProductGrant - 주문이 만들어진 뒤 실제로 상품을 지급할 때 호출해요. `orderId`를 받아서 지급 성공 여부를 `true` 또는 `Promise<true>`로 반환해요. 지급에 실패하면 `false`를 반환해요.
+ * @property {(event: SuccessEvent) => void | Promise<void>} onEvent - 결제가 성공했을 때 호출해요. `event.type`이 `'success'`이고, `event.data`에 `IapCreateOneTimePurchaseOrderResult`가 들어 있어요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 결제 과정에서 에러가 발생했을 때 호출해요. 에러 객체를 받아서 로깅하거나 복구 절차를 실행할 수 있어요.
+ */
+interface IapCreateOneTimePurchaseOrderOptions {
+    options: Sku & {
+        processProductGrant: (params: {
+            orderId: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
 /**
  * @public
  * @category 인앱결제
@@ -125,6 +158,29 @@ 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 인앱결제
@@ -137,12 +193,11 @@ declare const IAP: {
     /**
      * @public
      * @category 인앱결제
-     * @name iapCreateOneTimePurchaseOrder
+     * @name createOneTimePurchaseOrder
      * @description
      * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
      * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
-     * @param {string} params.productId - 주문할 상품의 ID예요.
-     * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+     * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
      *
      * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
      * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -154,20 +209,66 @@ declare const IAP: {
      * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
      * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
      * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+     * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
      */
-    createOneTimePurchaseOrder: (args_0: {
-        productId: string;
-    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    createOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => () => void;
     /**
      * @public
      * @category 인앱결제
-     * @name iapGetProductItemList
+     * @name getProductItemList
      * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
      * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
      */
     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>;
 };
 
 declare function getSafeAreaInsets(): {
@@ -787,4 +888,4 @@ declare const startUpdateLocation: {
     openPermissionDialog(): Promise<"denied" | "allowed">;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, 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

@@ -85,6 +85,16 @@ declare const Storage: {
     clearItems: (args_0: void) => Promise<void>;
 };
 
+type Sku = {
+    /**
+     * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+     */
+    productId: string;
+    sku?: string;
+} | {
+    productId?: never;
+    sku: string;
+};
 /**
  * @public
  * @category 인앱결제
@@ -107,6 +117,29 @@ interface IapCreateOneTimePurchaseOrderResult {
     fraction: number;
     miniAppIconUrl: string | null;
 }
+interface SuccessEvent {
+    type: 'success';
+    data: IapCreateOneTimePurchaseOrderResult;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @property {Sku} options - 결제할 상품의 정보예요.
+ * @property {string} options.sku - 주문할 상품의 고유 ID예요.
+ * @property {(params: { orderId: string }) => boolean | Promise<boolean>} processProductGrant - 주문이 만들어진 뒤 실제로 상품을 지급할 때 호출해요. `orderId`를 받아서 지급 성공 여부를 `true` 또는 `Promise<true>`로 반환해요. 지급에 실패하면 `false`를 반환해요.
+ * @property {(event: SuccessEvent) => void | Promise<void>} onEvent - 결제가 성공했을 때 호출해요. `event.type`이 `'success'`이고, `event.data`에 `IapCreateOneTimePurchaseOrderResult`가 들어 있어요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 결제 과정에서 에러가 발생했을 때 호출해요. 에러 객체를 받아서 로깅하거나 복구 절차를 실행할 수 있어요.
+ */
+interface IapCreateOneTimePurchaseOrderOptions {
+    options: Sku & {
+        processProductGrant: (params: {
+            orderId: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
 /**
  * @public
  * @category 인앱결제
@@ -125,6 +158,29 @@ 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 인앱결제
@@ -137,12 +193,11 @@ declare const IAP: {
     /**
      * @public
      * @category 인앱결제
-     * @name iapCreateOneTimePurchaseOrder
+     * @name createOneTimePurchaseOrder
      * @description
      * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
      * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
-     * @param {string} params.productId - 주문할 상품의 ID예요.
-     * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+     * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
      *
      * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
      * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -154,20 +209,66 @@ declare const IAP: {
      * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
      * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
      * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+     * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
      */
-    createOneTimePurchaseOrder: (args_0: {
-        productId: string;
-    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    createOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => () => void;
     /**
      * @public
      * @category 인앱결제
-     * @name iapGetProductItemList
+     * @name getProductItemList
      * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
      * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
      */
     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>;
 };
 
 declare function getSafeAreaInsets(): {
@@ -787,4 +888,4 @@ declare const startUpdateLocation: {
     openPermissionDialog(): Promise<"denied" | "allowed">;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, 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

@@ -76,17 +76,112 @@ var Storage = {
 };
 
 // src/iap.ts
-import { createAsyncBridge as createAsyncBridge2 } from "@apps-in-toss/bridge-core";
+import { createAsyncBridge as createAsyncBridge2, createEventBridge } from "@apps-in-toss/bridge-core";
+
+// src/isMinVersionSupported.ts
+import { createConstantBridge } from "@apps-in-toss/bridge-core";
+
+// src/utils/compareVersion.ts
+var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
+var isWildcard = (val) => ["*", "x", "X"].includes(val);
+var tryParse = (val) => {
+  const num = parseInt(val, 10);
+  return isNaN(num) ? val : num;
+};
+var coerceTypes = (a, b) => {
+  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
+};
+var compareValues = (a, b) => {
+  if (isWildcard(a) || isWildcard(b)) {
+    return 0;
+  }
+  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
+  if (aVal > bVal) {
+    return 1;
+  }
+  if (aVal < bVal) {
+    return -1;
+  }
+  return 0;
+};
+var parseVersion = (version) => {
+  if (typeof version !== "string") {
+    throw new TypeError("Invalid argument: expected a string");
+  }
+  const match = version.match(SEMVER_REGEX);
+  if (!match) {
+    throw new Error(`Invalid semver: '${version}'`);
+  }
+  const [, major, minor, patch, build, preRelease] = match;
+  return [major, minor, patch, build, preRelease];
+};
+var compareSegments = (a, b) => {
+  const maxLength = Math.max(a.length, b.length);
+  for (let i = 0; i < maxLength; i++) {
+    const segA = a[i] ?? "0";
+    const segB = b[i] ?? "0";
+    const result = compareValues(segA, segB);
+    if (result !== 0) {
+      return result;
+    }
+  }
+  return 0;
+};
+var compareVersions = (v1, v2) => {
+  const seg1 = parseVersion(v1);
+  const seg2 = parseVersion(v2);
+  const preRelease1 = seg1.pop();
+  const preRelease2 = seg2.pop();
+  const mainCompare = compareSegments(seg1, seg2);
+  if (mainCompare !== 0) {
+    return mainCompare;
+  }
+  if (preRelease1 && preRelease2) {
+    return compareSegments(preRelease1.split("."), preRelease2.split("."));
+  }
+  if (preRelease1) {
+    return -1;
+  }
+  if (preRelease2) {
+    return 1;
+  }
+  return 0;
+};
+
+// src/isMinVersionSupported.ts
+function isMinVersionSupported(minVersions) {
+  const operationalEnvironment = createConstantBridge("getOperationalEnvironment")();
+  if (operationalEnvironment === "sandbox") {
+    return true;
+  }
+  const currentVersion = createConstantBridge("getTossAppVersion")();
+  const isIOS = createConstantBridge("getPlatformOS")() === "ios";
+  const minVersion = isIOS ? minVersions.ios : minVersions.android;
+  if (minVersion === void 0) {
+    return false;
+  }
+  if (minVersion === "always") {
+    return true;
+  }
+  if (minVersion === "never") {
+    return false;
+  }
+  return compareVersions(currentVersion, minVersion) >= 0;
+}
+
+// src/iap.ts
+function processProductGrant(params) {
+  return createAsyncBridge2("processProductGrant")(params);
+}
 var IAP = {
   /**
    * @public
    * @category 인앱결제
-   * @name iapCreateOneTimePurchaseOrder
+   * @name createOneTimePurchaseOrder
    * @description
    * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
    * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
-   * @param {string} params.productId - 주문할 상품의 ID예요.
-   * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+   * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
    *
    * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
    * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -98,30 +193,127 @@ var IAP = {
    * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
    * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
    * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+   * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
    */
-  createOneTimePurchaseOrder: createAsyncBridge2(
-    "iapCreateOneTimePurchaseOrder"
-  ),
+  createOneTimePurchaseOrder: (params) => {
+    const isIAPSupported = isMinVersionSupported({
+      android: "5.219.0",
+      ios: "5.219.0"
+    });
+    const noop = () => {
+    };
+    if (!isIAPSupported) {
+      return noop;
+    }
+    const isProcessProductGrantSupported = isMinVersionSupported({
+      android: "5.231.1",
+      ios: "5.230.0"
+    });
+    const { options, onEvent, onError } = params;
+    const sku = options.sku ?? options.productId;
+    if (!isProcessProductGrantSupported) {
+      const v1 = () => {
+        createAsyncBridge2(
+          "iapCreateOneTimePurchaseOrder"
+        )({
+          productId: sku
+        }).then((response) => {
+          Promise.resolve(options.processProductGrant({ orderId: response.orderId })).then(() => {
+            onEvent({ type: "success", data: response });
+          }).catch((error) => {
+            onError(error);
+          });
+        }).catch((error) => {
+          onError(error);
+        });
+        return noop;
+      };
+      return v1();
+    }
+    const unregisterCallbacks = createEventBridge("requestOneTimePurchase")({
+      options: { sku },
+      onEvent: async (event) => {
+        if (event.type === "purchased") {
+          const isProductGranted = await options.processProductGrant({ orderId: event.data.orderId });
+          await processProductGrant({
+            orderId: event.data.orderId,
+            isProductGranted
+          }).catch(onError);
+        } else {
+          onEvent(event);
+        }
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    });
+    return unregisterCallbacks;
+  },
   /**
    * @public
    * @category 인앱결제
-   * @name iapGetProductItemList
+   * @name getProductItemList
    * @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")
 };
 
 // src/getSafeAreaInsets.ts
-import { createConstantBridge } from "@apps-in-toss/bridge-core";
-var getSafeAreaBottom = createConstantBridge("getSafeAreaBottom");
-var getSafeAreaTop = createConstantBridge("getSafeAreaTop");
+import { createConstantBridge as createConstantBridge2 } from "@apps-in-toss/bridge-core";
+var getSafeAreaBottom = createConstantBridge2("getSafeAreaBottom");
+var getSafeAreaTop = createConstantBridge2("getSafeAreaTop");
 function getSafeAreaInsets() {
   return { top: getSafeAreaTop(), bottom: getSafeAreaBottom() };
 }
 
 // src/googleAdMob.ts
-import { createConstantBridge as createConstantBridge2, createEventBridge } from "@apps-in-toss/bridge-core";
+import { createConstantBridge as createConstantBridge3, createEventBridge as createEventBridge2 } from "@apps-in-toss/bridge-core";
 var GoogleAdMob = {
   /**
    * @public
@@ -172,9 +364,9 @@ var GoogleAdMob = {
    * ```
    */
   loadAdMobInterstitialAd: Object.assign(
-    createEventBridge("loadAdMobInterstitialAd"),
+    createEventBridge2("loadAdMobInterstitialAd"),
     {
-      isSupported: createConstantBridge2("loadAdMobInterstitialAd_isSupported")
+      isSupported: createConstantBridge3("loadAdMobInterstitialAd_isSupported")
     }
   ),
   /**
@@ -247,9 +439,9 @@ var GoogleAdMob = {
    * ```
    */
   showAdMobInterstitialAd: Object.assign(
-    createEventBridge("showAdMobInterstitialAd"),
+    createEventBridge2("showAdMobInterstitialAd"),
     {
-      isSupported: createConstantBridge2("showAdMobInterstitialAd_isSupported")
+      isSupported: createConstantBridge3("showAdMobInterstitialAd_isSupported")
     }
   ),
   /**
@@ -301,9 +493,9 @@ var GoogleAdMob = {
    * ```
    */
   loadAdMobRewardedAd: Object.assign(
-    createEventBridge("loadAdMobRewardedAd"),
+    createEventBridge2("loadAdMobRewardedAd"),
     {
-      isSupported: createConstantBridge2("loadAdMobRewardedAd_isSupported")
+      isSupported: createConstantBridge3("loadAdMobRewardedAd_isSupported")
     }
   ),
   /**
@@ -376,9 +568,9 @@ var GoogleAdMob = {
    * ```
    */
   showAdMobRewardedAd: Object.assign(
-    createEventBridge("showAdMobRewardedAd"),
+    createEventBridge2("showAdMobRewardedAd"),
     {
-      isSupported: createConstantBridge2("showAdMobRewardedAd_isSupported")
+      isSupported: createConstantBridge3("showAdMobRewardedAd_isSupported")
     }
   ),
   /**
@@ -435,8 +627,8 @@ var GoogleAdMob = {
    * }
    * ```
    */
-  loadAppsInTossAdMob: Object.assign(createEventBridge("loadAppsInTossAdMob"), {
-    isSupported: createConstantBridge2("loadAppsInTossAdMob_isSupported")
+  loadAppsInTossAdMob: Object.assign(createEventBridge2("loadAppsInTossAdMob"), {
+    isSupported: createConstantBridge3("loadAppsInTossAdMob_isSupported")
   }),
   /**
    * @public
@@ -513,19 +705,19 @@ var GoogleAdMob = {
    * }
    * ```
    */
-  showAppsInTossAdMob: Object.assign(createEventBridge("showAppsInTossAdMob"), {
-    isSupported: createConstantBridge2("showAppsInTossAdMob_isSupported")
+  showAppsInTossAdMob: Object.assign(createEventBridge2("showAppsInTossAdMob"), {
+    isSupported: createConstantBridge3("showAppsInTossAdMob_isSupported")
   })
 };
 
 // src/graniteEvent.ts
-import { createEventBridge as createEventBridge2 } from "@apps-in-toss/bridge-core";
+import { createEventBridge as createEventBridge3 } from "@apps-in-toss/bridge-core";
 var graniteEvent = {
   addEventListener: (event, {
     onEvent,
     onError,
     options
-  }) => createEventBridge2(event)({
+  }) => createEventBridge3(event)({
     onEvent,
     onError: onError ?? (() => {
     }),
@@ -533,105 +725,14 @@ var graniteEvent = {
   })
 };
 
-// src/isMinVersionSupported.ts
-import { createConstantBridge as createConstantBridge3 } from "@apps-in-toss/bridge-core";
-
-// src/utils/compareVersion.ts
-var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
-var isWildcard = (val) => ["*", "x", "X"].includes(val);
-var tryParse = (val) => {
-  const num = parseInt(val, 10);
-  return isNaN(num) ? val : num;
-};
-var coerceTypes = (a, b) => {
-  return typeof a === typeof b ? [a, b] : [String(a), String(b)];
-};
-var compareValues = (a, b) => {
-  if (isWildcard(a) || isWildcard(b)) {
-    return 0;
-  }
-  const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
-  if (aVal > bVal) {
-    return 1;
-  }
-  if (aVal < bVal) {
-    return -1;
-  }
-  return 0;
-};
-var parseVersion = (version) => {
-  if (typeof version !== "string") {
-    throw new TypeError("Invalid argument: expected a string");
-  }
-  const match = version.match(SEMVER_REGEX);
-  if (!match) {
-    throw new Error(`Invalid semver: '${version}'`);
-  }
-  const [, major, minor, patch, build, preRelease] = match;
-  return [major, minor, patch, build, preRelease];
-};
-var compareSegments = (a, b) => {
-  const maxLength = Math.max(a.length, b.length);
-  for (let i = 0; i < maxLength; i++) {
-    const segA = a[i] ?? "0";
-    const segB = b[i] ?? "0";
-    const result = compareValues(segA, segB);
-    if (result !== 0) {
-      return result;
-    }
-  }
-  return 0;
-};
-var compareVersions = (v1, v2) => {
-  const seg1 = parseVersion(v1);
-  const seg2 = parseVersion(v2);
-  const preRelease1 = seg1.pop();
-  const preRelease2 = seg2.pop();
-  const mainCompare = compareSegments(seg1, seg2);
-  if (mainCompare !== 0) {
-    return mainCompare;
-  }
-  if (preRelease1 && preRelease2) {
-    return compareSegments(preRelease1.split("."), preRelease2.split("."));
-  }
-  if (preRelease1) {
-    return -1;
-  }
-  if (preRelease2) {
-    return 1;
-  }
-  return 0;
-};
-
-// src/isMinVersionSupported.ts
-function isMinVersionSupported(minVersions) {
-  const operationalEnvironment = createConstantBridge3("getOperationalEnvironment")();
-  if (operationalEnvironment === "sandbox") {
-    return true;
-  }
-  const currentVersion = createConstantBridge3("getTossAppVersion")();
-  const isIOS = createConstantBridge3("getPlatformOS")() === "ios";
-  const minVersion = isIOS ? minVersions.ios : minVersions.android;
-  if (minVersion === void 0) {
-    return false;
-  }
-  if (minVersion === "always") {
-    return true;
-  }
-  if (minVersion === "never") {
-    return false;
-  }
-  return compareVersions(currentVersion, minVersion) >= 0;
-}
-
 // src/appsInTossEvent.ts
-import { createEventBridge as createEventBridge3 } from "@apps-in-toss/bridge-core";
+import { createEventBridge as createEventBridge4 } from "@apps-in-toss/bridge-core";
 var appsInTossEvent = {
   addEventListener: (event, {
     onEvent,
     onError,
     options
-  }) => createEventBridge3(event)({
+  }) => createEventBridge4(event)({
     onEvent,
     onError: onError ?? (() => {
     }),
@@ -663,7 +764,7 @@ var getAppsInTossGlobals = () => {
 };
 
 // src/tdsEvent.ts
-import { createEventBridge as createEventBridge4 } from "@apps-in-toss/bridge-core";
+import { createEventBridge as createEventBridge5 } from "@apps-in-toss/bridge-core";
 var tdsEvent = {
   /**
    * @public
@@ -693,7 +794,7 @@ var tdsEvent = {
     onEvent,
     onError,
     options
-  }) => createEventBridge4(event)({
+  }) => createEventBridge5(event)({
     onEvent,
     onError: onError ?? (() => {
     }),
@@ -858,14 +959,14 @@ var getClipboardText = createPermissionFunction({
 });
 
 // src/permissions/startUpdateLocation.ts
-import { createAsyncBridge as createAsyncBridge11, createEventBridge as createEventBridge5 } from "@apps-in-toss/bridge-core";
+import { createAsyncBridge as createAsyncBridge11, createEventBridge as createEventBridge6 } from "@apps-in-toss/bridge-core";
 import {
   StartUpdateLocationPermissionError
 } from "@apps-in-toss/types";
 var getPermission2 = createAsyncBridge11("getPermission");
 var openPermissionDialog2 = createAsyncBridge11("openPermissionDialog");
 var startUpdateLocation = (params) => {
-  return createEventBridge5("updateLocationEvent")({
+  return createEventBridge6("updateLocationEvent")({
     ...params,
     onError: (error) => {
       const locationError = new StartUpdateLocationPermissionError();

package/package.json

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