tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/mail_tm.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require "securerandom"
+
+module TempmailSdk
+  module Providers
+    # mail.tm 渠道实现
+    # API: https://api.mail.tm
+    # 流程: 获取域名 -> 生成随机邮箱/密码 -> 创建账号 -> 获取 Bearer Token
+    module MailTm
+      CHANNEL = "mail-tm"
+      BASE_URL = "https://api.mail.tm"
+      DEFAULT_HEADERS = { "Content-Type" => "application/json", "Accept" => "application/json" }.freeze
+
+      module_function
+
+      def random_string(length)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 获取可用域名列表，兼容 Hydra 格式和纯数组
+      def fetch_domains
+        resp = Http.get("#{BASE_URL}/domains", 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
+
+      def create_account(address, password)
+        resp = Http.post("#{BASE_URL}/accounts",
+                         headers: DEFAULT_HEADERS.merge("Content-Type" => "application/ld+json"),
+                         json: { "address" => address, "password" => password })
+        resp.raise_for_status
+        resp.json
+      end
+
+      def fetch_token(address, password)
+        resp = Http.post("#{BASE_URL}/token", headers: DEFAULT_HEADERS,
+                                              json: { "address" => address, "password" => password })
+        resp.raise_for_status
+        resp.json["token"]
+      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)
+        account = create_account(address, password)
+        token = fetch_token(address, password)
+        EmailInfo.new(channel: CHANNEL, email: address, token: token, created_at: account["createdAt"])
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        resp = Http.get("#{BASE_URL}/messages",
+                        headers: DEFAULT_HEADERS.merge("Authorization" => "Bearer #{token}"))
+        resp.raise_for_status
+        data = resp.json
+        messages = data.is_a?(Array) ? data : (data["hydra:member"] || [])
+        return [] if messages.empty?
+
+        messages.map do |msg|
+          flat = begin
+            dr = Http.get("#{BASE_URL}/messages/#{msg['id']}",
+                          headers: DEFAULT_HEADERS.merge("Authorization" => "Bearer #{token}"))
+            flatten(dr.ok? ? dr.json : msg, email)
+          rescue StandardError
+            flatten(msg, email)
+          end
+          Normalize.normalize_email(flat, email)
+        end
+      end
+
+      # 将 mail.tm 消息格式扁平化
+      def flatten(msg, recipient)
+        from_addr = msg["from"].is_a?(Hash) ? msg["from"]["address"].to_s : msg["from"].to_s
+        to_addr = recipient
+        if msg["to"].is_a?(Array) && msg["to"][0].is_a?(Hash)
+          to_addr = msg["to"][0]["address"] || recipient
+        end
+        html = msg["html"]
+        html = html.join if html.is_a?(Array)
+        {
+          "id" => msg["id"] || "", "from" => from_addr, "to" => to_addr,
+          "subject" => msg["subject"] || "", "text" => msg["text"] || "",
+          "html" => html || "", "createdAt" => msg["createdAt"] || "",
+          "seen" => msg["seen"] || false
+        }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mailcatch.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "securerandom"
+
+module TempmailSdk
+  module Providers
+    # MailCatch 渠道 — https://mailcatch.com
+    # 公开收件箱，无需认证。GET /api/list/{inbox} + GET /api/data/{inbox}/{id}
+    module Mailcatch
+      CHANNEL = "mailcatch"
+      BASE_URL = "https://mailcatch.com"
+      DOMAIN = "mailcatch.com"
+
+      # 匹配邮件列表 HTML 中的邮件项
+      EMAIL_ITEM_RE = /class="email-item"\s+data-email-id="([^"]*)"\s+data-subject="([^"]*)"\s+data-timestamp="([^"]*)"\s+data-sender="([^"]*)"/i
+
+      HEADERS = {
+        "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "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 random_local
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        "sdk" + Array.new(16) { chars.sample }.join
+      end
+
+      # 提取邮箱地址的 @ 前部分
+      def local_part(email)
+        (email || "").strip.split("@").first.to_s.strip
+      end
+
+      # 创建 mailcatch 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        local = random_local
+        email = "#{local}@#{DOMAIN}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: local)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        raise "mailcatch: token 不能为空" if token.nil? || token.to_s.empty?
+
+        addr = (email || "").strip
+        raise "mailcatch: 邮箱地址不能为空" if addr.empty?
+
+        inbox = token.strip
+        inbox = local_part(addr) if inbox.empty?
+        raise "mailcatch: 无法确定收件箱名称" if inbox.empty?
+
+        # 获取邮件列表 HTML
+        resp = Http.get("#{BASE_URL}/api/list/#{inbox}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+
+        items = resp.body.scan(EMAIL_ITEM_RE)
+        return [] if items.empty?
+
+        items.filter_map do |email_id, subject, timestamp, sender|
+          email_id = email_id.strip
+          next if email_id.empty?
+
+          # 获取邮件正文 HTML
+          body_html = ""
+          begin
+            detail_resp = Http.get("#{BASE_URL}/api/data/#{inbox}/#{email_id}", headers: HEADERS, timeout: 15)
+            body_html = detail_resp.body.strip if detail_resp.ok?
+          rescue StandardError
+            # 忽略正文获取失败
+          end
+
+          raw = {
+            "id" => email_id,
+            "from" => sender.strip,
+            "to" => addr,
+            "subject" => subject.strip,
+            "html" => body_html,
+            "date" => timestamp.strip
+          }
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/maildrop.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Maildrop — https://maildrop.cx
+    # GET /api/suffixes.php、GET /api/emails.php
+    module Maildrop
+      CHANNEL = "maildrop"
+      BASE = "https://maildrop.cx"
+      EXCLUDED_SUFFIX = "transformer.edu.kg"
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Referer" => "https://maildrop.cx/zh-cn/app",
+        "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",
+        "x-requested-with" => "XMLHttpRequest"
+      }.freeze
+
+      module_function
+
+      def random_local(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      def fetch_suffixes
+        r = Http.get("#{BASE}/api/suffixes.php", headers: HEADERS)
+        r.raise_for_status
+        data = r.json
+        raise "maildrop: invalid suffixes response" unless data.is_a?(Array)
+
+        ex = EXCLUDED_SUFFIX.downcase
+        out = data.select { |x| x.is_a?(String) }.map(&:strip).reject { |t| t.empty? || t.downcase == ex }
+        raise "maildrop: no domains available" if out.empty?
+
+        out
+      end
+
+      def pick_suffix(suffixes, preferred)
+        if preferred && !preferred.to_s.strip.empty?
+          p = preferred.to_s.strip.downcase
+          found = suffixes.find { |d| d.downcase == p }
+          raise "maildrop: domain not available: #{p}" unless found
+
+          return found
+        end
+        suffixes.sample
+      end
+
+      def cx_date_to_iso(str)
+        s = str.to_s.strip
+        return "#{s[0, 10]}T#{s[11..]}Z" if s.length == 19 && s[10] == " "
+
+        s
+      end
+
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        suffixes = fetch_suffixes
+        dom = pick_suffix(suffixes, domain)
+        email = "#{random_local}@#{dom}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # @param email [String]
+      # @param token [String, nil]
+      # @return [Array<Email>]
+      def get_emails(email, token = nil)
+        addr = email.to_s.strip
+        addr = token.to_s.strip if addr.empty?
+        raise "maildrop: empty address" if addr.empty?
+
+        qs = URI.encode_www_form(addr: addr, page: "1", limit: "20")
+        r = Http.get("#{BASE}/api/emails.php?#{qs}", headers: HEADERS)
+        r.raise_for_status
+        data = r.body.empty? ? {} : r.json
+        rows = data["emails"] || []
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |row| row.is_a?(Hash) }.map do |row|
+          ir = row["isRead"]
+          Email.new(
+            id: row["id"].to_s, from_addr: (row["from_addr"] || "").strip, to: addr,
+            subject: (row["subject"] || "").strip, text: (row["description"] || "").strip,
+            html: "", date: cx_date_to_iso(row["date"] || ""),
+            is_read: ir == true || ir == 1, attachments: []
+          )
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/maildrop_cc.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require "json"
+require "securerandom"
+
+module TempmailSdk
+  module Providers
+    # maildrop.cc GraphQL API 渠道 — https://maildrop.cc
+    # 无认证，公共邮箱
+    module MaildropCc
+      CHANNEL = "maildrop-cc"
+      DOMAIN = "maildrop.cc"
+      GRAPHQL_URL = "https://api.maildrop.cc/graphql"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "Content-Type" => "application/json",
+        "Origin" => "https://maildrop.cc",
+        "Referer" => "https://maildrop.cc/",
+        "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
+
+      LOCAL_CHARS = ("a".."z").to_a + ("0".."9").to_a
+
+      module_function
+
+      def random_local(n = 10)
+        Array.new(n) { LOCAL_CHARS.sample }.join
+      end
+
+      def mailbox(email)
+        e = (email || "").strip
+        idx = e.index("@")
+        idx ? e[0...idx] : e
+      end
+
+      def do_graphql(query)
+        resp = Http.post(GRAPHQL_URL, headers: HEADERS, json: { "query" => query })
+        resp.raise_for_status
+        resp.json
+      end
+
+      def inbox_query(mb)
+        mb_s = JSON.generate(mb)
+        "query { inbox(mailbox: #{mb_s}) { id headerfrom subject date } }"
+      end
+
+      def message_query(mb, mid)
+        mb_s = JSON.generate(mb)
+        mid_s = JSON.generate(mid)
+        "query { message(mailbox: #{mb_s}, id: #{mid_s}) { id headerfrom subject date html } }"
+      end
+
+      # 创建 maildrop.cc 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        email = "#{random_local(10)}@#{DOMAIN}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String] （不使用，公共邮箱无需认证）
+      # @return [Array<Email>]
+      def get_emails(email, token = "")
+        mb = mailbox(email)
+        raise "maildrop-cc: 邮箱地址为空" if mb.empty?
+
+        inbox_resp = do_graphql(inbox_query(mb))
+        items = ((inbox_resp || {})["data"] || {})["inbox"]
+        return [] unless items.is_a?(Array) && !items.empty?
+
+        items.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          mid = (item["id"] || "").to_s
+
+          raw = {
+            "id" => mid,
+            "from" => item["headerfrom"] || "",
+            "subject" => item["subject"] || "",
+            "date" => item["date"] || ""
+          }
+
+          # 查询单封详情补全 html 正文
+          unless mid.empty?
+            begin
+              msg_resp = do_graphql(message_query(mb, mid))
+              msg = ((msg_resp || {})["data"] || {})["message"]
+              if msg.is_a?(Hash)
+                raw = {
+                  "id" => msg["id"] || mid,
+                  "from" => msg["headerfrom"] || "",
+                  "subject" => msg["subject"] || "",
+                  "date" => msg["date"] || "",
+                  "html" => msg["html"] || ""
+                }
+              end
+            rescue StandardError
+              # 回退使用列表元信息
+            end
+          end
+
+          Normalize.normalize_email(raw, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mailforspam.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # MailForSpam 渠道 — https://mailforspam.com
+    # 匿名 REST API：邮箱列表接口 + 逐封详情
+    module Mailforspam
+      CHANNEL = "mailforspam"
+      API_BASE = "https://api.mailforspam.com/api"
+      DEFAULT_DOMAIN = "mailforspam.com"
+      DOMAINS = %w[mailforspam.com tempmail.io disposable.email].freeze
+      HEADERS = {
+        "Accept" => "application/json",
+        "Referer" => "https://mailforspam.com/",
+        "Origin" => "https://mailforspam.com",
+        "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 random_local
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        "sdk#{Array.new(16) { chars.sample }.join}"
+      end
+
+      # 选择域名：命中别名域名则用之，否则默认域名
+      def pick_domain(preferred)
+        p = preferred.to_s.strip.sub(/\A@/, "").downcase
+        unless p.empty?
+          found = DOMAINS.find { |d| d.downcase == p }
+          return found if found
+        end
+        DEFAULT_DOMAIN
+      end
+
+      def mailbox_emails_url(email, page_size = 100)
+        "#{API_BASE}/mailboxes/#{URI.encode_www_form_component(email)}/emails" \
+          "?page=1&page_size=#{page_size}&sort_by=date&sort_order=desc"
+      end
+
+      def flatten(raw, recipient)
+        {
+          "id" => raw["id"] || "", "from" => raw["sender"] || "",
+          "to" => raw["receiver"] || recipient, "subject" => raw["subject"] || "",
+          "text" => raw["body_text"] || "", "html" => raw["body_html"] || "",
+          "date" => raw["date"] || "", "isRead" => !raw["readAt"].nil?,
+          "attachments" => raw["attachments"]
+        }
+      end
+
+      def fetch_message(message_id, email)
+        resp = Http.get(
+          "#{API_BASE}/mailboxes/#{URI.encode_www_form_component(email)}/emails/#{URI.encode_www_form_component(message_id)}",
+          headers: HEADERS, timeout: 15
+        )
+        return nil unless resp.ok?
+
+        data = resp.json
+        data.is_a?(Hash) ? data : nil
+      end
+
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        email = "#{random_local}@#{pick_domain(domain)}"
+        Http.get(mailbox_emails_url(email, 1), headers: HEADERS, timeout: 15).raise_for_status
+        EmailInfo.new(channel: CHANNEL, email: email)
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "mailforspam: empty email" if address.empty?
+
+        resp = Http.get(mailbox_emails_url(address, 100), 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 |item|
+          next unless item.is_a?(Hash)
+
+          message_id = item["id"].to_s.strip
+          next if message_id.empty?
+
+          detail = fetch_message(message_id, address)
+          Normalize.normalize_email(flatten(detail || item, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mailhole_de.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # MailholeDe 渠道实现
+    # API: https://mailhole.de
+    # 公共临时邮箱，无需认证，token 即邮箱地址本身
+    module MailholeDe
+      CHANNEL = "mailhole-de"
+      BASE_URL = "https://mailhole.de"
+
+      # 从 /api/random 返回的 HTML 中提取邮箱地址
+      EMAIL_RE = /([a-z0-9.]+@mailhole\.de)/
+
+      module_function
+
+      # 按优先级从消息字典中提取首个非空字符串值
+      def first_str(msg, *keys)
+        keys.each do |key|
+          val = msg[key]
+          return val.to_s if val.is_a?(String) && !val.empty?
+        end
+        ""
+      end
+
+      # 创建 mailhole.de 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}/api/random", headers: { "Accept" => "text/html" }, timeout: 15)
+        resp.raise_for_status
+
+        m = resp.body.match(EMAIL_RE)
+        raise "mailhole-de: 无法从响应中解析邮箱地址" unless m
+
+        email = m[1]
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        addr = email.to_s.strip
+        raise "mailhole-de: 缺少邮箱地址" if addr.empty?
+
+        resp = Http.get("#{BASE_URL}/json/#{URI.encode_www_form_component(addr)}",
+                        headers: { "Accept" => "application/json" }, timeout: 15)
+        resp.raise_for_status
+
+        return [] if resp.body.nil? || resp.body.strip.empty? || resp.body.strip == "[]"
+
+        messages = resp.json
+        return [] unless messages.is_a?(Array)
+
+        messages.select { |msg| msg.is_a?(Hash) }.map do |msg|
+          row = {
+            "id" => (msg["id"] || "").to_s,
+            "from" => first_str(msg, "sender", "from"),
+            "to" => addr,
+            "subject" => (msg["subject"] || "").to_s,
+            "text" => first_str(msg, "body", "text"),
+            "html" => first_str(msg, "html", "body"),
+            "received_at" => first_str(msg, "date", "received")
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end