eCourt-note/hooks/useAnnotationRealtime.ts

85 lines
3.5 KiB
TypeScript
Raw Normal View History

import { useEffect, useState } from "react";
import type { AnnotationDTO, BookmarkDTO, ReplyDTO } from "@/db/schema";
import type { AnnotateEvent } from "@/lib/annotate-events";
BASE_PATH: serve ใต้ /docedit/note — next.config.mjs ตั้ง basePath + env NEXT_PUBLIC_BASE_PATH (ประกาศค่าเดียวที่ไฟล์นี้) ให้ utils/base-path.ts (ใหม่) withBasePath() เติม prefix ให้ URL ฝั่ง browser ที่ Next ไม่เติมให้เอง (fetch/EventSource/plain href/workerSrc/img src): PDFViewer (workerSrc, /api/pdf ซ่อม ToUnicode, fallback file.pdfUrl, image branch N3 รวบเป็นตัวแปร fileUrl, export PDF F8), SSE stream ใน useAnnotationRealtime, ปุ่มส่งออก bookmark JSON (N7) + คัดลอกลิงก์ F12 ใน AnnotationSidebar (window.location.origin + basePath กัน paste แล้ว 404), Export CSV (F16) หน้า summary — <Link>/next/navigation/middleware.ts ไม่ต้องแก้ (Next 14.2 auto-prefix ให้ + matcher จับ path ที่ตัด basePath แล้ว + NextURL redirect ใส่กลับเอง ยืนยันจาก source ใน node_modules) + pdf_url ใน DB เก็บ path ไม่รวม basePath เติมตอนใช้เท่านั้น + sync เอกสารตาม governance: CLAUDE.md invariant #6 (workerSrc ผ่าน withBasePath) + #12 ใหม่ (URL ฝั่ง browser ที่สร้างเองต้องผ่าน withBasePath), PLAN.md A3/§4, rules pdf-viewer/realtime, plan-reviewer #8, README URL localhost:3000/docedit/note — verify: tsc strict ผ่าน + curl (root / 404, ไม่มี cookie 307→/docedit/note/login, worker 200, SSE reachable, มี cookie 200) + Playwright login จริงเปิดไฟล์ 44 หน้า render ครบ (SSE /api/pdf /worker 200 ผ่าน basePath) + code-reviewer ผ่าน (vitest 126 tests, ไม่พบ bug, blob URL ไม่โดน prefix ซ้ำ, env inline ครบทั้ง client/server ตาม define-env-plugin) — deploy: basePath เป็น build-time ต้อง build image ใหม่ถึงจะเสิร์ฟที่ /docedit/note + reverse proxy ต้อง forward path เต็มแบบไม่ strip prefix Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 16:06:20 +07:00
import { withBasePath } from "@/utils/base-path";
// SSE sync (PLAN.md §4, rules/realtime.md)
// - เปิด EventSource ไป /api/annotations/stream?fileId=<id> — reconnect อัตโนมัติเมื่อขาด (ห้ามทำ retry เอง)
// - event เป็น DTO (camelCase + ISO string) จาก server ตรง ๆ — ไม่มีการแปลง
// - dedupe ด้วย id เท่านั้น (คู่กับ useOptimistic ใน PDFViewer — PLAN.md §4)
export function useAnnotationRealtime(
fileId: string,
initialAnnotations: AnnotationDTO[],
initialBookmarks: BookmarkDTO[],
initialReplies: ReplyDTO[],
) {
const [annotations, setAnnotations] = useState(initialAnnotations);
const [bookmarks, setBookmarks] = useState(initialBookmarks);
const [replies, setReplies] = useState(initialReplies);
useEffect(() => {
BASE_PATH: serve ใต้ /docedit/note — next.config.mjs ตั้ง basePath + env NEXT_PUBLIC_BASE_PATH (ประกาศค่าเดียวที่ไฟล์นี้) ให้ utils/base-path.ts (ใหม่) withBasePath() เติม prefix ให้ URL ฝั่ง browser ที่ Next ไม่เติมให้เอง (fetch/EventSource/plain href/workerSrc/img src): PDFViewer (workerSrc, /api/pdf ซ่อม ToUnicode, fallback file.pdfUrl, image branch N3 รวบเป็นตัวแปร fileUrl, export PDF F8), SSE stream ใน useAnnotationRealtime, ปุ่มส่งออก bookmark JSON (N7) + คัดลอกลิงก์ F12 ใน AnnotationSidebar (window.location.origin + basePath กัน paste แล้ว 404), Export CSV (F16) หน้า summary — <Link>/next/navigation/middleware.ts ไม่ต้องแก้ (Next 14.2 auto-prefix ให้ + matcher จับ path ที่ตัด basePath แล้ว + NextURL redirect ใส่กลับเอง ยืนยันจาก source ใน node_modules) + pdf_url ใน DB เก็บ path ไม่รวม basePath เติมตอนใช้เท่านั้น + sync เอกสารตาม governance: CLAUDE.md invariant #6 (workerSrc ผ่าน withBasePath) + #12 ใหม่ (URL ฝั่ง browser ที่สร้างเองต้องผ่าน withBasePath), PLAN.md A3/§4, rules pdf-viewer/realtime, plan-reviewer #8, README URL localhost:3000/docedit/note — verify: tsc strict ผ่าน + curl (root / 404, ไม่มี cookie 307→/docedit/note/login, worker 200, SSE reachable, มี cookie 200) + Playwright login จริงเปิดไฟล์ 44 หน้า render ครบ (SSE /api/pdf /worker 200 ผ่าน basePath) + code-reviewer ผ่าน (vitest 126 tests, ไม่พบ bug, blob URL ไม่โดน prefix ซ้ำ, env inline ครบทั้ง client/server ตาม define-env-plugin) — deploy: basePath เป็น build-time ต้อง build image ใหม่ถึงจะเสิร์ฟที่ /docedit/note + reverse proxy ต้อง forward path เต็มแบบไม่ strip prefix Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 16:06:20 +07:00
const es = new EventSource(withBasePath(`/api/annotations/stream?fileId=${fileId}`));
es.onmessage = (e: MessageEvent<string>) => {
let ev: AnnotateEvent;
try {
ev = JSON.parse(e.data) as AnnotateEvent;
} catch {
return;
}
// กรอง message ที่ไม่ใช่ annotate event (เช่น { type: "connected" })
if (typeof ev.table !== "string" || typeof ev.action !== "string") return;
if (ev.table === "annotations") {
if (ev.action === "create") {
setAnnotations((prev) =>
prev.some((a) => a.id === ev.row.id) ? prev : [...prev, ev.row],
);
} else if (ev.action === "update") {
// replace ตาม id — idempotent: event มาก่อน/หลัง optimistic ก็ได้ผลเดียวกัน (PLAN-FEAT.md §5)
setAnnotations((prev) =>
prev.some((a) => a.id === ev.row.id)
? prev.map((a) => (a.id === ev.row.id ? ev.row : a))
: prev,
);
} else {
setAnnotations((prev) => prev.filter((a) => a.id !== ev.id));
// ลบแม่ → replies หายตาม CASCADE ของ DB — เก็บ state ให้เท่ากันด้วย (F9)
setReplies((prev) => prev.filter((r) => r.annotationId !== ev.id));
}
} else if (ev.table === "replies") {
if (ev.action === "create") {
setReplies((prev) =>
prev.some((r) => r.id === ev.row.id) ? prev : [...prev, ev.row],
);
} else {
setReplies((prev) => prev.filter((r) => r.id !== ev.id));
}
} else {
if (ev.action === "create") {
setBookmarks((prev) =>
prev.some((b) => b.id === ev.row.id) ? prev : [...prev, ev.row],
);
} else if (ev.action === "update") {
// N2: แก้ชื่อ/โน้ต/ย้ายหัวข้อ (รวมลูกที่ถูกยกขึ้น root ตอนแม่ถูกลบ) — replace by id
setBookmarks((prev) =>
prev.some((b) => b.id === ev.row.id)
? prev.map((b) => (b.id === ev.row.id ? ev.row : b))
: prev,
);
} else {
setBookmarks((prev) => prev.filter((b) => b.id !== ev.id));
}
}
};
return () => {
es.close();
};
}, [fileId]);
return { annotations, bookmarks, replies, setAnnotations, setBookmarks, setReplies };
}