react-native-email-imap-smtp 0.1.0

package/src/native.ts

@@ -0,0 +1,305 @@
+// ============================================================
+// Native bridge — iOS (Swift) / Android (Kotlin) / Windows (C++)
+// ============================================================
+
+import { NitroModules } from 'react-native-nitro-modules';
+import type { EmailImapSmtp } from './EmailImapSmtp.nitro';
+import type {
+  IMAPConfig,
+  SMTPConfig,
+  IMAPConnectionResult,
+  SMTPConnectionResult,
+  Mailbox,
+  MailboxStatus,
+  Folder,
+  Email,
+  Attachment,
+  FetchEmailsOptions,
+  SearchCriteria,
+  BatchResult,
+  IMAPNotification,
+  QuotaInfo,
+  AppendResult,
+  SendMailOptions,
+  SendMailResult,
+} from './types';
+
+let hybridObject: EmailImapSmtp | null = null;
+
+function getHybridObject(): EmailImapSmtp {
+  if (!hybridObject) {
+    hybridObject =
+      NitroModules.createHybridObject<EmailImapSmtp>('EmailImapSmtp');
+  }
+  return hybridObject;
+}
+
+// ─── IMAP ────────────────────────────────────────────────────
+
+export async function imapConnect(
+  config: IMAPConfig
+): Promise<IMAPConnectionResult> {
+  const h = getHybridObject();
+  return h.imapConnect({
+    host: config.host,
+    port: config.port,
+    username: config.username,
+    password: config.password,
+    tls: config.tls ?? true,
+    authType: config.authType ?? 'password',
+    accessToken: config.accessToken,
+    timeout: config.timeout ?? 30000,
+    checkCertificate: config.checkCertificate ?? true,
+    debug: config.debug ?? false,
+  }) as Promise<IMAPConnectionResult>;
+}
+
+export async function imapDisconnect(): Promise<void> {
+  return getHybridObject().imapDisconnect();
+}
+
+export async function imapListMailboxes(): Promise<Mailbox[]> {
+  return getHybridObject().imapListMailboxes() as unknown as Promise<Mailbox[]>;
+}
+
+export async function imapSelectMailbox(
+  mailbox: string,
+  readOnly?: boolean
+): Promise<MailboxStatus> {
+  return getHybridObject().imapSelectMailbox(
+    mailbox,
+    readOnly ?? false
+  ) as unknown as Promise<MailboxStatus>;
+}
+
+export async function imapRefreshMailbox(): Promise<MailboxStatus> {
+  return getHybridObject().imapRefreshMailbox() as unknown as Promise<MailboxStatus>;
+}
+
+export async function imapFetchFolders(): Promise<Folder[]> {
+  return getHybridObject().imapFetchFolders() as unknown as Promise<Folder[]>;
+}
+
+export async function imapCreateFolder(folderName: string): Promise<void> {
+  return getHybridObject().imapCreateFolder(folderName);
+}
+
+export async function imapDeleteFolder(folderName: string): Promise<void> {
+  return getHybridObject().imapDeleteFolder(folderName);
+}
+
+export async function imapRenameFolder(
+  oldName: string,
+  newName: string
+): Promise<void> {
+  return getHybridObject().imapRenameFolder(oldName, newName);
+}
+
+export async function imapSubscribeFolder(folderName: string): Promise<void> {
+  return getHybridObject().imapSubscribeFolder(folderName);
+}
+
+export async function imapUnsubscribeFolder(folderName: string): Promise<void> {
+  return getHybridObject().imapUnsubscribeFolder(folderName);
+}
+
+export async function imapFetchEmails(
+  options: FetchEmailsOptions
+): Promise<Email[]> {
+  const h = getHybridObject();
+  return h.imapFetchEmails({
+    from: options.from,
+    to: options.to,
+    rangeType: options.rangeType,
+    page: options.page,
+    pageSize: options.pageSize ?? 20,
+    since: options.since,
+    before: options.before,
+    mailbox: options.mailbox,
+    fetchBody: options.fetchBody ?? true,
+    fetchAttachments: options.fetchAttachments ?? false,
+    fetchFlags: options.fetchFlags ?? true,
+    fetchHeaders: options.fetchHeaders ?? true,
+    fetchFullContent: options.fetchFullContent ?? false,
+    maxBodySize: options.maxBodySize ?? 0,
+  }) as unknown as Promise<Email[]>;
+}
+
+export async function imapFetchEmailByUID(uid: number): Promise<Email | null> {
+  return getHybridObject().imapFetchEmailByUID(
+    uid
+  ) as unknown as Promise<Email | null>;
+}
+
+export async function imapSearchEmails(
+  criteria: SearchCriteria
+): Promise<Email[]> {
+  const h = getHybridObject();
+  return h.imapSearchEmails({
+    text: criteria.text,
+    subject: criteria.subject,
+    from: criteria.from,
+    to: criteria.to,
+    body: criteria.body,
+    since: criteria.since,
+    before: criteria.before,
+    on: criteria.on,
+    sentSince: criteria.sentSince,
+    sentBefore: criteria.sentBefore,
+    flagged: criteria.flagged,
+    seen: criteria.seen,
+    answered: criteria.answered,
+    draft: criteria.draft,
+    deleted: criteria.deleted,
+    junk: criteria.junk,
+    hasAttachment: criteria.hasAttachment,
+    uids: criteria.uids,
+    header: criteria.header,
+    larger: criteria.larger,
+    smaller: criteria.smaller,
+    mailbox: criteria.mailbox,
+    sortOrder: criteria.sortOrder ?? 'desc',
+    limit: criteria.limit ?? 0,
+    fetchBody: criteria.fetchBody ?? true,
+    fetchAttachments: criteria.fetchAttachments ?? false,
+    fetchFlags: criteria.fetchFlags ?? true,
+    fetchHeaders: criteria.fetchHeaders ?? true,
+    fetchFullContent: criteria.fetchFullContent ?? false,
+    maxBodySize: criteria.maxBodySize ?? 0,
+  }) as unknown as Promise<Email[]>;
+}
+
+export async function imapMarkAsRead(
+  uids: number[],
+  silent?: boolean
+): Promise<void> {
+  return getHybridObject().imapMarkAsRead(uids, silent ?? true);
+}
+
+export async function imapMarkAsFlagged(
+  uids: number[],
+  flagged: boolean
+): Promise<void> {
+  return getHybridObject().imapMarkAsFlagged(uids, flagged);
+}
+
+export async function imapMoveEmails(
+  uids: number[],
+  destinationMailbox: string
+): Promise<void> {
+  return getHybridObject().imapMoveEmails(uids, destinationMailbox);
+}
+
+export async function imapCopyEmails(
+  uids: number[],
+  destinationMailbox: string
+): Promise<void> {
+  return getHybridObject().imapCopyEmails(uids, destinationMailbox);
+}
+
+export async function imapDeleteEmails(uids: number[]): Promise<BatchResult> {
+  return getHybridObject().imapDeleteEmails(
+    uids
+  ) as unknown as Promise<BatchResult>;
+}
+
+export async function imapExpunge(): Promise<void> {
+  return getHybridObject().imapExpunge();
+}
+
+export async function imapFetchAttachments(
+  uid: number,
+  partId: string
+): Promise<Attachment | null> {
+  return getHybridObject().imapFetchAttachments(uid, partId);
+}
+
+export async function imapFetchAllAttachments(
+  uid: number
+): Promise<Attachment[]> {
+  return getHybridObject().imapFetchAllAttachments(uid);
+}
+
+export async function imapIdle(
+  callback: (notification: IMAPNotification) => void
+): Promise<void> {
+  return getHybridObject().imapIdle(callback as any);
+}
+
+export async function imapStopIdle(): Promise<void> {
+  return getHybridObject().imapStopIdle();
+}
+
+export async function imapGetQuota(root?: string): Promise<QuotaInfo> {
+  return getHybridObject().imapGetQuota(root);
+}
+
+export async function imapAppendMessage(
+  mailbox: string,
+  rawMimeData: ArrayBuffer,
+  flags?: string[]
+): Promise<AppendResult> {
+  return getHybridObject().imapAppendMessage(mailbox, rawMimeData, flags);
+}
+
+// ─── SMTP ────────────────────────────────────────────────────
+
+export async function smtpConnect(
+  config: SMTPConfig
+): Promise<SMTPConnectionResult> {
+  const h = getHybridObject();
+  return h.smtpConnect({
+    host: config.host,
+    port: config.port,
+    username: config.username,
+    password: config.password,
+    tls: config.tls ?? true,
+    authType: config.authType ?? 'password',
+    accessToken: config.accessToken,
+    timeout: config.timeout ?? 30000,
+    checkCertificate: config.checkCertificate ?? true,
+    helloName: config.helloName,
+    debug: config.debug ?? false,
+  }) as Promise<SMTPConnectionResult>;
+}
+
+export async function smtpDisconnect(): Promise<void> {
+  return getHybridObject().smtpDisconnect();
+}
+
+export async function smtpSendMail(
+  options: SendMailOptions
+): Promise<SendMailResult> {
+  const h = getHybridObject();
+  return h.smtpSendMail({
+    from: { name: options.from.name, email: options.from.email },
+    to: options.to.map((a) => ({ name: a.name, email: a.email })),
+    cc: options.cc?.map((a) => ({ name: a.name, email: a.email })),
+    bcc: options.bcc?.map((a) => ({ name: a.name, email: a.email })),
+    replyTo: options.replyTo?.map((a) => ({ name: a.name, email: a.email })),
+    subject: options.subject,
+    textBody: options.textBody,
+    htmlBody: options.htmlBody,
+    attachments: options.attachments?.map((a) => ({
+      filename: a.filename,
+      mimeType: a.mimeType,
+      data: a.data,
+      inline: a.inline ?? false,
+      contentId: a.contentId,
+      disposition: a.disposition,
+    })),
+    priority: options.priority,
+    headers: options.headers,
+    inReplyTo: options.inReplyTo,
+    references: options.references,
+    readReceiptTo: options.readReceiptTo
+      ? { name: options.readReceiptTo.name, email: options.readReceiptTo.email }
+      : undefined,
+    charset: options.charset ?? 'UTF-8',
+    encoding: options.encoding,
+  });
+}
+
+export async function smtpVerifyConnection(): Promise<boolean> {
+  return getHybridObject().smtpVerifyConnection();
+}

