import { EmitterSubscription } from 'react-native';
import * as react_jsx_runtime from 'react/jsx-runtime';
import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';

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;
}
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(() => {
 *     return startUpdateLocation({
 *       options: {
 *         accuracy: Accuracy.Default,
 *         timeInterval: 3000,
 *         distanceInterval: 10,
 *       },
 *       onEvent: (location) => {
 *         setLocation(location);
 *       },
 *       onError: (error) => {
 *         console.error('위치 정보를 가져오는데 실패했어요:', error);
 *       },
 *     });
 *   }, []);
 *
 *   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(eventParams: {
    onEvent: (response: Location) => void;
    onError: (error: unknown) => void;
    options: StartUpdateLocationOptions;
}): () => void;

/**
 * @public
 * @tag AppsInTossModule
 * @category AppsInTossModules
 * @kind function
 * @name setClipboardText
 * @description 텍스트를 클립보드에 복사해서 사용자가 다른 곳에 붙여 넣기 할 수 있어요.
 * @param {Promise<void>} text - 클립보드에 복사할 텍스트예요. 문자열 형식으로 입력해요.
 *
 * @example
 * ### 텍스트를 클립보드에 복사하기
 *
 * ```tsx
 * import { Button } from 'react-native';
 * import { setClipboardText } from '@apps-in-toss/framework';
 *
 * // '복사' 버튼을 누르면 "복사할 텍스트"가 클립보드에 복사돼요.
 * function CopyButton() {
 *   const handleCopy = async () => {
 *     try {
 *       await setClipboardText('복사할 텍스트');
 *       console.log('텍스트가 복사됐어요!');
 *     } catch (error) {
 *       console.error('텍스트 복사에 실패했어요:', error);
 *     }
 *   };
 *
 *   return <Button title="복사" onPress={handleCopy} />;
 * }
 * ```
 */
declare function setClipboardText(text: string): Promise<void>;

/**
 * @public
 * @tag AppsInTossModule
 * @category AppsInTossModules
 * @kind function
 * @name getClipboardText
 * @description 클립보드에 저장된 텍스트를 가져오는 함수예요. 복사된 텍스트를 읽어서 다른 작업에 활용할 수 있어요.
 * @returns {Promise<string>} - 클립보드에 저장된 텍스트를 반환해요. 클립보드에 텍스트가 없으면 빈 문자열을 반환해요.
 *
 * @example
 * ### 클립보드의 텍스트 가져오기
 *
 * ```tsx
 * import React, { useState } from 'react';
 * import { View, Text, Button } from 'react-native';
 * import { getClipboardText } from '@apps-in-toss/framework';
 *
 * // '붙여넣기' 버튼을 누르면 클립보드에 저장된 텍스트를 가져와 화면에 표시해요.
 * function PasteButton() {
 *   const [text, setText] = useState('');
 *
 *   const handlePress = async () => {
 *     try {
 *       const clipboardText = await getClipboardText();
 *       setText(clipboardText || '클립보드에 텍스트가 없어요.');
 *     } catch (error) {
 *       console.error('클립보드에서 텍스트를 가져오지 못했어요:', error);
 *     }
 *   };
 *
 *   return (
 *     <View>
 *       <Text>{text}</Text>
 *       <Button title="붙여넣기" onPress={handlePress} />
 *     </View>
 *   );
 * }
 * ```
 */
declare function getClipboardText(): Promise<string>;

/**
 * 연락처 정보를 나타내는 타입이에요.
 */
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<ImageResponse[]>}
 * 앨범 사진의 고유 ID와 데이터 URI를 포함한 배열을 반환해요.
 *
 * @example
 * ### 사진의 최대 폭을 360px로 제한하여 가져오기
 *
 * ```tsx
 * import React, { useState } from 'react';
 * import { View, Image, 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({
 *         base64: true,
 *         maxWidth: 360,
 *       });
 *       setAlbumPhotos((prev) => ([...prev, ...response]));
 *     } catch (error) {
 *       console.error('앨범을 가져오는 데 실패했어요:', error);
 *     }
 *   };
 *
 *   return (
 *     <View>
 *       {albumPhotos.map((image) => (
 *         <Image source={{ uri: image.dataUri }} key={image.id} />
 *       ))}
 *       <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 {number} [options.maxWidth=1024] - 이미지의 최대 너비를 나타내는 숫자 값이에요. 기본값은 `1024`예요.
 * @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>;

/**
 * @public
 * @tag AppsInTossModule
 * @category AppsInTossModules
 * @kind function
 * @name appLogin
 * @description 토스 인증으로 로그인해요. 로그인이 완료되면 다시 토스 앱으로 이동해요.
 * @example
 *
 * ### 토스 인증을 통해 로그인을 하는 예제
 *
 * ```tsx
 * import { Button } from 'react-native';
 * import { appLogin } from '@apps-in-toss/framework';
 *
 * function Page() {
 *   const handleLogin = async () => {
 *     const { authorizationCode } = await appLogin();
 *
 *     // 획득한 인가 코드(`authorizationCode`)를 서버로 전달해요.
 *   }
 *
 *   return <Button title="로그인" onPress={handleLogin} />;
 * }
 * ```
 */
declare function appLogin(): Promise<{
    authorizationCode: string;
}>;

interface WebViewProps extends Omit<WebViewProps$1, 'source' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded'> {
    localhostPort?: number;
}
declare function WebView({ localhostPort, onMessage, ...props }: WebViewProps): react_jsx_runtime.JSX.Element;

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;

declare const env: {
    getDeploymentId: () => string | undefined;
};

export { Accuracy, type ContactEntity, type FetchAlbumPhotosOptions, type GetCurrentLocationOptions, type ImageResponse, type Location, type OpenCameraOptions, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
