@apps-in-toss/native-modules 1.1.1 → 1.1.3

package/dist/index.cjs

@@ -50,11 +50,14 @@ __export(index_exports, {
   getSchemeUri: () => getSchemeUri,
   getTossAppVersion: () => getTossAppVersion,
   getTossShareLink: () => getTossShareLink,
+  iapCreateOneTimePurchaseOrder: () => iapCreateOneTimePurchaseOrder,
   isMinVersionSupported: () => isMinVersionSupported,
   onVisibilityChangedByTransparentServiceWeb: () => onVisibilityChangedByTransparentServiceWeb,
   openCamera: () => openCamera,
   openGameCenterLeaderboard: () => openGameCenterLeaderboard,
   openURL: () => openURL2,
+  processProductGrant: () => processProductGrant,
+  requestOneTimePurchase: () => requestOneTimePurchase,
   saveBase64Data: () => saveBase64Data,
   setClipboardText: () => setClipboardText,
   setDeviceOrientation: () => setDeviceOrientation,
@@ -68,22 +71,11 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
-var import_react_native9 = require("@granite-js/react-native");
-
-// src/AppsInTossModule/native-event-emitter/event-plugins/BackButtonClickHandleEvent.ts
-var import_react_native = require("@granite-js/react-native");
-var BackButtonClickHandleEvent = class extends import_react_native.GraniteEventDefinition {
-  name = "backButtonClickEvent";
-  remove() {
-  }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_) {
-  }
-};
+var import_react_native7 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/native-event-emitter/event-plugins/EntryMessageExitedEvent.ts
-var import_react_native2 = require("@granite-js/react-native");
-var EntryMessageExitedEvent = class extends import_react_native2.GraniteEventDefinition {
+var import_react_native = require("@granite-js/react-native");
+var EntryMessageExitedEvent = class extends import_react_native.GraniteEventDefinition {
   name = "entryMessageExited";
   remove() {
   }
@@ -92,24 +84,13 @@ var EntryMessageExitedEvent = class extends import_react_native2.GraniteEventDef
   }
 };
 
-// src/AppsInTossModule/native-event-emitter/event-plugins/HomeIconButtonClickHandleEvent.ts
-var import_react_native3 = require("@granite-js/react-native");
-var HomeIconButtonClickHandleEvent = class extends import_react_native3.GraniteEventDefinition {
-  name = "homeIconButtonClickEvent";
-  remove() {
-  }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_) {
-  }
-};
-
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
 var import_types = require("@apps-in-toss/types");
-var import_react_native6 = require("@granite-js/react-native");
+var import_react_native4 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/native-modules/AppsInTossModule.ts
-var import_react_native4 = require("react-native");
-var Module = import_react_native4.TurboModuleRegistry.getEnforcing("AppsInTossModule");
+var import_react_native2 = require("react-native");
+var Module = import_react_native2.TurboModuleRegistry.getEnforcing("AppsInTossModule");
 var AppsInTossModuleInstance = Module;
 var AppsInTossModule = Module;
 
@@ -136,11 +117,11 @@ async function requestPermission(permission) {
 }
 
 // src/AppsInTossModule/native-event-emitter/nativeEventEmitter.ts
