@apps-in-toss/framework 0.0.28 → 0.0.30

package/dist/index.cjs

@@ -35,6 +35,8 @@ __export(src_exports, {
   Analytics: () => Analytics2,
   AppsInToss: () => AppsInToss,
   GoogleAdMob: () => GoogleAdMob,
+  IAP: () => IAP,
+  INTERNAL__onVisibilityChangedByTransparentServiceWeb: () => INTERNAL__onVisibilityChangedByTransparentServiceWeb,
   Storage: () => Storage,
   TossPay: () => TossPay,
   WebView: () => WebView,
@@ -52,9 +54,11 @@ __export(src_exports, {
   getTossShareLink: () => getTossShareLink,
   isMinVersionSupported: () => isMinVersionSupported,
   openCamera: () => openCamera,
+  saveBase64Data: () => saveBase64Data,
   setClipboardText: () => setClipboardText,
   setDeviceOrientation: () => setDeviceOrientation,
   startUpdateLocation: () => startUpdateLocation,
+  useCreateUserAgent: () => useCreateUserAgent,
   useGeolocation: () => useGeolocation
 });
 module.exports = __toCommonJS(src_exports);
@@ -63,7 +67,7 @@ var import_analytics2 = require("@apps-in-toss/analytics");
 // src/core/registerApp.tsx
 var import_analytics = require("@apps-in-toss/analytics");
 var import_react_native6 = require("@toss-design-system/react-native");
-var import_react_native_bedrock7 = require("react-native-bedrock");
+var import_react_native_bedrock8 = require("react-native-bedrock");
 
 // src/core/components/AppEvent.tsx
 var import_react2 = require("react");
@@ -261,7 +265,7 @@ var import_react_native5 = require("@toss-design-system/react-native");
 var import_react3 = require("react");
 
 // src/native-event-emitter/appsInTossEvent.ts
-var import_react_native_bedrock6 = require("react-native-bedrock");
+var import_react_native_bedrock7 = require("react-native-bedrock");
 
 // src/native-event-emitter/event-plugins/EntryMessageExitedEvent.ts
 var import_react_native_bedrock3 = require("react-native-bedrock");
@@ -420,11 +424,39 @@ var AppBridgeCallbackEvent = class _AppBridgeCallbackEvent extends import_react_
   }
 };
 
+// src/native-event-emitter/internal/VisibilityChangedByTransparentServiceWebEvent.ts
+var import_react_native_bedrock6 = require("react-native-bedrock");
+var VisibilityChangedByTransparentServiceWebEvent = class extends import_react_native_bedrock6.BedrockEventDefinition {
+  name = "onVisibilityChangedByTransparentServiceWeb";
+  subscription = null;
+  remove() {
+    this.subscription?.remove();
+    this.subscription = null;
+  }
+  listener(options, onEvent, onError) {
+    const subscription = nativeEventEmitter.addListener("visibilityChangedByTransparentServiceWeb", (params) => {
+      if (this.isVisibilityChangedByTransparentServiceWebResult(params)) {
+        if (params.callbackId === options.callbackId) {
+          onEvent(params.isVisible);
+        }
+      } else {
+        onError(new Error("Invalid visibility changed by transparent service web result"));
+      }
+    });
+    this.subscription = subscription;
+  }
+  isVisibilityChangedByTransparentServiceWebResult(params) {
+    return typeof params === "object" && typeof params.callbackId === "string" && typeof params.isVisible === "boolean";
+  }
+};
+
 // src/native-event-emitter/appsInTossEvent.ts