package/src/types.ts

@@ -0,0 +1,328 @@
+// ============================================================
+// react-native-email-imap-smtp — Shared Type Definitions
+// ============================================================
+
+// ─── Auth & Connection ───────────────────────────────────────
+
+export type AuthType = 'password' | 'oauth2' | 'none';
+export type ConnectionType = 'tls' | 'starttls' | 'plain';
+
+export interface IMAPConfig {
+  host: string;
+  port: number;
+  username: string;
+  password: string;
+  tls?: boolean;
+  authType?: AuthType;
+  accessToken?: string;
+  timeout?: number;
+  checkCertificate?: boolean;
+  debug?: boolean;
+}
+
+export interface SMTPConfig {
+  host: string;
+  port: number;
+  username: string;
+  password: string;
+  tls?: boolean;
+  authType?: AuthType;
+  accessToken?: string;
+  timeout?: number;
+  checkCertificate?: boolean;
+  helloName?: string;
+  debug?: boolean;
+}
+
+export interface IMAPConnectionResult {
+  success: boolean;
+  serverInfo?: {
+    serverName: string;
+    capabilities: string[];
+    isCompressed: boolean;
+  };
+  error?: string;
+}
+
+export interface SMTPConnectionResult {
+  success: boolean;
+  serverInfo?: {
+    serverName: string;
+    capabilities: string[];
+    supportedAuthMethods: string[];
+  };
+  error?: string;
+}
+
+// ─── Mailbox / Folder ───────────────────────────────────────
+
+export type MailboxFlag = string;
+
+export interface Mailbox {
+  name: string;
+  path: string;
+  delimiter: string;
+  flags: MailboxFlag[];
+  subscribed: boolean;
+}
+
+export interface Folder {
+  name: string;
+  path: string;
+  delimiter: string;
+  parent: string;
+  children: string[];
+  flags: MailboxFlag[];
+  subscribed: boolean;
+  messageCount: number;
+  unseenCount: number;
+}
+
+// ─── Mailbox Status ─────────────────────────────────────────
+
+export interface MailboxStatus {
+  name: string;
+  path: string;
+  uidNext: number;
+  uidValidity: number;
+  messageCount: number;
+  recentCount: number;
+  unseenCount: number;
+  firstUnseenUid: number;
+  highestModSeq?: number;
+  flags: string[];
+  permanentFlags: string[];
+}
+
+// ─── Email ──────────────────────────────────────────────────
+
+export type EmailFlag =
+  | 'seen'
+  | 'answered'
+  | 'flagged'
+  | 'deleted'
+  | 'draft'
+  | 'recent'
+  | 'junk'
+  | 'forwarded';
+
+export type EmailPriority = 'low' | 'normal' | 'high';
+
+export interface EmailAddress {
+  name: string;
+  email: string;
+}
+
+export interface Attachment {
+  filename: string;
+  mimeType: string;
+  partId: string;
+  size: number;
+  data: ArrayBuffer;
+  contentId?: string;
+  inline: boolean;
+  charset?: string;
+  contentDisposition: string;
+  /** 附件缓存在本地的文件路径（如果有），避免大附件全部加载到内存 */
+  localPath?: string;
+}
+
+export interface EmailBody {
+  text?: string;
+  html?: string;
+  embeddedAttachments: Attachment[];
+}
+
+export interface ThreadInfo {
+  threadId: string;
+  parentMessageId: string | null;
+  depth: number;
+  children: ThreadInfo[];
+}
+
+export interface Email {
+  uid: number;
+  sequenceNumber: number;
+  subject: string;
+  from: EmailAddress;
+  to: EmailAddress[];
+  cc: EmailAddress[];
+  bcc: EmailAddress[];
+  replyTo: EmailAddress[];
+  date: string;
+  receivedDate: string;
+  body: EmailBody;
+  attachments: Attachment[];
+  flags: EmailFlag[];
+  headers: Record<string, string>;
+  size: number;
+  messageId: string;
+  inReplyTo?: string;
+  references?: string;
+  priority: EmailPriority;
+  isEncrypted: boolean;
+  mimeType: string;
+  charset: string;
+}
+
+// ─── Fetch Options ──────────────────────────────────────────
+
+export interface FetchOptions {
+  fetchBody?: boolean;
+  fetchAttachments?: boolean;
+  fetchFlags?: boolean;
+  fetchHeaders?: boolean;
+  fetchFullContent?: boolean;
+  maxBodySize?: number;
+}
+
+export interface FetchEmailsOptions {
+  // 范围模式
+  from?: number;
+  to?: number;
+  rangeType?: 'uid' | 'sequence';
+  // 分页模式
+  page?: number;
+  pageSize?: number;
+  // 时间模式
+  since?: string;
+  before?: string;
+  // 通用
+  mailbox?: string;
+  // 获取选项（扁平化）
+  fetchBody?: boolean;
+  fetchAttachments?: boolean;
+  fetchFlags?: boolean;
+  fetchHeaders?: boolean;
+  fetchFullContent?: boolean;
+  maxBodySize?: number;
+}
+
+// ─── Search ─────────────────────────────────────────────────
+
+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?: { key: string; value: string };
+  larger?: number;
+  smaller?: number;
+  mailbox?: string;
+  sortOrder?: 'asc' | 'desc';
+  limit?: number;
+  // 获取选项（扁平化）
+  fetchBody?: boolean;
+  fetchAttachments?: boolean;
+  fetchFlags?: boolean;
+  fetchHeaders?: boolean;
+  fetchFullContent?: boolean;
+  maxBodySize?: number;
+}
+
+// ─── Send Mail ──────────────────────────────────────────────
+
+export interface SendAttachment {
+  filename: string;
+  mimeType: string;
+  data: ArrayBuffer;
+  inline?: boolean;
+  contentId?: string;
+  disposition?: 'attachment' | 'inline';
+}
+
+export interface SendMailOptions {
+  from: EmailAddress;
+  to: EmailAddress[];
+  cc?: EmailAddress[];
+  bcc?: EmailAddress[];
+  replyTo?: EmailAddress[];
+  subject: string;
+  textBody?: string;
+  htmlBody?: string;
+  attachments?: SendAttachment[];
+  priority?: EmailPriority;
+  headers?: Record<string, string>;
+  inReplyTo?: string;
+  references?: string;
+  readReceiptTo?: EmailAddress;
+  charset?: string;
+  encoding?: '7bit' | '8bit' | 'base64' | 'quoted-printable';
+}
+
+export interface SendMailResult {
+  success: boolean;
+  messageId?: string;
+  date?: string;
+  serverResponseCode?: number;
+  rawMimeData?: ArrayBuffer;
+  queueId?: string;
+  error?: string;
+  retryable?: boolean;
+}
+
+// ─── IDLE ───────────────────────────────────────────────────
+
+export interface IMAPNotification {
+  type:
+    | 'newMessage'
+    | 'messageDeleted'
+    | 'messageFlagged'
+    | 'mailboxChanged'
+    | 'connectionLost';
+  mailbox: string;
+  uid?: number;
+  flag?: string;
+  messageCount?: number;
+  timestamp: number;
+}
+
+// ─── Quota ──────────────────────────────────────────────────
+
+export interface QuotaInfo {
+  storageUsed: number;
+  storageLimit: number;
+  storageUnit: string;
+  messagesUsed?: number;
+  messagesLimit?: number;
+  root: string;
+}
+
+// ─── Batch & Append Results ─────────────────────────────────
+
+export interface BatchResult {
+  success: number[];
+  failed: number[];
+  error?: string;
+}
+
+export interface AppendResult {
+  uid: number;
+  uidValidity: number;
+  date: string;
+}
+
+// ─── Error ──────────────────────────────────────────────────
+
+export interface EmailError {
+  code: string;
+  message: string;
+  retryable: boolean;
+  serverResponse?: string;
+  originalResponse?: string;
+  details?: any;
+}