cloudflare-next-intl 0.2.2 → 0.3.1

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}".`);
@@ -73,6 +79,10 @@ export function getTranslationsImpl(locale, messages, namespace, cacheKey) {
             }
             const value = currentTranslation[part];
             if (i === keyParts.length - 1) {
+                if (typeof value !== 'string') {
+                    console.warn(`Translation key "${key}" in namespace "${namespace}" resolves to a non-string value for locale "${locale}". Expected string, got "${typeof value}".`);
+                    return key;
+                }
                 return value;
             }
             else {
@@ -87,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/dist/src/general/index.js

@@ -1,3 +1,2 @@
 export { setLocaleCache as setLocale, setLocaleAsync } from './cache_variables';
 export { alternatesLinks } from './metadata';
-// export { default as getLayoutStates } from './get_layout_states';

package/dist/src/general/metadata.bench.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/general/metadata.bench.js

@@ -0,0 +1,15 @@
+import { bench, describe } from 'vitest';
+import { alternatesLinks, languages } from './metadata';
+describe('languages', () => {
+    bench('builds per-locale hreflang map for one URL', () => {
+        languages(`https://example.com/${Math.random()}`, '/about');
+    });
+});
+describe('alternatesLinks', () => {
+    bench('builds canonical + languages for the default locale', () => {
+        alternatesLinks({ url: `https://example.com/${Math.random()}`, locale: 'en', linkPart: '/about' });
+    });
+    bench('builds languages only for a non-default locale (no canonical)', () => {
+        alternatesLinks({ url: `https://example.com/${Math.random()}`, locale: 'de', linkPart: '/about' });
+    });
+});

package/dist/src/general/metadata.js

@@ -34,7 +34,7 @@ export function iAlternatesLinks({ locale, url, canonical, linkPart }) {
         };
     }
     catch (e) {
-        console.error(`Language Helper error for Metadata, link: ${url}, linkPart: ${linkPart}, Error: ${e}`);
+        console.error(`[cloudflare-next-intl] alternatesLinks failed for url="${url}" linkPart="${linkPart}" — returning undefined, so "alternates" will be omitted from your metadata. Underlying error:`, e);
         return undefined;
     }
 }

package/dist/src/server/components/server_provider.js

@@ -3,6 +3,7 @@ import { setLocaleCache, setMessageForLocaleCache } from "../../general/cache_va
 import { getMessage } from "../functions/server";
 import dynamic from "next/dynamic";
 import { localesSet } from "../../config/middleware";
+import config from "../../config/intl_config";
 const LocationzationClientProvider = dynamic(() => import("../../client/components/client_provider"));
 /**
  * Server component that provides locale/messages context to the rest of the
@@ -45,5 +46,10 @@ export default async function LocationzationProvider({ language, messages, child
         setMessageForLocaleCache(language, messages);
     }
     const messagesValue = messages ?? await getMessage(language);
-    return _jsx(LocationzationClientProvider, { language: language, messages: messagesValue, children: children });
+    let initialAuthUser = null;
+    if (config.firebaseAuth) {
+        const { resolveAuthUserAndRedirect } = await import("../../firebase_auth/server/auth_user_server_provider");
+        initialAuthUser = await resolveAuthUserAndRedirect();
+    }
+    return _jsx(LocationzationClientProvider, { language: language, messages: messagesValue, initialAuthUser: initialAuthUser, children: children });
 }

package/dist/src/server/functions/get_user_locale.bench.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server/functions/get_user_locale.bench.js

@@ -0,0 +1,13 @@
+import { bench, describe } from 'vitest';
+import { languageDetecotr } from './get_user_locale';
+describe('languageDetecotr', () => {
+    bench('single locale header', () => {
+        languageDetecotr('en');
+    });
+    bench('realistic multi-entry Accept-Language header', () => {
+        languageDetecotr('fr-CA,fr;q=0.9,en-US;q=0.8,en;q=0.7,de;q=0.6,es;q=0.5');
+    });
+    bench('no header (default-locale fallback)', () => {
+        languageDetecotr(null);
+    });
+});

package/dist/src/server/functions/get_user_locale.js

@@ -14,11 +14,14 @@ function languageDetecotrImpl(acceptLanguageHeader) {
             .split(',');
         let localeValue;
         for (const item of parsedLocales) {
-            const parts = item.trim().split(';');
-            const locale = parts[0];
-            const languageOnly = locale.split('-')[0];
+            const trimmed = item.trim();
+            const semi = trimmed.indexOf(';');
+            const locale = semi === -1 ? trimmed : trimmed.slice(0, semi);
+            const dash = locale.indexOf('-');
+            const languageOnly = dash === -1 ? locale : locale.slice(0, dash);
             if (languageOnly && localesSet.has(languageOnly)) {
-                const q = parts.length > 1 ? parseFloat(parts[1].split('=')[1]) : 1;
+                const eq = semi === -1 ? -1 : trimmed.indexOf('=', semi);
+                const q = eq === -1 ? 1 : parseFloat(trimmed.slice(eq + 1));
                 if (!localeValue || localeValue.q < q) {
                     localeValue = { locale: languageOnly, q };
                 }

package/dist/src/server/functions/server.bench.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server/functions/server.bench.js

@@ -0,0 +1,39 @@
+import { bench, describe, vi } from 'vitest';
+const mockCookiesGet = () => ({ value: 'en' });
+vi.mock('next/headers', () => ({
+    cookies: vi.fn(async () => ({ get: mockCookiesGet })),
+}));
+describe('getMessage', () => {
+    bench('cold: dynamic import + cache write for an uncached locale', async () => {
+        vi.resetModules();
+        const { getMessage } = await import('./server');
+        await getMessage('en');
+    });
+    bench('warm: module-scope Map cache hit for an already-loaded locale', async () => {
+        const { getMessage } = await import('./server');
+        await getMessage('en');
+    });
+});
+describe('getTranslations', () => {
+    bench('cold: full namespace traversal + translator build', async () => {
+        vi.resetModules();
+        const { getTranslations } = await import('./server');
+        await getTranslations('Common', 'en');
+    });
+    bench('warm: translationFunctionsCache hit for repeated namespace/locale', async () => {
+        const { getTranslations } = await import('./server');
+        await getTranslations('Common', 'en');
+        await getTranslations('Common', 'en');
+    });
+});
+describe('getLocale', () => {
+    bench('cold: reads the locale cookie', async () => {
+        vi.resetModules();
+        const { getLocale } = await import('./server');
+        await getLocale();
+    });
+    bench('warm: module-scope currentLanguage cache hit', async () => {
+        const { getLocale } = await import('./server');
+        await getLocale();
+    });
+});

package/dist/src/server/functions/server.js

@@ -1,7 +1,7 @@
 import { getTranslationsImpl } from "../../general/general_functions";
 import config from "../../config/intl_config";
 import { localeCookieName } from "../../config/cookie_key";
-import { getLocaleCache, getMessageCache, setLocaleCache, setMessageForLocaleCache } from "../../general/cache_variables";
+import { getLocaleCache, getMessageCache, getTranslationCache, setLocaleCache, setMessageForLocaleCache } from "../../general/cache_variables";
 import { cache } from "react";
 import { localesSet } from "../../config/middleware";
 const isDev = process.env.NODE_ENV === 'development';
@@ -57,10 +57,14 @@ async function iGetTranslations(namespace, locale) {
     // Determine the effective locale, awaiting getLocale only if not provided.
     const effectiveLocale = locale ?? (await getLocale());
     const cacheKey = `${effectiveLocale}-${namespace}`;
-    // Return cached translation function immediately if available.
-    // if (translationFunctionsCache.has(cacheKey)) {
-    //     return translationFunctionsCache.get(cacheKey)!;
-    // }
+    // Return cached translation function immediately if available. Skipped
+    // in dev for the same reason iGetMessage skips its own cache read: a
+    // stale translator function built from a since-edited messages/*.json
+    // must not survive across requests during local development.
+    const cachedTranslation = isDev ? undefined : getTranslationCache(cacheKey);
+    if (cachedTranslation) {
+        return cachedTranslation;
+    }
     // Load messages for the effective locale. This also benefits from caching.
     const serverMessages = await iGetMessage(effectiveLocale);
     return getTranslationsImpl(effectiveLocale, serverMessages, namespace, cacheKey);

package/dist/src/server/functions/use_functions.bench.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server/functions/use_functions.bench.js

@@ -0,0 +1,23 @@
+import { bench, describe, vi } from 'vitest';
+import * as ReactModule from 'react';
+vi.mock('./server', () => ({
+    getLocale: vi.fn(async () => 'en'),
+    getMessage: vi.fn(async () => ({ Common: { title: 'Hello' } })),
+}));
+describe('useLocaleImpl', () => {
+    vi.spyOn(ReactModule, 'use').mockReturnValue('en');
+    bench('resolves the locale via use(getLocale())', async () => {
+        const { useLocaleImpl } = await import('./use_functions');
+        useLocaleImpl();
+    });
+});
+describe('useTranslations (RSC)', () => {
+    vi.spyOn(ReactModule, 'use')
+        .mockReturnValueOnce('en')
+        .mockImplementation(() => ({ Common: { title: 'Hello' } }));
+    bench('resolves locale + messages and builds a translation function', async () => {
+        const { useTranslations } = await import('./use_functions');
+        const t = useTranslations('Common');
+        t('title');
+    });
+});

package/dist/src/server/functions/use_functions.d.ts

@@ -12,6 +12,8 @@ import type { TranslatorReturnType } from "../../types/types";
  *
  * @returns The current locale (e.g. `"en"`).
  * @throws If called without an `IntlProvider` above it in the tree.
+ * @example
+ * const locale = useLocale(); // "en"
  */
 export declare function useLocaleImpl(): string;
 export declare const useLocale: typeof useLocaleImpl;
