tempmail-sdk 1.0.1 → 1.0.2

package/src/providers/awamail.ts

@@ -0,0 +1,101 @@
+import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+
+const CHANNEL: Channel = 'awamail';
+const BASE_URL = 'https://awamail.com/welcome';
+
+const DEFAULT_HEADERS: Record<string, string> = {
+  'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36 Edg/144.0.0.0',
+  'Accept': 'application/json, text/javascript, */*; q=0.01',
+  'accept-language': 'zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6',
+  'cache-control': 'no-cache',
+  'dnt': '1',
+  'origin': 'https://awamail.com',
+  'pragma': 'no-cache',
+  'referer': 'https://awamail.com/?lang=zh',
+  'sec-ch-ua': '"Not(A:Brand";v="8", "Chromium";v="144", "Microsoft Edge";v="144"',
+  'sec-ch-ua-mobile': '?0',
+  'sec-ch-ua-platform': '"Windows"',
+  'sec-fetch-dest': 'empty',
+  'sec-fetch-mode': 'cors',
+  'sec-fetch-site': 'same-origin',
+};
+
+/**
+ * 从 Set-Cookie 响应头中提取 awamail_session 值
+ */
+function extractSessionCookie(response: Response): string {
+  const setCookie = response.headers.get('set-cookie') || '';
+  const match = setCookie.match(/awamail_session=([^;]+)/);
+  return match ? `awamail_session=${match[1]}` : '';
+}
+
+/**
+ * 创建临时邮箱
+ * API: POST /welcome/change_mailbox (空 body)
+ * 返回: { success, data: { email_address, expired_at, created_at, ... } }
+ * 需要保存响应中的 Set-Cookie (awamail_session) 用于后续获取邮件
+ */
+export async function generateEmail(): Promise<EmailInfo> {
+  const response = await fetch(`${BASE_URL}/change_mailbox`, {
+    method: 'POST',
+    headers: {
+      ...DEFAULT_HEADERS,
+      'Content-Length': '0',
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to generate email: ${response.status}`);
+  }
+
+  // 提取 session cookie
+  const sessionCookie = extractSessionCookie(response);
+  if (!sessionCookie) {
+    throw new Error('Failed to extract session cookie');
+  }
+
+  const data = await response.json();
+
+  if (!data.success || !data.data) {
+    throw new Error('Failed to generate email');
+  }
+
+  return {
+    channel: CHANNEL,
+    email: data.data.email_address,
+    token: sessionCookie,
+    expiresAt: data.data.expired_at,
+    createdAt: data.data.created_at,
+  };
+}
+
+/**
+ * 获取邮件列表
+ * API: GET /welcome/get_emails
+ * 需要传入 Cookie (awamail_session) 和 x-requested-with 头
+ * 返回: { success, data: { emails: [...], latest: {...} } }
+ */
+export async function getEmails(token: string, email: string): Promise<Email[]> {
+  const response = await fetch(`${BASE_URL}/get_emails`, {
+    method: 'GET',
+    headers: {
+      ...DEFAULT_HEADERS,
+      'Cookie': token,
+      'x-requested-with': 'XMLHttpRequest',
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to get emails: ${response.status}`);
+  }
+
+  const data = await response.json();
+
+  if (!data.success || !data.data) {
+    throw new Error('Failed to get emails');
+  }
+
+  const rawEmails = data.data.emails || [];
+  return rawEmails.map((raw: any) => normalizeEmail(raw, email));
+}

package/src/providers/chatgpt-org-uk.ts

@@ -1,4 +1,5 @@
 import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
 
 const CHANNEL: Channel = 'chatgpt-org-uk';
 const BASE_URL = 'https://mail.chatgpt.org.uk/api';
@@ -53,5 +54,6 @@ export async function getEmails(email: string): Promise<Email[]> {
     throw new Error('Failed to get emails');
   }
 
-  return data.data?.emails || [];
+  const rawEmails = data.data?.emails || [];
+  return rawEmails.map((raw: any) => normalizeEmail(raw, email));
 }

package/src/providers/dropmail.ts

@@ -0,0 +1,98 @@
+import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+
+const CHANNEL: Channel = 'dropmail';
+const BASE_URL = 'https://dropmail.me/api/graphql/MY_TOKEN';
+
+const DEFAULT_HEADERS: Record<string, string> = {
+  'Content-Type': 'application/x-www-form-urlencoded',
+};
+
+const CREATE_SESSION_QUERY = 'mutation {introduceSession {id, expiresAt, addresses{id, address}}}';
+
+const GET_MAILS_QUERY = `query ($id: ID!) {
+  session(id:$id) {
+    mails {
+      id, rawSize, fromAddr, toAddr, receivedAt,
+      text, headerFrom, headerSubject, html
+    }
+  }
+}`;
+
+/**
+ * 执行 GraphQL 请求
+ */
+async function graphqlRequest(query: string, variables?: Record<string, any>): Promise<any> {
+  const params = new URLSearchParams();
+  params.set('query', query);
+  if (variables) {
+    params.set('variables', JSON.stringify(variables));
+  }
+
+  const response = await fetch(BASE_URL, {
+    method: 'POST',
+    headers: DEFAULT_HEADERS,
+    body: params.toString(),
+  });
+
+  if (!response.ok) {
+    throw new Error(`GraphQL request failed: ${response.status}`);
+  }
+
+  const data = await response.json();
+
+  if (data.errors) {
+    throw new Error(`GraphQL error: ${data.errors[0]?.message || 'Unknown error'}`);
+  }
+
+  return data.data;
+}
+
+/**
+ * 创建临时邮箱
+ * GraphQL mutation: introduceSession
+ * 返回 session ID (存入 token) 和邮箱地址
+ */
+export async function generateEmail(): Promise<EmailInfo> {
+  const data = await graphqlRequest(CREATE_SESSION_QUERY);
+
+  const session = data?.introduceSession;
+  if (!session || !session.addresses || session.addresses.length === 0) {
+    throw new Error('Failed to generate email');
+  }
+
+  return {
+    channel: CHANNEL,
+    email: session.addresses[0].address,
+    token: session.id,
+    expiresAt: session.expiresAt,
+  };
+}
+
+/**
+ * 将 dropmail 的邮件格式扁平化为 normalizeEmail 可处理的格式
+ */
+function flattenMessage(mail: any, recipientEmail: string): any {
+  return {
+    id: mail.id || '',
+    from: mail.fromAddr || '',
+    to: mail.toAddr || recipientEmail,
+    subject: mail.headerSubject || '',
+    text: mail.text || '',
+    html: mail.html || '',
+    received_at: mail.receivedAt || '',
+    attachments: [],
+  };
+}
+
+/**
+ * 获取邮件列表
+ * GraphQL query: session(id) { mails {...} }
+ * token 中存储的是 session ID
+ */
+export async function getEmails(token: string, email: string): Promise<Email[]> {
+  const data = await graphqlRequest(GET_MAILS_QUERY, { id: token });
+
+  const mails = data?.session?.mails || [];
+  return mails.map((mail: any) => normalizeEmail(flattenMessage(mail, email), email));
+}

package/src/providers/linshi-email.ts

@@ -1,4 +1,5 @@
 import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
 
 const CHANNEL: Channel = 'linshi-email';
 const BASE_URL = 'https://www.linshi-email.com/api/v1';
@@ -57,5 +58,6 @@ export async function getEmails(email: string): Promise<Email[]> {
     throw new Error('Failed to get emails');
   }
 
-  return data.list || [];
+  const rawEmails = data.list || [];
+  return rawEmails.map((raw: any) => normalizeEmail(raw, email));
 }

package/src/providers/mail-tm.ts

@@ -0,0 +1,188 @@
+import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+
+const CHANNEL: Channel = 'mail-tm';
+const BASE_URL = 'https://api.mail.tm';
+
+const DEFAULT_HEADERS: Record<string, string> = {
+  'Content-Type': 'application/json',
+  'Accept': 'application/json',
+};
+
+/**
+ * 生成随机字符串
+ */
+function randomString(length: number): string {
+  const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+  let result = '';
+  for (let i = 0; i < length; i++) {
+    result += chars[Math.floor(Math.random() * chars.length)];
+  }
+  return result;
+}
+
+/**
+ * 获取可用域名列表
+ * API: GET /domains
+ */
+async function getDomains(): Promise<string[]> {
+  const response = await fetch(`${BASE_URL}/domains`, {
+    method: 'GET',
+    headers: DEFAULT_HEADERS,
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to get domains: ${response.status}`);
+  }
+
+  const data = await response.json();
+  const members = data['hydra:member'] || [];
+  return members
+    .filter((d: any) => d.isActive)
+    .map((d: any) => d.domain);
+}
+
+/**
+ * 创建账号
+ * API: POST /accounts
+ */
+async function createAccount(address: string, password: string): Promise<any> {
+  const response = await fetch(`${BASE_URL}/accounts`, {
+    method: 'POST',
+    headers: { ...DEFAULT_HEADERS, 'Content-Type': 'application/ld+json' },
+    body: JSON.stringify({ address, password }),
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Failed to create account: ${response.status} ${text}`);
+  }
+
+  return response.json();
+}
+
+/**
+ * 获取 Bearer Token
+ * API: POST /token
+ */
+async function getToken(address: string, password: string): Promise<string> {
+  const response = await fetch(`${BASE_URL}/token`, {
+    method: 'POST',
+    headers: DEFAULT_HEADERS,
+    body: JSON.stringify({ address, password }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to get token: ${response.status}`);
+  }
+
+  const data = await response.json();
+  return data.token;
+}
+
+/**
+ * 创建临时邮箱
+ * 流程: 获取域名 → 生成随机邮箱/密码 → 创建账号 → 获取 Token
+ */
+export async function generateEmail(): Promise<EmailInfo> {
+  // 1. 获取可用域名
+  const domains = await getDomains();
+  if (domains.length === 0) {
+    throw new Error('No available domains');
+  }
+
+  // 2. 生成随机邮箱和密码
+  const domain = domains[Math.floor(Math.random() * domains.length)];
+  const username = randomString(12);
+  const address = `${username}@${domain}`;
+  const password = randomString(16);
+
+  // 3. 创建账号
+  const account = await createAccount(address, password);
+
+  // 4. 获取 Bearer Token
+  const token = await getToken(address, password);
+
+  return {
+    channel: CHANNEL,
+    email: address,
+    token: token,
+    createdAt: account.createdAt,
+  };
+}
+
+/**
+ * 将 mail.tm 的消息格式扁平化为 normalizeEmail 可处理的格式
+ * mail.tm 的 from 是 {name, address} 对象，to 是数组，html 是字符串数组
+ */
+function flattenMessage(msg: any, recipientEmail: string): any {
+  return {
+    id: msg.id || '',
+    from: msg.from?.address || '',
+    to: msg.to?.[0]?.address || recipientEmail,
+    subject: msg.subject || '',
+    text: msg.text || '',
+    html: Array.isArray(msg.html) ? msg.html.join('') : (msg.html || ''),
+    createdAt: msg.createdAt || '',
+    seen: msg.seen ?? false,
+    attachments: (msg.attachments || []).map((a: any) => ({
+      filename: a.filename || '',
+      size: a.size || undefined,
+      contentType: a.contentType || undefined,
+      downloadUrl: a.downloadUrl ? `${BASE_URL}${a.downloadUrl}` : undefined,
+    })),
+  };
+}
+
+/**
+ * 获取邮件列表
+ * 流程: GET /messages 获取列表 → 对每封邮件 GET /messages/{id} 获取详情（含 text/html）
+ */
+export async function getEmails(token: string, email: string): Promise<Email[]> {
+  // 1. 获取邮件列表
+  const listResponse = await fetch(`${BASE_URL}/messages`, {
+    method: 'GET',
+    headers: {
+      ...DEFAULT_HEADERS,
+      'Authorization': `Bearer ${token}`,
+    },
+  });
+
+  if (!listResponse.ok) {
+    throw new Error(`Failed to get emails: ${listResponse.status}`);
+  }
+
+  const listData = await listResponse.json();
+  const messages = listData['hydra:member'] || [];
+
+  if (messages.length === 0) {
+    return [];
+  }
+
+  // 2. 并行获取每封邮件的详情（含 text/html/attachments）
+  const detailPromises = messages.map(async (msg: any) => {
+    try {
+      const detailResponse = await fetch(`${BASE_URL}/messages/${msg.id}`, {
+        method: 'GET',
+        headers: {
+          ...DEFAULT_HEADERS,
+          'Authorization': `Bearer ${token}`,
+        },
+      });
+
+      if (!detailResponse.ok) {
+        // 如果详情获取失败，退回使用列表数据
+        return flattenMessage(msg, email);
+      }
+
+      const detail = await detailResponse.json();
+      return flattenMessage(detail, email);
+    } catch {
+      // 出错时退回使用列表数据
+      return flattenMessage(msg, email);
+    }
+  });
+
+  const flatMessages = await Promise.all(detailPromises);
+  return flatMessages.map((raw: any) => normalizeEmail(raw, email));
+}

package/src/providers/temp-mail-io.ts

@@ -0,0 +1,76 @@
+import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+
+const CHANNEL: Channel = 'temp-mail-io';
+const BASE_URL = 'https://api.internal.temp-mail.io/api/v3';
+
+const DEFAULT_HEADERS: Record<string, string> = {
+  'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36 Edg/144.0.0.0',
+  'Content-Type': 'application/json',
+  'accept-language': 'zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6',
+  'application-name': 'web',
+  'application-version': '4.0.0',
+  'cache-control': 'no-cache',
+  'dnt': '1',
+  'origin': 'https://temp-mail.io',
+  'pragma': 'no-cache',
+  'referer': 'https://temp-mail.io/',
+  'sec-ch-ua': '"Not(A:Brand";v="8", "Chromium";v="144", "Microsoft Edge";v="144"',
+  'sec-ch-ua-mobile': '?0',
+  'sec-ch-ua-platform': '"Windows"',
+  'sec-fetch-dest': 'empty',
+  'sec-fetch-mode': 'cors',
+  'sec-fetch-site': 'same-site',
+};
+
+/**
+ * 创建临时邮箱
+ * API: POST /api/v3/email/new
+ * 返回: { email, token }
+ */
+export async function generateEmail(): Promise<EmailInfo> {
+  const response = await fetch(`${BASE_URL}/email/new`, {
+    method: 'POST',
+    headers: DEFAULT_HEADERS,
+    body: JSON.stringify({ min_name_length: 100, max_name_length: 100 }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to generate email: ${response.status}`);
+  }
+
+  const data = await response.json();
+
+  if (!data.email || !data.token) {
+    throw new Error('Failed to generate email');
+  }
+
+  return {
+    channel: CHANNEL,
+    email: data.email,
+    token: data.token,
+  };
+}
+
+/**
+ * 获取邮件列表
+ * API: GET /api/v3/email/{email}/messages
+ * 返回: [ { id, from, to, cc, subject, body_text, body_html, created_at, attachments } ]
+ */
+export async function getEmails(email: string): Promise<Email[]> {
+  const encodedEmail = encodeURIComponent(email);
+  const response = await fetch(`${BASE_URL}/email/${encodedEmail}/messages`, {
+    method: 'GET',
+    headers: DEFAULT_HEADERS,
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to get emails: ${response.status}`);
+  }
+
+  const data = await response.json();
+
+  // API 直接返回邮件数组
+  const rawEmails = Array.isArray(data) ? data : [];
+  return rawEmails.map((raw: any) => normalizeEmail(raw, email));
+}

package/src/providers/tempmail-la.ts

@@ -0,0 +1,99 @@
+import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
+
+const CHANNEL: Channel = 'tempmail-la';
+const BASE_URL = 'https://tempmail.la/api';
+
+const DEFAULT_HEADERS: Record<string, string> = {
+  'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36 Edg/144.0.0.0',
+  'Accept': 'application/json, text/plain, */*',
+  'Content-Type': 'application/json',
+  'accept-language': 'zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6',
+  'cache-control': 'no-cache',
+  'dnt': '1',
+  'locale': 'zh-CN',
+  'origin': 'https://tempmail.la',
+  'platform': 'PC',
+  'pragma': 'no-cache',
+  'product': 'TEMP_MAIL',
+  'referer': 'https://tempmail.la/zh-CN/tempmail',
+  'sec-ch-ua': '"Not(A:Brand";v="8", "Chromium";v="144", "Microsoft Edge";v="144"',
+  'sec-ch-ua-mobile': '?0',
+  'sec-ch-ua-platform': '"Windows"',
+  'sec-fetch-dest': 'empty',
+  'sec-fetch-mode': 'cors',
+  'sec-fetch-site': 'same-origin',
+};
+
+/**
+ * 创建临时邮箱
+ * API: POST /api/mail/create
+ * 返回: { code: 0, data: { mailId, address, type, startAt, endAt } }
+ */
+export async function generateEmail(): Promise<EmailInfo> {
+  const response = await fetch(`${BASE_URL}/mail/create`, {
+    method: 'POST',
+    headers: DEFAULT_HEADERS,
+    body: JSON.stringify({ turnstile: '' }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to generate email: ${response.status}`);
+  }
+
+  const data = await response.json();
+
+  if (data.code !== 0 || !data.data) {
+    throw new Error('Failed to generate email');
+  }
+
+  return {
+    channel: CHANNEL,
+    email: data.data.address,
+    expiresAt: data.data.endAt,
+    createdAt: data.data.startAt,
+  };
+}
+
+/**
+ * 获取邮件列表
+ * API: POST /api/mail/box
+ * 请求: { address, cursor }
+ * 返回: { code: 0, data: { rows: [...], cursor, hasMore } }
+ * 每封邮件: { mailboxId, messageFrom, subject, createdAt, html, attachments, read }
+ */
+export async function getEmails(email: string): Promise<Email[]> {
+  const allEmails: any[] = [];
+  let cursor: string | null = null;
+  let hasMore = true;
+
+  // 支持分页，循环获取所有邮件
+  while (hasMore) {
+    const response: Response = await fetch(`${BASE_URL}/mail/box`, {
+      method: 'POST',
+      headers: DEFAULT_HEADERS,
+      body: JSON.stringify({ address: email, cursor }),
+    });
+
+    if (!response.ok) {
+      throw new Error(`Failed to get emails: ${response.status}`);
+    }
+
+    const data: any = await response.json();
+
+    if (data.code !== 0 || !data.data) {
+      throw new Error('Failed to get emails');
+    }
+
+    const rows = data.data.rows || [];
+    allEmails.push(...rows);
+
+    if (data.data.hasMore && data.data.cursor) {
+      cursor = data.data.cursor;
+    } else {
+      hasMore = false;
+    }
+  }
+
+  return allEmails.map((raw: any) => normalizeEmail(raw, email));
+}

package/src/providers/tempmail-lol.ts

@@ -1,4 +1,5 @@
 import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
 
 const CHANNEL: Channel = 'tempmail-lol';
 const BASE_URL = 'https://api.tempmail.lol/v2';
@@ -37,7 +38,7 @@ export async function generateEmail(domain: string | null = null): Promise<Email
   };
 }
 
-export async function getEmails(token: string): Promise<Email[]> {
+export async function getEmails(token: string, recipientEmail: string = ''): Promise<Email[]> {
   const response = await fetch(`${BASE_URL}/inbox?token=${encodeURIComponent(token)}`, {
     method: 'GET',
     headers: DEFAULT_HEADERS,
@@ -49,5 +50,6 @@ export async function getEmails(token: string): Promise<Email[]> {
 
   const data = await response.json();
   
-  return data.emails || [];
+  const rawEmails = data.emails || [];
+  return rawEmails.map((raw: any) => normalizeEmail(raw, recipientEmail));
 }

package/src/providers/tempmail.ts

@@ -1,4 +1,5 @@
 import { EmailInfo, Email, Channel } from '../types';
+import { normalizeEmail } from '../normalize';
 
 const CHANNEL: Channel = 'tempmail';
 const BASE_URL = 'https://api.tempmail.ing/api';
@@ -55,5 +56,6 @@ export async function getEmails(email: string): Promise<Email[]> {
     throw new Error('Failed to get emails');
   }
 
-  return data.emails || [];
+  const rawEmails = data.emails || [];
+  return rawEmails.map((raw: any) => normalizeEmail(raw, email));
 }