react-native-email-imap-smtp 0.1.0

package/src/EmailImapSmtp.nitro.ts

@@ -0,0 +1,333 @@
+// ============================================================
+// EmailImapSmtp — Nitro HybridObject Interface
+// iOS -> Swift  |  Android -> Kotlin
+// ============================================================
+
+import type { HybridObject } from 'react-native-nitro-modules';
+
+// ─── Shared Types ─────────────────────────────────────────
+
+export interface EmailAddress {
+  name: string;
+  email: string;
+}
+
+export interface ConnectionConfig {
+  host: string;
+  port: number;
+  username: string;
+  password: string;
+  tls: boolean;
+  authType: string;
+  accessToken?: string;
+  timeout: number;
+  checkCertificate: boolean;
+  debug: boolean;
+}
+
+export interface SmtpConnectionConfig {
+  host: string;
+  port: number;
+  username: string;
+  password: string;
+  tls: boolean;
+  authType: string;
+  accessToken?: string;
+  timeout: number;
+  checkCertificate: boolean;
+  helloName?: string;
+  debug: boolean;
+}
+
+export interface ImapServerInfo {
+  serverName: string;
+  capabilities: string[];
+  isCompressed: boolean;
+}
+
+export interface SmtpServerInfo {
+  serverName: string;
+  capabilities: string[];
+  supportedAuthMethods: string[];
+}
+
+export interface ConnectionResult {
+  success: boolean;
+  serverInfo?: ImapServerInfo | SmtpServerInfo;
+  error?: string;
+}
+
+export interface MailboxListItem {
+  name: string;
+  path: string;
+  delimiter: string;
+  flags: string[];
+  subscribed: boolean;
+}
+
+export interface MailboxInfo {
+  name: string;
+  path: string;
+  uidNext: number;
+  uidValidity: number;
+  messageCount: number;
+  recentCount: number;
+  unseenCount: number;
+  firstUnseenUid: number;
+  highestModSeq: number;
+  flags: string[];
+  permanentFlags: string[];
+}
+
+export interface FolderInfo {
+  name: string;
+  path: string;
+  delimiter: string;
+  parent: string;
+  children: string[];
+  flags: string[];
+  subscribed: boolean;
+  messageCount: number;
+  unseenCount: number;
+}
+
+export interface EmailBody {
+  text: string;
+  html: string;
+  embeddedAttachments: string[];
+}
+
+export interface EmailMessage {
+  uid: number;
+  sequenceNumber: number;
+  subject: string;
+  from: EmailAddress;
+  to: EmailAddress[];
+  cc: EmailAddress[];
+  bcc: EmailAddress[];
+  replyTo: EmailAddress[];
+  date: string;
+  receivedDate: string;
+  body: EmailBody;
+  attachments: AttachmentInfo[];
+  flags: string[];
+  headers: Record<string, string>;
+  size: number;
+  messageId: string;
+  inReplyTo: string;
+  references: string;
+  priority: string;
+  isEncrypted: boolean;
+  mimeType: string;
+  charset: string;
+}
+
+export interface FetchEmailsOptions {
+  from?: number;
+  to?: number;
+  rangeType?: string;
+  page?: number;
+  pageSize?: number;
+  since?: string;
+  before?: string;
+  mailbox?: string;
+  fetchBody: boolean;
+  fetchAttachments: boolean;
+  fetchFlags: boolean;
+  fetchHeaders: boolean;
+  fetchFullContent: boolean;
+  maxBodySize: number;
+}
+
+export interface SearchHeader {
+  key: string;
+  value: string;
+}
+
+export interface SearchCriteria {
+  text?: string;
+  subject?: string;
+  from?: string;
+  to?: string;
+  body?: string;
+  since?: string;
+  before?: string;
+  on?: string;
+  sentSince?: string;
+  sentBefore?: string;
+  flagged?: boolean;
+  seen?: boolean;
+  answered?: boolean;
+  draft?: boolean;
+  deleted?: boolean;
+  junk?: boolean;
+  hasAttachment?: boolean;
+  uids?: number[];
+  header?: SearchHeader;
+  larger?: number;
+  smaller?: number;
+  mailbox?: string;
+  sortOrder?: string;
+  limit?: number;
+  fetchBody: boolean;
+  fetchAttachments: boolean;
+  fetchFlags: boolean;
+  fetchHeaders: boolean;
+  fetchFullContent: boolean;
+  maxBodySize: number;
+}
+
+export interface DeleteResult {
+  success: number[];
+  failed: number[];
+  error?: string;
+}
+
+export interface AttachmentInfo {
+  filename: string;
+  mimeType: string;
+  partId: string;
+  size: number;
+  data: ArrayBuffer;
+  contentId?: string;
+  inline: boolean;
+  charset?: string;
+  contentDisposition: string;
+  /** 附件缓存在本地的文件路径（如果有），避免大附件全部加载到内存 */
+  localPath?: string;
+}
+
+export interface IdleNotification {
+  type: string;
+  mailbox: string;
+  uid?: number;
+  flag?: string;
+  messageCount?: number;
+  timestamp: number;
+}
+
+export interface QuotaInfo {
+  storageUsed: number;
+  storageLimit: number;
+  storageUnit: string;
+  messagesUsed?: number;
+  messagesLimit?: number;
+  root: string;
+}
+
+export interface AppendResult {
+  uid: number;
+  uidValidity: number;
+  date: string;
+}
+
+export interface SmtpAttachment {
+  filename: string;
+  mimeType: string;
+  data: ArrayBuffer;
+  inline: boolean;
+  contentId?: string;
+  disposition?: string;
+}
+
+export interface SendMailOptions {
+  from: EmailAddress;
+  to: EmailAddress[];
+  cc?: EmailAddress[];
+  bcc?: EmailAddress[];
+  replyTo?: EmailAddress[];
+  subject: string;
+  textBody?: string;
+  htmlBody?: string;
+  attachments?: SmtpAttachment[];
+  priority?: string;
+  headers?: Record<string, string>;
+  inReplyTo?: string;
+  references?: string;
+  readReceiptTo?: EmailAddress;
+  charset?: string;
+  encoding?: string;
+}
+
+export interface SendMailResult {
+  success: boolean;
+  messageId?: string;
+  date?: string;
+  serverResponseCode?: number;
+  rawMimeData?: ArrayBuffer;
+  queueId?: string;
+  error?: string;
+  retryable?: boolean;
+}
+
+// ═══════════════════════════════════════════════════════════
+//  HybridObject Interface
+// ═══════════════════════════════════════════════════════════
+
+export interface EmailImapSmtp extends HybridObject<{
+  ios: 'swift';
+  android: 'kotlin';
+}> {
+  // ─── Connection ─────────────────────────────────────────
+  imapConnect(config: ConnectionConfig): Promise<ConnectionResult>;
+  imapDisconnect(): Promise<void>;
+
+  // ─── Mailbox ────────────────────────────────────────────
+  imapListMailboxes(): Promise<MailboxListItem[]>;
+  imapSelectMailbox(mailbox: string, readOnly: boolean): Promise<MailboxInfo>;
+  imapRefreshMailbox(): Promise<MailboxInfo>;
+
+  // ─── Folders ────────────────────────────────────────────
+  imapFetchFolders(): Promise<FolderInfo[]>;
+  imapCreateFolder(folderName: string): Promise<void>;
+  imapDeleteFolder(folderName: string): Promise<void>;
+  imapRenameFolder(oldName: string, newName: string): Promise<void>;
+  imapSubscribeFolder(folderName: string): Promise<void>;
+  imapUnsubscribeFolder(folderName: string): Promise<void>;
+
+  // ─── Fetch Emails ────────────────────────────────────────
+  imapFetchEmails(options: FetchEmailsOptions): Promise<EmailMessage[]>;
+  imapFetchEmailByUID(uid: number): Promise<EmailMessage | null>;
+
+  // ─── Search ─────────────────────────────────────────────
+  imapSearchEmails(criteria: SearchCriteria): Promise<EmailMessage[]>;
+
+  // ─── Flags ──────────────────────────────────────────────
+  imapMarkAsRead(uids: number[], silent: boolean): Promise<void>;
+  imapMarkAsFlagged(uids: number[], flagged: boolean): Promise<void>;
+
+  // ─── Move / Copy / Delete ───────────────────────────────
+  imapMoveEmails(uids: number[], destinationMailbox: string): Promise<void>;
+  imapCopyEmails(uids: number[], destinationMailbox: string): Promise<void>;
+  imapDeleteEmails(uids: number[]): Promise<DeleteResult>;
+  imapExpunge(): Promise<void>;
+
+  // ─── Attachments ───────────────────────────────────────
+  imapFetchAttachments(
+    uid: number,
+    partId: string
+  ): Promise<AttachmentInfo | null>;
+  imapFetchAllAttachments(uid: number): Promise<AttachmentInfo[]>;
+
+  // ─── IDLE ──────────────────────────────────────────────
+  imapIdle(callback: (notification: IdleNotification) => void): Promise<void>;
+  imapStopIdle(): Promise<void>;
+
+  // ─── Quota ──────────────────────────────────────────────
+  imapGetQuota(root?: string): Promise<QuotaInfo>;
+
+  // ─── Append ────────────────────────────────────────────
+  imapAppendMessage(
+    mailbox: string,
+    rawMimeData: ArrayBuffer,
+    flags?: string[]
+  ): Promise<AppendResult>;
+
+  // ═══════════════════════════════════════════════════════
+  //  SMTP
+  // ═══════════════════════════════════════════════════════
+  smtpConnect(config: SmtpConnectionConfig): Promise<ConnectionResult>;
+  smtpDisconnect(): Promise<void>;
+  smtpSendMail(options: SendMailOptions): Promise<SendMailResult>;
+  smtpVerifyConnection(): Promise<boolean>;
+}

