@apps-in-toss/native-modules 1.0.2 → 1.1.0

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

@@ -1,21 +1,6 @@
-import { AppsInTossModule } from './AppsInTossModule';
-import { requestPermission } from './requestPermission';
-
-/**
- * 연락처 정보를 나타내는 타입이에요.
- */
-export interface ContactEntity {
-  /** 연락처 이름이에요. */
-  name: string;
-  /** 연락처 전화번호로, 문자열 형식이에요. */
-  phoneNumber: string;
-}
-
-export interface ContactResult {
-  result: ContactEntity[];
-  nextOffset: number | null;
-  done: boolean;
-}
+import { FetchContactsPermissionError, type FetchContacts } from '@apps-in-toss/types';
+import { AppsInTossModule } from '../../AppsInTossModule';
+import { createPermissionFunction } from '../createPermissionFunction';
 
 /**
  * @public
@@ -27,6 +12,9 @@ export interface ContactResult {
  * @param options.offset - 가져올 연락처의 시작 지점이에요. 처음 호출할 때는 `0`을 전달해야 해요. 이후에는 이전 호출에서 반환된 `nextOffset` 값을 사용해요.
  * @param options.query - 추가적인 필터링 옵션이에요.
  * @param options.query.contains - 이름에 특정 문자열이 포함된 연락처만 가져오고 싶을 때 사용해요. 이 값을 전달하지 않으면 모든 연락처를 가져와요.
+ * @property [openPermissionDialog] - 연락처 읽기 권한을 다시 요청하는 다이얼로그를 표시해요. 사용자는 "허용", "한 번만 허용", "안하기" 중 하나를 선택할 수 있어요. "허용"이나 "한 번만 허용"을 선택하면 `allowed`를 반환하고, "안하기"를 선택하면 `denied`를 반환해요.
+ * @property [getPermission] - 연락처 읽기 권한의 현재 상태를 반환해요. `allowed`는 사용자가 연락처 읽기 권한을 허용한 상태예요. `denied`는 사용자가 연락처 읽기 권한을 거부한 상태예요. `notDetermined`는 연락처 읽기 권한 요청을 한 번도 하지 않은 상태예요.
+ *
  * @returns {Promise<ContactResult>}
  * 연락처 목록과 페이지네이션 정보를 포함한 객체를 반환해요.
  * - `result`: 가져온 연락처 목록이에요.
@@ -47,10 +35,15 @@ export interface ContactResult {
  * @example
  * ### 특정 문자열이 포함된 연락처 목록 가져오기
  *
+ * 연락처 목록을 가져오는 예제예요.
+ * "권한 확인하기"버튼을 눌러서 현재 연락처 읽기 권한을 확인해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`FetchContactsPermissionError`](/react-native/reference/types/권한/FetchContactsPermissionError)를 반환해요.
+ * "권한 요청하기"버튼을 눌러서 연락처 읽기 권한을 요청할 수 있어요.
+ *
  * ```tsx
- * import React, { useState } from 'react';
- * import { View, Text, Button } from 'react-native';
- * import { fetchContacts, ContactEntity } from '@apps-in-toss/framework';
+ * import { ContactEntity, fetchContacts, FetchContactsPermissionError } from '@apps-in-toss/framework';
+ * import { useState } from 'react';
+ * import { Alert, Button, Text, View } from 'react-native';
  *
  * // 특정 문자열을 포함한 연락처 목록을 가져와 화면에 표시하는 컴포넌트
  * function ContactsList() {
@@ -82,6 +75,9 @@ export interface ContactResult {
  *         done: response.done,
  *       }));
  *     } catch (error) {
+ *       if (error instanceof FetchContactsPermissionError) {
+ *         // 연락처 읽기 권한 없음
+ *       }
  *       console.error('연락처를 가져오는 데 실패했어요:', error);
  *     }
  *   };
@@ -89,33 +85,48 @@ export interface ContactResult {
  *   return (
  *     <View>
  *       {contacts.result.map((contact, index) => (
- *         <Text key={index}>{contact.name}: {contact.phoneNumber}</Text>
+ *         <Text key={index}>
+ *           {contact.name}: {contact.phoneNumber}
+ *         </Text>
  *       ))}
  *       <Button
  *         title={contacts.done ? '모든 연락처를 가져왔어요.' : '다음 연락처 가져오기'}
  *         disabled={contacts.done}
  *         onPress={handlePress}
  *       />
+ *       <Button
+ *         title="권한 확인하기"
+ *         onPress={async () => {
+ *           const permission = await fetchContacts.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *       <Button
+ *         title="권한 요청하기"
+ *         onPress={async () => {
+ *           const permission = await fetchContacts.openPermissionDialog();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
  *     </View>
  *   );
  * }
  * ```
  */
