@apps-in-toss/web-framework 0.0.8 → 0.0.10

package/dist/fetchAlbumPhotos.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+export interface ImageResponse {
+	/** 가져온 사진의 고유 ID예요. */
+	id: string;
+	/** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+	dataUri: string;
+}
+/**
+ * 앨범 사진을 조회할 때 사용하는 옵션 타입이에요.
+ */
+export interface FetchAlbumPhotosOptions {
+	/** 가져올 사진의 최대 개수를 설정해요. 숫자를 입력하고 기본값은 10이에요. */
+	maxCount?: number;
+	/** 사진의 최대 폭을 제한해요. 단위는 픽셀이고 기본값은 1024이에요. */
+	maxWidth?: number;
+	/** 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요. */
+	base64?: boolean;
+}
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name fetchAlbumPhotos
+ * @description
+ * 사용자의 앨범에서 사진 목록을 불러오는 함수예요.
+ * 최대 개수와 해상도를 설정할 수 있고 갤러리 미리보기, 이미지 선택 기능 등에 활용할 수 있어요.
+ *
+ * @param options - 조회 옵션을 담은 객체예요.
+ * @param {number} [options.maxCount=10] 가져올 사진의 최대 개수를 설정해요. 숫자로 입력하며 기본값은 10이에요.
+ * @param {number} [options.maxWidth=1024] 사진의 최대 폭을 제한해요. 단위는 픽셀이며 기본값은 `1024`이에요.
+ * @param {boolean} [options.base64=false] 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요.
+ * @returns {Promise<AlbumResponse[]>}
+ * 앨범 사진의 고유 ID와 데이터 URI를 포함한 배열을 반환해요.
+ *
+ * @example
+ * ### 사진의 최대 폭을 360px로 제한하여 가져오기
+ *
+ * ```tsx
+ * import React, { useState } from 'react';
+ * 
+ * import { fetchAlbumPhotos } from '@apps-in-toss/web-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 (
+ *     <div>
+ *       {albumPhotos.map((image) => (
+ *         <img src={`data:image/jpeg;base64,${image.dataUri}`} key={image.id} />
+ *       ))}
+ *       <input type="button" value="앨범 가져오기" onClick={handlePress} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function fetchAlbumPhotos(options: FetchAlbumPhotosOptions): Promise<ImageResponse[]>;
+
+export {};

package/dist/fetchContacts.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 연락처 정보를 나타내는 타입이에요.
+ */
+export 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 { fetchContacts } from '@apps-in-toss/web-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 (
+ *     <div>
+ *       {contacts.result.map((contact, index) => (
+ *         <span key={index}>{contact.name}: {contact.phoneNumber}</span>
+ *       ))}
+ *       <input type="button"
+ *         value={contacts.done ? '모든 연락처를 가져왔어요.' : '다음 연락처 가져오기'}
+ *         disabled={contacts.done}
+ *         onClick={handlePress}
+ *       />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function fetchContacts({ size, offset, query, }: {
+	size: number;
+	offset: number;
+	query?: {
+		contains?: string;
+	};
+}): Promise<{
+	result: ContactEntity[];
+	nextOffset: number | null;
+	done: boolean;
+}>;
+
+export {};

package/dist/generateHapticFeedback.d.ts

@@ -0,0 +1,52 @@
+export type HapticFeedbackType = "tickWeak" | "tap" | "tickMedium" | "softMedium" | "basicWeak" | "basicMedium" | "success" | "error" | "wiggle" | "confetti";
+/**
+* @public
+* @tag HapticFeedbackType
+* @category Types
+* @name HapticFeedbackOptions
+* @description
+* generateHapticFeedback 함수에 전달할 햅틱진동의 타입을 나타내요. 진동타입의 종류는 다음과 같아요.
+* ```typescript
+* type HapticFeedbackType =
+* | "tickWeak"
+* | "tap"
+* | "tickMedium"
+* | "softMedium"
+* | "basicWeak"
+* | "basicMedium"
+* | "success"
+* | "error"
+* | "wiggle"
+* | "confetti";
+* ```
+* @typedef { type: HapticFeedbackType } HapticFeedbackOptions
+* @typedef { "tickWeak" | "tap" | "tickMedium" | "softMedium" | "basicWeak" | "basicMedium" | "success" | "error" | "wiggle" | "confetti" } HapticFeedbackType
+*
+*/
+export interface HapticFeedbackOptions {
+	type: HapticFeedbackType;
+}
+/**
+ * @public
+ * @tag BedrockModule
+ * @category BedrockModules
+ * @kind function
+ * @name generateHapticFeedback
+ * @description 디바이스에 햅틱 진동을 일으키는 함수예요. 예를 들어, 버튼 터치나 화면전환에 드라마틱한 효과를 주고 싶을 때 사용할 수 있어요. [HapticFeedbackOptions](../Types/HapticFeedbackOptions.html)에서 진동타입을 확인해 보세요.
+ * @returns {void}
+ *
+ * @example
+ * ### 버튼을 눌러 햅틱 일으키기
+ *
+ * ```tsx
+ * 
+ * import { generateHapticFeedback } from '@apps-in-toss/web-framework';
+ *
+ * function GenerateHapticFeedback() {
+ *  return <input type="button" value="햅틱" onClick={() => { generateHapticFeedback( { type: "tickWeak"}) }} />;
+ * }
+ * ```
+ */
+export declare function generateHapticFeedback(options: HapticFeedbackOptions): Promise<void>;
+
+export {};

package/dist/getClipboardText.d.ts

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

package/dist/getCurrentLocation.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 위치 정확도 옵션이에요.
+ */
+export enum Accuracy {
+	/**
+	 * 오차범위 3KM 이내
+	 */
+	Lowest = 1,
+	/**
+	 * 오차범위 1KM 이내
+	 */
+	Low,
+	/**
+	 * 오차범위 몇 백미터 이내
+	 */
+	Balanced,
+	/**
+	 * 오차범위 10M 이내
+	 */
+	High,
+	/**
+	 * 가장 높은 정확도
+	 */
+	Highest,
+	/**
+	 * 네비게이션을 위한 최고 정확도
+	 */
+	BestForNavigation
+}
+export 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; // 방향 (북: 0°, 동: 90°, 남: 180°, 서: 270°)
+	};
+}
+export 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 { getCurrentLocation } from '@apps-in-toss/web-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 (
+ *     <div>
+ *       {position ? (
+ *         <span>위치: {position.coords.latitude}, {position.coords.longitude}</span>
+ *       ) : (
+ *         <span>위치 정보를 아직 가져오지 않았어요</span>
+ *       )}
+ *       <input type="button" value="현재 위치 정보 가져오기" onClick={handlePress} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function getCurrentLocation(options: GetCurrentLocationOptions): Promise<Location>;
+
+export {};

package/dist/getDeviceId.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @public
+ * @tag BedrockModule
+ * @category BedrockModules
+ * @kind function
+ * @name getDeviceId
+ * @description
+ * 사용 중인 기기의 고유 식별자를 문자열로 반환해요.
+ *
+ * 이 함수는 현재 사용 중인 기기의 고유 식별자를 문자열로 반환해요. 기기별로 설정이나 데이터를 저장하거나 사용자의 기기를 식별해서 로그를 기록하고 분석하는 데 사용할 수 있어요. 같은 사용자의 여러 기기를 구분하는 데도 유용해요.
+ *
+ * @returns {string} 기기의 고유 식별자를 나타내는 문자열이에요.
+ *
+ * @example
+ * ### 기기 고유 식별자 가져오기
+ *
+ * ```tsx
+ * import { getDeviceId } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * function MyPage() {
+ *   const id = getDeviceId();
+ *
+ *   return (
+ *     <span>사용자의 기기 고유 식별자: {id}</span>
+ *   );
+ * }
+ * ```
+ */
+export declare function getDeviceId(): string;
+
+export {};

package/dist/getLocale.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @public
+ * @tag BedrockModule
+ * @category BedrockModules
+ * @kind function
+ * @name getLocale
+ * @description
+ * 사용자의 로케일(locale) 정보를 반환해요. 네이티브 모듈에서 로케일 정보를 가져올 수 없을 때는 기본값으로 'ko-KR'을 반환합니다. 앱의 현지화 및 언어 설정과 관련된 기능을 구현할 때 사용하세요.
+ *
+ * @returns {string} 사용자의 로케일 정보를 반환해요.
+ *
+ * @example
+ * ### 현재 사용자의 로케일 정보 가져오기
+ *
+ * ```tsx
+ * import { getLocale } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * function MyPage() {
+ *  const locale = getLocale();
+ *
+ *  return (
+ *    <span>사용자의 로케일 정보: {locale}</span>
+ *  )
+ * }
+ *
+ * ```
+ */
+export declare function getLocale(): string;
+
+export {};

package/dist/getNetworkStatus.d.ts

@@ -0,0 +1,55 @@
+export type NetworkStatus = "OFFLINE" | "WIFI" | "2G" | "3G" | "4G" | "5G" | "WWAN" | "UNKNOWN";
+/**
+ * @public
+ * @tag BedrockModule
+ * @category BedrockModules
+ * @kind function
+ * @name getNetworkStatus
+ * @description
+ * 디바이스의 현재 네트워크 연결 상태를 가져오는 함수예요.
+ * 반환 값은 `NetworkStatus` 타입으로, 인터넷 연결 여부와 연결 유형(Wi-Fi, 모바일 데이터 등)을 나타내요. 값은 다음 중 하나예요.
+ *
+ * - `OFFLINE`: 인터넷에 연결되지 않은 상태예요.
+ * - `WIFI`: Wi-Fi에 연결된 상태예요.
+ * - `2G`: 2G 네트워크에 연결된 상태예요.
+ * - `3G`: 3G 네트워크에 연결된 상태예요.
+ * - `4G`: 4G 네트워크에 연결된 상태예요.
+ * - `5G`: 5G 네트워크에 연결된 상태예요.
+ * - `WWAN`: 인터넷은 연결되었지만, 연결 유형(Wi-Fi, 2G~5G)을 알 수 없는 상태예요. 이 상태는 iOS에서만 확인할 수 있어요.
+ * - `UNKNOWN`: 인터넷 연결 상태를 알 수 없는 상태예요. 이 상태는 안드로이드에서만 확인할 수 있어요.
+ *
+ * @returns {Promise<NetworkStatus>} 네트워크 상태를 반환해요.
+ *
+ * @example
+ * ### 현재 네트워크 상태 가져오기
+ *
+ * 네트워크 연결 상태를 가져와 화면에 표시하는 예제예요.
+ *
+ * ```tsx
+ * import { useState, useEffect } from 'react';
+ * 
+ * import { getNetworkStatus, NetworkStatus } from '@apps-in-toss/web-framework';
+ *
+ * function GetNetworkStatus() {
+ *   const [status, setStatus] = useState<NetworkStatus | ''>('');
+ *
+ *   useEffect(() => {
+ *     async function fetchStatus() {
+ *       const networkStatus = await getNetworkStatus();
+ *       setStatus(networkStatus);
+ *     }
+ *
+ *     fetchStatus();
+ *   }, []);
+ *
+ *   return (
+ *     <div>
+ *       <span>현재 네트워크 상태: {status}</span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function getNetworkStatus(): Promise<NetworkStatus>;
+
+export {};

package/dist/getSchemeUri.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @public
+ * @name getSchemeUri
+ * @tag BedrockModule
+ * @category BedrockModules
+ * @kind function
+ * @description 처음에 화면에 진입한 스킴 값이에요. 페이지 이동으로 인한 URI 변경은 반영되지 않아요.
+ * @returns {string} 처음에 화면에 진입한 스킴 값을 반환해요.
+ *
+ * @example
+ * ### 처음 진입한 스킴 값 가져오기
+ *
+ * ```tsx
+ * import { getSchemeUri } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * function MyPage() {
+ *  const schemeUri = getSchemeUri();
+ *
+ *  return <span>처음에 화면에 진입한 스킴 값: {schemeUri}</span>
+ * }
+ * ```
+ */
+export declare function getSchemeUri(): string;
+
+export {};

package/dist/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './closeView';
+export * from './generateHapticFeedback';
+export * from './share';
+export * from './setSecureScreen';
+export * from './setScreenAwakeMode';
+export * from './getNetworkStatus';
+export * from './getLocale';
+export * from './getSchemeUri';
+export * from './getDeviceId';
+export * from './setClipboardText';
+export * from './getClipboardText';
+export * from './fetchContacts';
+export * from './fetchAlbumPhotos';
+export * from './getCurrentLocation';
+export * from './openCamera';
+export * from './startUpdateLocation';

package/dist/index.js

@@ -0,0 +1 @@
+export const createEvents=()=>({emit(event,args){for(let callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on(event,cb){var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return()=>{var _this_events_event;this.events[event]=(_this_events_event=this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(i=>cb!==i)}}});const createEventId=()=>Math.random().toString(36).substring(2,15);const deserializeError=value=>{if(value&&value.__isError){const err=new Error(value.message);err.name=value.name;err.stack=value.stack;return err}return value};window.__BEDROCK_NATIVE_EMITTER=createEvents();export function closeView(...args){if(!window.ReactNativeWebView){throw new Error("This closeView is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`closeView/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`closeView/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"closeView",eventId,args}))})}export function generateHapticFeedback(...args){if(!window.ReactNativeWebView){throw new Error("This generateHapticFeedback is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`generateHapticFeedback/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`generateHapticFeedback/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"generateHapticFeedback",eventId,args}))})}export function share(...args){if(!window.ReactNativeWebView){throw new Error("This share is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`share/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`share/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"share",eventId,args}))})}export function setSecureScreen(...args){if(!window.ReactNativeWebView){throw new Error("This setSecureScreen is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setSecureScreen/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setSecureScreen/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setSecureScreen",eventId,args}))})}export function setScreenAwakeMode(...args){if(!window.ReactNativeWebView){throw new Error("This setScreenAwakeMode is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setScreenAwakeMode/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setScreenAwakeMode/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setScreenAwakeMode",eventId,args}))})}export function getNetworkStatus(...args){if(!window.ReactNativeWebView){throw new Error("This getNetworkStatus is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getNetworkStatus/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getNetworkStatus/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"getNetworkStatus",eventId,args}))})}export function getLocale(){if(!window.ReactNativeWebView){throw new Error("This getLocale is not available in browser environment")}if("getLocale"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getLocale"]}throw new Error("getLocale is not a constant handler")}export function getSchemeUri(){if(!window.ReactNativeWebView){throw new Error("This getSchemeUri is not available in browser environment")}if("getSchemeUri"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getSchemeUri"]}throw new Error("getSchemeUri is not a constant handler")}export function getDeviceId(){if(!window.ReactNativeWebView){throw new Error("This getDeviceId is not available in browser environment")}if("getDeviceId"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getDeviceId"]}throw new Error("getDeviceId is not a constant handler")}export function setClipboardText(...args){if(!window.ReactNativeWebView){throw new Error("This setClipboardText is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setClipboardText/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setClipboardText/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setClipboardText",eventId,args}))})}export function getClipboardText(...args){if(!window.ReactNativeWebView){throw new Error("This getClipboardText is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getClipboardText/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getClipboardText/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"getClipboardText",eventId,args}))})}export function fetchContacts(...args){if(!window.ReactNativeWebView){throw new Error("This fetchContacts is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchContacts/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchContacts/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"fetchContacts",eventId,args}))})}export function fetchAlbumPhotos(...args){if(!window.ReactNativeWebView){throw new Error("This fetchAlbumPhotos is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchAlbumPhotos/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`fetchAlbumPhotos/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"fetchAlbumPhotos",eventId,args}))})}export var Accuracy=function(Accuracy){Accuracy[Accuracy["Lowest"]=1]="Lowest";Accuracy[Accuracy["Low"]=2]="Low";Accuracy[Accuracy["Balanced"]=3]="Balanced";Accuracy[Accuracy["High"]=4]="High";Accuracy[Accuracy["Highest"]=5]="Highest";Accuracy[Accuracy["BestForNavigation"]=6]="BestForNavigation";return Accuracy}({});export function getCurrentLocation(...args){if(!window.ReactNativeWebView){throw new Error("This getCurrentLocation is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getCurrentLocation/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`getCurrentLocation/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"getCurrentLocation",eventId,args}))})}export function openCamera(...args){if(!window.ReactNativeWebView){throw new Error("This openCamera is not available in browser environment")}const eventId=createEventId();const emitters=[];const unsubscribe=()=>{for(const emitter of emitters){emitter()}};return new Promise((resolve,reject)=>{emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`openCamera/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`openCamera/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"openCamera",eventId,args}))})}export function startUpdateLocation({onEvent,onError,options}){if(!window.ReactNativeWebView){onError(new Error("This startUpdateLocation is not available in browser environment"));return()=>{}}const eventId=createEventId();const removes=[window.__BEDROCK_NATIVE_EMITTER.on(`startUpdateLocation/onEvent/${eventId}`,response=>{onEvent(response)}),window.__BEDROCK_NATIVE_EMITTER.on(`startUpdateLocation/onError/${eventId}`,error=>{onError(deserializeError(error))})];window.ReactNativeWebView.postMessage(JSON.stringify({type:"addEventListener",functionName:"startUpdateLocation",eventId,args:options}));return()=>{window.ReactNativeWebView.postMessage(JSON.stringify({type:"removeEventListener",functionName:"startUpdateLocation",eventId}));for(const remove of removes){remove()}}}

package/dist/openCamera.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 사진 조회 결과를 나타내는 타입이에요.
+ */
+export interface ImageResponse {
+	/** 가져온 사진의 고유 ID예요. */
+	id: string;
+	/** 사진의 데이터 URI예요. `base64` 옵션이 `true`인 경우 Base64 문자열로 반환돼요. */
+	dataUri: string;
+}
+export 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 { openCamera } from '@apps-in-toss/web-framework';
+ *
+ * // 카메라를 실행하고 촬영된 이미지를 화면에 표시하는 컴포넌트
+ * function Camera() {
+ *   const [image, setImage] = useState(null);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const response = await openCamera({ base64: true });
+ *       setImage(response);
+ *     } catch (error) {
+ *       console.error('사진을 가져오는 데 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {image ? (
+ *         <img src={`data:image/jpeg;base64,${image.dataUri}`} style={{ width: 200, height: 200 }} />
+ *       ) : (
+ *         <span>사진이 없어요</span>
+ *       )}
+ *       <input type="button" value="사진 촬영하기" onClick={handlePress} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
+
+export {};