@@ -22,6 +24,9 @@ export declare const useLocale: typeof useLocaleImpl;
  * @param namespace Dot-separated key prefix into your messages file.
  * @returns A `(key: string) => string` translation function.
  * @throws If called without an `IntlProvider` above it in the tree.
+ * @example
+ * const t = useTranslations("Index");
+ * return <h1>{t("title")}</h1>;
  */
 declare function useTranslationsImpl(namespace: string): TranslatorReturnType;
 export declare const useTranslations: typeof useTranslationsImpl;

package/dist/src/server/functions/use_functions.js

@@ -1,6 +1,8 @@
 import { getTranslationsImpl } from "../../general/general_functions";
 import { getLocale, getMessage } from "./server";
+import { getTranslationCache } from "../../general/cache_variables";
 import { cache, use } from "react";
+const isDev = process.env.NODE_ENV === 'development';
 /**
  * React Server Component `useLocale`, reached via the `cloudflare-next-intl/use`
  * subpath's `react-server` condition (resolved automatically — you always
@@ -14,11 +16,13 @@ import { cache, use } from "react";
  *
  * @returns The current locale (e.g. `"en"`).
  * @throws If called without an `IntlProvider` above it in the tree.
+ * @example
+ * const locale = useLocale(); // "en"
  */
 export function useLocaleImpl() {
     const language = use(getLocale());
     if (language === undefined) {
-        throw new Error('Please set IntlProvider before using useLocale');
+        throw new Error('useLocale must be used within an IntlProvider');
     }
     return language;
 }
@@ -30,13 +34,24 @@ export const useLocale = cache(useLocaleImpl);
  * @param namespace Dot-separated key prefix into your messages file.
  * @returns A `(key: string) => string` translation function.
  * @throws If called without an `IntlProvider` above it in the tree.