-export async function fetchContacts(options: {
-  size: number;
-  offset: number;
-  query?: {
-    contains?: string;
-  };
-}): Promise<ContactResult> {
-  const permissionStatus = await requestPermission({ name: 'contacts', access: 'read' });
-  if (permissionStatus === 'denied') {
-    throw new Error('연락처 권한이 거부되었어요.');
-  }
-  const contacts = await AppsInTossModule.fetchContacts(options);
-  return {
-    result: contacts.result,
-    nextOffset: contacts.nextOffset ?? null,
-    done: contacts.done,
-  };
-}
+
+export const fetchContacts = createPermissionFunction<FetchContacts>({
+  handler: async (options) => {
+    const contacts = await AppsInTossModule.fetchContacts(options);
+
+    return {
+      result: contacts.result,
+      nextOffset: contacts.nextOffset ?? null,
+      done: contacts.done,
+    };
+  },
+  permission: {
+    name: 'contacts',
+    access: 'read',
+  },
+  error: FetchContactsPermissionError,
+});

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

@@ -0,0 +1,87 @@
+import { GetClipboardTextPermissionError, type GetClipboardText } from '@apps-in-toss/types';
+import { AppsInTossModule } from '../../AppsInTossModule';
+import { createPermissionFunction } from '../createPermissionFunction';
+
+/**
+ * @public
+ * @category 클립보드
+ * @name getClipboardText
+ * @description 클립보드에 저장된 텍스트를 가져오는 함수예요. 복사된 텍스트를 읽어서 다른 작업에 활용할 수 있어요.
+ * @property [openPermissionDialog] - 클립보드 읽기 권한을 다시 요청하는 다이얼로그를 표시해요. 사용자는 "허용", "한 번만 허용", "안하기" 중 하나를 선택할 수 있어요. "허용"이나 "한 번만 허용"을 선택하면 `allowed`를 반환하고, "안하기"를 선택하면 `denied`를 반환해요.
+ * @property [getPermission] - 클립보드 읽기 권한의 현재 상태를 반환해요. `allowed`는 사용자가 클립보드 읽기 권한을 허용한 상태예요. `denied`는 사용자가 클립보드 읽기 권한을 거부한 상태예요. `notDetermined`는 클립보드 읽기 권한 요청을 한 번도 하지 않은 상태예요.
+ * @returns {Promise<string>} - 클립보드에 저장된 텍스트를 반환해요. 클립보드에 텍스트가 없으면 빈 문자열을 반환해요.
+ * 
+ * @signature
+ * ```typescript
+ * function getClipboardText(): Promise<string>;
+ * ```
+ *
+ * @example
+ * ### 클립보드의 텍스트 가져오기
+ * 
+ * 클립보드의 텍스트를 가져오는 예제예요.
+ * "권한 확인하기"버튼을 눌러서 현재 클립보드 읽기 권한을 확인해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`GetClipboardTextPermissionError`](/react-native/reference/types/권한/GetClipboardTextPermissionError)를 반환해요.
+ * "권한 요청하기"버튼을 눌러서 클립보드 읽기 권한을 요청할 수 있어요.
+ *
+ * ```tsx
+ * import {
+ *   getClipboardText,
+ *   GetClipboardTextPermissionError,
+ *   SetClipboardTextPermissionError,
+ * } from '@apps-in-toss/framework';
+ * import { useState } from 'react';
+ * import { Alert, Button, Text, View } from 'react-native'; * 
+
+ * // '붙여넣기' 버튼을 누르면 클립보드에 저장된 텍스트를 가져와 화면에 표시해요.
+ * function PasteButton() {
+ *   const [text, setText] = useState(''); * 
+
+ *   const handlePress = async () => {
+ *     try {
+ *       const clipboardText = await getClipboardText();
+ *       setText(clipboardText || '클립보드에 텍스트가 없어요.');
+ *     } catch (error) {
+ *       if (error instanceof GetClipboardTextPermissionError) {
+ *         // 클립보드 읽기 권한 없음
+ *       } * 
+
+ *       if (error instanceof SetClipboardTextPermissionError) {
+ *         // 클립보드 쓰기 권한 없음
+ *       }
+ *     }
+ *   }; * 
+
+ *   return (
+ *     <View>
+ *       <Text>{text}</Text>
+ *       <Button title="붙여넣기" onPress={handlePress} />
+ *       <Button
+ *         title="권한 확인하기"
+ *         onPress={async () => {
+ *           const permission = await getClipboardText.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *       <Button
+ *         title="권한 요청하기"
+ *         onPress={async () => {
+ *           const permission = await getClipboardText.openPermissionDialog();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export const getClipboardText = createPermissionFunction<GetClipboardText>({
+  handler: () => {
+    return AppsInTossModule.getClipboardText({});
+  },
+  permission: {
+    name: 'clipboard',
+    access: 'read',
+  },
+  error: GetClipboardTextPermissionError,
+});

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

@@ -0,0 +1,88 @@
+import { GetCurrentLocation, GetCurrentLocationPermissionError } from '@apps-in-toss/types';
+import { AppsInTossModule } from '../../AppsInTossModule';
+import { createPermissionFunction } from '../createPermissionFunction';
+
+/**
+ * @public
+ * @category 위치 정보
+ * @name getCurrentLocation
+ * @description 디바이스의 현재 위치 정보를 가져오는 함수예요.
+ * 위치 기반 서비스를 구현할 때 사용되고, 한 번만 호출되어 현재 위치를 즉시 반환해요.
+ * 예를 들어 지도 앱에서 사용자의 현재 위치를 한 번만 가져올 때, 날씨 앱에서 사용자의 위치를 기반으로 기상 정보를 제공할 때, 매장 찾기 기능에서 사용자의 위치를 기준으로 가까운 매장을 검색할 때 사용하면 유용해요.
+ *
+ * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
+ * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
+ * @property [openPermissionDialog] - 위치 정보 권한을 다시 요청하는 다이얼로그를 표시해요. 사용자는 "허용", "한 번만 허용", "안하기" 중 하나를 선택할 수 있어요. "허용"이나 "한 번만 허용"을 선택하면 `allowed`를 반환하고, "안하기"를 선택하면 `denied`를 반환해요.
+ * @property [getPermission] - 위치 정보 권한의 현재 상태를 반환해요. `allowed`는 사용자가 위치 정보 권한을 허용한 상태예요. `denied`는 사용자가 위치 정보 권한을 거부한 상태예요. `notDetermined`는 위치 정보 권한 요청을 한 번도 하지 않은 상태예요.
+ * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/react-native/reference/native-modules/Types/Location.html)을 참고해주세요.
+ *
+ * @signature
+ * ```typescript
+ * function getCurrentLocation(options: {
+ *   accuracy: Accuracy;
+ * }): Promise<Location>;
+ * ```
+ *
+ * @example
+ * ### 디바이스의 현재 위치 정보 가져오기
+ *
+ * "권한 확인하기"버튼을 눌러서 현재 위치정보 권한을 확인해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`GetCurrentLocationPermissionError`](/react-native/reference/types/권한/GetCurrentLocationPermissionError)를 반환해요.
+ * "권한 요청하기"버튼을 눌러서 위치정보 권한을 요청할 수 있어요.
+ *
+ * ```tsx
+ * import { Accuracy, getCurrentLocation, Location } from '@apps-in-toss/framework';
+ * import { useState } from 'react';
+ * import { Alert, Button, Text, View } from 'react-native';
+ *
+ * // 현재 위치 정보를 가져와 화면에 표시하는 컴포넌트
+ * function CurrentPosition() {
+ *   const [position, setPosition] = useState<Location | null>(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await getCurrentLocation({ accuracy: Accuracy.Balanced });
+ *       setPosition(response);
+ *     } catch (error) {
+ *       console.error('위치 정보를 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       {position ? (
+ *         <Text>
+ *           위치: {position.coords.latitude}, {position.coords.longitude}
+ *         </Text>
+ *       ) : (
+ *         <Text>위치 정보를 아직 가져오지 않았어요</Text>
+ *       )}
+ *       <Button title="현재 위치 정보 가져오기" onPress={handlePress} />
+ *       <Button
+ *         title="권한 확인하기"
+ *         onPress={async () => {
+ *           Alert.alert(await getCurrentLocation.getPermission());
+ *         }}
+ *       />
+ *       <Button
+ *         title="권한 요청하기"
+ *         onPress={async () => {
+ *           Alert.alert(await getCurrentLocation.openPermissionDialog());
+ *         }}
+ *       />
+ *     </View>
+ *   );
+ * }
+ *
+ * ```
+ */
+export const getCurrentLocation = createPermissionFunction<GetCurrentLocation>({
+  handler: async (options) => {
+    return AppsInTossModule.getCurrentLocation(options);
+  },
+  permission: {
+    name: 'geolocation',
+    access: 'access',
+  },
+  error: GetCurrentLocationPermissionError,
+});

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

