cloudflare-next-intl 0.10.32 → 0.10.33

package/README.md

@@ -280,7 +280,7 @@ export default defineConfig({
 
    Being text-only and transitive, it can over-flag: any local file the page reaches — however many imports away — that merely *calls* a recognized signal counts, even along a branch that never runs in production (a `Config.isDev`-gated `fetch(..., { cache: "no-store" })`) or one that's optional/best-effort (a `try`/`catch`-wrapped `getAuthUser()` used only to tag a log line). It cannot see that a call is conditional or swallowed. For a page whose only reason for being flagged is that kind of optional read — attaching "whoever's signed in, if anyone" to an error report, analytics event, or log line — switch that read to `resolveOptionalAuthUser()` (`cloudflare-next-intl/resolveOptionalAuthUser`, see Firebase Auth below): it wraps `getAuthUser()` the same way but, being an npm-package import, is a boundary the scan doesn't open, so it contributes no signal. If that read lives in a shared `onError` sink used by many pages at once, `resolveErrorReportingUser(useAuthUser?)` (same subpath) is the more precise fix: it's off (`{ user: null }`, no `getAuthUser()` call) by default, and only a `reportError({ ..., useAuthUser: true })` call site that actually wants the user on that report opts in per-call — instead of every page reaching that sink getting flagged.
 2. **Auto Locale Params for Static Pages (`autoLocaleParams`)**: Automatically scans `page`/`layout`/`loading` files under a `[locale]`-scoped route during `configResolved` and inserts the `locale` param from `params` plus a `setLocale(locale)` call wherever `getTranslations()`/`useTranslations()` is used without one — the common cause of a page reading `NEXT_LOCALE` from cookies (and so implicitly becoming request-dependent) even though it never calls `cookies()` itself. Runs before `autoDynamicPages` so a page fixed this way no longer trips the cookie-derived-locale signal below. The scan (`checkLocaleParams`, also usable standalone from `cloudflare-next-intl/checkLocaleParams`, or via the `cfni-check-locale-params` CLI bin) is a text heuristic like `checkDynamicPages`; pass `mode: "report"` to only log without editing files, or `skip`/`overrides`/`localeParam` to fine-tune per-file.
-4. **Build-Time Image Optimizer (`imageOptimizer`)**: Automatically scans your image directories (`public/images`, `public/icons`), downscales oversized assets, produces sibling formats (`webp` by default; also supports `avif`, `png`, `jpeg`, `gif`, `tiff`, `heif`, `jp2`, `jxl`), generates 8px `.blur.webp` thumbnails with Next.js-matching SVG Gaussian blur placeholders, and provides transparent `<Image placeholder="blur" />` shimming via virtual modules. When more than one format is generated for an image, the shim renders a `<picture>` with one `<source>` per format — ordered exactly as configured — so the browser picks the best format it supports, with the original untouched file as an `onError` fallback if a generated asset fails to load. When the same image is used at different widths across the codebase, each size gets its own generated variant, and each `<Image>` usage automatically resolves to the closest matching size. Remote, `data:` and `blob:` srcs (e.g. upload previews) are never matched against the manifest and pass through untouched. Runs on production build only by default (`dev: false`) — downscaling/format conversion is a build concern, and re-scanning on every dev server start slows cold starts for no dev-time benefit; the shim degrades cleanly with no manifest (plain, unoptimized `next/image` rendering, no blur placeholder). Pass `dev: true` to also run it in dev and preview real optimized output/blur.
+4. **Build-Time Image Optimizer (`imageOptimizer`)**: Automatically scans your image directories (`public/images`, `public/icons`), downscales oversized assets, produces sibling formats (`webp` by default; also supports `avif`, `png`, `jpeg`, `gif`, `tiff`, `heif`, `jp2`, `jxl`), generates 8px `.blur.webp` thumbnails with Next.js-matching SVG Gaussian blur placeholders, and provides transparent `<Image placeholder="blur" />` shimming via virtual modules. When more than one format is generated for an image, the shim renders a `<picture>` with one `<source>` per format — ordered exactly as configured — so the browser picks the best format it supports, with the original untouched file as an `onError` fallback if a generated asset fails to load. When the same image is used at different widths across the codebase, each size gets its own generated variant, and each `<Image>` usage automatically resolves to the closest matching size. Remote, `data:` and `blob:` srcs (e.g. upload previews) are never matched against the manifest and pass through untouched. An auto-detected image loader is applied on the client, so `<Image>` stays safe in Server Components; a loader that throws falls back to the original `src`. Runs on production build only by default (`dev: false`) — downscaling/format conversion is a build concern, and re-scanning on every dev server start slows cold starts for no dev-time benefit; the shim degrades cleanly with no manifest (plain, unoptimized `next/image` rendering, no blur placeholder). Pass `dev: true` to also run it in dev and preview real optimized output/blur.
 5. **Locale File Bundling & Resolution (`localeFiles`)**: Resolves `@locale-file/*` to your `./messages` directory and transforms dynamic imports into `import.meta.glob('/messages/*.json', { eager: true })` for lightning-fast locale loading on Cloudflare Workers.
 6. **User-Agent Stub (`userAgentStub`)**: Prevents Next.js `user-agent` from importing `node:fs` during workerd runtime execution (which otherwise causes runtime 404 / 500 crashes in Workers proxy/middleware).
 7. **Cloudflare Workers Client Stub (`cfWorkersClientStub`)**: Stubs `cloudflare:workers` in client builds so shared modules can be referenced without client bundling errors.

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

@@ -31,7 +31,7 @@ export default function LocationzationClientProvider({ language, messages, initi
         providedChildren = _jsxs(AuthUserProvider, { initialUser: initialAuthUser, children: [children, config.firebaseAuth.performance !== false && (_jsx(Suspense, { fallback: null, children: _jsx(AutoFirebasePerformanceEvents, {}) }))] });
     }
     if (config.cookieConsent) {
-        providedChildren = _jsxs(CookieConsentProvider, { requiresConsent: requiresConsent, children: [providedChildren, analyticsConfig && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentAnalytics, { config: analyticsConfig }) })), analyticsConfig && (analyticsConfig.googleAnalyticsId || analyticsConfig.googleAdsId) && (_jsx(Suspense, { fallback: null, children: _jsx(AutoAnalyticsEvents, { config: autoAnalyticsEventsConfig }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentDialog, { ...dialogProps }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(PrivacyPolicyUpdateDialog, { ...updateDialogProps }) }))] });
+        providedChildren = _jsxs(CookieConsentProvider, { requiresConsent: requiresConsent, children: [providedChildren, analyticsConfig && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentAnalytics, { config: analyticsConfig }) })), analyticsConfig && (analyticsConfig.googleAnalyticsId || analyticsConfig.googleAdsId) && (_jsx(Suspense, { fallback: null, children: _jsx(AutoAnalyticsEvents, { config: autoAnalyticsEventsConfig ?? config.cookieConsent?.autoAnalyticsEvents }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentDialog, { ...(dialogProps ?? config.cookieConsent?.dialogProps) }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(PrivacyPolicyUpdateDialog, { ...(updateDialogProps ?? config.cookieConsent?.updateDialogProps) }) }))] });
     }
     const contextValue = useMemo(() => ({ language, messages }), [language, messages]);
     return _jsx(LocaleContext.Provider, { value: contextValue, children: providedChildren });

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

