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

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,82 @@ 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.230.0",
+      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")
 };
 
 // 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 +360,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 +435,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 +489,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 +564,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 +623,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 +701,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 +721,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 인앱결제
@@ -137,12 +170,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,14 +186,13 @@ 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`를 반환해요.
      */
@@ -787,4 +818,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, 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 인앱결제
@@ -137,12 +170,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,14 +186,13 @@ 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`를 반환해요.
      */
@@ -787,4 +818,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, 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,14 +193,66 @@ 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.230.0",
+      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`를 반환해요.
    */
@@ -113,15 +260,15 @@ var IAP = {
 };
 
 // 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 +319,9 @@ var GoogleAdMob = {
    * ```
    */
   loadAdMobInterstitialAd: Object.assign(
-    createEventBridge("loadAdMobInterstitialAd"),
+    createEventBridge2("loadAdMobInterstitialAd"),
     {
-      isSupported: createConstantBridge2("loadAdMobInterstitialAd_isSupported")
+      isSupported: createConstantBridge3("loadAdMobInterstitialAd_isSupported")
     }
   ),
   /**
@@ -247,9 +394,9 @@ var GoogleAdMob = {
    * ```
    */
   showAdMobInterstitialAd: Object.assign(
-    createEventBridge("showAdMobInterstitialAd"),
+    createEventBridge2("showAdMobInterstitialAd"),
     {
-      isSupported: createConstantBridge2("showAdMobInterstitialAd_isSupported")
+      isSupported: createConstantBridge3("showAdMobInterstitialAd_isSupported")
     }
   ),
   /**
@@ -301,9 +448,9 @@ var GoogleAdMob = {
    * ```
    */
   loadAdMobRewardedAd: Object.assign(
-    createEventBridge("loadAdMobRewardedAd"),
+    createEventBridge2("loadAdMobRewardedAd"),
     {
-      isSupported: createConstantBridge2("loadAdMobRewardedAd_isSupported")
+      isSupported: createConstantBridge3("loadAdMobRewardedAd_isSupported")
     }
   ),
   /**
@@ -376,9 +523,9 @@ var GoogleAdMob = {
    * ```
    */
   showAdMobRewardedAd: Object.assign(
-    createEventBridge("showAdMobRewardedAd"),
+    createEventBridge2("showAdMobRewardedAd"),
     {
-      isSupported: createConstantBridge2("showAdMobRewardedAd_isSupported")
+      isSupported: createConstantBridge3("showAdMobRewardedAd_isSupported")
     }
   ),
   /**
@@ -435,8 +582,8 @@ var GoogleAdMob = {
    * }
    * ```
    */
-  loadAppsInTossAdMob: Object.assign(createEventBridge("loadAppsInTossAdMob"), {
-    isSupported: createConstantBridge2("loadAppsInTossAdMob_isSupported")
+  loadAppsInTossAdMob: Object.assign(createEventBridge2("loadAppsInTossAdMob"), {
+    isSupported: createConstantBridge3("loadAppsInTossAdMob_isSupported")
   }),
   /**
    * @public
@@ -513,19 +660,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 +680,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 +719,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 +749,7 @@ var tdsEvent = {
     onEvent,
     onError,
     options
-  }) => createEventBridge4(event)({
+  }) => createEventBridge5(event)({
     onEvent,
     onError: onError ?? (() => {
     }),
@@ -858,14 +914,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.1.3",
   "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.1.3"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "1.1.2",
-    "@apps-in-toss/framework": "1.1.2",
+    "@apps-in-toss/bridge-core": "1.1.3",
+    "@apps-in-toss/framework": "1.1.3",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "7b3c5e53a3ed0ffef8af2690a5ab92e8dfb0213b"
+  "gitHead": "0c80b4a0b49ec85f9f042909c7e9762c25425573"
 }