@scalemule/news-publication 0.0.18 → 0.0.20

package/dist/index.cjs

@@ -82,7 +82,7 @@ var walnutCreekTimes = definePublication({
   regionLabel: "Walnut Creek",
   towns: ["Walnut Creek", "Rossmoor", "Saranap", "Pleasant Hill"],
   nearbyTowns: ["Martinez", "Concord", "Contra Costa"],
-  sections: ["Civic life", "Community", "Local businesses", "Events", "Food & places"],
+  sections: ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health"],
   description: "Local news, independent businesses and community voices from Walnut Creek, Rossmoor, Saranap and Pleasant Hill.",
   layout: "broadsheet",
   layouts: ["broadsheet"],
@@ -174,9 +174,30 @@ function defaultRevalidateTargets() {
 
 // src/editorial.ts
 var labels = {
-  "Local businesses": "Local business",
+  "Local businesses": "Business",
+  "Events": "Things to do",
   "Food & places": "Food & drink"
 };
+var EDITORIAL_SECTION_ORDER = [
+  "Civic life",
+  "Community",
+  "Local businesses",
+  "Real Estate",
+  "Food & places",
+  "Events",
+  "Health",
+  "Schools",
+  "Opinion"
+];
+function orderedSections(sections, order = EDITORIAL_SECTION_ORDER) {
+  return sections.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;
+    const rightOrder = rightRank === -1 ? order.length : rightRank;
+    return leftOrder - rightOrder || left.name.localeCompare(right.name);
+  });
+}
 function sectionId(name) {
   return "section-" + name.normalize("NFKD").replace(/\p{Mark}/gu, "").toLowerCase().replace(/[^\p{Letter}\p{Number}]+/gu, "-").replace(/^-|-$/g, "");
 }
@@ -320,11 +341,16 @@ function newsArticleJsonLd(publication, article, canonical, authorName) {
     headline: article.title,
     description: article.excerpt ?? void 0,
     datePublished: article.published_at,
-    dateModified: article.updated_at,
+    // updated_at also changes for media/operational maintenance. A trusted
+    // editorial modification timestamp is required before emitting dateModified.
     image: image ? [image] : void 0,
-    mainEntityOfPage: canonicalUrl,
+    mainEntityOfPage: url,
     url,
-    author: { "@type": "Organization", name: authorName || publication.name },
+    ...canonicalUrl !== url ? { isBasedOn: canonicalUrl } : {},
+    articleSection: article.section || void 0,
+    // The publication byline is known to be an organization. Do not infer a
+    // person's identity or classify an untyped external byline as a newsroom.
+    author: { ...!authorName || authorName === publication.name ? { "@type": "Organization" } : {}, name: authorName || publication.name },
     publisher: { "@type": "NewsMediaOrganization", name: publication.name, url: canonical }
   };
 }
@@ -359,17 +385,17 @@ function articleMeta(publication, article, canonical, indexable) {
   const canonicalUrl = publicHttps(article.canonical_url) ?? url;
   const image = publicHttps(article.og_image_url) ?? publicHttps(article.cover_image_url);
   return {
-    title: article.seo_title ?? article.title,
+    title: article.title,
     description: article.seo_description ?? article.excerpt ?? publication.description,
     canonical: canonicalUrl,
     indexable: indexable && !article.no_index,
     openGraph: {
       type: "article",
+      siteName: publication.name,
       title: article.title,
       description: article.excerpt ?? void 0,
       url,
       publishedTime: article.published_at,
-      modifiedTime: article.updated_at,
       images: image ? [image] : []
     }
   };
@@ -1902,6 +1928,7 @@ exports.CLASSIFIED_CATEGORIES = CLASSIFIED_CATEGORIES;
 exports.COOKIE_CATEGORIES = COOKIE_CATEGORIES;
 exports.CookieConsentBanner = CookieConsentBanner;
 exports.CookieSettingsView = CookieSettingsView;
+exports.EDITORIAL_SECTION_ORDER = EDITORIAL_SECTION_ORDER;
 exports.EVENTS = EVENTS;
 exports.FEATURE_NAMES = FEATURE_NAMES;
 exports.JOB_EMPLOYMENT_TYPES = JOB_EMPLOYMENT_TYPES;
@@ -1969,6 +1996,7 @@ exports.matchesStoryTag = matchesStoryTag;
 exports.nearbyUpdates = nearbyUpdates;
 exports.newsArticleJsonLd = newsArticleJsonLd;
 exports.normalizedText = normalizedText;
+exports.orderedSections = orderedSections;
 exports.parseSnapshot = parseSnapshot;
 exports.prepareClassified = prepareClassified;
 exports.prepareJobPost = prepareJobPost;

package/dist/index.d.cts

@@ -102,6 +102,16 @@ declare function defaultRevalidateTargets(): {
     paths: string[];
 };
 
+/**
+ * Canonical reader-facing order for editorial sections across the network.
+ * Names not listed here sort after these, alphabetically. "Schools" and
+ * "Opinion" are reserved so future sections slot in without a release.
+ */
+declare const EDITORIAL_SECTION_ORDER: readonly ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health", "Schools", "Opinion"];
+/** Sorts sections into the canonical order, dropping the implicit "Local news" bucket. */
+declare function orderedSections<T extends {
+    name: string;
+}>(sections: T[], order?: readonly string[]): T[];
 declare function sectionId(name: string): string;
 declare function sectionPath(name: string): string;
 declare function sectionDefinition(name: string): EditorialSection;
@@ -146,26 +156,27 @@ declare function storyDate(value: string): string | null;
 /** https URL with no userinfo. Anything else is dropped from public markup. */
 declare function publicHttps(value?: string | null): string | undefined;
 declare function articleUrl(canonical: string, slug: string): string;
-/** Same NewsArticle graph Walnut Creek Times emits on an indexable story. */
+/** Describe the local edition while retaining the designated reporting source. */
 declare function newsArticleJsonLd(publication: NewsPublication, article: NewsArticle, canonical: string, authorName?: string | null): {
-    "@context": string;
-    "@type": string;
-    headline: string;
-    description: string | undefined;
-    datePublished: string;
-    dateModified: string;
-    image: string[] | undefined;
-    mainEntityOfPage: string;
-    url: string;
+    articleSection: string | undefined;
     author: {
-        "@type": string;
         name: string;
+        "@type"?: string | undefined;
     };
     publisher: {
         "@type": string;
         name: string;
         url: string;
     };
+    isBasedOn?: string | undefined;
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string | undefined;
+    datePublished: string;
+    image: string[] | undefined;
+    mainEntityOfPage: string;
+    url: string;
 };
 declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
     "@context": string;
@@ -199,11 +210,11 @@ declare function articleMeta(publication: NewsPublication, article: NewsArticle,
     indexable: boolean;
     openGraph: {
         type: "article";
+        siteName: string;
         title: string;
         description: string | undefined;
         url: string;
         publishedTime: string;
-        modifiedTime: string;
         images: string[];
     };
 };
@@ -300,4 +311,4 @@ declare function readerSources(input: unknown): {
     publisher?: string;
 }[];
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, 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, 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 };
+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 };

package/dist/index.d.ts

@@ -102,6 +102,16 @@ declare function defaultRevalidateTargets(): {
     paths: string[];
 };
 
+/**
+ * Canonical reader-facing order for editorial sections across the network.
+ * Names not listed here sort after these, alphabetically. "Schools" and
+ * "Opinion" are reserved so future sections slot in without a release.
+ */
+declare const EDITORIAL_SECTION_ORDER: readonly ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health", "Schools", "Opinion"];
+/** Sorts sections into the canonical order, dropping the implicit "Local news" bucket. */
+declare function orderedSections<T extends {
+    name: string;
+}>(sections: T[], order?: readonly string[]): T[];
 declare function sectionId(name: string): string;
 declare function sectionPath(name: string): string;
 declare function sectionDefinition(name: string): EditorialSection;
@@ -146,26 +156,27 @@ declare function storyDate(value: string): string | null;
 /** https URL with no userinfo. Anything else is dropped from public markup. */
 declare function publicHttps(value?: string | null): string | undefined;
 declare function articleUrl(canonical: string, slug: string): string;
-/** Same NewsArticle graph Walnut Creek Times emits on an indexable story. */
+/** Describe the local edition while retaining the designated reporting source. */
 declare function newsArticleJsonLd(publication: NewsPublication, article: NewsArticle, canonical: string, authorName?: string | null): {
-    "@context": string;
-    "@type": string;
-    headline: string;
-    description: string | undefined;
-    datePublished: string;
-    dateModified: string;
-    image: string[] | undefined;
-    mainEntityOfPage: string;
-    url: string;
+    articleSection: string | undefined;
     author: {
-        "@type": string;
         name: string;
+        "@type"?: string | undefined;
     };
     publisher: {
         "@type": string;
         name: string;
         url: string;
     };
+    isBasedOn?: string | undefined;
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string | undefined;
+    datePublished: string;
+    image: string[] | undefined;
+    mainEntityOfPage: string;
+    url: string;
 };
 declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
     "@context": string;
@@ -199,11 +210,11 @@ declare function articleMeta(publication: NewsPublication, article: NewsArticle,
     indexable: boolean;
     openGraph: {
         type: "article";
+        siteName: string;
         title: string;
         description: string | undefined;
         url: string;
         publishedTime: string;
-        modifiedTime: string;
         images: string[];
     };
 };
@@ -300,4 +311,4 @@ declare function readerSources(input: unknown): {
     publisher?: string;
 }[];
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, 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, 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 };
+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 };

package/dist/index.js

@@ -18,7 +18,7 @@ var walnutCreekTimes = definePublication({
   regionLabel: "Walnut Creek",
   towns: ["Walnut Creek", "Rossmoor", "Saranap", "Pleasant Hill"],
   nearbyTowns: ["Martinez", "Concord", "Contra Costa"],
-  sections: ["Civic life", "Community", "Local businesses", "Events", "Food & places"],
+  sections: ["Civic life", "Community", "Local businesses", "Real Estate", "Food & places", "Events", "Health"],
   description: "Local news, independent businesses and community voices from Walnut Creek, Rossmoor, Saranap and Pleasant Hill.",
   layout: "broadsheet",
   layouts: ["broadsheet"],
@@ -110,9 +110,30 @@ function defaultRevalidateTargets() {
 
 // src/editorial.ts
 var labels = {
-  "Local businesses": "Local business",
+  "Local businesses": "Business",
+  "Events": "Things to do",
   "Food & places": "Food & drink"
 };
+var EDITORIAL_SECTION_ORDER = [
+  "Civic life",
+  "Community",
+  "Local businesses",
+  "Real Estate",
+  "Food & places",
+  "Events",
+  "Health",
+  "Schools",
+  "Opinion"
+];
+function orderedSections(sections, order = EDITORIAL_SECTION_ORDER) {
+  return sections.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;
+    const rightOrder = rightRank === -1 ? order.length : rightRank;
+    return leftOrder - rightOrder || left.name.localeCompare(right.name);
+  });
+}
 function sectionId(name) {
   return "section-" + name.normalize("NFKD").replace(/\p{Mark}/gu, "").toLowerCase().replace(/[^\p{Letter}\p{Number}]+/gu, "-").replace(/^-|-$/g, "");
 }
@@ -256,11 +277,16 @@ function newsArticleJsonLd(publication, article, canonical, authorName) {
     headline: article.title,
     description: article.excerpt ?? void 0,
     datePublished: article.published_at,
-    dateModified: article.updated_at,
+    // updated_at also changes for media/operational maintenance. A trusted
+    // editorial modification timestamp is required before emitting dateModified.
     image: image ? [image] : void 0,
-    mainEntityOfPage: canonicalUrl,
+    mainEntityOfPage: url,
     url,
-    author: { "@type": "Organization", name: authorName || publication.name },
+    ...canonicalUrl !== url ? { isBasedOn: canonicalUrl } : {},
+    articleSection: article.section || void 0,
+    // The publication byline is known to be an organization. Do not infer a
+    // person's identity or classify an untyped external byline as a newsroom.
+    author: { ...!authorName || authorName === publication.name ? { "@type": "Organization" } : {}, name: authorName || publication.name },
     publisher: { "@type": "NewsMediaOrganization", name: publication.name, url: canonical }
   };
 }
@@ -295,17 +321,17 @@ function articleMeta(publication, article, canonical, indexable) {
   const canonicalUrl = publicHttps(article.canonical_url) ?? url;
   const image = publicHttps(article.og_image_url) ?? publicHttps(article.cover_image_url);
   return {
-    title: article.seo_title ?? article.title,
+    title: article.title,
     description: article.seo_description ?? article.excerpt ?? publication.description,
     canonical: canonicalUrl,
     indexable: indexable && !article.no_index,
     openGraph: {
       type: "article",
+      siteName: publication.name,
       title: article.title,
       description: article.excerpt ?? void 0,
       url,
       publishedTime: article.published_at,
-      modifiedTime: article.updated_at,
       images: image ? [image] : []
     }
   };
@@ -491,4 +517,4 @@ function readerSources(input) {
   return output;
 }
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, 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, publicHttps, publicUrl, publicationJsonLd, 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, 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 };

package/package.json

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