source: Klonkt/src/services/ActivityPubService.js@ bea59a1

main
Last change on this file since bea59a1 was bea59a1, checked in by roboburr <roboburr@…>, 2 months ago

feat(federation): keep the Cirkel in sync the AP way — inbound Update + outbox backfill

Two AP-native mechanisms so the Cirkel/timeline stays fresh without a custom poll loop:

  • Inbound Update(Note/Article): a remote edit now refreshes the cached ap_timeline row (and a cached fediverse reply), scoped to the signing actor so B can't edit A's note. Live edit-sync via push — selfHeal was a version-bump workaround for not having this handler.
  • backfillFromOutbox(slug, actorUri): pulls an actor's standard AP outbox and merges their recent top-level posts into the timeline. Fired fire-and-forget when you feature an account (setAutoBoost on) or follow+feature in one step. Covers what push cannot: history from before you followed and deliveries missed while down. PULL ONLY — sends nothing to the fediverse (consistent with the no-auto-fediverse rule).
  • src/services/ActivityPubService.js — Update handler in handleInbox; apGetJson + backfillFromOutbox; wired into setAutoBoost + followActor; exported

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

  • Property mode set to 100644
File size: 96.8 KB
RevLine 
[6bd25d1]1/**
2 * ActivityPubService — Klonkt as a real ActivityPub actor (fediverse bridge).
3 *
4 * Phase 1 (this file): the PUBLISH/discoverable side.
5 * - per-site RSA keypair (Mastodon-compatible HTTP Signatures; separate from
6 * the Ed25519 keys used by the lighter Cirkels v1)
7 * - builders for the Actor document, Note objects and the Outbox collection
8 * - apWants(): HTTP content-negotiation helper (activity+json vs HTML)
9 *
10 * The interactive side (inbox: Follow/Accept, signature verify, delivery to
11 * followers) lands in the next step and is tested live against Mastodon.
12 *
13 * AP actor URLs live under /ap/* so they never clash with the human pages:
14 * actor = <base>/ap/users/<slug>
15 * inbox = <actor>/inbox outbox = <actor>/outbox
16 * note = <base>/ap/notes/<postId>
17 */
18import crypto from 'crypto';
[3dd99d3]19import dns from 'dns';
20import net from 'net';
[6bd25d1]21import db from '../config/database.js';
[c16e0a5]22import HtmlSanitizerService from './HtmlSanitizerService.js';
[6bd25d1]23
24const PUBLIC = 'https://www.w3.org/ns/activitystreams#Public';
[d3b9f68]25// Full JSON-LD context for every AP object we emit: AS2 core + security (publicKey) + the
26// extension terms we actually use (Mastodon/toot + schema.org), each with a term definition
27// so a strict JSON-LD processor resolves them instead of dropping them → valid AS2/JSON-LD.
28// This is the same context shape Mastodon publishes, so Mastodon sees no change.
29const AP_CONTEXT = [
30 'https://www.w3.org/ns/activitystreams',
31 'https://w3id.org/security/v1',
32 {
33 toot: 'http://joinmastodon.org/ns#',
34 schema: 'http://schema.org#',
35 sensitive: 'as:sensitive',
36 Hashtag: 'as:Hashtag',
37 manuallyApprovesFollowers: 'as:manuallyApprovesFollowers',
38 discoverable: 'toot:discoverable',
39 featured: { '@id': 'toot:featured', '@type': '@id' },
40 PropertyValue: 'schema:PropertyValue',
41 value: 'schema:value',
42 embedUrl: { '@id': 'schema:embedUrl', '@type': '@id' },
43 },
44];
[3dd99d3]45
46// Short random suffix so two activity ids minted in the same millisecond (e.g.
47// parallel saves) don't collide and get deduped by a receiver.
48const rid = () => crypto.randomBytes(4).toString('hex');
49
50// Keep only http(s) URLs — drops javascript:/data:/etc so a remote actor can't
51// smuggle a dangerous scheme into a stored href/src (rendered in owner-only views).
52const safeUrl = (u) => { const s = String(u == null ? '' : u).trim(); return /^https?:\/\//i.test(s) ? s : ''; };
53
54// ── SSRF guard for outbound fetches ───────────────────────────────
55// Remote URLs (actor/keyId/webfinger/inbox/inReplyTo) are attacker-controlled, so
56// every outbound fetch must refuse hosts that resolve to private/loopback ranges
57// (cloud metadata, internal services) — on the initial host AND each redirect hop.
58function isBlockedIp(ip) {
59 if (!ip) return true;
60 const v = net.isIP(ip);
61 if (v === 4) {
62 const o = ip.split('.').map(Number);
63 return o[0] === 127 || o[0] === 10 || o[0] === 0
64 || (o[0] === 172 && o[1] >= 16 && o[1] <= 31)
65 || (o[0] === 192 && o[1] === 168)
66 || (o[0] === 169 && o[1] === 254)
67 || (o[0] === 100 && o[1] >= 64 && o[1] <= 127); // CGNAT
68 }
69 if (v === 6) {
70 const s = ip.toLowerCase().replace(/^\[|\]$/g, '');
71 return s === '::1' || s === '::' || s.startsWith('fc') || s.startsWith('fd') || s.startsWith('fe80')
72 || s.startsWith('::ffff:127.') || s.startsWith('::ffff:10.') || s.startsWith('::ffff:192.168.')
73 || s.startsWith('::ffff:169.254.') || s.startsWith('::ffff:172.');
74 }
75 return true; // not an IP literal we recognise → refuse
76}
77async function assertPublicHost(hostname) {
78 if (net.isIP(hostname)) { if (isBlockedIp(hostname)) throw new Error('ssrf-blocked-ip'); return; }
79 const addrs = await dns.promises.lookup(hostname, { all: true });
80 if (!addrs.length || addrs.some((a) => isBlockedIp(a.address))) throw new Error('ssrf-blocked-host');
81}
[74c5abc]82export async function safeFetch(url, opts = {}, maxRedirects = 3) {
[3dd99d3]83 let target = url;
84 for (let hop = 0; ; hop++) {
85 const u = new URL(target); // throws on malformed → caller's catch
86 if (u.protocol !== 'https:' && u.protocol !== 'http:') throw new Error('ssrf-bad-scheme');
87 await assertPublicHost(u.hostname);
88 const r = await fetch(target, { ...opts, redirect: 'manual', signal: AbortSignal.timeout(8000) });
89 const loc = (r.status >= 300 && r.status < 400) ? r.headers.get('location') : null;
90 if (loc && hop < maxRedirects) { target = new URL(loc, target).toString(); continue; }
91 return r;
92 }
93}
[6bd25d1]94const MAX_OUTBOX = 20;
[5085b1d]95// Cache-buster for the music listen-link → forces Mastodon to re-crawl a FRESH
96// (square) player card. Bump this whenever the twitter:player card dimensions change.
97const FEDI_CARD_VER = '2';
[6bd25d1]98
99// ── RSA keys per actor (lazy, cached in DB) ───────────────────────
100// Prepared lazily (NOT at module load) — the ap_keys table is created in
101// initializeDatabase(), which runs after this module is imported.
102let _sel, _ins;
103function keyStmts() {
104 if (!_sel) {
105 _sel = db.prepare('SELECT public_pem, private_pem FROM ap_keys WHERE slug = ?');
106 _ins = db.prepare('INSERT OR IGNORE INTO ap_keys (slug, public_pem, private_pem, created_at) VALUES (?,?,?,CURRENT_TIMESTAMP)');
107 }
108 return { sel: _sel, ins: _ins };
109}
110
111export function getOrCreateKeys(slug) {
112 const { sel, ins } = keyStmts();
113 const row = sel.get(slug);
114 if (row) return row;
115 const { publicKey, privateKey } = crypto.generateKeyPairSync('rsa', {
116 modulusLength: 2048,
117 publicKeyEncoding: { type: 'spki', format: 'pem' },
118 privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
119 });
120 ins.run(slug, publicKey, privateKey);
121 return sel.get(slug) || { public_pem: publicKey, private_pem: privateKey };
122}
123
124// ── content negotiation ───────────────────────────────────────────
125// True when the caller wants ActivityPub JSON rather than the HTML page.
126export function apWants(req) {
127 const a = String(req.headers.accept || '').toLowerCase();
128 return a.includes('application/activity+json') ||
129 (a.includes('application/ld+json') && a.includes('activitystreams'));
130}
131
132const AP_CONTENT_TYPE = 'application/activity+json; charset=utf-8';
133export function sendAP(res, obj) {
134 res.type(AP_CONTENT_TYPE);
135 res.set('Cache-Control', 'public, max-age=120');
136 res.send(JSON.stringify(obj));
137}
138
139// ── document builders ─────────────────────────────────────────────
140export function actorId(base, slug) { return `${base}/ap/users/${encodeURIComponent(slug)}`; }
141export function noteId(base, postId) { return `${base}/ap/notes/${encodeURIComponent(postId)}`; }
142
143export function buildActor(base, site) {
144 const id = actorId(base, site.slug);
145 const keys = getOrCreateKeys(site.slug);
146 const actor = {
[d3b9f68]147 '@context': AP_CONTEXT,
[6bd25d1]148 id,
149 type: 'Person',
150 preferredUsername: site.slug,
151 name: site.title || site.slug,
152 summary: site.tagline || site.description || '',
153 url: `${base}/${site.slug === site.primary_slug ? '' : 'user/' + encodeURIComponent(site.slug)}`,
154 manuallyApprovesFollowers: false,
155 discoverable: true,
156 inbox: `${id}/inbox`,
157 outbox: `${id}/outbox`,
158 followers: `${id}/followers`,
[f2796d3]159 following: `${id}/following`,
[75bda38]160 featured: `${id}/featured`,
[6bd25d1]161 endpoints: { sharedInbox: `${base}/ap/inbox` },
162 publicKey: {
163 id: `${id}#main-key`,
164 owner: id,
165 publicKeyPem: keys.public_pem,
166 },
167 };
168 if (site.profile_photo) {
169 const u = /^https?:/.test(site.profile_photo) ? site.profile_photo : `${base}${site.profile_photo.startsWith('/') ? '' : '/'}${site.profile_photo}`;
170 actor.icon = { type: 'Image', url: u };
171 }
[f2796d3]172 // Account creation date — shown by Mastodon + read by indexers (additive, standard AS2).
173 if (site.created_at) { try { actor.published = new Date(site.created_at).toISOString(); } catch { /* skip bad date */ } }
174 // Profile links → PropertyValue rows: Mastodon/PeerTube/WordPress-ActivityPub render these as
175 // profile metadata (rel=me enables link-back verification). Additive; ignored by simpler receivers.
176 try {
177 const links = JSON.parse(site.profile_links || '[]');
178 if (Array.isArray(links) && links.length) {
179 const esc = (s) => String(s).replace(/[<>&]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' }[c]));
180 const rows = links
181 .filter((l) => l && l.url && /^https?:/i.test(l.url))
182 .map((l) => ({
183 type: 'PropertyValue',
184 name: esc(l.platform || 'Link'),
185 value: `<a href="${esc(l.url).replace(/"/g, '&quot;')}" rel="me nofollow noopener" target="_blank">${esc(String(l.url).replace(/^https?:\/\//, ''))}</a>`,
186 }));
187 if (rows.length) actor.attachment = rows;
188 }
189 } catch { /* skip malformed profile_links */ }
[6bd25d1]190 return actor;
191}
192
[30271e6]193// Does a post's audio shortcodes reference at least one PLAYABLE (file-backed)
194// track? Link-only tracks (external Spotify/YouTube, media_id NULL) don't count —
195// they have no Klonkt-hosted audio to embed, so no player card / cover-suppression.
196export function hasPlayableAudio(content, siteId) {
197 if (!content || !/\[\[(track|album|playlist):/i.test(content)) return false;
198 try {
199 for (const m of content.matchAll(/\[\[track:([A-Za-z0-9_-]+)\]\]/g)) { const r = db.prepare('SELECT media_id FROM audio_tracks WHERE id = ?').get(m[1]); if (r && r.media_id) return true; }
200 for (const m of content.matchAll(/\[\[album:([^\]]+)\]\]/g)) { if (db.prepare('SELECT 1 FROM audio_tracks WHERE site_id = ? AND album = ? AND media_id IS NOT NULL LIMIT 1').get(siteId, m[1].trim())) return true; }
201 for (const m of content.matchAll(/\[\[playlist:([A-Za-z0-9_-]+)\]\]/g)) { if (db.prepare('SELECT 1 FROM playlist_tracks pt JOIN audio_tracks t ON t.id = pt.track_id WHERE pt.playlist_id = ? AND t.media_id IS NOT NULL LIMIT 1').get(m[1])) return true; }
202 } catch { /* non-fatal */ }
203 return false;
204}
205
[6bd25d1]206// A single post as an AS2 Note (the object), and as a Create activity (for outbox/delivery).
207export function buildNote(base, site, post) {
208 const id = noteId(base, post.id);
209 const aId = actorId(base, site.slug);
210 const human = `${base}/${encodeURIComponent(post.slug)}`;
[065452a]211 // Mastodon ignores a Note's `name`, so put the title INTO the content (bold
212 // first line) — the standard blog→fediverse convention. post.content is
213 // already sanitized HTML; the title is plain text, so escape it.
214 const escTitle = String(post.title || '').replace(/[<>&]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' }[c]));
215 const titleHtml = post.title ? `<p><strong>${escTitle}</strong></p>` : '';
[5a93ac0]216
217 // Images travel as AP `attachment` (Mastodon strips <img> from content). Collect
218 // the cover + any inline <img>, make absolute, then strip <img> from the content
219 // to avoid duplicate rendering on clients that DO keep them.
220 const abs = (u) => !u ? null : (/^https?:/i.test(u) ? u : `${base}${u.startsWith('/') ? '' : '/'}${u}`);
221 const mediaType = (u) => {
222 const e = ((u || '').split('?')[0].match(/\.(\w+)$/) || [])[1];
223 return ({ jpg: 'image/jpeg', jpeg: 'image/jpeg', png: 'image/png', gif: 'image/gif', webp: 'image/webp', avif: 'image/avif' })[(e || '').toLowerCase()] || 'image/jpeg';
224 };
[2923a95]225 const hadAudio = /\[\[(track|album|playlist):/i.test(post.content || '');
[30271e6]226 const playable = hasPlayableAudio(post.content || '', site && site.id);
[5a93ac0]227 const urls = [];
[30271e6]228 // Posts with PLAYABLE hosted audio suppress image attachments so Mastodon renders
229 // the player CARD (twitter:player) instead of the cover — media attachment and
230 // link/player card are mutually exclusive on Mastodon. Link-only audio (external)
231 // keeps its cover (no player card to show).
232 if (post.cover_image_url && !playable) urls.push(abs(post.cover_image_url));
[5a93ac0]233 let body = post.content || '';
[30271e6]234 if (!playable) for (const m of body.matchAll(/<img\b[^>]*\bsrc="([^"]+)"[^>]*>/gi)) urls.push(abs(m[1]));
[5a93ac0]235 body = body.replace(/<img\b[^>]*>/gi, '');
[5a6a457]236 // Audio shortcodes: do NOT federate the raw audio file — Klonkt deliberately
237 // gates audio (the /audio/stream URL has friction), and shipping it as an AP
238 // audio attachment would hand Mastodon a plain, downloadable mp3 URL. Instead,
239 // replace the shortcodes with a "🎵 listen on the site" link so the post invites
240 // a click-through to the protected player (discovery without leaking the file).
241 const esc = (s) => String(s == null ? '' : s).replace(/[<>&]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' }[c]));
242 const audioLabels = [];
243 try {
244 for (const m of body.matchAll(/\[\[track:([A-Za-z0-9_-]+)\]\]/g)) { const r = db.prepare('SELECT title FROM audio_tracks WHERE id = ?').get(m[1]); if (r && r.title) audioLabels.push(r.title); }
245 for (const m of body.matchAll(/\[\[album:([^\]]+)\]\]/g)) audioLabels.push(m[1].trim());
246 } catch { /* non-fatal */ }
[f2eacca]247 // fedi_open tracks → real AS2 Audio attachments (the actual file URL, served ungated) so
248 // EVERY client incl. the Mastodon apps plays them inline natively. Gated tracks (default)
249 // stay link/card-only — the file is never exposed for them. Resolve from post.content so a
250 // later body mutation can't affect it.
251 const openAudio = [];
252 if (hadAudio) {
253 const seenA = new Set();
254 const addRow = (r) => {
255 const fn = r.filename || (r.storage_path || '').split('/').pop();
256 if (!fn || seenA.has(fn)) return; seenA.add(fn);
257 openAudio.push({ type: 'Document', mediaType: r.mime_type || 'audio/mpeg', url: `${base}/audio/stream/${encodeURIComponent(fn)}`, name: r.title || 'Audio' });
258 };
259 const SEL = 'SELECT t.title, m.filename, m.storage_path, m.mime_type FROM audio_tracks t JOIN media m ON m.id = t.media_id WHERE t.fedi_open = 1 AND ';
260 try {
261 for (const mm of (post.content || '').matchAll(/\[\[track:([A-Za-z0-9_-]+)\]\]/g)) { const r = db.prepare(SEL + 't.id = ?').get(mm[1]); if (r) addRow(r); }
262 for (const mm of (post.content || '').matchAll(/\[\[album:([^\]]+)\]\]/g)) for (const r of db.prepare(SEL + 't.site_id = ? AND t.album = ? ORDER BY t.rowid').all(site.id, mm[1].trim())) addRow(r);
263 for (const mm of (post.content || '').matchAll(/\[\[playlist:([A-Za-z0-9_-]+)\]\]/g)) for (const r of db.prepare('SELECT t.title, m.filename, m.storage_path, m.mime_type FROM playlist_tracks pt JOIN audio_tracks t ON t.id = pt.track_id JOIN media m ON m.id = t.media_id WHERE t.fedi_open = 1 AND pt.playlist_id = ? ORDER BY pt.position').all(mm[1])) addRow(r);
264 } catch { /* non-fatal */ }
265 }
[2826bb97]266 body = body.replace(/\[\[(track|album|playlist):[^\]]+\]\]/gi, '');
[4b5223f]267 // External embeds ([[embed:url]]) → emit the bare URL as a link so Mastodon
268 // renders its OWN preview/player card (YouTube/Spotify/SoundCloud/etc) instead
269 // of federating the raw shortcode text.
270 body = body.replace(/\[\[embed:([^\]]+)\]\]/gi, (mm, raw) => {
271 const u = esc(raw.trim().replace(/&amp;/g, '&'));
272 return `<p><a href="${u}">${u}</a></p>`;
273 });
[5a6a457]274 if (hadAudio) {
275 const lbl = audioLabels.length ? esc(audioLabels.slice(0, 4).join(', ')) : '';
[5085b1d]276 // For playable posts, append a version param to the listen-link so Mastodon
277 // sees a NEW card URL and re-crawls it (fresh SQUARE player card) instead of
278 // reusing the cached landscape one. Invisible: the link TEXT stays clean, the
279 // page ignores the param. Bump FEDI_CARD_VER when the card dimensions change.
280 const listenHref = playable ? `${human}?fc=${FEDI_CARD_VER}` : human;
281 body += `<p>🎵 ${lbl ? `<strong>${lbl}</strong> — ` : ''}<a href="${listenHref}">listen on ${esc(site.title || 'the site')}</a></p>`;
[5a6a457]282 }
[cd6a008]283 // Klonkt renders post content with white-space:pre-wrap, so raw newlines ARE line
284 // breaks on the site. Mastodon (plain HTML) collapses whitespace and would drop them,
285 // so convert newlines to <br> for the federated copy (content already made with
286 // shift+enter uses <br> and has no \n → this is a no-op there).
287 body = body.replace(/\r?\n/g, '<br>');
[7cea873]288 body = linkHashtags(base, body); // link inline #hashtags in the post body too
[2e62848]289 // Append the tags-field hashtags to the content so Mastodon renders them as clickable
290 // hashtags (a Hashtag that's only in the `tag` array isn't shown inline). CamelCase
291 // multi-word tags; skip any already present inline in the body.
292 {
293 const inlineTags = new Set(hashtagTags(base, body).map((h) => h.name.slice(1).toLowerCase()));
294 const addSeen = new Set();
295 const tagLinks = normalizeTags(post.tags).map(tagParts).filter(Boolean)
296 .filter((p) => !inlineTags.has(p.slug) && !addSeen.has(p.slug) && addSeen.add(p.slug))
297 .map((p) => `<a href="${base}/tag/${encodeURIComponent(p.slug)}" class="mention hashtag" rel="tag">#${p.label}</a>`);
298 if (tagLinks.length) body += `<p>${tagLinks.join(' ')}</p>`;
299 }
[5a93ac0]300 const seen = new Set();
301 const attachment = urls.filter(Boolean)
302 .filter((u) => { if (seen.has(u)) return false; seen.add(u); return true; })
303 .map((u) => ({ type: 'Document', mediaType: mediaType(u), url: u }));
[f2eacca]304 for (const a of openAudio) attachment.push(a); // fedi_open tracks → native Audio players
[5a93ac0]305
306 const note = {
[6bd25d1]307 id,
308 type: 'Note',
309 attributedTo: aId,
[5a93ac0]310 content: titleHtml + body,
[6bd25d1]311 url: human,
312 published: new Date(post.published_at || post.created_at || Date.now()).toISOString(),
[80c36a1]313 // fan_only = "fans only" → followers-only visibility (delivered to your followers
314 // but not addressed to Public, so Mastodon shows it only to them and can't boost it).
315 to: post.fan_only ? [`${aId}/followers`] : [PUBLIC],
316 cc: post.fan_only ? [] : [`${aId}/followers`],
[7cea873]317 tag: buildHashtagList(base, post.tags, body),
[d7526bd]318 replies: `${id}/replies`,
[837fc9c]319 // NSFW → Mastodon-style content warning: sensitive (blurs media) + a summary/spoiler
320 // (hides the whole post behind a "Gevoelige inhoud" button until the reader opens it).
321 sensitive: !!post.nsfw,
[6bd25d1]322 };
[b7d4458]323 if (post.nsfw) note.summary = post.content_warning || 'Gevoelige inhoud';
[5a93ac0]324 if (attachment.length) note.attachment = attachment;
[c628db10]325 // Playable-audio posts suppress the cover attachment (player card). Still expose
326 // the cover via AS2 `image` so card/grid consumers (the Klonkt Cirkel) can show
327 // it — Mastodon ignores a Note's `image`, so the player card is unaffected.
328 if (post.cover_image_url && playable) {
329 const cov = abs(post.cover_image_url);
330 if (cov) note.image = { type: 'Image', mediaType: mediaType(cov), url: cov };
331 }
[80797d7]332 // Experiment (mirrors PeerTube / schema.org `embedUrl`): point at the GATED player page
333 // (/embed) so a client that honours embedUrl can show an inline player WITHOUT ever
334 // getting the audio file — the anti-steal posture is untouched. `embedUrl` is a real
335 // standard field name (not a Klonkt invention); if Mastodon's apps honour it on a Note we
336 // make it JSON-LD-clean with a context term, otherwise it degrades to the player card.
337 if (playable) note.embedUrl = `${base}/embed?post=${encodeURIComponent(post.slug)}`;
[5a93ac0]338 return note;
[6bd25d1]339}
340
[d7526bd]341// All reply note URIs on a local post (inbound fediverse replies + our own
342// outbound replies) — backs the Note's `replies` Collection so remote servers
343// can fetch the whole thread.
344export function getReplyUris(base, postId) {
345 const out = [];
346 try {
347 for (const r of db.prepare("SELECT object_uri FROM ap_interactions WHERE kind = 'reply' AND post_id = ? AND object_uri != '' ORDER BY created_at").all(postId)) out.push(r.object_uri);
348 for (const r of db.prepare('SELECT id FROM ap_outbox WHERE post_id = ? ORDER BY rowid').all(postId)) out.push(`${base}/ap/notes/${r.id}`);
349 } catch { /* non-fatal */ }
350 return out;
351}
352
[e951b7c]353// Notifications "seen" tracking → a real bell badge. Stored per site in app_settings.
354export function markNotificationsSeen(slug) {
355 try {
356 db.prepare("INSERT INTO app_settings (key, value, updated_at) VALUES (?, ?, CURRENT_TIMESTAMP) ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = CURRENT_TIMESTAMP")
357 .run(`fedi_notif_seen:${slug}`, new Date().toISOString());
358 } catch { /* non-fatal */ }
359}
360export function countUnseenNotifications(slug) {
361 try {
362 const row = db.prepare('SELECT value FROM app_settings WHERE key = ?').get(`fedi_notif_seen:${slug}`);
363 const seen = row ? Date.parse(row.value) : 0;
364 let n = 0;
365 for (const it of getNotifications(slug, 50)) { if (Date.parse(it.created_at) > seen) n++; }
366 return n;
367 } catch { return 0; }
368}
369
[6bd25d1]370export function buildCreate(base, site, post) {
371 const note = buildNote(base, site, post);
372 return {
[d3b9f68]373 '@context': AP_CONTEXT,
[6bd25d1]374 id: note.id + '#create',
375 type: 'Create',
376 actor: actorId(base, site.slug),
377 published: note.published,
378 to: note.to,
379 cc: note.cc,
380 object: note,
381 };
382}
383
384export function buildOutbox(base, site, posts) {
385 const id = `${actorId(base, site.slug)}/outbox`;
386 const items = (posts || []).slice(0, MAX_OUTBOX).map((p) => buildCreate(base, site, p));
387 return {
[d3b9f68]388 '@context': AP_CONTEXT,
[6bd25d1]389 id,
390 type: 'OrderedCollection',
391 totalItems: items.length,
392 orderedItems: items,
393 };
394}
395
396export function buildFollowers(base, site, count) {
397 const id = `${actorId(base, site.slug)}/followers`;
398 return {
[d3b9f68]399 '@context': AP_CONTEXT,
[6bd25d1]400 id,
401 type: 'OrderedCollection',
402 totalItems: count || 0,
403 orderedItems: [], // hidden for privacy; count only
404 };
405}
406
[f2796d3]407// The accounts this site follows — count only, mirroring buildFollowers. The spec lists
408// `following` as a standard actor property; Hubzilla/Friendica + crawlers expect it.
409export function buildFollowing(base, site, count) {
410 const id = `${actorId(base, site.slug)}/following`;
411 return {
[d3b9f68]412 '@context': AP_CONTEXT,
[f2796d3]413 id,
414 type: 'OrderedCollection',
415 totalItems: count || 0,
416 orderedItems: [], // count only
417 };
418}
419
[75bda38]420// Pinned posts → the actor's `featured` collection. Mastodon reads this and shows
421// these as the "Featured" tab (pinned to the profile). Posts come ordered by pin
422// rank; embedded as full Notes so a remote server doesn't need extra fetches.
423export function buildFeatured(base, site, posts) {
424 const id = `${actorId(base, site.slug)}/featured`;
425 const items = (posts || []).map((p) => buildNote(base, site, p));
426 return {
[d3b9f68]427 '@context': AP_CONTEXT,
[75bda38]428 id,
429 type: 'OrderedCollection',
430 totalItems: items.length,
431 orderedItems: items,
432 };
433}
434
[5bf63b7]435// ── followers store (lazy stmts) ──────────────────────────────────
436let _insF, _delF, _listF, _cntF;
437function fStmts() {
438 if (!_insF) {
439 _insF = db.prepare('INSERT OR IGNORE INTO ap_followers (slug, actor_uri, inbox, shared_inbox, created_at) VALUES (?,?,?,?,CURRENT_TIMESTAMP)');
440 _delF = db.prepare('DELETE FROM ap_followers WHERE slug = ? AND actor_uri = ?');
441 _listF = db.prepare('SELECT inbox, shared_inbox FROM ap_followers WHERE slug = ?');
442 _cntF = db.prepare('SELECT COUNT(*) n FROM ap_followers WHERE slug = ?');
443 }
444 return { ins: _insF, del: _delF, list: _listF, cnt: _cntF };
445}
446export function followerCount(slug) { return fStmts().cnt.get(slug).n; }
447
[55bc7f9]448// ── inbound interactions store (replies / likes / boosts) + our outbound replies ──
449let _insI, _delLA, _delReply, _listI, _getI, _insO, _listO, _getO;
[c16e0a5]450function iStmts() {
451 if (!_insI) {
[7d932ce]452 _insI = db.prepare('INSERT OR IGNORE INTO ap_interactions (kind, post_id, object_uri, actor_uri, actor_name, actor_handle, actor_url, actor_icon, content, published, parent_uri, created_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,CURRENT_TIMESTAMP)');
[c16e0a5]453 _delLA = db.prepare('DELETE FROM ap_interactions WHERE kind = ? AND post_id = ? AND actor_uri = ?');
454 _delReply = db.prepare("DELETE FROM ap_interactions WHERE kind = 'reply' AND object_uri = ?");
[3289a64]455 _listI = db.prepare('SELECT id, kind, object_uri, parent_uri, actor_uri, actor_name, actor_handle, actor_url, actor_icon, content, published, created_at, acted_boost, acted_like FROM ap_interactions WHERE post_id = ? ORDER BY created_at ASC');
[55bc7f9]456 _getI = db.prepare('SELECT * FROM ap_interactions WHERE id = ?');
457 _insO = db.prepare('INSERT INTO ap_outbox (id, site_slug, post_id, post_slug, in_reply_to, to_actor, to_handle, content, created_at) VALUES (?,?,?,?,?,?,?,?,CURRENT_TIMESTAMP)');
458 _listO = db.prepare('SELECT * FROM ap_outbox WHERE post_id = ? ORDER BY created_at ASC');
459 _getO = db.prepare('SELECT * FROM ap_outbox WHERE id = ?');
[c16e0a5]460 }
[55bc7f9]461 return { ins: _insI, delLA: _delLA, delReply: _delReply, list: _listI, getI: _getI, insO: _insO, listO: _listO, getO: _getO };
[c16e0a5]462}
463
[55bc7f9]464export function getInteractionById(id) { return iStmts().getI.get(id); }
[c745659]465export function setInteractionBoosted(id, on) {
466 db.prepare('UPDATE ap_interactions SET acted_boost = ? WHERE id = ?').run(on ? 1 : 0, id);
467}
[3289a64]468export function setInteractionLiked(id, on) {
469 db.prepare('UPDATE ap_interactions SET acted_like = ? WHERE id = ?').run(on ? 1 : 0, id);
470}
[3d37c67]471// Your like/boost state on a REMOTE post (interact page toggles).
472export function setMyReaction(slug, uri, kind, on) {
473 if (on) db.prepare('INSERT OR IGNORE INTO ap_my_reactions (site_slug, target_uri, kind) VALUES (?,?,?)').run(slug, uri, kind);
474 else db.prepare('DELETE FROM ap_my_reactions WHERE site_slug = ? AND target_uri = ? AND kind = ?').run(slug, uri, kind);
475}
476export function getMyReactions(slug, uri) {
477 const rows = (slug && uri) ? db.prepare('SELECT kind FROM ap_my_reactions WHERE site_slug = ? AND target_uri = ?').all(slug, uri) : [];
478 return { liked: rows.some((r) => r.kind === 'like'), boosted: rows.some((r) => r.kind === 'boost') };
479}
[55bc7f9]480
[c16e0a5]481const localPostExists = (id) => { try { return !!db.prepare('SELECT 1 FROM posts WHERE id = ?').get(id); } catch { return false; } };
482// Extract our local post id from a note URL, but only if it's ours (base match).
483function postIdFromNoteUrl(url, base) {
484 const s = String(url || '');
485 if (base && !s.startsWith(base)) return null;
486 const m = s.match(/\/ap\/notes\/([^/?#]+)/);
487 return m ? decodeURIComponent(m[1]) : null;
488}
489function deriveHandle(actorUri) {
490 try { const u = new URL(actorUri); const seg = u.pathname.split('/').filter(Boolean).pop() || ''; return `@${seg}@${u.host}`; } catch { return String(actorUri || ''); }
491}
492function actorInfo(doc, actorUri) {
493 let host = ''; try { host = new URL(actorUri).host; } catch { /* keep empty */ }
494 const handle = doc && doc.preferredUsername ? `@${doc.preferredUsername}@${host}` : deriveHandle(actorUri);
495 const icon = doc && doc.icon ? (doc.icon.url || (Array.isArray(doc.icon) && doc.icon[0] && doc.icon[0].url)) : null;
496 return {
497 name: (doc && (doc.name || doc.preferredUsername)) || handle,
498 handle,
[3dd99d3]499 url: safeUrl((doc && (doc.url || doc.id)) || actorUri) || null,
500 icon: safeUrl(icon) || null,
[c16e0a5]501 };
502}
503
[7d932ce]504// Given an inReplyTo note URL, find which local post the thread belongs to + the
505// note being replied to (parent), so a reply-to-a-comment can be nested.
506function findThreadTarget(inReplyTo, base) {
507 if (!inReplyTo) return null;
508 const seg = postIdFromNoteUrl(inReplyTo, base); // our /ap/notes/<id> segment (if ours)
509 if (seg && localPostExists(seg)) return { post_id: seg, parent_uri: inReplyTo };
510 if (seg) {
511 try { const o = db.prepare('SELECT post_id FROM ap_outbox WHERE id = ?').get(seg); if (o && o.post_id) return { post_id: o.post_id, parent_uri: inReplyTo }; } catch { /* ignore */ }
512 }
513 try { const row = db.prepare("SELECT post_id FROM ap_interactions WHERE object_uri = ? AND kind = 'reply' LIMIT 1").get(inReplyTo); if (row && row.post_id) return { post_id: row.post_id, parent_uri: inReplyTo }; } catch { /* ignore */ }
514 return null;
515}
516
[7e66e7e]517// Drop the leading @mention(s) a federated reply carries (the person being replied to),
518// so a comment reads "dope tekening ouwe" instead of "@jason@jasonhacky.nl dope …".
519// Keeps a leading <p> wrapper; handles mention <a> links and plain-text @user@domain.
520export function stripLeadingMentions(html) {
521 if (!html) return html;
522 let s = String(html);
523 s = s.replace(/^(\s*<p[^>]*>)?\s*(?:<a\b[^>]*>\s*@[^<]+<\/a>[  ]*)+/i, (m, p) => p || '');
524 s = s.replace(/^(\s*<p[^>]*>)?\s*(?:@[\w.-]+(?:@[\w.-]+)?[  ]+)+/i, (m, p) => p || '');
525 return s;
526}
527
[7d932ce]528// View-ready threaded view of a post's fediverse activity (inbound replies +
529// our outbound replies, nested), plus like/boost counts.
[c73ac64]530export function getInteractions(postId, base, site) {
[55bc7f9]531 const s = iStmts();
532 const rows = s.list.all(postId);
[7d932ce]533 const baseClean = (base || process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
534 const postNoteId = baseClean ? `${baseClean}/ap/notes/${postId}` : null;
[c73ac64]535 // Our own (outbound) replies show the SITE identity for everyone (not "You").
536 let host = ''; try { host = new URL(baseClean).host; } catch { /* ignore */ }
537 const siteName = (site && (site.title || site.slug)) || '';
538 const siteHandle = (site && site.slug && host) ? `@${site.slug}@${host}` : '';
539 const siteUrl = baseClean ? `${baseClean}/` : '';
540 const siteIcon = (site && site.profile_photo) || null;
[7d932ce]541
542 const nodes = [];
543 for (const r of rows) {
544 if (r.kind !== 'reply') continue;
545 nodes.push({
[e91849c]546 noteId: r.object_uri, parent: r.parent_uri || null, mine: false, id: r.id,
[7d932ce]547 actor_name: r.actor_name, actor_handle: r.actor_handle, actor_url: r.actor_url,
[7e66e7e]548 actor_icon: r.actor_icon, content: stripLeadingMentions(r.content), created_at: r.published || r.created_at,
[3289a64]549 acted_boost: !!r.acted_boost, acted_like: !!r.acted_like,
[7d932ce]550 children: [],
551 });
552 }
553 for (const o of s.listO.all(postId)) {
554 nodes.push({
555 noteId: baseClean ? `${baseClean}/ap/notes/${o.id}` : o.id, parent: o.in_reply_to || null,
[7e66e7e]556 mine: true, outboxId: o.id, content: stripLeadingMentions(o.content), created_at: o.created_at,
[c73ac64]557 actor_name: siteName, actor_handle: siteHandle, actor_url: siteUrl, actor_icon: siteIcon,
558 children: [],
[7d932ce]559 });
560 }
561
562 const byId = new Map(nodes.map((n) => [n.noteId, n]));
563 const isTop = (n) => !n.parent || n.parent === postNoteId || !byId.has(n.parent);
564 const tops = [];
565 for (const n of nodes) {
566 if (isTop(n)) { tops.push(n); continue; }
567 let anc = n, guard = 0;
568 while (!isTop(anc) && guard++ < 12) anc = byId.get(anc.parent);
569 anc.children.push(n);
570 }
571 const byTime = (a, b) => new Date(a.created_at) - new Date(b.created_at);
572 tops.sort(byTime).forEach((t) => t.children.sort(byTime));
573
[c16e0a5]574 return {
[7d932ce]575 thread: tops,
[c16e0a5]576 likeCount: rows.filter((r) => r.kind === 'like').length,
577 announceCount: rows.filter((r) => r.kind === 'announce').length,
[7d932ce]578 total: nodes.length,
[c16e0a5]579 };
580}
581
[5bf63b7]582// ── HTTP Signatures + delivery ────────────────────────────────────
583const slugFromActorUrl = (url) => { const m = String(url || '').match(/\/ap\/users\/([^/?#]+)/); return m ? decodeURIComponent(m[1]) : null; };
584
585// Sign + POST an activity to a remote inbox (draft-cavage HTTP Signatures, RSA-SHA256).
586export async function deliver(inboxUrl, bodyObj, keyId, privatePem) {
587 const body = JSON.stringify(bodyObj);
588 const u = new URL(inboxUrl);
589 const date = new Date().toUTCString();
590 const digest = 'SHA-256=' + crypto.createHash('sha256').update(body).digest('base64');
591 const signingString = `(request-target): post ${u.pathname}\nhost: ${u.host}\ndate: ${date}\ndigest: ${digest}`;
592 const signature = crypto.sign('sha256', Buffer.from(signingString), privatePem).toString('base64');
593 const sig = `keyId="${keyId}",algorithm="rsa-sha256",headers="(request-target) host date digest",signature="${signature}"`;
[3dd99d3]594 const r = await safeFetch(inboxUrl, {
[5bf63b7]595 method: 'POST',
596 headers: { 'Content-Type': 'application/activity+json', Accept: 'application/activity+json', Date: date, Digest: digest, Signature: sig },
597 body,
598 });
599 return r.status;
600}
601
602export async function fetchActor(url) {
603 try {
[3dd99d3]604 const r = await safeFetch(url, { headers: { Accept: 'application/activity+json' } });
[5bf63b7]605 if (!r.ok) return null;
[3dd99d3]606 const len = Number(r.headers.get('content-length') || 0);
607 if (len > 2_000_000) return null; // refuse oversized actor docs
[5bf63b7]608 return await r.json();
609 } catch { return null; }
610}
611
[5a6a457]612// ── Delivery queue with retries ───────────────────────────────────
613// Outbound deliveries are tried immediately; on failure (down server, timeout,
614// non-2xx) they're queued and retried with backoff so a briefly-offline follower
615// doesn't silently miss the post. The signing key is NOT stored — the worker
616// re-derives it from the actor slug at send time.
617const DELIVERY_MAX_ATTEMPTS = 6;
618const DELIVERY_BACKOFF_MIN = [1, 5, 15, 60, 180, 360];
619let _insDeliv, _dueDeliv, _delDeliv, _bumpDeliv;
620function deliveryStmts() {
621 if (!_insDeliv) {
622 _insDeliv = db.prepare('INSERT INTO ap_delivery (slug, inbox, body, attempts, next_at) VALUES (?,?,?,0,CURRENT_TIMESTAMP)');
623 _dueDeliv = db.prepare("SELECT * FROM ap_delivery WHERE datetime(next_at) <= datetime('now') ORDER BY next_at LIMIT 30");
624 _delDeliv = db.prepare('DELETE FROM ap_delivery WHERE id = ?');
625 _bumpDeliv = db.prepare('UPDATE ap_delivery SET attempts = ?, next_at = ? WHERE id = ?');
626 }
627 return { ins: _insDeliv, due: _dueDeliv, del: _delDeliv, bump: _bumpDeliv };
628}
629export function enqueueDelivery(slug, inbox, activity) {
630 if (!slug || !inbox || !activity) return;
631 try { deliveryStmts().ins.run(slug, inbox, JSON.stringify(activity)); } catch { /* ignore */ }
632}
633// Deliver now; queue for retry if it fails.
634export async function deliverWithRetry(slug, inbox, activity, keyId, privPem) {
635 if (!inbox) return;
636 try { const st = await deliver(inbox, activity, keyId, privPem); if (st >= 200 && st < 300) return; } catch { /* queue below */ }
637 enqueueDelivery(slug, inbox, activity);
638}
[3dd99d3]639let _processingDeliv = false;
[5a6a457]640export async function processDeliveryQueue() {
[3dd99d3]641 if (_processingDeliv) return; // re-entrancy guard: 30 rows × 8s can exceed the 60s tick → no double-delivery
642 _processingDeliv = true;
643 try {
644 let rows;
645 try { rows = deliveryStmts().due.all(); } catch { return; }
646 if (!rows || !rows.length) return;
647 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
648 for (const row of rows) {
649 let ok = false;
650 try {
651 const keys = getOrCreateKeys(row.slug);
652 const st = await deliver(row.inbox, JSON.parse(row.body), `${actorId(base, row.slug)}#main-key`, keys.private_pem);
653 ok = st >= 200 && st < 300;
654 } catch { ok = false; }
655 if (ok) { deliveryStmts().del.run(row.id); continue; }
656 const attempts = row.attempts + 1;
657 if (attempts >= DELIVERY_MAX_ATTEMPTS) { deliveryStmts().del.run(row.id); console.warn('[AP] delivery gave up after', attempts, 'tries →', row.inbox); continue; }
658 // Index the backoff on the CURRENT attempt count (row.attempts) so the first
659 // retry uses the 1-min tier instead of skipping it.
660 const mins = DELIVERY_BACKOFF_MIN[Math.min(row.attempts, DELIVERY_BACKOFF_MIN.length - 1)];
661 deliveryStmts().bump.run(attempts, new Date(Date.now() + mins * 60000).toISOString(), row.id);
662 }
663 } finally { _processingDeliv = false; }
[5a6a457]664}
665let _delivTimer = null;
666export function startDeliveryWorker() {
667 if (_delivTimer) return;
668 _delivTimer = setInterval(() => { processDeliveryQueue().catch(() => {}); }, 60 * 1000);
669 if (_delivTimer.unref) _delivTimer.unref();
670}
671
[5bf63b7]672// Best-effort verification of an incoming signed request. Returns the sender's
673// actor doc if the signature checks out, else null. (Not gating yet — MVP.)
674export async function verifyRequest(req) {
675 const sigH = req.headers['signature'];
676 if (!sigH) return null;
677 const p = Object.fromEntries([...sigH.matchAll(/([a-zA-Z]+)="([^"]*)"/g)].map((m) => [m[1], m[2]]));
678 if (!p.keyId || !p.signature) return null;
679 const actor = await fetchActor(p.keyId.split('#')[0]);
680 const pem = actor && actor.publicKey && actor.publicKey.publicKeyPem;
681 if (!pem) return null;
682 const hs = (p.headers || '(request-target) host date').split(/\s+/);
[9910ba1]683 // Behind a reverse proxy the raw Host header is the backend bind (e.g. localhost:3000, when
684 // the proxy doesn't preserve it — Apache .htaccess [P] proxying), but the sender signed the
685 // HTTP-Signature over the PUBLIC host. Try each candidate host (the configured PUBLIC_BASE_URL
686 // host, the proxy's X-Forwarded-Host, and the raw Host) and accept if the signature verifies
687 // against any. An attacker can't forge a match (no private key), so this only rescues the
688 // legitimate proxied case. Also normalise a leading double-slash in the request-target.
689 let _pubHost = null;
690 if (process.env.PUBLIC_BASE_URL) { try { _pubHost = new URL(process.env.PUBLIC_BASE_URL).host; } catch { /* ignore */ } }
691 const _hosts = [...new Set([_pubHost, req.headers['x-forwarded-host'], req.headers['host']].filter(Boolean))];
692 const _target = `${req.method.toLowerCase()} ${String(req.originalUrl || '').replace(/^\/{2,}/, '/')}`;
693 const _sig = Buffer.from(p.signature, 'base64');
[5bf63b7]694 let ok = false;
[9910ba1]695 for (const _h of _hosts) {
696 const line = hs.map((x) => x === '(request-target)'
697 ? `(request-target): ${_target}`
698 : x === 'host' ? `host: ${_h}`
699 : `${x}: ${req.headers[x] || ''}`).join('\n');
700 try { if (crypto.verify('sha256', Buffer.from(line), pem, _sig)) { ok = true; break; } } catch { /* try next host */ }
701 }
[5bf63b7]702 if (ok && hs.includes('digest') && req.rawBody) {
703 const exp = 'SHA-256=' + crypto.createHash('sha256').update(req.rawBody).digest('base64');
704 if (req.headers['digest'] !== exp) ok = false;
705 }
706 return ok ? actor : null;
707}
708
709// Handle an incoming inbox POST. slugParam = null for the shared /ap/inbox.
710export async function handleInbox(req, slugParam) {
711 const act = req.body || {};
712 const type = act.type;
[bbce8da]713 // Real client IP (behind the proxy via `trust proxy`) — logged on dropped/rejected/
714 // ignored inbox hits so an operator can see who is probing their fediverse inbox.
715 const ip = req.ip || (req.connection && req.connection.remoteAddress) || '?';
[5bf63b7]716 const base = (process.env.PUBLIC_BASE_URL || `${req.protocol}://${req.get('host')}`).replace(/\/+$/, '');
[d0cab9d]717 const verified = await verifyRequest(req).catch(() => null);
718
719 // ENFORCE HTTP signatures: a data-affecting activity must be signed by the very
720 // actor it claims to be. No valid signature, or signer ≠ actor → reject (no
721 // forged replies/likes/follows/timeline posts). GET/discovery stays open.
722 const claimedActor = typeof act.actor === 'string' ? act.actor : (act.actor && act.actor.id);
[f5c3870]723 // Blocked actor/domain → silently drop (202, don't reveal the block).
[bbce8da]724 if (claimedActor && isBlockedAny(claimedActor)) { console.log('[AP] inbox dropped (blocked)', claimedActor, 'from', ip); return 202; }
[3dd99d3]725 const GATED = ['Create', 'Like', 'Announce', 'Follow', 'Delete', 'Undo', 'Accept', 'Reject', 'Add', 'Remove', 'Update'];
[d0cab9d]726 if (GATED.includes(type)) {
727 if (!verified || !claimedActor || verified.id !== claimedActor) {
[bbce8da]728 console.warn('[AP] inbox REJECTED (signature)', type, claimedActor || '?', 'from', ip, verified ? '(signer mismatch)' : '(unsigned/invalid)');
[d0cab9d]729 return 401;
730 }
731 }
[5bf63b7]732
733 if (type === 'Follow') {
734 const who = typeof act.actor === 'string' ? act.actor : (act.actor && act.actor.id);
735 const slug = slugParam || slugFromActorUrl(typeof act.object === 'string' ? act.object : (act.object && act.object.id));
736 if (!who || !slug) return 400;
737 const remote = await fetchActor(who);
738 if (!remote || !remote.inbox) return 202; // can't reach them → drop quietly
[4c12783]739 const sharedInbox = (remote.endpoints && remote.endpoints.sharedInbox) || null;
740 fStmts().ins.run(slug, who, remote.inbox, sharedInbox);
[5bf63b7]741 const me = actorId(base, slug);
742 const keys = getOrCreateKeys(slug);
[d3b9f68]743 const accept = { '@context': AP_CONTEXT, id: `${me}#accept-${Date.now()}-${rid()}`, type: 'Accept', actor: me, object: act };
[5bf63b7]744 deliver(remote.inbox, accept, `${me}#main-key`, keys.private_pem).catch((e) => console.warn('[AP] Accept delivery failed:', e.message));
[4c12783]745 // Auto-backfill: send our recent posts as Create so the instance has our history
746 // (Mastodon doesn't fetch history on follow). ONCE PER REMOTE INSTANCE only —
747 // Mastodon dedupes notes per-instance, so re-filling an instance that already has
748 // a follower of ours is wasted work (and won't re-populate the new follower's
749 // timeline anyway). Deliver to the shared inbox (instance-level) when present.
750 // Sync insert+check (no await between) → no interleave race with concurrent Follows.
751 const instanceFilled = sharedInbox &&
752 db.prepare('SELECT 1 FROM ap_followers WHERE slug = ? AND shared_inbox = ? AND actor_uri != ? LIMIT 1')
753 .get(slug, sharedInbox, who);
754 if (!instanceFilled) {
755 backfillNewFollower(base, slug, sharedInbox || remote.inbox).catch(() => { /* best-effort */ });
756 }
[5bf63b7]757 console.log('[AP] Follow', who, '→', slug, verified ? '(sig ok)' : '(sig unverified)');
758 return 202;
759 }
[c16e0a5]760 if (type === 'Undo' && act.object) {
[5bf63b7]761 const who = typeof act.actor === 'string' ? act.actor : (act.actor && act.actor.id);
[c16e0a5]762 const ot = act.object.type;
763 if (ot === 'Follow') {
764 const obj = act.object.object;
765 const slug = slugParam || slugFromActorUrl(typeof obj === 'string' ? obj : (obj && obj.id));
766 if (who && slug) { fStmts().del.run(slug, who); console.log('[AP] Unfollow', who, '→', slug); }
767 return 202;
768 }
769 if (ot === 'Like' || ot === 'Announce') {
770 const tgt = act.object.object;
771 const pid = postIdFromNoteUrl(typeof tgt === 'string' ? tgt : (tgt && tgt.id), base);
772 if (who && pid) { iStmts().delLA.run(ot.toLowerCase(), pid, who); console.log('[AP] Undo', ot, who, '→', pid); }
773 return 202;
774 }
775 return 202;
776 }
777
778 const actorUri = typeof act.actor === 'string' ? act.actor : (act.actor && act.actor.id);
779 const resolveActor = async (uri) => ((verified && verified.id === uri) ? verified : await fetchActor(uri).catch(() => null));
[ffa53cc]780 // Activities from our OWN actors are already stored via ap_outbox — don't re-store.
781 const isLocalActor = !!(base && actorUri && actorUri.startsWith(`${base}/ap/users/`));
[c16e0a5]782
[7d932ce]783 // Inbound reply: a Create whose object replies to one of our notes (post OR comment).
[c16e0a5]784 if (type === 'Create' && act.object && (act.object.type === 'Note' || act.object.type === 'Article')) {
785 const o = act.object;
[7d932ce]786 const tgt = findThreadTarget(o.inReplyTo, base);
[ffa53cc]787 if (tgt && actorUri && !isLocalActor) {
[c16e0a5]788 const ai = actorInfo(await resolveActor(actorUri), actorUri);
789 const html = HtmlSanitizerService.sanitize(o.content || '');
[7d932ce]790 iStmts().ins.run('reply', tgt.post_id, o.id || '', actorUri, ai.name, ai.handle, ai.url, ai.icon, html, o.published || null, tgt.parent_uri);
791 console.log('[AP] reply', actorUri, '→', tgt.post_id);
[914eb9f]792 return 202;
793 }
794 // Home timeline (client): a top-level post from an account we follow.
795 if (actorUri && !isLocalActor && !o.inReplyTo && o.id) {
[f278df9]796 let subs = []; try { subs = db.prepare('SELECT slug, auto_boost FROM ap_following WHERE actor_uri = ?').all(actorUri); } catch { /* table may not exist yet */ }
[914eb9f]797 if (subs.length) {
798 const ai = actorInfo(await resolveActor(actorUri), actorUri);
799 const html = HtmlSanitizerService.sanitize(o.content || '');
[c628db10]800 const _atts = (Array.isArray(o.attachment) ? o.attachment : []).map((a) => ({ url: safeUrl(a && a.url), type: (a && a.mediaType) || '' })).filter((m) => m.url);
801 // Fallback cover: a Note's `image` (set when the attachment was suppressed
802 // for a player-card post, e.g. hosted-audio posts).
803 if (!_atts.some((m) => !m.type || /image/i.test(m.type)) && o.image) {
804 const _im = Array.isArray(o.image) ? o.image[0] : o.image;
805 const _iu = safeUrl(typeof _im === 'string' ? _im : (_im && _im.url));
806 if (_iu) _atts.push({ url: _iu, type: (_im && _im.mediaType) || 'image/jpeg' });
807 }
808 const media = JSON.stringify(_atts);
[484adf8]809 // "Feature" = show in the Cirkel (local only). We do NOT auto-Announce
[fda08c2]810 // incoming posts to the fediverse — that flooded followers. Boosting to the
811 // fediverse is only ever a deliberate, manual per-post action (the 🔁 on
812 // the timeline).
[f278df9]813 for (const s of subs) {
[b7d4458]814 tlStmts().ins.run(o.id, s.slug, actorUri, ai.name, ai.handle, ai.icon, ai.url, html, o.url || null, o.published || null, media, o.sensitive ? 1 : 0, o.summary || null);
[f278df9]815 }
[914eb9f]816 console.log('[AP] timeline +', actorUri, 'x' + subs.length);
817 }
[c16e0a5]818 }
[5bf63b7]819 return 202;
820 }
[bea59a1]821 // A remote post we cached was edited upstream → refresh our cached copy. This is the
822 // push-based edit-sync that keeps the Cirkel/timeline fresh without polling (selfHeal
823 // does it on a version bump; this does it live). Scope to the SIGNING actor so B can't
824 // edit A's note (the signature gate guarantees claimedActor == the verified signer).
825 if (type === 'Update' && act.object && (act.object.type === 'Note' || act.object.type === 'Article')) {
826 const o = act.object;
827 if (o.id && claimedActor) {
828 const html = HtmlSanitizerService.sanitize(o.content || '');
829 const media = mediaFromNote(o);
830 try {
831 const r = db.prepare('UPDATE ap_timeline SET content = ?, media_json = ?, nsfw = ?, cw = ? WHERE id = ? AND author_uri = ?')
832 .run(html, media, o.sensitive ? 1 : 0, o.summary || null, o.id, claimedActor);
833 if (r.changes) console.log('[AP] timeline update', claimedActor, '→', o.id);
834 } catch { /* ignore */ }
835 // If this note is a cached fediverse reply on one of our posts, refresh its text too.
836 try { db.prepare('UPDATE ap_interactions SET content = ? WHERE object_uri = ? AND actor_uri = ?').run(html, o.id, claimedActor); } catch { /* ignore */ }
837 }
838 return 202;
839 }
[c16e0a5]840 if (type === 'Like' || type === 'Announce') {
841 const tgt = act.object;
[c6cdce6]842 const objUrl = typeof tgt === 'string' ? tgt : (tgt && tgt.id);
843 const pid = postIdFromNoteUrl(objUrl, base);
[ffa53cc]844 if (pid && actorUri && !isLocalActor && localPostExists(pid)) {
[c16e0a5]845 const ai = actorInfo(await resolveActor(actorUri), actorUri);
[7d932ce]846 iStmts().ins.run(type.toLowerCase(), pid, '', actorUri, ai.name, ai.handle, ai.url, ai.icon, null, null, null);
[c16e0a5]847 console.log('[AP]', type === 'Like' ? 'like' : 'boost', actorUri, '→', pid);
[c6cdce6]848 } else if (type === 'Announce' && objUrl && actorUri && !isLocalActor) {
849 // A boost FROM an account we follow, of a REMOTE post → show it in the News feed.
850 // We only STORE it for display; we NEVER auto-Announce it onward (anti-feedback-loop:
851 // re-announcing an incoming Announce would cascade boosts across the network).
852 let subs = []; try { subs = db.prepare('SELECT slug FROM ap_following WHERE actor_uri = ?').all(actorUri); } catch { /* table may not exist */ }
853 if (subs.length) {
854 const bn = await fetchNoteAP(objUrl);
855 if (bn && bn !== 404 && (bn.type === 'Note' || bn.type === 'Article') && bn.id) {
856 const origUri = actorUriOf(bn.attributedTo);
857 const oai = actorInfo(await resolveActor(origUri), origUri);
858 const html = HtmlSanitizerService.sanitize(bn.content || '');
859 const media = mediaFromNote(bn);
860 const booster = actorInfo(await resolveActor(actorUri), actorUri);
861 for (const s of subs) {
862 // published = now → the boost shows as fresh activity at the top (Mastodon shows
863 // reblogs at reblog-time, not the original's date). INSERT OR IGNORE: if we already
864 // have the note (e.g. we also follow the author), keep it and DON'T relabel it.
865 let inserted = false;
866 try { const r = tlStmts().ins.run(bn.id, s.slug, origUri || '', oai.name, oai.handle, oai.icon, oai.url, html, bn.url || null, new Date().toISOString(), media, bn.sensitive ? 1 : 0, bn.summary || null); inserted = r.changes > 0; } catch { /* ignore */ }
867 if (inserted) { try { db.prepare('UPDATE ap_timeline SET reblog_name = ?, reblog_handle = ?, reblog_icon = ? WHERE slug = ? AND id = ?').run(booster.name, booster.handle, booster.icon, s.slug, bn.id); } catch { /* ignore */ } }
868 }
869 console.log('[AP] timeline boost +', actorUri, 'x' + subs.length);
870 }
871 }
[c16e0a5]872 }
873 return 202;
874 }
875 if (type === 'Delete') {
[914eb9f]876 // A remote note was deleted upstream → drop it from replies AND the timeline.
[3dd99d3]877 // Scope to the SIGNING actor so actor B can't delete actor A's content (the
878 // signature gate guarantees claimedActor == the verified signer here).
[c16e0a5]879 const oid = typeof act.object === 'string' ? act.object : (act.object && act.object.id);
[3dd99d3]880 if (oid && claimedActor) {
881 try { db.prepare('DELETE FROM ap_interactions WHERE object_uri = ? AND actor_uri = ?').run(oid, claimedActor); } catch { /* ignore */ }
882 try { db.prepare('DELETE FROM ap_timeline WHERE id = ? AND author_uri = ?').run(oid, claimedActor); } catch { /* ignore */ }
883 }
[914eb9f]884 return 202;
885 }
886 // Accept/Reject of a Follow WE sent (client side).
887 if (type === 'Accept' && act.object) {
888 const fid = typeof act.object === 'string' ? act.object : (act.object && act.object.id);
889 if (fid) { try { fwStmts().acc.run(fid); } catch { /* ignore */ } }
890 console.log('[AP] follow accepted', actorUri);
891 return 202;
892 }
893 if (type === 'Reject' && act.object) {
894 const who = actorUri;
895 if (who && slugParam) { try { fwStmts().del.run(slugParam, who); } catch { /* ignore */ } }
[c16e0a5]896 return 202;
897 }
898
[bbce8da]899 console.log('[AP] inbox', type || 'unknown', '→', slugParam || 'shared', 'from', ip, '(ignored)');
[5bf63b7]900 return 202;
901}
902
903// Deliver a new post as Create(Note) to all followers' inboxes (fire-and-forget).
904// Needs PUBLIC_BASE_URL (absolute URLs); no-op without followers or base.
905export async function deliverCreate(site, post) {
906 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
907 if (!base || !site || !site.slug) return;
908 const followers = fStmts().list.all(site.slug);
909 if (!followers.length) return;
910 const inboxes = [...new Set(followers.map((f) => f.shared_inbox || f.inbox).filter(Boolean))];
911 const keys = getOrCreateKeys(site.slug);
912 const keyId = `${actorId(base, site.slug)}#main-key`;
913 const create = buildCreate(base, site, post);
[5a6a457]914 for (const inbox of inboxes) deliverWithRetry(site.slug, inbox, create, keyId, keys.private_pem);
[5bf63b7]915}
916
[f9f3312]917// On a new Follow, send that follower our most recent posts as Create so their
918// timeline shows our history (Mastodon does not backfill on follow). Oldest-first
919// so they sort into the follower's timeline at their original dates.
920async function backfillNewFollower(base, slug, inbox) {
921 if (!base || !slug || !inbox) return;
922 const site = db.prepare('SELECT * FROM sites WHERE slug = ?').get(slug);
923 if (!site) return;
924 const recent = db.prepare(
[b7d4458]925 `SELECT id, slug, title, content, cover_image_url, nsfw, content_warning, published_at, created_at
[f9f3312]926 FROM posts WHERE site_id = ? AND status = 'published' AND (fan_only IS NULL OR fan_only = 0)
927 ORDER BY COALESCE(published_at, created_at) DESC LIMIT 20`
928 ).all(site.id).reverse();
929 if (!recent.length) return;
930 const keys = getOrCreateKeys(slug);
931 const keyId = `${actorId(base, slug)}#main-key`;
932 for (const p of recent) {
933 try { await deliver(inbox, buildCreate(base, site, p), keyId, keys.private_pem); } catch { /* best-effort */ }
934 await new Promise((r) => setTimeout(r, 150));
935 }
936 console.log('[AP] backfilled', recent.length, 'posts to new follower of', slug);
937}
938
[eb852c5]939// Tell followers a post is gone (Delete + Tombstone) so it's removed from their feeds.
940export async function deliverDelete(site, post) {
941 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
942 if (!base || !site || !site.slug || !post || !post.id) return;
943 const followers = fStmts().list.all(site.slug);
944 if (!followers.length) return;
945 const inboxes = [...new Set(followers.map((f) => f.shared_inbox || f.inbox).filter(Boolean))];
946 const keys = getOrCreateKeys(site.slug);
947 const me = actorId(base, site.slug);
948 const nid = noteId(base, post.id);
949 const del = {
[d3b9f68]950 '@context': AP_CONTEXT,
[3dd99d3]951 id: `${nid}#delete-${Date.now()}-${rid()}`,
[eb852c5]952 type: 'Delete',
953 actor: me,
954 to: [PUBLIC],
955 object: { id: nid, type: 'Tombstone' },
956 };
[5a6a457]957 for (const inbox of inboxes) deliverWithRetry(site.slug, inbox, del, `${me}#main-key`, keys.private_pem);
[eb852c5]958}
959
[ca25f360]960// Tell followers an already-published post changed (Update + edited Note) so
961// Mastodon refreshes the cached copy (e.g. after fixing content).
962export async function deliverUpdate(site, post) {
963 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
964 if (!base || !site || !site.slug || !post || !post.id) return;
965 const followers = fStmts().list.all(site.slug);
966 if (!followers.length) return;
967 const inboxes = [...new Set(followers.map((f) => f.shared_inbox || f.inbox).filter(Boolean))];
968 const keys = getOrCreateKeys(site.slug);
969 const me = actorId(base, site.slug);
970 const note = buildNote(base, site, post);
971 note.updated = new Date().toISOString();
972 const update = {
[d3b9f68]973 '@context': AP_CONTEXT,
[3dd99d3]974 id: `${noteId(base, post.id)}#update-${Date.now()}-${rid()}`,
[ca25f360]975 type: 'Update', actor: me, to: [PUBLIC], cc: [`${me}/followers`],
976 object: note,
977 };
978 for (const inbox of inboxes) deliverWithRetry(site.slug, inbox, update, `${me}#main-key`, keys.private_pem);
979}
980
[f1e0c1f]981// Tell followers the ACTOR changed (Update + Person) so Mastodon re-processes the
982// account AND re-fetches the featured (pinned) collection — there is no standard
983// "featured changed" activity, so this is how a pin/unpin propagates promptly.
984export async function deliverActorUpdate(site) {
985 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
986 if (!base || !site || !site.slug) return;
987 const followers = fStmts().list.all(site.slug);
988 if (!followers.length) return;
989 const inboxes = [...new Set(followers.map((f) => f.shared_inbox || f.inbox).filter(Boolean))];
990 const keys = getOrCreateKeys(site.slug);
991 const me = actorId(base, site.slug);
992 const update = {
[d3b9f68]993 '@context': AP_CONTEXT,
[3dd99d3]994 id: `${me}#update-${Date.now()}-${rid()}`,
[f1e0c1f]995 type: 'Update', actor: me, to: [PUBLIC], cc: [`${me}/followers`],
996 object: buildActor(base, site),
997 };
998 for (const inbox of inboxes) deliverWithRetry(site.slug, inbox, update, `${me}#main-key`, keys.private_pem);
999}
1000
[55bba23]1001// Reliably set the pinned order on followers' instances via Add/Remove activities
1002// (how Mastodon itself federates pins) — pushed to the inbox + processed immediately,
1003// unlike the featured COLLECTION which Mastodon caches with sticky StatusPins.
1004// Mastodon's Add skips an already-pinned status, so we REMOVE every pin first, wait,
1005// then ADD in rank-DESCENDING order (rank 1 added LAST → newest StatusPin → shown first,
1006// because Mastodon displays pins newest-first). `alsoRemove` = ids to unpin too.
1007export async function resyncFeaturedPins(site, alsoRemove = []) {
1008 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1009 if (!base || !site || !site.slug) return;
1010 const followers = fStmts().list.all(site.slug);
1011 if (!followers.length) return;
1012 const inboxes = [...new Set(followers.map((f) => f.shared_inbox || f.inbox).filter(Boolean))];
1013 const keys = getOrCreateKeys(site.slug);
1014 const me = actorId(base, site.slug);
1015 const keyId = `${me}#main-key`;
1016 const featured = `${me}/featured`;
1017 const note = (id) => noteId(base, id);
1018 const pinned = db.prepare(
1019 `SELECT id FROM posts WHERE site_id = ? AND status = 'published' AND (fan_only IS NULL OR fan_only = 0)
1020 AND pinned IS NOT NULL AND pinned > 0
1021 ORDER BY pinned DESC, COALESCE(published_at, created_at) ASC LIMIT 20`
1022 ).all(site.id);
1023 const removeIds = [...new Set([...pinned.map((p) => p.id), ...alsoRemove])];
1024 // 1. Remove every current pin so Mastodon can recreate them in order.
1025 for (const id of removeIds) {
[d3b9f68]1026 const rm = { '@context': AP_CONTEXT, id: `${me}#rm-${id}-${Date.now()}-${rid()}`, type: 'Remove', actor: me, object: note(id), target: featured, to: [PUBLIC] };
[55bba23]1027 for (const inbox of inboxes) deliver(inbox, rm, keyId, keys.private_pem).catch(() => { /* best-effort */ });
1028 }
1029 if (!pinned.length) { console.log('[AP] unpinned all featured for', site.slug); return; }
1030 await new Promise((r) => setTimeout(r, 5000)); // let the Removes land first
1031 // 2. Add in rank-DESC order, gaps so each StatusPin gets an increasing created_at.
1032 for (const p of pinned) {
[d3b9f68]1033 const add = { '@context': AP_CONTEXT, id: `${me}#add-${p.id}-${Date.now()}-${rid()}`, type: 'Add', actor: me, object: note(p.id), target: featured, to: [PUBLIC], cc: [`${me}/followers`] };
[55bba23]1034 for (const inbox of inboxes) deliver(inbox, add, keyId, keys.private_pem).catch(() => { /* best-effort */ });
1035 await new Promise((r) => setTimeout(r, 2000));
1036 }
1037 console.log('[AP] resynced', pinned.length, 'featured pins for', site.slug);
1038}
1039
[55bc7f9]1040// ── outbound replies (Klonkt → fediverse) ─────────────────────────
1041const escHtml = (s) => String(s || '').replace(/[<>&]/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' }[c]));
1042const toISO = (v) => { if (!v) return new Date().toISOString(); const s = String(v); const d = new Date(/[TZ]/.test(s) ? s : s.replace(' ', 'T') + 'Z'); return isNaN(d) ? new Date().toISOString() : d.toISOString(); };
1043
1044// Build one of OUR outbound reply Notes from an ap_outbox row.
[6bc2ca7e]1045// Turn #hashtags in reply text into Mastodon-style hashtag links (clickable + federated).
1046function linkHashtags(base, html) {
[be5d86c]1047 return String(html || '').replace(/(^|[\s>])#([\p{L}\p{M}\p{N}_]+)/gu, (m, pre, tag) =>
[6bc2ca7e]1048 `${pre}<a href="${base}/tag/${encodeURIComponent(tag.toLowerCase())}" class="mention hashtag" rel="tag">#${tag}</a>`);
1049}
1050// Extract the AP Hashtag tag objects from already-linked reply content.
1051function hashtagTags(base, content) {
1052 const tags = [], seen = new Set();
[be5d86c]1053 const re = /class="[^"]*\bhashtag\b[^"]*"[^>]*>#([\p{L}\p{M}\p{N}_]+)</giu;
[6bc2ca7e]1054 let m;
1055 while ((m = re.exec(content || ''))) {
1056 const k = m[1].toLowerCase();
1057 if (seen.has(k)) continue; seen.add(k);
1058 tags.push({ type: 'Hashtag', href: `${base}/tag/${encodeURIComponent(k)}`, name: '#' + m[1] });
1059 }
1060 return tags;
1061}
1062
[2e62848]1063// Normalise a post's tags field (array, JSON-string, or comma-string) to an array.
1064function normalizeTags(t) {
1065 if (Array.isArray(t)) return t;
1066 if (typeof t === 'string') {
1067 const s = t.trim(); if (!s) return [];
1068 if (s[0] === '[') { try { const a = JSON.parse(s); return Array.isArray(a) ? a : []; } catch { /* fall through */ } }
1069 return s.split(',').map((x) => x.trim()).filter(Boolean);
1070 }
1071 return [];
1072}
1073// A tag → { label, slug }. Multi-word tags become CamelCase (#LiveMusic) for the display
1074// name (Mastodon hashtags can't contain spaces; CamelCase is the accessibility norm); the
1075// slug/href stays lowercase ("livemusic").
1076function tagParts(raw) {
[be5d86c]1077 const words = String(raw || '').trim().split(/[\s_]+/).map((w) => w.replace(/[^\p{L}\p{M}\p{N}]/gu, '')).filter(Boolean);
[2e62848]1078 if (!words.length) return null;
1079 const slug = words.join('').toLowerCase();
1080 if (!slug) return null;
1081 const label = words.length > 1 ? words.map((w) => w[0].toUpperCase() + w.slice(1)).join('') : words[0];
1082 return { label, slug };
1083}
[7cea873]1084// Merge a post's tags field + the #hashtags linked inline in its body into one deduped
1085// Hashtag tag list (with hrefs to our /tag page).
1086function buildHashtagList(base, tagsField, content) {
1087 const out = [], seen = new Set();
[2e62848]1088 for (const t of normalizeTags(tagsField)) {
1089 const p = tagParts(t); if (!p || seen.has(p.slug)) continue; seen.add(p.slug);
1090 out.push({ type: 'Hashtag', href: `${base}/tag/${encodeURIComponent(p.slug)}`, name: '#' + p.label });
[7cea873]1091 }
1092 for (const h of hashtagTags(base, content)) {
1093 const k = h.name.slice(1).toLowerCase(); if (seen.has(k)) continue; seen.add(k);
1094 out.push(h);
1095 }
1096 return out;
1097}
1098
[dd7daef]1099// Extract Mention tag objects from already-linked content (class="u-url mention").
1100function mentionTags(content) {
1101 const tags = [], seen = new Set();
[204bd74]1102 // The link href is the human profile URL; the actor URI (for the Mention tag) is in data-actor.
1103 const re = /<a href="[^"]*" class="u-url mention" data-actor="([^"]+)">@([^<]+)<\/a>/gi;
[dd7daef]1104 let m;
1105 while ((m = re.exec(content || ''))) {
1106 const href = m[1];
1107 if (seen.has(href)) continue; seen.add(href);
1108 tags.push({ type: 'Mention', href, name: '@' + m[2] });
1109 }
1110 return tags;
1111}
1112// Resolve inline @user@domain mentions in reply/post text → link them (href = actor URI)
1113// and collect the mentioned actors' inboxes so they get notified. Best-effort per mention.
1114async function resolveMentionsInText(base, html) {
1115 const inboxes = [];
1116 const handles = new Set();
[be5d86c]1117 const re = /(^|[\s>])@([\p{L}\p{M}\p{N}_.-]+@[\p{L}\p{M}\p{N}.-]+)/gu;
[dd7daef]1118 let m;
1119 while ((m = re.exec(html || ''))) handles.add(m[2]);
1120 let out = String(html || '');
1121 for (const h of handles) {
1122 let actorUri = null;
1123 try { actorUri = await webfingerResolve('@' + h); } catch { actorUri = null; }
1124 if (!actorUri) continue;
1125 const actor = await fetchActor(actorUri).catch(() => null);
1126 const inbox = actor && ((actor.endpoints && actor.endpoints.sharedInbox) || actor.inbox);
1127 if (inbox) inboxes.push(inbox);
[204bd74]1128 const profileUrl = actorInfo(actor, actorUri).url || actorUri; // human profile page → the link href
[dd7daef]1129 const esc = h.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
[be5d86c]1130 out = out.replace(new RegExp('(^|[\\s>])@' + esc + '(?![\\p{L}\\p{M}\\p{N}_.-])', 'gu'),
[204bd74]1131 (full, pre) => `${pre}<a href="${profileUrl}" class="u-url mention" data-actor="${actorUri}">@${h}</a>`);
[dd7daef]1132 }
1133 return { html: out, inboxes };
1134}
1135
[55bc7f9]1136export function buildReplyNote(base, site, row) {
1137 const me = actorId(base, site.slug);
1138 return {
1139 id: noteId(base, row.id),
1140 type: 'Note',
1141 attributedTo: me,
1142 inReplyTo: row.in_reply_to || undefined,
1143 content: row.content,
1144 url: row.post_slug ? `${base}/${encodeURIComponent(row.post_slug)}` : undefined,
1145 published: toISO(row.created_at),
1146 to: row.to_actor ? [row.to_actor] : [PUBLIC],
1147 cc: [PUBLIC, `${me}/followers`],
[6bc2ca7e]1148 tag: [
[dd7daef]1149 ...mentionTags(row.content),
[6bc2ca7e]1150 ...hashtagTags(base, row.content),
1151 ],
[55bc7f9]1152 };
1153}
1154
1155// Resolve one of our outbound reply Notes by id (for /ap/notes/:id fallback).
1156export function getOutboxNote(base, id) {
1157 const row = iStmts().getO.get(id);
1158 if (!row) return null;
1159 const site = db.prepare('SELECT * FROM sites WHERE slug = ?').get(row.site_slug);
1160 if (!site) return null;
1161 return buildReplyNote(base, site, row);
1162}
1163
1164// Send a reply FROM this site to a remote actor (in reply to their inbound reply).
1165// `parent` = an ap_interactions row (actor_uri, actor_url, actor_handle, object_uri).
1166export async function deliverReply(site, { postId, postSlug, parent, text }) {
1167 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1168 if (!base || !site || !site.slug || !parent || !String(text || '').trim()) return null;
1169 const me = actorId(base, site.slug);
1170 const handle = parent.actor_handle || deriveHandle(parent.actor_uri);
[dd7daef]1171 const dispHandle = handle && handle[0] === '@' ? handle : '@' + (handle || '');
[55bc7f9]1172 const body = escHtml(String(text).trim()).replace(/\r?\n/g, '<br>');
[dd7daef]1173 const mres = await resolveMentionsInText(base, body); // link inline @mentions + collect their inboxes
[55bc7f9]1174 const mention = parent.actor_uri
[204bd74]1175 ? `<a href="${escHtml(parent.actor_url || parent.actor_uri)}" class="u-url mention" data-actor="${escHtml(parent.actor_uri)}">${escHtml(dispHandle)}</a> ` : '';
[dd7daef]1176 const content = `<p>${mention}${linkHashtags(base, mres.html)}</p>`;
[cc24fa1]1177 // Dedup: skip if the exact same reply was already sent (double-submit guard).
1178 const dup = db.prepare('SELECT 1 FROM ap_outbox WHERE site_slug = ? AND IFNULL(in_reply_to, \'\') = ? AND content = ? LIMIT 1')
1179 .get(site.slug, parent.object_uri || '', content);
1180 if (dup) { console.log('[AP] outreply skipped (duplicate)'); return { duplicate: true, delivered: 0 }; }
[55bc7f9]1181 const id = crypto.randomUUID();
1182 iStmts().insO.run(id, site.slug, postId, postSlug || null, parent.object_uri || null, parent.actor_uri || null, handle, content);
1183 const row = iStmts().getO.get(id);
1184 const note = buildReplyNote(base, site, row);
1185 const create = {
[d3b9f68]1186 '@context': AP_CONTEXT,
[55bc7f9]1187 id: note.id + '#create', type: 'Create', actor: me,
1188 published: note.published, to: note.to, cc: note.cc, object: note,
1189 };
1190 const keys = getOrCreateKeys(site.slug);
1191 const keyId = `${me}#main-key`;
1192 const inboxes = new Set();
1193 if (parent.actor_uri) {
1194 const a = await fetchActor(parent.actor_uri).catch(() => null);
1195 if (a) inboxes.add((a.endpoints && a.endpoints.sharedInbox) || a.inbox);
1196 }
[dc8e9bd]1197 if (parent.threadInbox) inboxes.add(parent.threadInbox); // back-compat (single)
1198 (parent.threadInboxes || []).forEach((i) => inboxes.add(i)); // whole ancestor chain
[55bc7f9]1199 for (const f of fStmts().list.all(site.slug)) inboxes.add(f.shared_inbox || f.inbox);
[dd7daef]1200 mres.inboxes.forEach((i) => inboxes.add(i)); // people @mentioned inline in the reply
[ffa53cc]1201 inboxes.delete(`${me}/inbox`); // never deliver to ourselves (already in ap_outbox)
1202 inboxes.delete(`${base}/ap/inbox`); // (our own shared inbox) → avoids a self-duplicate
[55bc7f9]1203 let delivered = 0;
1204 for (const inbox of [...inboxes].filter(Boolean)) {
1205 try { const st = await deliver(inbox, create, keyId, keys.private_pem); if (st >= 200 && st < 300) delivered++; } catch { /* best-effort */ }
1206 }
1207 console.log('[AP] outreply', site.slug, '→', parent.actor_uri, 'delivered', delivered);
1208 return { id, content, delivered };
1209}
1210
[c6bd87e]1211// attributedTo may be a string, an object {id}, or an ARRAY — e.g. a PeerTube Video is
1212// attributed to [Person (account), Group (channel)]. Pick a usable actor URI (prefer Person).
1213function actorUriOf(att) {
1214 if (!att) return null;
1215 if (typeof att === 'string') return att;
1216 if (Array.isArray(att)) {
1217 const person = att.find((a) => a && typeof a === 'object' && a.type === 'Person' && a.id);
1218 if (person) return person.id;
1219 for (const a of att) { if (typeof a === 'string') return a; if (a && a.id) return a.id; }
1220 return null;
1221 }
1222 return att.id || null;
1223}
1224
[3d7312a]1225// Resolve a remote post URL (any fediverse/Klonkt post) into a reply target.
1226// Returns a parent-shaped object usable by deliverReply(), or null.
1227export async function resolveRemoteNote(url) {
1228 if (!/^https?:\/\//i.test(String(url || ''))) return null;
1229 const note = await fetchActor(url).catch(() => null); // AP GET (content-negotiates)
1230 if (!note || !note.id) return null;
1231 const att = note.attributedTo;
[c6bd87e]1232 const actorUri = actorUriOf(att);
[3d7312a]1233 if (!actorUri) return null;
1234 const actor = await fetchActor(actorUri).catch(() => null);
1235 const ai = actorInfo(actor, actorUri);
[de3d24b]1236 // Is what we're replying to a post (or a comment) on one of OUR posts? If so,
1237 // link our reply to that local post so it shows nested in the post thread.
1238 const localTgt = findThreadTarget(note.id, (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, ''));
[dc8e9bd]1239 // Walk the WHOLE reply chain upward (comment → parent comment → … → root post)
1240 // and collect every ancestor author's inbox, so each participant's server —
1241 // including the original post's author — receives + threads our reply.
1242 const threadInboxes = [];
1243 const seenInbox = new Set();
1244 let cursor = note.inReplyTo, guard = 0;
1245 while (cursor && guard++ < 6) {
1246 const url = typeof cursor === 'string' ? cursor : (cursor && cursor.id);
1247 if (!url) break;
1248 const pn = await fetchActor(url).catch(() => null);
1249 if (!pn) break;
[c6bd87e]1250 const pa = actorUriOf(pn.attributedTo);
[dc8e9bd]1251 if (pa && pa !== actorUri) {
1252 const paDoc = await fetchActor(pa).catch(() => null);
1253 const inbox = paDoc && ((paDoc.endpoints && paDoc.endpoints.sharedInbox) || paDoc.inbox);
1254 if (inbox && !seenInbox.has(inbox)) { seenInbox.add(inbox); threadInboxes.push(inbox); }
[7d932ce]1255 }
[dc8e9bd]1256 cursor = pn.inReplyTo; // climb to the next ancestor
[7d932ce]1257 }
[c6bd87e]1258 // For non-Note objects (PeerTube Video, Article, …) the meaningful label is `name` (the
1259 // title); prepend it so the reply page shows what you're replying to (sanitize cleans it).
1260 let rawHtml = String(note.content || '').replace(/\[\[(track|album|playlist):[^\]]+\]\]/gi, '');
1261 if (note.name && note.type && note.type !== 'Note') rawHtml = `<p><strong>${note.name}</strong></p>` + rawHtml;
[2826bb97]1262 const images = (Array.isArray(note.attachment) ? note.attachment : [])
1263 .filter((a) => a && a.url && (!a.mediaType || /^image\//i.test(a.mediaType)))
[3dd99d3]1264 .map((a) => safeUrl(a.url)).filter(Boolean);
[3d7312a]1265 return {
[3dd99d3]1266 object_uri: safeUrl(note.id) || note.id,
[3d7312a]1267 actor_uri: actorUri,
1268 actor_url: ai.url,
1269 actor_handle: ai.handle,
1270 actor_name: ai.name,
1271 actor_icon: ai.icon,
[2826bb97]1272 url: note.url || url,
1273 content: HtmlSanitizerService.sanitize(rawHtml), // full, sanitized
[b7d4458]1274 sensitive: !!note.sensitive, // remote CW → blur in the Cirkel
1275 cw: note.summary || '',
[2826bb97]1276 images,
[dc8e9bd]1277 threadInboxes, // every ancestor author's inbox
[de3d24b]1278 localPostId: localTgt ? localTgt.post_id : '', // our post this belongs to (if any)
[3d7312a]1279 preview: HtmlSanitizerService.toPlainText(note.content || '').slice(0, 240),
1280 };
1281}
1282
[7d932ce]1283// List a site's own outbound fediverse replies (for the manage/delete view).
[bddbfe0]1284// The plain editable text of a stored reply (unwrap links → their text, <br> → newline)
1285// so the manage view can prefill an edit box; the mention is re-added on save.
1286function outboxEditableText(content) {
1287 return String(content || '')
1288 .replace(/<br\s*\/?>/gi, '\n')
1289 .replace(/<a\b[^>]*>([\s\S]*?)<\/a>/gi, '$1')
1290 .replace(/<[^>]+>/g, '')
1291 .replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&')
1292 .trim();
1293}
[7d932ce]1294export function listOutbox(siteSlug) {
[7e66e7e]1295 return db.prepare('SELECT id, content, to_handle, in_reply_to, created_at FROM ap_outbox WHERE site_slug = ? ORDER BY created_at DESC')
[bddbfe0]1296 .all(siteSlug).map((r) => { const c = stripLeadingMentions(r.content); return { ...r, content: c, editable: outboxEditableText(c) }; });
[7d932ce]1297}
1298
1299// Delete one of our outbound replies: send Delete(Tombstone) to recipients + remove it.
1300export async function deliverOutboxDelete(site, outboxId) {
1301 const row = iStmts().getO.get(outboxId);
1302 if (!row || row.site_slug !== site.slug) return false;
1303 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1304 if (base) {
1305 const me = actorId(base, site.slug);
1306 const nid = noteId(base, row.id);
[d3b9f68]1307 const del = { '@context': AP_CONTEXT, id: `${nid}#delete-${Date.now()}-${rid()}`, type: 'Delete', actor: me, to: [PUBLIC], object: { id: nid, type: 'Tombstone' } };
[7d932ce]1308 const keys = getOrCreateKeys(site.slug);
1309 const inboxes = new Set();
1310 if (row.to_actor) { const a = await fetchActor(row.to_actor).catch(() => null); if (a) inboxes.add((a.endpoints && a.endpoints.sharedInbox) || a.inbox); }
1311 for (const f of fStmts().list.all(site.slug)) inboxes.add(f.shared_inbox || f.inbox);
1312 for (const inbox of [...inboxes].filter(Boolean)) { try { await deliver(inbox, del, `${me}#main-key`, keys.private_pem); } catch { /* best-effort */ } }
1313 }
1314 db.prepare('DELETE FROM ap_outbox WHERE id = ?').run(outboxId);
1315 return true;
1316}
1317
[bddbfe0]1318// Edit one of our outbound replies: rewrite the stored content (mention re-added + #tags
1319// re-linked) and send an Update(Note) so recipients refresh their cached copy.
1320export async function deliverOutboxUpdate(site, outboxId, newText) {
1321 const row = iStmts().getO.get(outboxId);
1322 if (!row || row.site_slug !== site.slug) return false;
1323 const text = String(newText || '').trim();
1324 if (!text) return false;
1325 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1326 if (!base) return false;
1327 const me = actorId(base, site.slug);
[204bd74]1328 const toActor = row.to_actor ? await fetchActor(row.to_actor).catch(() => null) : null;
1329 const toProfile = row.to_actor ? (actorInfo(toActor, row.to_actor).url || row.to_actor) : '';
1330 const _h = row.to_handle || deriveHandle(row.to_actor);
1331 const toHandle = _h && _h[0] === '@' ? _h : '@' + (_h || '');
[bddbfe0]1332 const mention = row.to_actor
[204bd74]1333 ? `<a href="${escHtml(toProfile)}" class="u-url mention" data-actor="${escHtml(row.to_actor)}">${escHtml(toHandle)}</a> ` : '';
[dd7daef]1334 const mres = await resolveMentionsInText(base, escHtml(text).replace(/\r?\n/g, '<br>'));
1335 const content = `<p>${mention}${linkHashtags(base, mres.html)}</p>`;
[bddbfe0]1336 db.prepare('UPDATE ap_outbox SET content = ? WHERE id = ?').run(content, outboxId);
1337 const note = buildReplyNote(base, site, iStmts().getO.get(outboxId));
1338 note.updated = new Date().toISOString();
1339 const update = {
[d3b9f68]1340 '@context': AP_CONTEXT,
[bddbfe0]1341 id: `${note.id}#update-${Date.now()}-${rid()}`, type: 'Update', actor: me,
1342 published: note.published, updated: note.updated, to: note.to, cc: note.cc, object: note,
1343 };
1344 const keys = getOrCreateKeys(site.slug);
1345 const inboxes = new Set();
[204bd74]1346 if (toActor) inboxes.add((toActor.endpoints && toActor.endpoints.sharedInbox) || toActor.inbox);
[bddbfe0]1347 for (const f of fStmts().list.all(site.slug)) inboxes.add(f.shared_inbox || f.inbox);
[204bd74]1348 mres.inboxes.forEach((i) => inboxes.add(i)); // people @mentioned inline in the edit
[bddbfe0]1349 inboxes.delete(`${me}/inbox`); inboxes.delete(`${base}/ap/inbox`);
1350 let delivered = 0;
1351 for (const inbox of [...inboxes].filter(Boolean)) {
1352 try { const st = await deliver(inbox, update, `${me}#main-key`, keys.private_pem); if (st >= 200 && st < 300) delivered++; } catch { /* best-effort */ }
1353 }
1354 console.log('[AP] outreply edit', site.slug, 'delivered', delivered);
1355 return { ok: true, content, delivered };
1356}
1357
[914eb9f]1358// ── Fediverse CLIENT: follow accounts + home timeline ─────────────
1359// Resolve an @user@domain handle to its actor URL via WebFinger.
1360export async function webfingerResolve(handle) {
1361 const h = String(handle || '').trim().replace(/^@/, '');
1362 const parts = h.split('@');
1363 if (parts.length !== 2 || !parts[0] || !parts[1]) return null;
1364 const acct = `${parts[0]}@${parts[1]}`;
1365 try {
[3dd99d3]1366 const r = await safeFetch(`https://${parts[1]}/.well-known/webfinger?resource=acct:${encodeURIComponent(acct)}`,
1367 { headers: { Accept: 'application/jrd+json, application/json' } });
[914eb9f]1368 if (!r.ok) return null;
1369 const jrd = await r.json();
1370 const link = (jrd.links || []).find((l) => l.rel === 'self' && /activity\+json|ld\+json/.test(l.type || ''));
[3dd99d3]1371 return safeUrl(link ? link.href : '') || null;
[914eb9f]1372 } catch { return null; }
1373}
1374
[f278df9]1375let _insFw, _delFw, _listFw, _accFw, _oneFw, _setAB;
[914eb9f]1376function fwStmts() {
1377 if (!_insFw) {
[f278df9]1378 _insFw = db.prepare('INSERT OR REPLACE INTO ap_following (slug, actor_uri, handle, name, icon, url, inbox, follow_id, status, auto_boost, created_at) VALUES (?,?,?,?,?,?,?,?,?,?,CURRENT_TIMESTAMP)');
[914eb9f]1379 _delFw = db.prepare('DELETE FROM ap_following WHERE slug = ? AND actor_uri = ?');
1380 _listFw = db.prepare('SELECT * FROM ap_following WHERE slug = ? ORDER BY created_at DESC');
1381 _accFw = db.prepare("UPDATE ap_following SET status = 'accepted' WHERE follow_id = ?");
1382 _oneFw = db.prepare('SELECT * FROM ap_following WHERE slug = ? AND actor_uri = ?');
[f278df9]1383 _setAB = db.prepare('UPDATE ap_following SET auto_boost = ? WHERE slug = ? AND actor_uri = ?');
[914eb9f]1384 }
[f278df9]1385 return { ins: _insFw, del: _delFw, list: _listFw, acc: _accFw, one: _oneFw, setAB: _setAB };
[914eb9f]1386}
1387export function listFollowing(slug) { return fwStmts().list.all(slug); }
1388
[f278df9]1389// Toggle auto-boost ("feature") on an account we already follow.
1390export function setAutoBoost(slug, actorUri, on) {
1391 try { fwStmts().setAB.run(on ? 1 : 0, slug, actorUri); } catch { /* ignore */ }
[bea59a1]1392 // Featuring an account → AP-native catch-up so the Cirkel isn't empty until they next
1393 // post (push doesn't backfill history-before-follow). Fire-and-forget pull, sends nothing.
1394 if (on) backfillFromOutbox(slug, actorUri).catch(() => {});
[f278df9]1395 return { ok: true };
1396}
1397
[914eb9f]1398let _insTl, _listTl, _delTl;
1399function tlStmts() {
1400 if (!_insTl) {
[b7d4458]1401 _insTl = db.prepare('INSERT OR IGNORE INTO ap_timeline (id, slug, author_uri, author_name, author_handle, author_icon, author_url, content, url, published, media_json, nsfw, cw, created_at) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,CURRENT_TIMESTAMP)');
[914eb9f]1402 _listTl = db.prepare('SELECT * FROM ap_timeline WHERE slug = ? ORDER BY COALESCE(published, created_at) DESC LIMIT ?');
1403 _delTl = db.prepare('DELETE FROM ap_timeline WHERE id = ?');
1404 }
1405 return { ins: _insTl, list: _listTl, del: _delTl };
1406}
1407export function getTimeline(slug, limit) { return tlStmts().list.all(slug, limit || 50); }
1408
[2c22bb5]1409// ── Cirkel = posts from the accounts you auto-boost ("feature an artist") ──
1410let _abCount, _cirkelPosts, _cirkelMembers;
1411export function autoBoostCount(slug) {
1412 try { if (!_abCount) _abCount = db.prepare('SELECT COUNT(*) AS n FROM ap_following WHERE slug = ? AND auto_boost = 1'); return _abCount.get(slug).n; } catch { return 0; }
1413}
1414export function getCirkelPosts(slug, limit) {
1415 try {
[5045c30]1416 // Cirkel = posts from featured (auto_boost) accounts + posts you boosted
1417 // (t.boosted), mixed by date. One row per note in ap_timeline → no duplicates.
[2c22bb5]1418 if (!_cirkelPosts) _cirkelPosts = db.prepare(`
1419 SELECT t.id, t.author_uri, t.author_name, t.author_handle, t.author_icon, t.author_url,
[b7d4458]1420 t.content, t.url, t.published, t.media_json, t.boosted, t.nsfw, t.cw
[2c22bb5]1421 FROM ap_timeline t
[5045c30]1422 LEFT JOIN ap_following f ON f.slug = t.slug AND f.actor_uri = t.author_uri
1423 WHERE t.slug = ? AND (f.auto_boost = 1 OR t.boosted = 1)
[2c22bb5]1424 ORDER BY COALESCE(t.published, t.created_at) DESC, t.rowid DESC
1425 LIMIT ?`);
1426 return _cirkelPosts.all(slug, limit || 60);
1427 } catch { return []; }
1428}
1429export function getCirkelMembers(slug) {
1430 try { if (!_cirkelMembers) _cirkelMembers = db.prepare('SELECT name, url, icon FROM ap_following WHERE slug = ? AND auto_boost = 1 ORDER BY name'); return _cirkelMembers.all(slug); } catch { return []; }
1431}
[5045c30]1432// Mark a timeline post as boosted so it shows in the Cirkel (mixed by date).
[78b6d8a]1433let _markBoost, _unmarkBoost, _boostedCount;
[5045c30]1434export function markBoosted(slug, noteId) {
1435 try { if (!_markBoost) _markBoost = db.prepare('UPDATE ap_timeline SET boosted = 1 WHERE slug = ? AND id = ?'); _markBoost.run(slug, noteId); } catch { /* ignore */ }
1436}
[78b6d8a]1437export function unmarkBoosted(slug, noteId) {
1438 try { if (!_unmarkBoost) _unmarkBoost = db.prepare('UPDATE ap_timeline SET boosted = 0 WHERE slug = ? AND id = ?'); _unmarkBoost.run(slug, noteId); } catch { /* ignore */ }
1439}
[9d34855]1440let _markLike, _unmarkLike;
1441export function markLiked(slug, noteId) {
1442 try { if (!_markLike) _markLike = db.prepare('UPDATE ap_timeline SET liked = 1 WHERE slug = ? AND id = ?'); _markLike.run(slug, noteId); } catch { /* ignore */ }
1443}
1444export function unmarkLiked(slug, noteId) {
1445 try { if (!_unmarkLike) _unmarkLike = db.prepare('UPDATE ap_timeline SET liked = 0 WHERE slug = ? AND id = ?'); _unmarkLike.run(slug, noteId); } catch { /* ignore */ }
1446}
[0a75356]1447export function getTimelineReaction(slug, noteId) {
1448 try { const r = db.prepare('SELECT liked, boosted FROM ap_timeline WHERE slug = ? AND id = ?').get(slug, noteId); return { liked: !!(r && r.liked), boosted: !!(r && r.boosted) }; } catch { return { liked: false, boosted: false }; }
1449}
[74d61e6]1450// Boost a REMOTE post that may not be in your timeline (you don't follow the author):
1451// store it in ap_timeline (INSERT OR IGNORE → no dup for followed posts) so it shows in
1452// the Cirkel with a Boost badge, then flag it boosted.
1453export function upsertBoostedNote(slug, note) {
1454 if (!slug || !note || !note.object_uri) return;
1455 const id = note.object_uri;
1456 const media = JSON.stringify((note.images || []).map((u) => ({ url: u, type: 'image/jpeg' })));
1457 try {
1458 tlStmts().ins.run(id, slug, note.actor_uri || '', note.actor_name || '', note.actor_handle || '',
1459 note.actor_icon || '', note.actor_url || '', note.content || '', note.url || null,
[b7d4458]1460 new Date().toISOString(), media, note.sensitive ? 1 : 0, note.cw || null);
[74d61e6]1461 } catch { /* ignore */ }
1462 markBoosted(slug, id);
1463}
[5045c30]1464export function boostedCount(slug) {
1465 try { if (!_boostedCount) _boostedCount = db.prepare('SELECT COUNT(*) AS n FROM ap_timeline WHERE slug = ? AND boosted = 1'); return _boostedCount.get(slug).n; } catch { return 0; }
1466}
[2c22bb5]1467
[4c47eff]1468// Resolve a Klonkt/AP actor URL from a site root: a Klonkt site's root 302s to
1469// /ap/users/<slug> (content negotiation; Location may be relative). Used by
1470// followActor for bare-domain follows.
1471// NB: the old auto-migration of legacy Cirkels (circle_links -> AP follows) was
1472// REMOVED on 2026-06-26 — it auto-sent Follows on boot, which violates "the code
1473// never throws anything into the fediverse automatically" (would surprise-Follow
1474// for some operators at scale). The dead circle_links table stays as harmless dead
[297c77d]1475// data; an operator restores an old cirkel by re-following in /following (their click).
[d71ed03]1476async function resolveApActor(siteUrl) {
1477 try {
1478 const r = await fetch(siteUrl, { headers: { Accept: 'application/activity+json' }, redirect: 'manual' });
1479 if (r.status >= 300 && r.status < 400) { const loc = r.headers.get('location'); if (loc) return new URL(loc, siteUrl).href; }
1480 if (r.ok) return siteUrl;
1481 } catch { /* unreachable */ }
1482 return null;
1483}
1484
[b79466e]1485// ── Self-heal: re-sync the fediverse cache (ap_timeline) after a DRASTIC update ──
1486// Runs ONCE per SELFHEAL_VERSION bump — NOT on every boot. Re-fetches each cached
1487// note and refreshes content + media (recovers covers/edits that were delivered
1488// during a flux window, e.g. a fleet-wide update), and drops notes that are gone
1489// (404/410). Bump SELFHEAL_VERSION only on a release that warrants a re-sync.
[9e4e4ff]1490const SELFHEAL_VERSION = 2;
[b79466e]1491async function fetchNoteAP(url) {
1492 try {
1493 const r = await fetch(url, { headers: { Accept: 'application/activity+json' } });
1494 if (r.status === 404 || r.status === 410) return 404;
1495 if (r.ok) return await r.json();
1496 } catch { /* unreachable */ }
1497 return null;
1498}
1499function mediaFromNote(note) {
1500 const atts = (Array.isArray(note.attachment) ? note.attachment : []).map((a) => ({ url: safeUrl(a && a.url), type: (a && a.mediaType) || '' })).filter((m) => m.url);
1501 if (!atts.some((m) => !m.type || /image/i.test(m.type)) && note.image) {
1502 const im = Array.isArray(note.image) ? note.image[0] : note.image;
1503 const iu = safeUrl(typeof im === 'string' ? im : (im && im.url));
1504 if (iu) atts.push({ url: iu, type: (im && im.mediaType) || 'image/jpeg' });
1505 }
1506 return JSON.stringify(atts);
1507}
[bea59a1]1508// A generic SSRF-safe AP GET (collections / pages).
1509async function apGetJson(url) {
1510 try {
1511 const r = await safeFetch(url, { headers: { Accept: 'application/activity+json' } });
1512 if (!r.ok) return null;
1513 const len = Number(r.headers.get('content-length') || 0);
1514 if (len > 3_000_000) return null;
1515 return await r.json();
1516 } catch { return null; }
1517}
1518// AP-native catch-up: pull an actor's standard `outbox` collection and merge their recent
1519// top-level posts into the timeline for `slug`. Push (Create delivery) cannot backfill
1520// history-from-before-you-followed or a delivery that was missed while you were down;
1521// reading the outbox is the spec-conform way to catch up. PULL ONLY — sends nothing.
1522export async function backfillFromOutbox(slug, actorUri, limit = 20) {
1523 try {
1524 if (!slug || !actorUri) return 0;
1525 const actor = await fetchActor(actorUri);
1526 if (!actor || !actor.outbox) return 0;
1527 let page = await apGetJson(typeof actor.outbox === 'string' ? actor.outbox : actor.outbox.id);
1528 let items = (page && (page.orderedItems || page.items)) || [];
1529 if (!items.length && page && page.first) {
1530 page = await apGetJson(typeof page.first === 'string' ? page.first : page.first.id);
1531 items = (page && (page.orderedItems || page.items)) || [];
1532 }
1533 if (!Array.isArray(items) || !items.length) return 0;
1534 const ai = actorInfo(actor, actorUri);
1535 let added = 0;
1536 for (const it of items.slice(0, limit)) {
1537 // Each item is usually a Create wrapping a Note, or sometimes the Note itself.
1538 const o = (it && typeof it.object === 'object' && it.object) ? it.object : it;
1539 if (!o || !o.id) continue;
1540 if (o.type && o.type !== 'Note' && o.type !== 'Article') continue; // skip boosts/other
1541 if (o.inReplyTo) continue; // top-level only
1542 const auth = actorUriOf(o.attributedTo);
1543 if (auth && auth !== actorUri) continue; // their OWN posts only
1544 const html = HtmlSanitizerService.sanitize(o.content || '');
1545 try {
1546 const r = tlStmts().ins.run(o.id, slug, actorUri, ai.name, ai.handle, ai.icon, ai.url, html, o.url || null, o.published || null, mediaFromNote(o), o.sensitive ? 1 : 0, o.summary || null);
1547 if (r && r.changes > 0) added++;
1548 } catch { /* ignore */ }
1549 }
1550 if (added) console.log('[AP] outbox backfill', actorUri, '→', slug, '+' + added);
1551 return added;
1552 } catch { return 0; }
1553}
[b79466e]1554let _selfHealing = false;
1555export async function selfHealTimeline() {
1556 if (_selfHealing) return; _selfHealing = true;
1557 try {
1558 let cur = 0;
1559 try { const r = db.prepare('SELECT value FROM app_settings WHERE key = ?').get('selfheal_version'); cur = r ? (parseInt(r.value, 10) || 0) : 0; } catch { return; }
1560 if (cur >= SELFHEAL_VERSION) return; // already healed for this version — skip on normal boots
1561 let rows = [];
[9e4e4ff]1562 try { rows = db.prepare('SELECT id, content, media_json, nsfw, cw FROM ap_timeline ORDER BY rowid DESC LIMIT 200').all(); } catch { /* no table */ }
[b79466e]1563 let healed = 0;
1564 for (const r of rows) {
1565 try {
1566 const note = await fetchNoteAP(r.id);
1567 if (note === 404) { db.prepare('DELETE FROM ap_timeline WHERE id = ?').run(r.id); healed++; continue; }
1568 if (!note || typeof note !== 'object') continue;
1569 const html = HtmlSanitizerService.sanitize(note.content || '');
1570 const media = mediaFromNote(note);
[9e4e4ff]1571 const nsfw = note.sensitive ? 1 : 0; // re-sync NSFW/sensitive + CW onto already-cached posts
1572 const cw = note.summary || null;
1573 if ((html && html !== r.content) || media !== (r.media_json || '[]') || nsfw !== (r.nsfw || 0) || (cw || '') !== (r.cw || '')) {
1574 db.prepare('UPDATE ap_timeline SET content = ?, media_json = ?, nsfw = ?, cw = ? WHERE id = ?').run(html || r.content, media, nsfw, cw, r.id);
[b79466e]1575 healed++;
1576 }
1577 } catch { /* per-note best-effort */ }
1578 }
1579 try { db.prepare('INSERT OR REPLACE INTO app_settings (key, value) VALUES (?, ?)').run('selfheal_version', String(SELFHEAL_VERSION)); } catch { /* ignore */ }
1580 if (rows.length) console.log(`[AP] self-heal v${SELFHEAL_VERSION}: ${healed}/${rows.length} timeline notes`);
1581 } catch { /* never block boot */ } finally { _selfHealing = false; }
1582}
1583
[914eb9f]1584// Follow a fediverse account by @handle (WebFinger → actor → signed Follow).
[f278df9]1585export async function followActor(site, handle, autoBoost = false) {
[914eb9f]1586 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1587 if (!base || !site || !site.slug) return { error: 'config' };
[98688c6]1588 // Accept any of: a profile/actor URL, an @user@host handle (WebFinger), or a
1589 // bare site domain (site.com) — for a single-actor site (Klonkt etc.) the root
1590 // resolves to its AP actor, so you can follow a site by just its domain.
[8ad1784]1591 const s = String(handle || '').trim();
[98688c6]1592 let actorUrl;
1593 if (/^https?:\/\//i.test(s)) actorUrl = safeUrl(s) || null;
1594 else if (s.includes('@')) actorUrl = await webfingerResolve(s);
1595 else if (/^[a-z0-9.-]+\.[a-z]{2,}/i.test(s)) actorUrl = await resolveApActor('https://' + s.replace(/^\/+|\/+$/g, ''));
1596 else actorUrl = null;
[914eb9f]1597 if (!actorUrl) return { error: 'not_found' };
1598 const actor = await fetchActor(actorUrl).catch(() => null);
1599 if (!actor || !actor.id || !actor.inbox) return { error: 'unreachable' };
1600 const ai = actorInfo(actor, actor.id);
1601 const me = actorId(base, site.slug);
1602 const keys = getOrCreateKeys(site.slug);
[3dd99d3]1603 const followId = `${me}#follow-${Date.now()}-${rid()}`;
[f278df9]1604 fwStmts().ins.run(site.slug, actor.id, ai.handle, ai.name, ai.icon, ai.url, actor.inbox, followId, 'pending', autoBoost ? 1 : 0);
[d3b9f68]1605 const follow = { '@context': AP_CONTEXT, id: followId, type: 'Follow', actor: me, object: actor.id };
[914eb9f]1606 try { await deliver(actor.inbox, follow, `${me}#main-key`, keys.private_pem); }
1607 catch (e) { console.warn('[AP] follow deliver failed:', e.message); }
1608 console.log('[AP] follow', site.slug, '→', actor.id);
[bea59a1]1609 // Follow + feature in one step → backfill their recent posts into the Cirkel right away.
1610 if (autoBoost) backfillFromOutbox(site.slug, actor.id).catch(() => {});
[484adf8]1611 return { ok: true, name: ai.name, handle: ai.handle, actor: actor.id };
[914eb9f]1612}
1613
[8ad1784]1614// Resolve a profile URL or @handle to a followable remote actor (for the
1615// authorize_interaction "Follow" flow). Returns display fields + inbox, or null
1616// when it isn't a reachable actor (e.g. the input was a post, not a profile).
1617export async function resolveRemoteActor(input) {
1618 const s = String(input || '').trim();
1619 const actorUrl = /^https?:\/\//i.test(s) ? (safeUrl(s) || null) : await webfingerResolve(s);
1620 if (!actorUrl) return null;
1621 const actor = await fetchActor(actorUrl).catch(() => null);
1622 if (!actor || !actor.id || !actor.inbox) return null;
1623 const ai = actorInfo(actor, actor.id);
1624 return { actor_uri: actor.id, actor_name: ai.name, actor_handle: ai.handle, actor_url: ai.url, actor_icon: ai.icon, inbox: actor.inbox };
1625}
1626
[914eb9f]1627export async function unfollowActor(site, actorUri) {
1628 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1629 const me = actorId(base, site.slug);
1630 const keys = getOrCreateKeys(site.slug);
1631 const row = fwStmts().one.get(site.slug, actorUri);
[f2796d3]1632 // Undo(Follow) MUST reference the original Follow's real id so the remote can correlate it
1633 // and drop the follow. The old `${me}#follow` fallback never matched anything → the unfollow
1634 // silently failed on the remote. With no stored follow id (legacy row), skip the network Undo
1635 // rather than send an unmatchable one. Deliver durably via the retry queue.
1636 if (row && row.inbox && row.follow_id) {
[d3b9f68]1637 const undo = { '@context': AP_CONTEXT, id: `${me}/undo/${Date.now()}-${rid()}`, type: 'Undo', actor: me, object: { id: row.follow_id, type: 'Follow', actor: me, object: actorUri } };
[f2796d3]1638 deliverWithRetry(site.slug, row.inbox, undo, `${me}#main-key`, keys.private_pem);
1639 } else if (row && row.inbox) {
1640 console.warn('[AP] unfollow', site.slug, '→', actorUri, '— no stored follow id; removed locally only (legacy follow, remote may keep it)');
[914eb9f]1641 }
1642 fwStmts().del.run(site.slug, actorUri);
1643 return { ok: true };
1644}
1645
[d988fa0]1646// Send a Like or Announce (boost) on a remote note FROM this site.
1647export async function sendInteraction(site, kind, targetNoteId, authorUri) {
1648 const base = (process.env.PUBLIC_BASE_URL || '').replace(/\/+$/, '');
1649 if (!base || !site || !site.slug || !targetNoteId) return { error: 'config' };
1650 const me = actorId(base, site.slug);
1651 const keys = getOrCreateKeys(site.slug);
[78b6d8a]1652 // 'unboost' = Undo(Announce): retracts a boost so followers' servers remove the
1653 // reblog (matched on actor+object — no record of the original Announce needed).
1654 const fanout = (kind === 'boost' || kind === 'unboost'); // also goes to our followers
[fb6819d]1655 const followersCol = `${me}/followers`;
1656 // Address the original author in cc so their server (Mastodon, WordPress/ActivityPub, …)
1657 // attributes the boost to their post and notifies them — without this, a shared-inbox
1658 // receiver has nothing to route the Announce to. Non-fragment activity ids + a `published`
1659 // stamp keep us aligned with what Mastodon emits.
1660 const audience = authorUri ? [followersCol, authorUri] : [followersCol];
[78b6d8a]1661 let act;
[3289a64]1662 if (kind === 'unboost' || kind === 'unlike') {
1663 // Undo(Announce) retracts a boost; Undo(Like) un-favourites (matched on actor+object,
1664 // no record of the original activity needed — Mastodon honours both).
1665 const inner = kind === 'unboost' ? 'Announce' : 'Like';
[78b6d8a]1666 act = {
[d3b9f68]1667 '@context': AP_CONTEXT,
[fb6819d]1668 id: `${me}/undo/${Date.now()}-${rid()}`, type: 'Undo', actor: me,
1669 object: { id: `${me}/${inner.toLowerCase()}/${Date.now()}-${rid()}`, type: inner, actor: me, object: targetNoteId },
[78b6d8a]1670 };
[fb6819d]1671 if (kind === 'unboost') { act.to = [PUBLIC]; act.cc = audience; }
[78b6d8a]1672 } else {
1673 const type = kind === 'boost' ? 'Announce' : 'Like';
1674 act = {
[d3b9f68]1675 '@context': AP_CONTEXT,
[fb6819d]1676 id: `${me}/${type.toLowerCase()}/${Date.now()}-${rid()}`,
[78b6d8a]1677 type, actor: me, object: targetNoteId,
1678 };
[fb6819d]1679 if (type === 'Announce') { act.published = new Date().toISOString(); act.to = [PUBLIC]; act.cc = audience; }
[78b6d8a]1680 }
[d988fa0]1681 const inboxes = new Set();
[fb6819d]1682 // Author first, via their PERSONAL inbox (not the shared one) so a multi-user receiver
1683 // routes the Announce/Like to the right post unambiguously.
1684 if (authorUri) { const a = await fetchActor(authorUri).catch(() => null); if (a) inboxes.add(a.inbox || (a.endpoints && a.endpoints.sharedInbox)); }
[78b6d8a]1685 if (fanout) { for (const f of fStmts().list.all(site.slug)) inboxes.add(f.shared_inbox || f.inbox); }
[fb6819d]1686 // Queue each delivery (immediate attempt + backoff retries on failure via ap_delivery)
1687 // instead of a single fire-and-forget POST, so a transient hiccup at the receiver doesn't
1688 // silently lose the boost — same durability a new post (deliverCreate) already gets.
1689 let queued = 0;
1690 for (const inbox of [...inboxes].filter(Boolean)) { deliverWithRetry(site.slug, inbox, act, `${me}#main-key`, keys.private_pem); queued++; }
1691 console.log('[AP]', kind, site.slug, '→', targetNoteId, 'queued', queued, 'inbox(es)');
1692 return { ok: true, delivered: queued };
[d988fa0]1693}
1694
[00f669b]1695// Notifications inbox: new followers + replies/likes/boosts on this site's posts.
1696export function getNotifications(slug, limit) {
1697 const out = [];
1698 try {
1699 for (const f of db.prepare('SELECT actor_uri, created_at FROM ap_followers WHERE slug = ? ORDER BY created_at DESC LIMIT 50').all(slug)) {
1700 out.push({ type: 'follow', handle: deriveHandle(f.actor_uri), url: f.actor_uri, created_at: f.created_at });
1701 }
1702 } catch { /* ignore */ }
1703 try {
1704 const rows = db.prepare(`
1705 SELECT i.kind, i.actor_name, i.actor_handle, i.actor_url, i.content, i.created_at,
1706 p.slug AS post_slug, p.title AS post_title
1707 FROM ap_interactions i LEFT JOIN posts p ON p.id = i.post_id
1708 WHERE p.site_id = (SELECT id FROM sites WHERE slug = ?)
1709 ORDER BY i.created_at DESC LIMIT 80
1710 `).all(slug);
1711 for (const r of rows) out.push({
1712 type: r.kind, name: r.actor_name, handle: r.actor_handle, url: r.actor_url,
[7e66e7e]1713 content: stripLeadingMentions(r.content), post_slug: r.post_slug, post_title: r.post_title, created_at: r.created_at,
[00f669b]1714 });
1715 } catch { /* ignore */ }
1716 out.sort((a, b) => new Date(b.created_at) - new Date(a.created_at));
1717 return out.slice(0, limit || 60);
1718}
1719
[f5c3870]1720// ── Blocking / defederation ───────────────────────────────────────
1721let _insBl, _delBl, _listBl;
1722function blStmts() {
1723 if (!_insBl) {
1724 _insBl = db.prepare('INSERT OR IGNORE INTO ap_blocks (slug, target, kind, label, created_at) VALUES (?,?,?,?,CURRENT_TIMESTAMP)');
1725 _delBl = db.prepare('DELETE FROM ap_blocks WHERE slug = ? AND target = ?');
1726 _listBl = db.prepare('SELECT * FROM ap_blocks WHERE slug = ? ORDER BY created_at DESC');
1727 }
1728 return { ins: _insBl, del: _delBl, list: _listBl };
1729}
1730export function listBlocks(slug) { return blStmts().list.all(slug); }
1731
1732// True if an actor (or its whole domain) is blocked anywhere on this instance.
1733export function isBlockedAny(actorUri) {
1734 if (!actorUri) return false;
1735 let domain = ''; try { domain = new URL(actorUri).host; } catch { /* ignore */ }
1736 try { return !!db.prepare("SELECT 1 FROM ap_blocks WHERE (kind='actor' AND target=?) OR (kind='domain' AND target=?) LIMIT 1").get(actorUri, domain); }
1737 catch { return false; }
1738}
1739
1740function purgeBlocked(kind, target) {
1741 try {
1742 if (kind === 'domain') {
1743 const like = `%//${target}/%`;
1744 db.prepare('DELETE FROM ap_interactions WHERE actor_uri LIKE ?').run(like);
1745 db.prepare('DELETE FROM ap_timeline WHERE author_uri LIKE ?').run(like);
1746 db.prepare('DELETE FROM ap_followers WHERE actor_uri LIKE ?').run(like);
1747 } else {
1748 db.prepare('DELETE FROM ap_interactions WHERE actor_uri = ?').run(target);
1749 db.prepare('DELETE FROM ap_timeline WHERE author_uri = ?').run(target);
1750 db.prepare('DELETE FROM ap_followers WHERE actor_uri = ?').run(target);
1751 }
1752 } catch { /* best-effort */ }
1753}
1754
1755// Block an actor (@handle or actor URL) or a whole domain; purges their content.
1756export async function blockTarget(site, input) {
1757 const raw = String(input || '').trim();
1758 if (!site || !site.slug || !raw) return { error: 'empty' };
1759 let kind, target, label;
1760 if (/^https?:\/\//i.test(raw)) { kind = 'actor'; target = raw; label = raw; }
1761 else if (raw.includes('@')) {
1762 const actorUrl = await webfingerResolve(raw);
1763 if (!actorUrl) return { error: 'not_found' };
1764 kind = 'actor'; target = actorUrl; label = raw.startsWith('@') ? raw : ('@' + raw);
1765 } else { kind = 'domain'; target = raw.toLowerCase(); label = raw.toLowerCase(); }
1766 blStmts().ins.run(site.slug, target, kind, label);
1767 purgeBlocked(kind, target);
1768 console.log('[AP] block', site.slug, kind, target);
1769 return { ok: true, label };
1770}
1771
1772export function unblock(site, target) { blStmts().del.run(site.slug, target); return { ok: true }; }
1773
[6bd25d1]1774export default {
[d3b9f68]1775 AP_CONTEXT, getOrCreateKeys, apWants, sendAP, actorId, noteId,
[f2796d3]1776 buildActor, buildNote, buildCreate, buildOutbox, buildFollowers, buildFollowing, buildFeatured,
[55bba23]1777 followerCount, deliver, fetchActor, verifyRequest, handleInbox, deliverCreate, deliverDelete, deliverUpdate, deliverActorUpdate, resyncFeaturedPins,
[3d37c67]1778 getInteractions, getInteractionById, setInteractionBoosted, setInteractionLiked, setMyReaction, getMyReactions, buildReplyNote, getOutboxNote, deliverReply, resolveRemoteNote,
[bddbfe0]1779 listOutbox, deliverOutboxDelete, deliverOutboxUpdate,
[bea59a1]1780 webfingerResolve, followActor, resolveRemoteActor, unfollowActor, listFollowing, setAutoBoost, backfillFromOutbox, getTimeline, sendInteraction,
[74d61e6]1781 autoBoostCount, boostedCount, markBoosted, unmarkBoosted, markLiked, unmarkLiked, getTimelineReaction, upsertBoostedNote, getCirkelPosts, getCirkelMembers, selfHealTimeline,
[f5c3870]1782 getNotifications, listBlocks, isBlockedAny, blockTarget, unblock,
[5a6a457]1783 deliverWithRetry, enqueueDelivery, processDeliveryQueue, startDeliveryWorker,
[30271e6]1784 getReplyUris, markNotificationsSeen, countUnseenNotifications, hasPlayableAudio,
[6bd25d1]1785};
Note: See TracBrowser for help on using the repository browser.