(20241219) SMS module fully re-organized.

models/api/mail/sync.py

@@ -219,6 +219,35 @@ class MailSyncManyResults(BaseModel):
         extra = "forbid"
 
 
+# ---------------------------------------------------------------------------------------------------------------------
+
+
+class MailSendOneResult(BaseModel):
+
+    success: bool = Field(
+        description = "whether, or not, the mail was successfully sent",
+        default = False
+    )
+
+    message: str | None = Field(
+        description = "a brief message to summarize the result of the process",
+        default = None
+    )
+
+    mailMessage: CoreMessageModel | None = Field(
+        description = "the actual data of the mail; can be null in a successful process if the mail is already sent",
+        default = None
+    )
+
+    # ┏┓    ┏•
+    # ┃ ┏┓┏┓╋┓┏┓
+    # ┗┛┗┛┛┗┛┗┗┫
+    #          ┛
+
+    class Config:
+        extra = "forbid"
+
+
 #   *****************************************************************************************************************
 #  *****                                                                                                          ****
 # ***                                               MAIN PROGRAM                                                    ***