@apps-in-toss/framework 0.0.2 → 0.0.4

package/dist/index.d.ts

@@ -1,3 +1,162 @@
+import { EmitterSubscription } from 'react-native';
+
+interface EventEmitterSchema<K extends string, P extends unknown[]> {
+    name: K;
+    params: P;
+}
+
+/**
+ * 위치 정확도 옵션이에요.
+ */
+declare enum Accuracy {
+    /**
+     * 오차범위 3KM 이내
+     */
+    Lowest = 1,
+    /**
+     * 오차범위 1KM 이내
+     */
+    Low = 2,
+    /**
+     * 오차범위 몇 백미터 이내
+     */
+    Balanced = 3,
+    /**
+     * 오차범위 10M 이내
+     */
+    High = 4,
+    /**
+     * 가장 높은 정확도
+     */
+    Highest = 5,
+    /**
+     * 네비게이션을 위한 최고 정확도
+     */
+    BestForNavigation = 6
+}
+interface Location {
+    /**
+     * Android에서만 지원하는 옵션이에요.
+     *
+     * - `FINE`: 정확한 위치
+     * - `COARSE`: 대략적인 위치
+     *
+     * @see https://developer.android.com/codelabs/approximate-location
+     */
+    accessLocation?: 'FINE' | 'COARSE';
+    /**
+     * 위치가 업데이트된 시점의 유닉스 타임스탬프예요.
+     */
+    timestamp: number;
+    coords: {
+        latitude: number;
+        longitude: number;
+        altitude: number;
+        accuracy: number;
+        altitudeAccuracy: number;
+        heading: number;
+    };
+}
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+interface ImageResponse {
+    /** 가져온 사진의 고유 ID예요. */
+    id: string;
+    /** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+    dataUri: string;
+}
+
+interface StartUpdateLocationOptions {
+    /**
+     * 위치 정확도를 설정해요.
+     */
+    accuracy: Accuracy;
+    /**
+     * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
+     */
+    timeInterval: number;
+    /**
+     * 위치 변경 거리를 미터(m) 단위로 설정해요.
+     */
+    distanceInterval: number;
+    /**
+     * 위치 정보가 변경될 때 호출되는 콜백 함수예요.
+     */
+    callback: (location: Location) => void;
+}
+interface StartUpdateLocationSubscription extends EmitterSubscription {
+    remove: () => Promise<void>;
+}
+/**
+ * @name UpdateLocationEventEmitter
+ * @kind typedef
+ * @description
+ * 디바이스의 위치 정보 변경을 감지해요
+ * @extends {EventEmitterSchema<'updateLocation', [Location]>}
+ */
+interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation', [Location]> {
+}
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name startUpdateLocation
+ * @description  디바이스의 위치 정보를 지속적으로 감지하고, 위치가 변경되면 콜백을 실행하는 함수예요. 콜백 함수를 등록하면 위치가 변경될 때마다 자동으로 호출돼요.
+ * 실시간 위치 추적이 필요한 기능을 구현할 때 사용할 수 있어요. 예를 들어 지도 앱에서 사용자의 현재 위치를 실시간으로 업데이트할 때, 운동 앱에서 사용자의 이동 거리를 기록할 때 등이에요.
+ * 위치 업데이트 주기와 정확도를 조정해 배터리 소모를 최소화하면서도 필요한 정보를 얻을 수 있어요.
+ *
+ * @param {StartUpdateLocationOptions} options - 위치 정보 감지에 필요한 설정 객체에요.
+ * @param {number} [options.accuracy] 위치 정확도를 설정해요.
+ * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
+ * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
+ * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요.
+ *
+ * @example
+ * ### 위치 정보 변경 감지하기
+ *
+ * ```tsx
+ * import React, { useState, useEffect } from 'react';
+ * import { View, Text, Button } from 'react-native';
+ * import { startUpdateLocation } from '@apps-in-toss/framework';
+ *
+ * // 위치 정보 변경 감지하기
+ * function LocationWatcher() {
+ *   const [location, setLocation] = useState(null);
+ *
+ *   useEffect(() => {
+ *     const subscription = startUpdateLocation({
+ *       accuracy: Accuracy.Default,
+ *       timeInterval: 3000,
+ *       distanceInterval: 10,
+ *       callback: (location) => {
+ *         setLocation(location);
+ *       },
+ *     });
+ *
+ *     return () => subscription.remove();
+ *   }, []);
+ *
+ *   if (location == null) {
+ *     return <Text>위치 정보를 가져오는 중이에요...</Text>;
+ *   }
+ *
+ *   return (
+ *     <View>
+ *       <Text>위도: {location.coords.latitude}</Text>
+ *       <Text>경도: {location.coords.longitude}</Text>
+ *       <Text>위치 정확도: {location.coords.accuracy}m</Text>
+ *       <Text>높이: {location.coords.altitude}m</Text>
+ *       <Text>고도 정확도: {location.coords.altitudeAccuracy}m</Text>
+ *       <Text>방향: {location.coords.heading}°</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function startUpdateLocation(options: StartUpdateLocationOptions): Promise<StartUpdateLocationSubscription>;
+
 /**
  * @public
  * @tag AppsInTossModule
@@ -72,4 +231,327 @@ declare function setClipboardText(text: string): Promise<void>;
  */
 declare function getClipboardText(): Promise<string>;
 
-export { getClipboardText, setClipboardText };
+/**
+ * 연락처 정보를 나타내는 타입이에요.
+ */
+interface ContactEntity {
+    /** 연락처 이름이에요. */
+    name: string;
+    /** 연락처 전화번호로, 문자열 형식이에요. */
+    phoneNumber: string;
+}
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name fetchContacts
+ * @description 사용자의 연락처 목록을 페이지 단위로 가져오는 함수예요.
+ * @param size - 한 번에 가져올 연락처 개수예요. 예를 들어, 10을 전달하면 최대 10개의 연락처를 가져와요.
+ * @param offset - 가져올 연락처의 시작 지점이에요. 처음 호출할 때는 `0`을 전달해야 해요. 이후에는 이전 호출에서 반환된 `nextOffset` 값을 사용해요.
+ * @param query - 추가적인 필터링 옵션이에요.
+ * @param query.contains - 이름에 특정 문자열이 포함된 연락처만 가져오고 싶을 때 사용해요. 이 값을 전달하지 않으면 모든 연락처를 가져와요.
+ * @returns {Promise<{result: { name: string; phoneNumber: string }[]; nextOffset: number | null; done: boolean}>}
+ * 연락처 목록과 페이지네이션 정보를 포함한 객체를 반환해요.
+ * - `result`: 가져온 연락처 목록이에요.
+ * - `nextOffset`: 다음 호출에 사용할 오프셋 값이에요. 더 가져올 연락처가 없으면 `null`이에요.
+ * - `done`: 모든 연락처를 다 가져왔는지 여부를 나타내요. 모두 가져왔다면 `true`예요.
+ *
+ * @example
+ * ### 특정 문자열이 포함된 연락처 목록 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * import { View, Text, Button } from 'react-native';
+ * import { fetchContacts } from '@apps-in-toss/framework';
+ *
+ * // 특정 문자열을 포함한 연락처 목록을 가져와 화면에 표시하는 컴포넌트
+ * function ContactsList() {
+ *   const [contacts, setContacts] = useState({
+ *     result: [],
+ *     nextOffset: null,
+ *     done: false,
+ *   });
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       if (contacts.done) {
+ *         console.log('모든 연락처를 가져왔어요.');
+ *         return;
+ *       }
+ *
+ *       const response = await fetchContacts({
+ *         size: 10,
+ *         offset: contacts.nextOffset ?? 0,
+ *         query: { contains: '홍길동' },
+ *       });
+ *       setContacts((prev) => ({
+ *         result: [...prev.result, ...response.result],
+ *         nextOffset: response.nextOffset,
+ *         done: response.done,
+ *       }));
+ *     } catch (error) {
+ *       console.error('연락처를 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       {contacts.result.map((contact, index) => (
+ *         <Text key={index}>{contact.name}: {contact.phoneNumber}</Text>
+ *       ))}
+ *       <Button
+ *         title={contacts.done ? '모든 연락처를 가져왔어요.' : '다음 연락처 가져오기'}
+ *         disabled={contacts.done}
+ *         onPress={handlePress}
+ *       />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function fetchContacts({ size, offset, query, }: {
+    size: number;
+    offset: number;
+    query?: {
+        contains?: string;
+    };
+}): Promise<{
+    result: ContactEntity[];
+    nextOffset: number | null;
+    done: boolean;
+}>;
+
+/**
+ * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
+ */
+interface FetchAlbumPhotosOptions {
+    /** 가져올 사진의 최대 개수를 설정해요. 숫자를 입력하고 기본값은 10이에요. */
+    maxCount?: number;
+    /** 사진의 최대 폭을 제한해요. 단위는 픽셀이고 기본값은 1024이에요. */
+    maxWidth?: number;
+    /** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
+    base64?: boolean;
+}
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name fetchAlbumPhotos
+ * @description
+ * 사용자의 앨범에서 사진 목록을 불러오는 함수예요.
+ * 최대 개수와 해상도를 설정할 수 있고 갤러리 미리보기, 이미지 선택 기능 등에 활용할 수 있어요.
+ *
+ * @param options - 조회 옵션을 담은 객체예요.
+ * @param {number} [options.maxCount=10] 가져올 사진의 최대 개수를 설정해요. 숫자로 입력하며 기본값은 10이에요.
+ * @param {number} [options.maxWidth=1024] 사진의 최대 폭을 제한해요. 단위는 픽셀이며 기본값은 `1024`이에요.
+ * @param {boolean} [options.base64=false] 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요.
+ * @returns {Promise<AlbumResponse[]>}
+ * 앨범 사진의 고유 ID와 데이터 URI를 포함한 배열을 반환해요.
+ *
+ * @example
+ * ### 사진의 최대 폭을 360px로 제한하여 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * import { View, Text, Button } from 'react-native';
+ * import { fetchAlbumPhotos } from '@apps-in-toss/framework';
+ *
+ * // 앨범 사진 목록을 가져와 화면에 표시하는 컴포넌트
+ * function AlbumPhotoList() {
+ *   const [albumPhotos, setAlbumPhotos] = useState([]);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await fetchAlbumPhotos({
+ *         maxWidth: 360,
+ *       });
+ *       setAlbumPhotos((prev) => ([...prev, ...response]));
+ *     } catch (error) {
+ *       console.error('앨범을 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       {albumPhotos.map((album) => (
+ *         <Text key={album.id}>{album.dataUri}</Text>
+ *       ))}
+ *       <Button title="앨범 가져오기" onPress={handlePress} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function fetchAlbumPhotos(options: FetchAlbumPhotosOptions): Promise<ImageResponse[]>;
+
+interface GetCurrentLocationOptions {
+    /**
+     * 위치 정보를 가져올 정확도 수준이에요.
+     */
+    accuracy: Accuracy;
+}
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name getCurrentLocation
+ * @description 디바이스의 현재 위치 정보를 가져오는 함수예요.
+ * 위치 기반 서비스를 구현할 때 사용되고, 한 번만 호출되어 현재 위치를 즉시 반환해요.
+ * 예를 들어 지도 앱에서 사용자의 현재 위치를 한 번만 가져올 때, 날씨 앱에서 사용자의 위치를 기반으로 기상 정보를 제공할 때, 매장 찾기 기능에서 사용자의 위치를 기준으로 가까운 매장을 검색할 때 사용하면 유용해요.
+ *
+ * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
+ * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
+ * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요.
+ *
+ * @example
+ * ### 디바이스의 현재 위치 정보 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * import { View, Text, Button } from 'react-native';
+ * import { getCurrentLocation } from '@apps-in-toss/framework';
+ *
+ * // 현재 위치 정보를 가져와 화면에 표시하는 컴포넌트
+ * function CurrentPosition() {
+ *   const [position, setPosition] = useState(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} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function getCurrentLocation(options: GetCurrentLocationOptions): Promise<Location>;
+
+interface OpenCameraOptions {
+    /**
+     * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
+     *
+     * 기본값: `false`.
+     */
+    base64?: boolean;
+    /**
+     * 이미지의 최대 너비를 나타내는 숫자 값이에요.
+     *
+     * 기본값: `1024`.
+     */
+    maxWidth?: number;
+}
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name openCamera
+ * @description 카메라를 실행해서 촬영된 이미지를 반환하는 함수예요.
+ * @param {OpenCameraOptions} options - 카메라 실행 시 사용되는 옵션 객체예요.
+ * @param {boolean} [options.base64=false] - 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요. 기본값은 `false`예요. `true`로 설정하면 `dataUri` 대신 Base64 인코딩된 문자열을 반환해요.
+ * @param {boolean} [options.maxWidth=1024] - 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요. 기본값은 `false`예요. `true`로 설정하면 `dataUri` 대신 Base64 인코딩된 문자열을 반환해요.
+ * @returns {Promise<ImageResponse>}
+ * 촬영된 이미지 정보를 포함한 객체를 반환해요. 반환 객체의 구성은 다음과 같아요:
+ * - `id`: 이미지의 고유 식별자예요.
+ * - `dataUri`: 이미지 데이터를 표현하는 데이터 URI예요.
+ *
+ * @example
+ * ### 카메라 실행 후 촬영된 사진 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * import { View, Text, Button, Image } from 'react-native';
+ * import { openCamera } from '@apps-in-toss/framework';
+ *
+ * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
+ * function Camera() {
+ *   const [image, setImage] = useState(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await openCamera({ base64: false });
+ *       setImage(response);
+ *     } catch (error) {
+ *       console.error('사진을 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <View>
+ *       {image ? (
+ *         <Image source={{ uri: image.dataUri }} style={{ width: 200, height: 200 }} />
+ *       ) : (
+ *         <Text>사진이 없어요</Text>
+ *       )}
+ *       <Button title="사진 촬영하기" onPress={handlePress} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
+
+type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name useGeolocation
+ * @description 디바이스의 위치 정보를 반환하는 훅이에요. 위치가 변경되면 값도 변경돼요.
+ * GPS 정보를 활용해 현재 위치를 감지하고, 사용자의 이동에 따라 자동으로 업데이트돼요.
+ * 예를 들어, 지도 기반 서비스에서 사용자의 현재 위치를 표시하거나, 배달 앱에서 실시간 이동 경로를 추적할 때 활용할 수 있어요.
+ * 위치 정보의 정확도와 업데이트 주기를 조정할 수 있어서 배터리 소모를 최소화하면서도 필요한 수준의 정확도를 유지할 수 있어요.
+ *
+ * @param {UseGeolocationOptions} options - 위치 정보 감지에 필요한 설정 객체에요.
+ * @param {Accuracy} [options.accuracy] 위치 정확도를 설정해요. `Accuracy.Lowest`: 오차범위 3KM 이내, `Accuracy.Low`: 오차범위 1KM 이내, `Accuracy.Balanced`: 오차범위 몇 백미터 이내, `Accuracy.High`: 오차범위 10M 이내, `Accuracy.Highest`: 가장 높은 정확도, `Accuracy.BestForNavigation`: 네비게이션을 위한 최고 정확도
+ * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
+ * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
+ *
+ * @example
+ * ### 위치 정보 변경 감지하기
+ *
+ * ```ts
+ * import React, { useState, useCallback } from 'react';
+ * import { View, Text } from 'react-native';
+ * import { useGeolocation, Accuracy } from '@apps-in-toss/framework';
+ *
+ * // 위치 정보 변경 감지하기
+ * function LocationWatcher() {
+ *   const location = useGeolocation({
+ *     accuracy: Accuracy.Balanced,
+ *     distanceInterval: 10,
+ *     timeInterval: 1000,
+ *   });
+ *
+ *   if (location == null) {
+ *     return <Text>위치 정보를 가져오는 중이에요...</Text>;
+ *   }
+ *
+ *   return (
+ *     <View>
+ *       <Text>위치 정보: {location.latitude}, {location.longitude}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function useGeolocation({ accuracy, distanceInterval, timeInterval }: UseGeolocationOptions): Location | null;
+
+export { Accuracy, type ContactEntity, type FetchAlbumPhotosOptions, type GetCurrentLocationOptions, type ImageResponse, type Location, type OpenCameraOptions, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, type UpdateLocationEventEmitter, type UseGeolocationOptions, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, openCamera, setClipboardText, startUpdateLocation, useGeolocation };

package/dist/index.js

@@ -1,33 +1,13 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  getClipboardText: () => getClipboardText,
-  setClipboardText: () => setClipboardText
-});
-module.exports = __toCommonJS(src_exports);
+// src/native-event-emitter/nativeEventEmitter.ts
+import { NativeEventEmitter } from "react-native";
 
 // src/native-modules/AppsInTossModule.ts
-var import_react_native = require("react-native");
-var AppsInTossModule = import_react_native.NativeModules.AppsInTossModule;
+import { NativeModules } from "react-native";
+var AppsInTossModuleInstance = NativeModules.AppsInTossModule;
+var AppsInTossModule = AppsInTossModuleInstance;
+
+// src/native-event-emitter/nativeEventEmitter.ts
+var nativeEventEmitter = new NativeEventEmitter(AppsInTossModuleInstance);
 
 // src/native-modules/getPermission.ts
 function getPermission(permission) {
@@ -51,6 +31,33 @@ async function requestPermission(permission) {
   }
 }
 
+// src/native-event-emitter/startUpdateLocation.ts
+async function startUpdateLocation(options) {
+  const { callback, ...nativeOptions } = options;
+  const permissionStatus = await requestPermission({ name: "geolocation", access: "access" });
+  if (permissionStatus === "denied") {
+    throw new Error("\uC704\uCE58 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+  }
+  await AppsInTossModuleInstance.startUpdateLocation(nativeOptions);
+  const subscription = nativeEventEmitter.addListener("updateLocation", callback);
+  subscriptionCount++;
+  const subscriptionProxy = new Proxy(subscription, {
+    get: (target, key, receiver) => {
+      const result = Reflect.get(target, key, receiver);
+      if (key === "remove") {
+        return async () => {
+          await (--subscriptionCount === 0 && AppsInTossModuleInstance.stopUpdateLocation({}));
+          const remove = result;
+          remove();
+        };
+      }
+      return result;
+    }
+  });
+  return subscriptionProxy;
+}
+var subscriptionCount = 0;
+
 // src/native-modules/setClipboardText.ts
 async function setClipboardText(text) {
   const permissionStatus = await requestPermission({ name: "clipboard", access: "write" });
@@ -68,8 +75,121 @@ async function getClipboardText() {
   }
   return AppsInTossModule.getClipboardText({});
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+
+// src/native-modules/fetchContacts.ts
+async function fetchContacts({
+  size,
+  offset,
+  query
+}) {
+  const permissionStatus = await requestPermission({ name: "contacts", access: "read" });
+  if (permissionStatus === "denied") {
+    throw new Error("\uC5F0\uB77D\uCC98 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+  }
+  const contacts = await AppsInTossModule.fetchContacts({
+    size,
+    offset,
+    query
+  });
+  return {
+    result: contacts.result,
+    nextOffset: contacts.nextOffset ?? null,
+    done: contacts.done
+  };
+}
+
+// src/native-modules/fetchAlbumPhotos.ts
+var DEFAULT_MAX_COUNT = 10;
+var DEFAULT_MAX_WIDTH = 1024;
+async function fetchAlbumPhotos(options) {
+  const permissionStatus = await requestPermission({ name: "photos", access: "read" });
+  if (permissionStatus === "denied") {
+    throw new Error("\uC0AC\uC9C4\uCCA9 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+  }
+  const albumPhotos = await AppsInTossModule.fetchAlbumPhotos({
+    ...options,
+    maxCount: options.maxCount ?? DEFAULT_MAX_COUNT,
+    maxWidth: options.maxWidth ?? DEFAULT_MAX_WIDTH
+  });
+  return albumPhotos;
+}
+
+// src/native-modules/getCurrentLocation.ts
+async function getCurrentLocation(options) {
+  const permissionStatus = await requestPermission({ name: "geolocation", access: "access" });
+  if (permissionStatus === "denied") {
+    throw new Error("\uC704\uCE58 \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+  }
+  const position = await AppsInTossModule.getCurrentLocation(options);
+  return position;
+}
+
+// src/native-modules/openCamera.ts
+async function openCamera(options) {
+  const permissionStatus = await requestPermission({ name: "camera", access: "access" });
+  if (permissionStatus === "denied") {
+    throw new Error("\uCE74\uBA54\uB77C \uAD8C\uD55C\uC774 \uAC70\uBD80\uB418\uC5C8\uC5B4\uC694.");
+  }
+  const photo = await AppsInTossModule.openCamera({ base64: false, maxWidth: 1024, ...options });
+  return photo;
+}
+
+// src/hooks/useGeolocation.ts
+import { useState, useCallback, useEffect, useRef } from "react";
+import { useVisibility } from "react-native-bedrock";
+function useGeolocation({ accuracy, distanceInterval, timeInterval }) {
+  const isVisible = useVisibility();
+  const subscriptionRef = useRef();
+  const [location, setLocation] = useState(null);
+  const subscribe = useCallback(async () => {
+    try {
+      const subscription = await startUpdateLocation({
+        accuracy,
+        distanceInterval,
+        timeInterval,
+        callback: setLocation
+      });
+      subscriptionRef.current = subscription;
+    } catch (error) {
+      console.error("failed to subscribe location", error);
+    }
+  }, [accuracy, distanceInterval, timeInterval]);
+  const cleanup = useCallback(async () => {
+    try {
+      const prevSubscription = subscriptionRef.current;
+      subscriptionRef.current = void 0;
+      await prevSubscription?.remove();
+    } catch (error) {
+      console.error("failed to cleanup location subscription", error);
+    }
+  }, []);
+  useEffect(() => {
+    if (subscriptionRef.current == null && isVisible) {
+      subscribe();
+    }
+    return () => void cleanup();
+  }, [subscribe, cleanup, isVisible]);
+  return location;
+}
+
+// src/types.ts
+var Accuracy = /* @__PURE__ */ ((Accuracy2) => {
+  Accuracy2[Accuracy2["Lowest"] = 1] = "Lowest";
+  Accuracy2[Accuracy2["Low"] = 2] = "Low";
+  Accuracy2[Accuracy2["Balanced"] = 3] = "Balanced";
+  Accuracy2[Accuracy2["High"] = 4] = "High";
+  Accuracy2[Accuracy2["Highest"] = 5] = "Highest";
+  Accuracy2[Accuracy2["BestForNavigation"] = 6] = "BestForNavigation";
+  return Accuracy2;
+})(Accuracy || {});
+export {
+  Accuracy,
+  fetchAlbumPhotos,
+  fetchContacts,
   getClipboardText,
-  setClipboardText
-});
+  getCurrentLocation,
+  openCamera,
+  setClipboardText,
+  startUpdateLocation,
+  useGeolocation
+};