@scalemule/news-publication 0.0.20 → 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

@@ -1836,6 +1836,279 @@ function readerSources(input) {
   return output;
 }
 
+// src/listening.ts
+function publicationListeningTrack(article, publicationId, publicationName, origin) {
+  const articleUrl2 = new URL(`/news/${encodeURIComponent(article.slug)}`, origin).href;
+  let storyId = articleUrl2;
+  if (article.canonical_url) {
+    try {
+      const canonical = new URL(article.canonical_url);
+      if (canonical.protocol === "https:" && !canonical.username && !canonical.password && /^\/news\/[^/]+\/?$/.test(canonical.pathname) && localPublications.some((item) => new URL(item.url).hostname === canonical.hostname.replace(/^www\./, ""))) {
+        canonical.search = "";
+        canonical.hash = "";
+        canonical.hostname = canonical.hostname.replace(/^www\./, "");
+        canonical.pathname = canonical.pathname.replace(/\/$/, "");
+        storyId = canonical.href;
+      }
+    } catch {
+    }
+  }
+  const revision = article.editorial?.modified_at;
+  return {
+    id: article.id,
+    publicationId,
+    publicationName,
+    title: article.title,
+    articleUrl: articleUrl2,
+    storyId,
+    ...revision && Number.isFinite(Date.parse(revision)) ? { revision } : {},
+    ...article.audio?.duration_ms && article.audio.duration_ms > 0 ? { durationSeconds: article.audio.duration_ms / 1e3 } : {},
+    ...article.section ? { section: article.section } : {},
+    ...article.published_at ? { publishedAt: article.published_at } : {}
+  };
+}
+async function publicationListeningCandidates(items, read, publicationId, publicationName, origin) {
+  const output = [];
+  const recent = items.filter((item) => !item.editorial?.duplicate_url).slice(0, 30);
+  let failures = 0;
+  for (let i = 0; i < recent.length; i += 4) {
+    const batch = await Promise.allSettled(recent.slice(i, i + 4).map((item) => read(item.slug)));
+    for (const result of batch) {
+      if (result.status === "rejected") {
+        failures++;
+        continue;
+      }
+      const article = result.value;
+      if (!article.editorial?.duplicate_url && article.audio?.url && article.audio.duration_ms && article.audio.duration_ms > 0)
+        output.push(publicationListeningTrack(article, publicationId, publicationName, origin));
+    }
+  }
+  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,
   get: function () { return compliance.COOKIE_CONSENT_BACKUP_KEY; }
@@ -1945,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;
@@ -1979,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;
@@ -1986,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;
@@ -2007,6 +2284,8 @@ exports.publicJobsPath = publicJobsPath;
 exports.publicUrl = publicUrl;
 exports.publicationFromSnapshot = publicationFromSnapshot;
 exports.publicationJsonLd = publicationJsonLd;
+exports.publicationListeningCandidates = publicationListeningCandidates;
+exports.publicationListeningTrack = publicationListeningTrack;
 exports.publicationMeta = publicationMeta;
 exports.publicationRecord = publicationRecord;
 exports.readerSources = readerSources;

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;
@@ -311,4 +313,47 @@ declare function readerSources(input: unknown): {
     publisher?: string;
 }[];
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, 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, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+interface ListeningArticle {
+    id: string;
+    slug: string;
+    title: string;
+    canonical_url?: string | null;
+    section?: string | null;
+    published_at?: string;
+    editorial?: {
+        duplicate_url?: string;
+        modified_at?: string;
+    } | null;
+    audio?: {
+        url?: string | null;
+        duration_ms?: number | null;
+    };
+}
+/** Public metadata only. Never cache signed recording URLs in reader history. */
+declare function publicationListeningTrack(article: ListeningArticle, publicationId: string, publicationName: string, origin: string): {
+    publishedAt?: string | undefined;
+    section?: string | undefined;
+    durationSeconds?: number | undefined;
+    revision?: string | undefined;
+    id: string;
+    publicationId: string;
+    publicationName: string;
+    title: string;
+    articleUrl: string;
+    storyId: string;
+};
+/** Bounded public read fan-out, initiated only when a reader requests a catch-up queue. */
+declare function publicationListeningCandidates<T extends ListeningArticle>(items: T[], read: (slug: string) => Promise<ListeningArticle>, publicationId: string, publicationName: string, origin: string): Promise<{
+    publishedAt?: string | undefined;
+    section?: string | undefined;
+    durationSeconds?: number | undefined;
+    revision?: string | undefined;
+    id: string;
+    publicationId: string;
+    publicationName: string;
+    title: string;
+    articleUrl: string;
+    storyId: string;
+}[]>;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, 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 };