@apps-in-toss/framework 1.12.0 → 1.14.0

package/README.md

@@ -1,6 +1,25 @@
 # @apps-in-toss/framework
 
-Hub package for Apps In Toss
+react-native framework for building [apps in toss](https://toss.im/apps-in-toss) services.
+
+## Install
+
+```bash
+# yarn
+yarn add @apps-in-toss/framework
+
+# npm
+npm install @apps-in-toss/framework
+
+# pnpm
+pnpm add @apps-in-toss/framework
+```
+
+## Links
+
+- [Document](https://developers-apps-in-toss.toss.im) 
+- [Support](https://techchat-apps-in-toss.toss.im)
+- [Examples](https://github.com/toss/apps-in-toss-examples)
 
 ## License
 

package/dist/index.cjs

@@ -38,7 +38,9 @@ __export(src_exports, {
   OverlayProvider: () => import_private10.OverlayProvider,
   WebView: () => WebView,
   env: () => env,
+  homeEvent: () => homeEvent,
   loadFullScreenAd: () => loadFullScreenAd,
+  safeAreaInsetsChange: () => safeAreaInsetsChange,
   showFullScreenAd: () => showFullScreenAd,
   useCreateUserAgent: () => useCreateUserAgent,
   useGeolocation: () => useGeolocation,
@@ -741,6 +743,46 @@ function useCloseConfirm() {
   );
 }
 
+// src/utils/eventEmitter.ts
+var EventEmitter = class {
+  listeners = {};
+  subscribe(event, listener) {
+    if (!this.listeners[event]) {
+      this.listeners[event] = [];
+    }
+    this.listeners[event].push(listener);
+    return () => {
+      this.listeners[event] = this.listeners[event]?.filter((l) => l !== listener) ?? [];
+    };
+  }
+  hasSubscriptions(event) {
+    return this.listeners[event] != null && this.listeners[event].length > 0;
+  }
+  clearSubscriptions(event) {
+    this.listeners[event] = [];
+  }
+  emit(event, ...args) {
+    if (!this.listeners[event]) {
+      return;
+    }
+    this.listeners[event].forEach((listener) => listener(...args));
+  }
+};
+var eventEmitter = new EventEmitter();
+function createEvent(event) {
+  return {
+    name: event,
+    subscribe: (listener) => eventEmitter.subscribe(event, listener),
+    hasSubscriptions: () => eventEmitter.hasSubscriptions(event),
+    clearSubscriptions: () => eventEmitter.clearSubscriptions(event),
+    emit: (data) => eventEmitter.emit(event, data)
+  };
+}
+
+// src/events.ts
+var homeEvent = createEvent("homeEvent");
+var safeAreaInsetsChange = createEvent("safeAreaInsetsChange");
+
 // src/components/NavigationBar/common/useNavigationBarLogging.tsx
 var import_native_modules7 = require("@apps-in-toss/native-modules");
 var import_react_native13 = require("@granite-js/react-native");
@@ -855,7 +897,11 @@ function useNavigationEvent() {
       },
       handleHomeButtonClick: () => {
         logging.homeButtonClick();
-        navigation.navigate("/");
+        if (homeEvent.hasSubscriptions()) {
+          homeEvent.emit({});
+        } else {
+          navigation.navigate("/");
+        }
       },
       handleCloseButtonClick: () => {
         logging.closeButtonClick();
@@ -1083,11 +1129,11 @@ function HomeShortcutMenu() {
   );
 }
 
-// src/core/hooks/useMoreButtonBottomSheet/PermissionsMenu.tsx
+// src/core/hooks/useMoreButtonBottomSheet/SettingsMenu.tsx
 var import_native_modules11 = require("@apps-in-toss/native-modules");
 var import_react_native20 = require("@granite-js/react-native");
 var import_jsx_runtime8 = require("react/jsx-runtime");
-function PermissionsMenu() {
+function SettingsMenu() {
   const globals = getAppsInTossGlobals();
   if ((0, import_native_modules11.getOperationalEnvironment)() === "sandbox") {
     return null;
@@ -1095,10 +1141,10 @@ function PermissionsMenu() {
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
     Menu,
     {
-      title: "\uAD8C\uD55C \uC124\uC815",
+      title: "\uC124\uC815",
       iconURL: "https://static.toss.im/icons/png/4x/icon-setting-mono.png",
       onPress: () => (0, import_react_native20.openURL)(
-        `servicetoss://apps-in-toss-menu/permissions?appName=${import_react_native20.Granite.appName}&displayAppName=${globals.brandDisplayName}`
+        `servicetoss://apps-in-toss-menu/settings?appName=${import_react_native20.Granite.appName}&displayAppName=${globals.brandDisplayName}`
       )
     }
   );
@@ -1128,7 +1174,7 @@ var MIN_VERSION = {
     android: "5.246.0",
     ios: "5.246.0"
   },
-  PERMISSIONS_MENU: {
+  SETTINGS_MENU: {
     android: "5.238.0",
     ios: "5.237.0"
   }
@@ -1144,7 +1190,7 @@ function useMoreButtonBottomSheet() {
   const isHomeShortcutSupported = (0, import_native_modules12.isMinVersionSupported)(MIN_VERSION.HOME_SHORTCUT_MENU);
   const isBottomSheetSupported = (0, import_native_modules12.isMinVersionSupported)(MIN_VERSION.BOTTOM_SHEET);
   const isShareListMenuSupported = (0, import_native_modules12.isMinVersionSupported)(MIN_VERSION.SHARE_LIST_MENU);
-  const [isPermissionsMenuSupported, setIsPermissionsMenuSupported] = (0, import_react15.useState)(false);
+  const isSettingsMenuSupported = (0, import_native_modules12.isMinVersionSupported)(MIN_VERSION.SETTINGS_MENU);
   (0, import_react15.useEffect)(() => {
     if (!isBottomSheetSupported) {
       return;
@@ -1157,16 +1203,6 @@ function useMoreButtonBottomSheet() {
         onError: (error) => console.error("\uBA54\uB274 \uBAA9\uB85D\uC744 \uAC00\uC838\uC624\uB294 \uB370 \uC2E4\uD328\uD588\uC5B4\uC694:", error)
       }
     );
-    if ((0, import_native_modules12.isMinVersionSupported)(MIN_VERSION.PERMISSIONS_MENU)) {
-      import_native_modules12.INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
-        "getAllPermission",
-        {},
-        {
-          onSuccess: (permissions) => setIsPermissionsMenuSupported(permissions.length > 0),
-          onError: (error) => console.error("\uAD8C\uD55C \uBAA9\uB85D\uC744 \uAC00\uC838\uC624\uB294 \uB370 \uC2E4\uD328\uD588\uC5B4\uC694:", error)
-        }
-      );
-    }
   }, [isBottomSheetSupported]);
   const onClickHandler = async () => {
     logging.open();
@@ -1218,7 +1254,7 @@ function useMoreButtonBottomSheet() {
             )),
             isHomeShortcutSupported && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(HomeShortcutMenu, {}),
             isShareListMenuSupported && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(AppShareListMenu, {}),
-            isPermissionsMenuSupported && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(PermissionsMenu, {})
+            isSettingsMenuSupported && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(SettingsMenu, {})
           ] })
         }
       ) });
@@ -2105,40 +2141,18 @@ function parseNativeEventData(data) {
   }
 }
 
-// src/core/hooks/useSafeAreaInsetsEmitter.tsx
+// src/core/hooks/useSafeAreaInsetsEvent.tsx
 var import_react_native_safe_area_context3 = require("@granite-js/native/react-native-safe-area-context");
 var import_react23 = require("react");
-var EventEmitter = class {
-  listeners = {};
-  on(event, listener) {
-    if (!this.listeners[event]) {
-      this.listeners[event] = [];
-    }
-    this.listeners[event].push(listener);
-  }
-  emit(event, ...args) {
-    if (!this.listeners[event]) {
-      return;
-    }
-    this.listeners[event].forEach((listener) => listener(...args));
-  }
-  off(event, listener) {
-    if (!this.listeners[event]) {
-      return;
-    }
-    this.listeners[event] = this.listeners[event].filter((l) => l !== listener);
-  }
-};
-function useSafeAreaInsetsEmitter() {
+function useSafeAreaInsetsEvent() {
   const insets = (0, import_react_native_safe_area_context3.useSafeAreaInsets)();
-  const emitter = (0, import_react23.useMemo)(() => new EventEmitter(), []);
   (0, import_react23.useEffect)(() => {
-    emitter.emit("safeAreaInsetsChange", insets);
-    return () => {
-      emitter.off("safeAreaInsetsChange", (listener) => listener(insets));
-    };
-  }, [emitter, insets]);
-  return emitter;
+    safeAreaInsetsChange.emit(insets);
+  }, [insets]);
+  (0, import_react23.useEffect)(() => {
+    return () => safeAreaInsetsChange.clearSubscriptions();
+  }, []);
+  return safeAreaInsetsChange;
 }
 
 // src/core/hooks/useWebBackHandler.tsx
