cloudflare-next-intl 0.8.52 → 0.8.53

package/README.md

@@ -239,22 +239,52 @@ export default setIntlConfig({
 });
 ```
 
-#### Vite Build ID Asset Plugin (`cloudflare-next-intl/vite`)
+#### Vite Plugin for Vinext & Cloudflare Workers (`cloudflare-next-intl/vite`)
 
-When building client assets with Vite / Vinext for Cloudflare Workers, use `buildIdAsset` to emit the static `BUILD_ID` asset:
+When using **Vinext** (Vite + Next.js App Router for Cloudflare Workers), add `cloudflareNextIntl()` to `vite.config.ts`. It is **required** for Vinext projects to resolve translations, bundle locale files, stub Node.js dependencies, and emit the build asset:
 
 ```typescript
 // vite.config.ts
 import { defineConfig } from "vite";
-import { buildIdAsset } from "cloudflare-next-intl/vite";
+import { cloudflareNextIntl } from "cloudflare-next-intl/vite";
 
 export default defineConfig({
     plugins: [
-        buildIdAsset(), // reads __VINEXT_SHARED_BUILD_ID or __VINEXT_BUILD_ID
+        cloudflareNextIntl(), // All plugins enabled by default
     ],
 });
 ```
 
+##### What `cloudflareNextIntl()` Does
+1. **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.
+2. **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).
+3. **Cloudflare Workers Client Stub (`cfWorkersClientStub`)**: Stubs `cloudflare:workers` in client builds so shared modules can be referenced without client bundling errors.
+4. **Build ID Asset Emission (`buildIdAsset`)**: Emits `BUILD_ID` static asset in the client build directory from `process.env.__VINEXT_SHARED_BUILD_ID` or `process.env.__VINEXT_BUILD_ID`.
+
+##### Plugin Options
+All features are enabled by default, and can be individually configured or toggled off:
+
+```typescript
+import { defineConfig } from "vite";
+import { cloudflareNextIntl } from "cloudflare-next-intl/vite";
+
+export default defineConfig({
+    plugins: [
+        cloudflareNextIntl({
+            messagesDir: "./messages",            // Path to locale JSON files (default: './messages')
+            intlConfigPath: "./src/l18n/intl_config.ts", // Path to intl config (auto-detected if omitted)
+            buildIdAsset: true,                   // Emit BUILD_ID asset (or custom string filename, default: true)
+            localeFiles: true,                    // Enable @locale-file & glob bundling (default: true)
+            userAgentStub: true,                  // Enable regex-based user-agent stub (default: true)
+            cfWorkersClientStub: true,            // Enable client cloudflare:workers stub (default: true)
+        }),
+    ],
+});
+```
+
+Individual standalone plugins are also exported if you only need a specific feature:
+`buildIdAsset`, `localeFilePlugin`, `userAgentStubPlugin`, `cfWorkersClientStubPlugin`.
+
 ```tsx
 // Client Components ("use client")
 import { useLocale } from "cloudflare-next-intl/use";
