@apps-in-toss/native-modules 0.0.0-dev.1752049503789 → 1.0.0

package/dist/index.js

@@ -164,11 +164,39 @@ var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends GraniteEventD
   }
 };
 
+// src/AppsInTossModule/native-event-emitter/internal/VisibilityChangedByTransparentServiceWebEvent.ts
+import { GraniteEventDefinition as GraniteEventDefinition4 } from "@granite-js/react-native";
+var VisibilityChangedByTransparentServiceWebEvent = class extends GraniteEventDefinition4 {
+  name = "onVisibilityChangedByTransparentServiceWeb";
+  subscription = null;
+  remove() {
+    this.subscription?.remove();
+    this.subscription = null;
+  }
+  listener(options, onEvent, onError) {
+    const subscription = nativeEventEmitter.addListener("visibilityChangedByTransparentServiceWeb", (params) => {
+      if (this.isVisibilityChangedByTransparentServiceWebResult(params)) {
+        if (params.callbackId === options.callbackId) {
+          onEvent(params.isVisible);
+        }
+      } else {
+        onError(new Error("Invalid visibility changed by transparent service web result"));
+      }
+    });
+    this.subscription = subscription;
+  }
+  isVisibilityChangedByTransparentServiceWebResult(params) {
+    return typeof params === "object" && typeof params.callbackId === "string" && typeof params.isVisible === "boolean";
+  }
+};
+
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
 var appsInTossEvent = new GraniteEvent([
-  new AppBridgeCallbackEvent(),
   new UpdateLocationEvent(),
-  new EntryMessageExitedEvent()
+  new EntryMessageExitedEvent(),
+  // Internal events
+  new AppBridgeCallbackEvent(),
+  new VisibilityChangedByTransparentServiceWebEvent()
 ]);
 
 // src/AppsInTossModule/native-event-emitter/startUpdateLocation.ts
@@ -176,14 +204,6 @@ function startUpdateLocation(eventParams) {
   return appsInTossEvent.addEventListener("updateLocationEvent", eventParams);
 }
 
-// src/AppsInTossModule/native-modules/ads/googleAdMob.ts
-import { noop } from "es-toolkit";
-
-// src/AppsInTossModule/native-modules/getOperationalEnvironment.ts
-function getOperationalEnvironment() {
-  return AppsInTossModule.operationalEnvironment;
-}
-
 // src/AppsInTossModule/native-modules/isMinVersionSupported.ts
 import { Platform } from "react-native";
 
@@ -275,6 +295,42 @@ function isMinVersionSupported(minVersions) {
   return compareVersions(currentVersion, minVersion) >= 0;
 }
 
