@scalemule/news-publication 0.0.81 → 0.0.83

package/dist/index.js

@@ -773,8 +773,11 @@ var EVENTS = {
   article_shared: browser("engagement"),
   promotion_viewed: browser("content"),
   promotion_clicked: browser("engagement"),
+  newsletter_invitation_viewed: browser("content"),
+  related_stories_viewed: browser("content"),
   newsletter_signup_started: browser("engagement"),
   newsletter_subscription_confirmed: server(),
+  experiment_exposed: browser("system"),
   web_vital_recorded: browser("system"),
   scroll_depth_reached: browser("content"),
   navigation_clicked: browser("navigation"),
@@ -1020,4 +1023,196 @@ function campaignReportHtml(report) {
   <footer><p>${escape(report.reporting_note)}</p><p>${escape(report.editorial_independence)}</p><p>Campaign reference: ${escape(report.campaign_id)}</p></footer></body></html>`;
 }
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, EDITORIAL_SECTION_ORDER, EVENTS, LOCAL_BRIEFING_POLICY_VERSION, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, composeEdition, composeLocalBriefing, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, referralCode, resolveCoupon, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+// src/community-conversion.ts
+var ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+var CELEBRATION_PATTERN = /\b(celebrat(?:e|ion|ions|ing)|wedding|weddings|baby|babies|newborn|quarter[- ]?finals?|milestone|milestones|anniversar(?:y|ies)|graduat(?:e|es|ion|ions)|honor(?:s|ed|ing)?|award(?:s|ed)?|champion|champions|hero(?:es)?|little warrior|birthday)\b/iu;
+var SPONSORED_MARKER_PATTERN = /\b(sponsored|paid post|partner content|advertorial|promoted|brand studio)\b/iu;
+function resolveArticleConversionVariant(assignedVariant, queryOverride) {
+  const candidate = (queryOverride ?? assignedVariant ?? "").trim().toLowerCase();
+  if (candidate === "treatment" || candidate === "inline" || candidate === "b") {
+    return "treatment";
+  }
+  return "control";
+}
+function classifyStoryInvitationCategory(story) {
+  const combinedText = [
+    story.title,
+    story.excerpt ?? "",
+    story.section ?? "",
+    ...(story.tags ?? []).map((t) => t.name),
+    ...(story.categories ?? []).map((c) => c.name)
+  ].join(" ");
+  if (CELEBRATION_PATTERN.test(combinedText)) {
+    return "celebrations";
+  }
+  const section = resolveSection(story);
+  switch (section) {
+    case "Local businesses":
+      return "local_businesses";
+    case "Schools":
+      return "education";
+    case "Events":
+      return "community_events";
+    case "Civic life":
+    case "Real Estate":
+    case "Health":
+      return "neighborhood_news";
+    default:
+      return "community";
+  }
+}
+function contextualCommunityInvitation(story, publication) {
+  const category = classifyStoryInvitationCategory(story);
+  const region = publication.regionLabel.trim() || publication.name.trim();
+  const coverage = publication.coverageText?.trim() || (publication.towns && publication.towns.length > 0 ? publication.towns.slice(0, 3).join(", ") : region);
+  switch (category) {
+    case "celebrations":
+      return {
+        category,
+        eyebrow: `${region} Community`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Discover more people and milestones worth celebrating.",
+        description: `${region} is full of stories worth celebrating. Discover the people, places, events, and milestones shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+    case "local_businesses":
+      return {
+        category,
+        eyebrow: `${region} Local Businesses`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Meet the entrepreneurs building your community.",
+        description: `Discover the founders, independent shops, places, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More local stories in ${region}`
+      };
+    case "education":
+      return {
+        category,
+        eyebrow: `${region} Schools & Youth`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Follow achievements from local students and schools.",
+        description: `Discover the students, educators, neighborhood milestones, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+    case "community_events":
+      return {
+        category,
+        eyebrow: `${region} Events & Gatherings`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Find something happening near you this weekend.",
+        description: `Discover the people, places, weekend gatherings, and local stories shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `Happening around ${region}`
+      };
+    case "neighborhood_news":
+      return {
+        category,
+        eyebrow: `${region} Neighborhood Briefing`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Stay informed about changes affecting your neighborhood.",
+        description: `Follow the civic decisions, neighborhood projects, people, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More from ${region}`
+      };
+    case "community":
+    default:
+      return {
+        category: "community",
+        eyebrow: `${region} Community`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Discover the people, places, and events shaping your community.",
+        description: `Receive local reporting on the people, places, events, and stories shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+  }
+}
+function isSponsoredStoryItem(item) {
+  const markers = [
+    item.section ?? "",
+    ...(item.tags ?? []).map((t) => `${t.name} ${t.slug}`),
+    ...(item.categories ?? []).map((c) => `${c.name} ${c.slug}`)
+  ].join(" ");
+  return SPONSORED_MARKER_PATTERN.test(markers);
+}
+function normalizedCoverIdentity(item) {
+  const raw = item.cover_image_url?.trim();
+  if (!raw) return null;
+  if (item.visual_identity?.version === 1 && /^[a-f0-9]{64}$/u.test(item.visual_identity.key)) {
+    return `pixels:${item.visual_identity.key}`;
+  }
+  try {
+    const url = new URL(raw);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return null;
+    url.hash = "";
+    url.searchParams.sort();
+    return `url:${url.toString()}`;
+  } catch {
+    return null;
+  }
+}
+function selectRelevantLocalStories(currentStory, candidates, publication, limit = 3) {
+  if (limit <= 0) return [];
+  const currentSection = resolveSection(currentStory);
+  const pubTowns = Array.isArray(publication.towns) ? publication.towns : [];
+  const currentTowns = new Set(storyTowns(currentStory, pubTowns).map((t) => t.toLowerCase()));
+  const currentTags = /* @__PURE__ */ new Set([
+    ...(currentStory.tags ?? []).map((t) => t.name.toLowerCase()),
+    ...(currentStory.categories ?? []).map((c) => c.name.toLowerCase())
+  ]);
+  const primaryRegion = publication.regionLabel.trim().toLowerCase();
+  const seenIds = /* @__PURE__ */ new Set([currentStory.id]);
+  const seenSlugs = /* @__PURE__ */ new Set([currentStory.slug]);
+  const usedCovers = /* @__PURE__ */ new Set();
+  const currentCover = normalizedCoverIdentity(currentStory);
+  if (currentCover) usedCovers.add(currentCover);
+  const scored = candidates.filter((item) => {
+    if (!item?.id || !item?.slug) return false;
+    if (seenIds.has(item.id) || seenSlugs.has(item.slug)) return false;
+    if (isSponsoredStoryItem(item)) return false;
+    return true;
+  }).map((item) => {
+    let score = 0;
+    const cover = normalizedCoverIdentity(item);
+    if (cover) score += 40;
+    const itemTowns = storyTowns(item, pubTowns).map((t) => t.toLowerCase());
+    if (itemTowns.some((t) => currentTowns.has(t))) {
+      score += 25;
+    } else if (primaryRegion && `${item.title} ${item.excerpt ?? ""}`.toLowerCase().includes(primaryRegion)) {
+      score += 18;
+    }
+    const section = resolveSection(item);
+    if (section === currentSection) {
+      score += 20;
+    } else if (["Community", "Events", "Schools", "Local businesses", "Food & places"].includes(section)) {
+      score += 12;
+    }
+    const itemTags = [
+      ...(item.tags ?? []).map((t) => t.name.toLowerCase()),
+      ...(item.categories ?? []).map((c) => c.name.toLowerCase())
+    ];
+    const sharedTags = itemTags.filter((t) => currentTags.has(t)).length;
+    score += Math.min(sharedTags * 8, 16);
+    if (CELEBRATION_PATTERN.test(`${item.title} ${item.excerpt ?? ""}`)) {
+      score += 6;
+    }
+    const parsedTime = Date.parse(item.published_at);
+    const publishedMs = Number.isFinite(parsedTime) ? parsedTime : 0;
+    return { item: { ...item, section }, cover, score, publishedMs };
+  }).sort((a, b) => b.score - a.score || b.publishedMs - a.publishedMs);
+  const selected = [];
+  for (const entry of scored) {
+    if (selected.length >= limit) break;
+    if (seenIds.has(entry.item.id) || seenSlugs.has(entry.item.slug)) continue;
+    if (entry.cover && usedCovers.has(entry.cover)) continue;
+    seenIds.add(entry.item.id);
+    seenSlugs.add(entry.item.slug);
+    if (entry.cover) usedCovers.add(entry.cover);
+    selected.push(entry.item);
+  }
+  return selected;
+}
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, ArticleProvenance, EDITORIAL_SECTION_ORDER, EVENTS, LOCAL_BRIEFING_POLICY_VERSION, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/package.json

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

package/tokens/broadsheet.css

@@ -508,12 +508,15 @@
   .publication [class*="sectionCollection"] > [class*="section"]:only-child [class*="sectionFeature"],
   .publication [class*="sectionCollection"] > [class*="section"]:last-child:nth-child(odd) [class*="sectionFeature"] {
     display: block;
+    grid-column: auto;
+    grid-row: auto;
   }
 
   .publication [class*="sectionCollection"] > [class*="section"]:only-child [class*="sectionSupporting"],
   .publication [class*="sectionCollection"] > [class*="section"]:last-child:nth-child(odd) [class*="sectionSupporting"] {
     display: grid;
-    grid-template-columns: minmax(0, 1fr);
+    grid-column: auto;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
     gap: 20px;
     align-content: start;
   }