tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/mailinator.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+require "time"
+
+module TempmailSdk
+  module Providers
+    # Mailinator 渠道实现 -- https://mailinator.com
+    #
+    # 匿名公共信箱：邮箱本地部分即为信箱名，收信统一走
+    # mailinator.com 的 public 域名 REST API。众多姊妹域名（如
+    # blackhole.djurby.se、sink.fblay.com 等）本质是同一公共信箱的别名，
+    # 仅生成邮箱时域名不同，取信逻辑完全一致。
+    module Mailinator
+      CHANNEL = "mailinator"
+      BASE_URL = "https://mailinator.com"
+      # 收信统一使用的公共域名标识
+      PUBLIC_DOMAIN = "public"
+      # 默认生成邮箱所用域名
+      DEFAULT_DOMAIN = "mailinator.com"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
+        "Cache-Control" => "no-cache",
+        "Pragma" => "no-cache",
+        "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
+
+      # 生成随机本地部分：length 位小写字母数字
+      def random_string(length)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 生成临时邮箱
+      # @param domain [String, nil] 邮箱域名（姊妹渠道派生用），缺省 mailinator.com
+      # @param channel [String] 渠道标识
+      # @return [EmailInfo]
+      def generate_email(domain = nil, channel = CHANNEL)
+        dom = domain.to_s.strip
+        dom = DEFAULT_DOMAIN if dom.empty?
+        EmailInfo.new(channel: channel, email: "#{random_string(12)}@#{dom}")
+      end
+
+      # 拉取邮件列表并逐封获取正文/附件
+      # @param token [String] 未使用（公共信箱无需鉴权）
+      # @param email [String] 邮箱地址
+      # @return [Array<Email>]
+      def get_emails(token, email = "")
+        _ = token
+        inbox = email.to_s.strip
+        inbox = inbox.split("@", 2).first.to_s if inbox.include?("@")
+        return [] if inbox.empty?
+
+        data = request_json("#{BASE_URL}/api/v2/domains/#{PUBLIC_DOMAIN}/inboxes/#{inbox}")
+        messages = parse_messages(data)
+        return [] if messages.empty?
+
+        messages.map do |msg|
+          message_id = (msg["id"] || msg["messageId"]).to_s.strip
+          text_payload = message_id.empty? ? nil : request_json(message_path(message_id, "text"))
+          html_payload = message_id.empty? ? nil : request_json(message_path(message_id, "texthtml"))
+          att_payload  = message_id.empty? ? nil : request_json(message_path(message_id, "attachments"))
+          Normalize.normalize_email(
+            flatten_message(msg, email, text_payload, html_payload, att_payload), email
+          )
+        end
+      end
+
+      # 拼接单封邮件某子资源的 URL
+      def message_path(message_id, suffix)
+        "#{BASE_URL}/api/v2/domains/#{PUBLIC_DOMAIN}/messages/#{message_id}/#{suffix}"
+      end
+
+      # 发起 GET 并解析 JSON，失败返回 nil；非 Hash 结果包裹为 { "data" => ... }
+      def request_json(url)
+        resp = Http.get(url, headers: HEADERS, timeout: 15)
+        return nil unless resp.ok?
+
+        data = resp.json
+        data.is_a?(Hash) ? data : { "data" => data }
+      rescue StandardError
+        nil
+      end
+
+      # 从响应中解析消息数组（兼容顶层数组或 msgs/data 字段）
+      def parse_messages(data)
+        return data.select { |item| item.is_a?(Hash) } if data.is_a?(Array)
+
+        if data.is_a?(Hash)
+          %w[msgs data].each do |key|
+            value = data[key]
+            return value.select { |item| item.is_a?(Hash) } if value.is_a?(Array)
+          end
+        end
+        []
+      end
+
+      # 从 payload 中取指定 content-type 的文本
+      def text_from_payload(payload, key)
+        return "" unless payload.is_a?(Hash)
+
+        value = payload[key]
+        return "" if value.nil?
+
+        value.is_a?(String) ? value : value.to_s
+      end
+
+      # 补全附件下载 URL（相对路径补上 BASE_URL）
+      def attachment_url(value)
+        return "" unless value.is_a?(String) && !value.empty?
+        return value if value.start_with?("http://", "https://")
+
+        "#{BASE_URL}#{value}"
+      end
+
+      # 将时间值统一为 ISO 8601（毫秒/秒时间戳或字符串）
+      def to_iso_time(value)
+        return "" if value.nil? || value == ""
+
+        if value.is_a?(Numeric)
+          millis = value > 1e12 ? value : value * 1000
+          return Time.at(millis / 1000.0).utc.iso8601
+        end
+
+        text = value.to_s
+        begin
+          Time.iso8601(text.sub(/Z\z/, "+00:00")).utc.iso8601
+        rescue ArgumentError
+          text
+        end
+      end
+
+      # 将邮件摘要与正文/附件展平为 normalize 可识别的字段
+      def flatten_message(summary, recipient_email, text_payload, html_payload, att_payload)
+        {
+          "id" => (summary["id"] || summary["messageId"] || "").to_s,
+          "from" => first_non_empty(summary["from"], summary["origfrom"]),
+          "to" => summary["to"] || recipient_email,
+          "subject" => summary["subject"] || "",
+          "text" => text_from_payload(text_payload, "text/plain"),
+          "html" => text_from_payload(html_payload, "text/html"),
+          "date" => to_iso_time(summary["time"] || summary["date"]),
+          "seen" => false,
+          "attachments" => build_attachments(att_payload)
+        }
+      end
+
+      # 展平附件列表
+      def build_attachments(att_payload)
+        list = att_payload.is_a?(Hash) ? att_payload["attachments"] : nil
+        return [] unless list.is_a?(Array)
+
+        list.filter_map do |att|
+          next unless att.is_a?(Hash)
+
+          {
+            "filename" => att["name"] || att["filename"] || "",
+            "size" => att["size"] || att["filesize"],
+            "contentType" => att["contentType"] || att["content_type"] ||
+              att["mimeType"] || att["mime_type"],
+            "url" => attachment_url(att["downloadUrl"] || att["url"])
+          }
+        end
+      end
+
+      # 返回首个非空字符串
+      def first_non_empty(*values)
+        values.each do |v|
+          next if v.nil?
+
+          t = v.to_s
+          return t unless t.empty?
+        end
+        ""
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mailmomy.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # mailmomy 渠道实现 -- https://mailmomy.com
+    #
+    # 免注册、无鉴权、无 CAPTCHA 的纯 GET JSON API 临时邮箱，Token 即邮箱地址本身。
+    # 流程:
+    #   1. GET /api/domains/active -> JSON 字符串数组，随机选一个域名（失败回退 mailmomy.com）
+    #   2. 本地随机 10 位 [a-z0-9] local part，拼接为 <local>@<域名>
+    #   3. GET /api/mail/messages?to=<email>&page=1&limit=20 -> {"emails": [...], ...}
+    #
+    # 16 个域名变体渠道（如 16888888.cyou、sbook.pics 等）复用同一后端，
+    # 仅在 generate_email(domain) 传入固定域名即可，收信逻辑完全一致。
+    module Mailmomy
+      CHANNEL = "mailmomy"
+      BASE_URL = "https://mailmomy.com"
+      DEFAULT_DOMAIN = "mailmomy.com"
+      DEFAULT_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                   "(KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
+
+      module_function
+
+      # 获取 User-Agent，优先使用配置中的自定义 UA
+      def user_agent
+        (Config.get_config.headers || {})["User-Agent"] || DEFAULT_UA
+      end
+
+      # 生成 n 位小写字母数字随机邮箱前缀
+      def random_local(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 按优先级从消息 Hash 中提取首个非空值并转为字符串
+      def first_value(msg, *keys)
+        keys.each do |key|
+          val = msg[key]
+          return val.to_s unless val.nil? || val == ""
+        end
+        ""
+      end
+
+      # 拉取 mailmomy 当前可用域名池并随机选取一个
+      # GET /api/domains/active -> JSON 字符串数组；请求或解析失败时回退到默认 mailmomy.com
+      def pick_domain
+        resp = Http.get("#{BASE_URL}/api/domains/active",
+                        headers: { "User-Agent" => user_agent, "Accept" => "application/json" })
+        resp.raise_for_status
+        data = resp.json
+        return DEFAULT_DOMAIN unless data.is_a?(Array)
+
+        domains = data.select { |d| d.is_a?(String) && !d.empty? }
+        domains.empty? ? DEFAULT_DOMAIN : domains.sample
+      rescue StandardError
+        DEFAULT_DOMAIN
+      end
+
+      # 创建临时邮箱；服务免注册，直接构造 <local>@<域名> 即可收信
+      # @param domain [String, nil] 指定固定域名（域名变体渠道用）；为空则从可用域名池随机选取
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        selected = domain.to_s.strip
+        selected = pick_domain if selected.empty?
+        email = "#{random_local(10)}@#{selected}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取邮件列表
+      # GET /api/mail/messages?to=<email>&page=1&limit=20
+      # 返回 {"emails": [{id,recipient,from,subject,message,bodyText,receivedAt}], ...}
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        addr = email.to_s.strip
+        raise "mailmomy: 缺少邮箱地址" if addr.empty?
+
+        url = "#{BASE_URL}/api/mail/messages?to=#{URI.encode_www_form_component(addr)}&page=1&limit=20"
+        resp = Http.get(url, headers: { "User-Agent" => user_agent, "Accept" => "application/json" })
+        resp.raise_for_status
+
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        emails = data["emails"]
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          message = first_value(msg, "message")
+          row = {
+            "id" => first_value(msg, "id"),
+            "from" => first_value(msg, "from"),
+            "to" => first_value(msg, "recipient").empty? ? addr : first_value(msg, "recipient"),
+            "subject" => first_value(msg, "subject"),
+            "text" => first_value(msg, "bodyText").empty? ? message : first_value(msg, "bodyText"),
+            "html" => message,
+            "date" => first_value(msg, "receivedAt")
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mailnesia.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require "cgi"
+require "securerandom"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Mailnesia 渠道 — https://mailnesia.com
+    # HTML 解析公开邮箱
+    module Mailnesia
+      CHANNEL = "mailnesia"
+      BASE_URL = "https://mailnesia.com"
+      DOMAIN = "mailnesia.com"
+      HEADERS = { "Accept" => "text/html,*/*" }.freeze
+
+      ROW_RE = /<tr\s+id="([^"]+)"[^>]*class="[^"]*\bemailheader\b[^"]*"[^>]*>(.*?)<\/tr>/mi
+      TIME_RE = /<time\s+datetime="([^"]+)"/i
+      ANCHOR_RE = /<a\b[^>]*class="email"[^>]*>(.*?)<\/a>/mi
+      TAG_RE = /<[^>]+>/
+
+      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
+
+      def mailbox_url(local)
+        "#{BASE_URL}/mailbox/#{URI.encode_www_form_component(local)}"
+      end
+
+      def detail_url(local, message_id)
+        "#{mailbox_url(local)}/#{URI.encode_www_form_component(message_id)}"
+      end
+
+      def fetch_html(url)
+        resp = Http.get(url, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        resp.body
+      end
+
+      def clean_text(raw)
+        CGI.unescapeHTML(raw.to_s.gsub(TAG_RE, " ")).split.join(" ")
+      end
+
+      # 从邮箱列表页解析邮件条目
+      def parse_rows(page)
+        rows = []
+        page.scan(ROW_RE).each do |message_id, row_html|
+          message_id = message_id.strip
+          date_match = row_html.match(TIME_RE)
+          anchors = row_html.scan(ANCHOR_RE).map { |m| clean_text(m[0]) }
+          next if anchors.length < 3
+
+          rows << {
+            "id" => message_id,
+            "date" => date_match ? CGI.unescapeHTML(date_match[1].strip) : "",
+            "from" => anchors[0],
+            "to" => anchors[1],
+            "subject" => anchors[2]
+          }
+        end
+        rows
+      end
+
+      # 从详情页提取指定 div 内容
+      def extract_div_by_id(page, div_id, next_id = "")
+        needle = "id=\"#{div_id}\""
+        pos = page.index(needle)
+        return "" unless pos
+
+        open_end = page.index(">", pos)
+        return "" unless open_end
+
+        start = open_end + 1
+        end_pos = -1
+        end_pos = page.index("<div id=\"#{next_id}\"", start) unless next_id.empty?
+        if end_pos < 0
+          close = page.index("</div>", start)
+          end_pos = close + 6 if close
+        end
+        return "" if end_pos < 0
+
+        content = page[start...end_pos].strip
+        content = content[0...-6].strip if content.end_with?("</div>")
+        content
+      end
+
+      # 提取纯文本部分
+      def extract_plain(page, message_id)
+        pattern = /<div\s+id="text_plain_#{Regexp.escape(message_id)}"[^>]*>\s*<pre>(.*?)<\/pre>\s*<\/div>/mi
+        m = page.match(pattern)
+        m ? CGI.unescapeHTML(m[1]).strip : ""
+      end
+
+      # 获取单封详情
+      def fetch_detail(local, row)
+        message_id = (row["id"] || "").strip
+        return row if message_id.empty?
+
+        page = fetch_html(detail_url(local, message_id))
+        detail = row.dup
+        detail["text"] = extract_plain(page, message_id)
+        detail["html"] = extract_div_by_id(page, "text_html_#{message_id}", "text_plain_#{message_id}")
+        detail
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        local = random_local
+        fetch_html(mailbox_url(local))
+        EmailInfo.new(channel: CHANNEL, email: "#{local}@#{DOMAIN}")
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        local = local_part(email)
+        raise "mailnesia: empty email" if local.empty?
+
+        page = fetch_html(mailbox_url(local))
+        rows = parse_rows(page)
+
+        rows.map do |row|
+          begin
+            Normalize.normalize_email(fetch_detail(local, row), email)
+          rescue StandardError
+            Normalize.normalize_email(row, email)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mffac.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "time"
+
+module TempmailSdk
+  module Providers
+    # MFFAC 渠道实现
+    # API: https://www.mffac.com/api
+    module Mffac
+      CHANNEL = "mffac"
+      BASE = "https://www.mffac.com/api"
+
+      HEADERS = {
+        "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",
+        "Content-Type" => "application/json",
+        "Accept" => "*/*",
+        "Origin" => "https://www.mffac.com",
+        "Referer" => "https://www.mffac.com/"
+      }.freeze
+
+      GET_HEADERS = HEADERS.reject { |k, _| k == "Content-Type" }.freeze
+
+      module_function
+
+      # 将 receivedAt 秒级时间戳转为 ISO8601
+      def received_at_to_iso(value)
+        seconds = Float(value)
+        return "" if seconds <= 0
+
+        Time.at(seconds).utc.strftime("%Y-%m-%dT%H:%M:%SZ")
+      rescue TypeError, ArgumentError
+        ""
+      end
+
+      # 扁平化邮件字段
+      def flatten_email(raw, recipient)
+        {
+          "id" => raw["id"] || "",
+          "from" => raw["fromAddress"] || "",
+          "to" => raw["toAddress"] || recipient,
+          "subject" => raw["subject"] || "",
+          "text" => raw["textContent"] || "",
+          "html" => raw["htmlContent"] || "",
+          "date" => received_at_to_iso(raw["receivedAt"]),
+          "isRead" => raw["isRead"] || false,
+          "attachments" => []
+        }
+      end
+
+      # 获取单封邮件详情
+      def fetch_detail(message_id)
+        r = Http.get("#{BASE}/emails/#{URI.encode_www_form_component(message_id)}", headers: GET_HEADERS)
+        return nil unless r.ok?
+
+        data = r.json
+        return nil unless data.is_a?(Hash) && data["success"]
+
+        email = data["email"]
+        email.is_a?(Hash) ? email : nil
+      rescue StandardError
+        nil
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        r = Http.post("#{BASE}/mailboxes", headers: HEADERS, json: { "expiresInHours" => 24 })
+        r.raise_for_status
+        data = r.json
+        raise "mffac: 创建失败" unless data.is_a?(Hash) && data["success"] && data["mailbox"]
+
+        mb = data["mailbox"]
+        addr = (mb["address"] || "").strip
+        mid = (mb["id"] || "").strip
+        raise "mffac: 无效的邮箱数据" if addr.empty? || mid.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: "#{addr}@mffac.com", token: mid, created_at: mb["createdAt"])
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token = "")
+        local = email.to_s.split("@", 2).first.to_s.strip
+        raise "mffac: 地址为空" if local.empty?
+
+        r = Http.get("#{BASE}/mailboxes/#{local}/emails", headers: GET_HEADERS)
+        r.raise_for_status
+        data = r.json
+        raise "mffac: 获取列表失败" unless data.is_a?(Hash) && data["success"]
+
+        (data["emails"] || []).select { |raw| raw.is_a?(Hash) }.map do |raw|
+          mid = raw["id"].to_s.strip
+          detail = mid.empty? ? nil : fetch_detail(mid)
+          Normalize.normalize_email(flatten_email(detail || raw, email), email)
+        end
+      end
+    end
+  end
+end