cloudflare-next-intl 0.4.1 → 0.4.4

package/README.md

@@ -193,14 +193,21 @@ auto-wires `CookieConsentProvider` (and `CookieConsentAnalytics`, if
 
 ```typescript
 // intl-config.ts
+import { getCloudflareContext } from "@opennextjs/cloudflare";
+
 export default setIntlConfig({
     locales: ["en", "de"],
     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).
-        getCloudflareContext: () => getCloudflareContext(),
+        // Pass @opennextjs/cloudflare's getCloudflareContext directly — its
+        // exact overloaded signature is accepted as-is, called internally
+        // with { async: true }.
+        getCloudflareContext,
         // gdprCountries: [...], // defaults to EU/EEA + UK + Switzerland
         // enableAnalyticsInDevMode: true, // analytics stay off in dev otherwise
     },

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.bench.js

@@ -1,5 +1,9 @@
 import { bench, describe } from 'vitest';
 import resolveRequiresConsent, { defaultGdprCountries } from './gdpr_countries';
+const fakeGetCloudflareContext = ((options) => {
+    const context = { cf: { country: 'DE' } };
+    return options?.async === false ? context : Promise.resolve(context);
+});
 const customList = ['US', 'CA', 'MX'];
 describe('resolveRequiresConsent: default GDPR list lookup', () => {
     bench('country inside the list (worst case for Array.includes: near the end)', async () => {
@@ -21,7 +25,7 @@ describe('resolveRequiresConsent: gating disabled', () => {
 });
 describe('resolveRequiresConsent: getCloudflareContext path', () => {
     bench('resolves cf.country from an async context getter', async () => {
-        await resolveRequiresConsent(undefined, async () => ({ cf: { country: 'DE' } }), undefined);
+        await resolveRequiresConsent(undefined, fakeGetCloudflareContext, undefined);
     });
 });
 // Sanity check the list itself isn't accidentally growing unbounded — a

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

@@ -1,4 +1,4 @@
-import type { CookieConsentCloudflareContext } from '../types/types';
+import type { CookieConsentGetCloudflareContext } from '../types/types';
 /**
  * Default `cookieConsent.gdprCountries` — EU/EEA member states (GDPR),
  * Iceland/Liechtenstein/Norway (EEA), the UK (UK-GDPR), and Switzerland
@@ -15,4 +15,4 @@ export declare const defaultGdprCountries: readonly string[];
  *   `gdprCountries` skips the banner. `getCountryCode` takes precedence
  *   over `getCloudflareContext` when both are set.
  */
-export default function resolveRequiresConsent(getCountryCode: (() => string | undefined | Promise<string | undefined>) | undefined, getCloudflareContext: (() => CookieConsentCloudflareContext | Promise<CookieConsentCloudflareContext>) | undefined, gdprCountries: readonly string[] | undefined): Promise<boolean>;
+export default function resolveRequiresConsent(getCountryCode: (() => string | undefined | Promise<string | undefined>) | undefined, getCloudflareContext: CookieConsentGetCloudflareContext | undefined, gdprCountries: readonly string[] | undefined): Promise<boolean>;

package/dist/src/cookie_consent/gdpr_countries.js

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

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

@@ -5,4 +5,4 @@ export { default as PrivacyPolicyUpdateDialog } from './client/components/privac
 export { default as CookieConsentAnalytics } from './client/components/cookie_consent_analytics';
 export { defaultGdprCountries } from './gdpr_countries';
 export type { CookieConsentContextType, ConsentValue, CookieDialogClassNames, CookieDialogStyles } from './types';
-export type { CookieConsentRoutingConfig, CookieConsentAnalyticsSecrets } from '../types/types';
+export type { CookieConsentRoutingConfig, CookieConsentAnalyticsSecrets, CookieConsentCloudflareContext, CookieConsentGetCloudflareContext, } from '../types/types';

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/index.d.ts

@@ -1 +1 @@
-export type { CookieAttributes, LocalePrefixMode, Locales, ReturnType, RoutingConfig, TranslationEntry, TranslationObject, TranslatorReturnType, Alternates, changeFrequency, IntlSitemap, CookieConsentRoutingConfig, CookieConsentAnalyticsSecrets, CookieConsentCloudflareContext, } from './types';
+export type { CookieAttributes, LocalePrefixMode, Locales, ReturnType, RoutingConfig, TranslationEntry, TranslationObject, TranslatorReturnType, Alternates, changeFrequency, IntlSitemap, CookieConsentRoutingConfig, CookieConsentAnalyticsSecrets, CookieConsentCloudflareContext, CookieConsentGetCloudflareContext, } from './types';

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__'`. */
@@ -136,11 +144,12 @@ export interface CookieConsentRoutingConfig {
      */
     getCountryCode?: () => string | undefined | Promise<string | undefined>;
     /**
-     * Returns the Cloudflare request context — e.g. your own
-     * `getCloudflareContext()` call from `@opennextjs/cloudflare` (not a
-     * dependency of this package, so bring your own). Only `cf.country`
-     * is read from the resolved context. Ignored when `getCountryCode` is
-     * also set.
+     * Pass `getCloudflareContext` from `@opennextjs/cloudflare` directly
+     * (not a dependency of this package, so bring your own import) — its
+     * exact overloaded signature is accepted as-is; called internally with
+     * `{ async: true }`, so you never need to wrap it yourself. Only
+     * `cf.country` is read from the resolved context. Ignored when
+     * `getCountryCode` is also set.
      *
      * Country-based gating (via either `getCountryCode` or
      * `getCloudflareContext`) decides whether the cookie-consent banner is
@@ -151,7 +160,7 @@ export interface CookieConsentRoutingConfig {
      * is the simplest opt-in-by-default setup; set one of the two getters
      * once you need real GDPR-region gating.
      */
-    getCloudflareContext?: () => CookieConsentCloudflareContext | Promise<CookieConsentCloudflareContext>;
+    getCloudflareContext?: CookieConsentGetCloudflareContext;
     /**
      * Country codes (ISO 3166-1 alpha-2) for which the cookie-consent banner
      * is required. Only consulted when `getCountryCode` or
@@ -174,14 +183,32 @@ 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
+ * signature exactly, so that function can be passed as
+ * `cookieConsent.getCloudflareContext` directly — this package always
+ * calls it with `{ async: true }` internally (the first overload), which is
+ * why that overload's return type drives `resolveRequiresConsent`'s
+ * awaited result; the sync overload is accepted structurally only so the
+ * real function's type (which has both) is assignable as-is.
+ */
+export interface CookieConsentGetCloudflareContext {
+    (options: {
+        async: true;
+    }): Promise<CookieConsentCloudflareContext | null>;
+    (options?: {
+        async: false;
+    }): CookieConsentCloudflareContext | null;
 }
 export interface CookieConsentAnalyticsSecrets {
     /** Cloudflare Web Analytics beacon token, e.g. `'{"token": "..."}'` (the raw `data-cf-beacon` attribute value). */

package/llms.txt

@@ -39,10 +39,10 @@ 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. Unresolved country always requires consent (fail-safe). `./cookieConsent` also exports `defaultGdprCountries` (EU/EEA + UK + Switzerland).
+- 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).
 
 ## Conventions
 

package/package.json

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