react-native-email-imap-smtp 0.3.30 → 0.3.32

package/server/src/smtpHandler.ts

@@ -1,242 +1,310 @@
-// ============================================================
-// SMTP 代理处理器 — 基于 nodemailer
-// ============================================================
-
-import nodemailer from 'nodemailer';
-import { v4 as uuidv4 } from 'uuid';
-
-// ─── 类型 ───────────────────────────────────────────────────
-
-interface SmtpSession {
-  transporter: nodemailer.Transporter;
-  config: any;
-}
-
-const sessions = new Map<string, SmtpSession>();
-
-// ─── 辅助 ───────────────────────────────────────────────────
-
-function getSession(sessionId: string): SmtpSession {
-  const s = sessions.get(sessionId);
-  if (!s) {
-    throw new Error('SMTP not connected. Call smtpConnect first.');
-  }
-  return s;
-}
-
-// ─── 连接 ───────────────────────────────────────────────────
-
-export async function connect(config: any): Promise<any> {
-  const sessionId = uuidv4();
-
-  try {
-    const transporter = nodemailer.createTransport({
-      host: config.host,
-      port: config.port ?? 465,
-      secure: config.tls ?? true,
-      auth: {
-        user: config.username,
-        pass: config.password,
-        accessToken: config.accessToken,
-      },
-      authMethod: config.authType === 'oauth2' ? 'XOAUTH2' : undefined,
-      tls: {
-        rejectUnauthorized: config.checkCertificate ?? true,
-      },
-      name: config.helloName,
-      connectionTimeout: config.timeout ?? 30000,
-      greetingTimeout: config.timeout ?? 30000,
-      socketTimeout: config.timeout ?? 30000,
-      debug: config.debug ?? false,
-      logger: config.debug ?? false,
-    });
-
-    sessions.set(sessionId, { transporter, config });
-
-    // 获取服务器信息（verify 会连接并验证）
-    let serverName = config.host;
-    const capabilities: string[] = [];
-    const supportedAuthMethods: string[] = [];
-
-    try {
-      await transporter.verify();
-    } catch {
-      // verify 失败不一定意味着连接失败，可能是认证问题
-      // 我们仍然返回 session
-    }
-
-    return {
-      success: true,
-      sessionId,
-      serverInfo: {
-        serverName,
-        capabilities,
-        supportedAuthMethods,
-      },
-    };
-  } catch (err: any) {
-    return {
-      success: false,
-      error: err.message ?? 'SMTP connection failed',
-    };
-  }
-}
-
-// ─── 断开连接 ───────────────────────────────────────────────
-
-export async function disconnect(sessionId: string): Promise<void> {
-  const s = sessions.get(sessionId);
-  if (s) {
-    s.transporter.close();
-    sessions.delete(sessionId);
-  }
-}
-
-// ─── 发送邮件 ──────────────────────────────────────────────
-
-export async function sendMail(sessionId: string, options: any): Promise<any> {
-  const s = getSession(sessionId);
-
-  try {
-    // 转换附件格式
-    const attachments: any[] = [];
-    if (options.attachments) {
-      for (const att of options.attachments) {
-        const attachment: any = {
-          filename: att.filename,
-          contentType: att.mimeType,
-          disposition:
-            att.disposition ?? (att.isInline ? 'inline' : 'attachment'),
-        };
-
-        if (att.contentId) {
-          attachment.contentId = att.contentId;
-          attachment.cid = att.contentId;
-        }
-
-        // data 可能是 ArrayBuffer、Buffer 或 base64 字符串
-        if (att.data) {
-          if (typeof att.data === 'string') {
-            // base64 编码的字符串
-            attachment.content = Buffer.from(att.data, 'base64');
-            attachment.encoding = 'base64';
-          } else if (att.data instanceof ArrayBuffer) {
-            attachment.content = Buffer.from(att.data);
-          } else if (att.data.buffer instanceof ArrayBuffer) {
-            attachment.content = Buffer.from(att.data.buffer);
-          } else {
-            attachment.content = att.data;
-          }
-        }
-
-        attachments.push(attachment);
-      }
-    }
-
-    // 构建邮件选项
-    const mailOptions: any = {
-      from: {
-        name: options.from?.name ?? '',
-        address: options.from?.email ?? '',
-      },
-      to: (options.to ?? []).map((a: any) => ({
-        name: a.name ?? '',
-        address: a.email ?? '',
-      })),
-      subject: options.subject ?? '',
-    };
-
-    if (options.cc && options.cc.length > 0) {
-      mailOptions.cc = options.cc.map((a: any) => ({
-        name: a.name ?? '',
-        address: a.email ?? '',
-      }));
-    }
-
-    if (options.bcc && options.bcc.length > 0) {
-      mailOptions.bcc = options.bcc.map((a: any) => ({
-        name: a.name ?? '',
-        address: a.email ?? '',
-      }));
-    }
-
-    if (options.replyTo && options.replyTo.length > 0) {
-      mailOptions.replyTo = options.replyTo.map((a: any) => ({
-        name: a.name ?? '',
-        address: a.email ?? '',
-      }));
-    }
-
-    if (options.textBody) mailOptions.text = options.textBody;
-    if (options.htmlBody) mailOptions.html = options.htmlBody;
-
-    if (attachments.length > 0) mailOptions.attachments = attachments;
-
-    if (options.priority) {
-      mailOptions.priority = options.priority;
-      mailOptions.headers = mailOptions.headers ?? {};
-      const priorityMap: Record<string, string> = {
-        high: '1',
-        normal: '3',
-        low: '5',
-      };
-      mailOptions.headers['X-Priority'] = priorityMap[options.priority] ?? '3';
-    }
-
-    if (options.headers) {
-      mailOptions.headers = {
-        ...(mailOptions.headers ?? {}),
-        ...options.headers,
-      };
-    }
-
-    if (options.inReplyTo) mailOptions.inReplyTo = options.inReplyTo;
-    if (options.references) mailOptions.references = options.references;
-
-    if (options.readReceiptTo) {
-      mailOptions.headers = mailOptions.headers ?? {};
-      mailOptions.headers['Disposition-Notification-To'] =
-        options.readReceiptTo.email;
-    }
-
-    if (options.charset) mailOptions.charset = options.charset;
-    if (options.encoding) mailOptions.encoding = options.encoding;
-
-    // 发送
-    const info = await s.transporter.sendMail(mailOptions);
-
-    return {
-      success: true,
-      messageId: info.messageId,
-      date: new Date().toISOString(),
-      serverResponseCode: info.response
-        ? parseInt(info.response, 10) || 250
-        : 250,
-      queueId: info.messageId,
-    };
-  } catch (err: any) {
-    return {
-      success: false,
-      error: err.message ?? 'Failed to send email',
-      retryable: err.code === 'ECONNECTION' || err.code === 'ETIMEDOUT',
-    };
-  }
-}
-
-// ─── 验证连接 ──────────────────────────────────────────────
-
-export async function verifyConnection(sessionId: string): Promise<boolean> {
-  const s = getSession(sessionId);
-  try {
-    await s.transporter.verify();
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// ─── 获取所有 session ID（用于清理）────────────────────────
-
-export function getAllSessionIds(): string[] {
-  return Array.from(sessions.keys());
-}
+// ============================================================
+// SMTP 代理处理器 — 基于 nodemailer
+// ============================================================
+
+import nodemailer from 'nodemailer';
+import { v4 as uuidv4 } from 'uuid';
+
+// ─── 类型 ───────────────────────────────────────────────────
+
+interface SmtpSession {
+  transporter: nodemailer.Transporter;
+  config: any;
+  /** 服务器 SIZE（RFC 1870）上限（字节），未通告为 0 */
+  maxMessageSize: number;
+}
+
+const sessions = new Map<string, SmtpSession>();
+
+// ─── 辅助 ───────────────────────────────────────────────────
+
+function getSession(sessionId: string): SmtpSession {
+  const s = sessions.get(sessionId);
+  if (!s) {
+    throw new Error('SMTP not connected. Call smtpConnect first.');
+  }
+  return s;
+}
+
+/** 轻量探测 SMTP 服务器 SIZE（RFC 1870）上限（字节）；未通告返回 0。
+ *  用 nodemailer 内部 SMTPConnection 做一次 EHLO 即读 `_maxAllowedSize` 后关闭。 */
+async function probeMaxMessageSize(config: any): Promise<number> {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const SMTPConnection: any = require('nodemailer/lib/smtp-connection');
+    const conn = new SMTPConnection({
+      host: config.host,
+      port: config.port ?? 465,
+      secure: config.tls ?? true,
+      connectionTimeout: config.timeout ?? 30000,
+      tls: { rejectUnauthorized: config.checkCertificate ?? true },
+      name: config.helloName,
+      logger: false,
+    });
+    return await new Promise<number>((resolve) => {
+      const done = (v: number) => {
+        try {
+          conn.close();
+        } catch {
+          /* ignore */
+        }
+        resolve(v);
+      };
+      conn.on('connect', () => done(conn._maxAllowedSize || 0));
+      conn.on('error', () => done(0));
+      conn.connect((err: any) => {
+        if (err) done(0);
+      });
+    });
+  } catch {
+    return 0;
+  }
+}
+
+// ─── 连接 ───────────────────────────────────────────────────
+
+export async function connect(config: any): Promise<any> {
+  const sessionId = uuidv4();
+
+  try {
+    const transporter = nodemailer.createTransport({
+      host: config.host,
+      port: config.port ?? 465,
+      secure: config.tls ?? true,
+      auth: {
+        user: config.username,
+        pass: config.password,
+        accessToken: config.accessToken,
+      },
+      authMethod: config.authType === 'oauth2' ? 'XOAUTH2' : undefined,
+      tls: {
+        rejectUnauthorized: config.checkCertificate ?? true,
+      },
+      name: config.helloName,
+      connectionTimeout: config.timeout ?? 30000,
+      greetingTimeout: config.timeout ?? 30000,
+      socketTimeout: config.timeout ?? 30000,
+      debug: config.debug ?? false,
+      logger: config.debug ?? false,
+    });
+
+    sessions.set(sessionId, { transporter, config, maxMessageSize: 0 });
+
+    let serverName = config.host;
+    const capabilities: string[] = [];
+    const supportedAuthMethods: string[] = [];
+
+    // 探测服务器 SIZE（RFC 1870）上限，用于发信前预检。
+    // 说明：不再单独调 transporter.verify() —— nodemailer 非 pool 模式每次操作都新建连接、用完即关，
+    // 没有可复用的常驻连接；verify() 的失败此前也被忽略，属多余的一次握手，故合并到 probe 这一条连接里。
+    const maxMessageSize = await probeMaxMessageSize(config);
+    const session = sessions.get(sessionId);
+    if (session) session.maxMessageSize = maxMessageSize;
+    if (maxMessageSize > 0) {
+      capabilities.push(`SIZE=${maxMessageSize}`);
+    }
+
+    return {
+      success: true,
+      sessionId,
+      serverInfo: {
+        serverName,
+        capabilities,
+        supportedAuthMethods,
+        maxMessageSize,
+      },
+    };
+  } catch (err: any) {
+    return {
+      success: false,
+      error: err.message ?? 'SMTP connection failed',
+    };
+  }
+}
+
+// ─── 断开连接 ───────────────────────────────────────────────
+
+export async function disconnect(sessionId: string): Promise<void> {
+  const s = sessions.get(sessionId);
+  if (s) {
+    s.transporter.close();
+    sessions.delete(sessionId);
+  }
+}
+
+// ─── 发送邮件 ──────────────────────────────────────────────
+
+/** 估算邮件整体大小（字节），含 base64 膨胀与 MIME 边界开销 */
+function estimateMailSize(mailOptions: any): number {
+  let size = 0;
+  if (mailOptions.text) size += Buffer.byteLength(String(mailOptions.text));
+  if (mailOptions.html) size += Buffer.byteLength(String(mailOptions.html));
+  for (const att of mailOptions.attachments ?? []) {
+    if (att.content && typeof att.content.length === 'number') {
+      // base64 膨胀 ≈ 4/3，留 1.4 余量；含 MIME 部分头
+      size += Math.ceil(att.content.length * 1.4) + 1024;
+    }
+  }
+  size += 4096; // 信封 + 头字段 + 边界开销
+  return Math.ceil(size);
+}
+
+export async function sendMail(sessionId: string, options: any): Promise<any> {
+  const s = getSession(sessionId);
+
+  try {
+    // 转换附件格式
+    const attachments: any[] = [];
+    if (options.attachments) {
+      for (const att of options.attachments) {
+        const attachment: any = {
+          filename: att.filename,
+          contentType: att.mimeType,
+          disposition:
+            att.disposition ?? (att.isInline ? 'inline' : 'attachment'),
+        };
+
+        if (att.contentId) {
+          attachment.contentId = att.contentId;
+          attachment.cid = att.contentId;
+        }
+
+        // data 可能是 ArrayBuffer、Buffer 或 base64 字符串
+        if (att.data) {
+          if (typeof att.data === 'string') {
+            // base64 编码的字符串
+            attachment.content = Buffer.from(att.data, 'base64');
+            attachment.encoding = 'base64';
+          } else if (att.data instanceof ArrayBuffer) {
+            attachment.content = Buffer.from(att.data);
+          } else if (att.data.buffer instanceof ArrayBuffer) {
+            attachment.content = Buffer.from(att.data.buffer);
+          } else {
+            attachment.content = att.data;
+          }
+        }
+
+        attachments.push(attachment);
+      }
+    }
+
+    // 构建邮件选项
+    const mailOptions: any = {
+      from: {
+        name: options.from?.name ?? '',
+        address: options.from?.email ?? '',
+      },
+      to: (options.to ?? []).map((a: any) => ({
+        name: a.name ?? '',
+        address: a.email ?? '',
+      })),
+      subject: options.subject ?? '',
+    };
+
+    if (options.cc && options.cc.length > 0) {
+      mailOptions.cc = options.cc.map((a: any) => ({
+        name: a.name ?? '',
+        address: a.email ?? '',
+      }));
+    }
+
+    if (options.bcc && options.bcc.length > 0) {
+      mailOptions.bcc = options.bcc.map((a: any) => ({
+        name: a.name ?? '',
+        address: a.email ?? '',
+      }));
+    }
+
+    if (options.replyTo && options.replyTo.length > 0) {
+      mailOptions.replyTo = options.replyTo.map((a: any) => ({
+        name: a.name ?? '',
+        address: a.email ?? '',
+      }));
+    }
+
+    if (options.textBody) mailOptions.text = options.textBody;
+    if (options.htmlBody) mailOptions.html = options.htmlBody;
+
+    if (attachments.length > 0) mailOptions.attachments = attachments;
+
+    if (options.priority) {
+      mailOptions.priority = options.priority;
+      mailOptions.headers = mailOptions.headers ?? {};
+      const priorityMap: Record<string, string> = {
+        high: '1',
+        normal: '3',
+        low: '5',
+      };
+      mailOptions.headers['X-Priority'] = priorityMap[options.priority] ?? '3';
+    }
+
+    if (options.headers) {
+      mailOptions.headers = {
+        ...(mailOptions.headers ?? {}),
+        ...options.headers,
+      };
+    }
+
+    if (options.inReplyTo) mailOptions.inReplyTo = options.inReplyTo;
+    if (options.references) mailOptions.references = options.references;
+
+    if (options.readReceiptTo) {
+      mailOptions.headers = mailOptions.headers ?? {};
+      mailOptions.headers['Disposition-Notification-To'] =
+        options.readReceiptTo.email;
+    }
+
+    if (options.charset) mailOptions.charset = options.charset;
+    if (options.encoding) mailOptions.encoding = options.encoding;
+
+    // 发信前预检：估算消息大小是否超过服务器 SIZE 限制（RFC 1870）
+    const maxSize = s.maxMessageSize ?? 0;
+    if (maxSize > 0) {
+      const estimated = estimateMailSize(mailOptions);
+      if (estimated > maxSize) {
+        return {
+          success: false,
+          error: `邮件大小约 ${Math.round(estimated / 1024)}KB 超过服务器 SIZE 限制 ${Math.round(maxSize / 1024)}KB（${maxSize} 字节）`,
+          retryable: false,
+        };
+      }
+    }
+
+    // 发送
+    const info = await s.transporter.sendMail(mailOptions);
+
+    return {
+      success: true,
+      messageId: info.messageId,
+      date: new Date().toISOString(),
+      serverResponseCode: info.response
+        ? parseInt(info.response, 10) || 250
+        : 250,
+      queueId: info.messageId,
+    };
+  } catch (err: any) {
+    return {
+      success: false,
+      error: err.message ?? 'Failed to send email',
+      retryable: err.code === 'ECONNECTION' || err.code === 'ETIMEDOUT',
+    };
+  }
+}
+
+// ─── 验证连接 ──────────────────────────────────────────────
+
+export async function verifyConnection(sessionId: string): Promise<boolean> {
+  const s = getSession(sessionId);
+  try {
+    await s.transporter.verify();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ─── 获取所有 session ID（用于清理）────────────────────────
+
+export function getAllSessionIds(): string[] {
+  return Array.from(sessions.keys());
+}

package/src/EmailImapSmtp.nitro.ts

@@ -45,6 +45,8 @@ export interface ConnectionConfig {
   checkCertificate: boolean;
   /** 是否输出调试日志 */
   debug: boolean;
+  /** 下载分块大小（字节），默认 1048576（1MB）；调大可提升大附件下载速度 */
+  downloadChunkSize?: number;
 }
 
 /**
@@ -97,6 +99,8 @@ export interface SmtpServerInfo {
   capabilities: string[];
   /** 支持的认证方法列表 */
   supportedAuthMethods: string[];
+  /** 服务器接受的最大邮件大小（字节，RFC 1870 SIZE）；未通告时为 undefined/0 */
+  maxMessageSize?: number;
 }
 
 /**

package/src/native.ts

@@ -51,6 +51,7 @@ export async function imapConnect(
     timeout: config.timeout ?? 30000,
     checkCertificate: config.checkCertificate ?? true,
     debug: config.debug ?? false,
+    downloadChunkSize: config.downloadChunkSize,
   }) as Promise<IMAPConnectionResult>;
 }
 

package/src/types.ts

@@ -51,6 +51,12 @@ export interface IMAPConfig {
   checkCertificate?: boolean;
   /** 是否在控制台输出调试日志 */
   debug?: boolean;
+  /**
+   * 下载分块大小（字节），默认 1048576（1MB）。
+   * Web 与 Android 通用：调大可减少大附件的分段请求次数、提升下载速度。
+   * 建议 256KB ~ 4MB；过大可能被服务器截断单次响应。
+   */
+  downloadChunkSize?: number;
 }
 
 /**
@@ -115,6 +121,8 @@ export interface SMTPConnectionResult {
     capabilities: string[];
     /** 服务器支持的认证方法，如 `PLAIN`、`LOGIN`、`XOAUTH2` */
     supportedAuthMethods: string[];
+    /** 服务器接受的最大邮件大小（字节，RFC 1870 SIZE）；未通告时为 0 或不返回 */
+    maxMessageSize?: number;
   };
   /** 连接失败时的错误信息（成功时为空） */
   error?: string;