cloudflare-next-intl 0.8.60 → 0.9.0

package/README.md

@@ -277,6 +277,8 @@ export default defineConfig({
                 formats: ["avif", "webp"],        // Target sibling formats, in browser-preference order (default: ["webp"], or `false`).
                                                    // Also supports: "png", "jpeg", "gif", "tiff", "heif", "jp2", "jxl"
                 quality: 80,                      // Compression quality (default: 80)
+                effort: 4,                        // Encoder effort 0-9 for avif/webp/png/heif/jxl (default: sharp's own default per format)
+                concurrency: 4,                   // Images processed in parallel (default: cpu count, clamped to 1-8)
                 blur: { quality: 70, stdDeviation: 20 }, // Next.js blur placeholder options (or `false`)
                 overrides: {                      // Per-image overrides keyed by public src path (wins over scanned <Image> props)
                     "/images/hero.png": { maxWidth: false, formats: ["webp"], blur: { quality: 80 } },
@@ -308,7 +310,7 @@ import { Image } from "cloudflare-next-intl/image";
 <Image src="/images/icon.svg" formats={false} blur={false} maxWidth={false} />
 ```
 
-Supported props: `formats` (array or `false`), `maxWidth` (number or `false`), `quality` (number), `blur` (`true`, `false`, or `{ size, quality, stdDeviation }`).
+Supported props: `formats` (array or `false`), `maxWidth` (number or `false`), `quality` (number), `blur` (`true`, `false`, or `{ size, quality, stdDeviation }`). `effort` is not scanned from JSX props — set it via the centralized `overrides` config or the global option.
 
 ##### Multi-Size Variants (Responsive Images)
 
@@ -454,6 +456,17 @@ export async function generateMetadata({ params }) {
 Set `firebaseAuth` on your `RoutingConfig` to enable — `IntlProvider` then
 auto-wires `AuthUserProvider` and server-side `getAuthUser` session validation.
 
+Requires `firebase` (or the scoped `@firebase/app` + `@firebase/auth` +
+`@firebase/app-check` + `@firebase/performance` packages) as a **peer**
+dependency — `npm install firebase` if you don't already have it. Declared as
+a peer, not a bundled dependency, so your own `firebase` install is the one
+and only copy that gets used: `@firebase/app` keeps its app registry
+(`getApps()`/`initializeApp()`) as module-level state, so a second, separately
+installed copy would silently initialize its own untracked Firebase app
+instead of joining yours. All `firebase_auth*` subpaths load their Firebase
+imports lazily (dynamic `import()`), so nothing is pulled in — installed or
+bundled — for apps that never set `firebaseAuth`.
+
 Features include:
 - `whiteListPaths`: Array of paths exempt from auth redirects (matches exact path or path-segment prefix, e.g. `/bonds` matches `/bonds/some-slug`).
 - `actionLinkPath`: Pinned route for handling Firebase action links (e.g. `/auth/action`), prioritized during cross-origin action link redirects.
@@ -593,7 +606,11 @@ third party without consent can itself be GDPR-relevant.
 
 #### Stale Deploy & Chunk Load Error Recovery
 
-When a new version of your application is deployed to Cloudflare Workers, users on older client sessions may encounter `ChunkLoadError` or failed dynamic imports when requesting outdated chunks. Use `isStaleDeployError` and `clearClientCache` in error boundaries or global error handlers to automatically recover:
+When a new version of your application is deployed to Cloudflare Workers, users on older client sessions may encounter `ChunkLoadError` or failed dynamic imports when requesting outdated chunks.
+
+`IntlHelperScript` renders an early-catch `<script>` (production only, id `stale-deploy-early-catch`) that runs before hydration and listens for `window.error`/`unhandledrejection` events matching the same patterns as `isStaleDeployError` (inlined as JSON, so it stays in sync with `staleDeployPatterns` config), then force-reloads once per build id. This covers the case a React-level recovery (`useStaleDeployRecovery` below) cannot: when the chunk that failed to load is part of your own error boundary/global-error bundle, React never gets a chance to render the recovery UI. Both layers share the same `sessionStorage['stale-deploy-recovery-reloaded']` marker keyed by build id, so they can't double-reload each other. No setup beyond rendering `<IntlHelperScript />` is required.
+
+For errors that don't crash the module graph itself (a normal thrown error reaching an error boundary), use `isStaleDeployError` and `clearClientCache` in error boundaries or global error handlers to automatically recover:
 
 ```typescript
 import { isStaleDeployError, clearClientCache } from "cloudflare-next-intl/errorHandling";
@@ -714,6 +731,36 @@ query code is identical either way — switching is a config change only.
 A direct connection always wins if both are configured, so adding a `supabase`
 block cannot silently reroute live traffic.
 
+#### Standalone usage (no Next.js / `@intl-config`)
+
+`withPublicDb`/`withUserDb` normally read their `db` config from
+`@intl-config` (Next.js apps, via `setIntlConfig`). Outside Next.js — Firebase
+Functions, a script, any plain TypeScript project with no bundler alias to
+set up — pass the `db` block directly as the last argument instead:
+
+```typescript
+// e.g. firebase/functions/src/index.ts — no @intl-config alias needed
+import { withPublicDb, withUserDb } from "cloudflare-next-intl/db";
+
+const rows = await withPublicDb(
+    (db) => db.select().from(bonds).limit(10),
+    { connectionString: process.env.DATABASE_URL },
+);
+
+const own = await withUserDb(
+    (db) => db.select().from(invitations),
+    uid,
+    { supabase: { url: process.env.SUPABASE_URL, anonKey: process.env.SUPABASE_ANON_KEY } },
+);
+```
+
+Import the whole package (`npm install cloudflare-next-intl`) but only the
+`cloudflare-next-intl/db` subpath — its dynamic `import()`s for `pg`/
+`drizzle-orm`/`@supabase/supabase-js` mean nothing Next.js/React-specific ever
+loads. This is the same `db` export Next.js apps use; the override argument is
+additive; Next.js call sites that omit it keep reading `@intl-config` exactly
+as before.
+
 ```typescript
 export default setIntlConfig({
     locales: ["en", "uk"] as const,
@@ -893,12 +940,12 @@ allowed to see the rows; call `.transaction(...)` on the handle either one
 hands your callback when a write needs more than one statement to succeed or
 fail together (see [Multi-statement transactions](#multi-statement-transactions-dbtransaction) above):
 
-- `withPublicDb(fn)` — runs `fn` as the anonymous role: a pooled connection
-  with no transaction/role switch in connection-string mode, or the anon key
-  as the PostgREST bearer token in Supabase mode. No user id is attached
-  either way, so RLS policies that test `auth.jwt()->>'sub'` will deny access
-  — use `withUserDb` for user-owned rows.
-- `withUserDb(fn, uid?)` — runs `fn` as the signed-in user. In
+- `withPublicDb(fn, dbOverride?)` — runs `fn` as the anonymous role: a pooled
+  connection with no transaction/role switch in connection-string mode, or the
+  anon key as the PostgREST bearer token in Supabase mode. No user id is
+  attached either way, so RLS policies that test `auth.jwt()->>'sub'` will
+  deny access — use `withUserDb` for user-owned rows.
+- `withUserDb(fn, uid?, dbOverride?)` — runs `fn` as the signed-in user. In
   connection-string mode this opens a transaction where Postgres sees the
   resolved user id as `auth.jwt()->>'sub'` under `db.authenticatedRole`; in
   Supabase mode identity instead rides on the JWT from `getAccessToken`/
@@ -909,6 +956,11 @@ fail together (see [Multi-statement transactions](#multi-statement-transactions-
   signed-in Firebase user when `firebaseAuth` is configured — you rarely need
   to pass it explicitly.
 
+`dbOverride` — a `db` block (`{ connectionString }` or `{ supabase }`) used
+for that one call instead of `@intl-config`'s. This is what makes `db` usable
+outside Next.js — see [Standalone usage](#standalone-usage-no-nextintl-config)
+below.
+
 ```typescript
 // anywhere on the server
 import { withPublicDb } from "cloudflare-next-intl/db";

package/dist/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/index.js

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/package.json

@@ -1,314 +1,3 @@
 {
-  "name": "cloudflare-next-intl",
-  "version": "0.8.53",
-  "description": "Optimized Next Intl Package Special for App Router and Cloudflare",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "sideEffects": false,
-  "bin": {
-    "cfni-db-codegen": "bin/db_codegen.mjs",
-    "cfni-db-install-exec": "bin/db_install_exec.mjs"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "supabase",
-    "LICENSE",
-    "README.md",
-    "llms.txt"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./client": {
-      "types": "./dist/src/client/index.d.ts",
-      "import": "./dist/src/client/index.js"
-    },
-    "./server": {
-      "types": "./dist/src/server/index.d.ts",
-      "import": "./dist/src/server/index.js"
-    },
-    "./geo": {
-      "types": "./dist/src/server/functions/geo.d.ts",
-      "import": "./dist/src/server/functions/geo.js"
-    },
-    "./getCountry": {
-      "types": "./dist/src/server/functions/geo.d.ts",
-      "import": "./dist/src/server/functions/geo.js"
-    },
-    "./getTimezone": {
-      "types": "./dist/src/server/functions/geo.d.ts",
-      "import": "./dist/src/server/functions/geo.js"
-    },
-    "./middleware": {
-      "types": "./dist/src/config/middleware.d.ts",
-      "import": "./dist/src/config/middleware.js"
-    },
-    "./setIntlConfig": {
-      "types": "./dist/src/config/init_config.d.ts",
-      "import": "./dist/src/config/init_config.js"
-    },
-    "./serverProvider": {
-      "types": "./dist/src/server/components/server_provider.d.ts",
-      "import": "./dist/src/server/components/server_provider.js"
-    },
-    "./serverProviderStatic": {
-      "types": "./dist/src/server/components/server_provider_static.d.ts",
-      "import": "./dist/src/server/components/server_provider_static.js"
-    },
-    "./Link": {
-      "types": "./dist/src/server/components/link.d.ts",
-      "import": "./dist/src/server/components/link.js"
-    },
-    "./IntlHelperScript": {
-      "types": "./dist/src/server/components/helper_script.d.ts",
-      "import": "./dist/src/server/components/helper_script.js"
-    },
-    "./LocaleLink": {
-      "types": "./dist/src/client/components/locale_link.d.ts",
-      "import": "./dist/src/client/components/locale_link.js"
-    },
-    "./usePathname": {
-      "types": "./dist/src/client/hooks/use_path_name.d.ts",
-      "import": "./dist/src/client/hooks/use_path_name.js"
-    },
-    "./metadata": {
-      "types": "./dist/src/general/metadata.d.ts",
-      "import": "./dist/src/general/metadata.js"
-    },
-    "./setCookieClient": {
-      "types": "./dist/src/client/functions/set_cookie.d.ts",
-      "import": "./dist/src/client/functions/set_cookie.js"
-    },
-    "./getCookieClient": {
-      "types": "./dist/src/client/functions/get_cookie.d.ts",
-      "import": "./dist/src/client/functions/get_cookie.js"
-    },
-    "./localeStaticParams": {
-      "types": "./dist/src/server/functions/locale_static_params.d.ts",
-      "import": "./dist/src/server/functions/locale_static_params.js"
-    },
-    "./use": {
-      "react-server": {
-        "types": "./dist/src/server/functions/use_functions.d.ts",
-        "import": "./dist/src/server/functions/use_functions.js"
-      },
-      "default": {
-        "types": "./dist/src/client/hooks/client_hooks.d.ts",
-        "import": "./dist/src/client/hooks/client_hooks.js"
-      }
-    },
-    "./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"
-    },
-    "./cookieConsent": {
-      "types": "./dist/src/cookie_consent/index.d.ts",
-      "import": "./dist/src/cookie_consent/index.js"
-    },
-    "./CookieConsentProvider": {
-      "types": "./dist/src/cookie_consent/client/cookie_consent_provider.d.ts",
-      "import": "./dist/src/cookie_consent/client/cookie_consent_provider.js"
-    },
-    "./useCookieConsent": {
-      "types": "./dist/src/cookie_consent/client/use_cookie_consent.d.ts",
-      "import": "./dist/src/cookie_consent/client/use_cookie_consent.js"
-    },
-    "./CookieConsentDialog": {
-      "types": "./dist/src/cookie_consent/client/components/cookie_consent_dialog.d.ts",
-      "import": "./dist/src/cookie_consent/client/components/cookie_consent_dialog.js"
-    },
-    "./PrivacyPolicyUpdateDialog": {
-      "types": "./dist/src/cookie_consent/client/components/privacy_policy_update_dialog.d.ts",
-      "import": "./dist/src/cookie_consent/client/components/privacy_policy_update_dialog.js"
-    },
-    "./cookieConsentAnalytics": {
-      "types": "./dist/src/cookie_consent/client/components/cookie_consent_analytics.d.ts",
-      "import": "./dist/src/cookie_consent/client/components/cookie_consent_analytics.js"
-    },
-    "./errorHandling": {
-      "types": "./dist/src/error_handling/index.d.ts",
-      "import": "./dist/src/error_handling/index.js"
-    },
-    "./installConsoleErrorOverride": {
-      "types": "./dist/src/error_handling/install_console_error_override.d.ts",
-      "import": "./dist/src/error_handling/install_console_error_override.js"
-    },
-    "./installGlobalErrorOverride": {
-      "types": "./dist/src/error_handling/install_global_error_override.d.ts",
-      "import": "./dist/src/error_handling/install_global_error_override.js"
-    },
-    "./stringifyUnknown": {
-      "types": "./dist/src/error_handling/stringify_unknown.d.ts",
-      "import": "./dist/src/error_handling/stringify_unknown.js"
-    },
-    "./formatErrorMessage": {
-      "types": "./dist/src/error_handling/format_error_message.d.ts",
-      "import": "./dist/src/error_handling/format_error_message.js"
-    },
-    "./defaultIgnoredConsoleErrors": {
-      "types": "./dist/src/error_handling/default_ignored_console_errors.d.ts",
-      "import": "./dist/src/error_handling/default_ignored_console_errors.js"
-    },
-    "./createServerErrorAction": {
-      "types": "./dist/src/error_handling/create_server_error_action.d.ts",
-      "import": "./dist/src/error_handling/create_server_error_action.js"
-    },
-    "./isStaleDeployError": {
-      "types": "./dist/src/error_handling/is_stale_deploy_error.d.ts",
-      "import": "./dist/src/error_handling/is_stale_deploy_error.js"
-    },
-    "./clearClientCache": {
-      "types": "./dist/src/error_handling/clear_client_cache.d.ts",
-      "import": "./dist/src/error_handling/clear_client_cache.js"
-    },
-    "./db": {
-      "types": "./dist/src/db/index.d.ts",
-      "import": "./dist/src/db/index.js"
-    },
-    "./dbEslint": {
-      "types": "./dist/src/db/eslint_config.d.ts",
-      "import": "./dist/src/db/eslint_config.js"
-    },
-    "./dbHelpers": {
-      "types": "./dist/src/db/helpers.d.ts",
-      "import": "./dist/src/db/helpers.js"
-    },
-    "./dbTesting": {
-      "types": "./dist/src/db/testing.d.ts",
-      "import": "./dist/src/db/testing.js"
-    },
-    "./dbSchema": {
-      "types": "./dist/src/db/schema.d.ts",
-      "import": "./dist/src/db/schema.js"
-    },
-    "./vite": {
-      "types": "./dist/src/vite/index.d.ts",
-      "import": "./dist/src/vite/index.js"
-    }
-  },
-  "scripts": {
-    "test": "vitest run --coverage",
-    "bench": "vitest bench --run",
-    "build": "tsc"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/demian-ilnytskyi/cloudflare-next-intl.git"
-  },
-  "keywords": [
-    "nextjs",
-    "i18n",
-    "internationalization",
-    "localization",
-    "multilingual",
-    "translation",
-    "language",
-    "optimized",
-    "performance",
-    "bundle-size",
-    "fast",
-    "efficient",
-    "app-router",
-    "server-components",
-    "ssr",
-    "ssg",
-    "tree-shaking",
-    "dynamic-imports",
-    "react",
-    "next-intl",
-    "messages",
-    "formatting",
-    "icu"
-  ],
-  "author": "Demian Ilnutskyi",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/demian-ilnytskyi/cloudflare-next-intl/issues"
-  },
-  "homepage": "https://github.com/demian-ilnytskyi/cloudflare-next-intl#readme",
-  "dependencies": {
-    "@microsoft/clarity": "^1.0.2",
-    "@supabase/supabase-js": "^2.112.3",
-    "drizzle-kit": "^0.31.10",
-    "drizzle-orm": "^0.45.2",
-    "embedded-postgres": "^18.4.0-beta.17",
-    "firebase": "^12.17.0",
-    "jose": "^6.2.8",
-    "pg": "^8.23.0"
-  },
-  "peerDependencies": {
-    "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",
-    "vite": ">=6"
-  },
-  "peerDependenciesMeta": {
-    "typescript": {
-      "optional": true
-    },
-    "vite": {
-      "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/pg": "^8.23.1",
-    "@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",
-    "jsdom": "^29.1.1",
-    "next": "^15.3.0",
-    "react": "19.2.0",
-    "react-dom": "19.2.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.5.3",
-    "typescript-eslint": "^8.33.1",
-    "vite": "^7.0.0",
-    "vitest": "^3.0.8"
-  }
+  "type": "module"
 }

package/dist/src/client/components/client_helper_script.js

@@ -1,7 +1,7 @@
 'use client';
 import { useEffect } from "react";
-import { isDarkCookieKey } from "../../config";
-import getCookie from "../functions/get_cookie";
+import { isDarkCookieKey } from "../../config/index.js";
+import getCookie from "../functions/get_cookie.js";
 export default function ClientHelperScript() {
     useEffect(() => {
         const isDark = getCookie(isDarkCookieKey);

package/dist/src/client/components/client_provider.d.ts

@@ -1,8 +1,8 @@
-import type { TranslationObject } from "../../types/types";
-import type { SerializedAuthUser } from "../../firebase_auth/types";
-import type { CookieConsentAnalyticsConfig, AutoAnalyticsEventsConfig } from "../../types/types";
-import type { CookieConsentDialogProps } from "../../cookie_consent/client/components/cookie_consent_dialog";
-import type { PrivacyPolicyUpdateDialogProps } from "../../cookie_consent/client/components/privacy_policy_update_dialog";
+import type { TranslationObject } from "../../types/types.js";
+import type { SerializedAuthUser } from "../../firebase_auth/types.js";
+import type { CookieConsentAnalyticsConfig, AutoAnalyticsEventsConfig } from "../../types/types.js";
+import type { CookieConsentDialogProps } from "../../cookie_consent/client/components/cookie_consent_dialog.js";
+import type { PrivacyPolicyUpdateDialogProps } from "../../cookie_consent/client/components/privacy_policy_update_dialog.js";
 interface LocaleContextType {
     language: string;
     messages: TranslationObject;
@@ -12,24 +12,12 @@ export default function LocationzationClientProvider({ language, messages, initi
     language: string;
     messages: TranslationObject;
     initialAuthUser?: SerializedAuthUser | null;
-    /** Set when `firebaseAuth.autoWireClientProvider` is `false` — skips wrapping `children` in the client `AuthUserProvider` entirely. */
     skipAuthProvider?: boolean;
-    /** Resolved server-side from `cookieConsent.analytics`/`getAnalytics` when `autoWireAnalytics` isn't `false`. */
     analyticsConfig?: CookieConsentAnalyticsConfig;
-    /** From `cookieConsent.autoAnalyticsEvents` — forwarded as-is to the auto-wired `AutoAnalyticsEvents`. */
     autoAnalyticsEventsConfig?: AutoAnalyticsEventsConfig;
-    /**
-     * Resolved server-side from `cookieConsent.getCountryCode`/`gdprCountries`.
-     * `false` means the visitor's country doesn't require the consent
-     * banner — `CookieConsentProvider` seeds consent as implicitly granted
-     * for a first-time visitor instead of `null`.
-     */
     requiresConsent?: boolean;
-    /** From `cookieConsent.autoWireDialogs` — renders `CookieConsentDialog`/`PrivacyPolicyUpdateDialog` automatically when `true` (default). */
     autoWireDialogs?: boolean;
-    /** From `cookieConsent.dialogProps` — forwarded as-is to the auto-wired `CookieConsentDialog`. */
     dialogProps?: CookieConsentDialogProps;
-    /** From `cookieConsent.updateDialogProps` — forwarded as-is to the auto-wired `PrivacyPolicyUpdateDialog`. */
     updateDialogProps?: PrivacyPolicyUpdateDialogProps;
     children: React.ReactNode;
 }): Component;

package/dist/src/client/components/client_provider.js

@@ -1,36 +1,24 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { setLocaleCache, setMessageForLocaleCache } from "../../general/cache_variables";
+import { setLocaleCache, setMessageForLocaleCache } from "../../general/cache_variables.js";
 import { createContext, useMemo } from "react";
 import dynamic from "next/dynamic";
 import config from "@intl-config";
-import installConsoleErrorOverride from "../../error_handling/install_console_error_override";
-import installGlobalErrorOverride from "../../error_handling/install_global_error_override";
+import installConsoleErrorOverride from "../../error_handling/install_console_error_override.js";
+import installGlobalErrorOverride from "../../error_handling/install_global_error_override.js";
 export const LocaleContext = createContext(undefined);
-// Hoisted to module scope — calling `dynamic()` inside the component body
-// creates a brand-new component identity every render, forcing React to
-// unmount/remount `AuthUserProvider` on every render instead of reusing the
-// existing instance. That remount re-subscribes `onIdTokenChanged`, which
-// Firebase immediately replays with the current user, triggering a state
-// update (and a `getIdToken(true)` refresh) that causes another render —
-// an infinite loop of session-cookie writes, one per render.
-const AuthUserProvider = dynamic(() => import("../../firebase_auth/client/auth_user_provider"));
-const AutoFirebasePerformanceEvents = dynamic(() => import("../../firebase_auth/client/components/auto_firebase_performance_events"));
-const CookieConsentProvider = dynamic(() => import("../../cookie_consent/client/cookie_consent_provider"));
-const CookieConsentAnalytics = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_analytics"));
-const AutoAnalyticsEvents = dynamic(() => import("../../cookie_consent/client/components/auto_analytics_events"));
-const CookieConsentDialog = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_dialog"));
-const PrivacyPolicyUpdateDialog = dynamic(() => import("../../cookie_consent/client/components/privacy_policy_update_dialog"));
+const AuthUserProvider = dynamic(() => import("../../firebase_auth/client/auth_user_provider.js"));
+const AutoFirebasePerformanceEvents = dynamic(() => import("../../firebase_auth/client/components/auto_firebase_performance_events.js"));
+const CookieConsentProvider = dynamic(() => import("../../cookie_consent/client/cookie_consent_provider.js"));
+const CookieConsentAnalytics = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_analytics.js"));
+const AutoAnalyticsEvents = dynamic(() => import("../../cookie_consent/client/components/auto_analytics_events.js"));
+const CookieConsentDialog = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_dialog.js"));
+const PrivacyPolicyUpdateDialog = dynamic(() => import("../../cookie_consent/client/components/privacy_policy_update_dialog.js"));
 export default function LocationzationClientProvider({ language, messages, initialAuthUser = null, skipAuthProvider = false, analyticsConfig, autoAnalyticsEventsConfig, requiresConsent = true, autoWireDialogs = true, dialogProps, updateDialogProps, children }) {
     setLocaleCache(language);
     setMessageForLocaleCache(language, messages);
     installConsoleErrorOverride(config, true);
     installGlobalErrorOverride(config);
-    // `LocaleContext.Provider` stays the outermost element here — the
-    // client `AuthUserProvider` (and its descendants calling
-    // usePathname()/useLocale()) must render as a CHILD of it, not a
-    // sibling wrapping it, or those hooks would throw for running outside
-    // the provider.
     let providedChildren = children;
     if (config.firebaseAuth && !skipAuthProvider) {
         providedChildren = _jsxs(AuthUserProvider, { initialUser: initialAuthUser, children: [children, config.firebaseAuth.performance !== false && _jsx(AutoFirebasePerformanceEvents, {})] });

package/dist/src/client/components/client_provider_static.d.ts

@@ -1,7 +1,7 @@
-import type { TranslationObject } from "../../types/types";
-import type { CookieConsentAnalyticsConfig, AutoAnalyticsEventsConfig } from "../../types/types";
-import type { CookieConsentDialogProps } from "../../cookie_consent/client/components/cookie_consent_dialog";
-import type { PrivacyPolicyUpdateDialogProps } from "../../cookie_consent/client/components/privacy_policy_update_dialog";
+import type { TranslationObject } from "../../types/types.js";
+import type { CookieConsentAnalyticsConfig, AutoAnalyticsEventsConfig } from "../../types/types.js";
+import type { CookieConsentDialogProps } from "../../cookie_consent/client/components/cookie_consent_dialog.js";
+import type { PrivacyPolicyUpdateDialogProps } from "../../cookie_consent/client/components/privacy_policy_update_dialog.js";
 interface LocaleContextType {
     language: string;
     messages: TranslationObject;
@@ -10,22 +10,11 @@ export declare const LocaleContext: import("react").Context<LocaleContextType |
 export default function LocationzationClientProvider({ language, messages, analyticsConfig, autoAnalyticsEventsConfig, requiresConsent, autoWireDialogs, dialogProps, updateDialogProps, children }: {
     language: string;
     messages: TranslationObject;
-    /** Resolved server-side from `cookieConsent.analytics`/`getAnalytics` when `autoWireAnalytics` isn't `false`. */
     analyticsConfig?: CookieConsentAnalyticsConfig;
-    /** From `cookieConsent.autoAnalyticsEvents` — forwarded as-is to the auto-wired `AutoAnalyticsEvents`. */
     autoAnalyticsEventsConfig?: AutoAnalyticsEventsConfig;
-    /**
-     * Resolved server-side from `cookieConsent.getCountryCode`/`gdprCountries`.
-     * `false` means the visitor's country doesn't require the consent
-     * banner — `CookieConsentProvider` seeds consent as implicitly granted
-     * for a first-time visitor instead of `null`.
-     */
     requiresConsent?: boolean;
-    /** From `cookieConsent.autoWireDialogs` — renders `CookieConsentDialog`/`PrivacyPolicyUpdateDialog` automatically when `true` (default). */
     autoWireDialogs?: boolean;
-    /** From `cookieConsent.dialogProps` — forwarded as-is to the auto-wired `CookieConsentDialog`. */
     dialogProps?: CookieConsentDialogProps;
-    /** From `cookieConsent.updateDialogProps` — forwarded as-is to the auto-wired `PrivacyPolicyUpdateDialog`. */
     updateDialogProps?: PrivacyPolicyUpdateDialogProps;
     children: React.ReactNode;
 }): Component;

package/dist/src/client/components/client_provider_static.js

@@ -1,25 +1,17 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { setLocaleCache, setMessageForLocaleCache } from "../../general/cache_variables";
+import { setLocaleCache, setMessageForLocaleCache } from "../../general/cache_variables.js";
 import { createContext, useMemo } from "react";
 import dynamic from "next/dynamic";
 import config from "@intl-config";
-import installConsoleErrorOverride from "../../error_handling/install_console_error_override";
-import installGlobalErrorOverride from "../../error_handling/install_global_error_override";
+import installConsoleErrorOverride from "../../error_handling/install_console_error_override.js";
+import installGlobalErrorOverride from "../../error_handling/install_global_error_override.js";
 export const LocaleContext = createContext(undefined);
-// `output: 'export'`-safe: unlike `client_provider.tsx`, this file has no
-// import anywhere in it pointing at `firebase_auth/client/auth_user_provider`
-// (which itself pulls in the "use server" `clear_session_action`). Next's
-// server-actions build step registers a "use server" file the moment any
-// `import()` in the compiled module graph points to it, so removing the
-// import entirely — not just skipping its use at runtime — is what keeps
-// `output: 'export'` builds from failing. See `server_provider_static.tsx`
-// for the full explanation.
-const CookieConsentProvider = dynamic(() => import("../../cookie_consent/client/cookie_consent_provider"));
-const CookieConsentAnalytics = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_analytics"));
-const AutoAnalyticsEvents = dynamic(() => import("../../cookie_consent/client/components/auto_analytics_events"));
-const CookieConsentDialog = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_dialog"));
-const PrivacyPolicyUpdateDialog = dynamic(() => import("../../cookie_consent/client/components/privacy_policy_update_dialog"));
+const CookieConsentProvider = dynamic(() => import("../../cookie_consent/client/cookie_consent_provider.js"));
+const CookieConsentAnalytics = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_analytics.js"));
+const AutoAnalyticsEvents = dynamic(() => import("../../cookie_consent/client/components/auto_analytics_events.js"));
+const CookieConsentDialog = dynamic(() => import("../../cookie_consent/client/components/cookie_consent_dialog.js"));
+const PrivacyPolicyUpdateDialog = dynamic(() => import("../../cookie_consent/client/components/privacy_policy_update_dialog.js"));
 export default function LocationzationClientProvider({ language, messages, analyticsConfig, autoAnalyticsEventsConfig, requiresConsent = true, autoWireDialogs = true, dialogProps, updateDialogProps, children }) {
     setLocaleCache(language);
     setMessageForLocaleCache(language, messages);

package/dist/src/client/components/locale_link.d.ts

@@ -4,27 +4,5 @@ type NextLinkProps = Omit<ComponentProps<'a'>, keyof LinkProps> & Omit<LinkProps
 export type LocaleLinkProps = NextLinkProps & {
     locale: string;
 };
-/**
- * Client-only link component for linking to a SPECIFIC locale — e.g. a
- * language switcher. Import from `cloudflare-next-intl/LocaleLink`.
- *
- * For normal in-app navigation that should stay on the current locale, use
- * the server-side `Link` (`cloudflare-next-intl/Link`) instead — it infers
- * the locale automatically and doesn't require `"use client"`.
- *
- * Renders inside a `Suspense` boundary; falls back to a disabled `<a>`
- * (`pointer-events-none`) while resolving.
- *
- * @param locale Required. The locale to link to (e.g. `"de"`), prepended to
- *   `href` regardless of the current locale.
- *
- * @example
- * ```tsx
- * "use client";
- * import LocaleLink from "cloudflare-next-intl/LocaleLink";
- *
- * <LocaleLink href="/about" locale="de">Über uns</LocaleLink> // -> "/de/about"
- * ```
- */
 declare const LocaleLink: import("react").ForwardRefExoticComponent<Omit<LocaleLinkProps, "ref"> & import("react").RefAttributes<HTMLAnchorElement>>;
 export default LocaleLink;