// dedupe key ของเอกสาร e-Court แบบ hash (ตามคำขอผู้ใช้ 2026-11-04) — // files.external_id เก็บ "ecourt:" + HMAC-SHA256(pepper, fid) แทน fid ดิบ // ไม่ให้ fid ของ e-Court หลุดลง DB (fid บางรูปสั้น/เรียงง่าย sha256 เปล่าจะ // brute force กลับได้ จึงต้องมี pepper) // // หลักการ: hash เกิดฝั่งเราตอนรับ request ทุกครั้ง (stage/D5/N10 ถามด้วย fid ดิบ // แล้วเรา hash ตอน query) — deterministic + pepper เดียวกัน = digest เดิมเสมอ // contract ฝั่ง e-Court ไม่เปลี่ยน · one-way: กู้ fid คืนจาก DB ไม่ได้ (โดยตั้งใจ — // field externalFileId ของ N10 จึงคืนค่า hash) // // ⚠️ env FID_HASH_PEPPER เป็นค่าคงที่ตลอดชีพของข้อมูล — **ห้ามเปลี่ยนหลังมีแถว** // (เปลี่ยน = แถวเก่าค้นไม่เจอ + re-INSERT เกิดแถวคู่เงียบ ๆ) · ห้าม commit ลง repo // // pure module ไม่ import อะไรที่ลาก @/db มาด้วย — unit test (tests/lib/) รันได้ // โดยไม่ต้องตั้ง DATABASE_URL (pattern เดียวกับ lib/docver-token.ts) import { createHmac } from "node:crypto"; export const ECOURT_ID_PREFIX = "ecourt:"; /** external_id ของเอกสาร e-Court — "ecourt:" + HMAC-SHA256 hex 64 ตัวของ fid * (trim ก่อน hash — caller หลายทางส่ง fid ที่ trim แล้ว จุดเดียวที่ normalize) * · env FID_HASH_PEPPER ไม่ตั้ง/ว่าง = throw (fail-closed: ยอม hash แบบไม่มี * pepper แล้วเติมทีหลัง = fid เดิมได้ 2 key แถวแตก) */ export function ecourtExternalId(fid: string): string { const pepper = process.env.FID_HASH_PEPPER?.trim(); if (pepper === undefined || pepper === "") { throw new Error( "ตั้งค่า FID_HASH_PEPPER ก่อน (ค่าคงที่ตลอดชีพ — ห้ามเปลี่ยนหลังมีข้อมูล)", ); } const digest = createHmac("sha256", pepper).update(fid.trim()).digest("hex"); return `${ECOURT_ID_PREFIX}${digest}`; } /** แถวนี้เป็นเอกสารของ e-Court ไหม (แยกจากแถว `url:` fallback ของ N8) */ export function isEcourtExternalId(externalId: string): boolean { return externalId.startsWith(ECOURT_ID_PREFIX); }