@scalemule/news-publication 0.0.81 → 0.0.83

package/dist/article-workflow-client.js

@@ -898,142 +898,34 @@ var PublicationArticleClient = class {
       "If-Match": String(generation)
     });
   }
-  /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-   * replay the same operation key to inspect/reuse staged contributions before another transfer.
-   * Editorial approval and release are always separate explicit operations. */
-  async submitArticle(input) {
-    if (input.document.media?.length)
-      throw new Error(
-        "Pass file assets separately when creating an article package"
-      );
-    const capabilities = await this.options();
-    if (capabilities.workflow_version !== 1)
-      throw new Error("Unsupported article workflow version");
-    if (input.assets?.length && !capabilities.capabilities.managed_private_asset_upload)
-      throw new Error("Managed article upload is not deployed");
-    const created = await this.create(
-      input.operationKey,
-      input.authorProfileId,
-      input.document,
-      input.reviewPolicy
-    );
-    try {
-      const selected = [];
-      for (const asset of input.assets ?? []) {
-        let current = await this.get(created.article_id);
-        const digest3 = Array.from(
-          new Uint8Array(
-            await crypto.subtle.digest(
-              "SHA-256",
-              await asset.file.arrayBuffer()
-            )
-          )
-        ).map((v) => v.toString(16).padStart(2, "0")).join("");
-        const existing = current.contributions.find(
-          (c) => c.kind === "MEDIA" && c.state !== "REJECTED" && c.state !== "WITHDRAWN" && c.payload.sha256 === digest3 && Object.entries(asset.metadata).every(
-            ([k, v]) => c.payload[k] === v
-          )
-        );
-        const staged = existing?.payload.file_id ? { contribution_id: existing.id, file_id: existing.payload.file_id } : await this.upload(
-          created.article_id,
-          current.generation,
-          asset.file,
-          asset.filename,
-          asset.metadata
-        );
-        await this.registerPhoto(staged.file_id);
-        if (input.approveMedia) {
-          if (!asset.metadata.rights_confirmed || asset.metadata.private_preview_only)
-            throw new Error("Publication requires confirmed image rights");
-          if (existing?.state !== "APPROVED") {
-            current = await this.get(created.article_id);
-            await this.command(created.article_id, current.generation, {
-              action: "RESOLVE",
-              contribution_id: staged.contribution_id,
-              state: "APPROVED"
-            });
-          }
-          selected.push({
-            kind: "image",
-            contribution_id: staged.contribution_id,
-            file_id: staged.file_id,
-            caption: asset.metadata.caption,
-            credit: asset.metadata.credit,
-            alt: asset.metadata.alt,
-            position: asset.position
-          });
-        }
-      }
-      if (selected.length) {
-        const current = await this.get(created.article_id);
-        const document = { ...input.document, media: selected };
-        const saved = current.revisions.find(
-          (r) => r.id === current.current_revision_id
-        )?.document;
-        if (!saved) throw new Error("Current immutable revision is missing");
-        if (sameDocument(saved, document))
-          return {
-            ...created,
-            revision_id: current.current_revision_id,
-            generation: current.generation,
-            editorial_status: current.status,
-            replayed: true
-          };
-        if (!sameDocument(
-          { ...saved, media: [] },
-          { ...input.document, media: [] }
-        ) || saved.media?.length)
-          throw new ArticleWorkflowError(
-            "The article was edited after this package began; load its current revision before changing it",
-            409,
-            created.article_id
-          );
-        return await this.save(
-          `${input.operationKey}:assets`,
-          created.article_id,
-          current.generation,
-          document,
-          "MEDIA_UPDATE"
-        );
-      }
-      return created;
-    } catch (error) {
-      if (error instanceof ArticleWorkflowError) {
-        error.articleId = created.article_id;
-        throw error;
-      }
-      throw new ArticleWorkflowError(
-        error instanceof Error ? error.message : "Article package interrupted",
-        0,
-        created.article_id
-      );
-    }
+  /** One server-owned submission. No client-side Photo/TTS orchestration and no
+   * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+   * Replay the identical manifest/files/key after an uncertain acknowledgement.
+   */
+  submit(manifest, operationKey, files = [], signal) {
+    if (!operationKey) throw new Error("A stable operation key is required");
+    if (files.length > 10 || files.some((f) => f.file.size < 1 || f.file.size > 25 * 1024 * 1024) || files.reduce((n, f) => n + f.file.size, 0) > 50 * 1024 * 1024) throw new Error("Supply up to ten photographs, at most 25 MiB each and 50 MiB total");
+    const slots = new Set(files.map((f) => f.slot));
+    if (slots.size !== files.length || files.length !== (manifest.assets?.length ?? 0) || manifest.assets?.some((a) => !slots.has(a.slot))) throw new Error("Supply one file for each declared asset slot");
+    if (!files.length) return this.request("/submissions", "POST", manifest, { "Idempotency-Key": operationKey }, signal);
+    const form = new FormData();
+    form.append("manifest", JSON.stringify(manifest));
+    for (const asset of files) form.append(asset.slot, asset.file, asset.filename);
+    return this.request("/submissions", "POST", form, { "Idempotency-Key": operationKey }, signal);
+  }
+  submission(submissionId, signal) {
+    return this.request("/submissions/" + encodeURIComponent(submissionId), "GET", void 0, void 0, signal);
+  }
+  submitArticle(input) {
+    if (input.document.media?.length) throw new Error("Pass file assets separately when creating an article package");
+    const assets = (input.assets ?? []).map((a, i) => ({ ...a, slot: "asset_" + String.fromCharCode(97 + i) }));
+    return this.submit({
+      article: { operation: "create", author_profile_id: input.authorProfileId, document: input.document, review_policy: input.reviewPolicy },
+      intent: input.intent ?? "draft",
+      approve_media: input.approveMedia,
+      assets: assets.map((a) => ({ slot: a.slot, position: a.position, metadata: a.metadata }))
+    }, input.operationKey, assets);
   }
 };
