trails/apps/journal/app/lib/notifications/link-for.ts
Ullrich Schäfer e61179ab27 Implement notifications + supporting fixes
Adds the notifications system end-to-end (4 types, payload-versioned
JSONB, SSE-based live unread badge, /notifications page, mark-read API,
fan-out job for activity_published, daily 90-day retention purge).
Bell icon in the navbar with unread badge.

Side-findings from exercising the change:
- Add 6-digit magic code to registration (mirrors login UX, mobile
  paste-friendly), with `[Register Magic Link]` console line in dev so
  the code is reachable without a real email transport.
- Manual passkey/magic-link toggle on the register form (login already
  had it).
- Restrict ALPN to http/1.1 in HTTPS dev so React Router's
  singleFetchAction CSRF check (Origin vs. Host) passes — Node doesn't
  synthesize Host from h2's :authority. Plain HTTP dev unaffected.
- Followers/Following routes now use the locked-account rule from the
  profile route (owner + accepted followers see the list; others 404).
  Profile page renders the count chips as plain spans for viewers who
  can't see the lists, so private profiles don't surface dead links.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-26 01:28:55 +02:00

65 lines
2.3 KiB
TypeScript

// Single source of truth for "what URL does this notification link to?"
// Every renderer (web loader, future mobile push formatter, future email
// formatter) calls linkFor; the type→URL mapping lives here, in one
// place, in three flavors so the same logical destination renders
// correctly per platform.
import type { NotificationType } from "@trails-cool/db/schema/journal";
import { readPayload } from "./payload.ts";
export interface LinkBundle {
web: string; // app-relative path for in-app navigation
mobile?: string; // trails:// scheme for native deep linking
email?: string; // absolute https:// URL for email click-through
}
export interface NotificationForLink {
type: NotificationType;
subjectId: string | null;
payload: Record<string, unknown> | null;
payloadVersion: number;
}
export function linkFor(n: NotificationForLink): LinkBundle {
const origin = process.env.ORIGIN ?? "https://trails.cool";
const p = readPayload(n.type, n.payloadVersion, n.payload);
switch (n.type) {
case "follow_received":
case "follow_request_received": {
// The actionable surface for a request lives at /follows/requests
// (where Approve/Reject is); a received auto-accept notification
// links to the new follower's profile. Both fall back to the
// payload's followerUsername if the actor account is gone.
const username =
p && "followerUsername" in p ? p.followerUsername : null;
const path =
n.type === "follow_request_received"
? "/follows/requests"
: username
? `/users/${username}`
: "/";
return buildBundle(origin, path);
}
case "follow_request_approved": {
const username =
p && "targetUsername" in p ? p.targetUsername : null;
const path = username ? `/users/${username}` : "/";
return buildBundle(origin, path);
}
case "activity_published": {
const activityId =
n.subjectId ?? (p && "activityId" in p ? p.activityId : null);
const path = activityId ? `/activities/${activityId}` : "/";
return buildBundle(origin, path);
}
}
}
function buildBundle(origin: string, path: string): LinkBundle {
return {
web: path,
mobile: `trails:/${path.startsWith("/") ? "" : "/"}${path.replace(/^\//, "")}`,
email: `${origin.replace(/\/$/, "")}${path}`,
};
}