@apps-in-toss/framework 0.0.8 → 0.0.9

package/README.md

@@ -4,21 +4,20 @@ Hub package for Apps In Toss
 
 ## License
 
-This software is licensed under the [Apache 2 license](LICENSE), quoted below.
+This software is licensed under the [GPL, Version 3.0](LICENSE), quoted below.
 
 ```
-Copyright 2025 Viva Republica, Inc
+Copyright 2025 Viva Republica, Inc.
 
-Licensed under the Apache License, Version 2.0 (the "License");
+Licensed under the GPL, Version 3.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at:
 
-    http://www.apache.org/licenses/LICENSE-2.0
+    https://www.gnu.org/licenses/gpl-3.0.html
 
 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-
 ```

package/{bin.js → bin/ait.js}

@@ -1,4 +1,3 @@
 #!/usr/bin/env node
 import { initialize } from '@apps-in-toss/cli';
-
 initialize();

package/dist/index.cjs

@@ -31,7 +31,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   Accuracy: () => Accuracy2,
+  AppsInToss: () => AppsInToss,
   WebView: () => WebView,
+  appLogin: () => appLogin,
   env: () => env,
   fetchAlbumPhotos: () => fetchAlbumPhotos,
   fetchContacts: () => fetchContacts,
@@ -44,6 +46,32 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/core/registerApp.tsx
+var import_react_native_bedrock = require("react-native-bedrock");
+var import_jsx_runtime = require("react/jsx-runtime");
+function AppsInTossContainer(Container, { children, ...initialProps }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Container, { ...initialProps, children });
+}
+function registerApp(container, { context }) {
+  return import_react_native_bedrock.Bedrock.registerApp(AppsInTossContainer.bind(null, container), {
+    appName: getAppName(),
+    context
+  });
+}
+function getAppName() {
+  try {
+    return global.__bedrock.app.name;
+  } catch (error) {
+    console.error("unexpected error occurred while getting app name");
+    throw error;
+  }
+}
+
+// src/core/index.ts
+var AppsInToss = {
+  registerApp
+};
+
 // src/native-event-emitter/index.ts
 var native_event_emitter_exports = {};
 __export(native_event_emitter_exports, {
@@ -51,10 +79,10 @@ __export(native_event_emitter_exports, {
 });
 
 // src/native-event-emitter/bedrock-event.ts
-var import_react_native_bedrock2 = require("react-native-bedrock");
+var import_react_native_bedrock3 = require("react-native-bedrock");
 
 // src/native-event-emitter/event-plugins/UpdateLocationEvent.ts
-var import_react_native_bedrock = require("react-native-bedrock");
+var import_react_native_bedrock2 = require("react-native-bedrock");
 
 // src/native-modules/AppsInTossModule.ts
 var import_react_native = require("react-native");
@@ -88,7 +116,7 @@ var import_react_native2 = require("react-native");
 var nativeEventEmitter = new import_react_native2.NativeEventEmitter(AppsInTossModuleInstance);
 
 // src/native-event-emitter/event-plugins/UpdateLocationEvent.ts
-var UpdateLocationEvent = class extends import_react_native_bedrock.BedrockEventDefinition {
+var UpdateLocationEvent = class extends import_react_native_bedrock2.BedrockEventDefinition {
   name = "updateLocationEvent";
   subscriptionCount = 0;
   ref = {
@@ -116,7 +144,7 @@ var UpdateLocationEvent = class extends import_react_native_bedrock.BedrockEvent
 };
 
 // src/native-event-emitter/bedrock-event.ts
-var appsInTossEvent = new import_react_native_bedrock2.BedrockEvent([new UpdateLocationEvent()]);
+var appsInTossEvent = new import_react_native_bedrock3.BedrockEvent([new UpdateLocationEvent()]);
 
 // src/native-event-emitter/startUpdateLocation.ts
 function startUpdateLocation(eventParams) {
@@ -126,6 +154,7 @@ function startUpdateLocation(eventParams) {
 // src/native-modules/index.ts
 var native_modules_exports = {};
 __export(native_modules_exports, {
+  appLogin: () => appLogin,
   fetchAlbumPhotos: () => fetchAlbumPhotos,
   fetchContacts: () => fetchContacts,
   getClipboardText: () => getClipboardText,
@@ -187,6 +216,14 @@ async function fetchAlbumPhotos(options) {
     maxCount: options.maxCount ?? DEFAULT_MAX_COUNT,
     maxWidth: options.maxWidth ?? DEFAULT_MAX_WIDTH
   });
+  if (options.base64) {
+    return albumPhotos.map((photo) => {
+      return {
+        ...photo,
+        dataUri: `data:image/jpeg;base64,${photo.dataUri}`
+      };
+    });
+  }
   return albumPhotos;
 }
 
@@ -210,13 +247,18 @@ async function openCamera(options) {
   return photo;
 }
 
+// src/native-modules/appLogin.ts
+async function appLogin() {
+  return AppsInTossModule.appLogin({});
+}
+
 // src/components/WebView.tsx
 var import_react_native_webview = require("@react-native-bedrock/native/react-native-webview");
 var import_react = require("react");
-var import_react_native_bedrock3 = require("react-native-bedrock");
+var import_react_native_bedrock4 = require("react-native-bedrock");
 var bridges = __toESM(require("react-native-bedrock/bridges"), 1);
 var constantBridges = __toESM(require("react-native-bedrock/constants"), 1);
-var import_jsx_runtime = require("react/jsx-runtime");
+var import_jsx_runtime2 = require("react/jsx-runtime");
 function WebView({ localhostPort = 5173, onMessage, ...props }) {
   const uri = (0, import_react.useMemo)(() => {
     if (__DEV__) {
@@ -224,7 +266,7 @@ function WebView({ localhostPort = 5173, onMessage, ...props }) {
     }
     return AppsInTossModule.getWebBundleURL({}).url;
   }, [localhostPort]);
-  const handler = (0, import_react_native_bedrock3.useBridgeHandler)({
+  const handler = (0, import_react_native_bedrock4.useBridgeHandler)({
     onMessage,
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     eventListenerMap: native_event_emitter_exports,
@@ -238,7 +280,7 @@ function WebView({ localhostPort = 5173, onMessage, ...props }) {
       ...native_modules_exports
     }
   });
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
     import_react_native_webview.WebView,
     {
       ref: handler.ref,
@@ -255,9 +297,9 @@ function WebView({ localhostPort = 5173, onMessage, ...props }) {
 
 // src/hooks/useGeolocation.ts
 var import_react2 = require("react");
-var import_react_native_bedrock4 = require("react-native-bedrock");
+var import_react_native_bedrock5 = require("react-native-bedrock");
 function useGeolocation({ accuracy, distanceInterval, timeInterval }) {
-  const isVisible = (0, import_react_native_bedrock4.useVisibility)();
+  const isVisible = (0, import_react_native_bedrock5.useVisibility)();
   const [location, setLocation] = (0, import_react2.useState)(null);
   (0, import_react2.useEffect)(() => {
     if (!isVisible) {
@@ -294,7 +336,9 @@ var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Accuracy,
+  AppsInToss,
   WebView,
+  appLogin,
   env,
   fetchAlbumPhotos,
   fetchContacts,

package/dist/index.d.cts

@@ -1,14 +1,26 @@
+import { ComponentType, PropsWithChildren } from 'react';
+import { InitialProps, BedrockProps } from 'react-native-bedrock';
 import { EmitterSubscription } from 'react-native';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';
 
+type AppsInTossProps = Pick<BedrockProps, 'context'>;
+declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
+
+declare const AppsInToss: {
+    registerApp: typeof registerApp;
+};
+
 interface EventEmitterSchema<K extends string, P extends unknown[]> {
     name: K;
     params: P;
 }
 
 /**
- * 위치 정확도 옵션이에요.
+ * @public
+ * @category Types
+ * @name Accuracy
+ * @description 위치 정확도 옵션이에요.
  */
 declare enum Accuracy {
     /**
@@ -36,6 +48,12 @@ declare enum Accuracy {
      */
     BestForNavigation = 6
 }
+/**
+ * @public
+ * @category Types
+ * @name Location
+ * @description 위치 정보를 나타내는 객체예요.
+ */
 interface Location {
     /**
      * Android에서만 지원하는 옵션이에요.
@@ -50,14 +68,42 @@ interface Location {
      * 위치가 업데이트된 시점의 유닉스 타임스탬프예요.
      */
     timestamp: number;
-    coords: {
-        latitude: number;
-        longitude: number;
-        altitude: number;
-        accuracy: number;
-        altitudeAccuracy: number;
-        heading: number;
-    };
+    /**
+     * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/reference/framework/Types/LocationCoords.html)을 참고해주세요.
+     */
+    coords: LocationCoords;
+}
+/**
+ * @public
+ * @category Types
+ * @name LocationCoords
+ * @description 세부 위치 정보를 나타내는 객체예요.
+ */
+interface LocationCoords {
+    /**
+     * 위도
+     */
+    latitude: number;
+    /**
+     * 경도
+     */
+    longitude: number;
+    /**
+     * 높이
+     */
+    altitude: number;
+    /**
+     * 위치 정확도
+     */
+    accuracy: number;
+    /**
+     * 고도 정확도
+     */
+    altitudeAccuracy: number;
+    /**
+     * 방향
+     */
+    heading: number;
 }
 /**
  * 사진 조회 결과를 나타내는 타입이에요.
@@ -109,7 +155,7 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
  * @param {number} [options.accuracy] 위치 정확도를 설정해요.
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
- * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요.
+ * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기
@@ -126,7 +172,7 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
  *   useEffect(() => {
  *     return startUpdateLocation({
  *       options: {
- *         accuracy: Accuracy.Default,
+ *         accuracy: Accuracy.Balanced,
  *         timeInterval: 3000,
  *         distanceInterval: 10,
  *       },
@@ -352,7 +398,7 @@ interface FetchAlbumPhotosOptions {
  * @param {number} [options.maxCount=10] 가져올 사진의 최대 개수를 설정해요. 숫자로 입력하며 기본값은 10이에요.
  * @param {number} [options.maxWidth=1024] 사진의 최대 폭을 제한해요. 단위는 픽셀이며 기본값은 `1024`이에요.
  * @param {boolean} [options.base64=false] 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요.
- * @returns {Promise<AlbumResponse[]>}
+ * @returns {Promise<ImageResponse[]>}
  * 앨범 사진의 고유 ID와 데이터 URI를 포함한 배열을 반환해요.
  *
  * @example
@@ -410,7 +456,7 @@ interface GetCurrentLocationOptions {
  *
  * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
  * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
- * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요.
+ * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 디바이스의 현재 위치 정보 가져오기
@@ -513,6 +559,36 @@ interface OpenCameraOptions {
  */
 declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
 
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name appLogin
+ * @description 토스 인증으로 로그인해요. 로그인이 완료되면 다시 토스 앱으로 이동해요.
+ * @example
+ *
+ * ### 토스 인증을 통해 로그인을 하는 예제
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { appLogin } from '@apps-in-toss/framework';
+ *
+ * function Page() {
+ *   const handleLogin = async () => {
+ *     const { authorizationCode } = await appLogin();
+ *
+ *     // 획득한 인가 코드(`authorizationCode`)를 서버로 전달해요.
+ *   }
+ *
+ *   return <Button title="로그인" onPress={handleLogin} />;
+ * }
+ * ```
+ */
+declare function appLogin(): Promise<{
+    authorizationCode: string;
+}>;
+
 interface WebViewProps extends Omit<WebViewProps$1, 'source' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded'> {
     localhostPort?: number;
 }
@@ -534,6 +610,7 @@ type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
  * @param {Accuracy} [options.accuracy] 위치 정확도를 설정해요. `Accuracy.Lowest`: 오차범위 3KM 이내, `Accuracy.Low`: 오차범위 1KM 이내, `Accuracy.Balanced`: 오차범위 몇 백미터 이내, `Accuracy.High`: 오차범위 10M 이내, `Accuracy.Highest`: 가장 높은 정확도, `Accuracy.BestForNavigation`: 네비게이션을 위한 최고 정확도
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
+ * @returns {Location | null} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기
@@ -569,4 +646,4 @@ declare const env: {
     getDeploymentId: () => string | undefined;
 };
 
-export { Accuracy, type ContactEntity, type FetchAlbumPhotosOptions, type GetCurrentLocationOptions, type ImageResponse, type Location, type OpenCameraOptions, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+export { Accuracy, AppsInToss, type ContactEntity, type FetchAlbumPhotosOptions, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, openCamera, setClipboardText, startUpdateLocation, useGeolocation };

package/dist/index.d.ts

@@ -1,14 +1,26 @@
+import { ComponentType, PropsWithChildren } from 'react';
+import { InitialProps, BedrockProps } from 'react-native-bedrock';
 import { EmitterSubscription } from 'react-native';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';
 
+type AppsInTossProps = Pick<BedrockProps, 'context'>;
+declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
+
+declare const AppsInToss: {
+    registerApp: typeof registerApp;
+};
+
 interface EventEmitterSchema<K extends string, P extends unknown[]> {
     name: K;
     params: P;
 }
 
 /**
- * 위치 정확도 옵션이에요.
+ * @public
+ * @category Types
+ * @name Accuracy
+ * @description 위치 정확도 옵션이에요.
  */
 declare enum Accuracy {
     /**
@@ -36,6 +48,12 @@ declare enum Accuracy {
      */
     BestForNavigation = 6
 }
+/**
+ * @public
+ * @category Types
+ * @name Location
+ * @description 위치 정보를 나타내는 객체예요.
+ */
 interface Location {
     /**
      * Android에서만 지원하는 옵션이에요.
@@ -50,14 +68,42 @@ interface Location {
      * 위치가 업데이트된 시점의 유닉스 타임스탬프예요.
      */
     timestamp: number;
-    coords: {
-        latitude: number;
-        longitude: number;
-        altitude: number;
-        accuracy: number;
-        altitudeAccuracy: number;
-        heading: number;
-    };
+    /**
+     * @description 위치 정보를 나타내는 객체예요. 자세한 내용은 [LocationCoords](/reference/framework/Types/LocationCoords.html)을 참고해주세요.
+     */
+    coords: LocationCoords;
+}
+/**
+ * @public
+ * @category Types
+ * @name LocationCoords
+ * @description 세부 위치 정보를 나타내는 객체예요.
+ */
+interface LocationCoords {
+    /**
+     * 위도
+     */
+    latitude: number;
+    /**
+     * 경도
+     */
+    longitude: number;
+    /**
+     * 높이
+     */
+    altitude: number;
+    /**
+     * 위치 정확도
+     */
+    accuracy: number;
+    /**
+     * 고도 정확도
+     */
+    altitudeAccuracy: number;
+    /**
+     * 방향
+     */
+    heading: number;
 }
 /**
  * 사진 조회 결과를 나타내는 타입이에요.
@@ -109,7 +155,7 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
  * @param {number} [options.accuracy] 위치 정확도를 설정해요.
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
- * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요.
+ * @param {(location: Location) => void} [options.callback] 위치 정보가 변경될 때 호출되는 콜백 함수예요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기
@@ -126,7 +172,7 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
  *   useEffect(() => {
  *     return startUpdateLocation({
  *       options: {
- *         accuracy: Accuracy.Default,
+ *         accuracy: Accuracy.Balanced,
  *         timeInterval: 3000,
  *         distanceInterval: 10,
  *       },
@@ -352,7 +398,7 @@ interface FetchAlbumPhotosOptions {
  * @param {number} [options.maxCount=10] 가져올 사진의 최대 개수를 설정해요. 숫자로 입력하며 기본값은 10이에요.
  * @param {number} [options.maxWidth=1024] 사진의 최대 폭을 제한해요. 단위는 픽셀이며 기본값은 `1024`이에요.
  * @param {boolean} [options.base64=false] 이미지를 base64 형식으로 반환할지 설정해요. 기본값은 `false`예요.
- * @returns {Promise<AlbumResponse[]>}
+ * @returns {Promise<ImageResponse[]>}
  * 앨범 사진의 고유 ID와 데이터 URI를 포함한 배열을 반환해요.
  *
  * @example
@@ -410,7 +456,7 @@ interface GetCurrentLocationOptions {
  *
  * @param {GetCurrentLocationOptions} options 위치 정보를 가져올 때 사용하는 옵션 객체예요.
  * @param {Accuracy} [options.accuracy] 위치 정보의 정확도 수준이에요. 정확도는 `Accuracy` 타입으로 설정돼요.
- * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요.
+ * @returns {Promise<Location>} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 디바이스의 현재 위치 정보 가져오기
@@ -513,6 +559,36 @@ interface OpenCameraOptions {
  */
 declare function openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;
 
+/**
+ * @public
+ * @tag AppsInTossModule
+ * @category AppsInTossModules
+ * @kind function
+ * @name appLogin
+ * @description 토스 인증으로 로그인해요. 로그인이 완료되면 다시 토스 앱으로 이동해요.
+ * @example
+ *
+ * ### 토스 인증을 통해 로그인을 하는 예제
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { appLogin } from '@apps-in-toss/framework';
+ *
+ * function Page() {
+ *   const handleLogin = async () => {
+ *     const { authorizationCode } = await appLogin();
+ *
+ *     // 획득한 인가 코드(`authorizationCode`)를 서버로 전달해요.
+ *   }
+ *
+ *   return <Button title="로그인" onPress={handleLogin} />;
+ * }
+ * ```
+ */
+declare function appLogin(): Promise<{
+    authorizationCode: string;
+}>;
+
 interface WebViewProps extends Omit<WebViewProps$1, 'source' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded'> {
     localhostPort?: number;
 }
@@ -534,6 +610,7 @@ type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
  * @param {Accuracy} [options.accuracy] 위치 정확도를 설정해요. `Accuracy.Lowest`: 오차범위 3KM 이내, `Accuracy.Low`: 오차범위 1KM 이내, `Accuracy.Balanced`: 오차범위 몇 백미터 이내, `Accuracy.High`: 오차범위 10M 이내, `Accuracy.Highest`: 가장 높은 정확도, `Accuracy.BestForNavigation`: 네비게이션을 위한 최고 정확도
  * @param {number} [options.timeInterval] 위치 정보를 업데이트하는 최소 주기로, 단위는 밀리초(ms)예요. 이 값은 위치 업데이트가 발생하는 가장 짧은 간격을 설정하지만, 시스템이나 환경의 영향을 받아 지정한 주기보다 더 긴 간격으로 업데이트될 수 있어요.
  * @param {number} [options.distanceInterval] 위치 변경 거리를 미터(m) 단위로 설정해요.
+ * @returns {Location | null} 디바이스의 위치 정보가 담긴 객체를 반환해요. 자세한 내용은 [Location](/reference/framework/Types/Location.html)을 참고해주세요.
  *
  * @example
  * ### 위치 정보 변경 감지하기
@@ -569,4 +646,4 @@ declare const env: {
     getDeploymentId: () => string | undefined;
 };
 
-export { Accuracy, type ContactEntity, type FetchAlbumPhotosOptions, type GetCurrentLocationOptions, type ImageResponse, type Location, type OpenCameraOptions, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+export { Accuracy, AppsInToss, type ContactEntity, type FetchAlbumPhotosOptions, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, openCamera, setClipboardText, startUpdateLocation, useGeolocation };

package/dist/index.js

@@ -4,6 +4,32 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/core/registerApp.tsx
+import { Bedrock } from "react-native-bedrock";
+import { jsx } from "react/jsx-runtime";
+function AppsInTossContainer(Container, { children, ...initialProps }) {
+  return /* @__PURE__ */ jsx(Container, { ...initialProps, children });
+}
+function registerApp(container, { context }) {
+  return Bedrock.registerApp(AppsInTossContainer.bind(null, container), {
+    appName: getAppName(),
+    context
+  });
+}
+function getAppName() {
+  try {
+    return global.__bedrock.app.name;
+  } catch (error) {
+    console.error("unexpected error occurred while getting app name");
+    throw error;
+  }
+}
+
+// src/core/index.ts
+var AppsInToss = {
+  registerApp
+};
+
 // src/native-event-emitter/index.ts
 var native_event_emitter_exports = {};
 __export(native_event_emitter_exports, {
@@ -86,6 +112,7 @@ function startUpdateLocation(eventParams) {
 // src/native-modules/index.ts
 var native_modules_exports = {};
 __export(native_modules_exports, {
+  appLogin: () => appLogin,
   fetchAlbumPhotos: () => fetchAlbumPhotos,
   fetchContacts: () => fetchContacts,
   getClipboardText: () => getClipboardText,
@@ -147,6 +174,14 @@ async function fetchAlbumPhotos(options) {
     maxCount: options.maxCount ?? DEFAULT_MAX_COUNT,
     maxWidth: options.maxWidth ?? DEFAULT_MAX_WIDTH
   });
+  if (options.base64) {
+    return albumPhotos.map((photo) => {
+      return {
+        ...photo,
+        dataUri: `data:image/jpeg;base64,${photo.dataUri}`
+      };
+    });
+  }
   return albumPhotos;
 }
 
@@ -170,6 +205,11 @@ async function openCamera(options) {
   return photo;
 }
 
+// src/native-modules/appLogin.ts
+async function appLogin() {
+  return AppsInTossModule.appLogin({});
+}
+
 // src/components/WebView.tsx
 import {
   WebView as OriginalWebView
@@ -178,7 +218,7 @@ import { useMemo } from "react";
 import { useBridgeHandler } from "react-native-bedrock";
 import * as bridges from "react-native-bedrock/bridges";
 import * as constantBridges from "react-native-bedrock/constants";
-import { jsx } from "react/jsx-runtime";
+import { jsx as jsx2 } from "react/jsx-runtime";
 function WebView({ localhostPort = 5173, onMessage, ...props }) {
   const uri = useMemo(() => {
     if (__DEV__) {
@@ -200,7 +240,7 @@ function WebView({ localhostPort = 5173, onMessage, ...props }) {
       ...native_modules_exports
     }
   });
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx2(
     OriginalWebView,
     {
       ref: handler.ref,
@@ -255,7 +295,9 @@ var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
 })(Accuracy2 || {});
 export {
   Accuracy2 as Accuracy,
+  AppsInToss,
   WebView,
+  appLogin,
   env,
   fetchAlbumPhotos,
   fetchContacts,

package/dist/jest/index.cjs

@@ -0,0 +1,24 @@
+"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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jest/index.ts
+var jest_exports = {};
+module.exports = __toCommonJS(jest_exports);
+__reExport(jest_exports, require("react-native-bedrock/jest"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("react-native-bedrock/jest")
+});

package/dist/jest/index.d.cts

@@ -0,0 +1 @@
+export * from 'react-native-bedrock/jest';

package/dist/jest/index.d.ts

@@ -0,0 +1 @@
+export * from 'react-native-bedrock/jest';

package/dist/jest/index.js

@@ -0,0 +1,4 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+
+// src/jest/index.ts
+export * from "react-native-bedrock/jest";