⚡ ✨ feat: Add UID method to IMAPSearchCriteria for unique email ident…

…ification

- Added  static method to IMAPSearchCriteria class
- The method generates search criteria for emails using the specified
  UID or range of UIDs
  - Updated class documentation with example usage for the  method

  The  method allows users to search for emails based on their
  unique identifiers, enhancing the search functionality of the
  IMAPSearchCriteria class. This update ensures better compatibility
  with the  package for Python, providing a straightforward way
  to use UIDs in IMAP queries.

sage_imap/helpers/search.py

@@ -348,3 +348,28 @@ def message_id(message_id: str) -> str:
         >>> print(criteria)  # Output: HEADER "Message-ID" "<[email protected]>"
         """
         return f'HEADER "Message-ID" "{message_id}"'
+
+    @staticmethod
+    def uid(uid: str) -> str:
+        """
+        Generate search criteria for emails with the specified UID or range of UIDs.
+
+        Parameters
+        ----------
+        uid : str
+            The UID or range of UIDs.
+
+        Returns
+        -------
+        str
+            The constructed search criteria.
+
+        Example
+        -------
+        >>> criteria = IMAPSearchCriteria.uid("100")
+        >>> print(criteria)  # Output: UID 100
+
+        >>> criteria = IMAPSearchCriteria.uid("100:200")
+        >>> print(criteria)  # Output: UID 100:200
+        """
+        return f"UID {uid}"