react-native-email-imap-smtp 0.1.0

package/src/web.ts

@@ -0,0 +1,196 @@
+// ============================================================
+// Web fallback implementation
+// 浏览器环境不支持原生 IMAP/SMTP，提供占位实现
+// ============================================================
+
+import type {
+  IMAPConfig,
+  SMTPConfig,
+  IMAPConnectionResult,
+  SMTPConnectionResult,
+  Mailbox,
+  MailboxStatus,
+  Folder,
+  Email,
+  Attachment,
+  FetchEmailsOptions,
+  SearchCriteria,
+  BatchResult,
+  IMAPNotification,
+  QuotaInfo,
+  AppendResult,
+  SendMailOptions,
+  SendMailResult,
+} from './types';
+
+function notSupported(): never {
+  throw new Error(
+    'IMAP/SMTP operations are not supported in the browser/web environment. ' +
+      'Please use react-native-email-imap-smtp on a native platform (iOS, Android, Windows).'
+  );
+}
+
+// ─── IMAP ────────────────────────────────────────────────────
+
+export async function imapConnect(
+  _config: IMAPConfig
+): Promise<IMAPConnectionResult> {
+  return notSupported();
+}
+
+export async function imapDisconnect(): Promise<void> {
+  return notSupported();
+}
+
+export async function imapListMailboxes(): Promise<Mailbox[]> {
+  return notSupported();
+}
+
+export async function imapSelectMailbox(
+  _mailbox: string,
+  _readOnly?: boolean
+): Promise<MailboxStatus> {
+  return notSupported();
+}
+
+export async function imapRefreshMailbox(): Promise<MailboxStatus> {
+  return notSupported();
+}
+
+export async function imapFetchFolders(): Promise<Folder[]> {
+  return notSupported();
+}
+
+export async function imapCreateFolder(_folderName: string): Promise<void> {
+  return notSupported();
+}
+
+export async function imapDeleteFolder(_folderName: string): Promise<void> {
+  return notSupported();
+}
+
+export async function imapRenameFolder(
+  _oldName: string,
+  _newName: string
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapSubscribeFolder(_folderName: string): Promise<void> {
+  return notSupported();
+}
+
+export async function imapUnsubscribeFolder(
+  _folderName: string
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapFetchEmails(
+  _options: FetchEmailsOptions
+): Promise<Email[]> {
+  return notSupported();
+}
+
+export async function imapFetchEmailByUID(_uid: number): Promise<Email | null> {
+  return notSupported();
+}
+
+export async function imapSearchEmails(
+  _criteria: SearchCriteria
+): Promise<Email[]> {
+  return notSupported();
+}
+
+export async function imapMarkAsRead(
+  _uids: number[],
+  _silent?: boolean
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapMarkAsFlagged(
+  _uids: number[],
+  _flagged: boolean
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapMoveEmails(
+  _uids: number[],
+  _destinationMailbox: string
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapCopyEmails(
+  _uids: number[],
+  _destinationMailbox: string
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapDeleteEmails(_uids: number[]): Promise<BatchResult> {
+  return notSupported();
+}
+
+export async function imapExpunge(): Promise<void> {
+  return notSupported();
+}
+
+export async function imapFetchAttachments(
+  _uid: number,
+  _partId: string
+): Promise<Attachment | null> {
+  return notSupported();
+}
+
+export async function imapFetchAllAttachments(
+  _uid: number
+): Promise<Attachment[]> {
+  return notSupported();
+}
+
+export async function imapIdle(
+  _callback: (notification: IMAPNotification) => void
+): Promise<void> {
+  return notSupported();
+}
+
+export async function imapStopIdle(): Promise<void> {
+  return notSupported();
+}
+
+export async function imapGetQuota(_root?: string): Promise<QuotaInfo> {
+  return notSupported();
+}
+
+export async function imapAppendMessage(
+  _mailbox: string,
+  _rawMimeData: ArrayBuffer,
+  _flags?: string[]
+): Promise<AppendResult> {
+  return notSupported();
+}
+
+// ─── SMTP ────────────────────────────────────────────────────
+
+export async function smtpConnect(
+  _config: SMTPConfig
+): Promise<SMTPConnectionResult> {
+  return notSupported();
+}
+
+export async function smtpDisconnect(): Promise<void> {
+  return notSupported();
+}
+
+export async function smtpSendMail(
+  _options: SendMailOptions
+): Promise<SendMailResult> {
+  return notSupported();
+}
+
+export async function smtpVerifyConnection(): Promise<boolean> {
+  return notSupported();
+}

package/src/windows.ts

@@ -0,0 +1,304 @@
+// ============================================================
+// windows.ts — Windows 平台实现
+// 通过 TurboModule 调用 C++ 原生代码（替代 Nitro）
+// ============================================================
+//
+// TurboModule 只支持基础类型（string, number, boolean, 数组）
+// 复杂对象通过 JSON.stringify/parse 序列化
+// ============================================================
+
+import NativeEmailImapSmtp from './NativeEmailImapSmtp';
+import type {
+  IMAPConfig,
+  SMTPConfig,
+  IMAPConnectionResult,
+  SMTPConnectionResult,
+  Mailbox,
+  MailboxStatus,
+  Folder,
+  Email,
+  Attachment,
+  FetchEmailsOptions,
+  SearchCriteria,
+  BatchResult,
+  QuotaInfo,
+  AppendResult,
+  SendMailOptions,
+  SendMailResult,
+} from './types';
+
+// ─── Session 管理 ──────────────────────────────────────────
+// IMAP 连接是状态性的，需要维护 sessionId
+let imapSessionId: string | null = null;
+let smtpSessionId: string | null = null;
+
+function getImapSessionId(): string {
+  if (!imapSessionId)
+    throw new Error('IMAP not connected. Call imapConnect first.');
+  return imapSessionId;
+}
+
+// ─── IMAP ────────────────────────────────────────────────────
+
+export async function imapConnect(
+  config: IMAPConfig
+): Promise<IMAPConnectionResult> {
+  const resultJson = await NativeEmailImapSmtp.imapConnect(
+    JSON.stringify(config)
+  );
+  const result: IMAPConnectionResult & { sessionId?: string } =
+    JSON.parse(resultJson);
+  if (result.success && result.sessionId) {
+    imapSessionId = result.sessionId;
+  }
+  return result;
+}
+
+export async function imapDisconnect(): Promise<void> {
+  const sid = imapSessionId;
+  imapSessionId = null;
+  if (sid) await NativeEmailImapSmtp.imapDisconnect(sid);
+}
+
+export async function imapListMailboxes(): Promise<Mailbox[]> {
+  const json = await NativeEmailImapSmtp.imapListMailboxes(getImapSessionId());
+  return JSON.parse(json);
+}
+
+export async function imapSelectMailbox(
+  mailbox: string,
+  readOnly?: boolean
+): Promise<MailboxStatus> {
+  const json = await NativeEmailImapSmtp.imapSelectMailbox(
+    getImapSessionId(),
+    mailbox,
+    readOnly ?? false
+  );
+  return JSON.parse(json);
+}
+
+export async function imapRefreshMailbox(): Promise<MailboxStatus> {
+  const json = await NativeEmailImapSmtp.imapRefreshMailbox(getImapSessionId());
+  return JSON.parse(json);
+}
+
+export async function imapFetchFolders(): Promise<Folder[]> {
+  const json = await NativeEmailImapSmtp.imapFetchFolders(getImapSessionId());
+  return JSON.parse(json);
+}
+
+export async function imapCreateFolder(folderName: string): Promise<void> {
+  await NativeEmailImapSmtp.imapCreateFolder(getImapSessionId(), folderName);
+}
+
+export async function imapDeleteFolder(folderName: string): Promise<void> {
+  await NativeEmailImapSmtp.imapDeleteFolder(getImapSessionId(), folderName);
+}
+
+export async function imapRenameFolder(
+  oldName: string,
+  newName: string
+): Promise<void> {
+  await NativeEmailImapSmtp.imapRenameFolder(
+    getImapSessionId(),
+    oldName,
+    newName
+  );
+}
+
+export async function imapSubscribeFolder(folderName: string): Promise<void> {
+  await NativeEmailImapSmtp.imapSubscribeFolder(getImapSessionId(), folderName);
+}
+
+export async function imapUnsubscribeFolder(folderName: string): Promise<void> {
+  await NativeEmailImapSmtp.imapUnsubscribeFolder(
+    getImapSessionId(),
+    folderName
+  );
+}
+
+export async function imapFetchEmails(
+  options: FetchEmailsOptions
+): Promise<Email[]> {
+  const json = await NativeEmailImapSmtp.imapFetchEmails(
+    getImapSessionId(),
+    JSON.stringify(options)
+  );
+  return JSON.parse(json);
+}
+
+export async function imapFetchEmailByUID(uid: number): Promise<Email | null> {
+  const json = await NativeEmailImapSmtp.imapFetchEmailByUID(
+    getImapSessionId(),
+    uid
+  );
+  return JSON.parse(json);
+}
+
+export async function imapSearchEmails(
+  criteria: SearchCriteria
+): Promise<Email[]> {
+  const json = await NativeEmailImapSmtp.imapSearchEmails(
+    getImapSessionId(),
+    JSON.stringify(criteria)
+  );
+  return JSON.parse(json);
+}
+
+export async function imapMarkAsRead(
+  uids: number[],
+  silent: boolean
+): Promise<void> {
+  await NativeEmailImapSmtp.imapMarkAsRead(
+    getImapSessionId(),
+    JSON.stringify(uids),
+    silent
+  );
+}
+
+export async function imapMarkAsFlagged(
+  uids: number[],
+  flagged: boolean
+): Promise<void> {
+  await NativeEmailImapSmtp.imapMarkAsFlagged(
+    getImapSessionId(),
+    JSON.stringify(uids),
+    flagged
+  );
+}
+
+export async function imapMoveEmails(
+  uids: number[],
+  destinationMailbox: string
+): Promise<void> {
+  await NativeEmailImapSmtp.imapMoveEmails(
+    getImapSessionId(),
+    JSON.stringify(uids),
+    destinationMailbox
+  );
+}
+
+export async function imapCopyEmails(
+  uids: number[],
+  destinationMailbox: string
+): Promise<void> {
+  await NativeEmailImapSmtp.imapCopyEmails(
+    getImapSessionId(),
+    JSON.stringify(uids),
+    destinationMailbox
+  );
+}
+
+export async function imapDeleteEmails(uids: number[]): Promise<BatchResult> {
+  const json = await NativeEmailImapSmtp.imapDeleteEmails(
+    getImapSessionId(),
+    JSON.stringify(uids)
+  );
+  return JSON.parse(json);
+}
+
+export async function imapExpunge(): Promise<void> {
+  await NativeEmailImapSmtp.imapExpunge(getImapSessionId());
+}
+
+export async function imapFetchAttachments(
+  uid: number,
+  partId: string
+): Promise<Attachment | null> {
+  const json = await NativeEmailImapSmtp.imapFetchAttachment(
+    getImapSessionId(),
+    uid,
+    partId
+  );
+  return JSON.parse(json);
+}
+
+export async function imapFetchAllAttachments(
+  uid: number
+): Promise<Attachment[]> {
+  const json = await NativeEmailImapSmtp.imapFetchAllAttachments(
+    getImapSessionId(),
+    uid
+  );
+  return JSON.parse(json);
+}
+
+export async function imapIdle(): Promise<void> {
+  await NativeEmailImapSmtp.imapIdle(getImapSessionId());
+}
+
+export async function imapStopIdle(): Promise<void> {
+  await NativeEmailImapSmtp.imapStopIdle(getImapSessionId());
+}
+
+export async function imapGetQuota(root?: string): Promise<QuotaInfo> {
+  const json = await NativeEmailImapSmtp.imapGetQuota(
+    getImapSessionId(),
+    root ?? null
+  );
+  return JSON.parse(json);
+}
+
+export async function imapAppendMessage(
+  mailbox: string,
+  rawMimeData: ArrayBuffer,
+  flags?: string[]
+): Promise<AppendResult> {
+  // ArrayBuffer → Base64 string
+  const bytes = new Uint8Array(rawMimeData);
+  let binary = '';
+  for (let i = 0; i < bytes.length; i++) {
+    const byte = bytes[i];
+    if (byte !== undefined) binary += String.fromCharCode(byte);
+  }
+  const base64 = btoa(binary);
+  const json = await NativeEmailImapSmtp.imapAppendMessage(
+    getImapSessionId(),
+    mailbox,
+    base64,
+    flags ? JSON.stringify(flags) : null
+  );
+  return JSON.parse(json);
+}
+
+// ═══ SMTP ═══════════════════════════════════════════════════
+
+export async function smtpConnect(
+  config: SMTPConfig
+): Promise<SMTPConnectionResult> {
+  const resultJson = await NativeEmailImapSmtp.smtpConnect(
+    JSON.stringify(config)
+  );
+  const result: SMTPConnectionResult & { sessionId?: string } =
+    JSON.parse(resultJson);
+  if (result.success && result.sessionId) {
+    smtpSessionId = result.sessionId;
+  }
+  return result;
+}
+
+export async function smtpDisconnect(): Promise<void> {
+  const sid = smtpSessionId;
+  smtpSessionId = null;
+  if (sid) await NativeEmailImapSmtp.smtpDisconnect(sid);
+}
+
+export async function smtpSendMail(
+  options: SendMailOptions
+): Promise<SendMailResult> {
+  const json = await NativeEmailImapSmtp.smtpSendMail(
+    getSmtpSessionId(),
+    JSON.stringify(options)
+  );
+  return JSON.parse(json);
+}
+
+export async function smtpVerifyConnection(): Promise<boolean> {
+  return NativeEmailImapSmtp.smtpVerifyConnection(getSmtpSessionId());
+}
+
+function getSmtpSessionId(): string {
+  if (!smtpSessionId)
+    throw new Error('SMTP not connected. Call smtpConnect first.');
+  return smtpSessionId;
+}