react-native-email-imap-smtp 0.1.0

package/EmailImapSmtp.podspec

@@ -0,0 +1,29 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "EmailImapSmtp"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://gitee.com/dongfangshuo001/react-native-email-imap-smtp.git", :tag => "#{s.version}" }
+
+  s.source_files = [
+    "ios/**/*.{swift}",
+    "ios/**/*.{m,mm}",
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+
+  load 'nitrogen/generated/ios/EmailImapSmtp+autolinking.rb'
+  add_nitrogen_files(s)
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 东方朔
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# react-native-email-imap-smtp
+
+React Native IMAP & SMTP 邮件客户端库，基于 Nitro Modules 构建。
+
+## 平台支持
+
+| 平台 | 状态 | 实现 |
+|------|------|------|
+| Android | ✅ **可用** | Kotlin + Jakarta Mail |
+| Windows | ✅ **可用** | C++ (WinSock2 + Schannel TLS)，独立 CMake 工程 |
+| iOS | ⚠️ **开发中** | 尚未完成，调用会抛出明确错误 |
+| Web | ❌ **不支持** | 调用即抛异常 |
+
+> **Windows 说明**：由于 `react-native-nitro-modules` 暂无官方 Windows 运行时支持，Windows 采用 **TurboModule 降级方案**（Android 继续使用 Nitro）。详见 `docs/发布方案.md` 中的架构说明。
+
+## 安装
+
+```sh
+npm install react-native-email-imap-smtp react-native-nitro-modules
+```
+
+> `react-native-nitro-modules` 是必需的，本库依赖 [Nitro Modules](https://nitro.margelo.com/)。
+
+## 快速开始
+
+```typescript
+import {
+  imapConnect,
+  imapSelectMailbox,
+  imapFetchEmails,
+  smtpConnect,
+  smtpSendMail,
+} from 'react-native-email-imap-smtp';
+
+// 1. 连接 IMAP 服务器
+const conn = await imapConnect({
+  host: 'imap.163.com',
+  port: 993,
+  username: 'your@163.com',
+  password: 'your-authorization-code', // ⚠️ 使用授权码，非登录密码
+  tls: true,
+  checkCertificate: false, // 网易邮箱需要关闭证书校验
+});
+
+// 2. 选择收件箱
+const inbox = await imapSelectMailbox('INBOX');
+
+// 3. 获取邮件
+const emails = await imapFetchEmails({ fetchBody: true, fetchHeaders: true });
+```
+
+> 完整示例请查看 [example/](./example/) 目录。
+
+## 网易邮箱（163/188.com）配置指南
+
+网易邮箱对第三方 IMAP/SMTP 客户端有严格的安全控制，连接时需注意以下事项：
+
+### 1. 使用授权码（必需）
+
+网易邮箱**不允许**使用登录密码直接通过 IMAP/SMTP 登录，必须使用**授权码**。
+
+**获取授权码步骤：**
+1. 登录 [mail.163.com](https://mail.163.com) 网页版
+2. 进入 **设置 → POP3/SMTP/IMAP**
+3. 开启 **IMAP/SMTP 服务**
+4. 点击 **新增授权码**，按提示完成手机验证
+5. 将生成的授权码（一串字符）填入 `password` 字段
+
+### 2. 配置参数
+
+```typescript
+{
+  host: 'imap.163.com',      // IMAP 服务器
+  port: 993,                  // IMAP SSL 端口
+  username: 'your@163.com',   // 完整邮箱地址
+  password: '授权码',          // ⚠️ 不是登录密码！
+  tls: true,                  // 使用 SSL/TLS 加密
+  checkCertificate: false,    // 网易邮箱需关闭证书校验
+  timeout: 30000,
+}
+```
+
+| 邮箱 | IMAP 服务器 | IMAP 端口 | SMTP 服务器 | SMTP 端口 |
+|------|------------|----------|------------|----------|
+| 163  | imap.163.com | 993 | smtp.163.com | 465 |
+| 188  | imap.188.com | 993 | smtp.188.com | 465 |
+| QQ   | imap.qq.com | 993 | smtp.qq.com | 465 |
+| Gmail | imap.gmail.com | 993 | smtp.gmail.com | 465 |
+
+### 3. 常见错误
+
+| 错误信息 | 原因 | 解决方法 |
+|---------|------|---------|
+| `NO SELECT Unsafe Login` | 服务器拒绝 SELECT 命令 | ① 使用授权码 ② 开启 IMAP 服务 ③ 登录网页邮箱完成安全验证 |
+| `Connection reset` | SSL 证书验证失败 | 设置 `checkCertificate: false` |
+| `FolderClosedException` | 服务器主动断开连接 | 库已内置自动重连机制 |
+| `NO Login` | 认证失败 | 检查账号和授权码是否正确 |
+
+### 4. 其他注意
+
+- 确保已在网页端开启 **IMAP/SMTP 服务**
+- 避免短时间内频繁登录，否则可能触发风控导致临时封禁
+- 若仍有问题，登录网页邮箱 → 设置 → 客户端密码 → 完成一次安全验证
+
+## API 文档
+
+详细 API 文档见 [docs/IMAP_SMTP_通信实现细节.md](./docs/IMAP_SMTP_通信实现细节.md)。
+
+## 贡献
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(emailimapsmtp)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME emailimapsmtp)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/EmailImapSmtp+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,117 @@
+buildscript {
+  ext.EmailImapSmtp = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return EmailImapSmtp[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply from: '../nitrogen/generated/android/EmailImapSmtp+autolinking.gradle'
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.margelo.nitro.emailimapsmtp"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packaging {
+    resources {
+      excludes += [
+        "META-INF",
+        "META-INF/**",
+        "META-INF/NOTICE.md",
+        "META-INF/NOTICE"
+      ]
+    }
+
+    jniLibs {
+      excludes += [
+        "**/libc++_shared.so",
+        "**/libfbjni.so",
+        "**/libjsi.so",
+        "**/libfolly_json.so",
+        "**/libfolly_runtime.so",
+        "**/libglog.so",
+        "**/libhermes.so",
+        "**/libhermes-executor-debug.so",
+        "**/libhermes_executor.so",
+        "**/libreactnative.so",
+        "**/libreactnativejni.so",
+        "**/libturbomodulejsijni.so",
+        "**/libreact_nativemodule_core.so",
+        "**/libjscexecutor.so"
+      ]
+    }
+  }
+
+  buildFeatures {
+    prefab true
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation project(":react-native-nitro-modules")
+  // Jakarta Mail for IMAP/SMTP (uses jakarta.mail.* namespace matching the imports in EmailImapSmtp.kt)
+  implementation("com.sun.mail:jakarta.mail:2.0.1") { because "Provides jakarta.mail.* API + com.sun.mail.imap/* + com.sun.mail.smtp/* providers" }
+  implementation("com.sun.activation:jakarta.activation:2.0.1")
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET" />
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,11 @@
+#include <jni.h>
+#include "EmailImapSmtpOnLoad.hpp"
+
+#include <fbjni/fbjni.h>
+
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return facebook::jni::initialize(vm, []() {
+    margelo::nitro::emailimapsmtp::registerAllNatives();
+  });
+}