tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/tempmail_fyi.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # temp-mail.fyi 临时邮箱渠道
+    # GET / 获取 PHPSESSID cookie + CSRF token
+    # POST /api/generate_email.php 创建邮箱
+    # POST /api/get_emails.php 获取邮件列表
+    module TempmailFyi
+      CHANNEL = "tempmail-fyi"
+      BASE_URL = "https://temp-mail.fyi"
+      TOK_PREFIX = "tmf1:"
+
+      CSRF_RE = /csrfToken"\s*value="([^"]+)"/
+
+      UA = "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"
+
+      module_function
+
+      def browser_headers
+        {
+          "User-Agent" => UA,
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
+          "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7"
+        }
+      end
+
+      def api_headers(csrf, cookie_hdr)
+        h = {
+          "User-Agent" => UA,
+          "Accept" => "application/json, text/javascript, */*; q=0.01",
+          "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7",
+          "Content-Type" => "application/json",
+          "X-CSRF-Token" => csrf,
+          "X-Requested-With" => "XMLHttpRequest",
+          "Referer" => "#{BASE_URL}/"
+        }
+        h["Cookie"] = cookie_hdr unless cookie_hdr.empty?
+        h
+      end
+
+      def extract_cookie_header(resp)
+        cookies = {}
+        resp.set_cookies.each do |line|
+          pair = line.split(";").first.to_s.strip
+          k, v = pair.split("=", 2)
+          cookies[k] = v if k && v
+        end
+        cookies.sort.map { |k, v| "#{k}=#{v}" }.join("; ")
+      end
+
+      def encode_token(csrf, cookie_hdr)
+        raw = JSON.generate({ "t" => csrf, "c" => cookie_hdr })
+        "#{TOK_PREFIX}#{Base64.strict_encode64(raw)}"
+      end
+
+      def decode_token(token)
+        raise "tempmail-fyi: 无效的 token" unless token&.start_with?(TOK_PREFIX)
+
+        data = JSON.parse(Base64.decode64(token[TOK_PREFIX.length..]))
+        csrf = (data["t"] || "").strip
+        cookie_hdr = (data["c"] || "").strip
+        raise "tempmail-fyi: token 中缺少 CSRF" if csrf.empty?
+
+        [csrf, cookie_hdr]
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}/", headers: browser_headers)
+        resp.raise_for_status
+
+        cookie_hdr = extract_cookie_header(resp)
+        m = resp.body.match(CSRF_RE)
+        raise "tempmail-fyi: 未能从首页提取 CSRF token" unless m
+
+        csrf = m[1]
+
+        resp2 = Http.post("#{BASE_URL}/api/generate_email.php",
+                          headers: api_headers(csrf, cookie_hdr), body: "{}")
+        resp2.raise_for_status
+        data = resp2.json
+        raise "tempmail-fyi: 创建邮箱响应格式异常" unless data.is_a?(Hash)
+        raise "tempmail-fyi: 创建邮箱失败" unless data["success"]
+
+        email = (data["email_address"] || "").strip
+        raise "tempmail-fyi: 获取到的邮箱地址无效" if email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: encode_token(csrf, cookie_hdr),
+                      expires_at: data["expires_at"])
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = (email || "").strip
+        raise "tempmail-fyi: 邮箱地址为空" if addr.empty?
+
+        csrf, cookie_hdr = decode_token((token || "").strip)
+
+        resp = Http.post("#{BASE_URL}/api/get_emails.php",
+                         headers: api_headers(csrf, cookie_hdr),
+                         body: JSON.generate({ "email_address" => addr }))
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmail-fyi: 邮件列表响应格式异常" unless data.is_a?(Hash)
+
+        emails = data["emails"]
+        return [] unless emails.is_a?(Array) && !emails.empty?
+
+        emails.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          Normalize.normalize_email(item, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail_lol.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # tempmail.lol 渠道实现
+    # API: https://api.tempmail.lol/v2
+    module TempmailLol
+      CHANNEL = "tempmail-lol"
+      BASE_URL = "https://api.tempmail.lol/v2"
+      DEFAULT_HEADERS = {
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36",
+        "Content-Type" => "application/json",
+        "Origin" => "https://tempmail.lol",
+        "DNT" => "1"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱，支持指定域名
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        resp = Http.post("#{BASE_URL}/inbox/create", headers: DEFAULT_HEADERS,
+                                                     json: { "domain" => domain, "captcha" => nil })
+        resp.raise_for_status
+        data = resp.json
+        raise "Failed to generate email" if data["address"].to_s.empty? || data["token"].to_s.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: data["address"], token: data["token"])
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        resp = Http.get("#{BASE_URL}/inbox?token=#{URI.encode_www_form_component(token)}", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        (resp.json["emails"] || []).map { |raw| Normalize.normalize_email(raw, email) }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail_lol_v2.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # tempmail.lol V2 渠道 — https://api.tempmail.lol
+    # GET /generate 创建邮箱，GET /auth/{token} 获取邮件
+    module TempmailLolV2
+      CHANNEL = "tempmail-lol-v2"
+      API_BASE = "https://api.tempmail.lol"
+      HEADERS = {
+        "Accept" => "application/json",
+        "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"
+      }.freeze
+
+      module_function
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{API_BASE}/generate", headers: HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmail-lol-v2: 缺少 address 或 token" if (data["address"] || "").empty? || (data["token"] || "").empty?
+
+        EmailInfo.new(channel: CHANNEL, email: data["address"], token: data["token"])
+      end
+
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        resp = Http.get("#{API_BASE}/auth/#{URI.encode_www_form_component(token)}", headers: HEADERS)
+        resp.raise_for_status
+        data = resp.json
+
+        mail_list = data["email"] || []
+        return [] unless mail_list.is_a?(Array)
+
+        mail_list.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          normalized = {
+            "id" => raw["id"] || raw["_id"] || "",
+            "from" => raw["from"] || raw["sender"] || "",
+            "to" => email,
+            "subject" => raw["subject"] || "",
+            "text" => raw["body"] || raw["text"] || "",
+            "html" => raw["html"] || raw["body"] || "",
+            "date" => raw["date"] || raw["receivedAt"] || ""
+          }
+          Normalize.normalize_email(normalized, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail_plus.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # TempMail Plus 渠道 — https://tempmail.plus
+    # 无需认证的简单 REST API，默认域名 mailto.plus
+    module TempmailPlus
+      CHANNEL = "tempmail-plus"
+      API_BASE = "https://tempmail.plus/api/mails"
+      DOMAIN = "mailto.plus"
+      HEADERS = {
+        "Accept" => "application/json",
+        "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",
+        "Referer" => "https://tempmail.plus/",
+        "Origin" => "https://tempmail.plus"
+      }.freeze
+
+      module_function
+
+      def random_local(length = 12)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 创建 tempmail-plus 临时邮箱
+      # @param domain [String]
+      # @param channel [String]
+      # @return [EmailInfo]
+      def generate_email(domain = DOMAIN, channel = CHANNEL)
+        selected_domain = (domain || DOMAIN).to_s.strip
+        selected_domain = DOMAIN if selected_domain.empty?
+        selected_channel = (channel || CHANNEL).to_s.strip
+        selected_channel = CHANNEL if selected_channel.empty?
+        email = "#{random_local}@#{selected_domain}"
+        # 调用列表接口验证地址可用
+        Http.get("#{API_BASE}/?email=#{email}&epin=", headers: HEADERS, timeout: 15).raise_for_status
+        EmailInfo.new(channel: selected_channel, email: email)
+      end
+
+      def fetch_body(mail_id, email)
+        return {} unless mail_id && mail_id != 0
+
+        resp = Http.get("#{API_BASE}/#{mail_id}?email=#{email}&epin=", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        data.is_a?(Hash) ? data : {}
+      rescue StandardError
+        {}
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        e = email.to_s.strip
+        raise "tempmail-plus: 邮箱地址为空" if e.empty?
+
+        resp = Http.get("#{API_BASE}/?email=#{e}&epin=", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        rows = data["mail_list"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map do |raw|
+          mail_id = raw["mail_id"] || 0
+          detail = fetch_body(mail_id, e)
+          flat = {
+            "id" => mail_id != 0 ? mail_id.to_s : "",
+            "from" => raw["from_mail"] || raw["from_name"] || "",
+            "to" => e, "subject" => raw["subject"] || "", "date" => raw["time"] || "",
+            "html" => detail["html"] || "", "text" => detail["text"] || "",
+            "isRead" => !(raw["is_new"].nil? ? true : raw["is_new"])
+          }
+          Normalize.normalize_email(flat, e)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmailc.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # TempMailC 渠道实现
+    # API: https://tempmailc.com/api/v1
+    module Tempmailc
+      CHANNEL = "tempmailc"
+      API_BASE = "https://tempmailc.com/api/v1"
+      HEADERS = { "Accept" => "application/json" }.freeze
+
+      module_function
+
+      # 扁平化列表消息（无正文时使用）
+      def flatten_list_message(raw, recipient)
+        {
+          "id" => raw["id"],
+          "from" => raw["from"],
+          "to" => recipient,
+          "subject" => raw["subject"] || "",
+          "timestamp" => raw["ts"],
+          "read" => raw["read"]
+        }
+      end
+
+      # 获取单封邮件详情
+      def fetch_message(email, message_id)
+        resp = Http.get(
+          "#{API_BASE}/message?email=#{URI.encode_www_form_component(email)}&msg_id=#{URI.encode_www_form_component(message_id)}",
+          headers: HEADERS, timeout: 15
+        )
+        return nil unless resp.ok?
+
+        data = resp.json
+        return nil unless data.is_a?(Hash) && data["ok"] != false
+
+        data
+      rescue StandardError
+        nil
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{API_BASE}/new", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        email = data.is_a?(Hash) ? data["email"].to_s.strip : ""
+        raise "tempmailc: 无效的响应" unless data.is_a?(Hash) && data["ok"] && !email.empty? && email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "tempmailc: 邮箱地址为空" if address.empty?
+
+        resp = Http.get(
+          "#{API_BASE}/inbox?email=#{URI.encode_www_form_component(address)}",
+          headers: HEADERS, timeout: 15
+        )
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmailc: inbox 响应失败" unless data.is_a?(Hash) && data["ok"]
+
+        rows = data["messages"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |item| item.is_a?(Hash) }.map do |item|
+          mid = item["id"].to_s.strip
+          detail = mid.empty? ? nil : fetch_message(address, mid)
+          Normalize.normalize_email(detail || flatten_list_message(item, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmailpro.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # TempMail Pro 渠道 — https://tempmailpro.us
+    # POST /api/v1/mailbox/create 创建邮箱，GET /api/v1/mailbox/{token}/emails 获取邮件
+    module Tempmailpro
+      CHANNEL = "tempmailpro"
+      API_BASE = "https://tempmailpro.us/api/v1"
+      HEADERS = { "Accept" => "application/json", "User-Agent" => "Mozilla/5.0" }.freeze
+
+      module_function
+
+      def flatten(raw, recipient)
+        {
+          "id" => raw["id"] || raw["message_id"],
+          "from" => raw["from_address"] || raw["from_name"],
+          "to" => recipient,
+          "subject" => raw["subject"],
+          "text" => raw["body_text"],
+          "html" => raw["body_html"],
+          "date" => raw["received_at"],
+          "attachments" => raw["attachments"]
+        }
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{API_BASE}/mailbox/create",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: {}, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmailpro: 创建邮箱响应无效" unless data.is_a?(Hash)
+
+        box = data["data"] || {}
+        raise "tempmailpro: 创建邮箱响应无效" unless box.is_a?(Hash)
+
+        email = (box["address"] || "").strip
+        token = (box["token"] || "").strip
+        raise "tempmailpro: 创建邮箱响应无效" if email.empty? || !email.include?("@") || token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token,
+                      expires_at: box["expires_at"], created_at: box["created_at"])
+      end
+
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        mailbox_token = (token || "").strip
+        address = (email || "").strip
+        raise "tempmailpro: token 为空" if mailbox_token.empty?
+        raise "tempmailpro: 邮箱地址为空" if address.empty?
+
+        resp = Http.get("#{API_BASE}/mailbox/#{URI.encode_www_form_component(mailbox_token)}/emails",
+                        headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        rows = data["data"]
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          message_id = (item["id"] || "").to_s.strip
+          detail = nil
+          unless message_id.empty?
+            begin
+              dr = Http.get("#{API_BASE}/mailbox/#{URI.encode_www_form_component(mailbox_token)}/emails/#{URI.encode_www_form_component(message_id)}",
+                            headers: HEADERS, timeout: 15)
+              if dr.ok?
+                dd = dr.json
+                detail = dd["data"] if dd.is_a?(Hash) && dd["data"].is_a?(Hash)
+              end
+            rescue StandardError
+              # 忽略
+            end
+          end
+          Normalize.normalize_email(flatten(detail || item, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmailten.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # tempmailten.com 临时邮箱渠道（Laravel + CSRF）
+    # GET /en 获取 session cookie + CSRF token
+    # POST /messages 获取邮箱地址和邮件列表
+    # GET /view/{id} 获取单封邮件 HTML 正文
+    module Tempmailten
+      CHANNEL = "tempmailten"
+      BASE_URL = "https://tempmailten.com"
+      TOK_PREFIX = "tmt1:"
+
+      CSRF_RE = /<meta\s+name="csrf-token"\s+content="([^"]+)"/
+
+      UA = "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"
+
+      module_function
+
+      def browser_headers
+        {
+          "User-Agent" => UA,
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
+          "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7"
+        }
+      end
+
+      def ajax_headers
+        {
+          "User-Agent" => UA,
+          "Accept" => "application/json, text/javascript, */*; q=0.01",
+          "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7",
+          "X-Requested-With" => "XMLHttpRequest",
+          "Referer" => "#{BASE_URL}/en"
+        }
+      end
+
+      def extract_cookie_header(resp)
+        cookies = {}
+        resp.set_cookies.each do |line|
+          pair = line.split(";").first.to_s.strip
+          k, v = pair.split("=", 2)
+          cookies[k] = v if k && v
+        end
+        cookies.sort.map { |k, v| "#{k}=#{v}" }.join("; ")
+      end
+
+      def encode_token(csrf, cookie_hdr)
+        raw = JSON.generate({ "t" => csrf, "c" => cookie_hdr })
+        "#{TOK_PREFIX}#{Base64.strict_encode64(raw)}"
+      end
+
+      def decode_token(token)
+        raise "tempmailten: 无效的 token" unless token&.start_with?(TOK_PREFIX)
+
+        data = JSON.parse(Base64.decode64(token[TOK_PREFIX.length..]))
+        csrf = (data["t"] || "").strip
+        cookie_hdr = (data["c"] || "").strip
+        raise "tempmailten: token 中缺少 CSRF" if csrf.empty?
+
+        [csrf, cookie_hdr]
+      end
+
+      def post_messages(csrf, cookie_hdr)
+        headers = ajax_headers.merge(
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "X-CSRF-TOKEN" => csrf
+        )
+        headers["Cookie"] = cookie_hdr unless cookie_hdr.empty?
+
+        resp = Http.post("#{BASE_URL}/messages", headers: headers,
+                                                  body: "_token=#{URI.encode_www_form_component(csrf)}&captcha=")
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmailten: 解析响应 JSON 失败" unless data.is_a?(Hash)
+
+        data
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}/en", headers: browser_headers)
+        resp.raise_for_status
+
+        cookie_hdr = extract_cookie_header(resp)
+        m = resp.body.match(CSRF_RE)
+        raise "tempmailten: 未能从首页提取 CSRF token" unless m
+
+        csrf = m[1]
+        data = post_messages(csrf, cookie_hdr)
+        mailbox = (data["mailbox"] || "").strip
+        raise "tempmailten: 邮箱地址无效" if mailbox.empty? || !mailbox.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: mailbox, token: encode_token(csrf, cookie_hdr))
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = (email || "").strip
+        raise "tempmailten: 邮箱地址为空" if addr.empty?
+
+        csrf, cookie_hdr = decode_token((token || "").strip)
+        data = post_messages(csrf, cookie_hdr)
+
+        msgs = data["messages"]
+        return [] unless msgs.is_a?(Array) && !msgs.empty?
+
+        msgs.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          mid = (msg["id"] || "").to_s.strip
+          next if mid.empty?
+
+          from_addr = (msg["from_email"] || "").to_s
+          from_name = (msg["from"] || "").to_s
+          from_addr = "#{from_name} <#{from_addr}>" if !from_name.empty? && from_name != from_addr
+
+          raw = {
+            "id" => mid,
+            "from" => from_addr,
+            "to" => addr,
+            "subject" => msg["subject"] || "",
+            "html" => fetch_view(cookie_hdr, mid),
+            "isRead" => !!msg["is_seen"]
+          }
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+
+      def fetch_view(cookie_hdr, mid)
+        return "" if mid.nil? || mid.empty?
+
+        headers = browser_headers.merge("Referer" => "#{BASE_URL}/en")
+        headers["Cookie"] = cookie_hdr unless cookie_hdr.empty?
+        resp = Http.get("#{BASE_URL}/view/#{URI.encode_www_form_component(mid)}", headers: headers)
+        return "" unless resp.ok?
+
+        resp.body
+      rescue StandardError
+        ""
+      end
+    end
+  end
+end