+// src/AppsInTossModule/native-event-emitter/contactsViral.ts
+function contactsViral(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.223.0",
+    ios: "5.223.0"
+  });
+  if (!isSupported) {
+    return () => {
+    };
+  }
+  const { onEvent, onError, options } = params;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("contactsViral", options, {
+    onRewardFromContactsViral: (result) => {
+      onEvent({ type: "sendViral", data: result });
+    },
+    onSuccess: (result) => {
+      onEvent({ type: "close", data: result });
+    },
+    onError
+  });
+  return unregisterCallbacks;
+}
+
+// src/AppsInTossModule/native-event-emitter/internal/onVisibilityChangedByTransparentServiceWeb.ts
+function onVisibilityChangedByTransparentServiceWeb(eventParams) {
+  return appsInTossEvent.addEventListener("onVisibilityChangedByTransparentServiceWeb", eventParams);
+}
+
+// src/AppsInTossModule/native-modules/ads/googleAdMob.ts
+import { noop } from "es-toolkit";
+
+// src/AppsInTossModule/native-modules/getOperationalEnvironment.ts
+function getOperationalEnvironment() {
+  return AppsInTossModule.operationalEnvironment;
+}
+
 // src/AppsInTossModule/native-modules/ads/googleAdMob.ts
 function loadAdMobInterstitialAd(params) {
   if (!loadAdMobInterstitialAd.isSupported()) {
@@ -382,22 +438,54 @@ async function checkoutPayment(options) {
   return AppsInTossModule.checkoutPayment({ params: options });
 }
 
-// src/AppsInTossModule/native-modules/setClipboardText.ts
-async function setClipboardText(text) {
-  const permissionStatus = await requestPermission({ name: "clipboard", access: "write" });
-  if (permissionStatus === "denied") {
-    throw new Error("\uD074\uB9BD\uBCF4\uB4DC \uC4F0\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+// src/AppsInTossModule/native-modules/appLogin.ts
+async function appLogin() {
+  return AppsInTossModule.appLogin({});
+}
+
+// src/AppsInTossModule/native-modules/eventLog.ts
+function normalizeParams(params) {
+  return Object.fromEntries(
+    Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+  );
+}
+async function eventLog(params) {
+  if (AppsInTossModule.operationalEnvironment === "sandbox") {
+    console.log("[eventLogDebug]", {
+      log_name: params.log_name,
+      log_type: params.log_type,
+      params: normalizeParams(params.params)
+    });
+    return;
   }
-  return AppsInTossModule.setClipboardText({ text });
+  const isSupported = isMinVersionSupported({
+    android: "5.208.0",
+    ios: "5.208.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.eventLog({
+    log_name: params.log_name,
+    log_type: params.log_type,
+    params: normalizeParams(params.params)
+  });
 }
 
-// src/AppsInTossModule/native-modules/getClipboardText.ts
-async function getClipboardText() {
-  const permissionStatus = await requestPermission({ name: "clipboard", access: "read" });
+// src/AppsInTossModule/native-modules/fetchAlbumPhotos.ts
+var DEFAULT_MAX_COUNT = 10;
+var DEFAULT_MAX_WIDTH = 1024;
+async function fetchAlbumPhotos(options) {
+  const permissionStatus = await requestPermission({ name: "photos", access: "read" });
   if (permissionStatus === "denied") {
-    throw new Error("\uD074\uB9BD\uBCF4\uB4DC \uC77D\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+    throw new Error("\uC0AC\uC9C4\uCCA9 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
   }
-  return AppsInTossModule.getClipboardText({});
+  const albumPhotos = await AppsInTossModule.fetchAlbumPhotos({
+    ...options,
+    maxCount: options.maxCount ?? DEFAULT_MAX_COUNT,
+    maxWidth: options.maxWidth ?? DEFAULT_MAX_WIDTH
+  });
+  return albumPhotos;
 }
 
 // src/AppsInTossModule/native-modules/fetchContacts.ts
@@ -414,20 +502,13 @@ async function fetchContacts(options) {
   };
 }
 
-// src/AppsInTossModule/native-modules/fetchAlbumPhotos.ts
-var DEFAULT_MAX_COUNT = 10;
-var DEFAULT_MAX_WIDTH = 1024;
-async function fetchAlbumPhotos(options) {
-  const permissionStatus = await requestPermission({ name: "photos", access: "read" });
+// src/AppsInTossModule/native-modules/getClipboardText.ts
+async function getClipboardText() {
+  const permissionStatus = await requestPermission({ name: "clipboard", access: "read" });
   if (permissionStatus === "denied") {
-    throw new Error("\uC0AC\uC9C4\uCCA9 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+    throw new Error("\uD074\uB9BD\uBCF4\uB4DC \uC77D\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
   }
-  const albumPhotos = await AppsInTossModule.fetchAlbumPhotos({
-    ...options,
-    maxCount: options.maxCount ?? DEFAULT_MAX_COUNT,
-    maxWidth: options.maxWidth ?? DEFAULT_MAX_WIDTH
-  });
-  return albumPhotos;
+  return AppsInTossModule.getClipboardText({});
 }
 
 // src/AppsInTossModule/native-modules/getCurrentLocation.ts
@@ -440,6 +521,51 @@ async function getCurrentLocation(options) {
   return position;
 }
 
+// src/AppsInTossModule/native-modules/getDeviceId.ts
+function getDeviceId() {
+  return AppsInTossModule.deviceId;
+}
+
+// src/AppsInTossModule/native-modules/getTossAppVersion.ts
+function getTossAppVersion() {
+  return AppsInTossModule.tossAppVersion;
+}
+
+// src/AppsInTossModule/native-modules/getTossShareLink.ts
+async function getTossShareLink(path) {
+  const { shareLink } = await AppsInTossModule.getTossShareLink({});
+  const shareUrl = new URL(shareLink);
+  shareUrl.searchParams.set("deep_link_value", path);
+  shareUrl.searchParams.set("af_dp", path);
+  return shareUrl.toString();
+}
+
+// src/AppsInTossModule/native-modules/iap.ts
+async function createOneTimePurchaseOrder(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.219.0",
+    ios: "5.219.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+}
+async function getProductItemList() {
+  const isSupported = isMinVersionSupported({
+    android: "5.219.0",
+    ios: "5.219.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.iapGetProductItemList({});
+}
+var IAP = {
+  createOneTimePurchaseOrder,
+  getProductItemList
+};
+
 // src/AppsInTossModule/native-modules/openCamera.ts
 async function openCamera(options) {
   const permissionStatus = await requestPermission({ name: "camera", access: "access" });
@@ -450,19 +576,38 @@ async function openCamera(options) {
   return photo;
 }
 
-// src/AppsInTossModule/native-modules/appLogin.ts
-async function appLogin() {
-  return AppsInTossModule.appLogin({});
+// src/AppsInTossModule/native-modules/saveBase64Data.ts
+async function saveBase64Data(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.218.0",
+    ios: "5.216.0"
+  });
+  if (!isSupported) {
+    console.warn("saveBase64Data is not supported in this app version");
+    return;
+  }
+  await AppsInTossModule.saveBase64Data(params);
 }
 
-// src/AppsInTossModule/native-modules/getTossAppVersion.ts
-function getTossAppVersion() {
-  return AppsInTossModule.tossAppVersion;
+// src/AppsInTossModule/native-modules/setClipboardText.ts
+async function setClipboardText(text) {
+  const permissionStatus = await requestPermission({ name: "clipboard", access: "write" });
+  if (permissionStatus === "denied") {
+    throw new Error("\uD074\uB9BD\uBCF4\uB4DC \uC4F0\uAE30 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+  }
+  return AppsInTossModule.setClipboardText({ text });
 }
 
-// src/AppsInTossModule/native-modules/getDeviceId.ts
-function getDeviceId() {
-  return AppsInTossModule.deviceId;
+// src/AppsInTossModule/native-modules/setDeviceOrientation.ts
+async function setDeviceOrientation(options) {
+  const isSupported = isMinVersionSupported({
+    android: "5.215.0",
+    ios: "5.215.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.setDeviceOrientation(options);
 }
 
 // src/AppsInTossModule/native-modules/storage.ts
@@ -488,67 +633,46 @@ var Storage = {
   clearItems
 };
 
-// src/AppsInTossModule/native-modules/eventLog.ts
-function normalizeParams(params) {
-  return Object.fromEntries(
-    Object.entries(params).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
-  );
-}
-async function eventLog(params) {
-  if (AppsInTossModule.operationalEnvironment === "sandbox") {
-    console.log("[eventLogDebug]", {
-      log_name: params.log_name,
-      log_type: params.log_type,
-      params: normalizeParams(params.params)
-    });
+// src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
+import { openURL } from "@granite-js/react-native";
+
+// src/AppsInTossModule/constants.ts
+var GAME_CENTER_MIN_VERSION = {
+  android: "5.221.0",
+  ios: "5.221.0"
+};
+
+// src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
+async function openGameCenterLeaderboard() {
+  if (!isMinVersionSupported(GAME_CENTER_MIN_VERSION)) {
     return;
   }
-  const isSupported = isMinVersionSupported({
-    android: "5.208.0",
-    ios: "5.208.0"
-  });
-  if (!isSupported) {
-    return;
+  const appName = global.__granite?.app?.name;
+  if (appName == null) {
+    throw new Error("Cannot get app name");
   }
-  return AppsInTossModule.eventLog({
-    log_name: params.log_name,
-    log_type: params.log_type,
-    params: normalizeParams(params.params)
-  });
+  const url = new URL("servicetoss://game-center/leaderboard?_navbar=hide");
+  url.searchParams.set("appName", appName);
+  url.searchParams.set("referrer", `appsintoss.${appName}`);
+  return openURL(url.toString());
 }
 
-// src/AppsInTossModule/native-modules/getTossShareLink.ts
-async function getTossShareLink(path) {
-  const { shareLink } = await AppsInTossModule.getTossShareLink({});
-  const shareUrl = new URL(shareLink);
-  shareUrl.searchParams.set("deep_link_value", path);
-  shareUrl.searchParams.set("af_dp", path);
-  return shareUrl.toString();
-}
-
-// src/AppsInTossModule/native-modules/setDeviceOrientation.ts
-async function setDeviceOrientation(options) {
-  const isSupported = isMinVersionSupported({
-    android: "5.215.0",
-    ios: "5.215.0"
-  });
+// src/AppsInTossModule/native-modules/getGameCenterGameProfile.ts
+async function getGameCenterGameProfile() {
+  const isSupported = isMinVersionSupported(GAME_CENTER_MIN_VERSION);
   if (!isSupported) {
     return;
   }
-  return AppsInTossModule.setDeviceOrientation(options);
+  return AppsInTossModule.getGameCenterGameProfile({});
 }
 
-// src/AppsInTossModule/native-modules/saveBase64Data.ts
-async function saveBase64Data(params) {
-  const isSupported = isMinVersionSupported({
-    android: "5.218.0",
-    ios: "5.216.0"
-  });
+// src/AppsInTossModule/native-modules/submitGameCenterLeaderBoardScore.ts
+async function submitGameCenterLeaderBoardScore(params) {
+  const isSupported = isMinVersionSupported(GAME_CENTER_MIN_VERSION);
   if (!isSupported) {
-    console.warn("saveBase64Data is not supported in this app version");
     return;
   }
-  await AppsInTossModule.saveBase64Data(params);
+  return AppsInTossModule.submitGameCenterLeaderBoardScore(params);
 }
 
 // src/AppsInTossModule/native-modules/index.ts
@@ -624,7 +748,7 @@ async function setIosSwipeGestureEnabled(options) {
 
 // src/BedrockModule/native-modules/natives/openURL.ts
 import { Linking } from "react-native";
-function openURL(url) {
+function openURL2(url) {
   return Linking.openURL(url);
 }
 
@@ -639,15 +763,15 @@ import { NativeModules as NativeModules2 } from "react-native";
 var BedrockCoreModule = NativeModules2.BedrockCoreModule;
 
 // src/types.ts
-var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
-  Accuracy3[Accuracy3["Lowest"] = 1] = "Lowest";
-  Accuracy3[Accuracy3["Low"] = 2] = "Low";
-  Accuracy3[Accuracy3["Balanced"] = 3] = "Balanced";
-  Accuracy3[Accuracy3["High"] = 4] = "High";
-  Accuracy3[Accuracy3["Highest"] = 5] = "Highest";
-  Accuracy3[Accuracy3["BestForNavigation"] = 6] = "BestForNavigation";
-  return Accuracy3;
-})(Accuracy2 || {});
+var Accuracy = /* @__PURE__ */ ((Accuracy2) => {
+  Accuracy2[Accuracy2["Lowest"] = 1] = "Lowest";
+  Accuracy2[Accuracy2["Low"] = 2] = "Low";
+  Accuracy2[Accuracy2["Balanced"] = 3] = "Balanced";
+  Accuracy2[Accuracy2["High"] = 4] = "High";
+  Accuracy2[Accuracy2["Highest"] = 5] = "Highest";
+  Accuracy2[Accuracy2["BestForNavigation"] = 6] = "BestForNavigation";
+  return Accuracy2;
+})(Accuracy || {});
 
 // src/AppsInTossModule/native-modules/tossCore.ts
 import { NativeModules as NativeModules3 } from "react-native";
@@ -672,11 +796,12 @@ var INTERNAL__module = {
   tossCoreEventLog
 };
 export {
-  Accuracy2 as Accuracy,
+  Accuracy,
   AppsInTossModule,
   BedrockCoreModule,
   BedrockModule,
   GoogleAdMob,
+  IAP,
   AppsInTossModuleInstance as INTERNAL__AppsInTossModule,
   INTERNAL__module,
   Storage,
@@ -684,6 +809,7 @@ export {
   appLogin,
   appsInTossEvent,
   closeView,
+  contactsViral,
   eventLog,
   fetchAlbumPhotos,
   fetchContacts,
@@ -691,6 +817,7 @@ export {
   getClipboardText,
   getCurrentLocation,
   getDeviceId,
+  getGameCenterGameProfile,
   getLocale,
   getNetworkStatus,
   getOperationalEnvironment,
@@ -699,8 +826,10 @@ export {
   getTossAppVersion,
   getTossShareLink,
   isMinVersionSupported,
+  onVisibilityChangedByTransparentServiceWeb,
   openCamera,
-  openURL,
+  openGameCenterLeaderboard,
+  openURL2 as openURL,
   saveBase64Data,
   setClipboardText,
   setDeviceOrientation,
@@ -708,5 +837,6 @@ export {
   setScreenAwakeMode,
   setSecureScreen,
   share,
-  startUpdateLocation
+  startUpdateLocation,
+  submitGameCenterLeaderBoardScore
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "0.0.0-dev.1752049503789",
+  "version": "1.0.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -26,16 +26,15 @@
   },
   "files": [
     "dist",
-    "src/async-bridges.ts",
-    "src/constant-bridges.ts",
-    "src/event-bridges.ts"
+    "src"
   ],
   "devDependencies": {
-    "@granite-js/native": "0.1.5",
-    "@granite-js/react-native": "0.1.5",
+    "@babel/runtime": "^7",
+    "@granite-js/native": "0.1.20",
+    "@granite-js/react-native": "0.1.20",
     "@types/react": "18.3.3",
     "dts-bundle-generator": "^9.5.1",
-    "esbuild": "^0.25.5",
+    "esbuild": "0.25.5",
     "picocolors": "^1.1.1",
     "react": "18.2.0",
     "react-native": "0.72.6",
@@ -54,5 +53,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8269e1336952bd7229eba87bc82ae1a077ac874a"
+  "gitHead": "1cf9898b323a17c789ff9f5d75e8c6ab68fe4a95"
 }

package/src/AppsInTossModule/constants.ts

@@ -0,0 +1,6 @@
+export const GAME_PROFILE_WEBVIEW_URL = 'https://service.toss.im/game-center/profile';
+
+export const GAME_CENTER_MIN_VERSION = {
+  android: '5.221.0',
+  ios: '5.221.0',
+} as const;

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

@@ -0,0 +1,13 @@
+import { GraniteEvent } from '@granite-js/react-native';
+import { EntryMessageExitedEvent } from './event-plugins/EntryMessageExitedEvent';
+import { UpdateLocationEvent } from './event-plugins/UpdateLocationEvent';
+import { AppBridgeCallbackEvent } from './internal/AppBridgeCallbackEvent';
+import { VisibilityChangedByTransparentServiceWebEvent } from './internal/VisibilityChangedByTransparentServiceWebEvent';
+
+export const appsInTossEvent = new GraniteEvent([
+  new UpdateLocationEvent(),
+  new EntryMessageExitedEvent(),
+  // Internal events
+  new AppBridgeCallbackEvent(),
+  new VisibilityChangedByTransparentServiceWebEvent(),
+]);

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

@@ -0,0 +1,140 @@
+import { INTERNAL__appBridgeHandler } from './internal/appBridge';
+import { isMinVersionSupported } from '../native-modules/isMinVersionSupported';
+
+/**
+ * @public
+ * @category 친구초대
+ * @name RewardFromContactsViralEvent
+ * @description 친구에게 공유하기를 완료했을 때 지급할 리워드 정보를 담는 타입이에요. 이 타입을 사용하면 공유가 완료됐을 때 지급할 리워드 정보를 확인할 수 있어요.
+ * @property {'sendViral'} type - 이벤트의 타입이에요. `'sendViral'`은 사용자가 친구에게 공유를 완료했을 때 돌아와요.
+ * @property {Object} data - 지급할 리워드 관련 정보를 담고 있어요.
+ * @property {number} data.rewardAmount - 지급할 리워드 수량이에요. 앱인토스 콘솔에서 설정한 수량 및 금액 값이에요.
+ * @property {string} data.rewardUnit - 리워드의 단위예요. 앱인토스 콘솔에 설정된 리워드 이름인 '하트', '보석' 등이 리워드 단위예요.
+ */
+type RewardFromContactsViralEvent = {
+  type: 'sendViral';
+  data: {
+    rewardAmount: number;
+    rewardUnit: string;
+  };
+};
+
+/**
+ * @public
+ * @category 친구초대
+ * @name ContactsViralSuccessEvent
+ * @description 연락처 공유 모듈이 정상적으로 종료됐을 때 전달되는 이벤트 객체예요. 종료 이유와 함께 리워드 상태 및 남은 친구 수 등 관련 정보를 제공해요.
+ * @property {'close'} type - 이벤트의 타입이에요. `'close'`는 공유 모듈이 종료됐을 때 돌아와요.
+ * @property {Object} data - 모듈 종료와 관련된 세부 정보를 담고 있어요.
+ * @property {'clickBackButton' | 'noReward'} data.closeReason - 모듈이 종료된 이유예요. `'clickBackButton'`은 사용자가 뒤로 가기 버튼을 눌러 종료한 경우이고, `'noReward'`는 받을 수 있는 리워드가 없어서 종료된 경우예요.
+ * @property {number} data.sentRewardAmount - 사용자가 받은 전체 리워드 수량이에요.
+ * @property {number} data.sendableRewardsCount - 아직 공유할 수 있는 친구 수예요.
+ * @property {number} data.sentRewardsCount - 사용자가 공유를 완료한 친구 수예요.
+ * @property {string} data.rewardUnit - 리워드의 단위예요. 앱인토스 콘솔에 설정된 리워드 이름인 '하트', '보석' 등이 리워드 단위예요.
+ */
+type ContactsViralSuccessEvent = {
+  type: 'close';
+  data: {
+    closeReason: 'clickBackButton' | 'noReward';
+    sentRewardAmount?: number;
+    sendableRewardsCount?: number;
+    sentRewardsCount: number;
+    rewardUnit?: string;
+  };
+};
+
+type ContactsViralEvent = RewardFromContactsViralEvent | ContactsViralSuccessEvent;
+
+/**
+ * @public
+ * @category 친구초대
+ * @name ContactsViralOption
+ * @description [연락처 공유 기능](/react-native/reference/native-modules/친구초대/contactsViral.html)을 사용할 때 필요한 옵션이에요.
+ * @property {string} moduleId - 공유 리워드를 구분하는 UUID 형식의 고유 ID예요. 앱인토스 콘솔의 미니앱 > 공유 리워드 메뉴에서 확인할 수 있어요.
+ */
+type ContactsViralOption = {
+  moduleId: string;
+};
+
+/**
+ * @public
+ * @category 친구초대
+ * @name ContactsViralParams
+ * @description `ContactsViralParams`는 연락처 공유 기능을 사용할 때 전달해야 하는 파라미터 타입이에요. 옵션을 설정하고, 이벤트 및 에러 처리 콜백을 지정할 수 있어요.
+ * @property {ContactsViralOption} options - 공유 기능에 사용할 옵션 객체예요.
+ * @property {(event: ContactsViralEvent) => void} onEvent - 공유 이벤트가 발생했을 때 실행되는 함수예요. [`RewardFromContactsViralEvent`](/bedrock/reference/native-modules/친구초대/RewardFromContactsViralEvent.html) 또는 [`ContactsViralSuccessEvent`](/react-native/reference/native-modules/친구초대/ContactsViralSuccessEvent.html) 타입의 이벤트 객체가 전달돼요.
+ * @property {(error: unknown) => void} onError - 예기치 않은 에러가 발생했을 때 실행되는 함수예요.
+ */
+export interface ContactsViralParams {
+  options: ContactsViralOption;
+  onEvent: (event: ContactsViralEvent) => void;
+  onError: (error: unknown) => void;
+}
+
+/**
+ * @public
+ * @category 친구초대
+ * @name contactsViral
+ * @description 친구에게 공유하고 리워드를 받을 수 있는 기능을 제공해요. 사용자가 친구에게 공유를 완료하면 앱브릿지가 이벤트를 통해 리워드 정보를 전달해요.
+ * @param {ContactsViralParams} params - 연락처 공유 기능을 실행할 때 사용하는 파라미터예요. 옵션 설정과 이벤트 핸들러를 포함해요. 자세한 내용은 [ContactsViralParams](/bedrock/reference/native-modules/친구초대/ContactsViralParams.html) 문서를 참고하세요.
+ * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 공유 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
+ *
+ * @example
+ * ### 친구에게 공유하고 리워드 받기
+ *
+ * ```tsx
+ * import { useCallback } from 'react';
+ * import { Button } from 'react-native';
+ * import { contactsViral } from '@apps-in-toss/framework';
+ *
+ * function ContactsViralButton({ moduleId }: { moduleId: string }) {
+ *   const handleContactsViral = useCallback(() => {
+ *     try {
+ *       const cleanup = contactsViral({
+ *         options: { moduleId: moduleId.trim() },
+ *         onEvent: (event) => {
+ *           if (event.type === 'sendViral') {
+ *             console.log('리워드 지급:', event.data.rewardAmount, event.data.rewardUnit);
+ *           } else if (event.type === 'close') {
+ *             console.log('모듈 종료:', event.data.closeReason);
+ *           }
+ *         },
+ *         onError: (error) => {
+ *           console.error('에러 발생:', error);
+ *         },
+ *       });
+ *
+ *       return cleanup;
+ *     } catch (error) {
+ *       console.error('실행 중 에러:', error);
+ *     }
+ *   }, [moduleId]);
+ *
+ *   return <Button title="친구에게 공유하고 리워드 받기" onPress={handleContactsViral} />;
+ * }
+ * ```
+ */
+export function contactsViral(params: ContactsViralParams) {
+  const isSupported = isMinVersionSupported({
+    android: '5.223.0',
+    ios: '5.223.0',
+  });
+
+  if (!isSupported) {
+    return () => {};
+  }
+
+  const { onEvent, onError, options } = params;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('contactsViral', options, {
+    onRewardFromContactsViral: (result: RewardFromContactsViralEvent['data']) => {
+      onEvent({ type: 'sendViral', data: result });
+    },
+    onSuccess: (result: ContactsViralSuccessEvent['data']) => {
+      onEvent({ type: 'close', data: result });
+    },
+    onError,
+  });
+
+  return unregisterCallbacks;
+}

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

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