implement phase 5 และ fix bugs

addin/src/services/versionFlow.ts

@@ -0,0 +1,159 @@
+/* global Word, Office */
+
+import * as authService from "./authService";
+import { getCurrentDocumentFile } from "./fileService";
+import {
+  generateGuid,
+  readContentControlFields,
+  readVersionHistoryFromXml,
+  stampTrackedProperties,
+  writeVersionHistoryToXml,
+  XmlVersionEntry,
+} from "./metadataService";
+import { uploadVersion } from "./versioningService";
+
+/**
+ * Orchestration ของ flow หลักสองอันของ add-in (แยกจาก UI เพื่อ unit test ได้):
+ *
+ * - `startVersioning` (FR-1 "Start Versioning This Document") — เอกสารใหม่ที่ยังไม่ถูก track
+ * - `saveAndVersion` (FR-2) — ไล่ตามลำดับใน spec แบบเคร่งครัด:
+ *   stamp properties → XML part (delete-then-add, fail ได้เงียบๆ) → document.save()
+ *   → ดึงไฟล์ + extract fields (FR-11) → POST version → คืนผลให้ UI แสดง/refresh history
+ *
+ * หมายเหตุค่า id ใน metadata: `LastVersionId` และ `<Version id>` ใน XML part เก็บ
+ * **clientVersionId** (GUID ที่ client generate) เพราะต้อง stamp ลงไฟล์ *ก่อน* upload —
+ * versionId ของ backend จะได้มาหลัง upload ซึ่งไฟล์ถูก capture ไปแล้ว
+ * (backend คือ source of truth ของ id จริงอยู่ดี)
+ */
+
+export interface StartVersioningResult {
+  documentId: string;
+  versionId: string;
+  versionNumber: number;
+}
+
+export interface SaveAndVersionResult {
+  versionId: string;
+  versionNumber: number;
+}
+
+/** เลข version ถัดไปตามที่ client เดา (history ล่าสุด + 1) — ใช้เขียน XML part ก่อนรู้ค่าจริงจาก backend */
+function predictNextVersionNumber(latestVersionNumber: number): number {
+  return latestVersionNumber + 1;
+}
+
+/** ชื่อไฟล์จาก URL ของ document ถ้าดึงได้ (desktop มักเป็น path จริง) — ใช้เป็นชื่อตอน upload */
+function guessDocumentFileName(): string | undefined {
+  try {
+    const url = Office.context.document.url;
+    if (!url) {
+      return undefined;
+    }
+    const name = url.split(/[\\/]/).pop();
+    if (!name) {
+      return undefined;
+    }
+    return name.toLowerCase().endsWith(".docx") ? name : `${name}.docx`;
+  } catch {
+    return undefined;
+  }
+}
+
+/** `context.document.save(Word.SaveBehavior.save)` — trigger native save ตาม FR-2 ขั้นตอนที่ 4 */
+async function saveDocument(): Promise<void> {
+  await Word.run(async (context) => {
+    context.document.save(Word.SaveBehavior.save);
+    await context.sync();
+  });
+}
+
+async function uploadCurrentFile(
+  documentId: string,
+  clientVersionId: string,
+  fields: Record<string, string>
+): Promise<{ versionId: string; versionNumber: number }> {
+  const file = await getCurrentDocumentFile();
+  return uploadVersion(documentId, file, clientVersionId, fields, guessDocumentFileName());
+}
+
+/** FR-1 — เริ่ม track เอกสารปัจจุบัน: stamp รอบแรก + upload เป็น version 1 */
+export async function startVersioning(
+  onProgress?: (message: string) => void
+): Promise<StartVersioningResult> {
+  const documentId = generateGuid();
+  const clientVersionId = generateGuid();
+  const timestamp = new Date().toISOString();
+
+  // 1) stamp รอบแรก — ได้ทั้ง SavedByAddIn และ DocumentTrackingId ใหม่
+  onProgress?.("กำลังบันทึก metadata ของเอกสาร…");
+  await stampTrackedProperties({
+    documentTrackingId: documentId,
+    lastVersionId: clientVersionId,
+    lastVersionTimestamp: timestamp,
+  });
+
+  // 2) XML part (secondary — fail ได้เงียบๆ)
+  onProgress?.("กำลังอัปเดต version history ในไฟล์…");
+  await writeVersionHistoryToXml([
+    { id: clientVersionId, number: 1, timestamp, user: authService.getUsername() ?? "unknown" },
+  ]);
+
+  // 3) native save แล้ว capture ไฟล์ + fields
+  onProgress?.("กำลังบันทึกไฟล์…");
+  await saveDocument();
+  onProgress?.("กำลังอ่านค่า fields จากเอกสาร…");
+  const fields = await readContentControlFields();
+
+  // 4) upload version แรก
+  onProgress?.("กำลังอัปโหลด version 1…");
+  const result = await uploadCurrentFile(documentId, clientVersionId, fields);
+  return { documentId, ...result };
+}
+
+/** FR-2 — Save & Version ของเอกสารที่ track อยู่แล้ว (เรียกหลังผู้ใช้กดยืนยันใน dialog แล้ว) */
+export async function saveAndVersion(
+  documentId: string,
+  latestVersionNumber: number,
+  onProgress?: (message: string) => void
+): Promise<SaveAndVersionResult> {
+  const clientVersionId = generateGuid();
+  const timestamp = new Date().toISOString();
+  const predictedNumber = predictNextVersionNumber(latestVersionNumber);
+  const user = authService.getUsername() ?? "unknown";
+
+  // 1) stamp properties (SavedByAddIn + DocumentTrackingId ถูก stamp ไว้แล้วจากรอบแรก — เขียนทับไม่เสียหาย)
+  onProgress?.("กำลังบันทึก metadata ของ version ใหม่…");
+  await stampTrackedProperties({
+    lastVersionId: clientVersionId,
+    lastVersionTimestamp: timestamp,
+  });
+
+  // 2) XML part: เพิ่ม entry ของ version ใหม่ไว้ต้นสุด=ใหม่→เก่า ตามรูปใน spec (เดาเลขก่อน upload) — fail ได้เงียบๆ
+  onProgress?.("กำลังอัปเดต version history ในไฟล์…");
+  const entries = await readVersionHistoryFromXml();
+  entries.unshift({ id: clientVersionId, number: predictedNumber, timestamp, user });
+  await writeVersionHistoryToXml(entries);
+
+  // 3) native save → capture ไฟล์ + fields ปัจจุบัน (FR-11)
+  onProgress?.("กำลังบันทึกไฟล์…");
+  await saveDocument();
+  onProgress?.("กำลังอ่านค่า fields จากเอกสาร…");
+  const fields = await readContentControlFields();
+
+  // 4) upload
+  onProgress?.("กำลังอัปโหลด version ใหม่…");
+  const result = await uploadCurrentFile(documentId, clientVersionId, fields);
+
+  // 5) เลขจริงจาก backend ต่างจากที่เดา (มี client อื่นแทรก) → แก้ XML part ให้ตรง (best effort)
+  if (result.versionNumber !== predictedNumber) {
+    const corrected = await readVersionHistoryFromXml();
+    const entry = corrected.find((item: XmlVersionEntry) => item.id === clientVersionId);
+    if (entry) {
+      entry.number = result.versionNumber;
+      corrected.sort((a, b) => b.number - a.number); // คงลำดับใหม่→เก่าหลังแก้เลข
+      await writeVersionHistoryToXml(corrected);
+    }
+  }
+
+  return result;
+}