@apps-in-toss/native-modules 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @apps-in-toss/native-modules
 
+## 1.9.0
+
+## 1.8.1
+
 ## 1.8.0
 
 ### Minor Changes

package/dist/bridges-meta.json

@@ -119,6 +119,10 @@
     "identifier": "grantPromotionRewardForGame",
     "dts": "export interface GrantPromotionRewardForGameSuccessResponse {\n\tkey: string;\n}\nexport interface GrantPromotionRewardForGameErrorResponse {\n\tcode: string;\n\t[key: string]: any;\n}\nexport interface GrantPromotionRewardForGameErrorResult {\n\terrorCode: string;\n\tmessage: string;\n}\nexport type GrantPromotionRewardForGameResponse = GrantPromotionRewardForGameSuccessResponse | GrantPromotionRewardForGameErrorResponse;\nexport type GrantPromotionRewardForGameResult = GrantPromotionRewardForGameResponse | GrantPromotionRewardForGameErrorResult | \"ERROR\" | undefined;\n/**\n * @public\n * @category 게임\n * @name grantPromotionRewardForGame\n * @description\n * 이 함수를 사용하면 게임 카테고리 미니앱에서 프로모션 코드를 사용해서 유저에게 리워드를 지급할 수 있어요.\n * 게임 카테고리가 아닌 미니앱에서 호출할 수 없어요.\n * @param {{ params: { promotionCode: string; amount: number } }} params - 포인트를 지급하기 위해 필요한 정보예요.\n * @param {string} params.promotionCode - 프로모션 코드예요.\n * @param {number} params.amount - 지급할 포인트 금액이에요.\n * @returns {Promise<{ key: string } | { errorCode: string; message: string } | 'ERROR' | undefined>}\n * 포인트 지급 결과를 반환해요.\n * - `{ key: string }`: 포인트 지급에 성공했어요. key는 리워드 키를 의미해요.\n * - `{ errorCode: string, message: string }`: 포인트 지급에 실패했어요. 에러 코드는 다음과 같아요.\n *   - `\"40000\"`: 게임이 아닌 미니앱에서 호출했을 때\n *   - `\"4100\"`: 프로모션 정보를 찾을 수 없을 때\n *   - `\"4104\"`: 프로모션이 중지되었을 때\n *   - `\"4105\"`: 프로모션이 종료되었을 때\n *   - `\"4108\"`: 프로모션이 승인되지 않았을 때\n *   - `\"4109\"`: 프로모션이 실행중이 아닐 때\n *   - `\"4110\"`: 리워드를 지급/회수할 수 없을 때\n *   - `\"4112\"`: 프로모션 머니가 부족할 때\n *   - `\"4113\"`: 이미 지급/회수된 내역일 때\n *   - `\"4114\"`: 프로모션에 설정된 1회 지급 금액을 초과할 때\n * - `'ERROR'`: 알 수 없는 오류가 발생했어요.\n * - `undefined`: 앱 버전이 최소 지원 버전보다 낮아요.\n * @example\n * ```tsx\n * // react-native\n * import { Button } from 'react-native';\n * import { grantPromotionRewardForGame } from '@apps-in-toss/framework';\n *\n * function GrantRewardButton() {\n *   async function handlePress() {\n *       const result = await grantPromotionRewardForGame({\n *         params: {\n *           promotionCode: 'GAME_EVENT_2024',\n *           amount: 1000,\n *         },\n *       });\n *\n *       if (!result) {\n *         console.warn('지원하지 않는 앱 버전이에요.');\n *         return;\n *       }\n *\n *       if (result === 'ERROR') {\n *         console.error('포인트 지급 중 알 수 없는 오류가 발생했어요.');\n *         return;\n *       }\n *\n *       if ('key' in result) {\n *         console.log('포인트 지급 성공!', result.key);\n *       } else if ('errorCode' in result) {\n *         console.error('포인트 지급 실패:', result.errorCode, result.message);\n *       }\n *   }\n *\n *   return <Button onPress={handlePress} title=\"포인트 지급하기\" />;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // webview\n * import { grantPromotionRewardForGame } from '@apps-in-toss/web-framework';\n *\n * function GrantRewardButton() {\n *   async function handleClick() {\n *       const result = await grantPromotionRewardForGame({\n *         params: {\n *           promotionCode: 'GAME_EVENT_2024',\n *           amount: 1000,\n *         },\n *       });\n *\n *       if (!result) {\n *         console.warn('지원하지 않는 앱 버전이에요.');\n *         return;\n *       }\n *\n *       if (result === 'ERROR') {\n *         console.error('포인트 지급 중 알 수 없는 오류가 발생했어요.');\n *         return;\n *       }\n *\n *       if ('key' in result) {\n *         console.log('포인트 지급 성공!', result.key);\n *       } else if ('errorCode' in result) {\n *         console.error('포인트 지급 실패:', result.errorCode, result.message);\n *       }\n *   }\n *\n *   return (\n *     <button onClick={handleClick}>포인트 지급하기</button>\n *   );\n * }\n * ```\n */\nexport declare function grantPromotionRewardForGame({ params, }: {\n\tparams: {\n\t\tpromotionCode: string;\n\t\tamount: number;\n\t};\n}): Promise<GrantPromotionRewardForGameResult>;\n\nexport {};\n"
   },
