@rmdes/indiekit-endpoint-microsub 1.0.66 → 1.0.67

package/lib/feeds/normalizer-rss.js

@@ -62,6 +62,19 @@ export function normalizeItem(item, feedUrl, feedType) {
     };
   }
 
+  // Item-level <source> (RSS 2.0) — per-item origin in aggregator feeds
+  // (e.g. a community feed where every item comes from a different user's
+  // feed). Feedparser exposes it as { url, title }.
+  if (item.source && (item.source.url || item.source.title)) {
+    normalized._source.itemSource = {
+      url: item.source.url,
+      title: item.source.title,
+    };
+    if (!normalized.author && item.source.title) {
+      normalized.author = { type: "card", name: item.source.title };
+    }
+  }
+
   // Categories/tags
   if (item.categories && item.categories.length > 0) {
     normalized.category = item.categories;

package/lib/feeds/source-meta.js

@@ -0,0 +1,46 @@
+/**
+ * Resolve metadata (name, photo, site url) of an item-level <source> feed.
+ * Aggregator feeds attribute each item to its originating feed via the
+ * RSS 2.0 <source url="..."> element; fetching that feed's channel image
+ * gives us the author's avatar. Results are cached in memory so each
+ * distinct source feed is fetched at most once per TTL.
+ * @module feeds/source-meta
+ */
+
+import { fetchAndParseFeed } from "./fetcher.js";
+
+const TTL = 24 * 60 * 60 * 1000; // 24h — feed titles/avatars change rarely
+const MAX_CACHE_ENTRIES = 500;
+
+/** @type {Map<string, { promise: Promise<object|undefined>, fetchedAt: number }>} */
+const cache = new Map();
+
+/**
+ * Resolve a source feed's metadata, cached
+ * @param {string} url - Source feed URL
+ * @returns {Promise<object|undefined>} { name, photo, url } or undefined on failure
+ */
+export async function resolveSourceFeedMeta(url) {
+  const now = Date.now();
+  const hit = cache.get(url);
+  if (hit && now - hit.fetchedAt < TTL) {
+    return hit.promise;
+  }
+
+  // ponytail: crude full-clear eviction; LRU if churn ever matters
+  if (cache.size >= MAX_CACHE_ENTRIES) {
+    cache.clear();
+  }
+
+  const promise = fetchAndParseFeed(url, { timeout: 10_000 })
+    .then((parsed) => ({
+      name: parsed.name,
+      photo: parsed.photo,
+      url: parsed.url,
+    }))
+    // Failures are cached too (negative cache) — avoids hammering dead feeds
+    .catch(() => {});
+
+  cache.set(url, { promise, fetchedAt: now });
+  return promise;
+}

package/lib/polling/processor.js

@@ -9,6 +9,7 @@ const MAX_ITEMS_PER_CYCLE = 100; // Max items to process per feed per cycle
 import { getRedisClient, publishEvent } from "../cache/redis.js";
 import { detectCapabilities } from "../feeds/capabilities.js";
 import { fetchAndParseFeed } from "../feeds/fetcher.js";
+import { resolveSourceFeedMeta } from "../feeds/source-meta.js";
 import { getChannelById } from "../storage/channels.js";
 import {
   updateFeed,
@@ -100,6 +101,22 @@ export async function processFeed(application, feed) {
         item._source.source_type = classifyUrl(feed.url).type;
       }
 
+      // Aggregator feeds: item-level <source> names the originating feed.
+      // Resolve its channel image/homepage (cached, one fetch per source
+      // feed per day) so the card shows the actual author's avatar.
+      const itemSource = item._source.itemSource;
+      if (itemSource?.url && !item.author?.photo) {
+        const meta = await resolveSourceFeedMeta(itemSource.url);
+        if (meta) {
+          item.author = {
+            type: "card",
+            name: item.author?.name || itemSource.title || meta.name,
+            url: item.author?.url || meta.url,
+            photo: meta.photo,
+          };
+        }
+      }
+
       // Store the item
       const stored = await addItem(application, {
         channelId: feed.channelId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-microsub",
-  "version": "1.0.66",
+  "version": "1.0.67",
   "description": "Microsub endpoint for Indiekit. Enables subscribing to feeds and reading content using the Microsub protocol.",
   "keywords": [
     "indiekit",