Derive device voltages from project settings

src/db/repositories/circuit-project-command.repository.ts

@@ -18,7 +18,9 @@ import {
   toCircuitPatchValues,
   type CircuitPatchPersistenceInput,
 } from "./circuit.persistence.js";
-import { executeProjectCommandTransaction } from "./project-command-transaction.persistence.js";
+import { executeProjectCommandTransactionWithAppliedForward } from "./project-command-transaction.persistence.js";
+import { resolveCircuitVoltage } from "./project-voltage.persistence.js";
+import { circuitDeviceRows } from "../schema/circuit-device-rows.js";
 
 type CircuitRow = typeof circuits.$inferSelect;
 
@@ -30,7 +32,7 @@ export class CircuitProjectCommandRepository
   executeUpdate(input: ExecuteCircuitUpdateCommandInput) {
     assertCircuitUpdateProjectCommand(input.command);
 
-    return executeProjectCommandTransaction(
+    return executeProjectCommandTransactionWithAppliedForward(
       this.database,
       input,
       (tx) => this.applyCommand(tx, input)
@@ -71,14 +73,44 @@ export class CircuitProjectCommandRepository
       ])
     ) as CircuitPatchPersistenceInput;
     this.assertSectionInCircuitList(tx, current, patch.sectionId);
+    if (input.source === "user") {
+      if (
+        input.command.payload.changes.every(
+          (change) => change.field === "voltage"
+        )
+      ) {
+        throw new Error("Circuit voltage is derived and cannot be edited.");
+      }
+      const devicePhaseTypes = tx
+        .select({ phaseType: circuitDeviceRows.phaseType })
+        .from(circuitDeviceRows)
+        .where(eq(circuitDeviceRows.circuitId, current.id))
+        .all()
+        .map((row) => row.phaseType);
+      const derivedVoltage = resolveCircuitVoltage(
+        tx,
+        input.projectId,
+        patch.sectionId ?? current.sectionId,
+        devicePhaseTypes
+      );
+      if (derivedVoltage === current.voltage) {
+        delete patch.voltage;
+      } else {
+        patch.voltage = derivedVoltage;
+      }
+    }
     this.assertUniqueEquipmentIdentifier(
       tx,
       current,
       patch.equipmentIdentifier
     );
 
+    const appliedForward = createCircuitUpdateProjectCommand(
+      current.id,
+      patch as CircuitUpdatePatch
+    );
     const inversePatch = Object.fromEntries(
-      input.command.payload.changes.map((change) => [
+      appliedForward.payload.changes.map((change) => [
         change.field,
         getCircuitFieldValue(current, change.field),
       ])
@@ -97,7 +129,7 @@ export class CircuitProjectCommandRepository
       throw new Error("Circuit changed before command execution.");
     }
 
-    return inverse;
+    return { forward: appliedForward, inverse };
   }
 
   private assertSectionInCircuitList(