Files
lobehub__lobehub/apps/auth/app/lib/prerender.ts
Innei 12fa88e49a ✨ feat(auth): split the auth surface into a prerendered micro app (#18542)
* ♻️ refactor(auth): make the auth shell safe to prerender

Three changes, all behaviour-preserving for the current client-rendered
auth SPA, that a prerendered copy of the same pages needs:

- `enableBusinessFeatures` is a build-time constant, not deployment state.
  `AuthServerConfigProvider` now reads it from `@lobechat/business-const`
  instead of the injected server config, so a render that has not received
  that config yet still resolves the right SSO provider source.
- The terms checkbox and the "last used" provider both seeded `useState`
  from `localStorage` during render. A returning user's stored value makes
  the first render depend on the browser, which cannot be prerendered; they
  now start empty and fill in from an effect.
- `LobeAnalyticsProviderWrapper` accepts the analytics config as a prop and
  guards its `window` read, so it can render outside a browser.

Also drops the `@/features/AuthShell` barrel from the `src/features/Auth`
importers: the barrel re-exports `AuthShell`, which pulls `AuthLocale` and
the full en-US dictionary into every consumer's graph.

* ✨ feat(auth): split the auth surface into a prerendered micro app

`apps/auth` renders the sign-in flow ahead of time instead of shipping an
empty `#root`. React Router framework mode with `ssr: false` + `prerender`,
so the worker carries no React at all — 7KB, it picks one prerendered
document by locale and swaps in the deployment's config.

- 18 locales x 4 routes = 72 documents, plus a SPA fallback for the routes
  that take params. One build pass per locale writes the same canonical
  paths; the non-default passes are folded into `build/client/__i18n/`.
  Passes are independent, so they run 6 at a time (3m05s -> 44s).
- Each document inlines only its own locale's dictionary; the rest load on
  demand for the language switcher, which keeps them off the first-load
  path entirely.
- `/webapi/auth/spa-config` is a new public endpoint the worker reads to
  fill `window.__SERVER_CONFIG__`. It carries only the six fields the auth
  pages actually read; a failed lookup leaves the placeholder and the page
  still renders.
- Per-route SEO: real localized titles, and `noindex, nofollow` on every
  transactional page — only /signin and /signup stay indexable, with a
  canonical URL.

The existing Next.js `/spa-auth` route is untouched, so self-hosted and
Docker deployments keep serving the client-rendered SPA. This app builds
and deploys from lobehub-cloud, which overlays `@/business/*`.

* 🐛 fix(auth): restore feature flags and track the prerender lib
2026-09-03 19:34:41 +08:00

52 lines
1.3 KiB
TypeScript

export const DEFAULT_PRERENDER_LOCALE = 'en-US';
export const SPA_FALLBACK_DOCUMENT = '/index.html';
export const PRERENDER_ROUTES = [
'/signin',
'/signup',
'/verify-email',
'/reset-password',
] as const;
// Hand-written: `react-router.config.ts` is loaded by plain Node and cannot
// resolve the repo's path aliases, so this list cannot be imported from
// `@/locales/resources`. `scripts/build.mjs` checks it against locales on disk.
export const PRERENDER_LOCALES = [
'ar',
'bg-BG',
'de-DE',
'en-US',
'es-ES',
'fa-IR',
'fr-FR',
'it-IT',
'ja-JP',
'ko-KR',
'nl-NL',
'pl-PL',
'pt-BR',
'ru-RU',
'tr-TR',
'vi-VN',
'zh-CN',
'zh-TW',
] as const;
export const prerenderOutputDir = (route: string) => route.replace(/^\//, '');
export const resolveDocumentLocale = (locale: string) =>
(PRERENDER_LOCALES as readonly string[]).includes(locale) ? locale : DEFAULT_PRERENDER_LOCALE;
export const documentPathFor = (pathname: string, locale: string) => {
const route = pathname.length > 1 && pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
const prerendered = (PRERENDER_ROUTES as readonly string[]).includes(route);
if (!prerendered) return SPA_FALLBACK_DOCUMENT;
const document = `${route}/index.html`;
if (locale === DEFAULT_PRERENDER_LOCALE) return document;
return `/__i18n/${locale}${document}`;
};