-var import_react_native5 = require("react-native");
-var nativeEventEmitter = new import_react_native5.NativeEventEmitter(AppsInTossModuleInstance);
+var import_react_native3 = require("react-native");
+var nativeEventEmitter = new import_react_native3.NativeEventEmitter(AppsInTossModuleInstance);
 
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
-var UpdateLocationEvent = class extends import_react_native6.GraniteEventDefinition {
+var UpdateLocationEvent = class extends import_react_native4.GraniteEventDefinition {
   name = "updateLocationEvent";
   subscriptionCount = 0;
   ref = {
@@ -170,7 +151,7 @@ var UpdateLocationEvent = class extends import_react_native6.GraniteEventDefinit
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
-var import_react_native7 = require("@granite-js/react-native");
+var import_react_native5 = require("@granite-js/react-native");
 
 // src/utils/generateUUID.ts
 function generateUUID(placeholder) {
@@ -232,7 +213,7 @@ var INTERNAL__appBridgeHandler = {
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
 var UNSAFE__nativeEventEmitter = nativeEventEmitter;
-var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_native7.GraniteEventDefinition {
+var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_native5.GraniteEventDefinition {
   static INTERNAL__appBridgeSubscription;
   name = "appBridgeCallbackEvent";
   constructor() {
@@ -262,8 +243,8 @@ var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/VisibilityChangedByTransparentServiceWebEvent.ts
-var import_react_native8 = require("@granite-js/react-native");
-var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_native8.GraniteEventDefinition {
+var import_react_native6 = require("@granite-js/react-native");
+var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_native6.GraniteEventDefinition {
   name = "onVisibilityChangedByTransparentServiceWeb";
   subscription = null;
   remove() {
@@ -288,12 +269,9 @@ var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_n
 };
 
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
-var appsInTossEvent = new import_react_native9.GraniteEvent([
+var appsInTossEvent = new import_react_native7.GraniteEvent([
   new UpdateLocationEvent(),
   new EntryMessageExitedEvent(),
-  // Navigation Bar events
-  new HomeIconButtonClickHandleEvent(),
-  new BackButtonClickHandleEvent(),
   // Internal events
   new AppBridgeCallbackEvent(),
   new VisibilityChangedByTransparentServiceWebEvent()
@@ -308,7 +286,7 @@ function getOperationalEnvironment() {
 }
 
 // src/AppsInTossModule/native-modules/isMinVersionSupported.ts
-var import_react_native10 = require("react-native");
+var import_react_native8 = require("react-native");
 
 // src/utils/compareVersion.ts
 var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
@@ -384,7 +362,7 @@ function isMinVersionSupported(minVersions) {
     return true;
   }
   const currentVersion = AppsInTossModule.tossAppVersion;
-  const isIOS = import_react_native10.Platform.OS === "ios";
+  const isIOS = import_react_native8.Platform.OS === "ios";
   const minVersion = isIOS ? minVersions.ios : minVersions.android;
   if (minVersion === void 0) {
     return false;
@@ -734,15 +712,80 @@ async function getTossShareLink(path) {
 }
 
 // src/AppsInTossModule/native-modules/iap.ts
-async function createOneTimePurchaseOrder(params) {
-  const isSupported = isMinVersionSupported({
+var import_es_toolkit3 = require("es-toolkit");
+function iapCreateOneTimePurchaseOrder(params) {
+  const sku = params.sku ?? params.productId;
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+}
+function processProductGrant(params) {
+  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+}
+function requestOneTimePurchase(params) {
+  const { options, onEvent, onError } = params;
+  const sku = options.sku ?? options.productId;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: (params2) => {
+        onEvent({ type: "purchased", data: params2 });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
+}
+function createOneTimePurchaseOrder(params) {
+  const isIAPSupported = isMinVersionSupported({
     android: "5.219.0",
     ios: "5.219.0"
   });
-  if (!isSupported) {
-    return;
+  if (!isIAPSupported) {
+    return import_es_toolkit3.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 = () => {
+      AppsInTossModule.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 import_es_toolkit3.noop;
+    };
+    return v1();
   }
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: async (params2) => {
+        const isProductGranted = await options.processProductGrant(params2);
+        await AppsInTossModule.processProductGrant({ orderId: params2.orderId, isProductGranted });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
 }
 async function getProductItemList() {
   const isSupported = isMinVersionSupported({
@@ -808,7 +851,7 @@ var Storage = {
 };
 
 // src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
-var import_react_native11 = require("@granite-js/react-native");
+var import_react_native9 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/constants.ts
 var GAME_CENTER_MIN_VERSION = {
@@ -828,7 +871,7 @@ async function openGameCenterLeaderboard() {
   const url = new URL("servicetoss://game-center/leaderboard?_navbar=hide");
   url.searchParams.set("appName", appName);
   url.searchParams.set("referrer", `appsintoss.${appName}`);
-  return (0, import_react_native11.openURL)(url.toString());
+  return (0, import_react_native9.openURL)(url.toString());
 }
 
 // src/AppsInTossModule/native-modules/getGameCenterGameProfile.ts
@@ -901,8 +944,8 @@ function onVisibilityChangedByTransparentServiceWeb(eventParams) {
 }
 
 // src/BedrockModule/native-modules/natives/BedrockModule.ts
-var import_react_native12 = require("react-native");
-var BedrockModule = import_react_native12.NativeModules.BedrockModule;
+var import_react_native10 = require("react-native");
+var BedrockModule = import_react_native10.NativeModules.BedrockModule;
 
 // src/BedrockModule/native-modules/natives/closeView.ts
 async function closeView() {
@@ -910,10 +953,10 @@ async function closeView() {
 }
 
 // src/BedrockModule/native-modules/natives/getLocale.ts
-var import_react_native13 = require("react-native");
+var import_react_native11 = require("react-native");
 function getLocale() {
   const locale = BedrockModule?.DeviceInfo?.locale ?? "ko-KR";
-  if (import_react_native13.Platform.OS === "android") {
+  if (import_react_native11.Platform.OS === "android") {
     return replaceUnderbarToHypen(locale);
   }
   return locale;
@@ -961,24 +1004,24 @@ async function setIosSwipeGestureEnabled(options) {
 }
 
 // src/BedrockModule/native-modules/natives/openURL.ts
-var import_react_native14 = require("react-native");
+var import_react_native12 = require("react-native");
 function openURL2(url) {
-  return import_react_native14.Linking.openURL(url);
+  return import_react_native12.Linking.openURL(url);
 }
 
 // src/BedrockModule/native-modules/natives/getPlatformOS.ts
-var import_react_native15 = require("react-native");
+var import_react_native13 = require("react-native");
 function getPlatformOS() {
-  return import_react_native15.Platform.OS;
+  return import_react_native13.Platform.OS;
 }
 
 // src/BedrockModule/native-modules/core/BedrockCoreModule.ts
-var import_react_native16 = require("react-native");
-var BedrockCoreModule = import_react_native16.NativeModules.BedrockCoreModule;
+var import_react_native14 = require("react-native");
+var BedrockCoreModule = import_react_native14.NativeModules.BedrockCoreModule;
 
 // src/AppsInTossModule/native-modules/tossCore.ts
-var import_react_native17 = require("react-native");
-var TossCoreModule = import_react_native17.NativeModules.TossCoreModule;
+var import_react_native15 = require("react-native");
+var TossCoreModule = import_react_native15.NativeModules.TossCoreModule;
 function tossCoreEventLog(params) {
   const supported = isMinVersionSupported({ ios: "5.210.0", android: "5.210.0" });
   const isSandbox = getOperationalEnvironment() === "sandbox";
@@ -1030,11 +1073,14 @@ var INTERNAL__module = {
   getSchemeUri,
   getTossAppVersion,
   getTossShareLink,
+  iapCreateOneTimePurchaseOrder,
   isMinVersionSupported,
   onVisibilityChangedByTransparentServiceWeb,
   openCamera,
   openGameCenterLeaderboard,
   openURL,
+  processProductGrant,
+  requestOneTimePurchase,
   saveBase64Data,
   setClipboardText,
   setDeviceOrientation,

package/dist/index.d.cts

@@ -231,24 +231,12 @@ interface ContactsViralParams {
  */
 declare function contactsViral(params: ContactsViralParams): () => void;
 
-declare class BackButtonClickHandleEvent extends GraniteEventDefinition<undefined, undefined> {
-    name: "backButtonClickEvent";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
 declare class EntryMessageExitedEvent extends GraniteEventDefinition<undefined, undefined> {
     name: "entryMessageExited";
     remove(): void;
     listener(_: undefined): void;
 }
 
-declare class HomeIconButtonClickHandleEvent extends GraniteEventDefinition<undefined, undefined> {
-    name: "homeIconButtonClickEvent";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
 interface StartUpdateLocationOptions {
     /**
      * 위치 정확도를 설정해요.
@@ -298,7 +286,7 @@ declare class VisibilityChangedByTransparentServiceWebEvent extends GraniteEvent
     private isVisibilityChangedByTransparentServiceWebResult;
 }
 
-declare const appsInTossEvent: GraniteEvent<BackButtonClickHandleEvent | EntryMessageExitedEvent | HomeIconButtonClickHandleEvent | UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
+declare const appsInTossEvent: GraniteEvent<EntryMessageExitedEvent | UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
 
 declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
     options: {
@@ -1423,16 +1411,16 @@ type GameCenterGameProfileResponse = {
  */
 declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;
 
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-interface IapCreateOneTimePurchaseOrderOptions {
+type Sku = {
+    /**
+     * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+     */
     productId: string;
-}
+    sku?: string;
+} | {
+    productId?: never;
+    sku: string;
+};
 /**
  * @public
  * @category 인앱결제
@@ -1455,15 +1443,54 @@ interface IapCreateOneTimePurchaseOrderResult {
     fraction: number;
     miniAppIconUrl: string | null;
 }
+interface SuccessEvent {
+    type: 'success';
+    data: IapCreateOneTimePurchaseOrderResult;
+}
+interface PurchasedEvent {
+    type: 'purchased';
+    data: {
+        orderId: string;
+    };
+}
+/**
+ * @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>;
+}
+interface IapRequestOneTimePurchaseOptions {
+    options: Sku;
+    onEvent: (event: PurchasedEvent | SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+declare function iapCreateOneTimePurchaseOrder(params: Sku): Promise<IapCreateOneTimePurchaseOrderResult>;
+declare function processProductGrant(params: {
+    orderId: string;
+    isProductGranted: boolean;
+}): Promise<void>;
+declare function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions): () => void;
 /**
  * @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"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -1475,6 +1502,7 @@ interface IapCreateOneTimePurchaseOrderResult {
  * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
  * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
  * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
  *
  * @example
  * ### 특정 인앱결제 주문서 페이지로 이동하기
@@ -1482,28 +1510,39 @@ interface IapCreateOneTimePurchaseOrderResult {
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
  * import { Button } from "@toss-design-system/react-native";
+ * import { useCallback } from "react";
  *
  * interface Props {
- *   productId: string;
+ *   sku: string;
  * }
  *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
+ * function IapCreateOneTimePurchaseOrderButton({ sku }: Props) {
+ *   const handleClick = useCallback(async () => {
+ *
+ *     const cleanup = await IAP.createOneTimePurchaseOrder({
+ *       options: {
+ *        sku,
+ *        processProductGrant: ({ orderId }) => {
+ *         // 상품 지급 로직 작성
+ *          return true; // 상품 지급 여부
+ *        }
+ *        },
+ *       onEvent: (event) => {
+ *         console.log(event);
+ *       },
+ *       onError: (error) => {
+ *         console.error(error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
  *
  *   return <Button onClick={handleClick}>구매하기</Button>;
  * }
  * ```
  */
-declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): Promise<IapCreateOneTimePurchaseOrderResult | undefined>;
+declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): () => void;
 /**
  * @public
  * @category 인앱결제
@@ -1525,7 +1564,7 @@ interface IapProductListItem {
 /**
  * @public
  * @category 인앱결제
- * @name iapGetProductItemList
+ * @name getProductItemList
  * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
  * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
  *
@@ -1773,10 +1812,24 @@ interface Spec extends TurboModule {
     }) => Promise<void>;
     saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
     /** IAP */
-    iapCreateOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => Promise<IapCreateOneTimePurchaseOrderResult>;
     iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{
         products: IapProductListItem[];
     }>;
+    /** @deprecated `requestOneTimePurchase`를 사용해주세요. */
+    iapCreateOneTimePurchaseOrder: (params: {
+        productId: string;
+    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    requestOneTimePurchase: (params: {
+        sku: string;
+    }, fallbacks: {
+        onPurchased: (params: {
+            orderId: string;
+        }) => void;
+    }) => () => void;
+    processProductGrant: (params: {
+        orderId: string;
+        isProductGranted: boolean;
+    }) => Promise<void>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
@@ -3195,4 +3248,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -231,24 +231,12 @@ interface ContactsViralParams {
  */
 declare function contactsViral(params: ContactsViralParams): () => void;
 
-declare class BackButtonClickHandleEvent extends GraniteEventDefinition<undefined, undefined> {
-    name: "backButtonClickEvent";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
 declare class EntryMessageExitedEvent extends GraniteEventDefinition<undefined, undefined> {
     name: "entryMessageExited";
     remove(): void;
     listener(_: undefined): void;
 }
 
-declare class HomeIconButtonClickHandleEvent extends GraniteEventDefinition<undefined, undefined> {
-    name: "homeIconButtonClickEvent";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
 interface StartUpdateLocationOptions {
     /**
      * 위치 정확도를 설정해요.
@@ -298,7 +286,7 @@ declare class VisibilityChangedByTransparentServiceWebEvent extends GraniteEvent
     private isVisibilityChangedByTransparentServiceWebResult;
 }
 
-declare const appsInTossEvent: GraniteEvent<BackButtonClickHandleEvent | EntryMessageExitedEvent | HomeIconButtonClickHandleEvent | UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
+declare const appsInTossEvent: GraniteEvent<EntryMessageExitedEvent | UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
 
 declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
     options: {
@@ -1423,16 +1411,16 @@ type GameCenterGameProfileResponse = {
  */
 declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;
 
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-interface IapCreateOneTimePurchaseOrderOptions {
+type Sku = {
+    /**
+     * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+     */
     productId: string;
-}
+    sku?: string;
+} | {
+    productId?: never;
+    sku: string;
+};
 /**
  * @public
  * @category 인앱결제
@@ -1455,15 +1443,54 @@ interface IapCreateOneTimePurchaseOrderResult {
     fraction: number;
     miniAppIconUrl: string | null;
 }
+interface SuccessEvent {
+    type: 'success';
+    data: IapCreateOneTimePurchaseOrderResult;
+}
+interface PurchasedEvent {
+    type: 'purchased';
+    data: {
+        orderId: string;
+    };
+}
+/**
+ * @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>;
+}
+interface IapRequestOneTimePurchaseOptions {
+    options: Sku;
+    onEvent: (event: PurchasedEvent | SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+declare function iapCreateOneTimePurchaseOrder(params: Sku): Promise<IapCreateOneTimePurchaseOrderResult>;
+declare function processProductGrant(params: {
+    orderId: string;
+    isProductGranted: boolean;
+}): Promise<void>;
+declare function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions): () => void;
 /**
  * @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"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -1475,6 +1502,7 @@ interface IapCreateOneTimePurchaseOrderResult {
  * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
  * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
  * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
  *
  * @example
  * ### 특정 인앱결제 주문서 페이지로 이동하기
@@ -1482,28 +1510,39 @@ interface IapCreateOneTimePurchaseOrderResult {
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
  * import { Button } from "@toss-design-system/react-native";
+ * import { useCallback } from "react";
  *
  * interface Props {
- *   productId: string;
+ *   sku: string;
  * }
  *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
+ * function IapCreateOneTimePurchaseOrderButton({ sku }: Props) {
+ *   const handleClick = useCallback(async () => {
+ *
+ *     const cleanup = await IAP.createOneTimePurchaseOrder({
+ *       options: {
+ *        sku,
+ *        processProductGrant: ({ orderId }) => {
+ *         // 상품 지급 로직 작성
+ *          return true; // 상품 지급 여부
+ *        }
+ *        },
+ *       onEvent: (event) => {
+ *         console.log(event);
+ *       },
+ *       onError: (error) => {
+ *         console.error(error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
  *
  *   return <Button onClick={handleClick}>구매하기</Button>;
  * }
  * ```
  */
-declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): Promise<IapCreateOneTimePurchaseOrderResult | undefined>;
+declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): () => void;
 /**
  * @public
  * @category 인앱결제
@@ -1525,7 +1564,7 @@ interface IapProductListItem {
 /**
  * @public
  * @category 인앱결제
- * @name iapGetProductItemList
+ * @name getProductItemList
  * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
  * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
  *
@@ -1773,10 +1812,24 @@ interface Spec extends TurboModule {
     }) => Promise<void>;
     saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
     /** IAP */
-    iapCreateOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => Promise<IapCreateOneTimePurchaseOrderResult>;
     iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{
         products: IapProductListItem[];
     }>;
+    /** @deprecated `requestOneTimePurchase`를 사용해주세요. */
+    iapCreateOneTimePurchaseOrder: (params: {
+        productId: string;
+    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    requestOneTimePurchase: (params: {
+        sku: string;
+    }, fallbacks: {
+        onPurchased: (params: {
+            orderId: string;
+        }) => void;
+    }) => () => void;
+    processProductGrant: (params: {
+        orderId: string;
+        isProductGranted: boolean;
+    }) => Promise<void>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
@@ -3195,4 +3248,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -1,20 +1,9 @@
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
 import { GraniteEvent } from "@granite-js/react-native";
 
-// src/AppsInTossModule/native-event-emitter/event-plugins/BackButtonClickHandleEvent.ts
-import { GraniteEventDefinition } from "@granite-js/react-native";
-var BackButtonClickHandleEvent = class extends GraniteEventDefinition {
-  name = "backButtonClickEvent";
-  remove() {
-  }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_) {
-  }
-};
-
 // src/AppsInTossModule/native-event-emitter/event-plugins/EntryMessageExitedEvent.ts
-import { GraniteEventDefinition as GraniteEventDefinition2 } from "@granite-js/react-native";
-var EntryMessageExitedEvent = class extends GraniteEventDefinition2 {
+import { GraniteEventDefinition } from "@granite-js/react-native";
+var EntryMessageExitedEvent = class extends GraniteEventDefinition {
   name = "entryMessageExited";
   remove() {
   }
@@ -23,20 +12,9 @@ var EntryMessageExitedEvent = class extends GraniteEventDefinition2 {
   }
 };
 
-// src/AppsInTossModule/native-event-emitter/event-plugins/HomeIconButtonClickHandleEvent.ts
-import { GraniteEventDefinition as GraniteEventDefinition3 } from "@granite-js/react-native";
-var HomeIconButtonClickHandleEvent = class extends GraniteEventDefinition3 {
-  name = "homeIconButtonClickEvent";
-  remove() {
-  }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_) {
-  }
-};
-
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
 import { GetCurrentLocationPermissionError } from "@apps-in-toss/types";
-import { GraniteEventDefinition as GraniteEventDefinition4 } from "@granite-js/react-native";
+import { GraniteEventDefinition as GraniteEventDefinition2 } from "@granite-js/react-native";
 
 // src/AppsInTossModule/native-modules/AppsInTossModule.ts
 import { TurboModuleRegistry } from "react-native";
@@ -71,7 +49,7 @@ import { NativeEventEmitter } from "react-native";
 var nativeEventEmitter = new NativeEventEmitter(AppsInTossModuleInstance);
 
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
-var UpdateLocationEvent = class extends GraniteEventDefinition4 {
+var UpdateLocationEvent = class extends GraniteEventDefinition2 {
   name = "updateLocationEvent";
   subscriptionCount = 0;
   ref = {
@@ -101,7 +79,7 @@ var UpdateLocationEvent = class extends GraniteEventDefinition4 {
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
-import { GraniteEventDefinition as GraniteEventDefinition5 } from "@granite-js/react-native";
+import { GraniteEventDefinition as GraniteEventDefinition3 } from "@granite-js/react-native";
 
 // src/utils/generateUUID.ts
 function generateUUID(placeholder) {
@@ -163,7 +141,7 @@ var INTERNAL__appBridgeHandler = {
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
 var UNSAFE__nativeEventEmitter = nativeEventEmitter;
-var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends GraniteEventDefinition5 {
+var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends GraniteEventDefinition3 {
   static INTERNAL__appBridgeSubscription;
   name = "appBridgeCallbackEvent";
   constructor() {
@@ -193,8 +171,8 @@ var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends GraniteEventD
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/VisibilityChangedByTransparentServiceWebEvent.ts
-import { GraniteEventDefinition as GraniteEventDefinition6 } from "@granite-js/react-native";
-var VisibilityChangedByTransparentServiceWebEvent = class extends GraniteEventDefinition6 {
+import { GraniteEventDefinition as GraniteEventDefinition4 } from "@granite-js/react-native";
+var VisibilityChangedByTransparentServiceWebEvent = class extends GraniteEventDefinition4 {
   name = "onVisibilityChangedByTransparentServiceWeb";
   subscription = null;
   remove() {
@@ -222,9 +200,6 @@ var VisibilityChangedByTransparentServiceWebEvent = class extends GraniteEventDe
 var appsInTossEvent = new GraniteEvent([
   new UpdateLocationEvent(),
   new EntryMessageExitedEvent(),
-  // Navigation Bar events
-  new HomeIconButtonClickHandleEvent(),
-  new BackButtonClickHandleEvent(),
   // Internal events
   new AppBridgeCallbackEvent(),
   new VisibilityChangedByTransparentServiceWebEvent()
@@ -665,15 +640,80 @@ async function getTossShareLink(path) {
 }
 
 // src/AppsInTossModule/native-modules/iap.ts
-async function createOneTimePurchaseOrder(params) {
-  const isSupported = isMinVersionSupported({
+import { noop as noop3 } from "es-toolkit";
+function iapCreateOneTimePurchaseOrder(params) {
+  const sku = params.sku ?? params.productId;
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+}
+function processProductGrant(params) {
+  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+}
+function requestOneTimePurchase(params) {
+  const { options, onEvent, onError } = params;
+  const sku = options.sku ?? options.productId;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: (params2) => {
+        onEvent({ type: "purchased", data: params2 });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
+}
+function createOneTimePurchaseOrder(params) {
+  const isIAPSupported = isMinVersionSupported({
     android: "5.219.0",
     ios: "5.219.0"
   });
-  if (!isSupported) {
-    return;
+  if (!isIAPSupported) {
+    return noop3;
   }
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  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 = () => {
+      AppsInTossModule.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 noop3;
+    };
+    return v1();
+  }
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: async (params2) => {
+        const isProductGranted = await options.processProductGrant(params2);
+        await AppsInTossModule.processProductGrant({ orderId: params2.orderId, isProductGranted });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
 }
 async function getProductItemList() {
   const isSupported = isMinVersionSupported({
@@ -960,11 +1000,14 @@ export {
   getSchemeUri,
   getTossAppVersion,
   getTossShareLink,
+  iapCreateOneTimePurchaseOrder,
   isMinVersionSupported,
   onVisibilityChangedByTransparentServiceWeb,
   openCamera,
   openGameCenterLeaderboard,
   openURL2 as openURL,
+  processProductGrant,
+  requestOneTimePurchase,
   saveBase64Data,
   setClipboardText,
   setDeviceOrientation,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -43,7 +43,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "^1.1.1",
+    "@apps-in-toss/types": "^1.1.3",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0e0af7d44ed8ad2615a237650b9682c68ab5861e"
+  "gitHead": "0c80b4a0b49ec85f9f042909c7e9762c25425573"
 }

package/src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts

@@ -1,7 +1,5 @@
 import { GraniteEvent } from '@granite-js/react-native';
-import { BackButtonClickHandleEvent } from './event-plugins/BackButtonClickHandleEvent';
 import { EntryMessageExitedEvent } from './event-plugins/EntryMessageExitedEvent';
-import { HomeIconButtonClickHandleEvent } from './event-plugins/HomeIconButtonClickHandleEvent';
 import { UpdateLocationEvent } from './event-plugins/UpdateLocationEvent';
 import { AppBridgeCallbackEvent } from './internal/AppBridgeCallbackEvent';
 import { VisibilityChangedByTransparentServiceWebEvent } from './internal/VisibilityChangedByTransparentServiceWebEvent';
@@ -10,10 +8,6 @@ export const appsInTossEvent = new GraniteEvent([
   new UpdateLocationEvent(),
   new EntryMessageExitedEvent(),
 
-  // Navigation Bar events
-  new HomeIconButtonClickHandleEvent(),
-  new BackButtonClickHandleEvent(),
-
   // Internal events
   new AppBridgeCallbackEvent(),
   new VisibilityChangedByTransparentServiceWebEvent(),

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

@@ -15,11 +15,7 @@ import type {
 import { TurboModuleRegistry, type TurboModule as __TurboModule } from 'react-native';
 import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './checkoutPayment';
 import type { GameCenterGameProfileResponse } from './getGameCenterGameProfile';
-import type {
-  IapCreateOneTimePurchaseOrderOptions,
-  IapCreateOneTimePurchaseOrderResult,
-  IapProductListItem,
-} from './iap';
+import { IapCreateOneTimePurchaseOrderResult, IapProductListItem } from './iap';
 import type { SaveBase64DataParams } from './saveBase64Data';
 import type { SubmitGameCenterLeaderBoardScoreResponse } from './submitGameCenterLeaderBoardScore';
 import type { ContactsViralParams } from '../native-event-emitter/contactsViral';
@@ -68,10 +64,15 @@ interface Spec extends __TurboModule {
   saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
 
   /** IAP */
-  iapCreateOneTimePurchaseOrder: (
-    params: IapCreateOneTimePurchaseOrderOptions
-  ) => Promise<IapCreateOneTimePurchaseOrderResult>;
   iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{ products: IapProductListItem[] }>;
+  /** @deprecated `requestOneTimePurchase`를 사용해주세요. */
+  iapCreateOneTimePurchaseOrder: (params: { productId: string }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+  requestOneTimePurchase: (
+    params: { sku: string },
+    fallbacks: { onPurchased: (params: { orderId: string }) => void }
+  ) => () => void;
+  processProductGrant: (params: { orderId: string; isProductGranted: boolean }) => Promise<void>;
+
   getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
   submitGameCenterLeaderBoardScore: (params: { score: string }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;
 

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

@@ -1,16 +1,20 @@
+import { noop } from 'es-toolkit';
 import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { INTERNAL__appBridgeHandler } from '../native-event-emitter/internal/appBridge';
 
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-export interface IapCreateOneTimePurchaseOrderOptions {
-  productId: string;
-}
+type Sku =
+  | {
+      /**
+       * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+       */
+      productId: string;
+      sku?: string;
+    }
+  | {
+      productId?: never;
+      sku: string;
+    };
 
 /**
  * @public
@@ -35,15 +39,78 @@ export interface IapCreateOneTimePurchaseOrderResult {
   miniAppIconUrl: string | null;
 }
 
+interface SuccessEvent {
+  type: 'success';
+  data: IapCreateOneTimePurchaseOrderResult;
+}
+
+interface PurchasedEvent {
+  type: 'purchased';
+  data: { orderId: string };
+}
+
 /**
  * @public
  * @category 인앱결제
- * @name iapCreateOneTimePurchaseOrder
+ * @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 - 결제 과정에서 에러가 발생했을 때 호출해요. 에러 객체를 받아서 로깅하거나 복구 절차를 실행할 수 있어요.
+ */
+export interface IapCreateOneTimePurchaseOrderOptions {
+  options: Sku & { processProductGrant: (params: { orderId: string }) => boolean | Promise<boolean> };
+  onEvent: (event: SuccessEvent) => void | Promise<void>;
+  onError: (error: unknown) => void | Promise<void>;
+}
+
+interface IapRequestOneTimePurchaseOptions {
+  options: Sku;
+  onEvent: (event: PurchasedEvent | SuccessEvent) => void | Promise<void>;
+  onError: (error: unknown) => void | Promise<void>;
+}
+
+export function iapCreateOneTimePurchaseOrder(params: Sku) {
+  const sku = (params.sku ?? params.productId) as string;
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+}
+
+export function processProductGrant(params: { orderId: string; isProductGranted: boolean }) {
+  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+}
+
+export function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions) {
+  const { options, onEvent, onError } = params;
+  const sku = (options.sku ?? options.productId) as string;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    'requestOneTimePurchase',
+    { sku },
+    {
+      onPurchased: (params: { orderId: string }) => {
+        onEvent({ type: 'purchased', data: params });
+      },
+      onSuccess: (result: IapCreateOneTimePurchaseOrderResult) => {
+        onEvent({ type: 'success', data: result });
+      },
+      onError: (error: any) => {
+        onError(error);
+      },
+    }
+  );
+
+  return unregisterCallbacks;
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @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"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -55,6 +122,7 @@ export interface IapCreateOneTimePurchaseOrderResult {
  * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
  * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
  * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
  *
  * @example
  * ### 특정 인앱결제 주문서 페이지로 이동하기
@@ -62,38 +130,96 @@ export interface IapCreateOneTimePurchaseOrderResult {
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
  * import { Button } from "@toss-design-system/react-native";
+ * import { useCallback } from "react";
  *
  * interface Props {
- *   productId: string;
+ *   sku: string;
  * }
  *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
+ * function IapCreateOneTimePurchaseOrderButton({ sku }: Props) {
+ *   const handleClick = useCallback(async () => {
+ *
+ *     const cleanup = await IAP.createOneTimePurchaseOrder({
+ *       options: {
+ *        sku,
+ *        processProductGrant: ({ orderId }) => {
+ *         // 상품 지급 로직 작성
+ *          return true; // 상품 지급 여부
+ *        }
+ *        },
+ *       onEvent: (event) => {
+ *         console.log(event);
+ *       },
+ *       onError: (error) => {
+ *         console.error(error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
  *
  *   return <Button onClick={handleClick}>구매하기</Button>;
  * }
  * ```
  */
-async function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions) {
-  const isSupported = isMinVersionSupported({
+function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions) {
+  const isIAPSupported = isMinVersionSupported({
     android: '5.219.0',
     ios: '5.219.0',
   });
 
-  if (!isSupported) {
-    return;
+  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) as string;
+
+  if (!isProcessProductGrantSupported) {
+    const v1 = () => {
+      AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku })
+        .then((response: IapCreateOneTimePurchaseOrderResult) => {
+          Promise.resolve(options.processProductGrant({ orderId: response.orderId }))
+            .then(() => {
+              onEvent({ type: 'success', data: response });
+            })
+            .catch((error: unknown) => {
+              onError(error);
+            });
+        })
+        .catch((error: unknown) => {
+          onError(error);
+        });
+
+      return noop;
+    };
+
+    return v1();
   }
 
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    'requestOneTimePurchase',
+    { sku },
+    {
+      onPurchased: async (params: { orderId: string }) => {
+        const isProductGranted = await options.processProductGrant(params);
+        await AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted });
+      },
+      onSuccess: (result: IapCreateOneTimePurchaseOrderResult) => {
+        onEvent({ type: 'success', data: result });
+      },
+      onError: (error: unknown) => {
+        onError(error);
+      },
+    }
+  );
+
+  return unregisterCallbacks;
 }
 
 /**
@@ -118,7 +244,7 @@ export interface IapProductListItem {
 /**
  * @public
  * @category 인앱결제
- * @name iapGetProductItemList
+ * @name getProductItemList
  * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
  * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
  *

package/src/AppsInTossModule/native-event-emitter/event-plugins/BackButtonClickHandleEvent.ts

@@ -1,10 +0,0 @@
-import { GraniteEventDefinition } from '@granite-js/react-native';
-
-export class BackButtonClickHandleEvent extends GraniteEventDefinition<undefined, undefined> {
-  name = 'backButtonClickEvent' as const;
-
-  remove() {}
-
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_: undefined) {}
-}

package/src/AppsInTossModule/native-event-emitter/event-plugins/HomeIconButtonClickHandleEvent.ts

@@ -1,10 +0,0 @@
-import { GraniteEventDefinition } from '@granite-js/react-native';
-
-export class HomeIconButtonClickHandleEvent extends GraniteEventDefinition<undefined, undefined> {
-  name = 'homeIconButtonClickEvent' as const;
-
-  remove() {}
-
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_: undefined) {}
-}