第4课：IMAP 邮件系统 —— 怎么连邮箱、收邮件

// 简化版核心逻辑
class ImapManager {
  private connection;  // IMAP 连接对象

  async connect() {
    // 用你的邮箱和应用密码连接 Gmail
    this.connection = new Imap({
      host: 'imap.gmail.com',
      port: 993,
      tls: true,                    // 加密连接
      user: 'you@gmail.com',
      password: 'your-app-password',
    });
  }

  async fetchEmails(count: number) {
    // 从服务器拉取最新的 N 封邮件
    // 返回原始邮件数据（包含 headers、body、attachments）
  }

  async startIDLE() {
    // 开启"待命"模式
    // Gmail 有新邮件时，服务器会主动通知我们
    // 而不是我们隔几秒去问一次"有新邮件吗？"
  }
}

第一步：初始同步
   程序启动 → 连接 Gmail → 拉取最近 N 封邮件 → 全部存入数据库

第二步：实时监听
   开启 IDLE 模式 → 等待 Gmail 推送新邮件通知

第三步：新邮件到达
   Gmail 推送通知 → 拉取新邮件 → 解析 → 存入数据库 → 触发 Listeners
                                                        ↑
                                            这一步是"自动化"的关键！

// email-sync.ts（简化版）
async function syncNewEmails() {
  const rawEmails = await imapManager.fetchNewEmails();

  for (const raw of rawEmails) {
    // 解析邮件
    const email = await parseEmail(raw);

    // 存入数据库
    await database.insertEmail(email);

    // 关键：通知所有监听器 "有新邮件来了！"
    await listenersManager.checkEvent('email_received', email);
    //                                 ↑ 事件类型        ↑ 邮件数据
  }
}

interface Email {
  messageId: string;          // 唯一标识
  threadId: string;           // 对话线程 ID
  from: string;               // 发件人
  to: string[];               // 收件人
  cc: string[];               // 抄送
  subject: string;            // 主题
  date_sent: Date;            // 发送时间
  body_text: string;          // 纯文本内容
  body_html: string;          // HTML 内容
  snippet: string;            // 摘要（前100字）
  is_read: boolean;           // 是否已读
  is_starred: boolean;        // 是否标星
  labels: string[];           // 标签（如 "Finance", "Urgent"）
  has_attachments: boolean;   // 是否有附件
  attachments: Attachment[];  // 附件列表
  folder: string;             // 所在文件夹（INBOX, Sent 等）
}