a02e983ba8
เพิ่มทางเข้าเอกสารสำหรับ e-Court ที่ไม่มี URL ให้ดึง — POST /api/note/files/stage (x-api-key DOCVER_API_KEY) ส่งเนื้อไฟล์ PDF/รูปเป็น base64 ระบบเก็บใน RAM staging (TTL sliding 8 ชม. + LRU + cap 100MB/ไฟล์ 256MB รวม — ห้ามเขียน disk/DB/MinIO แม้แต่ไบต์เดียวตามโจทย์) ส่วน annotation/bookmark เก็บถาวรตามระบบเดิม: - lib/staged-docs.ts: Map บน globalThis + sentinel "staged:<uuid>.<ext>" ใน pdf_url (ext จาก magic bytes — ไม่ต้อง migration) + hasStagedDoc แยกจาก getStagedDoc - lib/ecourt-fid.ts: external_id เก็บ HMAC-SHA256(pepper, fid) แทน fid ดิบ (env FID_HASH_PEPPER fail-closed) + แปลง row เก่าด้วย npm run migrate:ecourt-fid - route stage: อ่าน body แบบ stream นับไบต์ + idle 60 วิ/total 10 นาที = 408 + concurrency default 1 = 429 + base64 strict + magic bytes กำหนด ext เอง - registerStagedFile: ลำดับกัน race 23505 — stage ใต้ id ก่อน insert โดนชนแล้ว re-stage ใต้ id ผู้ชนะ + try/finally คืน RAM ผู้แพ้ทุกทางออก - ทางอ่าน 4 จุด: /api/note/pdf + export route (410 gate ไทย), resolvePublicPdfPath guard PdfPathError, PDFViewer โหลดผ่าน route + objectURL (gate ครบทุกชนิดไฟล์) - session route (D5): ลิงก์ fid-only ตัดสิน staging ตั้งแต่แลก token — มี bytes ได้ fileId / หมดอายุ fileError "พ้นช่วงจัดเตรียม" / token ออกทุกกรณี - Swagger UI: endpoint ใหม่ + คู่มือ retry (408/429/5xx ยิงซ้ำได้ stage ซ้ำปลอดภัย) - MockStageForm บน /note/dev ทดสอบ 3 ขั้นในหน้าเดียว (ต้องถือ API key จริง) Verify ครบตาม docs/PLAN-STAGED.md: tsc สะอาด + vitest 59 เคสใหม่ผ่าน + E2E browser จริง (textLayer ไทยเรียงถูก / export ฝัง annotation / restart ได้ fileError ตั้งแต่ bootstrap / RAM 100MB: peak WS +580MB commit จริง +92MB) — ผ่าน code review รอบ 7 แก้ครบทุก finding Co-Authored-By: Claude Code <noreply@anthropic.com>
57 lines
2.6 KiB
TypeScript
57 lines
2.6 KiB
TypeScript
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
|
|
import {
|
|
ECOURT_ID_PREFIX,
|
|
ecourtExternalId,
|
|
isEcourtExternalId,
|
|
} from "@/lib/ecourt-fid";
|
|
|
|
// hash fid ของ e-Court ก่อนเก็บลง DB (ตามคำขอผู้ใช้ 2026-11-04) — pure module
|
|
// รันได้ไม่ต้องตั้ง DATABASE_URL · env FID_HASH_PEPPER เป็นค่าคงที่ตลอดชีพ
|
|
|
|
afterEach(() => {
|
|
vi.unstubAllEnvs();
|
|
});
|
|
|
|
describe("ecourtExternalId", () => {
|
|
it("deterministic + รูป ecourt: + HMAC-SHA256 hex 64 ตัว + ไม่มี fid ดิบในค่า", () => {
|
|
vi.stubEnv("FID_HASH_PEPPER", "test-pepper");
|
|
const a = ecourtExternalId("1");
|
|
expect(a).toBe(ecourtExternalId("1"));
|
|
expect(a).toMatch(/^ecourt:[0-9a-f]{64}$/);
|
|
expect(a.startsWith(ECOURT_ID_PREFIX)).toBe(true);
|
|
// fid ดิบ (ที่มีเอกลักษณ์พอ) ต้องไม่หลุดไปอยู่ในค่า hash
|
|
const b = ecourtExternalId("SECRET-FID-XYZ-987654");
|
|
expect(b).not.toContain("SECRET-FID-XYZ");
|
|
});
|
|
|
|
it("fid ต่างค่า → hash ต่าง · pepper ต่างค่า → hash ต่าง (คาดเดากลับไม่ได้)", () => {
|
|
vi.stubEnv("FID_HASH_PEPPER", "test-pepper");
|
|
expect(ecourtExternalId("1")).not.toBe(ecourtExternalId("2"));
|
|
const withA = ecourtExternalId("F123");
|
|
vi.stubEnv("FID_HASH_PEPPER", "other-pepper");
|
|
expect(ecourtExternalId("F123")).not.toBe(withA);
|
|
});
|
|
|
|
it("trim fid ก่อน hash — มี whitespace รอบได้ค่าเดียวกัน (จุด normalize เดียว)", () => {
|
|
vi.stubEnv("FID_HASH_PEPPER", "test-pepper");
|
|
expect(ecourtExternalId(" F123 ")).toBe(ecourtExternalId("F123"));
|
|
expect(ecourtExternalId("\tF123\n")).toBe(ecourtExternalId("F123"));
|
|
});
|
|
|
|
it("ไม่ตั้ง/ว่าง pepper = throw (fail-closed กันสถานะครึ่ง ๆ สอง key)", () => {
|
|
delete process.env.FID_HASH_PEPPER;
|
|
expect(() => ecourtExternalId("1")).toThrow(/FID_HASH_PEPPER/);
|
|
vi.stubEnv("FID_HASH_PEPPER", " ");
|
|
expect(() => ecourtExternalId("1")).toThrow(/FID_HASH_PEPPER/);
|
|
});
|
|
});
|
|
|
|
describe("isEcourtExternalId", () => {
|
|
it("แยกแถว ecourt: ออกจากแถว url: ของ N8", () => {
|
|
vi.stubEnv("FID_HASH_PEPPER", "test-pepper");
|
|
expect(isEcourtExternalId(ecourtExternalId("1"))).toBe(true);
|
|
expect(isEcourtExternalId("url:https://x.go.th/a.pdf")).toBe(false);
|
|
expect(isEcourtExternalId("url:/samples/a.pdf")).toBe(false);
|
|
});
|
|
});
|