cloudflare-next-intl 0.3.0 → 0.3.1

package/dist/src/config/middleware.js

@@ -15,6 +15,8 @@ async function getIsBotValue(userAgent) {
     if (userAgent === null)
         return false;
     const { isBot } = await import('next/dist/server/web/spec-extension/user-agent');
+    // Unreachable: userAgent is already narrowed to non-null string above,
+    // so the ?? '' fallback never triggers.
     return isBot(userAgent ?? '');
 }
 const getIsBotValueCache = cache(getIsBotValue);
@@ -57,7 +59,9 @@ export default async function intlMiddleware(request, options) {
         let urlLocale;
         let pathWithoutLocale;
         // Avoids split('/').filter(Boolean) array allocation on every request:
-        // scan for the first segment's bounds directly.
+        // scan for the first segment's bounds directly. Unreachable:
+        // Next.js guarantees pathname always starts with '/', so the else
+        // branch (segmentStart = 0) never runs.
         const segmentStart = pathname.charCodeAt(0) === 47 /* '/' */ ? 1 : 0;
         let segmentEnd = pathname.indexOf('/', segmentStart);
         if (segmentEnd === -1)

package/dist/src/firebase_auth/error_messages/firebase_auth_error_helper.js

@@ -38,5 +38,8 @@ export default function firebaseAuthErrorMessage(locale, error) {
             // fall through to English default
         }
     }
+    // Unreachable: key is always either a value from ERROR_CODE_TO_KEY (all
+    // valid DEFAULT_MESSAGES_EN keys) or the literal 'unknown' fallback
+    // above, so DEFAULT_MESSAGES_EN[key] never misses.
     return DEFAULT_MESSAGES_EN[key] ?? DEFAULT_MESSAGES_EN.unknown;
 }

package/dist/src/firebase_auth/server/use_auth_user_server.d.ts

@@ -1,19 +1,39 @@
 import type { User } from 'firebase/auth';
 /**
- * Server Component counterpart of the client `useAuthUser()` hook (from
- * `cloudflare-next-intl/useFirebaseAuthUser`'s `default` condition — this
- * file is that same subpath's `react-server` condition, resolved
- * automatically, not a separately-imported function). Reads through the
- * same `cache()`-wrapped `getAuthenticatedAppForUser`, so every server
- * component calling this within one request shares one lookup.
+ * Resolves the current request's authenticated Firebase user.
+ * @returns `{ user, loading: false }` — `loading` is always `false` here;
+ *   server resolution is synchronous with respect to the awaited call.
+ */
+declare function iGetAuthUser(): Promise<{
+    user: User | null;
+    loading: false;
+}>;
+/**
+ * Server Component/Action only: resolves the current request's
+ * authenticated Firebase user, same style as {@link getLocale}/
+ * {@link getTranslations} — an unconditional, always-`async` export
+ * (`cloudflare-next-intl/getFirebaseAuthUser`), so the `await` requirement
+ * is visible from the type itself in every editor.
+ *
+ * Returns the same `{ user, loading }` shape the client `useAuthUser()`
+ * hook's context exposes, so `const { user } = await getAuthUser()`
+ * generalizes correctly from `const { user } = useAuthUser()` on the client.
  *
- * Returns the same `{ user, loading }` shape the client variant's context
- * exposes (`loading` is always `false` here — server resolution is
- * synchronous with respect to the awaited call), so code reading
- * `const { user } = await useAuthUser()` generalizes correctly from
- * `const { user } = useAuthUser()` on the client side.
+ * @example
+ * ```tsx
+ * const { user } = await getAuthUser();
+ * ```
+ */
+export declare const getAuthUser: typeof iGetAuthUser;
+/**
+ * Server Component counterpart of the client `useAuthUser()` hook, reached
+ * via `cloudflare-next-intl/useFirebaseAuthUser`'s `react-server` condition
+ * (resolved automatically — not meant to be imported directly by name).
+ * Prefer {@link getAuthUser} for an unconditional, editor-typed-as-async
+ * equivalent.
  */
 export default function useAuthUser(): Promise<{
     user: User | null;
     loading: false;
 }>;
+export {};

package/dist/src/firebase_auth/server/use_auth_user_server.js

@@ -1,19 +1,37 @@
 import { getAuthenticatedAppForUser } from './firebase_server';
 /**
- * Server Component counterpart of the client `useAuthUser()` hook (from
- * `cloudflare-next-intl/useFirebaseAuthUser`'s `default` condition — this
- * file is that same subpath's `react-server` condition, resolved
- * automatically, not a separately-imported function). Reads through the
- * same `cache()`-wrapped `getAuthenticatedAppForUser`, so every server
- * component calling this within one request shares one lookup.
- *
- * Returns the same `{ user, loading }` shape the client variant's context
- * exposes (`loading` is always `false` here — server resolution is
- * synchronous with respect to the awaited call), so code reading
- * `const { user } = await useAuthUser()` generalizes correctly from
- * `const { user } = useAuthUser()` on the client side.
+ * Resolves the current request's authenticated Firebase user.
+ * @returns `{ user, loading: false }` — `loading` is always `false` here;
+ *   server resolution is synchronous with respect to the awaited call.
  */
-export default async function useAuthUser() {
+async function iGetAuthUser() {
     const { currentUser } = await getAuthenticatedAppForUser();
     return { user: currentUser, loading: false };
 }
+/**
+ * Server Component/Action only: resolves the current request's
+ * authenticated Firebase user, same style as {@link getLocale}/
+ * {@link getTranslations} — an unconditional, always-`async` export
+ * (`cloudflare-next-intl/getFirebaseAuthUser`), so the `await` requirement
+ * is visible from the type itself in every editor.
+ *
+ * Returns the same `{ user, loading }` shape the client `useAuthUser()`
+ * hook's context exposes, so `const { user } = await getAuthUser()`
+ * generalizes correctly from `const { user } = useAuthUser()` on the client.
+ *
+ * @example
+ * ```tsx
+ * const { user } = await getAuthUser();
+ * ```
+ */
+export const getAuthUser = iGetAuthUser;
+/**
+ * Server Component counterpart of the client `useAuthUser()` hook, reached
+ * via `cloudflare-next-intl/useFirebaseAuthUser`'s `react-server` condition
+ * (resolved automatically — not meant to be imported directly by name).
+ * Prefer {@link getAuthUser} for an unconditional, editor-typed-as-async
+ * equivalent.
+ */
+export default async function useAuthUser() {
+    return getAuthUser();
+}

package/dist/src/general/general_functions.js

@@ -51,7 +51,10 @@ export function getTranslationsImpl(locale, messages, namespace, cacheKey) {
             }
         }
     }
-    // If after traversal, no base translations object was found.
+    // If after traversal, no base translations object was found. Unreachable:
+    // the loop above always either sets translationsBase or returns early on
+    // its final iteration, since namespaceParts always has length >= 1
+    // (''.split('.') yields ['']).
     if (!translationsBase) {
         return errorAndReturnFallback(`Translations for namespace "${namespace}" could not be found.`, cacheKeyValue, locale, namespace);
     }
@@ -66,6 +69,9 @@ export function getTranslationsImpl(locale, messages, namespace, cacheKey) {
         // Traverse the resolved translations base using the key parts.
         for (let i = 0; i < keyParts.length; i++) {
             const part = keyParts[i];
+            // Unreachable: currentTranslation only ever becomes a string via
+            // the reassignment below, which is guarded to only assign
+            // non-null objects.
             if (typeof currentTranslation === 'string') {
                 // Translation key path prematurely leads to a string.
                 console.warn(`Translation key "${key}" in namespace "${namespace}" leads to a string prematurely at "${part}" for locale "${locale}".`);
@@ -91,7 +97,10 @@ export function getTranslationsImpl(locale, messages, namespace, cacheKey) {
                 }
             }
         }
-        // If the loop completes and no string translation was found (e.g., key missing or not a string).
+        // If the loop completes and no string translation was found (e.g.,
+        // key missing or not a string). Unreachable: keyParts always has
+        // length >= 1 (''.split('.') yields ['']), and every branch above
+        // returns on the final iteration.
         console.warn(`Translation key "${key}" in namespace "${namespace}" is missing or not a string for locale "${locale}".`);
         return key; // Return the key as fallback
     };

package/llms.txt

@@ -30,6 +30,7 @@ other subpath can be used.
 - `./firebaseAuthClientProvider` — `AuthUserProvider`: client auth-state provider (session cookie sync, auth-page redirects).
 - `./firebaseAuthServerProvider` — server-side equivalent provider (not used by the default auto-wiring path — see its doc comment).
 - `./useFirebaseAuthUser` — `useAuthUser()`; resolves to RSC or client implementation via the `react-server` condition. Client variant throws `"useAuthUser must be used within an AuthUserProvider"` if called outside one.
+- `./getFirebaseAuthUser` — `getAuthUser()`; unconditional server-only export of the same RSC implementation `useFirebaseAuthUser` resolves to via `react-server`. Use this when you want `await` to be visible from the type itself — TypeScript doesn't evaluate the `react-server` condition, so `useFirebaseAuthUser` always types as its client (sync) signature in editors regardless of call site.
 - `./firebaseAuthActions` — `createLoginAction`/`createSignUpAction`/`createForgotPasswordAction`: factories returning React `useActionState`-shaped form actions.
 - `./firebaseAuthMiddleware` — `updateSession`: session-cookie refresh, called automatically by `./middleware`'s default handler.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudflare-next-intl",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Optimized Next Intl Package Special for App Router and Cloudflare",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -104,6 +104,10 @@
         "import": "./dist/src/firebase_auth/client/use_auth_user.js"
       }
     },
+    "./getFirebaseAuthUser": {
+      "types": "./dist/src/firebase_auth/server/use_auth_user_server.d.ts",
+      "import": "./dist/src/firebase_auth/server/use_auth_user_server.js"
+    },
     "./firebaseAuthActions": {
       "types": "./dist/src/firebase_auth/client/auth_actions.d.ts",
       "import": "./dist/src/firebase_auth/client/auth_actions.js"
@@ -150,9 +154,9 @@
   "author": "Demian Ilnutskyi",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/DemienIlnutskiy/cloudflare-next-intl/issues"
+    "url": "https://github.com/demian-ilnytskyi/cloudflare-next-intl/issues"
   },
-  "homepage": "https://github.com/DemienIlnutskiy/cloudflare-next-intl#readme",
+  "homepage": "https://github.com/demian-ilnytskyi/cloudflare-next-intl#readme",
   "peerDependencies": {
     "firebase": ">=10.0.0",
     "next": ">=12.0.0",