-function sameDocument(a, b) {
-  const sorted = (v) => Array.isArray(v) ? v.map(sorted) : v && typeof v === "object" ? Object.fromEntries(Object.keys(v).sort().map((k) => [k, sorted(v[k])])) : v;
-  const canonical3 = (d) => [
-    d.title,
-    d.subtitle || "",
-    d.content_markdown,
-    d.excerpt ?? null,
-    sorted(d.cards ?? null),
-    sorted(d.citations ?? null),
-    d.section,
-    d.community || "",
-    d.format || null,
-    d.layout ? [d.layout.id, d.layout.version] : null,
-    (d.media || []).map((m) => [
-      m.kind || "image",
-      m.contribution_id,
-      m.file_id,
-      m.caption,
-      m.credit,
-      m.alt,
-      m.position
-    ])
-  ];
-  return JSON.stringify(canonical3(a)) === JSON.stringify(canonical3(b));
-}
 
 export { ArticleEditOperationError, ArticlePhotoOperationError, ArticleWorkflowError, PublicationArticleClient, articleEditHtmlMatches, articlePhotoHtmlMatches };

package/dist/index.cjs

@@ -829,8 +829,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"),
@@ -3633,6 +3636,198 @@ function articleFormatLabel(format) {
   return format === "opinion" ? "Opinion" : format === "explainer" ? "Explainer" : format === "interview" ? "Interview" : format === "photo_essay" ? "Photo essay" : format === "video_story" ? "Video story" : void 0;
 }
 
+// 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;
+}
+
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
   get: function () { return compliance.COOKIE_CONSENT_BACKUP_KEY; }
@@ -3731,6 +3926,7 @@ Object.defineProperty(exports, "setNetworkConsentHub", {
 });
 exports.ANALYTICS_COOKIE = ANALYTICS_COOKIE;
 exports.ANALYTICS_VERSION = ANALYTICS_VERSION;
+exports.ARTICLE_CONVERSION_EXPERIMENT = ARTICLE_CONVERSION_EXPERIMENT;
 exports.ArticleProvenance = ArticleProvenance;
 exports.BROADSHEET_THEME = BROADSHEET_THEME;
 exports.CLASSIFIED_CATEGORIES = CLASSIFIED_CATEGORIES;
@@ -3787,12 +3983,14 @@ exports.canHostMeetup = canHostMeetup;
 exports.categoryLabel = categoryLabel;
 exports.classifiedPath = classifiedPath;
 exports.classifiedSearchPath = classifiedSearchPath;
+exports.classifyStoryInvitationCategory = classifyStoryInvitationCategory;
 exports.clearTheme = clearTheme;
 exports.clipChars = clipChars;
 exports.communityMapEmbeds = communityMapEmbeds;
 exports.communityPublications = communityPublications;
 exports.composeEdition = composeEdition;
 exports.composeLocalBriefing = composeLocalBriefing;
+exports.contextualCommunityInvitation = contextualCommunityInvitation;
 exports.dealDollars = dealDollars;
 exports.dealGoPath = dealGoPath;
 exports.dealsFeedPath = dealsFeedPath;
@@ -3818,6 +4016,7 @@ exports.isAdult = isAdult;
 exports.isClassifiedCategory = isClassifiedCategory;
 exports.isEmploymentType = isEmploymentType;
 exports.isSafeActionUrl = isSafeActionUrl;
+exports.isSponsoredStoryItem = isSponsoredStoryItem;
 exports.jobEmployerBody = jobEmployerBody;
 exports.jobOpeningBody = jobOpeningBody;
 exports.jobPostingBody = jobPostingBody;
@@ -3850,6 +4049,7 @@ exports.readerSources = readerSources;
 exports.recordConsentToCompliance = recordConsentToCompliance;
 exports.referralCode = referralCode;
 exports.renderArticleBlocksToHtml = renderArticleBlocksToHtml;
+exports.resolveArticleConversionVariant = resolveArticleConversionVariant;
 exports.resolveCoupon = resolveCoupon;
 exports.resolveEffectiveTheme = resolveEffectiveTheme;
 exports.resolveLayout = resolveLayout;
@@ -3863,6 +4063,7 @@ exports.secretsMatch = secretsMatch;
 exports.sectionDefinition = sectionDefinition;
 exports.sectionId = sectionId;
 exports.sectionPath = sectionPath;
+exports.selectRelevantLocalStories = selectRelevantLocalStories;
 exports.setTheme = setTheme;
 exports.shortDeck = shortDeck;
 exports.shortText = shortText;

package/dist/index.d.cts

