@scalemule/news-publication 0.0.11 → 0.0.13

package/dist/index.cjs

@@ -788,6 +788,8 @@ var COOKIE_CONSENT_KEY = "sm_cookie_consent_v1";
 var COOKIE_CONSENT_BACKUP_KEY = "napsite_cookie_consent_v1";
 var COOKIE_CONSENT_EVENT = "scalemule-cookie-consent-change";
 var COOKIE_CONSENT_MAX_AGE_SECONDS = 365 * 24 * 60 * 60;
+var DEFAULT_CONSENT_HUB_URL = "https://bayareachronicle.com/consent-bridge.html";
+var NETWORK_CONSENT_STORAGE_KEY = "sm_network_consent_status";
 var DEFAULT_PREFERENCES_REJECTED = {
   essential: true,
   performance: false,
@@ -942,6 +944,248 @@ function getCookieConsent() {
   }
   return memoryConsent;
 }
+var EU_EEA_UK_COUNTRIES = /* @__PURE__ */ new Set([
+  "AT",
+  "BE",
+  "BG",
+  "HR",
+  "CY",
+  "CZ",
+  "DK",
+  "EE",
+  "FI",
+  "FR",
+  "DE",
+  "GR",
+  "HU",
+  "IE",
+  "IT",
+  "LV",
+  "LT",
+  "LU",
+  "MT",
+  "NL",
+  "PL",
+  "PT",
+  "RO",
+  "SK",
+  "SI",
+  "ES",
+  "SE",
+  "IS",
+  "LI",
+  "NO",
+  "GB",
+  "CH"
+]);
+function isGeoConsentRequired(countryCode) {
+  if (countryCode && typeof countryCode === "string") {
+    const code = countryCode.trim().toUpperCase();
+    if (code.length === 2) {
+      return EU_EEA_UK_COUNTRIES.has(code);
+    }
+  }
+  if (typeof window !== "undefined") {
+    try {
+      const cached = readCookie("sm_geo_country") || window.localStorage?.getItem("sm_geo_country");
+      if (cached && typeof cached === "string" && cached.length === 2) {
+        return EU_EEA_UK_COUNTRIES.has(cached.toUpperCase());
+      }
+      const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+      if (tz) {
+        if (/^(America|US|Canada|Pacific)\//i.test(tz)) {
+          return false;
+        }
+        if (/^(Europe|Atlantic\/Reykjavik|Atlantic\/Canary|Atlantic\/Faeroe|Atlantic\/Madeira|Atlantic\/Azores|WET|CET|EET|GMT)/i.test(tz)) {
+          return true;
+        }
+      }
+    } catch {
+    }
+  }
+  return false;
+}
+function checkUrlConsentBridge() {
+  if (typeof window === "undefined") return false;
+  try {
+    const url = new URL(window.location.href);
+    const param = url.searchParams.get("sm_consent");
+    if (!param) return false;
+    if (param === "accepted" || param === "1" || param === "all") {
+      acceptAllCookies();
+    } else if (param === "rejected" || param === "0" || param === "essential") {
+      rejectOptionalCookies();
+    } else {
+      return false;
+    }
+    url.searchParams.delete("sm_consent");
+    const newSearch = url.searchParams.toString() ? `?${url.searchParams.toString()}` : "";
+    window.history.replaceState(null, "", `${url.pathname}${newSearch}${url.hash}`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function decorateNetworkUrl(targetUrl) {
+  const consent = getCookieConsent();
+  if (!consent) return targetUrl;
+  try {
+    const base = typeof window !== "undefined" ? window.location.origin : "https://localhost";
+    const url = new URL(targetUrl, base);
+    const value = consent.preferences.performance || consent.preferences.advertising ? "1" : "0";
+    url.searchParams.set("sm_consent", value);
+    return url.toString();
+  } catch {
+    return targetUrl;
+  }
+}
+function queryNetworkConsentHub(hubUrl = DEFAULT_CONSENT_HUB_URL, timeoutMs = 1e3) {
+  if (typeof window === "undefined") return Promise.resolve(null);
+  try {
+    const hubOrigin = new URL(hubUrl).origin;
+    if (window.location.origin === hubOrigin) {
+      try {
+        const direct = window.localStorage?.getItem(NETWORK_CONSENT_STORAGE_KEY);
+        if (direct === "accepted" || direct === "rejected") {
+          return Promise.resolve(direct);
+        }
+      } catch {
+      }
+      return Promise.resolve(null);
+    }
+    return new Promise((resolve) => {
+      let settled = false;
+      let iframe = null;
+      let timer = null;
+      const finish = (result) => {
+        if (settled) return;
+        settled = true;
+        if (timer !== null) window.clearTimeout(timer);
+        window.removeEventListener("message", onMessage);
+        if (iframe && iframe.parentNode) {
+          try {
+            iframe.parentNode.removeChild(iframe);
+          } catch {
+          }
+        }
+        resolve(result);
+      };
+      const sendGet = () => {
+        try {
+          iframe?.contentWindow?.postMessage({ type: "SM_CONSENT_GET" }, hubOrigin);
+        } catch {
+        }
+      };
+      const onMessage = (event) => {
+        if (event.origin !== hubOrigin) return;
+        const data = event.data;
+        if (!data || typeof data !== "object") return;
+        if (data.type === "SM_CONSENT_STATUS") {
+          const status = data.status === "accepted" || data.status === "rejected" ? data.status : null;
+          finish(status);
+        } else if (data.type === "SM_CONSENT_BRIDGE_READY") {
+          sendGet();
+        }
+      };
+      window.addEventListener("message", onMessage);
+      timer = window.setTimeout(() => {
+        finish(null);
+      }, timeoutMs);
+      try {
+        iframe = document.createElement("iframe");
+        iframe.src = hubUrl;
+        iframe.style.position = "absolute";
+        iframe.style.width = "0";
+        iframe.style.height = "0";
+        iframe.style.border = "0";
+        iframe.style.display = "none";
+        iframe.style.visibility = "hidden";
+        iframe.setAttribute("aria-hidden", "true");
+        iframe.setAttribute("tabindex", "-1");
+        iframe.onload = () => {
+          sendGet();
+        };
+        iframe.onerror = () => {
+          finish(null);
+        };
+        const target = document.body || document.documentElement;
+        target.appendChild(iframe);
+      } catch {
+        finish(null);
+      }
+    });
+  } catch {
+    return Promise.resolve(null);
+  }
+}
+function setNetworkConsentHub(status, hubUrl = DEFAULT_CONSENT_HUB_URL) {
+  if (typeof window === "undefined") return;
+  try {
+    const hubOrigin = new URL(hubUrl).origin;
+    if (window.location.origin === hubOrigin) {
+      try {
+        if (status) {
+          window.localStorage?.setItem(NETWORK_CONSENT_STORAGE_KEY, status);
+        } else {
+          window.localStorage?.removeItem(NETWORK_CONSENT_STORAGE_KEY);
+        }
+      } catch {
+      }
+      return;
+    }
+    let iframe = null;
+    let timer = null;
+    const cleanup = () => {
+      if (timer !== null) window.clearTimeout(timer);
+      window.removeEventListener("message", onMessage);
+      if (iframe && iframe.parentNode) {
+        try {
+          iframe.parentNode.removeChild(iframe);
+        } catch {
+        }
+      }
+    };
+    const sendSet = () => {
+      try {
+        iframe?.contentWindow?.postMessage({ type: "SM_CONSENT_SET", status }, hubOrigin);
+      } catch {
+      }
+    };
+    const onMessage = (event) => {
+      if (event.origin !== hubOrigin) return;
+      const data = event.data;
+      if (!data || typeof data !== "object") return;
+      if (data.type === "SM_CONSENT_SAVED") {
+        cleanup();
+      } else if (data.type === "SM_CONSENT_BRIDGE_READY") {
+        sendSet();
+      }
+    };
+    window.addEventListener("message", onMessage);
+    timer = window.setTimeout(cleanup, 2500);
+    try {
+      iframe = document.createElement("iframe");
+      iframe.src = hubUrl;
+      iframe.style.position = "absolute";
+      iframe.style.width = "0";
+      iframe.style.height = "0";
+      iframe.style.border = "0";
+      iframe.style.display = "none";
+      iframe.style.visibility = "hidden";
+      iframe.setAttribute("aria-hidden", "true");
+      iframe.setAttribute("tabindex", "-1");
+      iframe.onload = () => {
+        sendSet();
+      };
+      iframe.onerror = cleanup;
+      const target = document.body || document.documentElement;
+      target.appendChild(iframe);
+    } catch {
+      cleanup();
+    }
+  } catch {
+  }
+}
 function hasConsented() {
   return getCookieConsent() !== null;
 }
@@ -989,6 +1233,8 @@ function setCookieConsent(preferences, source = "settings_save") {
       window.localStorage?.setItem(COOKIE_CONSENT_KEY, serialized);
     } catch {
     }
+    const networkStatus = mergedPreferences.performance || mergedPreferences.advertising ? "accepted" : "rejected";
+    setNetworkConsentHub(networkStatus);
     window.dispatchEvent(new CustomEvent(COOKIE_CONSENT_EVENT, { detail: record }));
   }
   return record;
@@ -1010,6 +1256,7 @@ function clearCookieConsent() {
       window.localStorage?.removeItem(COOKIE_CONSENT_KEY);
     } catch {
     }
+    setNetworkConsentHub(null);
     window.dispatchEvent(new CustomEvent(COOKIE_CONSENT_EVENT, { detail: null }));
   }
 }