@@ -2251,10 +2265,8 @@ function useWebBackHandler(webViewInitialURL, webViewRef) {
   ]);
   const handleWebHome = (0, import_react25.useCallback)(() => {
     logging.homeButtonClick();
-    if (hasWebBackEvent) {
-      for (const handler of webBackHandlersRef) {
-        handler();
-      }
+    if (homeEvent.hasSubscriptions()) {
+      homeEvent.emit({});
       return;
     }
     webViewRef.current?.injectJavaScript(`
@@ -2631,7 +2643,7 @@ function WebView({ type, local, onMessage, ...props }) {
   const insets = (0, import_react_native_safe_area_context4.useSafeAreaInsets)();
   const global2 = getAppsInTossGlobals();
   const navigationBarContext = useNavigationBarContext();
-  const safeAreaInsetsEmitter = useSafeAreaInsetsEmitter();
+  const safeAreaInsetsEvent = useSafeAreaInsetsEvent();
   const [allowsBackForwardNavigationGestures, setAllowsBackForwardNavigationGestures] = (0, import_react28.useState)(
     props.allowsBackForwardNavigationGestures
   );
@@ -2646,13 +2658,9 @@ function WebView({ type, local, onMessage, ...props }) {
           webBackHandler.removeEventListener(onEvent);
         };
       },
+      homeEvent: ({ onEvent }) => homeEvent.subscribe(onEvent),
       updateLocationEvent: ({ onEvent, onError, options }) => import_native_modules24.appsInTossEvent.addEventListener("updateLocationEvent", { onEvent, onError, options }),
-      safeAreaInsetsChange: ({ onEvent }) => {
-        safeAreaInsetsEmitter.on("safeAreaInsetsChange", onEvent);
-        return () => {
-          safeAreaInsetsEmitter.off("safeAreaInsetsChange", onEvent);
-        };
-      },
+      safeAreaInsetsChange: ({ onEvent }) => safeAreaInsetsEvent.subscribe(onEvent),
       /** @internal */
       appBridgeCallbackEvent: ({ onEvent, onError, options }) => import_native_modules24.appsInTossEvent.addEventListener("appBridgeCallbackEvent", { onEvent, onError, options }),
       /** AdMobV2 */
@@ -4096,7 +4104,9 @@ var Analytics2 = {
   OverlayProvider,
   WebView,
   env,
+  homeEvent,
   loadFullScreenAd,
+  safeAreaInsetsChange,
   showFullScreenAd,
   useCreateUserAgent,
   useGeolocation,

package/dist/index.d.cts

@@ -9,6 +9,7 @@ import { ExternalWebViewScreenProps } from '@toss/tds-react-native';
 import { StartUpdateLocationOptions, Location, LoadFullScreenAdParams, ShowFullScreenAdParams } from '@apps-in-toss/types';
 export * from '@apps-in-toss/types';
 export { FetchTossAdOptions, LoadFullScreenAdEvent, LoadFullScreenAdOptions, LoadFullScreenAdParams, ShowFullScreenAdEvent, ShowFullScreenAdOptions, ShowFullScreenAdParams, TossAdEventLogParams } from '@apps-in-toss/types';
+import { EdgeInsets } from '@granite-js/native/react-native-safe-area-context';
 import { onVisibilityChangedByTransparentServiceWeb } from '@apps-in-toss/native-modules';
 export * from '@apps-in-toss/native-modules';
 export { OverlayProvider, useOverlay } from '@toss/tds-react-native/private';
@@ -171,6 +172,21 @@ declare const env: {
     getAppName: () => string;
 };
 
+declare const homeEvent: {
+    name: string;
+    subscribe: (listener: (data: any) => void) => () => void;
+    hasSubscriptions: () => boolean;
+    clearSubscriptions: () => void;
+    emit: (data: any) => void;
+};
+declare const safeAreaInsetsChange: {
+    name: string;
+    subscribe: (listener: (data: EdgeInsets) => void) => () => void;
+    hasSubscriptions: () => boolean;
+    clearSubscriptions: () => void;
+    emit: (data: EdgeInsets) => void;
+};
+
 declare const INTERNAL__onVisibilityChangedByTransparentServiceWeb: typeof onVisibilityChangedByTransparentServiceWeb;
 
 declare const loadFullScreenAd: {
@@ -238,4 +254,4 @@ declare const Analytics: {
     Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
 };
 
-export { type AdError, Analytics, AppsInToss, type BannerSlotCallbacks, type BannerSlotErrorPayload, type BannerSlotEventPayload, type ExternalWebViewProps, type GameWebViewProps, INTERNAL__onVisibilityChangedByTransparentServiceWeb, InlineAd, type InlineAdProps, type InlineAdTheme, type InlineAdTone, type InlineAdVariant, type PartnerWebViewProps, type UseGeolocationOptions, WebView, type WebViewProps, env, loadFullScreenAd, showFullScreenAd, useCreateUserAgent, useGeolocation, useTopNavigation, useWaitForReturnNavigator };
+export { type AdError, Analytics, AppsInToss, type BannerSlotCallbacks, type BannerSlotErrorPayload, type BannerSlotEventPayload, type ExternalWebViewProps, type GameWebViewProps, INTERNAL__onVisibilityChangedByTransparentServiceWeb, InlineAd, type InlineAdProps, type InlineAdTheme, type InlineAdTone, type InlineAdVariant, type PartnerWebViewProps, type UseGeolocationOptions, WebView, type WebViewProps, env, homeEvent, loadFullScreenAd, safeAreaInsetsChange, showFullScreenAd, useCreateUserAgent, useGeolocation, useTopNavigation, useWaitForReturnNavigator };

package/dist/index.d.ts

@@ -9,6 +9,7 @@ import { ExternalWebViewScreenProps } from '@toss/tds-react-native';
 import { StartUpdateLocationOptions, Location, LoadFullScreenAdParams, ShowFullScreenAdParams } from '@apps-in-toss/types';
 export * from '@apps-in-toss/types';
 export { FetchTossAdOptions, LoadFullScreenAdEvent, LoadFullScreenAdOptions, LoadFullScreenAdParams, ShowFullScreenAdEvent, ShowFullScreenAdOptions, ShowFullScreenAdParams, TossAdEventLogParams } from '@apps-in-toss/types';
+import { EdgeInsets } from '@granite-js/native/react-native-safe-area-context';
 import { onVisibilityChangedByTransparentServiceWeb } from '@apps-in-toss/native-modules';
 export * from '@apps-in-toss/native-modules';
 export { OverlayProvider, useOverlay } from '@toss/tds-react-native/private';
@@ -171,6 +172,21 @@ declare const env: {
     getAppName: () => string;
 };
 
+declare const homeEvent: {
+    name: string;
+    subscribe: (listener: (data: any) => void) => () => void;
+    hasSubscriptions: () => boolean;
+    clearSubscriptions: () => void;
+    emit: (data: any) => void;
+};
+declare const safeAreaInsetsChange: {
+    name: string;
+    subscribe: (listener: (data: EdgeInsets) => void) => () => void;
+    hasSubscriptions: () => boolean;
+    clearSubscriptions: () => void;
+    emit: (data: EdgeInsets) => void;
+};
+
 declare const INTERNAL__onVisibilityChangedByTransparentServiceWeb: typeof onVisibilityChangedByTransparentServiceWeb;
 
 declare const loadFullScreenAd: {
@@ -238,4 +254,4 @@ declare const Analytics: {
     Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
 };
 
-export { type AdError, Analytics, AppsInToss, type BannerSlotCallbacks, type BannerSlotErrorPayload, type BannerSlotEventPayload, type ExternalWebViewProps, type GameWebViewProps, INTERNAL__onVisibilityChangedByTransparentServiceWeb, InlineAd, type InlineAdProps, type InlineAdTheme, type InlineAdTone, type InlineAdVariant, type PartnerWebViewProps, type UseGeolocationOptions, WebView, type WebViewProps, env, loadFullScreenAd, showFullScreenAd, useCreateUserAgent, useGeolocation, useTopNavigation, useWaitForReturnNavigator };
+export { type AdError, Analytics, AppsInToss, type BannerSlotCallbacks, type BannerSlotErrorPayload, type BannerSlotEventPayload, type ExternalWebViewProps, type GameWebViewProps, INTERNAL__onVisibilityChangedByTransparentServiceWeb, InlineAd, type InlineAdProps, type InlineAdTheme, type InlineAdTone, type InlineAdVariant, type PartnerWebViewProps, type UseGeolocationOptions, WebView, type WebViewProps, env, homeEvent, loadFullScreenAd, safeAreaInsetsChange, showFullScreenAd, useCreateUserAgent, useGeolocation, useTopNavigation, useWaitForReturnNavigator };

package/dist/index.js

@@ -707,6 +707,46 @@ function useCloseConfirm() {
   );
 }
 
+// src/utils/eventEmitter.ts
+var EventEmitter = class {
+  listeners = {};
+  subscribe(event, listener) {
+    if (!this.listeners[event]) {
+      this.listeners[event] = [];
+    }
+    this.listeners[event].push(listener);
+    return () => {
+      this.listeners[event] = this.listeners[event]?.filter((l) => l !== listener) ?? [];
+    };
+  }
+  hasSubscriptions(event) {
+    return this.listeners[event] != null && this.listeners[event].length > 0;
+  }
+  clearSubscriptions(event) {
+    this.listeners[event] = [];
+  }
+  emit(event, ...args) {
+    if (!this.listeners[event]) {
+      return;
+    }
+    this.listeners[event].forEach((listener) => listener(...args));
+  }
+};
+var eventEmitter = new EventEmitter();
+function createEvent(event) {
+  return {
+    name: event,
+    subscribe: (listener) => eventEmitter.subscribe(event, listener),
+    hasSubscriptions: () => eventEmitter.hasSubscriptions(event),
+    clearSubscriptions: () => eventEmitter.clearSubscriptions(event),
+    emit: (data) => eventEmitter.emit(event, data)
+  };
+}
+
+// src/events.ts
+var homeEvent = createEvent("homeEvent");
+var safeAreaInsetsChange = createEvent("safeAreaInsetsChange");
+
 // src/components/NavigationBar/common/useNavigationBarLogging.tsx
 import { INTERNAL__module as INTERNAL__module4 } from "@apps-in-toss/native-modules";
 import { Granite as Granite4 } from "@granite-js/react-native";
@@ -821,7 +861,11 @@ function useNavigationEvent() {
       },
       handleHomeButtonClick: () => {
         logging.homeButtonClick();
-        navigation.navigate("/");
+        if (homeEvent.hasSubscriptions()) {
+          homeEvent.emit({});
+        } else {
+          navigation.navigate("/");
+        }
       },
       handleCloseButtonClick: () => {
         logging.closeButtonClick();
@@ -1049,11 +1093,11 @@ function HomeShortcutMenu() {
   );
 }
 
-// src/core/hooks/useMoreButtonBottomSheet/PermissionsMenu.tsx
+// src/core/hooks/useMoreButtonBottomSheet/SettingsMenu.tsx
 import { getOperationalEnvironment as getOperationalEnvironment3 } from "@apps-in-toss/native-modules";
 import { Granite as Granite6, openURL as openURL4 } from "@granite-js/react-native";
 import { jsx as jsx8 } from "react/jsx-runtime";
-function PermissionsMenu() {
+function SettingsMenu() {
   const globals = getAppsInTossGlobals();
   if (getOperationalEnvironment3() === "sandbox") {
     return null;
@@ -1061,10 +1105,10 @@ function PermissionsMenu() {
   return /* @__PURE__ */ jsx8(
     Menu,
     {
-      title: "\uAD8C\uD55C \uC124\uC815",
+      title: "\uC124\uC815",
       iconURL: "https://static.toss.im/icons/png/4x/icon-setting-mono.png",
       onPress: () => openURL4(
-        `servicetoss://apps-in-toss-menu/permissions?appName=${Granite6.appName}&displayAppName=${globals.brandDisplayName}`
+        `servicetoss://apps-in-toss-menu/settings?appName=${Granite6.appName}&displayAppName=${globals.brandDisplayName}`
       )
     }
   );
@@ -1094,7 +1138,7 @@ var MIN_VERSION = {
     android: "5.246.0",
     ios: "5.246.0"
   },
-  PERMISSIONS_MENU: {
+  SETTINGS_MENU: {
     android: "5.238.0",
     ios: "5.237.0"
   }
@@ -1110,7 +1154,7 @@ function useMoreButtonBottomSheet() {
   const isHomeShortcutSupported = isMinVersionSupported2(MIN_VERSION.HOME_SHORTCUT_MENU);
   const isBottomSheetSupported = isMinVersionSupported2(MIN_VERSION.BOTTOM_SHEET);
   const isShareListMenuSupported = isMinVersionSupported2(MIN_VERSION.SHARE_LIST_MENU);
-  const [isPermissionsMenuSupported, setIsPermissionsMenuSupported] = useState4(false);
+  const isSettingsMenuSupported = isMinVersionSupported2(MIN_VERSION.SETTINGS_MENU);
   useEffect6(() => {
     if (!isBottomSheetSupported) {
       return;
@@ -1123,16 +1167,6 @@ function useMoreButtonBottomSheet() {
         onError: (error) => console.error("\uBA54\uB274 \uBAA9\uB85D\uC744 \uAC00\uC838\uC624\uB294 \uB370 \uC2E4\uD328\uD588\uC5B4\uC694:", error)
       }
     );
-    if (isMinVersionSupported2(MIN_VERSION.PERMISSIONS_MENU)) {
-      INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
-        "getAllPermission",
-        {},
-        {
-          onSuccess: (permissions) => setIsPermissionsMenuSupported(permissions.length > 0),
-          onError: (error) => console.error("\uAD8C\uD55C \uBAA9\uB85D\uC744 \uAC00\uC838\uC624\uB294 \uB370 \uC2E4\uD328\uD588\uC5B4\uC694:", error)
-        }
-      );
-    }
   }, [isBottomSheetSupported]);
   const onClickHandler = async () => {
     logging.open();
@@ -1184,7 +1218,7 @@ function useMoreButtonBottomSheet() {
             )),
             isHomeShortcutSupported && /* @__PURE__ */ jsx9(HomeShortcutMenu, {}),
             isShareListMenuSupported && /* @__PURE__ */ jsx9(AppShareListMenu, {}),
-            isPermissionsMenuSupported && /* @__PURE__ */ jsx9(PermissionsMenu, {})
+            isSettingsMenuSupported && /* @__PURE__ */ jsx9(SettingsMenu, {})
           ] })
         }
       ) });
