@uniai-fe/next-providers 0.1.12 → 0.1.14

package/README.md

@@ -8,4 +8,4 @@
   - `modalProviders` 슬롯을 통해 `@uniai-fe/ui-legacy`나 신규 `@uniai-fe/uds-*` 모달 Provider를 서비스 측에서 직접 주입한다.
   - `onRouteChange` 콜백을 전달해 라우트 변경 시 모달 스택 초기화 등 앱 전용 부가 로직을 실행할 수 있다.
 - `SetQueryCookie` — query string 기반 쿠키 동기화
-- `RuntimeRouteGuard` / `runtimeRouteRedirectAtom` — 런타임 환경에 따라 `/mobile` 등 경로를 강제하거나 차단하는 가드 + Jotai 토글 atom
+- `RuntimeRouteGuard` — 런타임 환경에 따라 `/mobile` 등 경로를 강제하거나 차단하는 가드 (disabled prop으로 토글)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/next-providers",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Next.js State Providers for UNIAI FE Projects",
   "type": "module",
   "private": false,

package/src/NextRoots.tsx

@@ -1,10 +1,7 @@
-import { Suspense } from "react";
-
 import StyledComponentsRegistry from "./lib/StyledComponentsRegistry";
 import AirtableProvider from "./provider/AirtableProvider";
 import { JotaiProvider } from "./provider/JotaiProvider";
 import { ReactQueryProvider } from "./provider/ReactQueryProvider";
-import RouterEventDetector from "./lib/RouterEventsDetector";
 import SetQueryCookie from "./lib/SetQueryCookie";
 import SystemThemeChecker from "./lib/SystemThemeChecker";
 import type { SystemLanguageType } from "@uniai-fe/next-devkit/types";
@@ -30,13 +27,13 @@ export default function NextRoots({
   locale = "ko",
   systemThemeOptions,
   modalProviders,
-  onRouteChange,
+
   children,
 }: {
   locale?: SystemLanguageType;
   systemThemeOptions?: { exceptPaths: string[] };
   modalProviders?: React.ReactNode;
-  onRouteChange?: () => void;
+
   children: React.ReactNode;
 }) {
   return (
@@ -49,9 +46,6 @@ export default function NextRoots({
             {modalProviders}
           </AirtableProvider>
           <SystemThemeChecker exceptPaths={systemThemeOptions?.exceptPaths} />
-          <Suspense fallback={null}>
-            <RouterEventDetector onRouteChange={onRouteChange} />
-          </Suspense>
         </StyledComponentsRegistry>
       </JotaiProvider>
     </ReactQueryProvider>

package/src/index.tsx

@@ -1,7 +1,4 @@
-export {
-  RuntimeRouteGuard,
-  runtimeRouteRedirectAtom,
-} from "./lib/RuntimeRouteGuard";
+export { RuntimeRouteGuard } from "./lib/RuntimeRouteGuard";
 
 export { default as NextRoots } from "./NextRoots";
 export { default as SetQueryCookie } from "./lib/SetQueryCookie";

package/src/lib/RuntimeRouteGuard.tsx

@@ -2,7 +2,7 @@
 
 import { useEffect } from "react";
 import { usePathname, useRouter } from "next/navigation";
-import { atom, type PrimitiveAtom, useAtomValue } from "jotai";
+import { useAtomValue } from "jotai";
 import {
   runtimeEnvState,
   type RuntimeEnvState,
@@ -23,15 +23,9 @@ export type RuntimeRouteConditions = Pick<
 export interface RuntimeRouteGuardProps {
   mobileBasePath?: string;
   desktopFallbackPath?: string;
-  redirectAtom?: PrimitiveAtom<boolean>;
+  disabled?: boolean;
 }
 
-/**
- * 모바일 경로 리디렉션 on/off 상태를 제어하는 Jotai atom.
- * @constant
- */
-export const runtimeRouteRedirectAtom = atom(true);
-
 const isMobilePath = (pathname?: string | null, basePath?: string): boolean =>
   typeof pathname === "string" &&
   typeof basePath === "string" &&
@@ -63,26 +57,26 @@ const shouldPreventMobilePath = (
  * @param {RuntimeRouteGuardProps} props
  * @param {string} [props.mobileBasePath="/mobile"] 모바일 PWA 화면 루트 경로
  * @param {string} [props.desktopFallbackPath="/"] 모바일 접근 제한 시 이동할 데스크톱 경로
- * @param {PrimitiveAtom<boolean>} [props.redirectAtom=runtimeRouteRedirectAtom] 리디렉션 on/off를 제어하는 Jotai atom
+ * @param {boolean} [props.disabled=false] 강제 정책 비활성화 여부
  * @example
  * <RuntimeRouteGuard mobileBasePath="/mobile" desktopFallbackPath="/" />
  * @desc
  * - 모바일 standalone(PWA) 환경에서는 지정된 모바일 경로로 강제 이동한다.
  * - 모바일 브라우저 환경(비 PWA)에서는 모바일 경로 접근을 막고 기본 경로로 전환한다.
- * - redirectAtom을 이용해 DevTools 또는 UI에서 손쉽게 토글할 수 있다.
+ * - disabled 값을 이용해 개발 단계에서 정책을 손쉽게 토글할 수 있다.
  */
 export function RuntimeRouteGuard({
   mobileBasePath = DEFAULT_MOBILE_BASE_PATH,
   desktopFallbackPath = DEFAULT_DESKTOP_FALLBACK_PATH,
-  redirectAtom = runtimeRouteRedirectAtom,
+  disabled = false,
 }: RuntimeRouteGuardProps = {}) {
   const router = useRouter();
   const pathname = usePathname();
   const env = useAtomValue(runtimeEnvState);
-  const redirectEnabled = useAtomValue(redirectAtom);
 
   useEffect(() => {
-    if (!redirectEnabled) return;
+    // disabled일 때는 정책을 잠시 비활성화
+    if (disabled) return;
     if (typeof pathname !== "string") return;
 
     if (shouldForceMobilePath(pathname, env, mobileBasePath)) {
@@ -93,14 +87,7 @@ export function RuntimeRouteGuard({
     if (shouldPreventMobilePath(pathname, env, mobileBasePath)) {
       router.replace(desktopFallbackPath);
     }
-  }, [
-    desktopFallbackPath,
-    env,
-    mobileBasePath,
-    pathname,
-    redirectEnabled,
-    router,
-  ]);
+  }, [desktopFallbackPath, env, mobileBasePath, pathname, disabled, router]);
 
   return null;
 }

package/src/lib/RouterEventsDetector.tsx

@@ -1,28 +0,0 @@
-"use client";
-
-import { usePathname } from "next/navigation";
-import { useEffect } from "react";
-
-export interface RouterEventDetectorProps {
-  onRouteChange?: () => void;
-}
-
-/**
- * 경로 변경 이벤트 감지 훅
- * @component
- * @param {RouterEventDetectorProps} props
- * @param {() => void} [props.onRouteChange] 경로 변경 시 실행할 콜백
- * @desc
- * - 최상위 layout에서 경로 변경을 감지하고, 전달된 콜백을 실행한다.
- */
-export default function RouterEventDetector({
-  onRouteChange,
-}: RouterEventDetectorProps = {}) {
-  const pathname = usePathname();
-
-  useEffect(() => {
-    onRouteChange?.();
-  }, [onRouteChange, pathname]);
-
-  return null;
-}