diff --git a/.env.example b/.env.example index 0a4a54b..0aa4f54 100644 --- a/.env.example +++ b/.env.example @@ -6,6 +6,22 @@ DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/ecourt-note # ไม่ตั้ง/ว่าง = ปฏิเสธทุก request (fail closed) — ตั้งค่ายาวและสุ่ม เช่น 32+ ตัวอักษร # EXTERNAL_API_KEY= +# สำหรับตัวอย่างระบบนอกเรียกใช้ API ของ template +DOCEDIT_BASE_URL=http://192.168.2.51:3000/docedit +# สำหรับตัวอย่างระบบนอกเรียกใช้ API ของ template +EXTERNAL_API_KEY='secret-api-key-1234' +# ที่เก็บไฟล์เทมเพลต(docx) +TMPL_PATH='./public/tmpl' + +# Sign/Hash ที่ใช้ฝังในเอกสาร(docx) +SECRET="super_secret" +PRIVATE_KEY_HEX="8f2077b57b39399b6a7828f35da03a63ade8e3a36a6bf437b091a8bdb3d18ee1" +PUBLIC_KEY_HEX="66b09b4a1b66271d5728c592c2409657e1c070a7bf371bf9f6ed457855270546" +# Optional เวลาหมดอายุที่ฝังไว้ในข้อมูล (ticket_data) +TICKET_SEC=300 + + + # MinIO ของ API เอกสาร versioning (docs/PLAN-DOCVER.md §6) — ค่านี้ตรง docker-compose.yml # (MINIO_ENDPOINT/MINIO_ACCESS_KEY/MINIO_SECRET_KEY ไม่ตั้ง = ทุก endpoint ของกลุ่มนี้ตอบ 500) # หมายเหตุ: พอร์ตโฮสต์เป็น 19000 เพราะ 9000/9001 ชนกับโปรเจกต์อื่นในเครื่อง dev @@ -18,3 +34,23 @@ MINIO_ACCESS_KEY=minioadmin MINIO_SECRET_KEY=minioadmin # MINIO_BUCKET=docver # DOCVER_LINK_TTL_SECONDS=900 + +# docver token (2026-10-22): API key ของ POST /api/documents/token (header x-api-key) +# ไม่ตั้ง/ว่าง = ปฏิเสธทุก request (fail closed) — ตั้งค่ายาวและสุ่ม เช่น 32+ ตัวอักษร +# (ห้าม log ค่า key ดิบ — เทียบแบบ timing-safe ทุกครั้ง) +DOCVER_API_KEY= +# secret เซ็น/ตรวจ JWT HS256 ของทุก endpoint /api/documents/* (Authorization: Bearer) +# ไม่ตั้ง/ว่าง = ออก token ไม่ได้ (500) และทุก endpoint ตอบ 401 (fail closed) — ห้าม log ค่า secret +DOCVER_TOKEN_SECRET= +# DOCVER_TOKEN_TTL_SECONDS=3600 + +# add-in ticket auth (2026-10-27, docs/PLAN-ADDIN-AUTH.md): add-in ใน Word ขอ token +# ที่ POST /api/documents/token ด้วย body {ticket_data, HmacSha256} ที่ e-Court stamp +# มากับไฟล์ — secret ต้องตรงกับตัว stamp ของ e-Court ทั้งสองฝั่ง +# ฝั่ง server ตรวจ HMAC ของ ticket: ADDIN_TICKET_SECRET (ไม่ตั้ง = ใช้ env SECRET +# ของกลุ่ม template → ยังไม่ตั้งอีก = "super_secret" ตาม requirement) +# ⚠️ production ต้องตั้งค่าจริง — ค่า default รู้กันหมด = ใครก็ปลอม ticket ได้ +# ADDIN_TICKET_SECRET=super_secret +# ฝั่ง add-in (inline ลง bundle ตอน build — ใช้เป็นแค่ UX gate ตัดเคสไฟล์ถูกแก้ก่อนยิง +# network ส่วนความมั่นคงจริงอยู่ที่ฝั่ง server ข้างบน) +# NEXT_PUBLIC_ADDIN_TICKET_SECRET=super_secret diff --git a/CLAUDE.md b/CLAUDE.md index c1656e7..170bbc0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,7 +12,7 @@ - Next.js 14 (App Router) + TypeScript **strict** — serve ใต้ basePath `/docedit` + route ทั้งหมดของแอปใต้ `app/note/**` (URL ปลายทางยังเป็น `/docedit/note/…` เหมือนเดิม — basePath `/docedit` เป็นพื้นที่กลางรองรับ sibling ในอนาคต เช่น wordaddin, `next.config.mjs`) - pdfjs-dist **v4** (`^4.10.38`) — built-in TextLayer + worker จาก `public/note/pdf.worker.min.mjs` (postinstall `scripts/patch-pdf-worker.mjs` คัดลอกจาก node_modules + **patch fake-space ไทย** — รายละเอียด invariant #6) - Drizzle ORM + PostgreSQL (Docker container เดียว: `judes-note-db`, image `postgres:17-alpine`, พอร์ต 54322) — **ไม่ใช้ Supabase** + realtime sync ด้วย **SSE (Server-Sent Events)** ผ่าน `app/api/note/annotations/stream` + pub/sub in-process (`lib/annotate-events.ts`) -- **wordaddin** — taskpane ของ Word add-in "e-Court Documents Versioning" พอร์ตมาเป็น route `/docedit/wordaddin` ของแอปนี้ (UI = Genesis, ชั้น services Office.js พอร์ตดิบจาก `D:\word-addin-poc\addin`) — ปัจจุบัน auth + API เป็น **mock** รอของจริง (spec UI: `docs/addin-ui-flow.md`, คู่มือ dev/sideload/สลับกลับ: `docs/WORDADDIN-DEV.md`); Office.js **self-host** ที่ `public/wordaddin/office-js/` ผ่าน postinstall `scripts/fetch-office-js.mjs` — gitignore (ดาวน์โหลดฉบับล่าสุดจาก CDN ของ Microsoft ตอนติดตั้ง ตัวระบบ deploy ใช้ intranet ล้วน; แพ็กเกจ npm `@microsoft/office-js` เลิกอัปเดตที่ 1.1.110 ก่อน WordApi 1.4/1.5 — runtime ตัวนั้นไม่มี `Document.close` ใช้ไม่ได้) +- **wordaddin** — taskpane ของ Word add-in "e-Court Documents Versioning" พอร์ตมาเป็น route `/docedit/wordaddin` ของแอปนี้ (UI = Genesis, ชั้น services Office.js พอร์ตดิบจาก `D:\word-addin-poc\addin`) — **ไม่มี login ยกเลิก Keycloak 2026-10-27**: auth = **ticket ของ e-Court** (`ticket_data` + `HmacSha256` ใน custom properties — add-in ตรวจ HMAC เองฝั่ง client แล้วขอ token ที่ `/api/documents/token` แบบ body ticket เก็บใน localStorage `wordaddin-auth` ตาม fid, `docs/PLAN-ADDIN-AUTH.md`) และ **upload/download เป็นของจริงแล้ว** (ปลด mock 2026-10-27 — `versioningService` ยิง `/api/documents/*` ผ่าน Bearer same-origin; mock เหลือเฉพาะ `?addindemo`) (spec UI: `docs/addin-ui-flow.md`, คู่มือ dev/sideload: `docs/WORDADDIN-DEV.md`); Office.js **self-host** ที่ `public/wordaddin/office-js/` ผ่าน postinstall `scripts/fetch-office-js.mjs` — gitignore (ดาวน์โหลดฉบับล่าสุดจาก CDN ของ Microsoft ตอนติดตั้ง ตัวระบบ deploy ใช้ intranet ล้วน; แพ็กเกจ npm `@microsoft/office-js` เลิกอัปเดตที่ 1.1.110 ก่อน WordApi 1.4/1.5 — runtime ตัวนั้นไม่มี `Document.close` ใช้ไม่ได้) - Tailwind CSS + design system **Genesis** (`docs/DESIGN.md`, 2026-09-23) — palette tokens ใน `tailwind.config.ts` (`primary` เดิม + `primary-hover`/`canvas`/`line`/`ink`/`ink-soft`/`ink-faint`/`success`/`warning`/`error` + ระดับข้อความ `success-ink`/`warning-ink`/`error-ink` ≥5:1 สำหรับข้อความ/ไอคอนสถานะ — token 500 ใช้กับ border/bg tint เท่านั้น) ห้ามใช้ raw palette shades ของ Tailwind (`slate-*`/`amber-*`/`emerald-*`/`red-*` ฯลฯ) อีก; ฟอนต์ display = **General Sans** (self-host จาก Fontshare ผ่าน `next/font/local` — `app/fonts/`, variable weight 200–700, ใช้ intranet ได้), body = **DM Sans** (`next/font/google`), ไทย fallback **Sarabun** ตามลำดับใน stack (Latin ก่อนไทย — `fontFamily`/globals.css); รัศมี: ปุ่ม/input 6px (รวมปุ่ม action เล็กใน popup/composer/dialog — คู่ ยกเลิก/บันทึก ต้องได้รัศมีเดียวกัน), menu/list row ใน dropdown/panel 4px, panel/dropdown 8px, การ์ด 12px; เงาเฉพาะ hover (`shadow-card-hover`/`shadow-btn-glow` — static ไม่มีเงา ยกเว้นชั้น floating: dropdown/popover `shadow-lg` และ pin ลอยบนเอกสาร ดู §App-specific exceptions ของ DESIGN.md); focus indicator = outline น้ำเงินทึบ 2px + offset ผ่าน class `.focus-ring`/`.genesis-input` ใน globals.css (+ สำเนา `FOCUS_RING_CLS` ใน PDFViewer/AnnotationSidebar/AnnotationSelectionLayer/ToolControls — แก้ต้องแก้พร้อมกัน; halo alpha จางเกิน WCAG 1.4.11); น้ำเงินเฉพาะของ interactive (แบรนด์มาร์ก tile JN/แถบหัวหน้าสรุปยกเว้น) - mock login e-Court — หน้า `/note/login` (dropdown `MOCK_USERS` user1–user5 + รหัสผ่านกลาง `Demo1234`) ตั้ง cookie `oacCase` ตาม format จริงของระบบศาล → identity (userId = `u_userid`, userName = `u_userlogin` — **ต่างกันต่อคน** เพื่อสิทธิ์เจ้าของ) อ่านจาก cookie ผ่าน `lib/session.ts` + บังคับทุกหน้าด้วย `middleware.ts` (auth จริงเทียบระบบ e-Court + roles ยัง out of scope) @@ -21,7 +21,7 @@ 1. **Non-Destructive:** ไฟล์ต้นฉบับ (PDF/รูปภาพ) ไม่ถูกแก้ไขเด็ดขาด — annotation เก็บใน DB เป็นพิกัดเท่านั้น (export PDF ของ F8/N3 สร้างไฟล์ใหม่จากสำเนาในหน่วยความจำ — อ่าน `public/` อย่างเดียว ห้ามเขียนทับ; อัปโหลด N4 เขียนไฟล์**ใหม่**ที่ `public/note/uploads/` เท่านั้น ห้ามแตะไฟล์เดิม) 2. **พิกัดทุกอย่างใน DB เป็น % ของขนาดหน้า** — `rects`, `paths`, `position`, `strokeWidth` (% ของ width), `yOffset` (% ของ height) — แปลง px⇄% ผ่าน `utils/coordinates.ts` เท่านั้น และก่อนบันทึก HIGHLIGHT ต้องรวบ rects ด้วย `mergeRectsByLine` เหลือ 1 rect ต่อบรรทัด 3. **ลำดับ layer ตาม PLAN.md §1:** canvas (`pointer-events: none` เสมอ) → highlight-layer (`none` เสมอ, `mix-blend-mode: multiply`) → textLayer → InkLayer (SVG) → comment pins — สลับ pointer-events ตาม tool ปัจจุบัน -4. **เขียนผ่าน Server Actions เท่านั้น** (`app/actions/annotations.ts`) และ**หลังเขียน DB สำเร็จทุกครั้ง ต้อง publish event ผ่าน `lib/annotate-events.ts` + `revalidatePath` หน้า viewer และ summary ของ fileId นั้น** (helper `revalidateFilePages` — สั่ง browser ทิ้ง Router Cache ฝั่ง client, `force-dynamic` ปิดแค่ฝั่ง server ไม่พอ: ไม่งั้นกด back แล้วคลิกเข้าไฟล์ใหม่ยังได้ initial data เก่าจนต้อง hard refresh) / **อ่าน + sync ผ่าน SSE hook** (`hooks/useAnnotationRealtime.ts` เปิด `EventSource` ไป `/api/note/annotations/stream?fileId=`) — event เป็น DTO (camelCase + ISO string) จาก server ตรง ๆ — **ยกเว้น `registerExternalFile` (N8)** ที่เขียน row `files` ระหว่าง render ของหน้า `/note` และ `/note/annotate` (entry point ทั้งสองของสัญญาลิงก์ `?fileUrl=`) แล้ว `redirect` ออกทันที (หน้า `force-dynamic` + รายการไฟล์ไม่ได้ sync ผ่าน SSE — ไม่ต้อง publish event/`revalidatePath`) · เช่นกัน **กลุ่ม docver `app/api/documents/**`** (จัด version เอกสาร — `docs/PLAN-DOCVER.md`) เขียนตาราง `documents`/`document_versions` ผ่าน route handler ไม่ใช่ Server Action (ผู้เรียกเป็นระบบภายนอก stand-alone บอก userId/userName เองใน request ไม่มี session ของแอป note) — ไม่มีหน้า note ใดอ่านตารางนั้น จึงไม่ต้อง publish event/`revalidatePath` +4. **เขียนผ่าน Server Actions เท่านั้น** (`app/actions/annotations.ts`) และ**หลังเขียน DB สำเร็จทุกครั้ง ต้อง publish event ผ่าน `lib/annotate-events.ts` + `revalidatePath` หน้า viewer และ summary ของ fileId นั้น** (helper `revalidateFilePages` — สั่ง browser ทิ้ง Router Cache ฝั่ง client, `force-dynamic` ปิดแค่ฝั่ง server ไม่พอ: ไม่งั้นกด back แล้วคลิกเข้าไฟล์ใหม่ยังได้ initial data เก่าจนต้อง hard refresh) / **อ่าน + sync ผ่าน SSE hook** (`hooks/useAnnotationRealtime.ts` เปิด `EventSource` ไป `/api/note/annotations/stream?fileId=`) — event เป็น DTO (camelCase + ISO string) จาก server ตรง ๆ — **ยกเว้น `registerExternalFile` (N8)** ที่เขียน row `files` ระหว่าง render ของหน้า `/note` และ `/note/annotate` (entry point ทั้งสองของสัญญาลิงก์ `?fileUrl=`) แล้ว `redirect` ออกทันที (หน้า `force-dynamic` + รายการไฟล์ไม่ได้ sync ผ่าน SSE — ไม่ต้อง publish event/`revalidatePath`) · เช่นกัน **กลุ่ม docver `app/api/documents/**`** (จัด version เอกสาร — `docs/PLAN-DOCVER.md`) เขียนตาราง `documents`/`document_versions` ผ่าน route handler ไม่ใช่ Server Action (ผู้เรียกเป็นระบบภายนอก stand-alone ไม่มี session ของแอป note — identity userId/userName, templateId และ docId (จาก claim fid) แกะจาก Bearer token ที่ขอจาก `POST /api/documents/token` ผ่าน `lib/docver-token.ts` ไม่รับจาก request payload อีกต่อไป) — ไม่มีหน้า note ใดอ่านตารางนั้น จึงไม่ต้อง publish event/`revalidatePath` 5. **Timestamp ข้าม server→client→SSE เป็น ISO string เสมอ** (DTO types) — ห้ามส่ง Date object ตรง ๆ 6. **pdfjs-dist ต้อง `dynamic import()` ภายใน useEffect เท่านั้น** — ห้าม import top-level ใน module scope ที่ server evaluate และต้องตั้ง `GlobalWorkerOptions.workerSrc = withBasePath("/pdf.worker.min.mjs")` (postinstall `scripts/patch-pdf-worker.mjs` คัดลอกไฟล์ไป `public/note/` **แล้ว patch จุดเดียว: ถอด `if (scaledDim)` รอบ `textChunk.prevTransform = getCurrentTextTransform()` ให้อัปเดตทุก glyph** — pdf.js เดิมข้าม glyph กว้าง 0 อย่างสระ/วรรณยุกต์ไทย ทำให้ charSpacing ของ glyph เหล่านั้นสะสมเป็น gap จน `addFakeSpaces` แทรก " " กลางคำ "ฉะนั้ น" — bug ของ pdf.js ที่ upstream ยังไม่แก้; การ patch ทำบนโค้ด minified ด้วย pattern จำเพาะ ถ้าอัปเกรด pdfjs-dist แล้ว pattern ไม่ตรง postinstall จะ **fail ดัง ๆ โดยตั้งใจ** กัน patch หลุดเงียบ — test กัน regression: `tests/scripts/patch-pdf-worker.test.ts` + fixture `tests/fixtures/thai_letterspacing.pdf` — Docker build ต้องใช้ script นี้ด้วย ไม่ใช่ copyFileSync เปล่า ดู `docker/web.Dockerfile`) — ห้ามใช้ `new URL(..., import.meta.url)` 7. **InkLayer ใช้ SVG แบบไม่มี viewBox** — render ด้วย px จริง แปลง % → px จากขนาดที่ ResizeObserver วัด (viewBox จะทำให้ความหนาเส้นบิดเบี้ยว) @@ -35,13 +35,14 @@ ``` docker-compose.yml ← dev dependencies: `db` (judes-note-db — ชื่อ container/วอลุ่มเดียวกับคำสั่ง docker run เดิมใน README migrate ได้เลย, POSTGRES_DB ecourt-note) + `minio` (judes-note-minio — object storage ของกลุ่ม docver; โฮสต์แมพ 19000 API/19001 console เพราะ 9000/9001 ชน container โปรเจกต์อื่นในเครื่อง dev, image จาก quay.io ทางการ; bucket `docver` ไม่ต้องสร้างเอง app สร้างตอน first use ผ่าน ensureBucket) -docs/PLAN-DOCVER.md ← แผนกลุ่ม API docver: จัด version เอกสาร .docx+.pdf ต่อ docId (ห้ามซ้ำ) เก็บ object ใน MinIO + ผู้อัปโหลดต่อ version — contract 3 endpoint, ดีไซน์ตาราง, env MINIO_* ทั้งหมด +docs/PLAN-DOCVER.md ← แผนกลุ่ม API docver: จัด version เอกสาร .docx+.pdf ต่อ docId (ห้ามซ้ำ) เก็บ object ใน MinIO + ผู้อัปโหลดต่อ version — contract 4 endpoint (เพิ่ม POST /token ขอ access_token — Bearer บังคับทุก endpoint), ดีไซน์ตาราง, env MINIO_* + DOCVER_API_KEY/DOCVER_TOKEN_SECRET/DOCVER_TOKEN_TTL_SECONDS ทั้งหมด scripts/patch-pdf-worker.mjs ← postinstall: คัดลอก pdf.worker.min.mjs จาก node_modules ไป public/note/ + patch fake-space ไทย (invariant #6 — เจอ pattern ≠ 1 จุดหลังอัปเกรด pdfjs-dist = exit 1 ดัง ๆ) scripts/copy-swagger-ui.mjs ← postinstall ตัวที่สอง: คัดลอก swagger-ui-dist (bundle+css) ไป public/note/swagger-ui/ สำหรับหน้า Swagger UI ที่ GET /api/swagger (intranet ไม่ใช้ CDN — หาไฟล์ไม่เจอหลังอัปเกรด = exit 1 ดัง ๆ เหมือน patch-pdf-worker; Docker build รัน script นี้ด้วย ดู docker/web.Dockerfile) scripts/fetch-office-js.mjs ← postinstall ตัวที่สาม: ดาวน์โหลด Office.js runtime **ฉบับ CDN ล่าสุด** (appsforoffice.microsoft.com — ชุดไฟล์เฉพาะ Word: loader + host files ราย platform + legacy 15.x + o15apptofilemappingtable/microsoftajax + office_strings.js ต่อ locale en-us/th-th บังคับ) ไป public/wordaddin/office-js/ ให้ taskpane โหลด same-origin — npm `@microsoft/office-js` เลิกอัปเดตที่ 1.1.110 (~2018) ไม่มี `Document.close`/enum `CloseBehavior` ที่ runtime ใหม่+`@types/office-js` มี; ไฟล์หลักหาย/ตรวจไม่เจอ `"Document.close"`+`CloseBehavior` ใน word-win32-16.01.js หลังโหลด = exit 1 ดัง ๆ (ไฟล์ปลายทาง gitignore — ดาวน์โหลดใหม่ทุกครั้ง; ติดตั้งต้องออกเน็ตถึง CDN ของ Microsoft ส่วน runtime ตัวระบบ intranet ล้วน) +scripts/make-ticket-docx.mjs ← dev tool รันมือ (ไม่ใช่ postinstall): stamp ticket ขอ e-Court (`ticket_data` + `HmacSha256`) ลงไฟล์ .docx ใด ๆ ผ่าน pizzip เพื่อทดสอบ ticket auth ของ add-in ใน Word จริงโดยไม่ต้องผ่านกลุ่ม template (TMPL_PATH) — คำนวณ HMAC ตรงกับตัว stamp จริง (key เรียงตามตัวอักษรหลังเติม exp + เซ็นบน string ดิบ hex lowercase) · ตัวเลือก --fid/--uid/--uname/--tid/--exp /--secret/--tracked/--in-place/--list (PLAN-ADDIN-AUTH.md §9) db/schema.ts ← ตาราง + JSONB types + DTO + mapper toDTO db/index.ts ← postgres.js + drizzle (DATABASE_URL → container judes-note-db, prepare:false) -middleware.ts ← บังคับ login ทุกหน้า — ไม่มี cookie oacCase ที่ parse ได้ = redirect /note/login (path ที่ตัด basePath แล้ว: หน้าขึ้นต้น /note/… ส่วน API ขึ้นต้น /api/note/… — ยกเว้น note/login, api/note/*, api/template/* (กลุ่ม docx template เปิดกว้างให้ทางศาล/ผู้ทดสอบภายนอกยิงได้เลย — ไม่แตะ DB), api/documents/* (กลุ่ม docver จัด version เอกสาร — stand-alone ผู้เรียกบอก userId/userName เอง ไม่มี session, docs/PLAN-DOCVER.md), api/swagger/* (หน้า Swagger UI), wordaddin/* (taskpane ของ Word add-in — auth mock ของตัวเอง), note/uploads/*, note/samples, note/swagger-ui/*, note/pdf.worker.min.mjs, _next, fonts, favicon และ **root "/" เอง** (matcher ใช้ `.+` — root เป็น redirect สู่ /wordaddin ซึ่ง public ตามคำขอผู้ใช้ 2026-10-14, ลิงก์ e-Court N8 ที่ root ยังถูกคุมผ่าน /note ที่รับส่งต่อ)) +middleware.ts ← บังคับ login ทุกหน้า — ไม่มี cookie oacCase ที่ parse ได้ = redirect /note/login (path ที่ตัด basePath แล้ว: หน้าขึ้นต้น /note/… ส่วน API ขึ้นต้น /api/note/… — ยกเว้น note/login, api/note/*, api/template/* (กลุ่ม docx template เปิดกว้างให้ทางศาล/ผู้ทดสอบภายนอกยิงได้เลย — ไม่แตะ DB), api/documents/* (กลุ่ม docver จัด version เอกสาร — stand-alone ไม่มี session ใช้ auth ของกลุ่มเอง: ขอ access_token ผ่าน x-api-key แล้วแนบ Bearer ทุก endpoint, docs/PLAN-DOCVER.md), api/swagger/* (หน้า Swagger UI), wordaddin/* (taskpane ของ Word add-in — ไม่มี login: auth เป็น e-Court pass-through จาก token/owner ในไฟล์), note/uploads/*, note/samples, note/swagger-ui/*, note/pdf.worker.min.mjs, _next, fonts, favicon และ **root "/" เอง** (matcher ใช้ `.+` — root เป็น redirect สู่ /wordaddin ซึ่ง public ตามคำขอผู้ใช้ 2026-10-14, ลิงก์ e-Court N8 ที่ root ยังถูกคุมผ่าน /note ที่รับส่งต่อ)) lib/annotate-events.ts ← pub/sub in-process (actions publish → SSE route subscribe) lib/server-pdf.ts ← path guard อ่าน PDF จาก public/note/ (export ใช้) lib/session.ts ← getSessionUser — identity จาก cookie oacCase (mock login e-Court) @@ -50,16 +51,14 @@ lib/remote-file.ts ← N8 ดึงไฟล์รีโมตจาก allow lib/external-api-auth.ts ← N10 auth ของ /api/note/external/* — requireExternalApiKey เทียบ header `x-api-key` กับ env `EXTERNAL_API_KEY` ด้วย SHA-256 + crypto.timingSafeEqual (env ไม่ตั้ง/ว่าง = 401 fail closed ทุก request; ข้อความ 401 อันเดียวกันทั้งไม่ใส่/key ผิด กัน enumerate; ห้าม log ค่า key/header ดิบ) + externalApiError สร้าง Response ผิดพลาด JSON {"error": ไทย} ใช้ร่วมทุก route ของ N10 — **module นี้ห้าม import อะไรที่ลาก @/db มาด้วย** (db/index.ts throw ตอน import เมื่อไม่มี DATABASE_URL — unit test tests/lib/external-api-auth.test.ts ต้องรันได้โดยไม่แตะ DB) lib/external-api.ts ← N10 ส่วนกลางของ route — parseQueryBody (validate JSON body ของ /api/note/external/documents: รับเฉพาะ fileId/typeId/filter, ต้องมี fileId หรือ typeId อย่างน้อยหนึ่งอย่าง — ส่งทั้งคู่ได้ = AND เหลือเฉพาะเอกสารเดียวที่ตรงทั้งสองเงื่อนไข, คำขอผู้ใช้ 2026-09-25 (รอบเดียวกันเคยเป็น OR แล้วเปลี่ยนหลังทดสอบจริง), filter รับเฉพาะ type ∈ bookmarks|annotations ไม่ส่ง = ทั้งสอง + userId (string|array กรองตามเจ้าของรายการ annotations+bookmarks) + annotationTypes (ค่า enum annotation_type เฉพาะ annotations ค่าอื่น = 400 — เดิมชื่อ types เปลี่ยน 2026-09-25) — คืน discriminated mode "file" (fileId + typeId อาจมาด้วย) / "type" (typeId เดี่ยว)) + loadDocumentBundles(fileRows, parts) (bulk: inArray ทุกไฟล์ในชุด query เดียว = 3 query ต่อ request ไม่ว่ากลุ่มกี่ไฟล์ แทนยิง 3 query ต่อไฟล์พร้อมกันทั้งกลุ่ม, code review 2026-09-25 — กรอง userIds/annotationTypes ใน SQL; คืน bundle ยุบชั้น: field เอกสาร + annotations + bookmarks ระดับเดียวกัน ไม่มี object document ซ้อน; ต่อรายการมี `url` deep link F12 กลับหน้า `/annotate/[id]` — annotation `?ann=` / bookmark `?page=<หน้า 1-based>` — URL เต็ม: origin จาก request ผู้เรียก (route อ่าน x-forwarded-proto/host แล้ว fallback host ตรง ส่งเข้าทาง parameter origin) + basePath ผ่าน withBasePath, คำขอผู้ใช้ 2026-09-25) + type ExternalDocumentDTO (externalFileId เป็น null สำหรับไฟล์ url:-fallback/อัปโหลด N4 ในกลุ่ม) lib/openapi.ts ← OpenAPI 3.0 spec ของ API ทดสอบ (กลุ่ม template + N10 + docver — 2026-10-06) — แหล่งเดียวของ Swagger UI: GET /api/template inline ลง HTML ตรง ๆ ไม่มี endpoint spec แยก; URL ใน paths เป็น path เต็ม /api/… (servers เติมแค่ basePath ตาม invariant #12) — แก้ contract ของ API ต้องมาแก้ไฟล์นี้ให้ตรงด้วย -lib/document-versioning.ts ← docver pure validation (ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test tests/lib/document-versioning.test.ts ต้องรันได้เหมือน lib/external-api-auth.ts): parseDocId (charset [A-Za-z0-9._:-] 1–200), parseVersionUploadForm (allowlist field + userId/userName บังคับ + fields JSON ≤100 keys + message ≤2048), isDocxBytes/isPdfBytes (magic bytes), parseDownloadFormat/parseVersionIdParam, contentDispositionValue (ASCII fallback + filename*=UTF-8'') + docverError สร้าง Response JSON {"error": ไทย} ใช้ร่วมทุก route ของกลุ่ม +lib/document-versioning.ts ← docver pure validation (ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test tests/lib/document-versioning.test.ts ต้องรันได้เหมือน lib/external-api-auth.ts): parseVersionUploadForm (allowlist field — identity ไม่รับจาก form แล้ว แกะจาก token ผ่าน lib/docver-token.ts + fields JSON ≤1,000 keys **ความยาวค่าไม่จำกัด** (2026-10-27 เอกสารจริง 100–200 หน้า) + message ≤2048), isDocxBytes/isPdfBytes (magic bytes), parseDownloadFormat/parseVersionIdParam, contentDispositionValue (ASCII fallback + filename*=UTF-8'') + docverError สร้าง Response JSON {"error": ไทย} ใช้ร่วมทุก route ของกลุ่ม (parseDocId ถอดแล้ว 2026-10-26 — docId ไม่มาจาก path param) +lib/docver-token.ts ← docver token + auth ของกลุ่ม /api/documents/* (2026-10-22 — pure module ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย เหมือน lib/document-versioning.ts; unit test tests/lib/docver-token.test.ts ต้องรันได้โดยไม่ต้องตั้ง env) +lib/addin-ticket.ts ← add-in ticket auth ฝั่ง server ของทางเข้าที่สองของ POST /api/documents/token (2026-10-27, docs/PLAN-ADDIN-AUTH.md — pure เหมือน lib/docver-token.ts; unit test tests/lib/addin-ticket.test.ts): addinTicketSecret (env ADDIN_TICKET_SECRET → SECRET → "super_secret") + verifyAddinTicket (HMAC timing-safe บน ticket_data ดิบ + exp ผ่าน utils/docver-ticket.ts) + ticketToDocverClaims (uid→userid, uname→username, tid→template) + parseTicketTokenBody (allowlist ticket_data/HmacSha256 — missing → 401 / invalid → 400): issueDocverToken/verifyDocverToken (JWT HS256 มือเขียน node:crypto ล้วน — บังคับ alg=HS256 กัน alg-confusion, timingSafeEqual หลัง hash ทั้งสองฝั่ง, exp บังคับ) + requireDocverApiKey (header x-api-key เทียบ env DOCVER_API_KEY — fail closed 401 ไม่ตั้ง/ว่าง, 401 เดียวกันทั้งไม่ใส่/ผิด กัน enumerate, ห้าม log ค่า key/header ดิบ) + requireDocverBearer (Authorization: Bearer → claims {userid, username, fid, template} — secret จาก env DOCVER_TOKEN_SECRET ไม่ตั้ง = 401, ทุกกรณี 401 ข้อความเดียวกัน) + parseTokenRequestBody (allowlist userid/username/fid/template — **fid = fileId ของ e-Court (string, บังคับ 2026-10-26)** เป็น docId ของทุก operation ตรง ๆ · verify ไม่รับ token ที่ไม่มี fid) lib/docver-store.ts ← docver server-side MinIO + DB (env MINIO_* อ่านตอนเรียกไม่ใช่ module load; client + cached ensureBucket เก็บบน globalThis แบบ db/index.ts): object key `docver//document.docx|pdf` (uuid ล้วน ไม่มี input ผู้ใช้), putVersionObjects (docx ก่อน — pdf ล้ม = ลบ docx คืนแล้วโยนต่อ), removeVersionObjects (best-effort), presignVersionUrl (TTL env DOCVER_LINK_TTL_SECONDS), insertVersionRecord (**tx เดียว**: upsert documents ON CONFLICT DO NOTHING → SELECT id FOR UPDATE → max(versionNumber)+1 → insert — จ่ายเลข version ปลอดภัยเรียกคู่ขนาน, UNIQUE(document_id, version_number) เป็น safety net) wordaddin/ ← **client-only zone ของ Word add-in** (ห้าม import จาก lib/ หรือถูก import โดย server component — พอร์ตดิบจาก D:\word-addin-poc\addin\src, spec: docs/addin-ui-flow.md, คู่มือ dev: docs/WORDADDIN-DEV.md) -wordaddin/config.ts ← env NEXT_PUBLIC_ADDIN_API_BASE_URL ("" = ยังไม่ต่อ backend จริง) + NEXT_PUBLIC_ADDIN_MOCK_USERNAME (mock auth) +wordaddin/config.ts ← env NEXT_PUBLIC_ADDIN_API_BASE_URL ("" = ยังไม่ต่อ backend จริง) + NEXT_PUBLIC_ADDIN_MOCK_USERNAME (ชื่อ fallback ของ ?addindemo/ไฟล์ที่มี token ไม่มี owner) wordaddin/models/versionRecord.ts ← types VersionRecord/FieldsSnapshot + readSnapshotField (พอร์ตดิบ) -<<<<<<< HEAD -wordaddin/services/ ← documentService/fileService/metadataService/autoSaveService/versionFlow/apiClient/errors พอร์ตดิบทั้งไฟล์ · **authService = MOCK** (login ผ่านทันที คง surface เดิมครบไว้สลับของจริง — ต้นฉบับ Keycloak PKCE อยู่ที่ D:\word-addin-poc\addin + **`signInFromDocument` e-Court pass-through 2026-10-16: ไฟล์ที่ stamp custom properties `token`/`owner` มา (`readTrackedProperties` อ่านรวม) = `detect()` ของ TaskpaneApp ผ่านเข้าเลยไม่ต้องกด login — username จาก owner → uid ใน JWT → mockUsername, token ไฟล์เก็บ memory ให้ getAccessToken ใช้ต่อ**) · **versioningService = MOCK** (memory + **metadata persist ลง localStorage ต่อ documentId** เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ได้ — blob ไฟล์จริงเฉพาะ session; คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId เป๊ะ, download-link คืน about:blank — **backend จริงของ surface นี้มีแล้ว**: กลุ่ม `app/api/documents/**` (docver, docs/PLAN-DOCVER.md — สลับ mock ด้วยการตั้ง `NEXT_PUBLIC_ADDIN_API_BASE_URL`) -======= -wordaddin/services/ ← documentService/fileService/metadataService/autoSaveService/versionFlow/apiClient/errors พอร์ตดิบทั้งไฟล์ + **templateService** (แท็บที่ 2 "เครื่องมือ Template" 2026-10-19 — list/select/applyTestValues + แทรกย่อหน้า-ตัวแบ่งบรรทัด-ตัวแบ่งหน้า ที่ cursor (page break มี fallback OOXML กัน E_FAIL), Office.js ล้วน — ⚠️ `contentControls` ธรรมดาเห็นเฉพาะ rich text CC: feature-detect WordApi 1.5 ใช้ `getContentControls()` เห็นทุกชนิด, ห้าม top-level Office access) · **authService = MOCK** (login ผ่านทันที คง surface เดิมครบไว้สลับของจริง — ต้นฉบับ Keycloak PKCE อยู่ที่ D:\word-addin-poc\addin + **`signInFromDocument` e-Court pass-through 2026-10-16: ไฟล์ที่ stamp custom properties `token`/`owner` มา (`readTrackedProperties` อ่านรวม) = `detect()` ของ TaskpaneApp ผ่านเข้าเลยไม่ต้องกด login — username จาก owner → uid ใน JWT → mockUsername, token ไฟล์เก็บ memory ให้ getAccessToken ใช้ต่อ**) · **versioningService = MOCK** (memory + **metadata persist ลง localStorage ต่อ documentId** เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ได้ — blob ไฟล์จริงเฉพาะ session; คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId เป๊ะ, download-link คืน about:blank) ->>>>>>> 6daee1585199721ba931b2bf4fe55277cb7c304a +wordaddin/services/ ← documentService/fileService/metadataService/autoSaveService/versionFlow/apiClient/errors พอร์ตดิบทั้งไฟล์ + **templateService** (แท็บที่ 2 "เครื่องมือ Template" 2026-10-19 — list/select/applyTestValues + แทรกย่อหน้า-ตัวแบ่งบรรทัด-ตัวแบ่งหน้า ที่ cursor (page break มี fallback OOXML กัน E_FAIL), Office.js ล้วน — ⚠️ `contentControls` ธรรมดาเห็นเฉพาะ rich text CC: feature-detect WordApi 1.5 ใช้ `getContentControls()` เห็นทุกชนิด, ห้าม top-level Office access) · **authService + ticketService = ticket auth ของ e-Court ทางเดียว ไม่มี login แล้ว** (ยกเลิก Keycloak → pass-through token/owner → ticket 2026-10-27, `docs/PLAN-ADDIN-AUTH.md` ตาม `docs/requirement/addin-workflow.md` — surface เหลือ signInForDemo (dev-only) / signInWithTicket / getAccessToken / renewTokenFromTicket / getUsername; ไฟล์ที่ stamp custom properties `ticket_data`+`HmacSha256` มา = `detect()` ของ TaskpaneApp เรียก signInWithTicket: ตรวจ HMAC ฝั่ง client (Web Crypto + NEXT_PUBLIC_ADDIN_TICKET_SECRET — UX gate) → exp → session localStorage `wordaddin-auth` ตาม uid (user ใหม่ = เคลียร์ทั้งก้อน) → ขอ token ที่ `/api/documents/token` แบบ body ticket ผูก fid; ไม่มี ticket/HMAC ไม่ตรง/หมดอายุ = phase `no-access` แยกข้อความตามสาเหตุ; apiClient โดน 401 = renew จาก ticket 1 ครั้ง ยังไม่ผ่าน = AuthRequiredError → no-access) · **versioningService = ของจริง** (ปลด mock 2026-10-27 — uploadVersion/getVersions/getDownloadLink ยิงกลุ่ม `/api/documents/*` ผ่าน apiClient (Bearer same-origin ผ่าน withBasePath — `NEXT_PUBLIC_ADDIN_API_BASE_URL` ตั้งเฉพาะวัน deploy คนละ origin ต้องรวม basePath); เอกสารระบุด้วย fid ใน token — พารามิเตอร์ documentId/templateId เหลือตาม signature เดิมไม่ส่งถึง server และ **ห้ามส่ง userId/userName/templateId ใน form (contract 2026-10-22 ส่งมา = 400)**; mock เหลือเฉพาะโหมด `?addindemo` ผ่าน `authService.isDemoMode()` — memory + metadata persist ลง localStorage ต่อ documentId, download-link คืน about:blank; unit test tests/wordaddin/versioningService.test.ts คุมทั้งสองโหมด) utils/coordinates.ts ← pixel⇄% + getPointerPercent + clamp + mergeRectsByLine utils/geometry.ts ← bbox/translate/scale/hitTestPath ของ annotation (pure, หน่วย %) utils/annotation-display.ts ← label/ข้อความย่อต่อชนิด + TYPE_SHORT/TYPE_ORDER ชื่อย่อ/ลำดับชนิด (บรรทัดสรุปหน้าของหน้าสรุป + แผงตัวกรอง explorer — ย้ายจาก 2 ที่ซ้ำกันมารวมที่นี่ 2026-09-24) + ค่า default TEXTBOX/STAMP + describeAnnotationChange สรุปสิ่งที่เปลี่ยนของ version history F19 (sidebar/สรุป/groups/CSV ใช้ร่วม) @@ -68,6 +67,7 @@ utils/pdf-export.ts ← แปลงพิกัดจอ⇄PDF (/Rotate) + wr utils/user.ts ← parse/build ค่า cookie oacCase → OacUser {userId: u_userid, userName: u_userlogin} (pure module — middleware ใช้ร่วมได้) utils/external-file.ts ← N8 validation ลิงก์ไฟล์รีโมต (allowlist "admincourt.go.th" + env EXTERNAL_FILE_HOSTS, suffix match, https เท่านั้น ห้าม user:pass@) + titleFromExternalUrl/externalIdFor/isHttpUrl + normDocumentGroup (N9 normalize รหัสกลุ่ม — ใช้ร่วม N8/N4, pure) utils/base-path.ts ← withBasePath() เติม basePath /docedit + app path /note ให้ URL ฝั่ง browser ที่ Next ไม่เติมให้เอง (ค่าจาก next.config.mjs ผ่าน env — invariant #12) +utils/docver-ticket.ts ← ticket ของ add-in ส่วน pure แชร์ client/server (2026-10-27, PLAN-ADDIN-AUTH.md §4 — ไม่ import อะไรเลย ให้สองฝั่งฉีด crypto ของตัวเอง: lib/addin-ticket.ts = node:crypto / wordaddin/services/ticketService.ts = Web Crypto): parseDocverTicket (allowlist exp/fid/tid/uid/uname + cap ยาวตาม endpoint) + isTicketExpired + normalizeHexDigest + timingSafeEqualHex + type HmacSha256Hex — unit test tests/utils/docver-ticket.test.ts utils/file-kind.ts ← derive ชนิดไฟล์ pdf/image จาก extension ของ path (N3 — ใช้ร่วม viewer/export/หน้ารายการ/seed) utils/upload-name.ts ← N4 ถอดรหัสชื่อไฟล์จาก FormData ของ Server Action กลับเป็น UTF-8 ก่อนใช้ (undici ถอด header Content-Disposition เป็น latin1 ทำชื่อไทยเพี้ยน "คำ…" — encode กลับ byte แล้วถอด UTF-8; guard: ไม่มีตัว U+0080–U+00FF = ไม่แตะ, ถอดแล้วได้ U+FFFD = เก็บของเดิม, 2026-10-05) utils/tiff-client.ts ← decode TIFF ทุกเฟรม → PNG blob URL ฝั่ง client (N3) @@ -82,7 +82,7 @@ app/api/note/annotations/export/route.ts ← export PDF ฝัง annotation app/api/note/external/documents/route.ts ← N10 API ภายนอกเส้นเดียว (POST + JSON body {fileId และ/หรือ typeId, filter:{type, userId, annotationTypes}} — auth ผ่าน requireExternalApiKey ก่อนแตะ DB, ถาม fileId = ค้น files.external_id = "ecourt:" ไม่เจอ 404 แม้ส่ง typeId มาด้วย / ถาม typeId = ทุกไฟล์ในกลุ่ม กลุ่มว่าง = 200 documents:[] / ส่งทั้งคู่ = AND กรอง externalId+typeId ใน query เดียว เหลือเอกสารเดียว ไม่ตรงคู่ = 404 แยกสาเหตุในข้อความ (2026-09-25 เดิมเคยเป็น OR แล้วเป็น 400); response รูปเดียว {documents:[bundle…]} ผ่าน loadDocumentBundles ทั้งสอง mode; ครอบ try/catch ทุก DB call — ล้ม = log ฝั่ง server + 500 JSON ตาม contract ไม่ปล่อยเป็น 500 ของ framework; read-only ไม่ publish SSE ไม่ revalidatePath — snapshot ณ ตอนเรียก) app/api/swagger/route.ts ← **GET /api/swagger = หน้า Swagger UI** (2026-10-06 — document ของ API ทุกกลุ่ม: spec inline จาก lib/openapi.ts + asset จาก public/note/swagger-ui/ ของ postinstall scripts/copy-swagger-ui.mjs, persistAuthorization เก็บ x-api-key ไว้ใช้ข้าม reload — เปิดกว้างไม่ต้อง login) app/api/template/{test,extract,render}/route.ts ← กลุ่ม API docx template ของ wordaddin (WIP — GET test ตรวจ service / POST extract ดึงค่า Content Control / POST render = template(.docx)+data(JSON ไฟล์หรือ field dataJson) คืน .docx ใหม่; logic รวมอยู่ app/api/template/lib-tmpl.ts เป็นแชร์ไลบรารี pizzip+xpath; ไฟล์ทดสอบ/โน้ตอยู่ app/api/template/test/ — ไม่แตะ DB, URL /docedit/api/template/…) -app/api/documents/[docId]/versions/route.ts + [versionId]/download-link/route.ts ← **กลุ่ม API docver จัด version เอกสาร** (docs/PLAN-DOCVER.md — URL /docedit/api/documents/…, ไม่มี auth เปิดกว้างเหมือน api/template): POST versions = multipart `file`(.docx บังคับ ≤100MB เช็ค size ก่อน buffer → 413)+`pdf`(optional ไฟล์เปล่า = ไม่มี)+userId/userName+fields/message/clientVersionId/templateId/fileName → สร้างเอกสารอัตโนมัติถ้า docId ใหม่, MinIO ก่อน DB (DB ล้มหลัง put = เก็บกวาด object แบบ N4) → `{hasPdf, versionId, versionNumber}` (เลขจาก server เป็นค่าจริง) / GET versions = DocumentVersionDTO[] ใหม่→เก่า (ไม่เคยมี docId = 404) / GET download-link?format=docx|pdf = presigned URL อายุสั้น (เช็ค docId+versionId คู่กันกันโยน id ข้ามเอกสาร; ขอ pdf ที่ version ไม่มี = 404) — carve-out invariant #4: ไม่ publish SSE ไม่ revalidatePath +app/api/documents/token/route.ts + versions/route.ts + versions/[versionId]/download-link/route.ts ← **กลุ่ม API docver จัด version เอกสาร** (docs/PLAN-DOCVER.md — URL /docedit/api/documents/…, auth ของกลุ่มเอง 2026-10-22: POST token ขอ access_token ด้วย header `x-api-key` + env `DOCVER_API_KEY` (lib/docver-token.ts — fail closed 401 ไม่ตั้ง/ว่าง เหมือน N10) แล้ว **endpoint ที่เหลือทุกตัวบังคับ `Authorization: Bearer`** JWT HS256 เซ็นด้วย env `DOCVER_TOKEN_SECRET` (TTL `DOCVER_TOKEN_TTL_SECONDS` default 3600) — identity userid/username + templateId แกะจาก claims ไม่รับจาก request อีกต่อไป; ส่ง userId/userName/templateId ใน form = 400 ไม่รู้จัก field · **2026-10-27 POST token มีทางเข้าที่สองสำหรับ add-in ใน Word** (PLAN-ADDIN-AUTH.md): ไม่มี x-api-key + body `{ticket_data, HmacSha256}` — lib/addin-ticket.ts ตรวจ HMAC+exp (secret env ADDIN_TICKET_SECRET → SECRET → default "super_secret") แล้วออก token จาก claims ของ ticket เอง · **2026-10-26 ถอด segment `[docId]` ออกจาก URL ทุก endpoint — docId = claim `fid` (string) จาก token ตรง ๆ (บังคับตั้งแต่ขอ token)**): POST versions = multipart `file`(.docx บังคับ ≤100MB เช็ค size ก่อน buffer → 413)+`pdf`(optional ไฟล์เปล่า = ไม่มี)+fields/message/clientVersionId/fileName → สร้างเอกสารอัตโนมัติถ้า docId ใหม่, MinIO ก่อน DB (DB ล้มหลัง put = เก็บกวาด object แบบ N4) → `{hasPdf, versionId, versionNumber}` (เลขจาก server เป็นค่าจริง) / GET versions = DocumentVersionDTO[] ใหม่→เก่า (ไม่เคยมี docId = 404) / GET download-link?format=docx|pdf = presigned URL อายุสั้น (เช็ค docId+versionId คู่กันกันโยน id ข้ามเอกสาร; ขอ pdf ที่ version ไม่มี = 404) — carve-out invariant #4: ไม่ publish SSE ไม่ revalidatePath app/note/uploads/[name]/route.ts ← เสิร์ฟไฟล์อัปโหลดจาก public/note/uploads/ (N4 — Next production เห็นไฟล์ static เฉพาะที่มีตอน startup ไฟล์ที่เขียน runtime ต้องเสิร์ฟผ่าน route) app/note/page.tsx ← รายการไฟล์จัด section ตามกลุ่ม type_id + "ไม่มีกลุ่ม" ท้ายสุด (N9 — server component) app/note/groups/[typeId]/page.tsx ← N9 หน้าเอกสารในกลุ่ม (server component force-dynamic — files where type_id orderBy createdAt, ไม่มี = 404; ~~หมายเหตุ "แสดงเฉพาะเอกสารที่เคยเปิดในระบบนี้"~~ ถอดออกตามคำขอผู้ใช้ 2026-09-24; **redesign 2026-09-24 ตามคำขอผู้ใช้: ไม่มี navbar** — explorer 2 คอลัมน์ ตัวกรองซ้าย + list เดียวรวม bookmark+annotation ทั้งกลุ่มไม่แยกไฟล์: query ทั้งหมดฝั่ง server แล้วส่ง `GroupFileSummary[]` + `GroupListItem[]` (เรียง ไฟล์ตาม createdAt → หน้า → bookmark ก่อน annotation → createdAt) ให้ `GroupExplorer` กรองใน memory, แถวรายการ deep link `?ann=`/`?page=` เหมือนหน้าสรุป F12 + ไฟล์ที่มาต้น meta line) @@ -91,8 +91,8 @@ app/note/annotate/[id]/page.tsx ← โหลด file + initial data → PD app/note/annotate/[id]/summary/page.tsx ← หน้าสรุป Annotation+Bookmark ของไฟล์เดียว (server component — query ทั้งหมดฝั่ง server แล้วส่ง `ExplorerItem[]` เรียง หน้า → หน้าเดียวกัน bookmark ก่อน annotation (bookmark ต่อหน้าเรียงตาม yOffset N5 เหมือนเดิม, annotation ตาม createdAt) ให้ `SummaryExplorer` กรองใน memory; design "แฟ้มสำนวน" 2026-09-17 แถบหัวน้ำเงิน + การ์ดรายหน้าขอบ folio + รายการตามหน้าจุดไข่ปลา → **redesign 2026-09-24 ตามคำขอผู้ใช้เป็น explorer 2 คอลัมน์แบบหน้ากลุ่ม N9 โดยมิติแรกของตัวกรองเป็น "หน้า" แทน "ไฟล์"** — แถบหัวน้ำเงิน + action bar (กลับหน้าอ่าน — ปุ่มส่งออก CSV F16/ส่งออก Bookmark JSON N7 ถอด 2026-09-25 แทนด้วย N10 API) + empty state คงเดิม, ไฟล์ว่าง = ไม่ mount explorer เลย; generateMetadata ตั้งชื่อแท็บ browser ตามคดี; ตอนพิมพ์ header เป็นกรอบเส้นน้ำเงิน + แผงตัวกรอง/แถบ action ซ่อนด้วย print:hidden — กฎ @media print อยู่ใน globals.css) — อย่าถอด class `summary-page` ของ
(กฎ coarse 44px ใน globals.css ผูกอยู่กับ selector นี้ ครอบทั้ง `a` และ `button`) app/wordaddin/layout.tsx + page.tsx ← taskpane ของ Word add-in (URL `/docedit/wordaddin` — nested layout แรกของ repo override title แท็บ browser; page เป็น server component บาง ๆ render WordAddinGate ทั้งหมดฝั่ง client) app/wordaddin/manifest.xml/route.ts ← GET serve manifest ของ add-in พร้อม rewrite origin ตามโฮสต์ที่ขอ (template `public/wordaddin/manifest.template.xml` ค่า dev — dev/UAT/production โหลด manifest.xml ขอ environment ตัวเองแล้วใช้ได้เลย ไม่ต้อง rewrite มือ; origin จาก `utils/request-origin.ts` แชร์กับ deep link N10 — x-forwarded-proto/host ก่อน fallback host ตรง + บังคับ https โฮสต์ที่ไม่ใช่ localhost เพราะ Office รับ https เท่านั้น) -components/wordaddin/WordAddinGate.tsx ← client gate: ฉีด script office.js self-host (ผ่าน withBasePath "/wordaddin/office-js/office.js") → Office.onReady → mount TaskpaneApp · `?addindemo=untracked|tracking` (dev-only) ข้าม office.js + mock sign in + ตั้ง phase ตรง เพื่อดู UI ใน browser ธรรมดา — flow ที่แตะ Word จริงจะจบที่ error ตาม expected (FR-17: ใน browser ปกติ banner auto-save error โผล่หลัง ~30 วิ — ถูกต้อง) -components/wordaddin/TaskpaneApp.tsx ← state machine checking/signed-out/untracked/tracking + handler ทุกตัว พอร์ตจาก App.tsx ต้นฉบับ (state/handlers คงเดิม เปลี่ยนแค่ JSX → Genesis) · SaveControls/MessageBar/Spinner/ConfirmVersionDialog(portal แบบ AnnotationSidebar)/VersionHistoryPanel · **2 แท็บ (Versioning / เครื่องมือ Template — toggle `aria-pressed` เฉพาะ phase untracked|tracking, 2026-10-19): แท็บ template = TemplateToolsPanel (สแกน CC/กรอกค่าทดสอบ/แทรกย่อหน้า-ตัวแบ่ง — spec ที่ docs/addin-ui-flow.md §10)** +components/wordaddin/WordAddinGate.tsx ← client gate: ฉีด script office.js self-host (ผ่าน withBasePath "/wordaddin/office-js/office.js") → Office.onReady → mount TaskpaneApp · `?addindemo=untracked|tracking` (dev-only) ข้าม office.js + ตั้ง session mock (`signInForDemo`) + ตั้ง phase ตรง เพื่อดู UI ใน browser ธรรมดา — flow ที่แตะ Word จริงจะจบที่ error ตาม expected (FR-17: ใน browser ปกติ banner auto-save error โผล่หลัง ~30 วิ — ถูกต้อง; เส้นทางจริงไม่มี demo จะจบที่หน้า no-access เพราะอ่าน properties ไม่ได้) +components/wordaddin/TaskpaneApp.tsx ← state machine checking/no-access/untracked/tracking (ไม่มี login — ยกเลิก Keycloak 2026-10-27: detect อ่าน ticket_data/HmacSha256 จากไฟล์ผ่าน signInWithTicket ไม่ผ่าน = no-access แยกข้อความตามสาเหตุ · AuthRequiredError จาก flow ก็ไป no-access) + handler ทุกตัว พอร์ตจาก App.tsx ต้นฉบับ (เปลี่ยนแค่ JSX → Genesis + ถอดหน้า login/ปุ่มออกจากระบบ — header เหลือ chip username เฉย ๆ) · SaveControls/MessageBar/Spinner/ConfirmVersionDialog(portal แบบ AnnotationSidebar)/VersionHistoryPanel · **2 แท็บ (Versioning / เครื่องมือ Template — toggle `aria-pressed` เฉพาะ phase untracked|tracking, 2026-10-19): แท็บ template = TemplateToolsPanel (สแกน CC/กรอกค่าทดสอบ/แทรกย่อหน้า-ตัวแบ่ง — spec ที่ docs/addin-ui-flow.md §10)** components/summary/SummaryExplorer.tsx ← client root ของหน้าสรุป (redesign 2026-09-24) — state ตัวกรอง `FacetFilterState` จากแผงกลาง explorer + กรองใน memory + facet count/static users derive เอง + มิติ "หน้า" เป็นตัวเลือกแบบ single-select เฉพาะหน้าที่มีรายการ ≥1 เรียงน้อย→มาก (`optionsScroll` ให้ scroll ภายในกลุ่ม max-h-64 กันหน้าเยอะดันกลุ่มอื่นออกจอ) + layout 2 คอลัมน์ (มือถือ < lg ตัวกรองหุบเป็น `
`, desktop aside sticky 15rem — pattern เดียวกับ GroupExplorer; คอลัมน์ content ครอบด้วย `
` ไม่ใช่ `
` เพราะกฎ print break-inside ของ `main.summary-page section` มุ่งการ์ดรายหน้าข้างใน) components/summary/SummaryList.tsx ← คอลัมน์ content ของหน้าสรุป — การ์ดรายหน้า "1 หน้า 1 การ์ด" หัวการ์ด sticky ระดับ viewport (เลขหน้า + บรรทัดสรุปหน้า `pageSummaryLine` **คำนวณจากรายการที่เห็นจริงหลังกรอง** + ปุ่ม "เปิดหน้านี้"; กลับเป็น position static ตอนพิมพ์ผ่านกฎ `.page-head` ใน globals.css) + แถว passive จุดคลิกเดียวคือปุ่ม `` "View" เหมือน GroupList (deep link `?ann=`/`?page=` — bookmark ไปหน้า, annotation ไปรายการ; meta line ไม่มี segment ไฟล์เพราะไฟล์เดียวทั้งหน้า) + header "พบ N รายการ" (aria-live) + ปุ่ม "ล้างตัวกรอง" (เฉพาะมีตัวกรอง active) + empty state กรองจนไม่เหลือ + **ตอนพิมพ์แสดงฉบับเต็มเสมอ** — ตัวกรองที่ตั้งค้างต้องไม่ตัดรายการออกเงียบ ๆ บนกระดาษ: ตอน activeCount > 0 render ชุดบนจอ (print:hidden) + ชุดเต็ม (hidden print:block, ไม่มี id/aria-labelledby ซ้ำ) แยกกัน; anchor `#page-N` ของ section คงจาก design เดิมให้ลิงก์เก่ายังใช้ได้ components/pdf/PDFViewer.tsx ← client root (tool state, zoom, selection, lazy render หน้า) diff --git a/app/api/documents/token/route.ts b/app/api/documents/token/route.ts new file mode 100644 index 0000000..2173fe2 --- /dev/null +++ b/app/api/documents/token/route.ts @@ -0,0 +1,97 @@ +// PLAN-DOCVER.md §auth — POST /api/documents/token ออก access_token ของกลุ่ม docver +// ทางเข้า 2 ทาง (PLAN-ADDIN-AUTH.md §3 — header x-api-key เป็นตัวตั้ง): +// 1) e-Court server-to-server: header "x-api-key" เทียบ env DOCVER_API_KEY +// (fail closed เมื่อ env ไม่ตั้ง/ว่าง) + body claims ตรง ๆ (เดิมทุกอย่าง) +// 2) add-in ใน Word: ไม่มี x-api-key + body {ticket_data, HmacSha256} — server +// ตรวจ HMAC+exp ด้วย env ฝั่ง server (ADDIN_TICKET_SECRET → SECRET → +// "super_secret", lib/addin-ticket.ts) แล้วออก token จาก claims ของ ticket +// (secret ตัวเซ็น JWT ไม่มีทางไปอยู่ใน bundle ของ add-in) +// ทั้งสองทางออก JWT HS256 เซ็นด้วย env DOCVER_TOKEN_SECRET อายุตาม env +// DOCVER_TOKEN_TTL_SECONDS (default 3600) แล้วนำไปแนบ Authorization: Bearer กับ +// endpoint อื่นของกลุ่ม (lib/docver-token.ts) · segment คงที่ "token" ไม่ชน [docId] +// (Next ให้ static ชนะ) และ middleware ยกเว้น api/documents/* อยู่แล้ว +import { docverError } from "@/lib/document-versioning"; +import { + addinTicketSecret, + parseTicketTokenBody, + ticketToDocverClaims, + verifyAddinTicket, +} from "@/lib/addin-ticket"; +import { + issueDocverToken, + parseTokenRequestBody, + requireDocverApiKey, + type DocverTokenClaims, +} from "@/lib/docver-token"; + +export const runtime = "nodejs"; +export const dynamic = "force-dynamic"; + +/** 401 ของทางเข้า ticket — ข้อความเดียวทุกสาเหตุ (HMAC ผิด/รูปผิด/หมดอายุ/ไม่ส่งมา) กัน oracle */ +const TICKET_DENIED = "ticket ไม่ถูกต้องหรือหมดอายุ"; + +export async function POST(request: Request) { + return request.headers.get("x-api-key") !== null + ? postWithApiKey(request) + : postWithTicket(request); +} + +/** ทางเข้า 1 (เดิม) — e-Court server-to-server */ +async function postWithApiKey(request: Request): Promise { + const apiKeyFail = requireDocverApiKey(request); + if (apiKeyFail !== null) return apiKeyFail; + + let raw: unknown; + try { + raw = await request.json(); + } catch { + return docverError("body ต้องเป็น JSON", 400); + } + const parsed = parseTokenRequestBody(raw); + if (!parsed.ok) return docverError(parsed.error, 400); + return issueToken(parsed.claims); +} + +/** ทางเข้า 2 — add-in ส่ง ticket ที่ e-Court stamp มากับไฟล์ */ +async function postWithTicket(request: Request): Promise { + let raw: unknown; + try { + raw = await request.json(); + } catch { + return docverError("body ต้องเป็น JSON", 400); + } + const parsed = parseTicketTokenBody(raw); + if (!parsed.ok) { + // missing = ไม่มี ticket มาเล่น ๆ (401 เดียวกับตอน verify ไม่ผ่าน) + // invalid = รูป body ผิดจริง ๆ ให้ 400 ตาม convention กัน typo เงียบ ๆ + return docverError(parsed.error, parsed.kind === "invalid" ? 400 : 401); + } + const verified = verifyAddinTicket(parsed.ticketData, parsed.hmacHex, addinTicketSecret()); + if (!verified.ok) return docverError(TICKET_DENIED, 401); + return issueToken(ticketToDocverClaims(verified.ticket)); +} + +/** ออก JWT ของ claims ที่ผ่านการยืนยันแล้วจากทั้งสองทาง — ส่วนกลาง */ +async function issueToken(claims: DocverTokenClaims): Promise { + // ความผิด config ฝั่ง server ไม่ใช่ความผิดของผู้เรียก — ไม่ตั้ง = 500 (ห้าม log ค่า secret) + const secret = process.env.DOCVER_TOKEN_SECRET?.trim(); + // const secret = + // "487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e"; + + if (secret === undefined || secret === "") { + return docverError("DOCVER_TOKEN_SECRET ยังไม่ถูกตั้งค่า", 500); + } + const ttlRaw = Number(process.env.DOCVER_TOKEN_TTL_SECONDS); + const ttlSeconds = + Number.isFinite(ttlRaw) && ttlRaw > 0 ? Math.floor(ttlRaw) : 3600; + + const accessToken = issueDocverToken(claims, secret, ttlSeconds); + return new Response( + JSON.stringify({ + access_token: accessToken, + token_type: "Bearer", + expires_in: ttlSeconds, + }), + { headers: { "content-type": "application/json; charset=utf-8" } }, + ); +} diff --git a/app/api/documents/[docId]/versions/[versionId]/download-link/route.ts b/app/api/documents/versions/[versionId]/download-link/route.ts similarity index 65% rename from app/api/documents/[docId]/versions/[versionId]/download-link/route.ts rename to app/api/documents/versions/[versionId]/download-link/route.ts index 0b91a6c..b97ce00 100644 --- a/app/api/documents/[docId]/versions/[versionId]/download-link/route.ts +++ b/app/api/documents/versions/[versionId]/download-link/route.ts @@ -1,12 +1,13 @@ -// PLAN-DOCVER.md §1 — GET /api/documents/{docId}/versions/{versionId}/download-link?format=docx|pdf +// PLAN-DOCVER.md §1 — GET /api/documents/versions/{versionId}/download-link?format=docx|pdf // คืน presigned URL อายุสั้น (env DOCVER_LINK_TTL_SECONDS) ให้ UI เปิดในเบราว์เซอร์จริง -// ของผู้ใช้ — เช็คทั้ง docId และ versionId พร้อมกันกันโยน id ข้ามเอกสาร +// ของผู้ใช้ — เช็ค docId (จาก fid ใน token) กับ versionId คู่กันกันโยน id ข้ามเอกสาร +// auth: Authorization: Bearer (access_token จาก POST /api/documents/token — ทุก endpoint ของกลุ่ม) import { docverError, - parseDocId, parseDownloadFormat, parseVersionIdParam, } from "@/lib/document-versioning"; +import { requireDocverBearer } from "@/lib/docver-token"; import { findVersionForDoc, presignVersionUrl } from "@/lib/docver-store"; export const runtime = "nodejs"; @@ -14,10 +15,13 @@ export const dynamic = "force-dynamic"; export async function GET( request: Request, - { params }: { params: { docId: string; versionId: string } }, + { params }: { params: { versionId: string } }, ) { - const docId = parseDocId(params.docId); - if (!docId.ok) return docverError(docId.error, 400); + const auth = requireDocverBearer(request); + if (!auth.ok) return auth.response; + + // docId มาจาก fid ใน token — claim ถูกบังคับเป็น string ไม่ว่างตั้งแต่ขอ token + verify + const docId = auth.claims.fid; const versionId = parseVersionIdParam(params.versionId); if (!versionId.ok) return docverError(versionId.error, 400); let format: string | null = null; @@ -30,7 +34,7 @@ export async function GET( if (!parsedFormat.ok) return docverError(parsedFormat.error, 400); try { - const row = await findVersionForDoc(docId.docId, versionId.versionId); + const row = await findVersionForDoc(docId, versionId.versionId); if (!row) { return docverError("ไม่พบ version นี้ของเอกสาร", 404); } diff --git a/app/api/documents/[docId]/versions/route.ts b/app/api/documents/versions/route.ts similarity index 81% rename from app/api/documents/[docId]/versions/route.ts rename to app/api/documents/versions/route.ts index d022100..79dcc2b 100644 --- a/app/api/documents/[docId]/versions/route.ts +++ b/app/api/documents/versions/route.ts @@ -1,6 +1,9 @@ -// PLAN-DOCVER.md §1 — POST อัปโหลด version ใหม่ + GET history ของ /api/documents/{docId}/versions -// กลุ่ม API stand-alone ไม่มี auth (เปิดกว้างเหมือน api/template — intranet) — ผู้เรียกบอก -// identity เองผ่าน field userId/userName เพราะไม่มี session ร่วมกับใคร +// PLAN-DOCVER.md §1 — POST อัปโหลด version ใหม่ + GET history ของ /api/documents/versions +// กลุ่ม API stand-alone ไม่มี session — auth ด้วย access_token ของกลุ่มนี้: ขอที่ +// POST /api/documents/token (ยืนยัน x-api-key กับ env DOCVER_API_KEY) แล้วแนบ +// Authorization: Bearer ทุก request — identity (userid/username), templateId และ +// docId (= fid — fileId ของ e-Court, string) แกะจาก claims ของ token ทั้งหมด +// ไม่รับจาก URL/form อีก (lib/docver-token.ts) import { createHash, randomUUID } from "node:crypto"; import { toDocumentVersionDTO } from "@/db/schema"; @@ -10,10 +13,10 @@ import { DOCX_CONTENT_TYPE, isDocxBytes, isPdfBytes, - parseDocId, parseVersionUploadForm, sanitizeFilePartName, } from "@/lib/document-versioning"; +import { requireDocverBearer } from "@/lib/docver-token"; import { findDocumentByDocId, insertVersionRecord, @@ -27,13 +30,16 @@ export const runtime = "nodejs"; export const dynamic = "force-dynamic"; /** POST — อัปโหลด version ใหม่ (เอกสารสร้างแบบ implicit ถ้าเป็น version แรก) - * ลำดับ: validate text field ก่อนแตะไฟล์ → cap ขนาดก่อน buffer → magic bytes → + * ลำดับ: Bearer token → validate text field ก่อนแตะไฟล์ → cap ขนาดก่อน buffer → magic bytes → * putObject MinIO → insert DB (tx) — DB ล้ม = เก็บกวาด object (pattern N4) * response = UploadVersionResult เป๊ะ โดย versionNumber เป็นค่า authoritative * จาก server (client เดา latest+1 แล้วแก้เองเมื่ออัปโหลดชนกัน) */ -export async function POST(request: Request, { params }: { params: { docId: string } }) { - const docId = parseDocId(params.docId); - if (!docId.ok) return docverError(docId.error, 400); +export async function POST(request: Request) { + const auth = requireDocverBearer(request); + if (!auth.ok) return auth.response; + + // docId มาจาก fid ใน token — claim ถูกบังคับเป็น string ไม่ว่างตั้งแต่ขอ token + verify + const docId = auth.claims.fid; let form: FormData; try { @@ -109,19 +115,19 @@ export async function POST(request: Request, { params }: { params: { docId: stri try { row = await insertVersionRecord({ versionId, - docId: docId.docId, + docId, clientVersionId: parsed.form.clientVersionId, contentHash, message: parsed.form.message, fields: parsed.form.fields, - templateId: parsed.form.templateId, + templateId: auth.claims.template, fileName: docxDisplayName, docxObjectKey: keys.docx, pdfObjectKey: pdfBytes ? keys.pdf : null, docxSize: docxBytes.length, pdfSize: pdfBytes?.length ?? null, - userId: parsed.form.userId, - userName: parsed.form.userName, + userId: auth.claims.userid, + userName: auth.claims.username, }); } catch (err) { // DB ล้มหลังเขียน object — เก็บกวาดก่อนตอบ กัน object กำพร้าไม่มี row ชี้ @@ -142,12 +148,14 @@ export async function POST(request: Request, { params }: { params: { docId: stri /** GET — history ของเอกสาร (ใหม่ → เก่า) · docId ที่ยังไม่เคยมี version = 404 * (สัญญาณ REST ตรง ๆ แบบ N10 — UI ฝั่ง add-in แสดง error + ปุ่มลองใหม่ ไม่พัง) */ -export async function GET(_request: Request, { params }: { params: { docId: string } }) { - const docId = parseDocId(params.docId); - if (!docId.ok) return docverError(docId.error, 400); +export async function GET(request: Request) { + const auth = requireDocverBearer(request); + if (!auth.ok) return auth.response; + + const docId = auth.claims.fid; try { - const doc = await findDocumentByDocId(docId.docId); + const doc = await findDocumentByDocId(docId); if (!doc) { return docverError("ไม่พบเอกสารนี้ในระบบ (ยังไม่เคยอัปโหลด version)", 404); } diff --git a/app/api/template/download-docx/route.ts b/app/api/template/download-docx/route.ts new file mode 100644 index 0000000..f7e8017 --- /dev/null +++ b/app/api/template/download-docx/route.ts @@ -0,0 +1,109 @@ +// ตัวอย่างรองรับค่าจาก Frontend ที่เป็น Vanilla JavaScript และ Classic Framework +// โดย ผ่าน Form หรือ การกดลิงค์(GET) เปลี่ยนหน้าเพื่อดาว์นโหลดไฟล์ +// จะมีข้อมูล info.ticket_data ที่สมบูรณ์แล้ว({fid,tid,uid,uname})แล้วเเรียก /api/template/generate เพื่อสร้างเอกสาร docx +import { NextRequest, NextResponse } from 'next/server'; +import path from 'path'; +import fs from 'fs/promises'; + +const DOCEDIT_BASE_URL = process.env.DOCEDIT_BASE_URL??""; +const EXTERNAL_API_KEY = process.env.EXTERNAL_API_KEY??""; +const TMPL_PATH = process.env.TMPL_PATH??""; +if (!DOCEDIT_BASE_URL||!EXTERNAL_API_KEY||!TMPL_PATH) { + console.error('Missing variable DOCEDIT_BASE_URL, EXTERNAL_API_KEY or TMPL_PATH') +} + +// console.log("download-docx env",DOCEDIT_BASE_URL,EXTERNAL_API_KEY,TMPL_PATH) + +async function processRequest(fid: string,tid:string,uid:string,uname:string):Promise> +{ + // console.log("processRequest get:",fid,tid,uid,uname) + // console.log(process.cwd()) + const filePath = path.join(TMPL_PATH,`${fid}.json`); + try { + if (!fid||!tid||!uid||!uname) { + return NextResponse.json({ error: 'Missing fid, tid, uid or uname' }, { status: 400 }); + } + + // อ่านไฟล์ JSON จำลองการอ่านจากฐานข้อมูล + const rawJson = await fs.readFile(filePath, 'utf-8'); + const jsonData = JSON.parse(rawJson); + if (!jsonData || typeof jsonData !== 'object' ) { + return NextResponse.json({error:'Invalid data format'}, { status: 400 }); + } + + //!! ตรวจสอบสิทธิ์ผู้ใช้ uid ว่ามีสิทธิ์เข้าถึงไฟล์ fid หรือไม่เพื่อกันการการยิง API ตรงๆ ไม่ผ่าน Frontend!! + + // ข้อมูลจำเป็นต้องมี prop นี้เสมอถ้าไม่มีให้สร้าง jsonData.info.ticket_data + if(!Object.hasOwn(jsonData, 'info')) + jsonData['info']={} + jsonData.info['ticket_data'] = JSON.stringify({fid,tid,uid,uname}) + // sign เองตรงนี้ให้อยู่ในรูปแบบ data.info={ticket_data,HmacSha256,Ed25519} หรือว่างไว้ให้ docedit สร้างให้ + + //ยิงไปหาระบบ Docedit เพื่อเอา Stream + // console.log(`fetch ${DOCEDIT_BASE_URL}/api/template/generate`) + const docxResponse = await fetch(`${DOCEDIT_BASE_URL}/api/template/generate`, { + method: 'POST', + headers: { + 'Content-Type': 'application/json', + 'x-api-key': EXTERNAL_API_KEY, + }, + body: JSON.stringify(jsonData), + }); + + // เช็ค Content-Type และ Status ก่อน + const contentType = docxResponse.headers.get('content-type') || ''; + + if (!docxResponse.ok || contentType.includes('text/html')) { + const errorText = await docxResponse.text(); + console.error('download-docx:Invalid docx Response:', errorText); + + return NextResponse.json( + {error:`Error from docedit generate: Expected docx stream but received ${contentType} (Status ${docxResponse.status})`}, + { status: 502 } + ); + } + + // 2. ดึง ReadableStream โดยตรงจาก Response ของระบบ + const stream = docxResponse.body; + + // 3. ส่ง Binary Stream กลับไปยัง Browser พร้อม Header กำหนดประเภทไฟล์ + const download_file = `${fid}_${uid}_xxx` + return new NextResponse(stream as unknown as BodyInit, { + status: 200, + headers: { + 'Content-Type': + 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', + 'Content-Disposition': `attachment; filename="${encodeURIComponent(download_file)}.docx"`, + 'Cache-Control': 'no-store, max-age=0', + }, + }); + } catch (error:any) { + if ( error.code === 'ENOENT') { + return NextResponse.json( + { error: `Data not found: ${filePath}`}, + { status: 404 } + ); + } + console.error(error) + return NextResponse.json({error:'Internal Server Error'}, { status: 500 }); + } +} + +export async function GET(request: NextRequest) +{ + const searchParams = request.nextUrl.searchParams; + const fid = searchParams.get('fid') || ''; + const tid = searchParams.get('tid') || ''; + const uid = searchParams.get('uid') || ''; + const uname = searchParams.get('uname') || ''; + return await processRequest(fid,tid,uid,uname) +} + +export async function POST(request: NextRequest) { + const formData = await request.formData(); + const fid = String(formData.get('fid')) + const tid = String(formData.get('tid')) + const uid = String(formData.get('uid')) + const uname = String(formData.get('uname')) + return await processRequest(fid,tid,uid,uname) +} \ No newline at end of file diff --git a/app/api/template/extract/route.ts b/app/api/template/extract/route.ts index dc5b49c..12108b7 100644 --- a/app/api/template/extract/route.ts +++ b/app/api/template/extract/route.ts @@ -1,7 +1,7 @@ import { NextResponse } from "next/server"; -import { extractContentControls } from "../lib-tmpl"; - -export const runtime = "nodejs"; +import { extractContentControls, extractBookmark, templateContentControls, setCustomDocProps, getDocProps,templateDynamicContents } from "@/lib/lib-tmpl"; +import { verifyEd25519, verifyHmacSha256 } from "@/lib/lib-utils"; +// export const runtime = "nodejs"; const DOCX_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; @@ -14,24 +14,14 @@ export async function POST(request: Request) { try { const formData = await request.formData(); const file = formData.get("file"); + const TEST_SECRET = String(formData.get("secret") ?? ""); + const TEST_PUBLIC_KEY_HEX = String(formData.get("public_key") ?? ""); - if (!(file instanceof File)) { - return NextResponse.json( - { - success: false, - error: 'Missing DOCX file in field "file".', - }, - { status: 400 }, - ); - } - - if ( - file.type !== DOCX_CONTENT_TYPE && - !file.name.toLowerCase().endsWith(".docx") + if (!(file instanceof File) || + (file.type !== DOCX_CONTENT_TYPE && !file.name.toLowerCase().endsWith(".docx") ) ) { return NextResponse.json( { - success: false, error: 'Field "file" must be a .docx file.', }, { status: 400 }, @@ -41,7 +31,6 @@ export async function POST(request: Request) { if (file.size > MAX_UPLOAD_BYTES) { return NextResponse.json( { - success: false, error: 'Field "file" exceeds the 100MB size limit.', }, { status: 400 }, @@ -52,18 +41,36 @@ export async function POST(request: Request) { const buffer = Buffer.from(await file.arrayBuffer()); // ใช้ lib-tmpl.ts เดิม - const data = extractContentControls(buffer); + // const data = extractContentControls(buffer); - return NextResponse.json({ - success: true, - data, - }); + const cc = extractContentControls(buffer); + const bookmark = extractBookmark(buffer) + const properties = getDocProps(buffer) + let verify: Record ={} + const ticket_data = properties?.custom?.ticket_data + const HmacSha256 = String(properties?.custom?.HmacSha256) + const Ed25519 = String(properties?.custom?.Ed25519) + + if(ticket_data && typeof ticket_data === 'string'){ + const ticketDataObj= JSON.parse(ticket_data) + const unix_timestamp = Number(ticketDataObj.exp)*1000 + if(unix_timestamp){ + verify['exp'] = new Date(unix_timestamp).toLocaleString("th-TH", { timeZone: "Asia/Bangkok" }) + } + if(TEST_SECRET && HmacSha256){ + verify['HmacSha256'] = verifyHmacSha256(ticket_data,TEST_SECRET,HmacSha256) + } + if(TEST_PUBLIC_KEY_HEX&& Ed25519){ + verify["Ed25519"]=verifyEd25519(ticket_data,Ed25519,TEST_PUBLIC_KEY_HEX) + } + } + + let returnData : Record = {cc,bookmark,properties,verify} + return NextResponse.json(returnData); } catch (error) { console.error(error); - return NextResponse.json( { - success: false, error: error instanceof Error ? error.message diff --git a/app/api/template/generate/route.ts b/app/api/template/generate/route.ts new file mode 100644 index 0000000..7b0f506 --- /dev/null +++ b/app/api/template/generate/route.ts @@ -0,0 +1,104 @@ +// สร้าง docx จาก json +// - json.info.ticket_data จะมี tid ให้โหลดไฟล์ template นี้มาใช้ +// - สร้าง signature/hash จาก json.info.ticket_data + +import { NextRequest, NextResponse } from 'next/server'; +import {readFile} from 'fs/promises'; +import path from 'path'; +import {DocumentTemplate,applyTemplate} from "@/lib/lib-tmpl"; +const EXTERNAL_API_KEY = process.env.EXTERNAL_API_KEY || 'secret-api-key-1234'; +const TMPL_PATH = process.env.TMPL_PATH || '' +const PRIVATE_KEY_HEX = process.env.PRIVATE_KEY_HEX ||'' +const SECRET = process.env.SECRET || '' +const TICKET_SEC = Number(process.env.TICKET_SEC||'300') + +if (!EXTERNAL_API_KEY || !TMPL_PATH || !PRIVATE_KEY_HEX || !SECRET) + console.log("api/template/generate: require EXTERNAL_API_KEY, TMPL_PATH and PRIVATE_KEY_HEX") + +// console.log("generate env:",EXTERNAL_API_KEY,TMPL_PATH,PRIVATE_KEY_HEX,SECRET) + + +export async function POST(request: NextRequest) { + // 1. ตรวจสอบ API Key จาก HTTP Header (x-api-key) + const apiKey = request.headers.get('x-api-key'); + + if (!apiKey || apiKey !== EXTERNAL_API_KEY) { + return NextResponse.json( + { error: 'Unauthorized: Invalid API Key' }, + { status: 401 } + ); + } + + try { + // รับข้อมูล JSON Payload + const templateData:DocumentTemplate = (await request.json()); + // console.log(templateData) + // ต้องมี templateData.info.ticket_data เป็น json string เสมอ + if (!templateData || !templateData.info || + !templateData.info.ticket_data || + typeof templateData.info.ticket_data !== "string" + ) { + return NextResponse.json( + { + error: "template/generate json.info.ticket_data not avaliable", + }, + { status: 400 }, + ); + } + const ticketObj = JSON.parse(templateData.info.ticket_data) + const tid = String(ticketObj.tid) + const fid = String(ticketObj.fid) + const uid = String(ticketObj.uid) + if(!tid||!fid||!uid) + { + return NextResponse.json( + { + error: "template/generate require json.info.ticket_data.(fid|tid|uid)", + }, + { status: 400 }, + ); + } + + + //เปิดไฟล์ template + const tmplPath = path.join(TMPL_PATH, `${tid}.docx`); + let templateBuffer: Buffer = await readFile(tmplPath) + + const output = await applyTemplate(templateBuffer, templateData, SECRET, PRIVATE_KEY_HEX, TICKET_SEC); + + // สร้าง ReadableStream ของไฟล์ .docx + // ในโค้ดจริง ส่วนนี้จะดึง Binary Buffer จาก Library เช่น docx, docxtemplater หรืออ่านจาก File System + // const encoder = new TextEncoder(); + + const docxStream = new ReadableStream({ + start(controller) { + controller.enqueue(output); + controller.close(); + }, + }); + + // 4. ส่ง Return เป็น Response พร้อม Stream และ Headers กำหนด MIME type ของ MS Word + const dlFileName = encodeURIComponent(`${tid}_${fid}_${uid}XX`) + return new NextResponse(docxStream, { + status: 200, + headers: { + 'Content-Type': + 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', + 'Content-Disposition': `attachment; filename="${dlFileName}.docx"`, + 'Cache-Control': 'no-store, max-age=0', + }, + }); + } catch (error:any) { + if ( error.code === 'ENOENT') { + return NextResponse.json( + { error: 'NotFound: Invalid template ID or incorrect storage path'}, + { status: 404 } + ); + } + console.error('Error generating docx:', error); + return NextResponse.json( + { error: 'Failed to generate document payload'}, + { status: 500 } + ); + } +} \ No newline at end of file diff --git a/app/api/template/lib-tmpl.ts b/app/api/template/lib-tmpl.ts deleted file mode 100644 index 2c15f52..0000000 --- a/app/api/template/lib-tmpl.ts +++ /dev/null @@ -1,518 +0,0 @@ -import PizzaZip from "pizzip"; -import { - DOMParser, - XMLSerializer, - type Document as XmlDocument, - type Element as XmlElement, - type Node as XmlNode, - type Attr as XmlAttr, -} from "@xmldom/xmldom"; -import xpath from "xpath"; - -export interface ExtractedData { - [tagName: string]: string; -} - -const W_NS = - "http://schemas.openxmlformats.org/wordprocessingml/2006/main"; - -const asXpathNode = (node: XmlNode): globalThis.Node => - node as unknown as globalThis.Node; - -function createSelector() { - return xpath.useNamespaces({ w: W_NS }); -} - -/** - * อ่าน Content Control (w:sdt) จาก DOCX Buffer - * ปัจจุบันอ่านจาก word/document.xml ตาม logic ของโค้ดต้นฉบับ - */ -export function extractContentControls( - docxBuffer: Buffer, -): ExtractedData { - const zip = new PizzaZip(docxBuffer); - const docXmlFile = zip.file("word/document.xml"); - - if (!docXmlFile) { - throw new Error("Invalid docx file: word/document.xml not found."); - } - - const parser = new DOMParser(); - const doc = parser.parseFromString(docXmlFile.asText(), "text/xml"); - const select = createSelector(); - const result: ExtractedData = {}; - - const sdtNodes = select( - "//w:sdt", - asXpathNode(doc), - ) as unknown as XmlElement[]; - - sdtNodes.forEach((sdt) => { - const tagAttr = select( - "./w:sdtPr/w:tag/@w:val", - asXpathNode(sdt), - true, - ) as unknown as XmlAttr | undefined; - - const tagName = tagAttr?.value; - - if (!tagName) return; - - const sdtContent = select( - "./w:sdtContent", - asXpathNode(sdt), - true, - ) as unknown as XmlElement | undefined; - - if (!sdtContent) { - result[tagName] = ""; - return; - } - - const nodes = select( - ".//w:p | .//w:t | .//w:tab | .//w:br | .//w:noBreakHyphen | .//w:softHyphen | .//w:sym", - asXpathNode(sdtContent), - ) as unknown as XmlElement[]; - - let extractedText = ""; - - nodes.forEach((node) => { - switch (node.nodeName) { - case "w:p": - if ( - extractedText.length > 0 && - !extractedText.endsWith("\n") - ) { - extractedText += "\n"; - } - break; - - case "w:t": - extractedText += node.textContent || ""; - break; - - case "w:tab": - extractedText += "\t"; - break; - - case "w:br": - extractedText += "\n"; - break; - - case "w:noBreakHyphen": - extractedText += "\u2011"; - break; - - case "w:softHyphen": - extractedText += "\u00ad"; - break; - - case "w:sym": { - const charAttr = node.getAttribute("w:char"); - if (charAttr) { - const charCode = Number.parseInt(charAttr, 16); - extractedText += String.fromCharCode(charCode); - } - break; - } - } - }); - - result[tagName] = extractedText; - }); - - return result; -} - -type SdtControlType = "plain" | "rich" | "other"; -type SdtStructure = "block" | "inline"; - -function detectSdtControlType( - sdt: XmlElement, - select: xpath.XPathSelect, -): { type: SdtControlType; multiLine: boolean } { - const sdtPr = select( - "./w:sdtPr", - asXpathNode(sdt), - true, - ) as unknown as XmlElement | undefined; - - if (!sdtPr) { - return { type: "other", multiLine: false }; - } - - const textEl = select( - "./w:text", - asXpathNode(sdtPr), - true, - ) as unknown as XmlElement | undefined; - - if (textEl) { - const multiLineAttr = select( - "./@w:multiLine", - asXpathNode(textEl), - true, - ) as unknown as XmlAttr | undefined; - - return { - type: "plain", - multiLine: - multiLineAttr?.value === "1" || - multiLineAttr?.value === "true", - }; - } - - const richTextEl = select( - "./w:richText", - asXpathNode(sdtPr), - true, - ) as unknown as XmlElement | undefined; - - if (richTextEl) { - return { type: "rich", multiLine: true }; - } - - const otherTypeTags = [ - "w:date", - "w:dropDownList", - "w:comboBox", - "w:checkbox", - "w:citation", - "w:group", - "w:docPartObj", - "w:docPartList", - ]; - - for (const tag of otherTypeTags) { - const found = select( - `./${tag}`, - asXpathNode(sdtPr), - true, - ) as unknown as XmlElement | undefined; - - if (found) { - return { type: "other", multiLine: false }; - } - } - - return { type: "rich", multiLine: true }; -} - -function detectSdtStructure( - sdtContent: XmlElement, - select: xpath.XPathSelect, -): SdtStructure { - const directP = select( - "./w:p", - asXpathNode(sdtContent), - ) as unknown as XmlElement[]; - - return directP.length > 0 ? "block" : "inline"; -} - -function buildRunChildren( - doc: XmlDocument, - text: string, -): XmlElement[] { - const nodes: XmlElement[] = []; - const tokens = text.split(/(\t|\n)/); - - tokens.forEach((token) => { - if (token === "") return; - - if (token === "\t") { - nodes.push(doc.createElementNS(W_NS, "w:tab")); - } else if (token === "\n") { - nodes.push(doc.createElementNS(W_NS, "w:br")); - } else { - const t = doc.createElementNS(W_NS, "w:t"); - t.setAttribute("xml:space", "preserve"); - t.textContent = token; - nodes.push(t); - } - }); - - if (nodes.length === 0) { - const t = doc.createElementNS(W_NS, "w:t"); - t.setAttribute("xml:space", "preserve"); - t.textContent = ""; - nodes.push(t); - } - - return nodes; -} - -function buildRun( - doc: XmlDocument, - text: string, - rPr?: XmlElement, -): XmlElement { - const run = doc.createElementNS(W_NS, "w:r"); - - if (rPr) { - run.appendChild(rPr.cloneNode(true)); - } - - buildRunChildren(doc, text).forEach((node) => - run.appendChild(node), - ); - - return run; -} - -function insertInlineContent( - doc: XmlDocument, - sdtContent: XmlElement, - select: xpath.XPathSelect, - text: string, - allowLineBreak: boolean, -): void { - const safeText = allowLineBreak - ? text - : text.replace(/\n/g, " "); - - const existingRuns = select( - "./w:r", - asXpathNode(sdtContent), - ) as unknown as XmlElement[]; - - const firstRPr = - existingRuns.length > 0 - ? (select( - "./w:rPr", - asXpathNode(existingRuns[0]), - true, - ) as unknown as XmlElement | undefined) - : undefined; - - existingRuns.forEach((r) => { - if (r.parentNode) r.parentNode.removeChild(r); - }); - - sdtContent.appendChild( - buildRun(doc, safeText, firstRPr), - ); -} - -function insertBlockContent( - doc: XmlDocument, - sdtContent: XmlElement, - select: xpath.XPathSelect, - text: string, - allowMultiParagraph: boolean, -): void { - const allParagraphs = select( - "./w:p", - asXpathNode(sdtContent), - ) as unknown as XmlElement[]; - - if (allParagraphs.length === 0) { - // ป้องกัน template ที่มีโครงสร้างผิดปกติ - const p = doc.createElementNS(W_NS, "w:p"); - sdtContent.appendChild(p); - allParagraphs.push(p); - } - - const firstP = allParagraphs[0]; - - const firstPPr = select( - "./w:pPr", - asXpathNode(firstP), - true, - ) as unknown as XmlElement | undefined; - - const firstRun = select( - "./w:r", - asXpathNode(firstP), - true, - ) as unknown as XmlElement | undefined; - - const firstRPr = firstRun - ? (select( - "./w:rPr", - asXpathNode(firstRun), - true, - ) as unknown as XmlElement | undefined) - : undefined; - - allParagraphs.forEach((p) => { - if (p !== firstP && p.parentNode) { - p.parentNode.removeChild(p); - } - }); - - const existingRuns = select( - "./w:r", - asXpathNode(firstP), - ) as unknown as XmlElement[]; - - existingRuns.forEach((r) => { - if (r.parentNode) r.parentNode.removeChild(r); - }); - - if (!allowMultiParagraph) { - firstP.appendChild(buildRun(doc, text, firstRPr)); - return; - } - - text.split("\n").forEach((line, index) => { - let targetP: XmlElement; - - if (index === 0) { - targetP = firstP; - } else { - targetP = doc.createElementNS(W_NS, "w:p"); - - if (firstPPr) { - targetP.appendChild(firstPPr.cloneNode(true)); - } - - sdtContent.appendChild(targetP); - } - - const run = doc.createElementNS(W_NS, "w:r"); - - if (firstRPr) { - run.appendChild(firstRPr.cloneNode(true)); - } - - buildRunChildren(doc, line).forEach((node) => - run.appendChild(node), - ); - - targetP.appendChild(run); - }); -} - -function insertFallbackContent( - sdtContent: XmlElement, - select: xpath.XPathSelect, - text: string, -): void { - const textNodes = select( - ".//w:t", - asXpathNode(sdtContent), - ) as unknown as XmlElement[]; - - if (textNodes.length === 0) return; - - textNodes[0].textContent = text; - - for (let i = 1; i < textNodes.length; i++) { - textNodes[i].textContent = ""; - } -} - -export type TemplateData = Record; - -function normalizeValue(value: unknown): string { - if (value === null || value === undefined) { - return ""; - } - - if (typeof value === "string") { - return value; - } - - if ( - typeof value === "number" || - typeof value === "boolean" || - typeof value === "bigint" - ) { - return String(value); - } - - // รองรับ JSON ที่ส่ง array/object มา แต่ Content Control ต้องการ text - return JSON.stringify(value); -} - -/** - * นำ JSON data ไปแทนค่า Content Control ใน DOCX template - * คืนค่าเป็น Buffer ของ DOCX ที่สร้างเสร็จแล้ว - */ -export function templateContentControls( - templateBuffer: Buffer, - data: TemplateData, -): Buffer { - const zip = new PizzaZip(templateBuffer); - const docXmlFile = zip.file("word/document.xml"); - - if (!docXmlFile) { - throw new Error("Invalid docx file: word/document.xml not found."); - } - - const parser = new DOMParser(); - const doc = parser.parseFromString(docXmlFile.asText(), "text/xml"); - const select = createSelector(); - - const sdtNodes = select( - "//w:sdt", - asXpathNode(doc), - ) as unknown as XmlElement[]; - - sdtNodes.forEach((sdt) => { - const tagAttr = select( - "./w:sdtPr/w:tag/@w:val", - asXpathNode(sdt), - true, - ) as unknown as XmlAttr | undefined; - - const tagName = tagAttr?.value; - - if (!tagName || !Object.prototype.hasOwnProperty.call(data, tagName)) { - return; - } - - const newValue = normalizeValue(data[tagName]); - - const sdtContent = select( - "./w:sdtContent", - asXpathNode(sdt), - true, - ) as unknown as XmlElement | undefined; - - if (!sdtContent) return; - - const { type: controlType, multiLine } = - detectSdtControlType(sdt, select); - - const structure = detectSdtStructure(sdtContent, select); - - if (controlType === "other") { - insertFallbackContent(sdtContent, select, newValue); - return; - } - - if (structure === "inline") { - const allowLineBreak = - controlType === "plain" ? multiLine : true; - - insertInlineContent( - doc, - sdtContent, - select, - newValue, - allowLineBreak, - ); - } else { - insertBlockContent( - doc, - sdtContent, - select, - newValue, - controlType === "rich", - ); - } - }); - - const serializer = new XMLSerializer(); - zip.file( - "word/document.xml", - serializer.serializeToString(doc), - ); - - return zip.generate({ - type: "nodebuffer", - compression: "DEFLATE", - }); -} diff --git a/app/api/template/render/route.ts b/app/api/template/render/route.ts index df6501c..c738afe 100644 --- a/app/api/template/render/route.ts +++ b/app/api/template/render/route.ts @@ -1,94 +1,71 @@ import { NextResponse } from "next/server"; -import { - templateContentControls, - type TemplateData, -} from "../lib-tmpl"; - +import { DocumentTemplate,applyTemplate} from "@/lib/lib-tmpl"; export const runtime = "nodejs"; + const DOCX_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; - // cap เดียวกับ N4 (app/actions/files.ts) — route นี้เปิดกว้างให้ภายนอกยิงได้ // ต้องเช็คขนาดก่อนอ่านเข้าหน่วยความจำ กัน DoS (bodySizeLimit ครอบเฉพาะ Server Actions) const MAX_UPLOAD_BYTES = 100 * 1024 * 1024; // 100MB +const TICKET_SEC = Number(process.env.TICKET_SEC||'300') export async function POST(request: Request) { try { const formData = await request.formData(); - const template = formData.get("template"); const dataFile = formData.get("data"); const dataJson = formData.get("dataJson"); + const TEST_SECRET = String(formData.get("secret")||"") + const TEST_PRIVATE_KEY_HEX = String(formData.get("private_key")||"") - // ----------------------------- // ตรวจสอบ Template - // ----------------------------- - if (!(template instanceof File)) { return NextResponse.json( { - success: false, error: 'Missing DOCX file in field "template".', }, { status: 400 }, ); } - if ( - template.type !== DOCX_CONTENT_TYPE && - !template.name.toLowerCase().endsWith(".docx") + if (template.type !== DOCX_CONTENT_TYPE && + !template.name.toLowerCase().endsWith(".docx") && + template.size > MAX_UPLOAD_BYTES ) { return NextResponse.json( { - success: false, - error: 'Field "template" must be a .docx file.', + error: 'Field "template" must be a .docx file and not exceeds the 100MB size limit.', }, { status: 400 }, ); } - if (template.size > MAX_UPLOAD_BYTES) { - return NextResponse.json( - { - success: false, - error: 'Field "template" exceeds the 100MB size limit.', - }, - { status: 400 }, - ); - } - // ----------------------------- // อ่าน JSON - // ----------------------------- - - let data: TemplateData; - + let templateData: DocumentTemplate; // JSON ผิด syntax เป็นความผิดของฝั่งผู้เรียก — คืน 400 ไม่ใช่ 500 // (catch กลางท้ายฟังก์ชันสงวนไว้ให้ error ของระบบเท่านั้น) try { if (typeof dataJson === "string" && dataJson.length > 0) { // กรณีส่ง JSON ผ่าน form field - data = JSON.parse(dataJson) as TemplateData; + templateData = JSON.parse(dataJson) as DocumentTemplate; } else if (dataFile instanceof File) { if (dataFile.size > MAX_UPLOAD_BYTES) { return NextResponse.json( { - success: false, error: 'Field "data" exceeds the 100MB size limit.', }, { status: 400 }, ); } - // กรณี upload data.json const text = await dataFile.text(); - data = JSON.parse(text) as TemplateData; + templateData = JSON.parse(text) as DocumentTemplate; } else { return NextResponse.json( { - success: false, error: 'Missing JSON data. Send either "data" file or "dataJson" field.', }, @@ -98,24 +75,20 @@ export async function POST(request: Request) { } catch (error) { return NextResponse.json( { - success: false, - error: `Invalid JSON data (${ - error instanceof Error ? error.message : "parse error" - }).`, + error: `Invalid JSON data (${error instanceof Error ? error.message : "parse error" + }).`, }, { status: 400 }, ); } - // JSON ต้องเป็น object if ( - data === null || - typeof data !== "object" || - Array.isArray(data) + templateData === null || + typeof templateData !== "object" || + Array.isArray(templateData) ) { return NextResponse.json( { - success: false, error: "JSON data must be an object.", }, { status: 400 }, @@ -126,31 +99,21 @@ export async function POST(request: Request) { // Template File → Buffer // ----------------------------- - const templateBuffer = Buffer.from( + let templateBuffer: Buffer = Buffer.from( await template.arrayBuffer(), ); - - // ----------------------------- - // ใช้ lib-tmpl.ts เดิม - // ----------------------------- - - const output = templateContentControls( - templateBuffer, - data, - ); + const output = await applyTemplate(templateBuffer,templateData,TEST_SECRET,TEST_PRIVATE_KEY_HEX,TICKET_SEC); // ----------------------------- // ส่ง DOCX กลับ // ----------------------------- - + if(templateData?.info?.ticket_data) return new NextResponse(output as BodyInit, { status: 200, headers: { "Content-Type": DOCX_CONTENT_TYPE, - "Content-Disposition": 'attachment; filename="generated-document.docx"', - "Content-Length": String(output.length), }, }); @@ -159,7 +122,7 @@ export async function POST(request: Request) { return NextResponse.json( { - success: false, + error: error instanceof Error ? error.message @@ -168,4 +131,5 @@ export async function POST(request: Request) { { status: 500 }, ); } -} \ No newline at end of file +} + diff --git a/app/api/template/test/T2.json b/app/api/template/test/T2.json deleted file mode 100644 index 799c36f..0000000 --- a/app/api/template/test/T2.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "notname": "คำสั่งเรียก ให้ทำคำให้การ", - "nottype": "(ต. ๑)", - "blackno": "คดีหมายเลขดำที่", - "blackyear": "๑๐/๒๕๖๙", - "redno": "คดีหมายเลขแดงที่", - "redyear": "", - "court": "ศาลปกครองสุพรรณบุรี", - "curdate": "วันที่ ๗ เดือน สิงหาคม พุทธศักราช ๒๕๖๙", - "accuser": "นายธัญวิสิษฐ์ ศรแก้ว", - "acc1": "ผู้ฟ้องคดี", - "accused": "เจ้าคุณมด ที่ ๑ กับพวกรวม ๓ คน", - "acc2": "ผู้ถูกฟ้องคดี", - "nottitle": "คำสั่งถึง", - "commto": "เจ้าคุณมด", - "groupname": "ผู้ถูกฟ้องคดีที่ ๑", - "detail1": "ด้วยผู้ฟ้องคดีได้ยื่นฟ้องผู้ถูกฟ้องคดีต่อศาล มีข้อความตามที่ปรากฏ ในระบบงานคดีปกครองอิเล็กทรอนิกส์\nฉะนั้น ให้ ท่านทำคำให้การแก้คำฟ้อง พร้อมด้วยพยานหลักฐาน ๑ ชุด ต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่งนี้", - "pname": "นางนพเก้า เถื่อนชัย", - "courtname": "ศาลปกครองสุพรรณบุรี", - "courtno": "๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี", - "courttam": "จังหวัดสุพรรณบุรี ๗๒๐๐๐", - "courttel": "กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓", - "courttel2": "สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน “๑๓๕๕”", - "sendto": "เจ้าคุณมด", - "addrno": "เลขที่ - หมู่ที่ - ตรอก/ซอย - ถนน - ตำบล/แขวง - อำเภอ/เขต - จังหวัด - โทรศัพท์ -", - "remarkhead": "", - "remark": "", - "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่าผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี" -} \ No newline at end of file diff --git a/app/api/template/test/Test.docx b/app/api/template/test/Test.docx deleted file mode 100644 index f078f00..0000000 Binary files a/app/api/template/test/Test.docx and /dev/null differ diff --git a/app/api/template/test/make-protected.mjs b/app/api/template/test/make-protected.mjs deleted file mode 100644 index c35f2b2..0000000 --- a/app/api/template/test/make-protected.mjs +++ /dev/null @@ -1,298 +0,0 @@ -// ทดลอง: เปิด Restrict Edit (readOnly + enforcement) และฝัง custom properties -// (token / primary-key / owner) ลงไฟล์ docx — ตามแนวทาง Token-Based ใน note.md -// -// ใช้: node app/api/template/test/make-protected.mjs [in.docx] [out.docx] -// ไม่ส่ง argument = อ่านและเขียนทับ output-T3.docx (ผล render ล่าสุด) -// -// สิ่งที่แก้ในไฟล์ docx: -// 1. word/settings.xml — w:documentProtection edit="readOnly" enforcement="1" -// (เอกสารทั้งฉบับอ่านอย่างเดียว — ทดสอบแล้ว: readOnly ล็อค CC ด้วย -// จึงต้องคู่กับข้อ 2 ถึงจะแก้ใน CC ได้) -// 2. word/document.xml ฯลฯ — ครอบ w:sdt ทุกตัวที่มี w:tag ด้วย -// w:permStart(w:edGrp="everyone") / w:permEnd — กลไก "Exceptions: Everyone" -// ของแผง Restrict Editing ใน Word (บริเวณใน perm แก้ได้ นอกนั้นล็อค) -// พร้อมเติม w:lock="sdtLocked" ให้ CC ที่ยังไม่มี กันลบช่องตอนอยู่ในโหมดนี้ -// 3. docProps/custom.xml — สร้างใหม่ เก็บค่า custom properties แบบ vt:lpwstr -// 4. [Content_Types].xml — เพิ่ม Override สำหรับ custom.xml -// 5. _rels/.rels — เพิ่ม Relationship ชี้ docProps/custom.xml -import PizzaZip from "pizzip"; -import { DOMParser, XMLSerializer } from "@xmldom/xmldom"; -import xpath from "xpath"; -import { readFileSync, writeFileSync } from "node:fs"; -import { fileURLToPath } from "node:url"; -import { dirname, join } from "node:path"; - -const __dirname = dirname(fileURLToPath(import.meta.url)); -const inPath = process.argv[2] ?? join(__dirname, "output-T3.docx"); -const outPath = process.argv[3] ?? inPath; - -// ตัวอย่างข้อมูลที่จะฝัง (ใน production จะมาจาก backend ตอน render เอกสาร) -const CUSTOM_PROPS = { - token: "eyJhbGciOiJIUzI1NiJ9.eyJ1aWQiOiJ1MTAwMSIsImZpZCI6IkRPTi0yMDI2LTAwMDEyMyIsImV4cCI6MTc5NjI0NzIwMH0.demo", - "primary-key": "DOC-2026-000123", - owner: "u1001", -}; - -const W_NS = "http://schemas.openxmlformats.org/wordprocessingml/2006/main"; -const CUSTOM_NS = - "http://schemas.openxmlformats.org/officeDocument/2006/custom-properties"; -const VT_NS = - "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes"; -const REL_CUSTOM = - "http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties"; -const CT_CUSTOM = - "application/vnd.openxmlformats-officedocument.custom-properties+xml"; -const FMTID = "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}"; - -const parser = new DOMParser(); -const serializer = new XMLSerializer(); - -const parseXml = (text) => parser.parseFromString(text, "text/xml"); - -// xmldom serializer อาจคง xml declaration ไว้แล้ว — เติมเฉพาะเมื่อยังไม่มี -// (ถ้า prepend ซ้ำจะได้ declaration สองอัน ไฟล์ XML invalid) -const serialize = (doc) => { - const text = serializer.serializeToString(doc); - return text.startsWith("\r\n' + text; -}; - -// ครอบ w:sdt ที่มี w:tag ทุกตัวด้วย w:permStart/w:permEnd (edGrp="everyone") -// และเติม w:lock="sdtLocked" ให้ CC ที่ยังไม่มี — คืนจำนวน CC ที่ครอบ -function unlockContentControls(zip) { - const select = xpath.useNamespaces({ w: W_NS }); - const asNode = (n) => n; - const parts = Object.keys(zip.files).filter((n) => - /^word\/(document|header\d*|footer\d*)\.xml$/.test(n), - ); - - // id ของ perm ต้องไม่ซ้ำในเอกสาร — เริ่มสูงกว่าค่าสูงสุดที่มีอยู่ (จากทุก part) - let nextId = 999; - for (const part of parts) { - const ids = select( - "//w:permStart/@w:id | //w:permEnd/@w:id", - asNode(parseXml(zip.file(part).asText())), - ); - for (const id of ids) { - const n = Number.parseInt(id.value, 10); - if (Number.isFinite(n) && n >= nextId) nextId = n; - } - } - - let wrapped = 0; - let locked = 0; - for (const part of parts) { - const doc = parseXml(zip.file(part).asText()); - - // เฉพาะ sdt ระดับบนสุด (ไม่อยู่ใน sdt อื่น) มี w:tag = ช่องข้อมูลของ template - // และยังไม่ถูกครอบด้วย permStart อยู่แล้ว (กัน double-wrap ตอนรันซ้ำ) - const sdts = select( - "//w:sdt[./w:sdtPr/w:tag][not(ancestor::w:sdt)][not(preceding-sibling::*[1][self::w:permStart])]", - asNode(doc), - ); - if (sdts.length === 0) continue; - - for (const sdt of sdts) { - // เติม lock ให้ CC ที่ยังไม่มี — กันลบช่องตอนเปิดช่องให้แก้ผ่าน permission - const sdtPr = select("./w:sdtPr", sdt)[0]; - const hasLock = select("./w:lock", sdtPr).length > 0; - if (!hasLock) { - const lock = doc.createElementNS(W_NS, "w:lock"); - lock.setAttribute("w:val", "sdtLocked"); - // w:lock ต้องอยู่หลัง w:id ตามลำดับ schema ของ sdtPr - const idEl = select("./w:id", sdtPr)[0]; - if (idEl && idEl.nextSibling) { - sdtPr.insertBefore(lock, idEl.nextSibling); - } else { - sdtPr.appendChild(lock); - } - locked++; - } - - const start = doc.createElementNS(W_NS, "w:permStart"); - start.setAttribute("w:id", String(nextId)); - start.setAttribute("w:edGrp", "everyone"); - const end = doc.createElementNS(W_NS, "w:permEnd"); - end.setAttribute("w:id", String(nextId)); - nextId++; - - sdt.parentNode.insertBefore(start, sdt); - sdt.parentNode.insertBefore(end, sdt.nextSibling); - wrapped++; - } - - zip.file(part, serialize(doc)); - } - return { wrapped, locked }; -} - -function enableReadOnlyProtection(zip) { - const file = zip.file("word/settings.xml"); - if (!file) throw new Error("word/settings.xml not found"); - - const doc = parseXml(file.asText()); - const prots = doc.getElementsByTagNameNS(W_NS, "documentProtection"); - const prot = prots.length > 0 ? prots[0] : null; - - if (prot) { - prot.setAttribute("w:edit", "readOnly"); - prot.setAttribute("w:enforcement", "1"); - } else { - // T3 มี element นี้อยู่แล้ว แต่รองรับไฟล์ที่ไม่มี: แทรกเป็น child แรกของ w:settings - const el = doc.createElementNS(W_NS, "w:documentProtection"); - el.setAttribute("w:edit", "readOnly"); - el.setAttribute("w:enforcement", "1"); - doc.documentElement.insertBefore(el, doc.documentElement.firstChild); - } - - zip.file("word/settings.xml", serialize(doc)); -} - -function setCustomProperties(zip, props) { - // --- 1. docProps/custom.xml : สร้างใหม่ หรือ merge กับของเดิม --- - const existing = zip.file("docProps/custom.xml"); - let doc; - if (existing) { - doc = parseXml(existing.asText()); - // ลบ property ชื่อซ้ำออกก่อน (เขียนทับค่าใหม่) - const all = Array.from(doc.getElementsByTagNameNS(CUSTOM_NS, "property")); - for (const p of all) { - if (Object.prototype.hasOwnProperty.call(props, p.getAttribute("name"))) { - p.parentNode.removeChild(p); - } - } - } else { - doc = parseXml( - `` + - ``, - ); - } - - // pid ต้อง >= 2 และไม่ซ้ำ — เริ่มจากค่าสูงสุดที่มีอยู่ +1 - const usedPids = Array.from( - doc.getElementsByTagNameNS(CUSTOM_NS, "property"), - ).map((p) => Number.parseInt(p.getAttribute("pid"), 10) || 1); - let nextPid = Math.max(1, ...usedPids) + 1; - - for (const [name, value] of Object.entries(props)) { - const prop = doc.createElementNS(CUSTOM_NS, "property"); - prop.setAttribute("fmtid", FMTID); - prop.setAttribute("pid", String(nextPid++)); - prop.setAttribute("name", name); - const val = doc.createElementNS(VT_NS, "vt:lpwstr"); - val.textContent = value; - prop.appendChild(val); - doc.documentElement.appendChild(prop); - } - zip.file("docProps/custom.xml", serialize(doc)); - - // --- 2. [Content_Types].xml : เพิ่ม Override (ครั้งเดียว) --- - const ct = parseXml(zip.file("[Content_Types].xml").asText()); - const hasCt = Array.from(ct.getElementsByTagName("Override")).some( - (o) => o.getAttribute("PartName") === "/docProps/custom.xml", - ); - if (!hasCt) { - const el = ct.createElement("Override"); - el.setAttribute("PartName", "/docProps/custom.xml"); - el.setAttribute("ContentType", CT_CUSTOM); - ct.documentElement.appendChild(el); - zip.file("[Content_Types].xml", serialize(ct)); - } - - // --- 3. _rels/.rels : เพิ่ม Relationship (ครั้งเดียว) --- - const rels = parseXml(zip.file("_rels/.rels").asText()); - const relNodes = Array.from(rels.getElementsByTagName("Relationship")); - if (!relNodes.some((r) => r.getAttribute("Type") === REL_CUSTOM)) { - const usedIds = new Set(relNodes.map((r) => r.getAttribute("Id"))); - let n = 1; - while (usedIds.has(`rId${n}`)) n++; - const el = rels.createElement("Relationship"); - el.setAttribute("Id", `rId${n}`); - el.setAttribute("Type", REL_CUSTOM); - el.setAttribute("Target", "docProps/custom.xml"); - rels.documentElement.appendChild(el); - zip.file("_rels/.rels", serialize(rels)); - } -} - -// อ่านกลับมาตรวจทุกอย่างหลังเขียนไฟล์ -function verify(path) { - const zip = new PizzaZip(readFileSync(path)); - - const settings = zip.file("word/settings.xml")?.asText() ?? ""; - const prot = settings.match(/]*\/>/)?.[0]; - const enforced = - prot?.includes('w:edit="readOnly"') && prot?.includes('w:enforcement="1"'); - - const customXml = zip.file("docProps/custom.xml")?.asText(); - const propsBack = {}; - if (customXml) { - const doc = parseXml(customXml); - for (const p of Array.from( - doc.getElementsByTagNameNS(CUSTOM_NS, "property"), - )) { - propsBack[p.getAttribute("name")] = p.textContent; - } - } - - const rels = zip.file("_rels/.rels")?.asText() ?? ""; - const ct = zip.file("[Content_Types].xml")?.asText() ?? ""; - - const docXml = zip.file("word/document.xml")?.asText() ?? ""; - const sdtPrs = docXml.match(/[\s\S]*?<\/w:sdtPr>/g) ?? []; - const plain = sdtPrs.filter((p) => / / `${k}="${v.length > 40 ? v.slice(0, 40) + "…" : v}"`) - .join(", ") || "(ว่าง)", - ); - console.log( - `relationship : ${rels.includes(REL_CUSTOM) ? "✓" : "✗ ไม่พบ"} | content-type override: ${ct.includes(CT_CUSTOM) ? "✓" : "✗ ไม่พบ"}`, - ); - console.log(`content controls : ${sdtPrs.length} ตัว (plain=${plain}, rich=${rich}, มี tag=${tagged})`); - console.log( - `permission ranges : permStart=${permStarts} / permEnd=${permEnds} (ต้องเท่ากับมี tag=${tagged}) ` + - (permStarts === tagged && permEnds === tagged ? "✓" : "✗"), - ); - console.log( - `CC ไม่มี lock : ${missingLock} ตัว (ต้องเป็น 0 — กันลบช่อง) ${missingLock === 0 ? "✓" : "✗"}`, - ); - - return ( - enforced && - !!customXml && - permStarts === tagged && - permEnds === tagged && - missingLock === 0 - ); -} - -const zip = new PizzaZip(readFileSync(inPath)); -enableReadOnlyProtection(zip); -const { wrapped, locked } = unlockContentControls(zip); -setCustomProperties(zip, CUSTOM_PROPS); - -if (locked > 0) { - console.log(`เติม w:lock="sdtLocked" ให้ CC อีก ${locked} ตัวที่ยังไม่มี`); -} -console.log(`ครอบ CC ด้วย permission range: ${wrapped} ตัว`); - -const out = zip.generate({ type: "nodebuffer", compression: "DEFLATE" }); -writeFileSync(outPath, out); -console.log(`เขียนไฟล์แล้ว: ${outPath} (${out.length.toLocaleString()} bytes)`); - -const ok = verify(outPath); -process.exit(ok ? 0 : 1); diff --git a/app/api/template/test/note.md b/app/api/template/test/note.md deleted file mode 100644 index 919190b..0000000 --- a/app/api/template/test/note.md +++ /dev/null @@ -1,127 +0,0 @@ -# Docx Template -lib-tmpl.ts เป็นแชร์ไลบารีสำหรับการทำ Template ใช้ Content Control ใน MS Word -## วิธีการใช้ API -```sh -## Swagger UI — เปิดในเบราว์เซอร์ (ลองยิงจริงผ่านปุ่ม Try it out ได้เลย ไม่ต้อง login) -http://localhost:3000/docedit/api/swagger - -## template/test ไว้ทดสอบเท่านั้น -curl.exe http://localhost:3000/docedit/api/template/test - -## extract ค่าออกมาจาก content control -curl.exe -X POST http://localhost:3000/docedit/api/template/extract -F "file=@./output-T3.docx" - -## render เอกสาร (docx) = template(docx)+data(json) -### อาจจะเพิ่มการเอา template จาก url และ file(local) ยังไม่รู้ว่าทางนั้นจะส่งไฟล์แบบไหนมาให้ เอาแค่นี้ไว้ทดสอบก่อน -curl.exe -X POST http://localhost:3000/docedit/api/template/render -F "template=@./T3.docx" -F "data=@./T2.json" -o output.docx -### data เอาจาก string -curl -X POST http://localhost:3000/docedit/api/template/render \ - -F "template=@template.docx" \ - -F 'dataJson={"member_name":"นายสมชาย","member_id":"123456"}' \ - -o generated-document.docx - -``` -data(json) ตอนนี้อยู่ในรูปแบบ -```json -{ - "notname": "คำสั่งเรียก ให้ทำคำให้การ", - "nottype": "(ต. ๑)", - "blackno": "คดีหมายเลขดำที่", - "blackyear": "๑๐/๒๕๖๙", - ... -} -``` -data(json)น่าจะปรับเป็นแบบนี้เพื่อรองรับการทำ Token-Based Seamless Integration -หลักผ่าน API -- ส่วนของ cc จะไปกรอกใน Content Control -- uid,uname,fid,ott,expire สร้างเป็น token ฝังใน custom property ของเอกสาร -```json -{ - "uid":"id ผู้มีสิทธิ์แก้ไขเอกสาร", - "uname": "ชื่อผู้มีสิทธิ์แก้ไขเอกสาร สำหรับแสดงผล", - "fid":"file id จะได้เซฟข้อมูลกลับไปที่ Oracle ถูกตารางและหน่วยงาน", - "ott":"อายุของ one time token แบบระยะสั้น", - "expire": "อายุเอกสารแบบระยะยาวหลังเอา ott ไปแลก (optional)", - cc:{ - "notname": "คำสั่งเรียก ให้ทำคำให้การ", - "nottype": "(ต. ๑)", - "blackno": "คดีหมายเลขดำที่", - "blackyear": "๑๐/๒๕๖๙", - ... - } -} -``` -ที่ต้องทำเพิ่ม -- render ปัจจุบันมีไว้ให้ทางศาลทดสอบ อันที่ใช้จริงหลังกดสร้าง Template เพื่อ Download จะสร้างเอกสารเวอร์ชั่นแรกใน object storage หรือถ้ามีอยู่แล้ว จะเป็นการอัปเดต -- Backend จัดการ version -- อัปเดตข้อมูลและเอกสารกลับระบบเดิม ส่วนนี้ยังไม่ชัดเจนอาจจะทำ mock api เตรียมไว้ก่อน - -# ทดลอง Restrict Edit + Custom Properties (2026-10-07) - -สคริปต์ `make-protected.mjs` — อ่าน docx → เปิด protection + ฝัง custom properties → เขียนไฟล์ → อ่านกลับ verify ทุกครั้ง - -```sh -node app/api/template/test/make-protected.mjs [in.docx] [out.docx] -# ไม่ส่ง argument = อ่านและเขียนทับ output-T3.docx (ค่าตัวอย่างฝังอยู่ในตัวสคริปต์ CUSTOM_PROPS) -``` - -## Restrict Edit (เปิดผ่านโค้ด) - -- อยู่ที่ `word/settings.xml` → `` -- T3.docx มี element นี้อยู่เดิมแต่เป็น `w:enforcement="0"` (ตั้งค่าไว้ใน Word แต่ไม่ได้กดบังคับใช้) — สคริปต์แค่พลิกเป็น 1 ไม่ต้องแทรก element ใหม่ -- **บทเรียนจากทดสอบใน Word จริง (2026-10-07): `readOnly` + enforcement ล็อคทั้งเอกสารรวมถึง Content Control ด้วย** — CC ไม่ได้ถูกยกเว้นให้แก้อัตโนมัติ ต้องคู่กับข้อถัดไป -- **กลไกที่ถูกต้อง: ครอบ `w:sdt` ทุกตัวที่มี `w:tag` ด้วย `` … ``** — คือกลไก "Exceptions (optional): Everyone" ที่แผง Restrict Editing ของ Word ใช้เวลาเราเลือกบริเวณแล้วติ๊ก Everyone (บริเวณใน permission range แก้ได้ นอกนั้นล็อค) — แทรกที่ระดับเดียวกับ sdt (inline ใน `w:p` หรือ block ใน `w:body` ก็ valid ตาม grammar) -- สคริปต์เติม `w:lock="sdtLocked"` ให้ CC ที่ยังไม่มีด้วย (T3 ขาด acc1, nottitle) — พอช่องถูกเปิดให้แก้ผ่าน permission แล้ว ช่องที่ไม่มี lock จะถูก**ลบ**ได้ตามไปด้วย -- ไม่ใส่ password → ผู้ใช้ปลดเองได้จาก Review → Restrict Editing → Stop Protection — ตั้งใจไว้แบบนี้เพราะ concept คือ token ใน custom property เป็นตัวกำกับสิทธิ์จริง ส่วน protection เป็นแค่เกราะกันแก้พลาด (ถ้าจะใส่ password ต้องคำนวณ legacy hash: SHA-1 ของ password+salt วนตาม `w:cryptSpinCount` ตาม ECMA-376 — ยังไม่ทำ) - -## ฝังข้อมูลใน Property เอกสาร (token / primary-key / owner) - -ทางเลือกที่ศึกษา: -1. **`docProps/custom.xml` (custom properties) — ที่เลือกใช้** เห็นได้ใน Word: File → Info → Properties → Advanced Properties → แท็บ Custom; add-in ฝั่ง Word (Office.js) อ่าน/เขียนได้ผ่าน `Document.properties.customProperties` (WordApi 1.3+) - - ไฟล์ที่ไม่มี part นี้อยู่ (กรณีปกติของ docx) ต้องทำครบ 3 อย่างพร้อมกัน ไม่งั้น Word ถือว่าไฟล์เสีย: - 1. สร้าง `docProps/custom.xml` — property แต่ละตัว: `fmtid="{D5CDD505-2E9C-101B-9397-08002B2CF9AE}"` คงที่ + `pid` ≥ 2 ไม่ซ้ำ + `name` + ค่า string ใน `vt:lpwstr` - 2. `[Content_Types].xml` เพิ่ม `` - 3. `_rels/.rels` เพิ่ม Relationship ชนิด `.../relationships/custom-properties` Target `docProps/custom.xml` -2. `docProps/core.xml` (core properties: title/subject/creator/description) — แก้ง่าย เห็นในหน้า Properties ปกติ เหมาะกับข้อมูลที่แสดงต่อผู้ใช้ ไม่ใช่ token -3. `w:docVar` ใน `word/settings.xml` (document variables) — ไม่โผล่ใน UI เลย อ่านได้ผ่าน VBA/VSTO (`Document.Variables`) แต่ Word JS API ไม่มีทางตรง — ไม่เลือก - -gotcha ที่เจอ: `XMLSerializer` ของ @xmldom/xmldom คง `` declaration ไว้ในผลลัพธ์อยู่แล้ว — ห้าม prepend เพิ่มเอง จะได้ declaration ซ้อนเป็น XML invalid (Word/node อ่านไม่ได้) - -## extract บอก alignment รายช่อง — key `@align` (2026-10-07) — **ถอดออกแล้วตามคำขอ (ยังไม่เอา)** - -- เคย implement ใน `lib-tmpl.ts` + spec `lib/openapi.ts` แล้ว**ถอดกลับสถานะเดิม** — extract ปัจจุบันคืนแค่ `{ tag: text }` เหมือนเดิม -- แนวทางที่พิสูจน์แล้วว่าใช้ได้ (เผื่อกลับมาทำภายหลัง): คืน key `@align` (ค่า w:jc เช่น `thaiDistribute`) เฉพาะช่องที่ต่างจาก default ของเอกสาร โดย resolve: `w:pPr/w:jc` ตรงของย่อหน้า → style ที่ใช้ (ไล่ `w:pStyle` → `w:basedOn`) → `docDefaults` ("left"/"start" นับเป็นไม่ตั้ง) — บริบทย่อหน้าของช่อง: CC block = `w:p` แรกใน `w:sdtContent` / CC inline = `w:p` ที่ครอบ sdt -- ผลทดสอบตอน implement: direct pPr ชนะ style ✓ inline/block จับได้ทั้งคู่ ✓ และ T3 จัดช่อง 8 ตัวผ่าน style อยู่แล้ว (nottype/blackyear/redyear/acc1/acc2/groupname/detail1/pname — ชิดขวา/กลาง) — ช่องเหล่านี้จะโผล่ `@align` ตามจริง - -## จัด paragraph แบบ Thai Distributed — ตัดสินใจ: จัดเองใน Word ตอนทำ template (2026-10-07) - -- ค่า OOXML คือ `` ใน `w:pPr` (ใน Word UI: Paragraph → Alignment → Thai Distributed, ทางลัด Ctrl+Shift+J) — ต่างจาก `distribute` ธรรมดาตรงที่จัดกระจายช่องว่างระหว่างคำเป็นหลัก ไม่บีบยืดตัวอักษร/สระ-วรรณยุกต์ -- **ไม่ตั้งผ่านโค้ด** — ผู้ออกแบบ template จัดเองใน Word ตอนทำ template ทางเดียวกับที่ตั้งฟอนต์/ย่อหน้าอื่น ๆ (เคยทดลองตั้ง default ทั้งเอกสารผ่าน `styles.xml` → `w:docDefaults/w:pPrDefault/w:pPr` แล้วถอดออกตามคำขอ) -- วิธีจัดเองใน Word: - - รายย่อหน้า/ราย CC: คลิกในย่อหน้า → `Ctrl+Shift+J` หรือ Home → Paragraph launcher → Alignment เลือก Thai Distributed - - ทั้งเอกสาร: คลิกขวา style Normal → Modify → Format → Paragraph → Thai Distributed - - จัด "เฉพาะช่อง CC" ได้เฉพาะ CC แบบ block (มี `w:p` ใน `w:sdtContent` ของตัวเอง เช่น `detail1`) — CC แบบ inline อยู่ในบรรทัดเดียวกับข้อความอื่น การจัดมีผลทั้งบรรทัด -- จุดสำคัญต่อ render pipeline: `insertBlockContent` ของ lib-tmpl clone `w:pPr` ของย่อหน้าแรกให้ทุกบรรทัดที่แทนค่า — จัดไว้ใน CC ตั้งแต่ต้นค่าจะสืบทอดไปทุกบรรทัดที่ render ใส่ข้อมูลอัตโนมัติ ไม่ต้องทำอะไรฝั่ง render -- (อ้างอิงเชิงเทคนิคกรณีต้องตั้งผ่านโค้ดภายหลัง: `w:jc` ใน `w:pPr` เป็น fixed sequence — ต้องอยู่หลัง `w:autoSpaceDN`/`w:spacing`/`w:ind` และก่อน `w:textDirection`/`w:rPr`/`w:sectPr`) - -## ผล verify (อัตโนมัติทุกครั้งที่รันสคริปต์) - -- `documentProtection` เปิดใช้ (readOnly + enforcement=1) ✓ -- `docProps/custom.xml` มี + relationship + content-type override ครบ ✓ -- Content Control 27 ตัวครบเดิม (plain 26 = มี `w:text`, rich 1 = `detail1`) ✓ -- permission ranges: permStart/permEnd ครบตามจำนวน CC ที่มี tag (27/27) ✓ -- ทุก CC มี `w:lock="sdtLocked"` (กันลบช่อง) ✓ -- `extractContentControls` (lib-tmpl) อ่านคืนได้ทุก tag ตรงกับ output.docx ก่อน protect 100% ✓ - -## ผลทดสอบใน Word จริง (2026-10-07 รอบ 1) - -- ✅ แถบเหลือง protection ขึ้น / แก้นอก CC ไม่ได้ / ลบ CC ไม่ได้ -- ❌ B5: **CC แก้ไม่ได้** เพราะ readOnly ล็อคทั้งเอกสาร → แก้ด้วย permStart/permEnd ตามด้านบนแล้ว (รอบ 2) -- ✅ custom properties ครบ / ปลด protection ได้แบบไม่มี password - -## เหลือตรวจใน Word จริง (รอบ 2) - -- เปิด `output-T3.docx` → พิมพ์/แก้ในช่อง CC ต้องได้แล้ว (B5) -- ลบ CC ต้องไม่ได้ทุกตัว (รวม acc1, nottitle ที่เติม lock ให้) -- ขั้น E เดิม: F12 เซฟสำเนา → เปิดใหม่ → properties ยังอยู่ครบ -- (ผ่านแล้วทั้งหมด → ย้าย logic ไปเป็นฟังก์ชันใน lib-tmpl.ts แล้วต่อเข้า render pipeline) diff --git a/app/api/template/test/output.docx b/app/api/template/test/output.docx deleted file mode 100644 index 2622682..0000000 Binary files a/app/api/template/test/output.docx and /dev/null differ diff --git a/app/api/template/test/test.http b/app/api/template/test/test.http deleted file mode 100644 index d615855..0000000 --- a/app/api/template/test/test.http +++ /dev/null @@ -1,43 +0,0 @@ -@baseUrl = http://localhost:3000/docedit/api - -### 1. Extract Template -POST {{baseUrl}}/template/extract -Content-Type: multipart/form-data; boundary=WebAppBoundary - ---WebAppBoundary -Content-Disposition: form-data; name="file"; filename="output-T3.docx" -Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document - -< ./output-T3.docx ---WebAppBoundary-- - -### 2. Render Template with JSON File -POST {{baseUrl}}/template/render -Content-Type: multipart/form-data; boundary=WebAppBoundary - ---WebAppBoundary -Content-Disposition: form-data; name="template"; filename="T3.docx" -Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document - -< ./T3.docx ---WebAppBoundary -Content-Disposition: form-data; name="data"; filename="T2.json" -Content-Type: application/json - -< ./T2.json ---WebAppBoundary-- - -### 3. Render Template with Raw JSON String -POST {{baseUrl}}/template/render -Content-Type: multipart/form-data; boundary=WebAppBoundary - ---WebAppBoundary -Content-Disposition: form-data; name="template"; filename="template.docx" -Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document - -< ./T3.docx ---WebAppBoundary -Content-Disposition: form-data; name="dataJson" - -{"notname": "คำสั่งเรียก ให้ทำคำให้การ","nottype": "(ต. ๑)","blackno": "คดีหมายเลขดำที่","blackyear": "๑๐/๒๕๖๙","redno": "คดีหมายเลขแดงที่","redyear": "","court": "ศาลปกครองสุพรรณบุรี","curdate": "วันที่ ๗ เดือน สิงหาคม พุทธศักราช ๒๕๖๙","accuser": "นายธัญวิสิษฐ์ ศรแก้ว","acc1": "ผู้ฟ้องคดี","accused": "เจ้าคุณมด ที่ ๑ กับพวกรวม ๓ คน","acc2": "ผู้ถูกฟ้องคดี","nottitle": "คำสั่งถึง","commto": "เจ้าคุณมด","groupname": "ผู้ถูกฟ้องคดีที่ ๑","detail1": "ด้วยผู้ฟ้องคดีได้ยื่นฟ้องผู้ถูกฟ้องคดีต่อศาล มีข้อความตามที่ปรากฏ ในระบบงานคดีปกครองอิเล็กทรอนิกส์\nฉะนั้น ให้ ท่านทำคำให้การแก้คำฟ้อง พร้อมด้วยพยานหลักฐาน ๑ ชุด ต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่งนี้","pname": "นางนพเก้า เถื่อนชัย","courtname": "ศาลปกครองสุพรรณบุรี","courtno": "๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี","courttam": "จังหวัดสุพรรณบุรี ๗๒๐๐๐","courttel": "กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓","courttel2": "สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน “๑๓๕๕”","sendto": "เจ้าคุณมด","addrno": "เลขที่ - หมู่ที่ - ตรอก/ซอย - ถนน - ตำบล/แขวง - อำเภอ/เขต - จังหวัด - โทรศัพท์ -","remarkhead": "","remark": "","warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่าผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี"} ---WebAppBoundary-- diff --git a/app/tmpl/page.tsx b/app/tmpl/page.tsx new file mode 100644 index 0000000..fa31778 --- /dev/null +++ b/app/tmpl/page.tsx @@ -0,0 +1,101 @@ +// app/page.tsx (ระบบ B) +'use client'; +import Link from "next/link"; +import type { ChangeEvent } from 'react'; +// import { createDownloadFormAction } from './actions'; +import DependentDropdown, { DropdownData } from '@/components/utils/DependentDropdown'; + + + +export default function HomePage() { + const templateData: DropdownData = { + T_X: ['T_no_warning', 'TF_no_warning_P2', 'TS_P2_IN'], + T12_X: ['T12_b2_IN', 'T12_FD155_3s-long'], + }; + const handleTmplSelect = (template: string, data: string) => { + //console.log('Location Selected:', { template, data }); + }; + const handleInput = (e: ChangeEvent)=>{ + // console.log(e.target) + return true; + } + return ( +
+
+

ตัวอย่างการใช้ สร้างเอกสารจาก Template

+
+ ตัวอย่าง Frontend ส่งข้อมูลผ่าน <form>(POST) หรือ <a>(GET) + เพื่อรองรับ Vanilla JavaScript และ Classic Framework ใช้การเปลี่ยนหน้าเพื่อดาว์นโหลดไฟล์ + ตัวอย่างหน้าแบบ Plain HTML +
+
+
+

Form POST

+ +
+
+ uid: +
+
+ uname: +
+ + +
+
+

A Link Get(new)

+ T_no_warning_john_xxx.docx
+ TF_no_warning_P2_john_xxx.docx
+ TS_P2_IN_john_xxx.docx
+ + T12_b2_IN_john_xxx.docx
+ T12_FD155_3s-long_john_xxx.docx
+
+
+

Template & Data

+ Template: T_X.docx,   + T12_X.docx
+ Data: TF_no_warning_P2.json,   + T_no_warning.json,   + TS_P2_IN.json
+ T12_b2_IN.json,   + T12_FD155_3s-long.json +
+
+

Flow

+
+ หน้านี้(เลือกไฟล์)
+ ↓
+ download-docx(ตรวจสิทธิ์,ส่งเทมเพลต ID,ส่งข้อมูล)
+ ↓
+ generate(เปิดเทมเพลต,สร้าง docx)
+ ↓
+ ดาว์นโหลด docx เปิด MS Word อัตโนมัติ
+ ↓
+ Add-ins ตรวจสอบไฟล์, ผู้ใช้แก้ไข docx
+ ↓
+ Versioning(คุมเวอร์ชั่น)
+ ↓
+ ecourt(อัปเดตฐานข้อมูลและไฟล์)
+ +
+ +
+ +
+
+ ); +} \ No newline at end of file diff --git a/app/wordaddin/error.tsx b/app/wordaddin/error.tsx new file mode 100644 index 0000000..ac42382 --- /dev/null +++ b/app/wordaddin/error.tsx @@ -0,0 +1,37 @@ +"use client"; + +// [DBG-r3p1] error boundary ของ taskpane — แสดง error จริงแทนหน้า +// "Application error: a client-side exception has occurred" ของ Next +// (ไว้ใช้ debug ใน webview ของ Word ที่เปิด devtools ไม่ได้ — คงไว้ถาวร +// เพราะดีกว่าข้อความกลาง ๆ ของ Next เสมอ สำหรับ add-in ที่ผู้ใช้เปิด console ไม่ได้) +export default function WordAddinError({ + error, + reset, +}: { + error: Error & { digest?: string }; + reset: () => void; +}) { + return ( +
+

task pane ทำงานผิดพลาด

+

+ เกิดข้อผิดพลาดฝั่งหน้าเว็บ — แจ้งข้อความด้านล่าง (ถ่ายภาพหน้าจอนี้มาด้วย) แล้วกดลองใหม่ +

+ 
+        {error.message}
+        {error.digest ? `\n[digest ${error.digest}]` : ""}
+        {error.stack ? `\n\n${error.stack}` : ""}
+
+ +
+ ); +} diff --git a/components/utils/DependentDropdown.tsx b/components/utils/DependentDropdown.tsx new file mode 100644 index 0000000..7331bd9 --- /dev/null +++ b/components/utils/DependentDropdown.tsx @@ -0,0 +1,91 @@ +'use client'; + +import { useState, ChangeEvent, useEffect } from 'react'; + +export interface DropdownData { + [key: string]: string[]; +} + +interface DependentDropdownProps { + data: DropdownData; + name1: string; // เพิ่มมาเพื่อใช้กับ Form Action + name2: string; // เพิ่มมาเพื่อใช้กับ Form Action + label1?: string; + label2?: string; + placeholder1?: string; + placeholder2?: string; + onSelectChange?: (mainValue: string, subValue: string) => void; +} + +export default function DependentDropdown({ + data, + name1, + name2, + label1 = 'เลือกตัวเลือกหลัก:', + label2 = 'เลือกตัวเลือกย่อย:', + placeholder1 = '-- กรุณาเลือก --', + placeholder2 = '-- กรุณาเลือกตัวเลือกหลักก่อน --', + onSelectChange, +}: DependentDropdownProps) { + const [mainSelection, setMainSelection] = useState(''); + const [subSelection, setSubSelection] = useState(''); + + const handleMainChange = (e: ChangeEvent) => { + const value = e.target.value; + setMainSelection(value); + setSubSelection(''); + }; + + const handleSubChange = (e: ChangeEvent) => { + setSubSelection(e.target.value); + }; + + useEffect(() => { + if (onSelectChange) { + onSelectChange(mainSelection, subSelection); + } + }, [mainSelection, subSelection, onSelectChange]); + + const subOptions = mainSelection ? data[mainSelection] : []; + + return ( +
+ {/* Dropdown ที่ 1 */} +
+ + +
+ + {/* Dropdown ที่ 2 */} +
+ + +
+
+ ); +} diff --git a/components/wordaddin/TaskpaneApp.tsx b/components/wordaddin/TaskpaneApp.tsx index 5191a79..35895b7 100644 --- a/components/wordaddin/TaskpaneApp.tsx +++ b/components/wordaddin/TaskpaneApp.tsx @@ -3,7 +3,7 @@ "use client"; import { useCallback, useEffect, useState } from "react"; -import { FileUp, GitCommitHorizontal, LogOut } from "lucide-react"; +import { FileUp, GitCommitHorizontal } from "lucide-react"; import { autoSaveService } from "@/wordaddin/services/autoSaveService"; import * as authService from "@/wordaddin/services/authService"; @@ -23,22 +23,26 @@ import TemplateToolsPanel from "./TemplateToolsPanel"; import VersionHistoryPanel from "./VersionHistoryPanel"; /** - * Task pane หลัก — state machine ตาม Phase 5: - * checking → (ไม่มี token) signed-out - * → (มี token + ไม่ใช่ tracked document) untracked - * → (มี token + tracked document) tracking - * พอร์ตจาก App.tsx ต้นฉบับ (D:\word-addin-poc\addin) — state/handlers คงเดิมทุกตัว - * เปลี่ยนเฉพาะ: import path, JSX → Genesis/Tailwind, ถอด FluentProvider/makeStyles, + * Task pane หลัก — state machine: + * checking → (ไม่มี/ตรวจไม่ผ่าน ticket ในไฟล์) no-access + * → (ticket ผ่าน + ไม่ใช่ tracked document) untracked + * → (ticket ผ่าน + tracked document) tracking + * ไม่มี login ตั้งแต่ยกเลิก Keycloak (2026-10-27) — auth เข้าทางเดียวคือ ticket + * ของ e-Court: `detect()` อ่าน ticket_data + HmacSha256 จาก custom properties + * แล้วเรียก `authService.signInWithTicket` (ตรวจ HMAC → exp → session → ขอ token + * ตาม fid — PLAN-ADDIN-AUTH.md) + * พอร์ตจาก App.tsx ต้นฉบับ (D:\word-addin-poc\addin) — เปลี่ยน: import path, + * JSX → Genesis/Tailwind, ถอด FluentProvider/makeStyles, ถอดหน้า login, * เพิ่ม prop demo (โหมด ?addindemo ของ WordAddinGate — ตั้ง phase ตรง ไม่ detect จริง) * - * กติกา: ทุก async ต้อง catch — AuthRequiredError → กลับ signed-out อย่างเนียน (AC-9) + * กติกา: ทุก async ต้อง catch — AuthRequiredError → หน้า no-access ให้ขอไฟล์ใหม่จาก e-Court * error อื่นแสดง MessageBar ไม่ปล่อย unhandled rejection * - * FR-17 — auto-save (local เท่านั้น) เริ่มตอน mount ไม่รอ sign-in; FR-3 reminder + * FR-17 — auto-save (local เท่านั้น) เริ่มตอน mount ไม่ผูกกับ phase; FR-3 reminder * กลายเป็น flag `uncommittedSinceVersion` ที่ periodic tick ของ autoSaveService ตั้งค่า */ -type Phase = "checking" | "signed-out" | "untracked" | "tracking"; +type Phase = "checking" | "no-access" | "untracked" | "tracking"; /** แท็บของ taskpane — versioning คือทุกอย่างเดิม, template คือเครื่องมือจัดการ Content Controls * (Office.js ล้วน ไม่ยิง backend จึงใช้ได้ทั้ง untracked และ tracking) */ @@ -108,8 +112,8 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => const [historyLoading, setHistoryLoading] = useState(false); const [historyError, setHistoryError] = useState(null); - const [signingIn, setSigningIn] = useState(false); - const [loginError, setLoginError] = useState(null); + /** ข้อความบนหน้า no-access — ต่างกันตามสาเหตุ (ไม่มี token ในไฟล์ / token หมดอายุ) */ + const [noAccessNotice, setNoAccessNotice] = useState(null); const [starting, setStarting] = useState(false); const [saving, setSaving] = useState(false); @@ -135,15 +139,17 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => /** FR-3 — periodic tick เห็นการแก้ไขหลัง version ล่าสุด (แสดงเฉพาะตอน tracking) */ const [hasUncommitted, setHasUncommitted] = useState(false); - /** 401 ที่ refresh ไม่ช่วย → กลับหน้า sign-in อย่างเนียน (AC-9) */ + /** AuthRequiredError (ticket หมดอายุ/token ขอไม่ได้ หลัง renew-retry ของ apiClient) + * → หน้า no-access — ticket ต่ออายุไม่ได้ ผู้ใช้ต้องขอไฟล์ใหม่จาก e-Court + * จึงรีเซ็ต state ทั้งชุดกันใช้ของเก่าต่อ */ const handleAuthRequired = useCallback((error: unknown): boolean => { if (error instanceof AuthRequiredError) { - setPhase("signed-out"); + setPhase("no-access"); setActiveTab("versioning"); setDocumentId(null); setDocumentTemplateId(null); setVersions([]); - setLoginError("เซสชันหมดอายุ — กรุณา login ใหม่"); + setNoAccessNotice("ticket ของ e-Court หมดอายุหรือไม่ถูกต้อง — โปรดขอไฟล์ใหม่จาก e-Court แล้วเปิดอีกครั้ง"); return true; } return false; @@ -166,35 +172,38 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => [handleAuthRequired], ); - /** ตรวจตอนเปิด task pane (FR-1): token → SavedByAddIn → history + /** ตรวจตอนเปิด task pane (FR-1): ticket ในไฟล์ → SavedByAddIn → history * FR-16 — อ่าน properties ครั้งเดียวทั้งชุดแล้ว derive tracked เอง เพราะไฟล์ร่าง (untracked) * ต้องได้อ่าน TemplateId ไปใช้ตอน Start Versioning ด้วย (ข้ามทั้งหมดในโหมด demo) - * e-Court pass-through — ยังไม่มี session แต่ไฟล์ stamp token/owner มา = ผ่านเข้าเลยไม่ต้องกด login */ + * auth ทางเข้าเดียว: ticket_data + HmacSha256 ที่ e-Court stamp มา — signInWithTicket + * ตรวจ HMAC → exp → session/localStorage แล้วขอ token ตาม fid ให้ครบก่อนไหลต่อ + * (นอก Word เช่น browser ธรรมดา → อ่านไม่ได้ = ไป no-access) */ const detect = useCallback(async () => { setPhase("checking"); setBootError(null); try { let properties: metadataService.TrackedDocumentProperties | null = null; - if (!(await authService.getAccessToken())) { - // e-Court pass-through — อ่านไฟล์ก่อนตัดสิน: ไฟล์ที่ stamp token/owner มา = ผ่านเลยไม่ต้องกด login - // (นอก Word เช่น browser ธรรมดา → อ่านไม่ได้ = ไป signed-out ตามเดิม) - try { - properties = await metadataService.readTrackedProperties(); - } catch { - properties = null; - } - if ( - !properties || - !authService.signInFromDocument({ token: properties.ecourtToken, owner: properties.ecourtOwner }) - ) { - setPhase("signed-out"); - return; - } + try { + properties = await metadataService.readTrackedProperties(); + } catch { + properties = null; + } + if (!properties) { + setNoAccessNotice("อ่านข้อมูลเอกสารไม่สำเร็จ — ลองปิดแล้วเปิด task pane อีกครั้ง"); + setPhase("no-access"); + return; + } + const signIn = await authService.signInWithTicket({ + ticketData: properties.ticketData, + ticketHmac: properties.ticketHmac, + }); + if (!signIn.ok) { + setNoAccessNotice(signIn.message); + setPhase("no-access"); + return; } - authService.startAutoRefresh(); setUsername(authService.getUsername() ?? null); - properties ??= await metadataService.readTrackedProperties(); const tracked = properties.savedByAddIn === metadataService.ADDIN_SIGNATURE_GUID; const id = tracked ? properties.documentTrackingId : undefined; if (!id) { @@ -217,7 +226,7 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => void detect(); }, [demo, detect]); - /** FR-17 — เริ่ม auto-save ตั้งแต่ mount ไม่รอ sign-in (ข้ามใน demo กัน error banner จาก Word ที่ไม่มี) + /** FR-17 — เริ่ม auto-save ตั้งแต่ mount ไม่ผูกกับ phase (ข้ามใน demo กัน error banner จาก Word ที่ไม่มี) * ผูก listener ให้ React state: error → banner, dirty→save → flag FR-3 */ useEffect(() => { autoSaveService.onError = (error) => @@ -235,34 +244,6 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => }; }, [demo]); - const handleSignIn = async () => { - setSigningIn(true); - setLoginError(null); - try { - const result = await authService.login(); - if (result.ok) { - await detect(); - } else { - setLoginError(result.error); - } - } catch (error) { - setLoginError(getErrorMessage(error, "เข้าสู่ระบบไม่สำเร็จ")); - } finally { - setSigningIn(false); - } - }; - - const handleSignOut = () => { - authService.signOut(); - setUsername(null); - setDocumentId(null); - setDocumentTemplateId(null); - setVersions([]); - setLoginError(null); - setPhase("signed-out"); - setActiveTab("versioning"); - }; - /** FR-18 [บันทึก] — local save เดี่ยวผ่าน lock ของ autoSaveService (ไม่ stamp metadata อะไร) */ const handleSaveOnly = async () => { setSaveBusy(true); @@ -408,18 +389,15 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
e-Court Documents Versioning - {phase !== "signed-out" && phase !== "checking" && username ? ( - /* จอแคบ: username ย้ายไป title/aria-label — ไม่กินพื้นที่แถบหัวจนตัวชื่อแอป wrap 3-4 บรรทัด */ - + {username} + ) : null}
@@ -430,7 +408,7 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => {autoSaveError} ) : null} - {/* toggle แท็บ — แสดงเฉพาะ phase ที่เข้าถึงเอกสารแล้ว (checking/signed-out ยังไม่มีอะไรให้จัดการ) + {/* toggle แท็บ — แสดงเฉพาะ phase ที่เข้าถึงเอกสารแล้ว (checking/no-access ยังไม่มีอะไรให้จัดการ) ปิดทั้งสองปุ่มระหว่าง flow ที่เขียนเอกสาร: saving/starting ของ versioning (กัน progress หาย กลาง flow — handler อยู่ที่ component นี้ flow ยังรันจนจบ แค่หน้าตา), saveBusy ของบันทึก local/ปิดเอกสาร และ templateBusy ที่ panel รายงานผ่าน onBusyChange — กันเครื่องมือ template @@ -481,21 +459,13 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
) : null} - {phase === "signed-out" ? ( + {phase === "no-access" ? ( + /* ไม่มี login ให้กด — บอกสาเหตุและจบที่นั้น (ขั้นตอนสำหรับเอกสารทั่วไปจะมีในอนาคต) */
-

เข้าสู่ระบบเพื่อเริ่มใช้งาน versioning

+

เอกสารนี้ยังใช้งาน add-in ไม่ได้

- ใช้บัญชีของ realm word-versioning — หน้าต่าง login จะเปิดแยกต่างหาก + {noAccessNotice ?? "ไม่พบ ticket ของ e-Court ในไฟล์ — ขณะนี้ add-in ใช้ได้กับเอกสารที่ส่งมาจาก e-Court เท่านั้น"}

- - {loginError ? {loginError} : null}
) : null} diff --git a/components/wordaddin/VersionHistoryPanel.tsx b/components/wordaddin/VersionHistoryPanel.tsx index 7755035..930a4d1 100644 --- a/components/wordaddin/VersionHistoryPanel.tsx +++ b/components/wordaddin/VersionHistoryPanel.tsx @@ -135,7 +135,7 @@ export function VersionHistoryPanel({

) : null}

- {formatTimestamp(version.createdAt)} · โดย {version.createdByUserId} + {formatTimestamp(version.createdAt)} · โดย {version.createdByUserName ?? version.createdByUserId}

); diff --git a/docker/web.Dockerfile b/docker/web.Dockerfile index 38f1602..84788ea 100644 --- a/docker/web.Dockerfile +++ b/docker/web.Dockerfile @@ -23,8 +23,20 @@ ENV NEXT_TELEMETRY_DISABLED=1 # db/index.ts throw ถ้าไม่มี DATABASE_URL ตอน next build เก็บ page data — # ใส่ค่า dummy (postgres.js เชื่อมแบบ lazy ไม่มี query ตอน build) ตัวจริงฉีดตอน docker run ENV DATABASE_URL=postgresql://placeholder:placeholder@127.0.0.1:5432/placeholder +ENV MINIO_ENDPOINT=127.0.0.1 +ENV MINIO_PORT=19000 +ENV MINIO_USE_SSL=false +ENV MINIO_ACCESS_KEY=minioadmin +ENV MINIO_SECRET_KEY=minioadmin +ENV DOCVER_API_KEY=2d9b76d49a4f5311f6a0dacf759ecec53f34b6d102f24c696890a4052c99cf54 +ENV DOCVER_TOKEN_SECRET=487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e +ENV DOCVER_TOKEN_TTL_SECONDS=604800 +ENV MINIO_BUCKET=docver +ENV DOCVER_LINK_TTL_SECONDS=900 + RUN npm run build + # ─── Stage 3: runtime ตัวเบา (แค่ standalone + public/) ─── FROM node:24-alpine AS runner WORKDIR /app diff --git a/docs/PLAN-ADDIN-AUTH.md b/docs/PLAN-ADDIN-AUTH.md new file mode 100644 index 0000000..a6b8f62 --- /dev/null +++ b/docs/PLAN-ADDIN-AUTH.md @@ -0,0 +1,214 @@ +# PLAN-ADDIN-AUTH — Add-in Ticket Authen (`ticket_data` + `HmacSha256`) + +> วันที่ตกลงแผน: 2026-10-27 · สถานะ: แผนรออนุมัติ · requirement ต้นทาง: `docs/requirement/addin-workflow.md` + +## 0. บริบท/เป้าหมาย + +เปลี่ยน auth ของ wordaddin จาก e-Court pass-through แบบเดิม (e-Court ขอ token เองแล้ว stamp +`token`/`owner` ลงไฟล์) เป็น **ticket** ตาม requirement: + +- e-Court stamp custom properties 2 ค่าในไฟล์ .docx: `ticket_data` (JSON) + `HmacSha256` +- addin ตรวจ HMAC เองฝั่ง client (gate เชิง UX — ตัดเคสไฟล์ถูกแก้ก่อนยิง network) +- **addin เป็นฝ่ายขอ access_token** ที่ `POST /api/documents/token` เก็บใน localStorage + ตาม fid (session ต่อ userId) — ไม่ใช่ e-Court อีกต่อไป +- ถอดระบบเก่า `token`/`owner` ออกทั้งหมด (implement ไว้ 2026-10-27 ยังไม่มีไฟล์จริงใช้ — + ไม่ต้องรองรับสองแบบพร้อมกัน) + +## 1. ข้อตกลงที่ตัดสินใจแล้ว (2026-10-27) + +| # | เรื่อง | ข้อตกลง | +|---|---|---| +| D1 | addin ยืนยันกับ `/token` อย่างไร | **ขยาย `POST /api/documents/token` รับ ticket เพิ่ม** — body `{ticket_data, HmacSha256}` server ตรวจ HMAC+exp ด้วย secret ใน env ฝั่ง server ก่อนออก token · ทางเข้า `x-api-key` เดิม (e-Court server-to-server) ใช้ต่อคู่กัน | +| D2 | โค้ดซ้ำสองฝั่ง | แชร์ส่วน pure ผ่าน **`utils/docver-ticket.ts`** (โซนกลาง client ใช้ได้ — ไม่แตะกติกา "wordaddin ห้าม import จาก `lib/`") · ฝั่ง crypto ฉีดเข้าทาง parameter: client = Web Crypto, server = `node:crypto` | +| D3 | client-side HMAC | ทำตาม requirement (sign เทียบเองก่อน) โดย secret มาจาก `NEXT_PUBLIC_ADDIN_TICKET_SECRET` — **ยอมรับว่าค่าใน bundle สกัดได้** จึงถือเป็นแค่ UX gate, ความมั่นคงจริงอยู่ที่ server verify | +| D4 | รูปแบบ HMAC | sign บน **string ดิบของ `ticket_data` ตามที่อ่านได้จาก property** (ห้าม trim/normalize) · digest เป็น **hex lowercase 64 ตัว** — การเทียบ normalize เป็น lowercase ก่อน (ฝั่ง e-Court stamp ตัวพิมพ์ใหญ่ก็ผ่าน) | +| D5 | `tid` | = `template` ของ claims (`tid` optional → `template: null`) · map `uid→userid`, `uname→username`, `fid` ตรง ๆ | +| D6 | token หมดอายุ (TTL ~1 ชม.) แต่ ticket ยังไม่หมด | เก็บ `exp` ของ token (decode จาก JWT) — ก่อนใช้ถ้าหมดอายุและ ticket ยังไม่หมด → **renew อัตโนมัติ** · โดน 401 กลาง session → renew จาก ticket 1 ครั้งแล้ว retry ก่อนไป no-access | +| D7 | localStorage | key เดียว `wordaddin-auth` เก็บ JSON `{v:1, userId, userName, tokens: {[fid]: {token, exp}}}` · เจอ user ใหม่ = **เคลียร์ทั้งก้อน** (รวม token ทุก fid ของ user เก่า) · webview block localStorage = fallback memory (pattern `versioningService`) | +| D8 | "disable Add-in ทั้งหมด" | = phase `no-access` ที่มีอยู่ โดยแยกข้อความตามสาเหตุ: ไม่พบ ticket / ไฟล์ถูกแก้ไข (HMAC) / ticket หมดอายุ | +| D9 | ช่วง mock (`NEXT_PUBLIC_ADDIN_API_BASE_URL` ว่าง) | addin ยิงขอ token จริงที่ same-origin `withBasePath("/api/documents/token")` (ไม่ผูกกับ apiBaseUrl ของ versioning) — versioning ยัง mock ต่อ | +| D10 | เครื่องมือทดสอบ | มีสคริปต์ stamp ticket ลงไฟล์ .docx ตัวอย่าง (`scripts/make-ticket-docx.mjs`) — ไม่งั้นทดสอบ flow นี้ใน Word จริงไม่ได้เลย | + +## 2. Contract ของ ticket (ต้องส่งให้ทีม e-Court ฝั่ง stamp) + +Custom properties ของไฟล์ .docx (ชื่อ key ต้องตรงเป๊ะ — case-sensitive): + +``` +ticket_data = {"exp":1793067433,"fid":"T12_FD155_3s-long_ZZZ","tid":"T12","uid":"oom","uname":"สรวิชญ์"} +HmacSha256 = = HMAC-SHA256(secret, ticket_data ดิบทั้ง string ไม่ trim) +``` + +| field | type | เงื่อนไข | +|---|---|---| +| `exp` | int (unix วินาที) | บังคับ · `exp <= now` = หมดอายุ | +| `fid` | string | บังคับ · trim 1–200 · เป็น `docId` ของทุก operation ของกลุ่ม docver | +| `uid` | string | บังคับ · trim 1–100 | +| `uname` | string | บังคับ · trim 1–200 | +| `tid` | string | optional · ≤100 · template ต้นทาง (ไม่มี = `template: null`) | + +- field อื่นปนมา = reject (allowlist ตาม convention ของ repo) +- secret ปัจจุบัน = `"super_secret"` — **e-Court + `ADDIN_TICKET_SECRET` (server) + + `NEXT_PUBLIC_ADDIN_TICKET_SECRET` (client) ต้องตรงกันทั้งสาม** +- ⚠️ **custom property ของ Word จำกัด value ~255 ตัวอักษร** — JSON ของ `ticket_data` + ต้องออกแบบสั้น (fid/tid/uname ยาวมากจะทะลุ; ฝั่ง addin เจอค่าเกิน = ถือว่าไฟล์เสียหาย → no-access) + +## 3. ฝั่ง server — `POST /api/documents/token` รับ ticket เพิ่ม + +Branch ตาม header (ตัวตั้ง = `x-api-key`): + +| เคส | พฤติกรรม | +|---|---| +| มี header `x-api-key` | **ทางเดิมทุกอย่าง** — `requireDocverApiKey` + `parseTokenRequestBody` (body allowlist `userid`/`username`/`fid`/`template`, ส่ง field ticket ปนมา = 400 ตาม allowlist เดิม) | +| ไม่มี `x-api-key` + body `{ticket_data: string, HmacSha256: string}` | **ทางใหม่** — `verifyAddinTicket` → map claims → `issueDocverToken` → response รูปเดียวกัน `{access_token, token_type, expires_in}` | +| ไม่มี `x-api-key` + body ไม่ใช่ object / มี field อื่นปน / field ไม่ใช่ string | 400 (รูปผิดก่อนถึงการ verify) | +| HMAC ผิด / parse ticket ไม่ผ่าน / `exp` หมดอายุ | 401 **ข้อความเดียวกันทุกสาเหตุ** (กัน oracle — addin รู้สาเหตุจริงจากการตรวจเองฝั่ง client อยู่แล้ว) | +| ไม่มี `x-api-key` และไม่มี ticket fields เลย | 401 | +| `DOCVER_TOKEN_SECRET` ไม่ตั้ง | 500 (เดิม) | + +- การเทียบ digest ฝั่ง server: hash ทั้งสองฝั่งด้วย SHA-256 แล้ว `timingSafeEqual` — pattern + `verifyDocverToken` ของ `lib/docver-token.ts` เป๊ะ +- middleware ยกเว้น `api/documents/*` อยู่แล้ว — ไม่ต้องแต้ + +## 4. โค้ดแชร์ — `utils/docver-ticket.ts` (pure, ไม่มี dependency เลย) + +```ts +export interface DocverTicket { exp: number; fid: string; tid: string | null; uid: string; uname: string } +export function parseDocverTicket(raw: string | unknown): { ok: true; ticket: DocverTicket } | { ok: false; error: string } +export function isTicketExpired(exp: number, nowSec?: number): boolean // exp <= now +export function normalizeHexDigest(value: string): string | null // trim+lowercase+ตรวจ ^[0-9a-f]{64}$ +export function timingSafeEqualHex(a: string, b: string): boolean // constant-time บน hex ที่ normalize แล้ว +export type HmacSha256Hex = (message: string, secret: string) => Promise // adapter ที่สองฝั่งฉีด +``` + +- `lib/` (server) กับ `wordaddin/` (client) ใช้ `parseDocverTicket`/`isTicketExpired` ตัวเดียวกัน — + schema drift กันได้จากฝั่งเดียว + +## 5. ฝั่ง addin — flow ตอนเปิดเอกสาร (map ขั้นตอน 1–7 ของ requirement) + +`TaskpaneApp.detect()` → `authService.signInWithTicket({ticketData, ticketHmac})`: + +``` +1. อ่าน properties ticket_data + HmacSha256 (readTrackedProperties) +2. ขาดข้อใดข้อหนึ่ง / ค่ายาวเกิน 255 → no-access "ไม่พบ ticket ของ e-Court ในไฟล์" + parseDocverTicket ไม่ผ่าน → no-access "ไฟล์ถูกแก้ไข" + HMAC (Web Crypto + NEXT_PUBLIC_ADDIN_TICKET_SECRET) ไม่ตรง → no-access "ไฟล์ถูกแก้ไข" +3. session = localStorage["wordaddin-auth"] (fallback memory) +4. ไม่มี session หรือ uid ≠ session.userId (user ใหม่): + · ticket หมดอายุ → no-access "ticket หมดอายุ" + · เคลียร์ session ทั้งก้อน → ขอ token (ทาง ticket ของ /token) → fail → no-access "ขอ token ไม่สำเร็จ" + · เก็บ session ใหม่ {userId: uid, userName: uname, tokens: {[fid]: {token, exp}}} +5. uid ตรงกัน (คนเดิม): + · tokens[fid] มี (กลับมาทำเอกสารเดิม) → ผ่านเลย ไม่ตรวจ ticket exp (ตามเอกสาร) + — token หมดอายุ + ticket ยังไม่หมด → renew เงียบ ๆ ก่อน (D6) + — token หมดอายุ + ticket หมดด้วย → เข้า UI ได้แต่ API จะ 401 → renew fail → no-access ตอนใช้งาน + · tokens[fid] ไม่มี (เอกสารใหม่) → ตรวจ exp แล้วขอ token เก็บเหมือนข้อ 4 +6. ตั้ง state ภายใน (fid/token/username/ticket ดิบไว้ renew) → ไหลต่อ phase + untracked/tracking เดิม (SavedByAddIn → history) ไม่เปลี่ยน +``` + +- `authService` surface ใหม่: `signInWithTicket` / `getAccessToken` (token ของ fid ปัจจุบัน) / + `renewTokenFromTicket` / `getUsername` — ถอด `signInFromDocument` + `decodeJwtField` สำหรับ uid + (ticket มี uid/uname ตรง ๆ แล้ว เหลือ decode เฉพาะ `exp` ของ JWT ตอนเก็บ token) +- `apiClient` ตอนโดน 401: `renewTokenFromTicket()` → สำเร็จ = retry request 1 ครั้ง → ยัง 401/ไม่มี + ticket = `AuthRequiredError` (UI ไป no-access — เดิมมีอยู่แล้ว) +- `?addindemo` ยังใช้ได้ (`signInForDemo` คงเดิม) + +## 6. ไฟล์ที่สร้าง/แต้/ถอด + +**สร้าง** +- `utils/docver-ticket.ts` — §4 +- `lib/addin-ticket.ts` — server-only: `addinTicketSecret()` (env `ADDIN_TICKET_SECRET` trim หรือ default + `"super_secret"`) + `verifyAddinTicket(ticketData, hmacHex, secret, nowSec?)` (HMAC `node:crypto` + + timing-safe + parse + exp) + `ticketToDocverClaims(ticket)` — ห้าม import `@/db`/minio (unit test รันได้เปล่า ๆ) +- `wordaddin/services/ticketService.ts` — client: `verifyTicketHmacWeb` (crypto.subtle), session store + (`loadSession`/`saveSession`/`clearSession` — try/catch + memory fallback), `requestDocverToken` + (POST `withBasePath("/api/documents/token")` body ticket) +- `scripts/make-ticket-docx.mjs` — §9 +- `tests/utils/docver-ticket.test.ts`, `tests/lib/addin-ticket.test.ts` (vitest — pattern `tests/lib/docver-token.test.ts`) + +**แต้** +- `app/api/documents/token/route.ts` — branch ตาม §3 +- `wordaddin/config.ts` — `ticketSecret: process.env.NEXT_PUBLIC_ADDIN_TICKET_SECRET ?? "super_secret"` +- `wordaddin/services/metadataService.ts` — ถอด `ECOURT_TOKEN_PROPERTY`/`ECOURT_OWNER_PROPERTY` → + `TICKET_DATA_PROPERTY = "ticket_data"` + `TICKET_HMAC_PROPERTY = "HmacSha256"` (`readTrackedProperties` + อ่านคู่นี้แทน `ecourtToken`/`ecourtOwner`) +- `wordaddin/services/authService.ts` — rewrite ตาม §5 +- `wordaddin/services/apiClient.ts` — renew-retry ตอน 401 +- `components/wordaddin/TaskpaneApp.tsx` — `detect()` เรียก `signInWithTicket` + ข้อความ no-access 3 แบบ +- `lib/openapi.ts` — POST /token มี 2 รูป body (oneOf: identity+x-api-key / ticket) +- `.env.example`, `docs/WORDADDIN-DEV.md`, `docs/addin-ui-flow.md`, `docs/PLAN-DOCVER.md` (§token ชี้มาที่นี่), `CLAUDE.md` + +**ถอด** +- ระบบ `token`/`owner` ทั้งเส้น (properties + `signInFromDocument` + `decodeJwtField` ส่วน uid) — + แทนด้วย ticket เต็มตัว + +## 7. Env + +| env | default | หมายเหตุ | +|---|---|---| +| `ADDIN_TICKET_SECRET` | `SECRET` ของกลุ่ม template → `"super_secret"` | server ตรวจ HMAC ทาง ticket ของ /token — อ่านตามลำดับ `ADDIN_TICKET_SECRET` → `SECRET` (deployment เดียวกับตัว stamp ของกลุ่ม template มักตั้งไว้แล้ว) → `"super_secret"` · **production ต้องตั้งค่าใหม่** (ค่า default รู้กันหมด = ปลอม ticket ได้) และต้องตรงกับฝั่ง e-Court · ห้าม log ค่าดิบ | +| `NEXT_PUBLIC_ADDIN_TICKET_SECRET` | `"super_secret"` | ฝั่ง addin (UX gate) — inline ลง bundle · ต้องตรงกับฝั่ง e-Court เช่นกัน | + +> หมายเหตุจากตอน implement: ตัว stamp ticket จริงคือกลุ่ม template +> (`app/api/template/render/route.ts` → `applyTemplate` — sort key ตามตัวอักษรหลังเติม +> `exp` แล้ว HMAC hex lowercase ผ่าน `lib/lib-utils.ts` + stamp ลงไฟล์ด้วย +> `setCustomDocProps` ของ `lib/lib-tmpl.ts` อ่าน env `SECRET` กับ `TICKET_SEC` default +> 300 วิ — ไฟล์ยังมี property `Ed25519` เพิ่มด้วยแต่ out of scope ของแผนนี้) + +(เลือก default แทน fail-closed ตาม requirement ที่ระบุค่าปัจจุบันไว้ — dev ใช้ได้ทันที +แต่ comment เตือน production ชัด ๆ ทั้ง `.env.example` และแผนนี้) + +## 8. Edge cases + +- **property ยาวเกิน 255** → ไฟล์เสียหาย → no-access (Word ตัดค่าทิ้งจะ parse/HMAC ไม่ผ่านอยู่แล้ว — + เช็คความยาวเพื่อข้อความที่ชัดกว่า) +- **localStorage ถูก block** (webview บางตัว/private mode) → session อยู่ใน memory ต่อ session เดียว + (เปิดใหม่เริ่มใหม่ ขอ token ใหม่ — ยอมรับได้) +- **uname ไทย** — เป็น string ตรง ๆ ไม่ผ่าน base64 ไม่มีปัญหา mojibake (ต่างจาก decode JWT payload) +- **exp == now** → หมดอายุ +- **401 จาก endpoint อื่นระหว่างใช้งาน** → renew 1 ครั้ง → retry → ยังไม่ผ่าน → no-access +- **Word เปิดหลายเอกสารพร้อมกัน (user เดียวกัน fid ต่างกัน)** — tokens map รองรับ; current fid เป็น + state ต่อ taskpane instance (memory) — แยกกันอยู่แล้ว +- **ไฟล์ทั่วไปไม่มี ticket** → no-access เหมือนเดิม (ข้อความเดิมปรับคำ) + +## 9. สคริปต์ทดสอบ — `scripts/make-ticket-docx.mjs` + +Dev tool รันมือ `node scripts/make-ticket-docx.mjs [options]`: + +- option: `--fid --uid --uname --tid --exp --secret ` และ + `--tracked` (stamp `SavedByAddIn`+`DocumentTrackingId` เพื่อทดสอบ phase tracking ด้วย) +- ทำงาน: สร้าง JSON ticket → HMAC-SHA256 hex → เขียน custom properties ลง `docProps/custom.xml` + ผ่าน **pizzip** (dependency อยู่แล้วจากกลุ่ม template) — สร้าง custom.xml เองถ้าไฟล์ยังไม่มี + (พร้อม override ใน `[Content_Types].xml`) · เขียนทับไฟล์เดิม**เฉพาะเมื่อส่ง `--in-place`** + ไม่งั้นเขียนไฟล์ใหม่ `.ticket.docx` (กฎ non-destructive ผูกกับ `public/` เท่านั้นแต่ถือหลักเดียวกัน) +- default secret/exp สอดคล้อง .env ตัวอย่าง + +## 10. Verify criteria + +1. `npx vitest run` ผ่านทั้งชุด (ไฟล์ใหม่ + เดิม — โดยเฉพาะ `tests/lib/docver-token.test.ts` ไม่พัง) +2. `npx tsc --noEmit` ผ่าน +3. curl regression ที่ /token: (ก) `x-api-key` + identity body ออก token ได้เหมือนเดิม + (ข) ticket body ออก token ได้ (ค) HMAC ผิดกับ exp หมด = 401 ข้อความเดียวกัน (ง) body ปนกัน = 400 +4. ทดสอบใน Word จริง (sideload ตาม `docs/WORDADDIN-DEV.md`) ด้วยไฟล์จาก make-ticket-docx: + ไฟล์ถูกต้อง → ใช้ได้ ชื่อผู้ใช้ = uname · แก้ `ticket_data` 1 ตัวอักษร → no-access "ไฟล์ถูกแก้ไข" · + exp อดีต → no-access "ticket หมดอายุ" · เปิดเอกสารเดิมซ้ำ → ไม่ยิง /token ซ้ำ (ใช้ token เดิม) · + ตั้ง `DOCVER_TOKEN_TTL_SECONDS` สั้น ๆ แล้วเปิดซ้ำหลังหมดอายุ → renew อัตโนมัติใช้ต่อได้ · + เปิดไฟล์ uid คนละคน → session เดิมถูกเคลียร์ +5. รัน `plan-reviewer` + `code-reviewer` ตามกติกา `.claude/` + +## 11. ลำดับงาน + +1. `utils/docver-ticket.ts` + `tests/utils/docver-ticket.test.ts` +2. `lib/addin-ticket.ts` + `tests/lib/addin-ticket.test.ts` +3. `app/api/documents/token/route.ts` + `lib/openapi.ts` → verify 10.3 ด้วย curl +4. `wordaddin/config.ts` + `metadataService.ts` (properties) +5. `ticketService.ts` + `authService.ts` (rewrite) +6. `TaskpaneApp.tsx` (detect + ข้อความ) + `apiClient.ts` (renew-retry) +7. `scripts/make-ticket-docx.mjs` +8. env/docs/CLAUDE.md sync → verify 10.1–10.5 + +## 12. Out of scope + +- ~~ปลด mock `versioningService`~~ (ทำแล้ว 2026-10-27 — `versioningService` ยิงกลุ่ม docver จริงผ่าน Bearer same-origin; mock เหลือเฉพาะ `?addindemo` ดู `docs/WORDADDIN-DEV.md`) +- ~~ความไม่ตรงกันของ `documentId` (GUID ที่ stamp) กับ `docId` (= fid)~~ (ยุติแล้ว 2026-10-27 — เอกสารระบุด้วย fid ใน token ฝั่งเดียว; พารามิเตอร์ documentId ของ versioningService เหลือตาม signature เดิมไม่ส่งถึง server) +- UI จัดการ session/ออกจากระบบ, refresh token แบบมี revoke, ฝั่ง e-Court stamp (เขาทำ — เราส่ง §2 ให้) diff --git a/docs/PLAN-DOCVER.md b/docs/PLAN-DOCVER.md index 771669a..64de641 100644 --- a/docs/PLAN-DOCVER.md +++ b/docs/PLAN-DOCVER.md @@ -1,20 +1,29 @@ # PLAN-DOCVER — Document Versioning API (stand-alone) -> วันที่ตกลงแผน: 2026-10-20 · สถานะ: implement รอบแรก (API ก่อน — ยังไม่ต่อ wordaddin) +> วันที่ตกลงแผน: 2026-10-20 · เพิ่ม auth ด้วย access_token: 2026-10-22 · สถานะ: implement +> รอบแรก (API ก่อน) · **ปลด mock wordaddin แล้ว 2026-10-27** — `versioningService` +> ยิงกลุ่มนี้จริงผ่าน Bearer (mock เหลือเฉพาะ `?addindemo`) ## 0. บริบท/เป้าหมาย ทำ backend จริงของฟีเจอร์ **"e-Court Documents Versioning"** (ตอนนี้ wordaddin ใช้ mock ใน `wordaddin/services/versioningService.ts`): -- รับ `docId` จากผู้เรียก → ตารางเอกสารที่ `docId` **ห้ามซ้ำ** (unique index) +- ตารางเอกสารคีย์ด้วย `docId` **ห้ามซ้ำ** (unique index) — **`docId` = claim `fid` + (string) จาก Bearer token ตรง ๆ** (2026-10-26 ถอด path param `{docId}` ออกจาก URL ทุก + endpoint — fileId ของ e-Court ใน token เป็นที่มาเดียวของรหัสเอกสาร) - แต่ละ version อ้าง **object ใน MinIO** — เก็บทั้ง `.docx` และ `.pdf` (pdf เป็น optional/best-effort ตาม contract ของ add-in — `pdf.size === 0` = ไม่มี, มี `hasPdf` บอกใน response) - เก็บ `userId`, `userName`, `createdAt` ต่อ version เพื่อรู้ว่าใครอัปโหลด -- **endpoint รับ `userId`/`userName` ใน request** เพราะเป็นระบบ stand-alone ไม่มี session - ร่วมกับใคร (ผู้เรียกคือ add-in ใน Word หรือระบบภายนอก — identity ส่งมาแบบ plain field) -- **ไม่มี auth** — เปิดกว้างเหมือนกลุ่ม `api/template` (intranet) · ไม่มี CORS +- **identity (`userId`/`userName`/`templateId`) และ `docId` แกะจาก Bearer token** (2026-10-22 + — เดิมส่ง plain field ใน multipart): ขอ token ที่ `POST /api/documents/token` ด้วย header + `x-api-key` แล้วแนบ `Authorization: Bearer ` กับทุก request — ระบบ stand-alone + ไม่มี session ร่วมกับใคร (ผู้เรียกคือ add-in ใน Word หรือระบบภายนอก) token จึงเป็น + พาหะ identity เดียว +- **auth ทุก endpoint ของกลุ่มนี้** = Bearer JWT HS256 เซ็นด้วย `DOCVER_TOKEN_SECRET` + (ออก token ผ่าน `x-api-key` เทียบ env `DOCVER_API_KEY` — pattern `lib/external-api-auth.ts` + ของ N10) · ไม่มี CORS ข้อตกลงกับผู้ใช้ (2026-10-20): ทำ API ก่อน **ไม่แต้ wordaddin รอบนี้** — contract ตรง surface ที่ mock คงไว้เป๊ะ วันหน้าสลับของจริงแค่ตั้ง `NEXT_PUBLIC_ADDIN_API_BASE_URL` แล้วก้อบ body @@ -28,7 +37,41 @@ Contract อ้างอิง: `docs/addin-ui-flow.md` §7 + `wordaddin/service ## 1. Endpoint (URL เต็ม = `/docedit/api/documents/…` — prefix ใหม่ ได้รับยกเว้นจาก middleware เหมือน `api/template`) -### `POST /api/documents/{docId}/versions` — อัปโหลด version ใหม่ +### `POST /api/documents/token` — ขอ access_token (2026-10-22) + +auth: header `x-api-key` เทียบ env `DOCVER_API_KEY` (ไม่ตั้ง/ว่าง = 401 fail closed · +ไม่ใส่/ผิด = 401 ข้อความเดียวกันเป๊ะ กัน enumerate) — ตรวจก่อนอ่าน body เสมอ + +**ทางเข้าที่สอง (2026-10-27, add-in ใน Word — PLAN-ADDIN-AUTH.md):** ไม่มี header +`x-api-key` + body `{ticket_data, HmacSha256}` (ชื่อ field เหมือน custom properties +ในไฟล์) — server ตรวจ HMAC-SHA256(secret, ticket_data ดิบ) + exp ผ่าน +`lib/addin-ticket.ts` (env `ADDIN_TICKET_SECRET` → `SECRET` → default `"super_secret"`) +แล้วออก token จาก claims ใน ticket (`uid→userid`, `uname→username`, `fid`, `tid→template`) +· response/error รูปเดียวกับทางแรกทุกอย่าง (HMAC ผิด/หมดอายุ/ไม่ส่งมา = 401 ข้อความ +เดียวกัน · body ผิดรูป = 400) + +JSON body (allowlist — key อื่น = 400 กัน typo): + +| field | type | หมายเหตุ | +|---|---|---| +| `userid` | string | บังคับ — trim 1–100 (claim `userid` → column `user_id`) | +| `username` | string | บังคับ — trim 1–200 (claim `username` → column `user_name`) | +| `fid` | string | **บังคับ** — trim 1–200 · **fileId ของ e-Court** เป็น `docId` ของทุก operation ตรง ๆ · verify ไม่รับ token ที่ไม่มี fid | +| `template` | string | optional ≤100 (claim `template` → column `template_id` ตอน upload) | + +- env `DOCVER_TOKEN_SECRET` ไม่ตั้ง/ว่าง = **500** "DOCVER_TOKEN_SECRET ยังไม่ได้ตั้งค่า" + (ความผิด config ฝั่ง server ไม่ใช่ความผิดของผู้เรียก — และห้าม log ค่า secret) +- response 200: `{ "access_token": string, "token_type": "Bearer", "expires_in": number }` + — JWT HS256 stateless มี `iat`/`exp` (TTL env `DOCVER_TOKEN_TTL_SECONDS` default 3600) + · verify บังคับ alg=HS256 (กัน alg-confusion) และเทียบ signature แบบ timing-safe +- **endpoint อื่นของกลุ่มนี้ทั้งหมดต้องแนบ `Authorization: Bearer `** — + ไม่มี header / รูปผิด / signature ผิด / หมดอายุ / secret ไม่ตั้ง = 401 ข้อความไทย + เดียวกันทุกกรณี (ไม่เปิดให้ใช้ endpoint เป็น oracle รู้สาเหตุ) + +### `POST /api/documents/versions` — อัปโหลด version ใหม่ + +auth: `Authorization: Bearer` (ดู /token ด้านบน) — identity/templateId ของ row ใหม่และ +`docId` (= `fid` — string) มาจาก claims ของ token ทั้งหมด ไม่รับจาก URL/form อีกต่อไป multipart/form-data: @@ -36,22 +79,21 @@ multipart/form-data: |---|---|---| | `file` | File (.docx) | บังคับ — ≤ 100MB, magic bytes `PK\x03\x04` | | `pdf` | File (.pdf) | optional — `size === 0` = ถือว่าไม่มี (add-in แนบ blob เปล่าได้) | -| `userId` | string | **บังคับ** (stand-alone) — trim 1–100 | -| `userName` | string | **บังคับ** (stand-alone) — trim 1–200 | | `clientVersionId` | string | optional ≤100 — GUID ที่ client generate เอง | -| `fields` | string (JSON) | optional — map `{ [sdtTag]: text }` (≤100 keys, value ≤10,000) | +| `fields` | string (JSON) | optional — map `{ [sdtTag]: text }` (≤1,000 keys · **ความยาวค่าไม่จำกัด** 2026-10-27 ตามคำขอผู้ใช้ — เอกสาร 100–200 หน้า; jsonb รับได้ถึง 255MB) | | `message` | string | optional — commit message ≤2048 (trim ว่าง = NULL) | -| `templateId` | string | optional ≤100 | | `fileName` | string | optional — ชื่อไฟล์ดั้งเดิม (ผ่าน `decodeUploadFilename` แล้ว) | -- field ที่ไม่อยู่ในตาราง = **400 กัน typo เงียบ ๆ** (pattern `parseQueryBody` ของ N10) +- field ที่ไม่อยู่ในตาราง = **400 กัน typo เงียบ ๆ** (pattern `parseQueryBody` ของ N10) — + **breaking change 2026-10-22:** `userId`/`userName`/`templateId` ถอดออกจาก form แล้ว + (ส่งมา = 400) identity/template มาจาก Bearer token ของ request นั้นแทน - เอกสาร (`documents` row) สร้าง **แบบ implicit** ตอน upload version แรก — ไม่มี endpoint - "สร้างเอกสาร" แยก (ตาม flow ของ add-in ที่ generate documentId เองแล้วอัปโหลดทันที) + "สร้างเอกสาร" แยก (เอกสารถูกระบุที่ fid ใน token ตั้งแต่ขอ token) - response 200: `{ "hasPdf": boolean, "versionId": string, "versionNumber": number }` (= `UploadVersionResult` เป๊ะ) — `versionNumber` เป็นค่า **authoritative จาก server** (client เดา `latest+1` แล้วแก้ XML part ตัวเองเมื่อไม่ตรง — กรณีอัปโหลดชนกัน) -### `GET /api/documents/{docId}/versions` — history +### `GET /api/documents/versions` — history (ของเอกสาร fid ใน token) response: `DocumentVersionDTO[]` เรียง **ใหม่ → เก่า** (ตาม `VersionRecord[]` ของ add-in + ส่วนเสริม `createdByUserName`): @@ -70,13 +112,14 @@ response: `DocumentVersionDTO[]` เรียง **ใหม่ → เก่า } ``` -- `docId` ไม่รู้จัก (ยังไม่เคยมี version) = **404** (สัญญาณ REST ตรง ๆ แบบ N10 — UI ของ - add-in แสดง error + ปุ่มลองใหม่ ไม่พัง) +- `docId` (จาก fid ใน token) ไม่รู้จัก (ยังไม่เคยมี version) = **404** (สัญญาณ REST ตรง ๆ แบบ + N10 — UI ของ add-in แสดง error + ปุ่มลองใหม่ ไม่พัง) -### `GET /api/documents/{docId}/versions/{versionId}/download-link?format=docx|pdf` +### `GET /api/documents/versions/{versionId}/download-link?format=docx|pdf` - format ไม่ส่ง/"" = `docx` · ค่าอื่น = 400 -- query version row **เช็คทั้ง docId และ versionId พร้อมกัน** (กันโยน id ข้ามเอกสาร) — ไม่เจอ = 404 +- query version row **เช็ค docId (จาก fid ใน token) กับ versionId พร้อมกัน** (กันโยน id + ข้ามเอกสาร) — ไม่เจอ = 404 - `format=pdf` แต่ version นั้นไม่มี pdf = 404 "version นี้ไม่มีสำเนา PDF" - response 200: `{ "url": string, "expiresAt": string }` — url เป็น **MinIO presigned GET** (อายุตาม env `DOCVER_LINK_TTL_SECONDS` default 900 วิ) ให้ UI เปิดในเบราว์เซอร์จริงของ @@ -88,10 +131,11 @@ response: `DocumentVersionDTO[]` เรียง **ใหม่ → เก่า | เหตุ | สถานะ | |---|---| -| รูป docId/versionId/format ผิด · field ไม่รู้จัก · ไม่ใช่ multipart · magic bytes ผิด | 400 | +| รูป versionId/format ผิด · field ไม่รู้จัก (รวม userId/userName/templateId เก่า) · ไม่ใช่ multipart · magic bytes ผิด · body ขอ /token ผิดกติกา (รวมขาด fid) | 400 | +| `x-api-key` ไม่ตั้ง/ไม่ใส่/ผิด (ที่ /token) · Bearer ขาด/เน่า/หมดอายุ/secret ไม่ตั้ง (ทุก endpoint อื่น) | 401 | | ไฟล์เกิน 100MB (เช็ค `file.size` ก่อน buffer เสมอ — route ไม่มี `bodySizeLimit` คุม) | 413 | | เอกสาร/version ไม่มี · ขอ pdf ที่ version ไม่มี | 404 | -| MinIO env ไม่ตั้ง/ล้ม · DB ล้ม (หลังเก็บกวาด object กำพร้า) | 500 (log เต็มฝั่ง server + ข้อความกลาง ๆ ไทย) | +| MinIO env ไม่ตั้ง/ล้ม · DB ล้ม (หลังเก็บกวาด object กำพร้า) · `DOCVER_TOKEN_SECRET` ไม่ตั้ง (ที่ /token) | 500 (log เต็มฝั่ง server + ข้อความกลาง ๆ ไทย) | ## 2. ตาราง (db/schema.ts) @@ -156,6 +200,9 @@ read-only ของ N10 แต่ตัวนี้เขียนได้) | `MINIO_ACCESS_KEY` / `MINIO_SECRET_KEY` | — บังคับ | dev compose = `minioadmin` | | `MINIO_BUCKET` | `docver` | app สร้างเองตอน first use (`ensureBucket` — จับ race ข้าม process) | | `DOCVER_LINK_TTL_SECONDS` | `900` | อายุ presigned URL | +| `DOCVER_API_KEY` | — บังคับ | API key ของ `POST /api/documents/token` (header `x-api-key`) — ไม่ตั้ง/ว่าง = 401 fail closed · เทียบ timing-safe · ห้าม log ค่าดิบ | +| `DOCVER_TOKEN_SECRET` | — บังคับ | secret เซ็น/ตรวจ JWT HS256 — ไม่ตั้ง: /token = 500 · endpoint อื่น = 401 · ห้าม log ค่าดิบ | +| `DOCVER_TOKEN_TTL_SECONDS` | `3600` | อายุ access_token (วินาที) | `putObject` แนบ `Content-Type` + `Content-Disposition` (ชื่อไฟล์ไทยผ่าน `filename*=UTF-8''` best-effort + ASCII fallback `document.docx`/`document.pdf`) — presigned GET ได้ชื่อไฟล์สวย @@ -166,16 +213,19 @@ best-effort + ASCII fallback `document.docx`/`document.pdf`) — presigned GET - `db/schema.ts` — ตาราง + `DocumentVersionDTO`/`toDocumentVersionDTO` - `lib/document-versioning.ts` — pure validation (ห้าม import `@/db`/`minio` — unit test ได้ โดยไม่ต้องตั้ง env อะไรเลย ตาม pattern `lib/external-api-auth.ts`) +- `lib/docver-token.ts` — JWT HS256 issue/verify + `requireDocverApiKey`/`requireDocverBearer` + + `parseTokenRequestBody` (pure เหมือนกัน — ไม่ import `@/db`/`minio`) - `lib/docver-store.ts` — MinIO client (เก็บบน `globalThis` ใน dev แบบ `db/index.ts`) + `ensureBucket` + put/remove/presign + `insertVersionRecord` (tx) + query helpers -- `app/api/documents/[docId]/versions/route.ts` — POST + GET -- `app/api/documents/[docId]/versions/[versionId]/download-link/route.ts` — GET +- `app/api/documents/token/route.ts` — POST ขอ access_token (x-api-key) +- `app/api/documents/versions/route.ts` — POST + GET (docId = fid จาก token) +- `app/api/documents/versions/[versionId]/download-link/route.ts` — GET - `docker-compose.yml` — db (ชื่อ/วอลุ่มเดิมกับ `docker run` ใน README) + minio (โฮสต์ 19000 API / 19001 console — ข้างใน container 9000/9001; image จาก quay.io) -- `tests/lib/document-versioning.test.ts` — unit test ส่วน pure +- `tests/lib/document-versioning.test.ts` + `tests/lib/docver-token.test.ts` — unit test ส่วน pure ## 8. Out of scope รอบนี้ -- ไม่แต้ `wordaddin/` หรือ client ใด ๆ (สลับ mock ทีหลังผ่าน `NEXT_PUBLIC_ADDIN_API_BASE_URL`) +- ~~ไม่แต้ `wordaddin/` หรือ client ใด ๆ~~ (ปลด mock แล้ว 2026-10-27 — `wordaddin/services/versioningService.ts` ยิงกลุ่มนี้จริง same-origin ผ่าน Bearer; ดู `docs/WORDADDIN-DEV.md` หัว "การรันกับ backend จริง") - ไม่มีหน้า UI ดูรายการเอกสาร/version ของกลุ่มนี้ · ไม่มี GC object กำพร้า · ไม่มี idempotency บน `clientVersionId` · ไม่มีการแปลง docx→pdf ฝั่ง server (Office.js ของ add-in ทำ) diff --git a/docs/WORDADDIN-DEV.md b/docs/WORDADDIN-DEV.md index 23af799..301bf33 100644 --- a/docs/WORDADDIN-DEV.md +++ b/docs/WORDADDIN-DEV.md @@ -4,7 +4,7 @@ Taskpane ของ Word add-in "e-Court Documents Versioning" พอร์ตม **ทางเข้า:** เปิด `/docedit` เปล่า ๆ จะ redirect มาที่ taskpane ทันที (ไม่ผ่าน login — คำขอผู้ใช้ 2026-10-14) ยกเว้นลิงก์ e-Court `/docedit/?fileUrl=&fileId=&typeId=` ที่ยังส่งต่อให้ `/note` ตามสัญญา N8 · manifest ชี้ `/docedit/wordaddin` ตรง ๆ (ไม่ว่าผ่าน root เพื่อลด hop ใน webview) -สถานะช่วงนี้: **auth และ API เป็น mock** (login ทันที + version store เก็บ metadata ค้างข้าม session ใน localStorage ของ taskpane เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ — สลับกลับของจริงด้วยการลบ `wordaddin-mock-versions` หรือเคลียร์ storage ของ origin) รอ backend/auth จริง — ดูหัว "การสลับกลับของจริง" ด้านล่าง +สถานะช่วงนี้: **ไม่มี login แล้ว** (ยกเลิก Keycloak 2026-10-27 — auth เข้าทางเดียวคือ **ticket ของ e-Court** (`ticket_data` + `HmacSha256` ในไฟล์): add-in ตรวจ HMAC เอง → ขอ token ที่ `/api/documents/token` → เก็บใน localStorage ตาม fid ดูหัว "ทดสอบ e-Court ticket" และแผน `docs/PLAN-ADDIN-AUTH.md`) และ **upload/download เป็นของจริงแล้ว** (ปลด mock 2026-10-27 — `versioningService` ยิงกลุ่ม `/api/documents/*` ผ่าน Bearer จาก ticket: Save & Version ขึ้น MinIO จริง ดาวน์โหลดเปิด presigned URL ในเบราว์เซอร์; เหลือ mock เฉพาะโหมด `?addindemo` เพื่อดู UI ใน browser โดยไม่ต้องมี backend — ดูหัว "การรันกับ backend จริง") ## ไฟล์หลัก @@ -12,8 +12,8 @@ Taskpane ของ Word add-in "e-Court Documents Versioning" พอร์ตม |---|---| | `app/wordaddin/page.tsx` + `components/wordaddin/WordAddinGate.tsx` | gate โหลด Office.js (self-host) → `Office.onReady` → mount `TaskpaneApp` | | `app/wordaddin/manifest.xml/route.ts` | serve manifest พร้อม **rewrite origin ตามโฮสต์ที่ขอ** (อ่าน `x-forwarded-proto`/`x-forwarded-host` ก่อนแล้ว fallback host ตรง ผ่าน `utils/request-origin.ts` ที่แชร์กับ origin ของ deep link N10 — โฮสต์ที่ไม่ใช่ localhost บังคับ https เพราะ Office รับ https เท่านั้น) | -| `components/wordaddin/TaskpaneApp.tsx` | state machine `checking/signed-out/untracked/tracking` + ทุก handler | -| `wordaddin/services/*` | ชั้น Office.js พอร์ตดิบจากต้นฉบับ + `authService`/`versioningService` เป็น mock | +| `components/wordaddin/TaskpaneApp.tsx` | state machine `checking/no-access/untracked/tracking` + ทุก handler | +| `wordaddin/services/*` | ชั้น Office.js พอร์ตดิบจากต้นฉบับ + `versioningService` เป็น mock (`authService` + `ticketService` = ticket auth จริง ไม่มี login — PLAN-ADDIN-AUTH.md) | | `public/wordaddin/manifest.template.xml` | template ของ manifest (ค่า default dev `https://localhost:3000`) — serve ผ่าน route ด้านบนเท่านั้น ไม่ได้ใช้ตรง ๆ | | `public/wordaddin/office-js/` | Office.js runtime — สร้างโดย postinstall `scripts/fetch-office-js.mjs` ดาวน์โหลดฉบับล่าสุดจาก CDN ของ Microsoft (**gitignore** — รัน `npm install` ทุกครั้งหลัง clone เครื่องต้องออกอินเทอร์เน็ตตอนติดตั้ง ส่วนตัวระบบ deploy ใช้ intranet ล้วน) | | `wordaddin/config.ts` | env `NEXT_PUBLIC_ADDIN_*` (ตารางด้านล่าง) | @@ -22,8 +22,9 @@ Taskpane ของ Word add-in "e-Court Documents Versioning" พอร์ตม | ตัวแปร | default | ใช้เมื่อไหร่ | |---|---|---| -| `NEXT_PUBLIC_ADDIN_API_BASE_URL` | `""` (ว่าง) | ปลด mock ต่อ backend จริง (ต้องเป็น HTTPS) | -| `NEXT_PUBLIC_ADDIN_MOCK_USERNAME` | `"tester01"` | ชื่อผู้ใช้ของ mock — แสดง header + เป็น `createdByUserId` | +| `NEXT_PUBLIC_ADDIN_API_BASE_URL` | `""` (ว่าง) | ปลด mock ต่อ backend จริง (ต้องเป็น HTTPS) — ไม่เกี่ยวกับการขอ token (ยิง same-origin `/docedit/api/documents/token` เสมอ) | +| `NEXT_PUBLIC_ADDIN_MOCK_USERNAME` | `"tester01"` | ชื่อ fallback ของโหมด `?addindemo` (แสดง header + เป็น `createdByUserId` ของ mock) | +| `NEXT_PUBLIC_ADDIN_TICKET_SECRET` | `"super_secret"` | secret ตรวจ HMAC ของ ticket ฝั่ง client (UX gate) — ต้องตรงกับตัว stamp ของ e-Court และ `ADDIN_TICKET_SECRET`/`SECRET` ฝั่ง server (PLAN-ADDIN-AUTH.md §7) · **production ต้องตั้งค่าจริงทั้งสองฝั่ง** | ## รัน dev ด้วย HTTPS (จำเป็นสำหรับ sideload ใน Word) @@ -52,21 +53,37 @@ Deploy จริง (intranet): **ไม่ต้อง rewrite อะไรแ ## ทดสอบใน browser ธรรมดา (ไม่ต้องเปิด Word) -- **`/docedit/wordaddin`** — เส้นทางจริง: Office.js โหลดได้แม่นนอก host (host เป็น null) → เห็น `signed-out` → กด Sign in (mock ผ่านทันที) → detect พังที่ `Word.run` → `bootError` + ปุ่มลองใหม่ (ตรวจ state machine/handler ได้ครบ) -- **`/docedit/wordaddin?addindemo=untracked`** / **`?addindemo=tracking`** — dev-only: ข้าม Office.js + sign in mock ทันที + ตั้ง phase ตามค่า (tracking มี history ตัวอย่าง 3 รายการ) — ทุกปุ่มกดได้ แต่ flow ที่แตะ Word จริง (Start Versioning / Save & Version / บันทึก) จะจบที่ error ตาม expected +- **`/docedit/wordaddin`** — เส้นทางจริง: Office.js โหลดได้แม้นอก host (host เป็น null) → `detect()` อ่าน custom properties ไม่ได้ (ไม่มี `Word.run`) → เห็น `no-access` — ตรวจ state machine ได้แค่นี้ใน browser ปกติ ส่วน phase `untracked`/`tracking` ต้องใช้ demo ด้านล่าง (หรือ sideload ใน Word จริง) +- **`/docedit/wordaddin?addindemo=untracked`** / **`?addindemo=tracking`** — dev-only: ข้าม Office.js + ตั้ง session mock ทันที + ตั้ง phase ตามค่า (tracking มี history ตัวอย่าง 3 รายการ) — ทุกปุ่มกดได้ แต่ flow ที่แตะ Word จริง (Start Versioning / Save & Version / บันทึก) จะจบที่ error ตาม expected - หมายเหตุ: ใน browser ปกติ (ไม่ใช่ demo) banner "บันทึกอัตโนมัติไม่สำเร็จ" จะโผล่หลัง ~30 วิ เพราะ auto-save (FR-17) พยายาม save ทุก 30 วิแต่ไม่มี Word — ถือว่าถูกต้อง -## ทดสอบ e-Court pass-through (ข้าม login) +## ทดสอบ e-Court ticket (auth ทางเข้าเดียว) -ไฟล์ที่ e-Court stamp custom properties `token` และ/หรือ `owner` ไว้ จะเข้าใช้ได้เลยโดยไม่ต้องกด Sign in — `detect()` อ่านค่าทั้งสองตอนเปิด task pane แล้วเรียก `authService.signInFromDocument()` (username ได้จาก `owner` → ถอด `uid` ใน JWT payload → `NEXT_PUBLIC_ADDIN_MOCK_USERNAME`, token จากไฟล์เก็บใน memory ให้ `getAccessToken()` ใช้ต่อ) +ไฟล์ที่ e-Court stamp custom properties **`ticket_data`** (JSON `exp`/`fid`/`tid`/`uid`/`uname`) + **`HmacSha256`** (HMAC-SHA256 ของ string ดิบ ด้วย secret ปัจจุบัน `super_secret`) ไว้ จะใช้ได้เลย — ไม่มี login ให้กด: `detect()` อ่านคู่นี้ตอนเปิด task pane แล้วเรียก `authService.signInWithTicket()` ตาม flow ของ `docs/requirement/addin-workflow.md` (ตรวจ HMAC ฝั่ง client → ตรวจ exp → ดู session ใน localStorage `wordaddin-auth` ตาม uid/fid → ขอ access_token ที่ `/docedit/api/documents/token` แบบ body ticket → เก็บ token ตาม fid) · ไฟล์ที่ไม่มีคู่นี้ / HMAC ไม่ตรง / ticket หมดอายุ = phase `no-access` แยกข้อความตามสาเหตุ -ทดสอบเองใน Word โดยไม่ต้องรอ e-Court: เปิดไฟล์ → **File → Info → Properties → Advanced Properties → แท็บ Custom** → เพิ่ม property ชื่อ `token` (ค่า JWT ตัวอย่าง `eyJ...` — payload มี `uid` ก็แสดงเป็นชื่อผู้ใช้ได้) และ/หรือ `owner` (เช่น `u1001`) → เปิด task pane ใหม่ → ต้องเข้าเฟส untracked/tracking ทันทีไม่ผ่านหน้า login +ทดสอบเองใน Word โดยไม่ต้องรอ e-Court — สร้างไฟล์ทดสอบด้วยสคริปต์ (คำนวณ HMAC ตรงกับตัว stamp จริงของกลุ่ม template): -## การสลับกลับของจริง (วันหน้า) +```bash +# สร้าง .ticket.docx (ไม่แตะไฟล์เดิม) exp +5 นาที เท่า TICKET_SEC ของตัว stamp +node scripts/make-ticket-docx.mjs path/to/file.docx --fid DEMO_FID_001 --uid oom --uname "สรวิชญ์" --tid T12 +# ดู custom properties ที่มีในไฟล์ +node scripts/make-ticket-docx.mjs path/to/file.ticket.docx --list +# ทดสอบ phase tracking ด้วย (stamp SavedByAddIn + DocumentTrackingId เพิ่ม) +node scripts/make-ticket-docx.mjs path/to/file.docx --tracked --in-place +``` -- **Auth:** `wordaddin/services/authService.ts` เป็น mock คง surface เดิมครบ (`login/getAccessToken/refreshAccessToken/getUsername/signOut/startAutoRefresh/...`) — เขียน implementation จริงทับ (ต้นฉบับ Keycloak PKCE + Office Dialog API อยู่ที่ `D:\word-addin-poc\addin\src\services\authService.ts`; ถ้าใช้ ต้องเพิม DialogAPI กลับเข้า manifest + หน้า auth-start/auth-callback) · `signInFromDocument` (pass-through จาก token/owner ในไฟล์) เป็น mock-only — วันหน้า token ในไฟล์ควรเป็นแค่ตัวจับคู่เอกสาร ส่วนสิทธิ์ผู้ใช้พิสูจน์ตอน runtime -- **API:** `wordaddin/services/versioningService.ts` เก็บชื่อ/ลายเซ็นเหมือนต้นฉบับเป๊ะ — ก้อบ body เดิม (multipart POST ผ่าน `apiClient` ซึ่งพอร์ตไว้แล้ว) กลับมา + ตั้ง `NEXT_PUBLIC_ADDIN_API_BASE_URL` -- ชุด unit test ของ services (jest → vitest) ยังไม่พอร์ต — ต้นฉบับอยู่ที่ `D:\word-addin-poc\addin\src\services\*.test.ts` + mock ที่ `src/test/` +แล้วเปิดไฟล์ใน Word ที่ sideload แล้ว → ต้องเข้าเฟส untracked (หรือ tracking เมื่อ `--tracked`) ทันที ชื่อผู้ใช้ = `uname` · ทดสอบ fail-case: แก้ `ticket_data` ผ่าน **File → Info → Properties → Advanced Properties → Custom** สัก 1 ตัวอักษร → no-access "ไฟล์ถูกแก้ไข" · สร้างด้วย `--exp +1` รอ 1 นาทีแล้วเปิด → no-access "ticket หมดอายุ" · เปิดเอกสารเดิมซ้ำ (จน ticket หมดอายุแต่ token ยังอยู่ใน localStorage) → ยังใช้ได้ตาม requirement ขั้น 7 + +หมายเหตุ: การขอ token ยิง same-origin `/docedit/api/documents/token` จริง (ไม่ผูก `NEXT_PUBLIC_ADDIN_API_BASE_URL`) — dev server ต้องรันอยู่และ secret ฝั่ง server (`ADDIN_TICKET_SECRET` → `SECRET` → default `super_secret`) ตรงกับ `--secret` ของสคริปต์ + +## การรันกับ backend จริง (ปลด mock แล้ว 2026-10-27) + +- **Auth:** ไม่มี login — **ยกเลิก Keycloak ถาวร 2026-10-27** · auth ของ add-in คือ ticket ของ e-Court ผ่าน `signInWithTicket` (ticket_data + HmacSha256 ในไฟล์ — แผนเต็ม `docs/PLAN-ADDIN-AUTH.md`): add-in ตรวจ HMAC ฝั่ง client (UX gate) แล้วขอ access_token ที่ `/api/documents/token` ซึ่ง server ตรวจ HMAC+exp อีกชั้นด้วย secret ฝั่ง server · โดน 401 กลาง flow = ลอง renew จาก ticket 1 ครั้ง ยังไม่ผ่าน = `AuthRequiredError` → หน้า `no-access` (ticket ต่ออายุไม่ได้ — ต้องได้ไฟล์ใหม่จาก e-Court) +- **Upload/download ของจริงเป็น default แล้ว:** `wordaddin/services/versioningService.ts` ยิงกลุ่ม `/api/documents/*` ผ่าน `apiClient` (Bearer จาก ticket) — **ไม่ต้องตั้ง env อะไรเพิ่ม** เพราะ `apiClient.toUrl` ใช้ same-origin `withBasePath("/api/documents/…")` เมื่อ `NEXT_PUBLIC_ADDIN_API_BASE_URL` ว่าง (API ของกลุ่ม docver อยู่แอปนี้เอง) · ตั้งค่า env นั้นเฉพาะวันที่ deploy add-in กับ API คนละ origin (ต้องรวม basePath เช่น `https://host/docedit` และเป็น HTTPS) + - **เอกสารถูกระบุด้วย fid ใน token** — พารามิเตอร์ `documentId` (GUID ที่ stamp ในไฟล์) ของ uploadVersion/getVersions/getDownloadLink เหลือไว้ตาม signature เดิม ไม่ถูกส่งถึง server · templateId ก็เช่นกัน (มาจาก claims ของ token — ส่งใน form = 400) +- **สิ่งที่ต้องรันฝั่ง server ก่อนใช้จริง:** MinIO (`docker compose up -d minio` — bucket `docver` app สร้างเอง) + env `DOCVER_API_KEY`/`DOCVER_TOKEN_SECRET`/`MINIO_*` ตาม `.env.example` ของกลุ่ม docver (docs/PLAN-DOCVER.md §6) · ทดสอบวงเต็ม: สร้างไฟล์ด้วย `make-ticket-docx.mjs` → เปิดใน Word → Save & Version → version ขึ้น MinIO จริง → กดดาวน์โหลด/PDF เปิด presigned URL ในเบราว์เซอร์ (โฮสต์ MinIO ต้องเข้าถึงได้จากเครื่องผู้ใช้) +- **mock เหลือเฉพาะโหมด `?addindemo`** (dev-only — ดู UI ใน browser ไม่ต้องมี backend: version เก็บในเครื่อง metadata ใน localStorage `wordaddin-mock-versions`, download-link คืน about:blank — เคลียร์ด้วยการลบ key นี้หรือ clear storage ของ origin) +- ชุด unit test ของ services: ต้นฉบับ jest อยู่ที่ `D:\word-addin-poc\addin\src\services\*.test.ts` — ฝั่งนี้เขียนใหม่เป็น vitest เฉพาะส่วนที่เป็นโค้ดใหม่ (ticket auth + versioningService สองโหมด ที่ `tests/wordaddin/`) ## Docker diff --git a/docs/addin-ui-flow.md b/docs/addin-ui-flow.md index 83ef6da..7739cb5 100644 --- a/docs/addin-ui-flow.md +++ b/docs/addin-ui-flow.md @@ -10,32 +10,33 @@ Task pane ทั้งหมดเป็น state machine เดียว **ไม่มี routing** — component เดียว (`App`) สลับหน้าตาตาม `phase`: -ตั้งแต่ 2026-10-19 taskpane มี **2 แท็บ** (toggle กลุ่มปุ่ม `aria-pressed` ใต้ header — แสดงเฉพาะ phase `untracked`/`tracking`): **Versioning** คือทุกอย่างในเอกสารนี้ตามเดิม ส่วน **เครื่องมือ Template** (ดูหัวข้อ 10) คือเครื่องมือจัดการ Content Controls ฝั่ง Office.js ล้วน ไม่ยิง backend จึงใช้ได้ทั้งสอง phase ปุ่ม toggle **ทั้งสองปิดระหว่าง flow ที่เขียนเอกสาร** — `saving || starting` (versioning), `saveBusy` (บันทึก local/ปิดเอกสาร), `templateBusy` (operation ของแท็บ template รายงานผ่าน `onBusyChange` — กันสลับกลาง operation แล้ว flow versioning มา stamp/capture ซ้อน หรือกลับกัน; code review 2026-10-20) · สถานะแท็บรีเซ็ตกลับ `versioning` ตอน sign out / AuthRequiredError กัน surprise หลัง login ใหม่ · banner auto-save error (FR-17) ยกไว้เหนือ toggle ให้เห็นทั้งสองแท็บ +ตั้งแต่ 2026-10-19 taskpane มี **2 แท็บ** (toggle กลุ่มปุ่ม `aria-pressed` ใต้ header — แสดงเฉพาะ phase `untracked`/`tracking`): **Versioning** คือทุกอย่างในเอกสารนี้ตามเดิม ส่วน **เครื่องมือ Template** (ดูหัวข้อ 10) คือเครื่องมือจัดการ Content Controls ฝั่ง Office.js ล้วน ไม่ยิง backend จึงใช้ได้ทั้งสอง phase ปุ่ม toggle **ทั้งสองปิดระหว่าง flow ที่เขียนเอกสาร** — `saving || starting` (versioning), `saveBusy` (บันทึก local/ปิดเอกสาร), `templateBusy` (operation ของแท็บ template รายงานผ่าน `onBusyChange` — กันสลับกลาง operation แล้ว flow versioning มา stamp/capture ซ้อน หรือกลับกัน; code review 2026-10-20) · สถานะแท็บรีเซ็ตกลับ `versioning` ตอนเข้า `no-access` กัน surprise · banner auto-save error (FR-17) ยกไว้เหนือ toggle ให้เห็นทั้งสองแท็บ + +**ไม่มี login ตั้งแต่ 2026-10-27** (ยกเลิก Keycloak ตามคำขอผู้ใช้) — auth ทางเข้าเดียวคือ **ticket ของ e-Court**: `detect()` อ่าน custom properties `ticket_data` + `HmacSha256` ที่ e-Court stamp มากับไฟล์ แล้วเรียก `authService.signInWithTicket()` — ตรวจ HMAC ฝั่ง client → ตรวจ exp → ดู session ใน localStorage ตาม uid/fid → ขอ access_token ที่ `/api/documents/token` เก็บตาม fid (flow เต็ม: `docs/requirement/addin-workflow.md` + แผน `docs/PLAN-ADDIN-AUTH.md`) ``` -checking ──(ไม่มี token)──────────────→ signed-out +checking ──(ไม่มี ticket / HMAC ไม่ตรง / ticket หมดอายุ / ขอ token ไม่สำเร็จ)──→ no-access │ - ├─(มี token + ไม่ใช่ tracked doc)──→ untracked - └─(มี token + tracked doc)────────→ tracking + ├─(ticket ผ่าน + ไม่ใช่ tracked doc)──→ untracked + └─(ticket ผ่าน + tracked doc)────────→ tracking ``` การเปลี่ยน phase อื่นๆ: -- `signed-out` → (sign in สำเร็จ) → `checking` → ตัดสินใหม่ตามไฟล์ปัจจุบัน - `untracked` → (Start Versioning สำเร็จ) → `tracking` -- ทุก phase → (401 ที่ refresh token ไม่ช่วย / กดออกจากระบบ) → `signed-out` -- ปุ่ม "ลองใหม่" มีจริงแค่ 2 จุด: `bootError` ใน `checking` และ history error ใน `VersionHistoryPanel` — `untracked`/`tracking` **ไม่มี**ปุ่มลองใหม่แยกต่างหาก (เริ่ม flow ใหม่ด้วยการกดปุ่ม flow ซ้ำ) · กลไกเดียวที่วิ่งกลับมา `checking` คือ sign-in สำเร็จ +- ทุก phase → (ไม่มี ticket ตอน detect ใหม่ / 401 หลังพยายาม renew จาก ticket แล้ว = ticket หมดอายุไม่มีทางต่ออายุ) → `no-access` +- ปุ่ม "ลองใหม่" มีจริงแค่ 2 จุด: `bootError` ใน `checking` และ history error ใน `VersionHistoryPanel` — `untracked`/`tracking` **ไม่มี**ปุ่มลองใหม่แยกต่างหาก (เริ่ม flow ใหม่ด้วยการกดปุ่ม flow ซ้ำ) State ที่ UI ถือนอกเหนือจาก phase: | State | ความหมาย | |---|---| | `activeTab` | แท็บที่เปิดอยู่ `versioning` (default) / `template` — ดูหัวข้อ 10 | -| `username` | ชื่อผู้ใช้จาก token (แสดงใน header) | +| `username` | ชื่อจาก `uname` ของ ticket — แสดงเป็น chip เฉย ๆ ใน header | | `documentId` | tracking id ของเอกสาร (มีเฉพาะ `tracking`) | | `documentTemplateId` | template ต้นทางของ**ไฟล์ร่าง** (มีเฉพาะ `untracked` ที่เป็นไฟล์ร่าง — FR-16) | | `versions` + `historyLoading` + `historyError` | version history ของ `documentId` | -| `signingIn`, `loginError` | สถานะหน้า sign-in | +| `noAccessNotice` | ข้อความบนหน้า `no-access` — ต่างกันตามสาเหตุ (ไม่มี ticket ในไฟล์ / HMAC ไม่ตรง = ไฟล์ถูกแก้ / ticket หมดอายุ / ขอ token ไม่สำเร็จ) | | `starting`, `saving`, `progressMessage` | busy + ข้อความ progress ของ flow Start Versioning / Save & Version | | `confirmOpen`, `startConfirmOpen` | เปิด dialog ยืนยันของ flow ไหน | | `flowError`, `flowWarning`, `flowSuccess` | MessageBar 3 แบบของ flow หลัก (แสดงเฉพาะ `tracking`) | @@ -53,21 +54,22 @@ State ที่ UI ถือนอกเหนือจาก phase: ### Header (ทุก phase) - ชื่อแอป: **e-Court Documents Versioning** (semibold) -- ฝั่งขวา (เมื่อ login แล้วและไม่ใช่ `checking`/`signed-out`): ปุ่มเล็ก icon + `ออกจากระบบ` — username อยู่ใน `title`/`aria-label` (จอแคบ ไม่กินพื้นที่แถบหัว) — กดแล้ว sign out + กลับ `signed-out` +- ฝั่งขวา (เมื่อผ่าน ticket auth แล้วและไม่ใช่ `no-access`/`checking`): chip เล็กพื้น `canvas` แสดง `username` เฉย ๆ — ไม่ใช่ปุ่ม (ไม่มี login จึงไม่มีออกจากระบบ) · จอแคบตัดด้วย truncate ชื่อเต็มอยู่ใน `title` ### `checking` - `Spinner "กำลังตรวจสอบเอกสาร…"` ตรงกลาง - ถ้า detect พัง (`bootError`): MessageBar **error** + ปุ่ม `ลองใหม่` ข้างใน bar (รัน detect ใหม่) -### `signed-out` +### `no-access` -- ข้อความ: "เข้าสู่ระบบเพื่อเริ่มใช้งาน versioning" -- คำอธิบายจางๆ: "ใช้บัญชีของ realm `word-versioning` — หน้าต่าง login จะเปิดแยกต่างหาก" -- ปุ่ม primary `เข้าสู่ระบบ` → ระหว่างรันเปลี่ยนเป็น `กำลังเข้าสู่ระบบ…` + disable -- ถ้า login พัง: MessageBar **warning** (`loginError`) — เช่น "เซสชันหมดอายุ — กรุณา login ใหม่" ตอนโดน 401 กลาง flow - -> ใน project จริง login เปิดหน้าต่างแยกผ่าน Office Dialog API (ห้าม redirect iframe ไป Keycloak ตรงๆ) — ถ้าโปรเจกต์ใหม่ยังไม่มี auth ให้ mock `login()` คืน `{ ok: true }` ไปก่อน +- ข้อความ: "เอกสารนี้ยังใช้งาน add-in ไม่ได้" +- คำอธิบายจางๆ (`noAccessNotice` ตามสาเหตุ): + - ไม่มี ticket ในไฟล์: "ไม่พบ ticket ของ e-Court ในไฟล์ — add-in ใช้ได้กับเอกสารที่ส่งมาจาก e-Court เท่านั้น" + - ticket รูปผิด / HMAC ไม่ตรง: "ตรวจสอบ ticket ไม่ผ่าน — ไฟล์ถูกแก้ไขหรือเสียหาย" + - ticket หมดอายุ (ตอนเปิด หรือโดน 401 กลาง flow หลังพยายาม renew): "ticket ของ e-Court หมดอายุ — โปรดขอไฟล์ใหม่จาก e-Court แล้วเปิดอีกครั้ง" + - ขอ token ไม่สำเร็จ (server ลง/network): "ขอ token จากระบบไม่สำเร็จ — ตรวจการเชื่อมต่อแล้วเปิดเอกสารอีกครั้ง" +- **ไม่มีปุ่มใด ๆ** — ไม่มี login ให้กด (ยกเลิก Keycloak 2026-10-27; ขั้นตอนสำหรับเอกสารทั่วไปจะมีในอนาคต) ผู้ใช้ได้ไฟล์ใหม่จาก e-Court แล้วเปิดใหม่เท่านั้น ### `untracked` @@ -162,10 +164,10 @@ Dialog เดียวใช้ 2 flow (ปรับข้อความด้ ข้อความ flow (`flowSuccess`/`flowWarning`/`flowError`) ถูกเคลียร์เป็น null ทุกครั้งที่**เริ่ม** flow ใหม่ (Start Versioning / Save & Version / ดาวน์โหลด — ไม่ใช่ตอนจบ ไม่มี timeout) -### Detect (FR-1) — ตอนเปิด task pane / หลัง login / กดลองใหม่ +### Detect (FR-1) — ตอนเปิด task pane / กดลองใหม่ -1. ตรวจ token — ไม่มี → `signed-out` -2. อ่าน custom properties ครั้งเดียวทั้งชุด: `SavedByAddIn`, `DocumentTrackingId`, `LastVersionId`, `LastVersionTimestamp`, `TemplateId` +1. อ่าน custom properties ครั้งเดียวทั้งชุด: `ticket_data`, `HmacSha256`, `SavedByAddIn`, `DocumentTrackingId`, `LastVersionId`, `LastVersionTimestamp`, `TemplateId` +2. ticket auth (`signInWithTicket` — PLAN-ADDIN-AUTH.md §5): อ่านไฟล์ไม่ได้ / ไม่มี ticket / HMAC ไม่ตรง / ticket หมดอายุ (ตามเงื่อนไข uid/fid ของ session) / ขอ token ไม่สำเร็จ → `no-access` แยกข้อความตามสาเหตุ · ผ่าน = มี access_token ของ fid นี้เก็บใน localStorage `wordaddin-auth` แล้วไปต่อ 3. `tracked = (SavedByAddIn === GUID ของ add-in)`: - tracked **และมี** `DocumentTrackingId` → `tracking` + โหลด history - ไม่ track หรือ track แต่ id หาย → `untracked` (เก็บ `TemplateId` ไว้ใช้ตอน Start Versioning — ไฟล์ร่างอยู่กลุ่มนี้) @@ -200,7 +202,7 @@ dialog ยืนยัน → progress ทั้ง 7 ขั้นลำดั ### Auto-save (FR-17) -- เริ่มตั้งแต่ mount **ไม่รอ sign-in** +- เริ่มตั้งแต่ mount **ไม่ผูกกับ phase** (detect ยังไม่จบก็รันได้) - periodic ทุก 30 วิ: ไฟล์ dirty → save + ตั้ง flag `hasUncommitted`; สะอาด → ข้าม - save ล้ม → `autoSaveError` (warning bar); สำเร็จครั้งถัดไป → เคลียร์ bar - ทุก flow versioning ต้อง **suspend** auto-save ตอนเริ่มและ **resume** ตอนจบ (กัน save แทรกกลาง stamp/capture) @@ -251,17 +253,17 @@ interface VersionRecord { response: `{ url: string, expiresAt: string }` — UI เปิด `url` ในเบราว์เซอร์เครื่องผู้ใช้เท่านั้น -### Auth — OIDC PKCE ผ่าน Office Dialog API +### Auth — e-Court ticket (ไม่มี login) -`displayDialogAsync` เปิดหน้า login แยก → `messageParent` ส่งผลกลับ task pane · token เก็บ **ใน memory เท่านั้น** (ห้าม localStorage) · refresh token auto-refresh เงียบๆ จน 401 → สถานะ `AuthRequiredError` · mock ช่วงรอ: `login()` คืน `{ ok: true }`, `getAccessToken()` คืน token ปลอม, `getUsername()` คืนชื่อ test +ยกเลิก Keycloak OIDC/PKCE แล้ว (2026-10-27) — ไม่มี Office Dialog ไม่มีหน้า sign-in: e-Court stamp custom properties **`ticket_data`** (JSON `exp`/`fid`/`tid`/`uid`/`uname`) + **`HmacSha256`** (HMAC-SHA256 ของ string ดิบ ด้วย secret ที่ config ได้ — ปัจจุบัน `super_secret`) ลงไฟล์ตอนสร้าง แล้ว `signInWithTicket()` ใช้ได้ทันที · flow ตาม `docs/requirement/addin-workflow.md` (แผนเต็ม `docs/PLAN-ADDIN-AUTH.md`): ตรวจ HMAC ฝั่ง client (UX gate) → ตรวจ exp → session ใน localStorage `wordaddin-auth` ตาม uid (user ใหม่ = เคลียร์ session เก่าทั้งก้อน) → **ขอ access_token ที่ `POST /api/documents/token`** แบบ body `{ticket_data, HmacSha256}` (server ตรวจ HMAC+exp อีกชั้นด้วย secret ฝั่ง server) → เก็บ token ตาม fid ("คีย์คือ fid") — กลับมาเปิดเอกสารเดิม = ใช้ token เดิมไม่ต้องขอใหม่ · token หมดอายุกลางใช้งาน (โดน 401) = ลองขอใหม่จาก ticket 1 ครั้ง (ticket ต้องยังไม่หมดอายุ) ยังไม่ผ่าน = `AuthRequiredError` → หน้า `no-access` ให้ขอไฟล์ใหม่จาก e-Court · token นี้คือสิ่งที่ `apiClient` แนบเป็น `Authorization: Bearer` ทุก request ตอนต่อ backend จริง (กลุ่ม docver บังคับ Bearer — docs/PLAN-DOCVER.md) -> **หมายเหตุสถานะปัจจุบัน (2026-10-14):** UI นี้ถูก implement แล้วใน repo นี้ที่ route `/docedit/wordaddin` (ดู `components/wordaddin/` + `wordaddin/`) — ทั้ง auth (แทนด้วย mock `wordaddin/services/authService.ts`) และ API ทั้งสามข้างบน (แทนด้วย in-memory mock `wordaddin/services/versioningService.ts`) · วิธีสลับกลับของจริง: `docs/WORDADDIN-DEV.md` +> **หมายเหตุสถานะปัจจุบัน:** UI นี้ถูก implement แล้วใน repo นี้ที่ route `/docedit/wordaddin` (ดู `components/wordaddin/` + `wordaddin/`) — auth เป็น ticket auth จริงครบ flow (`wordaddin/services/authService.ts` + `ticketService.ts` + ทางเข้า ticket ของ `/api/documents/token`) และ **API ทั้งสามข้างบนเป็นของจริงแล้ว** (`wordaddin/services/versioningService.ts` ยิงกลุ่ม `/api/documents/*` ผ่าน Bearer — ปลด mock 2026-10-27; เหลือ mock เฉพาะโหมด `?addindemo`) · รายละเอียดการรันกับ backend: `docs/WORDADDIN-DEV.md` · สร้างไฟล์ทดสอบพร้อม ticket: `node scripts/make-ticket-docx.mjs` --- ## 8. กติกา error ที่ UI ต้องรองรับ -1. **`AuthRequiredError` (401 ที่ refresh ไม่ช่วย)** — ทุก flow ต้อง catch แล้ว: กลับ `signed-out` + เคลียร์ `documentId`/`documentTemplateId`/`versions` + ตั้ง `loginError` = "เซสชันหมดอายุ — กรุณา login ใหม่" — **ไม่ throw ต่อ ไม่โชว์ error ทับ phase** +1. **`AuthRequiredError` (ไม่มี token / 401 หลัง renew-retry)** — ทุก flow ต้อง catch แล้ว: กลับ `no-access` + เคลียร์ `documentId`/`documentTemplateId`/`versions` + ตั้ง `noAccessNotice` = "ticket ของ e-Court หมดอายุหรือไม่ถูกต้อง — โปรดขอไฟล์ใหม่จาก e-Court แล้วเปิดอีกครั้ง" — **ไม่ throw ต่อ ไม่โชว์ error ทับ phase** 2. error อื่น → MessageBar ณ จุดที่เกิด (login/history/flow/download แยกกัน) — ห้ามปล่อย unhandled rejection 3. แยก error ของ "ตัว version" ออกจาก "ปิดเอกสารไม่สำเร็จ" — อันหลังเป็น warning เพราะข้อมูลปลอดภัยแล้ว 4. PDF เป็น best-effort เสมอ — ล้มแค่เตือน ไม่ fail flow diff --git a/docs/requirement/addin-workflow.md b/docs/requirement/addin-workflow.md new file mode 100644 index 0000000..a4a6bf1 --- /dev/null +++ b/docs/requirement/addin-workflow.md @@ -0,0 +1,44 @@ +# ขั้นตอนการทำงานของ Addin + +## 1. เมื่อเปิดเอกสาร + +- อ่าน custom property ของ word + 1. ticket_data ซึ่งจะมีข้อมูลเบื้องต้น ดังนี้ + ```jsonc + { + "exp": 1793067433, + "fid": "T12_FD155_3s-long_ZZZ", + "tid": "T12", + "uid": "oom", + "uname": "สรวิชญ์", + } + ``` + 2. นำค่า ticket_data ที่เป็น string ก่อนนำไปแปลง json ทำการ sign HMAC-SHA256 โดยใช้ secret "super_secret" ซึ่งต้องรองรับการ config ค่านี้ในอนาคต + 3. นำค่าที่ sign ได้ มาเทียบกับค่า property "HmacSha256" +- ขั้นตอนการทำ authen + ``` + ขั้นตอน + 1. เมื่อเปิดไฟล์ Word ให้อ่าน Custom Property 2 ค่าที่ฝังมาในไฟล์ คือ value จริง และ Hash Value (HMAC) เพื่อตรวจสอบว่าไฟล์สร้างผ่านระบบอย่างถูกต้อง + 2. ถ้า HMAC ไม่ตรงกัน แสดงว่าไฟล์ถูกแก้ไข ให้ Add-in disable การทำงานทั้งหมด + 3. ถ้า HMAC ตรงกัน ให้เก็บค่า uId, uName, fId, tid ไว้ แล้วตรวจสอบว่า userId นี้มีใน localStorage อยู่แล้วหรือไม่ + 4. ถ้ายังไม่มีให้ตรวจค่า Exp ที่ได้จากไฟล์ Word + - หมดอายุ → disable Add-in ทั้งหมด + - ยังไม่หมดอายุ → เก็บใน localStorage + - userName: ค่าจาก uName + - คีย์คือ fid: เอาค่า { + "userid": uid, + "username": uname, + "fid": fid (เป็น  string), + "tid": tid + } + ไปทำการขอ token ที่ /api/documents/token แล้วนำค่าที่ได้มาเก็บไว้ที่ตัวแปรนี้ เพื่อให้อ่านค่าไปใช้ให้ตรงกับค่า fid ที่ได้รับ เนื่องจาก api ในส่วน /documents จะต้องแนบ token ไปไม่ส่งค่าไปตรงๆ เพื่อความถูกต้อง + 5. ถ้ามี Session อยู่แล้ว ให้ตรวจว่า userId ตรงกับ Session หรือไม่ + 6. ถ้า userId ไม่ตรงกัน (user ใหม่) ให้ตรวจค่า Expire + - ยังไม่หมดอายุ → เคลียร์ Session เดิม แล้วสร้าง Session 2 ค่าใหม่ + - หมดอายุ → disable Add-in ทั้งหมด + 7. ถ้า userId ตรงกัน (คนเดิม) ให้ตรวจว่า fid มีใน localStorage แล้วหรือไม่ + - มีแล้ว (กลับมาทำเอกสารเดิม) → ผ่านได้เลย ไม่ต้องตรวจ Expire + - ยังไม่มี (เอกสารใหม่) → ตรวจค่า Expire + - ยังไม่หมดอายุ → ทำการขอ token แล้วเก็บใน localStorage ตามขั้นตอนก่อนหน้า + - หมดอายุ → disable Add-in ทั้งหมด + ``` diff --git a/lib/addin-ticket.ts b/lib/addin-ticket.ts new file mode 100644 index 0000000..766db45 --- /dev/null +++ b/lib/addin-ticket.ts @@ -0,0 +1,124 @@ +// PLAN-ADDIN-AUTH.md §3 — ตรวจ ticket ของ add-in ฝั่ง server (ทางเข้าที่สองของ +// POST /api/documents/token) — secret อยู่ฝั่ง server อย่างเดียว เพราะทางเข้านี้ +// ผู้เรียกคือ add-in ใน webview ของ Word ซึ่งแนบ x-api-key (server-to-server +// ของ e-Court) มาไม่ได้ — ตัวพิสูจน์ตัวตนคือ ticket_data + HmacSha256 ที่ e-Court +// stamp มากับไฟล์ (คำนวณ HMAC ตรงกับ lib/lib-utils.ts generateHmacSha256 +// ของกลุ่ม template: hex lowercase บน string ดิบ) +// +// ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test (tests/lib/) ต้องรัน +// ได้โดยไม่ต้องตั้ง env อะไรเลย (pattern เดียวกับ lib/docver-token.ts) +import { createHash, createHmac, timingSafeEqual } from "node:crypto"; + +import { + isTicketExpired, + normalizeHexDigest, + parseDocverTicket, + type DocverTicket, +} from "@/utils/docver-ticket"; +import type { DocverTokenClaims } from "@/lib/docver-token"; + +/** + * secret ของ ticket — อ่านตอนเรียก ไม่ใช่ตอน module load + * ลำดับ: ADDIN_TICKET_SECRET (ของกลุ่มนี้) → SECRET (env เดียวกับตัว stamp + * ของกลุ่ม template — deployment เดียวกันมักตั้งค่านี้อยู่แล้ว) → "super_secret" + * (ค่าตาม requirement — dev ใช้ได้ทันที แต่ production ต้องตั้งค่าจริงเพราะ + * ค่าเดิมรู้กันหมด = ใครก็ปลอม ticket ได้) · ห้าม log ค่าดิบ + */ +export function addinTicketSecret(): string { + return ( + process.env.ADDIN_TICKET_SECRET?.trim() || + process.env.SECRET?.trim() || + "super_secret" + ); +} + +/** + * ตรวจ ticket เต็มชุด (HMAC → parse → exp) — ไม่แยกสาเหตุออกมา + * (route ตอบ 401 ข้อความเดียวกันทุกกรณี กันใช้ endpoint เป็น oracle — + * add-in รู้สาเหตุจริงจากการตรวจเองฝั่ง client อยู่แล้ว) + */ +export function verifyAddinTicket( + ticketData: string, + hmacHex: string, + secret: string, + nowSec: number = Math.floor(Date.now() / 1000), +): { ok: true; ticket: DocverTicket } | { ok: false } { + const digest = normalizeHexDigest(hmacHex); + if (digest === null) return { ok: false }; + + // เทียบแบบ timing-safe ตาม pattern verifyDocverToken — hash ทั้งสองฝั่ง + // ด้วย SHA-256 ก่อนเพื่อให้ digest ยาวเท่ากันเสมอ (timingSafeEqual ไม่ throw) + const expected = createHmac("sha256", secret).update(ticketData, "utf8").digest(); + const expectedHash = createHash("sha256").update(expected).digest(); + const providedHash = createHash("sha256").update(Buffer.from(digest, "hex")).digest(); + if (!timingSafeEqual(providedHash, expectedHash)) return { ok: false }; + + const parsed = parseDocverTicket(ticketData); + if (!parsed.ok) return { ok: false }; + if (isTicketExpired(parsed.ticket.exp, nowSec)) return { ok: false }; + return { ok: true, ticket: parsed.ticket }; +} + +/** แปลง ticket → claims ของ access_token (uid→userid, uname→username, tid→template) */ +export function ticketToDocverClaims(ticket: DocverTicket): DocverTokenClaims { + return { userid: ticket.uid, username: ticket.uname, fid: ticket.fid, template: ticket.tid }; +} + +/** body ของทางเข้า ticket — allowlist 2 field เป๊ะ (ชื่อเดียวกับ custom properties) */ +const TICKET_BODY_FIELDS = ["ticket_data", "HmacSha256"] as const; + +export type TicketTokenBodyResult = + | { ok: true; ticketData: string; hmacHex: string } + | { ok: false; kind: "missing" | "invalid"; error: string }; + +/** + * parse body ของ POST /api/documents/token ทางเข้า ticket + * - `missing` = ไม่มี ticket มาเลย (route ตอบ 401 — คำเดียวกับตอน verify ไม่ผ่าน) + * - `invalid` = รูปผิด (route ตอบ 400 ตาม convention กัน typo เงียบ ๆ) + */ +export function parseTicketTokenBody(raw: unknown): TicketTokenBodyResult { + if (raw === null || typeof raw !== "object" || Array.isArray(raw)) { + return { ok: false, kind: "invalid", error: "body ต้องเป็น JSON object" }; + } + const record = raw as Record; + for (const key of Object.keys(record)) { + if (!(TICKET_BODY_FIELDS as readonly string[]).includes(key)) { + return { + ok: false, + kind: "invalid", + error: `ไม่รู้จัก field '${key}' (รับเฉพาะ ${TICKET_BODY_FIELDS.join(", ")})`, + }; + } + } + + const read = (name: (typeof TICKET_BODY_FIELDS)[number]): string | null => { + const value = record[name]; + if (value === undefined || value === null || value === "") return null; // ไม่ส่ง = missing + if (typeof value !== "string") return ""; // ส่งผิดชนิด = invalid + return value; + }; + + const ticketData = read("ticket_data"); + if (ticketData === null) { + return { ok: false, kind: "missing", error: "ต้องระบุ ticket_data (string)" }; + } + if (ticketData === "") { + return { ok: false, kind: "invalid", error: "ticket_data ต้องเป็น string" }; + } + if (ticketData.length > 2048) { + return { ok: false, kind: "invalid", error: "ticket_data ยาวเกินไป" }; + } + + const hmacHex = read("HmacSha256"); + if (hmacHex === null) { + return { ok: false, kind: "missing", error: "ต้องระบุ HmacSha256 (string)" }; + } + if (hmacHex === "") { + return { ok: false, kind: "invalid", error: "HmacSha256 ต้องเป็น string" }; + } + if (hmacHex.length > 128) { + return { ok: false, kind: "invalid", error: "HmacSha256 ยาวเกินไป" }; + } + + return { ok: true, ticketData, hmacHex }; +} diff --git a/lib/document-versioning.ts b/lib/document-versioning.ts index 9973286..7d1dd63 100644 --- a/lib/document-versioning.ts +++ b/lib/document-versioning.ts @@ -17,22 +17,21 @@ export const DOCX_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; export const PDF_CONTENT_TYPE = "application/pdf"; -/** รหัสเอกสารจากผู้เรียก — URL-path-safe ล้วน (ไม่มี / .. ช่องว่าง ไทย) กันถูก - * ฝังลง path/log แปลก ๆ และตัดขนาดให้จำกัด */ -const DOC_ID_RE = /^[A-Za-z0-9._:-]{1,200}$/; +/** รหัสเอกสาร (docId) ไม่มี validator ที่นี่แล้ว — ตอนนี้มาจาก fid ใน Bearer token + * (String(fid) — integer ที่ verify แล้ว ผ่าน lib/docver-token.ts) ไม่ใช่ path param + * ของผู้เรียก · parseDocId เดิมถอดออกพร้อมการถอด segment [docId] ออกจาก URL */ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i; -/** field ที่รับใน multipart ของ POST …/versions — อะไรนอกนี้ = 400 กัน typo เงียบ ๆ */ +/** field ที่รับใน multipart ของ POST …/versions — อะไรนอกนี้ = 400 กัน typo เงียบ ๆ + * (userId/userName/templateId ถอดออกแล้ว — identity/template มาจาก Bearer token + * ผ่าน lib/docver-token.ts ส่ง field เก่ามา = 400 ตาม convention) */ const FORM_FIELDS = [ "file", "pdf", - "userId", - "userName", "clientVersionId", "fields", "message", - "templateId", "fileName", ] as const; @@ -47,22 +46,6 @@ export function docverError(message: string, status: number): Response { }); } -/** ตรวจ docId จาก path param — trim แล้วว่าง/เกิน 200/มีตัวอักษรนอก charset = ไม่ผ่าน - * (+ ปฏิเสธ "." / ".." เป็นพิเศษแม้อยู่ใน charset — path-traversal specials) */ -export function parseDocId(raw: string): - | { ok: true; docId: string } - | DocverError { - const docId = raw.trim(); - if (docId === "." || docId === ".." || !DOC_ID_RE.test(docId)) { - return { - ok: false, - error: - "รหัสเอกสาร (docId) ต้องยาว 1–200 ตัวอักษร และใช้ได้เฉพาะ A-Z a-z 0-9 . _ : -", - }; - } - return { ok: true, docId }; -} - /** magic bytes ของ .docx — OOXML เป็น ZIP จึงขึ้นต้น PK\x03\x04 (mirror รูปแบบ * matchesSignature ของ app/actions/files.ts — utils/file-kind.ts เป็นของ note files) */ export function isDocxBytes(bytes: Buffer): boolean { @@ -141,8 +124,11 @@ export function parseFieldsJson(raw: string): } const record = parsed as Record; const keys = Object.keys(record); - if (keys.length > 100) { - return { ok: false, error: 'field "fields" มี key เกิน 100 รายการ' }; + // เหลือ guard เชิงโครงสร้างเท่านั้น — ความยาวค่าไม่จำกัดแล้ว (2026-10-27 ตามคำขอผู้ใช้: + // เอกสารจริง 100–200 หน้า มี CC ยาวหลายแสนตัวอักษร; ผู้เรียกผ่าน Bearer เท่านั้น + jsonb + // ของ Postgres รับได้ถึงระดับ 255MB จึงไม่มีคอขวดฝั่งเก็บ) + if (keys.length > 1_000) { + return { ok: false, error: 'field "fields" มี key เกิน 1,000 รายการ' }; } for (const key of keys) { if (key.length > 200) { @@ -152,19 +138,13 @@ export function parseFieldsJson(raw: string): if (typeof value !== "string") { return { ok: false, error: 'ค่าของแต่ละรายการใน "fields" ต้องเป็น string' }; } - if (value.length > 10_000) { - return { ok: false, error: 'ค่าของแต่ละรายการใน "fields" ยาวเกิน 10,000 ตัวอักษร' }; - } } return { ok: true, fields: keys.length === 0 ? null : (parsed as Record) }; } export type ParsedVersionUploadForm = { - userId: string; - userName: string; clientVersionId: string | null; message: string | null; - templateId: string | null; /** ชื่อไฟล์ดั้งเดิมจาก field "fileName" (แยกจากชื่อของ File เอง — add-in ส่งมาเอง * เพราะ desktop Word ได้ชื่อจาก path จริง) — strip path + cap แล้ว */ fileName: string | null; @@ -172,7 +152,8 @@ export type ParsedVersionUploadForm = { }; /** ตรวจ text field ทั้งหมดของ POST …/versions (file/pdf เช็คที่ route เพราะต้องอ่าน - * size ก่อน buffer) — userId/userName บังคับเพราะระบบ stand-alone ไม่มี session */ + * size ก่อน buffer) — identity (userId/userName) กับ templateId ไม่รับใน form + * แล้ว: route แกะจาก Bearer token ผ่าน lib/docver-token.ts ก่อนเรียกตรงนี้ */ export function parseVersionUploadForm(form: FormData): | { ok: true; form: ParsedVersionUploadForm } | DocverError { @@ -187,36 +168,12 @@ export function parseVersionUploadForm(form: FormData): } } - const userId = formString(form, "userId"); - if (!userId.ok) return userId; - if (userId.value === null) { - return { ok: false, error: "ต้องระบุ userId (ระบบ stand-alone — บอกผู้อัปโหลดเอง)" }; - } - if (userId.value.length > 100) { - return { ok: false, error: "userId ยาวเกิน 100 ตัวอักษร" }; - } - - const userName = formString(form, "userName"); - if (!userName.ok) return userName; - if (userName.value === null) { - return { ok: false, error: "ต้องระบุ userName (ระบบ stand-alone — บอกผู้อัปโหลดเอง)" }; - } - if (userName.value.length > 200) { - return { ok: false, error: "userName ยาวเกิน 200 ตัวอักษร" }; - } - const clientVersionId = formString(form, "clientVersionId"); if (!clientVersionId.ok) return clientVersionId; if (clientVersionId.value && clientVersionId.value.length > 100) { return { ok: false, error: "clientVersionId ยาวเกิน 100 ตัวอักษร" }; } - const templateId = formString(form, "templateId"); - if (!templateId.ok) return templateId; - if (templateId.value && templateId.value.length > 100) { - return { ok: false, error: "templateId ยาวเกิน 100 ตัวอักษร" }; - } - const message = formString(form, "message"); if (!message.ok) return message; if (message.value && message.value.length > DOCVER_MESSAGE_MAX) { @@ -238,11 +195,8 @@ export function parseVersionUploadForm(form: FormData): return { ok: true, form: { - userId: userId.value, - userName: userName.value, clientVersionId: clientVersionId.value, message: message.value, - templateId: templateId.value, fileName: sanitizeDisplayFileName(rawFileName.value), fields, }, diff --git a/lib/docver-token.ts b/lib/docver-token.ts new file mode 100644 index 0000000..92bfc41 --- /dev/null +++ b/lib/docver-token.ts @@ -0,0 +1,223 @@ +// PLAN-DOCVER.md §auth — access_token ของกลุ่ม /api/documents (document versioning) +// - POST /api/documents/token ออก JWT HS256 ให้ผู้เรียกที่ยืนยัน header "x-api-key" +// กับ env DOCVER_API_KEY (fail closed เมื่อ env ไม่ตั้ง/ว่าง — pattern เดียวกับ +// lib/external-api-auth.ts ของ N10: hash SHA-256 ทั้งสองค่า + timingSafeEqual, +// ข้อความ 401 ของ "ไม่ใส่ key" กับ "key ผิด" เป็นอันเดียวกัน, ห้าม log ค่าดิบ) +// - token เซ็นด้วย env DOCVER_TOKEN_SECRET (มือเขียน HS256 ผ่าน node:crypto ล้วน — +// ไม่เพิ่ม dependency) แล้วทุก endpoint อื่นของกลุ่มบังคับ Authorization: Bearer — +// identity (userid/username) กับ templateId แกะจาก claims ไม่รับจาก payload +// - claims "fid" = fileId ของ e-Court (string) — เป็น docId ของทุก operation ตรง ๆ +// — บังคับตั้งแต่ขอ token และ verify ไม่รับ token ที่ไม่มี fid +// +// ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test (tests/lib/) ต้องรันได้ +// โดยไม่ต้องตั้ง DATABASE_URL/MINIO_* (pattern เดียวกับ lib/external-api-auth.ts) +import { createHash, createHmac, timingSafeEqual } from "node:crypto"; + +import { docverError, type DocverError } from "@/lib/document-versioning"; + +/** claims ของ access_token docver — โครงสร้างตามผู้เรียกกำหนด (e-Court) */ +export type DocverTokenClaims = { + userid: string; + username: string; + fid: string; + template: string | null; +}; + +function base64url(input: string): string { + return Buffer.from(input, "utf8").toString("base64url"); +} + +function decodeJsonSegment(segment: string): Record | null { + let text: string; + try { + text = Buffer.from(segment, "base64url").toString("utf8"); + } catch { + return null; + } + try { + const parsed = JSON.parse(text) as unknown; + if ( + parsed === null || + typeof parsed !== "object" || + Array.isArray(parsed) + ) { + return null; + } + return parsed as Record; + } catch { + return null; + } +} + +/** ออก JWT HS256 (base64url 3 segment) — payload = claims + iat/exp (วินาที) */ +export function issueDocverToken( + claims: DocverTokenClaims, + secret: string, + ttlSeconds: number, +): string { + const header = base64url(JSON.stringify({ alg: "HS256", typ: "JWT" })); + const iat = Math.floor(Date.now() / 1000); + const payload = base64url( + JSON.stringify({ ...claims, iat, exp: iat + ttlSeconds }), + ); + const signature = createHmac("sha256", secret) + .update(`${header}.${payload}`) + .digest("base64url"); + return `${header}.${payload}.${signature}`; +} + +/** claims ที่ถอดได้จาก payload ที่ตรวจ signature ผ่านแล้ว — รูปร่างผิด = invalid + * (กัน token ที่เซ็นถูกแต่ claims ไม่ครบ/ผิด type หลุดไปใช้ต่อ) */ +function claimsFromPayload( + payload: Record, +): DocverTokenClaims | null { + const { userid, username, fid, template } = payload; + if (typeof userid !== "string" || userid === "") return null; + if (typeof username !== "string" || username === "") return null; + if (typeof fid !== "string" || fid === "") return null; + if (template !== null && typeof template !== "string") return null; + return { userid, username, fid, template }; +} + +/** ตรวจ token: 3 segment → alg บังคับ HS256 (กัน alg-confusion เช่น "none") → + * เทียบ signature แบบ timing-safe (hash ทั้งสองฝั่งก่อน — digest ยาวเท่ากันเสมอ) → + * exp ต้องยังไม่ผ่านมาแล้ว → claims ต้องครบรูปร่าง */ +export function verifyDocverToken( + token: string, + secret: string, +): { ok: true; claims: DocverTokenClaims } | { ok: false } { + const segments = token.split("."); + if (segments.length !== 3) return { ok: false }; + const [headerSegment, payloadSegment, signatureSegment] = segments; + + const header = decodeJsonSegment(headerSegment); + if (header === null || header.alg !== "HS256") return { ok: false }; + + const expected = createHmac("sha256", secret) + .update(`${headerSegment}.${payloadSegment}`) + .digest(); + // ถอด base64url กลับเป็น byte ดิบของ signature ก่อน — แล้ว hash ทั้งสองฝั่ง + // (SHA-256 = 32 byte เท่ากันเสมอ แม้ segment จะเป็นขยะ decode ได้สั้น/ว่าง — + // timingSafeEqual จึงไม่ throw เรื่องความยาวต่างกัน) + const provided = createHash("sha256") + .update(Buffer.from(signatureSegment, "base64url")) + .digest(); + const expectedHash = createHash("sha256").update(expected).digest(); + if (!timingSafeEqual(provided, expectedHash)) return { ok: false }; + + const payload = decodeJsonSegment(payloadSegment); + if (payload === null) return { ok: false }; + const exp = payload.exp; + if (typeof exp !== "number" || !Number.isFinite(exp)) return { ok: false }; + if (exp <= Math.floor(Date.now() / 1000)) return { ok: false }; + + const claims = claimsFromPayload(payload); + if (claims === null) return { ok: false }; + return { ok: true, claims }; +} + +/** auth ของ POST /api/documents/token — mirror requireExternalApiKey (N10) แต่ + * env เป็น DOCVER_API_KEY และตอบผ่าน docverError ของกลุ่มนี้ + * คืน null เมื่อผ่าน / Response 401 เมื่อไม่ผ่าน */ +export function requireDocverApiKey(request: Request): Response | null { + // เทียบกับค่า trim แล้ว — กัน trailing newline จาก K8s secret / docker env_file + const envKey = process.env.DOCVER_API_KEY?.trim(); + // const envKey = + // "2d9b76d49a4f5311f6a0dacf759ecec53f34b6d102f24c696890a4052c99cf54"; + if (envKey === undefined || envKey === "") { + return docverError("ระบบยังไม่ได้ตั้งค่า API key", 401); + } + const provided = request.headers.get("x-api-key"); + if (provided === null || provided === "") { + return docverError("API key ไม่ถูกต้อง", 401); + } + const providedHash = createHash("sha256").update(provided).digest(); + const envHash = createHash("sha256").update(envKey).digest(); + return timingSafeEqual(providedHash, envHash) + ? null + : docverError("API key ไม่ถูกต้อง", 401); +} + +/** 401 เดียวสำหรับทุกกรณี — ไม่แยกสาเหตุ (ไม่มี header / รูปผิด / signature ผิด / + * หมดอายุ / secret ไม่ตั้ง) กันใช้ endpoint เป็น oracle สำรวจ */ +const BEARER_DENIED = "โทเคนไม่ถูกต้องหรือหมดอายุ"; + +/** บังคับ Authorization: Bearer ของกลุ่ม docver — เรียกเป็นอย่างแรกของ + * ทุก endpoint ก่อน parse path param · env DOCVER_TOKEN_SECRET ไม่ตั้ง = ไม่มี + * token ใดผ่าน (fail closed — ไม่ใช่ 500 เพราะไม่ใช่ความผิดของผู้เรียก) */ +export function requireDocverBearer( + request: Request, +): { ok: true; claims: DocverTokenClaims } | { ok: false; response: Response } { + const denied = () => + ({ ok: false, response: docverError(BEARER_DENIED, 401) }) as const; + const secret = process.env.DOCVER_TOKEN_SECRET?.trim(); + // const secret = + // "487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e"; + if (secret === undefined || secret === "") return denied(); + const header = request.headers.get("authorization"); + if (header === null) return denied(); + const match = /^Bearer\s+(\S+)$/i.exec(header); + if (match === null) return denied(); + const verified = verifyDocverToken(match[1], secret); + if (!verified.ok) return denied(); + return { ok: true, claims: verified.claims }; +} + +/** body ของ POST /api/documents/token — strict allowlist กัน typo เงียบ ๆ ตาม + * convention ของกลุ่ม (key อื่น = 400) · trim-ว่าง = ถือว่าไม่ส่ง */ +const TOKEN_BODY_FIELDS = ["userid", "username", "fid", "template"] as const; + +export function parseTokenRequestBody( + raw: unknown, +): { ok: true; claims: DocverTokenClaims } | DocverError { + if (raw === null || typeof raw !== "object" || Array.isArray(raw)) { + return { ok: false, error: "body ต้องเป็น JSON object" }; + } + const record = raw as Record; + for (const key of Object.keys(record)) { + if (!(TOKEN_BODY_FIELDS as readonly string[]).includes(key)) { + return { + ok: false, + error: `ไม่รู้จัก field '${key}' (รับเฉพาะ ${TOKEN_BODY_FIELDS.join(", ")})`, + }; + } + } + + const rawUserid = record.userid; + if (typeof rawUserid !== "string" || rawUserid.trim() === "") { + return { ok: false, error: "ต้องระบุ userid (string)" }; + } + const userid = rawUserid.trim(); + if (userid.length > 100) { + return { ok: false, error: "userid ยาวเกิน 100 ตัวอักษร" }; + } + + const rawUsername = record.username; + if (typeof rawUsername !== "string" || rawUsername.trim() === "") { + return { ok: false, error: "ต้องระบุ username (string)" }; + } + const username = rawUsername.trim(); + if (username.length > 200) { + return { ok: false, error: "username ยาวเกิน 200 ตัวอักษร" }; + } + + const rawFid = record.fid; + if (typeof rawFid !== "string" || rawFid.trim() === "") { + return { ok: false, error: "ต้องระบุ fid (string)" }; + } + const fid = rawFid.trim(); + if (fid.length > 200) { + return { ok: false, error: "fid ยาวเกิน 200 ตัวอักษร" }; + } + + const rawTemplate = record.template ?? null; + if (rawTemplate !== null && typeof rawTemplate !== "string") { + return { ok: false, error: "template ต้องเป็น string" }; + } + const template = rawTemplate?.trim() || null; + if (template !== null && template.length > 100) { + return { ok: false, error: "template ยาวเกิน 100 ตัวอักษร" }; + } + + return { ok: true, claims: { userid, username, fid, template } }; +} diff --git a/lib/lib-tmpl.ts b/lib/lib-tmpl.ts new file mode 100755 index 0000000..bb293d0 --- /dev/null +++ b/lib/lib-tmpl.ts @@ -0,0 +1,1314 @@ +import { generateHmacSha256, signEd25519, sortObjectKeys } from '@/lib/lib-utils'; +import createReport from 'docx-templates'; +import PizzaZip from "pizzip"; +import { + DOMParser, + XMLSerializer, + type Document as XmlDocument, + type Element as XmlElement, + type Node as XmlNode, + type Attr as XmlAttr, +} from "@xmldom/xmldom"; +import xpath from "xpath"; +const WORD_NS = + "http://schemas.openxmlformats.org/wordprocessingml/2006/main"; + +export interface ExtractedData { + [tagName: string]: string; +} + +const asXpathNode = (node: XmlNode): globalThis.Node => + node as unknown as globalThis.Node; + +function createSelector() { + return xpath.useNamespaces({ w: WORD_NS }); +} + + +/** + * ฟังก์ชันสำหรับดึงข้อมูลจาก docx ออกมาเป็น JSON โดยอิงจาก Bookmark (w:bookmarkStart) + */ +export function extractBookmark(docxBuffer: Buffer,): ExtractedData { + const zip = new PizzaZip(docxBuffer); + const docXmlFile = zip.file("word/document.xml"); + + if (!docXmlFile) { + throw new Error("Invalid docx file: word/document.xml not found."); + } + const docXmlText: string = docXmlFile.asText(); + + // 3. Parse ข้อความ XML ให้เป็น DOM Object + const parser = new DOMParser(); + const doc = parser.parseFromString(docXmlText, "text/xml"); + + // 4. ตั้งค่า Namespace ของ Word XML เพื่อใช้ค้นหาด้วย XPath + const select = xpath.useNamespaces({ + 'w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main' + }); + + const result: ExtractedData = {}; + + // ค้นหา Bookmark หรือ Tag ที่ใช้แบ่ง Section + // const bookmarks = select('//w:bookmarkStart', doc as unknown as globalThis.Node) as Element[]; + const bookmarks = select( + "//w:bookmarkStart", + doc as unknown as globalThis.Node + ) as unknown as XmlElement[]; + + bookmarks.forEach((bookmark: XmlElement) => { + const sectionName = bookmark.getAttribute('w:name'); + const bookmarkId = bookmark.getAttribute('w:id'); + + // กรองเอาเฉพาะ Bookmark ที่เราสนใจ (ไม่เอาพวกระบบสร้างเองอย่าง _GoBack) + if (sectionName && !sectionName.startsWith('_')) { + let extractedText = ""; + let currentNode: XmlNode | null = bookmark.nextSibling; + + // วนลูปอ่าน Node ถัดไปเรื่อยๆ จนกว่าจะเจอจุดสิ้นสุดของ Bookmark + while (currentNode) { + // ถ้าเจอจุดจบของ Bookmark ตัวเอง ให้หยุด + if ( + currentNode.nodeType === 1 && // Element node + (currentNode as XmlElement).nodeName === 'w:bookmarkEnd' && + (currentNode as XmlElement).getAttribute('w:id') === bookmarkId + ) { + break; + } + + // ดึง Text (w:t) ที่อยู่ภายใน Node ปัจจุบัน + const textNodes = select('.//w:t/text()', currentNode as unknown as globalThis.Node) as unknown as XmlNode[]; + textNodes.forEach((textNode: XmlNode) => { + if (textNode.nodeValue) { + extractedText += textNode.nodeValue; + } + }); + + currentNode = currentNode.nextSibling; + } + + // บันทึกลงผลลัพธ์ JSON + result[sectionName] = extractedText.trim(); + } + }); + + return result; +} + + + +/** + * อ่าน Content Control (w:sdt) จาก DOCX Buffer + * ปัจจุบันอ่านจาก word/document.xml ตาม logic ของโค้ดต้นฉบับ + */ +export function extractContentControls( + docxBuffer: Buffer, +): ExtractedData { + const zip = new PizzaZip(docxBuffer); + const docXmlFile = zip.file("word/document.xml"); + + if (!docXmlFile) { + throw new Error("Invalid docx file: word/document.xml not found."); + } + + const parser = new DOMParser(); + const doc = parser.parseFromString(docXmlFile.asText(), "text/xml"); + const select = createSelector(); + const result: ExtractedData = {}; + + const sdtNodes = select( + "//w:sdt", + asXpathNode(doc), + ) as unknown as XmlElement[]; + + sdtNodes.forEach((sdt) => { + const tagAttr = select( + "./w:sdtPr/w:tag/@w:val", + asXpathNode(sdt), + true, + ) as unknown as XmlAttr | undefined; + + const tagName = tagAttr?.value; + + if (!tagName) return; + + const sdtContent = select( + "./w:sdtContent", + asXpathNode(sdt), + true, + ) as unknown as XmlElement | undefined; + + if (!sdtContent) { + result[tagName] = ""; + return; + } + + const nodes = select( + ".//w:p | .//w:t | .//w:tab | .//w:br | .//w:noBreakHyphen | .//w:softHyphen | .//w:sym", + asXpathNode(sdtContent), + ) as unknown as XmlElement[]; + + let extractedText = ""; + + nodes.forEach((node) => { + switch (node.nodeName) { + case "w:p": + if ( + extractedText.length > 0 && + !extractedText.endsWith("\n") + ) { + extractedText += "\n\n"; + } + break; + + case "w:t": + extractedText += node.textContent || ""; + break; + + case "w:tab": + extractedText += "\t"; + break; + + case "w:br": + extractedText += "\n"; + break; + + case "w:noBreakHyphen": + extractedText += "\u2011"; + break; + + case "w:softHyphen": + extractedText += "\u00ad"; + break; + + case "w:sym": { + const charAttr = node.getAttribute("w:char"); + if (charAttr) { + const charCode = Number.parseInt(charAttr, 16); + extractedText += String.fromCharCode(charCode); + } + break; + } + } + }); + + result[tagName] = extractedText; + }); + + return result; +} + +type SdtControlType = "plain" | "rich" | "other"; +type SdtStructure = "block" | "inline"; + +function detectSdtControlType( + sdt: XmlElement, + select: xpath.XPathSelect, +): { type: SdtControlType; multiLine: boolean } { + const sdtPr = select( + "./w:sdtPr", + asXpathNode(sdt), + true, + ) as unknown as XmlElement | undefined; + + if (!sdtPr) { + return { type: "other", multiLine: false }; + } + + const textEl = select( + "./w:text", + asXpathNode(sdtPr), + true, + ) as unknown as XmlElement | undefined; + + if (textEl) { + const multiLineAttr = select( + "./@w:multiLine", + asXpathNode(textEl), + true, + ) as unknown as XmlAttr | undefined; + + return { + type: "plain", + multiLine: + multiLineAttr?.value === "1" || + multiLineAttr?.value === "true", + }; + } + + const richTextEl = select( + "./w:richText", + asXpathNode(sdtPr), + true, + ) as unknown as XmlElement | undefined; + + if (richTextEl) { + return { type: "rich", multiLine: true }; + } + + const otherTypeTags = [ + "w:date", + "w:dropDownList", + "w:comboBox", + "w:checkbox", + "w:citation", + "w:group", + "w:docPartObj", + "w:docPartList", + ]; + + for (const tag of otherTypeTags) { + const found = select( + `./${tag}`, + asXpathNode(sdtPr), + true, + ) as unknown as XmlElement | undefined; + + if (found) { + return { type: "other", multiLine: false }; + } + } + + return { type: "rich", multiLine: true }; +} + +function detectSdtStructure( + sdtContent: XmlElement, + select: xpath.XPathSelect, +): SdtStructure { + const directP = select( + "./w:p", + asXpathNode(sdtContent), + ) as unknown as XmlElement[]; + + return directP.length > 0 ? "block" : "inline"; +} + +function buildRunChildren( + doc: XmlDocument, + text: string, +): XmlElement[] { + const nodes: XmlElement[] = []; + const tokens = text.split(/(\t|\n)/); + + tokens.forEach((token) => { + if (token === "") return; + + if (token === "\t") { + nodes.push(doc.createElementNS(WORD_NS, "w:tab")); + } else if (token === "\n") { + nodes.push(doc.createElementNS(WORD_NS, "w:br")); + } else { + const t = doc.createElementNS(WORD_NS, "w:t"); + t.setAttribute("xml:space", "preserve"); + t.textContent = token; + nodes.push(t); + } + }); + + if (nodes.length === 0) { + const t = doc.createElementNS(WORD_NS, "w:t"); + t.setAttribute("xml:space", "preserve"); + t.textContent = ""; + nodes.push(t); + } + + return nodes; +} + +function buildRun( + doc: XmlDocument, + text: string, + rPr?: XmlElement, +): XmlElement { + const run = doc.createElementNS(WORD_NS, "w:r"); + + if (rPr) { + run.appendChild(rPr.cloneNode(true)); + } + + buildRunChildren(doc, text).forEach((node) => + run.appendChild(node), + ); + + return run; +} + +function insertInlineContent( + doc: XmlDocument, + sdtContent: XmlElement, + select: xpath.XPathSelect, + text: string, + allowLineBreak: boolean, +): void { + const safeText = allowLineBreak + ? text + : text.replace(/\n/g, " "); + + const existingRuns = select( + "./w:r", + asXpathNode(sdtContent), + ) as unknown as XmlElement[]; + + const firstRPr = + existingRuns.length > 0 + ? (select( + "./w:rPr", + asXpathNode(existingRuns[0]), + true, + ) as unknown as XmlElement | undefined) + : undefined; + + existingRuns.forEach((r) => { + if (r.parentNode) r.parentNode.removeChild(r); + }); + + sdtContent.appendChild( + buildRun(doc, safeText, firstRPr), + ); +} + +// ในฟังก์ชัน insertBlockContent() +function insertBlockContent( + doc: XmlDocument, + sdtContent: XmlElement, + select: xpath.XPathSelect, + text: string, + allowMultiParagraph: boolean, +): void { + const allParagraphs = select( + "./w:p", + asXpathNode(sdtContent), + ) as unknown as XmlElement[]; + + if (allParagraphs.length === 0) { + const p = doc.createElementNS(WORD_NS, "w:p"); + sdtContent.appendChild(p); + allParagraphs.push(p); + } + + const firstP = allParagraphs[0]; + + const firstPPr = select( + "./w:pPr", + asXpathNode(firstP), + true, + ) as unknown as XmlElement | undefined; + + const firstRun = select( + "./w:r", + asXpathNode(firstP), + true, + ) as unknown as XmlElement | undefined; + + const firstRPr = firstRun + ? (select( + "./w:rPr", + asXpathNode(firstRun), + true, + ) as unknown as XmlElement | undefined) + : undefined; + + // ลบย่อหน้าเดิมทั้งหมดยกเว้นย่อหน้าแรก + allParagraphs.forEach((p) => { + if (p !== firstP && p.parentNode) { + p.parentNode.removeChild(p); + } + }); + + // ลบ Run เดิมออกจากย่อหน้าแรก + const existingRuns = select( + "./w:r", + asXpathNode(firstP), + ) as unknown as XmlElement[]; + + existingRuns.forEach((r) => { + if (r.parentNode) r.parentNode.removeChild(r); + }); + + if (!allowMultiParagraph) { + // ถ้าไม่ใช่ออกแบบให้ข้ามย่อหน้าได้ ให้เปลี่ยน \n ทั้งหมดเป็น Space หรือ buildRun ปกติ + firstP.appendChild(buildRun(doc, text.replace(/\n+/g, "\n"), firstRPr)); + return; + } + + // แยกด้วย \n\n สำหรับ Paragraph Break (w:p) + const paragraphs = text.split("\n\n"); + + paragraphs.forEach((pText, index) => { + let targetP: XmlElement; + + if (index === 0) { + targetP = firstP; + } else { + targetP = doc.createElementNS(WORD_NS, "w:p"); + if (firstPPr) { + targetP.appendChild(firstPPr.cloneNode(true)); + } + sdtContent.appendChild(targetP); + } + + const run = doc.createElementNS(WORD_NS, "w:r"); + if (firstRPr) { + run.appendChild(firstRPr.cloneNode(true)); + } + + // pText จะมี \n เดี่ยวๆ หลงเหลืออยู่ ซึ่ง buildRunChildren จะแปลงเป็น w:br ให้โดยอัตโนมัติ + buildRunChildren(doc, pText).forEach((node) => + run.appendChild(node), + ); + + targetP.appendChild(run); + }); +} + +function insertFallbackContent( + sdtContent: XmlElement, + select: xpath.XPathSelect, + text: string, +): void { + const textNodes = select( + ".//w:t", + asXpathNode(sdtContent), + ) as unknown as XmlElement[]; + + if (textNodes.length === 0) return; + + textNodes[0].textContent = text; + + for (let i = 1; i < textNodes.length; i++) { + textNodes[i].textContent = ""; + } +} + +export type PropData = Record; +export type DocumentTemplate = {info?:PropData,dc?:PropData,cc:PropData,}; + +function normalizeValue(value: unknown): string { + if (value === null || value === undefined) { + return ""; + } + + if (typeof value === "string") { + return value; + } + + if ( + typeof value === "number" || + typeof value === "boolean" || + typeof value === "bigint" + ) { + return String(value); + } + + // รองรับ JSON ที่ส่ง array/object มา แต่ Content Control ต้องการ text + return JSON.stringify(value); +} + +/** + * นำ JSON data ไปแทนค่า Content Control ใน DOCX template + * คืนค่าเป็น Buffer ของ DOCX ที่สร้างเสร็จแล้ว + */ +export function templateContentControls( + templateBuffer: Buffer|Uint8Array, + data: PropData, +): Buffer { + const zip = new PizzaZip(templateBuffer); + const docXmlFile = zip.file("word/document.xml"); + + if (!docXmlFile) { + throw new Error("Invalid docx file: word/document.xml not found."); + } + + const parser = new DOMParser(); + const doc = parser.parseFromString(docXmlFile.asText(), "text/xml"); + const select = createSelector(); + + const sdtNodes = select( + "//w:sdt", + asXpathNode(doc), + ) as unknown as XmlElement[]; + + sdtNodes.forEach((sdt) => { + const tagAttr = select( + "./w:sdtPr/w:tag/@w:val", + asXpathNode(sdt), + true, + ) as unknown as XmlAttr | undefined; + + const tagName = tagAttr?.value; + + if (!tagName || !Object.prototype.hasOwnProperty.call(data, tagName)) { + return; + } + + const newValue = normalizeValue(data[tagName]); + + const sdtContent = select( + "./w:sdtContent", + asXpathNode(sdt), + true, + ) as unknown as XmlElement | undefined; + + if (!sdtContent) return; + + const { type: controlType, multiLine } = + detectSdtControlType(sdt, select); + + const structure = detectSdtStructure(sdtContent, select); + + if (controlType === "other") { + insertFallbackContent(sdtContent, select, newValue); + return; + } + + if (structure === "inline") { + const allowLineBreak = + controlType === "plain" ? multiLine : true; + + insertInlineContent( + doc, + sdtContent, + select, + newValue, + allowLineBreak, + ); + } else { + insertBlockContent( + doc, + sdtContent, + select, + newValue, + controlType === "rich", + ); + } + }); + + const serializer = new XMLSerializer(); + zip.file( + "word/document.xml", + serializer.serializeToString(doc), + ); + + return zip.generate({ + type: "nodebuffer", + compression: "DEFLATE", + }); +} + + +const CUSTOM_NS = + "http://schemas.openxmlformats.org/officeDocument/2006/custom-properties"; + +const VT_NS = + "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes"; + +const REL_NS = + "http://schemas.openxmlformats.org/package/2006/relationships"; + +const CONTENT_TYPES_NS = + "http://schemas.openxmlformats.org/package/2006/content-types"; + +const XMLNS_NS = "http://www.w3.org/2000/xmlns/"; + +const CUSTOM_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties"; + +const CUSTOM_CONTENT_TYPE = + "application/vnd.openxmlformats-officedocument.custom-properties+xml"; + +const CUSTOM_FMTID = + "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}"; + +const CUSTOM_PATH = "docProps/custom.xml"; + +type CustomPropertyValue = + | string + | number + | boolean + | Date + | null + | undefined; + +function parseXml(xml: string, fileName: string): XmlDocument { + const errors: string[] = []; + + const parser = new DOMParser(); + + const doc = parser.parseFromString( + xml, + "application/xml", + ) as XmlDocument; + + if (errors.length > 0 || !doc.documentElement) { + throw new Error( + `Invalid ${fileName}: ${errors.join("; ")}`, + ); + } + + return doc; +} + +function assertRoot( + doc: XmlDocument, + namespace: string, + localName: string, + fileName: string, +): XmlElement { + const root = doc.documentElement; + + if (root===null || + root.localName !== localName || + root.namespaceURI !== namespace + ) { + throw new Error(`Invalid root element in ${fileName}`); + } + + return root; +} + +function createCustomXml(): XmlDocument { + const xml = [ + '', + ``, + ].join(""); + + return parseXml(xml, CUSTOM_PATH); +} + +function createValueElement( + doc: XmlDocument, + value: unknown, +): XmlElement { + let tagName: string; + let text: string; + + if (value == null) { + // null และ undefined เก็บเป็น String ว่าง + tagName = "vt:lpwstr"; + text = ""; + } else if (typeof value === "string") { + tagName = "vt:lpwstr"; + text = value; + } else if (typeof value === "boolean") { + tagName = "vt:bool"; + text = value ? "true" : "false"; + } else if (typeof value === "number") { + if (!Number.isFinite(value)) { + throw new TypeError( + `Invalid numeric property value: ${value}`, + ); + } + + if (Number.isInteger(value)) { + if (!Number.isSafeInteger(value)) { + throw new TypeError( + `Integer property exceeds safe integer range: ${value}`, + ); + } + + tagName = "vt:i8"; + } else { + tagName = "vt:r8"; + } + + text = String(value); + } else if (value instanceof Date) { + if (Number.isNaN(value.getTime())) { + throw new TypeError("Invalid Date property value"); + } + + tagName = "vt:filetime"; + text = value.toISOString(); + } else { + throw new TypeError( + `Unsupported custom property type: ${ + Object.prototype.toString.call(value) + }`, + ); + } + + const element = doc.createElementNS(VT_NS, tagName); + + element.appendChild(doc.createTextNode(text)); + + return element; +} + +function ensureCustomRelationship(zip: PizzaZip): void { + const fileName = "_rels/.rels"; + const file = zip.file(fileName); + + if (!file) { + throw new Error(`DOCX is missing ${fileName}`); + } + + const doc = parseXml(file.asText(), fileName); + + const root = assertRoot( + doc, + REL_NS, + "Relationships", + fileName, + ); + + const relationships = Array.from( + root.getElementsByTagNameNS(REL_NS, "Relationship"), + ) as XmlElement[]; + + const existing = relationships.find( + (item) => item.getAttribute("Type") === CUSTOM_REL_TYPE, + ); + + if (existing) { + if (existing.getAttribute("Target") !== CUSTOM_PATH) { + throw new Error( + "Existing custom-properties relationship has an unexpected Target", + ); + } + + return; + } + + const ids = new Set( + relationships.map((item) => item.getAttribute("Id")), + ); + + let index = 1; + let relationshipId = `rId${index}`; + + while (ids.has(relationshipId)) { + index++; + relationshipId = `rId${index}`; + } + + const relationship = doc.createElementNS( + REL_NS, + "Relationship", + ); + + relationship.setAttribute("Id", relationshipId); + relationship.setAttribute("Type", CUSTOM_REL_TYPE); + relationship.setAttribute("Target", CUSTOM_PATH); + + root.appendChild(relationship); + + zip.file( + fileName, + new XMLSerializer().serializeToString(doc), + ); +} + +function ensureCustomContentType(zip: PizzaZip): void { + const fileName = "[Content_Types].xml"; + const file = zip.file(fileName); + + if (!file) { + throw new Error(`DOCX is missing ${fileName}`); + } + + const doc = parseXml(file.asText(), fileName); + + const root = assertRoot( + doc, + CONTENT_TYPES_NS, + "Types", + fileName, + ); + + const overrides = Array.from( + root.getElementsByTagNameNS( + CONTENT_TYPES_NS, + "Override", + ), + ) as XmlElement[]; + + const existing = overrides.find( + (item) => item.getAttribute("PartName") === "/docProps/custom.xml", + ); + + if (existing) { + existing.setAttribute("ContentType", CUSTOM_CONTENT_TYPE); + } else { + const override = doc.createElementNS( + CONTENT_TYPES_NS, + "Override", + ); + + override.setAttribute( + "PartName", + "/docProps/custom.xml", + ); + + override.setAttribute( + "ContentType", + CUSTOM_CONTENT_TYPE, + ); + + root.appendChild(override); + } + + zip.file( + fileName, + new XMLSerializer().serializeToString(doc), + ); +} +/** how to use +const templateBuffer = readFileSync("template.docx"); +const outputBuffer = setDocPropsCustom(templateBuffer, { + DocumentCode: "DOC-2026-001", + Department: "ฝ่ายเทคโนโลยีสารสนเทศ", + Revision: 2, + IsApproved: true, + PublishedAt: new Date(), +}); +writeFileSync("output.docx", outputBuffer); + */ +export function setCustomDocProps( + docxBuffer: Buffer | Uint8Array, + data: Record, +): Buffer { + const zip = new PizzaZip(docxBuffer); + + // อ่าน Custom Properties เดิม หรือสร้างใหม่หากไม่มี + const customFile = zip.file(CUSTOM_PATH); + + const doc = customFile + ? parseXml(customFile.asText(), CUSTOM_PATH) + : createCustomXml(); + + const root = assertRoot( + doc, + CUSTOM_NS, + "Properties", + CUSTOM_PATH, + ); + + // รับรองว่ามี Namespace vt สำหรับ Value Elements + root.setAttributeNS(XMLNS_NS, "xmlns:vt", VT_NS); + + const properties = Array.from( + root.getElementsByTagNameNS(CUSTOM_NS, "property"), + ) as XmlElement[]; + + const propertyMap = new Map(); + const usedPids = new Set(); + + for (const property of properties) { + const name = property.getAttribute("name"); + const pidText = property.getAttribute("pid"); + const pid = Number(pidText); + + if (!name) { + throw new Error( + "Custom property is missing its name attribute", + ); + } + + if (propertyMap.has(name)) { + throw new Error(`Duplicate custom property name: ${name}`); + } + + if (pidText === null || + !/^[1-9]\d*$/.test(pidText) || + !Number.isSafeInteger(pid) || + pid < 2 + ) { + throw new Error( + `Invalid custom property pid for "${name}": ${pidText}`, + ); + } + + if (usedPids.has(pid)) { + throw new Error(`Duplicate custom property pid: ${pid}`); + } + + propertyMap.set(name, property); + usedPids.add(pid); + } + + let nextPid = 2; + + for (const [name, value] of Object.entries(data)) { + if (!name.trim()) { + throw new Error("Custom property name must not be empty"); + } + + let property = propertyMap.get(name); + + if (!property) { + while (usedPids.has(nextPid)) { + nextPid++; + } + + property = doc.createElementNS( + CUSTOM_NS, + "property", + ); + + property.setAttribute("fmtid", CUSTOM_FMTID); + property.setAttribute("pid", String(nextPid)); + property.setAttribute("name", name); + + usedPids.add(nextPid); + nextPid++; + + root.appendChild(property); + propertyMap.set(name, property); + } + + // สร้างค่าใหม่ก่อนแก้ไข Property เดิม + const valueElement = createValueElement(doc, value); + + while (property.firstChild) { + property.removeChild(property.firstChild); + } + + property.appendChild(valueElement); + } + + // อัปเดตไฟล์ Custom Properties + zip.file( + CUSTOM_PATH, + new XMLSerializer().serializeToString(doc), + ); + + // ตรวจสอบส่วนประกอบที่เชื่อมโยงกับ Custom Properties + ensureCustomRelationship(zip); + ensureCustomContentType(zip); + + return Buffer.from( + zip.generate({ + type: "nodebuffer", + compression: "DEFLATE", + }), + ); +} + +/** + * ดึงค่า Custom Document Properties จาก DOCX Buffer + */ +export function getCustomDocProps( + docxBuffer: Buffer | Uint8Array, +): Record { + const zip = new PizzaZip(docxBuffer); + const customFile = zip.file(CUSTOM_PATH); + + if (!customFile) { + return {}; + } + + const doc = parseXml(customFile.asText(), CUSTOM_PATH); + const root = assertRoot( + doc, + CUSTOM_NS, + "Properties", + CUSTOM_PATH, + ); + + const properties = Array.from( + root.getElementsByTagNameNS(CUSTOM_NS, "property"), + ) as XmlElement[]; + + const result: Record = {}; + + for (const property of properties) { + const name = property.getAttribute("name"); + if (!name) continue; + + // หา child element แรกที่อยู่ใน VT_NS namespace + let valueNode: XmlElement | undefined; + for (let i = 0; i < property.childNodes.length; i++) { + const node = property.childNodes[i] as XmlElement; + if (node.nodeType === 1 && node.namespaceURI === VT_NS) { + valueNode = node; + break; + } + } + + if (!valueNode) { + result[name] = ""; + continue; + } + + const textContent = valueNode.textContent || ""; + + // แปลงค่ากลับตาม VT Data Type + switch (valueNode.localName) { + case "bool": + result[name] = textContent === "true" || textContent === "1"; + break; + + case "i1": + case "i2": + case "i4": + case "i8": + case "int": + case "ui1": + case "ui2": + case "ui4": + case "ui8": + case "uint": + case "r4": + case "r8": + case "decimal": { + const num = Number(textContent); + result[name] = Number.isNaN(num) ? textContent : num; + break; + } + + case "filetime": + case "date": { + const date = new Date(textContent); + result[name] = Number.isNaN(date.getTime()) ? textContent : date; + break; + } + + default: + // vt:lpwstr, vt:lpstr, vt:bstr และอื่นๆ + result[name] = textContent; + break; + } + } + + return result; +} + +const CORE_NS = + "http://schemas.openxmlformats.org/package/2006/metadata/core-properties"; +const DC_NS = "http://purl.org/dc/elements/1.1/"; +const DCTERMS_NS = "http://purl.org/dc/terms/"; +const APP_NS = + "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties"; + +export interface DocPropsOptions { + standard?: boolean; + extended?: boolean; + custom?: boolean; +} + +export interface StandardDocProps { + title?: string; + subject?: string; + creator?: string; + keywords?: string; + description?: string; + lastModifiedBy?: string; + revision?: string; + created?: Date; + modified?: Date; + category?: string; + contentStatus?: string; +} + +export interface ExtendedDocProps { + template?: string; + totalTime?: number; + pages?: number; + words?: number; + characters?: number; + charactersWithSpaces?: number; + lines?: number; + paragraphs?: number; + application?: string; + appVersion?: string; + company?: string; + manager?: string; + docSecurity?: number; +} + +export interface DocPropsResult { + standard?: StandardDocProps; + extended?: ExtendedDocProps; + custom?: Record; +} + +/** + * ดึงข้อมูล Properties ของเอกสาร DOCX ตามประเภทที่เลือก + * example: + * const allProps = getDocProps(docxBuffer); + * const selectedProps = getDocProps(docxBuffer, { + * standard: true, + * custom: true, + * extended: false, + * }); + * console.log(allProps); + * console.log(selectedProps.standard?.title); + */ + +export function getDocProps( + docxBuffer: Buffer | Uint8Array, + options: DocPropsOptions = { standard: true, extended: true, custom: true }, +): DocPropsResult { + const zip = new PizzaZip(docxBuffer); + const result: DocPropsResult = {}; + + // 1. Standard / Core Properties (docProps/core.xml) + if (options.standard) { + const coreFile = zip.file("docProps/core.xml"); + if (coreFile) { + const doc = parseXml(coreFile.asText(), "docProps/core.xml"); + const getText = (ns: string, localName: string) => { + const els = doc.getElementsByTagNameNS(ns, localName); + return els.length > 0 ? els[0].textContent || "" : undefined; + }; + + const parseDate = (dateStr?: string) => { + if (!dateStr) return undefined; + const d = new Date(dateStr); + return Number.isNaN(d.getTime()) ? undefined : d; + }; + + result.standard = { + title: getText(DC_NS, "title"), + subject: getText(DC_NS, "subject"), + creator: getText(DC_NS, "creator"), + keywords: getText(CORE_NS, "keywords"), + description: getText(DC_NS, "description"), + lastModifiedBy: getText(CORE_NS, "lastModifiedBy"), + revision: getText(CORE_NS, "revision"), + created: parseDate(getText(DCTERMS_NS, "created")), + modified: parseDate(getText(DCTERMS_NS, "modified")), + category: getText(CORE_NS, "category"), + contentStatus: getText(CORE_NS, "contentStatus"), + }; + } + } + + // 2. Extended / Automatically Updated Properties (docProps/app.xml) + if (options.extended) { + const appFile = zip.file("docProps/app.xml"); + if (appFile) { + const doc = parseXml(appFile.asText(), "docProps/app.xml"); + const getText = (localName: string) => { + const els = doc.getElementsByTagNameNS(APP_NS, localName); + return els.length > 0 ? els[0].textContent || "" : undefined; + }; + + const parseNum = (val?: string) => { + if (!val) return undefined; + const n = Number(val); + return Number.isNaN(n) ? undefined : n; + }; + + result.extended = { + template: getText("Template"), + totalTime: parseNum(getText("TotalTime")), + pages: parseNum(getText("Pages")), + words: parseNum(getText("Words")), + characters: parseNum(getText("Characters")), + charactersWithSpaces: parseNum(getText("CharactersWithSpaces")), + lines: parseNum(getText("Lines")), + paragraphs: parseNum(getText("Paragraphs")), + application: getText("Application"), + appVersion: getText("AppVersion"), + company: getText("Company"), + manager: getText("Manager"), + docSecurity: parseNum(getText("DocSecurity")), + }; + } + } + + // 3. Custom Properties (docProps/custom.xml) + if (options.custom) { + result.custom = getCustomDocProps(docxBuffer); + } + + return result; +} + + +//**************************** dynamic content ******************************************* +// sdtLocked(ห้ามลบ CC), contentLocked(ลบได้ห้ามแก้), sdtContentLocked(ห้ามทุกอย่าง) +type LockType = 'none' | 'sdtLocked' | 'contentLocked' | 'sdtContentLocked'; + +/** + * ฟังก์ชันสร้าง Plain Text Content Control XML String ครอบด้วย || + * ระวังการเกิดหลายรัน จะทำให้ xml เสีย + */ +function p_cc(title:string,tag:string,text:string='',isMultiLine:boolean=true,lock:LockType='sdtLocked'): string { + const lockTag = lock=='none'?"":`` + const multiLineTag = isMultiLine ? '':'' + const content = escapeXml(text) + const xmlString =`${lockTag}${multiLineTag}${content}` + return `||${xmlString}||`; +} +function br(n: number) +{ + let text="" + for(let i=0;i||`; +} +/** + * Escapes XML Special Characters + */ +function escapeXml(unsafe: string): string { + return unsafe + .replace(/&/g, '&') + .replace(//g, '>') + .replace(/"/g, '"') + .replace(/'/g, '''); +} +export const templateDynamicContents = async (template: Buffer, data: Record): Promise => { + return await createReport({ + template, data, cmdDelimiter: ['{{', '}}'], + additionalJsContext: { + bm,br, + p_cc, + } + }); +} + +// สร้างเอกสารจาก เทมเพลต+data render และ generate ใช้งานเหมือนกัน +// ยังไม่ค่อยแน่ใจว่าควรอยู่ใน library นี้หรือเปล่าเพราะมีการทำ hash/sign ticket_data +// - ticket_data ต้องมีข้อมูลสมบูรณ์ {fid,tid,uid,uname} +// - สร้าง signature/hash จาก ticket_data +// - สร้าง Dynamic Content (docx-templates) +// - เอาข้อมูลใส่ Content Control +export async function applyTemplate(templateBuffer:Buffer,templateData:DocumentTemplate, + secret:string,private_key:string,ttl:number):Promise> +{ + //Calculate hash + const originalTicket_data = templateData?.info?.ticket_data //expect valid json string + // console.log("templateData",templateData?.info?.ticket_data) + if (originalTicket_data && typeof originalTicket_data === 'string') { + try { + const originalTicketObj = JSON.parse(originalTicket_data)//sort and add expire to ticket data + if (originalTicketObj && typeof originalTicketObj === 'object') { + console.log("Found valid ticket data: hash it") + // คำนวณค่า expire (ปัจจุบัน + จำนวนวินาทีที่ต้องการให้หมดอายุ) + // หาร 1000 เพราะต้องการหน่วยวินาที (sec) ไม่ใช่มิลลิวินาที (ms) + const expireTimestamp = Math.floor(Date.now() / 1000) + ttl; + const fullObj = { ...originalTicketObj, exp: expireTimestamp }; + const sortedObj = sortObjectKeys(fullObj); + + // แปลงกลับเป็น JSON string เพื่อนำไปใช้ส่งและทำ Hash + const ticket_data = JSON.stringify(sortedObj); + // console.log("check secret:",TEST_SECRET,TEST_PRIVATE_KEY_HEX,ticket_data) + const HmacSha256 = generateHmacSha256(ticket_data, secret) + + const Ed25519 = signEd25519(ticket_data, private_key) + templateBuffer = setCustomDocProps(templateBuffer, { ticket_data, HmacSha256, Ed25519 }) + } + } catch (error) { //just skip + console.error("Set custom property fail",error); + } + } + + // Apply Dynamic Content + if (templateData?.dc && typeof templateData?.dc === "object") { + console.log("Apply Dynamic Content") + templateBuffer = Buffer.from(await templateDynamicContents(templateBuffer, templateData.dc)) + } + // Apply Content Control + if (templateData?.cc && typeof templateData?.cc === "object") { + console.log("Apply Content Control") + templateBuffer = templateContentControls(templateBuffer, templateData.cc); + } + return templateBuffer + +} \ No newline at end of file diff --git a/lib/lib-utils.ts b/lib/lib-utils.ts new file mode 100644 index 0000000..312d3cf --- /dev/null +++ b/lib/lib-utils.ts @@ -0,0 +1,112 @@ + +import { createHmac, createPrivateKey, createPublicKey, timingSafeEqual, verify, sign } from 'node:crypto'; +/** + * คำนวณ HMAC-SHA256 จาก string หรือ JSON Object + */ +export function generateHmacSha256(data: string | object, secretKey: string): string { + const payload = typeof data === 'string' ? data : JSON.stringify(data); + return createHmac('sha256', secretKey) + .update(payload, 'utf8') + .digest('hex'); +} + +/** + * ตรวจสอบความถูกต้องของ HMAC (ใช้ timingSafeEqual เพื่อป้องกัน Timing Attacks) + */ +export function verifyHmacSha256(data: string | object, secretKey: string, expectedHmac: string): boolean { + const calculatedHmac = generateHmacSha256(data, secretKey); + const a = Buffer.from(calculatedHmac, 'hex'); + const b = Buffer.from(expectedHmac, 'hex'); + + if (a.length !== b.length) { + return false; + } + return timingSafeEqual(a, b); +} +// ========================================== +// ตัวอย่างการใช้งาน +// ========================================== +/* +const secret = 'my-super-secret-key'; +const jsonData = { + userId: 12345, + action: 'transfer', + amount: 500 +}; + +// 1. สร้าง HMAC +const hmacSignature = generateHmacSha256(jsonData, secret); +console.log('HMAC Signature (Hex):', hmacSignature); + +// 2. ตรวจสอบ HMAC +const isValid = verifyHmacSha256(jsonData, secret, hmacSignature); +console.log('Is Signature Valid?:', isValid); // true +*/ + + +/** + * ฟังก์ชันสำหรับลงนามดิจิทัล (Sign) ข้อมูลด้วย Ed25519 Private Key (Hex) + * @param message ข้อความดิบที่ต้องการเซ็น (string หรือ Buffer) + * @param privateKeyHex คีย์ลับในรูปแบบ Hex String (ความยาว 64 ตัวอักษร) + * @returns ลายเซ็น (Signature) ในรูปแบบ Hex String (ความยาว 128 ตัวอักษร) + */ +export function signEd25519(message: string | Buffer, privateKeyHex: string): string { + const rawKeyBuffer = Buffer.from(privateKeyHex, 'hex'); + // ตัดเอาเฉพาะ 32 bytes (Seed) กรณีที่ Hex ยาว 64 bytes (ที่ต่อกับ Public Key มา) + const seed = rawKeyBuffer.length === 64 ? rawKeyBuffer.subarray(0, 32) : rawKeyBuffer; + // PKCS#8 Header สำหรับ Ed25519 Private Key + const pkcs8Header = Buffer.from('302e020100300506032b657004220420', 'hex'); + const pkcs8Buffer = Buffer.concat([pkcs8Header, seed]); + + const privateKey = createPrivateKey({ + key: pkcs8Buffer, + format: 'der', + type: 'pkcs8', + }); + + const dataBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : message; + const signatureBuffer = sign(null, dataBuffer, privateKey); + return signatureBuffer.toString('hex'); +} + +/** + * ฟังก์ชันสำหรับตรวจสอบลายเซ็น (Verify) ด้วย Ed25519 Public Key (Hex) + * @param message ข้อความดิบที่ใช้ในการเซ็น (string หรือ Buffer) + * @param signatureHex ลายเซ็นในรูปแบบ Hex String + * @param publicKeyHex คีย์สาธารณะในรูปแบบ Hex String (ความยาว 64 ตัวอักษร) + * @returns ผลลัพธ์ความถูกต้อง (true = ผ่าน, false = ไม่ผ่าน) + */ +export function verifyEd25519(message: string | Buffer, signatureHex: string, publicKeyHex: string): boolean { + try { + const rawPublicKey = Buffer.from(publicKeyHex, 'hex'); + + // SPKI Header สำหรับ Ed25519 Public Key (32 bytes) + const spkiHeader = Buffer.from('302a300506032b6570032100', 'hex'); + const spkiBuffer = Buffer.concat([spkiHeader, rawPublicKey]); + + const publicKey = createPublicKey({ + key: spkiBuffer, + format: 'der', + type: 'spki', + }); + + const dataBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : message; + const signatureBuffer = Buffer.from(signatureHex, 'hex'); + + return verify(null, dataBuffer, publicKey, signatureBuffer); + } catch (error) { + return false; + } +} + +/** + * ฟังก์ชันสำหรับเรียงคีย์ของ Object ตามตัวอักษรเพื่อไม่ให้โครงสร้าง JSON เพี้ยน + */ +export function sortObjectKeys(obj: Record): Record { + return Object.keys(obj) + .sort() + .reduce((result: Record, key: string) => { + result[key] = obj[key]; + return result; + }, {}); +} \ No newline at end of file diff --git a/lib/openapi.ts b/lib/openapi.ts index 4cd07d3..4dc3b66 100644 --- a/lib/openapi.ts +++ b/lib/openapi.ts @@ -32,15 +32,18 @@ export const openApiSpec = { { name: "template", description: - "Template เอกสาร DOCX ด้วย Content Control — ส่ง template (.docx) + data (JSON) " + - "แล้วได้เอกสารที่กรอกค่าแล้วกลับมา", + "Next Generation of Template : เป็นเทมเพลต MS Word(docx) รองรับรูปแบบข้อมูลที่ซับซ้อนได้ ", }, { name: "documents", description: - "จัด version เอกสาร (docver — docs/PLAN-DOCVER.md): เอกสารเดียวต่อ docId แต่ละ " + - "version เก็บ .docx + .pdf ใน MinIO พร้อมผู้อัปโหลด — ไม่มี auth (stand-alone): " + - "ผู้เรียกบอก userId/userName เองใน multipart", + "จัด version เอกสาร (docver): เอกสารเดียวต่อ docId แต่ละ " + + "version เก็บ .docx + .pdf ใน MinIO พร้อมผู้อัปโหลด — auth ด้วย access_token " + + "ของกลุ่มนี้: ขอที่ POST /api/documents/token ได้ 2 ทาง (x-api-key + body claims " + + "สำหรับระบบภายนอก หรือ body ticket_data+HmacSha256 สำหรับ add-in — PLAN-ADDIN-AUTH.md) " + + "แล้วแนบ Authorization: Bearer ทุก request — identity/template " + + "และ docId (= fid — fileId ของ e-Court, string) แกะจาก claims ของ token ทั้งหมด " + + "ไม่รับจาก URL/multipart form อีก", }, { name: "Judge's Note", @@ -72,53 +75,15 @@ export const openApiSpec = { }, }, }, - "/api/template/extract": { - post: { - tags: ["template"], - summary: "ดึงค่า Content Control ทั้งหมดออกมาจากไฟล์ .docx", - description: - "อ่าน w:sdt (Content Control) ทุกตัวใน word/document.xml — คืน map " + - "ชื่อแท็ก (w:tag) → ข้อความปัจจุบันในนั้น (ใช้สำรวจว่า template มีแท็กอะไรบ้างก่อนเรียก render)", - requestBody: { - required: true, - content: { - "multipart/form-data": { - schema: { - type: "object", - required: ["file"], - properties: { - file: { - type: "string", - format: "binary", - description: "ไฟล์ .docx ที่มี Content Control", - }, - }, - }, - }, - }, - }, - responses: { - 200: { - description: "รายการแท็กพร้อมข้อความ", - content: { - "application/json": { - schema: { $ref: "#/components/schemas/ExtractResponse" }, - }, - }, - }, - 400: { $ref: "#/components/responses/BadRequest" }, - 500: { $ref: "#/components/responses/ServerError" }, - }, - }, - }, "/api/template/render": { post: { tags: ["template"], - summary: "สร้างเอกสารจาก template (.docx) + data (JSON)", + summary: "สร้างเอกสารจาก template (.docx) + data (JSON) ใช้สำหรับนักพัฒนาเท่านั้น", description: "แทนค่า JSON ลงใน Content Control ของ template แล้วคืนไฟล์ .docx ใหม่ " + '(filename ตอน download = generated-document.docx) — ส่ง data ได้ 2 ทาง: ' + - 'field "data" เป็นไฟล์ JSON หรือ field "dataJson" เป็น string ตรง ๆ (เลือกอย่างใดอย่างหนึ่ง)', + 'field "data" เป็นไฟล์ JSON หรือ field "dataJson" เป็น string ตรง ๆ (เลือกอย่างใดอย่างหนึ่ง)
'+ + 'สำหรับนักพัฒนา Template เท่านั้น ไม่ต้อง ใช้ API Key ต้องตั้งค่า secret และ private key เองไม่ใช้ของระบบของระบบ', requestBody: { required: true, content: { @@ -140,9 +105,23 @@ export const openApiSpec = { dataJson: { type: "string", description: - "JSON เป็น string ตรง ๆ (ทางเลือกแทนการแนบไฟล์ data)", + "JSON เป็น string ตรง ๆ (ทางเลือกแทนการแนบไฟล์ data)
{\"info:\"{\"ticket_data\":\"JSON String\"},\"dc:\"{..},\"dc:\"{\"blackyear\": \"๙๐/๒๕๖๙\",...}}", example: - '{"notname":"คำสั่งเรียก ให้ทำคำให้การ","blackno":"คดีหมายเลขดำที่","blackyear":"๑๐/๒๕๖๙"}', + '', + }, + secret: { + type: "string", + description: + "ค่า secret สำหรับทดสอบการทำ HMAC-SHA256", + example: + 'super_secret', + }, + private_key: { + type: "string", + description: + "Private key ในรูปแบบ HEX
openssl genpkey -algorithm ED25519 -out private.pem
openssl pkey -in private.pem -outform DER | tail -c 32 | xxd -p -c 32 > private.hex
openssl pkey -in private.pem -pubout -outform DER | tail -c 32 | xxd -p -c 32 > public.hex", + example: + '8f2077b57b39399b6a7828f35da03a63ade8e3a36a6bf437b091a8bdb3d18ee1', }, }, }, @@ -163,6 +142,410 @@ export const openApiSpec = { }, }, }, + "/api/template/extract": { + post: { + tags: ["template"], + summary: "ดึงค่า Content Control ทั้งหมดออกมาจากไฟล์ .docx ใช้สำหรับนักพัฒนาเท่านั้น", + description: + "อ่าน Content Control, bookmark , property ของ MS Word(docx) ออกมาแสดง" + + "ค่าของ Content Control จะเป็น Plain Text ไม่มี markup ซึ่งเหมาะกับการเอาไปใส่ในฐานข้อมูล"+ + 'สำหรับนักพัฒนา Template เท่านั้น ไม่ต้อง ใช้ API Key ต้องตั้งค่า secret และ Public key เองไม่ใช้ของระบบของระบบ', + requestBody: { + required: true, + content: { + "multipart/form-data": { + schema: { + type: "object", + required: ["file"], + properties: { + file: { + type: "string", + format: "binary", + description: "ไฟล์ .docx ที่มี Content Control", + }, + secret: { + type: "string", + description: + "ค่า secret สำหรับ validate HMAC-SHA256 กับข้อมูลใน custom property", + example: + "super_secret", + }, + public_key: { + type: "string", + description: + "Public key ในรูปแบบ HEX
openssl genpkey -algorithm ED25519 -out private.pem
openssl pkey -in private.pem -outform DER | tail -c 32 | xxd -p -c 32 > private.hex
openssl pkey -in private.pem -pubout -outform DER | tail -c 32 | xxd -p -c 32 > public.hex", + example: + "66b09b4a1b66271d5728c592c2409657e1c070a7bf371bf9f6ed457855270546", + }, + }, + }, + }, + }, + }, + responses: { + 200: { + description: "รายการแท็กพร้อมข้อความ", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/ExtractResponse" }, + }, + }, + }, + 400: { $ref: "#/components/responses/BadRequest" }, + 500: { $ref: "#/components/responses/ServerError" }, + }, + }, + }, + "/api/template/generate": { + post: { + tags: ["template"], + summary: "สร้างเอกสาร DOCX จากข้อมูล JSON และ template ที่กำหนด", + description: + "เทมเพลตมีแท็กแบบพิเศษ(รองรับตัวแปร ลูป เงื่อนไข), Content Control เมื่อรวมกับข้อมูล(JSON) "+ + "จะได้เอกสาร รูปแบบฟอร์มที่กรอกค่าแล้วดึงค่ากลับมาใช้งานต่อได้เช่นอัปเดตฐานข้อมูล
    "+ + "
  • JSON payload ต้องมี info.ticket_data เป็น JSON string รูปแบบถูกต้อวมีค่าครบ(tid, fid และ uid)
    • " + + "
  • ไฟล์เทมเพลต(tid)ในระบบ + ข้อมูล(payload) เพื่อสร้างเอกสาร
    • " + + "
  • ticket_data จะทำการ hash/sign แบบอายุสั้นแล้วนำไปฝังไว้ใน custom property เพื่อนำไปใช้ร่วมกับระบบ Versioning
    • "+ + "
", + security: [{ ApiKeyAuth: [] }], + requestBody: { + required: true, + content: { + "application/json": { + schema: { + type: "object", + required: ["info"], + properties: { + info: { + type: "object", + required: ["ticket_data"], + properties: { + ticket_data: { + type: "string", + description: + "JSON string ที่ต้อง parse ได้ และต้องมี tid, fid และ uid", + example: + '{"tid":"T12","fid":"DOC-2569-0001","uid":"123"}', + }, + }, + additionalProperties: true, + }, + }, + additionalProperties: true, + }, + example: { + "info": { + "ticket_data": "{\"fid\":\"T12_b2_IN\",\"tid\":\"T12_X\",\"uid\":\"oom\",\"uname\":\"สรวิชญ์\"}" + }, + "dc": { + "Interpleader": true, + "docname": "", + "docabbr": "(ต. ๑๒)", + "blackno": "คดีหมายเลขดำที่", + "redno": "คดีหมายเลขแดงที่", + "court": "ศาลปกครองนครราชสีมา", + "panels": [ + { + "pname": "นายวิรุฬห์ จินตนะกุล", + "pmname": "ตุลาการศาลปกครองกลาง", + "pm": "ตุลาการเจ้าของสำนวน" + }, + { + "pname": "นายสัมฤทธิ์ อ่อนคำ", + "pmname": "ตุลาการศาลปกครองสูงสุด" + } + ], + "pnameT": "", + "pmnameT": "", + "pmT": "", + "acc_name": "" + + }, + "cc": { + "blackyear": "๙๐/๒๕๖๙", + "redyear": "", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙", + "accuser": "นายธีรพล ร่มเริง", + "acc1": "ผู้ฟ้องคดี", + "accused": "รร", + "acc2": "ผู้ถูกฟ้องคดี", + "interpleader": "สมชาย ใจดี", + "acc3": "ผู้ร้องสอด", + "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้องและเอกสารประกอบคำฟ้องแล้วเห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด ผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไขความเดือดร้อนหรือเสียหายก่อนฟ้องคดี และผู้ฟ้องคดีได้ดำเนินการครบถ้วน โดยเป็นการยื่นฟ้องคดีภายในระยะเวลาการฟ้องคดีตาม พรบ. จัดตั้งศาลปกครองและวิธีพิจารณาคดีปกครองฯ คดีนี้มีค่าธรรมเนียมที่ต้องชำระ\nโดยผู้ฟ้องคดีได้ชำระค่าธรรมเนียมครบถ้วนแล้ว รวมทั้งคดีนี้ไม่เป็นการฟ้องซ้อน การดำเนินกระบวนพิจารณาซ้ำ และการฟ้องซ้ำ\n\nจึงมีคำสั่งรับคำฟ้องไว้พิจารณาและสั่งให้ส่งสำเนาคำฟ้องพร้อมทั้งสำเนาพยานหลักฐานไปยังผู้ถูกฟ้องคดีเพื่อให้ผู้ถูกฟ้องคดีทำคำให้การยื่นต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่ง" + } + }, + }, + }, + }, + responses: { + 200: { + description: "ไฟล์ DOCX ที่สร้างสำเร็จ", + headers: { + "Content-Disposition": { + description: "ชื่อไฟล์สำหรับดาวน์โหลด", + schema: { type: "string" }, + }, + "Cache-Control": { + description: "ป้องกันการ cache response", + schema: { type: "string", example: "no-store, max-age=0" }, + }, + }, + content: { + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + schema: { type: "string", format: "binary" }, + }, + }, + }, + 400: { + description: + "JSON ไม่มี info.ticket_data, ticket_data ไม่ใช่ string, JSON string ไม่ถูกต้อง หรือไม่มี tid/fid/uid", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + examples: { + missingTicketData: { + value: { + error: + "template/generate json.info.ticket_data not avaliable", + }, + }, + missingIdentifiers: { + value: { + error: + "template/generate require json.info.ticket_data.(fid|tid|uid)", + }, + }, + }, + }, + }, + }, + 401: { + description: "ไม่ได้ส่ง x-api-key หรือ API key ไม่ถูกต้อง", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + example: { error: "Unauthorized: Invalid API Key" }, + }, + }, + }, + 404: { + description: "ไม่สามารถดึงข้อมูลขึ้นมาได้", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + example: { error: "NotFound: Invalid template ID or incorrect storage path" }, + }, + }, + }, + 500: { + description: + "เกิดข้อผิดพลาดระหว่างอ่าน template หรือสร้างเอกสาร", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + example: { error: "Failed to generate document payload" }, + }, + }, + }, + }, + }, + }, + "/api/template/download-docx": { + get: { + tags: ["template"], + summary: "ดาวน์โหลดเอกสาร DOCX ผ่าน Query Parameters (GET) ใช้เพื่อเป็นตัวอย่างจะถูกเอาออกในภายหลัง", + description: + "รับค่า fid, tid, uid, uname จาก Query Parameter อ่านข้อมูล JSON ประจำไฟล์ fid จาก TMPL_PATH แล้วส่งไปประมวลผลต่อที่ /api/template/generate เพื่อสร้างและคืนค่าเป็นไฟล์ DOCX stream ใช้เพื่อเป็นตัวอย่างสำหรับนักพัฒนา ต้องนำออกก่อน production", + parameters: [ + { + name: "fid", + in: "query", + required: true, + schema: { type: "string" }, + description: "ID เอกสาร (File ID)", + example: "T_no_warning", + }, + { + name: "tid", + in: "query", + required: true, + schema: { type: "string" }, + description: "ID เทมเพลต (Template ID)", + example: "T_X", + }, + { + name: "uid", + in: "query", + required: true, + schema: { type: "string" }, + description: "รหัสผู้ใช้งาน (User ID)", + example: "123", + }, + { + name: "uname", + in: "query", + required: true, + schema: { type: "string" }, + description: "ชื่อผู้ใช้งาน (User Name)", + example: "สมชาย ใจดี", + }, + ], + responses: { + 200: { + description: "ไฟล์ DOCX stream ที่สร้างสำเร็จ", + headers: { + "Content-Disposition": { + description: "ชื่อไฟล์สำหรับการดาวน์โหลด (attachment)", + schema: { type: "string", example: 'attachment; filename="T_no_warning_123_xxx.docx"' }, + }, + "Cache-Control": { + description: "การควบคุม Cache (no-store)", + schema: { type: "string", example: "no-store, max-age=0" }, + }, + }, + content: { + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + schema: { type: "string", format: "binary" }, + }, + }, + }, + 400: { + description: "พารามิเตอร์ไม่ครบถ้วน หรือรูปแบบไฟล์ JSON ไม่ถูกต้อง", + content: { + "text/plain": { + schema: { type: "string" }, + examples: { + missingParams: { value: "Missing fid,tid,uid or uname" }, + invalidData: { value: "Invalid data format" }, + }, + }, + }, + }, + 404: { + description: "ไม่พบไฟล์ข้อมูล JSON ใน TMPL_PATH", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + example: { error: "Data not found: /path/to/TMPL_PATH/T_no_warning.json" }, + }, + }, + }, + 502: { + description: "เกิดข้อผิดพลาดในการเรียกไปยังบริการ Docedit /api/template/generate", + content: { + "text/plain": { + schema: { type: "string" }, + example: "Error from docedit generate: Expected docx stream but received text/html (Status 500)", + }, + }, + }, + 500: { + description: "เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์", + content: { + "text/plain": { + schema: { type: "string" }, + example: "Internal Server Error", + }, + }, + }, + }, + }, + post: { + tags: ["template"], + summary: "ดาวน์โหลดเอกสาร DOCX ผ่าน HTML Form / Multipart Form Data (POST) เป็นตัวอย่างเท่านั้น จะถูกเอาออกในภายหลัง", + description: + "รับค่า fid, tid, uid, uname จาก Multipart Form Data หรือ Form-urlencoded อ่านข้อมูล JSON และประมวลผลสร้างไฟล์ DOCX stream คืนกลับไป "+ + "จะเรียก generate ในเบื้องหลัง ใช้เพื่อเป็นตัวอย่างสำหรับนักพัฒนา ต้องนำออกก่อน production", + requestBody: { + required: true, + content: { + "multipart/form-data": { + schema: { + type: "object", + required: ["fid", "tid", "uid", "uname"], + properties: { + fid: { type: "string", description: "ID เอกสาร (File ID)",example:"T12_b2_IN" }, + tid: { type: "string", description: "ID เทมเพลต (Template ID)",example:"T12_X" }, + uid: { type: "string", description: "รหัสผู้ใช้งาน (User ID)", example:"john" }, + uname: { type: "string", description: "ชื่อผู้ใช้งาน (User Name)", example:"John Doe"}, + }, + }, + }, + "application/x-www-form-urlencoded": { + schema: { + type: "object", + required: ["fid", "tid", "uid", "uname"], + properties: { + fid: { type: "string", description: "ID เอกสาร (File ID)" }, + tid: { type: "string", description: "ID เทมเพลต (Template ID)" }, + uid: { type: "string", description: "รหัสผู้ใช้งาน (User ID)" }, + uname: { type: "string", description: "ชื่อผู้ใช้งาน (User Name)" }, + }, + }, + }, + }, + }, + responses: { + 200: { + description: "ไฟล์ DOCX stream ที่สร้างสำเร็จ", + headers: { + "Content-Disposition": { + description: "ชื่อไฟล์สำหรับการดาวน์โหลด (attachment)", + schema: { type: "string", example: 'attachment; filename="T12_b2_IN_john_xxx.docx"' }, + }, + "Cache-Control": { + description: "การควบคุม Cache (no-store)", + schema: { type: "string", example: "no-store, max-age=0" }, + }, + }, + content: { + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + schema: { type: "string", format: "binary" }, + }, + }, + }, + 400: { + description: "พารามิเตอร์ไม่ครบถ้วน หรือรูปแบบไฟล์ JSON ไม่ถูกต้อง", + content: { + "text/plain": { + schema: { type: "string" }, + examples: { + missingParams: { value: "Missing fid,tid,uid or uname" }, + invalidData: { value: "Invalid data format" }, + }, + }, + }, + }, + 404: { + description: "ไม่พบไฟล์ข้อมูล JSON ใน TMPL_PATH", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + example: { error: "Data not found: /path/to/TMPL_PATH/T12_b2_IN.json" }, + }, + }, + }, + 502: { + description: "เกิดข้อผิดพลาดในการเรียกไปยังบริการ Docedit /api/template/generate", + content: { + "text/plain": { + schema: { type: "string" }, + example: "Error from docedit generate: Expected docx stream but received text/html (Status 500)", + }, + }, + }, + 500: { + description: "เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์", + content: { + "text/plain": { + schema: { type: "string" }, + example: "Internal Server Error", + }, + }, + }, + }, + }, + }, "/api/note/external/documents": { post: { tags: ["external"], @@ -225,31 +608,99 @@ export const openApiSpec = { }, }, }, - "/api/documents/{docId}/versions": { + "/api/documents/token": { + post: { + tags: ["documents"], + summary: "ขอ access_token ของกลุ่ม documents (docver)", + description: + "ออก access_token ใช้กับ endpoint อื่นของกลุ่ม documents เท่านั้น — token เป็น " + + "JWT HS256 ฝัง claims {userid, username, fid, template} อายุตาม env " + + "DOCVER_TOKEN_TTL_SECONDS (default 3600 วินาที) · identity (userId/userName), " + + "templateId และ docId (= fid) ตอนทำงานแกะจาก claims ของ token นี้ — " + + "fid จึงบังคับ · ทางเข้า 2 ทาง (header x-api-key เป็นตัวตั้ง): " + + "(1) ระบบภายนอก server-to-server — header x-api-key (env DOCVER_API_KEY) + body " + + "claims ตรง ๆ (2) add-in ใน Word — ไม่มี x-api-key + body {ticket_data, " + + "HmacSha256} ตามที่ e-Court stamp มากับไฟล์ — server ตรวจ HMAC-SHA256 ด้วย env " + + "ADDIN_TICKET_SECRET (ไม่ตั้ง = env SECRET ไม่ตั้ง = \"super_secret\") และ exp " + + "ของ ticket ก่อนออก token จาก claims ในตัว ticket เอง", + security: [{ ApiKeyAuth: [] }], + requestBody: { + required: true, + content: { + "application/json": { + schema: { + oneOf: [ + { $ref: "#/components/schemas/TokenRequest" }, + { $ref: "#/components/schemas/TicketTokenRequest" }, + ], + }, + examples: { + "server-to-server ด้วย x-api-key (ครบทุก claim)": { + value: { + userid: "123", + username: "Sorawit Bholsithi", + fid: "3", + template: "T12", + }, + }, + "server-to-server ขั้นต่ำ (template เป็นทางเลือก)": { + value: { userid: "123", username: "Sorawit Bholsithi", fid: "3" }, + }, + "add-in ด้วย ticket จากไฟล์ (ไม่ต้องมี x-api-key)": { + value: { + ticket_data: + '{"exp":1793067433,"fid":"T12_FD155_3s-long_ZZZ","tid":"T12","uid":"oom","uname":"สรวิชญ์"}', + HmacSha256: + "1dc53fbd48410845c895ddb841a8fe4ad93da413126fae9c688202e57f2baaa9", + }, + }, + }, + }, + }, + }, + responses: { + 200: { + description: "access_token พร้อมใช้ (แนบเป็น Authorization: Bearer ทุก request ถัดไป)", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/TokenResponse" }, + }, + }, + }, + 400: { $ref: "#/components/responses/BadRequest" }, + 401: { + description: + "ทางเข้า x-api-key: ไม่ได้ส่ง header หรือค่าไม่ถูกต้อง (env DOCVER_API_KEY) · " + + "ทางเข้า ticket: ticket ไม่ถูกต้อง/หมดอายุ หรือไม่ได้ส่งมา (ข้อความเดียวกันทุกสาเหตุ)", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + }, + }, + }, + 500: { $ref: "#/components/responses/ServerError" }, + }, + }, + }, + "/api/documents/versions": { post: { tags: ["documents"], summary: "อัปโหลด version ใหม่ของเอกสาร (docx + pdf)", description: - "สร้างเอกสารอัตโนมัติเมื่อ docId ยังไม่เคยมี (docId ห้ามซ้ำ) แล้วเก็บไฟล์ " + - ".docx (+ .pdf ถ้าแนบมา) ลง MinIO พร้อมผู้อัปโหลด — versionNumber ที่ server จ่าย " + - "คือค่าจริงเสมอ (client ที่เลขไม่ตรงต้องแก้ XML part ของตัวเอง) · pdf เป็น " + - "optional: ไม่แนบ/ไฟล์เปล่า = version นี้ไม่มีสำเนา PDF (ดู hasPdf ใน response)", - parameters: [ - { - name: "docId", - in: "path", - required: true, - schema: { type: "string" }, - description: "รหัสเอกสารจากผู้เรียก (add-in GUID / รหัส e-Court) — [A-Za-z0-9._:-]", - }, - ], + "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) — สร้างเอกสาร " + + "อัตโนมัติเมื่อ docId ยังไม่เคยมี แล้วเก็บไฟล์ .docx (+ .pdf ถ้าแนบมา) ลง MinIO " + + "พร้อมผู้อัปโหลด — versionNumber ที่ server จ่ายคือค่าจริงเสมอ (client ที่เลขไม่ตรง " + + "ต้องแก้ XML part ของตัวเอง) · pdf เป็น optional: ไม่แนบ/ไฟล์เปล่า = version นี้ไม่มี " + + "สำเนา PDF (ดู hasPdf ใน response) · ผู้อัปโหลด (userId/userName) และ templateId " + + "แกะจาก Bearer token ไม่รับใน form (ส่ง field เหล่านั้นมา = 400)", + security: [{ DocverBearer: [] }], requestBody: { required: true, content: { "multipart/form-data": { schema: { type: "object", - required: ["file", "userId", "userName"], + required: ["file"], properties: { file: { type: "string", @@ -262,14 +713,6 @@ export const openApiSpec = { description: "ไฟล์ .pdf ของ version นี้ (optional — ไม่แนบหรือไฟล์เปล่า = ไม่มี)", }, - userId: { - type: "string", - description: "รหัสผู้อัปโหลด (ระบบ stand-alone ไม่มี session)", - }, - userName: { - type: "string", - description: "ชื่อผู้อัปโหลด (แสดงใน version history)", - }, clientVersionId: { type: "string", description: "GUID ที่ client generate ก่อนเรียก (เก็บไว้สืบสวน ไม่ใช่ identity)", @@ -283,10 +726,6 @@ export const openApiSpec = { type: "string", description: "commit message ของ version (≤ 2048 ตัวอักษร)", }, - templateId: { - type: "string", - description: "รหัส template ที่ใช้สร้างเอกสาร (ถ้ามี)", - }, fileName: { type: "string", description: @@ -307,6 +746,7 @@ export const openApiSpec = { }, }, 400: { $ref: "#/components/responses/BadRequest" }, + 401: { $ref: "#/components/responses/DocverUnauthorized" }, 413: { description: "ไฟล์แนบใหญ่เกิน 100MB", content: { @@ -322,17 +762,10 @@ export const openApiSpec = { tags: ["documents"], summary: "รายการ version ทั้งหมดของเอกสาร (ใหม่ → เก่า)", description: - "version ทุกตัวของ docId นี้ พร้อมผู้อัปโหลด (userId/userName), เวลา, commit " + - "message, ค่า fields และ hasPdf — ใช้เขียน UI version history ของ add-in", - parameters: [ - { - name: "docId", - in: "path", - required: true, - schema: { type: "string" }, - description: "รหัสเอกสารจากผู้เรียก — [A-Za-z0-9._:-]", - }, - ], + "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) — version ทุกตัว " + + "ของเอกสารนั้น พร้อมผู้อัปโหลด (userId/userName), เวลา, commit message, ค่า fields " + + "และ hasPdf — ใช้เขียน UI version history ของ add-in", + security: [{ DocverBearer: [] }], responses: { 200: { description: "รายการ version เรียงใหม่ → เก่า", @@ -346,6 +779,7 @@ export const openApiSpec = { }, }, 400: { $ref: "#/components/responses/BadRequest" }, + 401: { $ref: "#/components/responses/DocverUnauthorized" }, 404: { description: "ไม่พบเอกสารนี้ในระบบ (ยังไม่เคยอัปโหลด version)", content: { @@ -358,22 +792,17 @@ export const openApiSpec = { }, }, }, - "/api/documents/{docId}/versions/{versionId}/download-link": { + "/api/documents/versions/{versionId}/download-link": { get: { tags: ["documents"], summary: "ขอ presigned URL ดาวน์โหลดไฟล์ของ version (docx/pdf)", description: - "คืน URL อายุสั้น (env DOCVER_LINK_TTL_SECONDS, default 900 วินาที) ให้เปิดใน " + - "เบราว์เซอร์/Word ของผู้ใช้ — URL อ้าง endpoint MinIO ตรง ๆ จึงต้องเป็นโฮสต์ที่ " + - "ผู้ใช้เข้าถึงได้ · ขอ pdf ใน version ที่ไม่มีสำเนา = 404", + "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) · คืน URL อายุสั้น " + + "(env DOCVER_LINK_TTL_SECONDS, default 900 วินาที) ให้เปิดในเบราว์เซอร์/Word ของ " + + "ผู้ใช้ — URL อ้าง endpoint MinIO ตรง ๆ จึงต้องเป็นโฮสต์ที่ผู้ใช้เข้าถึงได้ · ขอ pdf " + + "ใน version ที่ไม่มีสำเนา = 404", + security: [{ DocverBearer: [] }], parameters: [ - { - name: "docId", - in: "path", - required: true, - schema: { type: "string" }, - description: "รหัสเอกสาร (ต้องตรงกับ version นี้ — โยน id ข้ามเอกสารไม่ได้)", - }, { name: "versionId", in: "path", @@ -399,6 +828,7 @@ export const openApiSpec = { }, }, 400: { $ref: "#/components/responses/BadRequest" }, + 401: { $ref: "#/components/responses/DocverUnauthorized" }, 404: { description: "ไม่พบ version นี้ของเอกสาร หรือขอ format=pdf ใน version ที่ไม่มีสำเนา PDF", @@ -420,7 +850,17 @@ export const openApiSpec = { in: "header", name: "x-api-key", description: - "ค่าเดียวกับ env EXTERNAL_API_KEY ของ server — กดปุ่ม Authorize ด้านบนเพื่อใส่ครั้งเดียวแล้วใช้ทุก request", + "x-api-key ของ N10 = env EXTERNAL_API_KEY · ของการขอ token กลุ่ม documents = env " + + "DOCVER_API_KEY (คนละค่ากับของ N10 — กดปุ่ม Authorize ใส่ครั้งเดียวแล้วใช้ได้ทุก " + + "request ของกลุ่มที่ key ตรง)", + }, + DocverBearer: { + type: "http", + scheme: "bearer", + bearerFormat: "JWT", + description: + "access_token จาก POST /api/documents/token — แนบเป็น Authorization: Bearer " + + "กับ endpoint อื่นของกลุ่ม documents ทุกตัว", }, }, responses: { @@ -434,6 +874,15 @@ export const openApiSpec = { }, }, }, + DocverUnauthorized: { + description: + "ไม่ได้แนบ Authorization: Bearer หรือ token ไม่ถูกต้อง/หมดอายุ (กลุ่ม documents — ข้อความเดียวกันทุกสาเหตุ)", + content: { + "application/json": { + schema: { $ref: "#/components/schemas/Error" }, + }, + }, + }, ServerError: { description: "เกิดข้อผิดพลาดของระบบ (เช่นไฟล์ .docx ไม่ถูกต้อง / DB ล้ม)", content: { @@ -447,21 +896,104 @@ export const openApiSpec = { Error: { type: "object", properties: { - success: { type: "boolean", example: false }, error: { type: "string" }, }, }, + TokenRequest: { + type: "object", + description: + "claims ที่จะฝังใน access_token (ทางเข้า x-api-key) — key อื่น = 400", + required: ["userid", "username", "fid"], + properties: { + userid: { type: "string", description: "รหัสผู้ใช้ (บังคับ, ≤ 100 ตัวอักษร)" }, + username: { type: "string", description: "ชื่อผู้ใช้ (บังคับ, ≤ 200 ตัวอักษร)" }, + fid: { + type: "string", + description: + "fileId ของ e-Court (บังคับ, ≤ 200 ตัวอักษร) — เป็น docId ของทุก operation ตรง ๆ", + }, + template: { + type: "string", + nullable: true, + description: + "รหัส template ที่ใช้สร้างเอกสาร — กลายเป็น templateId ตอนอัปโหลด version", + }, + }, + }, + TicketTokenRequest: { + type: "object", + description: + "ทางเข้าของ add-in (ไม่ต้องมี x-api-key) — ส่ง ticket ที่ e-Court stamp มากับ " + + "ไฟล์ .docx ใน custom properties ตามเป๊ะ · key อื่น = 400 · server ตรวจ " + + "HMAC-SHA256(ลับ, ticket_data ดิบ) เทียบ HmacSha256 + exp ของ ticket — " + + "ไม่ผ่าน = 401 ข้อความเดียวกันทุกสาเหตุ", + required: ["ticket_data", "HmacSha256"], + properties: { + ticket_data: { + type: "string", + description: + 'JSON string ของ ticket เช่น {"exp":1793067433,"fid":"…","tid":"…","uid":"…","uname":"…"} ' + + "(exp = unix วินาที · tid optional · ส่งตรง ๆ ไม่แก้ string — HMAC ผูกกับค่าดิบ)", + }, + HmacSha256: { + type: "string", + description: "hex 64 ตัว ของ HMAC-SHA256(secret, ticket_data ดิบ)", + }, + }, + }, + TokenResponse: { + type: "object", + description: "access_token ของกลุ่ม documents (JWT HS256 อายุสั้น)", + properties: { + access_token: { type: "string", description: "JWT พร้อมใช้แนบเป็น Bearer" }, + token_type: { type: "string", example: "Bearer" }, + expires_in: { + type: "integer", + description: "อายุวินาที (env DOCVER_TOKEN_TTL_SECONDS, default 3600)", + }, + }, + }, ExtractResponse: { type: "object", properties: { - success: { type: "boolean", example: true }, data: { type: "object", description: "ชื่อแท็ก Content Control → ข้อความในนั้น (หลายบรรทัดคั่นด้วย \\n)", additionalProperties: { type: "string" }, example: { - blackno: "คดีหมายเลขดำที่", - court: "ศาลปกครองสุพรรณบุรี", + "cc": { + "blackyear": "๙๐/๒๕๖๙", + "redyear": "xxx", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ", + "accuser": "นายธีรพล ร่มเริง", + "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง...", + }, + "bookmark": { + "signature": "" + }, + "properties": { + "standard": { + "creator": "mam", + "created": "2026-10-22T02:58:00.000Z", + "modified": "2026-10-22T07:08:00.000Z" + }, + "extended": { + "template": "TS_P2_IN.dotx", + "totalTime": 172, + "pages": 2, + "words": 124, + }, + "custom": { + "ticket_data": "{\"exp\":1793013726,\"fid\":\"T_no_warning\",\"tid\":\"T_X\",\"uid\":\"john\",\"uname\":\"John Doe\"}", + "HmacSha256": "1dc53fbd48410845c895ddb841a8fe4ad93da413126fae9c688202e57f2baaa9", + "Ed25519": "95ea0ca6d81df885c22a2334ed89b2fc3c75a1a309fb5843e0deb0a16c9d05a45b345fb28fd606f3b152285e70560ad43a6389534794aa0d6f06d13f1307b005" + } + }, + "verify": { + "exp": "26/10/2569 18:22:06", + "HmacSha256": true, + "Ed25519": true + } }, }, }, diff --git a/middleware.ts b/middleware.ts index f05c44b..712d46e 100644 --- a/middleware.ts +++ b/middleware.ts @@ -37,6 +37,6 @@ export function middleware(req: NextRequest) { // ยังถูกคุมอยู่ดีเพราะ root page ส่งต่อให้ /note ซึ่ง middleware จับตามปกติ export const config = { matcher: [ - "/((?!note/login|api/note|api/template|api/documents|api/swagger|wordaddin|note/uploads|note/samples|note/swagger-ui|note/pdf\\.worker\\.min\\.mjs|_next|fonts|favicon\\.ico).+)", + "/((?!note/login|api/note|api/template|tmpl/|api/documents|api/swagger|tmpl|wordaddin|note/uploads|note/samples|note/swagger-ui|note/pdf\\.worker\\.min\\.mjs|_next|fonts|favicon\\.ico).+)", ], }; diff --git a/package-lock.json b/package-lock.json index 748a8c7..466a9f7 100644 --- a/package-lock.json +++ b/package-lock.json @@ -11,8 +11,10 @@ "dependencies": { "@pdf-lib/fontkit": "^1.1.1", "@xmldom/xmldom": "^0.9.12", + "docx-templates": "^4.15.0", "drizzle-orm": "^0.45.2", "lucide-react": "^1.42.0", + "minio": "^8.0.7", "next": "^14.2.35", "pdf-lib": "^1.17.1", "pdfjs-dist": "^4.10.38", @@ -26,7 +28,7 @@ "xpath": "^0.0.34" }, "devDependencies": { - "@types/node": "^26.5.0", + "@types/node": "^26.6.5", "@types/office-js": "^1.0.612", "@types/pngjs": "^6.0.5", "@types/react": "^18.3.31", @@ -61,7 +63,6 @@ "integrity": "sha512-4gY54eEGEstClvEkGnwVkTkrx0sqwemEFG5OSRRn3tD91XH0+Q8XIkYIfo7IwEWPpJZwILb9GUXeShtplRc/eA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@jsdevtools/ono": "^7.1.3", "@types/json-schema": "^7.0.15", @@ -80,7 +81,6 @@ "integrity": "sha512-Zc1AlqrJlX3SlpupFGpiLi2EbteyP7fXmUOGup6/DnkRgjP9bgMM/ag+n91rsv0U1Gpz0H3VILA/o3bW7Ua6BQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=10" } @@ -90,8 +90,7 @@ "resolved": "https://registry.npmjs.org/@apidevtools/swagger-methods/-/swagger-methods-3.0.2.tgz", "integrity": "sha512-QAkD5kK2b1WfjDS/UQn/qQkbwF31uqRjPTrsCs5ZG9BQGAkjwvqGFjjPqAuzac/IYzpPtRzjCP1WrTuAIjMrXg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@apidevtools/swagger-parser": { "version": "10.1.1", @@ -99,7 +98,6 @@ "integrity": "sha512-u/kozRnsPO/x8QtKYJOqoGtC4kH6yg1lfYkB9Au0WhYB0FNLpyFusttQtvhlwjtG3rOwiRz4D8DnnXa8iEpIKA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@apidevtools/json-schema-ref-parser": "11.7.2", "@apidevtools/openapi-schemas": "^2.1.0", @@ -170,7 +168,6 @@ "integrity": "sha512-fNAjWnA/nZ2jz31kxR/AqRaUT8ewHBw/WuBIosK0moMy1C9e5ValbDfFdIxJzVOOYaYkV/b2F1S4H/aHiqfVQg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.6.2" }, @@ -184,7 +181,6 @@ "integrity": "sha512-Vu011o3/bikQNwtjouwmUJud+Z6Brcjij2D0omPWClRGg8i5gBfOYSpDkFGkHbhGlaky4fgvfkxD0uHGq34uYA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^1.0.0", "@azure/core-auth": "^1.3.0", @@ -204,7 +200,6 @@ "integrity": "sha512-TrRLIoSQVzfAJX9H1JeFjzAoDGcoK1IYX1UImfceTZpsyYfWr09Ss1aHW1y5TrrR3iq6RZLBwJ3E24uwPhwahw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.2.0" }, @@ -218,7 +213,6 @@ "integrity": "sha512-JbZtIqfEulsIA0rC3zM7jfF4KkOnye9aKcaO/jJqxJRm/gM6lAjEv7sL4njW8D+35l50P1f+UuH5OqN+UKJqNA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^1.0.0", "@azure/core-auth": "^1.3.0", @@ -238,7 +232,6 @@ "integrity": "sha512-TrRLIoSQVzfAJX9H1JeFjzAoDGcoK1IYX1UImfceTZpsyYfWr09Ss1aHW1y5TrrR3iq6RZLBwJ3E24uwPhwahw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.2.0" }, @@ -252,7 +245,6 @@ "integrity": "sha512-J2jmTPv8ZraSHDTz9l2Bx8gNL3ktfDDWo2mxWfzarn64O9Fjhb+l85YWyubGy2xUdeGuZPKzvQLltGv8bSu8eQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^1.0.0", "@azure/core-auth": "^1.3.0", @@ -272,7 +264,6 @@ "integrity": "sha512-TrRLIoSQVzfAJX9H1JeFjzAoDGcoK1IYX1UImfceTZpsyYfWr09Ss1aHW1y5TrrR3iq6RZLBwJ3E24uwPhwahw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.2.0" }, @@ -286,7 +277,6 @@ "integrity": "sha512-DR/H2nfKtHNqfpuJ4L/B4irX1nX77QizulmfrxcLNZmkfinm0SdZpypXSvzaI5rHZSXfhXNUfBvMfi+jMkjWtw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.1.2", "@azure/core-auth": "^1.9.0", @@ -306,7 +296,6 @@ "integrity": "sha512-IUZydyTUkDnYdstOW9pFOOUQlBjAepK5teihDE3x6yxsPJs/hsAaaYpeGxdxrgtOiJbBKSjKW7MDk7AEhb4LRg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.1.2", "@azure/core-util": "^1.13.0", @@ -342,7 +331,6 @@ "integrity": "sha512-BoSmXPx2er1Ai+wKlDvj29jIQespCNBwEmKyZVHO2kEFsWbGjAjwMCGzug3DJM5/QYIV3vej0S1zcU5bq9fa8w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.1.2" }, @@ -360,7 +348,6 @@ "integrity": "sha512-0YIpccoX8m/k00O7mDDMdJpbr6mf1yWo2dfmxt5A8XVZVVMz2SSKaEbMCeJRvgQ0IaSlqhjT47p4hVIRRy90xw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.0.0", "@azure/core-util": "^1.2.0", @@ -377,7 +364,6 @@ "integrity": "sha512-7GEAoIsaoBr6KELNRb8nypowCqvk8dnCHFCYg4XD4lOQGY2GqjQg5IhkRjyBFRO18CGSMq05PaNqSOE9GQro3g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.6.2" }, @@ -391,7 +377,6 @@ "integrity": "sha512-/shnJ+ooO8WPxDhPEeI/2oRQuubn16gZ6CvlbpWbEswZfzwI9tI/sMAHmF3x1LuQ9yZYXfLW3TjzGMLEC5blKg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=22.0.0" } @@ -422,7 +407,6 @@ "integrity": "sha512-eGwxD0AtncrxeBM4tG8R55Pc3rdX1hNW2WibJAgYpCVA6E93mvvVH+LcssoVjOBrSKWS55yEIHsk0X8ctHmfOQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.6.2" }, @@ -436,7 +420,6 @@ "integrity": "sha512-9n2pWK61veAuN0V20t9lOuoV4CFMdyAZ1ygZzvBGk/pBBJRib/PjL9PLXa/aI2CcPpyHfqVsxxqLCYl6uZlfDw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.1.2", "@typespec/ts-http-runtime": "^0.3.0", @@ -452,7 +435,6 @@ "integrity": "sha512-e7lX/dk//F6Qf7BB6PTY4+p2yuOQtyOeHGyapYHNwqSp2OnYpwQt49A/Nin2XmKBQ69pwagR4k/lQBq8lbHQkA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "fast-xml-parser": "^5.5.9", "tslib": "^2.8.1" @@ -467,7 +449,6 @@ "integrity": "sha512-8utCLdTZn14CiAe0HW4JbtzUMsc0mdDwnjUvStFMrR4IxQP8S2eL9zVAdplpfORVJGYmidZElpeXRYjJQ4UyUw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.0.0", "@azure/core-auth": "^1.9.0", @@ -492,7 +473,6 @@ "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=12" }, @@ -506,7 +486,6 @@ "integrity": "sha512-++Zlftm0kVLPmzC06t6epuWmcRMDbI4z5P3NNX979WA/k23+NtSOynEGzsVfZwguKw2mi5umVgnBlJQMwRz4Pg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "default-browser": "^5.5.1", "define-lazy-prop": "^3.0.0", @@ -528,7 +507,6 @@ "integrity": "sha512-rbAE25KUfjU/s3XHUdJgceoCP5dEOpMx85J04kF+QMdta73XkuG9JGHHinch+XIoKpBdqljin+KqURpJriSzLA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@typespec/ts-http-runtime": "^0.3.0", "tslib": "^2.6.2" @@ -543,7 +521,6 @@ "integrity": "sha512-NDW2/bz2Pz71EJAlhSw+jg1kpRIWtrzj0gCzcHuG1u7iLvSOHpUc5lICkDA9x0bbeityxTneiunSBluvS+/y4w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/msal-common": "16.14.2" }, @@ -557,7 +534,6 @@ "integrity": "sha512-HOBR0Gfo39TMrkxNG8k6cfjRkrRjXZc3JQs3ebMWQc9S4cihuknMYra3sgmzbZB752oQBqBN9+WF7c826p2vIQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.8.0" } @@ -568,7 +544,6 @@ "integrity": "sha512-ixSO1Y/kCVRthRs+hSx/5qkwaunX1/RAePhlMN0wIpIQ4WEZ6AREGGnGd1AP0qspHVsAwzWQKGubpjh50JyJIQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/msal-common": "16.14.1", "jsonwebtoken": "^9.0.0" @@ -584,7 +559,6 @@ "dev": true, "hasInstallScript": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/msal-common": "15.17.0", "@azure/msal-node-runtime": "^0.20.0", @@ -600,7 +574,6 @@ "integrity": "sha512-VQ5/gTLFADkwue+FohVuCqlzFPUq4xSrX8jeZe+iwZuY6moliNC8xt86qPVNYdtbQfELDf2Nu6LI+demFPHGgw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.8.0" } @@ -610,8 +583,7 @@ "resolved": "https://registry.npmjs.org/@azure/msal-node-runtime/-/msal-node-runtime-0.20.6.tgz", "integrity": "sha512-89Al7l5c8sOEA954d35WZOg1sCa2WKfgf7KyTbN9vIkKsoZrXdJ5+CPjy8+tQqWcsJTAMbQD4OWr7V09/xN8KA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@azure/msal-node/node_modules/@azure/msal-common": { "version": "16.14.1", @@ -619,7 +591,6 @@ "integrity": "sha512-Or6xhPNyi4zHW25158yxBoyxuCqNSPa5YBVqfF1J5Ks4MJWBo/USXdp05DQIPu1Zli00YZu6t0+h6KvHJealxQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.8.0" } @@ -630,7 +601,6 @@ "integrity": "sha512-cXDTCAMwDx8Ng9yUe82kOOd2kPnZ8AQqe4FkLMcpaQ3Mvr3/PXVdvRhyP0FtY5/U5Oh6JGk3EcEibaFOymRLFw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.1.2", "@azure/core-auth": "^1.9.0", @@ -658,7 +628,6 @@ "integrity": "sha512-bttzuhQiCIwrkzjPDA+AtAR7dg19L/CC6ztcqJ5LfvWpXuys9mHp0UQ0udYnoUvv9SCT9KTR5kqFvFr0e6k0lQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/abort-controller": "^2.1.2", "@azure/core-auth": "^1.9.0", @@ -680,7 +649,6 @@ "integrity": "sha512-NpugTzbKgGrNe45Ui32cN8vCFFMxVtP/9rtfwv0nP5FRDAjvYBxJcLVpYA9mr1jxP6cnIT7x9LUzuDTbWYYNRA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=6.9.0" } @@ -705,7 +673,6 @@ "dev": true, "license": "MIT", "optional": true, - "peer": true, "engines": { "node": ">=0.1.90" } @@ -798,6 +765,7 @@ } ], "license": "MIT", + "peer": true, "engines": { "node": ">=20.19.0" }, @@ -846,6 +814,7 @@ } ], "license": "MIT", + "peer": true, "engines": { "node": ">=20.19.0" } @@ -1758,8 +1727,7 @@ "resolved": "https://registry.npmjs.org/@exodus/schemasafe/-/schemasafe-1.3.0.tgz", "integrity": "sha512-5Aap/GaRupgNx/feGBwLLTVv8OQFfv3pq2lPRzPg9R+IOBnDgghTGW7l7EuVXOvg5cc/xSAlRW8rBrjIC3Nvqw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@feathersjs/hooks": { "version": "0.6.5", @@ -1767,7 +1735,6 @@ "integrity": "sha512-WtcEoG/imdHRvC3vofGi/OcgH+cjHHhO0AfEeTlsnrKLjVKKBXV6aoIrB2nHZPpE7iW5sA7AZMR6bPD8ytxN+w==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 10" } @@ -1778,7 +1745,6 @@ "integrity": "sha512-MgP/I06GdvsilDspMk/qmRzpk8LOUStP6jFAbSRi40W09DhoyUn+Mj7eyKICPqeYKybOjVFLVIAQzvu1bfIa7Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=20" }, @@ -1961,7 +1927,6 @@ "integrity": "sha512-w3PMZH5rahrukn8/I7P9Ihil+twgLTUHDZtJlJyBbUKyPaOSSQjLZkb0PpncVhin1gCaMgOFXy6iNPgcZUoo2w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@inquirer/type": "^1.1.6", "@types/mute-stream": "^0.0.4", @@ -1988,7 +1953,6 @@ "integrity": "sha512-6oYBAi5ikg4Pl+kGsoYtawUMBT2zZMCvPNF7pVLnHZfd1zf38DRiWn/gT01RYCdUqkv7Fhr+C9ot4/tb+2sVvA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "undici-types": "~6.21.0" } @@ -1998,8 +1962,7 @@ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@inquirer/editor": { "version": "4.2.23", @@ -2702,7 +2665,6 @@ "integrity": "sha512-MzICLu4yS7V8AA61sANROZ9vT1H3ooca5dSmI1FjZkzq7o/koMsRfQSzRtFo+F3Ao4Sf1C0bpLKejpKB/+j6MA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "mute-stream": "^1.0.0" }, @@ -2716,7 +2678,6 @@ "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==", "dev": true, "license": "ISC", - "peer": true, "dependencies": { "minipass": "^7.0.4" }, @@ -2751,7 +2712,6 @@ "integrity": "sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.25" @@ -2780,8 +2740,7 @@ "resolved": "https://registry.npmjs.org/@jsdevtools/ono/-/ono-7.1.3.tgz", "integrity": "sha512-4JQNk+3mVzK3xh2rqd6RB4J46qUR19azEHBneZyTZM+c456qOrbbM/5xcR8huNCCcbVt7+UmizG6GuUvPvKUYg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@microsoft/app-manifest": { "version": "1.1.3", @@ -2805,7 +2764,6 @@ "integrity": "sha512-OayhehwI+CnO0Wr53e29ZJZWGsNA5yVG7r54qmZSLc5HxA5Cozk4hP7EbYDCXkxh4NbQoT1dhTzC8bkRo+wWXw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "buffer": "^5.2.1", "debug": "^4.1.1", @@ -2818,7 +2776,6 @@ "integrity": "sha512-wGuFEzvRiWZmDxQMGKEjOKhEIVnLiG6vRUuM9Hwqxpe/kbiyA2WiUyEVpniNPaaw8gDHTf9zJHnPNNj0JiL5mA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@microsoft/dev-tunnels-contracts": ">1.1.8", "axios": "^1.6.2", @@ -2833,7 +2790,6 @@ "integrity": "sha512-YlAI2jC0grK2p2fvxDV9Hin5EtRXL6yOMhLKqtjRVlH8Q0+hI9UWFl7RhLWSZjsbDyl+0LIlI2HjlcbsUhXGsQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "adm-zip": "^0.5.17", "original-fs": "^1.2.0", @@ -2847,7 +2803,6 @@ "integrity": "sha512-ufJnssQGbxzLNS1Ho9bCtX4rQKCCvoVuDLHoJyc3F9dOGDB4BkWs2Ci0kv53lqocAEQ/Cbi+I2XCsNYGqVYqng==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=12.0" } @@ -2862,7 +2817,6 @@ "https://github.com/sponsors/ctavan" ], "license": "MIT", - "peer": true, "bin": { "uuid": "dist-node/bin/uuid" } @@ -2873,7 +2827,6 @@ "integrity": "sha512-kdjOSJ2lLIn7r1rtrMbbNCHjyMPfRnowdKjBQ+mGq6NAW5QY2bEZC/khaC5OR8svbbjvLEaIXkOq45e2X9BIbQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=14.0.0" } @@ -2884,7 +2837,6 @@ "integrity": "sha512-mih5trnmvIKpjLgqzsoxqiWFvG5eMeETPCAdtFvDaXyferWzFt9UrdARfRoYboPhfFjYRYw8EoF3EA4yFVWCsQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@apidevtools/swagger-parser": "^10.1.1", "@microsoft/app-manifest": "1.1.3", @@ -2903,7 +2855,6 @@ "integrity": "sha512-KYAb4c9BJQI6QqGKthV68OHe0badztdXJWKo0WtBA9IuCFPTKvE5ZdUBglP833aMjhaSPNO4A5j/EkzZtGlKjA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", @@ -2968,7 +2919,6 @@ "integrity": "sha512-cSVQHqK7oYG+KvSR8y+nvOiXcLNU/t/8ihDyXbdJtZCnRft7ZtHpnt8yxL96xdFe2UUHLSipHbZSJBotQrIB+g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@azure/core-auth": "^1.4.0", "@microsoft/app-manifest": "1.1.3", @@ -2984,7 +2934,6 @@ "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": "*" } @@ -2995,7 +2944,6 @@ "integrity": "sha512-RITGBfijLkBddZvnn8jdqoTypxvqbOLYQkGGxXzeFjVHvudaPw0HNFD9x928/eUwYWd2dPCugVqspGALTZZQKw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "assertion-error": "^1.1.0", "check-error": "^1.0.3", @@ -3015,7 +2963,6 @@ "integrity": "sha512-156FXuXXl8DZ6aPU/GR0qFpo7JIHK9sBTqhUBOiO0ljRl+asP/S9nREQG4Vg4lPWL1UCCd6WeTpTcOPyyYQdJQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@apidevtools/swagger-parser": "^10.1.0", "@azure/arm-appservice": "^13.0.0", @@ -3086,7 +3033,6 @@ "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" }, @@ -3100,7 +3046,6 @@ "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=8" } @@ -3111,7 +3056,6 @@ "integrity": "sha512-2DdE+SJDtzLEEWzY1ZjY7Q+VcPhcV1KisD3zI4u0XZyktsjHum1mwbMI+JaulUBi2OZk+KJAi2uPXzxichPkdw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@hono/node-server": "^1.19.9 || ^2.0.5", "ajv": "^8.17.1", @@ -3153,7 +3097,6 @@ "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "mime-types": "^3.0.0", "negotiator": "^1.0.0" @@ -3168,7 +3111,6 @@ "integrity": "sha512-2cGmJupaNgg+QUwVLAucDuWuoMZ6EX9iHDRswZ5lsNYEmwPaRknMPCLZz07yTzVq/83p4o/wzbDZbBrTvGGTIw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "bytes": "^3.1.2", "content-type": "^2.0.0", @@ -3194,7 +3136,6 @@ "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -3209,7 +3150,6 @@ "integrity": "sha512-e+H0ZXHSWYrENhQzw1LPuP4oF5MzVKmDU6d3hxlvaPEYLLg62MxtQNPRx4SYSuYJSBUgnQIG4HIN2tEtNv7Dog==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -3224,7 +3164,6 @@ "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=6.6.0" } @@ -3235,7 +3174,6 @@ "integrity": "sha512-qCqy1xSoaugxOD4IVHb1ZWdkvCF2W3aE2okKouWj8VwJ+ztskSiXoBnCSJqfKT+cVPJhuJqe9YLbY425+Zh00g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "accepts": "^2.0.0", "body-parser": "^2.3.0", @@ -3280,7 +3218,6 @@ "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -3295,7 +3232,6 @@ "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "^4.4.0", "encodeurl": "^2.0.0", @@ -3318,7 +3254,6 @@ "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -3329,7 +3264,6 @@ "integrity": "sha512-yz3xRaG20c6/BOzvYoDaGtPmGscs7YivItZEEqe6GbwNfHuxu9YNmvnEkMzKldAGY4/80pRcQRZSEnhquk9XuQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" }, @@ -3344,7 +3278,6 @@ "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -3358,7 +3291,6 @@ "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -3369,7 +3301,6 @@ "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "mime-db": "^1.54.0" }, @@ -3387,7 +3318,6 @@ "integrity": "sha512-NMPBRMJgiQHjbd8phG3Vebdx4kZ1H121rbl5IkMqeOsahptB9BKo/d7oJ3zTXqTgagn2bWlNSXkh0QUGM31RYg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "content-type": "^2.1.0" }, @@ -3405,7 +3335,6 @@ "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -3420,7 +3349,6 @@ "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "^4.4.3", "encodeurl": "^2.0.0", @@ -3448,7 +3376,6 @@ "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "encodeurl": "^2.0.0", "escape-html": "^1.0.3", @@ -3469,7 +3396,6 @@ "integrity": "sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "content-type": "^2.0.0", "media-typer": "^1.1.0", @@ -3489,7 +3415,6 @@ "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -3902,15 +3827,13 @@ "version": "3.1.0", "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-3.1.0.tgz", "integrity": "sha512-LsS/DjHr+uDM647Gru/cA8+J3a3HfhttwCKLyuoyN7yXTFCxKBtSgMQBvrW9yNPa2/zDRUNuGPaH5QUFoa4arQ==", - "dev": true, "funding": [ { "type": "github", "url": "https://github.com/sponsors/nodable" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@nodelib/fs.scandir": { "version": "2.1.5", @@ -3956,7 +3879,6 @@ "integrity": "sha512-Efcc+iF0j3Bf67YjEqIqWXbX5XddXoK/Mw4K1/JuXwRCZ8N16VR7iT23nlCc9XrveFVh/E5Rqs2StT0V8v9LdA==", "dev": true, "license": "MIT", - "peer": true, "funding": { "url": "https://github.com/sponsors/oxc-project" } @@ -4001,7 +3923,6 @@ "os": [ "android" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4019,7 +3940,6 @@ "os": [ "android" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4037,7 +3957,6 @@ "os": [ "darwin" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4055,7 +3974,6 @@ "os": [ "darwin" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4073,7 +3991,6 @@ "os": [ "freebsd" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4091,7 +4008,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4109,7 +4025,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4127,7 +4042,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4145,7 +4059,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4163,7 +4076,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4181,7 +4093,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4199,7 +4110,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4217,7 +4127,6 @@ "os": [ "openharmony" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4235,7 +4144,6 @@ "os": [ "win32" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4253,7 +4161,6 @@ "os": [ "win32" ], - "peer": true, "engines": { "node": "^20.19.0 || >=22.12.0" } @@ -4263,8 +4170,7 @@ "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz", "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@scarf/scarf": { "version": "1.4.0", @@ -4330,8 +4236,7 @@ "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@types/jsonfile": { "version": "6.1.4", @@ -4349,15 +4254,14 @@ "integrity": "sha512-CPM9nzrCPPJHQNA9keH9CVkVI+WR5kMa+7XEs5jcGQ0VoAGnLv242w8lIVgwAEfmE4oufJRaTc9PNLQl0ioAow==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@types/node": "*" } }, "node_modules/@types/node": { - "version": "26.5.0", - "resolved": "https://registry.npmjs.org/@types/node/-/node-26.5.0.tgz", - "integrity": "sha512-dVSGpriSoCgz8WnDNTuSSuSv1PC/ALXihO4ulRZt7Md8k9mlbdin3lGOcDE8SnWOgf513ByWlXd7BK4azmyg/A==", + "version": "26.6.5", + "resolved": "https://registry.npmjs.org/@types/node/-/node-26.6.5.tgz", + "integrity": "sha512-uMzsv9stDdofIZBx4UGh4Z9ZgXnGC9seRDscilBcTHAeOFk67MZg/k9bWVfO+bk4qZmG+l52hRnLwUiH2LnJTg==", "dev": true, "license": "MIT", "dependencies": { @@ -4394,6 +4298,7 @@ "integrity": "sha512-vfEqpXTvwT91yhmwdfouStN2hSKwTvyRs8qpLfADyrq/kxDw0hZM7Wk9Ug1FELj8hIby+S/+kQCSRFF32nv2Qw==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "@types/prop-types": "*", "csstype": "^3.2.2" @@ -4425,8 +4330,7 @@ "resolved": "https://registry.npmjs.org/@types/wrap-ansi/-/wrap-ansi-3.0.0.tgz", "integrity": "sha512-ltIpx+kM7g/MLRZfkbL7EsCEjfzCcScLpkg37eXEtx5kmrAKBkTJwd1GIAjDSL8wTpM6Hzn5YO4pSb91BEwu1g==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/@typespec/ts-http-runtime": { "version": "0.3.9", @@ -4434,7 +4338,6 @@ "integrity": "sha512-edSdeAqkdxBVzA1yL1LrLCml1YjyCVvPMtMqJpbF+6K609tHe8V6sQUzFQSGcYNhcuhOceZtjvN32+mpIth30A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "http-proxy-agent": "^7.0.0", "https-proxy-agent": "^7.0.0", @@ -4497,7 +4400,6 @@ "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "mime-types": "~2.1.34", "negotiator": "0.6.3" @@ -4512,7 +4414,6 @@ "integrity": "sha512-oJlA3XiRm7Cyk6qFD2Jn8ak9B7jSy0qy00ADO3+8dpT0LSjFihQYv4C02LFCSYJV3Q37xYwwRy5m+IpIiUzqWw==", "dev": true, "license": "MIT", - "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -4526,7 +4427,6 @@ "integrity": "sha512-4B/qKCfeE/ODUaAUpSwfzazo5x29WD4r3vXiWsB7I2mSDAihwEqKO+g8GELZUQSSAo5e1XTYh3ZVfLyxBc12nA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 10.0.0" } @@ -4547,7 +4447,6 @@ "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 14" } @@ -4608,7 +4507,6 @@ "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "type-fest": "^0.21.3" }, @@ -4670,15 +4568,13 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/anynum/-/anynum-1.0.1.tgz", "integrity": "sha512-N6//FLET/tXYNM/F6ABca1oH6fWB+KlTt909Le28WMDBk8oaT4vY17DCrwg2MvmuqUKt3Ni4N5dGJ/EoBgcO6A==", - "dev": true, "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/apache-arrow": { "version": "21.2.0", @@ -4686,7 +4582,6 @@ "integrity": "sha512-Hxe6Agq26gQOM954qpzYSllJBPJl+e16U5CkfuMUhLrNba+5nKkttIVlflaovN6oaTratqMGAO8H5u/aNhmHWQ==", "dev": true, "license": "Apache-2.0", - "peer": true, "dependencies": { "@types/node": "^25.2.0", "flatbuffers": "^25.1.24", @@ -4703,7 +4598,6 @@ "integrity": "sha512-b4e2xxj/yMeT2hNlD6x7zNFiQK2Dlmkb9CQ6v3/1G2RezKN4YS2lcEv8lzGm1mhs4f2lM4yNAMI/zUDBZBBt7w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "undici-types": ">=7.24.0 <7.24.7" } @@ -4713,8 +4607,7 @@ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz", "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/applicationinsights": { "version": "1.8.10", @@ -4722,7 +4615,6 @@ "integrity": "sha512-ZLDA7mShh4mP2Z/HlFolmvhBPX1LfnbIWXrselyYVA7EKjHhri1fZzpu2EiWAmfbRxNBY6fRjoPJWbx5giKy4A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "cls-hooked": "^4.2.2", "continuation-local-storage": "^3.2.1", @@ -4742,24 +4634,21 @@ "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", "dev": true, - "license": "Python-2.0", - "peer": true + "license": "Python-2.0" }, "node_modules/array-flatten": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/array-timsort": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/array-timsort/-/array-timsort-1.0.3.tgz", "integrity": "sha512-/+3GRL7dDAGEfM6TseQk/U+mi18TU2Ms9I3UlLdUMhz2hbvGNTKdj9xniwXfUqgYhHxRx0+8UnKkvlNwVU+cWQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/assertion-error": { "version": "2.0.1", @@ -4771,13 +4660,18 @@ "node": ">=12" } }, + "node_modules/async": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "license": "MIT" + }, "node_modules/async-hook-jl": { "version": "1.7.6", "resolved": "https://registry.npmjs.org/async-hook-jl/-/async-hook-jl-1.7.6.tgz", "integrity": "sha512-gFaHkFfSxTjvoxDMYqDuGHlcRyUuamF8s+ZTtJdDzqjws4mCt7v0vuV79/E2Wr2/riMQgtG4/yUtXWs1gZ7JMg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "stack-chain": "^1.3.7" }, @@ -4791,7 +4685,6 @@ "integrity": "sha512-gpuo6xOyF4D5DE5WvyqZdPA3NGhiT6Qf07l7DCB0wwDEsLvDIbCr6j9S5aj5Ch96dLace5tXVzWBZkxU/c5ohw==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "semver": "^5.3.0", "shimmer": "^1.1.0" @@ -4806,7 +4699,6 @@ "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, "license": "ISC", - "peer": true, "bin": { "semver": "bin/semver" } @@ -4817,7 +4709,6 @@ "integrity": "sha512-HuTK7E7MT7jZEh1P9GtRW9+aTWiDWWi9InbZ5hjxrnRa39KS4BW04+xLBhYNS2aXhHUIKZSw3gj4Pn1pj+qGAA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tslib": "^2.3.1" } @@ -4827,8 +4718,7 @@ "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/at-least-node": { "version": "1.0.0", @@ -4836,7 +4726,6 @@ "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">= 4.0.0" } @@ -4884,7 +4773,6 @@ "integrity": "sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "follow-redirects": "^1.16.0", "form-data": "^4.0.6", @@ -4898,7 +4786,6 @@ "integrity": "sha512-8PJDLJv7qTTMMwdnbMvrLYuvB47M81wRtxQmEdV5w4rgbTXTt+vtPkXwajOfOdSyv/wZICJOC+/UhXH4aQ/R+w==", "dev": true, "license": "Apache-2.0", - "peer": true, "dependencies": { "@babel/runtime": "^7.15.4", "is-retry-allowed": "^2.2.0" @@ -4910,7 +4797,6 @@ "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "4" }, @@ -4924,7 +4810,6 @@ "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "agent-base": "6", "debug": "4" @@ -4939,7 +4824,6 @@ "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": "18 || 20 || >=22" } @@ -4963,8 +4847,7 @@ "url": "https://feross.org/support" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/baseline-browser-mapping": { "version": "2.11.21", @@ -5008,20 +4891,27 @@ "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "buffer": "^5.5.0", "inherits": "^2.0.4", "readable-stream": "^3.4.0" } }, + "node_modules/block-stream2": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/block-stream2/-/block-stream2-2.1.0.tgz", + "integrity": "sha512-suhjmLI57Ewpmq00qaygS8UgEq2ly2PCItenIyhMqVjo4t4pGzqMvfgJuX8iWTeSDdfSSqS6j38fL4ToNL7Pfg==", + "license": "MIT", + "dependencies": { + "readable-stream": "^3.4.0" + } + }, "node_modules/body-parser": { "version": "1.20.8", "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.8.tgz", "integrity": "sha512-JNcyFQ64OiijEkPzUBTCe+hyPXUD/3LEldGQ6iF5LR1w00mx9o7xtDWHXBY2iItjdCFGoilOLNQbH943ut7pHA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "bytes": "~3.1.2", "content-type": "~1.0.5", @@ -5047,7 +4937,6 @@ "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ms": "2.0.0" } @@ -5058,7 +4947,6 @@ "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "safer-buffer": ">= 2.1.2 < 3" }, @@ -5071,8 +4959,7 @@ "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/body-parser/node_modules/raw-body": { "version": "2.5.3", @@ -5080,7 +4967,6 @@ "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", @@ -5097,7 +4983,6 @@ "integrity": "sha512-DkVaaQHymRhpYEYo9x1oo7Q7B0Y6KJUsjm3c9eTyFDby4MHLBTwZ6ZDWBel5zrYxj1WsZgC5oLpiz+93MluXeA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">=20.19.0" }, @@ -5112,7 +4997,6 @@ "integrity": "sha512-YovQ3rzhaLMIrDjNDMkNS01tea93qhEhG5xy8f6+R0l+dw3Ki+5sCoIoI942iuLZTHWogWktgwVDhU09iNEimQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "balanced-match": "^4.0.2" }, @@ -5133,6 +5017,12 @@ "node": ">=8" } }, + "node_modules/browser-or-node": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/browser-or-node/-/browser-or-node-2.1.1.tgz", + "integrity": "sha512-8CVjaLJGuSKMVTxJ2DpBl5XnlNDiT4cQFeuCJJrvJmts9YrTZDizTX7PjC2s6W4x+MBGZeEY6dGMrF04/6Hgqg==", + "license": "MIT" + }, "node_modules/browserslist": { "version": "4.28.9", "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.9.tgz", @@ -5153,6 +5043,7 @@ } ], "license": "MIT", + "peer": true, "dependencies": { "baseline-browser-mapping": "^2.11.20", "caniuse-lite": "^1.0.30001810", @@ -5187,19 +5078,26 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.1.13" } }, + "node_modules/buffer-crc32": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-1.0.0.tgz", + "integrity": "sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w==", + "license": "MIT", + "engines": { + "node": ">=8.0.0" + } + }, "node_modules/buffer-equal-constant-time": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", "dev": true, - "license": "BSD-3-Clause", - "peer": true + "license": "BSD-3-Clause" }, "node_modules/buffer-from": { "version": "1.1.2", @@ -5214,7 +5112,6 @@ "integrity": "sha512-DdH81/zPLVS11EUgWq3tEu/xn+EzljlMYooDNdzWEnFha3R3NBMpMV1UqYIpjYHV/SgpFKMIX1Oh7o06SjM/oA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "run-applescript": "^7.0.0" }, @@ -5242,7 +5139,6 @@ "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -5253,7 +5149,6 @@ "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" @@ -5268,7 +5163,6 @@ "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "call-bind-apply-helpers": "^1.0.2", "get-intrinsic": "^1.3.0" @@ -5285,8 +5179,7 @@ "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/camelcase-css": { "version": "2.0.1", @@ -5334,7 +5227,6 @@ "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -5359,7 +5251,6 @@ "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "engines": { "node": "*" } @@ -5370,7 +5261,6 @@ "integrity": "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "get-func-name": "^2.0.2" }, @@ -5422,7 +5312,6 @@ "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "engines": { "node": ">=18" } @@ -5433,7 +5322,6 @@ "integrity": "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=6" }, @@ -5447,7 +5335,6 @@ "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "string-width": "^4.2.0" }, @@ -5480,7 +5367,6 @@ "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", "dev": true, "license": "ISC", - "peer": true, "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", @@ -5496,7 +5382,6 @@ "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", @@ -5515,7 +5400,6 @@ "integrity": "sha512-J4Xj5f5wq/4jAvcdgoGsL3G103BtWpZrMo8NEinRltN+xpTZdI+M38pyQqhuFU/P792xkMFvnKSf+Lm81U1bxw==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "async-hook-jl": "^1.7.6", "emitter-listener": "^1.0.1", @@ -5531,7 +5415,6 @@ "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, "license": "ISC", - "peer": true, "bin": { "semver": "bin/semver" } @@ -5562,7 +5445,6 @@ "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "delayed-stream": "~1.0.0" }, @@ -5586,7 +5468,6 @@ "integrity": "sha512-R2rze/hDX30uul4NZoIZ76ImSJLFxn/1/ZxtKC1L77y2X1k+yYu1joKbAtMA2Fg3hZrTOiw0I5mwVMo0cf250w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "array-timsort": "^1.0.3", "esprima": "^4.0.1" @@ -5601,7 +5482,6 @@ "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "safe-buffer": "5.2.1" }, @@ -5615,7 +5495,6 @@ "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -5626,7 +5505,6 @@ "integrity": "sha512-jx44cconVqkCEEyLSKWwkvUXwO561jXMa3LPjTPsm5QR22PA0/mhe33FT4Xb5y74JDvt/Cq+5lm8S8rskLv9ZA==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "async-listener": "^0.6.0", "emitter-listener": "^1.1.1" @@ -5638,7 +5516,6 @@ "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -5648,8 +5525,13 @@ "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz", "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" + }, + "node_modules/core-util-is": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", + "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", + "license": "MIT" }, "node_modules/cors": { "version": "2.8.6", @@ -5657,7 +5539,6 @@ "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "object-assign": "^4", "vary": "^1" @@ -5676,7 +5557,6 @@ "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", @@ -5692,7 +5572,6 @@ "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "engines": { "node": "*" } @@ -5702,8 +5581,7 @@ "resolved": "https://registry.npmjs.org/cryptr/-/cryptr-6.4.0.tgz", "integrity": "sha512-9jpMU9HMt1vhMUqNO+MPuGEpbh/f7HHZdxrd6L2DMwTuYGyt9pgUJfQyTS1Ei4/sn7qPM4FkjxUoiW79k0x8sA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/css-select": { "version": "7.0.0", @@ -5711,7 +5589,6 @@ "integrity": "sha512-snmjEVXy+1LnwXdxhYvTMj1d9tOh4HxkA1YmoayVBeeyR2C14Pum7fcxJIm4SswYspVy866eYNwlH6xC3/VH5g==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "boolbase": "^2.0.0", "css-what": "^8.0.0", @@ -5747,7 +5624,6 @@ "integrity": "sha512-DH0Bqq3DNp5tdOReuNyAA+Ev4Y2GS5FMbZpeTLP6C4CDi0h5nL0BmUPChXw3o/qbHLDWHl49sbNqQVY7bMSDdw==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "engines": { "node": ">=20.19.0" }, @@ -5774,8 +5650,7 @@ "resolved": "https://registry.npmjs.org/cssom/-/cssom-0.5.0.tgz", "integrity": "sha512-iKuQcq+NdHqlAcwUY0o/HL69XQrUaQdMjmStJ8JFmUaiiQErlhrmuigkg/CU4E2J0IyUKUrMAgl36TvN67MqTw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/csstype": { "version": "3.2.3", @@ -5814,7 +5689,6 @@ "integrity": "sha512-39BOQLs9ZjKh0/patS9nrT8wc3ioX3/eA/zgbKNopnF2wCqJEoxywwwElATYvRsXdnOxA/OQeQoFZ3rFjVajhg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=4.0" } @@ -5825,7 +5699,6 @@ "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ms": "^2.1.3" }, @@ -5845,13 +5718,21 @@ "dev": true, "license": "MIT" }, + "node_modules/decode-uri-component": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.2.tgz", + "integrity": "sha512-FqUYQ+8o158GyGTrMFJms9qh3CqTKvAqgqsTnkLI8sKu0028orqBhxNMFkFen0zGyg6epACD32pjVk58ngIErQ==", + "license": "MIT", + "engines": { + "node": ">=0.10" + } + }, "node_modules/decompress-response": { "version": "6.0.0", "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "mimic-response": "^3.1.0" }, @@ -5868,8 +5749,7 @@ "integrity": "sha512-aWS3UIVH+NPGCD1kki+DCU9Dua032iSsO43LqQpcs4R3+dVv7tX0qBGjiVHJHjplsoUM2XRO/KB92glqc68awg==", "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/deep-eql": { "version": "4.1.4", @@ -5877,7 +5757,6 @@ "integrity": "sha512-SUwdGfqdKOwxCPeVYjwSyRpJ7Z+fhpwIAtmCUdZIWZ/YP5R9WAsyuSgpLVDi9bjWoN2LXHNss/dk3urXtdQxGg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "type-detect": "^4.0.0" }, @@ -5891,7 +5770,6 @@ "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=4.0.0" } @@ -5902,7 +5780,6 @@ "integrity": "sha512-m1pAzaJgZ/gssEqlOhJkPJp8Xly7QyW6xcrkUa2KKcDeDSEMP7X8xipU3snUcfisTQx0w1AGae+9UtJSfVnXGw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "bundle-name": "^4.1.0", "default-browser-id": "^5.0.0" @@ -5920,7 +5797,6 @@ "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -5934,7 +5810,6 @@ "integrity": "sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=8" } @@ -5945,7 +5820,6 @@ "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.4.0" } @@ -5956,7 +5830,6 @@ "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -5967,7 +5840,6 @@ "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8", "npm": "1.2.8000 || >= 1.4.16" @@ -5979,7 +5851,6 @@ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", "dev": true, "license": "Apache-2.0", - "peer": true, "engines": { "node": ">=8" } @@ -5990,7 +5861,6 @@ "integrity": "sha512-CmnVc+Hek2egPx1PeTFVta2W78xy2K/9Rkf6cC4T59S50tVnzKj+tnx5mmx5lwvCkujZ4uRrpRSuV+IVs3f90Q==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "address": "^1.0.1", "debug": "4" @@ -6009,7 +5879,6 @@ "integrity": "sha512-6eb9YRrimz8oTr5+JDzGmSYnXy5V7YnK5y/hd8AUDK1MssHjQKm9LlD6NSrHx4vMDF3+e/spI2hmWTviElgWZA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "semver": "^5.3.0" } @@ -6020,7 +5889,6 @@ "integrity": "sha512-l126t01d2ZS9EreskvEtZPrcgstuvH3rbKy82oUhUrVmBaGx4hO9wECdl3cvZbKDYjMF3QJDB5z5dL9yWAjvZQ==", "dev": true, "license": "MIT", - "peer": true, "peerDependencies": { "diagnostic-channel": "*" } @@ -6031,7 +5899,6 @@ "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, "license": "ISC", - "peer": true, "bin": { "semver": "bin/semver" } @@ -6050,13 +5917,31 @@ "dev": true, "license": "MIT" }, + "node_modules/docx-templates": { + "version": "4.15.0", + "resolved": "https://registry.npmjs.org/docx-templates/-/docx-templates-4.15.0.tgz", + "integrity": "sha512-H0JEDFVCF5j64Do9fqHVWwF86MOWUnHhQ2dfGWy7C2o9yPwtbCT1pXpotE6165Px07fia1Ted1Xh1fj1UZ9u1g==", + "license": "MIT", + "dependencies": { + "jszip": "^3.10.1", + "sax": "1.3.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/docx-templates/node_modules/sax": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/sax/-/sax-1.3.0.tgz", + "integrity": "sha512-0s+oAmw9zLl1V1cS9BtZN7JAd0cW5e0QH4W3LWEK6a4LaLEA2OTpGYWDY+6XasBLtz6wkm3u1xRw95mRuJ59WA==", + "license": "ISC" + }, "node_modules/dom-serializer": { "version": "3.1.1", "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-3.1.1.tgz", "integrity": "sha512-4MEa38/QexBob6gFNwu+EGdWvhJ1OKuNwdYY3Y3NyeWDQfnGeDYQUDfIRzWu5B5gsv03so2Uxd28YC6zrsx3Lw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "domelementtype": "^3.0.0", "domhandler": "^6.0.0", @@ -6082,7 +5967,6 @@ } ], "license": "BSD-2-Clause", - "peer": true, "engines": { "node": ">=20.19.0" } @@ -6093,7 +5977,6 @@ "integrity": "sha512-gYzvtM72ZtxQO0T048kd6HWSbbGCNOUwcnfQ01cqIJ4X2IYKFFHZ5mKvrQETcFXxsRObZulDaKmy//R7TPtsBg==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "domelementtype": "^3.0.0" }, @@ -6111,7 +5994,6 @@ "integrity": "sha512-qI4JLRKnSzqFqr7hAlS5xQDusBCjKSEG4t4+7aNrIQMHBcsC2TGEhuyABJdYkgSewL57PNLYEiibY2iPKhKpaA==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "dom-serializer": "^3.0.0", "domelementtype": "^3.0.0", @@ -6131,7 +6013,6 @@ "integrity": "sha512-IrPdXQsk2BbzvCBGBOTmmSH5SodmqZNt4ERAZDmW4CT+tL8VtvinqywuANaFu4bOMWki16nqf0e4oC0QIaDr/g==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "engines": { "node": ">=10" } @@ -6767,7 +6648,6 @@ "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", @@ -6783,7 +6663,6 @@ "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==", "dev": true, "license": "Apache-2.0", - "peer": true, "dependencies": { "safe-buffer": "^5.0.1" } @@ -6793,8 +6672,7 @@ "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/electron-to-chromium": { "version": "1.5.423", @@ -6809,7 +6687,6 @@ "integrity": "sha512-Bt1sBAGFHY9DKY+4/2cV6izcKJUf5T7/gkdmkxzX/qv9CcGH8xSwVRW5mtX03SWJtRTWSOpzCuWN9rBFYZepZQ==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "shimmer": "^1.2.0" } @@ -6827,7 +6704,6 @@ "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -6838,7 +6714,6 @@ "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "once": "^1.4.0" } @@ -6862,7 +6737,6 @@ "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4" } @@ -6890,7 +6764,6 @@ "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "es-errors": "^1.3.0" }, @@ -6904,7 +6777,6 @@ "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "es-errors": "^1.3.0", "get-intrinsic": "^1.2.6", @@ -6920,8 +6792,7 @@ "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.3.1.tgz", "integrity": "sha512-SOp9Phqvqn7jtEUxPWdWfWoLmyt2VaJ6MpvP9Comy1MceMXqE6bxvaTu4iaxpYYPzhny28Lc+M87/c2cPK6lDg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/esbuild": { "version": "0.28.2", @@ -6980,8 +6851,7 @@ "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/escape-string-regexp": { "version": "1.0.5", @@ -6999,7 +6869,6 @@ "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "bin": { "esparse": "bin/esparse.js", "esvalidate": "bin/esvalidate.js" @@ -7024,18 +6893,22 @@ "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } }, + "node_modules/eventemitter3": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==", + "license": "MIT" + }, "node_modules/events": { "version": "3.3.0", "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz", "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.8.x" } @@ -7046,7 +6919,6 @@ "integrity": "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "eventsource-parser": "^3.0.1" }, @@ -7060,7 +6932,6 @@ "integrity": "sha512-EKN1vKAMcZ8MlYMpaNuxN6R9yakzH6uajHcHVTqWJzvu5pWw9DyhbP35HH8MVBQ+dZjAfDxk+A8NiR9KWaXiyQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18.0.0" } @@ -7071,7 +6942,6 @@ "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", "dev": true, "license": "(MIT OR WTFPL)", - "peer": true, "engines": { "node": ">=6" } @@ -7140,7 +7010,6 @@ "integrity": "sha512-2FXbqkygil3mZiXzEtM0IjE/UBmBNot0J1GEVrJT4JbrvwOSoEtqtO+wHbiMQELWe1eNvHoYRg2dkjOid+6JkA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "^4.4.3", "ip-address": "^10.2.0" @@ -7161,7 +7030,6 @@ "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ms": "2.0.0" } @@ -7171,8 +7039,7 @@ "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/fast-deep-equal": { "version": "3.1.3", @@ -7216,8 +7083,7 @@ "resolved": "https://registry.npmjs.org/fast-safe-stringify/-/fast-safe-stringify-2.1.1.tgz", "integrity": "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/fast-uri": { "version": "3.1.8", @@ -7240,7 +7106,6 @@ "version": "1.3.1", "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.3.1.tgz", "integrity": "sha512-pIM/1n3ntFXKYrUZwW7QCK0gAW7XY+wzj1YMIV3tLDvPj/V+zTGJK5e3/4WJfwj0qWw2ElNXiTixda/R+3YSug==", - "dev": true, "funding": [ { "type": "github", @@ -7248,7 +7113,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "path-expression-matcher": "^1.6.2", "xml-naming": "^0.3.0" @@ -7258,7 +7122,6 @@ "version": "5.11.2", "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.11.2.tgz", "integrity": "sha512-R9iDuNrQYeQut46cn2r2wHKn4HYzVDvDm5J1wW+koZewykv0yuO2HChTYeZtrULyHIDM9cj9TUXloCsueCQUog==", - "dev": true, "funding": [ { "type": "github", @@ -7266,7 +7129,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "@nodable/entities": "^3.0.1", "fast-xml-builder": "^1.2.0", @@ -7319,7 +7181,6 @@ "integrity": "sha512-yaduQFRKLXYOGgEn6AZau90j3ggSOyiqXU0F9JZfeXYhNa+Jk4X+s45A2zg5jns87GAFa34BBm2kXw4XpNcbdg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "escape-string-regexp": "^1.0.5" }, @@ -7343,13 +7204,21 @@ "node": ">=8" } }, + "node_modules/filter-obj": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/filter-obj/-/filter-obj-1.1.0.tgz", + "integrity": "sha512-8rXg1ZnX7xzy2NGDVkBVaAy+lSlPNwad13BtgSlLuxfIslyt5Vg64U7tFcCt4WS1R0hvtnQybT/IyCkGZ3DpXQ==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/finalhandler": { "version": "1.3.2", "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz", "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "2.6.9", "encodeurl": "~2.0.0", @@ -7369,7 +7238,6 @@ "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ms": "2.0.0" } @@ -7379,24 +7247,21 @@ "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/flatbuffers": { "version": "25.9.23", "resolved": "https://registry.npmjs.org/flatbuffers/-/flatbuffers-25.9.23.tgz", "integrity": "sha512-MI1qs7Lo4Syw0EOzUl0xjs2lsoeqFku44KpngfIduHBYvzm8h2+7K8YMQh1JtVVVrUvhLpNwqVi4DERegUJhPQ==", "dev": true, - "license": "Apache-2.0", - "peer": true + "license": "Apache-2.0" }, "node_modules/flatted": { "version": "3.4.4", "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.4.tgz", "integrity": "sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/follow-redirects": { "version": "1.16.1", @@ -7410,7 +7275,6 @@ } ], "license": "MIT", - "peer": true, "engines": { "node": ">=4.0" }, @@ -7426,7 +7290,6 @@ "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", @@ -7457,7 +7320,6 @@ "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -7482,7 +7344,6 @@ "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -7492,8 +7353,7 @@ "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/fs-extra": { "version": "9.1.0", @@ -7501,7 +7361,6 @@ "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "at-least-node": "^1.0.0", "graceful-fs": "^4.2.0", @@ -7543,7 +7402,6 @@ "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": "6.* || 8.* || >= 10.*" } @@ -7554,7 +7412,6 @@ "integrity": "sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": "*" } @@ -7565,7 +7422,6 @@ "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", @@ -7591,7 +7447,6 @@ "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" @@ -7618,8 +7473,7 @@ "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/glob": { "version": "13.0.6", @@ -7627,7 +7481,6 @@ "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "dependencies": { "minimatch": "^10.2.2", "minipass": "^7.1.3", @@ -7659,7 +7512,6 @@ "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4" }, @@ -7679,7 +7531,6 @@ "integrity": "sha512-P5VJMVM7qgBn6vjXMw8WG9uVI+ncf2pi72j4de4yz5ZULLj2RGqLYaKOYGsgyrViQ0tePOVlN1tDCCXXtFqXKg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "minimist": "^1.2.8", "neo-async": "^2.6.2", @@ -7702,7 +7553,6 @@ "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=8" } @@ -7713,7 +7563,6 @@ "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4" }, @@ -7727,7 +7576,6 @@ "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "has-symbols": "^1.0.3" }, @@ -7780,8 +7628,7 @@ "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-3.0.3.tgz", "integrity": "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/htmlparser2": { "version": "10.1.0", @@ -7796,7 +7643,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "domelementtype": "^2.3.0", "domhandler": "^5.0.3", @@ -7810,7 +7656,6 @@ "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "domelementtype": "^2.3.0", "domhandler": "^5.0.2", @@ -7826,7 +7671,6 @@ "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "engines": { "node": ">=0.12" }, @@ -7845,8 +7689,7 @@ "url": "https://github.com/sponsors/fb55" } ], - "license": "BSD-2-Clause", - "peer": true + "license": "BSD-2-Clause" }, "node_modules/htmlparser2/node_modules/domhandler": { "version": "5.0.3", @@ -7854,7 +7697,6 @@ "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "domelementtype": "^2.3.0" }, @@ -7871,7 +7713,6 @@ "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "dom-serializer": "^2.0.0", "domelementtype": "^2.3.0", @@ -7887,7 +7728,6 @@ "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "engines": { "node": ">=0.12" }, @@ -7901,7 +7741,6 @@ "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "depd": "~2.0.0", "inherits": "~2.0.4", @@ -7923,7 +7762,6 @@ "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "agent-base": "^7.1.0", "debug": "^4.3.4" @@ -7937,8 +7775,7 @@ "resolved": "https://registry.npmjs.org/http2-client/-/http2-client-1.3.5.tgz", "integrity": "sha512-EC2utToWl4RKfs5zd36Mxq7nzHHBuomZboI0yYL6Y0RmBgT7Sgkq4rQ0ezFTYoIsSs7Tm9SJe+o2FcAg6GBhGA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/https-proxy-agent": { "version": "7.0.6", @@ -7946,7 +7783,6 @@ "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "agent-base": "^7.1.2", "debug": "4" @@ -7991,8 +7827,7 @@ "url": "https://feross.org/support" } ], - "license": "BSD-3-Clause", - "peer": true + "license": "BSD-3-Clause" }, "node_modules/ignore": { "version": "5.3.2", @@ -8000,26 +7835,28 @@ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 4" } }, + "node_modules/immediate": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz", + "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==", + "license": "MIT" + }, "node_modules/inherits": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", - "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/ini": { "version": "1.3.8", "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/inquirer": { "version": "12.11.1", @@ -8120,7 +7957,6 @@ "integrity": "sha512-DWBMKyeM25D70nrIiTkgQth59/G+naKOTep6huF9j+GmeK3DMD60Zvxg5d5qQnz+38AHgou6ean2LECX+lrKDg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 12" } @@ -8131,7 +7967,6 @@ "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.10" } @@ -8154,8 +7989,7 @@ "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/is-core-module": { "version": "2.16.2", @@ -8179,7 +8013,6 @@ "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==", "dev": true, "license": "MIT", - "peer": true, "bin": { "is-docker": "cli.js" }, @@ -8229,7 +8062,6 @@ "integrity": "sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=20" }, @@ -8243,7 +8075,6 @@ "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "is-docker": "^3.0.0" }, @@ -8263,7 +8094,6 @@ "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==", "dev": true, "license": "MIT", - "peer": true, "bin": { "is-docker": "cli.js" }, @@ -8296,8 +8126,7 @@ "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/is-retry-allowed": { "version": "2.2.0", @@ -8305,7 +8134,6 @@ "integrity": "sha512-XVm7LOeLpTW4jV19QSH38vkswxoLud8sQ57YwJVTPWdiaI9I8keEhGFpBlslyVsgdQy4Opg8QOLb8YRgsyZiQg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=10" }, @@ -8317,15 +8145,13 @@ "version": "2.0.2", "resolved": "https://registry.npmjs.org/is-unsafe/-/is-unsafe-2.0.2.tgz", "integrity": "sha512-HgbIHPBH0KHHCcjLfGsCvhtPTVxjaAZlXjwdz7/GQC40SjSe4sfQsar8J5VFo8JOSbarkpV0OLG95bbaNd9aAQ==", - "dev": true, "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/is-wsl": { "version": "2.2.0", @@ -8333,7 +8159,6 @@ "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "is-docker": "^2.0.0" }, @@ -8341,13 +8166,18 @@ "node": ">=8" } }, + "node_modules/isarray": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", + "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", + "license": "MIT" + }, "node_modules/isexe": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/jiti": { "version": "1.21.7", @@ -8355,6 +8185,7 @@ "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==", "dev": true, "license": "MIT", + "peer": true, "bin": { "jiti": "bin/jiti.js" } @@ -8365,7 +8196,6 @@ "integrity": "sha512-9NiFmJEex0sy2Dk58j2UGBSHgUs2ypF9eZSu4L6vjOX3Dp96Sw1F3uL+H+D1sx02jZZdzUT0HgvCy59CuvXcWw==", "dev": true, "license": "MIT", - "peer": true, "funding": { "url": "https://github.com/sponsors/panva" } @@ -8375,8 +8205,7 @@ "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-3.9.4.tgz", "integrity": "sha512-PtOMXpEGuP0RRiRXsjzHzl44dMHxSu2CPvAhinupR1tBa88me+1DPqsobl7eupn5UukjLkln1ZnAOAOXOrYG0Q==", "dev": true, - "license": "BSD-3-Clause", - "peer": true + "license": "BSD-3-Clause" }, "node_modules/js-tokens": { "version": "4.0.0", @@ -8400,7 +8229,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "argparse": "^2.0.1" }, @@ -8414,6 +8242,7 @@ "integrity": "sha512-ECi4Fi2f7BdJtUKTflYRTiaMxIB0O6zfR1fX0GXpUrf6flp8QIYn1UT20YQqdSOfk2dfkCwS8LAFoJDEppNK5Q==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "@asamuzakjp/css-color": "^5.1.11", "@asamuzakjp/dom-selector": "^7.1.1", @@ -8468,16 +8297,14 @@ "resolved": "https://registry.npmjs.org/json-schema-typed/-/json-schema-typed-8.0.2.tgz", "integrity": "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==", "dev": true, - "license": "BSD-2-Clause", - "peer": true + "license": "BSD-2-Clause" }, "node_modules/json-with-bigint": { "version": "3.5.12", "resolved": "https://registry.npmjs.org/json-with-bigint/-/json-with-bigint-3.5.12.tgz", "integrity": "sha512-uwbF/wSSuOgC7qqlq27Xp5B6a2MHVug3t0idZdTqu0JnlFvgJuH7ju+KAk/J06C7GfhoYy2gnb9wz2INqcne7w==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/jsonfile": { "version": "6.2.1", @@ -8498,7 +8325,6 @@ "integrity": "sha512-K+A9hhqbn0f3pJX17Q/7H6yQfD/5OXgdrR5UE12gMXCiN9D5Xq2o5mddV2QEcX/bjla99ASsAAQUyMCCRWAEhw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": "*" } @@ -8509,7 +8335,6 @@ "integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "jws": "^4.0.1", "lodash.includes": "^4.3.0", @@ -8527,6 +8352,48 @@ "npm": ">=6" } }, + "node_modules/jszip": { + "version": "3.10.2", + "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.2.tgz", + "integrity": "sha512-3l+rb15IOWtUhU0H5MFqES/T6Kh7abYwjosBey/vD6hDt8zoEffkSC5Ws5SGtgVw3gBx2NEbhTeSW1+kWkpyTQ==", + "license": "(MIT OR GPL-3.0-or-later)", + "dependencies": { + "lie": "~3.3.0", + "pako": "~1.0.2", + "readable-stream": "~2.3.6", + "setimmediate": "^1.0.5" + } + }, + "node_modules/jszip/node_modules/readable-stream": { + "version": "2.3.8", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", + "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", + "license": "MIT", + "dependencies": { + "core-util-is": "~1.0.0", + "inherits": "~2.0.3", + "isarray": "~1.0.0", + "process-nextick-args": "~2.0.0", + "safe-buffer": "~5.1.1", + "string_decoder": "~1.1.1", + "util-deprecate": "~1.0.1" + } + }, + "node_modules/jszip/node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "license": "MIT" + }, + "node_modules/jszip/node_modules/string_decoder": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", + "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.1.0" + } + }, "node_modules/junk": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/junk/-/junk-3.1.0.tgz", @@ -8543,7 +8410,6 @@ "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "buffer-equal-constant-time": "^1.0.1", "ecdsa-sig-formatter": "1.0.11", @@ -8556,7 +8422,6 @@ "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "jwa": "^2.0.1", "safe-buffer": "^5.0.1" @@ -8569,7 +8434,6 @@ "dev": true, "hasInstallScript": true, "license": "MIT", - "peer": true, "dependencies": { "node-addon-api": "^4.3.0", "prebuild-install": "^7.0.1" @@ -8581,18 +8445,25 @@ "integrity": "sha512-0Fo5oir+O9jnXu5EefYbVK+mHMBeEVEy2cmctR1O1NECcCkPRreJKrS6Qt/j3KC2C148Dfo9i3pCmCMsdqGr0g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "graceful-fs": "^4.1.9" } }, + "node_modules/lie": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz", + "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==", + "license": "MIT", + "dependencies": { + "immediate": "~3.0.5" + } + }, "node_modules/lightningcss": { "version": "1.33.0", "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz", "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==", "dev": true, "license": "MPL-2.0", - "peer": true, "dependencies": { "detect-libc": "^2.0.3" }, @@ -8630,7 +8501,6 @@ "os": [ "android" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8652,7 +8522,6 @@ "os": [ "darwin" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8674,7 +8543,6 @@ "os": [ "darwin" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8696,7 +8564,6 @@ "os": [ "freebsd" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8718,7 +8585,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8740,7 +8606,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8762,7 +8627,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8784,7 +8648,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8806,7 +8669,6 @@ "os": [ "linux" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8828,7 +8690,6 @@ "os": [ "win32" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8850,7 +8711,6 @@ "os": [ "win32" ], - "peer": true, "engines": { "node": ">= 12.0.0" }, @@ -8885,7 +8745,6 @@ "integrity": "sha512-ES/o9qotMpzpN2MHs+Iq/JcVoOj8Fa5wiQYrTdFpvAnwXL0g66XHHUc9WUMk6nAlBtGsFQ24ne+SYnvnaQ2FSw==", "dev": true, "license": "ISC", - "peer": true, "dependencies": { "css-select": "^7.0.0", "cssom": "^0.5.0", @@ -8909,65 +8768,56 @@ "version": "4.18.1", "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz", "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==", - "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.includes": { "version": "4.3.0", "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.isboolean": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.isinteger": { "version": "4.0.4", "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.isnumber": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.isplainobject": { "version": "4.0.6", "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.isstring": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/lodash.once": { "version": "4.1.1", "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/log4js": { "version": "6.9.1", @@ -8975,7 +8825,6 @@ "integrity": "sha512-1somDdy9sChrr9/f4UlzhdaGfDR2c/SaD2a4T7qEkG4jTS57/B3qmnjLYePwQ8cqWnUHZI0iAKxMBpCZICiZ2g==", "dev": true, "license": "Apache-2.0", - "peer": true, "dependencies": { "date-format": "^4.0.14", "debug": "^4.3.4", @@ -9005,7 +8854,6 @@ "integrity": "sha512-zSMINGVYkdpYSOBmLi0D1Uo7JU9nVdQKrHxC8eYlV+9YKK9WePqAlL7lSlorG/U2Fw1w0hTBmaa/jrQ3UbPHtA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "get-func-name": "^2.0.1" } @@ -9045,7 +8893,6 @@ "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4" } @@ -9056,7 +8903,6 @@ "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "charenc": "0.0.2", "crypt": "0.0.2", @@ -9076,7 +8922,6 @@ "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -9087,7 +8932,6 @@ "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", "dev": true, "license": "MIT", - "peer": true, "funding": { "url": "https://github.com/sponsors/sindresorhus" } @@ -9108,7 +8952,6 @@ "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -9133,7 +8976,6 @@ "integrity": "sha512-USPkMeET31rOMiarsBNIHZKLGgvKc/LrjofAnBlOttf5ajRvqiRA8QsenbcooctK6d6Ts6aqZXBA+XbkKthiQg==", "dev": true, "license": "MIT", - "peer": true, "bin": { "mime": "cli.js" }, @@ -9145,9 +8987,7 @@ "version": "1.52.0", "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", - "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -9156,9 +8996,7 @@ "version": "2.1.35", "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", - "dev": true, "license": "MIT", - "peer": true, "dependencies": { "mime-db": "1.52.0" }, @@ -9172,7 +9010,6 @@ "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=10" }, @@ -9186,7 +9023,6 @@ "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "dependencies": { "brace-expansion": "^5.0.8" }, @@ -9203,18 +9039,49 @@ "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", "dev": true, "license": "MIT", - "peer": true, "funding": { "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/minio": { + "version": "8.0.7", + "resolved": "https://registry.npmjs.org/minio/-/minio-8.0.7.tgz", + "integrity": "sha512-E737MgufW8CeQAsTAtnEMrxZ9scMSf29kkhZoXzDTKj/Jszzo2SfeZUH9wbDQH2Rsq6TCtl/yQL0+XdVKZansQ==", + "license": "Apache-2.0", + "dependencies": { + "async": "^3.2.4", + "block-stream2": "^2.1.0", + "browser-or-node": "^2.1.1", + "buffer-crc32": "^1.0.0", + "eventemitter3": "^5.0.1", + "fast-xml-parser": "^5.3.4", + "ipaddr.js": "^2.0.1", + "lodash": "^4.17.21", + "mime-types": "^2.1.35", + "query-string": "^7.1.3", + "stream-json": "^1.8.0", + "through2": "^4.0.2", + "xml2js": "^0.5.0 || ^0.6.2" + }, + "engines": { + "node": "^16 || ^18 || >=20" + } + }, + "node_modules/minio/node_modules/ipaddr.js": { + "version": "2.5.0", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.5.0.tgz", + "integrity": "sha512-aq+t5NAc+cS6rZQQVWC2x98CPqGtKKTMDd4Gaodv0wShnItdKg/51djkGJ1hqH+Oy0ivDftCbSLCQob8zso01w==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, "node_modules/minipass": { "version": "7.1.3", "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz", "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "engines": { "node": ">=16 || 14 >=14.17" } @@ -9225,7 +9092,6 @@ "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "minipass": "^7.1.2" }, @@ -9265,16 +9131,14 @@ "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/ms": { "version": "2.1.3", "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/mustache": { "version": "4.2.0", @@ -9282,7 +9146,6 @@ "integrity": "sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==", "dev": true, "license": "MIT", - "peer": true, "bin": { "mustache": "bin/mustache" } @@ -9293,7 +9156,6 @@ "integrity": "sha512-avsJQhyd+680gKXyG/sQc0nXaC6rBkPOfyHYcFb9+hdkqQkR9bdnkJ0AMZhke0oesPqIO+mFFJ+IdBc7mst4IA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": "^14.17.0 || ^16.13.0 || >=18.0.0" } @@ -9333,8 +9195,7 @@ "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz", "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/negotiator": { "version": "0.6.3", @@ -9342,7 +9203,6 @@ "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -9352,16 +9212,14 @@ "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/neverthrow": { "version": "3.2.0", "resolved": "https://registry.npmjs.org/neverthrow/-/neverthrow-3.2.0.tgz", "integrity": "sha512-AINA32QbYO83L+3CBI6I5lH4LpBSlLwWteJ+uI25s4AQy6g/xz3RZuedmuNo91lLw2rY+AbPEPQdxd7mg1rXoQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/next": { "version": "14.2.35", @@ -9447,7 +9305,6 @@ "integrity": "sha512-lLdwkeg2XUVPTHqWjPltTxH81zbQNbUWC+AEb9ni50KjxkUzAAx1HGtMT21sbntzfUGfIphhcklvs3imJeqDXw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "semver": "^7.3.5" }, @@ -9460,8 +9317,7 @@ "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-4.3.0.tgz", "integrity": "sha512-73sE9+3UaLYYFmDsFZnqCInzPyh3MqIwZO9cw58yIqAZhONrrabrYyYe3TuIqtIiOuTXVhsGau8hcrhhwSsDIQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/node-domexception": { "version": "1.0.0", @@ -9509,7 +9365,6 @@ "integrity": "sha512-ofRW94Ab0T4AOh5Fk8t0h8OBWrmjb0SSB20xh1H8YnPV9EJ+f5AMoYSUQ2zgJ4Iq2HAK0I2l5/Nequ8YzFS3Hg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "http2-client": "^1.2.5" }, @@ -9532,8 +9387,7 @@ "resolved": "https://registry.npmjs.org/node-machine-id/-/node-machine-id-1.1.12.tgz", "integrity": "sha512-QNABxbrPa3qEIfrE6GOJ7BYIuignnJw7iQ2YPbc3Nla1HzRJjXzZOiikfF8m7eAMfichLt3M4VgLOetqgDmgGQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/node-readfiles": { "version": "0.2.0", @@ -9541,7 +9395,6 @@ "integrity": "sha512-SU00ZarexNlE4Rjdm83vglt5Y9yiQ+XI1XpflWlb7q7UTN1JUItm69xMeiQCTxtTfnzt+83T8Cx+vI2ED++VDA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "es6-promise": "^3.2.1" } @@ -9579,7 +9432,6 @@ "integrity": "sha512-GX0gsdbGVCgnRgbeGaubfjpBXyYRWOOCVeYh08bSQvDZqxz5ndXs1OTfAt/h36G1xvI94YIspsI0sVFqAV9+RQ==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "boolbase": "^2.0.0" }, @@ -9597,7 +9449,6 @@ "integrity": "sha512-pJTS2+T0oGIwgjGpw7sIRU8RQMcUoKCDWFLdBqKB2BNmGpbBMH2sdqAaOXUg8OzonZHU0L7vfJu1mJFEiYDWOQ==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "fast-safe-stringify": "^2.0.7" } @@ -9608,7 +9459,6 @@ "integrity": "sha512-KEGjPDVoU5K6swgo9hJVA/qYGlwfbFx+Kg2QB/kd7rzV5N8N5Mg6PlsoCMohVnQmo+pzJap/F610qTodKzecGQ==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "@exodus/schemasafe": "^1.0.0-rc.2", "should": "^13.2.1", @@ -9624,7 +9474,6 @@ "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">= 6" } @@ -9635,7 +9484,6 @@ "integrity": "sha512-Yx5PWQNZomfEhPPOphFbZKi9W93CocQj18NlD2Pa4GWZzdZpSJvYwoiuurRI7m3SpcChrnO08hkuQDL3FGsVFQ==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "node-fetch-h2": "^2.3.0", "oas-kit-common": "^1.0.8", @@ -9656,7 +9504,6 @@ "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">= 6" } @@ -9667,7 +9514,6 @@ "integrity": "sha512-2yucenq1a9YPmeNExoUa9Qwrt9RFkjqaMAA1X+U7sbb0AqBeTIdMHky9SQQ6iN94bO5NW0W4TRYXerG+BdAvAQ==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "funding": { "url": "https://github.com/Mermade/oas-kit?sponsor=1" } @@ -9678,7 +9524,6 @@ "integrity": "sha512-cu20/HE5N5HKqVygs3dt94eYJfBi0TsZvPVXDhbXQHiEityDN+RROTleefoKRKKJ9dFAF2JBkDHgvWj0sjKGmw==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "call-me-maybe": "^1.0.1", "oas-kit-common": "^1.0.8", @@ -9699,7 +9544,6 @@ "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">= 6" } @@ -9730,7 +9574,6 @@ "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4" }, @@ -10380,7 +10223,6 @@ "integrity": "sha512-kxV247eRDdGhBKOZYBhAvgzm/PveXdUXvZR5bi0mDYWFeY6wHoDuCSjRw00khRR///1ZvgixfvS4CqSfezyptQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@microsoft/app-manifest": "^1.0.2", "adm-zip": "0.5.16", @@ -10402,7 +10244,6 @@ "integrity": "sha512-2eOdCCYJ5bhCe2p9KKETdg1UNshsKaT0lDU/jNopAg3t7zC1WxwvofTSO/+4Log5L4Re+wUdV8MqrQikZBa7+Q==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@xmldom/xmldom": "^0.8.5", "commander": "^9.0.0", @@ -10418,7 +10259,6 @@ "integrity": "sha512-/5NV/vDALVFDXgLmfsy9TRCBlKwO2LNBFzpzvb9iIj+jR+eSc6DLYYvVOdivT/jm7MtU6TebYuRmzEOI7w40UA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=10.0.0" } @@ -10429,7 +10269,6 @@ "integrity": "sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": "^12.20.0 || >=14" } @@ -10440,7 +10279,6 @@ "integrity": "sha512-TGw5yVi4saajsSEgz25grObGHEUaDrniwvA2qwSC060KfqGPdglhvPMA2lPIoxs3PQIItj2iag35fONcQqgUaQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=12.0" } @@ -10451,7 +10289,6 @@ "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "color-convert": "^1.9.0" }, @@ -10465,7 +10302,6 @@ "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ansi-styles": "^3.2.1", "escape-string-regexp": "^1.0.5", @@ -10481,7 +10317,6 @@ "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "color-name": "1.1.3" } @@ -10491,8 +10326,7 @@ "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/office-addin-manifest/node_modules/commander": { "version": "13.1.0", @@ -10500,7 +10334,6 @@ "integrity": "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" } @@ -10511,7 +10344,6 @@ "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "graceful-fs": "^4.1.2", "jsonfile": "^4.0.0", @@ -10527,7 +10359,6 @@ "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=4" } @@ -10538,7 +10369,6 @@ "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==", "dev": true, "license": "MIT", - "peer": true, "optionalDependencies": { "graceful-fs": "^4.1.6" } @@ -10549,7 +10379,6 @@ "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "whatwg-url": "^5.0.0" }, @@ -10571,7 +10400,6 @@ "integrity": "sha512-MUbcqOodtlOUNhLKjSdqeLBHFVd7Qh5pUODqmQe2VLBKk7PuRgl4dCk6bp2dU79vl6BcDyrRERpkyVnQg6zdFg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "commander": "^13.0.0" }, @@ -10585,7 +10413,6 @@ "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "has-flag": "^3.0.0" }, @@ -10598,8 +10425,7 @@ "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/office-addin-manifest/node_modules/universalify": { "version": "0.1.2", @@ -10607,7 +10433,6 @@ "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 4.0.0" } @@ -10622,7 +10447,6 @@ "https://github.com/sponsors/ctavan" ], "license": "MIT", - "peer": true, "bin": { "uuid": "dist-node/bin/uuid" } @@ -10632,8 +10456,7 @@ "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==", "dev": true, - "license": "BSD-2-Clause", - "peer": true + "license": "BSD-2-Clause" }, "node_modules/office-addin-manifest/node_modules/whatwg-url": { "version": "5.0.0", @@ -10641,7 +10464,6 @@ "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tr46": "~0.0.3", "webidl-conversions": "^3.0.0" @@ -10725,7 +10547,6 @@ "integrity": "sha512-WjthzxXY5gl78+jh91LczM9zg26zU8tc3afLi2bUcrMaPc6LaRaKJhw6NsyRB73kVDx76DGTe6Ws6sxufghOdQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "adm-zip": "0.5.12", "commander": "^13.0.0", @@ -10745,7 +10566,6 @@ "integrity": "sha512-6TVU49mK6KZb4qG6xWaaM4C7sA/sgUMLy/JYMOzkcp3BvVLpW0fXDFQiIzAuxFCt/2+xD7fNIiPFAoLZPhVNLQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=6.0" } @@ -10756,7 +10576,6 @@ "integrity": "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" } @@ -10767,7 +10586,6 @@ "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "graceful-fs": "^4.1.2", "jsonfile": "^4.0.0", @@ -10783,7 +10601,6 @@ "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==", "dev": true, "license": "MIT", - "peer": true, "optionalDependencies": { "graceful-fs": "^4.1.6" } @@ -10794,7 +10611,6 @@ "integrity": "sha512-MUbcqOodtlOUNhLKjSdqeLBHFVd7Qh5pUODqmQe2VLBKk7PuRgl4dCk6bp2dU79vl6BcDyrRERpkyVnQg6zdFg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "commander": "^13.0.0" }, @@ -10808,7 +10624,6 @@ "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 4.0.0" } @@ -10842,7 +10657,6 @@ "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ee-first": "1.1.1" }, @@ -10856,7 +10670,6 @@ "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", "dev": true, "license": "ISC", - "peer": true, "dependencies": { "wrappy": "1" } @@ -10867,7 +10680,6 @@ "integrity": "sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "define-lazy-prop": "^2.0.0", "is-docker": "^2.1.1", @@ -10893,8 +10705,7 @@ "resolved": "https://registry.npmjs.org/original-fs/-/original-fs-1.2.0.tgz", "integrity": "sha512-IGo+qFumpIV65oDchJrqL0BOk9kr82fObnTesNJt8t3YgP6vfqcmRs0ofPzg3D9PKMeBHt7lrg1k/6L+oFdS8g==", "dev": true, - "license": "Unlicense", - "peer": true + "license": "Unlicense" }, "node_modules/pako": { "version": "1.0.11", @@ -10921,7 +10732,6 @@ "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -10930,7 +10740,6 @@ "version": "1.6.2", "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.6.2.tgz", "integrity": "sha512-enSlaiat05iasnzmgNxRj8reFdj3puY2QpNgP1aPIaVfT6nn9ICuPoFlKHk8EN22HcwewshO+mN2DGbkCEOtqQ==", - "dev": true, "funding": [ { "type": "github", @@ -10938,7 +10747,6 @@ } ], "license": "MIT", - "peer": true, "engines": { "node": ">=14.0.0" } @@ -10949,7 +10757,6 @@ "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=8" } @@ -10967,7 +10774,6 @@ "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "dependencies": { "lru-cache": "^11.0.0", "minipass": "^7.1.2" @@ -10984,8 +10790,7 @@ "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz", "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/pathval": { "version": "1.1.1", @@ -10993,7 +10798,6 @@ "integrity": "sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": "*" } @@ -11088,7 +10892,6 @@ "integrity": "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=16.20.0" } @@ -11122,6 +10925,7 @@ } ], "license": "MIT", + "peer": true, "dependencies": { "nanoid": "^3.3.18", "picocolors": "^1.1.1", @@ -11270,6 +11074,7 @@ "resolved": "https://registry.npmjs.org/postgres/-/postgres-3.4.9.tgz", "integrity": "sha512-GD3qdB0x1z9xgFI6cdRD6xu2Sp2WCOEoe3mtnyB5Ee0XrrL5Pe+e4CCnJrRMnL1zYtRDZmQQVbvOttLnKDLnaw==", "license": "Unlicense", + "peer": true, "engines": { "node": ">=12" }, @@ -11284,7 +11089,6 @@ "integrity": "sha512-C+y9x90UElAddDZmV4qOx9W53B61PO7cIqWz2dQsWlwswuq4mr8NEwytdGKboYbQlGZ3awrkTeNvcZiZNHnQ8A==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=20" }, @@ -11299,7 +11103,6 @@ "deprecated": "No longer maintained. Please contact the author of the relevant native addon; alternatives are available.", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "detect-libc": "^2.0.0", "expand-template": "^2.0.3", @@ -11321,13 +11124,18 @@ "node": ">=10" } }, + "node_modules/process-nextick-args": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", + "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", + "license": "MIT" + }, "node_modules/proper-lockfile": { "version": "4.1.2", "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz", "integrity": "sha512-TjNPblN4BwAWMXU8s9AEz4JmQxnD1NNL7bNOY/AKUzyamc379FWASUhc/K1pL2noVb+XmZKLL68cjzLsiOAMaA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "graceful-fs": "^4.2.4", "retry": "^0.12.0", @@ -11339,8 +11147,7 @@ "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/proxy-addr": { "version": "2.0.8", @@ -11348,7 +11155,6 @@ "integrity": "sha512-5nnx0yGyVUcY6t9RnWcARWtwT9F1D8O9rt08htPvnd49W1IgZtmLkhu9WfMzQj1cFxjHIO6connUNVW5k7AVyQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" @@ -11367,7 +11173,6 @@ "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=10" } @@ -11378,7 +11183,6 @@ "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" @@ -11400,7 +11204,6 @@ "integrity": "sha512-5Px6J7rfHBAGUhNQ3es4YzcOdBBw0SDcVtThJml4RdnKw4tKs2epA0kPZ+K8X+WiHktT93RHVcQ/3ym5aTCgtg==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "es-define-property": "^1.0.1", "side-channel": "^1.1.1" @@ -11412,6 +11215,24 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/query-string": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/query-string/-/query-string-7.1.3.tgz", + "integrity": "sha512-hh2WYhq4fi8+b+/2Kg9CEge4fDPvHS534aOOvOZeQ3+Vf2mCFsaFBYj0i+iXcAq6I9Vzp5fjMFBlONvayDC1qg==", + "license": "MIT", + "dependencies": { + "decode-uri-component": "^0.2.2", + "filter-obj": "^1.1.0", + "split-on-first": "^1.0.0", + "strict-uri-encode": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/queue-microtask": { "version": "1.2.3", "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", @@ -11439,7 +11260,6 @@ "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.6" } @@ -11450,7 +11270,6 @@ "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", @@ -11467,7 +11286,6 @@ "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", "dev": true, "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", - "peer": true, "dependencies": { "deep-extend": "^0.6.0", "ini": "~1.3.0", @@ -11483,6 +11301,7 @@ "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz", "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==", "license": "MIT", + "peer": true, "dependencies": { "loose-envify": "^1.1.0" }, @@ -11495,6 +11314,7 @@ "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz", "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==", "license": "MIT", + "peer": true, "dependencies": { "loose-envify": "^1.1.0", "scheduler": "^0.23.2" @@ -11528,9 +11348,7 @@ "version": "3.6.2", "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "dev": true, "license": "MIT", - "peer": true, "dependencies": { "inherits": "^2.0.3", "string_decoder": "^1.1.1", @@ -11558,8 +11376,7 @@ "resolved": "https://registry.npmjs.org/reflect-metadata/-/reflect-metadata-0.1.14.tgz", "integrity": "sha512-ZhYeb6nRaXCfhnndflDK8qI6ZQ/YcWZCISRAWICW9XYqMUwjZM9Z0DveWX/ABN01oxSHwVxKQmxeYZSsm0jh5A==", "dev": true, - "license": "Apache-2.0", - "peer": true + "license": "Apache-2.0" }, "node_modules/reftools": { "version": "1.1.9", @@ -11567,7 +11384,6 @@ "integrity": "sha512-OVede/NQE13xBQ+ob5CKd5KyeJYU2YInb1bmV4nRoOfquZPkAkxuOXicSe1PvqIuZZ4kD13sPKBbR7UFDmli6w==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "funding": { "url": "https://github.com/Mermade/oas-kit?sponsor=1" } @@ -11578,7 +11394,6 @@ "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.10.0" } @@ -11631,7 +11446,6 @@ "integrity": "sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 4" } @@ -11652,8 +11466,7 @@ "resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.4.1.tgz", "integrity": "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/rolldown": { "version": "1.2.8", @@ -11661,7 +11474,6 @@ "integrity": "sha512-Z67nTmhZe7anqnM/EjI392w5i/ANUinjip7QYsOyN37oayduxt3ksdX0hf5OOamkAd53BiIHfbfSzfUmzKFQqQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@oxc-project/types": "=0.149.0", "@rolldown/pluginutils": "^1.0.0" @@ -11696,7 +11508,6 @@ "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "^4.4.0", "depd": "^2.0.0", @@ -11714,7 +11525,6 @@ "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==", "dev": true, "license": "MIT", - "peer": true, "funding": { "type": "opencollective", "url": "https://opencollective.com/express" @@ -11726,7 +11536,6 @@ "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=18" }, @@ -11740,7 +11549,6 @@ "integrity": "sha512-540WwVDOMxA6dN6We19EcT9sc3hkXPw5mzRNGM3FkdN/vtE9NFvj5lFAPNwUDmJjXidm3v7TC1cTE7t17Ulm1Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.12.0" } @@ -11783,7 +11591,6 @@ "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", - "dev": true, "funding": [ { "type": "github", @@ -11798,8 +11605,7 @@ "url": "https://feross.org/support" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/safer-buffer": { "version": "2.1.2", @@ -11812,7 +11618,6 @@ "version": "1.6.1", "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz", "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==", - "dev": true, "license": "BlueOak-1.0.0", "engines": { "node": ">=11.0.0" @@ -11846,7 +11651,6 @@ "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", "dev": true, "license": "ISC", - "peer": true, "bin": { "semver": "bin/semver.js" }, @@ -11860,7 +11664,6 @@ "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "debug": "2.6.9", "depd": "2.0.0", @@ -11886,7 +11689,6 @@ "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "ms": "2.0.0" } @@ -11896,8 +11698,7 @@ "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/send/node_modules/mime": { "version": "1.6.0", @@ -11905,7 +11706,6 @@ "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", "dev": true, "license": "MIT", - "peer": true, "bin": { "mime": "cli.js" }, @@ -11919,7 +11719,6 @@ "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "encodeurl": "~2.0.0", "escape-html": "~1.0.3", @@ -11930,13 +11729,18 @@ "node": ">= 0.8.0" } }, + "node_modules/setimmediate": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz", + "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==", + "license": "MIT" + }, "node_modules/setprototypeof": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/shebang-command": { "version": "2.0.0", @@ -11944,7 +11748,6 @@ "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "shebang-regex": "^3.0.0" }, @@ -11958,7 +11761,6 @@ "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=8" } @@ -11969,7 +11771,6 @@ "integrity": "sha512-PcByqNyT/38F2kDNi006HAMRJaULuBzq/FOsw3qdZvX/GA9W/jamDaRskgHjubHiftXK5sIFxLNkvrXUwcof6Q==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4" }, @@ -11982,8 +11783,7 @@ "resolved": "https://registry.npmjs.org/shimmer/-/shimmer-1.2.1.tgz", "integrity": "sha512-sQTKC1Re/rM6XyFM6fIAGHRPVGvyXfgzIDvzoq608vM+jeyVD0Tu1E6Np0Kc2zAIFWIj963V2800iF/9LPieQw==", "dev": true, - "license": "BSD-2-Clause", - "peer": true + "license": "BSD-2-Clause" }, "node_modules/should": { "version": "13.2.3", @@ -11991,7 +11791,6 @@ "integrity": "sha512-ggLesLtu2xp+ZxI+ysJTmNjh2U0TsC+rQ/pfED9bUZZ4DKefP27D+7YJVVTvKsmjLpIi9jAa7itwDGkDDmt1GQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "should-equal": "^2.0.0", "should-format": "^3.0.3", @@ -12006,7 +11805,6 @@ "integrity": "sha512-ZP36TMrK9euEuWQYBig9W55WPC7uo37qzAEmbjHz4gfyuXrEUgF8cUvQVO+w+d3OMfPvSRQJ22lSm8MQJ43LTA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "should-type": "^1.4.0" } @@ -12017,7 +11815,6 @@ "integrity": "sha512-hZ58adtulAk0gKtua7QxevgUaXTTXxIi8t41L3zo9AHvjXO1/7sdLECuHeIN2SRtYXpNkmhoUP2pdeWgricQ+Q==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "should-type": "^1.3.0", "should-type-adaptors": "^1.0.1" @@ -12028,8 +11825,7 @@ "resolved": "https://registry.npmjs.org/should-type/-/should-type-1.4.0.tgz", "integrity": "sha512-MdAsTu3n25yDbIe1NeN69G4n6mUnJGtSJHygX3+oN0ZbO3DTiATnf7XnYJdGT42JCXurTb1JI0qOBR65shvhPQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/should-type-adaptors": { "version": "1.1.0", @@ -12037,7 +11833,6 @@ "integrity": "sha512-JA4hdoLnN+kebEp2Vs8eBe9g7uy0zbRo+RMcU0EsNy+R+k049Ki+N5tT5Jagst2g7EAja+euFuoXFCa8vIklfA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "should-type": "^1.3.0", "should-util": "^1.0.0" @@ -12048,8 +11843,7 @@ "resolved": "https://registry.npmjs.org/should-util/-/should-util-1.0.1.tgz", "integrity": "sha512-oXF8tfxx5cDk8r2kYqlkUJzZpDBqVY/II2WhvU0n9Y3XYvAYRmeaf1PvvIvTgPnv4KJ+ES5M0PyDq5Jp+Ygy2g==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/side-channel": { "version": "1.1.1", @@ -12057,7 +11851,6 @@ "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "es-errors": "^1.3.0", "object-inspect": "^1.13.4", @@ -12078,7 +11871,6 @@ "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "es-errors": "^1.3.0", "object-inspect": "^1.13.4" @@ -12096,7 +11888,6 @@ "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", @@ -12116,7 +11907,6 @@ "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", @@ -12170,8 +11960,7 @@ "url": "https://feross.org/support" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/simple-get": { "version": "4.0.1", @@ -12193,7 +11982,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "decompress-response": "^6.0.0", "once": "^1.3.1", @@ -12230,13 +12018,21 @@ "source-map": "^0.6.0" } }, + "node_modules/split-on-first": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/split-on-first/-/split-on-first-1.1.0.tgz", + "integrity": "sha512-43ZssAJaMusuKWL8sKUBQXHWOpq8d6CfN/u1p4gUzfJkM05C8rxTmYrkIPTXapZpORA6LkkzcUulJ8FqA7Uudw==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/stack-chain": { "version": "1.3.7", "resolved": "https://registry.npmjs.org/stack-chain/-/stack-chain-1.3.7.tgz", "integrity": "sha512-D8cWtWVdIe/jBA7v5p5Hwl5yOSOrmZPWDPe2KxQ5UAGD+nxbxU0lKXA4h85Ta6+qgdKVL3vUxsbIZjc1kBG7ug==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/stackback": { "version": "0.0.2", @@ -12251,7 +12047,6 @@ "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -12263,13 +12058,27 @@ "dev": true, "license": "MIT" }, + "node_modules/stream-chain": { + "version": "2.2.5", + "resolved": "https://registry.npmjs.org/stream-chain/-/stream-chain-2.2.5.tgz", + "integrity": "sha512-1TJmBx6aSWqZ4tx7aTpBDXK0/e2hhcNSTV8+CbFJtDjbb+I1mZ8lHit0Grw9GRT+6JbIrrDd8esncgBi8aBXGA==", + "license": "BSD-3-Clause" + }, + "node_modules/stream-json": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/stream-json/-/stream-json-1.9.1.tgz", + "integrity": "sha512-uWkjJ+2Nt/LO9Z/JyKZbMusL8Dkh97uUBTv3AJQ74y07lVahLY4eEFsPsE97pxYBwr8nnjMAIch5eqI0gPShyw==", + "license": "BSD-3-Clause", + "dependencies": { + "stream-chain": "^2.2.5" + } + }, "node_modules/streamroller": { "version": "3.1.5", "resolved": "https://registry.npmjs.org/streamroller/-/streamroller-3.1.5.tgz", "integrity": "sha512-KFxaM7XT+irxvdqSP1LGLgNWbYN7ay5owZ3r/8t77p+EtSUAfUgtl7be3xtqtOmGUl9K9YPO2ca8133RlTjvKw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "date-format": "^4.0.14", "debug": "^4.3.4", @@ -12285,7 +12094,6 @@ "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^4.0.0", @@ -12301,7 +12109,6 @@ "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==", "dev": true, "license": "MIT", - "peer": true, "optionalDependencies": { "graceful-fs": "^4.1.6" } @@ -12312,7 +12119,6 @@ "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 4.0.0" } @@ -12325,13 +12131,20 @@ "node": ">=10.0.0" } }, + "node_modules/strict-uri-encode": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/strict-uri-encode/-/strict-uri-encode-2.0.0.tgz", + "integrity": "sha512-QwiXZgpRcKkhTj2Scnn++4PKtWsH0kpzZ62L2R6c/LUVYv7hVnZqcg2+sMuT6R7Jusu1vviK/MFsu6kNJfWlEQ==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, "node_modules/string_decoder": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", - "dev": true, "license": "MIT", - "peer": true, "dependencies": { "safe-buffer": "~5.2.0" } @@ -12383,7 +12196,6 @@ "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.10.0" } @@ -12392,7 +12204,6 @@ "version": "2.5.1", "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.5.1.tgz", "integrity": "sha512-UM4nTLWzQiDBseVxUGxN0wJzIk0UU89Qi7pKXz9qISo+lhviJikTuikBsK/oFRlpvYHvSdz0TVoLyQ+sEpYwxA==", - "dev": true, "funding": [ { "type": "github", @@ -12400,7 +12211,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "anynum": "^1.0.1" } @@ -12457,7 +12267,6 @@ "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "has-flag": "^4.0.0" }, @@ -12493,7 +12302,6 @@ "integrity": "sha512-upi/0ZGkYgEcLeGieoz8gT74oWHA0E7JivX7aN9mAf+Tc7BQoRBvnIGHoPDw+f9TXTW4s6kGYCZJtauP6OYp7g==", "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "call-me-maybe": "^1.0.1", "node-fetch": "^2.6.1", @@ -12522,7 +12330,6 @@ "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "whatwg-url": "^5.0.0" }, @@ -12543,16 +12350,14 @@ "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/swagger2openapi/node_modules/webidl-conversions": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==", "dev": true, - "license": "BSD-2-Clause", - "peer": true + "license": "BSD-2-Clause" }, "node_modules/swagger2openapi/node_modules/whatwg-url": { "version": "5.0.0", @@ -12560,7 +12365,6 @@ "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "tr46": "~0.0.3", "webidl-conversions": "^3.0.0" @@ -12572,7 +12376,6 @@ "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">= 6" } @@ -12628,7 +12431,6 @@ "integrity": "sha512-MFO/QzvtAOmJbkhOaCTvbGcFN9L9b+JunIsDwaKljSOdcLMea3NJ1k9Usz/rjdfSXTq4dfzfeS7W4p4YOAAHeA==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "dependencies": { "@isaacs/fs-minipass": "^4.0.0", "chownr": "^3.0.0", @@ -12646,7 +12448,6 @@ "integrity": "sha512-OboTd8mmMhZDNPV+UjQcK9yKAatXu2aJ+r1w4im1Otd4M4fl2hwvdoXUxIYHFTHWK/3y3FarBP70v3vwmGlOxw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "chownr": "^1.1.1", "mkdirp-classic": "^0.5.2", @@ -12659,8 +12460,7 @@ "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/tar-stream": { "version": "2.2.0", @@ -12668,7 +12468,6 @@ "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "bl": "^4.0.3", "end-of-stream": "^1.4.1", @@ -12686,7 +12485,6 @@ "integrity": "sha512-UDdUF9kV2hYdlv+7AgqP2kXarVSUhjK7tg1BUflIRGEgND0/QoNpN64rcEuhEcM8AIbW65yrCopJWqRhLZ3m8w==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "axios": "^1.6.1" } @@ -12697,7 +12495,6 @@ "integrity": "sha512-bWnjSNscmuI+GJze6ZupnHP8G/cTcsJF+bXCeQknk2SHQsgbNJnLrqiH9jZ2W4STPVXH2mDKKRX3iwPhc9Cn/Q==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "@jridgewell/source-map": "^0.3.3", "acorn": "^8.15.0", @@ -12716,8 +12513,7 @@ "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/thenify": { "version": "3.3.1", @@ -12742,6 +12538,15 @@ "node": ">=0.8" } }, + "node_modules/through2": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz", + "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==", + "license": "MIT", + "dependencies": { + "readable-stream": "3" + } + }, "node_modules/tinybench": { "version": "6.1.4", "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-6.1.4.tgz", @@ -12803,6 +12608,7 @@ "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", "dev": true, "license": "MIT", + "peer": true, "engines": { "node": ">=12" }, @@ -12836,7 +12642,6 @@ "integrity": "sha512-e0votIpp4Uo2AJYSzVHV6xCcawuiez3DzqDAbrTc3YxBkplN6e+dM13ZeIcZnDg/QpSuU2zfZ3rzwY8ukEnaXw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=14.14" } @@ -12860,7 +12665,6 @@ "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=0.6" } @@ -12897,7 +12701,6 @@ "integrity": "sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==", "dev": true, "license": "MIT", - "peer": true, "bin": { "tree-kill": "cli.js" } @@ -12940,7 +12743,6 @@ "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", "dev": true, "license": "Apache-2.0", - "peer": true, "dependencies": { "safe-buffer": "^5.0.1" }, @@ -12954,7 +12756,6 @@ "integrity": "sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=4" } @@ -12965,7 +12766,6 @@ "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==", "dev": true, "license": "(MIT OR CC0-1.0)", - "peer": true, "engines": { "node": ">=10" }, @@ -12979,7 +12779,6 @@ "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "media-typer": "0.3.0", "mime-types": "~2.1.24" @@ -12993,8 +12792,7 @@ "resolved": "https://registry.npmjs.org/typedi/-/typedi-0.10.0.tgz", "integrity": "sha512-v3UJF8xm68BBj6AF4oQML3ikrfK2c9EmZUyLOfShpJuItAqVBHWP/KtpGinkSsIiP6EZyyb6Z3NXyW9dgS9X1w==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/typescript": { "version": "5.9.3", @@ -13017,7 +12815,6 @@ "dev": true, "license": "BSD-2-Clause", "optional": true, - "peer": true, "bin": { "uglifyjs": "bin/uglifyjs" }, @@ -13030,16 +12827,14 @@ "resolved": "https://registry.npmjs.org/uhyphen/-/uhyphen-0.2.0.tgz", "integrity": "sha512-qz3o9CHXmJJPGBdqzab7qAYuW8kQGKNEuoHFYrBwV6hWIMcpAmxDLXojcHfFr9US1Pe6zUswEIJIbLI610fuqA==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/underscore": { "version": "1.13.8", "resolved": "https://registry.npmjs.org/underscore/-/underscore-1.13.8.tgz", "integrity": "sha512-DXtD3ZtEQzc7M8m4cXotyHR+FAS18C64asBYY5vqZexfYryNNnDc02W4hKg3rdQuqOYas1jkseX0+nZXjTXnvQ==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/undici": { "version": "7.30.0", @@ -13074,7 +12869,6 @@ "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -13123,7 +12917,6 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", - "dev": true, "license": "MIT" }, "node_modules/utils-merge": { @@ -13132,7 +12925,6 @@ "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.4.0" } @@ -13147,7 +12939,6 @@ "https://github.com/sponsors/ctavan" ], "license": "MIT", - "peer": true, "bin": { "uuid": "dist/esm/bin/uuid" } @@ -13158,7 +12949,6 @@ "integrity": "sha512-TQ5pAGhd5whStmqWvYF4OjQROlmv9SMFVt37qoCBdqRffuuklWYQlCNnEs2ZaIBD1kZRNnikiZOS1eqgkar0iw==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.10" } @@ -13169,7 +12959,6 @@ "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">= 0.8" } @@ -13180,7 +12969,6 @@ "integrity": "sha512-cFKLV/PRgAUlIRm5WjMjJ86jrftzpqcgH+Us+DS8mI3CDNiH30Whrz8uHL3+MOLPAgqbMBAqWdAHAphOAM+z/Q==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "lightningcss": "^1.33.0", "picomatch": "^4.0.5", @@ -13259,7 +13047,6 @@ "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=12" }, @@ -13369,7 +13156,6 @@ "integrity": "sha512-perEnXQdQOJMTDFNv+UF3h1Y0z4iSiaN9jIlb0OqIYgosPCZGYh/MCUlkFtV2668PL69lRDO32hmvL2yiidUYg==", "dev": true, "license": "MIT", - "peer": true, "engines": { "node": ">=8.0.0 || >=10.0.0" } @@ -13438,7 +13224,6 @@ "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", "dev": true, "license": "ISC", - "peer": true, "dependencies": { "isexe": "^2.0.0" }, @@ -13478,8 +13263,7 @@ "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", "dev": true, - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/wrap-ansi": { "version": "6.2.0", @@ -13501,8 +13285,7 @@ "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", "dev": true, - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/ws": { "version": "7.5.13", @@ -13532,7 +13315,6 @@ "integrity": "sha512-c16PKLIRxBYpR3jSWsdS7SFp0COm5SOQdiFjY818dYFHJbMGuLBszpF07LBWmOS1uzrHa9VGdynsEgoeKy0oOQ==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "is-wsl": "^3.1.0", "powershell-utils": "^0.2.0" @@ -13550,7 +13332,6 @@ "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "is-inside-container": "^1.0.0" }, @@ -13575,7 +13356,6 @@ "version": "0.3.0", "resolved": "https://registry.npmjs.org/xml-naming/-/xml-naming-0.3.0.tgz", "integrity": "sha512-ghig2TBE/H11aOVgmahA3MhimvkBr6JIYknH/Dhdk10nXwdbIqBJsbfMxpvFPG8bAw77gN29aQWvKpmVoPlvPQ==", - "dev": true, "funding": [ { "type": "github", @@ -13583,7 +13363,6 @@ } ], "license": "MIT", - "peer": true, "engines": { "node": ">=16.0.0" } @@ -13592,7 +13371,6 @@ "version": "0.5.0", "resolved": "https://registry.npmjs.org/xml2js/-/xml2js-0.5.0.tgz", "integrity": "sha512-drPFnkQJik/O+uPKpqSgr22mpuFHqKdbS835iAQrUC73L2F5WkboIRd63ai/2Yg6I1jzifPFKH2NTK+cfglkIA==", - "dev": true, "license": "MIT", "dependencies": { "sax": ">=0.6.0", @@ -13606,7 +13384,6 @@ "version": "11.0.1", "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-11.0.1.tgz", "integrity": "sha512-fDlsI/kFEx7gLvbecc0/ohLG50fugQp8ryHzMTuW9vSa1GJ0XYWKnhsUx7oie3G98+r56aTQIUB4kht42R3JvA==", - "dev": true, "license": "MIT", "engines": { "node": ">=4.0" @@ -13634,7 +13411,6 @@ "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">=10" } @@ -13645,7 +13421,6 @@ "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==", "dev": true, "license": "BlueOak-1.0.0", - "peer": true, "engines": { "node": ">=18" } @@ -13656,7 +13431,6 @@ "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==", "dev": true, "license": "ISC", - "peer": true, "bin": { "yaml": "bin.mjs" }, @@ -13673,7 +13447,6 @@ "integrity": "sha512-GZtjxm/J/4TSxuL3FNYjCmLktBTnIw/rVmKSIyKeYAZpmJB2ig9VauCC5xsa82GNKVKDAqpOn3KVzNt0zmrU0g==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "cliui": "^8.0.1", "escalade": "^3.1.1", @@ -13693,7 +13466,6 @@ "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", "dev": true, "license": "ISC", - "peer": true, "engines": { "node": ">=12" } @@ -13728,7 +13500,6 @@ "integrity": "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA==", "dev": true, "license": "ISC", - "peer": true, "peerDependencies": { "zod": "^3.25.28 || ^4" } diff --git a/package.json b/package.json index 701ecae..fabdcde 100644 --- a/package.json +++ b/package.json @@ -15,6 +15,7 @@ "dependencies": { "@pdf-lib/fontkit": "^1.1.1", "@xmldom/xmldom": "^0.9.12", + "docx-templates": "^4.15.0", "drizzle-orm": "^0.45.2", "lucide-react": "^1.42.0", "minio": "^8.0.7", @@ -31,7 +32,7 @@ "xpath": "^0.0.34" }, "devDependencies": { - "@types/node": "^26.5.0", + "@types/node": "^26.6.5", "@types/office-js": "^1.0.612", "@types/pngjs": "^6.0.5", "@types/react": "^18.3.31", diff --git a/public/tmpl/T12_FD155_3s-long.json b/public/tmpl/T12_FD155_3s-long.json new file mode 100644 index 0000000..294791e --- /dev/null +++ b/public/tmpl/T12_FD155_3s-long.json @@ -0,0 +1,44 @@ +{ + "info": { + "ticket_data": "{\"fid\":\"T12_FD155_3s-long\",\"tid\":\"T12\",\"uid\":\"john\",\"uname\":\"John Doe\"}" + }, + "dc": { + "Interpleader": false, + "docabbr": "(ต. ๒๒)", + "blackno": "คดีหมายเลขดำที่", + "redno": "คดีหมายเลขแดงที่", + "court": "ศาลปกครองนครราชสีมา", + "panels": [ + { + "pname": "นายวิรุฬห์ จินตนะกุล", + "pmname": "ตุลาการศาลปกครองกลาง", + "pm": "ตุลาการเจ้าของสำนวน" + }, + { + "pname": "นายสัมฤทธิ์ อ่อนคำ", + "pmname": "ตุลาการศาลปกครองสูงสุด" + }, + { + "pname": "นางสุมาลี ลิมปโอวาท", + "pmname": "ตุลาการศาลปกครองสูงสุด" + } + ], + "pnameT":"ชื่อ pnameT", + "pmnameT":"ตำแหน่งของ pnameT", + "pmT":"ตุลาการผู้แถลงคดี", + "acc_name":"ชื่อ acc_name" + + }, + "cc": { + "blackyear": "๙๐/๒๕๖๙", + "redyear": "", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙", + "accuser": "นายธีรพล ร่มเริง", + "acc1": "ผู้ฟ้องคดี", + "accused": "รร", + "acc2": "ผู้ถูกฟ้องคดี", + "interpleader": "สมชาย ใจดี", + "acc3": "ผู้ร้องสอด", + "detail1": "ตำแหน่งปลัดอำเภอ (เจ้าพนักงานปกครองชำนาญการพิเศษ) ที่ทำการปกครองอำเภอแม่สาย จังหวัดเชียงราย กรมการปกครอง ได้รับความเดือดร้อนเสียหายจากการที่ผู้ถูกฟ้องคดีที่ ๒ มีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดี ออกจากราชการ กรณีเมื่อครั้งผู้ฟ้องคดีดำรงตำแหน่งปลัดอำเภอ (เจ้าพนักงานปกครอง 5) ที่ทำการปกครองอำเภอพญาเม็งราย จังหวัดเชียงราย ถูกกล่าวหาว่ากระทำการทุจริตโครงการ จัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข้มแข็งให้ชุมชนอำเภอพญาเม็งราย จังหวัด เชียงราย และโครงการส่งเสริมการเกษตรแบบครบวงจร ซึ่งผู้ฟ้องคดีมีอำนาจหน้าที่เป็น คณะกรรมการตรวจรับพัสดุในโครงการดังกล่าว กระทำการจัดทำเอกสารหลักฐานการเบิกจ่ายเงิน อันเป็นเท็จและลงลายมือชื่อตรวจรับพัสดุอันเป็นเท็จ ซึ่งเป็นการไม่ปฏิบัติตามข้อ ๗๑ ของระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ และที่แก้ไขเพิ่มเติม ผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่ 4 ตุลาคม ๒๕๖๒ จึงมีมติชี้มูลความผิดอาญา ฐานเป็นเจ้าพนักงานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่โดยมิชอบ เพื่อให้เกิดความเสียหาย แก่ผู้หนึ่งผู้ใด หรือปฏิบัติหรือละเว้นการปฏิบัติหน้าที่โดยทุจริต ตามมาตรา ๑๕๗ แห่งประมวล กฎหมายอาญา และความผิดทางวินัยอย่างร้ายแรง ฐานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ ราชการโดยมิชอบ เพื่อให้ตนเองหรือผู้อื่นได้ประโยชน์ที่มีควรได้ เป็นการทุจริตต่อหน้าที่ ราชการ ฐานปฏิบัติหน้าที่ราชการโดยจงใจไม่ปฏิบัติตามกฎหมาย ระเบียบของทางราชการ มติคณะรัฐมนตรี หรือนโยบายของรัฐบาล อันเป็นเหตุให้เสียหายแก่ราชการอย่างร้ายแรง และ ฐานกระทำการอื่นใดอันได้ชื่อว่าเป็นผู้ประพฤติชั่วอย่างร้ายแรง ตามมาตรา ๑๘๒ วรรคสาม มาตรา ๘๕ วรรคสอง และมาตรา ๔๘ วรรคสอง แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๓๕ ประกอบมาตรา ๑๓๓ แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๕๑ ผู้ถูกฟ้องคดีที่ ๑ ผู้ถูกฟ้องคดีที่ ๒ จึงได้ส่งรายงาน สำนวนการไต่สวน เอกสารหลักฐาน และคำวินิจฉัยไปยัง ซึ่งเป็นผู้บังคับบัญชาและผู้มีอำนาจบรรจุและแต่งตั้งผู้ฟ้องคดี ผู้ถูกฟ้องคดีที่ ๒ เสนอเรื่องต่อ อ.ก.พ. กระทรวงมหาดไทย ซึ่ง อ.ก.พ. กระทรวงมหาดไทย มีมติในการประชุม ครั้งที่ ๒/๒๕๖๓ เมื่อวันที่ ๑๘ มิถุนายน ๒๕๖๓ ให้ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ ตามฐานความผิดที่ผู้ถูกฟ้องคดีที่ ๑ ชี้มูลความผิด ผู้ถูกฟ้องคดีที่ ๒ จึงมีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ ต่อมา ผู้ฟ้องคดีมีหนังสือลงวันที่ ๑๕ กันยายน ๒๕๖๓ อุทธรณ์คำสั่งดังกล่าวต่อคณะกรรมการพิทักษ์ ที่ ระบบคุณธรรม ต่อมาคณะกรรมการพิทักษ์ระบบคุณธรรมได้มีคำวินิจฉัย เรื่องดำที่ ๖๓๑๐๑๖๖ เรื่องแดงที่ ๐๐๔๘๑๖๕ ลงวันที่ ๕ กรกฎาคม ๒๕๖๕ ให้ยกอุทธรณ์ และมีหนังสือ นร ๑๐๑๐.๓.๑.๔/๒๕ ลงวันที่ 6 กรกฎาคม ๒๕๖๕ แจ้งคำวินิจฉัยดังกล่าวให้ผู้ฟ้องคดีทราบ ผู้ฟ้องคดีไม่เห็นพ้องด้วย เนื่องจากโครงการจัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้าง ความเข็มแข็งให้ชุมชนอำเภอพญาเม็งราย จังหวัดเชียงราย เป็นโครงการที่นายบุญยัง เรือนกูล นายอำเภอพญาเม็งราย ในขณะนั้น ได้ดำเนินการไปก่อนที่ผู้ฟ้องคดีจะได้รับการแต่งตั้ง ให้ดำรงตำแหน่งปลัดอำเภอพญาเม็งราย ครั้นเมื่อผู้ฟ้องคดีได้รับการแต่งตั้งให้ดำรงตำแหน่ง ดังกล่าว นายบุญยังได้ออกคำสั่งให้ผู้ฟ้องคดีปฏิบัติหน้าที่รับผิดชอบงานด้านความมั่นคง ตามคำสั่งอำเภอพญาเม็งราย ที่ ๓๗๒/๒๕๕๗ ลงวันที่ ๓ ธันวาคม ๒๕๔๗ ซึ่งรวมถึงโครงการ จัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข็มแข็งให้ชุมชนอำเภอพญาเม็งรายด้วย ผู้ฟ้องคดีในฐานะผู้ใต้บังคับบัญชาจึงต้องเชื่อฟังและปฏิบัติตามคำสั่งของนายบุญยัง แม้ผู้ฟ้องคดี จะเป็นผู้ลงนามเสนอและเปลี่ยนแปลงโครงการ แต่ผู้ฟ้องคดีไม่มีความเป็นอิสระในการบริหาร โดยอำนาจบริหารอยู่ภายใต้การสั่งการของนายบุญยัง ส่วนโครงการส่งเสริมการเกษต แบบครบวงจรเป็นการบริหารโครงการที่นายบุญยังเป็นผู้ดำเนินการควบคุมสั่งการทุกขั้น จนกระทั่งเสร็จสิ้นโครงการเช่นเดียวกัน เมื่อดำเนินการโครงการดังกล่าวเสร็จสิ้น นายบุญยัง และนางวัลลภาภรณ์ เรือนปาง เสมียนตราอำเภอพญาเม็งรายและกรรมการรับเงินอุดหนุนโครงการ จึงได้รวบรวมเอกสารที่เกี่ยวข้องเสนอผู้ฟ้องคดีให้ลงนามในฐานะคณะกรรมการตรวจรับพัสดุ โดยผู้ฟ้องคดีไม่มีโอกาสได้ปฏิบัติหน้าที่ตามระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ เมื่อนางวัลลภาภรณ์ผู้ตรวจรับพัสดุยืนยันว่าได้ตรวจสอบพัสดุครบถ้วนทุกรายการ และส่งมอบให้ นายบุญยังแจกจ่ายครบถ้วนแล้ว ผู้ฟ้องคดีจึงลงนามตรวจรับพัสดุ จึงเห็นได้ว่า ผู้ฟ้องคดีไม่มี เจตนาทุจริต ข้อเท็จจริงไม่ปรากฏว่าผู้ฟ้องคดีมีทรัพย์สินเพิ่มมากขึ้นผิดปกติ หรือมีการ ได้ประโยชน์ในลักษณะทรัพย์สิน หรือประโยชน์อื่นใดจากการดำเนินโครงการ ผู้ฟ้องคดี ไม่ได้กระทำการทุจริตต่อหน้าที่ อีกทั้ง ผู้ถูกฟ้องคดีที่ ๑ ไม่มีพยานหลักฐานที่สามารถพิสูจน์ โดยปราศจากข้อสงสัยว่าผู้ฟ้องคดีกระทำการทุจริต การที่ผู้ถูกฟ้องคดีที่ ๑ ไต่สวนข้อเท็จจริง และมีมติชี้มูลความผิดจึงเป็นการไต่สวนและชี้มูลความผิดไม่ตรงกับข้อเท็จจริงและเป็นการ พยายามบิดเบือนว่าผู้ฟ้องคดีกระทำความผิดทางวินัยฐานทุจริต ทั้งที่ผู้ฟ้องคดีกระทำความผิด ทางวินัยฐานอื่น มติของผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๑๐๕/๒๕๖๓ เมื่อวันที่ 4 ตุลาคม ๒๕๖๒ ที่ชี้มูลความผิดผู้ฟ้องคดีจึงเป็นมติที่ไม่ชอบด้วยกฎหมาย นอกจากนี้ ผู้ถูกฟ้องคดีที่ ๑ มีอำนาจไต่สวนและชี้มูลความผิดทางวินัยเฉพาะความผิดฐานทุจริตต่อหน้าที่ราชการเท่านั้น เมื่อผู้ฟ้องคดีไม่ได้กระทำความผิดฐานทุจริตต่อหน้าที่ ผู้ถูกฟ้องคดีที่ ๑ จึงไม่มีอำนาจไต่สวน และชี้มูลความผิดผู้ฟ้องคดี และไม่ผูกพันผู้ถูกฟ้องคดีที่ ๒ ให้ต้องถือรายงานการไต่สวนของ ผู้ถูกฟ้องคดีที่ ๑ เป็นรายงานการสอบสวน โดยผู้ถูกฟ้องคดีที่ ๒ ต้องดำเนินการแต่งตั้ง คณะกรรมการสอบสวนความผิดทางวินัยเพื่อสอบสวนข้อเท็จจริง เมื่อผู้ถูกฟ้องคดีที่ ๒ ไม่ได้ แต่งตั้งคณะกรรมการดังกล่าว การที่ผู้ถูกฟ้องคดีที่ ๒ มีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ จึงเป็นการออกคำสั่งโดยไม่ถูกต้อง ตามรูปแบบ ขั้นตอน หรือวิธีการ อันเป็นสาระสำคัญที่กำหนดไว้สำหรับการออกคำสั่งนั้น ผู้ฟ้องคดีจึงนำคดีมาฟ้องต่อศาลปกครองสูงสุดโดยวิธีส่งทางไปรษณีย์ลงทะเบียน เมื่อวันที่ ๓ ตุลาคม ๒๕๖\n\nขอให้ศาลมีคำพิพากษาหรือคำสั่ง ดังนี้ \n\n๑. เพิกถอนมติของผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่ ๘ ตุลาคม ๒๕๖๒ ที่ชี้มูลความผิดของผู้ฟ้องคดี \n\n๒. เพิกถอนคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ที่ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ \n\n๓. ให้แก่ผู้ฟ้องคดี คดี\n\nศาลได้พิจารณาคำฟ้องและคำขอของผู้ฟ้องคดีแล้ว สามารถแปลความได้ว่า ผู้ฟ้องคดีมีความประสงค์จะขอให้ศาลมีคำพิพากษาหรือคำสั่งเพิกถอนคำวินิจฉัยอุทธรณ์ ของคณะกรรมการพิทักษ์ระบบคุณธรรม เรื่องดำที่ ๖๓๑๐๑๖๖ เรื่องแดงที่ ๑๐๔๘๑๖๕ ลงวันที่ ๕ กรกฎาคม ๒๕๖๕ ที่ให้ยกอุทธรณ์ของผู้ฟ้องคดี ศาลจึงมีคำสั่งลงวันที่ ๒๘ กุมภาพันธ์ ๒๕๖๖ เรียกให้คณะกรรมการพิทักษ์ระบบคุณธรรมเข้ามาเป็นผู้ถูกฟ้องคดีที่ ๓ ตาม มาตรา ๔๔ แห่งพระราชบัญญัติจัดตั้งศาลปกครองและวิธีพิจารณาคดีปกครอง พ.ศ. ๒๕๔๒ ประกอบกับข้อ ๗๘ แห่งระเบียบของที่ประชุมใหญ่ตุลาการในศาลปกครองสูงสุด ว่าด้วย วิธีพิจารณาคดีปกครอง พ.ศ. ๒๕๔๓ และมาตรา ๕๗ และมาตรา ๕๘ แห่งประมวลกฎหมาย วิธีพิจารณาความแพ่ง\n\nผู้ถูกฟ้องคดีที่ ๑ ให้การว่า ขณะเกิดเหตุคดีนี้ ผู้ฟ้องคดีดำรงตำแหน่งปลัดอำเภอ (พนักงานปกครอง 5) ที่ทำการปกครองอำเภอพญาเม็งราย จังหวัดเชียงราย มีอำนาจหน้าที่ ช่วยเหลือนายอำเภอในการปฏิบัติราชการให้เป็นไปตามพระราชบัญญัติระเบียบบริหารราชการ แผ่นดิน พ.ศ. ๒๕๓๔ และที่แก้ไขเพิ่มเติม โดยได้รับการแต่งตั้งให้เป็นคณะกรรมการตรวจรับ พัสดุในโครงการส่งเสริมการเกษตรแบบครบวงจรของที่ทำการปกครองอำเภอพญาเม็งราย ปีงบประมาณ พ.ศ. ๒๕๕๗ และได้รับการแต่งตั้งให้เป็นคณะกรรมการตรวจรับงานจ้างในโครงการ จัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข้มแข็งให้ชุมชนในอำเภอพญาเม็งราย จังหวัดเชียงราย งบประมาณปี พ.ศ. ๒๕๕๘ ตามระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ และที่แก้ไขเพิ่มเติม ข้อเท็จจริงปรากฏว่า โครงการจัดทำเวทีประชาคมไม่มีการจัดโครงการ ตามที่มีการจัดซื้อจัดจ้าง และการจัดซื้อวัสดุตามโครงการส่งเสริมการเกษตรไม่ได้รับพัสดุ ครบถ้วนตามที่ได้มีการจัดซื้อ อันเป็นการไม่ปฏิบัติตามข้อ ๗๑ ของระเบียบสำนักนายกรัฐมนตรี ว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ และที่แก้ไขเพิ่มเติม ทำให้เกิดความเสียหายต่อทางราชการ มีมูล ความผิดทางอาญา ตามประมวลกฎหมายอาญา มาตรา ๑๕๗ และมีมูลความผิดทางวินัย อย่างร้ายแรง ตามพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๓๕ มาตรา ๑๒ วรรคสาม มาตรา ๘๕ วรรคสอง และมาตรา ๔๘ วรรคสอง เมื่อผู้ถูกฟ้องคดีที่ ๑ ได้รับเรื่องกล่าวหา จากสำนักงานการตรวจเงินแผ่นดิน และสำนักตรวจสอบพิเศษ ภาค ๘ (จังหวัดเชียงใหม่) เรื่อง การตรวจสอบการใช้จ่ายเงินของที่ทำการปกครองอำเภอพญาเม็งราย จังหวัดเชียงราย จึงมีมติ แต่งตั้งคณะกรรมการไต่สวนเพื่อดำเนินการไต่สวน ซึ่งคณะกรรมการไต่สวนได้ไต่สวน ข้อเท็จจริงและรวบรวมพยานหลักฐานแล้วเห็นว่าพยานหลักฐานเพียงพอพิสูจน์ได้ว่าผู้ฟ้องคดี กระทำความผิดตามข้อกล่าวหา จึงแจ้งข้อกล่าวหากับผู้ฟ้องคดี ผู้ฟ้องคดีรับทราบข้อกล่าวหา และมีหนังสือชี้แจงแก้ข้อกล่าวหาแล้ว ผู้ถูกฟ้องคดีที่ ๑ พิจารณาข้อเท็จจริงพร้อมพยานหลักฐาน\n\nตามสำนวนการไต่สวนของคณะกรรมการไต่สวนในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่ ๘ ตุลาคม ๒๕๖๒ แล้วมีมติว่า การกระทำของผู้ฟ้องคดีมีมูลความผิดทางอาญา ตามประมวลกฎหมายอาญา มาตรา ๑๕๗ และมีมูลความผิดทางวินัยอย่างร้ายแรง ฐานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ราชการ โดยมิชอบ เพื่อให้ตนเองหรือผู้อื่นได้ประโยชน์ที่มีควรได้ เป็นการทุจริตต่อหน้าที่ราชการ ฐานปฏิบัติหน้าที่ราชการโดยจงใจไม่ปฏิบัติตามกฎหมาย ระเบียบของทางราชการ มติคณะรัฐมนตรี หรือนโยบายของรัฐบาล อันเป็นเหตุให้เสียหายแก่ราชการอย่างร้ายแรง และฐานกระทำการอื่นใด อันได้ชื่อว่าเป็นผู้ประพฤติชั่วอย่างร้ายแรง ตามพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๓๕ มาตรา ๒ วรรคสาม มาตรา ๕๕ วรรคสอง และมาตรา ๔๘ วรรคสอง เมื่อผู้ถูกฟ้องคดีที่ ๑ ไต่สวนแล้วมีมติว่าผู้ฟ้องคดีกระทำความผิดฐานทุจริตต่อหน้าที่ หรือกระทำความผิดต่อตำแหน่ง หน้าที่ราชการ อันเป็นความผิดมูลฐานตามที่รัฐธรรมนูญกำหนดไว้แล้ว ผู้ถูกฟ้องคดีที่ ๑ จึงมี อำนาจชี้มูลความผิดทางวินัยผู้ฟ้องคดีฐานอื่นซึ่งเป็นความผิดที่เกี่ยวข้องกันได้ ตามบทบัญญัติ มาตรา ๑๙ (๔) ประกอบมาตรา ๘๔ แห่งพระราชบัญญัติประกอบรัฐธรรมนูญว่าด้วยการป้องกัน และปราบปรามการทุจริต พ.ศ. ๒๕๔๒ และที่แก้ไขเพิ่มเติม ดังนั้น การไต่สวนข้อเท็จจริง มติชี้มูลความผิด และคำวินิจฉัยของผู้ถูกฟ้องคดีที่ ๑ ตลอดจนการที่ผู้ถูกฟ้องคดีที่ ๑ ชี้มูล ความผิดทางวินัยและส่งเรื่องให้ผู้ถูกฟ้องคดีที่ ๒ ซึ่งผู้บังคับบัญชาของผู้ฟ้องคดีดำเนินการ ทางวินัย จึงเป็นการดำเนินการตามขั้นตอนที่กฎหมายและระเบียบกำหนดไว้แล้ว และมีผล ผูกพันผู้ถูกฟ้องคดีที่ ๒ ซึ่งเป็นผู้บังคับบัญชาของผู้ฟ้องคดีในการพิจารณาโทษทางวินัยตามมติ ของผู้ถูกฟ้องคดีที่ ๑ การที่ผู้ถูกฟ้องคดีที่ ๒ มีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดีออกจากราชการตามฐานความผิดที่ผู้ถูกฟ้องคดีที่ ๑ ได้มีมติจึงชอบด้วยกฎหมายแล้ว นอกจากนี้ อัยการสูงสุดได้ยื่นฟ้องผู้ฟ้องคดีเป็นจำเลยที่ ๒ ต่อศาลอาญาคดีทุจริตและประพฤติมิชอบภาค ๕ ในคดีหมายเลขดำที่ อท ๑๓๕, ๑๓๖/๒๕๖๒ คดีหมายเลขแดงที่ อท ๗๘, ๗๙/๒๕๖๓ ซึ่งศาลอาญาคดีทุจริตและประพฤติมิชอบภาค ๕ ได้วินิจฉัยว่า โครงการจัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข้มแข็งให้ชุมชน อำเภอ พญาเม็งราย จังหวัดเชียงราย ผู้ฟ้องคดีในฐานะประธานกรรมการตรวจการจ้างและตรวจรับพัสดุ ได้ลงนามรับรองเป็นหลักฐานว่า มีการส่งมอบการจ้างและพัสดุต่างๆ ถูกต้องครบถ้วน และยังสั่งการ ให้คณะกรรมการตรวจการจ้างและตรวจรับพัสดุคนอื่นที่เป็นสมาชิกอาสารักษาดินแดน ซึ่งเป็น ผู้ใต้บังคับบัญชาโดยตรงของผู้ฟ้องคดี ลงนามในเอกสารเพื่อใช้เป็นหลักฐานในการเบิกจ่ายเงิน ของทางราชการ ทั้งที่ข้อเท็จจริงไม่มีการจัดโครงการและไม่มีการตรวจการจ้างและตรวจรับพัสดุ ตามที่มีการเบิกจ่ายแต่อย่างใด และในส่วนของโครงการส่งเสริมการเกษตรแบบครบวงจร ผู้ฟ้องคดี มีเจตนาร่วมกับนายบุญยัง เรือนกูล ในการทำเอกสารหลักฐานการเบิกจ่ายอันเป็นเท็จ เนื่องจากไม่ปฏิบัติตามระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ และที่แก้ไขเพิ่มเติม การกระทำของผู้ฟ้องคดีจึงเป็นความผิด ฐานเป็นเจ้าพนักงานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ โดยมิชอบ เพื่อให้เกิดความเสียหายแก่ผู้หนึ่งผู้ใด หรือปฏิบัติหรือละเว้นการปฏิบัติหน้าที่โดยทุจริต พิพากษาจำคุกผู้ฟ้องคดี 5 ปี\n\nผู้ถูกฟ้องคดีที่ ๒ ให้การในทำนองเดียวกับคำให้การของผู้ถูกฟ้องคดีที่ ๑ และ เพิ่มเติมว่า มูลเหตุคดีนี้เกิดจากอำเภอพญาเม็งรายได้จัดทำโครงการจัดทำเวทีประชาคม หมู่บ้านเพื่อเสริมสร้างความเข้มแข็งให้ชุมชนอำเภอพญาเม็งราย ปีงบประมาณ พ.ศ. ๒๕๕๘ เพื่อให้ ราษฎรมีส่วนร่วมในการป้องกันและเฝ้าระวังปัญหายาเสพติดในพื้นที่ ๕ ตำบล ๖๙ หมู่บ้าน ระยะเวลาดำเนินการตั้งแต่วันที่ ๑๕ ธันวาคม ๒๕๕๗ ถึงวันที่ ๓๑ มกราคม ๒๕๔๘ ได้รับการ สนับสนุนงบประมาณจากองค์การบริหารส่วนตำบล จำนวน ๕ แห่ง แห่งละ ๑๐,๐๐๐ บาท และเทศบาลตำบลพญาเม็งราย ๒๐,๐๐๐ บาท รวมเป็นเงิน ๗๐,๐๐๐ บาท โดยมีผู้ฟ้องคดี เป็นผู้เสนอโครงการ โดยผ่านการเห็นชอบจากนายประจญ ปรัชญ์สกุล ปลัดอำเภอหัวหน้าฝ่าย บริหารงานปกครอง และได้รับอนุมัติโครงการจากนายบุญยัง เรือนกูล นายอำเภอพญาเม็งราย และอำเภอพญาเม็งรายได้มีคำสั่ง ที่ ๓๙๖/๒๕๕๗ ลงวันที่ ๒๗ ธันวาคม ๒๕๕๗ แต่งตั้ง ดังกล่าว นางวัลลภาภรณ์ เรือนปาง เสมียนตราอำเภอพญาเม็งราย เป็นกรรมการรับเงินอุดหนุนโครงการ ต่อมา ผู้ฟ้องคดีได้เสนอขออนุมัติเปลี่ยนแปลงกำหนดการจัดทำโครงการการจัดทำเวที ประชาคมหมู่บ้าน โดยให้จัดประชุมให้แล้วเสร็จภายในวันที่ ๑๙ มกราคม ๒๕๕๘ ณ หอประชุม พญาเม็งราย ดังนี้ หมู่ที่ ๑ ๒๐ ตำบลแม่เปา วันที่ ๑๗ มกราคม ๒๕๔๗ หมู่ที่ ๑ - ๑๔ ตำบล เม็งราย วันที่ ๑๘ มกราคม ๒๕๕๗ หมู่ที่ ๑ ๑๑ ตำบลแม่ต่ำ วันที่ ๑๘ มกราคม ๒๕๕๗ หมู่ที่ ๑- ๑๘ ตำบลไม้ยา วันที่ ๑๙ มกราคม ๒๕๕๗ และหมู่ที่ ๑ ๘ ตำบลตาดควัน วันที่ ๑๙ มกราคม ๒๕๔๗ นายบุญยัง ได้ลงนามอนุมัติท้ายบันทึกดังกล่าว และมีผู้ฟ้องคดี นายพัฒน์ อินถา และนายทัศน์ ถาแก้ว เป็นคณะกรรมการตรวจรับพัสดุการดำเนินการจัดซื้อจัดจ้าง จำนวน ๓ รายการ ดังนี้ (๑) วัสดุแบบพิมพ์อบรมสร้างความเข้มแข็งให้ชุมชน และกระดาษถ่ายเอกสารจำนวน ๑๐ รีม รีมละ ๑๐๐ บาท เป็นเงิน ๑,๐๐๐ บาท จากการตรวจสอบข้อเท็จจริงพบว่า โครงการจัดทำเวที ประชาคมหมู่บ้านฯ ไม่มีการจัดเตรียมเอกสารหรือแจกจ่ายเอกสาร จึงไม่ได้มีการใช้วัสดุที่จัดซื้อ ให้เป็นไปตามวัตถุประสงค์ของโครงการ (๒) จ้างเหมาจัดทำอาหาร/อาหารว่าง เครื่องดื่ม ให้ผู้เข้าอบรมโครงการการจัดทำเวทีประชาคมหมู่บ้านฯ กับนายสว่าง วรรณสอน สมาชิก กองอาสารักษาดินแดน จากการตรวจสอบข้อเท็จจริงพบว่าไม่มีการจ้างนายสว่าง ผู้รับจ้าง ทำอาหารจริง และนายสว่างไม่มีอาชีพในการทำอาหาร ทั้งปรากฏหลักฐานการเบิกจ่ายซึ่งไม่มี รายละเอียดในการจัดหาอาหารในแต่ละวัน จำนวนอาหารในแต่ละวันมีความเหมาะสมกับราคาหรือไม่ เป็นการยากต่อการดำเนินการตรวจรับว่ามีการจัดจ้างตรงตามใบสั่งจ้างหรือไม่ (๓) จ้างเหมา จัดสถานที่และเช่าเครื่องเสียงจัดทำเวทีประชาคมฯ จำนวน ๓๐,๐๐๐ บาท กับนายสุวนันท์ ไชยานันตา สมาชิกกองอาสารักษาดินแดน จากการตรวจสอบข้อเท็จจริงพบว่า นายสุวนันท์ไม่มีอาชีพในการ จัดสถานที่หรือมีเครื่องเสียงให้เช่า ไม่มีการจ้างเหมาจัดสถานที่และเช่าเครื่องเสียง ไม่มีการ จ่ายเงินให้กับนายสุวนันท์จริง และเอกสารมีการดำเนินการไม่ถูกต้อง เช่น ใบส่งมอบงานระบุ วันที่ ๑๙ มกราคม ๒๕๕๙ และใบสำคัญรับเงินไม่ระบุวันที่ มกราคม ๒๕๕๐ เป็นต้น ส่วนที่ อำเภอพญาเม็งรายได้จัดทำโครงการจ่ายเงินอุดหนุนและการจัดซื้อวัสดุโครงการส่งเสริมเกษตร แบบครบวงจร จำนวน ๓๘๔,๐๐๐ บาท จากการตรวจสอบเอกสารปีงบประมาณ พ.ศ. ๒๕๔๗ ๒๕๔๘ พบว่า มีการจัดซื้อโดยแบ่งการจัดซื้อจำนวน 5 ครั้ง โดยแยกบันทึกเป็นแต่ละหมู่บ้านจำนวน 5 หมู่บ้าน ครั้งละ ๑๑ รายการ วงเงินจัดซื้อหมู่บ้านละ ๖๔,๐๐๐ บาท ตามใบสั่งซื้อเลขที่ ๗/๒๕๔๘ - ๑๒/๒๕๕๘ ลงวันที่ ๑๔ กุมภาพันธ์ ๒๕๕๘ รายการที่จัดซื้อประกอบด้วย (๑) เครื่องสกัดยาฆ่าแมลง (๒) เครื่องบดดิน (๓) ถังพ่นยา (๔) ถั่วฝักยาว (๕) ผักบุ้งจีน (๖) แตงกวา (๓) คะน้า (๘) กวางตุ้ง (๔) ผักชี (๑๐) ผักขึ้นฉ่าย ผักข (๑๑) บวบเหลี่ยม รวมเป็นเงินทั้งสิ้น ๓๘๔,๐๐๐ บาท เป็นรายการจัดซื้อวัสดุจากนายธนกร ไชยวรรณ์ โดยจัดซื้อในวิธีตกลงราคาให้กับ เกษตรกรในพื้นที่อำเภอพญาเม็งรายใน 5 หมู่บ้าน มีผู้ฟ้องคดี นายพัฒน์ อินถา และนายทัศน์ ถาแก้ว เป็นคณะกรรมการตรวจรับพัสดุ ซึ่งคณะกรรมการตรวจรับพัสดุได้ลงลายมือชื่อในใบตรวจรับ โดยเห็นว่ามีปริมาณและคุณภาพถูกต้อง พร้อมส่งมอบให้กับเจ้าหน้าที่พัสดุแล้ว แต่จากการ ตรวจสอบข้อเท็จจริงพบว่าโครงการส่งเสริมการเกษตรแบบครบวงจรไม่มีการจัดทำโครงการที่ระบุ รายละเอียดของวัตถุประสงค์ กลุ่มเป้าหมาย ผลที่ได้รับจากโครงการอันไม่มีจุดประสงค์ในการ ใช้งบประมาณ และในการขอซื้อวัสดุอุปกรณ์ในรายงานการขอซื้อ ไม่มีที่มาของราคาของวัสดุ และมีการจัดวัสดุชนิดเดียวกัน1 ๑๑ ๑๑ รายการ แยกเป็น 5 ครั้ง ในวันเดียวกัน อันทำให้อำนาจ ในการสั่งซื้อเปลี่ยนไปเป็นการแบ่งซื้อตามข้อ ๒๒ วรรคสอง ของระเบียบสำนักนายกรัฐมนตรี ว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ และที่แก้ไขเพิ่มเติม อีกทั้ง เมื่อตรวจสอบสำเนาเอกสารบัญชี รับพัสดุของที่ทำการปกครองอำเภอพญาเม็งราย ผู้ลงลายมือชื่อรับพัสดุแจ้งว่าลงลายมือชื่อตามที่ ที่ทำการปกครองอำเภอพญาเม็งรายให้ลงลายมือชื่อโดยไม่ได้ตรวจสอบ และบางรายยืนยันว่าไม่ใช่ ลายมือชื่อของตนและยืนยันว่าได้รับเฉพาะเครื่องสกัดยาฆ่าแมลงและเครื่องบดดิน ส่วนรายการอื่นๆ ไม่ได้รับ \n\nเมื่อผู้ถูกฟ้องคดีที่ ๑ ได้รับเรื่องกล่าวหา พิจารณาพฤติการณ์แห่งการกระทำ ความผิด และมีมติชี้มูลความผิดทางวินัยผู้ฟ้องคดีแล้ว จึงส่งรายงานสำนวนการสอบสวน เอกสารหลักฐาน พร้อมทั้งคำวินิจฉัยมายังผู้ถูกฟ้องคดีที่ ๒ ซึ่งเป็นผู้บังคับบัญชาของผู้ฟ้องคดี\n\nเพื่อพิจารณาโทษทางวินัยตามฐานความผิดที่ผู้ถูกฟ้องคดีที่ ๑ ได้มีมติ โดยไม่ต้องแต่งตั้ง คณะกรรมการสอบสวนวินัยอีก และให้ถือว่าสำนวนการไต่สวนของผู้ถูกฟ้องคดีที่ ๑ เป็นสำนวน การสอบสวนทางวินัยของคณะกรรมการสอบสวนวินัย ตามมาตรา ๔๘ แห่งพระราชบัญญัติ ขั้นตอน ประกอบรัฐธรรมนูญว่าด้วยการป้องกันและปราบปรามการทุจริต พ.ศ. ๒๕๖๑ การที่ผู้ถูกฟ้องคดีที่ ๒ มีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดี ออกจากราชการตามฐานความผิดที่ผู้ถูกฟ้องคดีที่ ๑ มีมติ เป็นการลงโทษตามแนวการลงโทษ ตามมติคณะรัฐมนตรี และระดับโทษเหมาะสมแก่กรณีกระทำผิดแล้ว โดยที่การพิจารณาโทษ ทางวินัยกับผู้ฟ้องคดีนั้น ผู้ถูกฟ้องคดีที่ ๒ ได้รับฟังข้อเท็จจริงถูกต้องตามหลักเกณฑ์ รูปแบบ หรือวิธีการอันเป็นสาระสำคัญเกี่ยวกับการลงโทษทางวินัยอย่างร้ายแรงตามที่กฎหมาย กำหนด แต่ผู้ถูกฟ้องคดีที่ ๒ ไม่สามารถวินิจฉัยกระบวนการไต่สวนหรือมติ มูลของผู้ถูกฟ้องคดีที่ ๑ เป็นอย่างอื่นได้ เนื่องจากสำนวนการไต่สวนของผู้ถูกฟ้องคดีที่ ๑ มีผลผูกพันผู้ถูกฟ้องคดีที่ ๒ ที่จะต้องพิจารณาโทษทางวินัยตามฐานความผิดที่ผู้ถูกฟ้องคดีที่ ๑ มีมติ ซึ่งผู้ถูกฟ้องคดีที่ ๒ ได้ดำเนินการตามหลักเกณฑ์ รูปแบบ ขั้นตอน หรือวิธีการอันเป็นสาระสำคัญถูกต้องตามที่ กฎหมายกำหนดแล้ว ดังนั้น คำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ จึงเป็นคำสั่งที่ชอบด้วยกฎหมาย ไม่มีเหตุที่จะให้ ผู้ฟ้องคดีกลับเข้ารับราชการและคืนสิทธิประโยชน์ให้แก่ผู้ฟ้องคดีแต่อย่างใด\n\nผู้ถูกฟ้องคดีที่ ๓ ให้การในทำนองเดียวกับคำให้การของผู้ถูกฟ้องคดีที่ ๑ และ ผู้ถูกฟ้องคดีที่ ๓ ขอยืนยันตามวินิจฉัยของผู้ถูกฟ้องคดีที่ ๓ เรื่องคำที่ ผู้ถูกฟ้องคดีที่ ๒ และเพิ่มเติมว่า ๖๓๑๐๑๖๖ เรื่องแดงที่ ๑๐๔๘๑๖๕ ลงวันที่ ๕ กรกฎาคม ๒๕๖๕ ซึ่งผู้ถูกฟ้องคดีที่ ๓ ได้วินิจฉัยอุทธรณ์ของผู้ฟ้องคดีตามอำนาจหน้าที่ที่กฎหมายกำหนด และได้พิจารณาข้อเท็จจริง ตามพยานหลักฐานที่ปรากฏอย่างละเอียดรอบคอบ ปราศจากอคติ และให้ความเป็นธรรม แก่ผู้ฟ้องคดี ตามหลักเกณฑ์และวิธีการที่กฎ ก.พ.ค. ว่าด้วยการอุทธรณ์และการพิจารณา วินิจฉัยอุทธรณ์ พ.ศ. ๒๕๕๑ แล้ว ดังนั้น การที่ผู้ถูกฟ้องคดีที่ ๓ มีคำวินิจฉัยยกอุทธรณ์ของผู้ฟ้องคดี จึงเป็นการกระทำที่ถูกต้องและชอบด้วยกฎหมายแล้ว\n\nศาลปกครองสูงสุดออกนั่งพิจารณาคดีครั้งแรกเมื่อวันที่ 4 มีนาคม ๒๕๖๙ โดยได้รับฟังสรุปข้อเท็จจริงของตุลาการเจ้าของสำนวน พิจารณาคำชี้แจงด้วยวาจาประกอบ คำแถลงการณ์เป็นหนังสือของตุลาการผู้แถลงคดี\n\nศาลปกครองสูงสุดได้ตรวจพิจารณาพยานหลักฐานในคำฟ้อง คำให้การ คำคัดค้านคำให้การ คำให้การเพิ่มเติม แล้ว\n\nข้อเท็จจริงรับฟังได้ว่า เดิมผู้ฟ้องคดีรับราชการเป็นข้าราชการพลเรือนสามัญ ตำแหน่งปลัดอำเภอ (เจ้าพนักงานปกครองชำนาญการพิเศษ) ที่ทำการปกครองอำเภอแม่สาย จังหวัดเชียงราย กรมการปกครอง ได้รับความเดือดร้อนเสียหายจากการที่ผู้ถูกฟ้องคดีที่ ๒ มีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดี ออกจากราชการ ตั้งแต่วันที่ ๒๓ พฤษภาคม ๒๕๖๓ เป็นต้นไป กรณีเมื่อครั้งผู้ฟ้องคดีดำรงตำแหน่ง ปลัดอำเภอ (เจ้าพนักงานปกครอง 5) ที่ทำการปกครองอำเภอพญาเม็งราย จังหวัดเชียงราย ถูกกล่าวหาว่ากระทำการทุจริตโครงการส่งเสริมการเกษตรแบบครบวงจร และโครงการจัดทำ เวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข้มแข็งให้ชุมชนอำเภอพญาเม็งราย จังหวัดเชียงราย ซึ่งผู้ฟ้องคดีมีอำนาจหน้าที่เป็นคณะกรรมการตรวจรับพัสดุในโครงการดังกล่าว กระทำการ จัดทำเอกสารหลักฐานการเบิกจ่ายเงินอันเป็นเท็จและลงลายมือชื่อตรวจรับพัสดุอันเป็นเท็จ ซึ่งเป็นการไม่ปฏิบัติตามข้อ ๗๑ ของระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ และที่แก้ไขเพิ่มเติม ผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่4 ตุลาคม ๒๕๖๒ จึงมีมติชี้มูลความผิดอาญา ฐานเป็นเจ้าพนักงานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ โดยมิชอบ เพื่อให้เกิดความเสียหายแก่ผู้หนึ่งผู้ใด หรือปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ โดยทุจริต ตามมาตรา ๑๕๗ แห่งประมวลกฎหมายอาญา และความผิดทางวินัยอย่างร้ายแรง ฐานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ราชการโดยมิชอบ เพื่อให้ตนเองหรือผู้อื่นได้ประโยชน์ ที่มีควรได้ เป็นการทุจริตต่อหน้าที่ราชการ ฐานปฏิบัติหน้าที่ราชการโดยจงใจไม่ปฏิบัติตาม กฎหมาย ระเบียบของทางราชการ มติคณะรัฐมนตรี หรือนโยบายของรัฐบาล อันเป็นเหตุให้ เสียหายแก่ราชการอย่างร้ายแรง และฐานกระทำการอื่นใดอันได้ชื่อว่าเป็นผู้ประพฤติชั่วอย่างร้ายแรง ตามมาตรา ๘๒ วรรคสาม มาตรา ๘๕ วรรคสอง และมาตรา ๙๘ วรรคสอง แห่งพระราชบัญญัติ ระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๓๕ ประกอบมาตรา ๑๓๓ แห่งพระราชบัญญัติระเบียบ ข้าราชการพลเรือน พ.ศ. ๒๕๕๑ ผู้ถูกฟ้องคดีที่ ๑ จึงมีหนังสือสำนักงาน ป.ป.ช. ที่ ปช ๐๑.๐๑ (ชร) ๑๔๔๒ ลงวันที่ 6 พฤศจิกายน ๒๕๖๒ ส่งรายงาน สำนวนการไต่สวน เอกสารหลักฐาน และคำวินิจฉัย ซึ่งเป็นผู้บังคับบัญชาและผู้มีอำนาจบรรจุและแต่งตั้งผู้ฟ้องคดี ไปยังผู้ถูกฟ้องคดีที่ ๒ ตามมาตรา ๕๗ (๔) แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๕๑ ผู้ถูกฟ้องคดีที่ ๒ เสนอเรื่องให้ อ.ก.พ. กระทรวงมหาดไทย พิจารณา ซึ่ง อ.ก.พ. กระทรวงมหาดไทย มีมติในการประชุม ครั้งที่ ๒/๒๕๖๓ เมื่อวันที่ ๑๘ มิถุนายน ๒๕๖๓ ให้ลงโทษไล่ผู้ฟ้องคดีออกจากราชการตามฐาน ความผิดที่ผู้ถูกฟ้องคดีที่ ๑ ชี้มูลความผิด และตามมติคณะรัฐมนตรี เมื่อวันที่ ๒๑ ธันวาคม ๒๕๓๖ แจ้งตามหนังสือสำนักเลขาธิการคณะรัฐมนตรี ที่ นร ๐๒๐๕/ว ๒๓๔ ลงวันที่ ๒๔ ธันวาคม ๒๕๓๖ ผู้ถูกฟ้องคดีที่ ๒ จึงมีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม\n\n๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ ตั้งแต่วันที่ ๒๓ พฤษภาคม ๒๕๖๓ เป็นต้นไป ซึ่งเป็นวันที่ผู้ฟ้องคดีถูกพักราชการไว้ก่อน ต่อมา ผู้ฟ้องคดีมีหนังสือลงวันที่ ๑๕ กันยายน ๒๕๖๓ อุทธรณ์คำสั่งดังกล่าวต่อผู้ถูกฟ้องคดีที่ ๓ ผู้ถูกฟ้องคดีที่ ๓ พิจารณาแล้วจึงมีคำวินิจฉัย เรื่องดำที่ ผู้ฟ้องคดี ๖๓๑๐๑๖๖ เรื่องแดงที่ ๐๐๔๘๑๖๕ ลงวันที่ ๕ กรกฎาคม ๒๕๖๕ ให้ยกอุทธรณ์ และมีหนังสือ ที่ นร ๑๐๑๐.๓.๑.๔/๒๕ ลงวันที่ 4 กรกฎาคม ๒๕๖๕ แจ้งคำวินิจฉัยดังกล่าว ให้ผู้ฟ้องคดีทราบ ผู้ฟ้องคดีไม่เห็นพ้องด้วย เนื่องจากผู้ฟ้องคดีปฏิบัติตามคำสั่งของผู้บังคับบัญชา ไม่มีเจตนาทุจริต ไม่มีพยานหลักฐานว่าผู้ฟ้องคดีทุจริต ผู้ถูกฟ้องคดีที่ ๑ จึงไม่มีอำนาจชี้มูล จึงนำคดีมาฟ้องต่อศาลปกครองสูงสุด\n\nศาลปกครองสูงสุดได้ตรวจพิจารณากฎหมาย ระเบียบ และข้อบังคับที่เกี่ยวข้อง ประกอบด้วยแล้ว\n\nคดีมีประเด็นที่จะต้องวินิจฉัยว่า คำวินิจฉัยเรื่องดำที่ ๖๓๑๐๑๖๖ เรื่องแดง ที่ ๑๐๔๘๑๖๕ ลงวันที่ ๕ กรกฎาคม ๒๕๖๕ ให้ยกอุทธรณ์ของผู้ฟ้องคดี เป็นการกระทำการ โดยชอบด้วยกฎหมายหรือไม่ โดยคดีมีปัญหาต้องวินิจฉัยก่อนว่า คำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ที่ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ ตามมติ ของผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่ 6 ตุลาคม ๒๕๖๒ เป็นการ กระทำโดยถูกต้องตามรูปแบบขั้นตอน หรือวิธีการอันเป็นสาระสำคัญที่กำหนดไว้สำหรับ การกระทำนั้นหรือไม\n\nพิเคราะห์แล้วเห็นว่า พระราชบัญญัติประกอบรัฐธรรมนูญว่าด้วยการป้องกัน และปราบปรามการทุจริต พ.ศ. ๒๕๖๑ มาตรา ๔ บัญญัติว่า “เจ้าหน้าที่ของรัฐ” หมายความว่า ข้าราชการหรือพนักงานส่วนท้องถิ่นซึ่งมีตำแหน่งหรือเงินเดือนประจำ ผู้ปฏิบัติงานในหน่วยงาน ของรัฐหรือในรัฐวิสาหกิจ ผู้บริหารท้องถิ่น รองผู้บริหารท้องถิ่น ผู้ช่วยผู้บริหารท้องถิ่น และ สมาชิกสภาท้องถิ่นขององค์กรปกครองส่วนท้องถิ่น เจ้าพนักงานตามกฎหมายว่าด้วยลักษณะ ปกครองท้องที่ หรือเจ้าพนักงานอื่นตามที่กฎหมายบัญญัติ และให้หมายความรวมถึงกรรมการ อนุกรรมการ ลูกจ้างของส่วนราชการ หน่วยงานของรัฐ หรือรัฐวิสาหกิจ และบุคคลหรือคณะบุคคล บรรดาซึ่งมีกฎหมายกำหนดให้ใช้อำนาจหรือได้รับมอบให้ใช้อำนาจทางปกครองที่จัดตั้งขึ้น ในระบบราชการ รัฐวิสาหกิจ หรือกิจการอื่นของรัฐด้วย แต่ไม่รวมถึงผู้ดำรงตำแหน่งทางการเมือง ตุลาการศาลรัฐธรรมนูญ ผู้ดำรงตำแหน่งในองค์กรอิสระ และคณะกรรมการ ป.ป.ช. มาตรา ๔๘ วรรคหนึ่ง บัญญัติว่า เมื่อความปรากฏต่อคณะกรรมการ ป.ป.ช. ไม่ว่าจะมีการกล่าวหาหรือไม่ ว่ามีการกระทำความผิดที่อยู่ในหน้าที่และอำนาจของคณะกรรมการ ป.ป.ช. ให้คณะกรรมการ ป.ป.ช. ดำเนินการตามหน้าที่และอำนาจโดยพลัน โดยในกรณีที่จำเป็นต้องมีการไต่สวน ต้องไต่สวน\n\nและมีความเห็นหรือวินิจฉัยให้แล้วเสร็จภายในกำหนดเวลาที่คณะกรรมการ ป.ป.ช. กำหนด ซึ่งต้องไม่เกินสองปีนับแต่วันเริ่มดำเนินการไต่สวน มาตรา ๔๑ บัญญัติว่า เมื่อคณะกรรมการ ป.ป.ช. ไต่สวนแล้วมีมติวินิจฉัยว่าเจ้าหน้าที่ของรัฐกระทำความผิดฐานทุจริตต่อหน้าที่ หรือ กระทำความผิดต่อตำแหน่งหน้าที่ราชการ หรือความผิดต่อตำแหน่งหน้าที่ในการยุติธรรม หรือ ความผิดที่เกี่ยวข้องกันให้ดำเนินการดังต่อไปนี้.. (๒) ถ้ามีมูลความผิดทางวินัย ให้คณะกรรมการ ป.ป.ช. ส่งรายงาน สำนวนการไต่สวน เอกสารหลักฐาน และคำวินิจฉัยไปยังผู้บังคับบัญชาหรือผู้มีอำนาจ แต่งตั้งถอดถอนภายในสามสิบวันเพื่อให้ดำเนินการทางวินัยต่อไป มาตรา ๔๘ วรรคหนึ่ง บัญญัติว่า เมื่อผู้บังคับบัญชาหรือผู้มีอำนาจแต่งตั้งถอดถอนผู้ถูกกล่าวหาได้รับสำนวนการไต่สวน ของคณะกรรมการ ป.ป.ช. ตามมาตรา ๑ แล้ว ให้ผู้บังคับบัญชาหรือผู้มีอำนาจแต่งตั้งถอดถอน ผู้ถูกกล่าวหาผู้นั้นพิจารณาโทษทางวินัยตามฐานความผิดที่คณะกรรมการ ป.ป.ช. ได้มีมติโดยไม่ต้อง แต่งตั้งคณะกรรมการสอบสวนวินัยอีก โดยในการพิจารณาโทษทางวินัยแก่ผู้ถูกกล่าวหา ให้ถือว่า สำนวนการไต่สวนของคณะกรรมการ ป.ป.ช. เป็นสำนวนการสอบสวนทางวินัยของคณะกรรมการ สอบสวนวินัยตามกฎหมาย ระเบียบ หรือข้อบังคับว่าด้วยการบริหารงานบุคคลของผู้ถูกกล่าวหานั้น แล้วแต่กรณี\n\nจากบทบัญญัติแห่งกฎหมายดังกล่าว การที่ผู้ถูกฟ้องคดีที่ ๑ จะใช้อำนาจในการ ไต่สวนและวินิจฉัยชี้มูลความผิดที่เกี่ยวข้องกันตามกฎหมายว่าด้วยการป้องกันและปราบปราม การทุจริตได้จะต้องเป็นกรณีที่เจ้าหน้าที่ของรัฐกระทำความผิดฐานทุจริตต่อหน้าที่ หรือกระทำ ความผิดต่อตำแหน่งหน้าที่ราชการ หรือความผิดต่อตำแหน่งหน้าที่ในการยุติธรรมเสียก่อน หากมีความผิดอื่นที่เกี่ยวข้องกับความผิดมูลฐานดังกล่าว ผู้ถูกฟ้องคดีที่ ๑ จึงจะมีอำนาจชี้มูล ความผิดทางวินัยอันเป็นความผิดที่เกี่ยวข้องกันได้ ข้อเท็จจริงปรากฏว่า เมื่อสำนักงานการ ดังกล่าว ตรวจเงินแผ่นดิน โดยสำนักตรวจสอบพิเศษ ภาค ๘ มีหนังสือ ที่ ตผ ๐๐๕๐ ชม/๐๐๑ ลงวันที่ ๙ มกราคม ๒๕๖๐ ถึงผู้ถูกฟ้องคดีที่ ๑ เรื่อง การตรวจสอบการใช้จ่ายเงินที่ได้รับอุดหนุน ของที่ทำการปกครองอำเภอพญาเม็งราย จังหวัดเชียงราย ผู้ถูกฟ้องคดีที่ ๑ ได้รับเรื่องกล่าวหา และมีมติในการประชุมครั้งที่ ๑๐๐๙ - ๘๐/๒๕๖๑ เมื่อวันที่ 4 กันยายน ๒๕๖๑ แต่งตั้งคณะกรรมการไต่สวนเพื่อดำเนินการไต่สวน ตามมาตรา ๕๑ แห่งพระราชบัญญัติ ประกอบรัฐธรรมนูญว่าด้วยการป้องกันและปราบปรามการทุจริต พ.ศ. ๒๕๖๑ คณะกรรมการไต่สวน ได้แจ้งข้อกล่าวหาให้ผู้ฟ้องคดีทราบ ผู้ฟ้องคดีรับทราบข้อกล่าวหาและเข้าใจข้อกล่าวหา ตลอดจน ได้ชี้แจงแก้ข้อกล่าวหา ซึ่งคณะกรรมการไต่สวนได้รวบรวมข้อเท็จจริงและพยานหลักฐาน ทั้งหมดแล้วเห็นว่ามีพยานหลักฐานเพียงพอที่จะสนับสนุนข้อกล่าวหา จึงได้จัดทำรายงานและ สำนวนไต่สวนพร้อมทั้งทำความเห็นเสนอต่อผู้ถูกฟ้องคดีที่ ๑ ผู้ถูกฟ้องคดีที่ ๑ พิจารณาแล้ว\n\nมีมติในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่ ๘ ตุลาคม ๒๕๖๒ ว่า การกระทำของผู้ฟ้องคดี มีมูลความผิดทางอาญา ตามมาตรา ๑๕๗ แห่งประมวลกฎหมายอาญา และความผิดทางวินัย อย่างร้ายแรง ฐานปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ราชการโดยมิชอบ เพื่อให้ตนเองหรือผู้อื่น ได้ประโยชน์ที่มีควรได้ เป็นการทุจริตต่อหน้าที่ราชการ ฐานปฏิบัติหน้าที่ราชการโดยจงใจ ไม่ปฏิบัติตามกฎหมาย ระเบียบของทางราชการ มติคณะรัฐมนตรี หรือนโยบายของรัฐบาล อันเป็นเหตุให้เสียหายแก่ราชการอย่างร้ายแรง และฐานกระทำการอื่นใดอันได้ชื่อว่าเป็น ผู้ประพฤติชั่วอย่างร้ายแรง ตามมาตรา ๘๒ วรรคสาม มาตรา ๘๕ วรรคสอง และมาตรา ๔๘ วรรคสอง แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๓๕ ประกอบมาตรา ๑๓๓ แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๕๑ จึงเห็นได้ว่า ผู้ถูกฟ้องคดีที่ ๑ ไต่สวน ข้อเท็จจริงและมีมติชี้มูลความผิดทางวินัยผู้ฟ้องคดีในการกระทำความผิดฐานทุจริตต่อหน้าที่แล้ว ผู้ถูกฟ้องคดีที่ ๑ จึงมีอำนาจชี้มูลความผิดทางวินัยผู้ฟ้องคดีในฐานอื่นที่เกี่ยวข้องกันและส่งเรื่องไปยัง ผู้ถูกฟ้องคดีที่ 6 ซึ่งเป็นผู้บังคับบัญชาหรือผู้มีอำนาจแต่งตั้งถอดถอนผู้ฟ้องคดีเพื่อให้ดำเนินการ ทางวินัยได้ โดยไม่ต้องแต่งตั้งคณะกรรมการสอบสวนวินัยอีก และให้ถือว่าสำนวนการไต่สวนของ ผู้ถูกฟ้องคดีที่ ๑ เป็นสำนวนการสอบสวนทางวินัยของคณะกรรมการสอบสวนวินัย ตามมาตรา ๙๑ (๒) และมาตรา ๔๘ วรรคหนึ่ง แห่งพระราชบัญญัติประกอบรัฐธรรมนูญว่าด้วยการป้องกันและ ปราบปรามการทุจริต พ.ศ. ๒๕๖๑ ที่ผู้ฟ้องคดีอ้างว่า ผู้ถูกฟ้องคดีที่ ๑ มีอำนาจไต่สวนและชี้มูล ความผิดทางวินัยเฉพาะความผิดฐานทุจริตต่อหน้าที่ราชการเท่านั้น เมื่อผู้ฟ้องคดีไม่ได้กระทำ ความผิดฐานทุจริตต่อหน้าที่ ผู้ถูกฟ้องคดีที่ ๑ จึงไม่มีอำนาจไต่สวนและชี้มูลความผิดผู้ฟ้องคดี และไม่ผูกพันผู้ถูกฟ้องคดีที่ ๒ ให้ต้องถือรายงานการไต่สวนของผู้ถูกฟ้องคดีที่ ๑ เป็นรายงาน การสอบสวน โดยผู้ถูกฟ้องคดีที่ ๑ ต้องดำเนินการแต่งตั้งคณะกรรมการสอบสวนความผิดทางวินัย เพื่อสอบสวนข้อเท็จจริง นั้น จึงฟังไม่ขึ้น นอกจากนี้ เมื่อพิจารณามาตรา ๑๙๒ แห่งพระราชบัญญัติ ประกอบรัฐธรรมนูญดังกล่าว ซึ่งบัญญัติว่า การดำเนินการตรวจรับคำกล่าวหา แสวงหาข้อเท็จจริง และรวบรวมพยานหลักฐาน ไต่สวนและมีความเห็นหรือวินิจฉัย ตามพระราชบัญญัติประกอบ รัฐธรรมนูญว่าด้วยการป้องกันและปราบปรามการทุจริต พ.ศ. ๒๕๔๒ และที่แก้ไขเพิ่มเติม ในวันก่อนวันที่พระราชบัญญัติประกอบรัฐธรรมนูญนี้ใช้บังคับให้เป็นอันใช้ได้และให้ดำเนินการ ต่อไป โดยการดำเนินการดังกล่าวต้องดำเนินการให้แล้วเสร็จตามมาตรา ๔๘ กล่าวคือ ต้องไม่เกิน ๒๕๖๑ สองปีนับแต่วันเริ่มดำเนินการไต่สวน การที่ผู้ถูกฟ้องคดีที่ ๑ มีคำสั่งให้ไต่สวนเมื่อวันที่ 4 กันยายน จนถึงผู้ถูกฟ้องคดีที่ ๑ มีมติชี้มูลความผิดของผู้ฟ้องคดีในการประชุมครั้งที่ ๑๐๕/๒๕๖๒ เมื่อวันที่ ๘ ตุลาคม ๒๕๖๒ จึงยังไม่พ้นกำหนดระยะเวลาสองปี ตามมาตรา ๔๘ ประกอบมาตรา ๑๙๒ แห่งพระราชบัญญัติประกอบรัฐธรรมนูญว่าด้วยการป้องกันและปราบปรามการทุจริต พ.ศ. ๒๕๖๑\n\nที่ผู้ฟ้องคดีอ้างว่าผู้ถูกฟ้องคดีที่ ๑ ใช้เวลาในการดำเนินการไต่สวนประมาณสามปีเศษ ล่วงเลย ต่อมา เมื่อผู้ถูกฟ้องคดีที่ ระยะเวลาตามที่กฎหมายกำหนดไว้โดยไม่มีเหตุจำเป็น และผู้ถูกฟ้องคดีที่ ๑ ไม่ได้ขอขยาย ระยะเวลา อันเป็นการไม่ปฏิบัติตามพระราชบัญญัติประกอบรัฐธรรมนูญว่าด้วยการป้องกัน และปราบปรามการทุจริต พ.ศ. ๒๕๖๑ มาตรา ๔๘ ทำให้มติการชี้มูลความผิดของผู้ถูกฟ้องคดีที่ ๑ ไม่มีผลผูกพันต่อผู้ถูกฟ้องคดีที่ ๒ ที่จะดำเนินการลงโทษทางวินัยแก่ผู้ฟ้องคดี นั้น จึงฟังไม่ขึ้น ๒ ซึ่งเป็นผู้บังคับบัญชามีอำนาจบรรจุและแต่งตั้งผู้ฟ้องคดี ตามมาตรา ๕๗ (๔) แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๕๑ ได้รับหนังสือสำนักงาน ป.ป.ช. ที่ ปช ๐๑.๐๑ (ชร/๑๔๔๒ ลงวันที่ 4 พฤศจิกายน ๒๕๖๒ ส่งรายงาน สำนวนการไต่สวน เอกสารหลักฐาน และคำวินิจฉัยแล้ว จึงส่งเรื่องให้ อ.ก.พ. กระทรวงมหาดไทย พิจารณาโทษทางวินัยผู้ฟ้องคดี ตามมาตรา ๔๗ วรรคสอง แห่งพระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๕๑ ซึ่ง อ.ก.พ. กระทรวงมหาดไทย ได้มีมติในการประชุมครั้งที่ ๒/๒๕๖๓ เมื่อวันที่ ๑๘ มิถุนายน ๒๕๖๓ ว่า พฤติการณ์ของผู้ฟ้องคดีเป็นความผิดวินัยอย่างร้ายแรงตามฐานความผิดที่ผู้ถูกฟ้องคดีที่ ๑ มีมติ ชี้มูลความผิด และตามมติคณะรัฐมนตรี เมื่อวันที่ ๒๑ ธันวาคม ๒๕๓๖ แจ้งตามหนังสือสำนัก เลขาธิการคณะรัฐมนตรี ที่ นร ๐๒๐๕/ว ๒๓๔ ลงวันที่ ๒๔ ธันวาคม ๒๕๓๖ ที่กำหนดให้ลงโทษ ผู้กระทำผิดวินัยฐานทุจริตต่อหน้าที่ราชการเป็นความผิดวินัยอย่างร้ายแรงควรลงโทษไล่ออก ที่ จากราชการ ให้ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ ผู้ถูกฟ้องคดีที่ ๒ จึงมีคำสั่งกรมการปกครอง ๑๔๐๐/๒๕๖๓ ลงวันที่ 4 สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดีออกจากราชการ ตั้งแต่วันที่ ๒๓ พฤษภาคม ๒๕๖๓ เป็นต้นไป ซึ่งเป็นวันที่ผู้ฟ้องคดีถูกพักราชการไว้ก่อน เห็นได้ว่า กระบวนการออกคำสั่งลงโทษไล่ผู้ฟ้องคดีออกจากราชการดังกล่าวเป็นการกระทำโดยถูกต้อง ตามรูปแบบขั้นตอน หรือวิธีการอันเป็นสาระสำคัญที่กำหนดไว้สำหรับการกระทำนั้นแล้ว\n\nคดีมีปัญหาต้องวินิจฉัยต่อไปว่า ผู้ฟ้องคดีกระทำผิดวินัยอย่างร้ายแรง ตามที่ ผู้ถูกฟ้องคดีที่๑ ชี้มูลหรือไม่\n\nพิเคราะห์แล้วเห็นว่า พระราชบัญญัติระเบียบบริหารราชการแผ่นดิน พ.ศ. ๒๕๓๔ มาตรา ๒๓ บัญญัติว่า ในอำเภอหนึ่ง นอกจากจะมีนายอำเภอเป็นผู้ปกครองบังคับบัญชาและ รับผิดชอบดังกล่าวในมาตรา ๒๒ ให้มีปลัดอำเภอและหัวหน้าส่วนราชการประจำอำเภอ บัญญัติว่า ซึ่งกระทรวง ทบวง กรมต่าง ๆ ส่งมาประจำให้ปฏิบัติหน้าที่เป็นผู้ช่วยเหลือนายอำเภอ และ มีอำนาจบังคับบัญชาข้าราชการฝ่ายบริหารส่วนภูมิภาคซึ่งสังกัดกระทรวง ทบวง กรมนั้น ในอำเภอนั้น พระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๓๕ มาตรา ๑๒ วรรคสาม การปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ราชการโดยมิชอบ เพื่อให้ตนเองหรือผู้อื่น ได้ประโยชน์ที่มีควรได้ เป็นการทุจริตต่อหน้าที่ราชการและเป็นความผิดวินัยอย่างร้ายแรง\n\nมาตรา ๘๕ วรรคสอง บัญญัติว่า การปฏิบัติหน้าที่ราชการโดยจงใจไม่ปฏิบัติตามกฎหมาย ระเบียบของทางราชการ มติคณะรัฐมนตรี หรือนโยบายของรัฐบาล อันเป็นเหตุให้เสียหายแก่ ราชการอย่างร้ายแรง เป็นความผิดวินัยอย่างร้ายแรง และมาตรา ๔๘ วรรคสอง บัญญัติว่า การกระทำความผิดอาญาจนได้รับโทษจำคุก หรือโทษที่หนักกว่าจำคุกโดยคำพิพากษาถึงที่สุด ให้จำคุก หรือให้รับโทษที่หนักกว่าจำคุก เว้นแต่เป็นโทษสำหรับความผิดที่ได้กระทำโดยประมาท หรือความผิดลหุโทษ หรือกระทำการอื่นใดอันได้ชื่อว่าเป็นผู้ประพฤติชั่วอย่างร้ายแรงเป็นความผิด วินัยอย่างร้ายแรง พระราชบัญญัติระเบียบข้าราชการพลเรือน พ.ศ. ๒๕๕๑ มาตรา ๑๓๓ บัญญัติว่า ข้าราชการพลเรือนผู้ใดมีกรณีกระทำผิดวินัยหรือกรณีที่สมควรให้ออกจากราชการ อยู่ก่อนวันที่บทบัญญัติในลักษณะ ๔ ข้าราชการพลเรือนสามัญ และลักษณะ ๕ ข้าราชการ พลเรือนในพระองค์ แห่งพระราชบัญญัตินี้ใช้บังคับ ให้ผู้บังคับบัญชาตามพระราชบัญญัตินี้มีอำนาจ สั่งลงโทษผู้นั้นหรือสั่งให้ผู้นั้นออกจากราชการตามกฎหมายว่าด้วยระเบียบข้าราชการพลเรือน ที่ใช้อยู่ในขณะนั้น ส่วนการสอบสวน การพิจารณาและการดำเนินการเพื่อลงโทษหรือให้ออก จากราชการ ให้ดำเนินการตามพระราชบัญญัตินี้... ระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ ข้อ ๗๑ กำหนดว่า คณะกรรมการตรวจรับพัสดุ มีหน้าที่ดังนี้... (๒) ตรวจรับพัสดุ ให้ถูกต้องครบถ้วนตามหลักฐานที่ตกลงกันไว้... ... ในกรณีที่เห็นว่าพัสดุที่ส่งมอบ มีรายละเอียด ไม่เป็นไปตามข้อกำหนดในสัญญาหรือข้อตกลง ให้รายงานหัวหน้าส่วนราชการผ่านหัวหน้าเจ้าหน้าที่ พัสดุ เพื่อทราบหรือสั่งการ แล้วแต่กรณี\n\nข้อเท็จจริงปรากฏว่า ขณะผู้ฟ้องคดีดำรงตำแหน่งปลัดอำเภอ (เจ้าพนักงาน ปกครอง 5) ที่ทำการปกครองอำเภอพญาเม็งราย จังหวัดเชียงราย มีหน้าที่เป็นผู้ช่วยเหลือ นายอำเภอ และมีอำนาจบังคับบัญชาข้าราชการฝ่ายบริหารส่วนภูมิภาคซึ่งสังกัดกระทรวง ทบวง กรมนั้น ในอำเภอนั้น ตามมาตรา ๖๓ แห่งพระราชบัญญัติระเบียบบริหารราชการแผ่นดิน พ.ศ. ๒๕๓๔ ที่ทำการปกครองอำเภอพญาเม็งรายได้รับการสนับสนุนเงินงบประมาณประจำปี พ.ศ. ๒๕๔๘ โดยนายอำเภอพญาเม็งรายได้แต่งตั้งให้ผู้ฟ้องคดีเป็นประธานกรรมการตรวจรับพัสดุ จำนวน ๒ โครงการ คือ โครงการจัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข้มแข็ง ให้ชุมชนอำเภอพญาเม็งราย จังหวัดเชียงราย และโครงการส่งเสริมการเกษตรแบบครบวงจร สำหรับโครงการจัดทำเวทีประชาคมหมู่บ้านเพื่อเสริมสร้างความเข้มแข็งให้ชุมชนอำเภอพญาเม็งราย จังหวัดเชียงราย ได้รับเงินงบประมาณและเงินอุดหนุนจากองค์การบริหารส่วนตำบลในอำเภอพญา เม็งราย ๕ อบต. เป็นเงิน ๙๐,๐๐๐ บาท โดยมีผู้ฟ้องคดีเป็นผู้เสนอโครงการซึ่งมีวัตถุประสงค์เพื่อให้ราษฎร มีส่วนร่วมในการป้องกันและเฝ้าระวังปัญหายาเสพติดในพื้นที่ ๕ ตำบล ๖๙ หมู่บ้าน ระหว่างวันที่ ๑๕ ธันวาคม ๒๕๔๗ ถึงวันที่ ๓๑ มกราคม ๒๕๔๘ ต่อมา ผู้ฟ้องคดีได้มีหนังสือ ไม่ระบุวันที่ เดือนมกราคม ๒๕๕๘ ขออนุมัติเปลี่ยนแปลงกำหนดการจัดทำเวทีประชาคมหมู่บ้านฯ โดยจัดประชุม เวทีประชาคมหมู่บ้านในวันที่ ๑๗ - ๑๙ มกราคม ๒๕๕๘ ณ หอประชุมพญาเม็งราย โครงการดังกล่าว มีการจัดซื้อจัดจ้างรวม ๓ รายการ คือ (๑) วัสดุแบบพิมพ์อบรมสร้างความเข้มแข็งให้ชุมชน และกระดาษถ่ายเอกสาร จำนวน ๑๐ รีม รีมละ ๑๐๐ บาท เป็นเงิน ๑,๐๐๐ บาท จากนางเจรุมาศ อนุสถิตวัฒนา ผู้ขาย (๒) จ้างเหมาจัดทำอาหาร อาหารว่าง และเครื่องดื่ม สำหรับผู้เข้าอบรม ในวันที่ ๑๗ ๑๙ มกราคม ๒๕๔๘ จำนวน ๕๙ หมู่บ้าน หมู่บ้านละ ๒๐ คน คนละ ๕๐ บาท เป็นเงิน ๕๔,๐๐๐ บาท จากนายสว่าง วรรณสอน ผู้รับจ้าง (๓) จ้างเหมาจัดสถานที่และเช่าเครื่องเสีย จัดทำเวทีประชาคม ในวันที่ ๑๗ ๑๙ มกราคม ๒๕๕๘ เป็นเงิน ๔,๐๐๐ บาท และจัดหาโต๊ะ เก้าอี้ สำหรับวิทยากรและผู้เข้าอบรม จำนวน ๕๐๐ ตัว พร้อมโต๊ะหมู่บูชา แอมป์พาวเวอร์ และ อุปกรณ์อื่นๆ เป็นเงิน ๒๑,๐๐๐ บาท รวมเป็นเงิน ๓๐,๐๐๐ บาท จากนายสุวนันท์ ไชยานันตา ผู้รับจ้าง รวมเป็นเงิน ๙๐,๐๐๐ บาท แต่จากรายงานการไต่สวนของผู้ถูกฟ้องคดีที่ ๑ ปรากฏว่า พยานบุคคลซึ่งเป็นผู้ปกครองท้องที่อำเภอพญาเม็งรายหลายรายต่างให้ถ้อยคำสอดคล้องกันว่า อำเภอพญาเม็งรายดำเนินการจัดประชุมประชาคม ณ หอประชุมหมู่บ้าน เพียงครึ่งวัน โดยไม่มี การจัดเลี้ยงอาหารกลางวันแก่ผู้เข้าอบรม และในวันที่ ๑๗ - ๑๙ มกราคม ๒๕๕๘ ไม่มีการจัด เวทีประชาคมหมู่บ้าน ณ หอประชุมอำเภอพญาเม็งราย แต่อย่างใด มีเพียงการประชุมประชาคม ของหมู่ที่ 5 ตำบลตาดควัน ในวันที่ ๑๗ ธันวาคม ๒๕๔๗ และการประชุมประชาคมของหมู่ที่ ๒ ตำบลแม่ต่ำ ในวันที่ ๓๐ ธันวาคม ๒๕๕๗ ตามบันทึกรายงานการตรวจ ลงวันที่ ๑๗ ธันวาคม ๒๕๕๗ และวันที่ ๓๐ ธันวาคม ๒๕๔๗ เท่านั้น ประกอบกับนายสุวนันท์ ไชยานันตา ผู้รับจ้างเหมา จัดสถานที่และเช่าเครื่องเสียงจัดทำเวทีประชาคม ให้ถ้อยคำว่า นายสุวนันท์เป็นอาสาสมัครรักษา ดินแดนอำเภอพญาเม็งรายอยู่ภายใต้การบังคับบัญชาโดยตรงของผู้ฟ้องคดี ผู้ฟ้องคดีได้สั่งการให้ นายสุวนันท์ลงลายมือชื่อเป็นผู้รับจ้างทั้งที่ทราบอยู่แล้วว่านายสุวนันท์ไม่มีอาชีพในการจัดสถานที่ หรือมีเครื่องเสียงให้เช่า แม้นายสุวนันท์จะได้จัดหาโต๊ะ เก้าอี้ ลำโพงขนาดใหญ่ ลำโพงขนาดเล็ก และไมโครโฟน เพื่อใช้จัดสถานที่ในวันที่ ๑๖ มกราคม ๒๕๕๘ จริง แต่นายสุวนันท์ไม่ทราบว่า ในวันที่ ๑๗ ๑๙ มกราคม ๒๕๕๘ มีการจัดประชุมหรือไม่ และไม่ทราบว่ามีการจัดหาเครื่องเสียง ชุดใหญ่พร้อมแอมป์พาวเวอร์หรือไม่ โดยนายสุวนันท์ไม่ได้รับค่าจ้างแต่อย่างใด อีกทั้ง ในการ เบิกจ่ายค่าจ้างเหมาจัดทำอาหาร อาหารว่าง และเครื่องดื่ม ก็ไม่ปรากฏรายละเอียดในหลักฐาน การเบิกจ่าย และนายสว่าง วรรณสอน ผู้รับจ้าง ก็ไม่มีอาชีพในการจัดทำอาหาร แต่เป็นอาสาสมัคร รักษาดินแดนอำเภอพญาเม็งรายซึ่งอยู่ภายใต้การบังคับบัญชาโดยตรงของผู้ฟ้องคดีเช่นเดียวกับ นายสุวนันท์ เห็นได้ว่า ผู้ฟ้องคดีซึ่งได้รับแต่งตั้งให้เป็นประธานกรรมการตรวจรับพัสดุ มีหน้าที่ ตรวจรับพัสดุให้ถูกต้องครบถ้วนตามหลักฐานที่ตกลงกันไว้ กรณีที่เห็นว่าพัสดุที่ส่งมอบมีรายละเอียดไม่เป็นไปตามข้อกำหนดในสัญญาหรือข้อตกลง ให้รายงานหัวหน้าส่วนราชการ ผ่านหัวหน้าเจ้าหน้าที่พัสดุเพื่อทราบหรือสั่งการ แล้วแต่กรณี ตามข้อ ๗๑ ของระเบียบสำนัก นายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ แต่ผู้ฟ้องคดีกลับไม่ตรวจรับพัสดุตามโครงการจัดทำ เวทีประชาคมหมู่บ้านฯ ทั้งยังลงนามรับรองเป็นหลักฐานว่ามีการดำเนินการจัดซื้อจัดจ้างถูกต้อง ครบถ้วน เพื่อเสนอให้มีการเบิกจ่ายเงิน อันเป็นการไม่ปฏิบัติตามข้อ ๗๑ ของระเบียบสำนัก นายกรัฐมนตรีดังกล่าว\n\nส่วนโครงการส่งเสริมการเกษตรแบบครบวงจร ได้รับจัดสรรเงินงบประมาณ จำนวน ๓๘๔,๐๐๐ บาท มีการจัดซื้อวัสดุอุปกรณ์ส่งเสริมเกษตรธรรมชาติแบบครบวงจร จากนายธนกร ไชยวรรณ์ จำนวน 5 ครั้ง สำหรับหมู่ที่ ๓ ตำบลเม็งราย หมู่ที่ ๙ ตำบลไม้ยา หมู่ที่ ๙ ตำบลแม่ต่ำ หมู่ที่ ๑๓ ตำบลตาดควัน หมู่ที่ ๑๔ ตำบลไม้ยา และหมู่ที่ ๑๙ ตำบลแม่เปา ครั้งละ ๑๑ รายการ ประกอบด้วยเครื่องสกัดยาฆ่าแมลง เครื่องบดดิน ถังพ่นยา ถั่วฝักยาว ผักบุ้งจีน แตงกวา คะน้า กวางตุ้งใบ ผักชี ผักขึ้นฉ่าย และบวบเหลี่ยม ตามใบสั่งซื้อเลขที่ ๗/๒๕๔๘ ๑๒/๒๕๔๘ ๑๔ กุมภาพันธ์ ๒๕๕๘ แต่ปรากฏว่าชาวบ้านหมู่ที่ ๓ ตำบลเม็งราย ได้รับวัสดุไม่ครบ ทั้ง ลงวันที่ ๑๑ รายการ หมู่ที่ ๓ ตำบลตาดควัน ได้รับวัสดุไม่ครบทั้ง ๑๑ รายการ หมู่ที่ ๙ ตำบลไม้ยา ได้รับเฉพาะเครื่องสกัดยาฆ่าแมลงและเครื่องบดดิน หมู่ที่ 4 ตำบลแม่ต่ำ ได้รับเฉพาะเครื่องสกัด ยาฆ่าแมลงและเครื่องบดดิน หมู่ที่ ๑๔ ตำบลไม้ยา ได้รับเฉพาะเครื่องสกัดยาฆ่าแมลงและเครื่องบดดิน และหมู่ที่ ๑๙ ตำบลแม่เปา ได้รับเฉพาะเครื่องสกัดยาฆ่าแมลงและเครื่องบดดิน ชาวบ้านต่างได้รับ พัสดุไม่ตรงตามที่ขออนุมัติและได้รับพัสดุไม่ครบถ้วน แม้ผู้ฟ้องคดีจะไม่มีอำนาจหน้าที่ในการ แจกจ่ายพัสดุให้กับชาวบ้าน แต่ผู้ฟ้องคดีซึ่งเป็นประธานกรรมการตรวจรับพัสดุ มีหน้าที่ตรวจ รับพัสดุให้ถูกต้องครบถ้วนตามหลักฐานที่ตกลงกันไว้ กรณีที่เห็นว่าพัสดุที่ส่งมอบมีรายละเอียด ไม่เป็นไปตามข้อกำหนดในสัญญาหรือข้อตกลง ให้รายงานหัวหน้าส่วนราชการผ่านหัวหน้า เจ้าหน้าที่พัสดุเพื่อทราบหรือสั่งการ แล้วแต่กรณี ตามข้อ ๗๑ ของระเบียบสำนักนายกรัฐมนตรี ว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ กลับลงนามยืนยันว่ามีการตรวจรับพัสดุครบถ้วน เพื่อเสนออนุมัติ เบิกจ่ายเงิน ทั้งที่ผู้ฟ้องคดีไม่ได้ตรวจรับพัสดุตามโครงการส่งเสริมการเกษตรแบบครบวงจรจริง อันเป็นการไม่ปฏิบัติตามข้อ ๗๑ ของระเบียบสำนักนายกรัฐมนตรีดังกล่าว นอกจากนี้ ผู้ฟ้องคดี รับว่าทั้งโครงการจัดทำเวทีประชาคมหมู่บ้านฯ และโครงการส่งเสริมการเกษตรแบบครบวงจร นายบุญยัง เรือนกูล นายอำเภอพญาเม็งราย และนางวัลลภาภรณ์ เรือนปาง เสมียนตราอำเภอ พญาเม็งราย ได้รวบรวมเอกสารที่เกี่ยวข้องเสนอผู้ฟ้องคดีให้ลงนามในฐานะประธานกรรมการ ตรวจรับพัสดุ ผู้ฟ้องคดีได้ลงนามรับรองเป็นหลักฐานว่ามีการดำเนินการจัดซื้อจัดจ้างถูกต้อง ครบถ้วน เพื่อเสนอให้มีการเบิกจ่ายเงินงบประมาณจำนวน ๙๐,๐๐๐ บาท และจำนวน ๓๘๔,๐๐๐ บาท อันเป็นการเอื้อให้บุคคลอื่นได้รับผลประโยชน์จากงบประมาณดังกล่าว\n\nที่ผู้ฟ้องคดีอ้างว่า ผู้ฟ้องคดีไม่มีความเป็นอิสระในการบริหาร ต้องตกอยู่ภายใต้การสั่งการของ นายบุญยัง ผู้ฟ้องคดีไม่มีเจตนาทุจริต ไม่ปรากฏว่าผู้ฟ้องคดีมีทรัพย์สินเพิ่มมากขึ้นผิดปกติ หรือมีการได้ประโยชน์ในลักษณะทรัพย์สิน หรือประโยชน์อื่นใดจากการดำเนินโครงการ ผู้ฟ้องคดี ไม่ได้กระทำการทุจริตต่อหน้าที่ นั้น เห็นว่า เมื่อพิจารณาประวัติการรับราชการของผู้ฟ้องคดี ในช่วงก่อนที่ผู้ฟ้องคดีจะได้รับการแต่งตั้งให้ดำรงตำแหน่งปลัดอำเภอ ที่ทำการปกครองพญาเม็งราย ผู้ฟ้องคดีดำรงตำแหน่งปลัดอำเภอ (เจ้าพนักงานปกครอง ๓) ตั้งแต่วันที่ ๒๖ ธันวาคม ๒๕๓๗ และรับราชการตำแหน่งดังกล่าวมาแล้วในหลายท้องที่ของจังหวัดเชียงราย ผู้ฟ้องคดีย่อมเป็น ข้าราชการผู้มีความรู้และประสบการณ์ในการปฏิบัติหน้าที่ในตำแหน่งนั้นเป็นอย่างดี เมื่อผู้ฟ้องคดี ได้รับแต่งตั้งให้เป็นประธานกรรมการตรวจรับพัสดุ ผู้ฟ้องคดีจึงมีหน้าที่ต้องตรวจรับพัสดุให้ถูกต้อง ครบถ้วนตามข้อ ๗๑ ของระเบียบสำนักนายกรัฐมนตรีว่าด้วยการพัสดุ พ.ศ. ๒๕๓๕ แต่ผู้ฟ้องคดี กลับยอมลงชื่อในเอกสารการตรวจรับพัสดุและการจ้างตามที่ นายบุญยัง นำมาให้โดยมิได้ทักท้วง หรือเสนอความเห็นให้มีการทบทวนการกระทำที่ไม่ถูกต้องแต่อย่างใด แม้ไม่ปรากฏว่าผู้ฟ้องคดี ได้จะได้รับเงินจากการเบิกจ่ายงบประมาณดังกล่าวโดยตรง แต่การกระทำของผู้ฟ้องคดียังเป็น การเอื้อประโยชน์ให้กับบุคคลอื่นได้รับเงินหรือประโยชน์ที่มีควรได้ ข้อกล่าวอ้างของผู้ฟ้องคดี ฟังไม่ขึ้น จึงเห็นได้ว่า พฤติการณ์ของผู้ฟ้องคดีเป็นการปฏิบัติหรือละเว้นการปฏิบัติหน้าที่ราชการ โดยมิชอบ เพื่อให้ตนเองหรือผู้อื่นได้ประโยชน์ที่มีควรได้ เป็นการทุจริตต่อหน้าที่ราชการ ปฏิบัติหน้าที่ราชการโดยจงใจไม่ปฏิบัติตามกฎหมาย ระเบียบของทางราชการ มติคณะรัฐมนตรี หรือนโยบายของรัฐบาล อันเป็นเหตุให้เสียหายแก่ราชการอย่างร้ายแรง และกระทำการอื่นใด อันได้ชื่อว่าเป็นผู้ประพฤติชั่วอย่างร้ายแรง ซึ่งเป็นความผิดวินัยอย่างร้ายแรง ตามมาตรา ๘๒ เมื่อวันที่ ๘ วรรคสาม มาตรา ๘๕ วรรคสอง และมาตรา ๙๘ วรรคสอง แห่งพระราชบัญญัติระเบียบ ข้าราชการพลเรือน พ.ศ. ๒๕๓๕ ประกอบมาตรา ๑๓๓ แห่งพระราชบัญญัติระเบียบข้าราชการ พลเรือน พ.ศ. ๒๕๕๑ ตามที่ผู้ถูกฟ้องคดีที่ ๑ ชี้มูลความผิด ดังนั้น การที่ผู้ถูกฟ้องคดีที่ ๒ มีคำสั่งกรมการปกครอง ที่ ๑๔๐๐/๒๕๖๓ ลงวันที่ ๕ สิงหาคม ๒๕๖๓ ลงโทษไล่ผู้ฟ้องคดี ออกจากราชการ จึงชอบด้วยกฎหมายแล้ว และการที่ผู้ถูกฟ้องคดีที่ ๓ วินิจฉัยอุทธรณ์ของผู้ฟ้องคดี โดยอาศัยข้อเท็จจริงและข้อกฎหมายเดียวกันแล้วมีคำวินิจฉัยเรื่องดำที่ ๖๓๑๐๑๖๖ เรื่องแดง ที่ ๑๐๔๘๑๖๕ ลงวันที่ ๕ กรกฎาคม ๒๕๖๕ ให้ยกอุทธรณ์ของผู้ฟ้องคดี จึงชอบด้วยกฎหมายเช่นกัน\n\nในส่วนของคำขอท้ายคำฟ้องที่ผู้ฟ้องคดีมีคำขอให้เพิกถอนมติของผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๕/๒๕๖๓ เมื่อวันที่ 4 มกราคม ๒๕๖๒ ที่ชี้มูลความผิดทางวินัย อย่างร้ายแรงผู้ฟ้องคดี นั้น เห็นว่า แม้มติของผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๕/๒๕๖๓ 4 มกราคม ๒๕๖๓ ที่ชี้มูลความผิดทางวินัยอย่างร้ายแรงผู้ฟ้องคดีฐานทุจริตต่อหน้าที่ ราชการ จะมีผลผูกพันให้ผู้ถูกฟ้องคดีที่ ๒ ต้องมีคำสั่งตามมติดังกล่าว แต่ก็เป็นเพียงส่วนหนึ่งของการพิจารณาทางปกครองเพื่อออกคำสั่งทางปกครองเท่านั้น ยังไม่มีผลเป็นการสร้าง นิติสัมพันธ์ขึ้นระหว่างบุคคลในอันที่จะก่อ เปลี่ยนแปลง โอน สงวน ระงับ หรือมีผลกระทบ ต่อสถานภาพของสิทธิหรือหน้าที่ของบุคคล อันจะถือได้ว่าเป็นคำสั่งทางปกครองตามมาตรา ๕ แห่งพระราชบัญญัติวิธีปฏิบัติราชการทางปกครอง พ.ศ. ๒๕๓๙ แต่อย่างใด ผู้ฟ้องคดีจึงมิใช่ ผู้ได้รับความเดือดร้อนหรือเสียหายจากมติดังกล่าวที่จะมีสิทธิฟ้องขอให้ศาลมีคำพิพากษาหรือ คำสั่งเพิกถอนมติของผู้ถูกฟ้องคดีที่ ๑ ในการประชุมครั้งที่ ๕/๒๕๖๓ เมื่อวันที่ 4 มกราคม ๒๕๖๒ ที่ชี้มูลความผิดทางวินัยอย่างร้ายแรงผู้ฟ้องคดีได้\n\nกรณีที่ผู้ฟ้องคดีอ้างว่า มติคณะรัฐมนตรีแจ้งเวียนตามหนังสือสำนักเลขาธิการ คณะรัฐมนตรีที่ นร ๐๒๐๕/ว ๒๓๔ ลงวันที่ ๒๔ ธันวาคม ๒๕๓๖ ที่ระบุว่า การให้ลงโทษ ผู้กระทำผิดวินัยฐานทุจริตต่อหน้าที่ราชการควรลงโทษเป็นไล่ออกจากราชการการ เป็นเพียง การแนะนำเท่านั้น การลงโทษผู้ฟ้องคดีจึงเป็นดุลพินิจของผู้ถูกฟ้องคดีที่ ๒ และผู้ถูกฟ้องคดีที่ ๓ ย่อมมีอำนาจในการวินิจฉัยฐานความผิดทางวินัยแก่ผู้ฟ้องคดีเสียใหม่ได้ นั้น เห็นว่า แม้มติ คณะรัฐมนตรีดังกล่าวมิได้มีสถานะเป็นกฎหมายหรือกฎอันจะมีผลผูกพันให้ผู้ถูกฟ้องคดีที่ ๒ ต้องปฏิบัติตาม แต่มติดังกล่าวเป็นการกำหนดนโยบายหรือแนวปฏิบัติในการใช้ดุลพินิจ สั่งลงโทษผู้กระทำผิดในเรื่องที่กำหนดไว้ เพื่อให้การลงโทษเป็นไปด้วยความเหมาะสมกับกรณี ความผิด มีมาตรฐานเดียวกัน และเป็นไปในทางเดียวกัน ดังนั้น ในการพิจารณาสั่งลงโทษทางวินัย อย่างร้ายแรงฐานทุจริตต่อหน้าที่ราชการ ผู้บังคับบัญชาต้องนำมติดังกล่าวมาประกอบการพิจารณา ใช้ดุลพินิจด้วย ส่วนกระบวนการพิจารณาอุทธรณ์ของผู้ถูกฟ้องคดีที่ ๓ มิใช่การพิจารณาเฉพาะ รายงานการสอบสวนทางวินัยเท่านั้น แต่ยังให้โอกาสผู้ถูกกล่าวหาพิสูจน์หลักฐานอื่น รวมทั้ง มีอำนาจสอบสวนเพิ่มเติมได้ ผู้ถูกฟ้องคดีที่ ๓ จึงมีอำนาจพิจารณาอุทธรณ์ตามหลักเกณฑ์และ วิธีการที่กำหนดไว้ตามอำนาจหน้าที่และอาจพิจารณาแตกต่างจากคำสั่งลงโทษของผู้ถูกฟ้องคดีที่ ๒ ได้ ข้ออ้างของผู้ฟ้องคดีในประเด็นนี้จึงฟังไม่ขึ้น\n\nกรณีที่ผู้ฟ้องคดีอ้างว่า คดีหมายเลขดำที่ อท ๑๓๕, ที่ อท ๗๘, ๑๓๖/๒๕๖๒ และคดีหมายเลขแดง ๗๗/๒๕๖๓ ของศาลอาญาคดีทุจริตและประพฤติมิชอบภาค ๕ นั้น ผู้ฟ้องคดียังใช้สิทธิ ทางศาลในชั้นอุทธรณ์และฎีกาอยู่ คดีจึงยังไม่ถึงที่สุด และที่ผู้ถูกฟ้องคดีที่ ๑ ให้การเพิ่มเติมว่า พยานหลักฐานตามที่ได้นำสืบในชั้นศาลและในชั้นไต่สวนของผู้ถูกฟ้องคดีที่ ๑ เห็นได้ชัดว่า ผู้ฟ้องคดีได้กระทำความผิดตามที่ถูกกล่าวหา และการกระทำของผู้ฟ้องคดีจึงเป็นความผิดตาม คำพิพากษาของศาลอาญาคดีทุจริตและประพฤติมิชอบภาค ๕ นั้น เห็นว่า ในการพิจารณา พิพากษาคดีปกครองเกี่ยวกับการลงโทษทางวินัย ไม่มีกฎหมายบัญญัติบังคับไว้ให้ศาลปกครอง จำต้องถือข้อเท็จจริงตามที่ปรากฏในคำพิพากษาคดีส่วนอาญา ดังนั้น การพิจารณาคดีปกครอง\n\nเกี่ยวกับการลงโทษทางวินัยในกรณีสืบเนื่องจากผู้ถูกฟ้องคดีที่ ที่ ๑ ๑ ชี้มูลว่าผู้ฟ้องคดีกระทำการ อันมีมูลความผิดฐานทุจริตต่อหน้าที่ ซึ่งเป็นความผิดทางวินัยและทางอาญานั้น แม้การดำเนินการ ทางวินัยและการดำเนินคดีส่วนอาญาจะได้อาศัยสำนวนการสอบสวนของผู้ถูกฟ้องคดีที่ ๑ เป็นหลัก และคดีส่วนอาญาได้มีคำพิพากษาถึงที่สุดแล้วหรือไม่ก็ตาม ศาลก็หาจำต้องถือข้อเท็จจริง ตามที่ปรากฏในคำพิพากษาคดีส่วนอาญาแต่อย่างใดไม่ ข้ออ้างของผู้ฟ้องคดีในประเด็นนี้ จึงฟังไม่ขึ้นเช่นกัน\n\nพิพากษายกฟ้อง" + } +} \ No newline at end of file diff --git a/app/api/template/test/T3.docx b/public/tmpl/T12_X.docx old mode 100644 new mode 100755 similarity index 75% rename from app/api/template/test/T3.docx rename to public/tmpl/T12_X.docx index 7573a45..93478ec Binary files a/app/api/template/test/T3.docx and b/public/tmpl/T12_X.docx differ diff --git a/public/tmpl/T12_b2_IN.json b/public/tmpl/T12_b2_IN.json new file mode 100644 index 0000000..4bd98a5 --- /dev/null +++ b/public/tmpl/T12_b2_IN.json @@ -0,0 +1,41 @@ +{ + "info": { + "ticket_data": "{\"fid\":\"T12_b2_IN\",\"tid\":\"T12\",\"uid\":\"john\",\"uname\":\"John Doe\"}" + }, + "dc": { + "Interpleader": true, + "docname": "", + "docabbr": "(ต. ๑๒)", + "blackno": "คดีหมายเลขดำที่", + "redno": "คดีหมายเลขแดงที่", + "court": "ศาลปกครองนครราชสีมา", + "panels": [ + { + "pname": "นายวิรุฬห์ จินตนะกุล", + "pmname": "ตุลาการศาลปกครองกลาง", + "pm": "ตุลาการเจ้าของสำนวน" + }, + { + "pname": "นายสัมฤทธิ์ อ่อนคำ", + "pmname": "ตุลาการศาลปกครองสูงสุด" + } + ], + "pnameT":"", + "pmnameT":"", + "pmT":"", + "acc_name":"" + + }, + "cc": { + "blackyear": "๙๐/๒๕๖๙", + "redyear": "", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙", + "accuser": "นายธีรพล ร่มเริง", + "acc1": "ผู้ฟ้องคดี", + "accused": "รร", + "acc2": "ผู้ถูกฟ้องคดี", + "interpleader": "สมชาย ใจดี", + "acc3": "ผู้ร้องสอด", + "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้องและเอกสารประกอบคำฟ้องแล้วเห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด ผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไขความเดือดร้อนหรือเสียหายก่อนฟ้องคดี และผู้ฟ้องคดีได้ดำเนินการครบถ้วน โดยเป็นการยื่นฟ้องคดีภายในระยะเวลาการฟ้องคดีตาม พรบ. จัดตั้งศาลปกครองและวิธีพิจารณาคดีปกครองฯ คดีนี้มีค่าธรรมเนียมที่ต้องชำระ\nโดยผู้ฟ้องคดีได้ชำระค่าธรรมเนียมครบถ้วนแล้ว รวมทั้งคดีนี้ไม่เป็นการฟ้องซ้อน การดำเนินกระบวนพิจารณาซ้ำ และการฟ้องซ้ำ\n\nจึงมีคำสั่งรับคำฟ้องไว้พิจารณาและสั่งให้ส่งสำเนาคำฟ้องพร้อมทั้งสำเนาพยานหลักฐานไปยังผู้ถูกฟ้องคดีเพื่อให้ผู้ถูกฟ้องคดีทำคำให้การยื่นต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่ง" + } +} \ No newline at end of file diff --git a/public/tmpl/TF_no_warning_P2.json b/public/tmpl/TF_no_warning_P2.json new file mode 100755 index 0000000..152736c --- /dev/null +++ b/public/tmpl/TF_no_warning_P2.json @@ -0,0 +1,50 @@ +{ + "info": { + "ticket_data": "{\"fid\":\"TF_no_warning_P2\",\"tid\":\"T_X\",\"uid\":\"john\",\"uname\":\"John Doe\"}" + }, + "dc": { + "Interpleader": false, + "CommandTo": true, + "SendTo": false, + "AdditionCommand" : true, + "Warning":false, + + "docname":"คำสั่งศาล", + "doctype":"(ต. ๔๗.๑)", + "blackno": "คดีหมายเลขดำที่", + "redno": "คดีหมายเลขแดงที่", + + "court": "ศาลปกครองนครราชสีมา", + "doctitle":"คำสั่งศาลถึง", + "pname":"สมหญิง", + + "courtname":"ศาลปกครองสุพรรณบุรี", + "courtno":"๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี", + "courttam":"จังหวัดสุพรรณบุรี ๗๒๐๐๐", + "courttel":"กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓", + "courttel2":"สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน ๑๓๕๕", + "pname2":"ชื่อของ pname2" + }, + "cc": { + "blackyear": "๙๐/๒๕๖๙", + "redyear": "xxx", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ", + "commto" : "นายสมชาย จรดปลายเท้า", + "addrno" : "3/77 xxx yyy ทุ่งสองห้อง,หลักสี่, จังหวัดกรุงเทพฯ ", + "groupname":"ผู้อำนวยการโรงเรียน", + + "accuser": "นายธีรพล ร่มเริง", + "acc1": "ผู้ฟ้องคดี", + "accused": "รร", + "acc2": "ผู้ถูกฟ้องคดี", + "interpleader": "สมชาย ใจดี", + "acc3": "ผู้ร้องสอด", + "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง และเอกสารประกอบคำฟ้องแล้ว เห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด\n\nผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไข ความเดือดร้อนหรือเสียหายก่อนฟ้องคดี ", + "sendto" : "นายสมศักดิ์ ฟักมี", + + "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่า ผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี", + "detail2":"คำสั่งเพิ่มเติมคือ bla bla", + "remarkhead":"หัวของ Remark", + "remark":"This is remark Text bla bla " + } +} \ No newline at end of file diff --git a/public/tmpl/TS_P2_IN.json b/public/tmpl/TS_P2_IN.json new file mode 100755 index 0000000..479478a --- /dev/null +++ b/public/tmpl/TS_P2_IN.json @@ -0,0 +1,52 @@ +{ + "info": { + "ticket_data": "{\"fid\":\"TS_P2_IN\",\"tid\":\"T_X\",\"uid\":\"john\",\"uname\":\"John Doe\"}" + }, + "dc": { + "Interpleader": true, + "CommandTo": true, + "SendTo": false, + "AdditionCommand" : true, + "Warning":true, + + "docname":"คำสั่งเรียกพยานบุคคล", + "doctype":"(ต. ๖)", + "blackno": "คดีหมายเลขดำที่", + "redno": "คดีหมายเลขแดงที่", + + "court": "ศาลปกครองนครราชสีมา", + "doctitle":"คำสั่งถึง", + "pname":"สมหญิง", + + "courtname":"ศาลปกครองสุพรรณบุรี", + "courtno":"๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี", + "courttam":"จังหวัดสุพรรณบุรี ๗๒๐๐๐", + "courttel":"กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓", + "courttel2":"สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน ๑๓๕๕", + + "pname2":"ชื่อของ pname2", + "remarkhead":"หัวของ Remark" + }, + "cc": { + "blackyear": "๙๐/๒๕๖๙", + "redyear": "xxx", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ", + "commto" : "นายสมชาย จรดปลายเท้า", + "addrno" : "3/77 xxx yyy ทุ่งสองห้อง,หลักสี่, จังหวัดกรุงเทพฯ ", + "groupname":"ผู้อำนวยการโรงเรียน", + + "accuser": "นายธีรพล ร่มเริง", + "acc1": "ผู้ฟ้องคดี", + "accused": "รร", + "acc2": "ผู้ถูกฟ้องคดี", + "interpleader": "สมชาย ใจดี", + "acc3": "ผู้ร้องสอด", + "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง และเอกสารประกอบคำฟ้องแล้ว เห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด\n\nผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไข ความเดือดร้อนหรือเสียหายก่อนฟ้องคดี ", + "sendto" : "นายสมศักดิ์ ฟักมี", + + "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่า ผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี", + "detail2":"คำสั่งเพิ่มเติมคือ bla bla", + + "remark":"This is remark Text bla bla " + } +} \ No newline at end of file diff --git a/app/api/template/test/output-T3.docx b/public/tmpl/T_X.docx old mode 100644 new mode 100755 similarity index 73% rename from app/api/template/test/output-T3.docx rename to public/tmpl/T_X.docx index c7619be..06182a4 Binary files a/app/api/template/test/output-T3.docx and b/public/tmpl/T_X.docx differ diff --git a/public/tmpl/T_no_warning.json b/public/tmpl/T_no_warning.json new file mode 100755 index 0000000..7697123 --- /dev/null +++ b/public/tmpl/T_no_warning.json @@ -0,0 +1,51 @@ +{ + "info": { + "ticket_data": "{\"fid\":\"T_no_warning\",\"tid\":\"T_X\",\"uid\":\"john\",\"uname\":\"John Doe\"}" + }, + "dc": { + "Interpleader": false, + "CommandTo": true, + "SendTo": true, + "AdditionCommand" : false, + "Warning":false, + + "docname":"คำสั่งเรียก\nให้ทำคำให้การเพิ่มเติม", + "doctype":"(ต. ๓)", + "blackno": "คดีหมายเลขดำที่", + "redno": "คดีหมายเลขแดงที่", + + "court": "ศาลปกครองนครราชสีมา", + "doctitle":"คำสั่งถึง", + "pname":"สมหญิง", + + "courtname":"ศาลปกครองสุพรรณบุรี", + "courtno":"๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี", + "courttam":"จังหวัดสุพรรณบุรี ๗๒๐๐๐", + "courttel":"กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓", + "courttel2":"สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน ๑๓๕๕", + "pname2":"ชื่อของ pname2" + }, + "cc": { + "docname":"คำสั่งเรียกพยานบุคคล", + "blackyear": "๙๐/๒๕๖๙", + "redyear": "xxx", + "curdate": "วันที่ เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ", + "commto" : "นายสมชาย จรดปลายเท้า", + "addrno" : "3/77 xxx yyy ทุ่งสองห้อง,หลักสี่, จังหวัดกรุงเทพฯ ", + "groupname":"ผู้อำนวยการโรงเรียน", + + "accuser": "นายธีรพล ร่มเริง", + "acc1": "ผู้ฟ้องคดี", + "accused": "รร", + "acc2": "ผู้ถูกฟ้องคดี", + "interpleader": "สมชาย ใจดี", + "acc3": "ผู้ร้องสอด", + "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง และเอกสารประกอบคำฟ้องแล้ว \nเห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด\n\nผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไข ความเดือดร้อนหรือเสียหายก่อนฟ้องคดี ", + "sendto" : "นายสมศักดิ์ ฟักมี", + + "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่า ผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี", + "detail2":"คำสั่งเพิ่มเติมคือ bla bla", + "remarkhead":"หัวของ Remark", + "remark":"This is remark Text bla bla " + } +} \ No newline at end of file diff --git a/public/tmpl/dl.html b/public/tmpl/dl.html new file mode 100644 index 0000000..6114ce9 --- /dev/null +++ b/public/tmpl/dl.html @@ -0,0 +1,28 @@ + + + + + + Test Download DOCX a + + +

A a Get

+ T_no_warning_john_xxx.docx
+ TF_no_warning_P2_john_xxx.docx
+ TS_P2_IN_john_xxx.docx
+ + T12_b2_IN_john_xxx.docx
+ T12_FD155_3s-long_john_xxx.docx
+ +

Template & Data

+ Template: T_X.docx,   + T12_X.docx
+ Data: TF_no_warning_P2.json,   + T_no_warning.json,   + TS_P2_IN.json
+ T12_b2_IN.json,   + T12_FD155_3s-long.json + + + + \ No newline at end of file diff --git a/public/wordaddin/manifest.template.xml b/public/wordaddin/manifest.template.xml index efe2e93..a51ebb1 100644 --- a/public/wordaddin/manifest.template.xml +++ b/public/wordaddin/manifest.template.xml @@ -11,8 +11,10 @@ ผลต่างจากต้นฉบับ: - taskpane ชี้ที่หน้า Next.js (/docedit/wordaddin) แทน taskpane.html ของ webpack - - ตัด DialogAPI (login ช่วงนี้เป็น mock ไม่มี Keycloak dialog) — เหลือ WordApi 1.5 + OpenBrowserWindowApi - - ตัด AppDomain ของ Keycloak (https://localhost:8443) + - ตัด DialogAPI + AppDomain ของ Keycloak (https://localhost:8443) — ยกเลิก auth ด้วย Keycloak + 2026-10-27: ไม่มี login ใน add-in auth เป็น e-Court pass-through (token/owner ใน custom + properties ของไฟล์) requirement set เหลือ WordApi 1.3 + OpenBrowserWindowApi + (ดูรายละเอียดระดับที่ใช้จริงในคอมเมนต์ก่อน ) - Commands.Url ชี้ taskpane URL เดียวกัน (ไม่มี commands.html — ปุ่มเดียวคือ ShowTaskpane) - คง Id GUID เดิม — เครื่องที่เคย sideload ตัว poc จะถือว่าเป็น add-in ตัวเดิม --> diff --git a/scripts/make-ticket-docx.mjs b/scripts/make-ticket-docx.mjs new file mode 100644 index 0000000..e22f6d0 --- /dev/null +++ b/scripts/make-ticket-docx.mjs @@ -0,0 +1,263 @@ +#!/usr/bin/env node +// PLAN-ADDIN-AUTH.md §9 — dev tool stamp ticket ของ e-Court (custom properties +// `ticket_data` + `HmacSha256`) ลงไฟล์ .docx เพื่อทดสอบ auth ของ add-in ใน Word จริง +// โดยไม่ต้องผ่านกลุ่ม template (TMPL_PATH) — คำนวณ HMAC ตรงกับตัว stamp จริง +// (app/api/template/render/route.ts: key เรียงตามตัวอักษรหลังเติม exp → +// HMAC-SHA256(secret, ticket_data ดิบ) เป็น hex lowercase) +// +// ใช้: node scripts/make-ticket-docx.mjs [options] +// --fid default DEMO_FID_001 +// --uid default oom +// --uname default "สรวิชญ์" +// --tid template id (optional — ไม่ส่ง = ไม่มี tid ใน ticket) +// --exp default +300 (5 นาที เท่า TICKET_SEC ของตัว stamp) +// --secret default "super_secret" (ต้องตรง env ฝั่ง server/add-in) +// --tracked [id] stamp SavedByAddIn + DocumentTrackingId ด้วย (ทดสอบ phase tracking) +// --in-place เขียนทับไฟล์เดิม (ปกติเขียน <ชื่อเดิม>.ticket.docx) +// --list แค่อ่าน custom properties ที่มีในไฟล์แล้วออกมาดู +// +// รันใน repo เท่านั้น (import pizzip จาก node_modules) — ไม่ใช่ postinstall + +import { createHmac, randomUUID } from "node:crypto"; +import { readFileSync, writeFileSync } from "node:fs"; +import path from "node:path"; +import PizZip from "pizzip"; + +const CUSTOM_PATH = "docProps/custom.xml"; +const CT_PATH = "[Content_Types].xml"; +const RELS_PATH = "_rels/.rels"; +const CUSTOM_FMTID = "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}"; +/** ต้องตรง metadataService.ADDIN_SIGNATURE_GUID ฝั่ง add-in */ +const ADDIN_SIGNATURE_GUID = "9B7A3C51-4E6F-4D2A-8B5C-1E0F2A3B4C5D"; + +function usage(code = 1) { + console.log(`ใช้: node scripts/make-ticket-docx.mjs [options] + --fid --uid --uname --tid + --exp --secret + --tracked [trackingId] --in-place --list`); + process.exit(code); +} + +function parseArgs(argv) { + const options = { + file: null, + fid: "DEMO_FID_001", + uid: "oom", + uname: "สรวิชญ์", + tid: null, + exp: "+300", + secret: "super_secret", + tracked: false, + trackingId: null, + inPlace: false, + list: false, + }; + for (let i = 0; i < argv.length; i++) { + const arg = argv[i]; + const next = () => { + const value = argv[++i]; + if (value === undefined) usage(); + return value; + }; + switch (arg) { + case "--fid": options.fid = next(); break; + case "--uid": options.uid = next(); break; + case "--uname": options.uname = next(); break; + case "--tid": options.tid = next(); break; + case "--exp": options.exp = next(); break; + case "--secret": options.secret = next(); break; + case "--tracked": + options.tracked = true; + if (argv[i + 1] && !argv[i + 1].startsWith("--")) options.trackingId = next(); + break; + case "--in-place": options.inPlace = true; break; + case "--list": options.list = true; break; + case "--help": case "-h": usage(0); break; + default: + if (arg.startsWith("--")) usage(); + if (options.file !== null) usage(); + options.file = arg; + } + } + if (options.file === null) usage(); + return options; +} + +function resolveExp(raw) { + if (raw.startsWith("+")) { + const seconds = Number(raw.slice(1)); + if (!Number.isFinite(seconds) || seconds <= 0) throw new Error("--exp +<วินาที> ไม่ถูกต้อง"); + return Math.floor(Date.now() / 1000) + Math.floor(seconds); + } + const value = Number(raw); + if (!Number.isInteger(value) || value <= 0) throw new Error("--exp ต้องเป็น unix วินาที หรือ +<วินาที>"); + return value; +} + +function escapeXml(value) { + return String(value) + .replace(/&/g, "&") + .replace(//g, ">") + .replace(/"/g, """) + .replace(/'/g, "'"); +} + +/** ticket_data ตามรูปตัว stamp จริง — key เรียงตามตัวอักษรหลังเติม exp */ +function buildTicketData(options) { + const ticket = { exp: resolveExp(options.exp), fid: options.fid, uid: options.uid, uname: options.uname }; + if (options.tid !== null) ticket.tid = options.tid; + const sorted = Object.keys(ticket) + .sort() + .reduce((result, key) => { + result[key] = ticket[key]; + return result; + }, {}); + return JSON.stringify(sorted); +} + +function unescapeXml(value) { + return String(value) + .replace(/</g, "<") + .replace(/>/g, ">") + .replace(/"/g, '"') + .replace(/'/g, "'") + .replace(/&/g, "&"); +} + +/** ถอด ทั้งชุดจาก custom.xml — ไว้ --list และหา pid ที่ใช้แล้ว */ +function readProperties(xml) { + const properties = []; + const regex = /]*name="([^"]*)"[^>]*>([\s\S]*?)<\/Property>|]*name="([^"]*)"[^>]*\/>/g; + let match; + while ((match = regex.exec(xml)) !== null) { + const name = match[1] ?? match[3]; + const inner = match[2] ?? ""; + const value = inner.replace(/<[^>]+>/g, ""); + properties.push({ name: unescapeXml(name), value: unescapeXml(value.trim()) }); + } + return properties; +} + +function usedPids(xml) { + const pids = new Set([1]); + const regex = /pid="(\d+)"/g; + let match; + while ((match = regex.exec(xml)) !== null) pids.add(Number(match[1])); + return pids; +} + +function propertyXml(name, pid, value) { + return ` ${escapeXml(value)}\n`; +} + +/** upsert property ลง custom.xml (สร้างไฟล์ใหม่ถ้ายังไม่มี) — คืน XML ที่พร้อมเขียนกลับ zip */ +function upsertProperties(existingXml, entries) { + // เอา Property เก่าของชื่อที่จะเขียนทิ้งก่อน (replace แบบตัวเอง) + let xml = existingXml; + for (const entry of entries) { + const removal = new RegExp( + `\\s*]*name="${escapeXml(entry.name).replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"[^>]*>([\\s\\S]*?)`, + "g", + ); + xml = xml.replace(removal, ""); + } + const pids = usedPids(xml); + let nextPid = 2; + const takePid = () => { + while (pids.has(nextPid)) nextPid++; + pids.add(nextPid); + return nextPid++; + }; + const block = entries.map((entry) => propertyXml(entry.name, takePid(), entry.value)).join(""); + const hasRoot = xml.includes(""); + if (hasRoot) { + xml = xml.replace(/<\/Properties>/, `${block}`); + } else { + xml = + `\n` + + `\n${block}`; + } + return xml; +} + +/** ผูก docProps/custom.xml เข้ากับแพ็กเกจ — Word ไม่เห็น part ที่ไม่มี relationship/content-type */ +function ensurePartRegistered(zip) { + const ct = zip.file(CT_PATH); + if (ct && !ct.asText().includes('PartName="/docProps/custom.xml"')) { + const updated = ct + .asText() + .replace( + /<\/Types>/, + ` \n`, + ); + zip.file(CT_PATH, updated); + } + const rels = zip.file(RELS_PATH); + if (rels && !rels.asText().includes('Target="docProps/custom.xml"')) { + const match = rels.asText().match(/Id="rId(\d+)"/g); + const maxId = match ? Math.max(...match.map((item) => Number(item.match(/\d+/)[0]))) : 0; + const updated = rels + .asText() + .replace( + /<\/Relationships>/, + ` \n`, + ); + zip.file(RELS_PATH, updated); + } +} + +// --------------------------------------------------------------------------- + +const options = parseArgs(process.argv.slice(2)); +const source = readFileSync(options.file); + +if (source.subarray(0, 2).toString("latin1") !== "PK") { + console.error(`✗ ${options.file} ไม่ใช่ไฟล์ .docx (zip)`); + process.exit(1); +} + +const zip = new PizZip(source); + +if (options.list) { + const custom = zip.file(CUSTOM_PATH); + if (!custom) { + console.log(`(ไม่มี ${CUSTOM_PATH} ในไฟล์นี้)`); + } else { + for (const property of readProperties(custom.asText())) { + console.log(`${property.name} = ${property.value}`); + } + } + process.exit(0); +} + +const ticketData = buildTicketData(options); +const hmac = createHmac("sha256", options.secret).update(ticketData, "utf8").digest("hex"); +if (ticketData.length > 255) { + console.warn(`⚠ ticket_data ยาว ${ticketData.length} ตัวอักษร — เกินขีดจำกัด ~255 ของ Word custom property อาจถูกตัด`); +} + +const entries = [ + { name: "ticket_data", value: ticketData }, + { name: "HmacSha256", value: hmac }, +]; +if (options.tracked) { + entries.push({ name: "SavedByAddIn", value: ADDIN_SIGNATURE_GUID }); + entries.push({ name: "DocumentTrackingId", value: options.trackingId ?? randomUUID() }); +} + +const existing = zip.file(CUSTOM_PATH); +zip.file(CUSTOM_PATH, upsertProperties(existing ? existing.asText() : "", entries)); +ensurePartRegistered(zip); + +const output = zip.generate({ type: "nodebuffer", compression: "DEFLATE" }); +const target = options.inPlace + ? options.file + : `${options.file.replace(/\.docx$/i, "")}.ticket.docx`; +writeFileSync(target, output); + +console.log(`✓ stamp ticket ลง ${path.relative(process.cwd(), target)}${options.inPlace ? " (ทับไฟล์เดิม)" : ""}`); +console.log(` ticket_data : ${ticketData}`); +console.log(` HmacSha256 : ${hmac}`); +console.log(` secret : ${options.secret}`); +console.log(` exp : ${new Date(resolveExp(options.exp) * 1000).toLocaleString("th-TH")}`); diff --git a/tests/lib/addin-ticket.test.ts b/tests/lib/addin-ticket.test.ts new file mode 100644 index 0000000..5c75931 --- /dev/null +++ b/tests/lib/addin-ticket.test.ts @@ -0,0 +1,148 @@ +import { createHmac } from "node:crypto"; +import { describe, expect, it } from "vitest"; + +import { + addinTicketSecret, + parseTicketTokenBody, + ticketToDocverClaims, + verifyAddinTicket, +} from "@/lib/addin-ticket"; + +// PLAN-ADDIN-AUTH.md §3 — pure ล้วน (verifyAddinTicket รับ secret ทาง parameter) +// ไม่แตะ @/db/minio — รันได้โดยไม่ต้องตั้ง env อะไร (เหมือน docver-token.test.ts) + +const SECRET = "super_secret"; + +/** ตัว ticket ตัวอย่าง — key เรียงตามตัวอักษรเหมือนตัว stamp จริง (sortObjectKeys ของ lib-utils) */ +const TICKET_DATA = JSON.stringify({ + exp: Math.floor(Date.now() / 1000) + 300, + fid: "T12_FD155_3s-long_ZZZ", + tid: "T12", + uid: "oom", + uname: "สรวิชญ์", +}); + +function sign(message: string, secret: string = SECRET): string { + return createHmac("sha256", secret).update(message, "utf8").digest("hex"); +} + +function ok(result: { ok: boolean } & T): asserts result is { ok: true } & T { + expect(result.ok).toBe(true); +} + +describe("verifyAddinTicket", () => { + it("ticket ถูกต้อง + HMAC ตรง = ผ่าน ได้ ticket แกะแล้ว", () => { + const result = verifyAddinTicket(TICKET_DATA, sign(TICKET_DATA), SECRET); + ok(result); + expect(result.ticket.fid).toBe("T12_FD155_3s-long_ZZZ"); + expect(result.ticket.uid).toBe("oom"); + expect(result.ticket.tid).toBe("T12"); + }); + + it("HMAC ผิด (แก้ ticket 1 ตัวอักษร / secret ผิด / digest เพี้ยน) = ไม่ผ่านทุกกรณี", () => { + const digest = sign(TICKET_DATA); + const tampered = `${TICKET_DATA.slice(0, -2)}xx}`; + expect(verifyAddinTicket(tampered, digest, SECRET).ok).toBe(false); + expect(verifyAddinTicket(TICKET_DATA, sign(TICKET_DATA, "wrong-secret"), SECRET).ok).toBe(false); + const flipped = `${digest.slice(0, -1)}${digest.endsWith("0") ? "1" : "0"}`; + expect(verifyAddinTicket(TICKET_DATA, flipped, SECRET).ok).toBe(false); + }); + + it("digest รูปไม่ใช่ (ไม่ใช่ hex / สั้น / ว่าง) = ไม่ผ่าน · uppercase hex normalize แล้วผ่านได้", () => { + expect(verifyAddinTicket(TICKET_DATA, "zz".repeat(32), SECRET).ok).toBe(false); + expect(verifyAddinTicket(TICKET_DATA, "abcd", SECRET).ok).toBe(false); + expect(verifyAddinTicket(TICKET_DATA, "", SECRET).ok).toBe(false); + expect(verifyAddinTicket(TICKET_DATA, sign(TICKET_DATA).toUpperCase(), SECRET).ok).toBe(true); + }); + + it("ticket หมดอายุ (exp อดีต / เท่ากับ now) = ไม่ผ่าน แม้ HMAC ถูก", () => { + const now = Math.floor(Date.now() / 1000); + for (const exp of [now - 1, now]) { + const expired = JSON.stringify({ exp, fid: "f", uid: "u", uname: "n" }); + expect(verifyAddinTicket(expired, sign(expired), SECRET, now).ok, `exp=${exp}`).toBe(false); + } + const alive = JSON.stringify({ exp: now + 1, fid: "f", uid: "u", uname: "n" }); + expect(verifyAddinTicket(alive, sign(alive), SECRET, now).ok).toBe(true); + }); + + it("HMAC ถูกแต่ ticket ผิดกติกา (field หลุด allowlist / exp ไม่ใช่ integer) = ไม่ผ่าน", () => { + const extra = JSON.stringify({ exp: Math.floor(Date.now() / 1000) + 60, fid: "f", uid: "u", uname: "n", oops: 1 }); + expect(verifyAddinTicket(extra, sign(extra), SECRET).ok).toBe(false); + const badExp = JSON.stringify({ exp: "123", fid: "f", uid: "u", uname: "n" }); + expect(verifyAddinTicket(badExp, sign(badExp), SECRET).ok).toBe(false); + }); +}); + +describe("ticketToDocverClaims", () => { + it("แปลง uid→userid, uname→username, tid→template · tid ไม่มี = null", () => { + expect( + ticketToDocverClaims({ exp: 1, fid: "F1", tid: "T12", uid: "oom", uname: "สรวิชญ์" }), + ).toEqual({ userid: "oom", username: "สรวิชญ์", fid: "F1", template: "T12" }); + expect( + ticketToDocverClaims({ exp: 1, fid: "F1", tid: null, uid: "oom", uname: "สรวิชญ์" }), + ).toEqual({ userid: "oom", username: "สรวิชญ์", fid: "F1", template: null }); + }); +}); + +describe("parseTicketTokenBody", () => { + it("ครบทั้งคู่ = ได้ค่าตรง ๆ (ไม่แตะค่า — HMAC ต้องคำนวณบน string ดิบ)", () => { + const digest = sign(TICKET_DATA); + const result = parseTicketTokenBody({ ticket_data: TICKET_DATA, HmacSha256: digest }); + ok(result); + expect(result.ticketData).toBe(TICKET_DATA); + expect(result.hmacHex).toBe(digest); + }); + + it("ไม่ใช่ object / มี field อื่นปน = invalid (→ 400)", () => { + for (const raw of [[], "text", null, { ticket_data: "x", HmacSha256: "y", extra: 1 }]) { + const result = parseTicketTokenBody(raw); + expect(result.ok, JSON.stringify(raw)).toBe(false); + if (!result.ok) expect(result.kind).toBe("invalid"); + } + }); + + it("ขาด field (ไม่ส่ง/ว่าง/null) = missing (→ 401 กัน oracle)", () => { + for (const raw of [{}, { ticket_data: "" }, { HmacSha256: "y" }, { ticket_data: null, HmacSha256: "y" }]) { + const result = parseTicketTokenBody(raw); + expect(result.ok, JSON.stringify(raw)).toBe(false); + if (!result.ok) expect(result.kind).toBe("missing"); + } + }); + + it("field ไม่ใช่ string / ยาวเกิน cap = invalid", () => { + for (const raw of [ + { ticket_data: 123, HmacSha256: "y" }, + { ticket_data: "x", HmacSha256: "y".repeat(129) }, + { ticket_data: "x".repeat(2049), HmacSha256: "y" }, + ]) { + const result = parseTicketTokenBody(raw); + expect(result.ok, JSON.stringify(raw)).toBe(false); + if (!result.ok) expect(result.kind).toBe("invalid"); + } + }); +}); + +describe("addinTicketSecret", () => { + // env save/restore — addinTicketSecret อ่านตอนเรียก + const ORIG_ADDIN = process.env.ADDIN_TICKET_SECRET; + const ORIG_SECRET = process.env.SECRET; + + it("ลำดับ ADDIN_TICKET_SECRET → SECRET → default \"super_secret\" (trim ทุกตัว)", () => { + delete process.env.ADDIN_TICKET_SECRET; + delete process.env.SECRET; + expect(addinTicketSecret()).toBe("super_secret"); + + process.env.SECRET = " tmpl-secret "; + expect(addinTicketSecret()).toBe("tmpl-secret"); + + process.env.ADDIN_TICKET_SECRET = " addin-secret "; + expect(addinTicketSecret()).toBe("addin-secret"); + + delete process.env.ADDIN_TICKET_SECRET; + process.env.SECRET = " "; // ว่างล้วน = ข้ามไปตัวถัดไป + expect(addinTicketSecret()).toBe("super_secret"); + + process.env.ADDIN_TICKET_SECRET = ORIG_ADDIN; + process.env.SECRET = ORIG_SECRET; + }); +}); diff --git a/tests/lib/document-versioning.test.ts b/tests/lib/document-versioning.test.ts index 635fb84..a8d13a4 100644 --- a/tests/lib/document-versioning.test.ts +++ b/tests/lib/document-versioning.test.ts @@ -6,7 +6,6 @@ import { docverError, isDocxBytes, isPdfBytes, - parseDocId, parseDownloadFormat, parseFieldsJson, parseVersionIdParam, @@ -23,28 +22,6 @@ function ok(result: { ok: boolean } & T): asserts result is { ok: true } & T expect(result.ok).toBe(true); } -describe("parseDocId", () => { - it("รับ GUID / รหัส e-Court / charset ที่อนุญาตทั้งหมด และ trim รอบ ๆ", () => { - for (const raw of [ - "123e4567-e89b-12d3-a456-426614174000", - "ecourt:123", - "DOC_2026.10", - " doc1 ", - "a".repeat(200), - ]) { - const result = parseDocId(raw); - ok(result); - expect(result.docId).toBe(raw.trim()); - } - }); - - it("ตกเมื่อว่าง / เกิน 200 / มีช่องว่างกลาง / ไทย / slash / '..'", () => { - for (const raw of ["", " ", "a".repeat(201), "doc 1", "เอกสาร1", "a/b", "..", "a\\b"]) { - expect(parseDocId(raw).ok).toBe(false); - } - }); -}); - describe("parseVersionIdParam", () => { it("รับ UUID ทั้งพิมพ์ใหญ่/เล็ก (normalize ลงตัวพิมพ์เล็ก) + trim", () => { const result = parseVersionIdParam(" 6F9619FF-8B86-D011-B42D-00C04FC964FF "); @@ -112,11 +89,11 @@ describe("parseFieldsJson", () => { }); describe("parseVersionUploadForm", () => { + // identity (userId/userName) กับ templateId ถอดออกจาก form แล้ว — route แกะจาก + // Bearer token ผ่าน lib/docver-token.ts (เคสของ token อยู่ docver-token.test.ts) function baseForm(): FormData { const form = new FormData(); form.append("file", new File([Buffer.from("PK\x03\x04")], "draft.docx")); - form.append("userId", "u0001"); - form.append("userName", "สมชาย ใจดี"); return form; } @@ -124,17 +101,13 @@ describe("parseVersionUploadForm", () => { const form = baseForm(); form.append("clientVersionId", " 11111111-1111-4111-8111-111111111111 "); form.append("message", " "); - form.append("templateId", "tmpl-main"); form.append("fields", '{"blackno":"1"}'); form.append("fileName", "C:\\Users\\judge\\คำสั่งเรียก.docx"); const result = parseVersionUploadForm(form); ok(result); expect(result.form).toEqual({ - userId: "u0001", - userName: "สมชาย ใจดี", clientVersionId: "11111111-1111-4111-8111-111111111111", message: null, - templateId: "tmpl-main", fileName: "คำสั่งเรียก.docx", fields: { blackno: "1" }, }); @@ -148,22 +121,22 @@ describe("parseVersionUploadForm", () => { if (!result.ok) expect(result.error).toContain("oops"); }); - it("ตกเมื่อขาด userId หรือ userName (stand-alone บอกผู้อัปโหลดเอง)", () => { - const noUser = baseForm(); - noUser.delete("userId"); - expect(parseVersionUploadForm(noUser).ok).toBe(false); - const noName = baseForm(); - noName.delete("userName"); - expect(parseVersionUploadForm(noName).ok).toBe(false); + it("ส่ง userId/userName/templateId ใน form = 400 ไม่รู้จัก field (identity มาจาก token)", () => { + for (const legacy of ["userId", "userName", "templateId"]) { + const form = baseForm(); + form.append(legacy, "x"); + const result = parseVersionUploadForm(form); + expect(result.ok).toBe(false); + if (!result.ok) expect(result.error).toContain(legacy); + } }); it("ตกเมื่อ text field ถูกส่งมาเป็นไฟล์", () => { const form = baseForm(); - form.delete("userId"); - form.append("userId", new File(["x"], "u.txt")); + form.append("message", new File(["x"], "m.txt")); const result = parseVersionUploadForm(form); expect(result.ok).toBe(false); - if (!result.ok) expect(result.error).toContain("userId"); + if (!result.ok) expect(result.error).toContain("message"); }); it(`message ยาว ${DOCVER_MESSAGE_MAX} ผ่าน แต่เกิน = ตก`, () => { @@ -180,6 +153,25 @@ describe("parseVersionUploadForm", () => { form.append("fields", '{"a":1}'); expect(parseVersionUploadForm(form).ok).toBe(false); }); + + it("ค่าของ fields ไม่จำกัดความยาว (เอกสาร 100–200 หน้า — 2026-10-27) · key รับได้ถึง 1,000", () => { + const big = baseForm(); + big.append("fields", JSON.stringify({ detail1: "พ".repeat(1_000_000) })); + expect(parseVersionUploadForm(big).ok).toBe(true); + + const manyKeys = baseForm(); + manyKeys.append( + "fields", + JSON.stringify(Object.fromEntries(Array.from({ length: 1_000 }, (_, i) => [`tag${i}`, "x"]))), + ); + expect(parseVersionUploadForm(manyKeys).ok).toBe(true); + const over = baseForm(); + over.append( + "fields", + JSON.stringify(Object.fromEntries(Array.from({ length: 1_001 }, (_, i) => [`tag${i}`, "x"]))), + ); + expect(parseVersionUploadForm(over).ok).toBe(false); + }); }); describe("sanitizeDisplayFileName / sanitizeFilePartName", () => { diff --git a/tests/lib/docver-token.test.ts b/tests/lib/docver-token.test.ts new file mode 100644 index 0000000..6b2a5ab --- /dev/null +++ b/tests/lib/docver-token.test.ts @@ -0,0 +1,316 @@ +import { createHmac } from "node:crypto"; +import { afterEach, describe, expect, it } from "vitest"; + +import { + issueDocverToken, + parseTokenRequestBody, + requireDocverApiKey, + requireDocverBearer, + verifyDocverToken, + type DocverTokenClaims, +} from "@/lib/docver-token"; + +// docver token (PLAN-DOCVER.md §auth) — validation/auth ล้วนของ /api/documents/*: +// ไฟล์นี้ตั้งใจไม่แตะ module ใดที่ลาก @/db หรือ minio มาด้วย (pattern เดียวกับ +// external-api-auth.test.ts — vitest ไม่โหลด .env จึงต้องรันได้โดยไม่ต้องตั้ง +// DATABASE_URL/MINIO_*) + +const SECRET = "test-secret-docver"; +const CLAIMS: DocverTokenClaims = { + userid: "123", + username: "Sorawit Bholsithi", + fid: "3", + template: "T12", +}; + +function ok(result: { ok: boolean } & T): asserts result is { ok: true } & T { + expect(result.ok).toBe(true); +} + +// --- env save/restore — require* อ่าน env ตอนเรียก ไม่ใช่ตอน module load +const HAD_API_KEY = Object.prototype.hasOwnProperty.call(process.env, "DOCVER_API_KEY"); +const ORIG_API_KEY = process.env.DOCVER_API_KEY; +const HAD_SECRET = Object.prototype.hasOwnProperty.call(process.env, "DOCVER_TOKEN_SECRET"); +const ORIG_SECRET = process.env.DOCVER_TOKEN_SECRET; + +afterEach(() => { + if (HAD_API_KEY) process.env.DOCVER_API_KEY = ORIG_API_KEY; + else delete process.env.DOCVER_API_KEY; + if (HAD_SECRET) process.env.DOCVER_TOKEN_SECRET = ORIG_SECRET; + else delete process.env.DOCVER_TOKEN_SECRET; +}); + +function reqWithKey(key?: string): Request { + return new Request("http://localhost/docedit/api/documents/token", { + headers: key === undefined ? {} : { "x-api-key": key }, + }); +} + +function reqWithBearer(authorization: string | null): Request { + return new Request("http://localhost/docedit/api/documents/doc1/versions", { + headers: authorization === null ? {} : { authorization }, + }); +} + +async function bodyOf(res: Response): Promise<{ error: string }> { + expect(res.headers.get("content-type")).toBe("application/json; charset=utf-8"); + return (await res.json()) as { error: string }; +} + +/** เซ็น payload ใด ๆ ด้วย SECRET ผ่านมือ — ใช้ประกอบเคส claims ผิดรูปที่ issueDocverToken สร้างเองไม่ได้ */ +function signPayload(payload: Record): string { + const header = Buffer.from(JSON.stringify({ alg: "HS256", typ: "JWT" }), "utf8").toString( + "base64url", + ); + const body = Buffer.from(JSON.stringify(payload), "utf8").toString("base64url"); + const signature = createHmac("sha256", SECRET) + .update(`${header}.${body}`) + .digest("base64url"); + return `${header}.${body}.${signature}`; +} + +describe("issueDocverToken / verifyDocverToken", () => { + it("issue → verify ได้ claims ครบทุกตัว (userid/username/fid/template)", () => { + const verified = verifyDocverToken(issueDocverToken(CLAIMS, SECRET, 60), SECRET); + ok(verified); + expect(verified.claims).toEqual(CLAIMS); + }); + + it("template เป็นทางเลือก (null ได้) แต่ fid บังคับ — token ไม่มี fid = ไม่ผ่าน", () => { + const verified = verifyDocverToken( + issueDocverToken({ userid: "u1", username: "ชื่อ", fid: "7", template: null }, SECRET, 60), + SECRET, + ); + ok(verified); + expect(verified.claims).toEqual({ userid: "u1", username: "ชื่อ", fid: "7", template: null }); + const noFid = signPayload({ + userid: "u1", + username: "n", + template: "T1", + iat: 0, + exp: Math.floor(Date.now() / 1000) + 60, + }); + expect(verifyDocverToken(noFid, SECRET).ok).toBe(false); + }); + + it("แก้ payload แล้วใช้ signature เดิม (tampered) หรือ secret ผิด = ไม่ผ่าน", () => { + const token = issueDocverToken(CLAIMS, SECRET, 60); + const [header, , signature] = token.split("."); + const tamperedPayload = Buffer.from( + JSON.stringify({ ...CLAIMS, userid: "999" }), + "utf8", + ).toString("base64url"); + expect(verifyDocverToken(`${header}.${tamperedPayload}.${signature}`, SECRET).ok).toBe(false); + expect(verifyDocverToken(token, "wrong-secret").ok).toBe(false); + }); + + it("header alg อื่น (none / HS512) = ไม่ผ่าน แม้จะเซ็นด้วย secret ถูก (กัน alg-confusion)", () => { + const body = Buffer.from( + JSON.stringify({ ...CLAIMS, iat: 0, exp: Math.floor(Date.now() / 1000) + 60 }), + "utf8", + ).toString("base64url"); + for (const alg of ["none", "HS512"]) { + const header = Buffer.from(JSON.stringify({ alg, typ: "JWT" }), "utf8").toString("base64url"); + const signature = createHmac("sha256", SECRET) + .update(`${header}.${body}`) + .digest("base64url"); + expect(verifyDocverToken(`${header}.${body}.${signature}`, SECRET).ok).toBe(false); + } + }); + + it("token หมดอายุ (ttl ติดลบ) หรือไม่มี exp = ไม่ผ่าน", () => { + expect(verifyDocverToken(issueDocverToken(CLAIMS, SECRET, -10), SECRET).ok).toBe(false); + const noExp = signPayload({ ...CLAIMS, iat: Math.floor(Date.now() / 1000) }); + expect(verifyDocverToken(noExp, SECRET).ok).toBe(false); + }); + + it("claims ไม่ครบรูปร่าง (แม้เซ็นถูก) = ไม่ผ่าน — กัน token เซ็นเองหลุดไปใช้", () => { + const now = Math.floor(Date.now() / 1000) + 60; + for (const bad of [ + { username: "n", fid: "3", template: null, iat: 0, exp: now }, // ไม่มี userid + { userid: "u", fid: "3", template: null, iat: 0, exp: now }, // ไม่มี username + { userid: "", username: "n", fid: "3", template: null, iat: 0, exp: now }, // userid ว่าง + { userid: "u", username: "n", fid: 3, template: null, iat: 0, exp: now }, // fid เป็น number + { userid: "u", username: "n", fid: "", template: null, iat: 0, exp: now }, // fid ว่าง + { userid: "u", username: "n", template: null, iat: 0, exp: now }, // ไม่มี fid (บังคับแล้ว) + { userid: "u", username: "n", fid: null, template: null, iat: 0, exp: now }, // fid null + ]) { + expect(verifyDocverToken(signPayload(bad), SECRET).ok).toBe(false); + } + }); + + it("รูป token ผิด (ไม่ใช่ 3 segment / segment เป็น base64 ปกติไม่ใช่ base64url) = ไม่ผ่าน", () => { + expect(verifyDocverToken("not-a-jwt", SECRET).ok).toBe(false); + expect(verifyDocverToken("a.b.c.d", SECRET).ok).toBe(false); + // base64 ปกติมี + / ซึ่ง base64url decode แล้วได้ byte ผิด → header/payload พัง + expect(verifyDocverToken("???.???.???", SECRET).ok).toBe(false); + }); +}); + +describe("requireDocverApiKey", () => { + it("env ไม่ตั้ง / ว่าง / ช่องว่างล้วน = 401 fail closed ทุกกรณี", async () => { + for (const value of [undefined, "", " "]) { + if (value === undefined) delete process.env.DOCVER_API_KEY; + else process.env.DOCVER_API_KEY = value; + const res = requireDocverApiKey(reqWithKey("test-key")); + expect(res?.status).toBe(401); + expect(await bodyOf(res!)).toEqual({ error: "ระบบยังไม่ได้ตั้งค่า API key" }); + } + }); + + it("ไม่ใส่ header กับ key ผิด ต้องได้ 401 ข้อความเดียวกันเป๊ะ (กัน enumerate)", async () => { + process.env.DOCVER_API_KEY = "test-key"; + const missing = requireDocverApiKey(reqWithKey()); + const wrong = requireDocverApiKey(reqWithKey("not-the-key")); + expect(missing?.status).toBe(401); + expect(wrong?.status).toBe(401); + expect(await bodyOf(missing!)).toEqual(await bodyOf(wrong!)); + }); + + it("key ตรง = ผ่าน (คืน null) · env มี whitespace รอบ ๆ ก็ trim ให้เทียบได้", () => { + process.env.DOCVER_API_KEY = "test-key"; + expect(requireDocverApiKey(reqWithKey("test-key"))).toBeNull(); + process.env.DOCVER_API_KEY = " test-key "; + expect(requireDocverApiKey(reqWithKey("test-key"))).toBeNull(); + }); +}); + +describe("requireDocverBearer", () => { + it("ทุกกรณีพ้นสภาพ (ไม่มี header / ไม่ใช่ Bearer / token เน่า / หมดอายุ / secret ไม่ตั้ง) = 401 ข้อความเดียวกัน", async () => { + const deniedBodies = new Set(); + const cases: { label: string; secret: string | undefined; authorization: string | null }[] = [ + { label: "ไม่มี Authorization", secret: SECRET, authorization: null }, + { label: "scheme อื่น (Basic)", secret: SECRET, authorization: "Basic dXNlcjpwYXNz" }, + { label: "Bearer ว่างเปล่า", secret: SECRET, authorization: "Bearer " }, + { label: "token เน่า", secret: SECRET, authorization: "Bearer garbage.token.here" }, + { + label: "token หมดอายุ", + secret: SECRET, + authorization: `Bearer ${issueDocverToken(CLAIMS, SECRET, -10)}`, + }, + { + label: "เซ็นด้วย secret ผิด", + secret: SECRET, + authorization: `Bearer ${issueDocverToken(CLAIMS, "other-secret", 60)}`, + }, + { label: "secret ไม่ตั้ง (fail closed)", secret: undefined, authorization: null }, + { + label: "secret ไม่ตั้งแม้จะมี token ถูก", + secret: undefined, + authorization: `Bearer ${issueDocverToken(CLAIMS, SECRET, 60)}`, + }, + ]; + for (const testCase of cases) { + if (testCase.secret === undefined) delete process.env.DOCVER_TOKEN_SECRET; + else process.env.DOCVER_TOKEN_SECRET = testCase.secret; + const auth = requireDocverBearer(reqWithBearer(testCase.authorization)); + expect(auth.ok, testCase.label).toBe(false); + if (!auth.ok) { + expect(auth.response.status, testCase.label).toBe(401); + deniedBodies.add(JSON.stringify(await bodyOf(auth.response))); + } + } + expect(deniedBodies.size).toBe(1); // ข้อความ 401 เดียวกันหมด — ไม่ใช้ endpoint เป็น oracle + }); + + it("Bearer ที่ verify ผ่าน = ได้ claims · คำว่า bearer พิมพ์เล็กก็รับ (case-insensitive)", () => { + process.env.DOCVER_TOKEN_SECRET = SECRET; + const token = issueDocverToken(CLAIMS, SECRET, 60); + const auth = requireDocverBearer(reqWithBearer(`Bearer ${token}`)); + ok(auth); + expect(auth.claims).toEqual(CLAIMS); + const lower = requireDocverBearer(reqWithBearer(`bearer ${token}`)); + ok(lower); + expect(lower.claims).toEqual(CLAIMS); + }); + + it("env มี whitespace รอบ secret ก็ trim แล้ว verify ได้", () => { + process.env.DOCVER_TOKEN_SECRET = ` ${SECRET} `; + const auth = requireDocverBearer( + reqWithBearer(`Bearer ${issueDocverToken(CLAIMS, SECRET, 60)}`), + ); + ok(auth); + expect(auth.claims).toEqual(CLAIMS); + }); +}); + +describe("parseTokenRequestBody", () => { + it("ครบทุก field = ได้ claims (trim ค่า) · template ไม่ส่ง = null (fid บังคับ)", () => { + const full = parseTokenRequestBody({ + userid: " 123 ", + username: " Sorawit Bholsithi ", + fid: " 3 ", + template: " T12 ", + }); + ok(full); + expect(full.claims).toEqual({ userid: "123", username: "Sorawit Bholsithi", fid: "3", template: "T12" }); + + const minimal = parseTokenRequestBody({ userid: "123", username: "Sorawit", fid: "3" }); + ok(minimal); + expect(minimal.claims).toEqual({ userid: "123", username: "Sorawit", fid: "3", template: null }); + }); + + it("template ส่งมาเป็นช่องว่าง = null (ถือว่าไม่ส่ง)", () => { + const result = parseTokenRequestBody({ userid: "123", username: "n", fid: "3", template: " " }); + ok(result); + expect(result.claims.template).toBeNull(); + }); + + it("ไม่ใช่ object (array / string / null) = 400", () => { + for (const raw of [[], "text", null]) { + const result = parseTokenRequestBody(raw); + expect(result.ok).toBe(false); + if (!result.ok) expect(result.error).toBe("body ต้องเป็น JSON object"); + } + }); + + it("key อื่นนอก allowlist = 400 ไม่รู้จัก field (กัน typo เงียบ ๆ)", () => { + const result = parseTokenRequestBody({ userid: "1", username: "n", oops: 1 }); + expect(result.ok).toBe(false); + if (!result.ok) expect(result.error).toContain("oops"); + }); + + it("ขาด userid หรือ username / ส่งมาไม่ใช่ string = 400 ข้อความเฉพาะ field", () => { + for (const raw of [ + { username: "n" }, + { userid: " ", username: "n" }, + { userid: 123, username: "n" }, + { userid: "1" }, + { userid: "1", username: "" }, + ]) { + const result = parseTokenRequestBody(raw); + expect(result.ok).toBe(false); + if (!result.ok) { + expect(result.error).toMatch(/ต้องระบุ (userid|username)/); + } + } + }); + + it("fid ขาด/null/ว่าง/ไม่ใช่ string (number) หรือ template ไม่ใช่ string = 400", () => { + const missing = parseTokenRequestBody({ userid: "1", username: "n" }); + expect(missing.ok).toBe(false); + if (!missing.ok) expect(missing.error).toContain("fid"); + for (const raw of [ + { userid: "1", username: "n", fid: null }, + { userid: "1", username: "n", fid: 3 }, + { userid: "1", username: "n", fid: "" }, + { userid: "1", username: "n", fid: " " }, + { userid: "1", username: "n", template: 12 }, + ]) { + expect(parseTokenRequestBody(raw).ok).toBe(false); + } + }); + + it("ความยาวเกิน cap: userid > 100 / username > 200 / fid > 200 / template > 100 = 400", () => { + expect(parseTokenRequestBody({ userid: "a".repeat(101), username: "n" }).ok).toBe(false); + expect( + parseTokenRequestBody({ userid: "1", username: "a".repeat(201) }).ok, + ).toBe(false); + expect( + parseTokenRequestBody({ userid: "1", username: "n", fid: "a".repeat(201) }).ok, + ).toBe(false); + expect( + parseTokenRequestBody({ userid: "1", username: "n", template: "a".repeat(101) }).ok, + ).toBe(false); + }); +}); diff --git a/tests/utils/docver-ticket.test.ts b/tests/utils/docver-ticket.test.ts new file mode 100644 index 0000000..bdde305 --- /dev/null +++ b/tests/utils/docver-ticket.test.ts @@ -0,0 +1,118 @@ +import { describe, expect, it } from "vitest"; + +import { + isTicketExpired, + normalizeHexDigest, + parseDocverTicket, + timingSafeEqualHex, +} from "@/utils/docver-ticket"; + +// PLAN-ADDIN-AUTH.md §4 — pure ล้วนไม่แตะ env/DB อะไรเลย +// รูป ticket_data อ้างอิงจากตัว stamp จริงของกลุ่ม template (app/api/template/ +// render/route.ts applyTemplate — key เรียงตามตัวอักษรหลังเติม exp) + +const VALID = JSON.stringify({ + exp: 1793067433, + fid: "T12_FD155_3s-long_ZZZ", + tid: "T12", + uid: "oom", + uname: "สรวิชญ์", +}); + +function ok(result: { ok: boolean } & T): asserts result is { ok: true } & T { + expect(result.ok).toBe(true); +} + +describe("parseDocverTicket", () => { + it("ticket ครบทุก field = แกะได้ (trim ค่า string)", () => { + const result = parseDocverTicket(VALID); + ok(result); + expect(result.ticket).toEqual({ + exp: 1793067433, + fid: "T12_FD155_3s-long_ZZZ", + tid: "T12", + uid: "oom", + uname: "สรวิชญ์", + }); + }); + + it("tid optional — ไม่ส่ง/ส่งค่าว่าง = null", () => { + const noTid = parseDocverTicket(JSON.stringify({ exp: 1, fid: "f", uid: "u", uname: "n" })); + ok(noTid); + expect(noTid.ticket.tid).toBeNull(); + const blankTid = parseDocverTicket( + JSON.stringify({ exp: 1, fid: "f", tid: " ", uid: "u", uname: "n" }), + ); + ok(blankTid); + expect(blankTid.ticket.tid).toBeNull(); + }); + + it("JSON ไม่ผ่าน / ไม่ใช่ object (array/string/null) = ไม่ผ่าน", () => { + for (const raw of ["not json", "[1,2]", '"text"', "null", "{}"]) { + expect(parseDocverTicket(raw).ok, raw).toBe(false); + } + }); + + it("field อื่นนอก allowlist = ไม่ผ่าน (กัน typo/field หลุดจาก spec)", () => { + const result = parseDocverTicket(JSON.stringify({ exp: 1, fid: "f", uid: "u", uname: "n", oops: 1 })); + expect(result.ok).toBe(false); + if (!result.ok) expect(result.error).toContain("oops"); + }); + + it("exp ไม่ใช่จำนวนเต็ม / หาย / uid-uname-fid หายหรือไม่ใช่ string = ไม่ผ่าน", () => { + for (const ticket of [ + { fid: "f", uid: "u", uname: "n" }, // ไม่มี exp + { exp: "1793067433", fid: "f", uid: "u", uname: "n" }, // exp เป็น string + { exp: 1.5, fid: "f", uid: "u", uname: "n" }, // exp ไม่ใช่ integer + { exp: 1, uid: "u", uname: "n" }, // ไม่มี fid + { exp: 1, fid: "f", uname: "n" }, // ไม่มี uid + { exp: 1, fid: "f", uid: "u" }, // ไม่มี uname + { exp: 1, fid: "", uid: "u", uname: "n" }, // fid ว่าง + { exp: 1, fid: 3, uid: "u", uname: "n" }, // fid เป็น number + { exp: 1, fid: "f", uid: "u", uname: "n", tid: 12 }, // tid ไม่ใช่ string + ]) { + expect(parseDocverTicket(JSON.stringify(ticket)).ok, JSON.stringify(ticket)).toBe(false); + } + }); + + it("ความยาวเกิน cap: uid > 100 / uname > 200 / fid > 200 / tid > 100 = ไม่ผ่าน", () => { + expect(parseDocverTicket(JSON.stringify({ exp: 1, fid: "f", uid: "u".repeat(101), uname: "n" })).ok).toBe(false); + expect(parseDocverTicket(JSON.stringify({ exp: 1, fid: "f", uid: "u", uname: "n".repeat(201) })).ok).toBe(false); + expect(parseDocverTicket(JSON.stringify({ exp: 1, fid: "f".repeat(201), uid: "u", uname: "n" })).ok).toBe(false); + expect(parseDocverTicket(JSON.stringify({ exp: 1, fid: "f", uid: "u", uname: "n", tid: "t".repeat(101) })).ok).toBe(false); + }); +}); + +describe("isTicketExpired", () => { + it("exp อนาคต = ยังไม่หมด · exp ตรง now พอดี/อดีต = หมดแล้ว", () => { + const now = 1_793_000_000; + expect(isTicketExpired(now + 1, now)).toBe(false); + expect(isTicketExpired(now, now)).toBe(true); + expect(isTicketExpired(now - 1, now)).toBe(true); + }); +}); + +describe("normalizeHexDigest", () => { + const HEX64 = "1dc53fbd48410845c895ddb841a8fe4ad93da413126fae9c688202e57f2baaa9"; + + it("hex lowercase ครบ 64 = ผ่าน · trim และ uppercase ก็ normalize ให้", () => { + expect(normalizeHexDigest(HEX64)).toBe(HEX64); + expect(normalizeHexDigest(` ${HEX64} `)).toBe(HEX64); + expect(normalizeHexDigest(HEX64.toUpperCase())).toBe(HEX64); + }); + + it("รูปไม่ใช่ (สั้น/ยาว/ไม่ใช่ hex/ว่าง) = null", () => { + for (const bad of ["", "abc", `${HEX64}00`, `g${HEX64.slice(1)}`, " "]) { + expect(normalizeHexDigest(bad), bad).toBeNull(); + } + }); +}); + +describe("timingSafeEqualHex", () => { + it("ค่าเท่ากัน = true ต่างกัน = false · ความยาวไม่เท่า = false ทันที", () => { + const a = "ab".repeat(32); + expect(timingSafeEqualHex(a, a)).toBe(true); + expect(timingSafeEqualHex(a, "cd".repeat(32))).toBe(false); + expect(timingSafeEqualHex(a, "ab")).toBe(false); + }); +}); diff --git a/tests/wordaddin/ticket-auth-flow.test.ts b/tests/wordaddin/ticket-auth-flow.test.ts new file mode 100644 index 0000000..250a5fa --- /dev/null +++ b/tests/wordaddin/ticket-auth-flow.test.ts @@ -0,0 +1,116 @@ +// @vitest-environment jsdom +// ticket auth ของ add-in (PLAN-ADDIN-AUTH.md §5) — คุมพฤติกรรม service layer: +// happy-path ขอ token ครั้งเดียวต่อ fid, เปิดเอกสารเดิมซ้ำใช้ token เดิมไม่ยิง /token ซ้ำ, +// memory fallback ของ session, และทุก fail path ต้องคืน result ไม่ใช่ throw +// (jsdom ไม่มี crypto.subtle — ฉีด webcrypto ของ node แทน secure context ของ webview จริง) +import { createHmac, webcrypto } from "node:crypto"; +import { afterEach, describe, expect, it, vi } from "vitest"; + +import * as authService from "@/wordaddin/services/authService"; +import * as ticketService from "@/wordaddin/services/ticketService"; + +// จับ error ทุกทาง (window error / unhandled rejection) — flow ต้องไม่ปล่อยอะไรหลุดเลย +const errors: unknown[] = []; +function trapErrors() { + window.addEventListener("error", (event) => errors.push(event.error ?? event.message)); + window.addEventListener("unhandledrejection", (event) => errors.push(event.reason)); +} + +function makeTicket(): { ticketData: string; ticketHmac: string } { + const ticket = { + exp: Math.floor(Date.now() / 1000) + 300, + fid: "DBG_FID_001", + tid: "T12", + uid: "oom", + uname: "สรวิชญ์", + }; + const ticketData = JSON.stringify(ticket); + const ticketHmac = createHmac("sha256", "super_secret").update(ticketData, "utf8").digest("hex"); + return { ticketData, ticketHmac }; +} + +afterEach(() => { + window.localStorage.clear(); + // memory fallback ของ session เป็น module state — เคลียร์ด้วยไม่งั้นค้างข้ามเคส + ticketService.clearSession(); + authService.signInForDemo(); // รีเซ็ต state ของ authService (username/fid/ticket) + vi.restoreAllMocks(); + vi.unstubAllGlobals(); + errors.length = 0; +}); + +describe("signInWithTicket (service layer)", () => { + it("B: signInWithTicket happy-path (มี crypto.subtle + fetch ตอบ 200) ไม่ต้อง throw", async () => { + trapErrors(); + // jsdom ไม่มี crypto.subtle — ใส่ webcrypto ของ node แทน (secure context ของ webview จริงมีอยู่แล้ว) + vi.stubGlobal("crypto", webcrypto); + + const { ticketData, ticketHmac } = makeTicket(); + const fetchMock = vi.fn( + async () => + new Response( + JSON.stringify({ + access_token: [ + "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9", + Buffer.from( + JSON.stringify({ userid: "oom", fid: "DBG_FID_001", exp: Math.floor(Date.now() / 1000) + 3600 }), + ).toString("base64url"), + "sig", + ].join("."), + token_type: "Bearer", + expires_in: 3600, + }), + { status: 200, headers: { "content-type": "application/json" } }, + ), + ); + vi.stubGlobal("fetch", fetchMock); + + const first = await authService.signInWithTicket({ ticketData, ticketHmac }); + expect(first.ok, JSON.stringify(first)).toBe(true); + + // เปิดเอกสารเดิมซ้ำ — ต้องไม่ยิง /token ซ้ำ (ใช้ token เดิมจาก localStorage) + await authService.signInWithTicket({ ticketData, ticketHmac }); + expect(fetchMock).toHaveBeenCalledTimes(1); + + expect(errors).toEqual([]); + expect(window.localStorage.getItem("wordaddin-auth")).toBeTruthy(); + }); + + it("C: signInWithTicket แบบไม่มี crypto.subtle (webview เก่า) ต้องจบเป็น no-access ไม่ใช่ throw", async () => { + trapErrors(); + const noSubtle = { getRandomValues: () => new Uint8Array(0) }; + vi.stubGlobal("crypto", noSubtle); // ไม่มี .subtle เลย + const { ticketData, ticketHmac } = makeTicket(); + const result = await authService.signInWithTicket({ ticketData, ticketHmac }); + expect(result.ok).toBe(false); + expect(errors).toEqual([]); + }); + + it("D: ticket ผิดทุกแบบ (ขาด/hex เพี้ยน/parse ไม่ผ่าน/หมดอายุ/fetch 401) ต้องคืน result ไม่ใช่ throw", async () => { + trapErrors(); + vi.stubGlobal("crypto", webcrypto); + vi.stubGlobal( + "fetch", + vi.fn(async () => new Response(JSON.stringify({ error: "no" }), { status: 401 })), + ); + const { ticketData, ticketHmac } = makeTicket(); + const bad = [ + { ticketData: undefined, ticketHmac: undefined }, + { ticketData: "not-json", ticketHmac }, + { ticketData, ticketHmac: "zz".repeat(32) }, + { + ticketData: JSON.stringify({ exp: 1, fid: "f", uid: "u", uname: "n" }), // หมดอายุ + HMAC ถูก + ticketHmac: createHmac("sha256", "super_secret") + .update(JSON.stringify({ exp: 1, fid: "f", uid: "u", uname: "n" }), "utf8") + .digest("hex"), + }, + { ticketData, ticketHmac }, // ถูก แต่ server 401 → token-request-failed + ] satisfies { ticketData?: string; ticketHmac?: string }[]; + for (const input of bad) { + const result = await authService.signInWithTicket(input); + expect(result.ok, JSON.stringify(input)).toBe(false); + if (!result.ok) expect(typeof result.message).toBe("string"); + } + expect(errors).toEqual([]); + }); +}); diff --git a/tests/wordaddin/versioningService.test.ts b/tests/wordaddin/versioningService.test.ts new file mode 100644 index 0000000..4de9046 --- /dev/null +++ b/tests/wordaddin/versioningService.test.ts @@ -0,0 +1,209 @@ +// @vitest-environment jsdom +// versioningService หลังปลด mock (2026-10-27) — คุมทั้งสองโหมด: +// - ของจริง: sign-in ผ่าน signInWithTicket ให้ได้ Bearer ก่อน แล้วตรวจ FormData ของ +// uploadVersion ตรง contract POST /api/documents/versions (ห้ามส่ง userId/userName/ +// templateId — identity มาจาก Bearer หมด), getVersions แปลง DTO, getDownloadLink ใส่ ?format= +// - โหมด ?addindemo: ใช้ mock ในเครื่อง (ไม่ยิง network เลย) +import { createHmac, webcrypto } from "node:crypto"; +import { afterEach, describe, expect, it, vi } from "vitest"; + +import * as authService from "@/wordaddin/services/authService"; +import * as ticketService from "@/wordaddin/services/ticketService"; +import { + getDownloadLink, + getVersions, + uploadVersion, +} from "@/wordaddin/services/versioningService"; + +const TOKEN = "header.payload.sig"; // ค่าหยง ๆ ก็ได้ — apiClient แนบตรง ๆ ไม่ decode + +/** sign-in จริงผ่าน signInWithTicket (fetch ตอบ token 1 ครั้ง) — real mode + มี Bearer ใน session */ +async function signInReal(): Promise { + vi.stubGlobal("crypto", webcrypto); // jsdom ไม่มี crypto.subtle + const ticket = { + exp: Math.floor(Date.now() / 1000) + 300, + fid: "REAL_FID_001", + uid: "oom", + uname: "สรวิชญ์", + }; + const ticketData = JSON.stringify(ticket); + const ticketHmac = createHmac("sha256", "super_secret").update(ticketData, "utf8").digest("hex"); + vi.stubGlobal( + "fetch", + vi.fn( + async () => + new Response( + JSON.stringify({ access_token: TOKEN, token_type: "Bearer", expires_in: 3600 }), + { status: 200, headers: { "content-type": "application/json" } }, + ), + ), + ); + const result = await authService.signInWithTicket({ ticketData, ticketHmac }); + expect(result.ok, JSON.stringify(result)).toBe(true); + vi.unstubAllGlobals(); +} + +describe("versioningService (real mode)", () => { + it("uploadVersion สร้าง multipart ตรง contract + แนบ Bearer ผ่าน apiClient + parse ผล", async () => { + await signInReal(); + const fetchMock = vi.fn( + async (_url: string, _init?: RequestInit) => + new Response( + JSON.stringify({ hasPdf: true, versionId: "v-1", versionNumber: 3 }), + { status: 200, headers: { "content-type": "application/json" } }, + ), + ); + vi.stubGlobal("fetch", fetchMock); + + const docx = new Blob(["PK\x03\x04 docx"], { + type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document", + }); + const pdf = new Blob(["%PDF-"], { type: "application/pdf" }); + const result = await uploadVersion( + "doc-guid-ไม่ส่งถึง-server", + docx, + "client-vid-1", + { blackno: "ด1" }, + "คำฟ้อง.docx", + " แก้ไขย่อหน้า 3 ", + pdf, + "T12-ไม่ส่งถึง-server", + ); + + expect(result).toEqual({ hasPdf: true, versionId: "v-1", versionNumber: 3 }); + expect(fetchMock).toHaveBeenCalledTimes(1); + const [url, init] = fetchMock.mock.calls[0] as [string, RequestInit]; + // same-origin ผ่าน withBasePath (ใน vitest env NEXT_PUBLIC_BASE_PATH ว่าง — Next inline ตอน build + // เท่านั้น จึง assert เฉพาะ path ที่อยู่หลัง basePath) + expect(url.endsWith("/api/documents/versions")).toBe(true); + expect(init.method).toBe("POST"); + expect((init.headers as Headers).get("authorization")).toBe(`Bearer ${TOKEN}`); + const form = init.body as FormData; + expect(form.get("file")).toBeInstanceOf(File); + expect((form.get("file") as File).name).toBe("คำฟ้อง.docx"); + expect((form.get("pdf") as File).name).toBe("document.pdf"); + expect(form.get("clientVersionId")).toBe("client-vid-1"); + expect(JSON.parse(form.get("fields") as string)).toEqual({ blackno: "ด1" }); + expect(form.get("message")).toBe("แก้ไขย่อหน้า 3"); // trim แล้ว + // contract 2026-10-22: ห้ามมี field identity/template เหลืออยู่เลย + expect(form.has("userId")).toBe(false); + expect(form.has("userName")).toBe(false); + expect(form.has("templateId")).toBe(false); + }); + + it("pdf ว่าง/ไม่แนบ = ไม่ append field pdf (ไฟล์เปล่า = version ไม่มี PDF)", async () => { + await signInReal(); + const fetchMock = vi.fn( + async (_url: string, _init?: RequestInit) => + new Response(JSON.stringify({ hasPdf: false, versionId: "v-2", versionNumber: 1 }), { status: 200 }), + ); + vi.stubGlobal("fetch", fetchMock); + await uploadVersion("d", new Blob(["PK"]), "cv", undefined, undefined, undefined, new Blob([])); + const form = (fetchMock.mock.calls[0] as unknown[])[1] as RequestInit; + expect((form.body as FormData).has("pdf")).toBe(false); + }); + + it("getVersions แปลง DocumentVersionDTO → VersionRecord ครบทุก field", async () => { + await signInReal(); + const fetchMock = vi.fn( + async (_url: string, _init?: RequestInit) => + new Response( + JSON.stringify([ + { + versionId: "v-9", + versionNumber: 9, + createdAt: "2026-10-27T05:00:00Z", + createdByUserId: "oom", + createdByUserName: "สรวิชญ์", + contentHash: "ab", + fields: { blackno: "ด1" }, + message: null, + hasPdf: true, + }, + ]), + { status: 200 }, + ), + ); + vi.stubGlobal("fetch", fetchMock); + const rows = await getVersions("anything"); + expect(rows).toEqual([ + { + versionId: "v-9", + versionNumber: 9, + createdAt: "2026-10-27T05:00:00Z", + createdByUserId: "oom", + createdByUserName: "สรวิชญ์", + contentHash: "ab", + fields: { blackno: "ด1" }, + message: null, + hasPdf: true, + }, + ]); + }); + + it("getDownloadLink ใส่ ?format=pdf · format docx/ไม่ส่ง = ไม่มี query", async () => { + await signInReal(); + const fetchMock = vi.fn( + async (_url: string, _init?: RequestInit) => + new Response(JSON.stringify({ url: "http://minio/x", expiresAt: "2026-10-27T06:00:00Z" }), { status: 200 }), + ); + vi.stubGlobal("fetch", fetchMock); + await getDownloadLink("d", "v-9", "pdf"); + expect(String(fetchMock.mock.calls[0][0]).endsWith("/api/documents/versions/v-9/download-link?format=pdf")).toBe(true); + await getDownloadLink("d", "v-9"); + expect(String(fetchMock.mock.calls[1][0]).endsWith("/api/documents/versions/v-9/download-link")).toBe(true); + await getDownloadLink("d", "v-9", "docx"); + expect(String(fetchMock.mock.calls[2][0]).endsWith("/api/documents/versions/v-9/download-link")).toBe(true); + }); + + it("โดน 401 แล้ว renew ไม่สำเร็จ = AuthRequiredError (ไม่ใช่ error อื่น)", async () => { + await signInReal(); + // fetch ตอบ 401 ทุกอัน (ทั้ง request หลักและการ renew token จาก ticket) + vi.stubGlobal("fetch", vi.fn(async () => new Response("{}", { status: 401 }))); + await expect(getVersions("d")).rejects.toMatchObject({ name: "AuthRequiredError" }); + }); + + it("404 จาก history (เอกสารยังไม่เคยมี version เช่น stamp ค้างสมัย mock) = list ว่าง ไม่ใช่ error", async () => { + await signInReal(); + vi.stubGlobal( + "fetch", + vi.fn( + async (_url: string, _init?: RequestInit) => + new Response(JSON.stringify({ error: "ไม่พบเอกสารนี้ในระบบ (ยังไม่เคยอัปโหลด version)" }), { status: 404 }), + ), + ); + await expect(getVersions("d")).resolves.toEqual([]); + }); +}); + +// โหมด demo ไว้ท้ายสุด — signInForDemo เปิด flag ค้างใน module จนกว่าจะ sign-in จริง +describe("versioningService (demo mode = mock)", () => { + it("signInForDemo แล้วใช้ mock ในเครื่อง — ไม่ยิง network และ persist ตาม documentId", async () => { + authService.signInForDemo(); + const fetchMock = vi.fn(); + vi.stubGlobal("fetch", fetchMock); + + const first = await uploadVersion("demo-doc", new Blob(["PK"]), "cv1", undefined, undefined, "vแรก"); + const second = await uploadVersion("demo-doc", new Blob(["PK2"]), "cv2"); + expect(first.versionNumber).toBe(1); + expect(second.versionNumber).toBe(2); + + const rows = await getVersions("demo-doc"); + expect(rows.map((row) => row.versionNumber)).toEqual([2, 1]); // ใหม่ → เก่า + expect(rows[0].message).toBeNull(); + expect(rows[1].message).toBe("vแรก"); + + const link = await getDownloadLink("demo-doc", rows[0].versionId, "pdf"); + expect(link.url).toBe("about:blank"); + expect(fetchMock).not.toHaveBeenCalled(); + expect(window.localStorage.getItem("wordaddin-mock-versions")).toBeTruthy(); + }); +}); + +afterEach(() => { + window.localStorage.clear(); + ticketService.clearSession(); + authService.signInForDemo(); // รีเซ็ต authService ให้มี username เสมอ (เคสถัดไป sign-in ใหม่เอง) + vi.restoreAllMocks(); + vi.unstubAllGlobals(); +}); diff --git a/utils/docver-ticket.ts b/utils/docver-ticket.ts new file mode 100644 index 0000000..14130c6 --- /dev/null +++ b/utils/docver-ticket.ts @@ -0,0 +1,136 @@ +// PLAN-ADDIN-AUTH.md §4 — ticket ของ add-in (custom properties `ticket_data` + +// `HmacSha256` ที่ e-Court ผ่านกลุ่ม template stamp ลงไฟล์) — ส่วน pure ที่ +// ใช้ร่วมกันทั้งฝั่ง server (lib/addin-ticket.ts — route /api/documents/token) +// และฝั่ง client ของ add-in (wordaddin/services/ticketService.ts) +// +// กติกา (docs/requirement/addin-workflow.md + lib/lib-utils.ts generateHmacSha256 +// ของตัว stamp ฝั่ง template): +// - ticket_data เป็น JSON string ตามที่ stamp ไว้เป๊ะ (key เรียงตามตัวอักษร +// หลังเติม exp) — **HMAC ต้องคำนวณบน string ดิบนี้ ห้าม trim/normalize** +// - HmacSha256 เป็น hex lowercase 64 ตัว (การเทียบ normalize เป็น lowercase +// ให้ก่อน — ฝั่ง stamp ตัวพิมพ์ใหญ่ก็ผ่านได้) +// - ห้าม import อะไรที่เป็น platform-specific (node:crypto/crypto.subtle) — +// module นี้ต้องรันได้ทั้งใน route handler และ webview ของ Word โดยส่ง +// ตัวคำนวณ HMAC เข้ามาทาง parameter แทน + +/** ticket ที่แกะจาก ticket_data — ชื่อ field ตามที่ e-Court กำหนด (requirement) */ +export interface DocverTicket { + /** หมดอายุเมื่อไร — unix epoch วินาที */ + exp: number; + /** fileId ของ e-Court — เป็น docId ของทุก operation ของกลุ่ม docver ตรง ๆ */ + fid: string; + /** template ต้นทาง — optional (ไม่มี = null) */ + tid: string | null; + /** รหัสผู้ใช้ → claim `userid` */ + uid: string; + /** ชื่อผู้ใช้ → claim `username` */ + uname: string; +} + +/** ความยาว cap ต่อ field — ตาม parseTokenRequestBody ของ /api/documents/token */ +const TICKET_LIMITS = { + uid: 100, + uname: 200, + fid: 200, + tid: 100, +} as const; + +/** allowlist ของ ticket_data — field อื่นปนมา = reject (กัน typo เงียบ ๆ ตาม convention ของ repo) */ +const TICKET_FIELDS = ["exp", "fid", "tid", "uid", "uname"] as const; + +export type DocverTicketParseResult = + | { ok: true; ticket: DocverTicket } + | { ok: false; error: string }; + +/** + * แกะ + ตรวจ ticket จาก string ดิบของ property `ticket_data` + * คืนค่าที่ trim แล้ว (uid/uname/fid/tid) — exp เป็น number ตรง ๆ + */ +export function parseDocverTicket(raw: string): DocverTicketParseResult { + let parsed: unknown; + try { + parsed = JSON.parse(raw); + } catch { + return { ok: false, error: "ticket_data ไม่ใช่ JSON ที่ถูกต้อง" }; + } + if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) { + return { ok: false, error: "ticket_data ต้องเป็น JSON object" }; + } + const record = parsed as Record; + for (const key of Object.keys(record)) { + if (!(TICKET_FIELDS as readonly string[]).includes(key)) { + return { + ok: false, + error: `ticket_data มี field ที่ไม่รู้จัก '${key}' (รับเฉพาะ ${TICKET_FIELDS.join(", ")})`, + }; + } + } + + const exp = record.exp; + if (typeof exp !== "number" || !Number.isSafeInteger(exp)) { + return { ok: false, error: "ticket_data ต้องมี exp เป็นจำนวนเต็ม (unix วินาที)" }; + } + + const field = (name: "uid" | "uname" | "fid"): string | null => { + const value = record[name]; + if (typeof value !== "string" || value.trim() === "") { + return null; + } + const trimmed = value.trim(); + return trimmed.length <= TICKET_LIMITS[name] ? trimmed : null; + }; + + const uid = field("uid"); + if (uid === null) return { ok: false, error: "ticket_data ต้องมี uid (string 1–100)" }; + const uname = field("uname"); + if (uname === null) return { ok: false, error: "ticket_data ต้องมี uname (string 1–200)" }; + const fid = field("fid"); + if (fid === null) return { ok: false, error: "ticket_data ต้องมี fid (string 1–200)" }; + + let tid: string | null = null; + if (record.tid !== undefined) { + if (typeof record.tid !== "string") { + return { ok: false, error: "ticket_data ของ tid ต้องเป็น string" }; + } + const trimmed = record.tid.trim(); + if (trimmed !== "") { + if (trimmed.length > TICKET_LIMITS.tid) { + return { ok: false, error: "ticket_data ของ tid ยาวเกิน 100 ตัวอักษร" }; + } + tid = trimmed; + } + } + + return { ok: true, ticket: { exp, fid, tid, uid, uname } }; +} + +/** exp หมดอายุไหม — exp เท่ากับ now พอดีก็ถือว่าหมดแล้ว */ +export function isTicketExpired(exp: number, nowSec: number = Math.floor(Date.now() / 1000)): boolean { + return exp <= nowSec; +} + +/** + * normalize ค่า digest ที่ได้รับ (property `HmacSha256` / body field) — + * trim + lowercase แล้วตรวจว่าเป็น hex ครบ 64 ตัว คืน null เมื่อรูปไม่ใช่ + */ +export function normalizeHexDigest(value: string): string | null { + const normalized = value.trim().toLowerCase(); + return /^[0-9a-f]{64}$/.test(normalized) ? normalized : null; +} + +/** + * เทียบ hex digest สองค่าแบบ constant-time (best-effort ของ pure JS — + * ฝั่ง server จริงใช้ node:crypto timingSafeEqual ผ่าน lib/addin-ticket.ts + * ตัวนี้ใช้กับ UX gate ฝั่ง client เป็นหลัก) — ค่าที่ส่งเข้าควร normalize แล้ว + */ +export function timingSafeEqualHex(a: string, b: string): boolean { + if (a.length !== b.length) return false; + let diff = 0; + for (let i = 0; i < a.length; i++) { + diff |= a.charCodeAt(i) ^ b.charCodeAt(i); + } + return diff === 0; +} + +/** ตัวคำนวณ HMAC-SHA256 คืนค่าเป็น hex lowercase — สองฝั่งฉีดของตัวเอง (Web Crypto / node:crypto) */ +export type HmacSha256Hex = (message: string, secret: string) => Promise; diff --git a/wordaddin/config.ts b/wordaddin/config.ts index e142b70..646079e 100644 --- a/wordaddin/config.ts +++ b/wordaddin/config.ts @@ -2,12 +2,19 @@ * Config ของ wordaddin — ค่าจาก NEXT_PUBLIC_* env (Next inline ตอน build) * (ต้นฉบับ D:\word-addin-poc\addin inject ผ่าน webpack DefinePlugin — พอร์ตมาเป็น env ของ Next) * - * ช่วง mock: authService/versioningService เป็น mock ไม่ใช้ apiBaseUrl — + * ช่วง mock: versioningService เป็น mock ไม่ใช้ apiBaseUrl — * ตั้งค่านี้เมื่อปลด mock ต่อ backend จริง (ต้องเป็น HTTPS เสมอ — webview ของ Word บล็อก http) + * ส่วนการขอ token (ticket auth) ยิง same-origin /api/documents/token เสมอ ไม่ผูกกับ apiBaseUrl */ export const config = { /** base URL ของ backend API (ไม่มี slash ท้าย) — ว่าง = ยังไม่ต่อ backend จริง */ apiBaseUrl: process.env.NEXT_PUBLIC_ADDIN_API_BASE_URL ?? "", /** ชื่อผู้ใช้ของ mock auth — แสดงหน้า header + เป็น createdByUserId ของ version ที่ mock สร้าง */ mockUsername: process.env.NEXT_PUBLIC_ADDIN_MOCK_USERNAME ?? "tester01", + /** + * secret ตรวจ HMAC ของ ticket ฝั่ง client (UX gate — ตัดเคสไฟล์ถูกแก้ก่อนยิง network; + * ความมั่นคงจริงอยู่ที่ server ตรวจอีกชั้น เพราะค่าใน bundle สกัดได้) — ต้องตรงกับ + * ตัว stamp ของ e-Court และ env ADDIN_TICKET_SECRET/SECRET ฝั่ง server (PLAN-ADDIN-AUTH.md §7) + */ + ticketSecret: process.env.NEXT_PUBLIC_ADDIN_TICKET_SECRET ?? "super_secret", }; diff --git a/wordaddin/models/versionRecord.ts b/wordaddin/models/versionRecord.ts index 7af9352..3a1087d 100644 --- a/wordaddin/models/versionRecord.ts +++ b/wordaddin/models/versionRecord.ts @@ -32,6 +32,8 @@ export interface VersionRecord { /** ISO-8601 */ createdAt: string; createdByUserId: string; + /** ชื่อผู้สร้าง — ส่วนเสริมของ DTO กลุ่ม docver (mock/demo อาจไม่มี → UI fallback เป็น userId) */ + createdByUserName?: string; /** SHA256 hex */ contentHash: string; fields: FieldsSnapshot | null; diff --git a/wordaddin/services/apiClient.ts b/wordaddin/services/apiClient.ts index 59f9e06..0b4476e 100644 --- a/wordaddin/services/apiClient.ts +++ b/wordaddin/services/apiClient.ts @@ -1,18 +1,20 @@ import { config } from "../config"; +import { withBasePath } from "@/utils/base-path"; import * as authService from "./authService"; /** - * fetch wrapper ของ add-in — แนบ Bearer ทุก request - * โดน 401 → silent refresh แล้ว retry ครั้งเดียว; ยัง 401 → AuthRequiredError - * (UI จับ error นี้แล้วพากลับหน้า sign-in อย่างเนียน — AC-9) - * พอร์ตดิบจาก D:\word-addin-poc\addin\src\services\apiClient.ts + * fetch wrapper ของ add-in — แนบ Bearer ทุก request (access_token ที่ authService + * ขอจาก /api/documents/token ด้วย ticket ของไฟล์ — PLAN-ADDIN-AUTH.md) + * โดน 401 → ลองขอ token ใหม่จาก ticket แล้ว retry 1 ครั้ง ยังไม่ผ่าน → AuthRequiredError: + * UI จับ error นี้แล้วพาไปหน้า no-access ให้ขอไฟล์ใหม่จาก e-Court + * พอร์ตจาก D:\word-addin-poc\addin\src\services\apiClient.ts * (ช่วง mock ไม่มี caller จริง — เตรียมไว้ให้ versioningService วันปลด mock + AuthRequiredError * ถูก TaskpaneApp ใช้อยู่แล้ว) */ -/** บอกว่าต้องกลับไป login ใหม่ (ไม่มี token / refresh ไม่ได้ / 401 ซ้ำ) */ +/** บอกว่า ticket ใช้ไม่ได้แล้ว (หมดอายุ / token ขอไม่ได้) — ต้องได้ไฟล์ใหม่จาก e-Court */ export class AuthRequiredError extends Error { - constructor(message = "เซสชันหมดอายุ — ต้อง login ใหม่") { + constructor(message = "ticket ของ e-Court หมดอายุหรือไม่ถูกต้อง") { super(message); this.name = "AuthRequiredError"; } @@ -35,8 +37,15 @@ export interface ApiRequestOptions { body?: BodyInit | null; } +/** + * path เต็มเสมอ — ไม่ตั้ง `NEXT_PUBLIC_ADDIN_API_BASE_URL` = same-origin ผ่าน withBasePath + * (ได้ /docedit/api/… ถูกต้องตาม invariant #12 — API ของกลุ่ม docver อยู่แอปนี้เอง) + * · ตั้งค่า = ชี้ backend คนละ origin (ต้องรวม basePath แล้ว เช่น https://host/docedit — ใช้ตอน + * deploy add-in กับ API คนละตัว) และต้องเป็น HTTPS เสมอ (webview ของ Word บล็อก http) + */ function toUrl(path: string): string { - return path.startsWith("http") ? path : `${config.apiBaseUrl}${path}`; + if (path.startsWith("http")) return path; + return config.apiBaseUrl ? `${config.apiBaseUrl}${path}` : withBasePath(path); } async function doFetch( @@ -54,27 +63,30 @@ async function doFetch( } /** - * request พร้อม Bearer + retry-on-401 ครั้งเดียว - * Response ที่ได้คืนไปให้ caller เช็ค ok เอง (ยกเว้น 401 ที่ refresh ไม่ช่วย → AuthRequiredError) + * request พร้อม Bearer — โดน 401 → ขอ token ใหม่จาก ticket ของเอกสารปัจจุบัน + * (renewTokenFromTicket — ticket ยังไม่หมดอายุเท่านั้น) แล้ว retry 1 ครั้ง + * ยัง 401 อีก / renew ไม่ได้ = AuthRequiredError (UI พาไป no-access ให้ขอไฟล์ + * ใหม่จาก e-Court) · Response ที่ได้คืนไปให้ caller เช็ค ok เอง */ export async function apiFetch(path: string, options: ApiRequestOptions = {}): Promise { const accessToken = await authService.getAccessToken(); if (!accessToken) { throw new AuthRequiredError(); } - - let response = await doFetch(path, options, accessToken); - if (response.status === 401) { - const refreshedToken = await authService.refreshAccessToken(); - if (!refreshedToken) { - throw new AuthRequiredError(); - } - response = await doFetch(path, options, refreshedToken); - if (response.status === 401) { - throw new AuthRequiredError(); + const response = await doFetch(path, options, accessToken); + if (response.status !== 401) { + return response; + } + if (await authService.renewTokenFromTicket()) { + const retryToken = await authService.getAccessToken(); + if (retryToken) { + const retry = await doFetch(path, options, retryToken); + if (retry.status !== 401) { + return retry; + } } } - return response; + throw new AuthRequiredError(); } /** อ่าน error message จาก response body — backend error ส่วนใหญ่เป็น plain text, บางทีเป็น JSON problem details */ diff --git a/wordaddin/services/authService.ts b/wordaddin/services/authService.ts index 7cd7509..6904876 100644 --- a/wordaddin/services/authService.ts +++ b/wordaddin/services/authService.ts @@ -1,97 +1,188 @@ /** - * MOCK — แทน Keycloak OIDC/PKCE ของต้นฉบับ (ผู้ใช้งานเลือกไม่ใช้ Keycloak ช่วงพอร์ต) - * ต้นฉบับ: D:\word-addin-poc\addin\src\services\authService.ts (login ผ่าน Office Dialog API, - * token เก็บใน memory เท่านั้น, auto-refresh) + * Auth ของ add-in — e-Court ticket ทางเข้าเดียว (PLAN-ADDIN-AUTH.md §5 ตาม + * docs/requirement/addin-workflow.md) * - * วันสลับเป็น auth จริง: เขียน implementation ใหม่โดยคง export surface ด้านล่างครบทุกตัว - * (เพิ่ม refreshAccessToken ที่ต้นฉบับมีอยู่แล้วสำหรับ apiClient) — โค้ดอื่นไม่ต้องแตะ + * ไม่มี login ใน add-in: ไฟล์ที่ e-Court stamp custom properties `ticket_data` + * + `HmacSha256` มา (ผ่านกลุ่ม template) = ผ่านเข้าได้ — signInWithTicket ตรวจ + * HMAC → exp → session ใน localStorage ตาม uid/fid แล้วขอ access_token จาก + * /api/documents/token เก็บตาม fid ("คีย์คือ fid") + * + * token เก็บใน localStorage (ข้าม session ได้ — กลับมาเปิดเอกสารเดิมไม่ต้องขอใหม่ + * ตาม requirement ขั้น 7) ส่วน ticket ดิบของเอกสารปัจจุบันเก็บใน memory ไว้ renew + * ตอน token หมดอายุกลาง session */ import { config } from "../config"; +import { isTicketExpired, parseDocverTicket } from "@/utils/docver-ticket"; +import * as ticketService from "./ticketService"; -/** discriminated union เหมือนต้นฉบับ — ok:false ต้องมี error เสมอ */ -export type LoginResult = { ok: true } | { ok: false; error: string }; +/** สาเหตุที่เข้าไม่ได้ — UI แยกข้อความตาม reason (TaskpaneApp) */ +export type SignInFailureReason = "missing" | "tampered" | "expired" | "token-request-failed"; -/** state เดียวของ mock — null = signed out */ +export type SignInResult = { ok: true } | { ok: false; reason: SignInFailureReason; message: string }; + +/** state ของ taskpane instance นี้ (ต่อเอกสารที่เปิด) — null = ยังไม่ได้ sign in */ let username: string | null = null; -/** token จาก custom properties ของไฟล์ (e-Court pass-through) — เก็บใน memory เท่านั้น */ -let docToken: string | null = null; +/** fid ของเอกสารปัจจุบัน — token ที่ใช้ผูกกับ fid นี้เสมอ */ +let currentFid: string | null = null; +/** ticket ดิบของเอกสารปัจจุบัน — ไว้ขอ token ใหม่ตอน 401/token หมดอายุ */ +let currentTicket: { data: string; hmac: string } | null = null; +/** โหมด ?addindemo (dev-only) — เปิดโดย signInForDemo เท่านั้น */ +let demoMode = false; -function delay(ms: number): Promise { - return new Promise((resolve) => setTimeout(resolve, ms)); -} - -/** จำลองเปิดหน้าต่าง login — สำเร็จทันที ตั้งชื่อจาก NEXT_PUBLIC_ADDIN_MOCK_USERNAME */ -export async function login(): Promise { - await delay(300); - username = config.mockUsername; - return { ok: true }; -} - -/** mock-only — โหมด ?addindemo ใช้ตั้ง session ทันทีไม่ผ่านปุ่ม Sign in */ +/** dev-only — โหมด ?addindemo ของ WordAddinGate ใช้ตั้ง session ทันทีไม่อ่านไฟล์จริง */ export function signInForDemo(): void { username = config.mockUsername; + currentFid = null; + currentTicket = null; + demoMode = true; } -/** ถอด field จาก JWT payload (base64url) โดยไม่ตรวจ signature — ใช้ดู uid ประกอบชื่อผู้ใช้เท่านั้น */ -function decodeJwtField(token: string, field: string): string | undefined { - const payload = token.split(".")[1]; - if (!payload) return undefined; - try { - // atob คืน binary string (1 char = 1 byte) — ต้องถอด UTF-8 ด้วย TextDecoder ก่อน JSON.parse - // ไม่งั้น uid ที่ไม่ใช่ ASCII (เช่น ชื่อไทย) จะกลายเป็น mojibake - const bytes = Uint8Array.from(atob(payload.replace(/-/g, "+").replace(/_/g, "/")), (char) => char.charCodeAt(0)); - const json: unknown = JSON.parse(new TextDecoder().decode(bytes)); - const value = typeof json === "object" && json !== null ? (json as Record)[field] : undefined; - return typeof value === "string" && value !== "" ? value : undefined; - } catch { - return undefined; - } +/** โหมด ?addindemo หรือเปล่า — versioningService ใช้ mock แทน backend จริงเฉพาะโหมดนี้ */ +export function isDemoMode(): boolean { + return demoMode; } /** - * e-Court pass-through (ระยะแรก) — ไฟล์ที่ e-Court stamp `token`/`owner` ไว้ใน custom properties - * ใช้งานได้เลยโดยไม่ต้องกด login: username จาก owner → uid ใน token → mockUsername - * คืน true = ผ่านเข้าได้ (มี token หรือ owner อย่างน้อยหนึ่งตัว) + * e-Court ticket — จุดเข้าเดียวของ auth ตอนเปิดเอกสาร (requirement ขั้น 1–7): + * 1. ตรวจมี ticket_data + HmacSha256 ครบ + * 2. parse + ตรวจ HMAC ฝั่ง client (UX gate) + * 3. session ใน localStorage: ยังไม่มี/user ใหม่ → ตรวจ exp → เคลียร์ session เก่า + * แล้วขอ token ใหม่ · user เดิม + fid เดิม → ผ่านเลย (renew เงียบ ๆ ถ้า token + * หมดอายุแต่ ticket ยังไม่หมด) · user เดิม + fid ใหม่ → ตรวจ exp → ขอ token เก็บเพิ่ม */ -export function signInFromDocument(input: { token?: string; owner?: string }): boolean { - const token = input.token?.trim() || undefined; - const owner = input.owner?.trim() || (token ? decodeJwtField(token, "uid") : undefined); - if (!token && !owner) { +export async function signInWithTicket(input: { + ticketData?: string; + ticketHmac?: string; +}): Promise { + const ticketData = input.ticketData ?? ""; + const ticketHmac = input.ticketHmac ?? ""; + // Word custom property จำกัด value ~255 ตัวอักษร — เกิน = ไฟล์เสียหาย (ถูกตัด) + if (ticketData === "" || ticketHmac === "" || ticketData.length > 255 || ticketHmac.length > 255) { + return { + ok: false, + reason: "missing", + message: "ไม่พบ ticket ของ e-Court ในไฟล์ — add-in ใช้ได้กับเอกสารที่ส่งมาจาก e-Court เท่านั้น", + }; + } + + const parsed = parseDocverTicket(ticketData); + if (!parsed.ok) { + return { + ok: false, + reason: "tampered", + message: "ตรวจสอบ ticket ไม่ผ่าน (รูปแบบไม่ถูกต้อง) — ไฟล์ถูกแก้ไขหรือเสียหาย", + }; + } + if (!(await ticketService.verifyTicketHmacWeb(ticketData, ticketHmac, config.ticketSecret))) { + return { + ok: false, + reason: "tampered", + message: "ตรวจสอบลายเซ็น (HMAC) ของ ticket ไม่ผ่าน — ไฟล์ถูกแก้ไข", + }; + } + const ticket = parsed.ticket; + const ticketAlive = !isTicketExpired(ticket.exp); + + const session = ticketService.loadSession(); + if (session === null || session.userId !== ticket.uid) { + // ไม่มี session / user ใหม่ — ตรวจ exp ก่อนแล้วเริ่ม session ใหม่ทั้งก้อน + if (!ticketAlive) { + return { + ok: false, + reason: "expired", + message: "ticket ของ e-Court หมดอายุ — โปรดขอไฟล์ใหม่จาก e-Court แล้วเปิดอีกครั้ง", + }; + } + ticketService.clearSession(); + let entry: ticketService.SessionTokenEntry; + try { + entry = await ticketService.requestDocverToken(ticketData, ticketHmac); + } catch { + return { + ok: false, + reason: "token-request-failed", + message: "ขอ token จากระบบไม่สำเร็จ — ตรวจการเชื่อมต่อแล้วเปิดเอกสารอีกครั้ง", + }; + } + ticketService.saveSession({ userId: ticket.uid, userName: ticket.uname, tokens: { [ticket.fid]: entry } }); + } else { + // คนเดิม — userName อัปเดตตามไฟล์ล่าสุด (ชื่อเปลี่ยนได้) + session.userName = ticket.uname; + let entry = session.tokens[ticket.fid] ?? null; + if (entry !== null && ticketService.isTokenExpired(entry)) { + // token หมดอายุ — renew ได้เฉพาะตอน ticket ยังไม่หมด; ticket หมดด้วยก็เก็บของ + // เก่าไว้ (requirement ขั้น 7: ผ่านเลยไม่ตรวจ exp) ให้ server ตัดสินตอนใช้งาน + if (ticketAlive) { + try { + entry = await ticketService.requestDocverToken(ticketData, ticketHmac); + session.tokens[ticket.fid] = entry; + } catch { + // ใช้ token เก่าต่อ — ถ้าเน่าจริง apiClient จะ 401 → renew-retry → no-access + } + } + } + if (entry === null) { + // เอกสารใหม่ของคนเดิม — ตรวจ exp แล้วขอ token เก็บเพิ่ม + if (!ticketAlive) { + return { + ok: false, + reason: "expired", + message: "ticket ของ e-Court หมดอายุ — โปรดขอไฟล์ใหม่จาก e-Court แล้วเปิดอีกครั้ง", + }; + } + try { + session.tokens[ticket.fid] = await ticketService.requestDocverToken(ticketData, ticketHmac); + } catch { + return { + ok: false, + reason: "token-request-failed", + message: "ขอ token จากระบบไม่สำเร็จ — ตรวจการเชื่อมต่อแล้วเปิดเอกสารอีกครั้ง", + }; + } + } + ticketService.saveSession(session); + } + + currentFid = ticket.fid; + currentTicket = { data: ticketData, hmac: ticketHmac }; + username = ticket.uname; + demoMode = false; // sign-in จริงเคลียร์โหมด demo (ถ้าเคยเปิดค้างใน page เดียวกัน) + return { ok: true }; +} + +/** + * ขอ token ใหม่จาก ticket ของเอกสารปัจจุบัน (ticket ต้องยังไม่หมดอายุ) — + * เรียกจาก apiClient ตอนโดน 401 ก่อน throw AuthRequiredError 1 รอบ + * คืน true = ได้ token ใหม่เรียบร้อย (getAccessToken จะเห็นค่าใหม่) + */ +export async function renewTokenFromTicket(): Promise { + if (currentTicket === null || currentFid === null) return false; + const parsed = parseDocverTicket(currentTicket.data); + if (!parsed.ok || isTicketExpired(parsed.ticket.exp)) return false; + try { + const entry = await ticketService.requestDocverToken(currentTicket.data, currentTicket.hmac); + const session = + ticketService.loadSession() ?? + { userId: parsed.ticket.uid, userName: parsed.ticket.uname, tokens: {} }; + session.userName = parsed.ticket.uname; + session.tokens[parsed.ticket.fid] = entry; + ticketService.saveSession(session); + return true; + } catch { return false; } - username = owner ?? config.mockUsername; - docToken = token ?? null; - return true; } +/** Bearer ของ apiClient — token ของ fid ปัจจุบัน (stale ได้ — apiClient เป็นคนตัดสิน 401) */ export async function getAccessToken(): Promise { - if (docToken) return docToken; + if (currentFid !== null) { + return ticketService.loadSession()?.tokens[currentFid]?.token ?? null; + } + // demo mode (?addindemo) — ไม่มี ticket ใช้ token ปลอมเหมือนเดิม return username ? `mock-token-${username}` : null; } -/** mock: token ไม่มีวันหมดอายุจริง — คืนตัวเดิมหรือ null ตามสถานะ login */ -export async function refreshAccessToken(): Promise { - return getAccessToken(); -} - export function getUsername(): string | undefined { return username ?? undefined; } - -export function isTokenValid(): boolean { - return username !== null; -} - -export function hasRefreshToken(): boolean { - return username !== null; -} - -export function startAutoRefresh(): void { - // mock: ไม่มีอะไรต้อง refresh -} - -export function signOut(): void { - username = null; - docToken = null; -} diff --git a/wordaddin/services/metadataService.ts b/wordaddin/services/metadataService.ts index 1119a3b..68a8693 100644 --- a/wordaddin/services/metadataService.ts +++ b/wordaddin/services/metadataService.ts @@ -23,9 +23,10 @@ export const LAST_VERSION_TIMESTAMP_PROPERTY = "LastVersionTimestamp"; /** FR-16 — stamp เฉพาะไฟล์ร่าง (draft) ที่เว็บสร้าง: template ต้นทาง (ค่าเดียวกับ AddInMetadata.TemplateIdPropertyName ฝั่ง backend) */ export const TEMPLATE_ID_PROPERTY = "TemplateId"; -/** e-Court pass-through — ไฟล์ที่ e-Court stamp มาใน custom properties เข้าใช้ได้เลยไม่ต้องกด login */ -export const ECOURT_TOKEN_PROPERTY = "token"; -export const ECOURT_OWNER_PROPERTY = "owner"; +/** e-Court ticket — ไฟล์ที่ e-Court stamp คู่นี้มาใน custom properties คือ auth ทางเข้าเดียวของ add-in + * (PLAN-ADDIN-AUTH.md §2: HMAC-SHA256(secret, ticket_data ดิบ) เป็น hex lowercase 64 ตัว) */ +export const TICKET_DATA_PROPERTY = "ticket_data"; +export const TICKET_HMAC_PROPERTY = "HmacSha256"; /** ค่า property ที่หาไม่เจอเป็น `undefined` (ไม่ใช่ throw) */ export interface TrackedDocumentProperties { @@ -35,9 +36,9 @@ export interface TrackedDocumentProperties { lastVersionTimestamp?: string; /** มีเฉพาะไฟล์ร่าง (FR-16) — ส่งต่อให้ backend ตอน Start Versioning เพื่อผูก Document กับ template */ templateId?: string; - /** e-Court pass-through — มีอย่างใดอย่างหนึ่ง = ข้ามหน้า login (username จาก owner หรือ uid ใน token) */ - ecourtToken?: string; - ecourtOwner?: string; + /** e-Court ticket — มีครบทั้งคู่ = ตรวจ HMAC แล้วเข้าใช้งานได้ (auth ทางเข้าเดียว) */ + ticketData?: string; + ticketHmac?: string; } /** item ใน Custom XML Part `` */ @@ -49,7 +50,7 @@ export interface XmlVersionEntry { } /** อ่าน custom properties ทั้ง 7 ตัวที่ระบบสนใจ (4 ตัวของ tracked + TemplateId ของไฟล์ร่าง FR-16 - * + token/owner ที่ e-Court stamp มากับไฟล์) */ + * + ticket_data/HmacSha256 ที่ e-Court stamp มากับไฟล์) */ export async function readTrackedProperties(): Promise { return Word.run(async (context) => { const properties = context.document.properties.customProperties; @@ -58,16 +59,16 @@ export async function readTrackedProperties(): Promise @@ -81,8 +82,8 @@ export async function readTrackedProperties(): Promise; +} + +/** memory fallback — ใช้เมื่อ localStorage โดน block (webview บางตัว/private mode) */ +let memorySession: AddinSession | null = null; + +function parseSession(raw: string | null): AddinSession | null { + if (!raw) return null; + try { + const parsed = JSON.parse(raw) as AddinSession; + if ( + typeof parsed.userId !== "string" || + typeof parsed.userName !== "string" || + parsed.userId === "" || + typeof parsed.tokens !== "object" || + parsed.tokens === null || + Array.isArray(parsed.tokens) + ) { + return null; + } + for (const entry of Object.values(parsed.tokens)) { + if (typeof entry.token !== "string" || typeof entry.exp !== "number") return null; + } + return parsed; + } catch { + return null; + } +} + +export function loadSession(): AddinSession | null { + if (typeof window === "undefined") return memorySession; // SSR ของ client component + try { + return parseSession(window.localStorage.getItem(SESSION_STORAGE_KEY)) ?? memorySession; + } catch { + return memorySession; + } +} + +/** เขียน session — localStorage พัง = เก็บ memory ต่อ (ไม่ throw) */ +export function saveSession(session: AddinSession): void { + memorySession = session; + if (typeof window === "undefined") return; + try { + window.localStorage.setItem(SESSION_STORAGE_KEY, JSON.stringify(session)); + } catch { + // ignore — quota/private mode: มี memory ของ session นี้อยู่ + } +} + +/** ล้างทั้งก้อน — ใช้ตอนเจอ user ใหม่ (requirement ขั้น 6: เคลียร์ Session เดิม) */ +export function clearSession(): void { + memorySession = null; + if (typeof window === "undefined") return; + try { + window.localStorage.removeItem(SESSION_STORAGE_KEY); + } catch { + // ignore + } +} + +/** token หมดอายุหรือยัง (มี margin 30 วิ กันขอบเขตตกหล่น) */ +export function isTokenExpired(entry: SessionTokenEntry): boolean { + return entry.exp * 1000 <= Date.now() - 30_000; +} + +// --------------------------------------------------------------------------- +// HMAC ฝั่ง client — Web Crypto (crypto.subtle ให้ promise เสมอ) +// --------------------------------------------------------------------------- + +/** คำนวณ HMAC-SHA256 คืน hex lowercase — รูปแบบเดียวกับ generateHmacSha256 ฝั่ง server */ +export async function hmacSha256HexWeb(message: string, secret: string): Promise { + const encoder = new TextEncoder(); + const key = await crypto.subtle.importKey( + "raw", + encoder.encode(secret), + { name: "HMAC", hash: "SHA-256" }, + false, + ["sign"], + ); + const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(message)); + return Array.from(new Uint8Array(signature), (byte) => byte.toString(16).padStart(2, "0")).join(""); +} + +/** + * ตรวจ HMAC ของ ticket ฝั่ง client — message คือ string ดิบของ ticket_data ตามที่อ่านจาก + * property (ห้าม trim — ตัว stamp เซ็นบนค่าดิบ) · เทียบหลัง normalize lowercase + */ +export async function verifyTicketHmacWeb(ticketData: string, expectedHex: string, secret: string): Promise { + const expected = normalizeHexDigest(expectedHex); + if (expected === null) return false; + try { + return (await hmacSha256HexWeb(ticketData, secret)) === expected; + } catch { + return false; + } +} + +// --------------------------------------------------------------------------- +// ขอ token จาก /api/documents/token (ทางเข้า ticket — PLAN-ADDIN-AUTH.md §3) +// --------------------------------------------------------------------------- + +interface TokenResponse { + access_token: string; + token_type: string; + expires_in: number; +} + +/** ถอด exp จาก JWT payload โดยไม่ตรวจ signature (แม่นกว่า expires_in — ใช้นาฬิกา server) */ +function jwtExp(token: string): number | undefined { + const payload = token.split(".")[1]; + if (!payload) return undefined; + try { + const bytes = Uint8Array.from(atob(payload.replace(/-/g, "+").replace(/_/g, "/")), (char) => char.charCodeAt(0)); + const json: unknown = JSON.parse(new TextDecoder().decode(bytes)); + const exp = typeof json === "object" && json !== null ? (json as Record).exp : undefined; + return typeof exp === "number" && Number.isFinite(exp) ? exp : undefined; + } catch { + return undefined; + } +} + +/** + * ขอ access_token ด้วย ticket — โยน Error เมื่อ status ไม่สำเร็จ + * (401 = ticket ไม่ผ่านการตรวจฝั่ง server — ให้ caller ไป no-access ตาม flow) + */ +export async function requestDocverToken(ticketData: string, ticketHmac: string): Promise { + const response = await fetch(withBasePath("/api/documents/token"), { + method: "POST", + headers: { "content-type": "application/json" }, + body: JSON.stringify({ ticket_data: ticketData, HmacSha256: ticketHmac }), + }); + if (!response.ok) { + throw new Error(`ขอ token ไม่สำเร็จ (HTTP ${response.status})`); + } + let data: TokenResponse; + try { + data = (await response.json()) as TokenResponse; + } catch { + throw new Error("ขอ token ไม่สำเร็จ (response ไม่ใช่ JSON)"); + } + if (typeof data.access_token !== "string" || data.access_token === "") { + throw new Error("ขอ token ไม่สำเร็จ (ไม่มี access_token)"); + } + const exp = + jwtExp(data.access_token) ?? + (typeof data.expires_in === "number" ? Math.floor(Date.now() / 1000) + data.expires_in : 0); + return { token: data.access_token, exp }; +} diff --git a/wordaddin/services/versioningService.ts b/wordaddin/services/versioningService.ts index 54dd519..f8fb51a 100644 --- a/wordaddin/services/versioningService.ts +++ b/wordaddin/services/versioningService.ts @@ -1,21 +1,154 @@ /** - * MOCK — version API ฝั่ง client (รอ backend จริงตาม contract ใน docs/addin-ui-flow.md §7) - * ต้นฉบับ: D:\word-addin-poc\addin\src\services\versioningService.ts (multipart POST ผ่าน apiClient) + * Version API ฝั่ง client — **ของจริง** (กลุ่ม docver /api/documents/* ผ่าน apiClient + * ซึ่งแนบ Bearer แล้ว — contract ตาม docs/PLAN-DOCVER.md) · เหลือ mock เฉพาะโหมด + * `?addindemo` (dev-only ดู UI ใน browser ไม่ต้องมี backend/MinIO — authService.isDemoMode) * - * - คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId ไว้เป๊ะ — - * วันปลด mock: ก้อบ body ของต้นฉบับกลับมาได้เลย - * - ต้นฉบับมีอีก 2 ตัวที่ไม่มี caller ใน UI จึงไม่พอร์ต: buildDownloadUrl, downloadVersion - * - **metadata ของ version ถูก persist ลง localStorage** (record เล็ก ๆ ต่อ documentId) — - * ไม่งั้นปิดเอกสาร (taskpane ปิดตาม) แล้วเปิดใหม่ history ว่างเปล่า ทั้งที่ metadata - * การ track อยู่ในไฟล์จริง ทำให้ทดสอบวง FR-18 ปิด→เปิดใหม่ไม่ได้; blob ของไฟล์จริง - * ยังเก็บเฉพาะ session (mock download คืน about:blank อยู่แล้ว) — localStorage เข้า - * ไม่ได้ (webview บางตัว block) = ใช้ memory อย่างเดียวแบบเดิม ไม่ throw + * - คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId ตามต้นฉบับ + * D:\word-addin-poc\addin\src\services\versioningService.ts — versionFlow เรียกต่อได้เดิม + * - **เอกสารถูกระบุด้วย fid ใน Bearer token** (ไม่ใช่ documentId GUID ที่ stamp ในไฟล์ — + * 2026-10-26 contract ถอด {docId} ออกจาก URL ทุก endpoint) พารามิเตอร์ documentId จึงเหลือ + * ไว้เพื่อ signature เดิมเท่านั้น ไม่ถูกส่งถึง server · templateId ก็เช่นกัน (มาจาก claims + * ของ token — ส่งมาใน form = 400) + * - **ห้ามส่ง userId/userName/templateId ใน FormData** (contract 2026-10-22 — ส่งมา = 400) + * - mock ยัง persist metadata ลง localStorage ต่อ documentId เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ + * ในโหมด demo — blob ไฟล์จริงเฉพาะ session; localStorage เข้าไม่ได้ (webview บางตัว block) + * = ใช้ memory อย่างเดียว ไม่ throw */ import * as authService from "./authService"; import { generateGuid } from "./metadataService"; +import { ApiError, apiGetJson, apiSendExpectJson } from "./apiClient"; import { UploadVersionResult, VersionRecord } from "../models/versionRecord"; +// --------------------------------------------------------------------------- +// ของจริง — กลุ่ม docver (Bearer จาก ticket auth แนบอัตโนมัติโดย apiClient) +// --------------------------------------------------------------------------- + +/** DTO ของ GET /api/documents/versions (ใหม่ → เก่า) — PLAN-DOCVER.md §1 */ +interface DocumentVersionDTO { + versionId: string; + versionNumber: number; + createdAt: string; + createdByUserId: string; + createdByUserName: string; + contentHash: string; + fields: Record | null; + message: string | null; + hasPdf: boolean; +} + +/** FR-5 — อัปโหลดไฟล์ปัจจุบันเป็น version ใหม่ (multipart POST) + * + FR-13: message คือ commit message ทางเลือก + * + FR-16: templateId เก็บไว้ตาม signature เดิม — ไม่ส่งถึง server (มาจาก claims ของ token) */ +export async function uploadVersion( + documentId: string, + file: Blob, + clientVersionId: string, + fields?: Record, + fileName?: string, + message?: string, + pdf?: Blob, + templateId?: string +): Promise { + if (!authService.isDemoMode()) { + void templateId; // contract 2026-10-22 — ห้ามส่ง (identity ทั้งหมดจาก Bearer token) + const form = new FormData(); + form.append("file", file, fileName ?? "document.docx"); + // pdf optional: ไม่แนบ/ไฟล์เปล่า = version นี้ไม่มีสำเนา PDF + if (pdf && pdf.size > 0) { + form.append("pdf", pdf, "document.pdf"); + } + if (clientVersionId) { + form.append("clientVersionId", clientVersionId); + } + if (fields && Object.keys(fields).length > 0) { + form.append("fields", JSON.stringify(fields)); + } + const trimmedMessage = message?.trim(); + if (trimmedMessage) { + form.append("message", trimmedMessage); + } + if (fileName) { + form.append("fileName", fileName); + } + return apiSendExpectJson( + "/api/documents/versions", + { method: "POST", body: form }, + "อัปโหลด version ไม่สำเร็จ", + ); + } + return uploadVersionMock(documentId, file, clientVersionId, fields, message, pdf); +} + +/** FR-6 — version history เรียงใหม่ → เก่า (คืนสำเนากัน caller mutate store ตรง ๆ) + * docId มาจาก fid ใน token — documentId พารามิเตอร์ไม่ถูกใช้กับ server ของจริง + * 404 = เอกสารนี้ยังไม่เคยมี version (เช่น ไฟล์ที่ stamp SavedByAddIn ไว้สมัย mock แล้วเพิ่ง + * มาใช้ backend จริง) — สำหรับ add-in ความหมายเดียวกับ list ว่าง: UI แสดง "ยังไม่มี version + * ในระบบ" และกด Save & Version สร้าง v1 ได้เลย (upload สร้างเอกสารให้อัตโนมัติ) */ +export async function getVersions(documentId: string): Promise { + if (!authService.isDemoMode()) { + let rows: DocumentVersionDTO[]; + try { + rows = await apiGetJson("/api/documents/versions", "โหลด version history ไม่สำเร็จ"); + } catch (error) { + if (error instanceof ApiError && error.status === 404) { + return []; + } + throw error; + } + // server เรียงใหม่ → เก่าอยู่แล้ว — แปลงเป็น VersionRecord ตามที่ UI ใช้ + return rows.map((row) => ({ + versionId: row.versionId, + versionNumber: row.versionNumber, + createdAt: row.createdAt, + createdByUserId: row.createdByUserId, + createdByUserName: row.createdByUserName, + contentHash: row.contentHash, + fields: row.fields && Object.keys(row.fields).length > 0 ? row.fields : null, + message: row.message, + hasPdf: row.hasPdf, + })); + } + return getVersionsMock(documentId); +} + +export interface VersionDownloadLink { + url: string; + /** ISO-8601 เวลาที่ URL หมดอายุ */ + expiresAt: string; +} + +/** + * FR-7 — ขอ presigned URL อายุสั้นของ version หนึ่ง เพื่อเปิดในเบราว์เซอร์ของผู้ใช้ + * (webview ของ Word ทิ้ง blob download เงียบๆ — ให้เบราว์เซอร์จริงจัดการแทน) + * URL เป็น MinIO presigned GET (อายุ env DOCVER_LINK_TTL_SECONDS default 900 วิ) — + * โฮสต์ MinIO ต้องเข้าถึงได้จากเครื่องผู้ใช้ + */ +export async function getDownloadLink( + documentId: string, + versionId: string, + format?: "docx" | "pdf" +): Promise { + if (!authService.isDemoMode()) { + void documentId; // เอกสารมาจาก fid ใน token — versionId เช็คคู่กับ docId ฝั่ง server + const query = format && format !== "docx" ? `?format=${encodeURIComponent(format)}` : ""; + return apiGetJson( + `/api/documents/versions/${encodeURIComponent(versionId)}/download-link${query}`, + "ขอลิงก์ดาวน์โหลดไม่สำเร็จ", + ); + } + return getDownloadLinkMock(); +} + +/** สร้าง clientVersionId ใหม่สำหรับ upload ครั้งถัดไป */ +export function newClientVersionId(): string { + return generateGuid(); +} + +// --------------------------------------------------------------------------- +// Mock — เฉพาะโหมด ?addindemo (dev-only) +// --------------------------------------------------------------------------- + interface StoredVersion { record: VersionRecord; docxBlob: Blob | null; @@ -73,22 +206,15 @@ async function mockContentHash(file: Blob): Promise { } } -/** FR-5 — อัปโหลดไฟล์ปัจจุบันเป็น version ใหม่ (mock: เก็บลง memory) - * + FR-13: message คือ commit message ทางเลือก - * + FR-16: templateId เฉพาะไฟล์ร่าง (mock ไม่ใช้ — คงไว้ตาม signature ต้นฉบับ) */ -export async function uploadVersion( +async function uploadVersionMock( documentId: string, file: Blob, clientVersionId: string, fields?: Record, - fileName?: string, message?: string, - pdf?: Blob, - templateId?: string + pdf?: Blob ): Promise { void clientVersionId; // mock ไม่ใช้ — id ของ mock สร้างเอง - void fileName; - void templateId; await delay(500); // ให้ข้อความ progress ของ flow ขึ้นจริง const versions = store.get(documentId) ?? []; @@ -112,8 +238,7 @@ export async function uploadVersion( return { hasPdf, versionId: record.versionId, versionNumber }; } -/** FR-6 — version history เรียงใหม่ → เก่า (คืนสำเนากัน caller mutate store ตรง ๆ) */ -export async function getVersions(documentId: string): Promise { +async function getVersionsMock(documentId: string): Promise { await delay(200); const versions = store.get(documentId) ?? []; return versions @@ -122,33 +247,7 @@ export async function getVersions(documentId: string): Promise .map((item) => ({ ...item.record })); } -export interface VersionDownloadLink { - url: string; - /** ISO-8601 เวลาที่ URL หมดอายุ */ - expiresAt: string; -} - -/** - * FR-7 — ขอ presigned URL อายุสั้นของ version หนึ่ง เพื่อเปิดในเบราว์เซอร์ของผู้ใช้ - * (webview ของ Word ทิ้ง blob download เงียบๆ — ให้เบราว์เซอร์จริงจัดการแทน) - * mock: ไม่มี URL จริงให้คืน — blob:/data: ใช้ผ่าน openBrowserWindow ไม่ได้ (blob ผูกกับ - * context ของ webview, data: โดนเบราว์เซอร์ block) ส่วน about:blank ที่คืนไปนี้ host จะ - * ปฏิเสธเงียบๆ เพราะ openBrowserWindow เปิดเฉพาะ http/https และเป็น void API ไม่รายงานกลับ - * — กดปุ่มดาวน์โหลด/PDF ตอน mock จึงไม่มีหน้าต่างเบราว์เซอร์เปิด (UI ยังเดินครบ flow) - */ -export async function getDownloadLink( - documentId: string, - versionId: string, - format?: "docx" | "pdf" -): Promise { - void documentId; - void versionId; - void format; +async function getDownloadLinkMock(): Promise { await delay(150); return { url: "about:blank", expiresAt: new Date(Date.now() + 10 * 60_000).toISOString() }; } - -/** สร้าง clientVersionId ใหม่สำหรับ upload ครั้งถัดไป */ -export function newClientVersionId(): string { - return generateGuid(); -}