@@ -1046,16 +1293,52 @@ function CookieConsentBanner({
   settingsUrl = "/cookies",
   className = "",
   publicationSlug,
-  complianceEndpoint = "/api/compliance/consent"
+  complianceEndpoint = "/api/compliance/consent",
+  countryCode,
+  forceShow = false,
+  consentHubUrl = DEFAULT_CONSENT_HUB_URL
 }) {
   const [mounted, setMounted] = react.useState(false);
   const [visible, setVisible] = react.useState(false);
   react.useEffect(() => {
     setMounted(true);
-    if (!hasConsented()) {
-      const timer = window.setTimeout(() => setVisible(true), 300);
-      return () => window.clearTimeout(timer);
+    if (checkUrlConsentBridge()) {
+      setVisible(false);
+      return;
+    }
+    if (hasConsented()) {
+      setVisible(false);
+      return;
     }
+    if (!forceShow && !isGeoConsentRequired(countryCode)) {
+      setVisible(false);
+      void queryNetworkConsentHub(consentHubUrl, 1200).then((networkStatus) => {
+        if (networkStatus === "accepted") {
+          acceptAllCookies();
+        } else if (networkStatus === "rejected") {
+          rejectOptionalCookies();
+        }
+      });
+      return;
+    }
+    let cancelled = false;
+    void queryNetworkConsentHub(consentHubUrl, 1e3).then((networkStatus) => {
+      if (cancelled) return;
+      if (networkStatus === "accepted") {
+        acceptAllCookies();
+        setVisible(false);
+      } else if (networkStatus === "rejected") {
+        rejectOptionalCookies();
+        setVisible(false);
+      } else {
+        setVisible(true);
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [countryCode, forceShow, consentHubUrl]);
+  react.useEffect(() => {
     const onConsentChange = () => {
       if (hasConsented()) {
         setVisible(false);
@@ -1070,19 +1353,21 @@ function CookieConsentBanner({
     setVisible(false);
     void recordConsentToCompliance(record, {
       endpoint: complianceEndpoint});
+    setNetworkConsentHub("accepted", consentHubUrl);
   };
   const handleReject = () => {
     const record = rejectOptionalCookies();
     setVisible(false);
     void recordConsentToCompliance(record, {
       endpoint: complianceEndpoint});
+    setNetworkConsentHub("rejected", consentHubUrl);
   };
   const defaultText = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    "We use cookies and process data from your device to analyze website performance, personalize ad content, and improve your experience. Your consent includes data transfers outside of the country you\u2019re located. View",
+    "We use cookies and device data to analyze performance, support local sponsors, and remember your reading preferences across our news network. View",
     " ",
     /* @__PURE__ */ jsxRuntime.jsx("a", { href: settingsUrl, className: "sm-cookie-banner-link", children: "Cookie Settings" }),
     " ",
-    "for more information."
+    "for details."
   ] });
   return /* @__PURE__ */ jsxRuntime.jsx(
     "aside",
@@ -1660,13 +1945,16 @@ exports.COOKIE_CONSENT_KEY = COOKIE_CONSENT_KEY;
 exports.COOKIE_CONSENT_MAX_AGE_SECONDS = COOKIE_CONSENT_MAX_AGE_SECONDS;
 exports.CookieConsentBanner = CookieConsentBanner;
 exports.CookieSettingsView = CookieSettingsView;
+exports.DEFAULT_CONSENT_HUB_URL = DEFAULT_CONSENT_HUB_URL;
 exports.DEFAULT_PREFERENCES_ACCEPTED = DEFAULT_PREFERENCES_ACCEPTED;
 exports.DEFAULT_PREFERENCES_REJECTED = DEFAULT_PREFERENCES_REJECTED;
+exports.EU_EEA_UK_COUNTRIES = EU_EEA_UK_COUNTRIES;
 exports.EVENTS = EVENTS;
 exports.FEATURE_NAMES = FEATURE_NAMES;
 exports.JOB_EMPLOYMENT_TYPES = JOB_EMPLOYMENT_TYPES;
 exports.LAYOUT_COOKIE = LAYOUT_COOKIE;
 exports.MEET_ACTIVITIES = MEET_ACTIVITIES;
+exports.NETWORK_CONSENT_STORAGE_KEY = NETWORK_CONSENT_STORAGE_KEY;
 exports.NEWS_CACHE = NEWS_CACHE;
 exports.NewsError = NewsError;
 exports.SESSION_IDLE_MS = SESSION_IDLE_MS;
@@ -1691,6 +1979,7 @@ exports.attribution = attribution;
 exports.briefSummary = briefSummary;
 exports.canHostMeetup = canHostMeetup;
 exports.categoryLabel = categoryLabel;
+exports.checkUrlConsentBridge = checkUrlConsentBridge;
 exports.classifiedPath = classifiedPath;
 exports.classifiedSearchPath = classifiedSearchPath;
 exports.clearCookieConsent = clearCookieConsent;
@@ -1700,6 +1989,7 @@ exports.composeEdition = composeEdition;
 exports.dealDollars = dealDollars;
 exports.dealGoPath = dealGoPath;
 exports.dealsFeedPath = dealsFeedPath;
+exports.decorateNetworkUrl = decorateNetworkUrl;
 exports.defaultRevalidateTargets = defaultRevalidateTargets;
 exports.definePublication = definePublication;
 exports.displayHeadline = displayHeadline;
@@ -1719,6 +2009,7 @@ exports.isAdult = isAdult;
 exports.isCategoryAllowed = isCategoryAllowed;
 exports.isClassifiedCategory = isClassifiedCategory;
 exports.isEmploymentType = isEmploymentType;
+exports.isGeoConsentRequired = isGeoConsentRequired;
 exports.jobEmployerBody = jobEmployerBody;
 exports.jobOpeningBody = jobOpeningBody;
 exports.jobPostingBody = jobPostingBody;
@@ -1739,6 +2030,7 @@ exports.publicationFromSnapshot = publicationFromSnapshot;
 exports.publicationJsonLd = publicationJsonLd;
 exports.publicationMeta = publicationMeta;
 exports.publicationRecord = publicationRecord;
+exports.queryNetworkConsentHub = queryNetworkConsentHub;
 exports.recordConsentToCompliance = recordConsentToCompliance;
 exports.referralCode = referralCode;
 exports.rejectOptionalCookies = rejectOptionalCookies;
@@ -1752,6 +2044,7 @@ exports.sectionDefinition = sectionDefinition;
 exports.sectionId = sectionId;
 exports.sectionPath = sectionPath;
 exports.setCookieConsent = setCookieConsent;
+exports.setNetworkConsentHub = setNetworkConsentHub;
 exports.setTheme = setTheme;
 exports.shortDeck = shortDeck;
 exports.shortText = shortText;

package/dist/index.d.cts

@@ -272,6 +272,8 @@ declare const COOKIE_CONSENT_KEY = "sm_cookie_consent_v1";
 declare const COOKIE_CONSENT_BACKUP_KEY = "napsite_cookie_consent_v1";
 declare const COOKIE_CONSENT_EVENT = "scalemule-cookie-consent-change";
 declare const COOKIE_CONSENT_MAX_AGE_SECONDS: number;
+declare const DEFAULT_CONSENT_HUB_URL = "https://bayareachronicle.com/consent-bridge.html";
+declare const NETWORK_CONSENT_STORAGE_KEY = "sm_network_consent_status";
 declare const DEFAULT_PREFERENCES_REJECTED: CookiePreferences;
 declare const DEFAULT_PREFERENCES_ACCEPTED: CookiePreferences;
 declare const COOKIE_CATEGORIES: CookieCategoryDefinition[];
@@ -280,6 +282,37 @@ declare const COOKIE_CATEGORIES: CookieCategoryDefinition[];
  * Checks HTTP cookie first, then localStorage fallback, then in-memory state.
  */
 declare function getCookieConsent(): CookieConsentRecord | null;
+/**
+ * ISO 3166-1 alpha-2 country codes for EU/EEA member states and the UK/Switzerland
+ * subject to the GDPR and ePrivacy Directive prior-consent requirement.
+ */
+declare const EU_EEA_UK_COUNTRIES: Set<string>;
+/**
+ * Determine if cookie consent prior-opt-in banner is required based on visitor geography.
+ * For US readers (including California CCPA/CPRA), opt-in banners are not required.
+ * Returns true ONLY if the visitor is identified as being within an EU/EEA/UK jurisdiction.
+ */
+declare function isGeoConsentRequired(countryCode?: string | null): boolean;
+/**
+ * Checks for a cross-domain network consent signal in the URL query (?sm_consent=accepted|rejected|1|0).
+ * If present, silently records the consent choice locally and removes the param from the address bar.
+ * Returns true if a consent signal was processed.
+ */
+declare function checkUrlConsentBridge(): boolean;
+/**
+ * Appends the current consent decision to an outgoing URL within the newspaper network
+ * so sister publications can adopt the user's choice without requiring a new banner prompt.
+ */
+declare function decorateNetworkUrl(targetUrl: string): string;
+/**
+ * Queries the central network iframe hub to retrieve the reader's cross-domain consent choice.
+ * If running on the hub origin directly, reads from local storage without an iframe.
+ */
+declare function queryNetworkConsentHub(hubUrl?: string, timeoutMs?: number): Promise<"accepted" | "rejected" | null>;
+/**
+ * Propagates a consent decision to the central network iframe hub so all sister publications adopt it.
+ */
+declare function setNetworkConsentHub(status: "accepted" | "rejected" | null, hubUrl?: string): void;
 /**
  * Check if the user has already provided an explicit consent decision.
  */
@@ -356,4 +389,4 @@ declare function subscribeTheme(listener: () => void): () => void;
  */
 declare function themeInitScript(): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, getStoredTheme, getSystemTheme, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NETWORK_CONSENT_STORAGE_KEY, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, checkUrlConsentBridge, clearCookieConsent, clearTheme, composeEdition, decorateNetworkUrl, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, getStoredTheme, getSystemTheme, hasConsented, inventoryCacheOptions, isCategoryAllowed, isGeoConsentRequired, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, queryNetworkConsentHub, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, setNetworkConsentHub, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -272,6 +272,8 @@ declare const COOKIE_CONSENT_KEY = "sm_cookie_consent_v1";
 declare const COOKIE_CONSENT_BACKUP_KEY = "napsite_cookie_consent_v1";
 declare const COOKIE_CONSENT_EVENT = "scalemule-cookie-consent-change";
 declare const COOKIE_CONSENT_MAX_AGE_SECONDS: number;
+declare const DEFAULT_CONSENT_HUB_URL = "https://bayareachronicle.com/consent-bridge.html";
+declare const NETWORK_CONSENT_STORAGE_KEY = "sm_network_consent_status";
 declare const DEFAULT_PREFERENCES_REJECTED: CookiePreferences;
 declare const DEFAULT_PREFERENCES_ACCEPTED: CookiePreferences;
 declare const COOKIE_CATEGORIES: CookieCategoryDefinition[];
@@ -280,6 +282,37 @@ declare const COOKIE_CATEGORIES: CookieCategoryDefinition[];
  * Checks HTTP cookie first, then localStorage fallback, then in-memory state.
  */
 declare function getCookieConsent(): CookieConsentRecord | null;
+/**
+ * ISO 3166-1 alpha-2 country codes for EU/EEA member states and the UK/Switzerland
+ * subject to the GDPR and ePrivacy Directive prior-consent requirement.
+ */
+declare const EU_EEA_UK_COUNTRIES: Set<string>;
+/**
+ * Determine if cookie consent prior-opt-in banner is required based on visitor geography.
+ * For US readers (including California CCPA/CPRA), opt-in banners are not required.
+ * Returns true ONLY if the visitor is identified as being within an EU/EEA/UK jurisdiction.
+ */
+declare function isGeoConsentRequired(countryCode?: string | null): boolean;
+/**
+ * Checks for a cross-domain network consent signal in the URL query (?sm_consent=accepted|rejected|1|0).
+ * If present, silently records the consent choice locally and removes the param from the address bar.
+ * Returns true if a consent signal was processed.
+ */
+declare function checkUrlConsentBridge(): boolean;
+/**
+ * Appends the current consent decision to an outgoing URL within the newspaper network
+ * so sister publications can adopt the user's choice without requiring a new banner prompt.
+ */
+declare function decorateNetworkUrl(targetUrl: string): string;
+/**
+ * Queries the central network iframe hub to retrieve the reader's cross-domain consent choice.
+ * If running on the hub origin directly, reads from local storage without an iframe.
+ */
+declare function queryNetworkConsentHub(hubUrl?: string, timeoutMs?: number): Promise<"accepted" | "rejected" | null>;
+/**
+ * Propagates a consent decision to the central network iframe hub so all sister publications adopt it.
+ */
+declare function setNetworkConsentHub(status: "accepted" | "rejected" | null, hubUrl?: string): void;
 /**
  * Check if the user has already provided an explicit consent decision.
  */
@@ -356,4 +389,4 @@ declare function subscribeTheme(listener: () => void): () => void;
  */
 declare function themeInitScript(): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, getStoredTheme, getSystemTheme, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NETWORK_CONSENT_STORAGE_KEY, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, checkUrlConsentBridge, clearCookieConsent, clearTheme, composeEdition, decorateNetworkUrl, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, getStoredTheme, getSystemTheme, hasConsented, inventoryCacheOptions, isCategoryAllowed, isGeoConsentRequired, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, queryNetworkConsentHub, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, setNetworkConsentHub, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.js

@@ -3,9 +3,9 @@ import { definePublication } from './chunk-C7JTEHTH.js';
 export { BROADSHEET_THEME, FEATURE_NAMES, LAYOUT_COOKIE, acceptRemoteRecord, acceptSnapshot, definePublication, featureEnabled, parseSnapshot, publicationFromSnapshot, publicationRecord, resolveLayout, snapshotFromRecord, syncPublication } from './chunk-C7JTEHTH.js';
 export { CLASSIFIED_CATEGORIES, JOB_EMPLOYMENT_TYPES, categoryLabel, classifiedPath, classifiedSearchPath, clipChars, dealDollars, dealGoPath, dealsFeedPath, employmentLabel, isClassifiedCategory, isEmploymentType, jobEmployerBody, jobOpeningBody, jobPostingBody, prepareClassified, prepareJobPost, publicJobPath, publicJobsPath } from './chunk-C7ZPLH2K.js';
 export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup, screenMessage } from './chunk-GB36YM56.js';
-export { CookieConsentBanner } from './chunk-5QHNNRVQ.js';
-export { CookieSettingsView } from './chunk-AYSBXLOT.js';
-export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, acceptAllCookies, clearCookieConsent, getCookieConsent, hasConsented, isCategoryAllowed, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent } from './chunk-RNXTBN5Z.js';
+export { CookieConsentBanner } from './chunk-5MHPE77S.js';
+export { CookieSettingsView } from './chunk-FUUL2PSF.js';
+export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, decorateNetworkUrl, getCookieConsent, hasConsented, isCategoryAllowed, isGeoConsentRequired, queryNetworkConsentHub, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from './chunk-L5OE6DND.js';
 
 // src/preset.ts
 var walnutCreekTimes = definePublication({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Shared server framework for ScaleMule local news publications. Walnut Creek Times is the broadsheet default; each paper supplies its own identity and feature flags.",
   "type": "module",
   "main": "./dist/index.cjs",