@scalemule/news-publication 0.0.46 → 0.0.48

package/dist/index.cjs

@@ -90,6 +90,48 @@ var EDITORIAL_SECTION_ORDER = [
   "Schools",
   "Opinion"
 ];
+var SECTION_ALIASES = {
+  "Business": "Local businesses",
+  "Government": "Civic life",
+  "Arts & Culture": "Community",
+  "Food & drink": "Food & places",
+  "Things to do": "Events",
+  "Sports": "Community",
+  "Education": "Schools",
+  "Public Safety": "Civic life",
+  "Transit": "Civic life",
+  "Environment": "Civic life",
+  "Recreation": "Community"
+};
+function resolveSection(item) {
+  const explicit = item.section?.trim();
+  if (explicit && explicit !== "Local news") {
+    return SECTION_ALIASES[explicit] ?? explicit;
+  }
+  const descriptors = [
+    ...(item.tags ?? []).map((t) => t.name.toLowerCase()),
+    ...(item.categories ?? []).map((c) => c.name.toLowerCase())
+  ];
+  for (const desc of descriptors) {
+    if (/\b(health|wellness|medical|hospital|clinic|doctor|pharmacy|veterinar|pet care|animal welfare|vaccin)\b/i.test(desc)) return "Health";
+    if (/\b(real estate|housing|home|homes|mortgage|tenant|tenants|apartment|apartments|property|bmr)\b/i.test(desc)) return "Real Estate";
+    if (/\b(civic|government|council|election|ballot|measure|transit|traffic|police|fire|firefighter|wildfire|safety|policy|supervisor)\b/i.test(desc)) return "Civic life";
+    if (/\b(business|retail|commerce|commercial|downtown|store|shop|merchants?|chamber of commerce)\b/i.test(desc)) return "Local businesses";
+    if (/\b(event|events|festival|festivals|fair|fairs|concert|concerts|music|workshop|workshops|things to do|exhibition|performance)\b/i.test(desc)) return "Events";
+    if (/\b(school|schools|education|student|students|teacher|teachers|campus|college|university)\b/i.test(desc)) return "Schools";
+    if (/\b(food|dining|restaurant|restaurants|wine|winery|brewery|bakery|cafe|coffee|cuisine|chef)\b/i.test(desc)) return "Food & places";
+    if (/\b(community|volunteer|volunteers|library|libraries|neighborhood|nonprofit|charity|youth|senior|seniors)\b/i.test(desc)) return "Community";
+  }
+  const text = `${item.title} ${item.excerpt ?? ""}`;
+  if (/\b(health|hospitals?|clinics?|medical|doctors?|pharmac(?:y|ies)|wellness|veterinar(?:y|ian)|pet care|animal welfare|vaccinat(?:ion|ions)|patients?)\b/iu.test(text)) return "Health";
+  if (/\b(real estate|homeownership|mortgage|housing|tenants?|apartments?|below-market rate|home sales?|condos?)\b/iu.test(text)) return "Real Estate";
+  if (/\b(city council|planning commission|board of supervisors|ballot|measure [a-z0-9]|election|transit|traffic|police|firefighter|wildfire|evacuation|pedestrian safety|city manager|public works)\b/iu.test(text)) return "Civic life";
+  if (/\b(storefront|retail|downtown business|chamber of commerce|opens? doors?|boutique|merchants?|shoppers?|commercial space)\b/iu.test(text)) return "Local businesses";
+  if (/\b(festival|parade|fair|concert|workshop|exhibition|showcase|celebration|weigh-off|halloween|trunk-or-treat)\b/iu.test(text)) return "Events";
+  if (/\b(schools?|students?|teachers?|campuses?|classrooms?|high school|elementary|school district)\b/iu.test(text)) return "Schools";
+  if (/\b(restaurants?|cafes?|baker(?:y|ies)|winer(?:y|ies)|brewer(?:y|ies)|dining|chefs?|menus?)\b/iu.test(text)) return "Food & places";
+  return "Community";
+}
 function orderedSections(sections2, order = EDITORIAL_SECTION_ORDER) {
   return sections2.filter((section) => section.name !== "Local news").slice().sort((left, right) => {
     const leftRank = order.indexOf(left.name);
@@ -111,8 +153,8 @@ function sectionDefinition(name) {
 function editorialSections(items) {
   const groups = /* @__PURE__ */ new Map();
   for (const item of items) {
-    const name = item.section?.trim() || "Local news";
-    groups.set(name, [...groups.get(name) ?? [], item]);
+    const name = resolveSection(item);
+    groups.set(name, [...groups.get(name) ?? [], { ...item, section: name }]);
   }
   return Array.from(groups, ([name, articles]) => ({ ...sectionDefinition(name), items: articles }));
 }
@@ -234,8 +276,8 @@ function shortDeck(value, limit = 160) {
   return (space > opening.length / 2 ? opening.slice(0, space) : opening).trimEnd() + "\u2026";
 }
 function storyDate(value) {
-  const date = new Date(value);
-  return Number.isNaN(date.getTime()) ? null : date.toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric", timeZone: "America/Los_Angeles" });
+  const date2 = new Date(value);
+  return Number.isNaN(date2.getTime()) ? null : date2.toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric", timeZone: "America/Los_Angeles" });
 }
 
 // src/seo.ts
@@ -1278,13 +1320,6 @@ var COOKIE_CATEGORIES = [
         duration: "1 year",
         type: "HTTP Cookie"
       },
-      {
-        name: "napsite_session_v1",
-        provider: "First-Party",
-        purpose: "Maintains session continuity, security tokens, and server routing.",
-        duration: "30 minutes (idle)",
-        type: "Session Storage"
-      },
       {
         name: "napsite_preview",
         provider: "First-Party",
@@ -1298,9 +1333,16 @@ var COOKIE_CATEGORIES = [
     id: "performance",
     title: "Performance & Analytics Cookies",
     shortDescription: "Help us measure reader engagement, story completion, and site reliability.",
-    fullDescription: "These cookies collect anonymous information about how visitors navigate our news publication. They allow us to count article reads, understand scroll depth and reading completion, and identify broken links or slow-loading assets so we can keep our community reporting responsive and fast. All metrics are aggregated and never contain personal information.",
+    fullDescription: "With your permission, first-party identifiers support page-visit and reading measurements. Aggregate reports help us improve the publication. Measurements are incomplete when readers decline consent and are not a count of unique people.",
     required: false,
     cookies: [
+      {
+        name: "napsite_session_v1",
+        provider: "First-Party",
+        purpose: "Groups consented reading measurements within a session.",
+        duration: "30 minutes (idle)",
+        type: "Session Storage"
+      },
       {
         name: "napsite_visitor_v1",
         provider: "First-Party",
@@ -1350,29 +1392,14 @@ var COOKIE_CATEGORIES = [
   {
     id: "advertising",
     title: "Advertising & Local Sponsorship Cookies",
-    shortDescription: "Support local business sponsors by capping repetition and measuring notices.",
-    fullDescription: "Our journalism is supported by local business sponsors and community partners. These cookies ensure you do not see the same sponsor banner repeatedly (frequency capping) and help local merchants measure whether their announcement reached their community. They never track your activity across unrelated third-party websites or build external advertising profiles.",
+    shortDescription: "Measure clearly labeled community sponsorship views and link clicks.",
+    fullDescription: "With your permission, we measure visible sponsor acknowledgments and link clicks. Repetition limits use temporary page-session memory. We do not use third-party advertising trackers or build behavioral advertising profiles.",
     required: false,
-    cookies: [
-      {
-        name: "napsite_sponsor_cap",
-        provider: "First-Party",
-        purpose: "Prevents repetitive display of identical local business announcements.",
-        duration: "7 days",
-        type: "Local Storage"
-      },
-      {
-        name: "local_sponsor_ref",
-        provider: "First-Party",
-        purpose: "Attributes community inquiries directly to the sponsoring local merchant.",
-        duration: "30 days",
-        type: "Local Storage"
-      }
-    ]
+    cookies: []
   }
 ];
 function CookieConsentBanner({
-  title = "Help Us Improve Our Website with Cookies",
+  title = "Your privacy choices",
   text,
   settingsUrl = "/cookies",
   className = "",
@@ -1386,73 +1413,41 @@ function CookieConsentBanner({
   const [visible, setVisible] = react.useState(false);
   react.useEffect(() => {
     setMounted(true);
-    setupNetworkConsentDelegation();
-    if (compliance.checkUrlConsentBridge()) {
-      setVisible(false);
-      return;
-    }
-    if (compliance.hasConsented()) {
-      setVisible(false);
-      return;
-    }
-    if (!forceShow && !compliance.isGeoConsentRequired(countryCode)) {
-      setVisible(false);
-      void compliance.queryNetworkConsentHub(consentHubUrl, 1200).then((networkStatus) => {
-        if (networkStatus === "accepted") {
-          compliance.acceptAllCookies();
-        } else if (networkStatus === "rejected") {
-          compliance.rejectOptionalCookies();
-        }
-      });
-      return;
-    }
-    let cancelled = false;
-    void compliance.queryNetworkConsentHub(consentHubUrl, 1e3).then((networkStatus) => {
-      if (cancelled) return;
-      if (networkStatus === "accepted") {
-        compliance.acceptAllCookies();
-        setVisible(false);
-      } else if (networkStatus === "rejected") {
-        compliance.rejectOptionalCookies();
-        setVisible(false);
-      } else {
-        setVisible(true);
-      }
-    });
-    return () => {
-      cancelled = true;
-    };
+    const url = new URL(window.location.href);
+    if (url.searchParams.has("sm_consent")) {
+      if (url.searchParams.get("sm_consent") === "0" && !compliance.hasConsented())
+        compliance.rejectOptionalCookies({ hubUrl: consentHubUrl });
+      url.searchParams.delete("sm_consent");
+      window.history.replaceState(window.history.state, "", url);
+    }
+    setVisible(!compliance.hasConsented() && !compliance.isGpcActive());
   }, [countryCode, forceShow, consentHubUrl]);
   react.useEffect(() => {
     const onConsentChange = () => {
-      if (compliance.hasConsented()) {
-        setVisible(false);
-      }
+      setVisible(!compliance.hasConsented() && !compliance.isGpcActive());
     };
     window.addEventListener(compliance.COOKIE_CONSENT_EVENT, onConsentChange);
     return () => window.removeEventListener(compliance.COOKIE_CONSENT_EVENT, onConsentChange);
   }, []);
   if (!mounted || !visible) return null;
   const handleAccept = () => {
-    const record = compliance.acceptAllCookies();
+    const record = compliance.acceptAllCookies({ hubUrl: consentHubUrl });
     setVisible(false);
     void recordConsentToCompliance(record, {
       endpoint: complianceEndpoint,
       publicationSlug
     });
-    compliance.setNetworkConsentHub("accepted", consentHubUrl);
   };
   const handleReject = () => {
-    const record = compliance.rejectOptionalCookies();
+    const record = compliance.rejectOptionalCookies({ hubUrl: consentHubUrl });
     setVisible(false);
     void recordConsentToCompliance(record, {
       endpoint: complianceEndpoint,
       publicationSlug
     });
-    compliance.setNetworkConsentHub("rejected", consentHubUrl);
   };
   const defaultText = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    "We use cookies and device data to analyze performance, support local sponsors, and remember your reading preferences across our news network. View",
+    "With your permission, we measure reading activity and sponsor acknowledgments. You can read the publication with optional cookies turned off. View",
     " ",
     /* @__PURE__ */ jsxRuntime.jsx("a", { href: settingsUrl, className: "sm-cookie-banner-link", children: "Cookie Settings" }),
     " ",
@@ -3234,6 +3229,111 @@ function renderArticleBlocksToHtml(blocks, mediaMap, options) {
   return parts.join("\n");
 }
 
+// src/sponsorships.ts
+var SPONSORSHIP_POLICY = "Sponsors receive clearly identified recognition. Sponsorship does not influence reporting, event selection, factual information, rankings or editorial recommendations.";
+var SPONSORSHIP_OFFERINGS = [
+  {
+    type: "community_partner",
+    name: "Publication Community Partner",
+    price_cents: 35e3,
+    duration: "One calendar month; exact start and end dates in the agreement.",
+    deliverables: "One acknowledgment on the publication's community partners page and one compact acknowledgment below the community calendar. No article placements.",
+    acknowledgments: "Two defined web locations; recurring display during the campaign, subject to reader repetition limits.",
+    creative: "Name, approved logo, up to 140 characters of copy and one HTTPS link.",
+    max_sponsors: 2,
+    product_path: "/community-partners"
+  },
+  {
+    type: "community_calendar",
+    name: "Community Calendar Sponsor",
+    price_cents: 25e3,
+    duration: "One calendar month; exact start and end dates in the agreement.",
+    deliverables: "One acknowledgment above the independently curated community events calendar.",
+    acknowledgments: "One web location; recurring display during the campaign, subject to reader repetition limits.",
+    creative: "Name, approved logo, up to 140 characters of copy and one HTTPS link.",
+    max_sponsors: 1,
+    product_path: "/this-week"
+  },
+  {
+    type: "daily_briefing",
+    name: "Daily Briefing Sponsor",
+    price_cents: 3e4,
+    duration: "One calendar month after verified newsletter delivery is operational.",
+    deliverables: "One acknowledgment per agreed briefing edition. Edition dates and count must be specified in the agreement before booking.",
+    acknowledgments: "One per contracted edition; no minimum send count is promised before launch.",
+    creative: "Name, optional logo, up to 140 characters of approved copy and one HTTPS link.",
+    max_sponsors: 1,
+    product_path: "/newsletter"
+  },
+  {
+    type: "community_guide",
+    name: "Community Guide Sponsor",
+    price_cents: null,
+    duration: "Fixed dates agreed for a named guide.",
+    deliverables: "One acknowledgment on one named, independently edited community guide; scope and updates agreed in writing.",
+    acknowledgments: "One web location per contracted guide.",
+    creative: "Name, approved logo, up to 140 characters of copy and one HTTPS link.",
+    max_sponsors: 1,
+    product_path: "/guides"
+  }
+];
+function safeSponsorUrl(value) {
+  if (typeof value !== "string" || value.length > 2048) return void 0;
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" || url.username || url.password)
+      return void 0;
+    return url.toString();
+  } catch {
+    return void 0;
+  }
+}
+function placementAvailable(placement, now = Date.now()) {
+  const verified = placement.verified_at && Date.parse(placement.verified_at);
+  return placement.placement_type !== "daily_briefing" && placement.active && placement.availability === "available" && Boolean(safeSponsorUrl(placement.verification_url)) && typeof verified === "number" && Number.isFinite(verified) && verified <= now && now - verified <= 90 * 864e5;
+}
+
+// src/measurement-consent.ts
+function measurementConsent(headers, sponsorship = false, now = Date.now()) {
+  if (headers.get("dnt") === "1" || headers.get("sec-gpc") === "1")
+    return false;
+  const cookies = headers.get("cookie")?.split(";").map((value) => value.trim()) ?? [];
+  const cookie = cookies.find((value) => value.startsWith("sm_cookie_consent_v1=")) ?? cookies.find((value) => value.startsWith("napsite_cookie_consent_v1="));
+  if (!cookie) return false;
+  try {
+    const record = JSON.parse(
+      decodeURIComponent(cookie.substring(cookie.indexOf("=") + 1))
+    );
+    const date2 = Date.parse(record.timestamp);
+    return record.version === 1 && record.preferences?.essential === true && typeof record.preferences?.functional === "boolean" && typeof record.preferences?.advertising === "boolean" && record.preferences?.performance === true && (!sponsorship || record.preferences?.advertising === true) && Number.isFinite(date2) && date2 <= now + 3e5 && now - date2 < 365 * 864e5;
+  } catch {
+    return false;
+  }
+}
+
+// src/sponsorship-report.ts
+var escape = (text) => String(text ?? "").replace(
+  /[&<>"']/g,
+  (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]
+);
+var date = (value) => new Date(value).toLocaleString("en-US", {
+  timeZone: "UTC",
+  dateStyle: "medium",
+  timeStyle: "short"
+}) + " UTC";
+function metric(value) {
+  if (value.status === "unavailable" || value.value === null)
+    return "Unavailable";
+  return `${escape(value.value.toLocaleString("en-US"))} <small>${escape(value.status)}</small>${value.from && value.to ? `<small>Observed period:<br>${escape(date(value.from))}<br>to ${escape(date(value.to))}</small>` : ""}`;
+}
+function campaignReportHtml(report) {
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${escape(report.campaign_name)} | Sponsorship report</title><style>
+  @page{size:Letter;margin:18mm}*{box-sizing:border-box}body{font:11pt/1.5 Arial,sans-serif;color:#172d37;margin:0}h1,h2{font-family:Georgia,serif;font-weight:normal}h1{font-size:30pt;line-height:1.12;margin:16pt 0}h2{font-size:19pt;margin:0 0 8pt}header{border-bottom:2pt solid #173d32;padding-bottom:16pt}.brand{font-size:10pt;letter-spacing:1pt}p{margin:8pt 0}.meta{color:#4e5d64;font-size:10pt}section{break-inside:avoid;margin:24pt 0}table{width:100%;border-collapse:collapse;margin:12pt 0}td,th{text-align:left;border-bottom:1px solid #d8dedc;padding:8pt 5pt}th{font-size:9pt}small{display:block;color:#4e5d64;font-size:8pt}footer{border-top:1px solid #d8dedc;padding-top:12pt;font-size:9pt}.notes{font-size:9pt;color:#4e5d64}
+  </style></head><body><header><div class="brand">BAY AREA NEWS NETWORK</div><p>Community sponsorship report</p><h1>${escape(report.campaign_name)}</h1><p>${escape(report.sponsor)}</p><p class="meta">Campaign period: ${escape(date(report.starts_at))} to ${escape(date(report.ends_at))}<br>Status: ${escape(report.status)}<br>Prepared: ${escape(date(report.generated_at))}</p></header>
+  ${report.placements.map((p) => `<section><h2>${escape(p.publication)}</h2><p>${escape(p.placement)} \xB7 ${escape(p.product_path)}</p><p class="meta">Community scope: ${escape(p.communities.length ? p.communities.join(", ") : "Publication-wide")}<br>Placement delivery: ${escape(p.delivery_status)}</p><table><thead><tr><th>Observed placement views</th><th>Observed sponsor link clicks</th><th>Newsletter deliveries</th></tr></thead><tbody><tr><td>${metric(p.views)}</td><td>${metric(p.clicks)}</td><td>${metric(p.newsletter_deliveries)}</td></tr></tbody></table><p class="notes">Views: ${escape(p.views.methodology)}<br>Clicks: ${escape(p.clicks.methodology)}<br>Newsletter: ${escape(p.newsletter_deliveries.methodology)}</p></section>`).join("")}
+  <footer><p>${escape(report.reporting_note)}</p><p>${escape(report.editorial_independence)}</p><p>Campaign reference: ${escape(report.campaign_id)}</p></footer></body></html>`;
+}
+
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
   get: function () { return compliance.COOKIE_CONSENT_BACKUP_KEY; }
@@ -3341,6 +3441,8 @@ exports.NEWS_CACHE = NEWS_CACHE;
 exports.NetworkCopyrightNotice = NetworkCopyrightNotice;
 exports.NewsError = NewsError;
 exports.SESSION_IDLE_MS = SESSION_IDLE_MS;
+exports.SPONSORSHIP_OFFERINGS = SPONSORSHIP_OFFERINGS;
+exports.SPONSORSHIP_POLICY = SPONSORSHIP_POLICY;
 exports.THEME_COOKIE = THEME_COOKIE;
 exports.THEME_EVENT = THEME_EVENT;
 exports.THEME_MAX_AGE_SECONDS = THEME_MAX_AGE_SECONDS;
@@ -3361,6 +3463,7 @@ exports.articleMeta = articleMeta;
 exports.articleUrl = articleUrl;
 exports.attribution = attribution;
 exports.briefSummary = briefSummary;
+exports.campaignReportHtml = campaignReportHtml;
 exports.canHostMeetup = canHostMeetup;
 exports.categoryLabel = categoryLabel;
 exports.classifiedPath = classifiedPath;
@@ -3403,12 +3506,14 @@ exports.listedPublications = listedPublications;
 exports.llmsText = llmsText;
 exports.localPublications = localPublications;
 exports.matchesStoryTag = matchesStoryTag;
+exports.measurementConsent = measurementConsent;
 exports.nearbyUpdates = nearbyUpdates;
 exports.newsArticleJsonLd = newsArticleJsonLd;
 exports.normalizedText = normalizedText;
 exports.orderedSections = orderedSections;
 exports.parseDocumentBlocks = parseDocumentBlocks;
 exports.parseSnapshot = parseSnapshot;
+exports.placementAvailable = placementAvailable;
 exports.prepareClassified = prepareClassified;
 exports.prepareJobPost = prepareJobPost;
 exports.prepareMeetup = prepareMeetup;
@@ -3429,7 +3534,9 @@ exports.renderArticleBlocksToHtml = renderArticleBlocksToHtml;
 exports.resolveCoupon = resolveCoupon;
 exports.resolveEffectiveTheme = resolveEffectiveTheme;
 exports.resolveLayout = resolveLayout;
+exports.resolveSection = resolveSection;
 exports.revalidateDecision = revalidateDecision;
+exports.safeSponsorUrl = safeSponsorUrl;
 exports.sanitizeInlineMarkdown = sanitizeInlineMarkdown;
 exports.screenMessage = screenMessage;
 exports.secretsMatch = secretsMatch;

package/dist/index.d.cts

@@ -15,6 +15,8 @@ import * as react from 'react';
 export { VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl } from './verified-card.cjs';
 export { C as CommunityMapArticleEmbed, c as communityMapEmbeds } from './community-maps-DKcYhQYN.cjs';
 export { C as ContentBlock, S as StructuredDocument, a as StructuredMedia, f as formatArtworkCaption, p as parseDocumentBlocks, r as renderArticleBlocksToHtml, s as sanitizeInlineMarkdown } from './article-blocks-DsabIDmH.cjs';
+import { M as Measurement } from './sponsorships-CtnBe3S8.cjs';
+export { a as Campaign, b as CampaignStatus, c as CampaignTarget, C as Creative, d as Placement, e as PlacementType, P as PublicAcknowledgment, S as SPONSORSHIP_OFFERINGS, f as SPONSORSHIP_POLICY, g as SponsorParty, p as placementAvailable, s as safeSponsorUrl } from './sponsorships-CtnBe3S8.cjs';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
 declare const BROADSHEET_THEME: PublicationTheme;
@@ -219,6 +221,13 @@ declare function defaultRevalidateTargets(): {
  * "Opinion" are reserved so future sections slot in without a release.
  */
 declare const EDITORIAL_SECTION_ORDER: readonly ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health", "Schools", "Opinion"];
+/**
+ * Resolves a story's canonical editorial section.
+ * Preserves explicitly assigned sections (normalizing known aliases).
+ * If unassigned, intelligently infers section desk from tags, categories, or keywords
+ * so stories are never lost to unrendered buckets.
+ */
+declare function resolveSection(item: NewsItem): string;
 /** Sorts sections into the canonical order, dropping the implicit "Local news" bucket. */
 declare function orderedSections<T extends {
     name: string;
@@ -473,4 +482,35 @@ declare function publicationListeningCandidates<T extends ListeningArticle>(item
  */
 declare const CURATED_COMMUNITY_CARDS: Record<string, Record<string, unknown>[]>;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, 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, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+/** The server enforces the same explicit consent gate as the browser. */
+declare function measurementConsent(headers: Pick<Headers, "get">, sponsorship?: boolean, now?: number): boolean;
+
+interface SponsorshipReport {
+    campaign_id: string;
+    campaign_name: string;
+    sponsor: string;
+    starts_at: string;
+    ends_at: string;
+    status: string;
+    generated_at: string;
+    editorial_independence: string;
+    reporting_note: string;
+    placements: Array<{
+        application_id: string;
+        publication_id: string;
+        publication: string;
+        publication_url: string;
+        placement_id: string;
+        placement: string;
+        product_path: string;
+        communities: string[];
+        delivery_status: string;
+        views: Measurement;
+        clicks: Measurement;
+        newsletter_deliveries: Measurement;
+    }>;
+}
+/** Shared by the newsroom print/export view and the repeatable PDF renderer. */
+declare function campaignReportHtml(report: SponsorshipReport): string;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -15,6 +15,8 @@ import * as react from 'react';
 export { VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl } from './verified-card.js';
 export { C as CommunityMapArticleEmbed, c as communityMapEmbeds } from './community-maps-DKcYhQYN.js';
 export { C as ContentBlock, S as StructuredDocument, a as StructuredMedia, f as formatArtworkCaption, p as parseDocumentBlocks, r as renderArticleBlocksToHtml, s as sanitizeInlineMarkdown } from './article-blocks-DsabIDmH.js';
+import { M as Measurement } from './sponsorships-CtnBe3S8.js';
+export { a as Campaign, b as CampaignStatus, c as CampaignTarget, C as Creative, d as Placement, e as PlacementType, P as PublicAcknowledgment, S as SPONSORSHIP_OFFERINGS, f as SPONSORSHIP_POLICY, g as SponsorParty, p as placementAvailable, s as safeSponsorUrl } from './sponsorships-CtnBe3S8.js';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
 declare const BROADSHEET_THEME: PublicationTheme;
@@ -219,6 +221,13 @@ declare function defaultRevalidateTargets(): {
  * "Opinion" are reserved so future sections slot in without a release.
  */
 declare const EDITORIAL_SECTION_ORDER: readonly ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health", "Schools", "Opinion"];
+/**
+ * Resolves a story's canonical editorial section.
+ * Preserves explicitly assigned sections (normalizing known aliases).
+ * If unassigned, intelligently infers section desk from tags, categories, or keywords
+ * so stories are never lost to unrendered buckets.
+ */
+declare function resolveSection(item: NewsItem): string;
 /** Sorts sections into the canonical order, dropping the implicit "Local news" bucket. */
 declare function orderedSections<T extends {
     name: string;
@@ -473,4 +482,35 @@ declare function publicationListeningCandidates<T extends ListeningArticle>(item
  */
 declare const CURATED_COMMUNITY_CARDS: Record<string, Record<string, unknown>[]>;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, 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, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+/** The server enforces the same explicit consent gate as the browser. */
+declare function measurementConsent(headers: Pick<Headers, "get">, sponsorship?: boolean, now?: number): boolean;
+
+interface SponsorshipReport {
+    campaign_id: string;
+    campaign_name: string;
+    sponsor: string;
+    starts_at: string;
+    ends_at: string;
+    status: string;
+    generated_at: string;
+    editorial_independence: string;
+    reporting_note: string;
+    placements: Array<{
+        application_id: string;
+        publication_id: string;
+        publication: string;
+        publication_url: string;
+        placement_id: string;
+        placement: string;
+        product_path: string;
+        communities: string[];
+        delivery_status: string;
+        views: Measurement;
+        clicks: Measurement;
+        newsletter_deliveries: Measurement;
+    }>;
+}
+/** Shared by the newsroom print/export view and the repeatable PDF renderer. */
+declare function campaignReportHtml(report: SponsorshipReport): string;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };