tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/dropmail_me.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "securerandom"
+require "time"
+
+module TempmailSdk
+  module Providers
+    # dropmail-me 渠道 — https://dropmail.me
+    # GraphQL 临时邮箱，需从页面提取 data-k 生成认证 token
+    module DropmailMe
+      CHANNEL = "dropmail-me"
+      BASE_URL = "https://dropmail.me"
+
+      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",
+        "Accept" => "application/json",
+        "Content-Type" => "application/json"
+      }.freeze
+
+      module_function
+
+      # FNV-1a 变体哈希
+      def fnv_hash(s)
+        h = 2_166_136_261
+        s.each_char do |c|
+          h ^= c.ord
+          h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24)
+          h &= 0xFFFFFFFF
+        end
+        h.to_s(16)
+      end
+
+      # 生成 dropmail.me API 认证 token
+      def generate_auth_token
+        resp = Http.get("#{BASE_URL}/en/", headers: {
+          "User-Agent" => HEADERS["User-Agent"],
+          "Accept" => "text/html"
+        }, timeout: 15)
+        resp.raise_for_status
+
+        match = resp.body.match(/<meta\s+name="app-config"\s+data-k="([^"]+)"/)
+        raise "dropmail-me: 无法从页面提取 data-k" unless match
+
+        data_k = match[1]
+        # 反转 + base64 解码得到 secret
+        _secret = Base64.decode64(data_k.reverse)
+
+        # 生成随机部分
+        date_str = Time.now.utc.strftime("%Y%m%d")
+        random_part = date_str + SecureRandom.alphanumeric(16)
+
+        # 计算哈希
+        hash_input = random_part + _secret
+        h = fnv_hash(hash_input)
+
+        "website_#{random_part}_#{h}"
+      end
+
+      # 创建 dropmail.me 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        auth_token = generate_auth_token
+
+        query = "mutation { introduceSession { id expiresAt addresses { address } } }"
+        resp = Http.post(
+          "#{BASE_URL}/api/graphql/#{auth_token}",
+          headers: HEADERS,
+          json: { "query" => query },
+          timeout: 15
+        )
+        resp.raise_for_status
+        data = resp.json
+
+        session_data = (data["data"] || {})[" introduceSession"] || (data["data"] || {})["introduceSession"]
+        raise "dropmail-me: 创建 session 失败" unless session_data
+
+        session_id = session_data["id"] || ""
+        addresses = session_data["addresses"] || []
+        raise "dropmail-me: 响应中缺少 session ID 或地址" if session_id.empty? || addresses.empty?
+
+        address = addresses[0]["address"] || ""
+        raise "dropmail-me: 地址为空" if address.empty?
+
+        # Token 序列化为 JSON
+        composite_token = JSON.generate({
+          "session_id" => session_id,
+          "auth_token" => auth_token
+        })
+
+        # 解析过期时间
+        expires_at = nil
+        expires_str = session_data["expiresAt"]
+        if expires_str
+          begin
+            dt = Time.parse(expires_str.sub("Z", "+00:00"))
+            expires_at = (dt.to_f * 1000).to_i
+          rescue ArgumentError, TypeError
+            # 忽略解析失败
+          end
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: address, token: composite_token, expires_at: expires_at)
+      end
+
+      # 获取邮件列表
+      # @param token [String] JSON {"session_id":"...","auth_token":"..."}
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        raise "dropmail-me: token 不能为空" if token.nil? || token.to_s.empty?
+
+        addr = (email || "").strip
+        raise "dropmail-me: 邮箱地址不能为空" if addr.empty?
+
+        # 解析复合 token
+        begin
+          token_data = JSON.parse(token)
+        rescue JSON::ParserError
+          raise "dropmail-me: token 格式无效"
+        end
+
+        session_id = token_data["session_id"] || ""
+        auth_token = token_data["auth_token"] || ""
+        raise "dropmail-me: token 中缺少 session_id 或 auth_token" if session_id.empty? || auth_token.empty?
+
+        # 查询邮件
+        query = "{ session(id:\"#{session_id}\") { mails { id headerFrom headerSubject text html receivedAt } } }"
+        resp = Http.post(
+          "#{BASE_URL}/api/graphql/#{auth_token}",
+          headers: HEADERS,
+          json: { "query" => query },
+          timeout: 15
+        )
+        resp.raise_for_status
+        data = resp.json
+
+        session_resp = (data["data"] || {})["session"]
+        return [] unless session_resp
+
+        mails = session_resp["mails"]
+        return [] unless mails.is_a?(Array) && !mails.empty?
+
+        mails.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          raw = {
+            "id" => msg["id"] || "",
+            "from" => msg["headerFrom"] || "",
+            "to" => addr,
+            "subject" => msg["headerSubject"] || "",
+            "text" => msg["text"] || "",
+            "html" => msg["html"] || "",
+            "date" => msg["receivedAt"] || ""
+          }
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/duckmail.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # DuckMail 渠道实现（与 mail.tm 同构 API）
+    # API: https://api.duckmail.sbs
+    module Duckmail
+      CHANNEL = "duckmail"
+      BASE_URL = "https://api.duckmail.sbs"
+      DEFAULT_HEADERS = {
+        "Content-Type" => "application/json",
+        "Accept" => "application/json",
+        "Origin" => "https://duckmail.sbs",
+        "Referer" => "https://duckmail.sbs/"
+      }.freeze
+
+      module_function
+
+      def random_string(length)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      def fetch_domains
+        resp = Http.get("#{BASE_URL}/domains?page=1", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        members = data.is_a?(Array) ? data : (data["hydra:member"] || [])
+        members.select { |d| d["isActive"] }.map { |d| d["domain"] }
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        domains = fetch_domains
+        raise "No available domains" if domains.empty?
+
+        address = "#{random_string(12)}@#{domains.sample}"
+        password = random_string(16)
+        acc = Http.post("#{BASE_URL}/accounts",
+                        headers: DEFAULT_HEADERS.merge("Content-Type" => "application/ld+json"),
+                        json: { "address" => address, "password" => password })
+        acc.raise_for_status
+        tok = Http.post("#{BASE_URL}/token", headers: DEFAULT_HEADERS,
+                                             json: { "address" => address, "password" => password })
+        tok.raise_for_status
+        EmailInfo.new(channel: CHANNEL, email: address, token: tok.json["token"],
+                      created_at: acc.json["createdAt"])
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        resp = Http.get("#{BASE_URL}/messages?page=1",
+                        headers: DEFAULT_HEADERS.merge("Authorization" => "Bearer #{token}"))
+        resp.raise_for_status
+        data = resp.json
+        messages = data.is_a?(Array) ? data : (data["hydra:member"] || [])
+        messages.map { |msg| Normalize.normalize_email(MailTm.flatten(msg, email), email) }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/eyepaste.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "securerandom"
+require "rexml/document"
+
+module TempmailSdk
+  module Providers
+    # Eyepaste 渠道 — https://eyepaste.com
+    # RSS XML API，无认证，直接生成随机用户名
+    module Eyepaste
+      CHANNEL = "eyepaste"
+      DOMAIN = "eyepaste.com"
+      BASE = "https://www.eyepaste.com"
+
+      HEADERS = {
+        "Accept" => "application/rss+xml, application/xml, text/xml, */*",
+        "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"
+      }.freeze
+
+      TAG_RE = /<[^>]+>/
+
+      module_function
+
+      # 生成随机用户名
+      def random_username(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 解析 RSS description 中的邮件元数据
+      def parse_description(desc)
+        result = { "from" => "", "to" => "", "subject" => "", "date" => "", "body" => "" }
+        return result if desc.nil? || desc.empty?
+
+        p_match = desc.match(/<p[^>]*>(.*?)<\/p>/mi)
+        if p_match
+          meta = p_match[1].strip
+          from_m = meta.match(/From:\s*(.*?)(?:\s+To:|$)/m)
+          result["from"] = from_m[1].strip if from_m
+          to_m = meta.match(/To:\s*(.*?)(?:\s+Subject:|$)/m)
+          result["to"] = to_m[1].strip if to_m
+          subject_m = meta.match(/Subject:\s*(.*?)(?:\s+Date:|$)/m)
+          result["subject"] = subject_m[1].strip if subject_m
+          date_m = meta.match(/Date:\s*(.*?)$/m)
+          result["date"] = date_m[1].strip if date_m
+
+          p_end = desc.index("</p>")
+          if p_end
+            body = desc[(p_end + 4)..].strip
+            result["body"] = body unless body.empty?
+          end
+        end
+        result
+      end
+
+      # 生成临时邮箱（无需 API 调用）
+      # @return [EmailInfo]
+      def generate_email
+        username = random_username
+        email = "#{username}@#{DOMAIN}"
+        EmailInfo.new(channel: CHANNEL, email: email)
+      end
+
+      # 获取邮件列表，通过 RSS XML 解析
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        e = (email || "").strip
+        raise "eyepaste: empty email" if e.empty?
+
+        resp = Http.get("#{BASE}/inbox/#{e}.rss", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        content = resp.body
+        return [] if content.nil? || content.strip.empty?
+
+        begin
+          doc = REXML::Document.new(content)
+        rescue REXML::ParseException
+          return []
+        end
+
+        channel_elem = doc.root&.elements&.to_a("channel")&.first
+        return [] unless channel_elem
+
+        emails = []
+        channel_elem.elements.each("item") do |item|
+          idx = emails.length
+          title = item.elements["title"]&.text.to_s.strip
+          desc = item.elements["description"]&.text.to_s.strip
+
+          parsed = parse_description(desc)
+          subject = parsed["subject"].empty? ? title : parsed["subject"]
+          from_addr = parsed["from"]
+          to_addr = parsed["to"].empty? ? e : parsed["to"]
+          date = parsed["date"]
+          body_html = parsed["body"]
+
+          text = ""
+          text = body_html.gsub(TAG_RE, "").strip unless body_html.empty?
+
+          emails << Email.new(
+            id: (idx + 1).to_s,
+            from_addr: from_addr,
+            to: to_addr,
+            subject: subject,
+            text: text,
+            html: body_html,
+            date: date,
+            is_read: false,
+            attachments: []
+          )
+        end
+
+        emails
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/fake_email_site.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # fake-email.site 渠道实现
+    # JSON REST API：创建临时邮箱 + 轮询收件箱
+    module FakeEmailSite
+      CHANNEL = "fake-email-site"
+      BASE = "https://api.fake-email.site"
+      HEADERS = {
+        "Accept" => "application/json",
+        "Content-Type" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+      }.freeze
+
+      module_function
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE}/api/temporary-address", headers: HEADERS, json: {})
+        resp.raise_for_status
+        data = resp.json
+        raise "fake-email-site: invalid response" unless data.is_a?(Hash)
+
+        email = (data["temp_email_addr"] || "").to_s.strip
+        raise "fake-email-site: missing temp_email_addr" if email.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        resp = Http.get("#{BASE}/api/inbox/poll?address=#{email}", headers: HEADERS)
+        return [] if resp.status_code == 404
+
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        rows = data["messages"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map { |row| Normalize.normalize_email(row, email) }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/fake_legal.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Fake Legal 渠道 — https://imgui.de
+    # imgui.de / pulsewebmenu.de 用 POST 保根域，其余域用 GET 创建
+    module FakeLegal
+      CHANNEL = "fake-legal"
+      BASE = "https://imgui.de"
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+        "Cache-Control" => "no-cache",
+        "DNT" => "1",
+        "Pragma" => "no-cache",
+        "Referer" => "https://imgui.de/",
+        "sec-ch-ua" => '"Chromium";v="146", "Not-A.Brand";v="24", "Microsoft Edge";v="146"',
+        "sec-ch-ua-mobile" => "?0",
+        "sec-ch-ua-platform" => '"Windows"',
+        "sec-fetch-dest" => "empty",
+        "sec-fetch-mode" => "cors",
+        "sec-fetch-site" => "same-origin",
+        "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"
+      }.freeze
+
+      module_function
+
+      def fetch_domains
+        resp = Http.get("#{BASE}/api/domains", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        raw = data["domains"]
+        return [] unless raw.is_a?(Array)
+
+        raw.filter_map { |d| d.strip if d.is_a?(String) && !d.strip.empty? }
+      end
+
+      def pick_domain(domains, preferred)
+        if preferred && !preferred.to_s.strip.empty?
+          p = preferred.to_s.strip.downcase
+          found = domains.find { |d| d.downcase == p }
+          return found if found
+
+          raise "fake-legal: domain not available: #{p}"
+        end
+        domains.sample
+      end
+
+      def random_username(length)
+        chars = ("a".."z").to_a + ("A".."Z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # @param domain [String, nil]
+      # @param channel [String]
+      # @return [EmailInfo]
+      def generate_email(domain = nil, channel = CHANNEL)
+        domains = fetch_domains
+        raise "fake-legal: no domains" if domains.empty?
+
+        d = pick_domain(domains, domain)
+        resp = if d == "imgui.de" || d == "pulsewebmenu.de"
+                 # imgui-de / pulsewebmenu-de 用 POST 保根域
+                 Http.post("#{BASE}/api/inbox/custom",
+                           json: { "username" => random_username(12), "domain" => d },
+                           headers: HEADERS, timeout: 15)
+               else
+                 # fake-legal 用 GET 创建
+                 Http.get("#{BASE}/api/inbox/new?domain=#{URI.encode_www_form_component(d)}",
+                          headers: HEADERS, timeout: 15)
+               end
+        resp.raise_for_status
+        data = resp.json
+        raise "fake-legal: create inbox failed" unless data.is_a?(Hash) && data["success"]
+
+        addr = data["address"]
+        raise "fake-legal: missing address" if addr.nil? || addr.to_s.strip.empty?
+
+        EmailInfo.new(channel: channel, email: addr.to_s.strip)
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        e = email.to_s.strip
+        raise "fake-legal: empty email" if e.empty?
+
+        resp = Http.get("#{BASE}/api/inbox/#{URI.encode_www_form_component(e)}",
+                        headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash) && data["success"]
+
+        rows = data["emails"]
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(raw, e)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/fmail.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # fmail.men 渠道实现
+    module Fmail
+      CHANNEL = "fmail"
+      BASE_URL = "https://fmail.men"
+      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
+
+      def fetch_json(path)
+        resp = Http.get("#{BASE_URL}#{path}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        data.is_a?(Hash) ? data : {}
+      end
+
+      def flatten_message(raw, recipient)
+        {
+          "id" => (raw["id"] || raw["uid"] || raw["token"]).to_s,
+          "from" => (raw["sender"] || raw["from"]).to_s,
+          "to" => (raw["recipient"] || raw["to"] || recipient).to_s,
+          "subject" => (raw["subject"] || "").to_s,
+          "text" => (raw["body_text"] || raw["text"] || raw["snippet"]).to_s,
+          "html" => (raw["body_html"] || raw["html"]).to_s,
+          "date" => (raw["received_at"] || raw["timestamp"] || raw["date"]).to_s,
+          "is_read" => raw["is_read"] || false,
+          "attachments" => raw["attachments"].is_a?(Array) ? raw["attachments"] : []
+        }
+      end
+
+      # @param domain [String, nil] 可选域名
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        selected = domain.to_s.strip.delete_prefix("@")
+        path = "/v1/random"
+        path = "#{path}?domain=#{URI.encode_www_form_component(selected)}" unless selected.empty?
+
+        data = fetch_json(path)
+        email = data["address"].to_s.strip
+        if email.empty?
+          username = data["username"].to_s.strip
+          dom = data["domain"].to_s.strip
+          email = "#{username}@#{dom}" if !username.empty? && !dom.empty?
+        end
+        raise "fmail: invalid random response" if email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email)
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        value = email.to_s.strip
+        local, _, domain = value.partition("@")
+        raise "fmail: invalid email" if local.empty? || domain.empty?
+
+        data = fetch_json(
+          "/v1/inbox/#{URI.encode_www_form_component(local)}?domain=#{URI.encode_www_form_component(domain)}&limit=50"
+        )
+        rows = data["emails"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map do |row|
+          token = (row["token"] || row["id"]).to_s.strip
+          if token.empty?
+            Normalize.normalize_email(flatten_message(row, value), value)
+          else
+            begin
+              detail = fetch_json("/v1/email/#{URI.encode_www_form_component(token)}")
+              nested = detail["email"].is_a?(Hash) ? detail["email"] : detail
+              Normalize.normalize_email(flatten_message(nested.is_a?(Hash) ? nested : row, value), value)
+            rescue StandardError
+              Normalize.normalize_email(flatten_message(row, value), value)
+            end
+          end
+        end
+      end
+    end
+  end
+end