(20241203) Mails sync'ing, listing, and fetching done.

models/data/mail/list.py

@@ -75,7 +75,7 @@ REGEX_SESSION_TOKEN = r"^[a-f0-9]{8}-[a-f0-9]{4}-[1-5][a-f0-9]{3}-[89ab][a-f0-9]
 #   *****************************************************************************************************************
 
 
-class MailGetRequestHeaders(BaseModel):
+class MailListRequestHeaders(BaseModel):
 
     sessionToken: str = Field(
         description = "the session token of the user who is requesting the service",
@@ -99,10 +99,24 @@ class MailGetRequestHeaders(BaseModel):
 # ---------------------------------------------------------------------------------------------------------------------
 
 
-class MailGetRequestData(BaseModel):
+class MailListByAccountIdRequestData(BaseModel):
 
-    mailId: str = Field(
-        description = "the mail identifier (Mongo ObjectId) of the document that holds the mail",
+    accountId: str = Field(
+        description = "the account identifier (Mongo ObjectId) granted by 'MailOAuthModel.get_account_identifier'",
+        frozen = True
+    )
+
+    count: int = Field(
+        description = "the no. of mails to list",
+        default = 25,
+        ge = 1,
+        le = 500,
+        frozen = True
+    )
+
+    fromCount: int = Field(
+        description = "the no. of mails to skip before picking mails to list; useful for pagination",
+        default = 0,
         frozen = True
     )