@scalemule/news-publication 0.0.66 → 0.0.67

package/README.md

@@ -301,3 +301,7 @@ users by email or forward one application’s reader token/API key to another.
 Provision and verify each RP before enabling sign-in or contribution flags.
 
 The publisher-supplied `PawMark` preserves the approved SVG paths. Hosts may set `--paw-logo-ink` and `--paw-logo-heart` on their `.paw` scope; the defaults follow the accessible page foreground and coral accent.
+
+### Homepage image identity
+
+`NewsItem.visual_identity` is a versioned public identity from the Blog feed. `composeEdition` allocates covers across the entire bounded inventory, gives the selected lead priority, and holds repeated covers as `null` without dropping stories or mutating inputs. Never re-add duplicate images as fallback. Legacy Photo rendition URLs are normalized by tenant/asset ID; server-side Photo identity detects copies under different IDs and ordinary resize/re-encoding/crop variants. Do not fetch or decode images in page components. Preserve existing caption/credit policy. See platform `docs/HOMEPAGE-PHOTO-IDENTITY.md` for storage, rights, concurrency and rollout tests.

package/dist/index.cjs

@@ -158,42 +158,72 @@ function editorialSections(items) {
   }
   return Array.from(groups, ([name, articles]) => ({ ...sectionDefinition(name), items: articles }));
 }