@@ -0,0 +1,99 @@
+import { OpenCameraPermissionError, type OpenCamera } from '@apps-in-toss/types';
+import { AppsInTossModule } from '../../AppsInTossModule';
+import { createPermissionFunction } from '../createPermissionFunction';
+
+/**
+ * @public
+ * @category 카메라
+ * @name openCamera
+ * @description 카메라를 실행해서 촬영된 이미지를 반환하는 함수예요.
+ * @param {OpenCameraOptions} options - 카메라 실행 시 사용되는 옵션 객체예요.
+ * @param {boolean} [options.base64=false] - 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요. 기본값은 `false`예요. `true`로 설정하면 `dataUri` 대신 Base64 인코딩된 문자열을 반환해요.
+ * @param {number} [options.maxWidth=1024] - 이미지의 최대 너비를 나타내는 숫자 값이에요. 기본값은 `1024`예요.
+ * @property [openPermissionDialog] - 카메라 접근 권한을 다시 요청하는 다이얼로그를 표시해요. 사용자는 "허용", "한 번만 허용", "안하기" 중 하나를 선택할 수 있어요. "허용"이나 "한 번만 허용"을 선택하면 `allowed`를 반환하고, "안하기"를 선택하면 `denied`를 반환해요.
+ * @property [getPermission] - 카메라 접근 권한의 현재 상태를 반환해요. `allowed`는 사용자가 카메라 접근 권한을 허용한 상태예요. `denied`는 사용자가 카메라 접근 권한을 거부한 상태예요. `notDetermined`는 카메라 접근 권한 요청을 한 번도 하지 않은 상태예요.
+ * @returns {Promise<ImageResponse>}
+ * 촬영된 이미지 정보를 포함한 객체를 반환해요. 반환 객체의 구성은 다음과 같아요:
+ * - `id`: 이미지의 고유 식별자예요.
+ * - `dataUri`: 이미지 데이터를 표현하는 데이터 URI예요.
+ *
+ * @signature
+ * ```typescript
+ * function openCamera(options: {
+ *   base64: boolean;
+ *   maxWidth: number;
+ * }): Promise<ImageResponse>;
+ * ```
+ *
+ * @example
+ * ### 카메라 실행 후 촬영된 사진 가져오기
+ *
+ * 카메라로 사진을 찍고 결과를 가져오는 예제예요.
+ * 이 과정에서 현재 카메라 권한 상태를 확인할 수 있고, 권한이 없으면 권한을 요청해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`OpenCameraPermissionError`](/react-native/reference/types/권한/OpenCameraPermissionError)를 반환해요.
+ *
+ * ```tsx
+ * import { ImageResponse, openCamera, OpenCameraPermissionError } from '@apps-in-toss/framework';
+ * import { useState } from 'react';
+ * import { Alert, Button, Image, Text, View } from 'react-native';
+ *
+ * const base64 = true;
+ *
+ * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
+ * function Camera() {
+ *   const [image, setImage] = useState<ImageResponse | null>(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await openCamera({ base64 });
+ *       setImage(response);
+ *     } catch (error) {
+ *       if (error instanceof OpenCameraPermissionError) {
+ *         console.log('권한 에러');
+ *       }
+ *
+ *       console.error('사진을 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   // base64 형식으로 반환된 이미지를 표시하려면 데이터 URL 스키마 Prefix를 붙여야해요.
+ *   const imageUri = base64 ? 'data:image/jpeg;base64,' + image?.dataUri : image?.dataUri;
+ *
+ *   return (
+ *     <View>
+ *       {image ? <Image source={{ uri: imageUri }} style={{ width: 200, height: 200 }} /> : <Text>사진이 없어요</Text>}
+ *       <Button title="사진 촬영하기" onPress={handlePress} />
+ *       <Button
+ *         title="권한 확인하기"
+ *         onPress={async () => {
+ *           const permission = await openCamera.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *
+ *       <Button
+ *         title="권한 요청하기"
+ *         onPress={async () => {
+ *           const currentPermission = await openCamera.openPermissionDialog();
+ *           Alert.alert(currentPermission);
+ *         }}
+ *       />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export const openCamera = createPermissionFunction<OpenCamera>({
+  handler: (options) => {
+    return AppsInTossModule.openCamera({
+      base64: false,
+      maxWidth: 1024,
+      ...options,
+    });
+  },
+  permission: {
+    name: 'camera',
+    access: 'access',
+  },
+  error: OpenCameraPermissionError,
+});

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

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

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

@@ -1,6 +1,6 @@
-import { getPermission } from './getPermission';
+import type { PermissionAccess, PermissionName, PermissionStatus } from '@apps-in-toss/types';
 import { openPermissionDialog } from './openPermissionDialog';
-import { PermissionAccess, PermissionName, PermissionStatus } from '../../types';
+import { getPermission } from '../getPermission';
 
 /**
  * @category PermissionManagement

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

@@ -0,0 +1,75 @@
+import { SetClipboardTextPermissionError, type SetClipboardText } from '@apps-in-toss/types';
+import { AppsInTossModule } from '../../AppsInTossModule';
+import { createPermissionFunction } from '../createPermissionFunction';
+
+/**
+ * @public
+ * @category 클립보드
+ * @name setClipboardText
+ * @description 텍스트를 클립보드에 복사해서 사용자가 다른 곳에 붙여 넣기 할 수 있어요.
+ * @param {Promise<void>} text - 클립보드에 복사할 텍스트예요. 문자열 형식으로 입력해요.
+ * @property [openPermissionDialog] - 클립보드 쓰기 권한을 다시 요청하는 다이얼로그를 표시해요. 사용자는 "허용", "한 번만 허용", "안하기" 중 하나를 선택할 수 있어요. "허용"이나 "한 번만 허용"을 선택하면 `allowed`를 반환하고, "안하기"를 선택하면 `denied`를 반환해요.
+ * @property [getPermission] - 클립보드 쓰기 권한의 현재 상태를 반환해요. `allowed`는 사용자가 클립보드 쓰기 권한을 허용한 상태예요. `denied`는 사용자가 클립보드 쓰기 권한을 거부한 상태예요. `notDetermined`는 클립보드 쓰기 권한 요청을 한 번도 하지 않은 상태예요.
+ *
+ * @signature
+ * ```typescript
+ * function setClipboardText(text: string): Promise<void>;
+ * ```
+ *
+ * @example
+ * ### 텍스트를 클립보드에 복사하기
+ *
+ * 텍스트를 클립보드에 복사하는 예제예요.
+ * "권한 확인하기"버튼을 눌러서 현재 클립보드 쓰기 권한을 확인해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`SetClipboardTextPermissionError`](/react-native/reference/types/권한/SetClipboardTextPermissionError)를 반환해요.
+ * "권한 요청하기"버튼을 눌러서 클립보드 쓰기 권한을 요청할 수 있어요.
+ *
+ * ```tsx
+ * import { setClipboardText, SetClipboardTextPermissionError } from '@apps-in-toss/framework';
+ * import { Alert, Button } from 'react-native';
+ *
+ * // '복사' 버튼을 누르면 "복사할 텍스트"가 클립보드에 복사돼요.
+ * function CopyButton() {
+ *   const handleCopy = async () => {
+ *     try {
+ *       await setClipboardText('복사할 텍스트');
+ *       console.log('텍스트가 복사됐어요!');
+ *     } catch (error) {
+ *       if (error instanceof SetClipboardTextPermissionError) {
+ *         // 텍스트 쓰기 권한 거부됨
+ *       }
+ *     }
+ *   };
+ *
+ *   return (
+ *     <>
+ *       <Button title="복사" onPress={handleCopy} />
+ *       <Button
+ *         title="권한 확인하기"
+ *         onPress={async () => {
+ *           const permission = await setClipboardText.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *       <Button
+ *         title="권한 요청하기"
+ *         onPress={async () => {
+ *           const permission = await setClipboardText.openPermissionDialog();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export const setClipboardText = createPermissionFunction<SetClipboardText>({
+  handler: (text) => {
+    return AppsInTossModule.setClipboardText({ text });
+  },
+  permission: {
+    name: 'clipboard',
+    access: 'write',
+  },
+  error: SetClipboardTextPermissionError,
+});

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

@@ -14,7 +14,7 @@ export interface SaveBase64DataParams {
  * @description 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요. 이미지, 텍스트, PDF 등 다양한 형식의 데이터를 저장할 수 있어요.
  * @param {SaveBase64DataParams} params - 저장할 데이터와 파일 정보를 담은 객체예요.
  * @param {string} params.data - Base64 형식으로 인코딩된 데이터 문자열이에요.
- * @param {string} params.fileName - 저장할 파일 이름이에요. 확장자도 같이 붙여줘야해요. 예를 들어, 'example.png'로 저장할 수 있어요. 
+ * @param {string} params.fileName - 저장할 파일 이름이에요. 확장자도 같이 붙여줘야해요. 예를 들어, 'example.png'로 저장할 수 있어요.
  * @param {string} params.mimeType - 저장할 파일의 MIME 타입이에요. 예를 들어 'image/png' 로 지정하면 이미지, 'application/pdf'는 PDF 파일이에요. 자세한 내용은 [MIME 문서](https://developer.mozilla.org/ko/docs/Web/HTTP/Guides/MIME_types)를 참고해주세요.
  *
  * @example

package/src/async-bridges.ts

@@ -9,12 +9,15 @@ export * from './BedrockModule/native-modules/natives/setIosSwipeGestureEnabled'
 export * from './BedrockModule/native-modules/natives/openURL';
 
 // AppsInTossModule
-export * from './AppsInTossModule/native-modules/setClipboardText';
-export * from './AppsInTossModule/native-modules/getClipboardText';
-export * from './AppsInTossModule/native-modules/fetchContacts';
-export * from './AppsInTossModule/native-modules/fetchAlbumPhotos';
-export * from './AppsInTossModule/native-modules/getCurrentLocation';
-export * from './AppsInTossModule/native-modules/openCamera';
+export * from './AppsInTossModule/native-modules/permissions/openPermissionDialog';
+export * from './AppsInTossModule/native-modules/permissions/requestPermission';
+export * from './AppsInTossModule/native-modules/getPermission';
+export * from './AppsInTossModule/native-modules/permissions/setClipboardText/setClipboardText';
+export * from './AppsInTossModule/native-modules/permissions/getClipboardText/getClipboardText';
+export * from './AppsInTossModule/native-modules/permissions/fetchContacts/fetchContacts';
+export * from './AppsInTossModule/native-modules/permissions/fetchAlbumPhotos/fetchAlbumPhotos';
+export * from './AppsInTossModule/native-modules/permissions/getCurrentLocation/getCurrentLocation';
+export * from './AppsInTossModule/native-modules/permissions/openCamera/openCamera';
 export * from './AppsInTossModule/native-modules/appLogin';
 export * from './AppsInTossModule/native-modules/eventLog';
 export * from './AppsInTossModule/native-modules/getTossShareLink';

package/src/types.ts

@@ -1,108 +1,2 @@
-export type PermissionStatus = 'notDetermined' | 'denied' | 'allowed';
-export type PermissionAccess = 'read' | 'write' | 'access';
-export type PermissionName = 'clipboard' | 'contacts' | 'photos' | 'geolocation' | 'camera';
-
 // Log
 export type Primitive = string | number | boolean | null | undefined | symbol;
-
-/**
- * @public
- * @category 위치 정보
- * @name Accuracy
- * @description 위치 정확도 옵션이에요.
- */
-export enum Accuracy {
-  /**
-   * 오차범위 3KM 이내
-   */
-  Lowest = 1,
-  /**
-   * 오차범위 1KM 이내
-   */
-  Low,
-  /**
-   * 오차범위 몇 백미터 이내
-   */
-  Balanced,
-  /**
-   * 오차범위 10M 이내
-   */
-  High,
-  /**
-   * 가장 높은 정확도
-   */
-  Highest,
-  /**
-   * 네비게이션을 위한 최고 정확도
-   */
-  BestForNavigation,
-}
-
-/**
- * @public
- * @category 위치 정보
- * @name Location
- * @description 위치 정보를 나타내는 객체예요.
- */
-export interface Location {
-  /**
-   * Android에서만 지원하는 옵션이에요.
-   *
-   * - `FINE`: 정확한 위치
-   * - `COARSE`: 대략적인 위치
-   *
-   * @see https://developer.android.com/codelabs/approximate-location
-   */
-  accessLocation?: 'FINE' | 'COARSE';
-  /**
-   * 위치가 업데이트된 시점의 유닉스 타임스탬프예요.
-   */
-  timestamp: number;
-  /**
-   * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/react-native/reference/native-modules/Types/LocationCoords.html)을 참고해주세요.
-   */
-  coords: LocationCoords;
-}
-
-/**
- * @public
- * @category 위치 정보
- * @name LocationCoords
- * @description 세부 위치 정보를 나타내는 객체예요.
- */
-export interface LocationCoords {
-  /**
-   * 위도
-   */
-  latitude: number;
-  /**
-   * 경도
-   */
-  longitude: number;
-  /**
-   * 높이
-   */
-  altitude: number;
-  /**
-   * 위치 정확도
-   */
-  accuracy: number;
-  /**
-   * 고도 정확도
-   */
-  altitudeAccuracy: number;
-  /**
-   * 방향
-   */
-  heading: number;
-}
-
-/**
- * 사진 조회 결과를 나타내는 타입이에요.
- */
-export interface ImageResponse {
-  /** 가져온 사진의 고유 ID예요. */
-  id: string;
-  /** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
-  dataUri: string;
-}