admin
c767322db6
Wire the Flutter route map (lib/router/app_router.dart) to Next.js 16 App
Router. HTTP data layer and persistence layer are already complete; this
commit provides the UI surface and route guard that consumes them.
Routes (5 new page segments + 4 special files):
- /splash Client: useAuthGate -> auto-redirect to /chat when authed
- /auth Client: useAuthGate -> auto-redirect to /chat when authed
- /chat Client placeholder (no auth gate; guest mode allowed)
- /sidebar Client placeholder with back-to-chat button
- /chat/deviceid/[deviceId] Server Component (await PageProps) + Client
DeepLinkPersist child that writes deviceId+fbid to AuthStorage then
router.replace('/chat')
Special files (root segment):
- loading.tsx Server: centered spinner fallback
- error.tsx Client boundary using v16 `unstable_retry` prop
- not-found.tsx Server: 404 with link back to /splash
- layout.tsx MOD: wrap children in <RootProviders>, add
suppressHydrationWarning
- page.tsx MOD: redirect('/splash') from server
Shared infrastructure:
- src/lib/routes.ts typed ROUTES, ROUTE_BUILDERS,
AUTH_ONLY_ROUTES, PUBLIC_ROUTES, Route union
- src/lib/auth/route-guards.ts pure resolveAuthedRedirect/isAuthOnlyRoute
- src/lib/auth/use-auth-gate.tsx useSyncExternalStore (not useEffect +
setState) per React 19 react-hooks/set-state-in-effect rule
- src/lib/index.ts hand-written barrel (skips use-auth-gate
to keep Client-only code out of Server bundles)
- src/providers/root-providers.tsx Client wrapper + <div id="toast-portal" />
- src/proxy.ts v16 proxy (NOT deprecated middleware.ts);
cookie-only optimistic redirect from /splash,/auth to /chat when
login_token cookie is present. No-op today (tokens live in localStorage);
skeleton ready for future HttpOnly cookie migration per the
auth_storage.ts TODO(security).
Conventions:
- AGENTS.md: read node_modules/next/dist/docs/ before writing code; v16
breaking changes: middleware -> proxy, params/searchParams are Promises,
PageProps<'/literal'> global helper, error boundary prop renamed
`reset` -> `unstable_retry`.
- All placeholder UIs use the design tokens from src/app/globals.css
(no new hex colors).
- No new runtime dependencies; no test framework added.
- src/lib/ NOT added to barrelsby.json (avoids pulling Client-only
use-auth-gate into Server bundles).
Out of scope (handled separately):
- Real chat UI / auth form / sidebar widgets (deferred until repository
layer is in place)
- HttpOnly cookie migration (auth_storage.ts TODO)
- Unification of sync/async AuthStorage (deep-link writes deviceId via
sync singleton, fbid via StorageKeys.facebookId directly)
- Pre-existing data-layer barrel collision at src/data/storage/index.ts:10
(acknowledged in replicated-mapping-creek.md)
Verified:
- pnpm next typegen: OK
- pnpm exec tsc --noEmit on new files: 0 errors
- pnpm lint: 0 errors, 0 warnings
- pnpm exec next build: blocked by pre-existing src/data/storage/index.ts
barrel ambiguity (unrelated, see replicated-mapping-creek.md)
37 lines
1.2 KiB
TypeScript
37 lines
1.2 KiB
TypeScript
/**
|
|
* 纯函数路由守卫
|
|
*
|
|
* 不依赖 React/Next.js，可被 `src/proxy.ts`（边缘运行时）与
|
|
* `src/lib/auth/use-auth-gate.tsx`（客户端 hook）共用。
|
|
*
|
|
* 对齐 Flutter `lib/router/app_router.dart` 中 `_handleAuthRedirect` 的语义：
|
|
* 已登录用户访问 `/splash` 或 `/auth` 时，重定向到 `/chat`。
|
|
*/
|
|
|
|
import { AUTH_ONLY_ROUTES, ROUTES, type StaticRoute } from "../routes";
|
|
|
|
/**
|
|
* 判定路径是否为"仅未登录态可见"的入口路由。
|
|
*/
|
|
export function isAuthOnlyRoute(pathname: string): pathname is StaticRoute {
|
|
return (AUTH_ONLY_ROUTES as readonly string[]).includes(pathname);
|
|
}
|
|
|
|
/**
|
|
* 判定路径是否为公开路由（游客态也允许访问）。
|
|
*/
|
|
export function isPublicRoute(pathname: string): pathname is StaticRoute {
|
|
return pathname === ROUTES.chat || pathname === ROUTES.sidebar;
|
|
}
|
|
|
|
/**
|
|
* 已登录用户访问入口路由时返回应跳转到的目标；其余情况返回 null。
|
|
*
|
|
* 当前实现仅做"splash/auth → chat"的重定向；未来若新增入口路由（如 onboarding），
|
|
* 只需在此函数追加分支。
|
|
*/
|
|
export function resolveAuthedRedirect(pathname: string): string | null {
|
|
if (isAuthOnlyRoute(pathname)) return ROUTES.chat;
|
|
return null;
|
|
}
|