@apps-in-toss/native-modules 1.1.2 → 1.2.0

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 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 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"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -55,45 +122,104 @@ 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
  * ### 특정 인앱결제 주문서 페이지로 이동하기
  *
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
- * import { Button } from "@toss-design-system/react-native";
+ * import { Button } from "@toss/tds-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;
   }
 
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  const isProcessProductGrantSupported = isMinVersionSupported({
+    android: '5.231.1',
+    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();
+  }
+
+  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;
 }
 
 /**
@@ -101,7 +227,7 @@ async function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderO
  * @category 인앱결제
  * @name IapProductListItem
  * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
- * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/native-modules/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html)를 호출할때 사용하는 `productId`와 동일한 값이에요.
+ * @property {string} sku - 상품의 고유 ID예요.
  * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
  * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
  * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
@@ -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`를 반환해요.
  *
@@ -127,7 +253,7 @@ export interface IapProductListItem {
  *
  * ```tsx
  * import { IAP, IapProductListItem } from "@apps-in-toss/framework";
- * import { Button, List, ListRow } from "@toss-design-system/react-native";
+ * import { Button, List, ListRow } from "@toss/tds-react-native";
  * import { useEffect, useState } from "react";
  *
  * function IapProductList() {
@@ -199,6 +325,94 @@ async function getProductItemList() {
   return AppsInTossModule.iapGetProductItemList({});
 }
 
+/**
+ * @public
+ * @category 인앱결제
+ * @name getPendingOrders
+ * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+ * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 대기 중인 주문 목록 가져오기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const pendingOrders = await IAP.getPendingOrders();
+ *     return pendingOrders;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function getPendingOrders() {
+  const isSupported = isMinVersionSupported({
+    android: '5.231.0',
+    ios: '5.231.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.getPendingOrders({});
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name CompletedOrRefundedOrdersResult
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 나타내는 객체예요. 페이지네이션 정보를 포함해요.
+ * @property {boolean} hasNext 다음 페이지가 있는지 여부예요. `true`면 더 많은 주문이 남아 있어요.
+ * @property {string | null} [nextKey] 다음 주문 목록을 조회할 때 사용할 키예요. 마지막 페이지라면 `null`이거나 생략될 수 있어요.
+ * @property {Array} orders 주문 정보를 담은 배열이에요. 각 요소는 하나의 주문을 나타내요.
+ * @property {string} orders[].orderId 주문의 고유 ID예요.
+ * @property {string} orders[].sku 주문 상품의 고유 ID예요.
+ * @property {'COMPLETED' | 'REFUNDED'} orders[].status 주문의 상태예요. 'COMPLETED'는 주문이 완료된 상태, 'REFUNDED'는 환불된 상태를 의미해요.
+ * @property {string} orders[].date 주문의 날짜 정보예요. ISO 8601 형식(YYYY-MM-DDTHH:mm:ss)을 사용해요. 예를 들어 "2025-09-22T00:00:00" 형식으로 제공돼요. 주문 상태가 `COMPLETED`라면 주문한 날짜를, `REFUNDED`라면 환불한 날짜를 나타내요.
+ */
+export interface CompletedOrRefundedOrdersResult {
+  hasNext: boolean;
+  nextKey?: string | null;
+  orders: { orderId: string; sku: string; status: 'COMPLETED' | 'REFUNDED'; date: string }[];
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name getCompletedOrRefundedOrders
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+ * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ```typescript
+ * import { IAP } from "@apps-in-toss/framework";
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const response =  await IAP.getCompletedOrRefundedOrders();
+ *     return response;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function getCompletedOrRefundedOrders(params?: { key?: string | null }) {
+  const isSupported = isMinVersionSupported({
+    android: '5.231.0',
+    ios: '5.231.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
+}
+
 /**
  * @public
  * @category 인앱결제
@@ -210,4 +424,6 @@ async function getProductItemList() {
 export const IAP = {
   createOneTimePurchaseOrder,
   getProductItemList,
+  getPendingOrders,
+  getCompletedOrRefundedOrders,
 };

package/src/utils/getReferrer.ts

@@ -0,0 +1,9 @@
+import { getSchemeUri } from '@granite-js/react-native';
+
+export function getReferrer() {
+  try {
+    return new URL(getSchemeUri()).searchParams.get('referrer');
+  } catch {
+    return null;
+  }
+}

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) {}
-}