@@ -19,7 +19,7 @@ export default function LocationzationClientProvider({ language, messages, analy
     installGlobalErrorOverride(config);
     let providedChildren = children;
     if (config.cookieConsent) {
-        providedChildren = _jsxs(CookieConsentProvider, { requiresConsent: requiresConsent, children: [providedChildren, analyticsConfig && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentAnalytics, { config: analyticsConfig }) })), analyticsConfig && (analyticsConfig.googleAnalyticsId || analyticsConfig.googleAdsId) && (_jsx(Suspense, { fallback: null, children: _jsx(AutoAnalyticsEvents, { config: autoAnalyticsEventsConfig }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentDialog, { ...dialogProps }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(PrivacyPolicyUpdateDialog, { ...updateDialogProps }) }))] });
+        providedChildren = _jsxs(CookieConsentProvider, { requiresConsent: requiresConsent, children: [providedChildren, analyticsConfig && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentAnalytics, { config: analyticsConfig }) })), analyticsConfig && (analyticsConfig.googleAnalyticsId || analyticsConfig.googleAdsId) && (_jsx(Suspense, { fallback: null, children: _jsx(AutoAnalyticsEvents, { config: autoAnalyticsEventsConfig ?? config.cookieConsent?.autoAnalyticsEvents }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(CookieConsentDialog, { ...(dialogProps ?? config.cookieConsent?.dialogProps) }) })), autoWireDialogs && (_jsx(Suspense, { fallback: null, children: _jsx(PrivacyPolicyUpdateDialog, { ...(updateDialogProps ?? config.cookieConsent?.updateDialogProps) }) }))] });
     }
     const contextValue = useMemo(() => ({ language, messages }), [language, messages]);
     return _jsx(LocaleContext.Provider, { value: contextValue, children: providedChildren });

