@apps-in-toss/web-framework 0.0.0-dev.1743135526084 → 0.0.0-dev.1744801739343

package/dist/prebuilt/prod.json

@@ -1,14 +1,14 @@
 [
   {
     "platform": "ios",
-    "totalModuleCount": 1602,
-    "duration": 1035.676083,
-    "size": 409089
+    "totalModuleCount": 1600,
+    "duration": 1026.3825829999998,
+    "size": 427594
   },
   {
     "platform": "android",
-    "totalModuleCount": 1602,
-    "duration": 1038.966791,
-    "size": 408290
+    "totalModuleCount": 1600,
+    "duration": 1015.0549169999997,
+    "size": 426973
   }
 ]

package/dist-web/bridge.d.ts

@@ -5,9 +5,9 @@ export * from './setSecureScreen';
 export * from './setScreenAwakeMode';
 export * from './getNetworkStatus';
 export * from './setIosSwipeGestureEnabled';
+export * from './openURL';
 export * from './getLocale';
 export * from './getSchemeUri';
-export * from './getDeviceId';
 export * from './getPlatformOS';
 export * from './setClipboardText';
 export * from './getClipboardText';
@@ -19,4 +19,6 @@ export * from './appLogin';
 export * from './checkoutPayment';
 export * from './executePayment';
 export * from './getOperationalEnvironment';
+export * from './getTossAppVersion';
+export * from './getDeviceId';
 export * from './startUpdateLocation';

package/dist-web/bridge.js

