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

package/built/index.cjs

@@ -27,11 +27,18 @@ __export(index_exports, {
   Storage: () => Storage,
   appsInTossEvent: () => appsInTossEvent,
   env: () => env,
+  fetchAlbumPhotos: () => fetchAlbumPhotos,
+  fetchContacts: () => fetchContacts,
   getAppsInTossGlobals: () => getAppsInTossGlobals,
+  getClipboardText: () => getClipboardText,
+  getCurrentLocation: () => getCurrentLocation,
   getSafeAreaInsets: () => getSafeAreaInsets,
   graniteEvent: () => graniteEvent,
   isMinVersionSupported: () => isMinVersionSupported,
+  openCamera: () => openCamera,
   partner: () => partner,
+  setClipboardText: () => setClipboardText,
+  startUpdateLocation: () => startUpdateLocation,
   tdsEvent: () => tdsEvent
 });
 module.exports = __toCommonJS(index_exports);
@@ -774,6 +781,143 @@ var partner = {
    */
   removeAccessoryButton: (0, import_bridge_core11.createAsyncBridge)("removeAccessoryButton")
 };
+
+// src/permissions/fetchAlbumPhotos.ts
+var import_bridge_core13 = require("@apps-in-toss/bridge-core");
+var import_types = require("@apps-in-toss/types");
+
+// src/permissions/createPermissionFunction.ts
+var import_bridge_core12 = require("@apps-in-toss/bridge-core");
+var requestPermission = (0, import_bridge_core12.createAsyncBridge)("requestPermission");
+var getPermission = (0, import_bridge_core12.createAsyncBridge)("getPermission");
+var openPermissionDialog = (0, import_bridge_core12.createAsyncBridge)("openPermissionDialog");
+function createPermissionFunction({
+  permission,
+  handler,
+  error
+}) {
+  const permissionFunction = async (...args) => {
+    const permissionStatus = await requestPermission(permission);
+    if (permissionStatus === "denied") {
+      throw new error();
+    }
+    return handler(...args);
+  };
+  permissionFunction.getPermission = () => getPermission(permission);
+  permissionFunction.openPermissionDialog = () => openPermissionDialog(permission);
+  return permissionFunction;
+}
+
+// src/permissions/fetchAlbumPhotos.ts
+var fetchAlbumPhotos = createPermissionFunction({
+  handler: (options) => {
+    return (0, import_bridge_core13.createAsyncBridge)("fetchAlbumPhotos")(
+      options
+    );
+  },
+  permission: {
+    name: "photos",
+    access: "read"
+  },
+  error: import_types.FetchAlbumPhotosPermissionError
+});
+
+// src/permissions/fetchContacts.ts
+var import_bridge_core14 = require("@apps-in-toss/bridge-core");
+var import_types2 = require("@apps-in-toss/types");
+var fetchContacts = createPermissionFunction({
+  handler: (options) => {
+    return (0, import_bridge_core14.createAsyncBridge)("fetchContacts")(options);
+  },
+  permission: {
+    name: "contacts",
+    access: "read"
+  },
+  error: import_types2.FetchContactsPermissionError
+});
+
+// src/permissions/getCurrentLocation.ts
+var import_bridge_core15 = require("@apps-in-toss/bridge-core");
+var import_types3 = require("@apps-in-toss/types");
+var getCurrentLocation = createPermissionFunction({
+  handler: (options) => {
+    return (0, import_bridge_core15.createAsyncBridge)(
+      "getCurrentLocation"
+    )(options);
+  },
+  permission: {
+    name: "geolocation",
+    access: "access"
+  },
+  error: import_types3.GetCurrentLocationPermissionError
+});
+
+// src/permissions/openCamera.ts
+var import_bridge_core16 = require("@apps-in-toss/bridge-core");
+var import_types4 = require("@apps-in-toss/types");
+var openCamera = createPermissionFunction({
+  handler: (options) => {
+    return (0, import_bridge_core16.createAsyncBridge)("openCamera")(options);
+  },
+  permission: {
+    name: "camera",
+    access: "access"
+  },
+  error: import_types4.OpenCameraPermissionError
+});
+
+// src/permissions/setClipboardText.ts
+var import_bridge_core17 = require("@apps-in-toss/bridge-core");
+var import_types5 = require("@apps-in-toss/types");
+var setClipboardText = createPermissionFunction({
+  handler: (options) => {
+    return (0, import_bridge_core17.createAsyncBridge)("setClipboardText")(
+      options
+    );
+  },
+  permission: {
+    name: "clipboard",
+    access: "write"
+  },
+  error: import_types5.SetClipboardTextPermissionError
+});
+
+// src/permissions/getClipboardText.ts
+var import_bridge_core18 = require("@apps-in-toss/bridge-core");
+var import_types6 = require("@apps-in-toss/types");
+var getClipboardText = createPermissionFunction({
+  handler: () => {
+    return (0, import_bridge_core18.createAsyncBridge)("getClipboardText")();
+  },
+  permission: {
+    name: "clipboard",
+    access: "read"
+  },
+  error: import_types6.GetClipboardTextPermissionError
+});
+
+// src/permissions/startUpdateLocation.ts
+var import_bridge_core19 = require("@apps-in-toss/bridge-core");
+var import_types7 = require("@apps-in-toss/types");
+var getPermission2 = (0, import_bridge_core19.createAsyncBridge)("getPermission");
+var openPermissionDialog2 = (0, import_bridge_core19.createAsyncBridge)("openPermissionDialog");
+var startUpdateLocation = (params) => {
+  return (0, import_bridge_core19.createEventBridge)("updateLocationEvent")({
+    ...params,
+    onError: (error) => {
+      const locationError = new import_types7.StartUpdateLocationPermissionError();
+      if (error instanceof Error && error.name === locationError.name) {
+        return params.onError(locationError);
+      }
+      return params.onError(error);
+    }
+  });
+};
+startUpdateLocation.getPermission = () => getPermission2({ name: "geolocation", access: "access" });
+startUpdateLocation.openPermissionDialog = () => openPermissionDialog2({ name: "geolocation", access: "access" });
+
+// src/index.ts
+__reExport(index_exports, require("@apps-in-toss/types"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   GoogleAdMob,
@@ -781,11 +925,19 @@ var partner = {
   Storage,
   appsInTossEvent,
   env,
+  fetchAlbumPhotos,
+  fetchContacts,
   getAppsInTossGlobals,
+  getClipboardText,
+  getCurrentLocation,
   getSafeAreaInsets,
   graniteEvent,
   isMinVersionSupported,
+  openCamera,
   partner,
+  setClipboardText,
+  startUpdateLocation,
   tdsEvent,
-  ...require("@apps-in-toss/bridge-core")
+  ...require("@apps-in-toss/bridge-core"),
+  ...require("@apps-in-toss/types")
 });

package/built/index.d.cts

@@ -1,6 +1,9 @@
 export * from './bridge';
 export * from '@apps-in-toss/bridge-core';
 import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions, LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions } from '@apps-in-toss/framework';
