Add circuit group reordering

src/domain/models/circuit-group-structure-project-command.model.ts

@@ -8,6 +8,7 @@ import type { SerializedProjectCommand } from "./project-command.model.js";
 export const circuitGroupInsertCommandType = "circuit-group.insert" as const;
 export const circuitGroupDeleteCommandType = "circuit-group.delete" as const;
 export const circuitGroupUpdateCommandType = "circuit-group.update" as const;
+export const circuitGroupReorderCommandType = "circuit-group.reorder" as const;
 export const circuitGroupStructureCommandSchemaVersion = 1 as const;
 
 export interface CircuitGroupSnapshot {
@@ -30,6 +31,17 @@ interface UpdatePayload {
   target: CircuitGroupSnapshot;
 }
 
+export interface CircuitGroupReorderAssignment {
+  groupId: string;
+  expectedSortOrder: number;
+  targetSortOrder: number;
+}
+
+interface ReorderPayload {
+  circuitListId: string;
+  assignments: CircuitGroupReorderAssignment[];
+}
+
 export interface CircuitGroupInsertProjectCommand
   extends SerializedProjectCommand<SnapshotPayload> {
   schemaVersion: typeof circuitGroupStructureCommandSchemaVersion;
@@ -48,10 +60,17 @@ export interface CircuitGroupUpdateProjectCommand
   type: typeof circuitGroupUpdateCommandType;
 }
 
+export interface CircuitGroupReorderProjectCommand
+  extends SerializedProjectCommand<ReorderPayload> {
+  schemaVersion: typeof circuitGroupStructureCommandSchemaVersion;
+  type: typeof circuitGroupReorderCommandType;
+}
+
 export type CircuitGroupStructureProjectCommand =
   | CircuitGroupInsertProjectCommand
   | CircuitGroupDeleteProjectCommand
-  | CircuitGroupUpdateProjectCommand;
+  | CircuitGroupUpdateProjectCommand
+  | CircuitGroupReorderProjectCommand;
 
 export function createCircuitGroupInsertProjectCommand(
   snapshot: CircuitGroupSnapshot
@@ -90,6 +109,19 @@ export function createCircuitGroupUpdateProjectCommand(
   return command;
 }
 
+export function createCircuitGroupReorderProjectCommand(
+  circuitListId: string,
+  assignments: CircuitGroupReorderAssignment[]
+): CircuitGroupReorderProjectCommand {
+  const command: CircuitGroupReorderProjectCommand = {
+    schemaVersion: circuitGroupStructureCommandSchemaVersion,
+    type: circuitGroupReorderCommandType,
+    payload: { circuitListId, assignments },
+  };
+  assertCircuitGroupReorderProjectCommand(command);
+  return command;
+}
+
 export function assertCircuitGroupInsertProjectCommand(
   command: SerializedProjectCommand<unknown>
 ): asserts command is CircuitGroupInsertProjectCommand {
@@ -132,6 +164,44 @@ export function assertCircuitGroupUpdateProjectCommand(
   }
 }
 
+export function assertCircuitGroupReorderProjectCommand(
+  command: SerializedProjectCommand<unknown>
+): asserts command is CircuitGroupReorderProjectCommand {
+  if (
+    command.schemaVersion !== circuitGroupStructureCommandSchemaVersion ||
+    command.type !== circuitGroupReorderCommandType ||
+    !isPlainObject(command.payload) ||
+    Object.keys(command.payload).length !== 2 ||
+    typeof command.payload.circuitListId !== "string" ||
+    !command.payload.circuitListId.trim() ||
+    !Array.isArray(command.payload.assignments) ||
+    command.payload.assignments.length === 0
+  ) {
+    throw new Error("Unsupported circuit-group reorder command.");
+  }
+  const groupIds = new Set<string>();
+  let hasChange = false;
+  for (const assignment of command.payload.assignments) {
+    if (
+      !isPlainObject(assignment) ||
+      typeof assignment.groupId !== "string" ||
+      !assignment.groupId.trim() ||
+      !Number.isFinite(assignment.expectedSortOrder) ||
+      !Number.isFinite(assignment.targetSortOrder) ||
+      groupIds.has(assignment.groupId)
+    ) {
+      throw new Error(
+        "Circuit-group reorder contains an invalid or duplicate assignment."
+      );
+    }
+    hasChange ||= assignment.expectedSortOrder !== assignment.targetSortOrder;
+    groupIds.add(assignment.groupId);
+  }
+  if (!hasChange) {
+    throw new Error("Circuit-group reorder must change at least one position.");
+  }
+}
+
 function assertSnapshotCommand(
   command: SerializedProjectCommand<unknown>,
   type: