tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/throwawaymail.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # ThrowawayMail 渠道 — https://throwawaymail.app
+    # POST /api/mailboxes 创建邮箱，GET /api/mailboxes/{id}/messages 获取邮件
+    module Throwawaymail
+      CHANNEL = "throwawaymail"
+      API_BASE = "https://throwawaymail.app/api"
+      HEADERS = { "Accept" => "application/json" }.freeze
+
+      module_function
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{API_BASE}/mailboxes", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "throwawaymail: 创建邮箱响应无效" unless data.is_a?(Hash)
+
+        mailbox_id = (data["mailbox_id"] || "").strip
+        email = (data["address"] || "").strip
+        raise "throwawaymail: 创建邮箱响应无效" if mailbox_id.empty? || email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: mailbox_id,
+                      expires_at: data["expires_at"], created_at: data["created_at"])
+      end
+
+      # @param token [String] mailbox_id
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        mailbox_id = (token || "").strip
+        address = (email || "").strip
+        raise "throwawaymail: mailbox_id 为空" if mailbox_id.empty?
+        raise "throwawaymail: 邮箱地址为空" if address.empty?
+
+        resp = Http.get("#{API_BASE}/mailboxes/#{URI.encode_www_form_component(mailbox_id)}/messages",
+                        headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        rows = resp.json
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          message_id = (item["message_id"] || "").strip
+          detail = nil
+          unless message_id.empty?
+            begin
+              dr = Http.get("#{API_BASE}/mailboxes/#{URI.encode_www_form_component(mailbox_id)}/messages/#{URI.encode_www_form_component(message_id)}",
+                            headers: HEADERS, timeout: 15)
+              detail = dr.json if dr.ok? && dr.json.is_a?(Hash)
+            rescue StandardError
+              # 忽略
+            end
+          end
+
+          src = detail || item
+          to_addresses = src["to_addresses"]
+          to_val = to_addresses.is_a?(Array) && !to_addresses.empty? ? to_addresses[0] : address
+
+          raw = {
+            "id" => src["message_id"],
+            "from_address" => src["from_address"],
+            "fromName" => src["from_name"],
+            "to" => to_val,
+            "subject" => src["subject"] || "",
+            "received_at" => src["received_at"],
+            "text" => src["text"] || "",
+            "html" => src["html"] || ""
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tmail_link.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # tmail.link 临时邮箱渠道（Django CSRF）
+    # GET / 获取首页 HTML，正则提取邮箱地址
+    # GET /inbox/{email}/ 获取 csrftoken cookie
+    # POST /inbox/{email}/ 获取邮件列表（form: format=json + csrfmiddlewaretoken）
+    module TmailLink
+      CHANNEL = "tmail-link"
+      BASE_URL = "https://tmail.link"
+
+      EMAIL_RE = /([a-zA-Z0-9._%+\-]+@tmail\.link)/
+
+      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" => "zh-CN,zh;q=0.9,en;q=0.8"
+        }
+      end
+
+      def post_headers(email, token)
+        {
+          "User-Agent" => UA,
+          "Accept" => "application/json, text/javascript, */*; q=0.01",
+          "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+          "X-Requested-With" => "XMLHttpRequest",
+          "Content-Type" => "application/x-www-form-urlencoded; charset=UTF-8",
+          "Origin" => BASE_URL,
+          "Referer" => "#{BASE_URL}/inbox/#{email}/",
+          "Cookie" => "csrftoken=#{token}"
+        }
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}/", headers: browser_headers)
+        resp.raise_for_status
+
+        m = resp.body.match(EMAIL_RE)
+        raise "tmail-link: 未能从首页提取邮箱地址" unless m
+
+        email = m[1].strip
+        raise "tmail-link: 提取的邮箱地址为空" if email.empty?
+
+        resp2 = Http.get("#{BASE_URL}/inbox/#{email}/", headers: browser_headers)
+        resp2.raise_for_status
+
+        token = resp2.cookie_value("csrftoken")
+        raise "tmail-link: 未能获取 csrftoken" if token.nil? || token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = (email || "").strip
+        raise "tmail-link: 邮箱地址为空" if addr.empty?
+
+        csrf = (token || "").strip
+        raise "tmail-link: csrftoken 为空" if csrf.empty?
+
+        body = "format=json&csrfmiddlewaretoken=#{URI.encode_www_form_component(csrf)}"
+        resp = Http.post("#{BASE_URL}/inbox/#{addr}/",
+                         headers: post_headers(addr, csrf), body: body)
+        resp.raise_for_status
+
+        data = resp.json
+        raise "tmail-link: 邮件列表响应格式异常" unless data.is_a?(Hash)
+
+        messages = data["messages"]
+        return [] unless messages.is_a?(Array) && !messages.empty?
+
+        messages.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          raw = {
+            "id" => (item["key"] || "").to_s,
+            "from" => (item["sender"] || "").to_s,
+            "to" => addr,
+            "subject" => (item["subject"] || "").to_s,
+            "date" => (item["date"] || "").to_s
+          }
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/uncorreotemporal.rb

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

data/lib/tempmail_sdk/providers/webmailtemp.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # webmailtemp.com 临时邮箱渠道
+    # GET /api/create 创建邮箱
+    # GET /api/check/{username} 获取邮件列表
+    module Webmailtemp
+      CHANNEL = "webmailtemp"
+      BASE_URL = "https://webmailtemp.com"
+      TOK_PREFIX = "wmt1:"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0"
+      }.freeze
+
+      module_function
+
+      def encode_token(username, cookie_hdr)
+        raw = JSON.generate({ "u" => username, "c" => cookie_hdr })
+        "#{TOK_PREFIX}#{Base64.strict_encode64(raw)}"
+      end
+
+      def decode_token(token)
+        raise "webmailtemp: 无效的 token" unless token&.start_with?(TOK_PREFIX)
+
+        data = JSON.parse(Base64.decode64(token[TOK_PREFIX.length..]))
+        username = (data["u"] || "").strip
+        cookie_hdr = (data["c"] || "").strip
+        raise "webmailtemp: token 数据无效" if username.empty? || cookie_hdr.empty?
+
+        { "username" => username, "cookie" => cookie_hdr }
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}/api/create", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "webmailtemp: 创建邮箱响应无效" unless data.is_a?(Hash)
+
+        email = (data["email"] || "").strip
+        username = (data["username"] || "").strip
+
+        # 从 set_cookies 提取第一个 cookie
+        cookie_hdr = ""
+        cookies = resp.set_cookies
+        unless cookies.empty?
+          pair = cookies.first.split(";").first.to_s.strip
+          cookie_hdr = pair unless pair.empty?
+        end
+
+        unless data["success"] && !email.empty? && email.include?("@") && !username.empty? && !cookie_hdr.empty?
+          raise "webmailtemp: 创建邮箱响应无效"
+        end
+
+        expires_at = nil
+        ttl = data["ttl"]
+        if ttl.is_a?(Numeric) && ttl > 0
+          expires_at = ((Time.now.to_f + ttl) * 1000).to_i
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: encode_token(username, cookie_hdr),
+                      expires_at: expires_at)
+      end
+
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        address = (email || "").strip
+        raise "webmailtemp: 邮箱地址为空" if address.empty?
+
+        session = decode_token((token || "").strip)
+        headers = HEADERS.merge("Cookie" => session["cookie"])
+
+        resp = Http.get("#{BASE_URL}/api/check/#{URI.encode_www_form_component(session["username"])}",
+                        headers: headers, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+
+        rows = data.is_a?(Hash) ? data["emails"] : nil
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |row|
+          next unless row.is_a?(Hash)
+
+          raw = {
+            "id" => row["id"],
+            "from" => row["from"],
+            "to" => address,
+            "subject" => row["subject"],
+            "text" => row["body"],
+            "html" => row["html"],
+            "date" => row["received_at"] || row["timestamp"],
+            "attachments" => row["attachments"]
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/xkx_me.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # xkx.me 临时邮箱渠道（CSRF + session cookie）
+    # GET / 获取 CSRF token + session cookie
+    # POST /mailbox/create/random 创建邮箱（不跟随重定向，从 Location 提取邮箱）
+    # GET /mailbox/{email}/messages 获取邮件列表
+    module XkxMe
+      CHANNEL = "xkx-me"
+      BASE_URL = "https://xkx.me"
+
+      CSRF_RE = /csrf-token"\s+content="([^"]+)"/
+
+      HEADERS = {
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
+      }.freeze
+
+      module_function
+
+      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
+
+      # @return [EmailInfo]
+      def generate_email
+        # 获取 CSRF token 和 session cookie
+        resp = Http.get(BASE_URL, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+
+        m = resp.body.match(CSRF_RE)
+        raise "xkx-me: 无法获取 CSRF token" unless m
+
+        csrf = m[1]
+        cookie_hdr = extract_cookie_header(resp)
+
+        # POST 创建邮箱（不跟随重定向）
+        post_headers = HEADERS.merge(
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Referer" => "#{BASE_URL}/"
+        )
+        post_headers["Cookie"] = cookie_hdr unless cookie_hdr.empty?
+
+        body = "_token=#{URI.encode_www_form_component(csrf)}"
+        resp2 = Http.post("#{BASE_URL}/mailbox/create/random",
+                          headers: post_headers, body: body, timeout: 15)
+
+        # 从 Location 头提取邮箱地址（302 重定向）
+        location = resp2.header("Location") || ""
+        email_match = location.match(/mailbox\/([^\/"'<>\s]+@xkx\.me)/)
+        raise "xkx-me: 无法从响应中提取邮箱地址" unless email_match
+
+        email = email_match[1]
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: cookie_hdr)
+      end
+
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        address = (email || "").strip
+        raise "xkx-me: 缺少邮箱地址" if address.empty?
+
+        cookie_str = (token || "").strip
+
+        headers = HEADERS.merge(
+          "Accept" => "application/json",
+          "X-Requested-With" => "XMLHttpRequest"
+        )
+        headers["Cookie"] = cookie_str unless cookie_str.empty?
+
+        encoded_email = URI.encode_www_form_component(address).gsub("%40", "@")
+        resp = Http.get("#{BASE_URL}/mailbox/#{encoded_email}/messages",
+                        headers: headers, timeout: 15)
+        return [] if resp.status_code == 404
+
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data
+
+        message_list = if data.is_a?(Array)
+                         data
+                       elsif data.is_a?(Hash)
+                         if data.key?("messages")
+                           data["messages"]
+                         elsif data["message"].is_a?(Hash)
+                           [data["message"]]
+                         else
+                           []
+                         end
+                       else
+                         []
+                       end
+
+        return [] unless message_list.is_a?(Array)
+
+        message_list.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          raw = {
+            "id" => (msg["id"] || "").to_s,
+            "from" => (msg["from"] || "").to_s,
+            "to" => address,
+            "subject" => (msg["subject"] || "").to_s,
+            "date" => (msg["date"] || "").to_s,
+            "html" => (msg["html"] || msg["body"] || "").to_s,
+            "text" => (msg["text"] || "").to_s,
+            "is_read" => false,
+            "attachments" => []
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end