@@ -1 +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 setIosSwipeGestureEnabled(...args){if(!window.ReactNativeWebView){throw new Error("This setIosSwipeGestureEnabled 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(`setIosSwipeGestureEnabled/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`setIosSwipeGestureEnabled/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"setIosSwipeGestureEnabled",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 getPlatformOS(){if(!window.ReactNativeWebView){throw new Error("This getPlatformOS is not available in browser environment")}if("getPlatformOS"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getPlatformOS"]}throw new Error("getPlatformOS 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 appLogin(...args){if(!window.ReactNativeWebView){throw new Error("This appLogin 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(`appLogin/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`appLogin/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"appLogin",eventId,args}))})}export function checkoutPayment(...args){if(!window.ReactNativeWebView){throw new Error("This checkoutPayment 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(`checkoutPayment/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`checkoutPayment/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"checkoutPayment",eventId,args}))})}export function executePayment(...args){if(!window.ReactNativeWebView){throw new Error("This executePayment 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(`executePayment/resolve/${eventId}`,args=>{unsubscribe();resolve(args)}));emitters.push(window.__BEDROCK_NATIVE_EMITTER.on(`executePayment/reject/${eventId}`,error=>{unsubscribe();reject(deserializeError(error))}));window.ReactNativeWebView.postMessage(JSON.stringify({type:"method",functionName:"executePayment",eventId,args}))})}export function getOperationalEnvironment(){if(!window.ReactNativeWebView){throw new Error("This getOperationalEnvironment is not available in browser environment")}if("getOperationalEnvironment"in window.__CONSTANT_HANDLER_MAP){return window.__CONSTANT_HANDLER_MAP["getOperationalEnvironment"]}throw new Error("getOperationalEnvironment is not a constant handler")}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()}}}
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){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(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__BEDROCK_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var setClipboardText=createAsyncBridge("setClipboardText");export var getClipboardText=createAsyncBridge("getClipboardText");export var fetchContacts=createAsyncBridge("fetchContacts");export var fetchAlbumPhotos=createAsyncBridge("fetchAlbumPhotos");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 var getCurrentLocation=createAsyncBridge("getCurrentLocation");export var openCamera=createAsyncBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var executePayment=createAsyncBridge("executePayment");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var startUpdateLocation=createEventBridge("startUpdateLocation");

package/dist-web/executePayment.d.ts

@@ -236,7 +236,7 @@ export interface TossMoneyExecutePaymentResult {
  * @param {ExecutePaymentOptions} options 결제를 실행할 때 필요한 옵션이에요.
  * @param {string} options.orderNo 결제를 생성할 때 사용한 주문번호예요.
  * @param {string} options.payToken 결제 인증 과정에서 전달받은 결제 토큰이에요. 결제를 실행할 때 사용해요.
- * @returns {Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>} 결제 결과 객체를 반환해요. 자세한 내용은 [카드 결제 결과](reference/framework/토스페이/CardExecutePaymentResult.html) 또는 [토스머니 결제 결과](reference/framework/토스페이/TossMoneyExecutePaymentResult.html)를 참고하세요.
+ * @returns {Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>} 결제 결과 객체를 반환해요. 자세한 내용은 [카드 결제 결과](/react-native/reference/framework/토스페이/CardExecutePaymentResult.html) 또는 [토스머니 결제 결과](/react-native/reference/framework/토스페이/TossMoneyExecutePaymentResult.html)를 참고하세요.
  *
  * @example
  *

package/dist-web/generateHapticFeedback.d.ts

@@ -29,7 +29,7 @@ export interface HapticFeedbackOptions {
  * @public
  * @category 인터렉션
  * @name generateHapticFeedback
- * @description 디바이스에 햅틱 진동을 일으키는 함수예요. 예를 들어, 버튼 터치나 화면전환에 드라마틱한 효과를 주고 싶을 때 사용할 수 있어요. [HapticFeedbackOptions](/reference/@apps-in-toss/web-framework/인터렉션/HapticFeedbackOptions.html)에서 진동타입을 확인해 보세요.
+ * @description 디바이스에 햅틱 진동을 일으키는 함수예요. 예를 들어, 버튼 터치나 화면전환에 드라마틱한 효과를 주고 싶을 때 사용할 수 있어요. [HapticFeedbackOptions](/react-native/reference/@apps-in-toss/web-framework/인터렉션/HapticFeedbackOptions.html)에서 진동타입을 확인해 보세요.
  * @returns {void}
  *
  * @example

package/dist-web/getCurrentLocation.d.ts

@@ -51,7 +51,7 @@ export interface Location {
 	 */
 	timestamp: number;
 	/**
-	 * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/reference/framework/Types/LocationCoords.html)을 참고해주세요.
+	 * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/react-native/reference/framework/Types/LocationCoords.html)을 참고해주세요.
 	 */
 	coords: LocationCoords;
 }
@@ -103,7 +103,7 @@ export interface GetCurrentLocationOptions {
  *
  * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
  * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
- * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
+ * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 디바이스의 현재 위치 정보 가져오기

package/dist-web/getTossAppVersion.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @public
+ * @category 환경 확인
+ * @name getTossAppVersion
+ * @description 토스 앱 버전을 가져옵니다. 예를 들어, `5.206.0`과 같은 형태로 반환돼요. 토스 앱 버전을 로그로 남기거나, 특정 기능이 특정 버전 이상에서만 실행될 때 사용돼요.
+ * @signature
+ * ```typescript
+ * function getTossAppVersion(): string
+ * ```
+ *
+ * @returns {string} 토스 앱 버전
+ *
+ * @example
+ *
+ *
+ * ### 토스 앱 버전 확인하기
+ *
+ * ```tsx
+ * import { getTossAppVersion } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * export function TossAppVersionPage() {
+ *  return (
+ *   <span>{getTossAppVersion()}</span>
+ *  )
+ * }
+ * ```
+ */
+export declare function getTossAppVersion(): string;
+
+export {};

package/dist-web/index.d.ts

@@ -1,70 +1,104 @@
-export * from './bridge'
-/**
- * 비동기 브릿지 함수 생성
- * @param method 호출할 메서드 이름
- * @returns args를 받아 Promise를 반환하는 함수
- * @typeParam T: 인자로 전달할 데이터 타입
- * @typeParam R: resolve 시 반환될 데이터 타입 (기본 any)
- * @example
- * // 카메라 열기 브릿지 함수 생성
- * const openCamera = createAsyncBridge<{base64: boolean}, { dataUri: string }>('openCamera');
- *
- * // 사용 예시
- * async function takePicture() {
- *   try {
- *     const result = await openCamera();
- *     console.log('카메라로 찍은 이미지 URL:', result.dataUri);
- *   } catch (error) {
- *     console.error('카메라 오류:', error);
- *   }
- * }
- */
-declare function createAsyncBridge<T, R = any>(method: string): (args: T) => Promise<R>;
+export * from './bridge';
+export * from '@apps-in-toss/bridge-core';
 
 /**
- * 상수 브릿지 함수 생성
- * @param method 호출할 상수 핸들러 이름
- * @returns 상수 값을 반환하는 함수
- * @typeParam T: 상수 값의 타입
- * @example
- * // 디바이스 ID를 가져오는 상수 브릿지 생성
- * const getDeviceId = createConstantBridge<string>('getDeviceId');
- *
- * // 사용 예시
- * function displayDeviceInfo() {
- *   const deviceId = getDeviceId();
- *   console.log('디바이스 ID:', deviceId);
- * }
+ * @public
+ * @category 저장소
+ * @name Storage
+ * @description 네이티브의 저장소를 사용해요.
+ * @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem)을 참고하세요.
+ * @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem)을 참고하세요.
+ * @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem)을 참고하세요.
+ * @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems)을 참고하세요.
  */
-declare function createConstantBridge<T>(method: string): () => T;
+declare const Storage: {
+    /**
+     * @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'
+     * ```
+     */
+    getItem: (args_0: 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');
+     * ```
+     */
+    setItem: (args_0: string, args_1: 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');
+     * ```
+     */
+    removeItem: (args_0: string) => Promise<void>;
+    /**
+     * @public
+     * @category 저장소
+     * @name clearItems
+     * @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
+     * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
+     * @example
+     *
+     * ### 저장소 초기화하기
+     * ```ts
+     * import { Storage } from '@apps-in-toss/framework';
+     *
+     * await Storage.clearItems();
+     * ```
+     */
+    clearItems: (args_0: void) => Promise<void>;
+};
 
-/**
- * 이벤트 브릿지 함수 생성
- * @param method 호출할 이벤트 핸들러 이름
- * @returns 이벤트 및 에러 핸들러를 포함한 객체를 받아 리스너 해제 함수를 반환하는 함수
- * @typeParam T: 이벤트 관련 추가 옵션 등의 타입
- * @example
- * // 위치 추적 이벤트 브릿지 생성
- * const startUpdatingLocation = createEventBridge<{ interval: number }>('startUpdatingLocation');
- *
- * // 사용 예시
- * const unsubscribe = startUpdatingLocation({
- *   options: { interval: 1000 }, // 1초마다 위치 업데이트
- *   onEvent: (location) => {
- *     console.log('현재 위치:', location.latitude, location.longitude);
- *   },
- *   onError: (error) => {
- *     console.error('위치 추적 오류:', error);
- *   }
- * });
- *
- * // 위치 추적 중단
- * unsubscribe();
- */
-declare function createEventBridge<TOptions, TData>(method: string): (args: {
-    onEvent: (data: TData) => void;
-    onError: (error: Error) => void;
-    options?: TOptions;
-}) => () => void;
+declare function getSafeAreaInsets(): {
+    top: number;
+    bottom: number;
+};
+
+type BedrockEvent = {
+    backEvent: {
+        onEvent: () => void;
+        onError?: (error: Error) => void;
+        options?: void;
+    };
+};
+declare const bedrockEvent: {
+    addEventListener: <K extends "backEvent">(event: K, { onEvent, onError, options, }: {
+        onEvent: BedrockEvent[K]["onEvent"];
+        onError?: BedrockEvent[K]["onError"] | undefined;
+        options?: BedrockEvent[K]["options"] | undefined;
+    }) => () => void;
+};
 
-export { createAsyncBridge, createConstantBridge, createEventBridge };
+export { type BedrockEvent, Storage, bedrockEvent, getSafeAreaInsets };

package/dist-web/index.js

@@ -1,144 +1,104 @@
 export * from './bridge.js'
 
-// src-web/nativeWindow.ts
-var NativeWindow = class {
-  get _window() {
-    return window;
-  }
+// src-web/index.ts
+export * from "@apps-in-toss/bridge-core";
+
+// src-web/storage.ts
+import { createAsyncBridge } from "@apps-in-toss/bridge-core";
+var Storage = {
   /**
-   * ReactNativeWebView를 이용해 메시지를 전송합니다.
-   * @param message 전송할 메시지(JSON 문자열)
+   * @public
+   * @category 저장소
+   * @name getItem
+   * @description 모바일 앱의 로컬 저장소에서 문자열 데이터를 가져와요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
+   * @param {string} key - 가져올 아이템의 키를 입력해요.
+   * @returns {Promise<string | null>} 지정한 키에 저장된 문자열 값을 반환해요. 값이 없으면 `null`을 반환해요.
    * @example
-   * const nativeWindow = new NativeWindow();
-   * nativeWindow.postMessage({ type: 'method', functionName: 'getDeviceId', eventId: '123', args: [] });
+   *
+   * ### `my-key`에 저장된 아이템 가져오기
+   * ```ts
+   * const value = await Storage.getItem('my-key');
+   * console.log(value); // 'value'
+   * ```
    */
-  postMessage(message) {
-    const webView = this._window.ReactNativeWebView;
-    if (!webView) {
-      throw new Error("ReactNativeWebView is not available in browser environment");
-    }
-    webView.postMessage(JSON.stringify(message));
-  }
+  getItem: createAsyncBridge("getStorageItem"),
   /**
-   * __BEDROCK_NATIVE_EMITTER를 이용해 이벤트 리스너를 등록합니다.
-   * @param event 이벤트 이름
-   * @param callback 데이터가 도착했을 때 호출되는 콜백
-   * @returns 리스너 해제 함수
+   * @public
+   * @category 저장소
+   * @name setItem
+   * @description 모바일 앱의 로컬 저장소에 문자열 데이터를 저장해요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
+   * @param {string} key - 저장할 아이템의 키를 입력해요.
+   * @param {string} value - 저장할 아이템의 값을 입력해요.
+   * @returns {Promise<void>} 아이템을 성공적으로 저장하면 아무 값도 반환하지 않아요.
    * @example
-   * const nativeWindow = new NativeWindow();
-   * const unsubscribe = nativeWindow.on('deviceInfo', (data) => {
-   *   console.log('Device info received:', data);
-   * });
    *
-   * // 리스너 해제
-   * unsubscribe();
+   * ### `my-key`에 아이템 저장하기
+   * ```ts
+   * import { Storage } from '@apps-in-toss/framework';
+   *
+   * await Storage.setItem('my-key', 'value');
+   * ```
    */
-  on(event, callback) {
-    const emitter = this._window.__BEDROCK_NATIVE_EMITTER;
-    if (!emitter) {
-      throw new Error("__BEDROCK_NATIVE_EMITTER is not available");
-    }
-    return emitter.on(event, callback);
-  }
+  setItem: createAsyncBridge("setStorageItem"),
   /**
-   * __CONSTANT_HANDLER_MAP에 등록된 상수 값을 반환합니다.
-   * @param method 상수 핸들러 이름
-   * @returns 상수 값
+   * @public
+   * @category 저장소
+   * @name removeItem
+   * @description 모바일 앱의 로컬 저장소에서 특정 키에 해당하는 아이템을 삭제해요.
+   * @param {string} key - 삭제할 아이템의 키를 입력해요.
+   * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않아요.
    * @example
-   * const nativeWindow = new NativeWindow();
-   * const deviceId = nativeWindow.getConstant('getDeviceId');
-   * console.log('Device ID:', deviceId);
+   *
+   * ### `my-key`에 저장된 아이템 삭제하기
+   * ```ts
+   * import { Storage } from '@apps-in-toss/framework';
+   *
+   * await Storage.removeItem('my-key');
+   * ```
    */
-  getConstant(method) {
-    const constantHandlerMap = this._window.__CONSTANT_HANDLER_MAP;
-    if (constantHandlerMap && method in constantHandlerMap) {
-      return constantHandlerMap[method];
-    }
-    throw new Error(`${method} is not a constant handler`);
-  }
-};
-var nativeWindow = new NativeWindow();
-var createEventId = () => Math.random().toString(36).substring(2, 15);
-var deserializeError = (value) => {
-  if (value && value.__isError) {
-    const err = new Error(value.message);
-    err.name = value.name;
-    err.stack = value.stack;
-    return err;
-  }
-  return value;
+  removeItem: createAsyncBridge("removeStorageItem"),
+  /**
+   * @public
+   * @category 저장소
+   * @name clearItems
+   * @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
+   * @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
+   * @example
+   *
+   * ### 저장소 초기화하기
+   * ```ts
+   * import { Storage } from '@apps-in-toss/framework';
+   *
+   * await Storage.clearItems();
+   * ```
+   */
+  clearItems: createAsyncBridge("clearItems")
 };
 
-// src-web/createAsyncBridge.ts
-function createAsyncBridge(method) {
-  return (args) => {
-    const eventId = createEventId();
-    const emitters = [];
-    const unsubscribe = () => {
-      for (const remove of emitters) {
-        remove();
-      }
-    };
-    return new Promise((resolve, reject) => {
-      emitters.push(
-        nativeWindow.on(`${method}/resolve/${eventId}`, (data) => {
-          unsubscribe();
-          resolve(data);
-        })
-      );
-      emitters.push(
-        nativeWindow.on(`${method}/reject/${eventId}`, (error) => {
-          unsubscribe();
-          reject(deserializeError(error));
-        })
-      );
-      nativeWindow.postMessage({
-        type: "method",
-        functionName: method,
-        eventId,
-        args: [args]
-      });
-    });
-  };
+// src-web/getSafeAreaInsets.ts
+import { createConstantBridge } from "@apps-in-toss/bridge-core";
+var getSafeAreaBottom = createConstantBridge("getSafeAreaBottom");
+var getSafeAreaTop = createConstantBridge("getSafeAreaTop");
+function getSafeAreaInsets() {
+  return { top: getSafeAreaTop(), bottom: getSafeAreaBottom() };
 }
 
-// src-web/createConstantBridge.ts
-function createConstantBridge(method) {
-  return () => {
-    return nativeWindow.getConstant(method);
-  };
-}
-
-// src-web/createEventBridge.ts
-function createEventBridge(method) {
-  return (args) => {
-    const eventId = createEventId();
-    const removes = [
-      nativeWindow.on(`${method}/onEvent/${eventId}`, (data) => {
-        args.onEvent(data);
-      }),
-      nativeWindow.on(`${method}/onError/${eventId}`, (error) => {
-        args.onError(deserializeError(error));
-      })
-    ];
-    nativeWindow.postMessage({
-      type: "addEventListener",
-      functionName: method,
-      eventId,
-      args: args.options
-    });
-    return () => {
-      nativeWindow.postMessage({
-        type: "removeEventListener",
-        functionName: method,
-        eventId
-      });
-      removes.forEach((remove) => remove());
-    };
-  };
-}
+// src-web/bedrockEvent.ts
+import { createEventBridge } from "@apps-in-toss/bridge-core";
+var bedrockEvent = {
+  addEventListener: (event, {
+    onEvent,
+    onError,
+    options
+  }) => createEventBridge(event)({
+    onEvent,
+    onError: onError ?? (() => {
+    }),
+    options
+  })
+};
 export {
-  createAsyncBridge,
-  createConstantBridge,
-  createEventBridge
+  Storage,
+  bedrockEvent,
+  getSafeAreaInsets
 };

package/dist-web/openURL.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @public
+ * @kind function
+ * @category 화면 이동
+ *
+ * @name openURL
+ * @signature
+ * ```typescript
+ * function openURL(url: string): Promise<any>;
+ * ```
+ *
+ * @description
+ * 지정된 URL을 기기의 기본 브라우저나 관련 앱에서 열어요.
+ * 이 함수는 `react-native`의 [`Linking.openURL`](https://reactnative.dev/docs/0.72/linking#openurl) 메서드를 사용하여 URL을 열어요.
+ *
+ * @param {string} url 열고자 하는 URL 주소
+ * @returns {Promise<any>} URL이 성공적으로 열렸을 때 해결되는 Promise
+ *
+ * @example
+ *
+ * ### 외부 URL 열기
+ *
+ * ```tsx
+ * import { openURL } from '@apps-in-toss/web-framework';
+ * 
+ *
+ * function Page() {
+ *   const handlePress = () => {
+ *     openURL('https://google.com');
+ *   };
+ *
+ *   return <input type="button" value="구글 웹사이트 열기" onClick={handlePress} />;
+ * }
+ * ```
+ */
+export declare function openURL(url: string): Promise<any>;
+
+export {};

package/dist-web/startUpdateLocation.d.ts

@@ -51,7 +51,7 @@ export interface Location {
 	 */
 	timestamp: number;
 	/**
-	 * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/reference/framework/Types/LocationCoords.html)을 참고해주세요.
+	 * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/react-native/reference/framework/Types/LocationCoords.html)을 참고해주세요.
 	 */
 	coords: LocationCoords;
 }
@@ -127,7 +127,7 @@ export interface UpdateLocationEventEmitter extends EventEmitterSchema<"updateLo
  * @param {number} [options.accuracy] 위치 정확도를 설정해요.
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
- * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
+ * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/react-native/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기