feat(sso): switch note session from cookies to token

เปลี่ยน session ของแอป note จาก cookie คู่ oacCase/oacCaseSig มาเป็น
access_token แบบ add-in ตามคำขอผู้ใช้ (2026-10-30):

- POST /api/note/auth/session แลก credential ของลิงก์ e-Court
  (JWT ทาง A / ticket ทาง B) เป็น access_token purpose=login อายุ 8 ชม.
  พร้อมลงทะเบียนเอกสาร N8 แบบ trusted ฝั่ง server (fileId จาก fid)
- token เก็บ localStorage "note-auth" (lib/note-session.ts) + Bearer
  ผ่าน noteAuthFetch · Server Actions ทุกตัวรับ token เป็น param แรก
  และแกะ identity เอง (lib/note-token.ts) — ไม่เชื่อ userId จาก client
- หน้า protected เป็น shell + client gate (NoteHome bootstrap ที่ /note,
  AnnotateView + GET /api/note/files/[id]/bootstrap)
- ถอด: middleware.ts, lib/session.ts, utils/user.ts, action logout,
  GET /api/note/auth/e-court, entry /note/annotate?fileUrl=
- ทาง ticket ปฏิเสธ secret default "super_secret" เฉพาะ production
- GET /api/note/files/open: ลิงก์เปิดไฟล์ตัวอย่างแบบ /tmpl (path ใน
  เครื่อง /samples เท่านั้น)
- หน้า /note/dev: ลิงก์ A Link Get(new) ที่ mint credential แล้วยิง
  เข้า flow SSO จริง (JWT/ticket สลับได้) + section Flow + เรียบเรียง
  ภาษาให้อ่านง่าย · หน้า /note เป็นหน้าข้อมูลระบบ
- แก้ตาม code review: redo closure เรียก action ด้วย signature เก่า,
  bootstrap timeout + strip credential ที่ผิดรูป, แยก no-session ออก
  จาก network error, ห้ามอักขระ & = + % ใน identity, ตรวจ purpose
  ก่อน exp ของ login-token, audit log strip อักขระควบคุม
- เอกสาร: docs/PLAN-SSO.md §0.5 (ฉบับ token), CLAUDE.md, .env.example

ทดสอบ: tsc ผ่าน · vitest ผ่านทั้งชุด · ทดสอบจริงผ่าน Playwright
(SSO → viewer → เปลี่ยนสี annotation → undo → redo ครบวงจร)

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

tests/lib/docver-token.test.ts

@@ -6,6 +6,7 @@ import {
   parseTokenRequestBody,
   requireDocverApiKey,
   requireDocverBearer,
+  verifyDocverLoginToken,
   verifyDocverToken,
   type DocverTokenClaims,
 } from "@/lib/docver-token";
@@ -314,3 +315,87 @@ describe("parseTokenRequestBody", () => {
     ).toBe(false);
   });
 });
