@apps-in-toss/native-modules 2.3.0 → 2.4.0

package/dist/bridges-meta.json

@@ -127,6 +127,10 @@
     "identifier": "getServerTime",
     "dts": "/**\n * @public\n * @category 시간\n * @name getServerTime\n * @description\n * 토스 앱 서버의 현재 시간을 Unix timestamp 형식으로 가져와요.\n * 디바이스 시간이 아닌 서버 기준 시간을 반환하므로 클라이언트 시간 조작에 따른 보상 중복 수령 등의 치팅을 방지할 수 있어요.\n *\n * @returns {Promise<number | undefined>} 서버 시간을 Unix timestamp 밀리초 단위로 반환해요. (예: 1705123456789) 지원하지 않는 버전에서는 `undefined`를 반환해요.\n * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.\n *\n * @example\n * ```tsx\n * import { getServerTime } from '@apps-in-toss/framework';\n *\n * async function checkRewardEligibility() {\n *   // 버전 체크를 먼저 수행하는 것을 권장해요\n *   if (!getServerTime.isSupported()) {\n *     console.log('이 기능은 지원되지 않는 버전입니다.');\n *     return;\n *   }\n *\n *   const serverTime = await getServerTime();\n *   const rewardDeadline = 1705200000000;\n *\n *   if (serverTime && serverTime > rewardDeadline) {\n *     console.log('보상 수령 기간이 지났습니다.');\n *   }\n * }\n * ```\n */\nexport declare function getServerTime(): Promise<number | undefined>;\nexport declare namespace getServerTime {\n\tvar isSupported: () => boolean;\n}\n\nexport {};\n"
   },
