@apps-in-toss/native-modules 1.14.0 → 2.0.0

package/src/{AppsInTossModule → MiniAppModule}/native-modules/appsInTossSignTossCert.ts

@@ -1,20 +1,8 @@
-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;
+import { safePostMessage } from '../../natives';
 
 export interface AppsInTossSignTossCertParams {
   txId: string;
-  skipConfirmDoc?: boolean;
 }
 
 /**
@@ -25,7 +13,6 @@ 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
@@ -47,14 +34,15 @@ export interface AppsInTossSignTossCertParams {
  */
 
 export async function appsInTossSignTossCert(params: AppsInTossSignTossCertParams) {
-  const minVersion =
-    params.skipConfirmDoc === true ? MIN_VERSION_BY_USER_TYPE.USER_NONE : MIN_VERSION_BY_USER_TYPE.USER_PERSONAL;
-  const isSupported = isMinVersionSupported(minVersion);
+  const isSupported = isMinVersionSupported({
+    android: '5.233.0',
+    ios: '5.233.0',
+  });
 
   if (!isSupported) {
     console.warn('appsInTossSignTossCert is not supported in this app version');
     return;
   }
 
-  await AppsInTossModule.appsInTossSignTossCert({ params });
+  await safePostMessage('appsInTossSignTossCert', params);
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/checkoutPayment.ts

@@ -1,4 +1,4 @@
-import { AppsInTossModule } from './AppsInTossModule';
+import { safePostMessage } from '../../natives';
 
 /**
  * @public
@@ -75,6 +75,6 @@ export interface CheckoutPaymentResult {
  * }
  * ```
  */
-export async function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult> {
-  return AppsInTossModule.checkoutPayment({ params: options });
+export async function checkoutPayment(options: { params: CheckoutPaymentOptions }): Promise<CheckoutPaymentResult> {
+  return safePostMessage('checkoutPayment', options.params);
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/eventLog.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { MiniAppModule, safePostMessage } from '../../natives';
 import { Primitive } from '../../types';
 
 function normalizeParams(params: Record<string, Primitive>): Record<string, string> {
@@ -52,7 +52,7 @@ export interface EventLogParams {
  * ```
  */
 export async function eventLog(params: EventLogParams) {
-  if (AppsInTossModule.operationalEnvironment === 'sandbox') {
+  if (MiniAppModule.getConstants().operationalEnvironment === 'sandbox') {
     console.log('[eventLogDebug]', {
       log_name: params.log_name,
       log_type: params.log_type,
@@ -69,7 +69,7 @@ export async function eventLog(params: EventLogParams) {
     return;
   }
 
-  return AppsInTossModule.eventLog({
+  return safePostMessage('eventLog', {
     log_name: params.log_name,
     log_type: params.log_type,
     params: normalizeParams(params.params),

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getDeviceId.ts

@@ -1,4 +1,4 @@
-import { AppsInTossModule } from './AppsInTossModule';
+import { MiniAppModule } from '../../natives';
 
 /**
  * @public
@@ -29,5 +29,5 @@ import { AppsInTossModule } from './AppsInTossModule';
  * ```
  */
 export function getDeviceId(): string {
-  return AppsInTossModule.deviceId;
+  return MiniAppModule.getConstants().deviceId;
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getGameCenterGameProfile.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 import { GAME_CENTER_MIN_VERSION } from '../constants';
 
 /**
@@ -64,5 +64,5 @@ export async function getGameCenterGameProfile() {
     return;
   }
 
-  return AppsInTossModule.getGameCenterGameProfile({});
+  return safePostMessage('getGameCenterGameProfile', {});
 }

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

@@ -0,0 +1,20 @@
+import { MiniAppModule } from '../../natives';
+
+/**
+ * @public
+ * @category Constants
+ * @name getGroupId
+ * @description 앱인토스에서 제공하는 그룹 ID를 가져와요.
+ * @returns {string} 그룹 ID
+ *
+ * @example
+ * ```typescript
+ * import { getGroupId } from '@apps-in-toss/native-modules';
+ *
+ * const groupId = getGroupId();
+ * console.log('Group ID:', groupId);
+ * ```
+ */
+export function getGroupId(): string {
+  return MiniAppModule.getConstants().groupId;
+}

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getIsTossLoginIntegratedService.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 import { GET_IS_TOSS_LOGIN_INTEGRATED_SERVICE_MIN_VERSION } from '../constants';
 
 /**
@@ -56,6 +56,6 @@ export async function getIsTossLoginIntegratedService(): Promise<boolean | undef
     return;
   }
 
-  const response = await AppsInTossModule.getIsTossLoginIntegratedService({});
+  const response = await safePostMessage('getIsTossLoginIntegratedService', {});
   return response;
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getOperationalEnvironment.ts

@@ -1,4 +1,4 @@
-import { AppsInTossModule } from './AppsInTossModule';
+import { MiniAppModule } from '../../natives';
 
 /**
  * @public
@@ -33,5 +33,5 @@ import { AppsInTossModule } from './AppsInTossModule';
  * ```
  */
 export function getOperationalEnvironment(): 'toss' | 'sandbox' {
-  return AppsInTossModule.operationalEnvironment;
+  return MiniAppModule.getConstants().operationalEnvironment;
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getPermission.ts

@@ -1,5 +1,5 @@
 import type { PermissionAccess, PermissionName, PermissionStatus } from '@apps-in-toss/types';
-import { AppsInTossModule } from './AppsInTossModule';
+import { safePostMessage } from '../../natives';
 
 /**
  * @category AppsInTossModules
@@ -54,5 +54,5 @@ export function getPermission(permission: {
   name: PermissionName;
   access: PermissionAccess;
 }): Promise<PermissionStatus> {
-  return AppsInTossModule.getPermission(permission);
+  return safePostMessage('getPermission', permission);
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getServerTime.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 import { GET_SERVER_TIME_MIN_VERSION } from '../constants';
 
 /**
@@ -40,7 +40,7 @@ export async function getServerTime(): Promise<number | undefined> {
     return;
   }
 
-  return (await AppsInTossModule.getServerTime({})).serverTime;
+  return (await safePostMessage('getServerTime', {})).serverTime;
 }
 
 getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getTossAppVersion.ts

@@ -1,4 +1,4 @@
-import { AppsInTossModule } from './AppsInTossModule';
+import { MiniAppModule } from '../../natives';
 
 /**
  * @public
@@ -29,5 +29,5 @@ import { AppsInTossModule } from './AppsInTossModule';
  * ```
  */
 export function getTossAppVersion() {
-  return AppsInTossModule.tossAppVersion;
+  return MiniAppModule.getConstants().tossAppVersion;
 }

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

@@ -0,0 +1,39 @@
+import { safePostMessage } from '../../natives';
+
+/**
+ * @public
+ * @category 공유
+ * @kind function
+ * @name getTossShareLink
+ * @description
+ * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
+ * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
+ *
+ * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
+ * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
+ *
+ * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
+ *
+ * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
+ * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
+ *
+ * @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 });
+ * ```
+ */
+export async function getTossShareLink(path: string): Promise<string> {
+  const { shareLink } = await safePostMessage('getTossShareLink', {});
+  const shareUrl = new URL(shareLink);
+
+  shareUrl.searchParams.set('deep_link_value', path);
+  shareUrl.searchParams.set('af_dp', path);
+  return shareUrl.toString();
+}

package/src/{AppsInTossModule → MiniAppModule}/native-modules/getUserKeyForGame.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 import { GAME_USER_KEY_MIN_VERSION } from '../constants';
 
 export interface GetUserKeyForGameSuccessResponse {
@@ -110,7 +110,7 @@ export async function getUserKeyForGame(): Promise<
   }
 
   try {
-    const response = await AppsInTossModule.getUserKeyForGame({});
+    const response = (await safePostMessage('getUserKeyForGame', {})) as GetUserKeyForGameResponse;
     if (response.type === 'HASH') {
       return response;
     }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/grantPromotionRewardForGame.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 import { GAME_PROMOTION_REWARD_MIN_VERSION } from '../constants';
 
 export interface GrantPromotionRewardForGameSuccessResponse {
@@ -136,10 +136,11 @@ function isGrantPromotionRewardForGameError(error: unknown): error is { code: st
  * }
  * ```
  */
-export async function grantPromotionRewardForGame({
-  params,
-}: {
-  params: { promotionCode: string; amount: number };
+export async function grantPromotionRewardForGame(params: {
+  params: {
+    promotionCode: string;
+    amount: number;
+  };
 }): Promise<GrantPromotionRewardForGameResult> {
   const isSupported = isMinVersionSupported(GAME_PROMOTION_REWARD_MIN_VERSION);
 
@@ -148,7 +149,10 @@ export async function grantPromotionRewardForGame({
   }
 
   try {
-    const response = await AppsInTossModule.grantPromotionRewardForGame({ params });
+    const response = (await safePostMessage(
+      'grantPromotionRewardForGame',
+      params.params
+    )) as GrantPromotionRewardForGameResponse;
     if (response.key) {
       return response;
     }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/iap.ts

@@ -1,9 +1,8 @@
-import { AppsInTossModule } from './AppsInTossModule';
+import { noop } from 'es-toolkit';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 import { INTERNAL__appBridgeHandler } from '../native-event-emitter/internal/appBridge';
 
-const noop = () => {};
-
 type Sku =
   | {
       /**
@@ -73,11 +72,11 @@ interface IapRequestOneTimePurchaseOptions {
 
 export function iapCreateOneTimePurchaseOrder(params: Sku) {
   const sku = (params.sku ?? params.productId) as string;
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+  return safePostMessage('iapCreateOneTimePurchaseOrder', { productId: sku });
 }
 
 export function processProductGrant(params: { orderId: string; isProductGranted: boolean }) {
-  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+  return safePostMessage('processProductGrant', { orderId: params.orderId, isProductGranted: params.isProductGranted });
 }
 
 export function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions) {
@@ -182,7 +181,7 @@ function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions
 
   if (!isProcessProductGrantSupported) {
     const v1 = () => {
-      AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku })
+      safePostMessage('iapCreateOneTimePurchaseOrder', { productId: sku })
         .then((response: IapCreateOneTimePurchaseOrderResult) => {
           Promise.resolve(options.processProductGrant({ orderId: response.orderId }))
             .then(() => {
@@ -208,7 +207,7 @@ function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions
     {
       onPurchased: async (params: { orderId: string }) => {
         const isProductGranted = await options.processProductGrant(params);
-        await AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted });
+        await safePostMessage('processProductGrant', { orderId: params.orderId, isProductGranted });
       },
       onSuccess: (result: IapCreateOneTimePurchaseOrderResult) => {
         onEvent({ type: 'success', data: result });
@@ -394,7 +393,7 @@ async function getProductItemList() {
     return;
   }
 
-  return AppsInTossModule.iapGetProductItemList({});
+  return safePostMessage('iapGetProductItemList', {});
 }
 
 /**
@@ -429,7 +428,7 @@ async function getPendingOrders() {
     return;
   }
 
-  return AppsInTossModule.getPendingOrders({});
+  return safePostMessage('getPendingOrders', {});
 }
 
 /**
@@ -482,7 +481,7 @@ async function getCompletedOrRefundedOrders(params?: { key?: string | null }) {
     return;
   }
 
-  return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
+  return safePostMessage('getCompletedOrRefundedOrders', params ?? { key: null });
 }
 
 /**
@@ -518,7 +517,7 @@ async function completeProductGrant(params: { params: { orderId: string } }) {
     return;
   }
 
-  return AppsInTossModule.completeProductGrant(params);
+  return safePostMessage('completeProductGrant', params.params);
 }
 
 /**
@@ -623,7 +622,7 @@ function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurchaseOrder
     {
       onPurchased: async (purchasedParams: { orderId: string; subscriptionId?: string }) => {
         const isProductGranted = await processProductGrant(purchasedParams);
-        await AppsInTossModule.processProductGrant({ orderId: purchasedParams.orderId, isProductGranted });
+        await safePostMessage('processProductGrant', { orderId: purchasedParams.orderId, isProductGranted });
       },
       onSuccess: (result: IapCreateSubscriptionPurchaseOrderResult) => {
         onEvent({ type: 'success', data: result });

package/src/{AppsInTossModule → MiniAppModule}/native-modules/index.ts

@@ -14,9 +14,6 @@ import {
 // TossPay
 import { checkoutPayment, type CheckoutPaymentOptions, type CheckoutPaymentResult } from './checkoutPayment';
 
-export { AppsInTossModuleInstance as INTERNAL__AppsInTossModule } from './AppsInTossModule';
-export { AppsInTossModule } from './AppsInTossModule';
-
 export * from './appLogin';
 export * from './eventLog';
 
@@ -45,6 +42,9 @@ export * from './grantPromotionRewardForGame';
 export * from './getIsTossLoginIntegratedService';
 export * from '../native-event-emitter/contactsViral';
 export * from './appsInTossSignTossCert';
+export * from './getGroupId';
+
+export * from './shareWithScheme';
 export * from './getServerTime';
 
 export type {
@@ -70,6 +70,8 @@ export const TossPay = {
   checkoutPayment,
 };
 
+export * from './checkoutPayment';
+
 /**
  * @public
  * @category 광고

package/src/{AppsInTossModule → MiniAppModule}/native-modules/isMinVersionSupported.ts

@@ -1,5 +1,5 @@
 import { Platform } from 'react-native';
-import { AppsInTossModule } from './AppsInTossModule';
+import { MiniAppModule } from '../../natives';
 import { compareVersions } from '../../utils/compareVersion';
 
 /**
@@ -44,12 +44,12 @@ export function isMinVersionSupported(minVersions: {
   android: `${number}.${number}.${number}` | 'always' | 'never';
   ios: `${number}.${number}.${number}` | 'always' | 'never';
 }): boolean {
-  const operationalEnvironment = AppsInTossModule.operationalEnvironment;
+  const operationalEnvironment = MiniAppModule.getConstants().operationalEnvironment;
   if (operationalEnvironment === 'sandbox') {
     return true;
   }
 
-  const currentVersion = AppsInTossModule.tossAppVersion;
+  const currentVersion = MiniAppModule.getConstants().tossAppVersion;
   const isIOS = Platform.OS === 'ios';
   const minVersion = isIOS ? minVersions.ios : minVersions.android;
 

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/fetchAlbumPhotos/fetchAlbumPhotos.ts

@@ -1,5 +1,5 @@
 import { FetchAlbumPhotos, FetchAlbumPhotosPermissionError } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../../AppsInTossModule';
+import { safePostMessage } from '../../../../natives';
 import { createPermissionFunction } from '../createPermissionFunction';
 
 const DEFAULT_MAX_COUNT = 10;
@@ -95,7 +95,7 @@ const DEFAULT_MAX_WIDTH = 1024;
  */
 export const fetchAlbumPhotos = createPermissionFunction<FetchAlbumPhotos>({
   handler: async (options) => {
-    return AppsInTossModule.fetchAlbumPhotos({
+    return safePostMessage('fetchAlbumPhotos', {
       ...options,
       maxCount: options?.maxCount ?? DEFAULT_MAX_COUNT,
       maxWidth: options?.maxWidth ?? DEFAULT_MAX_WIDTH,

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/fetchContacts/fetchContacts.ts

@@ -1,5 +1,5 @@
 import { FetchContactsPermissionError, type FetchContacts } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../../AppsInTossModule';
+import { safePostMessage } from '../../../../natives';
 import { createPermissionFunction } from '../createPermissionFunction';
 
 /**
@@ -116,7 +116,7 @@ import { createPermissionFunction } from '../createPermissionFunction';
 
 export const fetchContacts = createPermissionFunction<FetchContacts>({
   handler: async (options) => {
-    const contacts = await AppsInTossModule.fetchContacts(options);
+    const contacts = await safePostMessage('fetchContacts', options);
 
     return {
       result: contacts.result,

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/getClipboardText/getClipboardText.ts

@@ -1,5 +1,5 @@
 import { GetClipboardTextPermissionError, type GetClipboardText } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../../AppsInTossModule';
+import { safePostMessage } from '../../../../natives';
 import { createPermissionFunction } from '../createPermissionFunction';
 
 /**
@@ -77,7 +77,7 @@ import { createPermissionFunction } from '../createPermissionFunction';
  */
 export const getClipboardText = createPermissionFunction<GetClipboardText>({
   handler: () => {
-    return AppsInTossModule.getClipboardText({});
+    return safePostMessage('getClipboardText', {});
   },
   permission: {
     name: 'clipboard',

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/getCurrentLocation/getCurrentLocation.ts

@@ -1,5 +1,5 @@
 import { GetCurrentLocation, GetCurrentLocationPermissionError } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../../AppsInTossModule';
+import { safePostMessage } from '../../../../natives';
 import { createPermissionFunction } from '../createPermissionFunction';
 
 /**
@@ -78,7 +78,7 @@ import { createPermissionFunction } from '../createPermissionFunction';
  */
 export const getCurrentLocation = createPermissionFunction<GetCurrentLocation>({
   handler: async (options) => {
-    return AppsInTossModule.getCurrentLocation(options);
+    return safePostMessage('getCurrentLocation', options);
   },
   permission: {
     name: 'geolocation',

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/openCamera/openCamera.ts

@@ -1,5 +1,5 @@
 import { OpenCameraPermissionError, type OpenCamera } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../../AppsInTossModule';
+import { safePostMessage } from '../../../../natives';
 import { createPermissionFunction } from '../createPermissionFunction';
 
 /**
@@ -85,7 +85,7 @@ import { createPermissionFunction } from '../createPermissionFunction';
  */
 export const openCamera = createPermissionFunction<OpenCamera>({
   handler: (options) => {
-    return AppsInTossModule.openCamera({
+    return safePostMessage('openCamera', {
       base64: false,
       maxWidth: 1024,
       ...options,

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/openPermissionDialog.ts

@@ -1,5 +1,5 @@
 import type { PermissionAccess, PermissionDialogFunction, PermissionName } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../AppsInTossModule';
+import { safePostMessage } from '../../../natives';
 
 /**
  * @category AppsInTossModules
@@ -50,5 +50,5 @@ export function openPermissionDialog(permission: {
   name: PermissionName;
   access: PermissionAccess;
 }): ReturnType<PermissionDialogFunction> {
-  return AppsInTossModule.openPermissionDialog(permission);
+  return safePostMessage('openPermissionDialog', permission);
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/permissions/setClipboardText/setClipboardText.ts

@@ -1,5 +1,5 @@
 import { SetClipboardTextPermissionError, type SetClipboardText } from '@apps-in-toss/types';
-import { AppsInTossModule } from '../../AppsInTossModule';
+import { safePostMessage } from '../../../../natives';
 import { createPermissionFunction } from '../createPermissionFunction';
 
 /**
@@ -65,7 +65,7 @@ import { createPermissionFunction } from '../createPermissionFunction';
  */
 export const setClipboardText = createPermissionFunction<SetClipboardText>({
   handler: (text) => {
-    return AppsInTossModule.setClipboardText({ text });
+    return safePostMessage('setClipboardText', { text });
   },
   permission: {
     name: 'clipboard',

package/src/{AppsInTossModule → MiniAppModule}/native-modules/saveBase64Data.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 
 export interface SaveBase64DataParams {
   data: string;
@@ -53,5 +53,5 @@ export async function saveBase64Data(params: SaveBase64DataParams) {
     return;
   }
 
-  await AppsInTossModule.saveBase64Data(params);
+  await safePostMessage('saveBase64Data', params);
 }

package/src/{AppsInTossModule → MiniAppModule}/native-modules/setDeviceOrientation.ts

@@ -1,5 +1,5 @@
-import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
 
 /**
  * @public
@@ -70,5 +70,5 @@ export async function setDeviceOrientation(options: { type: 'portrait' | 'landsc
     return;
   }
 
-  return AppsInTossModule.setDeviceOrientation(options);
+  return safePostMessage('setDeviceOrientation', options);
 }

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

@@ -0,0 +1,23 @@
+import { safeSyncPostMessage } from '../../natives';
+
+/**
+ * @public
+ * @category 공유
+ * @kind function
+ * @name shareWithScheme
+ * @description
+ * `shareWithScheme` 함수는 지정한 스킴 URL을 다른 앱과 공유해요.
+ *
+ * @param params - 공유할 스킴 URL 정보
+ * @param params.schemeURL - 공유할 스킴 URL
+ *
+ * @example
+ * ```tsx
+ * import { shareWithScheme } from '@apps-in-toss/native-modules';
+ *
+ * shareWithScheme({ schemeURL: 'intoss://my-app?referrer=share' });
+ * ```
+ */
+export function shareWithScheme(params: { schemeURL: string }): void {
+  safeSyncPostMessage('shareWithScheme', params);
+}