-var appsInTossEvent = new import_react_native_bedrock6.BedrockEvent([
-  new AppBridgeCallbackEvent(),
+var appsInTossEvent = new import_react_native_bedrock7.BedrockEvent([
   new UpdateLocationEvent(),
-  new EntryMessageExitedEvent()
+  new EntryMessageExitedEvent(),
+  // Internal events
+  new AppBridgeCallbackEvent(),
+  new VisibilityChangedByTransparentServiceWebEvent()
 ]);
 
 // src/core/utils/getAppsInTossGlobals.ts
@@ -472,6 +504,7 @@ __export(async_bridges_exports, {
   getCurrentLocation: () => getCurrentLocation,
   getTossShareLink: () => getTossShareLink,
   openCamera: () => openCamera,
+  saveBase64Data: () => saveBase64Data,
   setClipboardText: () => setClipboardText,
   setDeviceOrientation: () => setDeviceOrientation
 });
@@ -612,6 +645,19 @@ async function setDeviceOrientation(options) {
   return AppsInTossModule.setDeviceOrientation(options);
 }
 
+// src/native-modules/saveBase64Data.ts
+async function saveBase64Data(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.218.0",
+    ios: "5.216.0"
+  });
+  if (!isSupported) {
+    console.warn("saveBase64Data is not supported in this app version");
+    return;
+  }
+  await AppsInTossModule.saveBase64Data(params);
+}
+
 // src/core/registerApp.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 function AppsInTossContainer(Container, { children, ...initialProps }) {
@@ -630,7 +676,7 @@ function registerApp(container, { context, analytics }) {
     logger: (params) => void eventLog(params),
     debug: analytics?.debug ?? __DEV__
   });
-  return import_react_native_bedrock7.Bedrock.registerApp(AppsInTossContainer.bind(null, container), {
+  return import_react_native_bedrock8.Bedrock.registerApp(AppsInTossContainer.bind(null, container), {
     appName: getAppName(),
     context,
     router: {
@@ -753,7 +799,6 @@ var ENVIRONMENT = getOperationalEnvironment();
 function createIsSupported() {
   return () => {
     if (ENVIRONMENT !== "toss") {
-      console.warn("Google AdMob is not supported in the current environment");
       return false;
     }
     return isMinVersionSupported({
@@ -800,6 +845,32 @@ var Storage = {
   clearItems
 };
 
+// src/native-modules/iap.ts
+async function createOneTimePurchaseOrder(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.219.0",
+    ios: "5.219.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+}
+async function getProductItemList() {
+  const isSupported = isMinVersionSupported({
+    android: "5.219.0",
+    ios: "5.219.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.iapGetProductItemList({});
+}
+var IAP = {
+  createOneTimePurchaseOrder,
+  getProductItemList
+};
+
 // src/native-modules/index.ts
 var TossPay = {
   checkoutPayment
@@ -812,10 +883,11 @@ var GoogleAdMob = {
 };
 
 // src/components/WebView.tsx
-var import_react_native14 = require("@toss-design-system/react-native");
+var import_react_native15 = require("@toss-design-system/react-native");
 var import_private = require("@toss-design-system/react-native/private");
-var import_react6 = require("react");
-var import_react_native_bedrock10 = require("react-native-bedrock");
+var import_react7 = require("react");
+var import_react_native16 = require("react-native");
+var import_react_native_bedrock13 = require("react-native-bedrock");
 var bedrockAsyncBridges = __toESM(require("react-native-bedrock/async-bridges"), 1);
 var bedrockConstantBridges = __toESM(require("react-native-bedrock/constant-bridges"), 1);
 
@@ -825,7 +897,7 @@ var import_react_native12 = require("@toss-design-system/react-native");
 var import_es_hangul = require("es-hangul");
 var import_react4 = require("react");
 var import_react_native13 = require("react-native");
-var import_react_native_bedrock8 = require("react-native-bedrock");
+var import_react_native_bedrock9 = require("react-native-bedrock");
 
 // src/components/GameWebViewNavigationBar/GameNavigationBar.tsx
 var import_react_native_svg = require("@react-native-bedrock/native/react-native-svg");
@@ -936,14 +1008,14 @@ var GameWebView = (0, import_react4.forwardRef)(function GameWebView2(props, ref
       closeOnDimmerClick: true
     });
     if (isConfirmed) {
-      (0, import_react_native_bedrock8.closeView)();
+      (0, import_react_native_bedrock9.closeView)();
     }
   }, [brandDisplayName, openConfirm]);
   (0, import_react4.useEffect)(() => {
     if (import_react_native13.Platform.OS === "ios") {
-      (0, import_react_native_bedrock8.setIosSwipeGestureEnabled)({ isEnabled: false });
+      (0, import_react_native_bedrock9.setIosSwipeGestureEnabled)({ isEnabled: false });
       return () => {
-        (0, import_react_native_bedrock8.setIosSwipeGestureEnabled)({ isEnabled: true });
+        (0, import_react_native_bedrock9.setIosSwipeGestureEnabled)({ isEnabled: true });
       };
     }
     return;
@@ -1105,8 +1177,63 @@ __export(event_bridges_exports, {
   startUpdateLocation: () => startUpdateLocation
 });
 
+// src/hooks/useCreateUserAgent.ts
+var import_react_native14 = require("react-native");
+var import_react_native_bedrock10 = require("react-native-bedrock");
+function useCreateUserAgent({
+  batteryModePreference,
+  colorPreference,
+  fontA11y,
+  locale,
+  navbarPreference,
+  pureSafeArea,
+  safeArea,
+  safeAreaBottomTransparency
+}) {
+  const platform = (0, import_react_native_bedrock10.getPlatformOS)();
+  const appVersion = getTossAppVersion();
+  const fontScale = (0, import_react_native14.useWindowDimensions)().fontScale;
+  const platformString = platform === "ios" ? "iPhone" : "Android";
+  return [
+    `TossApp/${appVersion}`,
+    batteryModePreference && `TossBatteryModePreference/${batteryModePreference}`,
+    colorPreference && `TossColorPreference/${colorPreference}`,
+    fontA11y && `TossFontAccessibility/${fontA11y}`,
+    fontScale && `TossFontScale/${fontScale}`,
+    locale && `TossLocale/${locale}`,
+    navbarPreference && `TossNavbarPreference/${navbarPreference}`,
+    pureSafeArea && `TossPureSafeArea/${pureSafeArea}`,
+    safeArea && `TossSafeArea/${safeArea}`,
+    safeAreaBottomTransparency && `TossSafeAreaBottomTransparency/${safeAreaBottomTransparency}`,
+    platformString
+  ].filter(Boolean).join(" ");
+}
+
+// src/hooks/useGeolocation.ts
+var import_react6 = require("react");
+var import_react_native_bedrock11 = require("react-native-bedrock");
+function useGeolocation({ accuracy, distanceInterval, timeInterval }) {
+  const isVisible = (0, import_react_native_bedrock11.useVisibility)();
+  const [location, setLocation] = (0, import_react6.useState)(null);
+  (0, import_react6.useEffect)(() => {
+    if (!isVisible) {
+      return;
+    }
+    return startUpdateLocation({
+      options: {
+        accuracy,
+        distanceInterval,
+        timeInterval
+      },
+      onEvent: setLocation,
+      onError: console.error
+    });
+  }, [accuracy, distanceInterval, timeInterval, isVisible]);
+  return location;
+}
+
 // src/utils/log.ts
-var import_react_native_bedrock9 = require("react-native-bedrock");
+var import_react_native_bedrock12 = require("react-native-bedrock");
 
 // src/utils/extractDateFromUUIDv7.ts
 var extractDateFromUUIDv7 = (uuid) => {
@@ -1132,7 +1259,7 @@ var getGroupId = (url) => {
 };
 var getReferrer = () => {
   try {
-    const referrer = new URL((0, import_react_native_bedrock9.getSchemeUri)());
+    const referrer = new URL((0, import_react_native_bedrock12.getSchemeUri)());
     return referrer.searchParams.get("referrer");
   } catch {
     return "";
@@ -1159,13 +1286,13 @@ var appsInTossGlobals = getAppsInTossGlobals();
 var operationalEnvironment = getOperationalEnvironment();
 var TYPES = ["partner", "external", "game"];
 var WEBVIEW_TYPES = {
-  partner: import_react_native14.PartnerWebViewScreen,
-  external: import_react_native14.ExternalWebViewScreen,
+  partner: import_react_native15.PartnerWebViewScreen,
+  external: import_react_native15.ExternalWebViewScreen,
   game: GameWebView
 };
 function mergeSchemeQueryParamsInto(url) {
   const baseUrl = new URL(url);
-  const schemeUrl = new URL((0, import_react_native_bedrock10.getSchemeUri)());
+  const schemeUrl = new URL((0, import_react_native_bedrock13.getSchemeUri)());
   baseUrl.pathname = schemeUrl.pathname;
   for (const [key, value] of schemeUrl.searchParams.entries()) {
     baseUrl.searchParams.set(key, value);
@@ -1189,10 +1316,11 @@ function WebView({ type, local, onMessage, ...props }) {
   if (!TYPES.includes(type)) {
     throw new Error(`Invalid WebView type: '${type}'`);
   }
-  const bedrockEvent = (0, import_react_native_bedrock10.useBedrockEvent)();
-  const uri = (0, import_react6.useMemo)(() => getWebViewUri(local), [local]);
+  const bedrockEvent = (0, import_react_native_bedrock13.useBedrockEvent)();
+  const uri = (0, import_react7.useMemo)(() => getWebViewUri(local), [local]);
   const top = (0, import_private.useSafeAreaTop)();
   const bottom = (0, import_private.useSafeAreaBottom)();
+  const global2 = getAppsInTossGlobals();
   const handler = useBridgeHandler({
     onMessage,
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -1214,6 +1342,7 @@ function WebView({ type, local, onMessage, ...props }) {
       ...constant_bridges_exports,
       getSafeAreaTop: () => top,
       getSafeAreaBottom: () => bottom,
+      ...Object.fromEntries(Object.entries(global2).map(([key, value]) => [key, () => value])),
       /** AdMob */
       loadAdMobInterstitialAd_isSupported: GoogleAdMob.loadAdMobInterstitialAd.isSupported,
       showAdMobInterstitialAd_isSupported: GoogleAdMob.showAdMobInterstitialAd.isSupported,
@@ -1231,10 +1360,13 @@ function WebView({ type, local, onMessage, ...props }) {
       getStorageItem: Storage.getItem,
       setStorageItem: Storage.setItem,
       removeStorageItem: Storage.removeItem,
-      clearItems: Storage.clearItems
+      clearItems: Storage.clearItems,
+      /** IAP */
+      iapCreateOneTimePurchaseOrder: IAP.createOneTimePurchaseOrder,
+      iapGetProductItemList: IAP.getProductItemList
     }
   });
-  const baseProps = (0, import_react6.useMemo)(() => {
+  const baseProps = (0, import_react7.useMemo)(() => {
     switch (type) {
       case "partner": {
         const headerOnlyProp = {
@@ -1265,18 +1397,28 @@ function WebView({ type, local, onMessage, ...props }) {
   }, [type, props]);
   const BaseWebView = WEBVIEW_TYPES[type];
   const webViewDebuggingEnabled = operationalEnvironment === "sandbox";
-  const handleNavigationStateChange = (0, import_react6.useCallback)((event) => {
+  const handleNavigationStateChange = (0, import_react7.useCallback)((event) => {
     if (event.url) {
       trackScreen(event.url);
     }
   }, []);
+  const userAgent = useCreateUserAgent({
+    colorPreference: "light"
+  });
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
     BaseWebView,
     {
       ref: handler.ref,
       ...props,
       ...baseProps,
-      source: { uri },
+      source: {
+        uri,
+        // NOTE: https://github.com/react-native-webview/react-native-webview/pull/3133
+        headers: {
+          "User-Agent": userAgent
+        }
+      },
+      userAgent: import_react_native16.Platform.OS === "ios" ? userAgent : void 0,
       sharedCookiesEnabled: true,
       webviewDebuggingEnabled: webViewDebuggingEnabled,
       thirdPartyCookiesEnabled: true,
@@ -1294,29 +1436,6 @@ function ensureValue(value, name) {
   return value;
 }
 
-// src/hooks/useGeolocation.ts
-var import_react7 = require("react");
-var import_react_native_bedrock11 = require("react-native-bedrock");
-function useGeolocation({ accuracy, distanceInterval, timeInterval }) {
-  const isVisible = (0, import_react_native_bedrock11.useVisibility)();
-  const [location, setLocation] = (0, import_react7.useState)(null);
-  (0, import_react7.useEffect)(() => {
-    if (!isVisible) {
-      return;
-    }
-    return startUpdateLocation({
-      options: {
-        accuracy,
-        distanceInterval,
-        timeInterval
-      },
-      onEvent: setLocation,
-      onError: console.error
-    });
-  }, [accuracy, distanceInterval, timeInterval, isVisible]);
-  return location;
-}
-
 // src/types.ts
 var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
   Accuracy3[Accuracy3["Lowest"] = 1] = "Lowest";
@@ -1328,6 +1447,14 @@ var Accuracy2 = /* @__PURE__ */ ((Accuracy3) => {
   return Accuracy3;
 })(Accuracy2 || {});
 
+// src/native-event-emitter/internal/onVisibilityChangedByTransparentServiceWeb.ts
+function onVisibilityChangedByTransparentServiceWeb(eventParams) {
+  return appsInTossEvent.addEventListener("onVisibilityChangedByTransparentServiceWeb", eventParams);
+}
+
+// src/private.ts
+var INTERNAL__onVisibilityChangedByTransparentServiceWeb = onVisibilityChangedByTransparentServiceWeb;
+
 // src/index.ts
 __reExport(src_exports, require("@apps-in-toss/analytics"), module.exports);
 var Analytics2 = {
@@ -1342,6 +1469,8 @@ var Analytics2 = {
   Analytics,
   AppsInToss,
   GoogleAdMob,
+  IAP,
+  INTERNAL__onVisibilityChangedByTransparentServiceWeb,
   Storage,
   TossPay,
   WebView,
@@ -1359,9 +1488,11 @@ var Analytics2 = {
   getTossShareLink,
   isMinVersionSupported,
   openCamera,
+  saveBase64Data,
   setClipboardText,
   setDeviceOrientation,
   startUpdateLocation,
+  useCreateUserAgent,
   useGeolocation,
   ...require("@apps-in-toss/analytics")
 });

package/dist/index.d.cts

@@ -1716,6 +1716,204 @@ declare function setDeviceOrientation(options: {
     type: 'portrait' | 'landscape';
 }): Promise<void>;
 
+interface SaveBase64DataParams {
+    data: string;
+    fileName: string;
+    mimeType: string;
+}
+/**
+ * @public
+ * @category 데이터
+ * @name saveBase64Data
+ * @description 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요. 이미지, 텍스트, PDF 등 다양한 형식의 데이터를 저장할 수 있어요.
+ * @param {SaveBase64DataParams} params - 저장할 데이터와 파일 정보를 담은 객체예요.
+ * @param {string} params.data - Base64 형식으로 인코딩된 데이터 문자열이에요.
+ * @param {string} params.fileName - 저장할 파일 이름이에요. 확장자도 같이 붙여줘야해요. 예를 들어, 'example.png'로 저장할 수 있어요.
+ * @param {string} params.mimeType - 저장할 파일의 MIME 타입이에요. 예를 들어 'image/png' 로 지정하면 이미지, 'application/pdf'는 PDF 파일이에요. 자세한 내용은 [MIME 문서](https://developer.mozilla.org/ko/docs/Web/HTTP/Guides/MIME_types)를 참고해주세요.
+ *
+ * @example
+ * ### Base64 이미지 데이터를 사용자 기기에 저장하기
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { saveBase64Data } from '@apps-in-toss/framework';
+ *
+ * // '저장' 버튼을 누르면 이미지가 사용자 기기에 저장돼요.
+ * function SaveButton() {
+ *   const handleSave = async () => {
+ *     try {
+ *       await saveBase64Data({
+ *         data: 'iVBORw0KGgo...',
+ *         fileName: 'some-photo.png',
+ *         mimeType: 'image/png',
+ *       });
+ *     } catch (error) {
+ *       console.error('데이터 저장에 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return <Button title="저장" onPress={handleSave} />;
+ * }
+ * ```
+ */
+declare function saveBase64Data(params: SaveBase64DataParams): Promise<void>;
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
+ * @property {string} productId - 주문할 상품의 ID예요.
+ */
+interface IapCreateOneTimePurchaseOrderOptions {
+    productId: string;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderResult
+ * @description 인앱결제 1건이 완료되면 결제 세부 정보와 상품 정보를 담아 반환해요. 반환된 정보로 결제한 상품의 정보를 화면에 표시할 수 있어요.
+ * @property {string | null} miniAppIconUrl - 미니앱 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요. 콘솔에서 아이콘을 등록하지 않았다면 `null`로 반환돼요.
+ * @property {string} displayName - 화면에 표시할 상품 이름이에요.
+ * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
+ * @property {number} amount - 상품 가격 숫자 값이에요. 화폐 단위와 쉼표를 제외한 순수 숫자예요. 예를 들어 `1000`으로 표시돼요.
+ * @property {string} currency - [ISO 4217 표준](https://ko.wikipedia.org/wiki/ISO_4217)에 따른 상품 가격 통화 단위예요. 예를 들어 원화는 `KRW`, 달러는 `USD`로 표시돼요.
+ * @property {number} fraction - 가격을 표시할 때 소수점 아래 몇 자리까지 보여줄지 정하는 값이에요. 예를 들어 달러는 소수점 둘째 자리까지 보여줘서 `2`, 원화는 소수점이 필요 없어서 `0`이에요
+ */
+interface IapCreateOneTimePurchaseOrderResult {
+    miniAppIconUrl: string | null;
+    displayName: string;
+    displayAmount: string;
+    amount: number;
+    currency: string;
+    fraction: number;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name iapCreateOneTimePurchaseOrder
+ * @description
+ * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
+ * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
+ * @param {string} params.productId - 주문할 상품의 ID예요.
+ * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+ *
+ * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
+ * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
+ * @throw {code: "NETWORK_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
+ * @throw {code: "INVALID_USER_ENVIRONMENT"} - 특정 기기, 계정 또는 설정 환경에서 구매할 수 없는 상품일 때 발생해요.
+ * @throw {code: "ITEM_ALREADY_OWNED"} - 사용자가 이미 구매한 상품을 다시 구매하려고 할 때 발생해요.
+ * @throw {code: "APP_MARKET_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 앱스토어에서 사용자 정보 검증에 실패했을 때 발생해요. 사용자가 앱스토어에 문의해서 환불을 요청해야해요.
+ * @throw {code: "TOSS_SERVER_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 서버 전송에 실패해서 결제 정보를 저장할 수 없을 때 발생해요.
+ * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
+ * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
+ * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ *
+ * @example
+ * ### 특정 인앱결제 주문서 페이지로 이동하기
+ *
+ * ```tsx
+ * import { Button } from 'react-native';
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * interface Props {
+ *   productId: string;
+ * }
+ *
+ * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
+ *   const handleClick = async () => {
+ *     try {
+ *       await IAP.createOneTimePurchaseOrder({
+ *         productId,
+ *       });
+ *     } catch (error) {
+ *       console.error('인앱결제에 실패했어요:', error);
+ *     }
+ *   };
+ *
+ *   return <Button title="구매하기" onPress={handleClick} />;
+ * }
+ * ```
+ */
+declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): Promise<IapCreateOneTimePurchaseOrderResult | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapProductListItem
+ * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
+ * @property {string} sku - 상품의 고유 ID예요. [인앱결제 주문서 페이지로 이동할때](/bedrock/reference/framework/인앱결제/createOneTimePurchaseOrder.html) 사용하는 `productId`와 동일한 값이에요.
+ * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
+ * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
+ * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
+ * @property {string} description - 상품에 대한 설명이에요. 설명은 앱인토스 콘솔에서 설정한 값이에요.
+ */
+interface IapProductListItem {
+    sku: string;
+    displayAmount: string;
+    displayName: string;
+    iconUrl: string;
+    description: string;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name iapGetProductItemList
+ * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
+ * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 구매 가능한 인앱결제 상품목록 가져오기
+ *
+ * ```tsx
+ * import { useEffect, useState } from 'react';
+ * import { List, ListRow, Txt } from '@toss-design-system/react-native';
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * function IapGetProductItemList() {
+ *   const [products, setProducts] = useState<IapProductListItem[]>([]);
+ *
+ *   useEffect(() => {
+ *     async function fetchProducts() {
+ *       try {
+ *         const response = await IAP.getProductItemList();
+ *         setProducts(response?.products ?? []);
+ *       } catch (error) {
+ *         console.error('상품 목록을 가져오는 데 실패했어요:', error);
+ *       }
+ *     }
+ *
+ *     fetchProducts();
+ *   }, []);
+ *
+ *   return (
+ *     <List>
+ *       {products.map((product) => (
+ *         <ListRow
+ *           key={product.sku}
+ *           contents={<Txt>{product.displayName}</Txt>}
+ *         />
+ *       ))}
+ *     </List>
+ *   );
+ * }
+ * ```
+ */
+declare function getProductItemList(): Promise<{
+    products: IapProductListItem[];
+} | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name IAP
+ * @description 인앱결제 관련 기능을 모은 객체예요. 단건 인앱결제 주문서 이동과 상품 목록 조회 기능을 제공해요.
+ * @property {typeof createOneTimePurchaseOrder} [createOneTimePurchaseOrder] 특정 인앱결제 주문서 페이지로 이동해요. 자세한 내용은 [createOneTimePurchaseOrder](/bedrock/reference/framework/인앱결제/createOneTimePurchaseOrder.html) 문서를 참고하세요.
+ * @property {typeof getProductItemList} [getProductItemList] 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 자세한 내용은 [getProductItemList](/bedrock/reference/framework/인앱결제/getProductItemList.html) 문서를 참고하세요.
+ */
+declare const IAP: {
+    createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
+    getProductItemList: typeof getProductItemList;
+};
+
 /**
  * @public
  * @category 토스페이
@@ -1765,6 +1963,17 @@ interface LocalNetwork {
 type InternalProps = 'source' | 'cacheEnabled' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded';
 declare function WebView({ type, local, onMessage, ...props }: WebViewProps): react_jsx_runtime.JSX.Element;
 
+declare function useCreateUserAgent({ batteryModePreference, colorPreference, fontA11y, locale, navbarPreference, pureSafeArea, safeArea, safeAreaBottomTransparency, }: {
+    batteryModePreference?: string;
+    colorPreference?: string;
+    fontA11y?: string;
+    locale?: string;
+    navbarPreference?: string;
+    pureSafeArea?: string;
+    safeArea?: string;
+    safeAreaBottomTransparency?: string;
+}): string;
+
 type UseGeolocationOptions = Omit<StartUpdateLocationOptions$1, 'callback'>;
 /**
  * @public
@@ -1859,7 +2068,26 @@ declare class AppBridgeCallbackEvent extends BedrockEventDefinition<void, AppBri
     private ensureInvokeAppBridgeCallback;
 }
 
-declare const appsInTossEvent: BedrockEvent<EntryMessageExitedEvent | AppBridgeCallbackEvent | UpdateLocationEvent>;
+interface VisibilityChangedByTransparentServiceWebOptions {
+    callbackId: string;
+}
+declare class VisibilityChangedByTransparentServiceWebEvent extends BedrockEventDefinition<VisibilityChangedByTransparentServiceWebOptions, boolean> {
+    name: "onVisibilityChangedByTransparentServiceWeb";
+    subscription: EmitterSubscription | null;
+    remove(): void;
+    listener(options: VisibilityChangedByTransparentServiceWebOptions, onEvent: (isVisible: boolean) => void, onError: (error: unknown) => void): void;
+    private isVisibilityChangedByTransparentServiceWebResult;
+}
+
+declare const appsInTossEvent: BedrockEvent<EntryMessageExitedEvent | VisibilityChangedByTransparentServiceWebEvent | UpdateLocationEvent | AppBridgeCallbackEvent>;
+
+declare function onVisibilityChangedByTransparentServiceWeb(eventParams: {
+    options: VisibilityChangedByTransparentServiceWebOptions;
+    onEvent: (isVisible: boolean) => void;
+    onError: (error: unknown) => void;
+}): () => void;
+
+declare const INTERNAL__onVisibilityChangedByTransparentServiceWeb: typeof onVisibilityChangedByTransparentServiceWeb;
 
 declare const Analytics: {
     init: (options: _apps_in_toss_analytics.AnalyticsConfig) => void;
@@ -1868,4 +2096,4 @@ declare const Analytics: {
     Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
 };
 
-export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, setDeviceOrientation, startUpdateLocation, useGeolocation };
+export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, IAP, INTERNAL__onVisibilityChangedByTransparentServiceWeb, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type SaveBase64DataParams, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, saveBase64Data, setClipboardText, setDeviceOrientation, startUpdateLocation, useCreateUserAgent, useGeolocation };