+  {
+    "identifier": "requestReview",
+    "dts": "/**\n * @public\n * @category 리뷰\n * @name getServerTime\n * @description\n * 유저에게 미니앱 리뷰를 요청해요.\n *\n * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.\n */\nexport declare function requestReview(): Promise<void>;\nexport declare namespace requestReview {\n\tvar isSupported: () => boolean;\n}\n\nexport {};\n"
+  },
   {
     "identifier": "getLocale",
     "dts": "/**\n * @public\n * @category 언어\n * @kind function\n * @name getLocale\n * @description\n * 사용자의 로케일(locale) 정보를 반환해요. 네이티브 모듈에서 로케일 정보를 가져올 수 없을 때는 기본값으로 'ko-KR'을 반환합니다. 앱의 현지화 및 언어 설정과 관련된 기능을 구현할 때 사용하세요.\n *\n * @returns {string} 사용자의 로케일 정보를 반환해요.\n *\n * @example\n * ### 현재 사용자의 로케일 정보 가져오기\n *\n * ```tsx\n * import { getLocale } from '@apps-in-toss/native-modules';\n * import { Text } from 'react-native';\n *\n * function MyPage() {\n *  const locale = getLocale();\n *\n *  return (\n *    <Text>사용자의 로케일 정보: {locale}</Text>\n *  )\n * }\n *\n * ```\n */\nexport declare function getLocale(): string;\n\nexport {};\n"

package/dist/index.cjs

@@ -62,6 +62,7 @@ __export(index_exports, {
   openURL: () => openURL2,
   processProductGrant: () => processProductGrant,
   requestOneTimePurchase: () => requestOneTimePurchase,
+  requestReview: () => requestReview,
   safePostMessage: () => safePostMessage,
   safeSyncPostMessage: () => safeSyncPostMessage,
   saveBase64Data: () => saveBase64Data,
@@ -1055,6 +1056,21 @@ async function getServerTime() {
 }
 getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
 
+// src/MiniAppModule/native-modules/requestReview.ts
+var MIN_VERSION = { android: "5.253.0", ios: "5.253.0" };
+async function requestReview() {
+  const isSupported = requestReview.isSupported();
+  if (!isSupported) {
+    return;
+  }
+  const brandDisplayName = global.__appsInToss?.brandDisplayName;
+  if (brandDisplayName == null) {
+    throw new Error("requestReview: Not AppsInToss Environment");
+  }
+  return safePostMessage("requestMiniAppReview", { title: brandDisplayName });
+}
+requestReview.isSupported = () => MiniAppModule.getConstants().operationalEnvironment === "toss" && isMinVersionSupported(MIN_VERSION);
+
 // src/MiniAppModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -1213,6 +1229,7 @@ var INTERNAL__module = {
   openURL,
   processProductGrant,
   requestOneTimePurchase,
+  requestReview,
   safePostMessage,
   safeSyncPostMessage,
   saveBase64Data,

package/dist/index.d.cts

@@ -1145,6 +1145,9 @@ interface AsyncMethodsMap {
     shareWithScheme: (params: {
         schemeURL: string;
     }) => Promise<void>;
+    requestMiniAppReview: (params: {
+        title: string;
+    }) => Promise<void>;
 }
 /**
  * Sync Methods Map
@@ -2836,6 +2839,20 @@ declare namespace getServerTime {
     var isSupported: () => boolean;
 }
 
+/**
+ * @public
+ * @category 리뷰
+ * @name getServerTime
+ * @description
+ * 유저에게 미니앱 리뷰를 요청해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ */
+declare function requestReview(): Promise<void>;
+declare namespace requestReview {
+    var isSupported: () => boolean;
+}
+
 /**
  * @public
  * @category 토스페이
@@ -3293,4 +3310,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, requestReview, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -1145,6 +1145,9 @@ interface AsyncMethodsMap {
     shareWithScheme: (params: {
         schemeURL: string;
     }) => Promise<void>;
+    requestMiniAppReview: (params: {
+        title: string;
+    }) => Promise<void>;
 }
 /**
  * Sync Methods Map
@@ -2836,6 +2839,20 @@ declare namespace getServerTime {
     var isSupported: () => boolean;
 }
 
+/**
+ * @public
+ * @category 리뷰
+ * @name getServerTime
+ * @description
+ * 유저에게 미니앱 리뷰를 요청해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ */
+declare function requestReview(): Promise<void>;
+declare namespace requestReview {
+    var isSupported: () => boolean;
+}
+
 /**
  * @public
  * @category 토스페이
@@ -3293,4 +3310,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, requestReview, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -976,6 +976,21 @@ async function getServerTime() {
 }
 getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
 
+// src/MiniAppModule/native-modules/requestReview.ts
+var MIN_VERSION = { android: "5.253.0", ios: "5.253.0" };
+async function requestReview() {
+  const isSupported = requestReview.isSupported();
+  if (!isSupported) {
+    return;
+  }
+  const brandDisplayName = global.__appsInToss?.brandDisplayName;
+  if (brandDisplayName == null) {
+    throw new Error("requestReview: Not AppsInToss Environment");
+  }
+  return safePostMessage("requestMiniAppReview", { title: brandDisplayName });
+}
+requestReview.isSupported = () => MiniAppModule.getConstants().operationalEnvironment === "toss" && isMinVersionSupported(MIN_VERSION);
+
 // src/MiniAppModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -1133,6 +1148,7 @@ export {
   openURL2 as openURL,
   processProductGrant,
   requestOneTimePurchase,
+  requestReview,
   safePostMessage,
   safeSyncPostMessage,
   saveBase64Data,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.3.0",
+    "@apps-in-toss/types": "2.4.0",
     "brick-module": "0.5.0",
     "es-toolkit": "^1.39.3"
   },

package/src/MiniAppModule/native-modules/index.ts

@@ -44,9 +44,9 @@ export * from './getIsTossLoginIntegratedService';
 export * from '../native-event-emitter/contactsViral';
 export * from './appsInTossSignTossCert';
 export * from './getGroupId';
-
 export * from './shareWithScheme';
 export * from './getServerTime';
+export * from './requestReview';
 
 export type {
   CheckoutPaymentOptions,

package/src/MiniAppModule/native-modules/requestReview.ts

@@ -0,0 +1,33 @@
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { MiniAppModule, safePostMessage } from '../../natives';
+
+const MIN_VERSION = { android: '5.253.0', ios: '5.253.0' } as const;
+
+/**
+ * @public
+ * @category 리뷰
+ * @name getServerTime
+ * @description
+ * 유저에게 미니앱 리뷰를 요청해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ */
+export async function requestReview(): Promise<void> {
+  const isSupported = requestReview.isSupported();
+
+  if (!isSupported) {
+    return;
+  }
+
+  const brandDisplayName = global.__appsInToss?.brandDisplayName;
+
+  if (brandDisplayName == null) {
+    throw new Error('requestReview: Not AppsInToss Environment');
+  }
+
+  return safePostMessage('requestMiniAppReview', { title: brandDisplayName });
+}
+requestReview.isSupported = () =>
+  MiniAppModule.getConstants().operationalEnvironment === 'toss' && isMinVersionSupported(MIN_VERSION);
+
+declare const global: { __granite: any; __appsInToss: any };

package/src/MiniAppModule/postMessage.ts

@@ -95,6 +95,7 @@ export interface AsyncMethodsMap {
 
   getServerTime: (params: CompatiblePlaceholderArgument) => Promise<{ serverTime: number }>;
   shareWithScheme: (params: { schemeURL: string }) => Promise<void>;
+  requestMiniAppReview: (params: { title: string }) => Promise<void>;
 }
 
 /**

package/src/async-bridges.ts

@@ -33,3 +33,4 @@ export * from './MiniAppModule/native-modules/grantPromotionReward';
 export * from './MiniAppModule/native-modules/grantPromotionRewardForGame';
 export * from './MiniAppModule/native-modules/getIsTossLoginIntegratedService';
 export * from './MiniAppModule/native-modules/getServerTime';
+export * from './MiniAppModule/native-modules/requestReview';