eCourt-note/wordaddin/models/versionRecord.ts

/**
 * Type ตรงกับ response ของ backend (`Models/VersionDtos.cs` — ASP.NET Core serialize camelCase)
 * พอร์ตดิบจาก D:\word-addin-poc\addin\src\models\versionRecord.ts
 */

/** response ของ POST /api/documents/{documentId}/versions  */
export interface UploadVersionResult {
  hasPdf: boolean;
  versionId: string;
  versionNumber: number;
}

/** field เดียวใน snapshot ของ version (เอกสารที่ผูก template) */
export interface FieldSnapshotEntry {
  value: string;
  missing: boolean;
}

/**
 * snapshot fields ต่อ version — backend เก็บ 2 รูปแบบ:
 *  - เอกสารผูก template: `{ [fieldKey]: { value, missing } }`
 *  - เอกสารไม่ผูก template (track เองจาก add-in): map ดิบ `{ [tag]: text }`
 * UI ต้อง handle ได้ทั้งคู่ (ใช้ readSnapshotField ช่วยอ่าน)
 */
export type FieldsSnapshot = Record<string, FieldSnapshotEntry> | Record<string, string>;

/** item ของ GET /api/documents/{documentId}/versions */
export interface VersionRecord {
  hasPdf?: boolean;
  versionId: string;
  versionNumber: number;
  /** ISO-8601 */
  createdAt: string;
  createdByUserId: string;
  /** ชื่อผู้สร้าง — ส่วนเสริมของ DTO กลุ่ม docver (mock/demo อาจไม่มี → UI fallback เป็น userId) */
  createdByUserName?: string;
  /** SHA256 hex */
  contentHash: string;
  fields: FieldsSnapshot | null;
  /** คำอธิบาย version แบบ commit message ที่ผู้ใช้พิมพ์ตอนสร้าง (FR-13) — null ได้ */
  message: string | null;
}

/** อ่านค่า + สถานะ missing ของ field หนึ่งจาก snapshot ไม่ว่าจะเก็บรูปแบบไหน — ไม่มี field นี้คืน null */
export function readSnapshotField(
  snapshot: FieldsSnapshot | null,
  key: string
): FieldSnapshotEntry | null {
  if (!snapshot) {
    return null;
  }
  const raw = snapshot[key];
  if (raw === undefined) {
    return null;
  }
  if (typeof raw === "string") {
    return { value: raw, missing: false };
  }
  return { value: raw.value, missing: raw.missing };
}