tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/tempfastmail.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # TempFastMail 渠道 — https://tempfastmail.com
+    module Tempfastmail
+      CHANNEL = "tempfastmail"
+      BASE_URL = "https://tempfastmail.com"
+      HEADERS = { "Accept" => "application/json", "User-Agent" => "Mozilla/5.0" }.freeze
+
+      module_function
+
+      def flatten(raw, recipient)
+        {
+          "id" => raw["uuid"],
+          "from" => raw["from"],
+          "to" => raw["real_to"] || recipient,
+          "subject" => raw["subject"],
+          "html" => raw["html"],
+          "date" => raw["received_at"],
+          "attachments" => raw["attachments"]
+        }
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/email-box", headers: HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        email = (data["email"] || "").strip
+        uuid = (data["uuid"] || "").strip
+        raise "tempfastmail: 创建邮箱响应无效" if email.empty? || !email.include?("@") || uuid.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: uuid)
+      end
+
+      # 获取邮件列表
+      # @param token [String] UUID
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        uuid = (token || "").strip
+        address = (email || "").strip
+        raise "tempfastmail: token 为空" if uuid.empty?
+        raise "tempfastmail: 邮箱地址为空" if address.empty?
+
+        resp = Http.get("#{BASE_URL}/api/email-box/#{URI.encode_www_form_component(uuid)}/emails",
+                        headers: HEADERS)
+        resp.raise_for_status
+        rows = resp.json
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |row|
+          raw = row.is_a?(Hash) ? row : {}
+          message_id = (raw["uuid"] || "").strip
+          unless message_id.empty?
+            begin
+              dr = Http.get("#{BASE_URL}/api/email-box/#{URI.encode_www_form_component(uuid)}/email/#{URI.encode_www_form_component(message_id)}",
+                            headers: HEADERS)
+              if dr.ok?
+                detail = dr.json
+                raw = detail if detail.is_a?(Hash)
+              end
+            rescue StandardError
+              # 忽略
+            end
+          end
+          Normalize.normalize_email(flatten(raw, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempgmailer.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # TempGmailer 渠道 — https://tempgmailer.com
+    # Laravel + CSRF，POST /get-gmail 创建，POST /get-inbox 获取邮件
+    module Tempgmailer
+      CHANNEL = "tempgmailer"
+      BASE_URL = "https://tempgmailer.com"
+
+      # 从 HTML 中提取 CSRF token
+      CSRF_RE = /<meta\s+name="csrf-token"\s+content="([^"]+)"/
+
+      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",
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+        "Referer" => "#{BASE_URL}/",
+        "X-Requested-With" => "XMLHttpRequest",
+        "X-TempGmailer-Auth" => "frontend",
+        "Content-Type" => "application/json"
+      }.freeze
+
+      module_function
+
+      def extract_cookies(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
+      end
+
+      def init_session
+        resp = Http.get(BASE_URL, headers: {
+          "User-Agent" => HEADERS["User-Agent"],
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+        }, timeout: 15)
+        resp.raise_for_status
+
+        m = resp.body.match(CSRF_RE)
+        raise "tempgmailer: 无法提取 CSRF token" unless m
+
+        csrf_token = m[1]
+        cookies = extract_cookies(resp)
+        cookie_str = cookies.map { |k, v| "#{k}=#{v}" }.join("; ")
+        raise "tempgmailer: 未获取到 session cookie" if cookie_str.empty?
+
+        [csrf_token, cookie_str]
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        csrf_token, cookie_str = init_session
+
+        headers = HEADERS.merge(
+          "X-CSRF-TOKEN" => csrf_token,
+          "Cookie" => cookie_str
+        )
+
+        resp = Http.post("#{BASE_URL}/get-gmail", headers: headers,
+                                                   json: { "refresh" => true, "adblock" => 0 })
+        resp.raise_for_status
+        data = resp.json
+        raise "tempgmailer: 创建邮箱失败: #{data['message'] || '未知错误'}" unless data["success"]
+
+        email = ((data["data"] || {})["email"] || "").strip
+        raise "tempgmailer: 创建邮箱失败，未返回邮箱地址" if email.empty?
+
+        token_payload = JSON.generate({ "csrfToken" => csrf_token, "cookies" => cookie_str })
+        EmailInfo.new(channel: CHANNEL, email: email, token: token_payload)
+      end
+
+      # 获取邮件列表
+      # @param token [String] JSON 格式认证信息
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        session = JSON.parse(token)
+        csrf_token = session["csrfToken"]
+        cookie_str = session["cookies"]
+
+        headers = HEADERS.merge(
+          "X-CSRF-TOKEN" => csrf_token,
+          "Cookie" => cookie_str
+        )
+
+        resp = Http.post("#{BASE_URL}/get-inbox", headers: headers,
+                                                   json: { "email" => email, "adblock" => 0 })
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data["success"]
+
+        messages = (data["data"] || {})["messages"] || []
+        return [] unless messages.is_a?(Array)
+
+        messages.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          from_field = msg["from"]
+          from_field = from_field["address"] if from_field.is_a?(Hash)
+          from_field = from_field.to_s
+
+          html_content = msg["body"] || msg["intro"] || ""
+          text_content = msg["intro"] || ""
+
+          raw = {
+            "id" => msg["id"] || "",
+            "from" => from_field,
+            "to" => email,
+            "subject" => msg["subject"] || "",
+            "text" => text_content,
+            "html" => html_content,
+            "date" => msg["createdAt"] || ""
+          }
+          Normalize.normalize_email(raw, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempgo_email.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # tempgo-email 渠道 — https://tempgo.email
+    # POST /api/generate 创建邮箱，GET /api/inbox 获取邮件
+    module TempgoEmail
+      CHANNEL = "tempgo-email"
+      BASE_URL = "https://tempgo.email"
+
+      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"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/generate", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        body = resp.json
+        raise "tempgo-email: 响应格式无效" unless body.is_a?(Hash)
+
+        address = body["email"] || ""
+        mailbox_id = body["mailbox_id"] || ""
+        raise "tempgo-email: 缺少邮箱地址" if address.empty?
+        raise "tempgo-email: 缺少 mailbox_id" if mailbox_id.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: address, token: mailbox_id)
+      end
+
+      # 获取邮件列表
+      # @param token [String] mailbox_id
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        raise "tempgo-email: token 不能为空" if token.nil? || token.empty?
+
+        address = (email || "").strip
+        raise "tempgo-email: 缺少邮箱地址" if address.empty?
+
+        resp = Http.get("#{BASE_URL}/api/inbox?email=#{URI.encode_www_form_component(address)}&mailbox_id=#{URI.encode_www_form_component(token)}",
+                        headers: HEADERS, timeout: 15)
+        return [] if resp.status_code == 404
+        resp.raise_for_status
+
+        body = resp.json
+        return [] unless body.is_a?(Hash)
+
+        messages = body["messages"]
+        return [] unless messages.is_a?(Array) && !messages.empty?
+
+        messages.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          raw = {
+            "id" => msg["id"] || "",
+            "from" => msg["from"] || msg["sender"] || "",
+            "to" => address,
+            "subject" => msg["subject"] || "",
+            "text" => msg["text"] || msg["body_plain"] || "",
+            "html" => msg["html"] || msg["body_html"] || "",
+            "date" => (msg["date"] || msg["received_at"] || "").to_s
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempinbox.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # TempInbox 渠道实现
+    # API: https://endpoint.tempinbox.xyz
+    module Tempinbox
+      CHANNEL = "tempinbox"
+      BASE = "https://endpoint.tempinbox.xyz"
+
+      # 支持的域名列表
+      DOMAINS = %w[tempinbox.xyz thepiratebay.cloud cryptoblad.nl].freeze
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Cache-Control" => "no-cache",
+        "DNT" => "1",
+        "Referer" => "https://www.tempinbox.xyz/",
+        "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_user(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        if domain && !domain.to_s.strip.empty?
+          d = domain.strip.downcase
+          raise "tempinbox: 域名不可用: #{d}" unless DOMAINS.include?(d)
+
+          user = random_user
+          addr = "#{user}@#{d}"
+          Http.get("#{BASE}/email/#{addr}", headers: HEADERS, timeout: 15).raise_for_status
+        else
+          resp = Http.get("#{BASE}/email/Random", headers: HEADERS, timeout: 15)
+          resp.raise_for_status
+          addr = resp.body.strip.delete('"')
+        end
+
+        raise "tempinbox: 无效的邮箱地址" if addr.to_s.empty? || !addr.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: addr)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        addr = email.to_s.strip
+        raise "tempinbox: 邮箱地址为空" if addr.empty?
+
+        resp = Http.get("#{BASE}/messages/#{addr}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Array)
+
+        data.select { |raw| raw.is_a?(Hash) }.map do |raw|
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # tempmail.ing 渠道实现
+    # API: https://api.tempmail.ing/api
+    module Tempmail
+      CHANNEL = "tempmail"
+      BASE_URL = "https://api.tempmail.ing/api"
+
+      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",
+        "Referer" => "https://tempmail.ing/",
+        "DNT" => "1"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱，支持自定义有效期（分钟）
+      # @param duration [Integer]
+      # @return [EmailInfo]
+      def generate_email(duration = 30)
+        resp = Http.post("#{BASE_URL}/generate", headers: DEFAULT_HEADERS, json: { "duration" => duration })
+        resp.raise_for_status
+        data = resp.json
+        raise "Failed to generate email" unless data["success"]
+
+        info = data["email"]
+        EmailInfo.new(
+          channel: CHANNEL,
+          email: info["address"],
+          expires_at: info["expiresAt"],
+          created_at: info["createdAt"]
+        )
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        resp = Http.get("#{BASE_URL}/emails/#{URI.encode_www_form_component(email)}", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        raise "Failed to get emails" unless data["success"]
+
+        (data["emails"] || []).map { |raw| Normalize.normalize_email(flatten(raw, email), email) }
+      end
+
+      # 将原始格式扁平化：content -> html, from_address -> from, received_at -> date
+      def flatten(raw, recipient)
+        {
+          "id" => raw["id"] || "",
+          "from" => raw["from_address"] || raw["from"] || "",
+          "to" => recipient,
+          "subject" => raw["subject"] || "",
+          "text" => raw["text"] || "",
+          "html" => raw["content"] || raw["html"] || "",
+          "date" => raw["received_at"] || raw["date"] || "",
+          "is_read" => raw["is_read"] == 1 || raw["is_read"] == true,
+          "attachments" => raw["attachments"] || []
+        }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail365.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "time"
+
+module TempmailSdk
+  module Providers
+    # Tempmail365 渠道实现
+    # API: https://tempmail365.cn/tempemail.php
+    module Tempmail365
+      CHANNEL = "tempmail365"
+      BASE = "https://tempmail365.cn/tempemail.php"
+
+      # 后备域名列表
+      FALLBACK_DOMAINS = %w[fengyou.cc shop345.com nutemail.com qvrf.cn].freeze
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Cache-Control" => "no-cache",
+        "DNT" => "1",
+        "Referer" => "https://tempmail365.cn/",
+        "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
+
+      # 从 API 获取可用域名列表
+      def fetch_domains
+        resp = Http.get("#{BASE}?action=get_config", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return FALLBACK_DOMAINS.dup unless data.is_a?(Hash)
+
+        raw = data["domains"]
+        return FALLBACK_DOMAINS.dup unless raw.is_a?(Array) && !raw.empty?
+
+        out = raw.select { |d| d.is_a?(String) && !d.strip.empty? }.map(&:strip)
+        out.empty? ? FALLBACK_DOMAINS.dup : out
+      rescue StandardError
+        FALLBACK_DOMAINS.dup
+      end
+
+      # 生成随机用户名
+      def random_username(length = 8)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 从 HTML 邮件内容中提取发件人
+      def extract_sender(content)
+        m = content.match(/(?:发件人|From)\s*[:：]\s*(.+?)(?:<br|<\/|<p|\n|\r)/i)
+        m ? m[1].strip : ""
+      end
+
+      # 从 HTML 邮件内容中提取主题
+      def extract_subject(content)
+        m = content.match(/(?:主题|Subject)\s*[:：]\s*(.+?)(?:<br|<\/|<p|\n|\r)/i)
+        m ? m[1].strip : ""
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        domains = fetch_domains
+        raise "tempmail365: 无可用域名" if domains.empty?
+
+        if domain && !domain.to_s.strip.empty?
+          d = domain.strip.downcase
+          matched = domains.select { |x| x.downcase == d }
+          raise "tempmail365: 域名不可用: #{d}" if matched.empty?
+
+          selected = matched.first
+        else
+          selected = domains.sample
+        end
+
+        username = random_username
+        addr = "#{username}@#{selected}"
+
+        url = "#{BASE}?action=create_email&email=#{URI.encode_www_form_component(addr)}&domain=#{URI.encode_www_form_component(selected)}"
+        resp = Http.get(url, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmail365: 创建邮箱失败" unless data.is_a?(Hash) && data["success"]
+
+        EmailInfo.new(channel: CHANNEL, email: addr)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        addr = email.to_s.strip
+        raise "tempmail365: 邮箱地址为空" if addr.empty?
+
+        resp = Http.get("#{BASE}?action=fetch_mail&email=#{URI.encode_www_form_component(addr)}",
+                        headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        content = data["content"]
+        return [] if content.nil? || !content.is_a?(String) || content.strip.empty?
+        return [] if content.strip == "无邮件"
+
+        sender = extract_sender(content)
+        subject = extract_subject(content)
+
+        raw = {
+          "from" => sender,
+          "subject" => subject,
+          "body" => content,
+          "date" => Time.now.utc.iso8601
+        }
+        [Normalize.normalize_email(raw, addr)]
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail_fish.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # TempMail Fish 渠道 — https://tempmail.fish
+    # POST /emails/new-email 创建邮箱，GET /emails/emails 获取邮件
+    module TempmailFish
+      CHANNEL = "tempmail-fish"
+      API_BASE = "https://api.tempmail.fish"
+      HEADERS = {
+        "Accept" => "application/json",
+        "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
+
+      # 将毫秒时间戳转换为 ISO8601 字符串
+      def to_iso(timestamp)
+        return "" if timestamp.nil?
+
+        millis = Float(timestamp)
+        Time.at(millis / 1000.0).utc.iso8601
+      rescue ArgumentError, TypeError
+        ""
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{API_BASE}/emails/new-email",
+                         headers: HEADERS.merge("Content-Type" => "application/json"))
+        resp.raise_for_status
+        data = resp.json
+        raise "tempmail-fish: 创建邮箱响应无效" unless data.is_a?(Hash)
+
+        email = (data["email"] || "").strip
+        auth_key = (data["authKey"] || "").strip
+        raise "tempmail-fish: 创建邮箱响应无效" if email.empty? || !email.include?("@") || auth_key.empty?
+
+        token = JSON.generate({ "email" => email, "authKey" => auth_key })
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # @param token [String] JSON 字符串
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        raise "tempmail-fish: token 不能为空" if token.nil? || token.empty?
+
+        parsed = JSON.parse(token)
+        raise "tempmail-fish: token 格式无效" unless parsed.is_a?(Hash)
+
+        address = (parsed["email"] || email || "").strip
+        auth_key = (parsed["authKey"] || "").strip
+        raise "tempmail-fish: token 缺少 email 或 authKey" if address.empty? || auth_key.empty?
+
+        resp = Http.get("#{API_BASE}/emails/emails?emailAddress=#{URI.encode_www_form_component(address)}",
+                        headers: HEADERS.merge("Authorization" => auth_key))
+        resp.raise_for_status
+        data = resp.json
+
+        rows = if data.is_a?(Array)
+                 data
+               elsif data.is_a?(Hash) && data["emails"].is_a?(Array)
+                 data["emails"]
+               else
+                 []
+               end
+
+        rows.filter_map do |row|
+          next unless row.is_a?(Hash)
+
+          raw = {
+            "from" => (row["from"] || "").to_s,
+            "to" => (row["to"] || "").to_s.empty? ? address : row["to"].to_s,
+            "subject" => (row["subject"] || "").to_s,
+            "text" => (row["textBody"] || "").to_s,
+            "html" => (row["htmlBody"] || "").to_s,
+            "date" => to_iso(row["timestamp"]),
+            "attachments" => row["attachments"] || []
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end