@apps-in-toss/framework 0.0.17 → 0.0.19

package/dist/index.cjs

@@ -32,6 +32,7 @@ var src_exports = {};
 __export(src_exports, {
   Accuracy: () => Accuracy2,
   AppsInToss: () => AppsInToss,
+  Storage: () => Storage,
   TossPay: () => TossPay,
   WebView: () => WebView,
   appLogin: () => appLogin,
@@ -41,6 +42,7 @@ __export(src_exports, {
   getClipboardText: () => getClipboardText,
   getCurrentLocation: () => getCurrentLocation,
   getOperationalEnvironment: () => getOperationalEnvironment,
+  getTossAppVersion: () => getTossAppVersion,
   openCamera: () => openCamera,
   setClipboardText: () => setClipboardText,
   startUpdateLocation: () => startUpdateLocation,
@@ -282,6 +284,34 @@ function getOperationalEnvironment() {
   return AppsInTossModule.operationalEnvironment;
 }
 
+// src/native-modules/getTossAppVersion.ts
+function getTossAppVersion() {
+  return AppsInTossModule.tossAppVersion;
+}
+
+// src/native-modules/storage.ts
+function getItem(key) {
+  return AppsInTossModule.getStorageItem({ key });
+}
+function setItem(key, value) {
+  return AppsInTossModule.setStorageItem({
+    key,
+    value
+  });
+}
+function removeItem(key) {
+  return AppsInTossModule.removeStorageItem({ key });
+}
+function clearItems() {
+  return AppsInTossModule.clearStorage({});
+}
+var Storage = {
+  getItem,
+  setItem,
+  removeItem,
+  clearItems
+};
+
 // src/native-modules/index.ts
 var TossPay = {
   checkoutPayment,
@@ -289,7 +319,8 @@ var TossPay = {
 };
 
 // src/components/WebView.tsx
-var import_react_native11 = require("@toss-design-system/react-native");
+var import_react_native12 = require("@toss-design-system/react-native");
+var import_private = require("@toss-design-system/react-native/private");
 var import_react3 = require("react");
 var import_react_native_bedrock5 = require("react-native-bedrock");
 var bedrockAsyncBridges = __toESM(require("react-native-bedrock/async-bridges"), 1);
@@ -297,8 +328,9 @@ var bedrockConstantBridges = __toESM(require("react-native-bedrock/constant-brid
 
 // src/components/GameWebView.tsx
 var import_react_native_webview = require("@react-native-bedrock/native/react-native-webview");
+var import_react_native10 = require("@toss-design-system/react-native");
 var import_react2 = require("react");
-var import_react_native10 = require("react-native");
+var import_react_native11 = require("react-native");
 var import_react_native_bedrock4 = require("react-native-bedrock");
 
 // src/components/GameWebViewNavigationBar/GameNavigationBar.tsx
@@ -382,6 +414,9 @@ function GameNavigationBar({ onClose }) {
           import_react_native9.TouchableOpacity,
           {
             hitSlop: { left: 8, right: 8 },
+            accessibilityRole: "button",
+            accessible: true,
+            accessibilityLabel: "\uB2EB\uAE30",
             style: {
               padding: import_react_native9.Platform.OS === "ios" ? 7 : 9
             },
@@ -397,16 +432,35 @@ function GameNavigationBar({ onClose }) {
 // src/components/GameWebView.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var GameWebView = (0, import_react2.forwardRef)(function GameWebView2(props, ref) {
+  const { openConfirm } = (0, import_react_native10.useDialog)();
+  const { brandDisplayName } = getAppsInTossGlobals();
+  (0, import_react2.useEffect)(() => {
+    if (import_react_native11.Platform.OS === "ios") {
+      (0, import_react_native_bedrock4.setIosSwipeGestureEnabled)({ isEnabled: false });
+      return () => {
+        (0, import_react_native_bedrock4.setIosSwipeGestureEnabled)({ isEnabled: true });
+      };
+    }
+    return;
+  }, []);
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
       GameNavigationBar,
       {
-        onClose: () => {
-          (0, import_react_native_bedrock4.closeView)();
+        onClose: async () => {
+          const isConfirmed = await openConfirm({
+            title: `${brandDisplayName}\uC744 \uC885\uB8CC\uD560\uAE4C\uC694?`,
+            leftButton: "\uCDE8\uC18C",
+            rightButton: "\uC885\uB8CC\uD558\uAE30",
+            closeOnDimmerClick: true
+          });
+          if (isConfirmed) {
+            (0, import_react_native_bedrock4.closeView)();
+          }
         }
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native10.View, { style: { flex: 1 }, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_webview.WebView, { ref, ...props }) })
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native11.View, { style: { flex: 1 }, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_webview.WebView, { ref, ...props }) })
   ] });
 });
 
@@ -427,7 +481,8 @@ __export(async_bridges_exports, {
 // src/constant-bridges.ts
 var constant_bridges_exports = {};
 __export(constant_bridges_exports, {
-  getOperationalEnvironment: () => getOperationalEnvironment
+  getOperationalEnvironment: () => getOperationalEnvironment,
+  getTossAppVersion: () => getTossAppVersion
 });
 
 // src/env.ts
@@ -446,8 +501,8 @@ var import_jsx_runtime5 = require("react/jsx-runtime");
 var appsInTossGlobals = getAppsInTossGlobals();
 var TYPES = ["partner", "external", "game"];
 var WEBVIEW_TYPES = {
-  partner: import_react_native11.PartnerWebViewScreen,
-  external: import_react_native11.ExternalWebViewScreen,
+  partner: import_react_native12.PartnerWebViewScreen,
+  external: import_react_native12.ExternalWebViewScreen,
   game: GameWebView
 };
 function mergeSchemeQueryParamsInto(url) {
@@ -477,6 +532,8 @@ function WebView({ type, local, onMessage, ...props }) {
     throw new Error(`Invalid WebView type: '${type}'`);
   }
   const uri = (0, import_react3.useMemo)(() => getWebViewUri(local), [local]);
+  const top = (0, import_private.useSafeAreaTop)();
+  const bottom = (0, import_private.useSafeAreaBottom)();
   const handler = (0, import_react_native_bedrock5.useBridgeHandler)({
     onMessage,
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -485,13 +542,22 @@ function WebView({ type, local, onMessage, ...props }) {
     // @ts-expect-error
     constantHandlerMap: {
       ...bedrockConstantBridges,
-      ...constant_bridges_exports
+      ...constant_bridges_exports,
+      getSafeAreaTop: () => top,
+      getSafeAreaBottom: () => bottom
     },
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-expect-error
     asyncHandlerMap: {
       ...bedrockAsyncBridges,
-      ...async_bridges_exports
+      ...async_bridges_exports,
+      // internal
+      openPermissionDialog: AppsInTossModule.openPermissionDialog,
+      /** Storage */
+      getStorageItem: Storage.getItem,
+      setStorageItem: Storage.setItem,
+      removeStorageItem: Storage.removeItem,
+      clearItems: Storage.clearItems
     }
   });
   const baseProps = (0, import_react3.useMemo)(() => {
@@ -524,6 +590,10 @@ function WebView({ type, local, onMessage, ...props }) {
     }
   }, [type, props]);
   const BaseWebView = WEBVIEW_TYPES[type];
+  const webviewDebuggingEnabled = (0, import_react3.useMemo)(
+    () => getOperationalEnvironment() === "sandbox",
+    []
+  );
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
     BaseWebView,
     {
@@ -532,9 +602,8 @@ function WebView({ type, local, onMessage, ...props }) {
       ...baseProps,
       source: { uri },
       sharedCookiesEnabled: true,
+      webviewDebuggingEnabled,
       thirdPartyCookiesEnabled: true,
-      cacheEnabled: false,
-      cacheMode: "LOAD_NO_CACHE",
       onMessage: handler.onMessage,
       injectedJavaScript: handler.injectedJavaScript,
       injectedJavaScriptBeforeContentLoaded: handler.injectedJavaScript
@@ -585,6 +654,7 @@ var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
 0 && (module.exports = {
   Accuracy,
   AppsInToss,
+  Storage,
   TossPay,
   WebView,
   appLogin,
@@ -594,6 +664,7 @@ var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
   getClipboardText,
   getCurrentLocation,
   getOperationalEnvironment,
+  getTossAppVersion,
   openCamera,
   setClipboardText,
   startUpdateLocation,

package/dist/index.d.cts

@@ -569,7 +569,7 @@ 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
  *
@@ -1027,13 +1027,127 @@ declare function appLogin(): Promise<{
  */
 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 저장소
+ * @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)을 참고하세요.
+ * @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 const Storage: {
+    getItem: typeof getItem;
+    setItem: typeof setItem;
+    removeItem: typeof removeItem;
+    clearItems: typeof clearItems;
+};
+
 /**
  * @public
  * @category 토스페이
  * @name TossPay
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
- * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 생성하는 함수예요. 자세한 내용은 [checkoutPayment](reference/framework/토스페이/checkoutPayment)를 참고하세요.
- * @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](reference/framework/토스페이/executePayment)를 참고하세요.
+ * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 생성하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
+ * @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](/react-native/reference/framework/토스페이/executePayment)를 참고하세요.
  */
 declare const TossPay: {
     checkoutPayment: typeof checkoutPayment;
@@ -1112,4 +1226,4 @@ declare const env: {
     getDeploymentId: () => string | undefined;
 };
 
-export { Accuracy, AppsInToss, type ContactEntity, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getOperationalEnvironment, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+export { Accuracy, AppsInToss, type ContactEntity, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getOperationalEnvironment, getTossAppVersion, openCamera, setClipboardText, startUpdateLocation, useGeolocation };

package/dist/index.d.ts

@@ -569,7 +569,7 @@ 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
  *
@@ -1027,13 +1027,127 @@ declare function appLogin(): Promise<{
  */
 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 저장소
+ * @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)을 참고하세요.
+ * @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 const Storage: {
+    getItem: typeof getItem;
+    setItem: typeof setItem;
+    removeItem: typeof removeItem;
+    clearItems: typeof clearItems;
+};
+
 /**
  * @public
  * @category 토스페이
  * @name TossPay
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
- * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 생성하는 함수예요. 자세한 내용은 [checkoutPayment](reference/framework/토스페이/checkoutPayment)를 참고하세요.
- * @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](reference/framework/토스페이/executePayment)를 참고하세요.
+ * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 생성하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
+ * @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](/react-native/reference/framework/토스페이/executePayment)를 참고하세요.
  */
 declare const TossPay: {
     checkoutPayment: typeof checkoutPayment;
@@ -1112,4 +1226,4 @@ declare const env: {
     getDeploymentId: () => string | undefined;
 };
 
-export { Accuracy, AppsInToss, type ContactEntity, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getOperationalEnvironment, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
+export { Accuracy, AppsInToss, type ContactEntity, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, type ImageResponse, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, env, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getOperationalEnvironment, getTossAppVersion, openCamera, setClipboardText, startUpdateLocation, useGeolocation };

package/dist/index.js

@@ -238,6 +238,34 @@ function getOperationalEnvironment() {
   return AppsInTossModule.operationalEnvironment;
 }
 
+// src/native-modules/getTossAppVersion.ts
+function getTossAppVersion() {
+  return AppsInTossModule.tossAppVersion;
+}
+
+// src/native-modules/storage.ts
+function getItem(key) {
+  return AppsInTossModule.getStorageItem({ key });
+}
+function setItem(key, value) {
+  return AppsInTossModule.setStorageItem({
+    key,
+    value
+  });
+}
+function removeItem(key) {
+  return AppsInTossModule.removeStorageItem({ key });
+}
+function clearItems() {
+  return AppsInTossModule.clearStorage({});
+}
+var Storage = {
+  getItem,
+  setItem,
+  removeItem,
+  clearItems
+};
+
 // src/native-modules/index.ts
 var TossPay = {
   checkoutPayment,
@@ -249,6 +277,7 @@ import {
   PartnerWebViewScreen,
   ExternalWebViewScreen
 } from "@toss-design-system/react-native";
+import { useSafeAreaBottom, useSafeAreaTop as useSafeAreaTop2 } from "@toss-design-system/react-native/private";
 import { useMemo } from "react";
 import { getSchemeUri, useBridgeHandler } from "react-native-bedrock";
 import * as bedrockAsyncBridges from "react-native-bedrock/async-bridges";
@@ -258,9 +287,10 @@ import * as bedrockConstantBridges from "react-native-bedrock/constant-bridges";
 import {
   WebView as PlainWebView
 } from "@react-native-bedrock/native/react-native-webview";
-import { forwardRef } from "react";
-import { View as View3 } from "react-native";
-import { closeView } from "react-native-bedrock";
+import { useDialog } from "@toss-design-system/react-native";
+import { forwardRef, useEffect as useEffect2 } from "react";
+import { Platform as Platform4, View as View3 } from "react-native";
+import { closeView, setIosSwipeGestureEnabled } from "react-native-bedrock";
 
 // src/components/GameWebViewNavigationBar/GameNavigationBar.tsx
 import { SvgXml } from "@react-native-bedrock/native/react-native-svg";
@@ -343,6 +373,9 @@ function GameNavigationBar({ onClose }) {
           TouchableOpacity,
           {
             hitSlop: { left: 8, right: 8 },
+            accessibilityRole: "button",
+            accessible: true,
+            accessibilityLabel: "\uB2EB\uAE30",
             style: {
               padding: Platform3.OS === "ios" ? 7 : 9
             },
@@ -358,12 +391,31 @@ function GameNavigationBar({ onClose }) {
 // src/components/GameWebView.tsx
 import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
 var GameWebView = forwardRef(function GameWebView2(props, ref) {
+  const { openConfirm } = useDialog();
+  const { brandDisplayName } = getAppsInTossGlobals();
+  useEffect2(() => {
+    if (Platform4.OS === "ios") {
+      setIosSwipeGestureEnabled({ isEnabled: false });
+      return () => {
+        setIosSwipeGestureEnabled({ isEnabled: true });
+      };
+    }
+    return;
+  }, []);
   return /* @__PURE__ */ jsxs2(Fragment3, { children: [
     /* @__PURE__ */ jsx4(
       GameNavigationBar,
       {
-        onClose: () => {
-          closeView();
+        onClose: async () => {
+          const isConfirmed = await openConfirm({
+            title: `${brandDisplayName}\uC744 \uC885\uB8CC\uD560\uAE4C\uC694?`,
+            leftButton: "\uCDE8\uC18C",
+            rightButton: "\uC885\uB8CC\uD558\uAE30",
+            closeOnDimmerClick: true
+          });
+          if (isConfirmed) {
+            closeView();
+          }
         }
       }
     ),
@@ -388,7 +440,8 @@ __export(async_bridges_exports, {
 // src/constant-bridges.ts
 var constant_bridges_exports = {};
 __export(constant_bridges_exports, {
-  getOperationalEnvironment: () => getOperationalEnvironment
+  getOperationalEnvironment: () => getOperationalEnvironment,
+  getTossAppVersion: () => getTossAppVersion
 });
 
 // src/env.ts
@@ -438,6 +491,8 @@ function WebView({ type, local, onMessage, ...props }) {
     throw new Error(`Invalid WebView type: '${type}'`);
   }
   const uri = useMemo(() => getWebViewUri(local), [local]);
+  const top = useSafeAreaTop2();
+  const bottom = useSafeAreaBottom();
   const handler = useBridgeHandler({
     onMessage,
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -446,13 +501,22 @@ function WebView({ type, local, onMessage, ...props }) {
     // @ts-expect-error
     constantHandlerMap: {
       ...bedrockConstantBridges,
-      ...constant_bridges_exports
+      ...constant_bridges_exports,
+      getSafeAreaTop: () => top,
+      getSafeAreaBottom: () => bottom
     },
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-expect-error
     asyncHandlerMap: {
       ...bedrockAsyncBridges,
-      ...async_bridges_exports
+      ...async_bridges_exports,
+      // internal
+      openPermissionDialog: AppsInTossModule.openPermissionDialog,
+      /** Storage */
+      getStorageItem: Storage.getItem,
+      setStorageItem: Storage.setItem,
+      removeStorageItem: Storage.removeItem,
+      clearItems: Storage.clearItems
     }
   });
   const baseProps = useMemo(() => {
@@ -485,6 +549,10 @@ function WebView({ type, local, onMessage, ...props }) {
     }
   }, [type, props]);
   const BaseWebView = WEBVIEW_TYPES[type];
+  const webviewDebuggingEnabled = useMemo(
+    () => getOperationalEnvironment() === "sandbox",
+    []
+  );
   return /* @__PURE__ */ jsx5(
     BaseWebView,
     {
@@ -493,9 +561,8 @@ function WebView({ type, local, onMessage, ...props }) {
       ...baseProps,
       source: { uri },
       sharedCookiesEnabled: true,
+      webviewDebuggingEnabled,
       thirdPartyCookiesEnabled: true,
-      cacheEnabled: false,
-      cacheMode: "LOAD_NO_CACHE",
       onMessage: handler.onMessage,
       injectedJavaScript: handler.injectedJavaScript,
       injectedJavaScriptBeforeContentLoaded: handler.injectedJavaScript
@@ -510,12 +577,12 @@ function ensureValue(value, name) {
 }
 
 // src/hooks/useGeolocation.ts
-import { useState, useEffect as useEffect2 } from "react";
+import { useState, useEffect as useEffect3 } from "react";
 import { useVisibility } from "react-native-bedrock";
 function useGeolocation({ accuracy, distanceInterval, timeInterval }) {
   const isVisible = useVisibility();
   const [location, setLocation] = useState(null);
-  useEffect2(() => {
+  useEffect3(() => {
     if (!isVisible) {
       return;
     }
@@ -545,6 +612,7 @@ var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
 export {
   Accuracy2 as Accuracy,
   AppsInToss,
+  Storage,
   TossPay,
   WebView,
   appLogin,
@@ -554,6 +622,7 @@ export {
   getClipboardText,
   getCurrentLocation,
   getOperationalEnvironment,
+  getTossAppVersion,
   openCamera,
   setClipboardText,
   startUpdateLocation,

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@apps-in-toss/framework",
   "type": "module",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "The framework for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
     "typecheck": "tsc --noEmit",
+    "test:no-parallel": "vitest --no-watch",
     "lint": "eslint .",
     "build": "tsup"
   },
@@ -55,21 +56,28 @@
     "ait": "./bin/ait.js"
   },
   "dependencies": {
-    "@apps-in-toss/cli": "0.0.17",
-    "@apps-in-toss/plugins": "0.0.17"
+    "@apps-in-toss/cli": "0.0.19",
+    "@apps-in-toss/plugins": "0.0.19"
   },
   "devDependencies": {
-    "@react-native-bedrock/mpack-next": "0.0.15",
-    "@react-native-bedrock/native": "0.0.15",
+    "@react-native-bedrock/mpack-next": "0.0.17",
+    "@react-native-bedrock/native": "0.0.17",
     "@toss-design-system/react-native": "^0.4.1",
+    "@types/kill-port": "^2.0.1",
     "@types/react": "18.3.3",
+    "@types/yauzl": "^2.10.3",
+    "es-toolkit": "^1.34.1",
     "eslint": "^9.7.0",
+    "execa": "^9.5.2",
+    "kill-port": "^2.0.1",
     "react": "18.2.0",
     "react-native": "0.72.6",
-    "react-native-bedrock": "0.0.15",
+    "react-native-bedrock": "0.0.17",
     "tsup": "^8.3.5",
     "typescript": "4.9.5",
-    "vitest": "^3.0.3"
+    "vitest": "^3.0.3",
+    "workspace-tools": "^0.38.2",
+    "yauzl": "^3.2.0"
   },
   "peerDependencies": {
     "@react-native-bedrock/native": "*",
@@ -82,5 +90,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8c405027275bd4ef6a16037e32b4786ea9f0277a"
+  "gitHead": "205a7b9571d501f2b64c9b6ad80cae377baec49d"
 }

package/src/constant-bridges.ts

@@ -1 +1,2 @@
 export * from './native-modules/getOperationalEnvironment.js';
+export * from './native-modules/getTossAppVersion.js';