tempmail-sdk 1.1.0 → 1.1.2

package/src/providers/tempmail.ts

@@ -1,4 +1,4 @@
-import { EmailInfo, Email, Channel } from '../types';
+import { InternalEmailInfo, Email, Channel } from '../types';
 import { normalizeEmail } from '../normalize';
 
 const CHANNEL: Channel = 'tempmail';
@@ -14,7 +14,7 @@ const DEFAULT_HEADERS = {
   'DNT': '1',
 };
 
-export async function generateEmail(duration: number = 30): Promise<EmailInfo> {
+export async function generateEmail(duration: number = 30): Promise<InternalEmailInfo> {
   const response = await fetch(`${BASE_URL}/generate`, {
     method: 'POST',
     headers: DEFAULT_HEADERS,
@@ -57,5 +57,29 @@ export async function getEmails(email: string): Promise<Email[]> {
   }
 
   const rawEmails = data.emails || [];
-  return rawEmails.map((raw: any) => normalizeEmail(raw, email));
+  return rawEmails.map((raw: any) => normalizeEmail(flattenMessage(raw, email), email));
+}
+
+/**
+ * 将 tempmail.ing 的原始邮件格式扁平化
+ *
+ * API 返回格式:
+ *   from_address: 发件人邮箱
+ *   content: HTML 内容（非纯文本）
+ *   text: 纯文本（通常为空）
+ *   received_at: 接收时间
+ *   is_read: 0/1
+ */
+function flattenMessage(raw: any, recipientEmail: string): any {
+  return {
+    id: raw.id ?? '',
+    from: raw.from_address || raw.from || '',
+    to: recipientEmail,
+    subject: raw.subject || '',
+    text: raw.text || '',
+    html: raw.content || raw.html || '',
+    date: raw.received_at || raw.date || '',
+    isRead: raw.is_read === 1 || raw.is_read === true,
+    attachments: raw.attachments || [],
+  };
 }

package/src/retry.ts

@@ -4,6 +4,7 @@
  */
 
 import { logger } from './logger';
+import { getConfig } from './config';
 
 /**
  * 重试配置选项
@@ -52,6 +53,11 @@ function defaultShouldRetry(error: any): boolean {
     return true;
   }
 
+  /* HTTP 429 限流 → 重试 */
+  if (message.includes('429') || message.includes('too many requests') || message.includes('rate limit')) {
+    return true;
+  }
+
   /* HTTP 4xx/5xx 错误 → 重试 */
   const statusMatch = message.match(/:\s*(\d{3})/);
   if (statusMatch) {
@@ -124,20 +130,25 @@ export async function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions)
 export async function fetchWithTimeout(
   url: string,
   init?: RequestInit,
-  timeoutMs: number = DEFAULT_RETRY_OPTIONS.timeout,
+  timeoutMs?: number,
 ): Promise<Response> {
+  const config = getConfig();
+  const effectiveTimeout = timeoutMs ?? config.timeout ?? DEFAULT_RETRY_OPTIONS.timeout;
   const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+  const timeoutId = setTimeout(() => controller.abort(), effectiveTimeout);
+
+  /* 使用自定义 fetch 或原生 fetch */
+  const fetchFn = config.customFetch || fetch;
 
   try {
-    const response = await fetch(url, {
+    const response = await fetchFn(url, {
       ...init,
       signal: controller.signal,
     });
     return response;
   } catch (error: any) {
     if (error.name === 'AbortError') {
-      throw new Error(`Request timeout after ${timeoutMs}ms: ${url}`);
+      throw new Error(`Request timeout after ${effectiveTimeout}ms: ${url}`);
     }
     throw error;
   } finally {

package/src/types.ts

@@ -6,21 +6,29 @@ export type Channel = 'tempmail' | 'linshi-email' | 'tempmail-lol' | 'chatgpt-or
 
 /**
  * 创建临时邮箱后返回的邮箱信息
- * 包含邮箱地址、认证令牌和生命周期信息
+ * Token 等认证信息由 SDK 内部维护，不对外暴露
  */
 export interface EmailInfo {
   /** 创建该邮箱所使用的渠道 */
   channel: Channel;
   /** 临时邮箱地址 */
   email: string;
-  /** 认证令牌，部分渠道在获取邮件时需要此令牌 */
-  token?: string;
   /** 邮箱过期时间（ISO 8601 字符串或 Unix 时间戳） */
   expiresAt?: string | number;
   /** 邮箱创建时间（ISO 8601 字符串） */
   createdAt?: string;
 }
 
+/**
+ * SDK 内部使用的邮箱信息，包含 token 等认证数据
+ * 不对外导出，用户无法访问
+ * @internal
+ */
+export interface InternalEmailInfo extends EmailInfo {
+  /** 认证令牌，由 SDK 内部维护 */
+  token?: string;
+}
+
 /**
  * 标准化邮件附件
  * 不同渠道的附件字段名不同，SDK 统一归一化为此结构
@@ -125,26 +133,18 @@ export interface GenerateEmailOptions {
 
 /**
  * 获取邮件列表的选项
+ * Channel/Email/Token 等由 SDK 从 EmailInfo 中自动获取，用户无需手动传递
  *
  * @example
  * ```ts
- * const result = await getEmails({
- *   channel: emailInfo.channel,
- *   email: emailInfo.email,
- *   token: emailInfo.token,
- * });
+ * const info = await generateEmail({ channel: 'mail-tm' });
+ * const result = await getEmails(info);
  * if (result.success && result.emails.length > 0) {
  *   console.log('收到邮件:', result.emails);
  * }
  * ```
  */
 export interface GetEmailsOptions {
-  /** 渠道标识，必填 */
-  channel: Channel;
-  /** 邮箱地址，必填 */
-  email: string;
-  /** 认证令牌 */
-  token?: string;
   /** 重试配置，不传则使用默认值（最多重试 2 次） */
   retry?: RetryConfig;
 }