eCourt-note/tests/utils/file-kind.test.ts
Your Name a02e983ba8 feat(n11): add base64 document staging from e-Court
เพิ่มทางเข้าเอกสารสำหรับ 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>
2026-11-05 12:53:56 +07:00

80 lines
4 KiB
TypeScript

import { describe, expect, it } from "vitest";
import {
SAMPLE_FILE_EXTENSIONS,
fileKindFromUrl,
imageContentTypeFromUrl,
imageFormatFromUrl,
} from "@/utils/file-kind";
describe("fileKindFromUrl", () => {
it("pdf → pdf, รูปทุกนามสกุล → image (case-insensitive)", () => {
expect(fileKindFromUrl("/samples/a.pdf")).toBe("pdf");
expect(fileKindFromUrl("/samples/photo.JPG")).toBe("image");
expect(fileKindFromUrl("/uploads/scan.Jpeg")).toBe("image");
expect(fileKindFromUrl("/uploads/scan.png")).toBe("image");
expect(fileKindFromUrl("/uploads/scan.TIF")).toBe("image");
expect(fileKindFromUrl("/uploads/scan.tiff")).toBe("image");
});
it("ไม่รู้จัก extension = pdf ตามพฤติกรรมก่อน N3", () => {
expect(fileKindFromUrl("/samples/file.docx")).toBe("pdf");
expect(fileKindFromUrl("/samples/noext")).toBe("pdf");
expect(fileKindFromUrl("/samples/.jpg")).toBe("pdf"); // dotfile ไม่ใช่ extension
});
});
describe("imageFormatFromUrl", () => {
it("จับคู่นามสกุล → format (รวม query string / จุดซ้ำในชื่อ)", () => {
expect(imageFormatFromUrl("/a/b/x.jpg?v=2")).toBe("jpeg");
expect(imageFormatFromUrl("/a/b/x.jpeg")).toBe("jpeg");
expect(imageFormatFromUrl("/a/b/scan.v2.png")).toBe("png");
expect(imageFormatFromUrl("/a/b/x.tif")).toBe("tiff");
expect(imageFormatFromUrl("/a/b/x.tiff")).toBe("tiff");
});
it("ไม่ใช่รูป → null (รวมชื่อที่คล้ายนามสกุลแต่เป็นโฟลเดอร์)", () => {
expect(imageFormatFromUrl("/a/b/x.pdf")).toBeNull();
expect(imageFormatFromUrl("/jpg.png/jpg")).toBeNull();
expect(imageFormatFromUrl("")).toBeNull();
});
});
describe("imageContentTypeFromUrl", () => {
it("map format → MIME ที่ถูกต้อง", () => {
expect(imageContentTypeFromUrl("/a/x.jpg")).toBe("image/jpeg");
expect(imageContentTypeFromUrl("/a/x.PNG")).toBe("image/png");
expect(imageContentTypeFromUrl("/a/x.tiff")).toBe("image/tiff");
expect(imageContentTypeFromUrl("/a/x.pdf")).toBe("application/octet-stream");
});
});
describe("sentinel staged: ของ N11 (PLAN-STAGED.md D4)", () => {
const uid = "0d7e6a52-9a71-4d40-bd1c-b2e1a44ab133";
// ล็อกสมมติฐาน "ext ใน sentinel เข้ากับ extOf() ทุกตัว" กัน helper เปลี่ยนวิธี
// parse ภายหลัง — sentinel คือ pdf_url จริงใน DB ตั้งแต่ N11
it("ครบ 4 ext: fileKindFromUrl แยก pdf/image ตาม extension ของ sentinel", () => {
expect(fileKindFromUrl(`staged:${uid}.pdf`)).toBe("pdf");
expect(fileKindFromUrl(`staged:${uid}.jpg`)).toBe("image");
expect(fileKindFromUrl(`staged:${uid}.png`)).toBe("image");
expect(fileKindFromUrl(`staged:${uid}.tif`)).toBe("image");
});
it("imageFormatFromUrl / imageContentTypeFromUrl ทำงานกับ sentinel (pdf ไม่ผ่านตัวรูป — สถานะเดิมคืน octet-stream)", () => {
expect(imageFormatFromUrl(`staged:${uid}.pdf`)).toBeNull();
expect(imageFormatFromUrl(`staged:${uid}.jpg`)).toBe("jpeg");
expect(imageFormatFromUrl(`staged:${uid}.png`)).toBe("png");
expect(imageFormatFromUrl(`staged:${uid}.tif`)).toBe("tiff");
expect(imageContentTypeFromUrl(`staged:${uid}.jpg`)).toBe("image/jpeg");
expect(imageContentTypeFromUrl(`staged:${uid}.png`)).toBe("image/png");
expect(imageContentTypeFromUrl(`staged:${uid}.tif`)).toBe("image/tiff");
expect(imageContentTypeFromUrl(`staged:${uid}.pdf`)).toBe("application/octet-stream");
});
});
describe("SAMPLE_FILE_EXTENSIONS", () => {
it("ครบทุกนามสกุลที่ requirement 5.3.4 ระบุ", () => {
for (const ext of [".pdf", ".jpg", ".jpeg", ".png", ".tif", ".tiff"]) {
expect(SAMPLE_FILE_EXTENSIONS).toContain(ext);
}
});
});