@apps-in-toss/framework 0.0.39 → 1.0.0

package/dist/index.d.cts

@@ -3,13 +3,14 @@ import { ComponentType, PropsWithChildren } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _apps_in_toss_analytics from '@apps-in-toss/analytics';
 export * from '@apps-in-toss/analytics';
-import { InitialProps, BedrockProps, BedrockEventDefinition, BedrockEvent } from 'react-native-bedrock';
-import { EmitterSubscription } from 'react-native';
+import { InitialProps, GraniteProps } from '@granite-js/react-native';
 import { PartnerWebViewScreenProps, ExternalWebViewScreenProps } from '@toss-design-system/react-native';
-import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';
+import { WebViewProps as WebViewProps$1 } from '@granite-js/native/react-native-webview';
+import { StartUpdateLocationOptions, Location, onVisibilityChangedByTransparentServiceWeb } from '@apps-in-toss/native-modules';
+export * from '@apps-in-toss/native-modules';
 
 interface AppsInTossProps {
-    context: BedrockProps['context'];
+    context: GraniteProps['context'];
     analytics?: {
         /**
          * 분석 로그 출력 여부를 설정해요. 기본값은 `__DEV__` 예요.
@@ -23,2206 +24,6 @@ declare const AppsInToss: {
     registerApp: typeof registerApp;
 };
 
-interface EventEmitterSchema<K extends string, P extends unknown[]> {
-    name: K;
-    params: P;
-}
-
-/**
- * @public
- * @category 위치 정보
- * @name Accuracy
- * @description 위치 정확도 옵션이에요.
- */
-declare enum Accuracy {
-    /**
-     * 오차범위 3KM 이내
-     */
-    Lowest = 1,
-    /**
-     * 오차범위 1KM 이내
-     */
-    Low = 2,
-    /**
-     * 오차범위 몇 백미터 이내
-     */
-    Balanced = 3,
-    /**
-     * 오차범위 10M 이내
-     */
-    High = 4,
-    /**
-     * 가장 높은 정확도
-     */
-    Highest = 5,
-    /**
-     * 네비게이션을 위한 최고 정확도
-     */
-    BestForNavigation = 6
-}
-/**
- * @public
- * @category 위치 정보
- * @name Location
- * @description 위치 정보를 나타내는 객체예요.
- */
-interface Location {
-    /**
-     * Android에서만 지원하는 옵션이에요.
-     *
-     * - `FINE`: 정확한 위치
-     * - `COARSE`: 대략적인 위치
-     *
-     * @see https://developer.android.com/codelabs/approximate-location
-     */
-    accessLocation?: 'FINE' | 'COARSE';
-    /**
-     * 위치가 업데이트된 시점의 유닉스 타임스탬프예요.
-     */
-    timestamp: number;
-    /**
-     * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/react-native/reference/framework/Types/LocationCoords.html)을 참고해주세요.
-     */
-    coords: LocationCoords;
-}
-/**
- * @public
- * @category 위치 정보
- * @name LocationCoords
- * @description 세부 위치 정보를 나타내는 객체예요.
- */
-interface LocationCoords {
-    /**
-     * 위도
-     */
-    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$1 {
-    /**
-     * 위치 정확도를 설정해요.
-     */
-    accuracy: Accuracy;
-    /**
-     * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
-     */
-    timeInterval: number;
-    /**
-     * 위치 변경 거리를 미터(m) 단위로 설정해요.
-     */
-    distanceInterval: number;
-}
-interface StartUpdateLocationSubscription extends EmitterSubscription {
-    remove: () => Promise<void>;
-}
-/**
- * @name UpdateLocationEventEmitter
- * @kind typedef
- * @description
- * 디바이스의 위치 정보 변경을 감지해요
- */
-type UpdateLocationEventEmitter = EventEmitterSchema<'updateLocation', [Location]>;
-/**
- * @public
- * @category 위치 정보
- * @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] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
- *
- * @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.Balanced,
- *         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$1;
-}): () => void;
-
-/**
- * @public
- * @category 광고
- * @name AdMobFullScreenEvent
- * @description 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
- * @example
- * ### 광고 이벤트 처리하기
- * ```ts
- * function handleEvent(event: AdMobFullScreenEvent) {
- *   switch (event.type) {
- *     case 'clicked':
- *       console.log('광고가 클릭됐어요.');
- *       break;
- *
- *     case 'dismissed':
- *       console.log('광고가 닫혔어요.');
- *       break;
- *
- *     case 'failedToShow':
- *       console.log('광고가 보여지지 않았어요.');
- *       break;
- *
- *     case 'impression':
- *       console.log('광고가 노출됐어요.');
- *       break;
- *
- *     case 'show':
- *       console.log('광고가 보여졌어요.');
- *       break;
- *   }
- * }
- * ```
- */
-type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
-type AdClicked = {
-    type: 'clicked';
-};
-type AdDismissed = {
-    type: 'dismissed';
-};
-type AdFailedToShow = {
-    type: 'failedToShow';
-};
-type AdImpression = {
-    type: 'impression';
-};
-type AdShow = {
-    type: 'show';
-};
-interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
-    options: Options;
-    onEvent: (event: Event) => void;
-    onError: (error: unknown) => void;
-}
-/**
- * @public
- * @category 광고
- * @name ResponseInfo
- * @description 광고 로드 응답 정보를 담고 있는 객체예요.
- * @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
- * @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
- * @property {string | null} responseId 광고 응답 ID예요.
- */
-interface ResponseInfo {
-    adNetworkInfoArray: Array<AdNetworkResponseInfo>;
-    loadedAdNetworkInfo: AdNetworkResponseInfo | null;
-    responseId: string | null;
-}
-/**
- * @public
- * @category 광고
- * @name AdNetworkResponseInfo
- * @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
- * @property {string} adSourceId 광고 소스 ID예요.
- * @property {string} adSourceName 광고 소스 이름이예요.
- * @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
- * @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
- * @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
- */
-interface AdNetworkResponseInfo {
-    adSourceId: string;
-    adSourceName: string;
-    adSourceInstanceId: string;
-    adSourceInstanceName: string;
-    adNetworkClassName: string | null;
-}
-/**
- * @public
- * @category 광고
- * @name InterstitialAd
- * @description 전면 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
- * @property {string} adUnitId 광고 ID예요.
- * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
- */
-interface InterstitialAd {
-    adUnitId: string;
-    responseInfo: ResponseInfo;
-}
-/**
- * @public
- * @category 광고
- * @name RewardedAd
- * @description 보상형 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
- * @property {string} adUnitId 광고 ID예요.
- * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
- */
-interface RewardedAd {
-    adUnitId: string;
-    responseInfo: ResponseInfo;
-}
-
-interface LoadAdMobInterstitialAdOptions {
-    /**
-     * 광고 단위 ID
-     */
-    adUnitId: string;
-}
-/**
- * @public
- * @category 광고
- * @name LoadAdMobInterstitialAdEvent
- * @description 전면 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [InterstitialAd](/react-native/reference/framework/광고/InterstitialAd.html) 객체가 함께 반환돼요.
- */
-type LoadAdMobInterstitialAdEvent = AdMobFullScreenEvent | {
-    type: 'loaded';
-    data: InterstitialAd;
-};
-/**
- * @public
- * @category 광고
- * @name LoadAdMobInterstitialAdParams
- * @description 전면 광고를 불러오는 함수에 필요한 옵션 객체예요.
- */
-type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdOptions, LoadAdMobInterstitialAdEvent>;
-/**
- * @public
- * @category 광고
- * @name loadAdMobInterstitialAd
- * @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
- * @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
- * @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
- * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
- * @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/framework/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
- * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
- * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
- *
- * @example
- * ### 버튼 눌러 불러온 전면 광고 보여주기
- * ```tsx
- * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
- * import { useCallback, useState } from 'react';
- * import { Button, Text, View } from 'react-native';
- * import { useNavigation } from 'react-native-bedrock';
- *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
- *
- * export function GoogleAdmobInterstitialAdExample() {
- *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
- *   const navigation = useNavigation();
- *
- *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
- *       return;
- *     }
-
- *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         switch (event.type) {
- *           case 'loaded':
- *             console.log('광고 로드 성공', event.data);
- *             setAdLoadStatus('loaded');
- *             break;
- *
- *           case 'clicked':
- *             console.log('광고 클릭');
- *             break;
- *
- *           case 'dismissed':
- *             console.log('광고 닫힘');
- *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
- *             break;
- *
- *           case 'failedToShow':
- *             console.log('광고 보여주기 실패');
- *             break;
- *
- *           case 'impression':
- *             console.log('광고 노출');
- *             break;
- *
- *           case 'show':
- *             console.log('광고 컨텐츠 보여졌음');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 불러오기 실패', error);
- *       },
- *     });
- *
- *     return cleanup;
- *   }, [navigation]);
- *
- *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
- *       return;
- *     }
- *
- *     GoogleAdMob.showAdMobInterstitialAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         switch (event.type) {
- *           case 'requested':
- *             console.log('광고 보여주기 요청 완료');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 보여주기 실패', error);
- *       },
- *     });
- *   }, []);
- *
- *   useFocusEffect(loadAd);
- *
- *   return (
- *     <View>
- *       <Text>
- *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
- *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
- *         {adLoadStatus === 'failed' && '광고 로드 실패'}
- *       </Text>
- *
- *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function loadAdMobInterstitialAd(params: LoadAdMobInterstitialAdParams): () => void;
-declare namespace loadAdMobInterstitialAd {
-    var isSupported: () => boolean;
-}
-interface ShowAdMobInterstitialAdOptions {
-    /**
-     * 광고 단위 ID
-     */
-    adUnitId: string;
-}
-/**
- * @public
- * @category 광고
- * @name ShowAdMobInterstitialAdEvent
- * @description 전면 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
- */
-type ShowAdMobInterstitialAdEvent = {
-    type: 'requested';
-};
-/**
- * @public
- * @category 광고
- * @name ShowAdMobInterstitialAdParams
- * @description 불러온 전면 광고를 보여주는 함수에 필요한 옵션 객체예요.
- */
-type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent>;
-/**
- * @public
- * @category 광고
- * @name showAdMobInterstitialAd
- * @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
- * @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
- * @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
- * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
- * @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/framework/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
- * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
- * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
- *
- * @example
- * ### 버튼 눌러 불러온 전면 광고 보여주기
- * ```tsx
- * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
- * import { useCallback, useState } from 'react';
- * import { Button, Text, View } from 'react-native';
- * import { useNavigation } from 'react-native-bedrock';
- *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
- *
- * export function GoogleAdmobInterstitialAdExample() {
- *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
- *   const navigation = useNavigation();
- *
- *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
- *       return;
- *     }
-
- *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         switch (event.type) {
- *           case 'loaded':
- *             console.log('광고 로드 성공', event.data);
- *             setAdLoadStatus('loaded');
- *             break;
- *
- *           case 'clicked':
- *             console.log('광고 클릭');
- *             break;
- *
- *           case 'dismissed':
- *             console.log('광고 닫힘');
- *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
- *             break;
- *
- *           case 'failedToShow':
- *             console.log('광고 보여주기 실패');
- *             break;
- *
- *           case 'impression':
- *             console.log('광고 노출');
- *             break;
- *
- *           case 'show':
- *             console.log('광고 컨텐츠 보여졌음');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 불러오기 실패', error);
- *       },
- *     });
- *
- *     return cleanup;
- *   }, [navigation]);
- *
- *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
- *       return;
- *     }
- *
- *     GoogleAdMob.showAdMobInterstitialAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         switch (event.type) {
- *           case 'requested':
- *             console.log('광고 보여주기 요청 완료');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 보여주기 실패', error);
- *       },
- *     });
- *   }, []);
- *
- *   useFocusEffect(loadAd);
- *
- *   return (
- *     <View>
- *       <Text>
- *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
- *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
- *         {adLoadStatus === 'failed' && '광고 로드 실패'}
- *       </Text>
- *
- *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function showAdMobInterstitialAd(params: ShowAdMobInterstitialAdParams): () => void;
-declare namespace showAdMobInterstitialAd {
-    var isSupported: () => boolean;
-}
-interface LoadAdMobRewardedAdOptions {
-    /**
-     * 광고 단위 ID
-     */
-    adUnitId: string;
-}
-/**
- * @public
- * @category 광고
- * @name LoadAdMobRewardedAdEvent
- * @description 보상형 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [RewardedAd](/react-native/reference/framework/광고/RewardedAd.html) 객체가 함께 반환돼요. `userEarnedReward` 이벤트는 사용자가 광고를 끝까지 시청해, 보상 조건을 충족했을 때 발생해요.
- */
-type LoadAdMobRewardedAdEvent = AdMobFullScreenEvent | {
-    type: 'loaded';
-    data: RewardedAd;
-} | {
-    type: 'userEarnedReward';
-};
-/**
- * @public
- * @category 광고
- * @name LoadAdMobRewardedAdParams
- * @description 보상형 광고를 불러오는 함수에 필요한 옵션 객체예요.
- */
-type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions, LoadAdMobRewardedAdEvent>;
-/**
- * @public
- * @category 광고
- * @name loadAdMobRewardedAd
- * @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
- * @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
- * @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
- * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
- * @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/framework/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
- * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
- * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
- *
- * @example
- *
- * ### 버튼 눌러 불러온 보상형 광고 보여주기
- *
- * ```tsx
- * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useCallback, useState } from 'react';
- * import { Button, Text, View } from 'react-native';
- *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
- *
- * export function GoogleAdmobRewardedAdExample() {
- *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
- *
- *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
- *       return;
- *     }
- *
- *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         console.log(event.type);
- *         switch (event.type) {
- *           case 'loaded':
- *             console.log('광고 로드 성공', event.data);
- *             setAdLoadStatus('loaded');
- *             break;
- *
- *           case 'clicked':
- *             console.log('광고 클릭');
- *             break;
- *
- *           case 'dismissed':
- *             console.log('광고 닫힘');
- *             break;
- *
- *           case 'failedToShow':
- *             console.log('광고 보여주기 실패');
- *             break;
- *
- *           case 'impression':
- *             console.log('광고 노출');
- *             break;
- *
- *           case 'show':
- *             console.log('광고 컨텐츠 보여졌음');
- *             break;
- *
- *           case 'userEarnedReward':
- *             console.log('사용자가 광고 시청을 완료했음');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 불러오기 실패', error);
- *       },
- *     });
- *
- *     return cleanup;
- *   }, []);
- *
- *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
- *       return;
- *     }
- *
- *     GoogleAdMob.showAdMobRewardedAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         switch (event.type) {
- *           case 'requested':
- *             console.log('광고 보여주기 요청 완료');
- *             setAdLoadStatus('not_loaded');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 보여주기 실패', error);
- *       },
- *     });
- *   }, []);
- *
- *   return (
- *     <View>
- *       <Text>
- *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
- *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
- *         {adLoadStatus === 'failed' && '광고 로드 실패'}
- *       </Text>
- *
- *       <Button title="Load Ad" onPress={loadAd} />
- *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams): () => void;
-declare namespace loadAdMobRewardedAd {
-    var isSupported: () => boolean;
-}
-interface ShowAdMobRewardedAdOptions {
-    /**
-     * 광고 단위 ID
-     */
-    adUnitId: string;
-}
-/**
- * @public
- * @category 광고
- * @name ShowAdMobRewardedAdEvent
- * @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
- */
-type ShowAdMobRewardedAdEvent = {
-    type: 'requested';
-};
-/**
- * @public
- * @category 광고
- * @name ShowAdMobRewardedAdParams
- * @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
- */
-type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
-/**
- * @public
- * @category 광고
- * @name showAdMobRewardedAd
- * @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
- * @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
- * @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
- * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
- * @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/framework/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
- * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
- * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
- *
- * @example
- * ### 버튼 눌러 불러온 보상형 광고 보여주기
- *
- * ```tsx
- * import { GoogleAdMob } from '@apps-in-toss/framework';
- * import { useCallback, useState } from 'react';
- * import { Button, Text, View } from 'react-native';
- *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
- *
- * export function GoogleAdmobRewardedAdExample() {
- *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
- *
- *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
- *       return;
- *     }
- *
- *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         console.log(event.type);
- *         switch (event.type) {
- *           case 'loaded':
- *             console.log('광고 로드 성공', event.data);
- *             setAdLoadStatus('loaded');
- *             break;
- *
- *           case 'clicked':
- *             console.log('광고 클릭');
- *             break;
- *
- *           case 'dismissed':
- *             console.log('광고 닫힘');
- *             break;
- *
- *           case 'failedToShow':
- *             console.log('광고 보여주기 실패');
- *             break;
- *
- *           case 'impression':
- *             console.log('광고 노출');
- *             break;
- *
- *           case 'show':
- *             console.log('광고 컨텐츠 보여졌음');
- *             break;
- *
- *           case 'userEarnedReward':
- *             console.log('사용자가 광고 시청을 완료했음');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 불러오기 실패', error);
- *       },
- *     });
- *
- *     return cleanup;
- *   }, []);
- *
- *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
- *       return;
- *     }
- *
- *     GoogleAdMob.showAdMobRewardedAd({
- *       options: {
- *         adUnitId: AD_UNIT_ID,
- *       },
- *       onEvent: (event) => {
- *         switch (event.type) {
- *           case 'requested':
- *             console.log('광고 보여주기 요청 완료');
- *             setAdLoadStatus('not_loaded');
- *             break;
- *         }
- *       },
- *       onError: (error) => {
- *         console.error('광고 보여주기 실패', error);
- *       },
- *     });
- *   }, []);
- *
- *   return (
- *     <View>
- *       <Text>
- *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
- *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
- *         {adLoadStatus === 'failed' && '광고 로드 실패'}
- *       </Text>
- *
- *       <Button title="Load Ad" onPress={loadAd} />
- *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams): () => void;
-declare namespace showAdMobRewardedAd {
-    var isSupported: () => boolean;
-}
-
-/**
- * @public
- * @category 토스페이
- * @name CheckoutPaymentOptions
- * @description 토스페이 결제창을 띄울 때 필요한 옵션이에요.
- * @property {string} payToken 결제 토큰이에요.
- */
-interface CheckoutPaymentOptions {
-    /**
-     * 결제 토큰이에요.
-     */
-    payToken: string;
-}
-/**
- * @public
- * @category 토스페이
- * @name CheckoutPaymentResult
- * @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.
- * @property {boolean} success 인증이 성공했는지 여부예요.
- * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
- */
-interface CheckoutPaymentResult {
-    /**
-     * 인증이 성공했는지 여부예요.
-     */
-    success: boolean;
-    /**
-     * 인증이 실패했을 경우의 이유예요.
-     */
-    reason?: string;
-}
-/**
- * @public
- * @category 토스페이
- * @name checkoutPayment
- * @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
- *
- * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
- *
- * @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.
- * @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.
- *
- * @example
- *
- * ### 토스페이 결제창 띄우고 인증 처리하기
- *
- * ```tsx
- * import { TossPay } from '@apps-in-toss/framework';
- *
- * async function handlePayment() {
- *   try {
- *     // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
- *     const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());
- *
- *     const { success, reason } = await TossPay.checkoutPayment({ payToken });
- *
- *     if (success) {
- *       // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해주세요.
- *       await fetch('/my-api/payment/execute', {
- *         method: 'POST',
- *         body: JSON.stringify({ payToken }),
- *         headers: { 'Content-Type': 'application/json' },
- *       });
- *     } else {
- *       console.log('인증 실패:', reason);
- *     }
- *   } catch (error) {
- *     console.error('결제 인증 중 오류가 발생했어요:', error);
- *   }
- * }
- * ```
- */
-declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
-
-/**
- * @public
- * @category 로그인
- * @name appLogin
- * @description 토스 인증으로 로그인해요. 로그인이 완료되면 다시 토스 앱으로 이동해요.
- * @example
- *
- * ### 토스 인증을 통해 로그인을 하는 예제
- *
- * ```tsx
- * import { Button } from 'react-native';
- * import { appLogin } from '@apps-in-toss/framework';
- *
- * function Page() {
- *   const handleLogin = async () => {
- *     const { authorizationCode, referrer } = await appLogin();
- *
- *     // 획득한 인가 코드(`authorizationCode`)와 `referrer`를 서버로 전달해요.
- *   }
- *
- *   return <Button title="로그인" onPress={handleLogin} />;
- * }
- * ```
- */
-declare function appLogin(): Promise<{
-    authorizationCode: string;
-    referrer: "DEFAULT" | "SANDBOX";
-}>;
-
-type Primitive = string | number | boolean | null | undefined | symbol;
-
-interface EventLogParams {
-    log_name: string;
-    log_type: 'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click';
-    params: Record<string, Primitive>;
-}
-/**
- * @category 로깅
- * @kind function
- * @name eventLog
- * @description
- * 이벤트 로그를 기록하는 함수예요.
- *
- * 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.
- *
- * @param {Object} params 로그 기록에 필요한 매개변수 객체예요.
- * @param {string} params.log_name 로그의 이름이에요.
- * @param {'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click'} params.log_type 로그의 유형이에요.
- * @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.
- *
- * @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.
- *
- * @example
- * ### 이벤트 로그 기록하기
- *
- * ```tsx
- * import { eventLog } from '@apps-in-toss/framework';
- *
- * function logUserAction() {
- *   eventLog({
- *     log_name: 'user_action',
- *     log_type: 'info',
- *     params: {
- *       action: 'button_click',
- *       screen: 'main',
- *       userId: 12345
- *     }
- *   });
- * }
- * ```
- */
-declare function eventLog(params: EventLogParams): Promise<void>;
-
-/**
- * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
- */
-interface FetchAlbumPhotosOptions {
-    /** 가져올 사진의 최대 개수를 설정해요. 숫자를 입력하고 기본값은 10이에요. */
-    maxCount?: number;
-    /** 사진의 최대 폭을 제한해요. 단위는 픽셀이고 기본값은 1024이에요. */
-    maxWidth?: number;
-    /** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
-    base64?: boolean;
-}
-/**
- * @public
- * @category 사진
- * @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';
- *
- * const base64 = true;
- *
- * // 앨범 사진 목록을 가져와 화면에 표시하는 컴포넌트
- * function AlbumPhotoList() {
- *   const [albumPhotos, setAlbumPhotos] = useState([]);
- *
- *   const handlePress = async () => {
- *     try {
- *       const response = await fetchAlbumPhotos({
- *         base64,
- *         maxWidth: 360,
- *       });
- *       setAlbumPhotos((prev) => ([...prev, ...response]));
- *     } catch (error) {
- *       console.error('앨범을 가져오는 데 실패했어요:', error);
- *     }
- *   };
- *
- *   return (
- *     <View>
- *       {albumPhotos.map((image) => {
- *         // base64 형식으로 반환된 이미지를 표시하려면 데이터 URL 스키마 Prefix를 붙여야해요.
- *         const imageUri = base64 ? 'data:image/jpeg;base64,' + image.dataUri : image.dataUri;
- *
- *         return <Image source={{ uri: imageUri }} key={image.id} />;
- *       })}
- *       <Button title="앨범 가져오기" onPress={handlePress} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function fetchAlbumPhotos(options: FetchAlbumPhotosOptions): Promise<ImageResponse[]>;
-
-/**
- * 연락처 정보를 나타내는 타입이에요.
- */
-interface ContactEntity {
-    /** 연락처 이름이에요. */
-    name: string;
-    /** 연락처 전화번호로, 문자열 형식이에요. */
-    phoneNumber: string;
-}
-/**
- * @public
- * @category 연락처
- * @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`예요.
- *
- * @signature
- * ```typescript
- * function fetchContacts({ size, offset, query }: {
- *  size: number;
- *  offset: number;
- *  query?: {
- *    contains?: string;
- *  };
- * }): Promise<{
- *  result: ContactEntity[];
- *  nextOffset: number | null;
- *  done: boolean;
- *  }>;
- * ```
- *
- * @example
- * ### 특정 문자열이 포함된 연락처 목록 가져오기
- *
- * ```tsx
- * import React, { useState } from 'react';
- * import { View, Text, Button } from 'react-native';
- * import { fetchContacts, ContactEntity } from '@apps-in-toss/framework';
- *
- * // 특정 문자열을 포함한 연락처 목록을 가져와 화면에 표시하는 컴포넌트
- * function ContactsList() {
- *   const [contacts, setContacts] = useState<{
- *     result: ContactEntity[];
- *     nextOffset: number | null;
- *     done: boolean;
- *   }>({
- *     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;
-}>;
-
-/**
- * @public
- * @category 클립보드
- * @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 GetCurrentLocationOptions {
-    /**
-     * 위치 정보를 가져올 정확도 수준이에요.
-     */
-    accuracy: Accuracy;
-}
-/**
- * @public
- * @category 위치 정보
- * @name getCurrentLocation
- * @description 디바이스의 현재 위치 정보를 가져오는 함수예요.
- * 위치 기반 서비스를 구현할 때 사용되고, 한 번만 호출되어 현재 위치를 즉시 반환해요.
- * 예를 들어 지도 앱에서 사용자의 현재 위치를 한 번만 가져올 때, 날씨 앱에서 사용자의 위치를 기반으로 기상 정보를 제공할 때, 매장 찾기 기능에서 사용자의 위치를 기준으로 가까운 매장을 검색할 때 사용하면 유용해요.
- *
- * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
- * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
- * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
- *
- * @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>;
-
-/**
- * @public
- * @category 환경 확인
- * @kind function
- * @name getDeviceId
- * @description
- * 사용 중인 기기의 고유 식별자를 문자열로 반환해요.
- *
- * 이 함수는 현재 사용 중인 기기의 고유 식별자를 문자열로 반환해요. 기기별로 설정이나 데이터를 저장하거나 사용자의 기기를 식별해서 로그를 기록하고 분석하는 데 사용할 수 있어요. 같은 사용자의 여러 기기를 구분하는 데도 유용해요.
- *
- * @returns {string} 기기의 고유 식별자를 나타내는 문자열이에요.
- *
- * @example
- * ### 기기 고유 식별자 가져오기
- *
- * ```tsx
- * import { getDeviceId } from '@apps-in-toss/framework';
- * import { Text } from 'react-native';
- *
- * function MyPage() {
- *   const id = getDeviceId();
- *
- *   return (
- *     <Text>사용자의 기기 고유 식별자: {id}</Text>
- *   );
- * }
- * ```
- */
-declare function getDeviceId(): string;
-
-/**
- * @public
- * @category 환경 확인
- * @kind function
- * @name getOperationalEnvironment
- * @description
- * 현재 실행 중인 앱의 운영 환경을 확인해요.
- * 토스 앱에서 실행 중이라면 `'toss'`, 샌드박스 환경에서 실행 중이라면 `'sandbox'`를 반환해요.
- *
- * 운영 환경은 앱이 실행되는 컨텍스트를 의미하며, 특정 기능의 사용 가능 여부를 판단하는 데 활용할 수 있어요.
- *
- * @returns {'toss' | 'sandbox'}
- * 현재 운영 환경을 나타내는 문자열이에요.
- * - `'toss'`: 토스 앱에서 실행 중이에요.
- * - `'sandbox'`: 샌드박스 환경에서 실행 중이에요.
- *
- * @example
- * ### 현재 운영 환경 확인하기
- *
- * ```tsx
- * import { getOperationalEnvironment } from '@apps-in-toss/framework';
- * import { Text } from 'react-native';
- *
- * function EnvironmentInfo() {
- *   const environment = getOperationalEnvironment();
- *
- *   return (
- *     <Text>현재 운영 환경: {environment}</Text>
- *   );
- * }
- * ```
- */
-declare function getOperationalEnvironment(): 'toss' | 'sandbox';
-
-/**
- * @public
- * @category 환경 확인
- * @name getTossAppVersion
- * @description 토스 앱 버전을 가져옵니다. 예를 들어, `5.206.0`과 같은 형태로 반환돼요. 토스 앱 버전을 로그로 남기거나, 특정 기능이 특정 버전 이상에서만 실행될 때 사용돼요.
- * @signature
- * ```typescript
- * function getTossAppVersion(): string
- * ```
- *
- * @returns {string} 토스 앱 버전
- *
- * @example
- *
- *
- * ### 토스 앱 버전 확인하기
- *
- * ```tsx
- * import { getTossAppVersion } from '@apps-in-toss/framework';
- * import { Text } from 'react-native';
- *
- * export function TossAppVersionPage() {
- *  return (
- *   <Text>{getTossAppVersion()}</Text>
- *  )
- * }
- * ```
- */
-declare function getTossAppVersion(): string;
-
-/**
- * @public
- * @category 공유
- * @kind function
- * @name getTossShareLink
- * @description
- * `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
- * 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
- *
- * 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
- * 예를 들어 `intoss://<앱 이름>`이나 `intoss://<앱 이름>/about?name=test`처럼 작성해요.
- *
- * 이 함수를 사용하면 `deep_link_value`를 포함한 완성된 공유 링크를 만들 수 있어요.
- *
- * @param path - 딥링크로 열고 싶은 경로예요. `intoss://`로 시작하는 문자열이어야 해요.
- * @returns {Promise<string>} `deep_link_value`가 포함된 토스 공유 링크를 반환해요.
- *
- * @example
- * ```tsx
- * import { share } from 'react-native-bedrock';
- * import { getTossShareLink } from '@apps-in-toss/framework';
- *
- * // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
- * const tossLink = await getTossShareLink('intoss://my-app');
- *
- * // 생성한 링크를 메시지로 공유해요.
- * await share({ message: tossLink });
- * ```
- */
-declare function getTossShareLink(path: string): Promise<string>;
-
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-interface IapCreateOneTimePurchaseOrderOptions {
-    productId: string;
-}
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderResult
- * @description 인앱결제 1건이 완료되면 결제 세부 정보와 상품 정보를 담아 반환해요. 반환된 정보로 결제한 상품의 정보를 화면에 표시할 수 있어요.
- * @property {string} orderId - 결제 주문 ID이에요. 결제 완료 후 [결제 상태를 조회](https://developers-apps-in-toss.toss.im/api/getIapOrderStatus.html)할 때 사용해요.
- * @property {string} displayName - 화면에 표시할 상품 이름이에요.
- * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
- * @property {number} amount - 상품 가격 숫자 값이에요. 화폐 단위와 쉼표를 제외한 순수 숫자예요. 예를 들어 `1000`으로 표시돼요.
- * @property {string} currency - [ISO 4217 표준](https://ko.wikipedia.org/wiki/ISO_4217)에 따른 상품 가격 통화 단위예요. 예를 들어 원화는 `KRW`, 달러는 `USD`로 표시돼요.
- * @property {number} fraction - 가격을 표시할 때 소수점 아래 몇 자리까지 보여줄지 정하는 값이에요. 예를 들어 달러는 소수점 둘째 자리까지 보여줘서 `2`, 원화는 소수점이 필요 없어서 `0`이에요
- * @property {string | null} miniAppIconUrl - 미니앱 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요. 콘솔에서 아이콘을 등록하지 않았다면 `null`로 반환돼요.
- */
-interface IapCreateOneTimePurchaseOrderResult {
-    orderId: string;
-    displayName: string;
-    displayAmount: string;
-    amount: number;
-    currency: string;
-    fraction: number;
-    miniAppIconUrl: string | null;
-}
-/**
- * @public
- * @category 인앱결제
- * @name iapCreateOneTimePurchaseOrder
- * @description
- * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
- * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
- * @param {string} params.productId - 주문할 상품의 ID예요.
- * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
- *
- * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
- * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
- * @throw {code: "NETWORK_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
- * @throw {code: "INVALID_USER_ENVIRONMENT"} - 특정 기기, 계정 또는 설정 환경에서 구매할 수 없는 상품일 때 발생해요.
- * @throw {code: "ITEM_ALREADY_OWNED"} - 사용자가 이미 구매한 상품을 다시 구매하려고 할 때 발생해요.
- * @throw {code: "APP_MARKET_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 앱스토어에서 사용자 정보 검증에 실패했을 때 발생해요. 사용자가 앱스토어에 문의해서 환불을 요청해야해요.
- * @throw {code: "TOSS_SERVER_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 서버 전송에 실패해서 결제 정보를 저장할 수 없을 때 발생해요.
- * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
- * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
- * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
- *
- * @example
- * ### 특정 인앱결제 주문서 페이지로 이동하기
- *
- * ```tsx
- * import { IAP } from "@apps-in-toss/web-framework";
- * import { Button } from "@toss-design-system/react-native";
- *
- * interface Props {
- *   productId: string;
- * }
- *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
- *
- *   return <Button onClick={handleClick}>구매하기</Button>;
- * }
- * ```
- */
-declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): Promise<IapCreateOneTimePurchaseOrderResult | undefined>;
-/**
- * @public
- * @category 인앱결제
- * @name IapProductListItem
- * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
- * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html)를 호출할때 사용하는 `productId`와 동일한 값이에요.
- * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
- * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
- * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
- * @property {string} description - 상품에 대한 설명이에요. 설명은 앱인토스 콘솔에서 설정한 값이에요.
- */
-interface IapProductListItem {
-    sku: string;
-    displayAmount: string;
-    displayName: string;
-    iconUrl: string;
-    description: string;
-}
-/**
- * @public
- * @category 인앱결제
- * @name iapGetProductItemList
- * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
- * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
- *
- * @example
- * ### 구매 가능한 인앱결제 상품목록 가져오기
- *
- * ```tsx
- * import { IAP, IapProductListItem } from "@apps-in-toss/framework";
- * import { Button, List, ListRow } from "@toss-design-system/react-native";
- * import { useEffect, useState } from "react";
- *
- * function IapProductList() {
- *   const [products, setProducts] = useState<IapProductListItem[]>([]);
- *
- *   async function buyIapProduct(productId: string) {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error("인앱결제에 실패했어요:", error);
- *     }
- *   }
- *
- *   useEffect(() => {
- *     async function fetchProducts() {
- *       try {
- *         const response = await IAP.getProductItemList();
- *         setProducts(response?.products ?? []);
- *       } catch (error) {
- *         console.error("상품 목록을 가져오는 데 실패했어요:", error);
- *       }
- *     }
- *
- *     fetchProducts();
- *   }, []);
- *
- *   return (
- *     <List>
- *       {products.map((product) => (
- *         <ListRow
- *           key={product.sku}
- *           left={
- *             <ListRow.Image type="square" source={{ uri: product.iconUrl }} />
- *           }
- *           right={
- *             <Button size="medium" onPress={() => buyIapProduct(product.sku)}>
- *               구매하기
- *             </Button>
- *           }
- *           contents={
- *             <ListRow.Texts
- *               type="3RowTypeA"
- *               top={product.displayName}
- *               middle={product.description}
- *               bottom={product.displayAmount}
- *             />
- *           }
- *         />
- *       ))}
- *     </List>
- *   );
- * }
- * ```
- */
-declare function getProductItemList(): Promise<{
-    products: IapProductListItem[];
-} | undefined>;
-/**
- * @public
- * @category 인앱결제
- * @name IAP
- * @description 인앱결제 관련 기능을 모은 객체예요. 단건 인앱결제 주문서 이동과 상품 목록 조회 기능을 제공해요.
- * @property {typeof createOneTimePurchaseOrder} [createOneTimePurchaseOrder] 특정 인앱결제 주문서 페이지로 이동해요. 자세한 내용은 [createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getProductItemList.html) 문서를 참고하세요.
- * @property {typeof getProductItemList} [getProductItemList] 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 자세한 내용은 [getProductItemList](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html) 문서를 참고하세요.
- */
-declare const IAP: {
-    createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
-    getProductItemList: typeof getProductItemList;
-};
-
-/**
- * @public
- * @category 환경 확인
- * @kind function
- * @name isMinVersionSupported
- * @description
- * 현재 토스 앱 버전이 지정한 최소 버전 이상인지 확인해요.
- *
- * 이 함수는 현재 실행 중인 토스 앱의 버전이 파라미터로 전달된 최소 버전 요구사항을 충족하는지 확인해요. 특정 기능이 최신 버전에서만 동작할 때, 사용자에게 앱 업데이트를 안내할 수 있어요.
- *
- * @param {Object} minVersions 플랫폼별 최소 버전 요구사항을 지정하는 객체예요.
- * @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.android 안드로이드 플랫폼의 최소 버전 요구사항이에요.
- * @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.ios iOS 플랫폼의 최소 버전 요구사항이에요.
- * @returns {boolean} 현재 앱 버전이 최소 버전 이상이면 true, 그렇지 않으면 false를 반환해요.
- *
- * @example
- * ### 앱 버전 확인하기
- *
- * ```tsx
- * import { isMinVersionSupported } from '@apps-in-toss/framework';
- * import { Text, View } from 'react-native';
- *
- * function VersionCheck() {
- *   const isSupported = isMinVersionSupported({
- *     android: '1.2.0',
- *     ios: '1.3.0'
- *   });
- *
- *   return (
- *     <View>
- *       {!isSupported && (
- *         <Text>최신 버전으로 업데이트가 필요해요.</Text>
- *       )}
- *     </View>
- *   );
- * }
- * ```
- */
-declare function isMinVersionSupported(minVersions: {
-    android: `${number}.${number}.${number}` | 'always' | 'never';
-    ios: `${number}.${number}.${number}` | 'always' | 'never';
-}): boolean;
-
-interface OpenCameraOptions {
-    /**
-     * 이미지를 Base64 형식으로 반환할지 여부를 나타내는 불리언 값이에요.
-     *
-     * 기본값: `false`.
-     */
-    base64?: boolean;
-    /**
-     * 이미지의 최대 너비를 나타내는 숫자 값이에요.
-     *
-     * 기본값: `1024`.
-     */
-    maxWidth?: number;
-}
-/**
- * @public
- * @category 카메라
- * @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';
- *
- * const base64 = true;
- *
- * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
- * function Camera() {
- *   const [image, setImage] = useState(null);
- *
- *   const handlePress = async () => {
- *     try {
- *       const response = await openCamera({ base64 });
- *       setImage(response);
- *     } catch (error) {
- *       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} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
-
-/**
- * @public
- * @category 게임센터
- * @name openGameCenterLeaderboard
- * @description 게임센터 리더보드 웹뷰를 열어요.
- * 앱 버전이 최소 지원 버전(`5.221.0`)보다 낮으면 아무 동작도 하지 않고 `undefined`를 반환해요.
- * 게임센터를 사용하는 사용자는 반드시 최소 지원 버전 이상이어야 게임을 실행할 수 있어요.
- * @returns 리더보드 웹뷰를 호출해요. 앱 버전이 낮으면 아무 동작도 하지 않고 `undefined`를 반환해요.
- *
- * @example
- * import { Button } from 'react-native';
- * import { openGameCenterLeaderboard } from '@apps-in-toss/framework';
- *
- * // '리더보드' 버튼을 누르면 게임센터 리더보드 웹뷰가 열려요.
- * function LeaderboardButton() {
- *   const onPress = () => {
- *     openGameCenterLeaderboard();
- *   };
- *
- *   return <Button title="리더보드 웹뷰 호출" onPress={onPress} />;
- * }
- */
-declare function openGameCenterLeaderboard(): Promise<void>;
-
-interface SaveBase64DataParams {
-    data: string;
-    fileName: string;
-    mimeType: string;
-}
-/**
- * @public
- * @category 데이터
- * @name saveBase64Data
- * @description 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요. 이미지, 텍스트, PDF 등 다양한 형식의 데이터를 저장할 수 있어요.
- * @param {SaveBase64DataParams} params - 저장할 데이터와 파일 정보를 담은 객체예요.
- * @param {string} params.data - Base64 형식으로 인코딩된 데이터 문자열이에요.
- * @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
- * ### Base64 이미지 데이터를 사용자 기기에 저장하기
- *
- * ```tsx
- * import { Button } from 'react-native';
- * import { saveBase64Data } from '@apps-in-toss/framework';
- *
- * // '저장' 버튼을 누르면 이미지가 사용자 기기에 저장돼요.
- * function SaveButton() {
- *   const handleSave = async () => {
- *     try {
- *       await saveBase64Data({
- *         data: 'iVBORw0KGgo...',
- *         fileName: 'some-photo.png',
- *         mimeType: 'image/png',
- *       });
- *     } catch (error) {
- *       console.error('데이터 저장에 실패했어요:', error);
- *     }
- *   };
- *
- *   return <Button title="저장" onPress={handleSave} />;
- * }
- * ```
- */
-declare function saveBase64Data(params: SaveBase64DataParams): Promise<void>;
-
-/**
- * @public
- * @category 클립보드
- * @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
- * @category 화면 제어
- * @kind function
- * @name setDeviceOrientation
- * @description
- * `setDeviceOrientation` 함수는 기기의 화면 방향을 설정하는 기능을 제공해요.
- * 이 기능은 특정 화면에서 가로 모드나 세로 모드를 강제로 지정해야 할 때 유용해요.
- *
- * `type` 옵션을 통해 원하는 화면 방향을 지정할 수 있어요. 특히, 이 함수는 앱 전체에 영향을 미치므로
- * 특정 화면에서만 사용하려면 화면을 벗어날 때 이전 상태로 복구하는 추가 작업이 필요해요.
- *
- * 예를 들어, 동영상 감상 화면에서는 가로 모드를 강제하고, 화면을 떠날 때 설정을 복구해서
- * 다른 화면들의 방향 설정에 영향을 주지 않도록 할 수 있어요.
- *
- * @param {object} options 화면 방향 설정 값이에요.
- * @param {string} options.type 화면 방향을 지정하는 옵션이에요.
- * 'portrait' | 'landscape' 중 하나를 선택할 수 있어요.
- *
- * @returns {Promise<void>} 화면 방향 설정이 완료되면 해결되는 Promise를 반환해요.
- *
- * @example
- * ### 화면 방향 설정하기
- *
- * ```tsx
- * import { Button } from 'react-native';
- * import { setDeviceOrientation } from '@apps-in-toss/framework';
- *
- * function SetDeviceOrientation() {
- *   return (
- *     <Button
- *       title="가로 모드로 변경"
- *       onPress={() => {
- *         setDeviceOrientation({ type: 'landscape' });
- *       }}
- *     />
- *   );
- * }
- * ```
- *
- * ### 화면 방향 복구하기
- * 특정 화면을 벗어날 때 이전 상태로 복구하려면 다음과 같이 `useEffect`를 사용하세요.
- *
- * ```tsx
- * import { useEffect } from 'react';
- * import { setDeviceOrientation } from '@apps-in-toss/framework';
- *
- * function VideoScreen() {
- *   useEffect(() => {
- *     setDeviceOrientation({ type: 'landscape' });
- *
- *     return () => {
- *       setDeviceOrientation({ type: 'portrait' }); // 설정을 이전 상태로 복구해요.
- *     };
- *   }, []);
- *
- *   return <Text>동영상을 감상하는 화면</Text>;
- * }
- * ```
- */
-declare function setDeviceOrientation(options: {
-    type: 'portrait' | 'landscape';
-}): Promise<void>;
-
-/**
- * @public
- * @category 저장소
- * @name getItem
- * @description 모바일 앱의 로컬 저장소에서 문자열 데이터를 가져와요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
- * @param {string} key - 가져올 아이템의 키를 입력해요.
- * @returns {Promise<string | null>} 지정한 키에 저장된 문자열 값을 반환해요. 값이 없으면 `null`을 반환해요.
- * @example
- *
- * ### `my-key`에 저장된 아이템 가져오기
- * ```ts
- * const value = await Storage.getItem('my-key');
- * console.log(value); // 'value'
- * ```
- */
-declare function getItem(key: string): Promise<string | null>;
-/**
- * @public
- * @category 저장소
- * @name setItem
- * @description 모바일 앱의 로컬 저장소에 문자열 데이터를 저장해요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
- * @param {string} key - 저장할 아이템의 키를 입력해요.
- * @param {string} value - 저장할 아이템의 값을 입력해요.
- * @returns {Promise<void>} 아이템을 성공적으로 저장하면 아무 값도 반환하지 않아요.
- * @example
- *
- * ### `my-key`에 아이템 저장하기
- * ```ts
- * import { Storage } from '@apps-in-toss/framework';
- *
- * await Storage.setItem('my-key', 'value');
- * ```
- */
-declare function setItem(key: string, value: string): Promise<void>;
-/**
- * @public
- * @category 저장소
- * @name removeItem
- * @description 모바일 앱의 로컬 저장소에서 특정 키에 해당하는 아이템을 삭제해요.
- * @param {string} key - 삭제할 아이템의 키를 입력해요.
- * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않아요.
- * @example
- *
- * ### `my-key`에 저장된 아이템 삭제하기
- * ```ts
- * import { Storage } from '@apps-in-toss/framework';
- *
- * await Storage.removeItem('my-key');
- * ```
- */
-declare function removeItem(key: string): Promise<void>;
-/**
- * @public
- * @category 저장소
- * @name clearItems
- * @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
- * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
- * @example
- *
- * ### 저장소 초기화하기
- * ```ts
- * import { Storage } from '@apps-in-toss/framework';
- *
- * await Storage.clearItems();
- * ```
- */
-declare function clearItems(): Promise<void>;
-/**
- * @public
- * @category 저장소
- * @name Storage
- * @description 네이티브의 저장소를 사용해요.
- * @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem.html)을 참고하세요.
- * @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem.html)을 참고하셰요.
- * @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem.html)을 참고하세요.
- * @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems.html)을 참고하세요.
- */
-declare const Storage: {
-    getItem: typeof getItem;
-    setItem: typeof setItem;
-    removeItem: typeof removeItem;
-    clearItems: typeof clearItems;
-};
-
-/**
- * @category 게임센터
- * @name GameCenterGameProfileResponse
- * @description 토스게임센터 프로필을 가져온 결과 타입이에요.
- * 앱에 프로필이 없는 경우, `statusCode`가 `'PROFILE_NOT_FOUND'`이고 다른 정보는 없어요.
- * 프로필이 있는 경우 `statusCode`가 `'SUCCESS'`이고, 닉네임과 프로필 이미지 주소가 함께 제공돼요.
- * @property {string} statusCode 프로필 조회 결과 상태예요. `'SUCCESS'` 또는 `'PROFILE_NOT_FOUND'` 중 하나예요.
- * @property {string} [nickname] 프로필 닉네임이에요. `statusCode`가 `'SUCCESS'`일 때만 있어요.
- * @property {string} [profileImageUri] 프로필 이미지 URL이에요. `statusCode`가 `'SUCCESS'`일 때만 있어요.
- */
-type GameCenterGameProfileResponse = {
-    statusCode: 'PROFILE_NOT_FOUND';
-} | {
-    statusCode: 'SUCCESS';
-    nickname: string;
-    profileImageUri: string;
-};
-/**
- * @category 게임센터
- * @name getGameCenterGameProfile
- * @description 토스게임센터 프로필 정보를 가져와요.
- * 사용자가 프로필을 만들지 않았다면 `statusCode`가 `'PROFILE_NOT_FOUND'`인 응답이 반환돼요.
- * 앱 버전이 최소 지원 버전(안드로이드 5.221.0, iOS 5.221.0)보다 낮으면 `undefined`를 반환해요.
- * @returns {Promise<GameCenterGameProfileResponse | undefined>} 프로필 정보 또는 `undefined`를 반환해요.
- *
- * @example
- * ### 게임센터 프로필 가져오기
- * ```tsx
- * import { getGameCenterGameProfile } from './getGameCenterGameProfile';
- * import { useState } from 'react';
- * import { View, Button } from 'react-native';
- *
- * function GameProfile() {
- *   const [profile, setProfile] = useState<GameCenterGameProfileResponse | null>(null);
- *
- *   const handlePress = async () => {
- *     try {
- *       const result = await getGameCenterGameProfile();
- *       if (result) {
- *         setProfile(result);
- *       }
- *     } catch (error) {
- *       console.error('게임센터 프로필 가져오기에 실패했어요.', error);
- *     }
- *   };
- *
- *   return (
- *     <View>
- *       <Button title="게임센터 프로필 가져오기" onPress={handlePress} />
- *     </View>
- *   );
- * }
- * ```
- */
-declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;
-
-/**
- * @public
- * @category 게임센터
- * @name SubmitGameCenterLeaderBoardScoreResponse
- * @description
- * 토스게임센터 리더보드에 점수를 제출한 결과 정보를 담아서 반환해요. 반환된 정보를 사용해서 점수 제출 결과에 따라 적절한 에러 처리를 할 수 있어요.
- * @property {'SUCCESS' | 'LEADERBOARD_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'UNPARSABLE_SCORE'} statusCode
- * 점수 제출 결과를 나타내는 상태 코드예요.
- * - `'SUCCESS'`: 점수 제출이 성공했어요.
- * - `'LEADERBOARD_NOT_FOUND'`: `gameId`에 해당하는 리더보드를 찾을 수 없어요.
- * - `'PROFILE_NOT_FOUND'`: 사용자의 프로필이 없어요.
- * - `'UNPARSABLE_SCORE'`: 점수를 해석할 수 없어요. 점수는 실수(float) 형태의 문자열로 전달해야 해요.
- */
-interface SubmitGameCenterLeaderBoardScoreResponse {
-    statusCode: 'SUCCESS' | 'LEADERBOARD_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'UNPARSABLE_SCORE';
-}
-/**
- * @public
- * @category 게임센터
- * @name submitGameCenterLeaderBoardScore
- * @description
- * 사용자의 게임 점수를 토스게임센터 리더보드에 제출해요. 이 기능으로 사용자의 점수를 공식 리더보드에 기록하고 다른 사용자와 비교할 수 있어요.
- * @param {string} params.score
- * 제출할 게임 점수예요. 실수 형태의 숫자를 문자열로 전달해야 해요. 예를들어 `"123.45"` 또는 `"9999"` 예요.
- * @returns {Promise<SubmitGameCenterLeaderBoardScoreResponse | undefined>}
- * 점수 제출 결과를 반환해요. 앱 버전이 최소 지원 버전보다 낮으면 아무 동작도 하지 않고 `undefined`를 반환해요.
- *
- * @example
- * ### 게임 점수를 토스게임센터 리더보드에 제출하기
- * ```tsx
- * import { Button } from 'react-native';
- * import { submitGameCenterLeaderBoardScore } from '@apps-in-toss/framework';
- *
- * function GameCenterLeaderBoardScoreSubmitButton() {
- *   async function handlePress() {
- *     try {
- *       const result = await submitGameCenterLeaderBoardScore({ score: '123.45' });
- *
- *       if (!result) {
- *         console.warn('지원하지 않는 앱 버전이에요.');
- *         return;
- *       }
- *
- *       if (result.statusCode === 'SUCCESS') {
- *         console.log('점수 제출 성공!');
- *       } else {
- *         console.error('점수 제출 실패:', result.statusCode);
- *       }
- *     } catch (error) {
- *       console.error('점수 제출 중 오류가 발생했어요.', error);
- *     }
- *   }
- *
- *   return (
- *     <Button onPress={handlePress}>점수 제출하기</Button>
- *   );
- * }
- * ```
- */
-declare function submitGameCenterLeaderBoardScore(params: {
-    score: string;
-}): Promise<SubmitGameCenterLeaderBoardScoreResponse | undefined>;
-
-/**
- * @public
- * @category 친구초대
- * @name RewardFromContactsViralEvent
- * @description 친구에게 공유하기를 완료했을 때 지급할 리워드 정보를 담는 타입이에요. 이 타입을 사용하면 공유가 완료됐을 때 지급할 리워드 정보를 확인할 수 있어요.
- * @property {'sendViral'} type - 이벤트의 타입이에요. `'sendViral'`은 사용자가 친구에게 공유를 완료했을 때 돌아와요.
- * @property {Object} data - 지급할 리워드 관련 정보를 담고 있어요.
- * @property {number} data.rewardAmount - 지급할 리워드 수량이에요. 앱인토스 콘솔에서 설정한 수량 및 금액 값이에요.
- * @property {string} data.rewardUnit - 리워드의 단위예요. 앱인토스 콘솔에 설정된 리워드 이름인 '하트', '보석' 등이 리워드 단위예요.
- */
-type RewardFromContactsViralEvent = {
-    type: 'sendViral';
-    data: {
-        rewardAmount: number;
-        rewardUnit: string;
-    };
-};
-/**
- * @public
- * @category 친구초대
- * @name SuccessEvent
- * @description 연락처 공유 모듈이 정상적으로 종료됐을 때 전달되는 이벤트 객체예요. 종료 이유와 함께 리워드 상태 및 남은 친구 수 등 관련 정보를 제공해요.
- * @property {'close'} type - 이벤트의 타입이에요. `'close'`는 공유 모듈이 종료됐을 때 돌아와요.
- * @property {Object} data - 모듈 종료와 관련된 세부 정보를 담고 있어요.
- * @property {'clickBackButton' | 'noReward'} data.closeReason - 모듈이 종료된 이유예요. `'clickBackButton'`은 사용자가 뒤로 가기 버튼을 눌러 종료한 경우이고, `'noReward'`는 받을 수 있는 리워드가 없어서 종료된 경우예요.
- * @property {number} data.sentRewardAmount - 사용자가 받은 전체 리워드 수량이에요.
- * @property {number} data.sendableRewardsCount - 아직 공유할 수 있는 친구 수예요.
- * @property {number} data.sentRewardsCount - 사용자가 공유를 완료한 친구 수예요.
- * @property {string} data.rewardUnit - 리워드의 단위예요. 앱인토스 콘솔에 설정된 리워드 이름인 '하트', '보석' 등이 리워드 단위예요.
- */
-type ContactsViralSuccessEvent = {
-    type: 'close';
-    data: {
-        closeReason: 'clickBackButton' | 'noReward';
-        sentRewardAmount?: number;
-        sendableRewardsCount?: number;
-        sentRewardsCount: number;
-        rewardUnit?: string;
-    };
-};
-type ContactsViralEvent = RewardFromContactsViralEvent | ContactsViralSuccessEvent;
-/**
- * @public
- * @category 친구초대
- * @name ContactsViralOption
- * @description [연락처 공유 기능](/bedrock/reference/framework/친구초대/contactsViral.html)을 사용할 때 필요한 옵션이에요.
- * @property {string} moduleId - 공유 리워드를 구분하는 UUID 형식의 고유 ID예요. 앱인토스 콘솔의 미니앱 > 공유 리워드 메뉴에서 확인할 수 있어요.
- */
-type ContactsViralOption = {
-    moduleId: string;
-};
-/**
- * @public
- * @category 친구초대
- * @description `ContactsViralParams`는 연락처 공유 기능을 사용할 때 전달해야 하는 파라미터 타입이에요. 옵션을 설정하고, 이벤트 및 에러 처리 콜백을 지정할 수 있어요.
- * @property {ContactsViralOption} options - 공유 기능에 사용할 옵션 객체예요.
- * @property {(event: ContactsViralEvent) => void} onEvent - 공유 이벤트가 발생했을 때 실행되는 함수예요. [`RewardFromContactsViralEvent`](/bedrock/reference/framework/친구초대/RewardFromContactsViralEvent.html) 또는 [`ContactsViralSuccessEvent`](/bedrock/reference/framework/친구초대/ContactsViralSuccessEvent.html) 타입의 이벤트 객체가 전달돼요.
- * @property {(error: unknown) => void} onError - 예기치 않은 에러가 발생했을 때 실행되는 함수예요.
- */
-interface ContactsViralParams {
-    options: ContactsViralOption;
-    onEvent: (event: ContactsViralEvent) => void;
-    onError: (error: unknown) => void;
-}
-/**
- * @public
- * @category 친구초대
- * @name contactsViral
- * @description 친구에게 공유하고 리워드를 받을 수 있는 기능을 제공해요. 사용자가 친구에게 공유를 완료하면 앱브릿지가 이벤트를 통해 리워드 정보를 전달해요.
- * @param {ContactsViralParams} params - 연락처 공유 기능을 실행할 때 사용하는 파라미터예요. 옵션 설정과 이벤트 핸들러를 포함해요. 자세한 내용은 [ContactsViralParams](/bedrock/reference/framework/친구초대/ContactsViralParams.html) 문서를 참고하세요.
- * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 공유 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
- *
- * @example
- * ### 친구에게 공유하고 리워드 받기
- *
- * ```tsx
- * import { useCallback } from 'react';
- * import { Button } from 'react-native';
- * import { contactsViral } from '@apps-in-toss/framework';
- *
- * function ContactsViralButton({ moduleId }: { moduleId: string }) {
- *   const handleContactsViral = useCallback(() => {
- *     try {
- *       const cleanup = contactsViral({
- *         options: { moduleId: moduleId.trim() },
- *         onEvent: (event) => {
- *           if (event.type === 'sendViral') {
- *             console.log('리워드 지급:', event.data.rewardAmount, event.data.rewardUnit);
- *           } else if (event.type === 'close') {
- *             console.log('모듈 종료:', event.data.closeReason);
- *           }
- *         },
- *         onError: (error) => {
- *           console.error('에러 발생:', error);
- *         },
- *       });
- *
- *       return cleanup;
- *     } catch (error) {
- *       console.error('실행 중 에러:', error);
- *     }
- *   }, [moduleId]);
- *
- *   return <Button title="친구에게 공유하고 리워드 받기" onPress={handleContactsViral} />;
- * }
- * ```
- */
-declare function contactsViral(params: ContactsViralParams): () => void;
-
-/**
- * @public
- * @category 토스페이
- * @name TossPay
- * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
- * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
- */
-declare const TossPay: {
-    checkoutPayment: typeof checkoutPayment;
-};
-/**
- * @public
- * @category 광고
- * @name GoogleAdMob
- * @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
- * @property {typeof loadAdMobInterstitialAd} [loadAdMobInterstitialAd] 전면 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobInterstitialAd](/react-native/reference/framework/광고/loadAdMobInterstitialAd.html)를 참고하세요.
- * @property {typeof showAdMobInterstitialAd} [showAdMobInterstitialAd] 로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobInterstitialAd](/react-native/reference/framework/광고/showAdMobInterstitialAd.html)를 참고하세요.
- * @property {typeof loadAdMobRewardedAd} [loadAdMobRewardedAd] 보상형 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobRewardedAd](/react-native/reference/framework/광고/loadAdMobRewardedAd.html)를 참고하세요.
- * @property {typeof showAdMobRewardedAd} [showAdMobRewardedAd] 로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobRewardedAd](/react-native/reference/framework/광고/showAdMobRewardedAd.html)를 참고하세요.
- */
-declare const GoogleAdMob: {
-    loadAdMobInterstitialAd: typeof loadAdMobInterstitialAd;
-    showAdMobInterstitialAd: typeof showAdMobInterstitialAd;
-    loadAdMobRewardedAd: typeof loadAdMobRewardedAd;
-    showAdMobRewardedAd: typeof showAdMobRewardedAd;
-};
-
 type GameWebViewProps$1 = WebViewProps$1;
 
 type WebViewProps = PartnerWebViewProps | ExternalWebViewProps | GameWebViewProps;
@@ -2255,7 +56,7 @@ declare function useCreateUserAgent({ batteryModePreference, colorPreference, lo
     safeAreaBottomTransparency?: string;
 }): string;
 
-type UseGeolocationOptions = Omit<StartUpdateLocationOptions$1, 'callback'>;
+type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
 /**
  * @public
  * @category 위치 정보
@@ -2305,69 +106,6 @@ declare const env: {
     getDeploymentId: () => string | undefined;
 };
 
-declare class EntryMessageExitedEvent extends BedrockEventDefinition<undefined, undefined> {
-    name: "entryMessageExited";
-    remove(): void;
-    listener(_: undefined): void;
-}
-
-interface StartUpdateLocationOptions {
-    /**
-     * 위치 정확도를 설정해요.
-     */
-    accuracy: Accuracy;
-    /**
-     * 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
-     */
-    timeInterval: number;
-    /**
-     * 위치 변경 거리를 미터(m) 단위로 설정해요.
-     */
-    distanceInterval: number;
-}
-declare class UpdateLocationEvent extends BedrockEventDefinition<StartUpdateLocationOptions, Location> {
-    name: "updateLocationEvent";
-    subscriptionCount: number;
-    ref: {
-        remove: () => void;
-    };
-    remove(): void;
-    listener(options: StartUpdateLocationOptions, onEvent: (response: Location) => void, onError: (error: unknown) => void): void;
-}
-
-interface AppBridgeCallbackResult {
-    name: string;
-    params?: any;
-}
-declare class AppBridgeCallbackEvent extends BedrockEventDefinition<void, AppBridgeCallbackResult> {
-    private static INTERNAL__appBridgeSubscription?;
-    name: "appBridgeCallbackEvent";
-    constructor();
-    remove(): void;
-    listener(): void;
-    private registerAppBridgeCallbackEventListener;
-    private ensureInvokeAppBridgeCallback;
-}
-
-interface VisibilityChangedByTransparentServiceWebOptions {
-    callbackId: string;
-}
-declare class VisibilityChangedByTransparentServiceWebEvent extends BedrockEventDefinition<VisibilityChangedByTransparentServiceWebOptions, boolean> {
-    name: "onVisibilityChangedByTransparentServiceWeb";
-    subscription: EmitterSubscription | null;
-    remove(): void;
-    listener(options: VisibilityChangedByTransparentServiceWebOptions, onEvent: (isVisible: boolean) => void, onError: (error: unknown) => void): void;
-    private isVisibilityChangedByTransparentServiceWebResult;
-}
-
-declare const appsInTossEvent: BedrockEvent<EntryMessageExitedEvent | VisibilityChangedByTransparentServiceWebEvent | UpdateLocationEvent | AppBridgeCallbackEvent>;
-
-declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
-    options: VisibilityChangedByTransparentServiceWebOptions;
-    onEvent: (isVisible: boolean) => void;
-    onError: (error: unknown) => void;
-}): () => void;
-
 declare const INTERNAL__onVisibilityChangedByTransparentServiceWeb: typeof onVisibilityChangedByTransparentServiceWeb;
 
 declare const Analytics: {
@@ -2377,4 +115,4 @@ declare const Analytics: {
     Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
 };
 
-export { Accuracy, Analytics, AppsInToss, type ContactEntity, type ContactsViralParams, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameCenterGameProfileResponse, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, IAP, INTERNAL__onVisibilityChangedByTransparentServiceWeb, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type SaveBase64DataParams, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, contactsViral, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, openGameCenterLeaderboard, saveBase64Data, setClipboardText, setDeviceOrientation, startUpdateLocation, submitGameCenterLeaderBoardScore, useCreateUserAgent, useGeolocation };
+export { Analytics, AppsInToss, type ExternalWebViewProps, type GameWebViewProps, INTERNAL__onVisibilityChangedByTransparentServiceWeb, type PartnerWebViewProps, type UseGeolocationOptions, WebView, type WebViewProps, env, useCreateUserAgent, useGeolocation };