@c-rex/templates 0.3.0-build.71 → 0.3.0-build.74

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "@c-rex/templates",
-    "version":  "0.3.0-build.71",
+    "version":  "0.3.0-build.74",
     "type":  "module",
     "files":  [
                   "src"
@@ -51,6 +51,7 @@
                          "cheerio":  "^1.1.0",
                          "i18next":  "^25.1.3",
                          "next":  "^15",
+                         "next-auth":  "^4.24.11",
                          "next-intl":  "^4.1.0",
                          "nuqs":  "^2.4.3",
                          "react":  "^18.3.1",

package/src/layout.tsx

@@ -1,6 +1,7 @@
 import React from "react";
 import { NextIntlClientProvider } from "next-intl";
 import { getLocale } from "next-intl/server";
+import { getServerSession, type Session } from "next-auth";
 import { Toaster } from "@c-rex/ui/sonner";
 import { AppConfigProvider } from "@c-rex/contexts/config-provider";
 import { NuqsAdapter } from "nuqs/adapters/next/app";
@@ -10,119 +11,197 @@ import { getIssuerMetadata } from "@c-rex/core/OIDC";
 import { resolveUILanguage, resolveContentLanguage } from "./utils";
 import { informationUnitsLanguagesServer } from "@c-rex/services/server-requests";
 import {
-  UI_LANG_KEY,
-  SEARCH_SETTINGS_COOKIE_NAME,
-  UI_PREFERENCES_COOKIE_NAME,
+    UI_LANG_KEY,
+    SEARCH_SETTINGS_COOKIE_NAME,
+    UI_PREFERENCES_COOKIE_NAME,
+    CONTENT_LANGUAGES_COOKIE_NAME,
+    PERSONALIZATION_MODES,
 } from "@c-rex/constants";
 import { transformLanguageData } from "@c-rex/utils";
 import { getSearchSettingsFromCookie } from "@c-rex/components/search-settings-store";
+import { getAvailableLanguagesFromCookie } from "@c-rex/components/language-store";
 import { FavoritesProvider } from "@c-rex/components/favorites-context";
 import { getUiPreferencesFromCookie } from "@c-rex/components/ui-preferences-store";
 import { UiPreferencesRuntime } from "@c-rex/components/ui-preferences-runtime";
+import { PersonalizationProvider } from "@c-rex/components/pulse/personalization-context";
+import { PulseThemeProvider } from "@c-rex/components/pulse/theme-context";
+import { PulseSubscriptionTargetProvider } from "@c-rex/components/pulse/subscription-target-context";
+import { getPersonalizationMode } from "@c-rex/core/personalization-mode";
+import { CrexLogger } from "@c-rex/core/logger";
+import type {} from "@c-rex/core/personalization-session";
 
 interface DefaultRootLayoutProps {
-  children: React.ReactNode;
+    children: React.ReactNode;
+    personalizationAppContext?: string;
 }
 
+const getPersonalizationModeSafe = async (): Promise<
+    (typeof PERSONALIZATION_MODES)[keyof typeof PERSONALIZATION_MODES]
+> => {
+    try {
+        return getPersonalizationMode();
+    } catch (error) {
+        // A misconfigured PULSE_PERSONALIZATION_MODE must not take down the
+        // whole app boot — degrade to the feature being off instead of a
+        // 500 on every request.
+        await new CrexLogger().log({
+            level: "error",
+            message: `DefaultRootLayout.getPersonalizationModeSafe: invalid PULSE_PERSONALIZATION_MODE, disabling personalization: ${error}`,
+        });
+        return PERSONALIZATION_MODES.DISABLED;
+    }
+};
+
 const getAvailableLanguagesSafe = async (): Promise<
-  { value: string; score: number }[]
+    { value: string; score: number }[]
 > => {
-  try {
-    const data = await informationUnitsLanguagesServer();
-    return (data as { value: string; score: number }[]) || [];
-  } catch (error) {
-    // Some installations expose the Languages endpoint only intermittently
-    // or behind infrastructure that can transiently return 503. The app
-    // should still boot with the configured default language instead of
-    // failing the entire root layout.
-    console.warn(
-      "[DefaultRootLayout] Failed to load available content languages. Falling back to defaults.",
-      error,
-    );
-    return [];
-  }
+    try {
+        const data = await informationUnitsLanguagesServer();
+        const languages = (data as { value: string; score: number }[]) || [];
+        if (languages.length === 0) {
+            // A 200 with an empty body is not a transport failure: the API
+            // filters the language list by what the current token may read.
+            await new CrexLogger().log({
+                level: "warning",
+                message:
+                    "DefaultRootLayout.getAvailableLanguagesSafe: Languages endpoint returned an empty list. Falling back to the persisted languages, if any.",
+            });
+        }
+        return languages;
+    } catch (error) {
+        // Some installations expose the Languages endpoint only intermittently
+        // or behind infrastructure that can transiently return 503. The app
+        // should still boot with the configured default language instead of
+        // failing the entire root layout.
+        await new CrexLogger().log({
+            level: "warning",
+            message: `DefaultRootLayout.getAvailableLanguagesSafe: failed to load available content languages, falling back to defaults: ${error}`,
+        });
+        return [];
+    }
 };
 
 export const DefaultRootLayout = async ({
-  children,
+    children,
+    personalizationAppContext,
 }: DefaultRootLayoutProps) => {
-  const [locale, metadata, languageData] = await Promise.all([
-    getLocale(),
-    getIssuerMetadata(),
-    getAvailableLanguagesSafe(),
-  ]);
+    const [locale, metadata, languageData] = await Promise.all([
+        getLocale(),
+        getIssuerMetadata(),
+        getAvailableLanguagesSafe(),
+    ]);
 
-  const sdk = new CrexSDK();
-  const cookieStore = await cookies();
-  const uiLangCookie = cookieStore.get(UI_LANG_KEY)?.value ?? null;
-  const clientConfigs = await sdk.getClientConfig();
-  const serverConfigs = sdk.getServerConfig();
-  const searchSettings = getSearchSettingsFromCookie(
-    cookieStore.get(SEARCH_SETTINGS_COOKIE_NAME)?.value,
-  );
-  const uiPreferences = getUiPreferencesFromCookie(
-    cookieStore.get(UI_PREFERENCES_COOKIE_NAME)?.value,
-  );
+    const sdk = new CrexSDK();
+    const cookieStore = await cookies();
+    const uiLangCookie = cookieStore.get(UI_LANG_KEY)?.value ?? null;
+    const clientConfigs = await sdk.getClientConfig();
+    const serverConfigs = sdk.getServerConfig();
+    const personalizationMode = personalizationAppContext
+        ? await getPersonalizationModeSafe()
+        : PERSONALIZATION_MODES.DISABLED;
+    const searchSettings = getSearchSettingsFromCookie(
+        cookieStore.get(SEARCH_SETTINGS_COOKIE_NAME)?.value,
+    );
+    const uiPreferences = getUiPreferencesFromCookie(
+        cookieStore.get(UI_PREFERENCES_COOKIE_NAME)?.value,
+    );
 
-  sdk.updateConfigProp("OIDC", {
-    ...serverConfigs.OIDC,
-    issuerMetadata: metadata,
-  });
+    sdk.updateConfigProp("OIDC", {
+        ...serverConfigs.OIDC,
+        issuerMetadata: metadata,
+    });
 
-  const availableLanguages = transformLanguageData(languageData);
+    // The personalization key is added by the SDK's custom session callback.
+    // Calling getServerSession without these options uses NextAuth's default
+    // callback and silently drops that key, leaving authenticated Pulse users
+    // looking unauthenticated in the browser.
+    const userAuthConfig =
+        personalizationMode === PERSONALIZATION_MODES.PULSE_USER
+            ? await sdk.getUserAuthConfig()
+            : undefined;
+    const session: Session | null = userAuthConfig
+        ? ((await getServerSession(userAuthConfig)) as Session | null)
+        : null;
+    const sessionKey = session?.personalizationSessionKey;
 
-  const uiLang = await resolveUILanguage({
-    uiLangCookie,
-    defaultLang: clientConfigs.languageSwitcher.default,
-  });
+    // The list is persisted client-side in a cookie by the language store.
+    // Reuse it whenever this render could not produce one, so a transient
+    // failure or a permission-filtered empty response does not blank out the
+    // language switcher for the rest of the session.
+    const fetchedLanguages = transformLanguageData(languageData);
+    const availableLanguages =
+        fetchedLanguages.length > 0
+            ? fetchedLanguages
+            : getAvailableLanguagesFromCookie(
+                cookieStore.get(CONTENT_LANGUAGES_COOKIE_NAME)?.value,
+            );
+    const initialTheme =
+        personalizationMode === PERSONALIZATION_MODES.PULSE_USER
+            ? "system"
+            : uiPreferences.theme;
 
-  const contentLang = await resolveContentLanguage({
-    contentLangCookie: searchSettings.language,
-    availableLanguages,
-    defaultLang:
-      clientConfigs.defaultContentLanguage ??
-      clientConfigs.languageSwitcher.default,
-  });
+    const uiLang = await resolveUILanguage({
+        uiLangCookie,
+        defaultLang: clientConfigs.languageSwitcher.default,
+    });
 
-  return (
-    <html
-      lang={locale}
-      className={uiPreferences.theme === "dark" ? "dark" : undefined}
-      data-theme={uiPreferences.theme}
-      data-font-scale={uiPreferences.fontScale}
-      data-readonly-mode={clientConfigs.readOnlyMode ? "true" : "false"}
-      style={{
-        fontSize:
-          uiPreferences.fontScale === "small"
-            ? "93.75%"
-            : uiPreferences.fontScale === "large"
-              ? "112.5%"
-              : "100%",
-      }}
-    >
-      <head>
-        <link rel="icon" type="image/x-icon" href="/img/favicon.png" />
-      </head>
-      <body className="min-h-screen bg-background font-sans antialiased">
-        <NextIntlClientProvider>
-          <AppConfigProvider
-            uiLang={uiLang}
-            contentLang={contentLang}
-            availableLanguages={availableLanguages}
-            initialConfig={clientConfigs}
-            loginEnabled={Boolean(serverConfigs.OIDC.client.enabled)}
-          >
-            <FavoritesProvider>
-              <UiPreferencesRuntime
-                initialTheme={uiPreferences.theme}
-                initialFontScale={uiPreferences.fontScale}
-              />
-              <Toaster />
-              <NuqsAdapter>{children}</NuqsAdapter>
-            </FavoritesProvider>
-          </AppConfigProvider>
-        </NextIntlClientProvider>
-      </body>
-    </html>
-  );
+    const contentLang = await resolveContentLanguage({
+        contentLangCookie: searchSettings.language,
+        availableLanguages,
+        defaultLang:
+            clientConfigs.defaultContentLanguage ??
+            clientConfigs.languageSwitcher.default,
+    });
+
+    return (
+        <html
+            lang={locale}
+            className={initialTheme === "dark" ? "dark" : undefined}
+            data-theme={initialTheme}
+            data-font-scale={uiPreferences.fontScale}
+            data-readonly-mode={clientConfigs.readOnlyMode ? "true" : "false"}
+            style={{
+                fontSize:
+                    uiPreferences.fontScale === "small"
+                        ? "93.75%"
+                        : uiPreferences.fontScale === "large"
+                            ? "112.5%"
+                            : "100%",
+            }}
+        >
+            <head>
+                <link rel="icon" type="image/x-icon" href="/img/favicon.png" />
+            </head>
+            <body className="min-h-screen bg-background font-sans antialiased">
+                <NextIntlClientProvider>
+                    <AppConfigProvider
+                        uiLang={uiLang}
+                        contentLang={contentLang}
+                        availableLanguages={availableLanguages}
+                        initialConfig={clientConfigs}
+                        loginEnabled={Boolean(serverConfigs.OIDC.client.enabled)}
+                    >
+                        <PersonalizationProvider
+                            mode={personalizationMode}
+                            sessionKey={sessionKey}
+                            appContext={personalizationAppContext}
+                        >
+                            <PulseSubscriptionTargetProvider>
+                                <PulseThemeProvider>
+                                    <FavoritesProvider>
+                                        <UiPreferencesRuntime
+                                            initialTheme={initialTheme}
+                                            initialFontScale={uiPreferences.fontScale}
+                                        />
+                                        <Toaster />
+                                        <NuqsAdapter>{children}</NuqsAdapter>
+                                    </FavoritesProvider>
+                                </PulseThemeProvider>
+                            </PulseSubscriptionTargetProvider>
+                        </PersonalizationProvider>
+                    </AppConfigProvider>
+                </NextIntlClientProvider>
+            </body>
+        </html>
+    );
 };