cloudflare-next-intl 0.4.2 → 0.4.4

package/README.md

@@ -200,6 +200,8 @@ export default setIntlConfig({
     defaultLocale: "en",
     cookieConsent: {
         privacyPolicyDate: "2026-01-01",
+        // privacyPolicyPath: "/privacy-policy", // default; used by the
+        // dialogs' auto-rendered link. Set false to disable that link.
         // Optional: gate the banner to GDPR-region visitors only. Omit both
         // getters to disable country-based gating (consent always implicit).
         // Pass @opennextjs/cloudflare's getCloudflareContext directly — its

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

@@ -2,8 +2,15 @@ import type { CookieDialogClassNames, CookieDialogStyles } from '../../types';
 export interface CookieConsentDialogProps {
     /** Banner message text. */
     message?: React.ReactNode;
-    /** Optional link element rendered right after `message` (e.g. a privacy-policy link). */
+    /**
+     * Link element rendered right after `message`. Defaults to a link to
+     * `cookieConsent.privacyPolicyPath` (`'/privacy-policy'` unless
+     * configured otherwise) with `privacyPolicyLinkText` as its label. Pass
+     * `null` to render no link, or your own element to override it.
+     */
     link?: React.ReactNode;
+    /** Label for the default privacy-policy link. Ignored when `link` is set. */
+    privacyPolicyLinkText?: string;
     acceptText?: string;
     declineText?: string;
     /** Hides the decline ("necessary only") button, leaving only accept. */
@@ -25,4 +32,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, acceptText, declineText, hideDecline, id, classNames, styles, render, }: CookieConsentDialogProps): React.ReactElement | null;
+export default function CookieConsentDialog({ message, link, privacyPolicyLinkText, acceptText, declineText, hideDecline, id, classNames, styles, render, }: CookieConsentDialogProps): React.ReactElement | null;

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

@@ -1,17 +1,21 @@
 'use client';
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import useCookieConsent from '../use_cookie_consent';
+import DefaultPrivacyPolicyLink from './default_privacy_policy_link';
 /**
  * Cookie-consent banner. Renders `null` once `consent` is already decided.
  * Every visual aspect is overridable via `classNames`/`styles` (per-slot) or
  * `render` (full custom markup) — none of it is hardcoded to Tailwind or any
  * particular design system.
  */
-export default function CookieConsentDialog({ message = 'We use cookies to improve your experience.', link, acceptText = 'Accept', declineText = 'Necessary only', hideDecline = false, id = 'cookie-consent-dialog', classNames, styles, render, }) {
-    const { consent, setConsent } = useCookieConsent();
+export default function CookieConsentDialog({ message = 'We use cookies to improve your experience.', link, privacyPolicyLinkText = 'Privacy Policy', acceptText = 'Accept', declineText = 'Necessary only', hideDecline = false, id = 'cookie-consent-dialog', classNames, styles, render, }) {
+    const { consent, setConsent, privacyPolicyPath } = useCookieConsent();
     if (consent !== null)
         return null;
     if (render)
         return _jsx(_Fragment, { children: render({ setConsent }) });
-    return (_jsxs("div", { id: id, role: "dialog", "aria-modal": "false", "aria-labelledby": `${id}-title`, className: classNames?.root, style: styles?.root, children: [_jsxs("p", { id: `${id}-title`, className: classNames?.message, style: styles?.message, children: [message, link ? _jsxs("span", { className: classNames?.link, style: styles?.link, children: [" ", link] }) : null] }), _jsxs("div", { className: classNames?.actions, style: styles?.actions, children: [!hideDecline && (_jsx("button", { type: "button", onClick: () => setConsent(false), className: classNames?.declineButton, style: styles?.declineButton, children: declineText })), _jsx("button", { type: "button", onClick: () => setConsent(true), className: classNames?.acceptButton, style: styles?.acceptButton, children: acceptText })] })] }));
+    const resolvedLink = link !== undefined
+        ? link
+        : _jsx(DefaultPrivacyPolicyLink, { privacyPolicyPath: privacyPolicyPath, text: privacyPolicyLinkText });
+    return (_jsxs("div", { id: id, role: "dialog", "aria-modal": "false", "aria-labelledby": `${id}-title`, className: classNames?.root, style: styles?.root, children: [_jsxs("p", { id: `${id}-title`, className: classNames?.message, style: styles?.message, children: [message, resolvedLink ? _jsxs("span", { className: classNames?.link, style: styles?.link, children: [" ", resolvedLink] }) : null] }), _jsxs("div", { className: classNames?.actions, style: styles?.actions, children: [!hideDecline && (_jsx("button", { type: "button", onClick: () => setConsent(false), className: classNames?.declineButton, style: styles?.declineButton, children: declineText })), _jsx("button", { type: "button", onClick: () => setConsent(true), className: classNames?.acceptButton, style: styles?.acceptButton, children: acceptText })] })] }));
 }

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

@@ -0,0 +1,14 @@
+/**
+ * Renders the default privacy-policy link used by `CookieConsentDialog`/
+ * `PrivacyPolicyUpdateDialog` when their `link` prop is omitted. Returns
+ * `null` when `privacyPolicyPath` is `false` (disabled via
+ * `cookieConsent.privacyPolicyPath`). Locale-prefixes `privacyPolicyPath`
+ * the same way the server `Link` component does — reads the locale set by
+ * `LocationzationClientProvider` on the current render.
+ */
+export default function DefaultPrivacyPolicyLink({ privacyPolicyPath, text, className, style }: {
+    privacyPolicyPath: string | false;
+    text: string;
+    className?: string;
+    style?: React.CSSProperties;
+}): React.ReactElement | null;

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

@@ -0,0 +1,21 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import NextLink from 'next/link';
+import config from '../../../config/intl_config';
+import { getLocaleCache } from '../../../general/cache_variables';
+/**
+ * Renders the default privacy-policy link used by `CookieConsentDialog`/
+ * `PrivacyPolicyUpdateDialog` when their `link` prop is omitted. Returns
+ * `null` when `privacyPolicyPath` is `false` (disabled via
+ * `cookieConsent.privacyPolicyPath`). Locale-prefixes `privacyPolicyPath`
+ * the same way the server `Link` component does — reads the locale set by
+ * `LocationzationClientProvider` on the current render.
+ */
+export default function DefaultPrivacyPolicyLink({ privacyPolicyPath, text, className, style }) {
+    if (privacyPolicyPath === false)
+        return null;
+    const localeValue = getLocaleCache();
+    const needsLangPath = localeValue !== config.defaultLocale || !localeValue;
+    const href = needsLangPath ? `/${localeValue}${privacyPolicyPath}` : privacyPolicyPath;
+    return (_jsx(NextLink, { href: href, className: className, style: style, children: text }));
+}

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

@@ -1,8 +1,15 @@
 import type { CookieDialogClassNames, CookieDialogStyles } from '../../types';
 export interface PrivacyPolicyUpdateDialogProps {
     message?: React.ReactNode;
-    /** Optional link element rendered right after `message` (e.g. to your privacy-policy page). */
+    /**
+     * Link element rendered right after `message`. Defaults to a link to
+     * `cookieConsent.privacyPolicyPath` (`'/privacy-policy'` unless
+     * configured otherwise) with `privacyPolicyLinkText` as its label. Pass
+     * `null` to render no link, or your own element to override it.
+     */
     link?: React.ReactNode;
+    /** Label for the default privacy-policy link. Ignored when `link` is set. */
+    privacyPolicyLinkText?: string;
     closeText?: string;
     id?: string;
     classNames?: CookieDialogClassNames;
@@ -21,4 +28,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, closeText, id, classNames, styles, render, }: PrivacyPolicyUpdateDialogProps): React.ReactElement | null;
+export default function PrivacyPolicyUpdateDialog({ message, link, privacyPolicyLinkText, closeText, id, classNames, styles, render, }: PrivacyPolicyUpdateDialogProps): React.ReactElement | null;

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

@@ -1,17 +1,21 @@
 'use client';
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import useCookieConsent from '../use_cookie_consent';
+import DefaultPrivacyPolicyLink from './default_privacy_policy_link';
 /**
  * "Privacy policy updated" banner. Auto-enabled only when
  * `cookieConsent.privacyPolicyDate` is set on the `RoutingConfig` — renders
  * `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 = 'Our privacy policy has been updated.', link, closeText = 'Got it', id = 'privacy-policy-update-dialog', classNames, styles, render, }) {
-    const { privacyPolicyUpdated, acknowledgePrivacyPolicyUpdate } = useCookieConsent();
+export default function PrivacyPolicyUpdateDialog({ message = 'Our privacy policy has been updated.', link, privacyPolicyLinkText = 'Learn more', closeText = 'Got it', id = 'privacy-policy-update-dialog', classNames, styles, render, }) {
+    const { privacyPolicyUpdated, acknowledgePrivacyPolicyUpdate, privacyPolicyPath } = useCookieConsent();
     if (!privacyPolicyUpdated)
         return null;
     if (render)
         return _jsx(_Fragment, { children: render({ acknowledge: acknowledgePrivacyPolicyUpdate }) });
-    return (_jsxs("div", { id: id, role: "dialog", "aria-modal": "false", "aria-labelledby": `${id}-title`, className: classNames?.root, style: styles?.root, children: [_jsxs("p", { id: `${id}-title`, className: classNames?.message, style: styles?.message, children: [message, link ? _jsxs("span", { className: classNames?.link, style: styles?.link, children: [" ", link] }) : null] }), _jsx("button", { type: "button", onClick: acknowledgePrivacyPolicyUpdate, "aria-label": closeText, className: classNames?.closeButton, style: styles?.closeButton, children: closeText })] }));
+    const resolvedLink = link !== undefined
+        ? link
+        : _jsx(DefaultPrivacyPolicyLink, { privacyPolicyPath: privacyPolicyPath, text: privacyPolicyLinkText });
+    return (_jsxs("div", { id: id, role: "dialog", "aria-modal": "false", "aria-labelledby": `${id}-title`, className: classNames?.root, style: styles?.root, children: [_jsxs("p", { id: `${id}-title`, className: classNames?.message, style: styles?.message, children: [message, resolvedLink ? _jsxs("span", { className: classNames?.link, style: styles?.link, children: [" ", resolvedLink] }) : null] }), _jsx("button", { type: "button", onClick: acknowledgePrivacyPolicyUpdate, "aria-label": closeText, className: classNames?.closeButton, style: styles?.closeButton, children: closeText })] }));
 }

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

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

package/dist/src/cookie_consent/gdpr_countries.js

@@ -46,7 +46,7 @@ export default async function resolveRequiresConsent(getCountryCode, getCloudfla
     const countryCode = getCountryCode
         ? await getCountryCode()
         : (await getCloudflareContext({ async: true }))?.cf?.country;
-    if (!countryCode)
+    if (typeof countryCode !== 'string' || !countryCode)
         return true;
     return getGdprCountriesSet(gdprCountries).has(countryCode);
 }

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

@@ -14,6 +14,13 @@ export interface CookieConsentContextType {
     setConsent: (value: boolean) => void;
     /** Acknowledges the privacy-policy update banner and persists the new date. */
     acknowledgePrivacyPolicyUpdate: () => void;
+    /**
+     * Resolved from `cookieConsent.privacyPolicyPath` (defaults to
+     * `'/privacy-policy'`; `false` disables it). Used by the default
+     * dialog components to render a privacy-policy link automatically
+     * when their `link` prop is omitted.
+     */
+    privacyPolicyPath: string | false;
 }
 /** Slot-level style/class overrides accepted by the default dialog components. */
 export interface CookieDialogClassNames {

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

@@ -98,6 +98,14 @@ export interface CookieConsentRoutingConfig {
      * cookie-consent banner still works independently).
      */
     privacyPolicyDate?: string | Date;
+    /**
+     * Path to your privacy-policy page, e.g. `"/privacy-policy"`. Used by
+     * `CookieConsentDialog`/`PrivacyPolicyUpdateDialog` to render a default
+     * link automatically when their `link` prop is omitted. Defaults to
+     * `'/privacy-policy'`. Set `false` to render no link by default (still
+     * overridable per-dialog via the `link` prop).
+     */
+    privacyPolicyPath?: string | false;
     /** Cookie-consent cookie name. Defaults to `'__cookie_consent_key__'`. */
     consentCookieName?: string;
     /** Privacy-policy-date cookie name. Defaults to `'__privacy_policy_date_key__'`. */
@@ -175,14 +183,15 @@ export interface CookieConsentRoutingConfig {
 }
 /**
  * Minimal shape read from your `getCloudflareContext()` return value — only
- * `cf.country` is consulted, so any superset (the real `CloudflareContext`
- * from `@opennextjs/cloudflare`) is accepted as-is without a hard
+ * `cf.country` is consulted (read defensively at the call site, since `cf`'s
+ * real type — `@opennextjs/cloudflare`'s `CfProperties`, a union of the
+ * incoming-request and request-init variants — only has `country` on one
+ * branch). `cf` is typed loosely here so the real (generic) function is
+ * assignable to `CookieConsentGetCloudflareContext` without a hard
  * dependency on that package.
  */
 export interface CookieConsentCloudflareContext {
-    cf?: {
-        country?: string;
-    };
+    cf?: Record<string, unknown>;
 }
 /**
  * Matches `@opennextjs/cloudflare`'s `getCloudflareContext` overloaded

package/llms.txt

@@ -39,8 +39,8 @@ other subpath can be used.
 - `./cookieConsent` — barrel: `CookieConsentProvider`, `useCookieConsent`, `CookieConsentDialog`, `PrivacyPolicyUpdateDialog`, `CookieConsentAnalytics`.
 - `./CookieConsentProvider` — context provider; reads/writes consent + privacy-policy-date cookies. Auto-wired by `IntlProvider` when `cookieConsent` is configured — manual nesting is optional.
 - `./useCookieConsent` — context hook; throws `"useCookieConsent must be used within a CookieConsentProvider"` if called outside one.
-- `./CookieConsentDialog` — default cookie-consent banner; accepts per-slot `classNames`/`styles` or a `render` prop for fully custom markup.
-- `./PrivacyPolicyUpdateDialog` — "privacy policy updated" banner; auto-enabled only when `cookieConsent.privacyPolicyDate` is set.
+- `./CookieConsentDialog` — default cookie-consent banner; accepts per-slot `classNames`/`styles` or a `render` prop for fully custom markup. When `link` is omitted, renders a default link to `cookieConsent.privacyPolicyPath` (defaults to `'/privacy-policy'`; label via `privacyPolicyLinkText`, default `"Privacy Policy"`) — pass `link={null}` for no link, or set `privacyPolicyPath: false` to disable it everywhere.
+- `./PrivacyPolicyUpdateDialog` — "privacy policy updated" banner; auto-enabled only when `cookieConsent.privacyPolicyDate` is set. Same default-link behavior as `CookieConsentDialog` (label default `"Learn more"`).
 - `./cookieConsentAnalytics` — `CookieConsentAnalytics`: gates Cloudflare Web Analytics / Google Ads / Google Analytics / AdSense / Microsoft Clarity behind consent; rendered automatically by `IntlProvider` when `cookieConsent.secrets` or `getSecrets` is set (and `autoWireAnalytics !== false`). Never renders in local dev (`NODE_ENV === 'development'`) unless `cookieConsent.enableAnalyticsInDevMode` is `true`.
 - Country-based gating (`cookieConsent.getCountryCode` / `getCloudflareContext` + `gdprCountries`): resolved server-side by `IntlProvider` into a `requiresConsent` boolean passed to `CookieConsentProvider`. Neither getter set → gating off, consent always implicitly granted. `getCountryCode` (direct country resolver) takes precedence over `getCloudflareContext` (reads `cf.country`) when both are set. `getCloudflareContext` accepts `@opennextjs/cloudflare`'s `getCloudflareContext` function directly (its exact overloaded signature — `CookieConsentGetCloudflareContext`), called internally with `{ async: true }`. Unresolved country (or a `null` context) always requires consent (fail-safe). `./cookieConsent` also exports `defaultGdprCountries` (EU/EEA + UK + Switzerland).
 

package/package.json

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