@apps-in-toss/web-bridge 1.0.3 → 1.1.1

package/built/bridge.d.ts

@@ -6,6 +6,9 @@ export * from './setScreenAwakeMode';
 export * from './getNetworkStatus';
 export * from './setIosSwipeGestureEnabled';
 export * from './openURL';
+export * from './openPermissionDialog';
+export * from './getPermission';
+export * from './requestPermission';
 export * from './setClipboardText';
 export * from './getClipboardText';
 export * from './fetchContacts';
@@ -27,7 +30,7 @@ export * from './getPlatformOS';
 export * from './getOperationalEnvironment';
 export * from './getTossAppVersion';
 export * from './getDeviceId';
+export * from './contactsViral';
 export * from './startUpdateLocation';
 export * from './onVisibilityChangedByTransparentServiceWeb';
-export * from './contactsViral';
 export * from './types';

package/built/bridge.js

@@ -1 +1 @@
-import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var setClipboardText=createAsyncBridge("setClipboardText");export var getClipboardText=createAsyncBridge("getClipboardText");export var fetchContacts=createAsyncBridge("fetchContacts");export var fetchAlbumPhotos=createAsyncBridge("fetchAlbumPhotos");export var getCurrentLocation=createAsyncBridge("getCurrentLocation");export var openCamera=createAsyncBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");export var contactsViral=createEventBridge("contactsViral");export var Accuracy=function(Accuracy){Accuracy[Accuracy["Lowest"]=1]="Lowest";Accuracy[Accuracy["Low"]=2]="Low";Accuracy[Accuracy["Balanced"]=3]="Balanced";Accuracy[Accuracy["High"]=4]="High";Accuracy[Accuracy["Highest"]=5]="Highest";Accuracy[Accuracy["BestForNavigation"]=6]="BestForNavigation";return Accuracy}({});
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");

package/built/fetchAlbumPhotos.d.ts

