mock server, file and folder management

server/app/mailer/sending/imap.py

@@ -8,6 +8,12 @@ import time
 from dataclasses import dataclass
 
 from app.mailer.campaign.models import ImapConfig, TransportSecurity
+from app.mailer.dev.mock_mailbox import (
+    MOCK_IMAP_FOLDERS,
+    consume_fail_next_imap,
+    is_mock_imap_host,
+    record_imap_append,
+)
 
 
 class ImapConfigurationError(ValueError):
@@ -210,6 +216,14 @@ def test_imap_login(*, imap_config: ImapConfig) -> ImapLoginTestResult:
     """
 
     host, port = _require_imap_config(imap_config)
+    if is_mock_imap_host(imap_config.host):
+        return ImapLoginTestResult(
+            host=host,
+            port=port,
+            security=imap_config.security.value,
+            authenticated=bool(imap_config.username and imap_config.password),
+        )
+
     client = _open_imap(imap_config)
     try:
         return ImapLoginTestResult(
@@ -229,6 +243,16 @@ def list_imap_folders(*, imap_config: ImapConfig) -> ImapFolderListResult:
     """Return folders visible through IMAP LIST and the best sent-folder guess."""
 
     host, port = _require_imap_config(imap_config)
+    if is_mock_imap_host(imap_config.host):
+        folders = [ImapMailboxInfo(name=str(item["name"]), flags=list(item.get("flags") or [])) for item in MOCK_IMAP_FOLDERS]
+        return ImapFolderListResult(
+            host=host,
+            port=port,
+            security=imap_config.security.value,
+            folders=folders,
+            detected_sent_folder="Sent",
+        )
+
     client = _open_imap(imap_config)
     try:
         typ, data = client.list()
@@ -272,6 +296,20 @@ def append_message_to_sent(
     """
 
     host, port = _require_imap_config(imap_config)
+    if is_mock_imap_host(imap_config.host):
+        if consume_fail_next_imap():
+            raise ImapAppendError("Mock IMAP configured to fail the next append", temporary=False)
+        target_folder = folder or (imap_config.sent_folder if imap_config.sent_folder and imap_config.sent_folder != "auto" else "Sent")
+        record = record_imap_append(message_bytes, folder=target_folder, imap_host=imap_config.host)
+        return ImapAppendResult(
+            host=host,
+            port=port,
+            security=imap_config.security.value,
+            folder=target_folder,
+            bytes_appended=len(message_bytes),
+            response=f"mock append stored as {record.id}",
+        )
+
     client: imaplib.IMAP4 | None = None
     try:
         client = _open_imap(imap_config)