@@ -405,6 +435,7 @@ export default setIntlConfig({
     },
     cookieConsent: {
         privacyPolicyDate: "2026-01-01",
+        // showPrivacyPolicy: false, // defaults to true; set false to hide privacy policy link in dialogs
         // privacyPolicyPath: "/privacy-policy", // default; used by the
         // dialogs' auto-rendered link. Set false to disable that link.
         // country-based gating is enabled by default (reads Cloudflare geo
@@ -414,8 +445,8 @@ export default setIntlConfig({
         // gdprCountries: [...], // defaults to EU/EEA + UK + Switzerland
         // enableAnalyticsInDevMode: true, // analytics stay off in dev otherwise
         // autoWireDialogs: false, // opt out and render the dialogs yourself
-        // dialogProps: { acceptText: "Accept" }, // forwarded to CookieConsentDialog
-        // updateDialogProps: { closeText: "Got it" }, // forwarded to PrivacyPolicyUpdateDialog
+        // dialogProps: { acceptText: "Accept", showPrivacyPolicy: true }, // forwarded to CookieConsentDialog
+        // updateDialogProps: { closeText: "Got it", showPrivacyPolicy: true }, // forwarded to PrivacyPolicyUpdateDialog
     },
 });
 ```

package/dist/package.json

@@ -0,0 +1,314 @@
+{
+  "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"
+  }
+}

package/dist/src/config/middleware.js

@@ -87,6 +87,23 @@ export default async function intlMiddleware(request, options) {
             pathWithoutLocale = pathname;
         }
         const effectiveLocaleForRequest = urlLocale ?? initialChosenLocale;
+        const country = request.cf?.country ?? request.headers.get('cf-ipcountry') ?? request.headers.get('x-cf-country');
+        if (country) {
+            request.headers.set('x-cf-country', country);
+        }
+        const timezone = request.cf?.timezone ?? request.headers.get('cf-timezone') ?? request.headers.get('x-cf-timezone');
+        if (timezone) {
+            request.headers.set('x-cf-timezone', timezone);
+        }
+        const requestHeaders = new Headers(request.headers);
+        requestHeaders.set('x-pathname', pathWithoutLocale);
+        requestHeaders.set('x-search', search);
+        if (country) {
+            requestHeaders.set('x-cf-country', country);
+        }
+        if (timezone) {
+            requestHeaders.set('x-cf-timezone', timezone);
+        }
         let response;
         let isRedirect = false;
         let rewriteUrl;
@@ -96,7 +113,7 @@ export default async function intlMiddleware(request, options) {
             const localeUrl = new URL(`${targetPath}${search}${hash}`, request.url);
             if (initialChosenLocale === config.defaultLocale) {
                 rewriteUrl = localeUrl;
-                response = NextResponse.rewrite(localeUrl, { request });
+                response = NextResponse.rewrite(localeUrl, { request: { headers: requestHeaders } });
             }
             else {
                 isRedirect = true;
@@ -106,7 +123,9 @@ export default async function intlMiddleware(request, options) {
         }
         else {
             response = NextResponse.next({
-                request,
+                request: {
+                    headers: requestHeaders,
+                },
             });
         }
         if (options?.middlewareHandler && (!isRedirect || options.runHandlerOnRedirect)) {
@@ -130,14 +149,10 @@ export default async function intlMiddleware(request, options) {
         response.headers.set('Content-Language', effectiveLocaleForRequest);
         response.headers.set('x-pathname', pathWithoutLocale);
         response.headers.set('x-search', search);
-        const country = request.cf?.country ?? request.headers.get('cf-ipcountry') ?? request.headers.get('x-cf-country');
         if (country) {
-            request.headers.set('x-cf-country', country);
             response.headers.set('x-cf-country', country);
         }
-        const timezone = request.cf?.timezone ?? request.headers.get('cf-timezone') ?? request.headers.get('x-cf-timezone');
         if (timezone) {
-            request.headers.set('x-cf-timezone', timezone);
             response.headers.set('x-cf-timezone', timezone);
         }
         // Auto-wires the firebase_auth submodule's redirect/session-refresh

package/dist/src/cookie_consent/client/components/cookie_consent_dialog.d.ts

@@ -11,6 +11,11 @@ export interface CookieConsentDialogProps {
     link?: React.ReactNode;
     /** Label for the default privacy-policy link. Ignored when `link` is set. */
     privacyPolicyLinkText?: string;
+    /**
+     * Whether to show the privacy policy link. Defaults to `cookieConsent.showPrivacyPolicy`
+     * (or `true` if unconfigured). Pass `false` to hide it, or `true` to force show.
+     */
+    showPrivacyPolicy?: boolean;
     acceptText?: string;
     declineText?: string;
     /** Hides the decline ("necessary only") button, leaving only accept. */
@@ -32,4 +37,4 @@ export interface CookieConsentDialogProps {
  * `render` (full custom markup) — none of it is hardcoded to Tailwind or any
  * particular design system.
  */
-export default function CookieConsentDialog({ message, link, privacyPolicyLinkText, acceptText, declineText, hideDecline, id, classNames, styles, render, }: CookieConsentDialogProps): React.ReactElement | null;
+export default function CookieConsentDialog({ message, link, privacyPolicyLinkText, showPrivacyPolicy, acceptText, declineText, hideDecline, id, classNames, styles, render, }: CookieConsentDialogProps): React.ReactElement | null;

package/dist/src/cookie_consent/client/components/cookie_consent_dialog.js

@@ -12,8 +12,8 @@ import { defaultCookieDialogClassNames } from './default_dialog_styles';
  * `render` (full custom markup) — none of it is hardcoded to Tailwind or any
  * particular design system.
  */
-export default function CookieConsentDialog({ message, link, privacyPolicyLinkText, acceptText, declineText, hideDecline = false, id = 'cookie-consent-dialog', classNames, styles, render, }) {
-    const { consent, requiresConsent, isMounted, setConsent, privacyPolicyPath } = useCookieConsent();
+export default function CookieConsentDialog({ message, link, privacyPolicyLinkText, showPrivacyPolicy, acceptText, declineText, hideDecline = false, id = 'cookie-consent-dialog', classNames, styles, render, }) {
+    const { consent, requiresConsent, isMounted, setConsent, privacyPolicyPath, showPrivacyPolicy: showPrivacyPolicyCtx } = useCookieConsent();
     if (!isMounted || !requiresConsent || consent !== null)
         return null;
     if (render)
@@ -24,8 +24,11 @@ export default function CookieConsentDialog({ message, link, privacyPolicyLinkTe
     const resolvedAcceptText = acceptText ?? text.acceptText;
     const resolvedDeclineText = declineText ?? text.declineText;
     const resolvedClassNames = { ...defaultCookieDialogClassNames, ...classNames };
+    const shouldShowPolicy = showPrivacyPolicy ?? showPrivacyPolicyCtx;
     const resolvedLink = link !== undefined
         ? link
-        : _jsx(DefaultPrivacyPolicyLink, { privacyPolicyPath: privacyPolicyPath, text: resolvedPrivacyPolicyLinkText, className: resolvedClassNames.link });
+        : (shouldShowPolicy && privacyPolicyPath !== false)
+            ? _jsx(DefaultPrivacyPolicyLink, { privacyPolicyPath: privacyPolicyPath, text: resolvedPrivacyPolicyLinkText, className: resolvedClassNames.link })
+            : null;
     return (_jsx(DialogPortal, { children: _jsxs("div", { id: id, role: "dialog", "aria-modal": "false", "aria-labelledby": `${id}-title`, className: resolvedClassNames.root, style: styles?.root, children: [_jsxs("p", { id: `${id}-title`, className: resolvedClassNames.message, style: styles?.message, children: [resolvedMessage, resolvedLink ? _jsxs("span", { children: [" ", resolvedLink] }) : null] }), _jsxs("div", { className: resolvedClassNames.actions, style: styles?.actions, children: [!hideDecline && (_jsx("button", { type: "button", onClick: () => setConsent(false), className: resolvedClassNames.declineButton, style: styles?.declineButton, children: resolvedDeclineText })), _jsx("button", { type: "button", onClick: () => setConsent(true), className: resolvedClassNames.acceptButton, style: styles?.acceptButton, children: resolvedAcceptText })] })] }) }));
 }

package/dist/src/cookie_consent/client/components/privacy_policy_update_dialog.d.ts

@@ -10,6 +10,11 @@ export interface PrivacyPolicyUpdateDialogProps {
     link?: React.ReactNode;
     /** Label for the default privacy-policy link. Ignored when `link` is set. */
     privacyPolicyLinkText?: string;
+    /**
+     * Whether to show the privacy policy link. Defaults to `cookieConsent.showPrivacyPolicy`
+     * (or `true` if unconfigured). Pass `false` to hide it, or `true` to force show.
+     */
+    showPrivacyPolicy?: boolean;
     closeText?: string;
     id?: string;
     classNames?: CookieDialogClassNames;
@@ -28,4 +33,4 @@ export interface PrivacyPolicyUpdateDialogProps {
  * `null` otherwise, or once acknowledged. Every visual aspect is overridable
  * via `classNames`/`styles` (per-slot) or `render` (full custom markup).
  */
-export default function PrivacyPolicyUpdateDialog({ message, link, privacyPolicyLinkText, closeText, id, classNames, styles, render, }: PrivacyPolicyUpdateDialogProps): React.ReactElement | null;
+export default function PrivacyPolicyUpdateDialog({ message, link, privacyPolicyLinkText, showPrivacyPolicy, closeText, id, classNames, styles, render, }: PrivacyPolicyUpdateDialogProps): React.ReactElement | null;

package/dist/src/cookie_consent/client/components/privacy_policy_update_dialog.js

@@ -12,8 +12,8 @@ import { defaultCookieDialogClassNames } from './default_dialog_styles';
  * `null` otherwise, or once acknowledged. Every visual aspect is overridable
  * via `classNames`/`styles` (per-slot) or `render` (full custom markup).
  */
-export default function PrivacyPolicyUpdateDialog({ message, link, privacyPolicyLinkText, closeText, id = 'privacy-policy-update-dialog', classNames, styles, render, }) {
-    const { privacyPolicyUpdated, acknowledgePrivacyPolicyUpdate, privacyPolicyPath } = useCookieConsent();
+export default function PrivacyPolicyUpdateDialog({ message, link, privacyPolicyLinkText, showPrivacyPolicy, closeText, id = 'privacy-policy-update-dialog', classNames, styles, render, }) {
+    const { privacyPolicyUpdated, acknowledgePrivacyPolicyUpdate, privacyPolicyPath, showPrivacyPolicy: showPrivacyPolicyCtx } = useCookieConsent();
     if (!privacyPolicyUpdated)
         return null;
     if (render)
@@ -23,8 +23,11 @@ export default function PrivacyPolicyUpdateDialog({ message, link, privacyPolicy
     const resolvedPrivacyPolicyLinkText = privacyPolicyLinkText ?? text.privacyPolicyLinkText;
     const resolvedCloseText = closeText ?? text.closeText;
     const resolvedClassNames = { ...defaultCookieDialogClassNames, ...classNames };
+    const shouldShowPolicy = showPrivacyPolicy ?? showPrivacyPolicyCtx;
     const resolvedLink = link !== undefined
         ? link
-        : _jsx(DefaultPrivacyPolicyLink, { privacyPolicyPath: privacyPolicyPath, text: resolvedPrivacyPolicyLinkText, className: resolvedClassNames.link });
+        : (shouldShowPolicy && privacyPolicyPath !== false)
+            ? _jsx(DefaultPrivacyPolicyLink, { privacyPolicyPath: privacyPolicyPath, text: resolvedPrivacyPolicyLinkText, className: resolvedClassNames.link })
+            : null;
     return (_jsx(DialogPortal, { children: _jsxs("div", { id: id, role: "dialog", "aria-modal": "false", "aria-labelledby": `${id}-title`, className: resolvedClassNames.root, style: styles?.root, children: [_jsxs("p", { id: `${id}-title`, className: resolvedClassNames.message, style: styles?.message, children: [resolvedMessage, resolvedLink ? _jsxs("span", { children: [" ", resolvedLink] }) : null] }), _jsx("button", { type: "button", onClick: acknowledgePrivacyPolicyUpdate, "aria-label": resolvedCloseText, className: resolvedClassNames.closeButton, style: styles?.closeButton, children: resolvedCloseText })] }) }));
 }

package/dist/src/cookie_consent/client/cookie_consent_provider.js

@@ -49,7 +49,7 @@ function parseConsent(raw) {
  * ```
  */
 export default function CookieConsentProvider({ requiresConsent = true, children }) {
-    const { consentCookieName, dateCookieName, maxAge, policyDate, privacyPolicyPath } = useMemo(() => {
+    const { consentCookieName, dateCookieName, maxAge, policyDate, privacyPolicyPath, showPrivacyPolicy } = useMemo(() => {
         const cc = requireCookieConsentConfig(config.cookieConsent);
         return {
             consentCookieName: cc.consentCookieName ?? cookieConsentCookieKey,
@@ -57,6 +57,7 @@ export default function CookieConsentProvider({ requiresConsent = true, children
             maxAge: cc.cookieMaxAge ?? 31536000,
             policyDate: cc.privacyPolicyDate ? new Date(cc.privacyPolicyDate) : null,
             privacyPolicyPath: cc.privacyPolicyPath ?? '/privacy-policy',
+            showPrivacyPolicy: cc.showPrivacyPolicy ?? true,
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
@@ -120,6 +121,6 @@ export default function CookieConsentProvider({ requiresConsent = true, children
             acknowledgePrivacyPolicyUpdate();
         }
     }, [pathname, privacyPolicyUpdated, privacyPolicyPath, acknowledgePrivacyPolicyUpdate]);
-    const contextValue = useMemo(() => ({ consent, requiresConsent, privacyPolicyUpdated, isMounted, setConsent, acknowledgePrivacyPolicyUpdate, privacyPolicyPath }), [consent, requiresConsent, privacyPolicyUpdated, isMounted, setConsent, acknowledgePrivacyPolicyUpdate, privacyPolicyPath]);
+    const contextValue = useMemo(() => ({ consent, requiresConsent, privacyPolicyUpdated, isMounted, setConsent, acknowledgePrivacyPolicyUpdate, privacyPolicyPath, showPrivacyPolicy }), [consent, requiresConsent, privacyPolicyUpdated, isMounted, setConsent, acknowledgePrivacyPolicyUpdate, privacyPolicyPath, showPrivacyPolicy]);
     return (_jsx(CookieConsentContext.Provider, { value: contextValue, children: children }));
 }

package/dist/src/cookie_consent/gdpr_countries.d.ts

@@ -1,8 +1,8 @@
-import type { CookieConsentGetCloudflareContext, ErrorHandlingRoutingConfig } from '../types/types';
+import type { CookieConsentGetCloudflareContext, ErrorHandlingRoutingConfig, GenerateRoutingConfig } from '../types/types';
 /**
  * Default `cookieConsent.gdprCountries` — EU/EEA member states (GDPR),
  * Iceland/Liechtenstein/Norway (EEA), the UK (UK-GDPR), and Switzerland
  * (nFADP). ISO 3166-1 alpha-2.
  */
 export declare const defaultGdprCountries: readonly string[];
-export default function resolveRequiresConsent(getCountryCode: (() => string | undefined | Promise<string | undefined>) | undefined, getCloudflareContext: CookieConsentGetCloudflareContext | undefined, gdprCountries: readonly string[] | undefined, errorHandlingConfig?: ErrorHandlingRoutingConfig, countryHeaderNames?: readonly string[]): Promise<boolean>;
+export default function resolveRequiresConsent(getCountryCode: (() => string | undefined | Promise<string | undefined>) | undefined, getCloudflareContext: CookieConsentGetCloudflareContext | undefined, gdprCountries: readonly string[] | undefined, errorHandlingConfig?: ErrorHandlingRoutingConfig, countryHeaderNames?: readonly string[], generateConfig?: GenerateRoutingConfig): Promise<boolean>;

package/dist/src/cookie_consent/gdpr_countries.js

@@ -32,7 +32,7 @@ function getGdprCountriesSet(gdprCountries) {
     }
     return set;
 }
-export default async function resolveRequiresConsent(getCountryCode, getCloudflareContext, gdprCountries, errorHandlingConfig, countryHeaderNames) {
+export default async function resolveRequiresConsent(getCountryCode, getCloudflareContext, gdprCountries, errorHandlingConfig, countryHeaderNames, generateConfig) {
     let countryCode;
     if (getCountryCode) {
         countryCode = await getCountryCode();
@@ -51,7 +51,7 @@ export default async function resolveRequiresConsent(getCountryCode, getCloudfla
     // headers off the current request.
     if (typeof countryCode !== 'string' || !countryCode) {
         try {
-            countryCode = await getCountry(undefined, undefined, countryHeaderNames);
+            countryCode = await getCountry(undefined, generateConfig, countryHeaderNames);
         }
         catch {
             return true;

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

@@ -43,6 +43,11 @@ export interface CookieConsentContextType {
      * when their `link` prop is omitted.
      */
     privacyPolicyPath: string | false;
+    /**
+     * Whether the privacy policy link should be shown in default dialogs.
+     * Defaults to `true`.
+     */
+    showPrivacyPolicy: boolean;
 }
 /** Slot-level style/class overrides accepted by the default dialog components. */
 export interface CookieDialogClassNames {

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

@@ -144,7 +144,7 @@ export default async function LocationzationProvider({ language, messages, stati
         // `getCloudflareContext` path in dev; fail-safe to `true`
         // (banner shown) same as an unresolved country would.
         requiresConsent = !isDevEnvironment
-            ? await resolveRequiresConsent(config.cookieConsent.getCountryCode, config.generate?.getCloudflareContext, config.cookieConsent.gdprCountries, config.errorHandling, config.cookieConsent.countryHeaderNames)
+            ? await resolveRequiresConsent(config.cookieConsent.getCountryCode, config.generate?.getCloudflareContext, config.cookieConsent.gdprCountries, config.errorHandling, config.cookieConsent.countryHeaderNames, config.generate)
             : false;
         const analyticsAllowedInEnv = config.cookieConsent.enableAnalyticsInDevMode === true || !isDevEnvironment;
         if (config.cookieConsent.autoWireAnalytics !== false && analyticsAllowedInEnv) {

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

@@ -87,7 +87,7 @@ export default async function LocationzationProvider({ language, messages, child
         // `getCloudflareContext` path in dev; fail-safe to `true`
         // (banner shown) same as an unresolved country would.
         requiresConsent = !isDevEnvironment
-            ? await resolveRequiresConsent(config.cookieConsent.getCountryCode, config.generate?.getCloudflareContext, config.cookieConsent.gdprCountries, config.errorHandling, config.cookieConsent.countryHeaderNames)
+            ? await resolveRequiresConsent(config.cookieConsent.getCountryCode, config.generate?.getCloudflareContext, config.cookieConsent.gdprCountries, config.errorHandling, config.cookieConsent.countryHeaderNames, config.generate)
             : false;
         const analyticsAllowedInEnv = config.cookieConsent.enableAnalyticsInDevMode === true || !isDevEnvironment;
         if (config.cookieConsent.autoWireAnalytics !== false && analyticsAllowedInEnv) {

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

@@ -10,7 +10,7 @@ export declare const defaultTimezoneHeaderNames: readonly string[];
  * 1. Explicit `input` (Request, NextRequest, or Headers) if provided
  * 2. Next.js request headers via `headers()` (`headerNames`, default
  *    `x-cf-country`, `cf-ipcountry`)
- * 3. `generate.getCloudflareContext` or `cf.country` if passed
+ * 3. `generate.ctx` or `generate.getCloudflareContext` or `cf.country` if passed
  * 4. `undefined` if outside request scope or unavailable
  */
 export declare function getCountry(input?: RequestOrHeaders, generate?: GenerateRoutingConfig, headerNames?: readonly string[]): Promise<string | undefined>;
@@ -21,7 +21,7 @@ export declare function getCountry(input?: RequestOrHeaders, generate?: Generate
  * 1. Explicit `input` (Request, NextRequest, or Headers) if provided
  * 2. Next.js request headers via `headers()` (`headerNames`, default
  *    `x-cf-timezone`, `cf-timezone`)
- * 3. `generate.getCloudflareContext` or `cf.timezone` if passed
+ * 3. `generate.ctx` or `generate.getCloudflareContext` or `cf.timezone` if passed
  * 4. `fallback` (or `undefined`) if outside request scope or unavailable
  */
 export declare function getTimezone(input?: RequestOrHeaders, fallback?: string, generate?: GenerateRoutingConfig, headerNames?: readonly string[]): Promise<string | undefined>;

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

@@ -14,10 +14,10 @@ function extractHeader(h, name) {
 // Read lazily (and tolerantly): `@intl-config` may not be set at all in
 // standalone/unit usage of these helpers, and importing the config eagerly
 // would risk a cycle with a config module that itself imports from here.
-async function configuredHeaderNames(key) {
+async function configuredGenerate() {
     try {
         const config = (await import('../../config/intl_config')).default;
-        return config?.generate?.[key];
+        return config?.generate;
     }
     catch {
         return undefined;
@@ -38,13 +38,13 @@ function extractFromHeaderNames(h, headerNames) {
  * 1. Explicit `input` (Request, NextRequest, or Headers) if provided
  * 2. Next.js request headers via `headers()` (`headerNames`, default
  *    `x-cf-country`, `cf-ipcountry`)
- * 3. `generate.getCloudflareContext` or `cf.country` if passed
+ * 3. `generate.ctx` or `generate.getCloudflareContext` or `cf.country` if passed
  * 4. `undefined` if outside request scope or unavailable
  */
 export async function getCountry(input, generate, headerNames) {
+    const gen = generate ?? await configuredGenerate();
     const names = headerNames
-        ?? generate?.countryHeaderNames
-        ?? await configuredHeaderNames('countryHeaderNames')
+        ?? gen?.countryHeaderNames
         ?? defaultCountryHeaderNames;
     if (input) {
         if ('headers' in input && input.headers) {
@@ -72,9 +72,21 @@ export async function getCountry(input, generate, headerNames) {
     catch {
         // Outside request scope / build time
     }
-    if (generate?.getCloudflareContext) {
+    if (gen?.ctx) {
         try {
-            const ctx = await generate.getCloudflareContext({ async: true });
+            const context = typeof gen.ctx === 'function' ? await gen.ctx() : gen.ctx;
+            const cf = context?.cf;
+            if (cf?.country && typeof cf.country === 'string' && cf.country.length > 0) {
+                return cf.country;
+            }
+        }
+        catch {
+            // Ignore context resolution errors
+        }
+    }
+    if (gen?.getCloudflareContext) {
+        try {
+            const ctx = await gen.getCloudflareContext({ async: true });
             if (ctx?.cf?.country && typeof ctx.cf.country === 'string' && ctx.cf.country.length > 0) {
                 return ctx.cf.country;
             }
@@ -92,13 +104,13 @@ export async function getCountry(input, generate, headerNames) {
  * 1. Explicit `input` (Request, NextRequest, or Headers) if provided
  * 2. Next.js request headers via `headers()` (`headerNames`, default
  *    `x-cf-timezone`, `cf-timezone`)
- * 3. `generate.getCloudflareContext` or `cf.timezone` if passed
+ * 3. `generate.ctx` or `generate.getCloudflareContext` or `cf.timezone` if passed
  * 4. `fallback` (or `undefined`) if outside request scope or unavailable
  */
 export async function getTimezone(input, fallback, generate, headerNames) {
+    const gen = generate ?? await configuredGenerate();
     const names = headerNames
-        ?? generate?.timezoneHeaderNames
-        ?? await configuredHeaderNames('timezoneHeaderNames')
+        ?? gen?.timezoneHeaderNames
         ?? defaultTimezoneHeaderNames;
     if (input) {
         if ('headers' in input && input.headers) {
@@ -126,9 +138,21 @@ export async function getTimezone(input, fallback, generate, headerNames) {
     catch {
         // Outside request scope
     }
-    if (generate?.getCloudflareContext) {
+    if (gen?.ctx) {
         try {
-            const ctx = await generate.getCloudflareContext({ async: true });
+            const context = typeof gen.ctx === 'function' ? await gen.ctx() : gen.ctx;
+            const cf = context?.cf;
+            if (cf?.timezone && typeof cf.timezone === 'string' && cf.timezone.length > 0) {
+                return cf.timezone;
+            }
+        }
+        catch {
+            // Ignore context resolution errors
+        }
+    }
+    if (gen?.getCloudflareContext) {
+        try {
+            const ctx = await gen.getCloudflareContext({ async: true });
             if (ctx?.cf?.timezone && typeof ctx.cf.timezone === 'string' && ctx.cf.timezone.length > 0) {
                 return ctx.cf.timezone;
             }

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

@@ -332,6 +332,12 @@ export interface CookieConsentRoutingConfig {
      * overridable per-dialog via the `link` prop).
      */
     privacyPolicyPath?: string | false;
+    /**
+     * Whether to show the privacy policy link in the default cookie consent
+     * dialog and privacy policy update dialog. Defaults to `true`.
+     * Set `false` to hide the privacy policy link by default.
+     */
+    showPrivacyPolicy?: boolean;
     /** Cookie-consent cookie name. Defaults to `'__cookie_consent_key__'`. */
     consentCookieName?: string;
     /** Privacy-policy-date cookie name. Defaults to `'__privacy_policy_date_key__'`. */

package/dist/src/vite/cf_workers_client_stub.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "vite";
+export declare const CF_WORKERS_CLIENT_STUB_ID = "\0cfni:cloudflare-workers-client-stub";
+export declare const CF_WORKERS_CLIENT_STUB_CODE = "\nexport class WorkerEntrypoint {}\nexport class DurableObject {}\nexport const env = {};\nexport default {};\n";
+export declare function cfWorkersClientStubPlugin(): Plugin;

package/dist/src/vite/cf_workers_client_stub.js

@@ -0,0 +1,23 @@
+export const CF_WORKERS_CLIENT_STUB_ID = "\0cfni:cloudflare-workers-client-stub";
+export const CF_WORKERS_CLIENT_STUB_CODE = `
+export class WorkerEntrypoint {}
+export class DurableObject {}
+export const env = {};
+export default {};
+`;
+export function cfWorkersClientStubPlugin() {
+    return {
+        name: "cfni:cf-workers-client-stub",
+        enforce: "pre",
+        resolveId(id, _importer, options) {
+            if (id === "cloudflare:workers" && (this.environment?.name === "client" || options?.ssr === false)) {
+                return CF_WORKERS_CLIENT_STUB_ID;
+            }
+        },
+        load(id) {
+            if (id === CF_WORKERS_CLIENT_STUB_ID) {
+                return CF_WORKERS_CLIENT_STUB_CODE;
+            }
+        },
+    };
+}

package/dist/src/vite/index.d.ts

@@ -0,0 +1,5 @@
+export { buildIdAsset } from "./build_id_asset.js";
+export { userAgentStubPlugin, USER_AGENT_STUB_ID, USER_AGENT_STUB_CODE } from "./user_agent_stub.js";
+export { cfWorkersClientStubPlugin, CF_WORKERS_CLIENT_STUB_ID, CF_WORKERS_CLIENT_STUB_CODE } from "./cf_workers_client_stub.js";
+export { localeFilePlugin, resolveDefaultIntlConfigPath, type LocaleFilePluginOptions } from "./locale_file_plugin.js";
+export { cloudflareNextIntl, cloudflareNextIntlPlugin, type CloudflareNextIntlOptions, default } from "./plugin.js";

package/dist/src/vite/index.js

@@ -0,0 +1,5 @@
+export { buildIdAsset } from "./build_id_asset.js";
+export { userAgentStubPlugin, USER_AGENT_STUB_ID, USER_AGENT_STUB_CODE } from "./user_agent_stub.js";
+export { cfWorkersClientStubPlugin, CF_WORKERS_CLIENT_STUB_ID, CF_WORKERS_CLIENT_STUB_CODE } from "./cf_workers_client_stub.js";
+export { localeFilePlugin, resolveDefaultIntlConfigPath } from "./locale_file_plugin.js";
+export { cloudflareNextIntl, cloudflareNextIntlPlugin, default } from "./plugin.js";

package/dist/src/vite/locale_file_plugin.d.ts

@@ -0,0 +1,19 @@
+import type { Plugin } from "vite";
+export interface LocaleFilePluginOptions {
+    /**
+     * Directory containing translation json files (e.g. `./messages`).
+     * @default "./messages"
+     */
+    messagesDir?: string;
+    /**
+     * Path to `intl_config.ts`.
+     */
+    intlConfigPath?: string;
+    /**
+     * Root directory of the project. Defaults to `process.cwd()`.
+     */
+    root?: string;
+}
+export declare function resolveDefaultIntlConfigPath(root: string): string;
+export declare function getCfniDistSrcDir(root: string): string;
+export declare function localeFilePlugin(options?: LocaleFilePluginOptions): Plugin;

package/dist/src/vite/locale_file_plugin.js

@@ -0,0 +1,90 @@
+import path from "node:path";
+import fs from "node:fs";
+import { createRequire } from "node:module";
+export function resolveDefaultIntlConfigPath(root) {
+    const candidates = [
+        path.join(root, "src", "l18n", "intl_config.ts"),
+        path.join(root, "src", "l18n", "intl_config.js"),
+        path.join(root, "src", "intl_config.ts"),
+        path.join(root, "src", "intl_config.js"),
+        path.join(root, "intl_config.ts"),
+        path.join(root, "intl_config.js"),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return candidates[0];
+}
+export function getCfniDistSrcDir(root) {
+    try {
+        const require = createRequire(path.join(root, "package.json"));
+        const pkgEntry = require.resolve("cloudflare-next-intl");
+        const distDir = path.dirname(pkgEntry);
+        const distSrc = path.join(distDir, "src");
+        return distSrc.replace(/\\/g, "/");
+    }
+    catch {
+        const fallback = path.join(root, "node_modules", "cloudflare-next-intl", "dist", "src");
+        return fallback.replace(/\\/g, "/");
+    }
+}
+export function localeFilePlugin(options = {}) {
+    let resolvedRoot = options.root ?? process.cwd();
+    let resolvedMessagesDir = options.messagesDir
+        ? (path.isAbsolute(options.messagesDir) ? options.messagesDir : path.join(resolvedRoot, options.messagesDir))
+        : path.join(resolvedRoot, "messages");
+    let resolvedIntlConfigPath = options.intlConfigPath
+        ? (path.isAbsolute(options.intlConfigPath) ? options.intlConfigPath : path.join(resolvedRoot, options.intlConfigPath))
+        : resolveDefaultIntlConfigPath(resolvedRoot);
+    return {
+        name: "cfni:locale-file",
+        enforce: "pre",
+        configResolved(config) {
+            resolvedRoot = options.root ?? config.root ?? process.cwd();
+            if (!options.messagesDir) {
+                resolvedMessagesDir = path.join(resolvedRoot, "messages");
+            }
+            if (!options.intlConfigPath) {
+                resolvedIntlConfigPath = resolveDefaultIntlConfigPath(resolvedRoot);
+            }
+        },
+        resolveId(id) {
+            if (id.startsWith("@locale-file/")) {
+                const file = id.replace("@locale-file/", "");
+                return path.join(resolvedMessagesDir, file);
+            }
+            if (id === "@intl-config") {
+                return resolvedIntlConfigPath;
+            }
+            if (id === "cloudflare-next-intl" && this.environment?.name === "rsc") {
+                return "\0cloudflare-next-intl:rsc";
+            }
+        },
+        load(id) {
+            if (id === "\0cloudflare-next-intl:rsc") {
+                const cfniDir = getCfniDistSrcDir(resolvedRoot);
+                return `
+export * from '${cfniDir}/config/index.js';
+export * from '${cfniDir}/general/index.js';
+export * from '${cfniDir}/server/index.js';
+export * from '${cfniDir}/theme_switcher/index.js';
+export * from '${cfniDir}/types/index.js';
+export * from '${cfniDir}/client/index.js';
+`;
+            }
+        },
+        transform(code, id) {
+            if (id.includes("cloudflare-next-intl") && code.includes("@locale-file")) {
+                const globPattern = `/messages/*.json`;
+                return {
+                    code: `
+const __cfni_locales__ = import.meta.glob('${globPattern}', { eager: true });
+${code.replace(/\(await import\([`'"]@locale-file\/\$\{locale\}\.json[`'"]\)\)\.default/g, `(__cfni_locales__[\`/messages/\${locale}.json\`]?.default ?? (() => { throw new Error('missing locale'); })())`)}`,
+                    map: null,
+                };
+            }
+        },
+    };
+}

package/dist/src/vite/plugin.d.ts

@@ -0,0 +1,29 @@
+import type { Plugin } from "vite";
+import { type LocaleFilePluginOptions } from "./locale_file_plugin.js";
+export interface CloudflareNextIntlOptions extends LocaleFilePluginOptions {
+    /**
+     * Emit static `BUILD_ID` asset on client build for Vinext / Cloudflare.
+     * Set to `false` to disable or pass a custom filename string.
+     * @default true ("BUILD_ID")
+     */
+    buildIdAsset?: boolean | string;
+    /**
+     * Enable `@locale-file/*` resolution, `@intl-config` alias, RSC re-exports,
+     * and eager glob bundling for messages (`import.meta.glob('/messages/*.json', { eager: true })`).
+     * @default true
+     */
+    localeFiles?: boolean;
+    /**
+     * Stub `next/dist/server/web/spec-extension/user-agent` to avoid pulling `node:fs` into Cloudflare Workers runtime.
+     * @default true
+     */
+    userAgentStub?: boolean;
+    /**
+     * Stub `cloudflare:workers` on client / non-SSR builds to prevent client bundling errors.
+     * @default true
+     */
+    cfWorkersClientStub?: boolean;
+}
+export declare function cloudflareNextIntl(options?: CloudflareNextIntlOptions): Plugin[];
+export declare const cloudflareNextIntlPlugin: typeof cloudflareNextIntl;
+export default cloudflareNextIntl;

package/dist/src/vite/plugin.js

@@ -0,0 +1,27 @@
+import { buildIdAsset } from "./build_id_asset.js";
+import { userAgentStubPlugin } from "./user_agent_stub.js";
+import { cfWorkersClientStubPlugin } from "./cf_workers_client_stub.js";
+import { localeFilePlugin } from "./locale_file_plugin.js";
+export function cloudflareNextIntl(options = {}) {
+    const plugins = [];
+    if (options.buildIdAsset !== false) {
+        const fileName = typeof options.buildIdAsset === "string" ? options.buildIdAsset : "BUILD_ID";
+        plugins.push(buildIdAsset(fileName));
+    }
+    if (options.cfWorkersClientStub !== false) {
+        plugins.push(cfWorkersClientStubPlugin());
+    }
+    if (options.userAgentStub !== false) {
+        plugins.push(userAgentStubPlugin());
+    }
+    if (options.localeFiles !== false) {
+        plugins.push(localeFilePlugin({
+            messagesDir: options.messagesDir,
+            intlConfigPath: options.intlConfigPath,
+            root: options.root,
+        }));
+    }
+    return plugins;
+}
+export const cloudflareNextIntlPlugin = cloudflareNextIntl;
+export default cloudflareNextIntl;

package/dist/src/vite/user_agent_stub.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "vite";
+export declare const USER_AGENT_STUB_ID = "\0cfni:user-agent-stub";
+export declare const USER_AGENT_STUB_CODE = "\nexport function isBot(input) {\n    if (!input) return false;\n    return /Googlebot|Mediapartners-Google|AdsBot-Google|googleweblight|Storebot-Google|Google-PageRenderer|Google-InspectionTool|Bingbot|BingPreview|Slurp|DuckDuckBot|baiduspider|yandex|sogou|LinkedInBot|bitlybot|tumblr|vkShare|quora link preview|facebookexternalhit|facebookcatalog|Twitterbot|applebot|redditbot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|ia_archiver|GPTBot/i.test(\n        input\n    );\n}\n\nexport function userAgentFromString(input) {\n    return {\n        ua: input ?? \"\",\n        browser: { name: undefined, version: undefined, major: undefined },\n        cpu: { architecture: undefined },\n        device: { model: undefined, type: undefined, vendor: undefined },\n        engine: { name: undefined, version: undefined },\n        os: { name: undefined, version: undefined },\n        isBot: input === undefined ? false : isBot(input),\n    };\n}\n\nexport function userAgent(context) {\n    const headers = context?.headers;\n    const ua = headers?.get ? headers.get(\"user-agent\") : undefined;\n    return userAgentFromString(ua ?? undefined);\n}\n\nexport default {\n    isBot,\n    userAgent,\n    userAgentFromString,\n};\n";
+export declare function userAgentStubPlugin(): Plugin;

package/dist/src/vite/user_agent_stub.js

@@ -0,0 +1,49 @@
+export const USER_AGENT_STUB_ID = "\0cfni:user-agent-stub";
+export const USER_AGENT_STUB_CODE = `
+export function isBot(input) {
+    if (!input) return false;
+    return /Googlebot|Mediapartners-Google|AdsBot-Google|googleweblight|Storebot-Google|Google-PageRenderer|Google-InspectionTool|Bingbot|BingPreview|Slurp|DuckDuckBot|baiduspider|yandex|sogou|LinkedInBot|bitlybot|tumblr|vkShare|quora link preview|facebookexternalhit|facebookcatalog|Twitterbot|applebot|redditbot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|ia_archiver|GPTBot/i.test(
+        input
+    );
+}
+
+export function userAgentFromString(input) {
+    return {
+        ua: input ?? "",
+        browser: { name: undefined, version: undefined, major: undefined },
+        cpu: { architecture: undefined },
+        device: { model: undefined, type: undefined, vendor: undefined },
+        engine: { name: undefined, version: undefined },
+        os: { name: undefined, version: undefined },
+        isBot: input === undefined ? false : isBot(input),
+    };
+}
+
+export function userAgent(context) {
+    const headers = context?.headers;
+    const ua = headers?.get ? headers.get("user-agent") : undefined;
+    return userAgentFromString(ua ?? undefined);
+}
+
+export default {
+    isBot,
+    userAgent,
+    userAgentFromString,
+};
+`;
+export function userAgentStubPlugin() {
+    return {
+        name: "cfni:user-agent-stub",
+        enforce: "pre",
+        resolveId(id) {
+            if (id === "next/dist/server/web/spec-extension/user-agent" || id.endsWith("/spec-extension/user-agent")) {
+                return USER_AGENT_STUB_ID;
+            }
+        },
+        load(id) {
+            if (id === USER_AGENT_STUB_ID) {
+                return USER_AGENT_STUB_CODE;
+            }
+        },
+    };
+}

package/llms.txt

@@ -27,7 +27,7 @@ other subpath can be used.
 - `./db` — `withPublicDb(fn)` / `withUserDb(fn, uid?)` server-side Postgres/Drizzle context helpers (require `db` set on your `RoutingConfig`; direct Postgres or Supabase Data API with automatic PostgREST REST translation and `cfni_exec` fallback, see below).
 - `./dbEslint` — flat-config ESLint fragment banning direct `@supabase/supabase-js`, `pg`, `postgres`, and deep `dist/` imports in application code.
 - `./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.
+- `./vite` — `cloudflareNextIntl(options?)` / `cloudflareNextIntlPlugin`, `buildIdAsset(fileName?)`, `localeFilePlugin(options?)`, `userAgentStubPlugin()`, `cfWorkersClientStubPlugin()`: All-in-one Vite plugin required for Vinext/Cloudflare Workers environments (bundles `@locale-file/*` via eager glob, resolves `@intl-config`, stubs Node.js `user-agent` to prevent runtime `node:fs` errors, stubs `cloudflare:workers` for client builds, and emits client `BUILD_ID`).
 - `./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 / 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudflare-next-intl",
-  "version": "0.8.52",
+  "version": "0.8.53",
   "description": "Optimized Next Intl Package Special for App Router and Cloudflare",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -219,8 +219,8 @@
       "import": "./dist/src/db/schema.js"
     },
     "./vite": {
-      "types": "./dist/src/vite/build_id_asset.d.ts",
-      "import": "./dist/src/vite/build_id_asset.js"
+      "types": "./dist/src/vite/index.d.ts",
+      "import": "./dist/src/vite/index.js"
     }
   },
   "scripts": {