Persist Revit CSV configuration

src/domain/models/project-state-snapshot.model.ts

@@ -18,9 +18,12 @@ import {
   resolveCircuitPhaseType,
   resolveProjectVoltage,
 } from "../services/project-voltage.service.js";
+import { validateExternalCsvConfiguration } from "../../external-model/csv/external-csv-configuration.js";
+import type { ExternalCsvConfiguration } from "../../external-model/csv/external-csv-contracts.js";
 
-export const projectStateSnapshotSchemaVersion = 2 as const;
-const previousProjectStateSnapshotSchemaVersion = 1 as const;
+export const projectStateSnapshotSchemaVersion = 3 as const;
+const previousProjectStateSnapshotSchemaVersion = 2 as const;
+const baselineProjectStateSnapshotSchemaVersion = 1 as const;
 
 const idSchema = z.string().trim().min(1);
 const nullableStringSchema = z.string().nullable();
@@ -249,6 +252,17 @@ const componentProtectionDeviceSchema = z
   .strict()
   .superRefine(validatePersistedProtectionDevice);
 
+const externalCsvConfigurationSnapshotSchema = z
+  .object({
+    id: idSchema,
+    projectId: idSchema,
+    configurationVersion: z.number().int().positive(),
+    configuration: z.custom<ExternalCsvConfiguration>(
+      (value) => validateExternalCsvConfiguration(value).success
+    ),
+  })
+  .strict();
+
 const projectStateSnapshotContents = {
   circuitLists: z.array(circuitListSchema),
   circuitSections: z.array(circuitSectionSchema),
@@ -268,6 +282,7 @@ export const projectStateSnapshotSchema = z
     schemaVersion: z.literal(projectStateSnapshotSchemaVersion),
     project: projectSchema,
     distributionBoards: z.array(distributionBoardSchema),
+    externalCsvConfiguration: externalCsvConfigurationSnapshotSchema.nullable(),
     ...projectStateSnapshotContents,
   })
   .strict();
@@ -275,6 +290,15 @@ export const projectStateSnapshotSchema = z
 const previousProjectStateSnapshotSchema = z
   .object({
     schemaVersion: z.literal(previousProjectStateSnapshotSchemaVersion),
+    project: projectSchema,
+    distributionBoards: z.array(distributionBoardSchema),
+    ...projectStateSnapshotContents,
+  })
+  .strict();
+
+const baselineProjectStateSnapshotSchema = z
+  .object({
+    schemaVersion: z.literal(baselineProjectStateSnapshotSchemaVersion),
     project: previousProjectSchema,
     distributionBoards: z.array(distributionBoardSchema),
     ...projectStateSnapshotContents,
@@ -301,20 +325,29 @@ function upgradePreviousProjectStateSnapshot(value: unknown): unknown {
     value === null ||
     typeof value !== "object" ||
     Array.isArray(value) ||
-    (value as { schemaVersion?: unknown }).schemaVersion !==
-      previousProjectStateSnapshotSchemaVersion
+    typeof (value as { schemaVersion?: unknown }).schemaVersion !== "number"
   ) {
     return value;
   }
-  const previous = previousProjectStateSnapshotSchema.parse(value);
-  return {
-    ...previous,
-    schemaVersion: projectStateSnapshotSchemaVersion,
-    project: {
-      ...previous.project,
-      isPublicBuilding: false,
-    },
-  };
+  const schemaVersion = (value as { schemaVersion: number }).schemaVersion;
+  if (schemaVersion === previousProjectStateSnapshotSchemaVersion) {
+    const previous = previousProjectStateSnapshotSchema.parse(value);
+    return {
+      ...previous,
+      schemaVersion: projectStateSnapshotSchemaVersion,
+      externalCsvConfiguration: null,
+    };
+  }
+  if (schemaVersion === baselineProjectStateSnapshotSchemaVersion) {
+    const baseline = baselineProjectStateSnapshotSchema.parse(value);
+    return {
+      ...baseline,
+      schemaVersion: projectStateSnapshotSchemaVersion,
+      project: { ...baseline.project, isPublicBuilding: false },
+      externalCsvConfiguration: null,
+    };
+  }
+  return value;
 }
 
 function normalizeSnapshotPhaseTypes(
@@ -377,6 +410,12 @@ function assertProjectStateSnapshotRelations(
   snapshot: ProjectStateSnapshot
 ) {
   const projectId = snapshot.project.id;
+  if (
+    snapshot.externalCsvConfiguration !== null &&
+    snapshot.externalCsvConfiguration.projectId !== projectId
+  ) {
+    throw new Error("Snapshot external CSV configuration belongs to a different project.");
+  }
   const boardIds = uniqueIds(
     snapshot.distributionBoards,
     "distribution board"