package/src/NativeEmailImapSmtp.ts

@@ -0,0 +1,100 @@
+// ============================================================
+// NativeEmailImapSmtp.ts — Windows TurboModule 接口定义
+// Android 继续使用 Nitro (src/native.ts)
+// ============================================================
+// react-native-windows 的 autolinking 会识别此文件并生成
+// 对应的 C++/WinRT 桥接代码 (.g.h / .g.cpp)
+// ============================================================
+
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+  // ─── IMAP 连接 ─────────────────────────────────────────
+  imapConnect(configJson: string): Promise<string>;
+  imapDisconnect(sessionId: string): Promise<void>;
+
+  // ─── 邮箱操作 ──────────────────────────────────────────
+  imapListMailboxes(sessionId: string): Promise<string>;
+  imapSelectMailbox(
+    sessionId: string,
+    mailbox: string,
+    readOnly: boolean
+  ): Promise<string>;
+  imapRefreshMailbox(sessionId: string): Promise<string>;
+
+  // ─── 文件夹操作 ────────────────────────────────────────
+  imapFetchFolders(sessionId: string): Promise<string>;
+  imapCreateFolder(sessionId: string, folderName: string): Promise<void>;
+  imapDeleteFolder(sessionId: string, folderName: string): Promise<void>;
+  imapRenameFolder(
+    sessionId: string,
+    oldName: string,
+    newName: string
+  ): Promise<void>;
+  imapSubscribeFolder(sessionId: string, folderName: string): Promise<void>;
+  imapUnsubscribeFolder(sessionId: string, folderName: string): Promise<void>;
+
+  // ─── 获取邮件 ──────────────────────────────────────────
+  imapFetchEmails(sessionId: string, optionsJson: string): Promise<string>;
+  imapFetchEmailByUID(sessionId: string, uid: number): Promise<string>;
+
+  // ─── 搜索 ──────────────────────────────────────────────
+  imapSearchEmails(sessionId: string, criteriaJson: string): Promise<string>;
+
+  // ─── 标记 ──────────────────────────────────────────────
+  imapMarkAsRead(
+    sessionId: string,
+    uidsJson: string,
+    silent: boolean
+  ): Promise<void>;
+  imapMarkAsFlagged(
+    sessionId: string,
+    uidsJson: string,
+    flagged: boolean
+  ): Promise<void>;
+
+  // ─── 移动/复制/删除 ────────────────────────────────────
+  imapMoveEmails(
+    sessionId: string,
+    uidsJson: string,
+    destinationMailbox: string
+  ): Promise<void>;
+  imapCopyEmails(
+    sessionId: string,
+    uidsJson: string,
+    destinationMailbox: string
+  ): Promise<void>;
+  imapDeleteEmails(sessionId: string, uidsJson: string): Promise<string>;
+  imapExpunge(sessionId: string): Promise<void>;
+
+  // ─── 附件 ──────────────────────────────────────────────
+  imapFetchAttachment(
+    sessionId: string,
+    uid: number,
+    partId: string
+  ): Promise<string>;
+  imapFetchAllAttachments(sessionId: string, uid: number): Promise<string>;
+
+  // ─── IDLE ──────────────────────────────────────────────
+  imapIdle(sessionId: string): Promise<void>;
+  imapStopIdle(sessionId: string): Promise<void>;
+
+  // ─── Quota & Append ────────────────────────────────────
+  imapGetQuota(sessionId: string, root: string | null): Promise<string>;
+  imapAppendMessage(
+    sessionId: string,
+    mailbox: string,
+    rawMimeData: string,
+    flagsJson: string | null
+  ): Promise<string>;
+
+  // ═══ SMTP ═══════════════════════════════════════════════
+  smtpConnect(configJson: string): Promise<string>;
+  smtpDisconnect(sessionId: string): Promise<void>;
+  smtpSendMail(sessionId: string, optionsJson: string): Promise<string>;
+  smtpVerifyConnection(sessionId: string): Promise<boolean>;
+}
+
+// TurboModule 的注册名，必须与 C++ 端的注册名一致
+export default TurboModuleRegistry.getEnforcing<Spec>('EmailImapSmtp');