@@ -624,4 +624,54 @@ interface SponsorshipReport {
 /** Shared by the newsroom print/export view and the repeatable PDF renderer. */
 declare function campaignReportHtml(report: SponsorshipReport): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+declare const ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+type ArticleConversionVariant = "control" | "treatment";
+type CommunityInvitationCategory = "celebrations" | "local_businesses" | "education" | "neighborhood_news" | "community_events" | "community";
+interface ContextualCommunityInvitation {
+    category: CommunityInvitationCategory;
+    eyebrow: string;
+    heading: string;
+    subprompt: string;
+    description: string;
+    ctaLabel: string;
+    relatedHeading: string;
+}
+/**
+ * Resolves the `article_conversion_module` experiment variant consistently.
+ * Supports query-parameter preview overrides (`?conversion=treatment` or `?conversion=control`)
+ * before falling back to the assigned ScaleMule flag variant (`"control"` default).
+ */
+declare function resolveArticleConversionVariant(assignedVariant?: string | null, queryOverride?: string | null): ArticleConversionVariant;
+/**
+ * Infers the reader-facing community invitation category from a story's section,
+ * tags, categories, headline, and excerpt.
+ */
+declare function classifyStoryInvitationCategory(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">): CommunityInvitationCategory;
+/**
+ * Builds a publication-aware, category-tailored invitation that connects the reader's
+ * reason for visiting a specific article to staying connected with the local community.
+ */
+interface CommunityInvitationPublicationContext {
+    name: string;
+    regionLabel: string;
+    coverageText?: string;
+    towns?: string[];
+}
+declare function contextualCommunityInvitation(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">, publication: CommunityInvitationPublicationContext): ContextualCommunityInvitation;
+/**
+ * Returns true if a story carries any sponsored, paid, or partner-content markers.
+ * Editorial recommendation slots must never mix unlabeled sponsored items.
+ */
+declare function isSponsoredStoryItem(item: NewsItem): boolean;
+/**
+ * Selects 2–3 relevant local editorial stories for the post-prose Community Conversion Module.
+ *
+ * Rules:
+ * - Never includes the current story or duplicate story IDs/slugs.
+ * - Never includes sponsored/paid items (`isSponsoredStoryItem`).
+ * - Deduplicates cover images so recommended cards never repeat the current story's cover or each other's cover.
+ * - Prioritizes stories with valid cover photographs, shared town/geographic relevance, and community/section affinity.
+ */
+declare function selectRelevantLocalStories(currentStory: NewsItem, candidates: NewsItem[], publication: Pick<NewsPublication, "regionLabel" | "towns">, limit?: number): NewsItem[];
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -624,4 +624,54 @@ interface SponsorshipReport {
 /** Shared by the newsroom print/export view and the repeatable PDF renderer. */
 declare function campaignReportHtml(report: SponsorshipReport): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+declare const ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+type ArticleConversionVariant = "control" | "treatment";
+type CommunityInvitationCategory = "celebrations" | "local_businesses" | "education" | "neighborhood_news" | "community_events" | "community";
+interface ContextualCommunityInvitation {
+    category: CommunityInvitationCategory;
+    eyebrow: string;
+    heading: string;
+    subprompt: string;
+    description: string;
+    ctaLabel: string;
+    relatedHeading: string;
+}
+/**
+ * Resolves the `article_conversion_module` experiment variant consistently.
+ * Supports query-parameter preview overrides (`?conversion=treatment` or `?conversion=control`)
+ * before falling back to the assigned ScaleMule flag variant (`"control"` default).
+ */
+declare function resolveArticleConversionVariant(assignedVariant?: string | null, queryOverride?: string | null): ArticleConversionVariant;
+/**
+ * Infers the reader-facing community invitation category from a story's section,
+ * tags, categories, headline, and excerpt.
+ */
+declare function classifyStoryInvitationCategory(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">): CommunityInvitationCategory;
+/**
+ * Builds a publication-aware, category-tailored invitation that connects the reader's
+ * reason for visiting a specific article to staying connected with the local community.
+ */
+interface CommunityInvitationPublicationContext {
+    name: string;
+    regionLabel: string;
+    coverageText?: string;
+    towns?: string[];
+}
+declare function contextualCommunityInvitation(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">, publication: CommunityInvitationPublicationContext): ContextualCommunityInvitation;
+/**
+ * Returns true if a story carries any sponsored, paid, or partner-content markers.
+ * Editorial recommendation slots must never mix unlabeled sponsored items.
+ */
+declare function isSponsoredStoryItem(item: NewsItem): boolean;
+/**
+ * Selects 2–3 relevant local editorial stories for the post-prose Community Conversion Module.
+ *
+ * Rules:
+ * - Never includes the current story or duplicate story IDs/slugs.
+ * - Never includes sponsored/paid items (`isSponsoredStoryItem`).
+ * - Deduplicates cover images so recommended cards never repeat the current story's cover or each other's cover.
+ * - Prioritizes stories with valid cover photographs, shared town/geographic relevance, and community/section affinity.
+ */
+declare function selectRelevantLocalStories(currentStory: NewsItem, candidates: NewsItem[], publication: Pick<NewsPublication, "regionLabel" | "towns">, limit?: number): NewsItem[];
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };