@apps-in-toss/native-modules 1.5.2 → 1.6.0

package/dist/bridges-meta.json

@@ -77,7 +77,7 @@
   },
   {
     "identifier": "getTossShareLink",
-    "dts": "/**\n * @public\n * @category 공유\n * @kind function\n * @name getTossShareLink\n * @description\n * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.\n * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.\n *\n * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.\n * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.\n *\n * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.\n *\n * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.\n * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.\n *\n * @example\n * ```tsx\n * import { share } from '@granite-js/react-native';\n * import { getTossShareLink } from '@apps-in-toss/framework';\n *\n * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.\n * const tossLink = await getTossShareLink('intoss://my-app');\n *\n * // 생성한 링크를 메시지로 공유해요.\n * await share({ message: tossLink });\n * ```\n */\nexport declare function getTossShareLink(path: string): Promise<string>;\n\nexport {};\n"
+    "dts": "/**\n * @public\n * @category 공유\n * @kind function\n * @name getTossShareLink\n * @description\n * 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 생성해요.\n *\n * 생성된 링크를 다른 사람과 공유하면:\n * - 토스 앱이 설치되어 있으면: 토스 앱이 실행되면서 지정한 경로로 이동해요.\n * - 토스 앱이 없으면: iOS는 앱스토어로, Android는 플레이스토어로 이동해요.\n *\n * @param path - 딥링크 경로예요. `intoss://`로 시작하는 문자열이어야 해요. (예: `intoss://my-app`, `intoss://my-app/detail?id=123`)\n * @param ogImageUrl - (선택) 공유 시 표시될 커스텀 OG 이미지 URL이에요. 최소 버전: Android 5.240.0, iOS 5.239.0\n * @returns {Promise<string>} 생성된 토스 공유 링크\n *\n * @example\n * ```tsx\n * import { share } from '@granite-js/react-native';\n * import { getTossShareLink } from '@apps-in-toss/framework';\n *\n * // 기본 사용법\n * const tossLink = await getTossShareLink('intoss://my-app');\n * await share({ message: tossLink });\n *\n * // 커스텀 OG 이미지와 함께 사용\n * const linkWithImage = await getTossShareLink(\n *   'intoss://my-app/event',\n *   'https://example.com/og-image.png'\n * );\n * await share({ message: linkWithImage });\n * ```\n */\nexport declare function getTossShareLink(path: string, ogImageUrl?: string): Promise<string>;\n\nexport {};\n"
   },
   {
     "identifier": "setDeviceOrientation",
@@ -93,7 +93,7 @@
   },
   {
     "identifier": "appsInTossSignTossCert",
-    "dts": "export interface AppsInTossSignTossCertParams {\n\ttxId: string;\n}\n/**\n * @public\n * @category 토스인증\n * @name appsInTossSignTossCert\n * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.\n *\n * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.\n * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.\n *\n * @example\n * ```tsx\n * import { appsInTossSignTossCert } from '@apps-in-toss/framework';\n *\n *  // 서명에 필요한 파라미터를 정의해요.\n *  const params = {\n *    txId: \"f2e1a6df...\"\n *  };\n *\n * appsInTossSignTossCert(params)\n *   .then(() => {\n *     console.log('서명 작업이 성공적으로 완료되었어요.');\n *   })\n *   .catch((error) => {\n *     console.error('서명 작업 중 에러가 발생했어요:', error);\n *   });\n * ```\n */\nexport declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;\n\nexport {};\n"
+    "dts": "export interface AppsInTossSignTossCertParams {\n\ttxId: string;\n\tskipConfirmDoc?: boolean;\n}\n/**\n * @public\n * @category 토스인증\n * @name appsInTossSignTossCert\n * @description 토스 인증서를 사용해 서명하는 기능을 제공해요. 이 함수를 사용하면 앱인토스에서 제공하는 인증서를 활용해 서명을 할 수 있어요.\n *\n * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.\n * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.\n * @param {boolean} params.skipConfirmDoc - (선택) 토스 원터치 인증방식을 사용하기 위한 옵션이예요. true 설정 시 최소 버전: Android 5.236.0, iOS 5.236.0 (default: false)\n *\n * @example\n * ```tsx\n * import { appsInTossSignTossCert } from '@apps-in-toss/framework';\n *\n *  // 서명에 필요한 파라미터를 정의해요.\n *  const params = {\n *    txId: \"f2e1a6df...\"\n *  };\n *\n * appsInTossSignTossCert(params)\n *   .then(() => {\n *     console.log('서명 작업이 성공적으로 완료되었어요.');\n *   })\n *   .catch((error) => {\n *     console.error('서명 작업 중 에러가 발생했어요:', error);\n *   });\n * ```\n */\nexport declare function appsInTossSignTossCert(params: AppsInTossSignTossCertParams): Promise<void>;\n\nexport {};\n"
   },
   {
     "identifier": "getGameCenterGameProfile",

package/dist/index.cjs

@@ -75,26 +75,15 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
-var import_react_native7 = require("@granite-js/react-native");
-
-// src/AppsInTossModule/native-event-emitter/event-plugins/EntryMessageExitedEvent.ts
-var import_react_native = require("@granite-js/react-native");
-var EntryMessageExitedEvent = class extends import_react_native.GraniteEventDefinition {
-  name = "entryMessageExited";
-  remove() {
-  }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  listener(_) {
-  }
-};
+var import_react_native6 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
 var import_types = require("@apps-in-toss/types");
-var import_react_native4 = require("@granite-js/react-native");
+var import_react_native3 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/native-modules/AppsInTossModule.ts
-var import_react_native2 = require("react-native");
-var Module = import_react_native2.TurboModuleRegistry.getEnforcing("AppsInTossModule");
+var import_react_native = require("react-native");
+var Module = import_react_native.TurboModuleRegistry.getEnforcing("AppsInTossModule");
 var AppsInTossModuleInstance = Module;
 var AppsInTossModule = Module;
 
@@ -121,11 +110,11 @@ async function requestPermission(permission) {
 }
 
 // src/AppsInTossModule/native-event-emitter/nativeEventEmitter.ts
-var import_react_native3 = require("react-native");
-var nativeEventEmitter = new import_react_native3.NativeEventEmitter(AppsInTossModuleInstance);
+var import_react_native2 = require("react-native");
+var nativeEventEmitter = new import_react_native2.NativeEventEmitter(AppsInTossModuleInstance);
 
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
-var UpdateLocationEvent = class extends import_react_native4.GraniteEventDefinition {
+var UpdateLocationEvent = class extends import_react_native3.GraniteEventDefinition {
   name = "updateLocationEvent";
   subscriptionCount = 0;
   ref = {
@@ -155,7 +144,7 @@ var UpdateLocationEvent = class extends import_react_native4.GraniteEventDefinit
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
-var import_react_native5 = require("@granite-js/react-native");
+var import_react_native4 = require("@granite-js/react-native");
 
 // src/utils/generateUUID.ts
 function generateUUID(placeholder) {
@@ -217,7 +206,7 @@ var INTERNAL__appBridgeHandler = {
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
 var UNSAFE__nativeEventEmitter = nativeEventEmitter;
-var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_native5.GraniteEventDefinition {
+var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_native4.GraniteEventDefinition {
   static INTERNAL__appBridgeSubscription;
   name = "appBridgeCallbackEvent";
   constructor() {
@@ -247,8 +236,8 @@ var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/VisibilityChangedByTransparentServiceWebEvent.ts
-var import_react_native6 = require("@granite-js/react-native");
-var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_native6.GraniteEventDefinition {
+var import_react_native5 = require("@granite-js/react-native");
+var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_native5.GraniteEventDefinition {
   name = "onVisibilityChangedByTransparentServiceWeb";
   subscription = null;
   remove() {
@@ -273,9 +262,8 @@ var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_n
 };
 
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
-var appsInTossEvent = new import_react_native7.GraniteEvent([
+var appsInTossEvent = new import_react_native6.GraniteEvent([
   new UpdateLocationEvent(),
-  new EntryMessageExitedEvent(),
   // Internal events
   new AppBridgeCallbackEvent(),
   new VisibilityChangedByTransparentServiceWebEvent()
@@ -290,7 +278,7 @@ function getOperationalEnvironment() {
 }
 
 // src/AppsInTossModule/native-modules/isMinVersionSupported.ts
-var import_react_native8 = require("react-native");
+var import_react_native7 = 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;
@@ -366,7 +354,7 @@ function isMinVersionSupported(minVersions) {
     return true;
   }
   const currentVersion = AppsInTossModule.tossAppVersion;
-  const isIOS = import_react_native8.Platform.OS === "ios";
+  const isIOS = import_react_native7.Platform.OS === "ios";
   const minVersion = isIOS ? minVersions.ios : minVersions.android;
   if (minVersion === void 0) {
     return false;
@@ -486,10 +474,10 @@ showAdMobRewardedAd.isSupported = createIsSupported();
 var import_es_toolkit2 = require("es-toolkit");
 
 // src/utils/getReferrer.ts
-var import_react_native9 = require("@granite-js/react-native");
+var import_react_native8 = require("@granite-js/react-native");
 function getReferrer() {
   try {
-    return new URL((0, import_react_native9.getSchemeUri)()).searchParams.get("referrer");
+    return new URL((0, import_react_native8.getSchemeUri)()).searchParams.get("referrer");
   } catch {
     return null;
   }
@@ -729,7 +717,24 @@ function getTossAppVersion() {
 }
 
 // src/AppsInTossModule/native-modules/getTossShareLink.ts
-async function getTossShareLink(path) {
+var V2_MIN_VERSION = {
+  android: "5.240.0",
+  ios: "5.239.0"
+};
+async function getTossShareLink(path, ogImageUrl) {
+  if (!isMinVersionSupported(V2_MIN_VERSION)) {
+    return await getTossShareLinkV1(path);
+  }
+  const params = {
+    params: {
+      url: path,
+      ogImageUrl
+    }
+  };
+  const { shareLink } = await AppsInTossModule.getTossShareLink(params);
+  return shareLink;
+}
+async function getTossShareLinkV1(path) {
   const { shareLink } = await AppsInTossModule.getTossShareLink({});
   const shareUrl = new URL(shareLink);
   shareUrl.searchParams.set("deep_link_value", path);
@@ -910,7 +915,7 @@ var Storage = {
 };
 
 // src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
-var import_react_native10 = require("@granite-js/react-native");
+var import_react_native9 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/constants.ts
 var GAME_CENTER_MIN_VERSION = {
@@ -942,7 +947,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_native10.openURL)(url.toString());
+  return (0, import_react_native9.openURL)(url.toString());
 }
 
 // src/AppsInTossModule/native-modules/getGameCenterGameProfile.ts
@@ -1045,11 +1050,19 @@ function contactsViral(params) {
 }
 
 // src/AppsInTossModule/native-modules/appsInTossSignTossCert.ts
-async function appsInTossSignTossCert(params) {
-  const isSupported = isMinVersionSupported({
+var MIN_VERSION_BY_USER_TYPE = {
+  USER_PERSONAL: {
     android: "5.233.0",
     ios: "5.233.0"
-  });
+  },
+  USER_NONE: {
+    android: "5.236.0",
+    ios: "5.236.0"
+  }
+};
+async function appsInTossSignTossCert(params) {
+  const minVersion = params.skipConfirmDoc === true ? MIN_VERSION_BY_USER_TYPE.USER_NONE : MIN_VERSION_BY_USER_TYPE.USER_PERSONAL;
+  const isSupported = isMinVersionSupported(minVersion);
   if (!isSupported) {
     console.warn("appsInTossSignTossCert is not supported in this app version");
     return;
@@ -1086,8 +1099,8 @@ function onVisibilityChangedByTransparentServiceWeb(eventParams) {
 }
 
 // src/BedrockModule/native-modules/natives/BedrockModule.ts
-var import_react_native11 = require("react-native");
-var BedrockModule = import_react_native11.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() {
@@ -1095,10 +1108,10 @@ async function closeView() {
 }
 
 // src/BedrockModule/native-modules/natives/getLocale.ts
-var import_react_native12 = require("react-native");
+var import_react_native11 = require("react-native");
 function getLocale() {
   const locale = BedrockModule?.DeviceInfo?.locale ?? "ko-KR";
-  if (import_react_native12.Platform.OS === "android") {
+  if (import_react_native11.Platform.OS === "android") {
     return replaceUnderbarToHypen(locale);
   }
   return locale;
@@ -1146,24 +1159,24 @@ async function setIosSwipeGestureEnabled(options) {
 }
 
 // src/BedrockModule/native-modules/natives/openURL.ts
-var import_react_native13 = require("react-native");
+var import_react_native12 = require("react-native");
 function openURL2(url) {
-  return import_react_native13.Linking.openURL(url);
+  return import_react_native12.Linking.openURL(url);
 }
 
 // src/BedrockModule/native-modules/natives/getPlatformOS.ts
-var import_react_native14 = require("react-native");
+var import_react_native13 = require("react-native");
 function getPlatformOS() {
-  return import_react_native14.Platform.OS;
+  return import_react_native13.Platform.OS;
 }
 
 // src/BedrockModule/native-modules/core/BedrockCoreModule.ts
-var import_react_native15 = require("react-native");
-var BedrockCoreModule = import_react_native15.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_native16 = require("react-native");
-var TossCoreModule = import_react_native16.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";

package/dist/index.d.cts

@@ -231,12 +231,6 @@ interface ContactsViralParams {
  */
 declare function contactsViral(params: ContactsViralParams): () => void;
 
-declare class EntryMessageExitedEvent extends GraniteEventDefinition<undefined, undefined> {
-    name: "entryMessageExited";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
 interface StartUpdateLocationOptions {
     /**
      * 위치 정확도를 설정해요.
@@ -286,7 +280,7 @@ declare class VisibilityChangedByTransparentServiceWebEvent extends GraniteEvent
     private isVisibilityChangedByTransparentServiceWebResult;
 }
 
-declare const appsInTossEvent: GraniteEvent<EntryMessageExitedEvent | UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
+declare const appsInTossEvent: GraniteEvent<UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
 
 declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
     options: {
@@ -1357,6 +1351,7 @@ declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<Check
 
 interface AppsInTossSignTossCertParams {
     txId: string;
+    skipConfirmDoc?: boolean;
 }
 /**
  * @public
@@ -1366,6 +1361,7 @@ interface AppsInTossSignTossCertParams {
  *
  * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.
  * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.
+ * @param {boolean} params.skipConfirmDoc - (선택) 토스 원터치 인증방식을 사용하기 위한 옵션이예요. true 설정 시 최소 버전: Android 5.236.0, iOS 5.236.0 (default: false)
  *
  * @example
  * ```tsx
@@ -2897,30 +2893,34 @@ declare function getTossAppVersion(): string;
  * @kind function
  * @name getTossShareLink
  * @description
- * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
- * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
+ * 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 생성해요.
  *
- * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
- * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
+ * 생성된 링크를 다른 사람과 공유하면:
+ * - 토스 앱이 설치되어 있으면: 토스 앱이 실행되면서 지정한 경로로 이동해요.
+ * - 토스 앱이 없으면: iOS는 앱스토어로, Android는 플레이스토어로 이동해요.
  *
- * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
- *
- * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
- * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
+ * @param path - 딥링크 경로예요. `intoss://`로 시작하는 문자열이어야 해요. (예: `intoss://my-app`, `intoss://my-app/detail?id=123`)
+ * @param ogImageUrl - (선택) 공유 시 표시될 커스텀 OG 이미지 URL이에요. 최소 버전: Android 5.240.0, iOS 5.239.0
+ * @returns {Promise<string>} 생성된 토스 공유 링크
  *
  * @example
  * ```tsx
  * import { share } from '@granite-js/react-native';
  * import { getTossShareLink } from '@apps-in-toss/framework';
  *
- * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
+ * // 기본 사용법
  * const tossLink = await getTossShareLink('intoss://my-app');
- *
- * // 생성한 링크를 메시지로 공유해요.
  * await share({ message: tossLink });
+ *
+ * // 커스텀 OG 이미지와 함께 사용
+ * const linkWithImage = await getTossShareLink(
+ *   'intoss://my-app/event',
+ *   'https://example.com/og-image.png'
+ * );
+ * await share({ message: linkWithImage });
  * ```
  */
-declare function getTossShareLink(path: string): Promise<string>;
+declare function getTossShareLink(path: string, ogImageUrl?: string): Promise<string>;
 
 /**
  * @public

package/dist/index.d.ts

@@ -231,12 +231,6 @@ interface ContactsViralParams {
  */
 declare function contactsViral(params: ContactsViralParams): () => void;
 
-declare class EntryMessageExitedEvent extends GraniteEventDefinition<undefined, undefined> {
-    name: "entryMessageExited";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
 interface StartUpdateLocationOptions {
     /**
      * 위치 정확도를 설정해요.
@@ -286,7 +280,7 @@ declare class VisibilityChangedByTransparentServiceWebEvent extends GraniteEvent
     private isVisibilityChangedByTransparentServiceWebResult;
 }
 
-declare const appsInTossEvent: GraniteEvent<EntryMessageExitedEvent | UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
+declare const appsInTossEvent: GraniteEvent<UpdateLocationEvent | AppBridgeCallbackEvent | VisibilityChangedByTransparentServiceWebEvent>;
 
 declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
     options: {
@@ -1357,6 +1351,7 @@ declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<Check
 
 interface AppsInTossSignTossCertParams {
     txId: string;
+    skipConfirmDoc?: boolean;
 }
 /**
  * @public
@@ -1366,6 +1361,7 @@ interface AppsInTossSignTossCertParams {
  *
  * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.
  * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.
+ * @param {boolean} params.skipConfirmDoc - (선택) 토스 원터치 인증방식을 사용하기 위한 옵션이예요. true 설정 시 최소 버전: Android 5.236.0, iOS 5.236.0 (default: false)
  *
  * @example
  * ```tsx
@@ -2897,30 +2893,34 @@ declare function getTossAppVersion(): string;
  * @kind function
  * @name getTossShareLink
  * @description
- * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
- * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
+ * 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 생성해요.
  *
- * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
- * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
+ * 생성된 링크를 다른 사람과 공유하면:
+ * - 토스 앱이 설치되어 있으면: 토스 앱이 실행되면서 지정한 경로로 이동해요.
+ * - 토스 앱이 없으면: iOS는 앱스토어로, Android는 플레이스토어로 이동해요.
  *
- * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
- *
- * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
- * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
+ * @param path - 딥링크 경로예요. `intoss://`로 시작하는 문자열이어야 해요. (예: `intoss://my-app`, `intoss://my-app/detail?id=123`)
+ * @param ogImageUrl - (선택) 공유 시 표시될 커스텀 OG 이미지 URL이에요. 최소 버전: Android 5.240.0, iOS 5.239.0
+ * @returns {Promise<string>} 생성된 토스 공유 링크
  *
  * @example
  * ```tsx
  * import { share } from '@granite-js/react-native';
  * import { getTossShareLink } from '@apps-in-toss/framework';
  *
- * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
+ * // 기본 사용법
  * const tossLink = await getTossShareLink('intoss://my-app');
- *
- * // 생성한 링크를 메시지로 공유해요.
  * await share({ message: tossLink });
+ *
+ * // 커스텀 OG 이미지와 함께 사용
+ * const linkWithImage = await getTossShareLink(
+ *   'intoss://my-app/event',
+ *   'https://example.com/og-image.png'
+ * );
+ * await share({ message: linkWithImage });
  * ```
  */
-declare function getTossShareLink(path: string): Promise<string>;
+declare function getTossShareLink(path: string, ogImageUrl?: string): Promise<string>;
 
 /**
  * @public

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/EntryMessageExitedEvent.ts
-import { GraniteEventDefinition } from "@granite-js/react-native";
-var EntryMessageExitedEvent = class extends GraniteEventDefinition {
-  name = "entryMessageExited";
-  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 GraniteEventDefinition2 } from "@granite-js/react-native";
+import { GraniteEventDefinition } from "@granite-js/react-native";
 
 // src/AppsInTossModule/native-modules/AppsInTossModule.ts
 import { TurboModuleRegistry } from "react-native";
@@ -49,7 +38,7 @@ import { NativeEventEmitter } from "react-native";
 var nativeEventEmitter = new NativeEventEmitter(AppsInTossModuleInstance);
 
 // src/AppsInTossModule/native-event-emitter/event-plugins/UpdateLocationEvent.ts
-var UpdateLocationEvent = class extends GraniteEventDefinition2 {
+var UpdateLocationEvent = class extends GraniteEventDefinition {
   name = "updateLocationEvent";
   subscriptionCount = 0;
   ref = {
@@ -79,7 +68,7 @@ var UpdateLocationEvent = class extends GraniteEventDefinition2 {
 };
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
-import { GraniteEventDefinition as GraniteEventDefinition3 } from "@granite-js/react-native";
+import { GraniteEventDefinition as GraniteEventDefinition2 } from "@granite-js/react-native";
 
 // src/utils/generateUUID.ts
 function generateUUID(placeholder) {
@@ -141,7 +130,7 @@ var INTERNAL__appBridgeHandler = {
 
 // src/AppsInTossModule/native-event-emitter/internal/AppBridgeCallbackEvent.ts
 var UNSAFE__nativeEventEmitter = nativeEventEmitter;
-var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends GraniteEventDefinition3 {
+var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends GraniteEventDefinition2 {
   static INTERNAL__appBridgeSubscription;
   name = "appBridgeCallbackEvent";
   constructor() {
@@ -171,8 +160,8 @@ 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 {
+import { GraniteEventDefinition as GraniteEventDefinition3 } from "@granite-js/react-native";
+var VisibilityChangedByTransparentServiceWebEvent = class extends GraniteEventDefinition3 {
   name = "onVisibilityChangedByTransparentServiceWeb";
   subscription = null;
   remove() {
@@ -199,7 +188,6 @@ var VisibilityChangedByTransparentServiceWebEvent = class extends GraniteEventDe
 // src/AppsInTossModule/native-event-emitter/appsInTossEvent.ts
 var appsInTossEvent = new GraniteEvent([
   new UpdateLocationEvent(),
-  new EntryMessageExitedEvent(),
   // Internal events
   new AppBridgeCallbackEvent(),
   new VisibilityChangedByTransparentServiceWebEvent()
@@ -653,7 +641,24 @@ function getTossAppVersion() {
 }
 
 // src/AppsInTossModule/native-modules/getTossShareLink.ts
-async function getTossShareLink(path) {
+var V2_MIN_VERSION = {
+  android: "5.240.0",
+  ios: "5.239.0"
+};
+async function getTossShareLink(path, ogImageUrl) {
+  if (!isMinVersionSupported(V2_MIN_VERSION)) {
+    return await getTossShareLinkV1(path);
+  }
+  const params = {
+    params: {
+      url: path,
+      ogImageUrl
+    }
+  };
+  const { shareLink } = await AppsInTossModule.getTossShareLink(params);
+  return shareLink;
+}
+async function getTossShareLinkV1(path) {
   const { shareLink } = await AppsInTossModule.getTossShareLink({});
   const shareUrl = new URL(shareLink);
   shareUrl.searchParams.set("deep_link_value", path);
@@ -969,11 +974,19 @@ function contactsViral(params) {
 }
 
 // src/AppsInTossModule/native-modules/appsInTossSignTossCert.ts
-async function appsInTossSignTossCert(params) {
-  const isSupported = isMinVersionSupported({
+var MIN_VERSION_BY_USER_TYPE = {
+  USER_PERSONAL: {
     android: "5.233.0",
     ios: "5.233.0"
-  });
+  },
+  USER_NONE: {
+    android: "5.236.0",
+    ios: "5.236.0"
+  }
+};
+async function appsInTossSignTossCert(params) {
+  const minVersion = params.skipConfirmDoc === true ? MIN_VERSION_BY_USER_TYPE.USER_NONE : MIN_VERSION_BY_USER_TYPE.USER_PERSONAL;
+  const isSupported = isMinVersionSupported(minVersion);
   if (!isSupported) {
     console.warn("appsInTossSignTossCert is not supported in this app version");
     return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "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.5.2",
+    "@apps-in-toss/types": "^1.6.0",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8224b90876f7d9e0feac0cd38ef80be42a5d784f"
+  "gitHead": "ee1ce0d363246b54246472599e0312cd2d2c1ff5"
 }

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

@@ -1,12 +1,10 @@
 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(),

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

@@ -1,8 +1,20 @@
 import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
 
+const MIN_VERSION_BY_USER_TYPE = {
+  USER_PERSONAL: {
+    android: '5.233.0',
+    ios: '5.233.0',
+  },
+  USER_NONE: {
+    android: '5.236.0',
+    ios: '5.236.0',
+  },
+} as const;
+
 export interface AppsInTossSignTossCertParams {
   txId: string;
+  skipConfirmDoc?: boolean;
 }
 
 /**
@@ -13,6 +25,7 @@ export interface AppsInTossSignTossCertParams {
  *
  * @param {AppsInTossSignTossCertParams} params - 서명에 필요한 파라미터를 포함하는 객체예요.
  * @param {string} params.txId - 토스인증서를 사용한 본인확인이나 간편인증, 전자서명에서 사용하는 Transaction Id예요.
+ * @param {boolean} params.skipConfirmDoc - (선택) 토스 원터치 인증방식을 사용하기 위한 옵션이예요. true 설정 시 최소 버전: Android 5.236.0, iOS 5.236.0 (default: false)
  *
  * @example
  * ```tsx
@@ -34,10 +47,9 @@ export interface AppsInTossSignTossCertParams {
  */
 
 export async function appsInTossSignTossCert(params: AppsInTossSignTossCertParams) {
-  const isSupported = isMinVersionSupported({
-    android: '5.233.0',
-    ios: '5.233.0',
-  });
+  const minVersion =
+    params.skipConfirmDoc === true ? MIN_VERSION_BY_USER_TYPE.USER_NONE : MIN_VERSION_BY_USER_TYPE.USER_PERSONAL;
+  const isSupported = isMinVersionSupported(minVersion);
 
   if (!isSupported) {
     console.warn('appsInTossSignTossCert is not supported in this app version');

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

@@ -1,4 +1,10 @@
 import { AppsInTossModule } from './AppsInTossModule';
+import { isMinVersionSupported } from './isMinVersionSupported';
+
+const V2_MIN_VERSION = {
+  android: '5.240.0',
+  ios: '5.239.0',
+} as const;
 
 /**
  * @public
@@ -6,30 +12,50 @@ import { AppsInTossModule } from './AppsInTossModule';
  * @kind function
  * @name getTossShareLink
  * @description
- * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
- * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
- *
- * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
- * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
+ * 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 생성해요.
  *
- * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
+ * 생성된 링크를 다른 사람과 공유하면:
+ * - 토스 앱이 설치되어 있으면: 토스 앱이 실행되면서 지정한 경로로 이동해요.
+ * - 토스 앱이 없으면: iOS는 앱스토어로, Android는 플레이스토어로 이동해요.
  *
- * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
- * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
+ * @param path - 딥링크 경로예요. `intoss://`로 시작하는 문자열이어야 해요. (예: `intoss://my-app`, `intoss://my-app/detail?id=123`)
+ * @param ogImageUrl - (선택) 공유 시 표시될 커스텀 OG 이미지 URL이에요. 최소 버전: Android 5.240.0, iOS 5.239.0
+ * @returns {Promise<string>} 생성된 토스 공유 링크
  *
  * @example
  * ```tsx
  * import { share } from '@granite-js/react-native';
  * import { getTossShareLink } from '@apps-in-toss/framework';
  *
- * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
+ * // 기본 사용법
  * const tossLink = await getTossShareLink('intoss://my-app');
- *
- * // 생성한 링크를 메시지로 공유해요.
  * await share({ message: tossLink });
+ *
+ * // 커스텀 OG 이미지와 함께 사용
+ * const linkWithImage = await getTossShareLink(
+ *   'intoss://my-app/event',
+ *   'https://example.com/og-image.png'
+ * );
+ * await share({ message: linkWithImage });
  * ```
  */
-export async function getTossShareLink(path: string): Promise<string> {
+export async function getTossShareLink(path: string, ogImageUrl?: string): Promise<string> {
+  if (!isMinVersionSupported(V2_MIN_VERSION)) {
+    return await getTossShareLinkV1(path);
+  }
+
+  const params = {
+    params: {
+      url: path,
+      ogImageUrl,
+    },
+  };
+
+  const { shareLink } = await AppsInTossModule.getTossShareLink(params);
+  return shareLink;
+}
+
+async function getTossShareLinkV1(path: string): Promise<string> {
   const { shareLink } = await AppsInTossModule.getTossShareLink({});
   const shareUrl = new URL(shareLink);
 

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

@@ -1,10 +0,0 @@
-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) {}
-}