Changeset 75bda38 in Klonkt

Timestamp:

06/25/2026 06:54:59 AM (3 months ago)

Author:

Robin Genis <roboburr@…>

Branches:

main

Children:

f1e0c1f

Parents:

abb34d2

Message:

feat(fediverse): expose pinned posts via the actor's featured collection

Adds actor.featured + GET /ap/users/:slug/featured (OrderedCollection of pinned,
published, non-fan_only posts as Notes, ordered by pin rank). Mastodon reads this
and shows them under the profile's Featured tab.

Co-Authored-By: Claude <noreply@…>

Location:

src

Files:

• routes/activitypub.js (modified) (2 diffs)
• services/ActivityPubService.js (modified) (3 diffs)

src/routes/activitypub.js

@@ -6 +6 @@
  *   GET /ap/users/:slug/outbox     OrderedCollection of Create(Note)
  *   GET /ap/users/:slug/followers  count-only OrderedCollection
+ *   GET /ap/users/:slug/featured   pinned posts (Mastodon "Featured" tab)
  *   GET /ap/notes/:id              a single Note
  *   POST /ap/users/:slug/inbox, /ap/inbox  → 202 (Follow/Accept + signature verify: next step)
@@ -72 +73 @@
 });
 
+// ── Featured (pinned posts → Mastodon "Featured" tab) ─────────────
+router.get('/ap/users/:slug/featured', (req, res) => {
+  const site = publicSite(req.params.slug);
+  if (!site) return res.status(404).end();
+  const posts = db.prepare(
+    `SELECT id, slug, title, content, cover_image_url, published_at, created_at
+     FROM posts WHERE site_id = ? AND status = 'published' AND (fan_only IS NULL OR fan_only = 0)
+       AND pinned IS NOT NULL AND pinned > 0
+     ORDER BY pinned ASC, COALESCE(published_at, created_at) DESC LIMIT 20`
+  ).all(site.id);
+  AP.sendAP(res, AP.buildFeatured(baseUrl(req), site, posts));
+});
+
 // ── Note ──────────────────────────────────────────────────────────
 router.get('/ap/notes/:id', (req, res) => {

src/services/ActivityPubService.js

@@ -83 +83 @@
     outbox: `${id}/outbox`,
     followers: `${id}/followers`,
+    featured: `${id}/featured`,
     endpoints: { sharedInbox: `${base}/ap/inbox` },
     publicKey: {
@@ -240 +241 @@
     totalItems: count || 0,
     orderedItems: [], // hidden for privacy; count only
+  };
+}
+
+// Pinned posts → the actor's `featured` collection. Mastodon reads this and shows
+// these as the "Featured" tab (pinned to the profile). Posts come ordered by pin
+// rank; embedded as full Notes so a remote server doesn't need extra fetches.
+export function buildFeatured(base, site, posts) {
+  const id = `${actorId(base, site.slug)}/featured`;
+  const items = (posts || []).map((p) => buildNote(base, site, p));
+  return {
+    '@context': 'https://www.w3.org/ns/activitystreams',
+    id,
+    type: 'OrderedCollection',
+    totalItems: items.length,
+    orderedItems: items,
   };
 }
@@ -968 +984 @@
 export default {
   getOrCreateKeys, apWants, sendAP, actorId, noteId,
-  buildActor, buildNote, buildCreate, buildOutbox, buildFollowers,
+  buildActor, buildNote, buildCreate, buildOutbox, buildFollowers, buildFeatured,
   followerCount, deliver, fetchActor, verifyRequest, handleInbox, deliverCreate, deliverDelete, deliverUpdate,
   getInteractions, getInteractionById, buildReplyNote, getOutboxNote, deliverReply, resolveRemoteNote,