diff --git a/src/Api/Tools/Models/Request/SendRequestModel.cs b/src/Api/Tools/Models/Request/SendRequestModel.cs
index 941fa14cfa..c15a3c4da9 100644
--- a/src/Api/Tools/Models/Request/SendRequestModel.cs
+++ b/src/Api/Tools/Models/Request/SendRequestModel.cs
@@ -109,6 +109,12 @@ public class SendRequestModel
///
public bool? HideEmail { get; set; }
+ ///
+ /// Transforms the request into a send object.
+ ///
+ /// The user that owns the send.
+ /// Hashes the send password.
+ /// The send object
public Send ToSend(Guid userId, ISendAuthorizationService sendAuthorizationService)
{
var send = new Send
@@ -120,8 +126,17 @@ public class SendRequestModel
return send;
}
+ ///
+ /// Transforms the request into a send object and file data.
+ ///
+ /// The user that owns the send.
+ /// Name of the file uploaded with the send.
+ /// Hashes the send password.
+ /// The send object and file data.
public (Send, SendFileData) ToSend(Guid userId, string fileName, ISendAuthorizationService sendAuthorizationService)
{
+ // FIXME: This method does two things: creates a send and a send file data.
+ // It should only do one thing.
var send = ToSendBase(new Send
{
Type = Type,
@@ -131,6 +146,13 @@ public class SendRequestModel
return (send, data);
}
+ ///
+ /// Update a send object with request content
+ ///
+ /// The send to update
+ /// Hashes the send password.
+ /// The send object
+ // FIXME: rename to `UpdateSend`
public Send ToSend(Send existingSend, ISendAuthorizationService sendAuthorizationService)
{
existingSend = ToSendBase(existingSend, sendAuthorizationService);