Add API endpoints for waiting for account restoration requests

service/src/main/java/org/whispersystems/textsecuregcm/entities/RestoreAccountRequest.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2024 Signal Messenger, LLC
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+
+package org.whispersystems.textsecuregcm.entities;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import javax.validation.constraints.NotNull;
+
+@Schema(description = """
+    Represents a request from a new device to restore account data by some method.
+    """)
+public record RestoreAccountRequest(
+    @NotNull
+    @Schema(description = "The method by which the new device has requested account data restoration")
+    Method method) {
+
+  public enum Method {
+    @Schema(description = "Restore account data from a remote message history backup")
+    REMOTE_BACKUP,
+
+    @Schema(description = "Restore account data from a local backup archive")
+    LOCAL_BACKUP,
+
+    @Schema(description = "Restore account data via direct device-to-device transfer")
+    DEVICE_TRANSFER,
+
+    @Schema(description = "Do not restore account data")
+    DECLINE,
+  }
+}