tempmail-sdk 1.2.0 → 1.2.2-dev

package/src/index.ts

@@ -1,5 +1,9 @@
 import * as tempmail from './providers/tempmail';
 import * as tempmailCn from './providers/tempmail-cn';
+import * as tmpmails from './providers/tmpmails';
+import * as tempmailg from './providers/tempmailg';
+import * as taEasy from './providers/ta-easy';
+import * as tenmailWangtz from './providers/10mail-wangtz';
 import * as linshiEmail from './providers/linshi-email';
 import * as linshiyou from './providers/linshiyou';
 import * as mffac from './providers/mffac';
@@ -19,6 +23,8 @@ import * as minmail from './providers/minmail';
 import * as vip215 from './providers/vip-215';
 import * as anonbox from './providers/anonbox';
 import * as fakeLegal from './providers/fake-legal';
+import * as moakt from './providers/moakt';
+import * as tenminuteOne from './providers/10minute-one';
 import { Channel, EmailInfo, InternalEmailInfo, Email, GetEmailsResult, GenerateEmailOptions, GetEmailsOptions } from './types';
 import { withRetry, withRetryWithAttempts } from './retry';
 import { reportTelemetry } from './telemetry';
@@ -36,7 +42,7 @@ export { Channel, EmailInfo, Email, EmailAttachment, GetEmailsResult, GenerateEm
 const tokenStore = new WeakMap<EmailInfo, string>();
 export { normalizeEmail } from './normalize';
 export { withRetry, withRetryWithAttempts, fetchWithTimeout, RetryOptions } from './retry';
-export type { RetryWithAttemptsResult } from './retry';
+export type { RetryWithAttemptsResult, FetchWithTimeoutOptions } from './retry';
 export { LogLevel, LogHandler, setLogLevel, getLogLevel, setLogger, logger } from './logger';
 export { SDKConfig, setConfig, getConfig } from './config';
 export { getSdkVersion } from './version';
@@ -49,7 +55,7 @@ export {
 } from './providers/linshi-token';
 
 /** 所有支持的渠道列表，用于随机选择和遍历 */
-const allChannels: Channel[] = ['tempmail', 'tempmail-cn', 'linshi-email', 'linshiyou', 'mffac', 'tempmail-lol', 'chatgpt-org-uk', 'temp-mail-io', 'awamail', 'temporary-email-org', 'mail-tm', 'mail-cx', 'dropmail', 'guerrillamail', 'maildrop', 'smail-pw', 'boomlify', 'minmail', 'vip-215', 'anonbox', 'fake-legal'];
+const allChannels: Channel[] = ['tempmail', 'tempmail-cn', 'tmpmails', 'tempmailg', 'ta-easy', '10mail-wangtz', '10minute-one', 'linshi-email', 'linshiyou', 'mffac', 'tempmail-lol', 'chatgpt-org-uk', 'temp-mail-io', 'awamail', 'temporary-email-org', 'mail-tm', 'mail-cx', 'dropmail', 'guerrillamail', 'maildrop', 'smail-pw', 'boomlify', 'minmail', 'vip-215', 'anonbox', 'fake-legal', 'moakt'];
 
 /**
  * 渠道信息，包含渠道标识、显示名称和对应网站
@@ -67,6 +73,11 @@ export interface ChannelInfo {
 const channelInfoMap: Record<Channel, ChannelInfo> = {
   'tempmail': { channel: 'tempmail', name: 'TempMail', website: 'tempmail.ing' },
   'tempmail-cn': { channel: 'tempmail-cn', name: 'TempMail CN', website: 'tempmail.cn' },
+  'tmpmails': { channel: 'tmpmails', name: 'TmpMails', website: 'tmpmails.com' },
+  'tempmailg': { channel: 'tempmailg', name: 'TempMailG', website: 'tempmailg.com' },
+  'ta-easy': { channel: 'ta-easy', name: 'TA Easy', website: 'ta-easy.com' },
+  '10mail-wangtz': { channel: '10mail-wangtz', name: '10mail Wangtz', website: '10mail.wangtz.cn' },
+  '10minute-one': { channel: '10minute-one', name: '10 Minute Email', website: '10minutemail.one' },
   'linshi-email': { channel: 'linshi-email', name: '临时邮箱', website: 'linshi-email.com' },
   'linshiyou': { channel: 'linshiyou', name: '临时邮', website: 'linshiyou.com' },
   'tempmail-lol': { channel: 'tempmail-lol', name: 'TempMail LOL', website: 'tempmail.lol' },
@@ -86,6 +97,7 @@ const channelInfoMap: Record<Channel, ChannelInfo> = {
   'vip-215': { channel: 'vip-215', name: 'VIP 215', website: 'vip.215.im' },
   'anonbox': { channel: 'anonbox', name: 'Anonbox', website: 'anonbox.net' },
   'fake-legal': { channel: 'fake-legal', name: 'Fake Legal', website: 'fake.legal' },
+  'moakt': { channel: 'moakt', name: 'Moakt', website: 'moakt.com' },
 };
 
 /**
@@ -200,6 +212,16 @@ async function generateEmailOnce(channel: Channel, options: GenerateEmailOptions
       return tempmail.generateEmail(options.duration || 30);
     case 'tempmail-cn':
       return tempmailCn.generateEmail(options.domain ?? null);
+    case 'tmpmails':
+      return tmpmails.generateEmail(options.domain ?? null);
+    case 'tempmailg':
+      return tempmailg.generateEmail(options.domain ?? null);
+    case 'ta-easy':
+      return taEasy.generateEmail();
+    case '10mail-wangtz':
+      return tenmailWangtz.generateEmail(options.domain ?? null);
+    case '10minute-one':
+      return tenminuteOne.generateEmail(options.domain ?? null);
     case 'linshi-email':
       return linshiEmail.generateEmail();
     case 'linshiyou':
@@ -236,6 +258,8 @@ async function generateEmailOnce(channel: Channel, options: GenerateEmailOptions
       return anonbox.generateEmail();
     case 'fake-legal':
       return fakeLegal.generateEmail(options.domain ?? null);
+    case 'moakt':
+      return moakt.generateEmail(options.domain ?? null);
     default:
       throw new Error(`Unknown channel: ${channel}`);
   }
@@ -314,6 +338,20 @@ async function getEmailsOnce(channel: Channel, email: string, token?: string): P
       return tempmail.getEmails(email);
     case 'tempmail-cn':
       return tempmailCn.getEmails(email);
+    case 'tmpmails':
+      if (!token) throw new Error('internal error: token missing for tmpmails');
+      return tmpmails.getEmails(email, token);
+    case 'tempmailg':
+      if (!token) throw new Error('internal error: token missing for tempmailg');
+      return tempmailg.getEmails(email, token);
+    case 'ta-easy':
+      if (!token) throw new Error('internal error: token missing for ta-easy');
+      return taEasy.getEmails(email, token);
+    case '10mail-wangtz':
+      return tenmailWangtz.getEmails(email);
+    case '10minute-one':
+      if (!token) throw new Error('internal error: token missing for 10minute-one');
+      return tenminuteOne.getEmails(email, token);
     case 'linshi-email':
       if (!token) throw new Error('internal error: token missing for linshi-email');
       return linshiEmail.getEmails(email, token);
@@ -367,6 +405,9 @@ async function getEmailsOnce(channel: Channel, email: string, token?: string): P
       return anonbox.getEmails(token, email);
     case 'fake-legal':
       return fakeLegal.getEmails(email);
+    case 'moakt':
+      if (!token) throw new Error('internal error: token missing for moakt');
+      return moakt.getEmails(email, token);
     default:
       throw new Error(`Unknown channel: ${channel}`);
   }

package/src/normalize.ts

@@ -70,6 +70,7 @@ function normalizeFrom(raw: any): string {
     raw.from_addr ||
     raw.from_address ||
     raw.fromAddress ||
+    raw.mail_sender ||
     raw.sender ||
     raw.address_from ||
     raw.from_email ||
@@ -92,7 +93,7 @@ function normalizeTo(raw: any, recipientEmail: string): string {
  * 候选字段: subject, e_subject
  */
 function normalizeSubject(raw: any): string {
-  return raw.subject || raw.e_subject || '';
+  return raw.subject || raw.e_subject || raw.mail_title || '';
 }
 
 /**
@@ -104,6 +105,7 @@ function normalizeText(raw: any): string {
     raw.text ||
     raw.text_body ||
     raw.preview_text ||
+    raw.mail_body_text ||
     raw.body ||
     raw.content ||
     raw.body_text ||
@@ -118,7 +120,7 @@ function normalizeText(raw: any): string {
  * 候选字段: html, html_content, body_html
  */
 function normalizeHtml(raw: any): string {
-  return raw.html || raw.html_body || raw.html_content || raw.body_html || '';
+  return raw.html || raw.html_body || raw.html_content || raw.body_html || raw.mail_body_html || '';
 }
 
 /**

package/src/providers/10mail-wangtz.ts

@@ -0,0 +1,128 @@
+import { InternalEmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+import { fetchWithTimeout } from '../retry';
+
+const CHANNEL: Channel = '10mail-wangtz';
+const ORIGIN = 'https://10mail.wangtz.cn';
+const MAIL_DOMAIN = 'wangtz.cn';
+
+const JSON_HEADERS: Record<string, string> = {
+  Accept: '*/*',
+  'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6',
+  'Content-Type': 'application/json; charset=utf-8',
+  Origin: ORIGIN,
+  Referer: `${ORIGIN}/`,
+  token: 'null',
+  Authorization: 'null',
+};
+
+function localPartFromDomainOption(domain?: string | null): string {
+  const s = String(domain ?? '').trim();
+  if (!s) return '';
+  const at = s.indexOf('@');
+  return at >= 0 ? s.slice(0, at).trim() : s;
+}
+
+/** emailList 返回 mailparser 风格：{ text?, value?: [{ address, name }] } */
+function formatAddrField(v: unknown): string {
+  if (!v || typeof v !== 'object') return '';
+  const o = v as { text?: unknown; value?: unknown };
+  const text = o.text;
+  if (text != null && String(text).trim()) return String(text);
+  const value = o.value;
+  if (!Array.isArray(value) || value.length === 0) return '';
+  const first = value[0];
+  if (!first || typeof first !== 'object') return '';
+  const addr = String((first as { address?: string }).address ?? '').trim();
+  if (!addr) return '';
+  const name = String((first as { name?: string }).name ?? '').trim();
+  if (name && name.toLowerCase() !== addr.toLowerCase()) return `${name} <${addr}>`;
+  return addr;
+}
+
+function flattenMessage(raw: Record<string, unknown>): Record<string, unknown> {
+  const out: Record<string, unknown> = { ...raw };
+  const mid = raw.messageId;
+  if (mid != null) out.id = mid;
+  const fromStr = formatAddrField(raw.from);
+  if (fromStr) out.from = fromStr;
+  const toStr = formatAddrField(raw.to);
+  if (toStr) out.to = toStr;
+  return out;
+}
+
+interface TempMailResponse {
+  code?: number;
+  msg?: string;
+  data?: { mailName?: string; endTime?: number };
+}
+
+export async function generateEmail(domain?: string | null): Promise<InternalEmailInfo> {
+  const emailName = localPartFromDomainOption(domain ?? null);
+  const res = await fetchWithTimeout(
+    `${ORIGIN}/api/tempMail`,
+    {
+      method: 'POST',
+      headers: {
+        ...JSON_HEADERS,
+        'User-Agent':
+          'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0',
+      },
+      body: JSON.stringify({ emailName }),
+    },
+    undefined,
+    { skipTlsVerify: true },
+  );
+  if (!res.ok) {
+    throw new Error(`10mail-wangtz generate: ${res.status}`);
+  }
+  const parsed = (await res.json()) as TempMailResponse;
+  if (parsed.code !== 0 || !parsed.data?.mailName) {
+    throw new Error(`10mail-wangtz: ${String(parsed.msg ?? 'create failed')}`);
+  }
+  const local = String(parsed.data.mailName).trim();
+  if (!local) {
+    throw new Error('10mail-wangtz: empty mailName');
+  }
+  const email = `${local}@${MAIL_DOMAIN}`;
+  let expiresAt: string | undefined;
+  if (parsed.data.endTime != null && Number.isFinite(parsed.data.endTime)) {
+    expiresAt = new Date(parsed.data.endTime).toISOString();
+  }
+  return {
+    channel: CHANNEL,
+    email,
+    token: '',
+    expiresAt,
+  };
+}
+
+export async function getEmails(email: string): Promise<Email[]> {
+  const res = await fetchWithTimeout(
+    `${ORIGIN}/api/emailList`,
+    {
+      method: 'POST',
+      headers: {
+        ...JSON_HEADERS,
+        'User-Agent':
+          'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0',
+      },
+      body: JSON.stringify({ emailName: email.trim() }),
+    },
+    undefined,
+    { skipTlsVerify: true },
+  );
+  if (!res.ok) {
+    throw new Error(`10mail-wangtz inbox: ${res.status}`);
+  }
+  const list = (await res.json()) as unknown;
+  if (!Array.isArray(list)) {
+    throw new Error('10mail-wangtz: inbox response is not an array');
+  }
+  return list.map(item => {
+    if (!item || typeof item !== 'object') {
+      return normalizeEmail({}, email);
+    }
+    return normalizeEmail(flattenMessage(item as Record<string, unknown>), email);
+  });
+}

package/src/providers/10minute-one.ts

@@ -0,0 +1,258 @@
+import { InternalEmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+import { fetchWithTimeout } from '../retry';
+
+const CHANNEL: Channel = '10minute-one';
+const SITE_ORIGIN = 'https://10minutemail.one';
+const API_BASE = 'https://web.10minutemail.one/api/v1';
+
+const JWT_RE = /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/;
+
+const DEFAULT_PAGE_HEADERS: Record<string, string> = {
+  Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+  'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8',
+  'Cache-Control': 'no-cache',
+  Pragma: 'no-cache',
+  DNT: '1',
+  'User-Agent':
+    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+};
+
+function extractNuxtDataArray(html: string): unknown[] {
+  const m = html.match(/<script[^>]*\bid="__NUXT_DATA__"[^>]*>([\s\S]*?)<\/script>/i);
+  if (!m) throw new Error('10minute-one: __NUXT_DATA__ not found');
+  return JSON.parse(m[1].trim()) as unknown[];
+}
+
+function resolveRef(arr: unknown[], value: unknown, depth = 0): unknown {
+  if (depth > 64) throw new Error('10minute-one: resolveRef too deep');
+  if (value == null) return value;
+  if (typeof value === 'number' && Number.isInteger(value) && value >= 0) {
+    if (value >= arr.length) return undefined;
+    return resolveRef(arr, arr[value], depth + 1);
+  }
+  return value;
+}
+
+function parseMailServiceTokenFromPayload(arr: unknown[]): string {
+  if (!Array.isArray(arr)) throw new Error('10minute-one: invalid __NUXT_DATA__');
+
+  for (let i = 0; i < Math.min(arr.length, 48); i++) {
+    const el = arr[i];
+    if (el && typeof el === 'object' && !Array.isArray(el) && 'mailServiceToken' in el) {
+      const t = resolveRef(arr, (el as Record<string, unknown>).mailServiceToken);
+      if (typeof t === 'string' && JWT_RE.test(t)) return t;
+    }
+  }
+  for (const el of arr) {
+    if (el && typeof el === 'object' && !Array.isArray(el) && 'mailServiceToken' in el) {
+      const t = resolveRef(arr, (el as Record<string, unknown>).mailServiceToken);
+      if (typeof t === 'string' && JWT_RE.test(t)) return t;
+    }
+  }
+  for (const el of arr) {
+    if (typeof el === 'string' && JWT_RE.test(el)) return el;
+  }
+  throw new Error('10minute-one: mailServiceToken not found');
+}
+
+function parseQuotedJsonArrayField(html: string, field: string): string[] {
+  const key = `${field}:"`;
+  const start = html.indexOf(key);
+  if (start < 0) return [];
+  const sliceStart = start + key.length;
+  if (html[sliceStart] !== '[') return [];
+  let depth = 0;
+  let j = sliceStart;
+  for (; j < html.length; j++) {
+    const c = html[j];
+    if (c === '[') depth++;
+    else if (c === ']') {
+      depth--;
+      if (depth === 0) {
+        j++;
+        break;
+      }
+    }
+  }
+  const raw = html.slice(sliceStart, j);
+  const unesc = raw.replace(/\\"/g, '"');
+  try {
+    const v = JSON.parse(unesc);
+    return Array.isArray(v) ? v.map(x => String(x)) : [];
+  } catch {
+    return [];
+  }
+}
+
+function parseEmailDomains(html: string): string[] {
+  const d = parseQuotedJsonArrayField(html, 'emailDomains');
+  return d.filter(Boolean);
+}
+
+function parseBlockedUsernames(html: string): Set<string> {
+  const list = parseQuotedJsonArrayField(html, 'blockedUsernames');
+  return new Set(list.map(s => s.toLowerCase()));
+}
+
+function randomRequestId(): string {
+  const a = new Uint8Array(16);
+  crypto.getRandomValues(a);
+  return [...a].map(b => b.toString(16).padStart(2, '0')).join('');
+}
+
+function b64DecodeUtf8(b64: string): string {
+  if (typeof Buffer !== 'undefined') {
+    return Buffer.from(b64, 'base64').toString('utf8');
+  }
+  const bin = atob(b64);
+  const bytes = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+  return new TextDecoder('utf-8').decode(bytes);
+}
+
+function b64UrlPayload(jwt: string): Record<string, unknown> | null {
+  const parts = jwt.split('.');
+  if (parts.length < 2) return null;
+  let b = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+  const pad = b.length % 4 ? '='.repeat(4 - (b.length % 4)) : '';
+  b += pad;
+  try {
+    return JSON.parse(b64DecodeUtf8(b)) as Record<string, unknown>;
+  } catch {
+    return null;
+  }
+}
+
+function jwtExpMs(jwt: string): number | undefined {
+  const p = b64UrlPayload(jwt);
+  const exp = p?.exp;
+  if (typeof exp === 'number' && Number.isFinite(exp)) return Math.floor(exp * 1000);
+  return undefined;
+}
+
+function randomLocal(len: number): string {
+  const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+  const a = new Uint8Array(len);
+  crypto.getRandomValues(a);
+  let s = '';
+  for (let i = 0; i < len; i++) s += chars[a[i] % chars.length];
+  return s;
+}
+
+function pickLocale(domain?: string | null): string {
+  const s = String(domain ?? '').trim();
+  if (!s) return 'zh';
+  if (s.includes('.') && !s.includes('/')) return 'zh';
+  return s;
+}
+
+function pickMailboxDomain(domainHint: string | undefined, available: string[]): string {
+  if (!available.length) throw new Error('10minute-one: no email domains in page');
+  const h = (domainHint ?? '').trim().toLowerCase();
+  if (h.includes('.')) {
+    for (const d of available) {
+      if (d.toLowerCase() === h) return d;
+    }
+  }
+  return available[Math.floor(Math.random() * available.length)]!;
+}
+
+function apiHeaders(token: string, extra?: Record<string, string>): Record<string, string> {
+  const ts = String(Math.floor(Date.now() / 1000));
+  return {
+    Accept: '*/*',
+    'Accept-Language': DEFAULT_PAGE_HEADERS['Accept-Language']!,
+    Authorization: `Bearer ${token}`,
+    'Cache-Control': 'no-cache',
+    'Content-Type': 'application/json',
+    DNT: '1',
+    Origin: SITE_ORIGIN,
+    Pragma: 'no-cache',
+    Referer: `${SITE_ORIGIN}/`,
+    'Sec-Fetch-Dest': 'empty',
+    'Sec-Fetch-Mode': 'cors',
+    'Sec-Fetch-Site': 'same-site',
+    'User-Agent': DEFAULT_PAGE_HEADERS['User-Agent']!,
+    'X-Request-ID': randomRequestId(),
+    'X-Timestamp': ts,
+    ...extra,
+  };
+}
+
+function encMailboxPath(email: string): string {
+  return encodeURIComponent(email);
+}
+
+function itemNeedsDetail(item: Record<string, unknown>): boolean {
+  const id = item.id;
+  if (id == null || String(id).trim() === '') return false;
+  const subj = String(item.subject ?? item.mail_title ?? '').trim();
+  const body = String(item.text ?? item.body ?? item.html ?? item.mail_text ?? '').trim();
+  return subj === '' && body === '';
+}
+
+export async function generateEmail(domain?: string | null): Promise<InternalEmailInfo> {
+  const locale = pickLocale(domain ?? undefined);
+  const pageUrl = `${SITE_ORIGIN}/${encodeURIComponent(locale)}`;
+  const res = await fetchWithTimeout(pageUrl, { headers: { ...DEFAULT_PAGE_HEADERS, Referer: pageUrl } });
+  if (!res.ok) throw new Error(`10minute-one generate: ${res.status}`);
+  const html = await res.text();
+  const arr = extractNuxtDataArray(html);
+  const token = parseMailServiceTokenFromPayload(arr);
+  let domains = parseEmailDomains(html);
+  if (domains.length === 0) {
+    domains = ['xghff.com', 'oqqaj.com', 'psovv.com'];
+  }
+  const blocked = parseBlockedUsernames(html);
+  const domainHint = (domain ?? '').trim().includes('.') ? (domain ?? '').trim() : undefined;
+  const mailDomain = pickMailboxDomain(domainHint, domains);
+
+  let local = '';
+  for (let attempt = 0; attempt < 32; attempt++) {
+    const cand = randomLocal(10);
+    if (!blocked.has(cand.toLowerCase())) {
+      local = cand;
+      break;
+    }
+  }
+  if (!local) throw new Error('10minute-one: could not pick username');
+
+  const address = `${local}@${mailDomain}`;
+  const expMs = jwtExpMs(token);
+  return {
+    channel: CHANNEL,
+    email: address,
+    token,
+    expiresAt: expMs,
+  };
+}
+
+export async function getEmails(email: string, token: string): Promise<Email[]> {
+  const url = `${API_BASE}/mailbox/${encMailboxPath(email)}`;
+  const res = await fetchWithTimeout(url, { headers: apiHeaders(token) });
+  if (!res.ok) throw new Error(`10minute-one inbox: ${res.status}`);
+  const list = (await res.json()) as unknown;
+  if (!Array.isArray(list)) throw new Error('10minute-one: invalid inbox JSON');
+
+  const out: Email[] = [];
+  for (const raw of list) {
+    if (!raw || typeof raw !== 'object') continue;
+    let row = raw as Record<string, unknown>;
+    if (itemNeedsDetail(row)) {
+      const id = encodeURIComponent(String(row.id));
+      const du = `${API_BASE}/mailbox/${encMailboxPath(email)}/${id}`;
+      const dr = await fetchWithTimeout(du, { headers: apiHeaders(token) });
+      if (dr.ok) {
+        try {
+          const detail = (await dr.json()) as Record<string, unknown>;
+          row = { ...row, ...detail };
+        } catch {
+          /* keep row */
+        }
+      }
+    }
+    out.push(normalizeEmail(row, email));
+  }
+  return out;
+}