+  {
+    "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": "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

@@ -50,6 +50,7 @@ __export(index_exports, {
   getOperationalEnvironment: () => getOperationalEnvironment,
   getPlatformOS: () => getPlatformOS,
   getSchemeUri: () => getSchemeUri2,
+  getServerTime: () => getServerTime,
   getTossAppVersion: () => getTossAppVersion,
   getTossShareLink: () => getTossShareLink,
   getUserKeyForGame: () => getUserKeyForGame,
@@ -853,6 +854,10 @@ var GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
   android: "5.237.0",
   ios: "5.237.0"
 };
+var GET_SERVER_TIME_MIN_VERSION = {
+  android: "5.245.0",
+  ios: "5.245.0"
+};
 
 // src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
 async function openGameCenterLeaderboard() {
@@ -989,6 +994,16 @@ async function appsInTossSignTossCert(params) {
   await AppsInTossModule.appsInTossSignTossCert({ params });
 }
 
+// src/AppsInTossModule/native-modules/getServerTime.ts
+async function getServerTime() {
+  const isSupported = isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
+  if (!isSupported) {
+    return;
+  }
+  return (await AppsInTossModule.getServerTime({})).serverTime;
+}
+getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
+
 // src/AppsInTossModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -1144,6 +1159,7 @@ var INTERNAL__module = {
   getOperationalEnvironment,
   getPlatformOS,
   getSchemeUri,
+  getServerTime,
   getTossAppVersion,
   getTossShareLink,
   getUserKeyForGame,

package/dist/index.d.cts

@@ -1662,6 +1662,9 @@ interface Spec extends TurboModule {
     appsInTossSignTossCert: (params: {
         params: AppsInTossSignTossCertParams;
     }) => void;
+    getServerTime: (arg: CompatiblePlaceholderArgument) => Promise<{
+        serverTime: number;
+    }>;
 }
 declare const AppsInTossModuleInstance: any;
 declare const AppsInTossModule: Spec;
@@ -2632,6 +2635,42 @@ declare function openGameCenterLeaderboard(): Promise<void>;
  */
 declare function getIsTossLoginIntegratedService(): Promise<boolean | undefined>;
 
+/**
+ * @public
+ * @category 시간
+ * @name getServerTime
+ * @description
+ * 토스 앱 서버의 현재 시간을 Unix timestamp 형식으로 가져와요.
+ * 디바이스 시간이 아닌 서버 기준 시간을 반환하므로 클라이언트 시간 조작에 따른 보상 중복 수령 등의 치팅을 방지할 수 있어요.
+ *
+ * @returns {Promise<number | undefined>} 서버 시간을 Unix timestamp 밀리초 단위로 반환해요. (예: 1705123456789) 지원하지 않는 버전에서는 `undefined`를 반환해요.
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ *
+ * @example
+ * ```tsx
+ * import { getServerTime } from '@apps-in-toss/framework';
+ *
+ * async function checkRewardEligibility() {
+ *   // 버전 체크를 먼저 수행하는 것을 권장해요
+ *   if (!getServerTime.isSupported()) {
+ *     console.log('이 기능은 지원되지 않는 버전입니다.');
+ *     return;
+ *   }
+ *
+ *   const serverTime = await getServerTime();
+ *   const rewardDeadline = 1705200000000;
+ *
+ *   if (serverTime && serverTime > rewardDeadline) {
+ *     console.log('보상 수령 기간이 지났습니다.');
+ *   }
+ * }
+ * ```
+ */
+declare function getServerTime(): Promise<number | undefined>;
+declare namespace getServerTime {
+    var isSupported: () => boolean;
+}
+
 /**
  * @public
  * @category 토스페이
@@ -3122,4 +3161,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -1662,6 +1662,9 @@ interface Spec extends TurboModule {
     appsInTossSignTossCert: (params: {
         params: AppsInTossSignTossCertParams;
     }) => void;
+    getServerTime: (arg: CompatiblePlaceholderArgument) => Promise<{
+        serverTime: number;
+    }>;
 }
 declare const AppsInTossModuleInstance: any;
 declare const AppsInTossModule: Spec;
@@ -2632,6 +2635,42 @@ declare function openGameCenterLeaderboard(): Promise<void>;
  */
 declare function getIsTossLoginIntegratedService(): Promise<boolean | undefined>;
 
+/**
+ * @public
+ * @category 시간
+ * @name getServerTime
+ * @description
+ * 토스 앱 서버의 현재 시간을 Unix timestamp 형식으로 가져와요.
+ * 디바이스 시간이 아닌 서버 기준 시간을 반환하므로 클라이언트 시간 조작에 따른 보상 중복 수령 등의 치팅을 방지할 수 있어요.
+ *
+ * @returns {Promise<number | undefined>} 서버 시간을 Unix timestamp 밀리초 단위로 반환해요. (예: 1705123456789) 지원하지 않는 버전에서는 `undefined`를 반환해요.
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ *
+ * @example
+ * ```tsx
+ * import { getServerTime } from '@apps-in-toss/framework';
+ *
+ * async function checkRewardEligibility() {
+ *   // 버전 체크를 먼저 수행하는 것을 권장해요
+ *   if (!getServerTime.isSupported()) {
+ *     console.log('이 기능은 지원되지 않는 버전입니다.');
+ *     return;
+ *   }
+ *
+ *   const serverTime = await getServerTime();
+ *   const rewardDeadline = 1705200000000;
+ *
+ *   if (serverTime && serverTime > rewardDeadline) {
+ *     console.log('보상 수령 기간이 지났습니다.');
+ *   }
+ * }
+ * ```
+ */
+declare function getServerTime(): Promise<number | undefined>;
+declare namespace getServerTime {
+    var isSupported: () => boolean;
+}
+
 /**
  * @public
  * @category 토스페이
@@ -3122,4 +3161,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, type AppsInTossSignTossCertParams, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type IsAdMobLoadedOptions, type LoadAdMobEvent, type LoadAdMobOptions, type LoadAdMobParams, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobOptions, type ShowAdMobParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -777,6 +777,10 @@ var GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
   android: "5.237.0",
   ios: "5.237.0"
 };
+var GET_SERVER_TIME_MIN_VERSION = {
+  android: "5.245.0",
+  ios: "5.245.0"
+};
 
 // src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
 async function openGameCenterLeaderboard() {
@@ -913,6 +917,16 @@ async function appsInTossSignTossCert(params) {
   await AppsInTossModule.appsInTossSignTossCert({ params });
 }
 
+// src/AppsInTossModule/native-modules/getServerTime.ts
+async function getServerTime() {
+  const isSupported = isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
+  if (!isSupported) {
+    return;
+  }
+  return (await AppsInTossModule.getServerTime({})).serverTime;
+}
+getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
+
 // src/AppsInTossModule/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -1067,6 +1081,7 @@ export {
   getOperationalEnvironment,
   getPlatformOS,
   getSchemeUri2 as getSchemeUri,
+  getServerTime,
   getTossAppVersion,
   getTossShareLink,
   getUserKeyForGame,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.8.0",
+  "version": "1.9.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": "^1.8.0",
+    "@apps-in-toss/types": "^1.9.0",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {

package/src/AppsInTossModule/constants.ts

@@ -19,3 +19,8 @@ export const GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION = {
   android: '5.237.0',
   ios: '5.237.0',
 } as const;
+
+export const GET_SERVER_TIME_MIN_VERSION = {
+  android: '5.245.0',
+  ios: '5.245.0',
+} as const;

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

@@ -93,6 +93,8 @@ interface Spec extends __TurboModule {
 
   /** 토스인증 */
   appsInTossSignTossCert: (params: { params: AppsInTossSignTossCertParams }) => void;
+
+  getServerTime: (arg: CompatiblePlaceholderArgument) => Promise<{ serverTime: number }>;
 }
 
 const Module = TurboModuleRegistry.getEnforcing<Spec>('AppsInTossModule');

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

@@ -0,0 +1,46 @@
+import { AppsInTossModule } from './AppsInTossModule';
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { GET_SERVER_TIME_MIN_VERSION } from '../constants';
+
+/**
+ * @public
+ * @category 시간
+ * @name getServerTime
+ * @description
+ * 토스 앱 서버의 현재 시간을 Unix timestamp 형식으로 가져와요.
+ * 디바이스 시간이 아닌 서버 기준 시간을 반환하므로 클라이언트 시간 조작에 따른 보상 중복 수령 등의 치팅을 방지할 수 있어요.
+ *
+ * @returns {Promise<number | undefined>} 서버 시간을 Unix timestamp 밀리초 단위로 반환해요. (예: 1705123456789) 지원하지 않는 버전에서는 `undefined`를 반환해요.
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ *
+ * @example
+ * ```tsx
+ * import { getServerTime } from '@apps-in-toss/framework';
+ *
+ * async function checkRewardEligibility() {
+ *   // 버전 체크를 먼저 수행하는 것을 권장해요
+ *   if (!getServerTime.isSupported()) {
+ *     console.log('이 기능은 지원되지 않는 버전입니다.');
+ *     return;
+ *   }
+ *
+ *   const serverTime = await getServerTime();
+ *   const rewardDeadline = 1705200000000;
+ *
+ *   if (serverTime && serverTime > rewardDeadline) {
+ *     console.log('보상 수령 기간이 지났습니다.');
+ *   }
+ * }
+ * ```
+ */
+export async function getServerTime(): Promise<number | undefined> {
+  const isSupported = isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
+
+  if (!isSupported) {
+    return;
+  }
+
+  return (await AppsInTossModule.getServerTime({})).serverTime;
+}
+
+getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);

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

@@ -45,6 +45,7 @@ export * from './grantPromotionRewardForGame';
 export * from './getIsTossLoginIntegratedService';
 export * from '../native-event-emitter/contactsViral';
 export * from './appsInTossSignTossCert';
+export * from './getServerTime';
 
 export type {
   CheckoutPaymentOptions,

package/src/async-bridges.ts

@@ -31,3 +31,4 @@ export * from './AppsInTossModule/native-modules/submitGameCenterLeaderBoardScor
 export * from './AppsInTossModule/native-modules/getUserKeyForGame';
 export * from './AppsInTossModule/native-modules/getIsTossLoginIntegratedService';
 export * from './AppsInTossModule/native-modules/grantPromotionRewardForGame';
+export * from './AppsInTossModule/native-modules/getServerTime';