@scalemule/news-publication 0.0.21 → 0.0.22

package/README.md

@@ -85,3 +85,18 @@ import { ArticleProvenance } from '@scalemule/news-publication'
 ```
 
 The component inherits the publication's typography. Optional styling hooks are `article-provenance` and `article-provenance__label`. `readerSources()` is available when an existing publication component owns source-list rendering.
+
+### Verified Community Cards
+
+`VerifiedCardSection` and `VerifiedCardComponent` render broadsheet-styled fact sheets for verified entities (`PLACE`, `ACTIVITY`, `EVENT`, `ORGANIZATION`, `PRODUCT`). Verified cards display confirmed operating hours, venues, contact details, dates, and primary action links (tickets, registration, maps) validated by newsroom staff.
+
+```tsx
+import { VerifiedCardSection, getArticleCards } from '@scalemule/news-publication'
+
+const cards = getArticleCards(article.metadata?.cards)
+
+<VerifiedCardSection cards={cards} />
+```
+
+Styles adhere to the publication theme (`--pub-paper`, `--pub-ink`, `--pub-accent`, `--pub-rule`, `--pub-soft`) and are included in `@scalemule/news-publication/tokens.css` or available standalone via `@scalemule/news-publication/verified-card.css`.
+

package/dist/chunk-I3ZTQCV3.js

@@ -0,0 +1,227 @@
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/verified-card.tsx
+var ALLOWED_CARD_TYPES = /* @__PURE__ */ new Set([
+  "PLACE",
+  "ACTIVITY",
+  "EVENT",
+  "ORGANIZATION",
+  "PRODUCT"
+]);
+function clip(val, maxChars) {
+  if (typeof val !== "string") return void 0;
+  const trimmed = val.trim();
+  if (!trimmed) return void 0;
+  return Array.from(trimmed).slice(0, maxChars).join("");
+}
+function isSafeActionUrl(raw) {
+  if (typeof raw !== "string") return false;
+  const trimmed = raw.trim();
+  if (!trimmed || trimmed.length > 2048) return false;
+  if (trimmed.startsWith("tel:") || trimmed.startsWith("mailto:")) {
+    return /^tel:\+?[\d\-().\s]+$/.test(trimmed) || /^mailto:[^\s@]+@[^\s@]+\.[^\s@]+$/.test(trimmed);
+  }
+  try {
+    const url = new URL(trimmed);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return false;
+    if (url.username || url.password) return false;
+    const hostname = url.hostname.toLowerCase();
+    if (hostname === "localhost" || hostname.endsWith(".localhost") || hostname.endsWith(".internal") || hostname.endsWith(".local") || hostname === "127.0.0.1" || hostname === "169.254.169.254") {
+      return false;
+    }
+    for (const [key] of url.searchParams.entries()) {
+      const cleanKey = key.toLowerCase().replace(/[^a-z0-9]/g, "");
+      if (cleanKey === "token" || cleanKey === "apikey" || cleanKey === "accesstoken" || cleanKey === "secret" || cleanKey === "clientsecret" || cleanKey === "authorization" || cleanKey === "signature" || cleanKey === "password" || cleanKey === "xamzsignature" || cleanKey === "xamzsecuritytoken") {
+        return false;
+      }
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getArticleCards(rawCards) {
+  if (!Array.isArray(rawCards) || rawCards.length === 0) return [];
+  const cards = [];
+  for (const item of rawCards) {
+    if (!item || typeof item !== "object") continue;
+    const c = item;
+    const id = clip(c.id, 64);
+    const title = clip(c.title, 300);
+    if (!id || !title) continue;
+    const rawType = typeof c.card_type === "string" ? c.card_type : c.cardType;
+    const cardType = ALLOWED_CARD_TYPES.has(rawType) ? rawType : "PLACE";
+    const kicker = clip(c.kicker, 120) || (cardType === "PLACE" ? "LOCAL VENUE \xB7 VERIFIED DIRECTORY" : cardType === "EVENT" ? "COMMUNITY EVENT \xB7 VERIFIED FACTSHEET" : cardType === "ACTIVITY" ? "COMMUNITY ACTIVITY \xB7 VERIFIED FACTSHEET" : cardType === "ORGANIZATION" ? "COMMUNITY ORGANIZATION \xB7 DIRECTORY" : "VERIFIED FACTSHEET");
+    const subtitle = clip(c.subtitle, 300);
+    const summary = clip(c.summary, 1e3);
+    const badge = clip(c.badge, 64);
+    const facts = [];
+    if (Array.isArray(c.facts)) {
+      for (const f of c.facts) {
+        if (!f || typeof f !== "object") continue;
+        const label = clip(f.label, 80);
+        const value = clip(f.value, 500);
+        if (!label || !value) continue;
+        let href = void 0;
+        const rawHref = f.href;
+        if (typeof rawHref === "string" && isSafeActionUrl(rawHref)) {
+          href = rawHref;
+        }
+        facts.push({ label, value, href });
+      }
+    } else {
+      const timeframe = clip(c.timeframe, 200);
+      if (timeframe) facts.push({ label: "Timeframe", value: timeframe });
+      const address = clip(c.address, 300);
+      if (address) {
+        facts.push({
+          label: "Address",
+          value: address,
+          href: `https://maps.google.com/?q=${encodeURIComponent(address)}`
+        });
+      }
+      const hours = clip(c.hours, 300);
+      if (hours) facts.push({ label: "Hours", value: hours });
+      const phone = clip(c.phone, 80);
+      if (phone) {
+        facts.push({
+          label: "Phone",
+          value: phone,
+          href: `tel:${phone.replace(/[^+\d]/g, "")}`
+        });
+      }
+      const cost = clip(c.cost, 120);
+      if (cost) facts.push({ label: "Cost", value: cost });
+    }
+    const actions = [];
+    if (Array.isArray(c.actions)) {
+      for (const act of c.actions) {
+        if (!act || typeof act !== "object") continue;
+        const actObj = act;
+        const label = clip(actObj.label, 80);
+        const url = typeof actObj.url === "string" ? actObj.url.trim() : "";
+        if (!label || !url || !isSafeActionUrl(url)) continue;
+        actions.push({
+          label,
+          url,
+          primary: Boolean(actObj.primary)
+        });
+        if (actions.length >= 5) break;
+      }
+    }
+    let image = void 0;
+    if (c.image && typeof c.image === "object") {
+      const img = c.image;
+      const masterUrl = typeof img.master_url === "string" && isSafeActionUrl(img.master_url) ? img.master_url : void 0;
+      const url = typeof img.url === "string" && isSafeActionUrl(img.url) ? img.url : masterUrl;
+      if (url) {
+        image = {
+          file_id: clip(img.file_id, 64),
+          master_url: masterUrl,
+          url,
+          width: typeof img.width === "number" ? img.width : void 0,
+          height: typeof img.height === "number" ? img.height : void 0,
+          alt: clip(img.alt, 500),
+          caption: clip(img.caption, 1e3),
+          attribution: clip(img.attribution, 500),
+          label: clip(img.label, 100),
+          ai_generated: Boolean(img.ai_generated)
+        };
+      }
+    }
+    const verificationNote = clip(c.verification_note || c.verificationNote, 300) || "Verified by publication reporting staff";
+    const verifiedAt = clip(c.verified_at || c.verifiedAt, 100) || "October 2026";
+    let rating = void 0;
+    if (typeof c.rating === "number" || typeof c.rating === "string") {
+      rating = c.rating;
+    }
+    cards.push({
+      id,
+      cardType,
+      kicker,
+      title,
+      subtitle,
+      summary,
+      badge,
+      facts,
+      actions,
+      verificationNote,
+      verifiedAt,
+      image,
+      rating
+    });
+    if (cards.length >= 10) break;
+  }
+  return cards;
+}
+function VerifiedCardComponent({
+  card,
+  className
+}) {
+  return /* @__PURE__ */ jsxs(
+    "aside",
+    {
+      className: `article-verified-card ${className || ""}`.trim(),
+      "aria-label": `Verified Factsheet: ${card.title}`,
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "article-verified-card__header", children: [
+          /* @__PURE__ */ jsx("span", { className: "article-verified-card__kicker", children: card.kicker }),
+          card.badge && /* @__PURE__ */ jsx("span", { className: "article-verified-card__badge", children: card.badge })
+        ] }),
+        /* @__PURE__ */ jsx("h2", { className: "article-verified-card__title", children: card.title }),
+        card.subtitle && /* @__PURE__ */ jsx("p", { className: "article-verified-card__subtitle", children: card.subtitle }),
+        card.summary && /* @__PURE__ */ jsx("p", { className: "article-verified-card__summary", children: card.summary }),
+        card.facts.length > 0 && /* @__PURE__ */ jsx("dl", { className: "article-verified-card__fact-grid", children: card.facts.map((fact, i) => /* @__PURE__ */ jsxs("div", { className: "article-verified-card__fact-row", children: [
+          /* @__PURE__ */ jsx("dt", { className: "article-verified-card__fact-label", children: fact.label }),
+          /* @__PURE__ */ jsx("dd", { className: "article-verified-card__fact-value", children: fact.href ? /* @__PURE__ */ jsx(
+            "a",
+            {
+              className: "article-verified-card__fact-link",
+              href: fact.href,
+              rel: "noopener noreferrer",
+              target: fact.href.startsWith("http") ? "_blank" : void 0,
+              children: fact.value
+            }
+          ) : fact.value })
+        ] }, i)) }),
+        card.actions.length > 0 && /* @__PURE__ */ jsx("div", { className: "article-verified-card__actions", children: card.actions.map((act, i) => /* @__PURE__ */ jsxs(
+          "a",
+          {
+            className: `article-verified-card__action ${act.primary ? "article-verified-card__action--primary" : "article-verified-card__action--secondary"}`,
+            href: act.url,
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: [
+              /* @__PURE__ */ jsx("span", { children: act.label }),
+              /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "article-verified-card__action-icon", children: "\u2197" })
+            ]
+          },
+          i
+        )) }),
+        /* @__PURE__ */ jsxs("footer", { className: "article-verified-card__footer", children: [
+          /* @__PURE__ */ jsxs("div", { className: "article-verified-card__seal", children: [
+            /* @__PURE__ */ jsx("span", { className: "article-verified-card__seal-check", "aria-hidden": "true", children: "\u2713" }),
+            /* @__PURE__ */ jsx("span", { children: card.verificationNote })
+          ] }),
+          /* @__PURE__ */ jsx("span", { className: "article-verified-card__date", children: card.verifiedAt })
+        ] })
+      ]
+    }
+  );
+}
+function VerifiedCardSection({
+  cards,
+  className
+}) {
+  if (!cards || cards.length === 0) return null;
+  return /* @__PURE__ */ jsx(
+    "section",
+    {
+      className: `article-verified-card-section ${className || ""}`.trim(),
+      "aria-label": "Verified Community Information",
+      children: cards.map((card) => /* @__PURE__ */ jsx(VerifiedCardComponent, { card }, card.id))
+    }
+  );
+}
+
+export { VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl };

package/dist/index.cjs

@@ -1886,6 +1886,228 @@ async function publicationListeningCandidates(items, read, publicationId, public
   if (!output.length && failures) throw new Error("Audio inventory could not be loaded");
   return output.sort((a, b) => (b.publishedAt ?? "").localeCompare(a.publishedAt ?? ""));
 }
+var ALLOWED_CARD_TYPES = /* @__PURE__ */ new Set([
+  "PLACE",
+  "ACTIVITY",
+  "EVENT",
+  "ORGANIZATION",
+  "PRODUCT"
+]);
+function clip(val, maxChars) {
+  if (typeof val !== "string") return void 0;
+  const trimmed = val.trim();
+  if (!trimmed) return void 0;
+  return Array.from(trimmed).slice(0, maxChars).join("");
+}
+function isSafeActionUrl(raw) {
+  if (typeof raw !== "string") return false;
+  const trimmed = raw.trim();
+  if (!trimmed || trimmed.length > 2048) return false;
+  if (trimmed.startsWith("tel:") || trimmed.startsWith("mailto:")) {
+    return /^tel:\+?[\d\-().\s]+$/.test(trimmed) || /^mailto:[^\s@]+@[^\s@]+\.[^\s@]+$/.test(trimmed);
+  }
+  try {
+    const url = new URL(trimmed);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return false;
+    if (url.username || url.password) return false;
+    const hostname = url.hostname.toLowerCase();
+    if (hostname === "localhost" || hostname.endsWith(".localhost") || hostname.endsWith(".internal") || hostname.endsWith(".local") || hostname === "127.0.0.1" || hostname === "169.254.169.254") {
+      return false;
+    }
+    for (const [key] of url.searchParams.entries()) {
+      const cleanKey = key.toLowerCase().replace(/[^a-z0-9]/g, "");
+      if (cleanKey === "token" || cleanKey === "apikey" || cleanKey === "accesstoken" || cleanKey === "secret" || cleanKey === "clientsecret" || cleanKey === "authorization" || cleanKey === "signature" || cleanKey === "password" || cleanKey === "xamzsignature" || cleanKey === "xamzsecuritytoken") {
+        return false;
+      }
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getArticleCards(rawCards) {
+  if (!Array.isArray(rawCards) || rawCards.length === 0) return [];
+  const cards = [];
+  for (const item of rawCards) {
+    if (!item || typeof item !== "object") continue;
+    const c = item;
+    const id = clip(c.id, 64);
+    const title = clip(c.title, 300);
+    if (!id || !title) continue;
+    const rawType = typeof c.card_type === "string" ? c.card_type : c.cardType;
+    const cardType = ALLOWED_CARD_TYPES.has(rawType) ? rawType : "PLACE";
+    const kicker = clip(c.kicker, 120) || (cardType === "PLACE" ? "LOCAL VENUE \xB7 VERIFIED DIRECTORY" : cardType === "EVENT" ? "COMMUNITY EVENT \xB7 VERIFIED FACTSHEET" : cardType === "ACTIVITY" ? "COMMUNITY ACTIVITY \xB7 VERIFIED FACTSHEET" : cardType === "ORGANIZATION" ? "COMMUNITY ORGANIZATION \xB7 DIRECTORY" : "VERIFIED FACTSHEET");
+    const subtitle = clip(c.subtitle, 300);
+    const summary = clip(c.summary, 1e3);
+    const badge = clip(c.badge, 64);
+    const facts = [];
+    if (Array.isArray(c.facts)) {
+      for (const f of c.facts) {
+        if (!f || typeof f !== "object") continue;
+        const label = clip(f.label, 80);
+        const value = clip(f.value, 500);
+        if (!label || !value) continue;
+        let href = void 0;
+        const rawHref = f.href;
+        if (typeof rawHref === "string" && isSafeActionUrl(rawHref)) {
+          href = rawHref;
+        }
+        facts.push({ label, value, href });
+      }
+    } else {
+      const timeframe = clip(c.timeframe, 200);
+      if (timeframe) facts.push({ label: "Timeframe", value: timeframe });
+      const address = clip(c.address, 300);
+      if (address) {
+        facts.push({
+          label: "Address",
+          value: address,
+          href: `https://maps.google.com/?q=${encodeURIComponent(address)}`
+        });
+      }
+      const hours = clip(c.hours, 300);
+      if (hours) facts.push({ label: "Hours", value: hours });
+      const phone = clip(c.phone, 80);
+      if (phone) {
+        facts.push({
+          label: "Phone",
+          value: phone,
+          href: `tel:${phone.replace(/[^+\d]/g, "")}`
+        });
+      }
+      const cost = clip(c.cost, 120);
+      if (cost) facts.push({ label: "Cost", value: cost });
+    }
+    const actions = [];
+    if (Array.isArray(c.actions)) {
+      for (const act of c.actions) {
+        if (!act || typeof act !== "object") continue;
+        const actObj = act;
+        const label = clip(actObj.label, 80);
+        const url = typeof actObj.url === "string" ? actObj.url.trim() : "";
+        if (!label || !url || !isSafeActionUrl(url)) continue;
+        actions.push({
+          label,
+          url,
+          primary: Boolean(actObj.primary)
+        });
+        if (actions.length >= 5) break;
+      }
+    }
+    let image = void 0;
+    if (c.image && typeof c.image === "object") {
+      const img = c.image;
+      const masterUrl = typeof img.master_url === "string" && isSafeActionUrl(img.master_url) ? img.master_url : void 0;
+      const url = typeof img.url === "string" && isSafeActionUrl(img.url) ? img.url : masterUrl;
+      if (url) {
+        image = {
+          file_id: clip(img.file_id, 64),
+          master_url: masterUrl,
+          url,
+          width: typeof img.width === "number" ? img.width : void 0,
+          height: typeof img.height === "number" ? img.height : void 0,
+          alt: clip(img.alt, 500),
+          caption: clip(img.caption, 1e3),
+          attribution: clip(img.attribution, 500),
+          label: clip(img.label, 100),
+          ai_generated: Boolean(img.ai_generated)
+        };
+      }
+    }
+    const verificationNote = clip(c.verification_note || c.verificationNote, 300) || "Verified by publication reporting staff";
+    const verifiedAt = clip(c.verified_at || c.verifiedAt, 100) || "October 2026";
+    let rating = void 0;
+    if (typeof c.rating === "number" || typeof c.rating === "string") {
+      rating = c.rating;
+    }
+    cards.push({
+      id,
+      cardType,
+      kicker,
+      title,
+      subtitle,
+      summary,
+      badge,
+      facts,
+      actions,
+      verificationNote,
+      verifiedAt,
+      image,
+      rating
+    });
+    if (cards.length >= 10) break;
+  }
+  return cards;
+}
+function VerifiedCardComponent({
+  card,
+  className
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "aside",
+    {
+      className: `article-verified-card ${className || ""}`.trim(),
+      "aria-label": `Verified Factsheet: ${card.title}`,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "article-verified-card__header", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "article-verified-card__kicker", children: card.kicker }),
+          card.badge && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "article-verified-card__badge", children: card.badge })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "article-verified-card__title", children: card.title }),
+        card.subtitle && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "article-verified-card__subtitle", children: card.subtitle }),
+        card.summary && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "article-verified-card__summary", children: card.summary }),
+        card.facts.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("dl", { className: "article-verified-card__fact-grid", children: card.facts.map((fact, i) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "article-verified-card__fact-row", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("dt", { className: "article-verified-card__fact-label", children: fact.label }),
+          /* @__PURE__ */ jsxRuntime.jsx("dd", { className: "article-verified-card__fact-value", children: fact.href ? /* @__PURE__ */ jsxRuntime.jsx(
+            "a",
+            {
+              className: "article-verified-card__fact-link",
+              href: fact.href,
+              rel: "noopener noreferrer",
+              target: fact.href.startsWith("http") ? "_blank" : void 0,
+              children: fact.value
+            }
+          ) : fact.value })
+        ] }, i)) }),
+        card.actions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "article-verified-card__actions", children: card.actions.map((act, i) => /* @__PURE__ */ jsxRuntime.jsxs(
+          "a",
+          {
+            className: `article-verified-card__action ${act.primary ? "article-verified-card__action--primary" : "article-verified-card__action--secondary"}`,
+            href: act.url,
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx("span", { children: act.label }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { "aria-hidden": "true", className: "article-verified-card__action-icon", children: "\u2197" })
+            ]
+          },
+          i
+        )) }),
+        /* @__PURE__ */ jsxRuntime.jsxs("footer", { className: "article-verified-card__footer", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "article-verified-card__seal", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "article-verified-card__seal-check", "aria-hidden": "true", children: "\u2713" }),
+            /* @__PURE__ */ jsxRuntime.jsx("span", { children: card.verificationNote })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "article-verified-card__date", children: card.verifiedAt })
+        ] })
+      ]
+    }
+  );
+}
+function VerifiedCardSection({
+  cards,
+  className
+}) {
+  if (!cards || cards.length === 0) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "section",
+    {
+      className: `article-verified-card-section ${className || ""}`.trim(),
+      "aria-label": "Verified Community Information",
+      children: cards.map((card) => /* @__PURE__ */ jsxRuntime.jsx(VerifiedCardComponent, { card }, card.id))
+    }
+  );
+}
 
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
@@ -1996,6 +2218,8 @@ exports.THEME_STORAGE_KEY = THEME_STORAGE_KEY;
 exports.ThemeToggle = ThemeToggle;
 exports.UTM_FIELDS = UTM_FIELDS;
 exports.UUID = UUID;
+exports.VerifiedCardComponent = VerifiedCardComponent;
+exports.VerifiedCardSection = VerifiedCardSection;
 exports.acceptRemoteRecord = acceptRemoteRecord;
 exports.acceptSnapshot = acceptSnapshot;
 exports.activeNearby = activeNearby;
@@ -2030,6 +2254,7 @@ exports.feedCacheOptions = feedCacheOptions;
 exports.filterNews = filterNews;
 exports.findPublicationByHost = findPublicationByHost;
 exports.findPublicationBySlug = findPublicationBySlug;
+exports.getArticleCards = getArticleCards;
 exports.getNetworkPublicationUrl = getNetworkPublicationUrl;
 exports.getStoredTheme = getStoredTheme;
 exports.getSystemTheme = getSystemTheme;
@@ -2037,6 +2262,7 @@ exports.inventoryCacheOptions = inventoryCacheOptions;
 exports.isAdult = isAdult;
 exports.isClassifiedCategory = isClassifiedCategory;
 exports.isEmploymentType = isEmploymentType;
+exports.isSafeActionUrl = isSafeActionUrl;
 exports.jobEmployerBody = jobEmployerBody;
 exports.jobOpeningBody = jobOpeningBody;
 exports.jobPostingBody = jobPostingBody;

package/dist/index.d.cts

@@ -1,7 +1,8 @@
-import { b as PublicationTheme, c as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, d as NearbyUpdate, e as NewsItem, E as EditorialSection, f as NewsArticle, C as CouponOffer } from './snapshot-OZFP3-Up.cjs';
-export { A as ArticleCitation, g as CategoryRef, h as CouponSettings, i as CoverImageMetadata, j as FEATURE_NAMES, k as FeatureFlags, l as NewsFeed, m as NewsLayoutId, n as PublicationModules, o as PublicationRecord, P as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, p as StoryDisplay, q as SyncSource, a as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-OZFP3-Up.cjs';
+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';
 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';
 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';
@@ -10,6 +11,7 @@ export { ThemeToggle, ThemeToggleProps } from './theme-toggle.cjs';
 export { PublicationNetworkItem, communityPublications, findPublicationByHost, findPublicationBySlug, getNetworkPublicationUrl, listedPublications, localPublications } from './network.cjs';
 export { LocalNetworkBar, LocalNetworkBarProps } from './network-bar.cjs';
 import * as react from 'react';
+export { VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl } from './verified-card.cjs';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
 declare const BROADSHEET_THEME: PublicationTheme;

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { b as PublicationTheme, c as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, d as NearbyUpdate, e as NewsItem, E as EditorialSection, f as NewsArticle, C as CouponOffer } from './snapshot-OZFP3-Up.js';
-export { A as ArticleCitation, g as CategoryRef, h as CouponSettings, i as CoverImageMetadata, j as FEATURE_NAMES, k as FeatureFlags, l as NewsFeed, m as NewsLayoutId, n as PublicationModules, o as PublicationRecord, P as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, p as StoryDisplay, q as SyncSource, a as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-OZFP3-Up.js';
+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';
 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';
 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';
@@ -10,6 +11,7 @@ export { ThemeToggle, ThemeToggleProps } from './theme-toggle.js';
 export { PublicationNetworkItem, communityPublications, findPublicationByHost, findPublicationBySlug, getNetworkPublicationUrl, listedPublications, localPublications } from './network.js';
 export { LocalNetworkBar, LocalNetworkBarProps } from './network-bar.js';
 import * as react from 'react';
+export { VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl } from './verified-card.js';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
 declare const BROADSHEET_THEME: PublicationTheme;

package/dist/index.js

@@ -1,5 +1,6 @@
 export { THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, ThemeToggle, applyTheme, clearTheme, getStoredTheme, getSystemTheme, resolveEffectiveTheme, setTheme, subscribeTheme, themeInitScript } from './chunk-NQD3M7ZY.js';
 export { LocalNetworkBar } from './chunk-QBT66OVE.js';
+export { VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl } from './chunk-I3ZTQCV3.js';
 import { definePublication } from './chunk-C7JTEHTH.js';
 export { BROADSHEET_THEME, FEATURE_NAMES, LAYOUT_COOKIE, acceptRemoteRecord, acceptSnapshot, definePublication, featureEnabled, parseSnapshot, publicationFromSnapshot, publicationRecord, resolveLayout, snapshotFromRecord, syncPublication } from './chunk-C7JTEHTH.js';
 export { CLASSIFIED_CATEGORIES, JOB_EMPLOYMENT_TYPES, categoryLabel, classifiedPath, classifiedSearchPath, clipChars, dealDollars, dealGoPath, dealsFeedPath, employmentLabel, isClassifiedCategory, isEmploymentType, jobEmployerBody, jobOpeningBody, jobPostingBody, prepareClassified, prepareJobPost, publicJobPath, publicJobsPath } from './chunk-C7ZPLH2K.js';

package/dist/snapshot-C0IGpt-B.d.cts

@@ -0,0 +1,48 @@
+import { P as PublicationInput, N as NewsPublication } from './types-DFDCZHbS.cjs';
+
+/**
+ * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)
+ * stay in the site and are attached after the snapshot loads.
+ */
+type PublicationRecord = Omit<PublicationInput, "matchTag" | "coupons"> & {
+    coupons?: Omit<NonNullable<PublicationInput["coupons"]>, "resolve">;
+};
+/** Last config the application accepted. Age never invalidates it. */
+type PublicationSnapshot = {
+    version: 1;
+    syncedAt: string;
+    record: PublicationRecord;
+};
+type SnapshotHooks = {
+    matchTag?: PublicationInput["matchTag"];
+    resolveCoupon?: NonNullable<PublicationInput["coupons"]>["resolve"];
+};
+type SyncSource = "fresh" | "retained";
+type SyncedPublication = {
+    publication: NewsPublication;
+    snapshot: PublicationSnapshot;
+    source: SyncSource;
+    /** How long this snapshot has been the one on disk. Zero for a fresh sync. */
+    ageMs: number;
+};
+declare function publicationRecord(publication: NewsPublication): PublicationRecord;
+declare function snapshotFromRecord(record: PublicationRecord, syncedAt?: string): PublicationSnapshot;
+declare function parseSnapshot(raw: string): PublicationSnapshot | null;
+declare function acceptSnapshot(value: unknown): PublicationSnapshot | null;
+/** A remote payload replaces the snapshot only when it is a complete record for this paper. */
+declare function acceptRemoteRecord(value: unknown, expectedSlug?: string): PublicationRecord | null;
+declare function publicationFromSnapshot(snapshot: PublicationSnapshot, hooks?: SnapshotHooks): NewsPublication;
+/**
+ * Fetch the application config. Any failure, timeout, or malformed body keeps
+ * the previous snapshot. Nothing here expires a snapshot because the API was
+ * unreachable for hours or days.
+ */
+declare function syncPublication(input: {
+    previous: PublicationSnapshot | null;
+    fetchRecord: () => Promise<unknown>;
+    expectedSlug?: string;
+    now?: number;
+    hooks?: SnapshotHooks;
+}): Promise<SyncedPublication>;
+
+export { type PublicationSnapshot as P, type SnapshotHooks as S, type SyncedPublication as a, type PublicationRecord as b, type SyncSource as c, acceptRemoteRecord as d, acceptSnapshot as e, publicationFromSnapshot as f, publicationRecord as g, syncPublication as h, parseSnapshot as p, snapshotFromRecord as s };

package/dist/snapshot-CxuyMF39.d.ts

@@ -0,0 +1,48 @@
+import { P as PublicationInput, N as NewsPublication } from './types-DFDCZHbS.js';
+
+/**
+ * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)
+ * stay in the site and are attached after the snapshot loads.
+ */
+type PublicationRecord = Omit<PublicationInput, "matchTag" | "coupons"> & {
+    coupons?: Omit<NonNullable<PublicationInput["coupons"]>, "resolve">;
+};
+/** Last config the application accepted. Age never invalidates it. */
+type PublicationSnapshot = {
+    version: 1;
+    syncedAt: string;
+    record: PublicationRecord;
+};
+type SnapshotHooks = {
+    matchTag?: PublicationInput["matchTag"];
+    resolveCoupon?: NonNullable<PublicationInput["coupons"]>["resolve"];
+};
+type SyncSource = "fresh" | "retained";
+type SyncedPublication = {
+    publication: NewsPublication;
+    snapshot: PublicationSnapshot;
+    source: SyncSource;
+    /** How long this snapshot has been the one on disk. Zero for a fresh sync. */
+    ageMs: number;
+};
+declare function publicationRecord(publication: NewsPublication): PublicationRecord;
+declare function snapshotFromRecord(record: PublicationRecord, syncedAt?: string): PublicationSnapshot;
+declare function parseSnapshot(raw: string): PublicationSnapshot | null;
+declare function acceptSnapshot(value: unknown): PublicationSnapshot | null;
+/** A remote payload replaces the snapshot only when it is a complete record for this paper. */
+declare function acceptRemoteRecord(value: unknown, expectedSlug?: string): PublicationRecord | null;
+declare function publicationFromSnapshot(snapshot: PublicationSnapshot, hooks?: SnapshotHooks): NewsPublication;
+/**
+ * Fetch the application config. Any failure, timeout, or malformed body keeps
+ * the previous snapshot. Nothing here expires a snapshot because the API was
+ * unreachable for hours or days.
+ */
+declare function syncPublication(input: {
+    previous: PublicationSnapshot | null;
+    fetchRecord: () => Promise<unknown>;
+    expectedSlug?: string;
+    now?: number;
+    hooks?: SnapshotHooks;
+}): Promise<SyncedPublication>;
+
+export { type PublicationSnapshot as P, type SnapshotHooks as S, type SyncedPublication as a, type PublicationRecord as b, type SyncSource as c, acceptRemoteRecord as d, acceptSnapshot as e, publicationFromSnapshot as f, publicationRecord as g, syncPublication as h, parseSnapshot as p, snapshotFromRecord as s };

package/dist/snapshot-file.d.cts

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