+function coverIdentity(item) {
+  if (!item.cover_image_url?.trim()) return null;
+  const identity = item.visual_identity;
+  if (identity?.version === 1 && /^[a-f0-9]{64}$/u.test(identity.key)) return `pixels:${identity.key}`;
+  try {
+    const url = new URL(item.cover_image_url.trim());
+    if (url.protocol !== "https:" || url.username || url.password) return null;
+    if (url.hostname === "cdn-public.scalemule.com") {
+      const match = url.pathname.match(/^\/([a-f0-9-]{36})\/anonymous\/photos\/([a-f0-9-]{36})\//iu);
+      if (match) return `photo:${match[1].toLowerCase()}:${match[2].toLowerCase()}`;
+    }
+    if (["api.scalemule.com", "gw.scalemule.com"].includes(url.hostname)) {
+      const match = url.pathname.match(/^\/v1\/photos\/public\/([a-f0-9-]{36})(?:\/|$)/iu);
+      if (match) return `photo-public:${match[1].toLowerCase()}`;
+    }
+    url.hash = "";
+    url.searchParams.sort();
+    return `url:${url.toString()}`;
+  } catch {
+    return null;
+  }
+}
 function composeEdition(items, selection = {}, now = Date.now()) {
   const seen = /* @__PURE__ */ new Set();
-  const inventory = items.filter((item) => {
+  let inventory = items.slice(0, 200).filter((item) => {
     if (!item.id || !item.slug || seen.has(item.id)) return false;
     seen.add(item.id);
     return true;
   });
   const pins = !selection.pinned_until || Date.parse(selection.pinned_until) > now ? selection : {};
-  const lead = inventory.find((item) => item.slug === pins.lead_slug) ?? inventory[0];
-  const remaining = inventory.filter((item) => item !== lead);
+  const selectedLead = inventory.find((item) => item.slug === pins.lead_slug) ?? inventory[0];
+  const rest = inventory.filter((item) => item !== selectedLead);
   const requested = new Set(pins.secondary_slugs ?? []);
   const ordered = [
-    ...(pins.secondary_slugs ?? []).flatMap((slug) => remaining.find((item) => item.slug === slug) ?? []),
-    ...remaining.filter((item) => !requested.has(item.slug))
+    ...(pins.secondary_slugs ?? []).flatMap((slug) => rest.find((item) => item.slug === slug) ?? []),
+    ...rest.filter((item) => !requested.has(item.slug))
   ];
-  const uniqueOrdered = Array.from(new Map(ordered.map((item) => [item.id, item])).values());
+  const originalOrder = Array.from(new Map(ordered.map((item) => [item.id, item])).values());
   const seenImages = /* @__PURE__ */ new Set();
-  if (lead?.cover_image_url?.trim()) {
-    seenImages.add(lead.cover_image_url.trim());
+  const duplicateImages = /* @__PURE__ */ new Set();
+  const display = /* @__PURE__ */ new Map();
+  for (const item of [selectedLead, ...originalOrder]) {
+    if (!item) continue;
+    const key = coverIdentity(item);
+    if (key && seenImages.has(key)) {
+      duplicateImages.add(item.id);
+      display.set(item.id, { ...item, cover_image_url: null });
+    } else {
+      display.set(item.id, item);
+      if (key) seenImages.add(key);
+    }
   }
+  inventory = inventory.map((item) => display.get(item.id));
+  const lead = selectedLead ? display.get(selectedLead.id) : void 0;
+  let remaining = rest.map((item) => display.get(item.id));
+  const uniqueOrdered = originalOrder.map((item) => display.get(item.id));
   const secondary = [];
-  const deferredWithDuplicateImage = [];
+  const deferred = [];
   for (const item of uniqueOrdered) {
     if (secondary.length >= 3) break;
-    const img = item.cover_image_url?.trim();
-    if (img && seenImages.has(img)) {
-      deferredWithDuplicateImage.push(item);
-    } else {
-      secondary.push(item);
-      if (img) seenImages.add(img);
-    }
-  }
-  while (secondary.length < 3 && deferredWithDuplicateImage.length > 0) {
-    secondary.push(deferredWithDuplicateImage.shift());
+    if (duplicateImages.has(item.id)) deferred.push(item);
+    else secondary.push(item);
   }
-  for (const item of secondary) remaining.splice(remaining.indexOf(item), 1);
+  while (secondary.length < 3 && deferred.length > 0) secondary.push(deferred.shift());
+  const secondaryIds = new Set(secondary.map((item) => item.id));
+  remaining = remaining.filter((item) => !secondaryIds.has(item.id));
   const eligible2 = remaining.filter((item) => {
     const age = now - Date.parse(item.published_at);
     return item.excerpt?.trim() && age >= 0 && age <= 7 * 864e5;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-DBi49N8m.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-DBi49N8m.cjs';
+import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-22lEf_UU.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-22lEf_UU.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-CO9Unz5M.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-qj4BeNzB.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-BBTow5Bn.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, consentModel, decorateNetworkUrl, effectivePreferences, getCookieConsent, hasConsented, impliedPreferences, isCategoryAllowed, isGeoConsentRequired, queryNetworkConsentHub, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from '@scalemule/compliance';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.cjs';
@@ -237,9 +237,9 @@ declare function sectionId(name: string): string;
 declare function sectionPath(name: string): string;
 declare function sectionDefinition(name: string): EditorialSection;
 declare function editorialSections(items: NewsItem[]): EditorialSection[];
-/** Published inventory only. Selection never duplicates or fabricates a story. */
+/** Published inventory only. All image-bearing slots share one allocation. */
 declare function composeEdition(items: NewsItem[], selection?: HomepageSelection, now?: number): {
-    lead: NewsItem;
+    lead: NewsItem | undefined;
     secondary: NewsItem[];
     briefs: NewsItem[];
     compact: NewsItem[];

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-DBi49N8m.js';
-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-DBi49N8m.js';
+import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-22lEf_UU.js';
+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-22lEf_UU.js';
 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-BWpxY20X.js';
 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.js';
-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-CjP7bSXJ.js';
+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-CHdsfUnU.js';
 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, consentModel, decorateNetworkUrl, effectivePreferences, getCookieConsent, hasConsented, impliedPreferences, isCategoryAllowed, isGeoConsentRequired, queryNetworkConsentHub, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from '@scalemule/compliance';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.js';
@@ -237,9 +237,9 @@ declare function sectionId(name: string): string;
 declare function sectionPath(name: string): string;
 declare function sectionDefinition(name: string): EditorialSection;
 declare function editorialSections(items: NewsItem[]): EditorialSection[];
-/** Published inventory only. Selection never duplicates or fabricates a story. */
+/** Published inventory only. All image-bearing slots share one allocation. */
 declare function composeEdition(items: NewsItem[], selection?: HomepageSelection, now?: number): {
-    lead: NewsItem;
+    lead: NewsItem | undefined;
     secondary: NewsItem[];
     briefs: NewsItem[];
     compact: NewsItem[];

package/dist/index.js

@@ -101,42 +101,72 @@ function editorialSections(items) {
   }
   return Array.from(groups, ([name, articles]) => ({ ...sectionDefinition(name), items: articles }));
 }
+function coverIdentity(item) {
+  if (!item.cover_image_url?.trim()) return null;
+  const identity = item.visual_identity;
+  if (identity?.version === 1 && /^[a-f0-9]{64}$/u.test(identity.key)) return `pixels:${identity.key}`;
+  try {
+    const url = new URL(item.cover_image_url.trim());
+    if (url.protocol !== "https:" || url.username || url.password) return null;
+    if (url.hostname === "cdn-public.scalemule.com") {
+      const match = url.pathname.match(/^\/([a-f0-9-]{36})\/anonymous\/photos\/([a-f0-9-]{36})\//iu);
+      if (match) return `photo:${match[1].toLowerCase()}:${match[2].toLowerCase()}`;
+    }
+    if (["api.scalemule.com", "gw.scalemule.com"].includes(url.hostname)) {
+      const match = url.pathname.match(/^\/v1\/photos\/public\/([a-f0-9-]{36})(?:\/|$)/iu);
+      if (match) return `photo-public:${match[1].toLowerCase()}`;
+    }
+    url.hash = "";
+    url.searchParams.sort();
+    return `url:${url.toString()}`;
+  } catch {
+    return null;
+  }
+}
 function composeEdition(items, selection = {}, now = Date.now()) {
   const seen = /* @__PURE__ */ new Set();
-  const inventory = items.filter((item) => {
+  let inventory = items.slice(0, 200).filter((item) => {
     if (!item.id || !item.slug || seen.has(item.id)) return false;
     seen.add(item.id);
     return true;
   });
   const pins = !selection.pinned_until || Date.parse(selection.pinned_until) > now ? selection : {};
-  const lead = inventory.find((item) => item.slug === pins.lead_slug) ?? inventory[0];
-  const remaining = inventory.filter((item) => item !== lead);
+  const selectedLead = inventory.find((item) => item.slug === pins.lead_slug) ?? inventory[0];
+  const rest = inventory.filter((item) => item !== selectedLead);
   const requested = new Set(pins.secondary_slugs ?? []);
   const ordered = [
-    ...(pins.secondary_slugs ?? []).flatMap((slug) => remaining.find((item) => item.slug === slug) ?? []),
-    ...remaining.filter((item) => !requested.has(item.slug))
+    ...(pins.secondary_slugs ?? []).flatMap((slug) => rest.find((item) => item.slug === slug) ?? []),
+    ...rest.filter((item) => !requested.has(item.slug))
   ];
-  const uniqueOrdered = Array.from(new Map(ordered.map((item) => [item.id, item])).values());
+  const originalOrder = Array.from(new Map(ordered.map((item) => [item.id, item])).values());
   const seenImages = /* @__PURE__ */ new Set();
-  if (lead?.cover_image_url?.trim()) {
-    seenImages.add(lead.cover_image_url.trim());
+  const duplicateImages = /* @__PURE__ */ new Set();
+  const display = /* @__PURE__ */ new Map();
+  for (const item of [selectedLead, ...originalOrder]) {
+    if (!item) continue;
+    const key = coverIdentity(item);
+    if (key && seenImages.has(key)) {
+      duplicateImages.add(item.id);
+      display.set(item.id, { ...item, cover_image_url: null });
+    } else {
+      display.set(item.id, item);
+      if (key) seenImages.add(key);
+    }
   }
+  inventory = inventory.map((item) => display.get(item.id));
+  const lead = selectedLead ? display.get(selectedLead.id) : void 0;
+  let remaining = rest.map((item) => display.get(item.id));
+  const uniqueOrdered = originalOrder.map((item) => display.get(item.id));
   const secondary = [];
-  const deferredWithDuplicateImage = [];
+  const deferred = [];
   for (const item of uniqueOrdered) {
     if (secondary.length >= 3) break;
-    const img = item.cover_image_url?.trim();
-    if (img && seenImages.has(img)) {
-      deferredWithDuplicateImage.push(item);
-    } else {
-      secondary.push(item);
-      if (img) seenImages.add(img);
-    }
-  }
-  while (secondary.length < 3 && deferredWithDuplicateImage.length > 0) {
-    secondary.push(deferredWithDuplicateImage.shift());
+    if (duplicateImages.has(item.id)) deferred.push(item);
+    else secondary.push(item);
   }
-  for (const item of secondary) remaining.splice(remaining.indexOf(item), 1);
+  while (secondary.length < 3 && deferred.length > 0) secondary.push(deferred.shift());
+  const secondaryIds = new Set(secondary.map((item) => item.id));
+  remaining = remaining.filter((item) => !secondaryIds.has(item.id));
   const eligible2 = remaining.filter((item) => {
     const age = now - Date.parse(item.published_at);
     return item.excerpt?.trim() && age >= 0 && age <= 7 * 864e5;

package/dist/{snapshot-qj4BeNzB.d.cts → snapshot-BBTow5Bn.d.cts}

@@ -1,4 +1,4 @@
-import { P as PublicationInput, N as NewsPublication } from './types-DBi49N8m.cjs';
+import { P as PublicationInput, N as NewsPublication } from './types-22lEf_UU.cjs';
 
 /**
  * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)

package/dist/{snapshot-CjP7bSXJ.d.ts → snapshot-CHdsfUnU.d.ts}

@@ -1,4 +1,4 @@
-import { P as PublicationInput, N as NewsPublication } from './types-DBi49N8m.js';
+import { P as PublicationInput, N as NewsPublication } from './types-22lEf_UU.js';
 
 /**
  * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)

package/dist/snapshot-file.d.cts

@@ -1,5 +1,5 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-qj4BeNzB.cjs';
-import './types-DBi49N8m.cjs';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-BBTow5Bn.cjs';
+import './types-22lEf_UU.cjs';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/snapshot-file.d.ts

@@ -1,5 +1,5 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-CjP7bSXJ.js';
-import './types-DBi49N8m.js';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-CHdsfUnU.js';
+import './types-22lEf_UU.js';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/{types-DBi49N8m.d.cts → types-22lEf_UU.d.cts}

@@ -100,6 +100,11 @@ type NewsItem = {
     title: string;
     excerpt: string | null;
     cover_image_url: string | null;
+    /** Versioned canonical pixel identity supplied by the publication owner. */
+    visual_identity?: {
+        version: number;
+        key: string;
+    } | null;
     published_at: string;
     updated_at: string;
     reading_time_minutes: number;

package/dist/{types-DBi49N8m.d.ts → types-22lEf_UU.d.ts}

@@ -100,6 +100,11 @@ type NewsItem = {
     title: string;
     excerpt: string | null;
     cover_image_url: string | null;
+    /** Versioned canonical pixel identity supplied by the publication owner. */
+    visual_identity?: {
+        version: number;
+        key: string;
+    } | null;
     published_at: string;
     updated_at: string;
     reading_time_minutes: number;

package/dist/verified-card.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { V as VerifiedCard } from './types-DBi49N8m.cjs';
+import { V as VerifiedCard } from './types-22lEf_UU.cjs';
 
 /**
  * Validate that an action link is safe for readers.

package/dist/verified-card.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { V as VerifiedCard } from './types-DBi49N8m.js';
+import { V as VerifiedCard } from './types-22lEf_UU.js';
 
 /**
  * Validate that an action link is safe for readers.

package/package.json

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