+import * as _apps_in_toss_types from '@apps-in-toss/types';
+import { FetchAlbumPhotos, FetchContacts, GetCurrentLocation, OpenCamera, SetClipboardText, GetClipboardText, StartUpdateLocationEventParams } from '@apps-in-toss/types';
+export * from '@apps-in-toss/types';
 
 /**
  * @public
@@ -766,4 +769,22 @@ declare const partner: {
     removeAccessoryButton: () => Promise<void>;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, getAppsInTossGlobals, getSafeAreaInsets, graniteEvent, isMinVersionSupported, partner, tdsEvent };
+declare const fetchAlbumPhotos: _apps_in_toss_types.PermissionFunctionWithDialog<FetchAlbumPhotos>;
+
+declare const fetchContacts: _apps_in_toss_types.PermissionFunctionWithDialog<FetchContacts>;
+
+declare const getCurrentLocation: _apps_in_toss_types.PermissionFunctionWithDialog<GetCurrentLocation>;
+
+declare const openCamera: _apps_in_toss_types.PermissionFunctionWithDialog<OpenCamera>;
+
+declare const setClipboardText: _apps_in_toss_types.PermissionFunctionWithDialog<SetClipboardText>;
+
+declare const getClipboardText: _apps_in_toss_types.PermissionFunctionWithDialog<GetClipboardText>;
+
+declare const startUpdateLocation: {
+    (params: StartUpdateLocationEventParams): () => void;
+    getPermission(): Promise<_apps_in_toss_types.PermissionStatus>;
+    openPermissionDialog(): Promise<"denied" | "allowed">;
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };

package/built/index.d.ts

@@ -1,6 +1,9 @@
 export * from './bridge';
 export * from '@apps-in-toss/bridge-core';
 import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions, LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions } from '@apps-in-toss/framework';
+import * as _apps_in_toss_types from '@apps-in-toss/types';
+import { FetchAlbumPhotos, FetchContacts, GetCurrentLocation, OpenCamera, SetClipboardText, GetClipboardText, StartUpdateLocationEventParams } from '@apps-in-toss/types';
+export * from '@apps-in-toss/types';
 
 /**
  * @public
@@ -766,4 +769,22 @@ declare const partner: {
     removeAccessoryButton: () => Promise<void>;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, getAppsInTossGlobals, getSafeAreaInsets, graniteEvent, isMinVersionSupported, partner, tdsEvent };
+declare const fetchAlbumPhotos: _apps_in_toss_types.PermissionFunctionWithDialog<FetchAlbumPhotos>;
+
+declare const fetchContacts: _apps_in_toss_types.PermissionFunctionWithDialog<FetchContacts>;
+
+declare const getCurrentLocation: _apps_in_toss_types.PermissionFunctionWithDialog<GetCurrentLocation>;
+
+declare const openCamera: _apps_in_toss_types.PermissionFunctionWithDialog<OpenCamera>;
+
+declare const setClipboardText: _apps_in_toss_types.PermissionFunctionWithDialog<SetClipboardText>;
+
+declare const getClipboardText: _apps_in_toss_types.PermissionFunctionWithDialog<GetClipboardText>;
+
+declare const startUpdateLocation: {
+    (params: StartUpdateLocationEventParams): () => void;
+    getPermission(): Promise<_apps_in_toss_types.PermissionStatus>;
+    openPermissionDialog(): Promise<"denied" | "allowed">;
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };

package/built/index.js

@@ -740,16 +740,164 @@ var partner = {
    */
   removeAccessoryButton: createAsyncBridge3("removeAccessoryButton")
 };
+
+// src/permissions/fetchAlbumPhotos.ts
+import { createAsyncBridge as createAsyncBridge5 } from "@apps-in-toss/bridge-core";
+import { FetchAlbumPhotosPermissionError } from "@apps-in-toss/types";
+
+// src/permissions/createPermissionFunction.ts
+import { createAsyncBridge as createAsyncBridge4 } from "@apps-in-toss/bridge-core";
+var requestPermission = createAsyncBridge4("requestPermission");
+var getPermission = createAsyncBridge4("getPermission");
+var openPermissionDialog = createAsyncBridge4("openPermissionDialog");
+function createPermissionFunction({
+  permission,
+  handler,
+  error
+}) {
+  const permissionFunction = async (...args) => {
+    const permissionStatus = await requestPermission(permission);
+    if (permissionStatus === "denied") {
+      throw new error();
+    }
+    return handler(...args);
+  };
+  permissionFunction.getPermission = () => getPermission(permission);
+  permissionFunction.openPermissionDialog = () => openPermissionDialog(permission);
+  return permissionFunction;
+}
+
+// src/permissions/fetchAlbumPhotos.ts
+var fetchAlbumPhotos = createPermissionFunction({
+  handler: (options) => {
+    return createAsyncBridge5("fetchAlbumPhotos")(
+      options
+    );
+  },
+  permission: {
+    name: "photos",
+    access: "read"
+  },
+  error: FetchAlbumPhotosPermissionError
+});
+
+// src/permissions/fetchContacts.ts
+import { createAsyncBridge as createAsyncBridge6 } from "@apps-in-toss/bridge-core";
+import { FetchContactsPermissionError } from "@apps-in-toss/types";
+var fetchContacts = createPermissionFunction({
+  handler: (options) => {
+    return createAsyncBridge6("fetchContacts")(options);
+  },
+  permission: {
+    name: "contacts",
+    access: "read"
+  },
+  error: FetchContactsPermissionError
+});
+
+// src/permissions/getCurrentLocation.ts
+import { createAsyncBridge as createAsyncBridge7 } from "@apps-in-toss/bridge-core";
+import {
+  GetCurrentLocationPermissionError
+} from "@apps-in-toss/types";
+var getCurrentLocation = createPermissionFunction({
+  handler: (options) => {
+    return createAsyncBridge7(
+      "getCurrentLocation"
+    )(options);
+  },
+  permission: {
+    name: "geolocation",
+    access: "access"
+  },
+  error: GetCurrentLocationPermissionError
+});
+
+// src/permissions/openCamera.ts
+import { createAsyncBridge as createAsyncBridge8 } from "@apps-in-toss/bridge-core";
+import { OpenCameraPermissionError } from "@apps-in-toss/types";
+var openCamera = createPermissionFunction({
+  handler: (options) => {
+    return createAsyncBridge8("openCamera")(options);
+  },
+  permission: {
+    name: "camera",
+    access: "access"
+  },
+  error: OpenCameraPermissionError
+});
+
+// src/permissions/setClipboardText.ts
+import { createAsyncBridge as createAsyncBridge9 } from "@apps-in-toss/bridge-core";
+import { SetClipboardTextPermissionError } from "@apps-in-toss/types";
+var setClipboardText = createPermissionFunction({
+  handler: (options) => {
+    return createAsyncBridge9("setClipboardText")(
+      options
+    );
+  },
+  permission: {
+    name: "clipboard",
+    access: "write"
+  },
+  error: SetClipboardTextPermissionError
+});
+
+// src/permissions/getClipboardText.ts
+import { createAsyncBridge as createAsyncBridge10 } from "@apps-in-toss/bridge-core";
+import { GetClipboardTextPermissionError } from "@apps-in-toss/types";
+var getClipboardText = createPermissionFunction({
+  handler: () => {
+    return createAsyncBridge10("getClipboardText")();
+  },
+  permission: {
+    name: "clipboard",
+    access: "read"
+  },
+  error: GetClipboardTextPermissionError
+});
+
+// src/permissions/startUpdateLocation.ts
+import { createAsyncBridge as createAsyncBridge11, createEventBridge as createEventBridge5 } from "@apps-in-toss/bridge-core";
+import {
+  StartUpdateLocationPermissionError
+} from "@apps-in-toss/types";
+var getPermission2 = createAsyncBridge11("getPermission");
+var openPermissionDialog2 = createAsyncBridge11("openPermissionDialog");
+var startUpdateLocation = (params) => {
+  return createEventBridge5("updateLocationEvent")({
+    ...params,
+    onError: (error) => {
+      const locationError = new StartUpdateLocationPermissionError();
+      if (error instanceof Error && error.name === locationError.name) {
+        return params.onError(locationError);
+      }
+      return params.onError(error);
+    }
+  });
+};
+startUpdateLocation.getPermission = () => getPermission2({ name: "geolocation", access: "access" });
+startUpdateLocation.openPermissionDialog = () => openPermissionDialog2({ name: "geolocation", access: "access" });
+
+// src/index.ts
+export * from "@apps-in-toss/types";
 export {
   GoogleAdMob,
   IAP,
   Storage,
   appsInTossEvent,
   env,
+  fetchAlbumPhotos,
+  fetchContacts,
   getAppsInTossGlobals,
+  getClipboardText,
+  getCurrentLocation,
   getSafeAreaInsets,
   graniteEvent,
   isMinVersionSupported,
+  openCamera,
   partner,
+  setClipboardText,
+  startUpdateLocation,
   tdsEvent
 };

package/built/openCamera.d.ts

@@ -21,6 +21,14 @@ export interface OpenCameraOptions {
 	 */
 	maxWidth?: number;
 }
+export type OpenCamera = (options?: OpenCameraOptions) => 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 카메라
@@ -29,50 +37,79 @@ export interface OpenCameraOptions {
  * @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 React, { useState } from 'react';
+ * import { ImageResponse, openCamera, OpenCameraPermissionError } from '@apps-in-toss/web-framework';
+ * import { useState } from 'react';
  * 
- * import { openCamera } from '@apps-in-toss/web-framework';
  *
  * const base64 = true;
  *
  * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
  * function Camera() {
- *   const [image, setImage] = useState(null);
+ *   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;
+ *   const imageUri = base64 ? 'data:image/jpeg;base64,' + image?.dataUri : image?.dataUri;
  *
  *   return (
  *     <div>
- *       {image ? (
- *         <Image source={{ uri: imageUri }} style={{ width: 200, height: 200 }} />
- *       ) : (
- *         <span>사진이 없어요</span>
- *       )}
+ *       {image ? <Image source={{ uri: imageUri }} style={{ width: 200, height: 200 }} /> : <span>사진이 없어요</span>}
  *       <input type="button" value="사진 촬영하기" onClick={handlePress} />
+ *       <input type="button"
+ *         value="권한 확인하기"
+ *         onClick={async () => {
+ *           const permission = await openCamera.getPermission();
+ *           Alert.alert(permission);
+ *         }}
+ *       />
+ *
+ *       <input type="button"
+ *         value="권한 요청하기"
+ *         onClick={async () => {
+ *           const currentPermission = await openCamera.openPermissionDialog();
+ *           Alert.alert(currentPermission);
+ *         }}
+ *       />
  *     </div>
  *   );
  * }
  * ```
  */
-export declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
+export declare const openCamera: PermissionFunctionWithDialog<OpenCamera>;
 
 export {};

package/built/openPermissionDialog.d.ts

@@ -0,0 +1,55 @@
+type PermissionStatus$1 = "notDetermined" | "denied" | "allowed";
+export type PermissionAccess = "read" | "write" | "access";
+type PermissionName$1 = "clipboard" | "contacts" | "photos" | "geolocation" | "camera";
+export type PermissionDialogFunction = () => Promise<Exclude<PermissionStatus$1, "notDetermined">>;
+/**
+ * @category AppsInTossModules
+ * @name openPermissionDialog
+ * @description 권한 요청 다이얼로그를 표시하는 함수예요. 사용자는 이 다이얼로그에서 특정 권한을 허용하거나 거부할 수 있어요.
+ * @param permission.name {PermissionName} 요청할 권한의 이름이에요. 예를 들어 `clipboard`는 클립보드 접근 권한을, `camera`는 카메라 접근 권한을 나타내요.
+ * @param permission.access {PermissionAccess} 요청할 권한의 접근 유형이에요. 예를 들어 `read`는 읽기 권한, `write`는 쓰기 권한을 의미해요.
+ * @returns {Promise<'allowed' | 'denied'>} 권한의 현재 상태를 반환해요. 반환값은 다음 중 하나예요:
+ * - `allowed`: 권한이 허용된 상태예요.
+ * - `denied`: 권한이 거부된 상태예요.
+ *
+ * @example
+ * ### 클립보드 읽기 권한 다이얼로그 열기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * 
+ * import { openPermissionDialog, type PermissionStatus } from '@apps-in-toss/web-framework';
+ *
+ * function PermissionRequest() {
+ *   const [permission, setPermission] = useState<PermissionStatus | null>(null);
+ *
+ *   const handleRequestPermission = async () => {
+ *     try {
+ *       // 클립보드 읽기 권한을 요청하는 다이얼로그를 표시해요.
+ *       const status = await openPermissionDialog({
+ *         name: 'clipboard',
+ *         access: 'read',
+ *       });
+ *       setPermission(status); // 권한 상태를 업데이트해요.
+ *     } catch (error) {
+ *       console.error('권한 요청 중 오류가 발생했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <span>
+ *         클립보드 읽기 권한 상태: {permission ? permission : '아직 요청하지 않음'}
+ *       </span>
+ *       <input type="button" value="권한 요청하기" onClick={handleRequestPermission} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function openPermissionDialog(permission: {
+	name: PermissionName$1;
+	access: PermissionAccess;
+}): ReturnType<PermissionDialogFunction>;
+
+export {};

package/built/requestPermission.d.ts

@@ -0,0 +1,55 @@
+type PermissionStatus$1 = "notDetermined" | "denied" | "allowed";
+export type PermissionAccess = "read" | "write" | "access";
+type PermissionName$1 = "clipboard" | "contacts" | "photos" | "geolocation" | "camera";
+/**
+ * @category PermissionManagement
+ * @name requestPermission
+ * @description 특정 권한을 요청하는 함수예요. 이미 허용되었거나 거부된 권한 상태를 확인한 뒤, 필요할 때 권한 요청 다이얼로그를 표시해요.
+ * @param permission.name {PermissionName} 요청할 권한의 이름이에요. 예를 들어 `clipboard`는 클립보드 접근 권한을, `camera`는 카메라 접근 권한을 나타내요.
+ * @param permission.access {PermissionAccess} 요청할 권한의 접근 유형이에요. 예를 들어 `read`는 읽기 권한, `write`는 쓰기 권한을 의미해요.
+ * @returns {Promise<'allowed' | 'denied'>} 사용자가 선택한 최종 권한 상태를 반환해요.
+ * 반환값은 다음 중 하나예요:
+ * - `allowed`: 권한이 허용된 경우
+ * - `denied`: 권한이 거부된 경우
+ *
+ * @example
+ * ### 클립보드 읽기 권한 요청하기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * 
+ * import { requestPermission, type PermissionStatus } from '@apps-in-toss/web-framework';
+ *
+ * function PermissionRequest() {
+ *   const [permissionStatus, setPermissionStatus] = useState<PermissionStatus | null>(null);
+ *
+ *   const handleRequestPermission = async () => {
+ *     try {
+ *       // 클립보드 읽기 권한을 요청해요.
+ *       const permissionStatus = await requestPermission({
+ *         name: 'clipboard', // 권한 이름: 클립보드
+ *         access: 'read', // 접근 유형: 읽기
+ *       });
+ *       setPermissionStatus(permissionStatus); // 최종 권한 상태를 저장해요.
+ *     } catch (error) {
+ *       console.error('권한 요청 중 오류가 발생했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <span>
+ *         클립보드 읽기 권한 상태: {permissionStatus ? permissionStatus : '아직 요청하지 않음'}
+ *       </span>
+ *       <input type="button" value="권한 요청하기" onClick={handleRequestPermission} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function requestPermission(permission: {
+	name: PermissionName$1;
+	access: PermissionAccess;
+}): Promise<Exclude<PermissionStatus$1, "notDetermined">>;
+
+export {};