tempmail-sdk 1.1.3 → 1.1.4

package/README.md

@@ -22,11 +22,11 @@ npm install @XxxXTeam/tempmail-sdk --registry=https://npm.pkg.github.com
 | `tempmail` | tempmail.ing | - | 支持自定义有效期 |
 | `linshi-email` | linshi-email.com | - | |
 | `tempmail-lol` | tempmail.lol | ✅ | 支持指定域名 |
-| `chatgpt-org-uk` | mail.chatgpt.org.uk | - | |
-| `tempmail-la` | tempmail.la | - | 支持分页 |
+| `chatgpt-org-uk` | mail.chatgpt.org.uk | ✅ | 首页注入 `__BROWSER_AUTH`，创建邮箱时须带 `X-Inbox-Token` + `gm_sid`（已自动处理） |
 | `temp-mail-io` | temp-mail.io | - | |
 | `awamail` | awamail.com | ✅ | Session Cookie 自动管理 |
-| `mail-tm` | mail.tm | ✅ | 自动注册账号获取 Bearer Token |
+| `mail-tm` | mail.tm / api.mail.tm | ✅ | 自动注册账号；请求与 **Internxt** 等站点前端一致（`GET /domains?page=1`、`GET /messages?page=1` 及常见浏览器头） |
+| `smail-pw` | smail.pw | ✅ | `POST/GET https://smail.pw/_root.data`，`__session` Cookie；解析 RSC/Flight 中的 **D1 邮件行对象**（`subject`/`time` 等） |
 | `dropmail` | dropmail.me | ✅ | GraphQL API |
 | `guerrillamail` | guerrillamail.com | ✅ | 公开 JSON API |
 | `maildrop` | maildrop.cc | ✅ | GraphQL API，自带反垃圾 |
@@ -76,13 +76,13 @@ console.log(channels);
 //   { channel: 'linshi-email', name: '临时邮箱', website: 'linshi-email.com' },
 //   { channel: 'tempmail-lol', name: 'TempMail LOL', website: 'tempmail.lol' },
 //   { channel: 'chatgpt-org-uk', name: 'ChatGPT Mail', website: 'mail.chatgpt.org.uk' },
-//   { channel: 'tempmail-la', name: 'TempMail LA', website: 'tempmail.la' },
 //   { channel: 'temp-mail-io', name: 'Temp Mail IO', website: 'temp-mail.io' },
 //   { channel: 'awamail', name: 'AwaMail', website: 'awamail.com' },
 //   { channel: 'mail-tm', name: 'Mail.tm', website: 'mail.tm' },
 //   { channel: 'dropmail', name: 'DropMail', website: 'dropmail.me' },
 //   { channel: 'guerrillamail', name: 'Guerrilla Mail', website: 'guerrillamail.com' },
-//   { channel: 'maildrop', name: 'Maildrop', website: 'maildrop.cc' }
+//   { channel: 'maildrop', name: 'Maildrop', website: 'maildrop.cc' },
+//   { channel: 'smail-pw', name: 'Smail.pw', website: 'smail.pw' }
 // ]
 
 const info = getChannelInfo('tempmail');
@@ -107,38 +107,29 @@ const emailInfo3 = await generateEmail({ channel: 'tempmail', duration: 60 });
 
 // tempmail-lol 渠道支持指定域名
 const emailInfo4 = await generateEmail({ channel: 'tempmail-lol', domain: 'example.com' });
+
+// 只尝试指定渠道（探测可用性、写自动化时用）
+const probe = await generateEmail({ channel: 'smail-pw', channelFallback: false });
 ```
 
 #### 获取邮件
 
-```typescript
-import { getEmails } from 'tempmail-sdk';
-
-// 不需要 Token 的渠道
-const result = await getEmails({
-  channel: 'tempmail',
-  email: 'xxx@ibymail.com',
-});
-console.log(result.emails); // 标准化邮件数组
+`getEmails` 的第一个参数必须是 **`generateEmail` 返回的 `EmailInfo`**（或与 `TempEmailClient` 缓存的相同结构）。Token / Session 由 SDK 内部绑定到该对象，**不要**再手动传入 `token` 字段。
 
-// 需要 Token 的渠道（token 由 generateEmail 返回）
-const result2 = await getEmails({
-  channel: 'mail-tm',
-  email: emailInfo.email,
-  token: emailInfo.token,    // Bearer Token
-});
-
-// 所有邮件使用统一格式，无需关心渠道差异
-for (const email of result2.emails) {
-  console.log(email.id);          // 邮件 ID
-  console.log(email.from);        // 发件人
-  console.log(email.to);          // 收件人
-  console.log(email.subject);     // 主题
-  console.log(email.text);        // 纯文本
-  console.log(email.html);        // HTML
-  console.log(email.date);        // ISO 日期
-  console.log(email.isRead);      // 是否已读
-  console.log(email.attachments); // 附件列表
+```typescript
+import { generateEmail, getEmails } from 'tempmail-sdk';
+
+const emailInfo = await generateEmail({ channel: 'tempmail' });
+if (!emailInfo) throw new Error('创建失败');
+const result = await getEmails(emailInfo);
+console.log(result.success, result.emails.length);
+
+const mailTm = await generateEmail({ channel: 'mail-tm' });
+if (mailTm) {
+  const r2 = await getEmails(mailTm, { retry: { maxRetries: 3, timeout: 20000 } });
+  for (const email of r2.emails) {
+    console.log(email.id, email.from, email.subject, email.date);
+  }
 }
 ```
 
@@ -171,8 +162,10 @@ for (const email of result2.emails) {
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `channel` | `Channel` | 指定渠道（可选，不指定则随机） |
+| `channelFallback` | `boolean` | 默认 `true`：指定渠道失败会继续尝试其他渠道；设为 `false` 时仅尝试 `channel` |
 | `duration` | `number` | 有效期分钟数（仅 `tempmail` 渠道） |
 | `domain` | `string` | 指定域名（仅 `tempmail-lol` 渠道） |
+| `retry` | `RetryConfig` | 创建邮箱时的重试（超时、5xx、网络错误等） |
 
 **返回值:** `EmailInfo`
 
@@ -184,17 +177,16 @@ for (const email of result2.emails) {
 | `expiresAt` | `string \| number?` | 过期时间 |
 | `createdAt` | `string?` | 创建时间 |
 
-### getEmails(options)
+### getEmails(info, options?)
 
 获取邮件列表。
 
 **参数:**
 
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|:----:|------|
-| `channel` | `Channel` | ✅ | 渠道标识 |
-| `email` | `string` | ✅ | 邮箱地址 |
-| `token` | `string` | 部分 | 访问令牌（`tempmail-lol`、`awamail`、`mail-tm`、`dropmail`、`guerrillamail`、`maildrop` 必填） |
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `info` | `EmailInfo` | 由 `generateEmail()` 或 `TempEmailClient.generate()` 返回；SDK 从中读取 `channel`、`email` 及内部 Token |
+| `options?.retry` | `RetryConfig` | 拉取邮件时的重试配置（可选） |
 
 **返回值:** `GetEmailsResult`
 
@@ -281,6 +273,19 @@ export TEMPMAIL_TIMEOUT=30000
 
 > **提示：** Node.js 原生 fetch 不支持代理，推荐通过 `customFetch` + `undici` 的 `ProxyAgent` 实现代理支持。
 
+DropMail 自动令牌等更多配置见源码 `src/config.ts` 注释（`DROPMAIL_*` 环境变量）。
+
+## 示例脚本（本仓库）
+
+在 `sdk/npm` 目录执行：
+
+| 命令 / 文件 | 说明 |
+|-------------|------|
+| `npx ts-node demo/poll-emails.ts` | 未配置 SMTP 时为交互式选渠道并轮询；配置 `SMTP_HOST` 等后可自动向各渠道发探针并轮询（`POLL_CHANNELS`、`POLL_INTERVAL_MS`、`POLL_MAX_ROUNDS`） |
+| `npm run demo:internxt` | `demo/internxt-tempmail-probe.ts`：检查 Internxt 页面与 **Mail.tm（SDK `mail-tm`）** 全流程 |
+
+`poll-emails` 使用 SMTP 时需安装：`npm install nodemailer @types/nodemailer`（若尚未加入 devDependencies）。
+
 ## 环境要求
 
 - Node.js 18+（需要原生 `fetch` 支持）

package/demo/poll-emails.ts

@@ -1,18 +1,66 @@
 /**
  * Demo: 获取指定渠道邮箱，轮询获取邮件
- * 
+ *
  * 使用方法:
- * npx ts-node demo/poll-emails.ts
+ *   npx ts-node demo/poll-emails.ts
+ *
+ * 行为:
+ * - 已设置 SMTP_HOST：自动对全部渠道（可用 POLL_CHANNELS 限定）创建临时邮箱、经 SMTP 发送探针邮件并轮询是否收到，用于验收渠道是否可用。
+ * - 未设置 SMTP_HOST：交互式选择单个渠道并轮询（原行为）。
+ * - 已设置 SMTP 时仍想交互：加参数 --interactive 或 -i
+ *
+ * SMTP 环境变量（自动模式必填 SMTP_HOST）:
+ *   SMTP_HOST      服务器地址
+ *   SMTP_PORT      端口，默认 587
+ *   SMTP_SECURE    含义随端口变化：
+ *                  - 465 / smtps / implicit：隐式 TLS（整条连接即 SSL，对应 nodemailer secure:true）
+ *                  - 587、2525、25：不使用 secure:true；1/true 表示「强制 STARTTLS」（requireTLS）
+ *                  - 其它端口：1/true 视为隐式 TLS（secure:true）
+ *   SMTP_REQUIRE_TLS  是否强制 STARTTLS（仅非隐式 TLS 时有效）。未设时 587/2525 默认强制，25 默认不强制
+ *   SMTP_IGNORE_TLS   1/true 则禁用 STARTTLS（明文，仅调试）
+ *   SMTP_TLS_REJECT_UNAUTHORIZED  默认校验证书；0/false 允许自签名（仅调试）
+ *   SMTP_USER      用户名（可选，无认证可留空）
+ *   SMTP_PASS      密码（可选）
+ *   SMTP_FROM      发件人地址，默认 SMTP_USER，再否则 noreply@localhost
+ *
+ * 可选:
+ *   POLL_CHANNELS       逗号分隔的渠道 id，仅测这些；未设则测全部
+ *   POLL_INTERVAL_MS    轮询间隔毫秒，默认 5000
+ *   POLL_MAX_ROUNDS       每渠道最大轮询次数，默认 60
  */
 
+import { randomBytes } from 'crypto';
 import * as readline from 'readline';
-import { generateEmail, getEmails, listChannels, getChannelInfo, Channel, EmailInfo, ChannelInfo, Email } from '../src';
+import nodemailer from 'nodemailer';
+import {
+  generateEmail,
+  getEmails,
+  listChannels,
+  getChannelInfo,
+  Channel,
+  EmailInfo,
+  ChannelInfo,
+  Email,
+} from '../src';
 
-// 配置
-const POLL_INTERVAL = 5000;           // 轮询间隔（毫秒）
-const MAX_POLL_COUNT = 60;            // 最大轮询次数
+const POLL_INTERVAL = parseInt(process.env.POLL_INTERVAL_MS || '5000', 10);
+const MAX_POLL_COUNT = parseInt(process.env.POLL_MAX_ROUNDS || '60', 10);
 
-function printJson(label: string, data: any): void {
+interface SmtpConfig {
+  host: string;
+  port: number;
+  /** true = 隐式 TLS（SMTPS，典型端口 465） */
+  secure: boolean;
+  /** 明文连接后强制升级到 TLS（587 提交端口） */
+  requireTLS: boolean;
+  ignoreTLS: boolean;
+  tls?: { rejectUnauthorized?: boolean };
+  user?: string;
+  pass?: string;
+  from: string;
+}
+
+function printJson(label: string, data: unknown): void {
   console.log(`\n${label}:`);
   console.log(JSON.stringify(data, null, 2));
 }
@@ -34,16 +82,124 @@ function question(prompt: string): Promise<string> {
   });
 }
 
+function envBool(v: string | undefined, defaultVal: boolean): boolean {
+  if (v === undefined || v.trim() === '') {
+    return defaultVal;
+  }
+  const s = v.trim().toLowerCase();
+  if (['1', 'true', 'yes'].includes(s)) {
+    return true;
+  }
+  if (['0', 'false', 'no'].includes(s)) {
+    return false;
+  }
+  return defaultVal;
+}
+
+function loadSmtpConfig(): SmtpConfig | null {
+  const host = process.env.SMTP_HOST?.trim();
+  if (!host) {
+    return null;
+  }
+  const port = parseInt(process.env.SMTP_PORT || '587', 10);
+  const sec = process.env.SMTP_SECURE?.trim().toLowerCase();
+
+  const submissionPorts = new Set([25, 587, 2525]);
+  const userWantsEncryption =
+    sec === '1' || sec === 'true' || sec === 'yes' || sec === 'implicit' || sec === 'smtps';
+
+  /** 465 或显式 smtps / implicit → 连接即 TLS */
+  const implicitTls =
+    port === 465 || sec === 'implicit' || sec === 'smtps';
+
+  let secure = false;
+  if (implicitTls) {
+    secure = true;
+  } else if (!submissionPorts.has(port) && userWantsEncryption) {
+    secure = true;
+  }
+  /*
+   * 587/2525/25 必须用 secure:false，由 STARTTLS 升级；此前把 SMTP_SECURE=1 当成 secure:true
+   * 会导致与提交端口不兼容（对方期待明文握手再 STARTTLS）。
+   */
+  const ignoreTLS = envBool(process.env.SMTP_IGNORE_TLS, false);
+
+  const defaultRequireStartTls =
+    !secure &&
+    !ignoreTLS &&
+    (port === 587 || port === 2525 || (port === 25 && userWantsEncryption));
+  const requireTLS = envBool(process.env.SMTP_REQUIRE_TLS, defaultRequireStartTls);
+
+  const rejectUnauthorized = envBool(process.env.SMTP_TLS_REJECT_UNAUTHORIZED, true);
+
+  const user = process.env.SMTP_USER?.trim() || undefined;
+  const pass = process.env.SMTP_PASS?.trim() || undefined;
+  const from =
+    process.env.SMTP_FROM?.trim() ||
+    user ||
+    'noreply@localhost';
+  return {
+    host,
+    port,
+    secure,
+    requireTLS,
+    ignoreTLS,
+    tls: { rejectUnauthorized },
+    user,
+    pass,
+    from,
+  };
+}
+
+function channelsToTest(all: ChannelInfo[]): Channel[] {
+  const raw = process.env.POLL_CHANNELS?.trim();
+  if (!raw) {
+    return all.map((c) => c.channel);
+  }
+  const wanted = raw.split(',').map((s) => s.trim()).filter(Boolean);
+  const valid = new Set<Channel>(all.map((c) => c.channel));
+  const picked: Channel[] = [];
+  for (const id of wanted) {
+    if (valid.has(id as Channel)) {
+      picked.push(id as Channel);
+    } else {
+      console.warn(`未知渠道，已跳过: ${id}`);
+    }
+  }
+  return picked.length > 0 ? picked : all.map((c) => c.channel);
+}
+
+async function sendProbeMail(config: SmtpConfig, to: string, subject: string, text: string): Promise<void> {
+  const transporter = nodemailer.createTransport({
+    host: config.host,
+    port: config.port,
+    secure: config.secure,
+    requireTLS: config.requireTLS,
+    ignoreTLS: config.ignoreTLS,
+    tls: config.tls,
+    auth:
+      config.user !== undefined && config.pass !== undefined
+        ? { user: config.user, pass: config.pass }
+        : undefined,
+  });
+  await transporter.sendMail({
+    from: config.from,
+    to,
+    subject,
+    text,
+  });
+}
+
 async function selectChannel(channels: ChannelInfo[]): Promise<Channel> {
   console.log('\n请选择渠道:');
   channels.forEach((ch, index) => {
     console.log(`  [${index + 1}] ${ch.channel} - ${ch.name} (${ch.website})`);
   });
-  
+
   while (true) {
     const input = await question('\n请输入渠道编号 (1-' + channels.length + '): ');
     const num = parseInt(input, 10);
-    
+
     if (num >= 1 && num <= channels.length) {
       return channels[num - 1].channel;
     }
@@ -82,24 +238,20 @@ async function pollEmails(emailInfo: EmailInfo): Promise<void> {
 
   while (pollCount < MAX_POLL_COUNT) {
     pollCount++;
-    
+
     try {
       const result = await getEmails(emailInfo);
 
       const timestamp = new Date().toLocaleTimeString();
-      
+
       if (result.emails.length > 0) {
         console.log(`\n[${timestamp}] 🎉 收到 ${result.emails.length} 封邮件！\n`);
-        
-        // 打印原始返回数据
+
         printJson('返回数据 (GetEmailsResult)', result);
 
         for (let i = 0; i < result.emails.length; i++) {
           printEmail(result.emails[i], i);
         }
-        
-        // 收到邮件后可以选择继续轮询或退出
-        // break;
       } else {
         process.stdout.write(`\r[${timestamp}] 第 ${pollCount}/${MAX_POLL_COUNT} 次检查，暂无新邮件...`);
       }
@@ -113,31 +265,130 @@ async function pollEmails(emailInfo: EmailInfo): Promise<void> {
   console.log('\n\n已达到最大轮询次数，停止轮询');
 }
 
-async function main(): Promise<void> {
+type ProbeResult = 'ok' | 'fail_create' | 'fail_smtp' | 'fail_timeout';
+
+async function probeChannel(channel: Channel, smtp: SmtpConfig): Promise<ProbeResult> {
+  const emailInfo = await generateEmail({ channel, channelFallback: false });
+  if (!emailInfo) {
+    console.log('  ❌ 创建临时邮箱失败');
+    return 'fail_create';
+  }
+
+  const to = String(emailInfo.email ?? '').trim();
+  if (!to || !to.includes('@')) {
+    console.log('  ❌ 无效收件地址（渠道未返回邮箱，例如 linshi-email 触发频率限制时 API 会返回空 data）');
+    return 'fail_create';
+  }
+
+  const marker = `tm-sdk-${Date.now()}-${randomBytes(4).toString('hex')}`;
+  const subject = `[tempmail-sdk] ${marker}`;
+  const text = `自动化探针邮件\nmarker: ${marker}\nchannel: ${channel}\n`;
+
+  try {
+    await sendProbeMail(smtp, to, subject, text);
+  } catch (err) {
+    console.log(`  ❌ SMTP 发送失败: ${err}`);
+    return 'fail_smtp';
+  }
+
+  console.log(`  📤 已发送测试邮件 → ${to}`);
+
+  let probeMismatchLogged = false;
+  for (let i = 0; i < MAX_POLL_COUNT; i++) {
+    const result = await getEmails(emailInfo);
+    if (result.success && result.emails.length > 0) {
+      const hit = result.emails.some(
+        (e) =>
+          (e.subject && e.subject.includes(marker)) ||
+          (e.text && e.text.includes(marker)) ||
+          (e.html && e.html.includes(marker)),
+      );
+      if (hit) {
+        console.log(`  ✅ 已收到匹配邮件（第 ${i + 1} 次轮询）`);
+        return 'ok';
+      }
+      const hintChannel = channel === 'smail-pw' || channel === 'chatgpt-org-uk';
+      if (hintChannel && !probeMismatchLogged) {
+        probeMismatchLogged = true;
+        const subs = result.emails.map((e) => e.subject || '(无主题)').join('; ');
+        console.log(`\n  提示: 已解析到 ${result.emails.length} 封邮件，但主题/正文/HTML 未含探针标记。主题摘要: ${subs.slice(0, 200)}`);
+      }
+    }
+    process.stdout.write(`\r  轮询 ${i + 1}/${MAX_POLL_COUNT}...`);
+    await sleep(POLL_INTERVAL);
+  }
+
+  console.log('\n  ❌ 超时未收到带标记的邮件');
+  if (channel === 'smail-pw') {
+    console.log(
+      '  提示: smail.pw 依赖 RSC 响应解析；若已修复解析仍超时，可能是外发 SMTP 被拒/延迟，可加大 POLL_MAX_ROUNDS、POLL_INTERVAL_MS 后重试。',
+    );
+  }
+  return 'fail_timeout';
+}
+
+async function runSmtpAutoSuite(smtp: SmtpConfig): Promise<void> {
+  console.log('═'.repeat(50));
+  console.log('  临时邮箱 Demo — SMTP 自动探针（默认测全部渠道）');
+  console.log('═'.repeat(50));
+  console.log(
+    `\nSMTP: ${smtp.host}:${smtp.port} implicitTLS=${smtp.secure} requireTLS=${smtp.requireTLS} ignoreTLS=${smtp.ignoreTLS} tls.rejectUnauthorized=${smtp.tls?.rejectUnauthorized ?? true} from=${smtp.from}`,
+  );
+
+  const all = listChannels();
+  const targets = channelsToTest(all);
+  console.log(`\n待测渠道 (${targets.length}): ${targets.join(', ')}\n`);
+
+  const stats: Record<ProbeResult, number> = {
+    ok: 0,
+    fail_create: 0,
+    fail_smtp: 0,
+    fail_timeout: 0,
+  };
+
+  for (const channel of targets) {
+    const info = getChannelInfo(channel);
+    const label = info ? `${info.name} (${channel})` : channel;
+    console.log(`\n── ${label} ──`);
+    const r = await probeChannel(channel, smtp);
+    stats[r]++;
+  }
+
+  console.log('\n' + '═'.repeat(50));
+  console.log('  汇总');
+  console.log('═'.repeat(50));
+  console.log(`  成功收到:     ${stats.ok}`);
+  console.log(`  创建失败:     ${stats.fail_create}`);
+  console.log(`  SMTP 失败:    ${stats.fail_smtp}`);
+  console.log(`  超时未收到:   ${stats.fail_timeout}`);
+
+  const bad = stats.fail_create + stats.fail_smtp + stats.fail_timeout;
+  if (bad > 0) {
+    process.exitCode = 1;
+  }
+}
+
+async function runInteractive(): Promise<void> {
   console.log('═'.repeat(50));
   console.log('  临时邮箱 Demo - 获取邮箱并轮询邮件');
   console.log('═'.repeat(50));
 
-  // 1. 列出所有支持的渠道
   console.log('\n[1] 列出所有支持的渠道...');
   const channels = listChannels();
   printJson('支持的渠道列表', channels);
 
-  // 2. 让用户选择渠道
   console.log('\n[2] 选择渠道...');
   const selectedChannel = await selectChannel(channels);
-  
-  // 3. 获取指定渠道信息
+
   console.log(`\n[3] 获取渠道 "${selectedChannel}" 信息...`);
   const channelInfo = getChannelInfo(selectedChannel);
   printJson('渠道信息', channelInfo);
 
-  // 4. 从指定渠道获取邮箱
   console.log(`\n[4] 从 ${selectedChannel} 渠道获取临时邮箱...`);
-  
+
   try {
     const emailInfo = await generateEmail({ channel: selectedChannel });
-    
+
     if (!emailInfo) {
       console.error('\n❌ 所有渠道均不可用');
       process.exit(1);
@@ -146,7 +397,7 @@ async function main(): Promise<void> {
 
     console.log('\n✅ 获取邮箱成功！');
     printJson('返回数据 (EmailInfo)', emailInfo);
-    
+
     console.log('\n📋 邮箱信息:');
     console.log(`   渠道: ${emailInfo.channel}`);
     console.log(`   邮箱: ${emailInfo.email}`);
@@ -158,14 +409,25 @@ async function main(): Promise<void> {
     }
 
     console.log('\n📧 请发送邮件到以上邮箱地址进行测试');
-    
-    // 5. 轮询获取邮件
-    await pollEmails(emailInfo);
 
+    await pollEmails(emailInfo);
   } catch (error) {
     console.error(`\n❌ 获取邮箱失败: ${error}`);
     process.exit(1);
   }
 }
 
+async function main(): Promise<void> {
+  const argv = new Set(process.argv.slice(2));
+  const forceInteractive = argv.has('--interactive') || argv.has('-i');
+  const smtp = loadSmtpConfig();
+
+  if (smtp && !forceInteractive) {
+    await runSmtpAutoSuite(smtp);
+    return;
+  }
+
+  await runInteractive();
+}
+
 main().catch(console.error);

package/dist/config.d.ts

@@ -6,6 +6,9 @@
  *   TEMPMAIL_PROXY    - 代理 URL
  *   TEMPMAIL_TIMEOUT  - 超时毫秒数
  *   TEMPMAIL_INSECURE - 设为 "1" 或 "true" 跳过 SSL 验证
+ *   DROPMAIL_AUTH_TOKEN / DROPMAIL_API_TOKEN - DropMail GraphQL 的 af_ 令牌（可选；未设置时 SDK 会 /api/token/generate 获取并在将过期时用 /api/token/renew 续期）
+ *   DROPMAIL_NO_AUTO_TOKEN - 设为 "1" 或 "true" 则禁止自动拉取/续期令牌
+ *   DROPMAIL_RENEW_LIFETIME - 自动续期请求的 lifetime，默认 1d（与官网 renew 接口一致）
  *
  * Node.js 环境下设置 insecure 会自动设置 NODE_TLS_REJECT_UNAUTHORIZED=0
  */
@@ -19,6 +22,19 @@ export interface SDKConfig {
     timeout?: number;
     /** 跳过 SSL 证书验证（调试用） */
     insecure?: boolean;
+    /**
+     * DropMail 渠道专用：GraphQL 端点 `https://dropmail.me/api/graphql/${token}` 中的 token（须为官网生成的 `af_` 前缀令牌）。
+     * 也可通过环境变量 DROPMAIL_AUTH_TOKEN 或 DROPMAIL_API_TOKEN 提供。
+     * 未配置且未设置 DROPMAIL_NO_AUTO_TOKEN 时，会向 https://dropmail.me/api/token/generate 申请 1h 令牌并内存缓存。
+     */
+    dropmailAuthToken?: string;
+    /** 为 true 时不自动请求 token（须配置 dropmailAuthToken 或环境变量） */
+    dropmailDisableAutoToken?: boolean;
+    /**
+     * 自动管理令牌即将过期时，调用 /api/token/renew 使用的 lifetime（如 1h、1d）。
+     * 也可通过环境变量 DROPMAIL_RENEW_LIFETIME 设置。
+     */
+    dropmailRenewLifetime?: string;
     /**
      * 自定义 fetch 函数，用于完全控制 HTTP 请求行为
      * 当设置了 proxy 但环境不支持 undici 时，可通过此选项传入支持代理的 fetch 实现

package/dist/config.js

@@ -7,6 +7,9 @@
  *   TEMPMAIL_PROXY    - 代理 URL
  *   TEMPMAIL_TIMEOUT  - 超时毫秒数
  *   TEMPMAIL_INSECURE - 设为 "1" 或 "true" 跳过 SSL 验证
+ *   DROPMAIL_AUTH_TOKEN / DROPMAIL_API_TOKEN - DropMail GraphQL 的 af_ 令牌（可选；未设置时 SDK 会 /api/token/generate 获取并在将过期时用 /api/token/renew 续期）
+ *   DROPMAIL_NO_AUTO_TOKEN - 设为 "1" 或 "true" 则禁止自动拉取/续期令牌
+ *   DROPMAIL_RENEW_LIFETIME - 自动续期请求的 lifetime，默认 1d（与官网 renew 接口一致）
  *
  * Node.js 环境下设置 insecure 会自动设置 NODE_TLS_REJECT_UNAUTHORIZED=0
  */
@@ -65,4 +68,4 @@ function setConfig(config) {
 function getConfig() {
     return globalConfig;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7R0FVRzs7QUF3REgsOEJBVUM7QUFHRCw4QkFFQztBQXBERCxrQkFBa0I7QUFDbEIsU0FBUyxhQUFhO0lBQ3BCLE1BQU0sTUFBTSxHQUFjLEVBQUUsQ0FBQztJQUM3QixJQUFJLE9BQU8sT0FBTyxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDbEQsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLGNBQWMsRUFBRSxDQUFDO1lBQy9CLE1BQU0sQ0FBQyxLQUFLLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUM7UUFDNUMsQ0FBQztRQUNELElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1lBQ2pDLE1BQU0sQ0FBQyxHQUFHLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGdCQUFnQixFQUFFLEVBQUUsQ0FBQyxDQUFDO1lBQ3JELElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUM7Z0JBQUUsTUFBTSxDQUFDLE9BQU8sR0FBRyxDQUFDLENBQUM7UUFDN0MsQ0FBQztRQUNELElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsS0FBSyxHQUFHLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsRUFBRSxXQUFXLEVBQUUsS0FBSyxNQUFNLEVBQUUsQ0FBQztZQUNyRyxNQUFNLENBQUMsUUFBUSxHQUFHLElBQUksQ0FBQztRQUN6QixDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUM7QUFFRCxJQUFJLFlBQVksR0FBYyxhQUFhLEVBQUUsQ0FBQztBQUU5Qzs7Ozs7Ozs7Ozs7Ozs7OztHQWdCRztBQUNILFNBQWdCLFNBQVMsQ0FBQyxNQUFpQjtJQUN6QyxZQUFZLEdBQUcsRUFBRSxHQUFHLE1BQU0sRUFBRSxDQUFDO0lBQzdCLG1DQUFtQztJQUNuQyxJQUFJLE9BQU8sT0FBTyxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDbEQsSUFBSSxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDcEIsT0FBTyxDQUFDLEdBQUcsQ0FBQyw0QkFBNEIsR0FBRyxHQUFHLENBQUM7UUFDakQsQ0FBQzthQUFNLENBQUM7WUFDTixPQUFPLE9BQU8sQ0FBQyxHQUFHLENBQUMsNEJBQTRCLENBQUM7UUFDbEQsQ0FBQztJQUNILENBQUM7QUFDSCxDQUFDO0FBRUQsb0JBQW9CO0FBQ3BCLFNBQWdCLFNBQVM7SUFDdkIsT0FBTyxZQUFZLENBQUM7QUFDdEIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogU0RLIOWFqOWxgOmFjee9rlxuICog5YyF5ZCr5Luj55CG44CB6LaF5pe244CBU1NMIOetieiuvue9ru+8jOS9nOeUqOS6juaJgOaciSBIVFRQIOivt+axglxuICpcbiAqIOaUr+aMgeeOr+Wig+WPmOmHj+iHquWKqOivu+WPlu+8iOS8mOWFiOe6p+S9juS6juS7o+eggeiuvue9ru+8ie+8mlxuICogICBURU1QTUFJTF9QUk9YWSAgICAtIOS7o+eQhiBVUkxcbiAqICAgVEVNUE1BSUxfVElNRU9VVCAgLSDotoXml7bmr6vnp5LmlbBcbiAqICAgVEVNUE1BSUxfSU5TRUNVUkUgLSDorr7kuLogXCIxXCIg5oiWIFwidHJ1ZVwiIOi3s+i/hyBTU0wg6aqM6K+BXG4gKlxuICogTm9kZS5qcyDnjq/looPkuIvorr7nva4gaW5zZWN1cmUg5Lya6Ieq5Yqo6K6+572uIE5PREVfVExTX1JFSkVDVF9VTkFVVEhPUklaRUQ9MFxuICovXG5cbi8qKlxuICogU0RLIOWFqOWxgOmFjee9ruaOpeWPo1xuICovXG5leHBvcnQgaW50ZXJmYWNlIFNES0NvbmZpZyB7XG4gIC8qKiDku6PnkIYgVVJM77yM5pSv5oyBIGh0dHAvaHR0cHMvc29ja3M177yM5aaCIFwiaHR0cDovLzEyNy4wLjAuMTo3ODkwXCIgKi9cbiAgcHJveHk/OiBzdHJpbmc7XG4gIC8qKiDlhajlsYDpu5jorqTotoXml7bvvIjmr6vnp5LvvInvvIzpu5jorqQgMTUwMDAgKi9cbiAgdGltZW91dD86IG51bWJlcjtcbiAgLyoqIOi3s+i/hyBTU0wg6K+B5Lmm6aqM6K+B77yI6LCD6K+V55So77yJICovXG4gIGluc2VjdXJlPzogYm9vbGVhbjtcbiAgLyoqXG4gICAqIOiHquWumuS5iSBmZXRjaCDlh73mlbDvvIznlKjkuo7lrozlhajmjqfliLYgSFRUUCDor7fmsYLooYzkuLpcbiAgICog5b2T6K6+572u5LqGIHByb3h5IOS9hueOr+Wig+S4jeaUr+aMgSB1bmRpY2kg5pe277yM5Y+v6YCa6L+H5q2k6YCJ6aG55Lyg5YWl5pSv5oyB5Luj55CG55qEIGZldGNoIOWunueOsFxuICAgKi9cbiAgY3VzdG9tRmV0Y2g/OiB0eXBlb2YgZmV0Y2g7XG59XG5cbi8qKiDku47njq/looPlj5jph4/or7vlj5bpu5jorqTphY3nva4gKi9cbmZ1bmN0aW9uIGxvYWRFbnZDb25maWcoKTogU0RLQ29uZmlnIHtcbiAgY29uc3QgY29uZmlnOiBTREtDb25maWcgPSB7fTtcbiAgaWYgKHR5cGVvZiBwcm9jZXNzICE9PSAndW5kZWZpbmVkJyAmJiBwcm9jZXNzLmVudikge1xuICAgIGlmIChwcm9jZXNzLmVudi5URU1QTUFJTF9QUk9YWSkge1xuICAgICAgY29uZmlnLnByb3h5ID0gcHJvY2Vzcy5lbnYuVEVNUE1BSUxfUFJPWFk7XG4gICAgfVxuICAgIGlmIChwcm9jZXNzLmVudi5URU1QTUFJTF9USU1FT1VUKSB7XG4gICAgICBjb25zdCB0ID0gcGFyc2VJbnQocHJvY2Vzcy5lbnYuVEVNUE1BSUxfVElNRU9VVCwgMTApO1xuICAgICAgaWYgKCFpc05hTih0KSAmJiB0ID4gMCkgY29uZmlnLnRpbWVvdXQgPSB0O1xuICAgIH1cbiAgICBpZiAocHJvY2Vzcy5lbnYuVEVNUE1BSUxfSU5TRUNVUkUgPT09ICcxJyB8fCBwcm9jZXNzLmVudi5URU1QTUFJTF9JTlNFQ1VSRT8udG9Mb3dlckNhc2UoKSA9PT0gJ3RydWUnKSB7XG4gICAgICBjb25maWcuaW5zZWN1cmUgPSB0cnVlO1xuICAgIH1cbiAgfVxuICByZXR1cm4gY29uZmlnO1xufVxuXG5sZXQgZ2xvYmFsQ29uZmlnOiBTREtDb25maWcgPSBsb2FkRW52Q29uZmlnKCk7XG5cbi8qKlxuICog6K6+572uIFNESyDlhajlsYDphY3nva5cbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHNcbiAqIC8vIOS4gOihjOi3s+i/hyBTU0wg6aqM6K+BXG4gKiBzZXRDb25maWcoeyBpbnNlY3VyZTogdHJ1ZSB9KTtcbiAqXG4gKiAvLyDorr7nva7ku6PnkIblkozotoXml7ZcbiAqIHNldENvbmZpZyh7IHByb3h5OiAnaHR0cDovLzEyNy4wLjAuMTo3ODkwJywgdGltZW91dDogMzAwMDAgfSk7XG4gKlxuICogLy8g5L2/55So6Ieq5a6a5LmJIGZldGNo77yI5aaC5pSv5oyB5Luj55CG55qEIHVuZGljae+8iVxuICogaW1wb3J0IHsgUHJveHlBZ2VudCwgZmV0Y2ggYXMgdW5kaWNpRmV0Y2ggfSBmcm9tICd1bmRpY2knO1xuICogY29uc3QgYWdlbnQgPSBuZXcgUHJveHlBZ2VudCgnaHR0cDovLzEyNy4wLjAuMTo3ODkwJyk7XG4gKiBzZXRDb25maWcoeyBjdXN0b21GZXRjaDogKHVybCwgaW5pdCkgPT4gdW5kaWNpRmV0Y2godXJsLCB7IC4uLmluaXQsIGRpc3BhdGNoZXI6IGFnZW50IH0pIH0pO1xuICogYGBgXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzZXRDb25maWcoY29uZmlnOiBTREtDb25maWcpOiB2b2lkIHtcbiAgZ2xvYmFsQ29uZmlnID0geyAuLi5jb25maWcgfTtcbiAgLyogTm9kZS5qcyDnjq/looPkuIsgaW5zZWN1cmUg6Ieq5Yqo6K6+572u546v5aKD5Y+Y6YePICovXG4gIGlmICh0eXBlb2YgcHJvY2VzcyAhPT0gJ3VuZGVmaW5lZCcgJiYgcHJvY2Vzcy5lbnYpIHtcbiAgICBpZiAoY29uZmlnLmluc2VjdXJlKSB7XG4gICAgICBwcm9jZXNzLmVudi5OT0RFX1RMU19SRUpFQ1RfVU5BVVRIT1JJWkVEID0gJzAnO1xuICAgIH0gZWxzZSB7XG4gICAgICBkZWxldGUgcHJvY2Vzcy5lbnYuTk9ERV9UTFNfUkVKRUNUX1VOQVVUSE9SSVpFRDtcbiAgICB9XG4gIH1cbn1cblxuLyoqIOiOt+WPluW9k+WJjSBTREsg5YWo5bGA6YWN572uICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0Q29uZmlnKCk6IFNES0NvbmZpZyB7XG4gIHJldHVybiBnbG9iYWxDb25maWc7XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7R0FhRzs7QUFxRUgsOEJBVUM7QUFHRCw4QkFFQztBQXBERCxrQkFBa0I7QUFDbEIsU0FBUyxhQUFhO0lBQ3BCLE1BQU0sTUFBTSxHQUFjLEVBQUUsQ0FBQztJQUM3QixJQUFJLE9BQU8sT0FBTyxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDbEQsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLGNBQWMsRUFBRSxDQUFDO1lBQy9CLE1BQU0sQ0FBQyxLQUFLLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUM7UUFDNUMsQ0FBQztRQUNELElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1lBQ2pDLE1BQU0sQ0FBQyxHQUFHLFFBQVEsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLGdCQUFnQixFQUFFLEVBQUUsQ0FBQyxDQUFDO1lBQ3JELElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUM7Z0JBQUUsTUFBTSxDQUFDLE9BQU8sR0FBRyxDQUFDLENBQUM7UUFDN0MsQ0FBQztRQUNELElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsS0FBSyxHQUFHLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsRUFBRSxXQUFXLEVBQUUsS0FBSyxNQUFNLEVBQUUsQ0FBQztZQUNyRyxNQUFNLENBQUMsUUFBUSxHQUFHLElBQUksQ0FBQztRQUN6QixDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUM7QUFFRCxJQUFJLFlBQVksR0FBYyxhQUFhLEVBQUUsQ0FBQztBQUU5Qzs7Ozs7Ozs7Ozs7Ozs7OztHQWdCRztBQUNILFNBQWdCLFNBQVMsQ0FBQyxNQUFpQjtJQUN6QyxZQUFZLEdBQUcsRUFBRSxHQUFHLE1BQU0sRUFBRSxDQUFDO0lBQzdCLG1DQUFtQztJQUNuQyxJQUFJLE9BQU8sT0FBTyxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDbEQsSUFBSSxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDcEIsT0FBTyxDQUFDLEdBQUcsQ0FBQyw0QkFBNEIsR0FBRyxHQUFHLENBQUM7UUFDakQsQ0FBQzthQUFNLENBQUM7WUFDTixPQUFPLE9BQU8sQ0FBQyxHQUFHLENBQUMsNEJBQTRCLENBQUM7UUFDbEQsQ0FBQztJQUNILENBQUM7QUFDSCxDQUFDO0FBRUQsb0JBQW9CO0FBQ3BCLFNBQWdCLFNBQVM7SUFDdkIsT0FBTyxZQUFZLENBQUM7QUFDdEIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogU0RLIOWFqOWxgOmFjee9rlxuICog5YyF5ZCr5Luj55CG44CB6LaF5pe244CBU1NMIOetieiuvue9ru+8jOS9nOeUqOS6juaJgOaciSBIVFRQIOivt+axglxuICpcbiAqIOaUr+aMgeeOr+Wig+WPmOmHj+iHquWKqOivu+WPlu+8iOS8mOWFiOe6p+S9juS6juS7o+eggeiuvue9ru+8ie+8mlxuICogICBURU1QTUFJTF9QUk9YWSAgICAtIOS7o+eQhiBVUkxcbiAqICAgVEVNUE1BSUxfVElNRU9VVCAgLSDotoXml7bmr6vnp5LmlbBcbiAqICAgVEVNUE1BSUxfSU5TRUNVUkUgLSDorr7kuLogXCIxXCIg5oiWIFwidHJ1ZVwiIOi3s+i/hyBTU0wg6aqM6K+BXG4gKiAgIERST1BNQUlMX0FVVEhfVE9LRU4gLyBEUk9QTUFJTF9BUElfVE9LRU4gLSBEcm9wTWFpbCBHcmFwaFFMIOeahCBhZl8g5Luk54mM77yI5Y+v6YCJ77yb5pyq6K6+572u5pe2IFNESyDkvJogL2FwaS90b2tlbi9nZW5lcmF0ZSDojrflj5blubblnKjlsIbov4fmnJ/ml7bnlKggL2FwaS90b2tlbi9yZW5ldyDnu63mnJ/vvIlcbiAqICAgRFJPUE1BSUxfTk9fQVVUT19UT0tFTiAtIOiuvuS4uiBcIjFcIiDmiJYgXCJ0cnVlXCIg5YiZ56aB5q2i6Ieq5Yqo5ouJ5Y+WL+e7reacn+S7pOeJjFxuICogICBEUk9QTUFJTF9SRU5FV19MSUZFVElNRSAtIOiHquWKqOe7reacn+ivt+axgueahCBsaWZldGltZe+8jOm7mOiupCAxZO+8iOS4juWumOe9kSByZW5ldyDmjqXlj6PkuIDoh7TvvIlcbiAqXG4gKiBOb2RlLmpzIOeOr+Wig+S4i+iuvue9riBpbnNlY3VyZSDkvJroh6rliqjorr7nva4gTk9ERV9UTFNfUkVKRUNUX1VOQVVUSE9SSVpFRD0wXG4gKi9cblxuLyoqXG4gKiBTREsg5YWo5bGA6YWN572u5o6l5Y+jXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU0RLQ29uZmlnIHtcbiAgLyoqIOS7o+eQhiBVUkzvvIzmlK/mjIEgaHR0cC9odHRwcy9zb2NrczXvvIzlpoIgXCJodHRwOi8vMTI3LjAuMC4xOjc4OTBcIiAqL1xuICBwcm94eT86IHN0cmluZztcbiAgLyoqIOWFqOWxgOm7mOiupOi2heaXtu+8iOavq+enku+8ie+8jOm7mOiupCAxNTAwMCAqL1xuICB0aW1lb3V0PzogbnVtYmVyO1xuICAvKiog6Lez6L+HIFNTTCDor4Hkuabpqozor4HvvIjosIPor5XnlKjvvIkgKi9cbiAgaW5zZWN1cmU/OiBib29sZWFuO1xuICAvKipcbiAgICogRHJvcE1haWwg5rig6YGT5LiT55So77yaR3JhcGhRTCDnq6/ngrkgYGh0dHBzOi8vZHJvcG1haWwubWUvYXBpL2dyYXBocWwvJHt0b2tlbn1gIOS4reeahCB0b2tlbu+8iOmhu+S4uuWumOe9keeUn+aIkOeahCBgYWZfYCDliY3nvIDku6TniYzvvInjgIJcbiAgICog5Lmf5Y+v6YCa6L+H546v5aKD5Y+Y6YePIERST1BNQUlMX0FVVEhfVE9LRU4g5oiWIERST1BNQUlMX0FQSV9UT0tFTiDmj5DkvpvjgIJcbiAgICog5pyq6YWN572u5LiU5pyq6K6+572uIERST1BNQUlMX05PX0FVVE9fVE9LRU4g5pe277yM5Lya5ZCRIGh0dHBzOi8vZHJvcG1haWwubWUvYXBpL3Rva2VuL2dlbmVyYXRlIOeUs+ivtyAxaCDku6TniYzlubblhoXlrZjnvJPlrZjjgIJcbiAgICovXG4gIGRyb3BtYWlsQXV0aFRva2VuPzogc3RyaW5nO1xuICAvKiog5Li6IHRydWUg5pe25LiN6Ieq5Yqo6K+35rGCIHRva2Vu77yI6aG76YWN572uIGRyb3BtYWlsQXV0aFRva2VuIOaIlueOr+Wig+WPmOmHj++8iSAqL1xuICBkcm9wbWFpbERpc2FibGVBdXRvVG9rZW4/OiBib29sZWFuO1xuICAvKipcbiAgICog6Ieq5Yqo566h55CG5Luk54mM5Y2z5bCG6L+H5pyf5pe277yM6LCD55SoIC9hcGkvdG9rZW4vcmVuZXcg5L2/55So55qEIGxpZmV0aW1l77yI5aaCIDFo44CBMWTvvInjgIJcbiAgICog5Lmf5Y+v6YCa6L+H546v5aKD5Y+Y6YePIERST1BNQUlMX1JFTkVXX0xJRkVUSU1FIOiuvue9ruOAglxuICAgKi9cbiAgZHJvcG1haWxSZW5ld0xpZmV0aW1lPzogc3RyaW5nO1xuICAvKipcbiAgICog6Ieq5a6a5LmJIGZldGNoIOWHveaVsO+8jOeUqOS6juWujOWFqOaOp+WItiBIVFRQIOivt+axguihjOS4ulxuICAgKiDlvZPorr7nva7kuoYgcHJveHkg5L2G546v5aKD5LiN5pSv5oyBIHVuZGljaSDml7bvvIzlj6/pgJrov4fmraTpgInpobnkvKDlhaXmlK/mjIHku6PnkIbnmoQgZmV0Y2gg5a6e546wXG4gICAqL1xuICBjdXN0b21GZXRjaD86IHR5cGVvZiBmZXRjaDtcbn1cblxuLyoqIOS7jueOr+Wig+WPmOmHj+ivu+WPlum7mOiupOmFjee9riAqL1xuZnVuY3Rpb24gbG9hZEVudkNvbmZpZygpOiBTREtDb25maWcge1xuICBjb25zdCBjb25maWc6IFNES0NvbmZpZyA9IHt9O1xuICBpZiAodHlwZW9mIHByb2Nlc3MgIT09ICd1bmRlZmluZWQnICYmIHByb2Nlc3MuZW52KSB7XG4gICAgaWYgKHByb2Nlc3MuZW52LlRFTVBNQUlMX1BST1hZKSB7XG4gICAgICBjb25maWcucHJveHkgPSBwcm9jZXNzLmVudi5URU1QTUFJTF9QUk9YWTtcbiAgICB9XG4gICAgaWYgKHByb2Nlc3MuZW52LlRFTVBNQUlMX1RJTUVPVVQpIHtcbiAgICAgIGNvbnN0IHQgPSBwYXJzZUludChwcm9jZXNzLmVudi5URU1QTUFJTF9USU1FT1VULCAxMCk7XG4gICAgICBpZiAoIWlzTmFOKHQpICYmIHQgPiAwKSBjb25maWcudGltZW91dCA9IHQ7XG4gICAgfVxuICAgIGlmIChwcm9jZXNzLmVudi5URU1QTUFJTF9JTlNFQ1VSRSA9PT0gJzEnIHx8IHByb2Nlc3MuZW52LlRFTVBNQUlMX0lOU0VDVVJFPy50b0xvd2VyQ2FzZSgpID09PSAndHJ1ZScpIHtcbiAgICAgIGNvbmZpZy5pbnNlY3VyZSA9IHRydWU7XG4gICAgfVxuICB9XG4gIHJldHVybiBjb25maWc7XG59XG5cbmxldCBnbG9iYWxDb25maWc6IFNES0NvbmZpZyA9IGxvYWRFbnZDb25maWcoKTtcblxuLyoqXG4gKiDorr7nva4gU0RLIOWFqOWxgOmFjee9rlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c1xuICogLy8g5LiA6KGM6Lez6L+HIFNTTCDpqozor4FcbiAqIHNldENvbmZpZyh7IGluc2VjdXJlOiB0cnVlIH0pO1xuICpcbiAqIC8vIOiuvue9ruS7o+eQhuWSjOi2heaXtlxuICogc2V0Q29uZmlnKHsgcHJveHk6ICdodHRwOi8vMTI3LjAuMC4xOjc4OTAnLCB0aW1lb3V0OiAzMDAwMCB9KTtcbiAqXG4gKiAvLyDkvb/nlKjoh6rlrprkuYkgZmV0Y2jvvIjlpoLmlK/mjIHku6PnkIbnmoQgdW5kaWNp77yJXG4gKiBpbXBvcnQgeyBQcm94eUFnZW50LCBmZXRjaCBhcyB1bmRpY2lGZXRjaCB9IGZyb20gJ3VuZGljaSc7XG4gKiBjb25zdCBhZ2VudCA9IG5ldyBQcm94eUFnZW50KCdodHRwOi8vMTI3LjAuMC4xOjc4OTAnKTtcbiAqIHNldENvbmZpZyh7IGN1c3RvbUZldGNoOiAodXJsLCBpbml0KSA9PiB1bmRpY2lGZXRjaCh1cmwsIHsgLi4uaW5pdCwgZGlzcGF0Y2hlcjogYWdlbnQgfSkgfSk7XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNldENvbmZpZyhjb25maWc6IFNES0NvbmZpZyk6IHZvaWQge1xuICBnbG9iYWxDb25maWcgPSB7IC4uLmNvbmZpZyB9O1xuICAvKiBOb2RlLmpzIOeOr+Wig+S4iyBpbnNlY3VyZSDoh6rliqjorr7nva7njq/looPlj5jph48gKi9cbiAgaWYgKHR5cGVvZiBwcm9jZXNzICE9PSAndW5kZWZpbmVkJyAmJiBwcm9jZXNzLmVudikge1xuICAgIGlmIChjb25maWcuaW5zZWN1cmUpIHtcbiAgICAgIHByb2Nlc3MuZW52Lk5PREVfVExTX1JFSkVDVF9VTkFVVEhPUklaRUQgPSAnMCc7XG4gICAgfSBlbHNlIHtcbiAgICAgIGRlbGV0ZSBwcm9jZXNzLmVudi5OT0RFX1RMU19SRUpFQ1RfVU5BVVRIT1JJWkVEO1xuICAgIH1cbiAgfVxufVxuXG4vKiog6I635Y+W5b2T5YmNIFNESyDlhajlsYDphY3nva4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRDb25maWcoKTogU0RLQ29uZmlnIHtcbiAgcmV0dXJuIGdsb2JhbENvbmZpZztcbn1cbiJdfQ==

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { normalizeEmail } from './normalize';
 export { withRetry, fetchWithTimeout, RetryOptions } from './retry';
 export { LogLevel, LogHandler, setLogLevel, getLogLevel, setLogger, logger } from './logger';
 export { SDKConfig, setConfig, getConfig } from './config';
+export type { SyntheticBrowserProfile } from './providers/linshi-token';
+export { deriveLinshiApiPathKey, randomSyntheticLinshiKey, randomBrowserLikeProfile, syntheticVisitorIdFromProfile, } from './providers/linshi-token';
 /**
  * 渠道信息，包含渠道标识、显示名称和对应网站
  */
@@ -39,7 +41,8 @@ export declare function getChannelInfo(channel: Channel): ChannelInfo | undefine
  * 创建临时邮箱
  *
  * 错误处理策略：
- * - 指定渠道失败时，自动尝试其他可用渠道（打乱顺序逐个尝试）
+ * - 指定渠道失败时，默认自动尝试其他可用渠道（打乱顺序逐个尝试）
+ * - `channelFallback: false` 且指定了 `channel` 时，仅尝试该渠道，失败即返回 null
  * - 未指定渠道时，打乱全部渠道逐个尝试，直到成功
  * - 所有渠道均不可用时返回 null（不抛出异常）
  *