package/dist/src/error_handling/use_stale_deploy_recovery.js

@@ -119,11 +119,14 @@ export default function useStaleDeployRecovery(error, onRecover, delayMs = 1000)
             return;
         const buildId = currentBuildId();
         const timeout = setTimeout(() => {
+            let spent = 0;
+            try {
+                spent = currentAttempts(buildId, sessionStorage.getItem(RECOVERY_RELOAD_KEY));
+            }
+            catch { }
             Promise.all([initialOnRecover?.().catch(() => undefined), clearClientCache().catch(() => undefined)])
                 .finally(() => {
                 try {
-                    const marker = sessionStorage.getItem(RECOVERY_RELOAD_KEY);
-                    const spent = currentAttempts(buildId, marker);
                     sessionStorage.setItem(RECOVERY_RELOAD_KEY, buildId);
                     sessionStorage.setItem(RECOVERY_COUNT_KEY, String(spent + 1));
                     sessionStorage.setItem(RECOVERY_TIME_KEY, String(Date.now()));

package/dist/src/image_optimizer/next_image_client.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import type { ImageProps } from "next/image.js";
+type Loader = (props: {
+    src: string;
+    width: number;
+    quality?: number;
+}) => string;
+export declare function safeLoader(loader: Loader): Loader;
+export declare function NextImageClient(props: ImageProps): React.JSX.Element;
+export {};

package/dist/src/image_optimizer/next_image_client.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import NextImage from "next/image.js";
+let defaultCustomLoader;
+try {
+    const loaderMod = (await import("virtual:cloudflare-next-intl-image-loader"));
+    const candidate = loaderMod.defaultLoader ?? loaderMod.default;
+    defaultCustomLoader = typeof candidate === "function" ? candidate : undefined;
+}
+catch {
+    defaultCustomLoader = undefined;
+}
+export function safeLoader(loader) {
+    return (params) => {
+        try {
+            const url = loader(params);
+            if (typeof url === "string" && url !== "")
+                return url;
+        }
+        catch (error) {
+            console.error("[cloudflare-next-intl] image loader failed, using original src:", params.src, error);
+        }
+        return params.src;
+    };
+}
+const safeDefaultLoader = defaultCustomLoader ? safeLoader(defaultCustomLoader) : undefined;
+export function NextImageClient(props) {
+    const loader = typeof props.loader === "function" ? safeLoader(props.loader) : safeDefaultLoader;
+    return _jsx(NextImage, { ...props, loader: loader });
+}

package/dist/src/image_optimizer/next_image_shim.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import NextImage, { getImageProps as nextGetImageProps } from "next/image.js";
+import { getImageProps as nextGetImageProps } from "next/image.js";
 import { getImageBlurSvg } from "./blur_svg.js";
 import { ImgWithFallback } from "./img_with_fallback.js";
+import { NextImageClient } from "./next_image_client.js";
 function pickVariant(entry, requestedWidth) {
     if (!requestedWidth || !entry.variants || entry.variants.length === 0) {
         return entry;
@@ -96,13 +97,13 @@ function toPlainImgAttrs(resolved, src) {
         fetchPriority: priority ? "high" : "auto",
     };
 }
-function resolveProps(props) {
+function resolveProps(props, injectLoader = false) {
     let src = props.src;
     let blurDataURL = props.blurDataURL;
     let width = props.width;
     let height = props.height;
     let style = props.style;
-    const loader = props.loader ?? defaultCustomLoader;
+    const loader = injectLoader ? (props.loader ?? defaultCustomLoader) : props.loader;
     const entry = findEntry(src);
     if (entry) {
         const variant = pickVariant(entry, typeof props.width === "number" ? props.width : undefined);
@@ -145,7 +146,7 @@ export default function Image(props) {
         : undefined;
     const alternates = (variant?.sources ?? []).filter((source) => source.src !== variant?.src);
     if (alternates.length === 0) {
-        return _jsx(NextImage, { ...resolved });
+        return _jsx(NextImageClient, { ...resolved });
     }
     const primarySrc = variant?.src ?? String(resolved.src);
     const originalSrc = entry?.originalSrc;
@@ -153,7 +154,7 @@ export default function Image(props) {
     return (_jsxs("picture", { children: [alternates.map((source) => (_jsx("source", { type: source.type, sizes: imgProps.sizes, srcSet: source.src }, source.src))), _jsx(ImgWithFallback, { ...imgProps, originalSrc: originalSrc })] }));
 }
 export function getImageProps(props) {
-    const resolved = resolveProps(props);
+    const resolved = resolveProps(props, true);
     return nextGetImageProps(resolved);
 }
 export { getImageBlurSvg };

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

@@ -61,5 +61,5 @@ export default async function LocationzationProvider({ language, messages, stati
             }
         }
     }
-    return (_jsx(LocaleProvider, { language: language, messages: messagesValue, children: _jsx(Suspense, { fallback: children, children: _jsx(LocationzationClientProvider, { language: language, messages: messagesValue, initialAuthUser: initialAuthUser, skipAuthProvider: !autoWireClientProvider, analyticsConfig: analyticsConfig, autoAnalyticsEventsConfig: config.cookieConsent?.autoAnalyticsEvents, requiresConsent: requiresConsent, autoWireDialogs: config.cookieConsent?.autoWireDialogs !== false, dialogProps: config.cookieConsent?.dialogProps, updateDialogProps: config.cookieConsent?.updateDialogProps, children: children }) }) }));
+    return (_jsx(LocaleProvider, { language: language, messages: messagesValue, children: _jsx(Suspense, { fallback: children, children: _jsx(LocationzationClientProvider, { language: language, messages: messagesValue, initialAuthUser: initialAuthUser, skipAuthProvider: !autoWireClientProvider, analyticsConfig: analyticsConfig, requiresConsent: requiresConsent, autoWireDialogs: config.cookieConsent?.autoWireDialogs !== false, children: children }) }) }));
 }

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

@@ -49,5 +49,5 @@ export default async function LocationzationProvider({ language, messages, child
             }
         }
     }
-    return (_jsx(Suspense, { fallback: children, children: _jsx(LocationzationClientProvider, { language: language, messages: messagesValue, analyticsConfig: analyticsConfig, autoAnalyticsEventsConfig: config.cookieConsent?.autoAnalyticsEvents, requiresConsent: requiresConsent, autoWireDialogs: config.cookieConsent?.autoWireDialogs !== false, dialogProps: config.cookieConsent?.dialogProps, updateDialogProps: config.cookieConsent?.updateDialogProps, children: children }) }));
+    return (_jsx(Suspense, { fallback: children, children: _jsx(LocationzationClientProvider, { language: language, messages: messagesValue, analyticsConfig: analyticsConfig, requiresConsent: requiresConsent, autoWireDialogs: config.cookieConsent?.autoWireDialogs !== false, children: children }) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudflare-next-intl",
-  "version": "0.10.32",
+  "version": "0.10.33",
   "description": "Optimized Next Intl Package Special for App Router and Cloudflare",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",