@@ -1,12 +1,3 @@
-/**
- * 사진 조회 결과를 나타내는 타입이에요.
- */
-export interface ImageResponse {
-	/** 가져온 사진의 고유 ID예요. */
-	id: string;
-	/** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
-	dataUri: string;
-}
 /**
  * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
  */
@@ -18,6 +9,23 @@ export interface FetchAlbumPhotosOptions {
 	/** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
 	base64?: boolean;
 }
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+export interface ImageResponse {
+	/** 가져온 사진의 고유 ID예요. */
+	id: string;
+	/** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+	dataUri: string;
+}
+export type FetchAlbumPhotos = (options?: FetchAlbumPhotosOptions) => Promise<ImageResponse[]>;
+type PermissionStatus$1 = "notDetermined" | "denied" | "allowed";
+export type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus$1, "notDetermined">>;
+export type GetPermissionFunction = () => Promise<PermissionStatus$1>;
+export type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+	getPermission: GetPermissionFunction;
+	openPermissionDialog: PermissionDialogFunction;
+};
 /**
  * @public
  * @category 사진
@@ -30,22 +38,38 @@ export interface FetchAlbumPhotosOptions {
  * @param {number} [options.maxCount=10] 가져올 사진의 최대 개수를 설정해요. 숫자로 입력하며 기본값은 10이에요.
  * @param {number} [options.maxWidth=1024] 사진의 최대 폭을 제한해요. 단위는 픽셀이며 기본값은 `1024`이에요.
  * @param {boolean} [options.base64=false] 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요.
+ * @property [openPermissionDialog] - 사진첩 읽기 권한을 다시 요청하는 다이얼로그를 표시해요. 사용자는 "허용", "한 번만 허용", "안하기" 중 하나를 선택할 수 있어요. "허용"이나 "한 번만 허용"을 선택하면 `allowed`를 반환하고, "안하기"를 선택하면 `denied`를 반환해요.
+ * @property [getPermission] - 사진첩 읽기 권한의 현재 상태를 반환해요. `allowed`는 사용자가 사진첩 읽기 권한을 허용한 상태예요. `denied`는 사용자가 사진첩 읽기 권한을 거부한 상태예요. `notDetermined`는 사진첩 읽기 권한 요청을 한 번도 하지 않은 상태예요.
  * @returns {Promise<ImageResponse[]>}
  * 앨범 사진의 고유 ID와 데이터 URI를 포함한 배열을 반환해요.
  *
+ * @signature
+ * ```typescript
+ * function fetchAlbumPhotos(options: {
+ *   maxCount: number;
+ *   maxWidth: number;
+ *   base64: boolean;
+ * }): Promise<ImageResponse[]>;
+ * ```
+ *
  * @example
  * ### 사진의 최대 폭을 360px로 제한하여 가져오기
  *
+ * 사진을 가져오는 예제예요.
+ * "권한 확인하기"버튼을 눌러서 현재 사진첩 읽기 권한을 확인해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`FetchAlbumPhotosPermissionError`](/react-native/reference/types/권한/FetchAlbumPhotosPermissionError)를 반환해요.
+ * "권한 요청하기"버튼을 눌러서 사진첩 읽기 권한을 요청할 수 있어요.
+ *
  * ```tsx
- * import React, { useState } from 'react';
+ * import { fetchAlbumPhotos, FetchAlbumPhotosPermissionError, ImageResponse } from '@apps-in-toss/web-framework';
+ * import { useState } from 'react';
  * 
- * import { fetchAlbumPhotos } from '@apps-in-toss/web-framework';
  *
  * const base64 = true;
  *
  * // 앨범 사진 목록을 가져와 화면에 표시하는 컴포넌트
  * function AlbumPhotoList() {
- *   const [albumPhotos, setAlbumPhotos] = useState([]);
+ *   const [albumPhotos, setAlbumPhotos] = useState<ImageResponse[]>([]);
  *
  *   const handlePress = async () => {
  *     try {
@@ -53,8 +77,11 @@ export interface FetchAlbumPhotosOptions {
  *         base64,
  *         maxWidth: 360,
  *       });
- *       setAlbumPhotos((prev) => ([...prev, ...response]));
+ *       setAlbumPhotos((prev) => [...prev, ...response]);
  *     } catch (error) {
+ *       if (error instanceof FetchAlbumPhotosPermissionError) {
+ *         // 앨범 읽기 권한 없음
+ *       }
  *       console.error('앨범을 가져오는 데 실패했어요:', error);
  *     }
  *   };
@@ -68,11 +95,25 @@ export interface FetchAlbumPhotosOptions {
  *         return <Image source={{ uri: imageUri }} key={image.id} />;
  *       })}
  *       <input type="button" value="앨범 가져오기" onClick={handlePress} />
+ *       <input type="button"
+ *         value="권한 확인하기"
+ *         onClick={async () => {
+ *           const permission = await fetchAlbumPhotos.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *       <input type="button"
+ *         value="권한 요청하기"
+ *         onClick={async () => {
+ *           const permission = await fetchAlbumPhotos.openPermissionDialog();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
  *     </div>
  *   );
  * }
  * ```
  */
-export declare function fetchAlbumPhotos(options: FetchAlbumPhotosOptions): Promise<ImageResponse[]>;
+export declare const fetchAlbumPhotos: PermissionFunctionWithDialog<FetchAlbumPhotos>;
 
 export {};

package/built/fetchContacts.d.ts

@@ -1,3 +1,10 @@
+export interface FetchContactsOptions {
+	size: number;
+	offset: number;
+	query?: {
+		contains?: string;
+	};
+}
 /**
  * 연락처 정보를 나타내는 타입이에요.
  */
@@ -12,6 +19,14 @@ export interface ContactResult {
 	nextOffset: number | null;
 	done: boolean;
 }
+export type FetchContacts = (options: FetchContactsOptions) => Promise<ContactResult>;
+type PermissionStatus$1 = "notDetermined" | "denied" | "allowed";
+export type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus$1, "notDetermined">>;
+export type GetPermissionFunction = () => Promise<PermissionStatus$1>;
+export type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+	getPermission: GetPermissionFunction;
+	openPermissionDialog: PermissionDialogFunction;
+};
 /**
  * @public
  * @category 연락처
@@ -22,6 +37,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`: 가져온 연락처 목록이에요.
@@ -42,10 +60,15 @@ export interface ContactResult {
  * @example
  * ### 특정 문자열이 포함된 연락처 목록 가져오기
  *
+ * 연락처 목록을 가져오는 예제예요.
+ * "권한 확인하기"버튼을 눌러서 현재 연락처 읽기 권한을 확인해요.
+ * 사용자가 권한을 거부했거나 시스템에서 권한이 제한된 경우에는 [`FetchContactsPermissionError`](/react-native/reference/types/권한/FetchContactsPermissionError)를 반환해요.
+ * "권한 요청하기"버튼을 눌러서 연락처 읽기 권한을 요청할 수 있어요.
+ *
  * ```tsx
- * import React, { useState } from 'react';
+ * import { ContactEntity, fetchContacts, FetchContactsPermissionError } from '@apps-in-toss/web-framework';
+ * import { useState } from 'react';
  * 
- * import { fetchContacts, ContactEntity } from '@apps-in-toss/web-framework';
  *
  * // 특정 문자열을 포함한 연락처 목록을 가져와 화면에 표시하는 컴포넌트
  * function ContactsList() {
@@ -77,6 +100,9 @@ export interface ContactResult {
  *         done: response.done,
  *       }));
  *     } catch (error) {
+ *       if (error instanceof FetchContactsPermissionError) {
+ *         // 연락처 읽기 권한 없음
+ *       }
  *       console.error('연락처를 가져오는 데 실패했어요:', error);
  *     }
  *   };
@@ -84,24 +110,34 @@ export interface ContactResult {
  *   return (
  *     <div>
  *       {contacts.result.map((contact, index) => (
- *         <span key={index}>{contact.name}: {contact.phoneNumber}</span>
+ *         <span key={index}>
+ *           {contact.name}: {contact.phoneNumber}
+ *         </span>
  *       ))}
  *       <input type="button"
  *         value={contacts.done ? '모든 연락처를 가져왔어요.' : '다음 연락처 가져오기'}
  *         disabled={contacts.done}
  *         onClick={handlePress}
  *       />
+ *       <input type="button"
+ *         value="권한 확인하기"
+ *         onClick={async () => {
+ *           const permission = await fetchContacts.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *       <input type="button"
+ *         value="권한 요청하기"
+ *         onClick={async () => {
+ *           const permission = await fetchContacts.openPermissionDialog();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
  *     </div>
  *   );
  * }
  * ```
  */
-export declare function fetchContacts(options: {
-	size: number;
-	offset: number;
-	query?: {
-		contains?: string;
-	};
-}): Promise<ContactResult>;
+export declare const fetchContacts: PermissionFunctionWithDialog<FetchContacts>;
 
 export {};

package/built/getClipboardText.d.ts

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

package/built/getCurrentLocation.d.ts

@@ -24,6 +24,12 @@ declare enum Accuracy {
 	 */
 	BestForNavigation = 6
 }
+export interface GetCurrentLocationOptions {
+	/**
+	 * 위치 정보를 가져올 정확도 수준이에요.
+	 */
+	accuracy: Accuracy;
+}
 interface Location$1 {
 	/**
 	 * Android에서만 지원하는 옵션이에요.
@@ -75,12 +81,14 @@ export interface LocationCoords {
 	 */
 	heading: number;
 }
-export interface GetCurrentLocationOptions {
-	/**
-	 * 위치 정보를 가져올 정확도 수준이에요.
-	 */
-	accuracy: Accuracy;
-}
+export type GetCurrentLocation = (options: GetCurrentLocationOptions) => Promise<Location$1>;
+type PermissionStatus$1 = "notDetermined" | "denied" | "allowed";
+export type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus$1, "notDetermined">>;
+export type GetPermissionFunction = () => Promise<PermissionStatus$1>;
+export type PermissionFunctionWithDialog<T extends (...args: any[]) => any> = T & {
+	getPermission: GetPermissionFunction;
+	openPermissionDialog: PermissionDialogFunction;
+};
 /**
  * @public
  * @category 위치 정보
@@ -91,19 +99,32 @@ export interface GetCurrentLocationOptions {
  *
  * @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 React, { useState } from 'react';
+ * import { Accuracy, getCurrentLocation, Location } from '@apps-in-toss/web-framework';
+ * import { useState } from 'react';
  * 
- * import { getCurrentLocation } from '@apps-in-toss/web-framework';
  *
  * // 현재 위치 정보를 가져와 화면에 표시하는 컴포넌트
  * function CurrentPosition() {
- *   const [position, setPosition] = useState(null);
+ *   const [position, setPosition] = useState<Location | null>(null);
  *
  *   const handlePress = async () => {
  *     try {
@@ -117,16 +138,31 @@ export interface GetCurrentLocationOptions {
  *   return (
  *     <div>
  *       {position ? (
- *         <span>위치: {position.coords.latitude}, {position.coords.longitude}</span>
+ *         <span>
+ *           위치: {position.coords.latitude}, {position.coords.longitude}
+ *         </span>
  *       ) : (
  *         <span>위치 정보를 아직 가져오지 않았어요</span>
  *       )}
  *       <input type="button" value="현재 위치 정보 가져오기" onClick={handlePress} />
+ *       <input type="button"
+ *         value="권한 확인하기"
+ *         onClick={async () => {
+ *           Alert.alert(await getCurrentLocation.getPermission());
+ *         }}
+ *       />
+ *       <input type="button"
+ *         value="권한 요청하기"
+ *         onClick={async () => {
+ *           Alert.alert(await getCurrentLocation.openPermissionDialog());
+ *         }}
+ *       />
  *     </div>
  *   );
  * }
+ *
  * ```
  */
-export declare function getCurrentLocation(options: GetCurrentLocationOptions): Promise<Location$1>;
+export declare const getCurrentLocation: PermissionFunctionWithDialog<GetCurrentLocation>;
 
 export {};

package/built/getPermission.d.ts

@@ -0,0 +1,58 @@
+type PermissionStatus$1 = "notDetermined" | "denied" | "allowed";
+export type PermissionAccess = "read" | "write" | "access";
+type PermissionName$1 = "clipboard" | "contacts" | "photos" | "geolocation" | "camera";
+/**
+ * @category AppsInTossModules
+ * @name getPermission
+ * @description 특정 권한의 현재 상태를 확인하는 함수예요. 사용자가 권한을 허용했는지, 거부했는지, 또는 아직 선택하지 않았는지를 알 수 있어요.
+ * @param permission.name {PermissionName} 요청할 권한의 이름이에요. 예를 들어 `clipboard`는 클립보드 접근 권한을, `camera`는 카메라 접근 권한을 나타내요.
+ * @param permission.access {PermissionAccess} 요청할 권한의 접근 유형이에요. 예를 들어 `read`는 읽기 권한, `write`는 쓰기 권한을 의미해요.
+ * @returns {Promise<'allowed' | 'denied' | 'notDetermined'>} 권한의 현재 상태를 반환해요. 반환값은 다음 중 하나예요:
+ * - `allowed`: 권한이 허용된 상태예요.
+ * - `denied`: 권한이 거부된 상태예요.
+ * - `notDetermined`: 아직 권한 요청에 대한 결정이 이루어지지 않은 상태예요.
+ *
+ * @example
+ * ### 클립보드 읽기 권한 상태 확인하기
+ *
+ * ```tsx
+ * import React, { useEffect, useState } from 'react';
+ * 
+ * import { getPermission, type PermissionStatus } from '@apps-in-toss/web-framework';
+ *
+ * function PermissionCheck() {
+ *   const [permission, setPermission] = useState<PermissionStatus | null>(null);
+ *
+ *   useEffect(() => {
+ *     async function checkPermission() {
+ *       try {
+ *         // 'clipboard'는 권한 이름, 'read'는 접근 유형을 나타내요.
+ *         const status = await getPermission({
+ *           name: 'clipboard', // 클립보드 접근 권한
+ *           access: 'read', // 읽기 권한 요청
+ *         });
+ *         setPermission(status); // 권한 상태를 업데이트해요.
+ *       } catch (error) {
+ *         console.error('권한 상태를 확인하지 못했어요:', error);
+ *       }
+ *     }
+ *
+ *     checkPermission();
+ *   }, []);
+ *
+ *   return (
+ *     <div>
+ *       <span>
+ *         클립보드 읽기 권한 상태: {permission ? permission : '확인 중...'}
+ *       </span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function getPermission(permission: {
+	name: PermissionName$1;
+	access: PermissionAccess;
+}): Promise<PermissionStatus$1>;
+
+export {};