@scalemule/news-publication 0.0.20 → 0.0.21

package/dist/index.cjs

@@ -1836,6 +1836,57 @@ 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 ?? ""));
+}
+
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
   get: function () { return compliance.COOKIE_CONSENT_BACKUP_KEY; }
@@ -2007,6 +2058,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

@@ -311,4 +311,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 };

package/dist/index.d.ts

@@ -311,4 +311,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 };

package/dist/index.js

@@ -6,6 +6,7 @@ export { CLASSIFIED_CATEGORIES, JOB_EMPLOYMENT_TYPES, categoryLabel, classifiedP
 export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup, screenMessage } from './chunk-GB36YM56.js';
 export { CookieConsentBanner } from './chunk-HTMIFWNA.js';
 export { CookieSettingsView } from './chunk-3MFKPHO3.js';
+import { localPublications } from './chunk-2IYYEFLD.js';
 export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, communityPublications, decorateNetworkUrl, findPublicationByHost, findPublicationBySlug, getCookieConsent, getNetworkPublicationUrl, hasConsented, isCategoryAllowed, isGeoConsentRequired, listedPublications, localPublications, queryNetworkConsentHub, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from './chunk-2IYYEFLD.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
@@ -517,4 +518,55 @@ function readerSources(input) {
   return output;
 }
 
-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, publicationMeta, readerSources, referralCode, resolveCoupon, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+// 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 ?? ""));
+}
+
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "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",