@scalemule/news-publication 0.0.44 → 0.0.46

package/README.md

@@ -73,6 +73,67 @@ The React front page still lives in the Walnut Creek Times repository. This pack
 
 Patch only (`0.0.x` or `0.1.x`) until a stable release is explicitly approved. Publishing is manual: `npm publish` from this directory.
 
+## Local briefing foundation
+
+`composeLocalBriefing(candidates, options)` is an opt-in, pure selector for an existing
+publication brief. It consumes `BriefingCandidate` projections from an authorized
+server adapter and returns a bounded list using existing `NewsItem` text. It does
+not fetch or generate news, verify claims, store preferences, or change the current
+`composeEdition` path. A server adapter and publication pilot are still required;
+there is no new live BaseNews endpoint in this package.
+
+This is an article-backed presentation helper, not the canonical BaseNews schema.
+BaseNews events, issues and opportunities must also work without an article.
+Its eligibility rules apply only to this optional brief. They must never become
+new publishing gates for articles, questionnaires, jokes, jobs, classifieds,
+celebrations or other existing publication features. Their current owner services
+and workflows continue independently, including when intelligence processing is
+unavailable. Underlying capture, trust and agent APIs take priority over UI rollout.
+
+Supply the recipient `sm_application_id`, `publication_id`, resolved
+`coverage_area_ids`, and optional explicit community/topic/entity/issue preferences.
+`personalized: false` ignores all preferences. `limit` is a maximum from 1–12
+(default 6); zero useful records yields an empty briefing. Render summaries as
+text, with original reporting links, verification labels and source attribution.
+`why_it_matters` is optional editorial text; reason codes explain selection and
+are not factual claims about an item's consequences.
+
+The server must derive scope from authentication, authorize destination grants,
+resolve geographic relationships, enforce evidence/summary redistribution rights,
+and send public, approved projections. Reuse existing Content Intelligence
+classification, coverage profiles, editorial decisions and current evaluation
+receipts in that adapter; this presentation selector does not replace its generic
+relevance engine or editorial ledger. This helper is **not an authorization or
+input-validation boundary**. Do not pass client-supplied trust/approval fields,
+private artifacts, or raw community submissions. Unverified and community-submitted
+information retains those labels even after editorial approval.
+
+Each candidate references an existing canonical development, occurrence or reporting
+record via a namespaced `canonical_key`, with its revision. Do not use a whole issue
+ID as the key: separate developments must survive. Include withdrawal/supersession
+revisions when combining cached inventories; the newest revision wins before
+eligibility and ranking. Supply one selected edition per canonical revision;
+conflicting copies of that revision are omitted for reconciliation, not selected
+by input order. A feed lacking tombstones cannot prove that cached records
+are still current. The caller must invalidate caches on corrections and grant
+revocation. Treat personalized HTTP responses as `private, no-store`.
+
+Policy 1 uses a civic priority tier, followed by geography × 4, practical value × 3,
+explicit follows × 3, topics × 2, reporting recency and editorial discovery value.
+All seven components and reason codes are returned. Recency describes reporting,
+not event time or urgency. Civic importance comes from editors, not section names.
+Keep a visible link to all important coverage whenever `remaining_important_count`
+is positive. Eligibility still applies to civic items: stale or unauthorized facts
+cannot bypass trust gates.
+
+`relevant_until` is required. Confirmed labels also require a public evidence link,
+`last_verified_at` and a future `review_due_at`. Expired review/relevance deadlines
+exclude records; missing freshness information stays `unknown`. No date is inferred
+from `updated_at`, no confidence score promotes verification, and no fallback story
+fills a quota. The entire approved excerpt must end with sentence punctuation and
+fit within 280 Unicode code points; otherwise it is omitted for editorial repair.
+Later qualifications and corrections are never cut off to make a shorter summary.
+
 
 ### Reporting credit and sources
 

package/dist/index.cjs

@@ -73,106 +73,6 @@ function resolveLayout(publication, cookieValue) {
   return publication.layout;
 }
 
