react-native-email-imap-smtp 0.3.0 → 0.3.2

package/lib/typescript/server/src/index.d.ts

@@ -1,4 +1,5 @@
-declare const app: import("express-serve-static-core").Express;
+import express from 'express';
+declare const app: express.Express;
 declare const server: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
 export interface ServerHandle {
     port: number;

package/lib/typescript/server/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/src/index.ts"],"names":[],"mappings":"AAmBA,QAAA,MAAM,GAAG,6CAAY,CAAC;AACtB,QAAA,MAAM,MAAM,mHAAoB,CAAC;AAgajC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,WAAW,CAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAQD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/src/index.ts"],"names":[],"mappings":"AAYA,OAAO,OAAO,MAAM,SAAS,CAAC;AAO9B,QAAA,MAAM,GAAG,EAAE,OAAO,CAAC,OAAmB,CAAC;AACvC,QAAA,MAAM,MAAM,mHAAoB,CAAC;AAgajC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,WAAW,CAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAQD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-email-imap-smtp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "The best of imap and smtp client of react native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -13,6 +13,14 @@
       "types": "./lib/typescript/src/index.d.ts",
       "default": "./lib/module/index.js"
     },
+    "./server/proxy": {
+      "import": "./server/proxy.mjs",
+      "default": "./server/proxy.mjs"
+    },
+    "./server/bin": {
+      "import": "./server/bin.mjs",
+      "default": "./server/bin.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [

package/server/bin.mjs

@@ -1,29 +1,62 @@
 #!/usr/bin/env node
 // ============================================================
-// CLI 入口 — npx react-native-email-imap-smtp-server
+// CLI 入口 — email-imap-proxy
 // ============================================================
-// 可直接在 dev 命令前启动:
-//   "dev": "email-imap-proxy & next dev"
-//   "dev": "email-imap-proxy & vite"
+//
+// 用法:
+//   email-imap-proxy                   默认：分离模式（启动后退出，代理后台运行）
+//   email-imap-proxy --foreground      前台模式（保持运行，Ctrl+C 停止）
+//   email-imap-proxy -f                同上
+//   email-imap-proxy --port 3987       指定端口
+//   email-imap-proxy --silent          静默模式
+//
+// 与 dev server 一起使用:
+//   email-imap-proxy & vite            ← Windows/Linux 通吃
+//   email-imap-proxy & webpack serve
+//   email-imap-proxy & next dev
+//
+//   # 或用 concurrently（跨平台）
+//   concurrently "email-imap-proxy" "vite"
+//
+//   # 或集成到 Vite/Webpack 配置（不依赖 CLI）
+//   import { startEmailProxy } from 'react-native-email-imap-smtp/server/proxy';
+//   await startEmailProxy();
 // ============================================================
 
 import { startEmailProxy } from './proxy.mjs';
 
-const port = parseInt(process.env.PROXY_PORT ?? '3987', 10);
-const silent = process.env.PROXY_SILENT === '1';
+// ─── 解析命令行参数 ─────────────────────────────────────
 
-startEmailProxy({ port, silent }).then((handle) => {
+const args = process.argv.slice(2);
+const portIndex = args.indexOf('--port');
+const port = portIndex >= 0 ? parseInt(args[portIndex + 1], 10) : parseInt(process.env.PROXY_PORT ?? '3987', 10);
+const silent = args.includes('--silent') || process.env.PROXY_SILENT === '1';
+// 分离模式为默认行为（解决 Windows & 不阻塞）
+const foreground = args.includes('--foreground') || args.includes('-f');
+
+// ─── 启动 ───────────────────────────────────────────────
+
+startEmailProxy({ port, silent, detach: !foreground }).then((handle) => {
   handle.onStderr((msg) => {
     if (!silent && msg.includes('ready')) {
       console.log(`[email-proxy] 代理服务器就绪 :${handle.port}`);
     }
   });
 
-  // 优雅退出
-  process.on('SIGINT', () => {
-    handle.stop().then(() => process.exit(0));
-  });
-  process.on('SIGTERM', () => {
-    handle.stop().then(() => process.exit(0));
-  });
+  // 默认（分离模式）：启动完成后父进程立即退出，代理在后台独立运行
+  if (!foreground) {
+    process.exit(0);
+  }
+
+  // 前台模式：保持进程存活，等待退出信号
+  const cleanup = async () => {
+    await handle.stop();
+    process.exit(0);
+  };
+  process.on('SIGINT', cleanup);
+  process.on('SIGTERM', cleanup);
+
+  // 保持事件循环活跃
+  const keepAlive = setInterval(() => {}, 2 ** 31 - 1);
+  process.on('exit', () => clearInterval(keepAlive));
 });

package/server/proxy.mjs

@@ -9,8 +9,10 @@
 //   const handle = await startEmailProxy();
 //   // 用完: handle.stop()
 //
-// 也可作为 dev 命令的前置进程:
+// 也可作为 dev 命令的前置进程（CLI 默认分离模式，不阻塞后续命令）:
 //   "dev": "email-imap-proxy & next dev"
+//   "dev": "email-imap-proxy & vite"
+//   "dev": "email-imap-proxy & webpack serve"
 // ============================================================
 
 import { spawn } from 'child_process';
@@ -25,6 +27,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
  * @property {number} [port=3987] 代理服务端口
  * @property {boolean} [silent=false] 静默模式
  * @property {number} [timeout=30000] 启动超时(ms)
+ * @property {boolean} [detach=false] 分离模式：启动后父进程可退出，代理独立运行（解决 Windows & 兼容问题）
  */
 
 /**
@@ -45,6 +48,7 @@ export async function startEmailProxy(options = {}) {
   const port = options.port ?? 3987;
   const silent = options.silent ?? false;
   const timeout = options.timeout ?? 30000;
+  const detach = options.detach ?? false;
 
   const serverDir = resolve(__dirname);
   const entryFile = resolve(serverDir, 'lib/index.js');
@@ -72,6 +76,7 @@ export async function startEmailProxy(options = {}) {
     stdio: ['ignore', silent ? 'ignore' : 'inherit', 'pipe'],
     env: { ...process.env, PROXY_PORT: String(port) },
     shell: true,
+    detached: detach,
   });
 
   let stderrCallback = null;
@@ -96,6 +101,11 @@ export async function startEmailProxy(options = {}) {
     console.log(`[email-proxy] 代理服务器就绪 :${port}`);
   }
 
+  // 分离模式下关闭子进程的 IPC 通道，允许父进程退出
+  if (detach) {
+    proc.unref();
+  }
+
   return {
     port,
     stop: () =>

package/server/src/index.ts

@@ -17,7 +17,7 @@ import { WebSocketServer, WebSocket } from 'ws';
 import * as imap from './imapHandler';
 import * as smtp from './smtpHandler';
 
-const app = express();
+const app: express.Express = express();
 const server = createServer(app);
 
 // ─── 配置 ───────────────────────────────────────────────────