+ * @example
+ * const t = useTranslations("Index");
+ * return <h1>{t("title")}</h1>;
  */
 function useTranslationsImpl(namespace) {
     const language = use(getLocale());
+    if (!language) {
+        throw new Error('useTranslations must be used within an IntlProvider');
+    }
+    const cacheKey = `${language}-${namespace}`;
+    const cachedTranslation = isDev ? undefined : getTranslationCache(cacheKey);
+    if (cachedTranslation) {
+        return cachedTranslation;
+    }
     const messages = use(getMessage(language));
-    if (!language || !messages) {
-        throw new Error('Please set IntlProvider before using useTranslations');
+    if (!messages) {
+        throw new Error('useTranslations must be used within an IntlProvider');
     }
-    return getTranslationsImpl(language, messages, namespace);
+    return getTranslationsImpl(language, messages, namespace, cacheKey);
 }
 export const useTranslations = cache(useTranslationsImpl);

package/dist/src/server/index.js

@@ -1,4 +1,7 @@
-// export { useLocale,useTranslations } from './functions/use_functions'; // Export specific server function
+// Intentionally not re-exported here: useLocale/useTranslations are public
+// via the "cloudflare-next-intl/use" subpath instead, which resolves to this
+// react-server implementation or the client one automatically via export conditions.
+// export { useLocale,useTranslations } from './functions/use_functions';
 export { getMessage as getMessage, getTranslations, getLocale } from './functions/server'; // Export specific server function
 export { default as IntlProvider } from './components/server_provider';
 export { default as Link } from './components/link';

package/dist/src/test_utils/mock_next_server.d.ts

@@ -0,0 +1,5 @@
+import { NextRequest } from 'next/server';
+export declare function makeTestRequest(url: string, init?: {
+    cookies?: Record<string, string>;
+    headers?: Record<string, string>;
+}): NextRequest;

package/dist/src/test_utils/mock_next_server.js

@@ -0,0 +1,10 @@
+import { NextRequest } from 'next/server';
+export function makeTestRequest(url, init) {
+    const request = new NextRequest(url, { headers: init?.headers });
+    if (init?.cookies) {
+        for (const [key, value] of Object.entries(init.cookies)) {
+            request.cookies.set(key, value);
+        }
+    }
+    return request;
+}

package/dist/src/types/types.d.ts

@@ -73,6 +73,53 @@ export interface RoutingConfig<AppLocales extends Locales, AppLocalePrefixMode e
      * By setting this to `false`, the cookie as well as the `accept-language` header will no longer be used for locale detection.
      **/
     localeDetection?: boolean;
+    /**
+     * Configures the optional `firebase_auth` submodule. Omit entirely (or
+     * leave undefined) to keep it fully disabled — no file in this package
+     * ever imports `firebase/app`/`firebase/auth` unless a firebase_auth
+     * export is actually called, and every such export throws a clear error
+     * if this field is missing at call time rather than silently no-op'ing.
+     */
+    firebaseAuth?: FirebaseAuthRoutingConfig;
+}
+export interface FirebaseAuthRoutingConfig {
+    /**
+     * Whether `intlMiddleware` should automatically run the firebase_auth
+     * redirect/session-refresh logic (guest→`redirectAuthPath`, signed-in→
+     * `homePath` on auth pages, ID-token refresh) for every request.
+     * Defaults to `true` — set `false` to keep `firebaseAuth` configured
+     * (e.g. for the client/server providers, actions) while driving the
+     * middleware redirect logic yourself instead.
+     */
+    middlewareEnabled?: boolean;
+    /** Firebase project's Web API key (`NEXT_PUBLIC_FIREBASE_API_KEY` equivalent). */
+    apiKey: string;
+    /** Firebase project's auth domain, e.g. "my-app.firebaseapp.com". */
+    authDomain: string;
+    /** Firebase project ID. */
+    projectId: string;
+    /** Firebase project's storage bucket. */
+    storageBucket?: string;
+    /** Firebase project's messaging sender ID. */
+    messagingSenderId?: string;
+    /** Firebase app ID. */
+    appId: string;
+    /** Firebase Analytics measurement ID. */
+    measurementId?: string;
+    /** Path to redirect signed-out users to, e.g. "/login". */
+    redirectAuthPath: string;
+    /** Path to redirect signed-in users away from auth pages to, e.g. "/". */
+    homePath: string;
+    /** Path to redirect unverified-email users to. Omit to skip email-verification redirects. */
+    verifyEmailPath?: string;
+    /** Returns true if the given (locale-stripped) path is an auth page (login/signup/etc). */
+    isAuthPath: (path: string) => boolean;
+    /** Locale-stripped paths exempt from all auth redirects (e.g. public marketing pages). */
+    whiteListPaths?: readonly string[];
+    /** Session cookie max-age in seconds. Defaults to 5 days (432000). */
+    sessionCookieMaxAge?: number;
+    /** Refresh-token cookie max-age in seconds. Defaults to 365 days (31536000). */
+    refreshTokenCookieMaxAge?: number;
 }
 export interface CookieAttributes {
     /**
@@ -185,7 +232,7 @@ export type TranslationEntry = string | TranslationObject;
 export interface TranslationObject {
     [key: string]: TranslationEntry;
 }
-export type ReturnType = any;
+export type ReturnType = string;
 export type TranslatorReturnType = (key: string) => ReturnType;
 export type changeFrequency = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never' | undefined;
 export type Alternates = {

package/llms.txt

@@ -0,0 +1,48 @@
+# cloudflare-next-intl
+
+Optimized next-intl-style i18n for Next.js App Router, tuned for Cloudflare
+Workers deployment (tree-shakeable, per-subpath exports instead of one big
+barrel). Requires a `@intl-config` path alias pointing at a config file built
+via `setIntlConfig` — see `src/config/README.md` / README "Setup" — before any
+other subpath can be used.
+
+## Subpaths
+
+- `.` — everything, re-exported (prefer the flat subpaths below for smaller bundles).
+- `./client` — client-side barrel: `LocaleLink`, `usePathname`, `setCookieClient`, `getCookieClient`.
+- `./server` — server-side barrel: `getMessage`, `getTranslations`, `getLocale`, `IntlProvider`, `Link`, `IntlHelperScript`, `getLocaleStaticParams`.
+- `./middleware` — `intlMiddleware` for `middleware.ts`; locale detection/rewrite/redirect.
+- `./setIntlConfig` — identity function for typed `RoutingConfig` authoring; use in your `@intl-config` file.
+- `./serverProvider` — `IntlProvider` server component (also under `./server`).
+- `./Link` — server-side locale-aware `<Link>` (also under `./server`).
+- `./IntlHelperScript` — inline script for flash-free locale/theme hydration.
+- `./LocaleLink` — client-side locale-aware link (counterpart to `./Link`).
+- `./usePathname` — client hook: pathname with locale prefix stripped.
+- `./metadata` — Next.js `generateMetadata` helper with locale alternates.
+- `./setCookieClient` / `./getCookieClient` — small client cookie utilities (not used internally for locale routing).
+- `./localeStaticParams` — `generateStaticParams` helper for locale segments.
+- `./use` — `useLocale`/`useTranslations`; resolves to the RSC or client implementation automatically via the `react-server` export condition. Both throw `"... must be used within an IntlProvider"` if called outside one.
+- `./ThemeSwitcher` — optional light/dark toggle component.
+
+## `firebaseAuth*` subpaths (require `firebaseAuth` set on your `RoutingConfig`)
+
+- `./firebaseAuthClient` — lazy Firebase client SDK getter.
+- `./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.
+
+## Conventions
+
+- Every exported function/component has a JSDoc comment with an `@example` where usage isn't obvious from the signature alone.
+- Errors from missing-provider hooks name the hook and the required provider explicitly (e.g. `"useAuthUser must be used within an AuthUserProvider"`).
+- One exported concept per file/subpath; `exports` in `package.json` is the source of truth for what's public — `src/**/index.ts` barrels are internal except `./client` and `./server`, which are themselves public subpaths.
+
+## Gotchas
+
+- Missing `@intl-config` alias (see README "Setup") throws at module-load time, before any of your own code runs.
+- Missing `firebaseAuth` on `RoutingConfig` throws immediately from any `firebaseAuth*` export, naming the missing config field.
+- `useLocale`/`useTranslations` (from `./use`) and `useAuthUser` (from `./useFirebaseAuthUser`) resolve to a Server- or Client-Component implementation automatically via the `react-server` export condition — always import from the subpath, never from an internal file path.
+- No unified `useFirebaseAuthUser` re-export inside `cloudflare-next-intl/firebaseAuth`'s barrel — that barrel can't replicate the `react-server` condition split, so import `cloudflare-next-intl/useFirebaseAuthUser` directly for the hook.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudflare-next-intl",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Optimized Next Intl Package Special for App Router and Cloudflare",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,8 @@
   "files": [
     "dist",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "llms.txt"
   ],
   "exports": {
     ".": {
@@ -55,10 +56,6 @@
       "types": "./dist/src/general/metadata.d.ts",
       "import": "./dist/src/general/metadata.js"
     },
-    "./getLayoutStates": {
-      "types": "./dist/src/general/get_layout_states.d.ts",
-      "import": "./dist/src/general/get_layout_states.js"
-    },
     "./setCookieClient": {
       "types": "./dist/src/client/functions/set_cookie.d.ts",
       "import": "./dist/src/client/functions/set_cookie.js"
@@ -84,15 +81,50 @@
     "./ThemeSwitcher": {
       "types": "./dist/src/theme_switcher/components/theme_switcher.d.ts",
       "import": "./dist/src/theme_switcher/components/theme_switcher.js"
+    },
+    "./firebaseAuthClient": {
+      "types": "./dist/src/firebase_auth/client/firebase_client.d.ts",
+      "import": "./dist/src/firebase_auth/client/firebase_client.js"
+    },
+    "./firebaseAuthClientProvider": {
+      "types": "./dist/src/firebase_auth/client/auth_user_provider.d.ts",
+      "import": "./dist/src/firebase_auth/client/auth_user_provider.js"
+    },
+    "./firebaseAuthServerProvider": {
+      "types": "./dist/src/firebase_auth/server/auth_user_server_provider.d.ts",
+      "import": "./dist/src/firebase_auth/server/auth_user_server_provider.js"
+    },
+    "./useFirebaseAuthUser": {
+      "react-server": {
+        "types": "./dist/src/firebase_auth/server/use_auth_user_server.d.ts",
+        "import": "./dist/src/firebase_auth/server/use_auth_user_server.js"
+      },
+      "default": {
+        "types": "./dist/src/firebase_auth/client/use_auth_user.d.ts",
+        "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"
+    },
+    "./firebaseAuthMiddleware": {
+      "types": "./dist/src/firebase_auth/middleware/update_session.d.ts",
+      "import": "./dist/src/firebase_auth/middleware/update_session.js"
     }
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "vitest run --coverage",
+    "bench": "vitest bench --run",
     "build": "tsc"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/DemienIlnutskiy/cloudflare-next-intl.git"
+    "url": "git+https://github.com/demian-ilnytskyi/cloudflare-next-intl.git"
   },
   "keywords": [
     "nextjs",
@@ -122,10 +154,11 @@
   "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",
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || >=19.0.0-rc <19.0.0 || ^19.0.0",
     "typescript": ">=5.0.0"
@@ -133,17 +166,26 @@
   "peerDependenciesMeta": {
     "typescript": {
       "optional": true
+    },
+    "firebase": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3",
     "@eslint/js": "^9.27.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^7.0.0",
+    "@testing-library/react": "^16.3.2",
     "@types/node": "^20.14.5",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@vitest/coverage-v8": "^3.2.7",
     "eslint": "^9.28.0",
     "eslint-config-next": "15.3.3",
     "eslint-config-prettier": "^10.1.2",
+    "firebase": "^12.17.0",
+    "jsdom": "^29.1.1",
     "next": "^15.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",