Restore named project snapshots

src/domain/services/project-command.service.ts

@@ -41,6 +41,10 @@ import {
   assertSerializedProjectCommand,
   type SerializedProjectCommand,
 } from "../models/project-command.model.js";
+import {
+  assertProjectStateRestoreCommand,
+  projectStateRestoreCommandType,
+} from "../models/project-state-restore-command.model.js";
 import {
   assertProjectDeviceRowSyncProjectCommand,
   projectDeviceRowSyncCommandType,
@@ -76,6 +80,7 @@ import type { ProjectDeviceProjectCommandStore } from "../ports/project-device-p
 import type { ProjectDeviceRowSyncProjectCommandStore } from "../ports/project-device-row-sync-project-command.store.js";
 import type { ProjectDeviceStructureProjectCommandStore } from "../ports/project-device-structure-project-command.store.js";
 import type { ProjectRevisionSource } from "../ports/project-revision.store.js";
+import type { ProjectStateRestoreCommandStore } from "../ports/project-state-restore-command.store.js";
 
 interface DispatchProjectCommandInput {
   projectId: string;
@@ -84,7 +89,7 @@ interface DispatchProjectCommandInput {
   description?: string;
   actorId?: string;
   historyTargetChangeSetId?: string;
-  command: SerializedProjectCommand;
+  command: SerializedProjectCommand<unknown>;
 }
 
 export class ProjectCommandService implements ProjectCommandExecutor {
@@ -99,6 +104,7 @@ export class ProjectCommandService implements ProjectCommandExecutor {
     private readonly projectDeviceStructureStore: ProjectDeviceStructureProjectCommandStore,
     private readonly projectDeviceStore: ProjectDeviceProjectCommandStore,
     private readonly projectDeviceRowSyncStore: ProjectDeviceRowSyncProjectCommandStore,
+    private readonly projectStateRestoreStore: ProjectStateRestoreCommandStore,
     private readonly historyStore: ProjectHistoryStore
   ) {}
 
@@ -107,6 +113,11 @@ export class ProjectCommandService implements ProjectCommandExecutor {
   ): ExecutedProjectCommand {
     assertExpectedRevision(input.expectedRevision);
     assertSerializedProjectCommand(input.command);
+    if (input.command.type === projectStateRestoreCommandType) {
+      throw new Error(
+        "Project state restore commands require a stored server snapshot."
+      );
+    }
     return this.dispatch({
       ...input,
       source: "user",
@@ -114,6 +125,18 @@ export class ProjectCommandService implements ProjectCommandExecutor {
     });
   }
 
+  executeRestore(
+    input: ExecuteUserProjectCommandInput
+  ): ExecutedProjectCommand {
+    assertExpectedRevision(input.expectedRevision);
+    assertProjectStateRestoreCommand(input.command);
+    return this.dispatch({
+      ...input,
+      source: "restore",
+      command: input.command,
+    });
+  }
+
   undo(
     input: ExecuteProjectHistoryCommandInput
   ): ExecutedProjectCommand {
@@ -271,6 +294,13 @@ export class ProjectCommandService implements ProjectCommandExecutor {
           command: input.command,
         }).revision;
       }
+      case projectStateRestoreCommandType: {
+        assertProjectStateRestoreCommand(input.command);
+        return this.projectStateRestoreStore.execute({
+          ...input,
+          command: input.command,
+        }).revision;
+      }
       default:
         throw new Error(
           `Unsupported project command type: ${input.command.type}.`