@apps-in-toss/native-modules 0.0.0-dev.1765732023607 → 0.0.0-dev.1765878631929

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

@@ -717,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);
@@ -1033,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;

package/dist/index.d.cts

@@ -1351,6 +1351,7 @@ declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<Check
 
 interface AppsInTossSignTossCertParams {
     txId: string;
+    skipConfirmDoc?: boolean;
 }
 /**
  * @public
@@ -1360,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
@@ -2891,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

@@ -1351,6 +1351,7 @@ declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<Check
 
 interface AppsInTossSignTossCertParams {
     txId: string;
+    skipConfirmDoc?: boolean;
 }
 /**
  * @public
@@ -1360,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
@@ -2891,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

@@ -641,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);
@@ -957,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": "0.0.0-dev.1765732023607",
+  "version": "0.0.0-dev.1765878631929",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -43,7 +43,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "^0.0.0-dev.1765732023607",
+    "@apps-in-toss/types": "^0.0.0-dev.1765878631929",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e45c1308eb7d471b4873b1d92b7570e11bc85ae3"
+  "gitHead": "f54ad0a6526e1b4752239cb0670dedbab5170c67"
 }

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);