cloudflare-next-intl 0.8.49 → 0.8.50

package/README.md

@@ -527,7 +527,7 @@ export default function GlobalError({
 }
 ```
 
-- `isStaleDeployError(error: Error, patterns?: readonly string[]): boolean`: Returns `true` if the error indicates a missing chunk, failed fetch, CSS chunk failure, closed connection, corrupted RSC payload, or hydration error #412 from a stale deployment. Defaults to `defaultStaleDeployPatterns` (or patterns configured in `intl-config.ts` via `errorHandling.staleDeployPatterns`).
+- `isStaleDeployError(error: unknown, patterns?: readonly string[]): boolean`: Returns `true` if the error indicates a missing chunk, failed fetch, dynamically imported module failure, CSS chunk failure, closed connection, corrupted RSC payload, hydration error #412 from a stale deployment, or an aborted stream missing an error value (`undefined`). Defaults to `defaultStaleDeployPatterns` (or patterns configured in `intl-config.ts` via `errorHandling.staleDeployPatterns`).
 - `setStaleDeployPatterns(patterns: readonly string[]): void`: Setter to update the active pattern list and pre-compute lowercased substrings for maximum runtime performance.
 - `getStaleDeployPatterns(): readonly string[]`: Returns the currently active pattern list.
 - `clearClientCache(): Promise<void>`: Best-effort cleanup that deletes all CacheStorage caches (`window.caches`), unregisters active Service Workers, and clears `sessionStorage`.
@@ -557,8 +557,8 @@ export default function GlobalError({
 }
 ```
 
-- `useStaleDeployRecovery(error: Error, onRecover?: () => Promise<unknown>, delayMs = 5000): boolean`: Detects a stale-deploy error via `isStaleDeployError` and, **once per build id**, waits `delayMs`, runs `onRecover` (if provided) and `clearClientCache` in parallel, then reloads the page. The build id is read from `localStorage['buildId']` (set by `IntlHelperScript`'s `BUILD_ID` check) and a `sessionStorage` marker records which build id already spent its reload, so a repeat failure on the same build falls through to `false` (render your normal error UI) instead of reloading forever. A redeploy changes the build id and re-arms exactly one more attempt. **Exception:** if the build id was written within the last 60 seconds (`localStorage['buildIdSetAt']`, also set by `IntlHelperScript`), the hook recovers anyway — a stale-deploy error moments after adopting a new build is the deploy still settling, not a real failure, so the one-reload cap is bypassed for that window.
-- `shouldRecoverFromStaleDeploy(error: Error, buildId: string, marker: string | null, recentBuild = false): boolean`: The pure predicate behind the hook, exported for testing.
+- `useStaleDeployRecovery(error: unknown, onRecover?: () => Promise<unknown>, delayMs = 5000): boolean`: Detects a stale-deploy error via `isStaleDeployError` and, **once per build id**, waits `delayMs`, runs `onRecover` (if provided) and `clearClientCache` in parallel, then reloads the page. The build id is read from `localStorage['buildId']` (set by `IntlHelperScript`'s `BUILD_ID` check) and a `sessionStorage` marker records which build id already spent its reload, so a repeat failure on the same build falls through to `false` (render your normal error UI) instead of reloading forever. A redeploy changes the build id and re-arms exactly one more attempt. **Exception:** if the build id was written within the last 60 seconds (`localStorage['buildIdSetAt']`, also set by `IntlHelperScript`), the hook recovers anyway — a stale-deploy error moments after adopting a new build is the deploy still settling, not a real failure, so the one-reload cap is bypassed for that window.
+- `shouldRecoverFromStaleDeploy(error: unknown, buildId: string, marker: string | null, recentBuild = false): boolean`: The pure predicate behind the hook, exported for testing.
 - `isRecentBuild(setAt: number | null, now: number, windowMs = 60000): boolean`: Whether `setAt` (typically `buildIdSetAt`) falls within `windowMs` of `now`.
 
 ### Database (`db`)

package/dist/src/error_handling/install_console_error_override.d.ts

@@ -45,4 +45,14 @@ import { type ReportErrorConfig } from './report_error';
  *   `getCloudflareContext`/`ctx.waitUntil` available in the browser, so
  *   client-side reports always await `onError` directly.
  */
+/**
+ * Logged in place of a bare `undefined` when something calls
+ * `console.error()` with no arguments (or a single `undefined`) — an
+ * aborted RSC stream on a stale deploy does exactly this, leaving an
+ * unactionable `undefined` line in devtools. The raw value is still passed
+ * to `reportError` unchanged: `isStaleDeployError` treats exactly
+ * `undefined` as a stale deploy, so substituting a string here would break
+ * the recovery reload.
+ */
+export declare const EMPTY_CONSOLE_ERROR_MESSAGE = "console.error called with no message";
 export default function installConsoleErrorOverride(config: ReportErrorConfig | undefined, isClient?: boolean): void;

package/dist/src/error_handling/install_console_error_override.js

@@ -45,6 +45,29 @@ import reportError, { consoleOverrideState } from './report_error';
  *   `getCloudflareContext`/`ctx.waitUntil` available in the browser, so
  *   client-side reports always await `onError` directly.
  */
+/**
+ * Logged in place of a bare `undefined` when something calls
+ * `console.error()` with no arguments (or a single `undefined`) — an
+ * aborted RSC stream on a stale deploy does exactly this, leaving an
+ * unactionable `undefined` line in devtools. The raw value is still passed
+ * to `reportError` unchanged: `isStaleDeployError` treats exactly
+ * `undefined` as a stale deploy, so substituting a string here would break
+ * the recovery reload.
+ */
+export const EMPTY_CONSOLE_ERROR_MESSAGE = 'console.error called with no message';
+/**
+ * The frames BELOW this override — i.e. whoever actually called
+ * `console.error`. Devtools blames this module for every forwarded call
+ * (the real `console.error` runs from here), so an argument-less call left
+ * nothing but a bare `undefined` line pointing at this file. Captured
+ * lazily, only for that case.
+ */
+function callerStack() {
+    const stack = new Error().stack;
+    if (!stack)
+        return '';
+    return `\n${stack.split('\n').slice(3).join('\n')}`;
+}
 export default function installConsoleErrorOverride(config, isClient) {
     if (config?.errorHandling?.overrideConsoleError !== true)
         return;
@@ -55,7 +78,12 @@ export default function installConsoleErrorOverride(config, isClient) {
     const suppressOnClient = isClient === true && config.errorHandling?.suppressClientConsoleError === true;
     const override = (message, ...optionalParams) => {
         if (!suppressOnClient) {
-            originalConsoleError(message, ...optionalParams);
+            if (message === undefined && optionalParams.length === 0) {
+                originalConsoleError(`${EMPTY_CONSOLE_ERROR_MESSAGE}${callerStack()}`);
+            }
+            else {
+                originalConsoleError(message, ...optionalParams);
+            }
         }
         void reportError(config, { error: message, classOrMethodName: 'Global Console Error Handler', params: optionalParams, isClient });
     };

package/dist/src/error_handling/is_stale_deploy_error.js

@@ -1,5 +1,6 @@
 export const defaultStaleDeployPatterns = [
     'chunk',
+    'dynamically imported module',
     'failed to fetch',
     'loading css chunk',
     'connection closed',

package/dist/src/error_handling/stringify_unknown.js

@@ -30,6 +30,10 @@ function resolveFunctionError(value) {
  *   so a single unserializable nested value can't crash the whole report.
  */
 export default function stringifyUnknown(value, isClient, isNested = false) {
+    if (value === undefined)
+        return 'undefined';
+    if (value === null)
+        return 'null';
     if (typeof value === 'string')
         return stripAnsiCodes(value);
     if (value instanceof Error)

package/llms.txt

@@ -29,7 +29,7 @@ other subpath can be used.
 - `./dbHelpers` — generic Drizzle SQL helper functions (`excluded`, `onConflictSet`, `ago`, `currentDate`, `windowCount`, `unnestLateral`, `ascNullsLast`, `alwaysTrue`, `lateral`, `aliasColumn`, `minOf`, `maxOf`, `roundReal`, `multiply`, `scalarFromCte`) for use with `./db`.
 - `./vite` — `buildIdAsset(fileName?)`: Vite plugin to emit the client `BUILD_ID` asset (from `__VINEXT_SHARED_BUILD_ID` or `__VINEXT_BUILD_ID`) during build in Vinext/Vite environments.
 - `./errorHandling` — error reporting & stale deploy recovery barrel: `reportError`, `withErrorHandling`, `installConsoleErrorOverride`, `installGlobalErrorOverride`, `stringifyUnknown`, `formatErrorMessage`, `defaultIgnoredConsoleErrors`, `createServerErrorAction`, `isStaleDeployError`, `defaultStaleDeployPatterns`, `setStaleDeployPatterns`, `getStaleDeployPatterns`, `clearClientCache`, `useStaleDeployRecovery`, `shouldRecoverFromStaleDeploy`, `isRecentBuild`.
-- `./isStaleDeployError` — `isStaleDeployError(error, patterns?)`, `setStaleDeployPatterns(patterns)`, `getStaleDeployPatterns()`: detector returning `true` for version skew / chunk load / hydration errors (ChunkLoadError, failed to fetch, loading CSS chunk, connection closed, RSC payload failure, minified error #412) with fast pre-lowercased pattern cache and intl-config integration (`errorHandling.staleDeployPatterns`).
+- `./isStaleDeployError` — `isStaleDeployError(error, patterns?)`, `setStaleDeployPatterns(patterns)`, `getStaleDeployPatterns()`: detector returning `true` for version skew / chunk load / dynamic import / hydration errors (ChunkLoadError, failed to fetch, dynamically imported module failure, loading CSS chunk, connection closed, RSC payload failure, minified error #412, or missing stream error `undefined`) with fast pre-lowercased pattern cache and intl-config integration (`errorHandling.staleDeployPatterns`).
 - `./clearClientCache` — `clearClientCache()`: async helper wiping `window.caches`, unregistering service workers, and clearing `sessionStorage` for recovering from stale deployments.
 - `useStaleDeployRecovery(error, onRecover?, delayMs?)` (client hook, in `./errorHandling`) — once per build id (`localStorage['buildId']`, `sessionStorage` marker), waits `delayMs` (default 5000ms), runs optional `onRecover()` + `clearClientCache()` in parallel, then `window.location.reload()`. Returns whether a reload is pending, so caller renders a loading state instead of error UI. Recovers even past the one-reload cap when `localStorage['buildIdSetAt']` is <60s old (new deploy still settling). `shouldRecoverFromStaleDeploy(error, buildId, marker, recentBuild?)` and `isRecentBuild(setAt, now, windowMs?)` are the pure predicates.
 - `./createServerErrorAction` — `createServerErrorAction(action, config)`: wrapper for server actions with standardized error reporting.

package/package.json

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