-// src/preset.ts
-var walnutCreekTimes = definePublication({
-  slug: "walnutcreektimes",
-  name: "Walnut Creek Times",
-  masthead: ["Walnut", "Creek", "Times"],
-  region: "Walnut Creek",
-  regionLabel: "Walnut Creek",
-  towns: ["Walnut Creek", "Rossmoor", "Saranap", "Pleasant Hill"],
-  nearbyTowns: ["Martinez", "Concord", "Contra Costa"],
-  sections: ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health"],
-  description: "Independent local journalism covering civic decisions, downtown commerce, neighborhood life, and community achievements across Walnut Creek, Rossmoor, Saranap, and Pleasant Hill.",
-  tagline: "Local stories. Stronger communities.",
-  layout: "broadsheet",
-  layouts: ["broadsheet"],
-  features: { smile: true, jobs: true, classifieds: true },
-  modules: { home: ["daily-smile"] }
-});
-
-// src/cache.ts
-var NEWS_CACHE = {
-  feedRevalidateSeconds: 30,
-  articleRevalidateSeconds: 60,
-  edgeMaxAgeSeconds: 60,
-  staleWhileRevalidateSeconds: 300,
-  feedTag: "news-feed",
-  articleTag: "news-article",
-  inventoryTag: "public-news-discovery-v2",
-  paths: ["/", "/news"]
-};
-var feedCacheOptions = {
-  revalidate: NEWS_CACHE.feedRevalidateSeconds,
-  tags: [NEWS_CACHE.feedTag]
-};
-var articleCacheOptions = {
-  revalidate: NEWS_CACHE.articleRevalidateSeconds,
-  tags: [NEWS_CACHE.articleTag]
-};
-var inventoryCacheOptions = {
-  revalidate: NEWS_CACHE.feedRevalidateSeconds,
-  tags: [NEWS_CACHE.feedTag, NEWS_CACHE.inventoryTag]
-};
-function edgeCacheControl() {
-  return `public, s-maxage=${NEWS_CACHE.edgeMaxAgeSeconds}, stale-while-revalidate=${NEWS_CACHE.staleWhileRevalidateSeconds}`;
-}
-function feedCacheKey(publicationId, before, section) {
-  return `${publicationId}:${before ?? ""}:${section ?? ""}`;
-}
-function articleCacheKey(publicationId, slug) {
-  return `${publicationId}:${slug}`;
-}
-var NewsError = class extends Error {
-  constructor(status, message) {
-    super(message);
-    this.status = status;
-    this.name = "NewsError";
-  }
-  status;
-};
-function shouldServeLastKnown(error) {
-  const status = error instanceof NewsError ? error.status : error && typeof error === "object" && "status" in error ? error.status : void 0;
-  return status !== 404;
-}
-async function withLastKnown(store, key, load, accept = () => true) {
-  try {
-    const value = await load();
-    if (accept(value)) store.set(key, value);
-    return value;
-  } catch (error) {
-    if (!shouldServeLastKnown(error)) throw error;
-    const cached = store.get(key);
-    if (cached) return cached;
-    throw error;
-  }
-}
-function secretsMatch(provided, secret) {
-  if (!provided || !secret) return false;
-  const left = Array.from(provided);
-  const right = Array.from(secret);
-  let mismatch = left.length === right.length ? 0 : 1;
-  const length = Math.max(left.length, right.length);
-  for (let index = 0; index < length; index += 1) {
-    mismatch |= (left[index]?.codePointAt(0) ?? 0) ^ (right[index]?.codePointAt(0) ?? 0);
-  }
-  return mismatch === 0;
-}
-function revalidateDecision(input) {
-  if (!secretsMatch(input.providedSecret, input.configuredSecret)) {
-    return { status: 401, body: { error: "Unauthorized" } };
-  }
-  const tag = input.tag?.trim() || `${NEWS_CACHE.feedTag}, ${NEWS_CACHE.articleTag}`;
-  const path = input.path?.trim() || NEWS_CACHE.paths.join(", ");
-  return { status: 200, body: { revalidated: true, tag, path, now: input.now ?? Date.now() } };
-}
-function defaultRevalidateTargets() {
-  return {
-    tags: [NEWS_CACHE.feedTag, NEWS_CACHE.articleTag, NEWS_CACHE.inventoryTag],
-    paths: [...NEWS_CACHE.paths]
-  };
-}
-
 // src/editorial.ts
 var labels = {
   "Local businesses": "Business",
@@ -190,8 +90,8 @@ var EDITORIAL_SECTION_ORDER = [
   "Schools",
   "Opinion"
 ];
-function orderedSections(sections, order = EDITORIAL_SECTION_ORDER) {
-  return sections.filter((section) => section.name !== "Local news").slice().sort((left, right) => {
+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);
     const rightRank = order.indexOf(right.name);
     const leftOrder = leftRank === -1 ? order.length : leftRank;
@@ -252,12 +152,12 @@ function composeEdition(items, selection = {}, now = Date.now()) {
     secondary.push(deferredWithDuplicateImage.shift());
   }
   for (const item of secondary) remaining.splice(remaining.indexOf(item), 1);
-  const eligible = remaining.filter((item) => {
+  const eligible2 = remaining.filter((item) => {
     const age = now - Date.parse(item.published_at);
     return item.excerpt?.trim() && age >= 0 && age <= 7 * 864e5;
   });
-  const selected = (pins.brief_slugs ?? []).flatMap((slug) => eligible.find((item) => item.slug === slug) ?? []);
-  const candidates = [...selected, ...editorialSections(eligible).map((group) => group.items[0]), ...eligible];
+  const selected = (pins.brief_slugs ?? []).flatMap((slug) => eligible2.find((item) => item.slug === slug) ?? []);
+  const candidates = [...selected, ...editorialSections(eligible2).map((group) => group.items[0]), ...eligible2];
   const briefIds = /* @__PURE__ */ new Set();
   const briefs = candidates.filter((item) => {
     if (!item || briefIds.has(item.id) || briefIds.size >= 4) return false;
@@ -266,8 +166,8 @@ function composeEdition(items, selection = {}, now = Date.now()) {
   });
   const compact = [...briefs, ...remaining.filter((item) => !briefIds.has(item.id))].slice(0, 4);
   const compactIds = new Set(compact.map((item) => item.id));
-  const sections = editorialSections(remaining.filter((item) => !compactIds.has(item.id)));
-  return { lead, secondary, briefs, compact, sections, navigation: editorialSections(inventory) };
+  const sections2 = editorialSections(remaining.filter((item) => !compactIds.has(item.id)));
+  return { lead, secondary, briefs, compact, sections: sections2, navigation: editorialSections(inventory) };
 }
 function displayHeadline(article, selection = {}) {
   return selection.stories?.[article.slug]?.display_title?.trim() || article.title;
@@ -432,6 +332,265 @@ function llmsText(publication, canonical) {
   ].join("\n");
 }
 
+// src/briefing.ts
+var LOCAL_BRIEFING_POLICY_VERSION = "1";
+var DAY = 864e5;
+var verifications = /* @__PURE__ */ new Set([
+  "unverified",
+  "community_submitted",
+  "officially_confirmed",
+  "independently_verified",
+  "disputed"
+]);
+var sections = /* @__PURE__ */ new Set(["important", "around_you", "people", "discover", "participate", "following"]);
+var overlaps = (a, b = []) => a.some((id) => id.trim() !== "" && b.includes(id));
+function timestamp(value) {
+  if (!/^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,3})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/.test(value) || !validCalendarDate(value.slice(0, 10))) return NaN;
+  return Date.parse(value);
+}
+function sourcesFor(candidate) {
+  const seen = /* @__PURE__ */ new Set();
+  return candidate.sources.flatMap((source) => {
+    const url = publicHttps(source.url);
+    if (!source.id.trim() || !source.publisher.trim() || !source.title.trim() || !url || seen.has(source.id)) return [];
+    seen.add(source.id);
+    return [{ id: source.id, url, title: source.title, publisher: source.publisher }];
+  });
+}
+function eligible(candidate, coverage, now) {
+  if (candidate.publication_status !== "published" || candidate.visibility !== "public" || candidate.editorial_approval !== "approved" || candidate.lifecycle !== "current" || !candidate.article.id.trim() || !candidate.article.slug.trim() || !candidate.article.title.trim() || !verifications.has(candidate.verification) || !sections.has(candidate.section) || !overlaps(candidate.geography_ids, coverage)) return false;
+  const published = timestamp(candidate.article.published_at);
+  const expiry = timestamp(candidate.relevant_until);
+  if (!Number.isFinite(published) || published > now || !Number.isFinite(expiry) || expiry <= now) return false;
+  const verified = candidate.last_verified_at === null ? null : timestamp(candidate.last_verified_at);
+  const review = candidate.review_due_at === null ? null : timestamp(candidate.review_due_at);
+  if (verified !== null && (!Number.isFinite(verified) || verified > now)) return false;
+  if (review !== null && (!Number.isFinite(review) || review <= now || verified !== null && review <= verified)) return false;
+  const confirmed = candidate.verification === "officially_confirmed" || candidate.verification === "independently_verified";
+  return !confirmed || verified !== null && review !== null && sourcesFor(candidate).length > 0;
+}
+function projectionKey(candidate) {
+  const article = candidate.article;
+  return JSON.stringify([
+    article.id,
+    article.slug,
+    article.title,
+    article.excerpt,
+    article.published_at,
+    article.author_name,
+    publicHttps(article.canonical_url),
+    [...candidate.geography_ids].sort(),
+    [...candidate.topic_ids].sort(),
+    [...candidate.entity_ids].sort(),
+    [...candidate.issue_ids].sort(),
+    candidate.section,
+    candidate.civic_importance,
+    candidate.practical_value,
+    candidate.discovery_value,
+    candidate.why_it_matters,
+    candidate.relevant_until,
+    candidate.verification,
+    candidate.last_verified_at,
+    candidate.review_due_at,
+    sourcesFor(candidate).sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0)
+  ]);
+}
+function composeLocalBriefing(candidates, options) {
+  const now = options.now ?? Date.now();
+  const limit = options.limit ?? 6;
+  if (!options.sm_application_id.trim() || !options.publication_id.trim() || !Number.isFinite(now) || !Number.isFinite(new Date(now).getTime()) || !Number.isInteger(limit) || limit < 1 || limit > 12) {
+    throw new RangeError("A briefing requires application/publication scope, a valid time and a limit from 1 to 12");
+  }
+  const preferences = options.personalized === false ? {} : options.preferences ?? {};
+  const personalized = [preferences.community_ids, preferences.topic_ids, preferences.entity_ids, preferences.issue_ids].some((ids) => ids?.some((id) => id.trim() !== ""));
+  const newest = /* @__PURE__ */ new Map();
+  for (const candidate of candidates) {
+    if (candidate.sm_application_id !== options.sm_application_id || candidate.publication_id !== options.publication_id || !candidate.canonical_key.trim() || !Number.isSafeInteger(candidate.revision) || candidate.revision < 1) continue;
+    const group = newest.get(candidate.canonical_key);
+    if (!group || candidate.revision > group[0].revision) newest.set(candidate.canonical_key, [candidate]);
+    else if (candidate.revision === group[0].revision) group.push(candidate);
+  }
+  const ranked = [];
+  for (const group of newest.values()) {
+    if (group.some((candidate2) => !eligible(candidate2, options.coverage_area_ids, now))) continue;
+    const candidate = group[0];
+    if (group.length > 1 && group.some((copy) => projectionKey(copy) !== projectionKey(candidate))) continue;
+    const summary = candidate.article.excerpt?.trim() ?? "";
+    if (!summary || Array.from(summary).length > 280 || !/[.!?。！？][”’"']?$/u.test(summary)) continue;
+    const community = overlaps(candidate.geography_ids, preferences.community_ids);
+    const entity = overlaps(candidate.entity_ids, preferences.entity_ids);
+    const issue = overlaps(candidate.issue_ids, preferences.issue_ids);
+    const topic = overlaps(candidate.topic_ids, preferences.topic_ids);
+    const published = timestamp(candidate.article.published_at);
+    const age = now - published;
+    const important = candidate.civic_importance === "important";
+    const relevance = {
+      geographic: community ? 2 : 1,
+      practical: candidate.practical_value ? 1 : 0,
+      relationship: entity || issue ? 1 : 0,
+      interest: topic ? 1 : 0,
+      temporal: age < DAY ? 2 : age < 7 * DAY ? 1 : 0,
+      civic: important ? 1 : 0,
+      discovery: candidate.discovery_value ? 1 : 0
+    };
+    const reasons = [];
+    if (important) reasons.push("important_civic_information");
+    reasons.push(community ? "selected_community" : "publication_coverage");
+    if (candidate.practical_value) reasons.push("practical_value");
+    if (entity) reasons.push("following_entity");
+    if (issue) reasons.push("following_issue");
+    if (topic) reasons.push("selected_topic");
+    if (relevance.temporal > 0) reasons.push("recent_reporting");
+    if (candidate.discovery_value) reasons.push("local_discovery");
+    const article = candidate.article;
+    const item = {
+      canonical_key: candidate.canonical_key,
+      revision: candidate.revision,
+      article: {
+        id: article.id,
+        slug: article.slug,
+        title: article.title,
+        published_at: article.published_at,
+        author_name: article.author_name,
+        canonical_url: publicHttps(article.canonical_url) ?? null
+      },
+      summary,
+      section: important ? "important" : entity || issue ? "following" : candidate.section,
+      geography_ids: [...new Set(candidate.geography_ids)],
+      why_it_matters: candidate.why_it_matters?.trim() || void 0,
+      reasons,
+      relevance,
+      verification: candidate.verification,
+      freshness: candidate.last_verified_at !== null && candidate.review_due_at !== null ? "current" : "unknown",
+      last_verified_at: candidate.last_verified_at,
+      review_due_at: candidate.review_due_at,
+      relevant_until: candidate.relevant_until,
+      sources: sourcesFor(candidate)
+    };
+    const score = 4 * relevance.geographic + 3 * relevance.practical + 3 * relevance.relationship + 2 * relevance.interest + relevance.temporal + relevance.discovery;
+    ranked.push({ item, score, published, important });
+  }
+  ranked.sort((a, b) => Number(b.important) - Number(a.important) || b.score - a.score || b.published - a.published || (a.item.canonical_key < b.item.canonical_key ? -1 : a.item.canonical_key > b.item.canonical_key ? 1 : 0));
+  const seenArticles = /* @__PURE__ */ new Set();
+  const seenUrls = /* @__PURE__ */ new Set();
+  const deduplicated = ranked.filter(({ item }) => {
+    const url = item.article.canonical_url;
+    if (seenArticles.has(item.article.id) || url && seenUrls.has(url)) return false;
+    seenArticles.add(item.article.id);
+    if (url) seenUrls.add(url);
+    return true;
+  });
+  return {
+    schema_version: 1,
+    policy_version: LOCAL_BRIEFING_POLICY_VERSION,
+    publication_id: options.publication_id,
+    generated_at: new Date(now).toISOString(),
+    personalized,
+    items: deduplicated.slice(0, limit).map(({ item }) => item),
+    remaining_important_count: deduplicated.slice(limit).filter(({ important }) => important).length
+  };
+}
+
+// src/preset.ts
+var walnutCreekTimes = definePublication({
+  slug: "walnutcreektimes",
+  name: "Walnut Creek Times",
+  masthead: ["Walnut", "Creek", "Times"],
+  region: "Walnut Creek",
+  regionLabel: "Walnut Creek",
+  towns: ["Walnut Creek", "Rossmoor", "Saranap", "Pleasant Hill"],
+  nearbyTowns: ["Martinez", "Concord", "Contra Costa"],
+  sections: ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health"],
+  description: "Independent local journalism covering civic decisions, downtown commerce, neighborhood life, and community achievements across Walnut Creek, Rossmoor, Saranap, and Pleasant Hill.",
+  tagline: "Local stories. Stronger communities.",
+  layout: "broadsheet",
+  layouts: ["broadsheet"],
+  features: { smile: true, jobs: true, classifieds: true },
+  modules: { home: ["daily-smile"] }
+});
+
+// src/cache.ts
+var NEWS_CACHE = {
+  feedRevalidateSeconds: 30,
+  articleRevalidateSeconds: 60,
+  edgeMaxAgeSeconds: 60,
+  staleWhileRevalidateSeconds: 300,
+  feedTag: "news-feed",
+  articleTag: "news-article",
+  inventoryTag: "public-news-discovery-v2",
+  paths: ["/", "/news"]
+};
+var feedCacheOptions = {
+  revalidate: NEWS_CACHE.feedRevalidateSeconds,
+  tags: [NEWS_CACHE.feedTag]
+};
+var articleCacheOptions = {
+  revalidate: NEWS_CACHE.articleRevalidateSeconds,
+  tags: [NEWS_CACHE.articleTag]
+};
+var inventoryCacheOptions = {
+  revalidate: NEWS_CACHE.feedRevalidateSeconds,
+  tags: [NEWS_CACHE.feedTag, NEWS_CACHE.inventoryTag]
+};
+function edgeCacheControl() {
+  return `public, s-maxage=${NEWS_CACHE.edgeMaxAgeSeconds}, stale-while-revalidate=${NEWS_CACHE.staleWhileRevalidateSeconds}`;
+}
+function feedCacheKey(publicationId, before, section) {
+  return `${publicationId}:${before ?? ""}:${section ?? ""}`;
+}
+function articleCacheKey(publicationId, slug) {
+  return `${publicationId}:${slug}`;
+}
+var NewsError = class extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "NewsError";
+  }
+  status;
+};
+function shouldServeLastKnown(error) {
+  const status = error instanceof NewsError ? error.status : error && typeof error === "object" && "status" in error ? error.status : void 0;
+  return status !== 404;
+}
+async function withLastKnown(store, key, load, accept = () => true) {
+  try {
+    const value = await load();
+    if (accept(value)) store.set(key, value);
+    return value;
+  } catch (error) {
+    if (!shouldServeLastKnown(error)) throw error;
+    const cached = store.get(key);
+    if (cached) return cached;
+    throw error;
+  }
+}
+function secretsMatch(provided, secret) {
+  if (!provided || !secret) return false;
+  const left = Array.from(provided);
+  const right = Array.from(secret);
+  let mismatch = left.length === right.length ? 0 : 1;
+  const length = Math.max(left.length, right.length);
+  for (let index = 0; index < length; index += 1) {
+    mismatch |= (left[index]?.codePointAt(0) ?? 0) ^ (right[index]?.codePointAt(0) ?? 0);
+  }
+  return mismatch === 0;
+}
+function revalidateDecision(input) {
+  if (!secretsMatch(input.providedSecret, input.configuredSecret)) {
+    return { status: 401, body: { error: "Unauthorized" } };
+  }
+  const tag = input.tag?.trim() || `${NEWS_CACHE.feedTag}, ${NEWS_CACHE.articleTag}`;
+  const path = input.path?.trim() || NEWS_CACHE.paths.join(", ");
+  return { status: 200, body: { revalidated: true, tag, path, now: input.now ?? Date.now() } };
+}
+function defaultRevalidateTargets() {
+  return {
+    tags: [NEWS_CACHE.feedTag, NEWS_CACHE.articleTag, NEWS_CACHE.inventoryTag],
+    paths: [...NEWS_CACHE.paths]
+  };
+}
+
 // src/analytics.ts
 var ANALYTICS_VERSION = 1;
 var ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -3174,6 +3333,7 @@ exports.EVENTS = EVENTS;
 exports.FEATURE_NAMES = FEATURE_NAMES;
 exports.JOB_EMPLOYMENT_TYPES = JOB_EMPLOYMENT_TYPES;
 exports.LAYOUT_COOKIE = LAYOUT_COOKIE;
+exports.LOCAL_BRIEFING_POLICY_VERSION = LOCAL_BRIEFING_POLICY_VERSION;
 exports.LocalNetworkBar = LocalNetworkBar;
 exports.MEET_ACTIVITIES = MEET_ACTIVITIES;
 exports.NETWORK_PARENT = NETWORK_PARENT;
@@ -3210,6 +3370,7 @@ exports.clipChars = clipChars;
 exports.communityMapEmbeds = communityMapEmbeds;
 exports.communityPublications = communityPublications;
 exports.composeEdition = composeEdition;
+exports.composeLocalBriefing = composeLocalBriefing;
 exports.dealDollars = dealDollars;
 exports.dealGoPath = dealGoPath;
 exports.dealsFeedPath = dealsFeedPath;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, b as NearbyUpdate, c as NewsItem, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-DFDCZHbS.cjs';
-export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-DFDCZHbS.cjs';
+import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-BJFCWWi0.cjs';
+export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-BJFCWWi0.cjs';
 export { M as MEET_ACTIVITIES, b as MeetActivity, c as MeetupInput, a as PreparedMeetup, P as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-RWmfj3I3.cjs';
 export { b as CLASSIFIED_CATEGORIES, c as ClassifiedCategory, C as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, d as PreparedClassified, e as PreparedJob, P as PublicDeal, f as PublicDealOffer, a as PublicJob, g as categoryLabel, h as classifiedPath, i as classifiedSearchPath, j as clipChars, k as dealDollars, l as dealGoPath, m as dealsFeedPath, n as employmentLabel, o as isClassifiedCategory, p as isEmploymentType, q as jobEmployerBody, r as jobOpeningBody, s as jobPostingBody, t as prepareClassified, u as prepareJobPost, v as publicJobPath, w as publicJobsPath } from './marketplace-29i5w4LS.cjs';
-export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-C0IGpt-B.cjs';
+export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-Dx4Lv-lB.cjs';
 import { CookieCategoryDefinition, CookieConsentRecord } from '@scalemule/compliance';
 export { COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, CookieCategory, CookieCategoryDefinition, CookieConsentRecord, CookieDisclosure, CookiePreferences, 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, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from '@scalemule/compliance';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.cjs';
@@ -32,6 +32,112 @@ declare const LAYOUT_COOKIE = "news_publication_layout";
  */
 declare function resolveLayout(publication: NewsPublication, cookieValue?: string | null): string;
 
+declare const LOCAL_BRIEFING_POLICY_VERSION = "1";
+type BriefingVerification = "unverified" | "community_submitted" | "officially_confirmed" | "independently_verified" | "disputed";
+type BriefingSection = "important" | "around_you" | "people" | "discover" | "participate" | "following";
+/** Public evidence links only. Artifact URLs and private reporter notes do not belong here. */
+interface BriefingSource {
+    id: string;
+    url: string;
+    title: string;
+    publisher: string;
+}
+/** Explicit choices only; no inferred demographics, relationships or reading history. */
+interface BriefingPreferences {
+    community_ids?: readonly string[];
+    topic_ids?: readonly string[];
+    entity_ids?: readonly string[];
+    issue_ids?: readonly string[];
+}
+/**
+ * A server-authorized projection, not a new canonical record or submission API.
+ * Article-backed presentation only: BaseNews records need not have an article.
+ * Eligibility here must never gate existing publication or community workflows.
+ * The producer must resolve grants, evidence rights and geographic relationships.
+ * Keep withdrawn/superseded revisions in the input to suppress older copies.
+ */
+interface BriefingCandidate {
+    sm_application_id: string;
+    publication_id: string;
+    /** Namespaced existing development/occurrence/reporting ID, never an issue-wide ID. */
+    canonical_key: string;
+    revision: number;
+    article: NewsItem;
+    publication_status: "published" | "draft";
+    visibility: "public" | "private";
+    editorial_approval: "approved" | "pending";
+    lifecycle: "current" | "superseded" | "withdrawn";
+    /** Resolved public area IDs, including applicable containing areas. No coordinates. */
+    geography_ids: readonly string[];
+    topic_ids: readonly string[];
+    entity_ids: readonly string[];
+    issue_ids: readonly string[];
+    section: BriefingSection;
+    /** Editorial assignments, never inferred from emotional language or click rates. */
+    civic_importance: "routine" | "important";
+    practical_value: boolean;
+    discovery_value: boolean;
+    why_it_matters?: string;
+    /** Required editorial relevance expiry; article publication time is not event time. */
+    relevant_until: string;
+    verification: BriefingVerification;
+    last_verified_at: string | null;
+    review_due_at: string | null;
+    sources: readonly BriefingSource[];
+}
+type BriefingReason = "important_civic_information" | "selected_community" | "publication_coverage" | "practical_value" | "following_entity" | "following_issue" | "selected_topic" | "recent_reporting" | "local_discovery";
+interface LocalBriefingOptions {
+    sm_application_id: string;
+    publication_id: string;
+    coverage_area_ids: readonly string[];
+    preferences?: BriefingPreferences;
+    personalized?: boolean;
+    /** Maximum, never a quota. Between 1 and 12, default 6. */
+    limit?: number;
+    now?: number;
+}
+interface LocalBriefingItem {
+    canonical_key: string;
+    revision: number;
+    article: Pick<NewsItem, "id" | "slug" | "title" | "published_at" | "author_name" | "canonical_url">;
+    summary: string;
+    section: BriefingSection;
+    geography_ids: string[];
+    why_it_matters?: string;
+    reasons: BriefingReason[];
+    relevance: {
+        geographic: number;
+        practical: number;
+        relationship: number;
+        interest: number;
+        temporal: number;
+        civic: number;
+        discovery: number;
+    };
+    verification: BriefingVerification;
+    freshness: "current" | "unknown";
+    last_verified_at: string | null;
+    review_due_at: string | null;
+    relevant_until: string;
+    sources: BriefingSource[];
+}
+interface LocalBriefing {
+    schema_version: 1;
+    policy_version: typeof LOCAL_BRIEFING_POLICY_VERSION;
+    publication_id: string;
+    generated_at: string;
+    personalized: boolean;
+    items: LocalBriefingItem[];
+    /** Consumers must keep a visible route to important coverage beyond the brief. */
+    remaining_important_count: number;
+}
+/**
+ * Opt-in, deterministic presentation of existing public records. This does not
+ * authenticate callers, fetch evidence, verify claims, persist preferences or
+ * publish anything. Never pass raw user submissions as authorized candidates.
+ */
+declare function composeLocalBriefing(candidates: readonly BriefingCandidate[], options: LocalBriefingOptions): LocalBriefing;
+
 /**
  * Walnut Creek Times, the reference paper.
  * Other papers call `definePublication` with their own name, towns, and flags.
@@ -367,4 +473,4 @@ 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, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, type ListeningArticle, 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, 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 };
+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 };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, b as NearbyUpdate, c as NewsItem, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-DFDCZHbS.js';
-export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-DFDCZHbS.js';
+import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-BJFCWWi0.js';
+export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-BJFCWWi0.js';
 export { M as MEET_ACTIVITIES, b as MeetActivity, c as MeetupInput, a as PreparedMeetup, P as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-RWmfj3I3.js';
 export { b as CLASSIFIED_CATEGORIES, c as ClassifiedCategory, C as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, d as PreparedClassified, e as PreparedJob, P as PublicDeal, f as PublicDealOffer, a as PublicJob, g as categoryLabel, h as classifiedPath, i as classifiedSearchPath, j as clipChars, k as dealDollars, l as dealGoPath, m as dealsFeedPath, n as employmentLabel, o as isClassifiedCategory, p as isEmploymentType, q as jobEmployerBody, r as jobOpeningBody, s as jobPostingBody, t as prepareClassified, u as prepareJobPost, v as publicJobPath, w as publicJobsPath } from './marketplace-29i5w4LS.js';
-export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-CxuyMF39.js';
+export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-DmRw8G_B.js';
 import { CookieCategoryDefinition, CookieConsentRecord } from '@scalemule/compliance';
 export { COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, CookieCategory, CookieCategoryDefinition, CookieConsentRecord, CookieDisclosure, CookiePreferences, 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, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from '@scalemule/compliance';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.js';
@@ -32,6 +32,112 @@ declare const LAYOUT_COOKIE = "news_publication_layout";
  */
 declare function resolveLayout(publication: NewsPublication, cookieValue?: string | null): string;
 
+declare const LOCAL_BRIEFING_POLICY_VERSION = "1";
+type BriefingVerification = "unverified" | "community_submitted" | "officially_confirmed" | "independently_verified" | "disputed";
+type BriefingSection = "important" | "around_you" | "people" | "discover" | "participate" | "following";
+/** Public evidence links only. Artifact URLs and private reporter notes do not belong here. */
+interface BriefingSource {
+    id: string;
+    url: string;
+    title: string;
+    publisher: string;
+}
+/** Explicit choices only; no inferred demographics, relationships or reading history. */
+interface BriefingPreferences {
+    community_ids?: readonly string[];
+    topic_ids?: readonly string[];
+    entity_ids?: readonly string[];
+    issue_ids?: readonly string[];
+}
+/**
+ * A server-authorized projection, not a new canonical record or submission API.
+ * Article-backed presentation only: BaseNews records need not have an article.
+ * Eligibility here must never gate existing publication or community workflows.
+ * The producer must resolve grants, evidence rights and geographic relationships.
+ * Keep withdrawn/superseded revisions in the input to suppress older copies.
+ */
+interface BriefingCandidate {
+    sm_application_id: string;
+    publication_id: string;
+    /** Namespaced existing development/occurrence/reporting ID, never an issue-wide ID. */
+    canonical_key: string;
+    revision: number;
+    article: NewsItem;
+    publication_status: "published" | "draft";
+    visibility: "public" | "private";
+    editorial_approval: "approved" | "pending";
+    lifecycle: "current" | "superseded" | "withdrawn";
+    /** Resolved public area IDs, including applicable containing areas. No coordinates. */
+    geography_ids: readonly string[];
+    topic_ids: readonly string[];
+    entity_ids: readonly string[];
+    issue_ids: readonly string[];
+    section: BriefingSection;
+    /** Editorial assignments, never inferred from emotional language or click rates. */
+    civic_importance: "routine" | "important";
+    practical_value: boolean;
+    discovery_value: boolean;
+    why_it_matters?: string;
+    /** Required editorial relevance expiry; article publication time is not event time. */
+    relevant_until: string;
+    verification: BriefingVerification;
+    last_verified_at: string | null;
+    review_due_at: string | null;
+    sources: readonly BriefingSource[];
+}
+type BriefingReason = "important_civic_information" | "selected_community" | "publication_coverage" | "practical_value" | "following_entity" | "following_issue" | "selected_topic" | "recent_reporting" | "local_discovery";
+interface LocalBriefingOptions {
+    sm_application_id: string;
+    publication_id: string;
+    coverage_area_ids: readonly string[];
+    preferences?: BriefingPreferences;
+    personalized?: boolean;
+    /** Maximum, never a quota. Between 1 and 12, default 6. */
+    limit?: number;
+    now?: number;
+}
+interface LocalBriefingItem {
+    canonical_key: string;
+    revision: number;
+    article: Pick<NewsItem, "id" | "slug" | "title" | "published_at" | "author_name" | "canonical_url">;
+    summary: string;
+    section: BriefingSection;
+    geography_ids: string[];
+    why_it_matters?: string;
+    reasons: BriefingReason[];
+    relevance: {
+        geographic: number;
+        practical: number;
+        relationship: number;
+        interest: number;
+        temporal: number;
+        civic: number;
+        discovery: number;
+    };
+    verification: BriefingVerification;
+    freshness: "current" | "unknown";
+    last_verified_at: string | null;
+    review_due_at: string | null;
+    relevant_until: string;
+    sources: BriefingSource[];
+}
+interface LocalBriefing {
+    schema_version: 1;
+    policy_version: typeof LOCAL_BRIEFING_POLICY_VERSION;
+    publication_id: string;
+    generated_at: string;
+    personalized: boolean;
+    items: LocalBriefingItem[];
+    /** Consumers must keep a visible route to important coverage beyond the brief. */
+    remaining_important_count: number;
+}
+/**
+ * Opt-in, deterministic presentation of existing public records. This does not
+ * authenticate callers, fetch evidence, verify claims, persist preferences or
+ * publish anything. Never pass raw user submissions as authorized candidates.
+ */
+declare function composeLocalBriefing(candidates: readonly BriefingCandidate[], options: LocalBriefingOptions): LocalBriefing;
+
 /**
  * Walnut Creek Times, the reference paper.
  * Other papers call `definePublication` with their own name, towns, and flags.
@@ -367,4 +473,4 @@ 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, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, type ListeningArticle, 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, 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 };
+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 };

package/dist/index.js

@@ -14,106 +14,6 @@ export { CLASSIFIED_CATEGORIES, JOB_EMPLOYMENT_TYPES, categoryLabel, classifiedP
 export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup, screenMessage } from './chunk-GB36YM56.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
-// src/preset.ts
-var walnutCreekTimes = definePublication({
-  slug: "walnutcreektimes",
-  name: "Walnut Creek Times",
-  masthead: ["Walnut", "Creek", "Times"],
-  region: "Walnut Creek",
-  regionLabel: "Walnut Creek",
-  towns: ["Walnut Creek", "Rossmoor", "Saranap", "Pleasant Hill"],
-  nearbyTowns: ["Martinez", "Concord", "Contra Costa"],
-  sections: ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health"],
-  description: "Independent local journalism covering civic decisions, downtown commerce, neighborhood life, and community achievements across Walnut Creek, Rossmoor, Saranap, and Pleasant Hill.",
-  tagline: "Local stories. Stronger communities.",
-  layout: "broadsheet",
-  layouts: ["broadsheet"],
-  features: { smile: true, jobs: true, classifieds: true },
-  modules: { home: ["daily-smile"] }
-});
-
-// src/cache.ts
-var NEWS_CACHE = {
-  feedRevalidateSeconds: 30,
-  articleRevalidateSeconds: 60,
-  edgeMaxAgeSeconds: 60,
-  staleWhileRevalidateSeconds: 300,
-  feedTag: "news-feed",
-  articleTag: "news-article",
-  inventoryTag: "public-news-discovery-v2",
-  paths: ["/", "/news"]
-};
-var feedCacheOptions = {
-  revalidate: NEWS_CACHE.feedRevalidateSeconds,
-  tags: [NEWS_CACHE.feedTag]
-};
-var articleCacheOptions = {
-  revalidate: NEWS_CACHE.articleRevalidateSeconds,
-  tags: [NEWS_CACHE.articleTag]
-};
-var inventoryCacheOptions = {
-  revalidate: NEWS_CACHE.feedRevalidateSeconds,
-  tags: [NEWS_CACHE.feedTag, NEWS_CACHE.inventoryTag]
-};
-function edgeCacheControl() {
-  return `public, s-maxage=${NEWS_CACHE.edgeMaxAgeSeconds}, stale-while-revalidate=${NEWS_CACHE.staleWhileRevalidateSeconds}`;
-}
-function feedCacheKey(publicationId, before, section) {
-  return `${publicationId}:${before ?? ""}:${section ?? ""}`;
-}
-function articleCacheKey(publicationId, slug) {
-  return `${publicationId}:${slug}`;
-}
-var NewsError = class extends Error {
-  constructor(status, message) {
-    super(message);
-    this.status = status;
-    this.name = "NewsError";
-  }
-  status;
-};
-function shouldServeLastKnown(error) {
-  const status = error instanceof NewsError ? error.status : error && typeof error === "object" && "status" in error ? error.status : void 0;
-  return status !== 404;
-}
-async function withLastKnown(store, key, load, accept = () => true) {
-  try {
-    const value = await load();
-    if (accept(value)) store.set(key, value);
-    return value;
-  } catch (error) {
-    if (!shouldServeLastKnown(error)) throw error;
-    const cached = store.get(key);
-    if (cached) return cached;
-    throw error;
-  }
-}
-function secretsMatch(provided, secret) {
-  if (!provided || !secret) return false;
-  const left = Array.from(provided);
-  const right = Array.from(secret);
-  let mismatch = left.length === right.length ? 0 : 1;
-  const length = Math.max(left.length, right.length);
-  for (let index = 0; index < length; index += 1) {
-    mismatch |= (left[index]?.codePointAt(0) ?? 0) ^ (right[index]?.codePointAt(0) ?? 0);
-  }
-  return mismatch === 0;
-}
-function revalidateDecision(input) {
-  if (!secretsMatch(input.providedSecret, input.configuredSecret)) {
-    return { status: 401, body: { error: "Unauthorized" } };
-  }
-  const tag = input.tag?.trim() || `${NEWS_CACHE.feedTag}, ${NEWS_CACHE.articleTag}`;
-  const path = input.path?.trim() || NEWS_CACHE.paths.join(", ");
-  return { status: 200, body: { revalidated: true, tag, path, now: input.now ?? Date.now() } };
-}
-function defaultRevalidateTargets() {
-  return {
-    tags: [NEWS_CACHE.feedTag, NEWS_CACHE.articleTag, NEWS_CACHE.inventoryTag],
-    paths: [...NEWS_CACHE.paths]
-  };
-}
-
 // src/editorial.ts
 var labels = {
   "Local businesses": "Business",
@@ -131,8 +31,8 @@ var EDITORIAL_SECTION_ORDER = [
   "Schools",
   "Opinion"
 ];
-function orderedSections(sections, order = EDITORIAL_SECTION_ORDER) {
-  return sections.filter((section) => section.name !== "Local news").slice().sort((left, right) => {
+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);
     const rightRank = order.indexOf(right.name);
     const leftOrder = leftRank === -1 ? order.length : leftRank;
@@ -193,12 +93,12 @@ function composeEdition(items, selection = {}, now = Date.now()) {
     secondary.push(deferredWithDuplicateImage.shift());
   }
   for (const item of secondary) remaining.splice(remaining.indexOf(item), 1);
-  const eligible = remaining.filter((item) => {
+  const eligible2 = remaining.filter((item) => {
     const age = now - Date.parse(item.published_at);
     return item.excerpt?.trim() && age >= 0 && age <= 7 * 864e5;
   });
-  const selected = (pins.brief_slugs ?? []).flatMap((slug) => eligible.find((item) => item.slug === slug) ?? []);
-  const candidates = [...selected, ...editorialSections(eligible).map((group) => group.items[0]), ...eligible];
+  const selected = (pins.brief_slugs ?? []).flatMap((slug) => eligible2.find((item) => item.slug === slug) ?? []);
+  const candidates = [...selected, ...editorialSections(eligible2).map((group) => group.items[0]), ...eligible2];
   const briefIds = /* @__PURE__ */ new Set();
   const briefs = candidates.filter((item) => {
     if (!item || briefIds.has(item.id) || briefIds.size >= 4) return false;
@@ -207,8 +107,8 @@ function composeEdition(items, selection = {}, now = Date.now()) {
   });
   const compact = [...briefs, ...remaining.filter((item) => !briefIds.has(item.id))].slice(0, 4);
   const compactIds = new Set(compact.map((item) => item.id));
-  const sections = editorialSections(remaining.filter((item) => !compactIds.has(item.id)));
-  return { lead, secondary, briefs, compact, sections, navigation: editorialSections(inventory) };
+  const sections2 = editorialSections(remaining.filter((item) => !compactIds.has(item.id)));
+  return { lead, secondary, briefs, compact, sections: sections2, navigation: editorialSections(inventory) };
 }
 function displayHeadline(article, selection = {}) {
   return selection.stories?.[article.slug]?.display_title?.trim() || article.title;
@@ -373,6 +273,265 @@ function llmsText(publication, canonical) {
   ].join("\n");
 }
 
+// src/briefing.ts
+var LOCAL_BRIEFING_POLICY_VERSION = "1";
+var DAY = 864e5;
+var verifications = /* @__PURE__ */ new Set([
+  "unverified",
+  "community_submitted",
+  "officially_confirmed",
+  "independently_verified",
+  "disputed"
+]);
+var sections = /* @__PURE__ */ new Set(["important", "around_you", "people", "discover", "participate", "following"]);
+var overlaps = (a, b = []) => a.some((id) => id.trim() !== "" && b.includes(id));
+function timestamp(value) {
+  if (!/^\d{4}-\d{2}-\d{2}T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,3})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/.test(value) || !validCalendarDate(value.slice(0, 10))) return NaN;
+  return Date.parse(value);
+}
+function sourcesFor(candidate) {
+  const seen = /* @__PURE__ */ new Set();
+  return candidate.sources.flatMap((source) => {
+    const url = publicHttps(source.url);
+    if (!source.id.trim() || !source.publisher.trim() || !source.title.trim() || !url || seen.has(source.id)) return [];
+    seen.add(source.id);
+    return [{ id: source.id, url, title: source.title, publisher: source.publisher }];
+  });
+}
+function eligible(candidate, coverage, now) {
+  if (candidate.publication_status !== "published" || candidate.visibility !== "public" || candidate.editorial_approval !== "approved" || candidate.lifecycle !== "current" || !candidate.article.id.trim() || !candidate.article.slug.trim() || !candidate.article.title.trim() || !verifications.has(candidate.verification) || !sections.has(candidate.section) || !overlaps(candidate.geography_ids, coverage)) return false;
+  const published = timestamp(candidate.article.published_at);
+  const expiry = timestamp(candidate.relevant_until);
+  if (!Number.isFinite(published) || published > now || !Number.isFinite(expiry) || expiry <= now) return false;
+  const verified = candidate.last_verified_at === null ? null : timestamp(candidate.last_verified_at);
+  const review = candidate.review_due_at === null ? null : timestamp(candidate.review_due_at);
+  if (verified !== null && (!Number.isFinite(verified) || verified > now)) return false;
+  if (review !== null && (!Number.isFinite(review) || review <= now || verified !== null && review <= verified)) return false;
+  const confirmed = candidate.verification === "officially_confirmed" || candidate.verification === "independently_verified";
+  return !confirmed || verified !== null && review !== null && sourcesFor(candidate).length > 0;
+}
+function projectionKey(candidate) {
+  const article = candidate.article;
+  return JSON.stringify([
+    article.id,
+    article.slug,
+    article.title,
+    article.excerpt,
+    article.published_at,
+    article.author_name,
+    publicHttps(article.canonical_url),
+    [...candidate.geography_ids].sort(),
+    [...candidate.topic_ids].sort(),
+    [...candidate.entity_ids].sort(),
+    [...candidate.issue_ids].sort(),
+    candidate.section,
+    candidate.civic_importance,
+    candidate.practical_value,
+    candidate.discovery_value,
+    candidate.why_it_matters,
+    candidate.relevant_until,
+    candidate.verification,
+    candidate.last_verified_at,
+    candidate.review_due_at,
+    sourcesFor(candidate).sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0)
+  ]);
+}
+function composeLocalBriefing(candidates, options) {
+  const now = options.now ?? Date.now();
+  const limit = options.limit ?? 6;
+  if (!options.sm_application_id.trim() || !options.publication_id.trim() || !Number.isFinite(now) || !Number.isFinite(new Date(now).getTime()) || !Number.isInteger(limit) || limit < 1 || limit > 12) {
+    throw new RangeError("A briefing requires application/publication scope, a valid time and a limit from 1 to 12");
+  }
+  const preferences = options.personalized === false ? {} : options.preferences ?? {};
+  const personalized = [preferences.community_ids, preferences.topic_ids, preferences.entity_ids, preferences.issue_ids].some((ids) => ids?.some((id) => id.trim() !== ""));
+  const newest = /* @__PURE__ */ new Map();
+  for (const candidate of candidates) {
+    if (candidate.sm_application_id !== options.sm_application_id || candidate.publication_id !== options.publication_id || !candidate.canonical_key.trim() || !Number.isSafeInteger(candidate.revision) || candidate.revision < 1) continue;
+    const group = newest.get(candidate.canonical_key);
+    if (!group || candidate.revision > group[0].revision) newest.set(candidate.canonical_key, [candidate]);
+    else if (candidate.revision === group[0].revision) group.push(candidate);
+  }
+  const ranked = [];
+  for (const group of newest.values()) {
+    if (group.some((candidate2) => !eligible(candidate2, options.coverage_area_ids, now))) continue;
+    const candidate = group[0];
+    if (group.length > 1 && group.some((copy) => projectionKey(copy) !== projectionKey(candidate))) continue;
+    const summary = candidate.article.excerpt?.trim() ?? "";
+    if (!summary || Array.from(summary).length > 280 || !/[.!?。！？][”’"']?$/u.test(summary)) continue;
+    const community = overlaps(candidate.geography_ids, preferences.community_ids);
+    const entity = overlaps(candidate.entity_ids, preferences.entity_ids);
+    const issue = overlaps(candidate.issue_ids, preferences.issue_ids);
+    const topic = overlaps(candidate.topic_ids, preferences.topic_ids);
+    const published = timestamp(candidate.article.published_at);
+    const age = now - published;
+    const important = candidate.civic_importance === "important";
+    const relevance = {
+      geographic: community ? 2 : 1,
+      practical: candidate.practical_value ? 1 : 0,
+      relationship: entity || issue ? 1 : 0,
+      interest: topic ? 1 : 0,
+      temporal: age < DAY ? 2 : age < 7 * DAY ? 1 : 0,
+      civic: important ? 1 : 0,
+      discovery: candidate.discovery_value ? 1 : 0
+    };
+    const reasons = [];
+    if (important) reasons.push("important_civic_information");
+    reasons.push(community ? "selected_community" : "publication_coverage");
+    if (candidate.practical_value) reasons.push("practical_value");
+    if (entity) reasons.push("following_entity");
+    if (issue) reasons.push("following_issue");
+    if (topic) reasons.push("selected_topic");
+    if (relevance.temporal > 0) reasons.push("recent_reporting");
+    if (candidate.discovery_value) reasons.push("local_discovery");
+    const article = candidate.article;
+    const item = {
+      canonical_key: candidate.canonical_key,
+      revision: candidate.revision,
+      article: {
+        id: article.id,
+        slug: article.slug,
+        title: article.title,
+        published_at: article.published_at,
+        author_name: article.author_name,
+        canonical_url: publicHttps(article.canonical_url) ?? null
+      },
+      summary,
+      section: important ? "important" : entity || issue ? "following" : candidate.section,
+      geography_ids: [...new Set(candidate.geography_ids)],
+      why_it_matters: candidate.why_it_matters?.trim() || void 0,
+      reasons,
+      relevance,
+      verification: candidate.verification,
+      freshness: candidate.last_verified_at !== null && candidate.review_due_at !== null ? "current" : "unknown",
+      last_verified_at: candidate.last_verified_at,
+      review_due_at: candidate.review_due_at,
+      relevant_until: candidate.relevant_until,
+      sources: sourcesFor(candidate)
+    };
+    const score = 4 * relevance.geographic + 3 * relevance.practical + 3 * relevance.relationship + 2 * relevance.interest + relevance.temporal + relevance.discovery;
+    ranked.push({ item, score, published, important });
+  }
+  ranked.sort((a, b) => Number(b.important) - Number(a.important) || b.score - a.score || b.published - a.published || (a.item.canonical_key < b.item.canonical_key ? -1 : a.item.canonical_key > b.item.canonical_key ? 1 : 0));
+  const seenArticles = /* @__PURE__ */ new Set();
+  const seenUrls = /* @__PURE__ */ new Set();
+  const deduplicated = ranked.filter(({ item }) => {
+    const url = item.article.canonical_url;
+    if (seenArticles.has(item.article.id) || url && seenUrls.has(url)) return false;
+    seenArticles.add(item.article.id);
+    if (url) seenUrls.add(url);
+    return true;
+  });
+  return {
+    schema_version: 1,
+    policy_version: LOCAL_BRIEFING_POLICY_VERSION,
+    publication_id: options.publication_id,
+    generated_at: new Date(now).toISOString(),
+    personalized,
+    items: deduplicated.slice(0, limit).map(({ item }) => item),
+    remaining_important_count: deduplicated.slice(limit).filter(({ important }) => important).length
+  };
+}
+
+// src/preset.ts
+var walnutCreekTimes = definePublication({
+  slug: "walnutcreektimes",
+  name: "Walnut Creek Times",
+  masthead: ["Walnut", "Creek", "Times"],
+  region: "Walnut Creek",
+  regionLabel: "Walnut Creek",
+  towns: ["Walnut Creek", "Rossmoor", "Saranap", "Pleasant Hill"],
+  nearbyTowns: ["Martinez", "Concord", "Contra Costa"],
+  sections: ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health"],
+  description: "Independent local journalism covering civic decisions, downtown commerce, neighborhood life, and community achievements across Walnut Creek, Rossmoor, Saranap, and Pleasant Hill.",
+  tagline: "Local stories. Stronger communities.",
+  layout: "broadsheet",
+  layouts: ["broadsheet"],
+  features: { smile: true, jobs: true, classifieds: true },
+  modules: { home: ["daily-smile"] }
+});
+
+// src/cache.ts
+var NEWS_CACHE = {
+  feedRevalidateSeconds: 30,
+  articleRevalidateSeconds: 60,
+  edgeMaxAgeSeconds: 60,
+  staleWhileRevalidateSeconds: 300,
+  feedTag: "news-feed",
+  articleTag: "news-article",
+  inventoryTag: "public-news-discovery-v2",
+  paths: ["/", "/news"]
+};
+var feedCacheOptions = {
+  revalidate: NEWS_CACHE.feedRevalidateSeconds,
+  tags: [NEWS_CACHE.feedTag]
+};
+var articleCacheOptions = {
+  revalidate: NEWS_CACHE.articleRevalidateSeconds,
+  tags: [NEWS_CACHE.articleTag]
+};
+var inventoryCacheOptions = {
+  revalidate: NEWS_CACHE.feedRevalidateSeconds,
+  tags: [NEWS_CACHE.feedTag, NEWS_CACHE.inventoryTag]
+};
+function edgeCacheControl() {
+  return `public, s-maxage=${NEWS_CACHE.edgeMaxAgeSeconds}, stale-while-revalidate=${NEWS_CACHE.staleWhileRevalidateSeconds}`;
+}
+function feedCacheKey(publicationId, before, section) {
+  return `${publicationId}:${before ?? ""}:${section ?? ""}`;
+}
+function articleCacheKey(publicationId, slug) {
+  return `${publicationId}:${slug}`;
+}
+var NewsError = class extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "NewsError";
+  }
+  status;
+};
+function shouldServeLastKnown(error) {
+  const status = error instanceof NewsError ? error.status : error && typeof error === "object" && "status" in error ? error.status : void 0;
+  return status !== 404;
+}
+async function withLastKnown(store, key, load, accept = () => true) {
+  try {
+    const value = await load();
+    if (accept(value)) store.set(key, value);
+    return value;
+  } catch (error) {
+    if (!shouldServeLastKnown(error)) throw error;
+    const cached = store.get(key);
+    if (cached) return cached;
+    throw error;
+  }
+}
+function secretsMatch(provided, secret) {
+  if (!provided || !secret) return false;
+  const left = Array.from(provided);
+  const right = Array.from(secret);
+  let mismatch = left.length === right.length ? 0 : 1;
+  const length = Math.max(left.length, right.length);
+  for (let index = 0; index < length; index += 1) {
+    mismatch |= (left[index]?.codePointAt(0) ?? 0) ^ (right[index]?.codePointAt(0) ?? 0);
+  }
+  return mismatch === 0;
+}
+function revalidateDecision(input) {
+  if (!secretsMatch(input.providedSecret, input.configuredSecret)) {
+    return { status: 401, body: { error: "Unauthorized" } };
+  }
+  const tag = input.tag?.trim() || `${NEWS_CACHE.feedTag}, ${NEWS_CACHE.articleTag}`;
+  const path = input.path?.trim() || NEWS_CACHE.paths.join(", ");
+  return { status: 200, body: { revalidated: true, tag, path, now: input.now ?? Date.now() } };
+}
+function defaultRevalidateTargets() {
+  return {
+    tags: [NEWS_CACHE.feedTag, NEWS_CACHE.articleTag, NEWS_CACHE.inventoryTag],
+    paths: [...NEWS_CACHE.paths]
+  };
+}
+
 // src/analytics.ts
 var ANALYTICS_VERSION = 1;
 var ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -593,4 +752,4 @@ async function publicationListeningCandidates(items, read, publicationId, public
   return output.sort((a, b) => (b.publishedAt ?? "").localeCompare(a.publishedAt ?? ""));
 }
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, EDITORIAL_SECTION_ORDER, EVENTS, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, composeEdition, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, referralCode, resolveCoupon, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, EDITORIAL_SECTION_ORDER, EVENTS, LOCAL_BRIEFING_POLICY_VERSION, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, composeEdition, composeLocalBriefing, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, referralCode, resolveCoupon, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/{snapshot-CxuyMF39.d.ts → snapshot-DmRw8G_B.d.ts}

@@ -1,4 +1,4 @@
-import { P as PublicationInput, N as NewsPublication } from './types-DFDCZHbS.js';
+import { P as PublicationInput, N as NewsPublication } from './types-BJFCWWi0.js';
 
 /**
  * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)

package/dist/{snapshot-C0IGpt-B.d.cts → snapshot-Dx4Lv-lB.d.cts}

@@ -1,4 +1,4 @@
-import { P as PublicationInput, N as NewsPublication } from './types-DFDCZHbS.cjs';
+import { P as PublicationInput, N as NewsPublication } from './types-BJFCWWi0.cjs';
 
 /**
  * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)

package/dist/snapshot-file.d.cts

@@ -1,5 +1,5 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-C0IGpt-B.cjs';
-import './types-DFDCZHbS.cjs';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-Dx4Lv-lB.cjs';
+import './types-BJFCWWi0.cjs';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/snapshot-file.d.ts

@@ -1,5 +1,5 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-CxuyMF39.js';
-import './types-DFDCZHbS.js';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-DmRw8G_B.js';
+import './types-BJFCWWi0.js';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/{types-DFDCZHbS.d.cts → types-BJFCWWi0.d.cts}

@@ -238,4 +238,4 @@ type EditorialSection = {
     items: NewsItem[];
 };
 
-export { type ArticleCitation as A, type CouponOffer as C, type EditorialSection as E, type FeatureName as F, type HomepageSelection as H, type NewsPublication as N, type PublicationInput as P, type ReferralSettings as R, type StoryDisplay as S, type TagRef as T, type VerifiedCard as V, type PublicationTheme as a, type NearbyUpdate as b, type NewsItem as c, type NewsArticle as d, type CardType as e, type CategoryRef as f, type CouponSettings as g, type CoverImageMetadata as h, FEATURE_NAMES as i, type FeatureFlags as j, type NewsFeed as k, type NewsLayoutId as l, type PublicationModules as m, type VerifiedCardAction as n, type VerifiedCardFact as o, type VerifiedCardImage as p };
+export { type ArticleCitation as A, type CouponOffer as C, type EditorialSection as E, type FeatureName as F, type HomepageSelection as H, type NewsPublication as N, type PublicationInput as P, type ReferralSettings as R, type StoryDisplay as S, type TagRef as T, type VerifiedCard as V, type PublicationTheme as a, type NewsItem as b, type NearbyUpdate as c, type NewsArticle as d, type CardType as e, type CategoryRef as f, type CouponSettings as g, type CoverImageMetadata as h, FEATURE_NAMES as i, type FeatureFlags as j, type NewsFeed as k, type NewsLayoutId as l, type PublicationModules as m, type VerifiedCardAction as n, type VerifiedCardFact as o, type VerifiedCardImage as p };

package/dist/{types-DFDCZHbS.d.ts → types-BJFCWWi0.d.ts}

@@ -238,4 +238,4 @@ type EditorialSection = {
     items: NewsItem[];
 };
 
-export { type ArticleCitation as A, type CouponOffer as C, type EditorialSection as E, type FeatureName as F, type HomepageSelection as H, type NewsPublication as N, type PublicationInput as P, type ReferralSettings as R, type StoryDisplay as S, type TagRef as T, type VerifiedCard as V, type PublicationTheme as a, type NearbyUpdate as b, type NewsItem as c, type NewsArticle as d, type CardType as e, type CategoryRef as f, type CouponSettings as g, type CoverImageMetadata as h, FEATURE_NAMES as i, type FeatureFlags as j, type NewsFeed as k, type NewsLayoutId as l, type PublicationModules as m, type VerifiedCardAction as n, type VerifiedCardFact as o, type VerifiedCardImage as p };
+export { type ArticleCitation as A, type CouponOffer as C, type EditorialSection as E, type FeatureName as F, type HomepageSelection as H, type NewsPublication as N, type PublicationInput as P, type ReferralSettings as R, type StoryDisplay as S, type TagRef as T, type VerifiedCard as V, type PublicationTheme as a, type NewsItem as b, type NearbyUpdate as c, type NewsArticle as d, type CardType as e, type CategoryRef as f, type CouponSettings as g, type CoverImageMetadata as h, FEATURE_NAMES as i, type FeatureFlags as j, type NewsFeed as k, type NewsLayoutId as l, type PublicationModules as m, type VerifiedCardAction as n, type VerifiedCardFact as o, type VerifiedCardImage as p };

package/dist/verified-card.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { V as VerifiedCard } from './types-DFDCZHbS.cjs';
+import { V as VerifiedCard } from './types-BJFCWWi0.cjs';
 
 /**
  * Validate that an action link is safe for readers.

package/dist/verified-card.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { V as VerifiedCard } from './types-DFDCZHbS.js';
+import { V as VerifiedCard } from './types-BJFCWWi0.js';
 
 /**
  * Validate that an action link is safe for readers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "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",
@@ -109,7 +109,7 @@
     "story-review.css"
   ],
   "peerDependencies": {
-    "@scalemule/react": "0.0.20",
+    "@scalemule/react": "0.0.21",
     "react": ">=18.0.0"
   },
   "peerDependenciesMeta": {
@@ -129,7 +129,7 @@
     "prepublishOnly": "node -e \"const v=require('./package.json').version; if(!/^0\\.(0|1)\\.\\d+$/.test(v)){console.error('ERR: SDK '+v+' violates patch-only policy (0.0.x or 0.1.x only). See CONTRIBUTING.md SDK versioning section.');process.exit(1)}\" && npm run lint && npm test && npm run build"
   },
   "devDependencies": {
-    "@scalemule/react": "0.0.20",
+    "@scalemule/react": "0.0.21",
     "@testing-library/react": "^16.3.3",
     "@types/node": "^22.15.0",
     "@types/react": "^19.1.0",
@@ -162,7 +162,7 @@
   },
   "dependencies": {
     "@scalemule/compliance": "^0.0.5",
-    "@scalemule/react": "0.0.20",
+    "@scalemule/react": "0.0.21",
     "@scalemule/sdk": "0.0.75"
   }
 }