HealthLog/src/lib/export/labs-backup-schema.ts

/**
 * The labs slice of the backup payload schema.
 *
 * Part of the labs backup domain, beside its export and restore.
 * Loaded only through `src/lib/validations/backup.ts`, which composes every
 * slice into `backupPayloadSchema` on first use (the schema is ~12 MB of
 * heap; see `backup-schema-lazy-guard.test.ts`).
 */
import { z } from "zod/v4";
import { base64BytesSchema, isoDateTime } from "@/lib/export/backup-schema-kit";

/* ── Structured-record disaster-recovery shapes ─────────────────────
 *
 * These shapes serve both the historical portable export and the canonical
 * weekly/off-host disaster-recovery payload. Portable document entries remain
 * metadata-only. Canonical entries additionally carry encrypted BYTEA values
 * as base64 plus the codec/hash fields required to recreate InboundDocument
 * without decrypting or fabricating content.
 */

export const labResultBackupSchema = z
  .object({
    id: z.string().min(1).optional(),
    // The source row's id in a portable file, as on a medication.
    ref: z.string().min(1).optional(),
    panel: z.string().nullable().optional(),
    analyte: z.string().min(1),
    value: z.number().nullable().optional(),
    valueText: z.string().nullable().optional(),
    // A qualitative reading ("positive", "trace") has no unit and is stored
    // under its marker's empty one (`POST /api/labs`); the refine below keeps
    // the unit required for every numeric reading.
    unit: z.string(),
    referenceLow: z.number().nullable().optional(),
    referenceHigh: z.number().nullable().optional(),
    // Optional so a backup written before these columns existed still
    // restores; absent reads as "this reading had no source window on file".
    sourceReferenceLow: z.number().nullable().optional(),
    sourceReferenceHigh: z.number().nullable().optional(),
    sourceReferenceText: z.string().nullable().optional(),
    // The value and unit as printed, kept beside a converted
    // reading. Optional: absent on every file written before the columns.
    sourceValue: z.number().nullable().optional(),
    sourceUnit: z.string().nullable().optional(),
    takenAt: isoDateTime,
    source: z.string().min(1),
    biomarkerName: z.string().nullable().optional(),
    biomarkerId: z.string().nullable().optional(),
    note: z.string().nullable().optional(),
    createdAt: isoDateTime.optional(),
    noteEncrypted: base64BytesSchema.nullable().optional(),
    deletedAt: isoDateTime.nullable().optional(),
    updatedAt: isoDateTime.optional(),
  })
  .passthrough()
  .superRefine((reading, ctx) => {
    const qualitative =
      (reading.value === null || reading.value === undefined) &&
      typeof reading.valueText === "string" &&
      reading.valueText.length > 0;
    if (reading.unit.length === 0 && !qualitative) {
      ctx.addIssue({
        code: "custom",
        path: ["unit"],
        message: "A numeric lab reading needs its unit",
      });
    }
  });
export const biomarkerBackupSchema = z
  .object({
    id: z.string().min(1).optional(),
    name: z.string().min(1),
    // Empty for a qualitative marker, minted from a reading with no unit. The
    // payload refine below refuses an empty unit on a marker a numeric
    // reading is filed under.
    unit: z.string(),
    lowerBound: z.number().nullable().optional(),
    upperBound: z.number().nullable().optional(),
    panel: z.string().nullable().optional(),
    hidden: z.boolean().optional(),
    // The catalogue analyte the marker resolves to.
    analyteKey: z.string().nullable().optional(),
    context: z.string().nullable().optional(),
    // The context's ciphertext, disaster-recovery files only. A file without
    // it carries the readable context, which the restore seals.
    contextEncrypted: base64BytesSchema.nullable().optional(),
    // The other spellings the marker answers to. Absent on
    // files written before them.
    aliases: z
      .array(
        z
          .object({
            id: z.string().min(1).optional(),
            name: z.string().min(1).max(120),
            source: z.enum(["MERGE", "IMPORT_CHOICE", "MANUAL"]),
            createdAt: isoDateTime.optional(),
          })
          .passthrough(),
      )
      .optional(),
    createdAt: isoDateTime.optional(),
    updatedAt: isoDateTime.optional(),
  })
  .passthrough();
// The ledger of markers merged into others.
export const biomarkerMergeBackupSchema = z
  .object({
    id: z.string().min(1).optional(),
    targetBiomarkerId: z.string().min(1).optional(),
    targetName: z.string().min(1),
    sourceBiomarkerId: z.string().min(1),
    sourceName: z.string().min(1).max(120),
    readingCount: z.number().int().min(0),
    mergedAt: isoDateTime,
  })
  .passthrough();