v4: a new link between two dumps shows among their related dumps at once — it showed on the next load of the page: the backlink service recorded the link without telling anyone, and the dump page fetched its related dumps once, the socket then only editing or removing the ones it had. relinkBacklinks now sends dump_related_changed when a note or a comment gains or loses a link, naming the dump and those at the other end, and the page showing one of them fetches /related again. A link shows to those who may see both its ends, so each socket is told only of the dumps its user may see, and not at all without one at each end. A private dump that turns public sends it too, for the links it already had, which are new to everyone but its poster. The page also fetches its related dumps again on a reconnection, as it does its comments and playlists.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

api/services/backlink-service.ts

@@ -1,7 +1,8 @@
 /**
  * Records which dumps a dump's note and comments link to, and finds the dumps
  * related to one through those links. The dump and comment services keep the
- * links up to date, and the dump page lists the related dumps.
+ * links up to date, and the dump page lists the related dumps, which it
+ * fetches again when `dump_related_changed` says they changed.
  *
  * @module
  */
@@ -16,6 +17,7 @@ import {
 import { parsePagePath } from "../../shared/paths.ts";
 import { canonicalizeUrl } from "../lib/canonical-url.ts";
 import { parseRows } from "../model/rows.ts";
+import { broadcastDumpRelatedChanged } from "./ws-service.ts";
 
 /**
  * Matches an http(s) URL in Markdown. It stops at the delimiters of
@@ -46,6 +48,42 @@ function resolveDumpPathId(pathname: string): string | null {
   return row?.id ?? null;
 }
 
+/**
+ * Tells clients that the links between `dumpId` and each of `otherIds`
+ * changed, as `broadcastDumpRelatedChanged` says, after reading who may see
+ * each of them. It sends nothing without `otherIds`.
+ */
+function announceRelatedChange(dumpId: string, otherIds: string[]): void {
+  if (otherIds.length === 0) return;
+  const ids = [dumpId, ...otherIds];
+  const rows = db.prepare(
+    `SELECT id, user_id, is_private FROM dumps
+      WHERE id IN (${ids.map(() => "?").join(", ")});`,
+  ).all(...ids) as { id: string; user_id: string; is_private: number }[];
+  const dumps = rows.map((row) => ({
+    id: row.id,
+    userId: row.user_id,
+    isPrivate: Boolean(row.is_private),
+  }));
+  const dump = dumps.find((d) => d.id === dumpId);
+  if (!dump) return;
+  broadcastDumpRelatedChanged(dump, dumps.filter((d) => d.id !== dumpId));
+}
+
+/**
+ * Tells clients that dump `dumpId`, which just turned public, is now related
+ * to the dumps linked to or from it, for the dump service. Its poster saw
+ * those links already; to everyone else they are new.
+ */
+export function announceLinksNowPublic(dumpId: string): void {
+  const rows = db.prepare(
+    `SELECT to_dump_id AS id FROM dump_backlinks WHERE from_dump_id = ?
+     UNION
+     SELECT from_dump_id FROM dump_backlinks WHERE to_dump_id = ?;`,
+  ).all(dumpId, dumpId) as { id: string }[];
+  announceRelatedChange(dumpId, rows.map((row) => row.id));
+}
+
 /**
  * Replaces the backlinks from one text, a dump's note (`dump_comment`) or one
  * of its comments (`comment`), with the links its current `text` holds. A link
@@ -53,7 +91,8 @@ function resolveDumpPathId(pathname: string): string | null {
  * when it is the URL a dump was posted with, compared by `canonicalizeUrl` as
  * reposts are. The dump and
  * comment services call it on every save, and with an empty `text` when a
- * comment is deleted.
+ * comment is deleted. Clients are told of the dumps it links or no longer
+ * links, as `dump_related_changed`.
  */
 export function relinkBacklinks(
   sourceType: "dump_comment" | "comment",
@@ -90,7 +129,11 @@ export function relinkBacklinks(
 
   targetIds.delete(fromDumpId);
 
-  transaction(() => {
+  const formerIds = transaction(() => {
+    const former = db.prepare(
+      `SELECT to_dump_id FROM dump_backlinks
+        WHERE source_type = ? AND source_id = ?;`,
+    ).all(sourceType, sourceId) as { to_dump_id: string }[];
     db.prepare(
       `DELETE FROM dump_backlinks WHERE source_type = ? AND source_id = ?;`,
     ).run(sourceType, sourceId);
@@ -102,7 +145,13 @@ export function relinkBacklinks(
     for (const toDumpId of targetIds) {
       insert.run(sourceType, sourceId, fromDumpId, toDumpId, createdAt);
     }
+    return new Set(former.map((row) => row.to_dump_id));
   });
+
+  // Most saves change no link, and send nothing.
+  announceRelatedChange(fromDumpId, [
+    ...targetIds.symmetricDifference(formerIds),
+  ]);
 }
 
 /**

api/services/dump-service.ts

@@ -57,7 +57,7 @@ import {
   VALIDATION,
 } from "../../shared/validation.ts";
 import { linkAttachments } from "./attachment-service.ts";
-import { relinkBacklinks } from "./backlink-service.ts";
+import { announceLinksNowPublic, relinkBacklinks } from "./backlink-service.ts";
 import {
   assertCategoriesExist,
   attachCategoryIds,
@@ -96,7 +96,8 @@ function assertFileDumpText(title?: string, comment?: string): void {
  * `broadcastDumpChange` for the dump itself, and, when it was deleted or
  * changed visibility, the dumps of each playlist holding it, which moved for
  * their viewers. A deletion passes the `holders` it read before the cascade
- * took the dump out of them.
+ * took the dump out of them. A dump that turned public also joins the related
+ * dumps of those it is linked with.
  */
 function announceDumpChange(
   before: Dump | null,
@@ -106,6 +107,7 @@ function announceDumpChange(
   broadcastDumpChange(before, after);
   if (!before || (after && after.isPrivate === before.isPrivate)) return;
   broadcastHoldersDumps(holders ?? playlistsHolding(before.id));
+  if (after && !after.isPrivate) announceLinksNowPublic(after.id);
 }
 
 /**

api/services/ws-service.ts

@@ -235,6 +235,29 @@ export function broadcastDumpChange(
   });
 }
 
+/**
+ * Sends `dump_related_changed` after the links between `dump` and each of
+ * `others` changed, for the backlink service. A link shows only to those who
+ * may see both its ends, so a socket is told only when its user may see
+ * `dump` and one of `others`, and of those alone.
+ */
+export function broadcastDumpRelatedChanged(
+  dump: Pick<Dump, "id" | "isPrivate" | "userId">,
+  others: Pick<Dump, "id" | "isPrivate" | "userId">[],
+): void {
+  for (const client of clients) {
+    const sees = (d: Pick<Dump, "isPrivate" | "userId">) =>
+      !d.isPrivate || d.userId === client.userId;
+    if (!sees(dump)) continue;
+    const seen = others.filter(sees);
+    if (seen.length === 0) continue;
+    send(client.socket, {
+      type: "dump_related_changed",
+      dumpIds: [dump.id, ...seen.map((d) => d.id)],
+    });
+  }
+}
+
 /**
  * Sends `votes_update` after the route stored a vote, to everyone, or with
  * `onlyUserId` to that user's sockets alone (for a private dump).