+
+// ─── purpose claim ของ PLAN-SSO.md (D4/D5) ───────────────────────────────────
+
+describe("issueDocverToken purpose / requireDocverBearer-reject-login", () => {
+  it("default = purpose docver (payload มีค่าชัด แต่ claims ที่ verify ได้เหมือนเดิม)", () => {
+    const token = issueDocverToken(CLAIMS, SECRET, 60);
+    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString("utf8"));
+    expect(payload.purpose).toBe("docver");
+    const verified = verifyDocverToken(token, SECRET);
+    ok(verified);
+    expect(verified.claims).toEqual(CLAIMS); // ไม่มี purpose ปนออกมา (ความหมาย = docver)
+  });
+
+  it("issue ด้วย purpose login → claims.purpose = login", () => {
+    const verified = verifyDocverToken(issueDocverToken(CLAIMS, SECRET, 60, "login"), SECRET);
+    ok(verified);
+    expect(verified.claims.purpose).toBe("login");
+  });
+
+  it("purpose ค่าอื่น (แม้เซ็นถูก) = invalid", () => {
+    const now = Math.floor(Date.now() / 1000) + 60;
+    const bad = signPayload({ ...CLAIMS, purpose: "admin", iat: 0, exp: now });
+    expect(verifyDocverToken(bad, SECRET).ok).toBe(false);
+  });
+
+  it("requireDocverBearer ปฏิเสธ login-token (scope escalation — 401 เดียวกับ token เน่า)", async () => {
+    process.env.DOCVER_TOKEN_SECRET = SECRET;
+    const auth = requireDocverBearer(
+      reqWithBearer(`Bearer ${issueDocverToken(CLAIMS, SECRET, 60, "login")}`),
+    );
+    expect(auth.ok).toBe(false);
+    if (!auth.ok) {
+      expect(auth.response.status).toBe(401);
+      expect(await bodyOf(auth.response)).toEqual({ error: "โทเคนไม่ถูกต้องหรือหมดอายุ" });
+    }
+  });
+});
+
+describe("verifyDocverLoginToken (SSO §3.2)", () => {
+  it("login-token ที่ยังไม่หมดอายุ = ได้ claims", () => {
+    const verified = verifyDocverLoginToken(issueDocverToken(CLAIMS, SECRET, 60, "login"), SECRET);
+    ok(verified);
+    expect(verified.claims.fid).toBe(CLAIMS.fid);
+    expect(verified.claims.purpose).toBe("login");
+  });
+
+  it("signature ถูกแต่ exp เลยมาแล้ว = reason expired (แยกจาก invalid ให้ route ตอบ sso=expired)", () => {
+    const verified = verifyDocverLoginToken(issueDocverToken(CLAIMS, SECRET, -10, "login"), SECRET);
+    expect(verified).toEqual({ ok: false, reason: "expired" });
+  });
+
+  it("token docver (ไม่มี purpose) / purpose=docver = reason invalid (D4)", () => {
+    const noPurpose = signPayload({ ...CLAIMS, iat: 0, exp: Math.floor(Date.now() / 1000) + 60 });
+    expect(verifyDocverLoginToken(noPurpose, SECRET)).toEqual({ ok: false, reason: "invalid" });
+    expect(verifyDocverLoginToken(issueDocverToken(CLAIMS, SECRET, 60), SECRET)).toEqual({
+      ok: false,
+      reason: "invalid",
+    });
+  });
+
+  it("token docver ที่หมดอายุ = invalid ไม่ใช่ expired (ตัดสินชนิดก่อนอายุ — 2026-10-30)", () => {
+    expect(verifyDocverLoginToken(issueDocverToken(CLAIMS, SECRET, -10), SECRET)).toEqual({
+      ok: false,
+      reason: "invalid",
+    });
+    const expiredNoPurpose = signPayload({ ...CLAIMS, iat: 0, exp: 1 });
+    expect(verifyDocverLoginToken(expiredNoPurpose, SECRET)).toEqual({ ok: false, reason: "invalid" });
+  });
+
+  it("ผิดรูป/secret ผิด/tampered = reason invalid", () => {
+    expect(verifyDocverLoginToken("garbage", SECRET)).toEqual({ ok: false, reason: "invalid" });
+    expect(verifyDocverLoginToken(issueDocverToken(CLAIMS, "other", 60, "login"), SECRET)).toEqual({
+      ok: false,
+      reason: "invalid",
+    });
+    const token = issueDocverToken(CLAIMS, SECRET, 60, "login");
+    const [h, , s] = token.split(".");
+    const tampered = Buffer.from(
+      JSON.stringify({ ...CLAIMS, userid: "999", purpose: "login", iat: 0, exp: Math.floor(Date.now() / 1000) + 60 }),
+      "utf8",
+    ).toString("base64url");
+    expect(verifyDocverLoginToken(`${h}.${tampered}.${s}`, SECRET)).toEqual({ ok: false, reason: "invalid" });
+  });
+});