@@ -1426,7 +1460,7 @@ import { useSafeAreaInsets as useSafeAreaInsets4 } from "@granite-js/native/reac
 import { getSchemeUri as getSchemeUri8 } from "@granite-js/react-native";
 import { ExternalWebViewScreen, tdsEvent } from "@toss/tds-react-native";
 import { useSafeAreaBottom, useSafeAreaTop as useSafeAreaTop3 } from "@toss/tds-react-native/private";
-import { useEffect as useEffect13, useMemo as useMemo7, useRef as useRef6, useState as useState6 } from "react";
+import { useEffect as useEffect13, useMemo as useMemo6, useRef as useRef6, useState as useState6 } from "react";
 import { BackHandler as BackHandler2, Linking, NativeModules as NativeModules3, Platform as Platform6 } from "react-native";
 
 // src/components/GameWebView.tsx
@@ -2092,50 +2126,28 @@ function parseNativeEventData(data) {
   }
 }
 
-// src/core/hooks/useSafeAreaInsetsEmitter.tsx
+// src/core/hooks/useSafeAreaInsetsEvent.tsx
 import { useSafeAreaInsets as useSafeAreaInsets3 } from "@granite-js/native/react-native-safe-area-context";
-import { useEffect as useEffect11, useMemo as useMemo4 } from "react";
-var EventEmitter = class {
-  listeners = {};
-  on(event, listener) {
-    if (!this.listeners[event]) {
-      this.listeners[event] = [];
-    }
-    this.listeners[event].push(listener);
-  }
-  emit(event, ...args) {
-    if (!this.listeners[event]) {
-      return;
-    }
-    this.listeners[event].forEach((listener) => listener(...args));
-  }
-  off(event, listener) {
-    if (!this.listeners[event]) {
-      return;
-    }
-    this.listeners[event] = this.listeners[event].filter((l) => l !== listener);
-  }
-};
-function useSafeAreaInsetsEmitter() {
+import { useEffect as useEffect11 } from "react";
+function useSafeAreaInsetsEvent() {
   const insets = useSafeAreaInsets3();
-  const emitter = useMemo4(() => new EventEmitter(), []);
   useEffect11(() => {
-    emitter.emit("safeAreaInsetsChange", insets);
-    return () => {
-      emitter.off("safeAreaInsetsChange", (listener) => listener(insets));
-    };
-  }, [emitter, insets]);
-  return emitter;
+    safeAreaInsetsChange.emit(insets);
+  }, [insets]);
+  useEffect11(() => {
+    return () => safeAreaInsetsChange.clearSubscriptions();
+  }, []);
+  return safeAreaInsetsChange;
 }
 
 // src/core/hooks/useWebBackHandler.tsx
 import { closeView as closeView6, useBackEventState } from "@granite-js/react-native";
 import { useDialog as useDialog7 } from "@toss/tds-react-native";
 import { josa as josa5 } from "es-hangul";