package/src/index.tsx

@@ -0,0 +1,166 @@
+// ============================================================
+// react-native-email-imap-smtp — Main Entry
+// ============================================================
+//
+// Platform resolution:
+//   iOS / Android / Windows → native.ts  → Nitro HybridObject
+//   Web / other             → web.ts      → throws not-supported
+// ============================================================
+
+import { Platform } from 'react-native';
+import type {
+  IMAPConfig,
+  SMTPConfig,
+  IMAPConnectionResult,
+  SMTPConnectionResult,
+  Mailbox,
+  MailboxStatus,
+  Folder,
+  Email,
+  Attachment,
+  FetchEmailsOptions,
+  SearchCriteria,
+  BatchResult,
+  IMAPNotification,
+  QuotaInfo,
+  AppendResult,
+  SendMailOptions,
+  SendMailResult,
+  EmailError,
+} from './types';
+
+export type {
+  IMAPConfig,
+  SMTPConfig,
+  IMAPConnectionResult,
+  SMTPConnectionResult,
+  Mailbox,
+  MailboxStatus,
+  Folder,
+  Email,
+  Attachment,
+  FetchEmailsOptions,
+  SearchCriteria,
+  BatchResult,
+  IMAPNotification,
+  QuotaInfo,
+  AppendResult,
+  SendMailOptions,
+  SendMailResult,
+  EmailError,
+};
+
+// ─── Platform-aware module resolution ──────────────────────
+
+let impl: any;
+
+if (Platform.OS === 'android') {
+  // Android 使用 NitroModules HybridObject
+  impl = require('./native');
+} else if (Platform.OS === 'windows') {
+  // Windows 使用 TurboModule 降级方案（NitroModules 无官方 Windows 运行时）
+  impl = require('./windows');
+} else if (Platform.OS === 'ios') {
+  throw new Error(
+    'EmailImapSmtp: iOS implementation is not ready yet. ' +
+      'Only Android and Windows are currently supported.'
+  );
+} else {
+  // Web 等其他平台
+  impl = require('./web');
+}
+
+// ─── IMAP exports ───────────────────────────────────────────
+
+export const imapConnect = impl.imapConnect as (
+  config: IMAPConfig
+) => Promise<IMAPConnectionResult>;
+export const imapDisconnect = impl.imapDisconnect as () => Promise<void>;
+export const imapListMailboxes = impl.imapListMailboxes as () => Promise<
+  Mailbox[]
+>;
+export const imapSelectMailbox = impl.imapSelectMailbox as (
+  mailbox: string,
+  readOnly?: boolean
+) => Promise<MailboxStatus>;
+export const imapRefreshMailbox =
+  impl.imapRefreshMailbox as () => Promise<MailboxStatus>;
+export const imapFetchFolders = impl.imapFetchFolders as () => Promise<
+  Folder[]
+>;
+export const imapCreateFolder = impl.imapCreateFolder as (
+  folderName: string
+) => Promise<void>;
+export const imapDeleteFolder = impl.imapDeleteFolder as (
+  folderName: string
+) => Promise<void>;
+export const imapRenameFolder = impl.imapRenameFolder as (
+  oldName: string,
+  newName: string
+) => Promise<void>;
+export const imapSubscribeFolder = impl.imapSubscribeFolder as (
+  folderName: string
+) => Promise<void>;
+export const imapUnsubscribeFolder = impl.imapUnsubscribeFolder as (
+  folderName: string
+) => Promise<void>;
+export const imapFetchEmails = impl.imapFetchEmails as (
+  options: FetchEmailsOptions
+) => Promise<Email[]>;
+export const imapFetchEmailByUID = impl.imapFetchEmailByUID as (
+  uid: number
+) => Promise<Email | null>;
+export const imapSearchEmails = impl.imapSearchEmails as (
+  criteria: SearchCriteria
+) => Promise<Email[]>;
+export const imapMarkAsRead = impl.imapMarkAsRead as (
+  uids: number[],
+  silent?: boolean
+) => Promise<void>;
+export const imapMarkAsFlagged = impl.imapMarkAsFlagged as (
+  uids: number[],
+  flagged: boolean
+) => Promise<void>;
+export const imapMoveEmails = impl.imapMoveEmails as (
+  uids: number[],
+  destinationMailbox: string
+) => Promise<void>;
+export const imapCopyEmails = impl.imapCopyEmails as (
+  uids: number[],
+  destinationMailbox: string
+) => Promise<void>;
+export const imapDeleteEmails = impl.imapDeleteEmails as (
+  uids: number[]
+) => Promise<BatchResult>;
+export const imapExpunge = impl.imapExpunge as () => Promise<void>;
+export const imapFetchAttachments = impl.imapFetchAttachments as (
+  uid: number,
+  partId: string
+) => Promise<Attachment | null>;
+export const imapFetchAllAttachments = impl.imapFetchAllAttachments as (
+  uid: number
+) => Promise<Attachment[]>;
+export const imapIdle = impl.imapIdle as (
+  callback: (notification: IMAPNotification) => void
+) => Promise<void>;
+export const imapStopIdle = impl.imapStopIdle as () => Promise<void>;
+export const imapGetQuota = impl.imapGetQuota as (
+  root?: string
+) => Promise<QuotaInfo>;
+export const imapAppendMessage = impl.imapAppendMessage as (
+  mailbox: string,
+  rawMimeData: ArrayBuffer,
+  flags?: string[]
+) => Promise<AppendResult>;
+
+// ─── SMTP exports ──────────────────────────────────────────
+
+export const smtpConnect = impl.smtpConnect as (
+  config: SMTPConfig
+) => Promise<SMTPConnectionResult>;
+export const smtpDisconnect = impl.smtpDisconnect as () => Promise<void>;
+export const smtpSendMail = impl.smtpSendMail as (
+  options: SendMailOptions
+) => Promise<SendMailResult>;
+export const smtpVerifyConnection =
+  impl.smtpVerifyConnection as () => Promise<boolean>;