feat(events): stream Redis invalidations over SSE

app/admin/[character]/[page]/page.tsx

@@ -2,6 +2,7 @@ import { notFound, redirect } from "next/navigation";
 import { connection } from "next/server";
 
 import { EditorWorkspace } from "@/components/admin/editor-workspace";
+import { LiveRefresh } from "@/components/live-refresh";
 import { getAdminSession } from "@/lib/auth/server";
 import { loadAdminNavigation, loadAdminPage } from "@/lib/content/loaders";
 
@@ -18,5 +19,16 @@ export default async function AdminEditorPage({
     loadAdminNavigation(),
   ]);
   if (!snapshot) notFound();
-  return <EditorWorkspace snapshot={snapshot} navigation={navigation} />;
+  return (
+    <>
+      {process.env.BUZZ_DEMO_MODE === "true" ? null : (
+        <LiveRefresh endpoint="/api/events/admin" />
+      )}
+      <EditorWorkspace
+        key={`${snapshot.page.id}:${snapshot.page.version}`}
+        snapshot={snapshot}
+        navigation={navigation}
+      />
+    </>
+  );
 }

app/admin/page.tsx

@@ -4,6 +4,7 @@ import { redirect } from "next/navigation";
 import { connection } from "next/server";
 
 import { AdminSidebar } from "@/components/admin/admin-sidebar";
+import { LiveRefresh } from "@/components/live-refresh";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import {
@@ -25,6 +26,9 @@ export default async function AdminPage() {
 
   return (
     <SidebarProvider>
+      {process.env.BUZZ_DEMO_MODE === "true" ? null : (
+        <LiveRefresh endpoint="/api/events/admin" />
+      )}
       <AdminSidebar navigation={navigation} />
       <SidebarInset>
         <header className="flex min-h-14 items-center gap-3 border-b px-4">

app/admin/templates/page.tsx

@@ -2,6 +2,7 @@ import { redirect } from "next/navigation";
 import { connection } from "next/server";
 
 import { AdminSidebar } from "@/components/admin/admin-sidebar";
+import { LiveRefresh } from "@/components/live-refresh";
 import { TemplateGallery } from "@/components/admin/template-gallery";
 import { SidebarInset, SidebarProvider, SidebarTrigger } from "@/components/ui/sidebar";
 import { getAdminSession } from "@/lib/auth/server";
@@ -15,6 +16,9 @@ export default async function TemplatesPage() {
 
   return (
     <SidebarProvider>
+      {process.env.BUZZ_DEMO_MODE === "true" ? null : (
+        <LiveRefresh endpoint="/api/events/admin" />
+      )}
       <AdminSidebar navigation={navigation} />
       <SidebarInset>
         <header className="flex min-h-14 items-center gap-3 border-b px-4">

app/api/events/admin/route.ts

@@ -0,0 +1,24 @@
+import {
+  AdminAuthorizationError,
+  requireAdmin,
+} from "@/lib/auth/server";
+import {
+  createRedisEventResponse,
+  eventsUnavailableResponse,
+} from "@/lib/events/redis-stream";
+
+export async function GET(request: Request) {
+  try {
+    await requireAdmin();
+  } catch (cause) {
+    if (cause instanceof AdminAuthorizationError) {
+      return Response.json({ error: "unauthorized" }, { status: 401 });
+    }
+    throw cause;
+  }
+  try {
+    return await createRedisEventResponse("admin", request.signal);
+  } catch {
+    return eventsUnavailableResponse();
+  }
+}

app/api/events/directory/route.ts

@@ -0,0 +1,12 @@
+import {
+  createRedisEventResponse,
+  eventsUnavailableResponse,
+} from "@/lib/events/redis-stream";
+
+export async function GET(request: Request) {
+  try {
+    return await createRedisEventResponse("directory", request.signal);
+  } catch {
+    return eventsUnavailableResponse();
+  }
+}

app/api/events/page/[id]/route.ts

@@ -0,0 +1,22 @@
+import {
+  createRedisEventResponse,
+  eventsUnavailableResponse,
+} from "@/lib/events/redis-stream";
+
+const UUID_PATTERN =
+  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+
+export async function GET(
+  request: Request,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  const { id } = await params;
+  if (!UUID_PATTERN.test(id)) {
+    return Response.json({ error: "invalid-page-id" }, { status: 400 });
+  }
+  try {
+    return await createRedisEventResponse(`page:${id}`, request.signal);
+  } catch {
+    return eventsUnavailableResponse();
+  }
+}

app/page.tsx

@@ -2,6 +2,7 @@ import { connection } from "next/server";
 
 import { CharacterDirectory } from "@/components/public/character-directory";
 import { SiteHeader } from "@/components/public/site-header";
+import { LiveRefresh } from "@/components/live-refresh";
 import { loadPublicDirectory } from "@/lib/content/loaders";
 
 export default async function HomePage() {
@@ -10,6 +11,9 @@ export default async function HomePage() {
 
   return (
     <div className="min-h-svh bg-background">
+      {process.env.BUZZ_DEMO_MODE === "true" ? null : (
+        <LiveRefresh endpoint="/api/events/directory" />
+      )}
       <SiteHeader />
       <main className="mx-auto w-full max-w-7xl px-4 py-10 sm:px-6 sm:py-14">
         <header className="mb-8 max-w-3xl space-y-3">