-import { useCallback as useCallback12, useMemo as useMemo6 } from "react";
+import { useCallback as useCallback12, useMemo as useMemo5 } from "react";
 
 // src/hooks/useWebviewHistoryStack.tsx
-import { useCallback as useCallback11, useMemo as useMemo5, useReducer } from "react";
+import { useCallback as useCallback11, useMemo as useMemo4, useReducer } from "react";
 var INITIAL_STATE = { stack: [], index: -1 };
 function reducer(state, action) {
   switch (action.type) {
@@ -2170,7 +2182,7 @@ function useWebViewHistory() {
   const onNavigationStateChange = useCallback11(({ url, canGoForward: canGoForward2 }) => {
     dispatch({ type: "NAVIGATION_CHANGE", url, canGoForward: canGoForward2 });
   }, []);
-  const { canGoBack, canGoForward } = useMemo5(() => {
+  const { canGoBack, canGoForward } = useMemo4(() => {
     const canBack = state.index > 0;
     const canFwd = state.index >= 0 && state.index < state.stack.length - 1;
     return { canGoBack: canBack, canGoForward: canFwd };
@@ -2238,10 +2250,8 @@ function useWebBackHandler(webViewInitialURL, webViewRef) {
   ]);
   const handleWebHome = useCallback12(() => {
     logging.homeButtonClick();
-    if (hasWebBackEvent) {
-      for (const handler of webBackHandlersRef) {
-        handler();
-      }
+    if (homeEvent.hasSubscriptions()) {
+      homeEvent.emit({});
       return;
     }
     webViewRef.current?.injectJavaScript(`
@@ -2251,7 +2261,7 @@ function useWebBackHandler(webViewInitialURL, webViewRef) {
     })();
     `);
   }, [hasWebBackEvent, webBackHandlersRef, logging, webViewInitialURL, webViewRef]);
-  return useMemo6(
+  return useMemo5(
     () => ({ addEventListener, removeEventListener, handleWebBack, handleWebHome, onNavigationStateChange }),
     [addEventListener, removeEventListener, handleWebBack, handleWebHome, onNavigationStateChange]
   );
@@ -2611,14 +2621,14 @@ function WebView({ type, local, onMessage, ...props }) {
     throw new Error(`Invalid WebView type: '${type}'`);
   }
   const webViewRef = useRef6(null);
-  const url = useMemo7(() => getWebViewURL(local), [local]);
+  const url = useMemo6(() => getWebViewURL(local), [local]);
   const webBackHandler = useWebBackHandler(url, webViewRef);
   const top = useSafeAreaTop3();
   const bottom = useSafeAreaBottom();
   const insets = useSafeAreaInsets4();
   const global2 = getAppsInTossGlobals();
   const navigationBarContext = useNavigationBarContext();
-  const safeAreaInsetsEmitter = useSafeAreaInsetsEmitter();
+  const safeAreaInsetsEvent = useSafeAreaInsetsEvent();
   const [allowsBackForwardNavigationGestures, setAllowsBackForwardNavigationGestures] = useState6(
     props.allowsBackForwardNavigationGestures
   );
@@ -2633,13 +2643,9 @@ function WebView({ type, local, onMessage, ...props }) {
           webBackHandler.removeEventListener(onEvent);
         };
       },
+      homeEvent: ({ onEvent }) => homeEvent.subscribe(onEvent),
       updateLocationEvent: ({ onEvent, onError, options }) => appsInTossEvent.addEventListener("updateLocationEvent", { onEvent, onError, options }),
-      safeAreaInsetsChange: ({ onEvent }) => {
-        safeAreaInsetsEmitter.on("safeAreaInsetsChange", onEvent);
-        return () => {
-          safeAreaInsetsEmitter.off("safeAreaInsetsChange", onEvent);
-        };
-      },
+      safeAreaInsetsChange: ({ onEvent }) => safeAreaInsetsEvent.subscribe(onEvent),
       /** @internal */
       appBridgeCallbackEvent: ({ onEvent, onError, options }) => appsInTossEvent.addEventListener("appBridgeCallbackEvent", { onEvent, onError, options }),
       /** AdMobV2 */
@@ -2722,7 +2728,7 @@ function WebView({ type, local, onMessage, ...props }) {
       }
     }
   });
-  const headerPropForExternalWebView = useMemo7(() => {
+  const headerPropForExternalWebView = useMemo6(() => {
     const parsedNavigationBar = global2.navigationBar != null ? safeParseNavigationBar(global2.navigationBar) : null;
     const initialAccessoryButton = parsedNavigationBar?.initialAccessoryButton;
     const withBackButton = parsedNavigationBar?.withBackButton ?? true;
@@ -4090,7 +4096,9 @@ export {
   OverlayProvider,
   WebView,
   env,
+  homeEvent,
   loadFullScreenAd,
+  safeAreaInsetsChange,
   showFullScreenAd,
   useCreateUserAgent,
   useGeolocation,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/framework",
   "type": "module",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "The framework for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -55,12 +55,12 @@
     "ait": "./bin/ait.js"
   },
   "dependencies": {
-    "@apps-in-toss/analytics": "1.12.0",
-    "@apps-in-toss/cli": "1.12.0",
-    "@apps-in-toss/native-modules": "1.12.0",
-    "@apps-in-toss/plugins": "1.12.0",
-    "@apps-in-toss/types": "1.12.0",
-    "@apps-in-toss/user-scripts": "^1.12.0",
+    "@apps-in-toss/analytics": "1.14.0",
+    "@apps-in-toss/cli": "1.14.0",
+    "@apps-in-toss/native-modules": "1.14.0",
+    "@apps-in-toss/plugins": "1.14.0",
+    "@apps-in-toss/types": "1.14.0",
+    "@apps-in-toss/user-scripts": "^1.14.0",
     "es-hangul": "^2.3.2"
   },
   "devDependencies": {