@rmdes/indiekit-endpoint-activitypub 2.5.5 → 2.6.1

package/assets/reader-blurhash.js

@@ -0,0 +1,66 @@
+/**
+ * Blurhash placeholder backgrounds for gallery images.
+ *
+ * Extracts the average (DC) color from a blurhash string and applies it
+ * as a background-color on images with a data-blurhash attribute.
+ * This provides a meaningful colored placeholder while images load.
+ *
+ * The DC component is encoded in the first 4 characters of the blurhash
+ * after the size byte, as a base-83 integer representing an sRGB color.
+ */
+
+const BASE83_CHARS =
+  "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz#$%*+,-.:;=?@[]^_{|}~";
+
+function decode83(str) {
+  let value = 0;
+  for (const c of str) {
+    const digit = BASE83_CHARS.indexOf(c);
+    if (digit === -1) return 0;
+    value = value * 83 + digit;
+  }
+  return value;
+}
+
+function decodeDC(value) {
+  return {
+    r: (value >> 16) & 255,
+    g: (value >> 8) & 255,
+    b: value & 255,
+  };
+}
+
+function blurhashToColor(hash) {
+  if (!hash || hash.length < 6) return null;
+  const dcValue = decode83(hash.slice(1, 5));
+  const { r, g, b } = decodeDC(dcValue);
+  return `rgb(${r},${g},${b})`;
+}
+
+document.addEventListener("DOMContentLoaded", () => {
+  for (const img of document.querySelectorAll("img[data-blurhash]")) {
+    const color = blurhashToColor(img.dataset.blurhash);
+    if (color) {
+      img.style.backgroundColor = color;
+    }
+  }
+
+  // Handle dynamically loaded images (infinite scroll)
+  const observer = new MutationObserver((mutations) => {
+    for (const mutation of mutations) {
+      for (const node of mutation.addedNodes) {
+        if (node.nodeType !== 1) continue;
+        const imgs = node.querySelectorAll
+          ? node.querySelectorAll("img[data-blurhash]")
+          : [];
+        for (const img of imgs) {
+          const color = blurhashToColor(img.dataset.blurhash);
+          if (color) {
+            img.style.backgroundColor = color;
+          }
+        }
+      }
+    }
+  });
+  observer.observe(document.body, { childList: true, subtree: true });
+});

package/assets/reader-links.css

@@ -15,16 +15,16 @@
 .ap-link-preview {
   display: flex;
   overflow: hidden;
-  border-radius: var(--border-radius-small);
+  border-radius: 8px;
   border: 1px solid var(--color-neutral-lighter);
   background-color: var(--color-offset);
   text-decoration: none;
   color: inherit;
-  transition: border-color 0.2s ease;
+  transition: border-color 0.15s ease;
 }
 
 .ap-link-preview:hover {
-  border-color: var(--color-primary);
+  border-color: var(--color-outline-variant);
 }
 
 /* Text content area (left side) */

package/assets/reader.css

@@ -150,10 +150,11 @@
 .ap-card {
   background: var(--color-offset);
   border: var(--border-width-thin) solid var(--color-outline);
-  border-left: var(--border-width-thickest) solid var(--color-outline);
-  border-radius: var(--border-radius-small);
+  border-left: 3px solid var(--color-outline);
+  border-radius: 8px;
   overflow: hidden;
   padding: var(--space-m);
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
   transition:
     box-shadow 0.2s ease,
     border-color 0.2s ease;
@@ -162,6 +163,7 @@
 .ap-card:hover {
   border-color: var(--color-outline-variant);
   border-left-color: var(--color-outline-variant);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
 }
 
 /* ==========================================================================
@@ -263,9 +265,9 @@
   border: var(--border-width-thin) solid var(--color-outline);
   border-radius: 50%;
   flex-shrink: 0;
-  height: 40px;
+  height: 44px;
   object-fit: cover;
-  width: 40px;
+  width: 44px;
 }
 
 .ap-card__avatar--default {
@@ -282,10 +284,12 @@
   display: flex;
   flex-direction: column;
   flex: 1;
+  gap: 1px;
   min-width: 0;
 }
 
 .ap-card__author-name {
+  font-size: 0.95em;
   font-weight: 600;
   overflow: hidden;
   text-overflow: ellipsis;
@@ -301,6 +305,21 @@
   text-decoration: underline;
 }
 
+.ap-card__bot-badge {
+  display: inline-block;
+  font-size: 0.6rem;
+  font-weight: 700;
+  line-height: 1;
+  padding: 0.15em 0.35em;
+  margin-left: 0.3em;
+  border: var(--border-width-thin) solid var(--color-on-offset);
+  border-radius: var(--border-radius-small);
+  color: var(--color-on-offset);
+  vertical-align: middle;
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+
 .ap-card__author-handle {
   color: var(--color-on-offset);
   font-size: var(--font-size-s);
@@ -312,12 +331,20 @@
 .ap-card__timestamp {
   color: var(--color-on-offset);
   flex-shrink: 0;
+  font-size: var(--font-size-s);
+}
+
+.ap-card__edited {
   font-size: var(--font-size-xs);
+  margin-left: 0.2em;
 }
 
 .ap-card__timestamp-link {
   color: inherit;
   text-decoration: none;
+  display: flex;
+  align-items: center;
+  gap: 0;
 }
 
 .ap-card__timestamp-link:hover {
@@ -351,7 +378,7 @@
 
 .ap-card__content {
   color: var(--color-on-background);
-  line-height: var(--line-height-prose);
+  line-height: calc(4 / 3 * 1em);
   margin-bottom: var(--space-s);
   overflow-wrap: break-word;
   word-break: break-word;
@@ -481,7 +508,7 @@
    ========================================================================== */
 
 .ap-card__gallery {
-  border-radius: var(--border-radius-small);
+  border-radius: 6px;
   display: grid;
   gap: 2px;
   margin-bottom: var(--space-s);
@@ -501,9 +528,14 @@
 .ap-card__gallery img {
   background: var(--color-offset-variant);
   display: block;
-  height: 200px;
+  height: 220px;
   object-fit: cover;
   width: 100%;
+  transition: filter 0.2s ease;
+}
+
+.ap-card__gallery-link:hover img {
+  filter: brightness(0.92);
 }
 
 .ap-card__gallery-link--more::after {
@@ -534,7 +566,7 @@
 
 .ap-card__gallery--1 img {
   height: auto;
-  max-height: 400px;
+  max-height: 500px;
 }
 
 /* 2 photos — side by side */
@@ -706,6 +738,30 @@
   opacity: 0.7;
 }
 
+/* Hashtag stuffing collapse */
+.ap-hashtag-overflow {
+  margin: var(--space-xs) 0;
+  font-size: var(--font-size-s);
+}
+
+.ap-hashtag-overflow summary {
+  cursor: pointer;
+  color: var(--color-on-offset);
+  list-style: none;
+}
+
+.ap-hashtag-overflow summary::before {
+  content: "▸ ";
+}
+
+.ap-hashtag-overflow[open] summary::before {
+  content: "▾ ";
+}
+
+.ap-hashtag-overflow p {
+  margin-top: var(--space-xs);
+}
+
 /* ==========================================================================
    Interaction Buttons
    ========================================================================== */
@@ -714,60 +770,86 @@
   border-top: var(--border-width-thin) solid var(--color-outline);
   display: flex;
   flex-wrap: wrap;
-  gap: var(--space-s);
+  gap: 2px;
   padding-top: var(--space-s);
 }
 
 .ap-card__action {
   align-items: center;
   background: transparent;
-  border: var(--border-width-thin) solid var(--color-outline);
-  border-radius: var(--border-radius-small);
+  border: 0;
+  border-radius: 6px;
   color: var(--color-on-offset);
   cursor: pointer;
   display: inline-flex;
   font-size: var(--font-size-s);
-  gap: var(--space-xs);
-  padding: var(--space-xs) var(--space-s);
+  gap: 0.3em;
+  min-height: 36px;
+  padding: 0.25em 0.6em;
   text-decoration: none;
-  transition: all 0.2s ease;
+  transition:
+    background-color 0.15s ease,
+    color 0.15s ease;
 }
 
 .ap-card__action:hover {
   background: var(--color-offset-variant);
-  border-color: var(--color-outline-variant);
   color: var(--color-on-background);
 }
 
-/* Active interaction states — using Indiekit's color palette */
+/* Color-coded hover states per action type */
+.ap-card__action--reply:hover {
+  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
+  color: var(--color-primary);
+}
+
+.ap-card__action--boost:hover {
+  background: color-mix(in srgb, var(--color-green50) 12%, transparent);
+  color: var(--color-green50);
+}
+
+.ap-card__action--like:hover {
+  background: color-mix(in srgb, var(--color-red45) 12%, transparent);
+  color: var(--color-red45);
+}
+
+.ap-card__action--link:hover {
+  background: var(--color-offset-variant);
+  color: var(--color-on-background);
+}
+
+.ap-card__action--save:hover {
+  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
+  color: var(--color-primary);
+}
+
+/* Active interaction states */
 .ap-card__action--like.ap-card__action--active {
-  background: var(--color-red90);
-  border-color: var(--color-red45);
+  background: color-mix(in srgb, var(--color-red45) 12%, transparent);
   color: var(--color-red45);
 }
 
 .ap-card__action--boost.ap-card__action--active {
-  background: var(--color-green90);
-  border-color: var(--color-green50);
+  background: color-mix(in srgb, var(--color-green50) 12%, transparent);
   color: var(--color-green50);
 }
 
 .ap-card__action--save.ap-card__action--active {
-  background: #4a9eff22;
-  border-color: #4a9eff;
-  color: #4a9eff;
+  background: color-mix(in srgb, var(--color-primary) 12%, transparent);
+  color: var(--color-primary);
 }
 
 .ap-card__action:disabled {
   cursor: wait;
-  opacity: 0.6;
+  opacity: 0.5;
 }
 
 /* Interaction counts */
 .ap-card__count {
   font-size: var(--font-size-xs);
-  color: var(--color-on-offset);
-  margin-left: 0.25rem;
+  color: inherit;
+  opacity: 0.7;
+  margin-left: 0.1em;
   font-variant-numeric: tabular-nums;
 }
 
@@ -2489,9 +2571,14 @@
 
 .ap-quote-embed {
   border: var(--border-width-thin) solid var(--color-outline);
-  border-radius: var(--border-radius-small);
+  border-radius: 8px;
   margin-top: var(--space-s);
   overflow: hidden;
+  transition: border-color 0.15s ease;
+}
+
+.ap-quote-embed:hover {
+  border-color: var(--color-outline-variant);
 }
 
 .ap-quote-embed--pending {
@@ -2506,7 +2593,7 @@
 }
 
 .ap-quote-embed__link:hover {
-  background: var(--color-offset);
+  background: color-mix(in srgb, var(--color-offset) 50%, transparent);
 }
 
 .ap-quote-embed__author {
@@ -2571,8 +2658,8 @@
 .ap-quote-embed__content {
   color: var(--color-on-background);
   font-size: var(--font-size-s);
-  line-height: 1.5;
-  max-height: calc(1.5em * 6);
+  line-height: calc(4 / 3 * 1em);
+  max-height: calc(1.333em * 6);
   overflow: hidden;
 }
 

package/lib/content-utils.js

@@ -0,0 +1,72 @@
+/**
+ * Content post-processing utilities.
+ * Applied after sanitization and emoji replacement in the item pipeline.
+ */
+
+/**
+ * Shorten displayed URLs in <a> tags that exceed maxLength.
+ * Keeps the full URL in href, only truncates the visible text.
+ *
+ * Example: <a href="https://example.com/very/long/path">https://example.com/very/long/path</a>
+ *       → <a href="https://example.com/very/long/path" title="https://example.com/very/long/path">example.com/very/lon…</a>
+ *
+ * @param {string} html - Sanitized HTML content
+ * @param {number} [maxLength=30] - Max visible URL length before truncation
+ * @returns {string} HTML with shortened display URLs
+ */
+export function shortenDisplayUrls(html, maxLength = 30) {
+  if (!html) return html;
+
+  // Match <a ...>URL text</a> where the visible text looks like a URL
+  return html.replace(
+    /(<a\s[^>]*>)(https?:\/\/[^<]+)(<\/a>)/gi,
+    (match, openTag, urlText, closeTag) => {
+      if (urlText.length <= maxLength) return match;
+
+      // Strip protocol for display
+      const display = urlText.replace(/^https?:\/\//, "");
+      const truncated = display.slice(0, maxLength - 1) + "\u2026";
+
+      // Add title attribute with full URL for hover tooltip (if not already present)
+      let tag = openTag;
+      if (!tag.includes("title=")) {
+        tag = tag.replace(/>$/, ` title="${urlText}">`);
+      }
+
+      return `${tag}${truncated}${closeTag}`;
+    },
+  );
+}
+
+/**
+ * Collapse paragraphs that are mostly hashtag links (hashtag stuffing).
+ * Detects <p> blocks where 80%+ of the text content is hashtag links
+ * and wraps them in a <details> element.
+ *
+ * @param {string} html - Sanitized HTML content
+ * @param {number} [minTags=3] - Minimum number of hashtag links to trigger collapse
+ * @returns {string} HTML with hashtag-heavy paragraphs collapsed
+ */
+export function collapseHashtagStuffing(html, minTags = 3) {
+  if (!html) return html;
+
+  // Match <p> blocks
+  return html.replace(/<p>([^]*?)<\/p>/gi, (match, inner) => {
+    // Count hashtag links: <a ...>#something</a> or plain #word
+    const hashtagLinks = inner.match(/<a[^>]*>#[^<]+<\/a>/gi) || [];
+    if (hashtagLinks.length < minTags) return match;
+
+    // Calculate what fraction of text content is hashtags
+    const textOnly = inner.replace(/<[^>]*>/g, "").trim();
+    const hashtagText = hashtagLinks
+      .map((link) => link.replace(/<[^>]*>/g, "").trim())
+      .join(" ");
+
+    // If hashtags make up 80%+ of the text content, collapse
+    if (hashtagText.length / Math.max(textOnly.length, 1) >= 0.8) {
+      return `<details class="ap-hashtag-overflow"><summary>Show ${hashtagLinks.length} tags</summary><p>${inner}</p></details>`;
+    }
+
+    return match;
+  });
+}

package/lib/controllers/explore-utils.js

@@ -119,12 +119,14 @@ export function mapMastodonStatusToItem(status, instance) {
     summary: status.spoiler_text || "",
     sensitive: status.sensitive || false,
     published: status.created_at || new Date().toISOString(),
+    updated: status.edited_at || "",
     author: {
       name: sanitizeHtml(account.display_name || account.username || "Unknown", { allowedTags: [], allowedAttributes: {} }),
       url: account.url || "",
       photo: account.avatar || account.avatar_static || "",
       handle,
       emojis: authorEmojis,
+      bot: account.bot || false,
     },
     category,
     mentions,

package/lib/item-processing.js

@@ -8,6 +8,7 @@
 
 import { stripQuoteReferenceHtml } from "./og-unfurl.js";
 import { replaceCustomEmoji } from "./emoji-utils.js";
+import { shortenDisplayUrls, collapseHashtagStuffing } from "./content-utils.js";
 
 /**
  * Post-process timeline items for rendering.
@@ -31,7 +32,10 @@ export async function postProcessItems(items, options = {}) {
   // 3. Replace custom emoji shortcodes with <img> tags
   applyCustomEmoji(items);
 
-  // 4. Build interaction map (likes/boosts) — empty when no collection
+  // 4. Shorten long URLs and collapse hashtag stuffing in content
+  applyContentEnhancements(items);
+
+  // 5. Build interaction map (likes/boosts) — empty when no collection
   const interactionMap = options.interactionsCol
     ? await buildInteractionMap(items, options.interactionsCol)
     : {};
@@ -154,6 +158,24 @@ function applyCustomEmoji(items) {
   }
 }
 
+/**
+ * Shorten long URLs and collapse hashtag-heavy paragraphs in content.
+ * Mutates items in place.
+ *
+ * @param {Array} items
+ */
+function applyContentEnhancements(items) {
+  for (const item of items) {
+    if (item.content?.html) {
+      item.content.html = shortenDisplayUrls(item.content.html);
+      item.content.html = collapseHashtagStuffing(item.content.html);
+    }
+    if (item.quote?.content?.html) {
+      item.quote.content.html = shortenDisplayUrls(item.quote.content.html);
+    }
+  }
+}
+
 /**
  * Build interaction map (likes/boosts) for template rendering.
  * Returns { [uid]: { like: true, boost: true } }.

package/lib/timeline-store.js

@@ -3,7 +3,7 @@
  * @module timeline-store
  */
 
-import { Article, Emoji, Hashtag, Mention } from "@fedify/fedify/vocab";
+import { Article, Application, Emoji, Hashtag, Mention, Service } from "@fedify/fedify/vocab";
 import sanitizeHtml from "sanitize-html";
 
 /**
@@ -101,7 +101,10 @@ export async function extractActorInfo(actor, options = {}) {
     // Emoji extraction failed — non-critical
   }
 
-  return { name, url, photo, handle, emojis };
+  // Bot detection — Service and Application actors are automated accounts
+  const bot = actor instanceof Service || actor instanceof Application;
+
+  return { name, url, photo, handle, emojis, bot };
 }
 
 /**
@@ -154,6 +157,9 @@ export async function extractObjectData(object, options = {}) {
     ? String(object.published)
     : new Date().toISOString();
 
+  // Edited date — non-null when the post has been updated after publishing
+  const updated = object.updated ? String(object.updated) : "";
+
   // Extract author — try multiple strategies in order of reliability
   const loaderOpts = options.documentLoader ? { documentLoader: options.documentLoader } : {};
   let authorObj = null;
@@ -304,6 +310,7 @@ export async function extractObjectData(object, options = {}) {
     summary,
     sensitive,
     published,
+    updated,
     author,
     category,
     mentions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-activitypub",
-  "version": "2.5.5",
+  "version": "2.6.1",
   "description": "ActivityPub federation endpoint for Indiekit via Fedify. Adds full fediverse support: actor, inbox, outbox, followers, following, syndication, and Mastodon migration.",
   "keywords": [
     "indiekit",

package/views/layouts/ap-reader.njk

@@ -19,6 +19,8 @@
 
   {# AP link interception for internal navigation #}
   <script defer src="/assets/@rmdes-indiekit-endpoint-activitypub/reader-links.js"></script>
+  {# Blurhash placeholder backgrounds for gallery images #}
+  <script defer src="/assets/@rmdes-indiekit-endpoint-activitypub/reader-blurhash.js"></script>
 
   {% if readerParent %}
   <nav class="ap-breadcrumb" aria-label="Breadcrumb">

package/views/partials/ap-item-card.njk

@@ -53,6 +53,7 @@
         {% else %}
           <span>{% if item.author.nameHtml %}{{ item.author.nameHtml | safe }}{% else %}{{ item.author.name or "Unknown" }}{% endif %}</span>
         {% endif %}
+        {% if item.author.bot %}<span class="ap-card__bot-badge" title="Bot account">BOT</span>{% endif %}
       </div>
       {% if item.author.handle %}
         <div class="ap-card__author-handle">{{ item.author.handle }}</div>
@@ -63,6 +64,7 @@
         <time datetime="{{ item.published }}" class="ap-card__timestamp" x-data x-relative-time>
           {{ item.published | date("PPp") }}
         </time>
+        {% if item.updated %}<span class="ap-card__edited" title="{{ item.updated | date('PPp') }}">✏️</span>{% endif %}
       </a>
     {% endif %}
   </header>

package/views/partials/ap-item-media.njk

@@ -10,10 +10,18 @@
       {# Support both old string format and new object format #}
       {% set photoSrc = photo.url if photo.url else photo %}
       {% set photoAlt = photo.alt if photo.alt else "" %}
+      {% set photoBlurhash = photo.blurhash if photo.blurhash else "" %}
+      {# Focus-point cropping: convert -1..1 range to CSS object-position percentages #}
+      {% set focusStyle = "" %}
+      {% if photo.focus and photo.focus.x != null and photo.focus.y != null %}
+        {% set fpX = ((photo.focus.x + 1) / 2 * 100) %}
+        {% set fpY = ((1 - (photo.focus.y + 1) / 2) * 100) %}
+        {% set focusStyle = "object-position:" + fpX + "% " + fpY + "%;" %}
+      {% endif %}
       {% if loop.index0 < 4 %}
         <div class="ap-card__gallery-item" x-data="{ showAlt: false }">
           <button type="button" @click="idx = {{ loop.index0 }}; lightbox = true" class="ap-card__gallery-link{% if loop.index0 == 3 and extraCount > 0 %} ap-card__gallery-link--more{% endif %}">
-            <img src="{{ photoSrc }}" alt="{{ photoAlt }}" loading="lazy">
+            <img src="{{ photoSrc }}" alt="{{ photoAlt }}" loading="lazy"{% if focusStyle %} style="{{ focusStyle }}"{% endif %}{% if photoBlurhash %} data-blurhash="{{ photoBlurhash }}"{% endif %}>
             {% if loop.index0 == 3 and extraCount > 0 %}
               <span class="ap-card__gallery-more">+{{ extraCount }}</span>
             {% endif %}

package/views/partials/ap-quote-embed.njk

@@ -26,8 +26,14 @@
       {% endif %}
       {% if item.quote.photo and item.quote.photo.length > 0 %}
         {% set qPhoto = item.quote.photo[0] %}
+        {% set qFocusStyle = "" %}
+        {% if qPhoto.focus and qPhoto.focus.x != null and qPhoto.focus.y != null %}
+          {% set qFpX = ((qPhoto.focus.x + 1) / 2 * 100) %}
+          {% set qFpY = ((1 - (qPhoto.focus.y + 1) / 2) * 100) %}
+          {% set qFocusStyle = "object-position:" + qFpX + "% " + qFpY + "%;" %}
+        {% endif %}
         <div class="ap-quote-embed__media">
-          <img src="{{ qPhoto.url if qPhoto.url else qPhoto }}" alt="{{ qPhoto.alt if qPhoto.alt else '' }}" loading="lazy" class="ap-quote-embed__photo">
+          <img src="{{ qPhoto.url if qPhoto.url else qPhoto }}" alt="{{ qPhoto.alt if qPhoto.alt else '' }}" loading="lazy" class="ap-quote-embed__photo"{% if qFocusStyle %} style="{{ qFocusStyle }}"{% endif %}>
         </div>
       {% endif %}
     </a>