tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/freecustom.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # freecustom.email 渠道实现
+    # 免注册临时邮箱，任意 local part @ 可用域名即时可收信
+    module Freecustom
+      CHANNEL = "freecustom"
+      SITE_URL = "https://www.freecustom.email"
+      DOMAINS_URL = "https://api2.freecustom.email/domains"
+      REFERER = "https://www.freecustom.email/en"
+      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
+
+      def get_ua
+        cfg = Config.get_config
+        (cfg.headers || {})["User-Agent"] || DEFAULT_UA
+      end
+
+      def random_local(n = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(n) { chars.sample }.join
+      end
+
+      def first_val(msg, *keys)
+        keys.each do |key|
+          val = msg[key]
+          return val.to_s if !val.nil? && val != ""
+        end
+        ""
+      end
+
+      # 挑选一个可收信域名
+      def pick_domain
+        resp = Http.get(
+          DOMAINS_URL,
+          headers: { "User-Agent" => get_ua, "Accept" => "application/json", "Referer" => REFERER }
+        )
+        resp.raise_for_status
+        data = resp.json
+        lst = data.is_a?(Hash) ? data["data"] : nil
+        raise "freecustom: domain list empty" unless lst.is_a?(Array) && !lst.empty?
+
+        usable = lst.select do |d|
+          d.is_a?(Hash) && d["tier"] == "free" && d["expiring_soon"] != true && !d["domain"].to_s.empty?
+        end
+        pool = usable.empty? ? lst.select { |d| d.is_a?(Hash) && !d["domain"].to_s.empty? } : usable
+        raise "freecustom: no usable domain" if pool.empty?
+
+        pool.sample["domain"].to_s
+      end
+
+      # 获取匿名访问令牌
+      def fetch_auth_token
+        resp = Http.post(
+          "#{SITE_URL}/api/auth",
+          headers: {
+            "User-Agent" => get_ua, "Accept" => "application/json",
+            "Content-Type" => "application/json", "Referer" => REFERER
+          }
+        )
+        resp.raise_for_status
+        data = resp.json
+        raise "freecustom: invalid token response" unless data.is_a?(Hash) && !data["token"].to_s.empty?
+
+        data["token"].to_s
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        domain = pick_domain
+        email = "#{random_local}@#{domain}"
+        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 "freecustom: missing email" if addr.empty?
+
+        jwt = fetch_auth_token
+        auth_headers = {
+          "User-Agent" => get_ua, "Accept" => "application/json",
+          "Referer" => REFERER, "Authorization" => "Bearer #{jwt}",
+          "x-fce-client" => "web-client"
+        }
+
+        list_resp = Http.get(
+          "#{SITE_URL}/api/public-mailbox?fullMailboxId=#{URI.encode_www_form_component(addr)}",
+          headers: auth_headers
+        )
+        list_resp.raise_for_status
+        list_data = list_resp.json
+        return [] unless list_data.is_a?(Hash) && list_data["success"]
+
+        items = list_data["data"]
+        return [] unless items.is_a?(Array)
+
+        items.select { |i| i.is_a?(Hash) && i["id"] }.map do |item|
+          msg_id = item["id"].to_s
+          full = item
+          begin
+            msg_resp = Http.get(
+              "#{SITE_URL}/api/public-mailbox?fullMailboxId=#{URI.encode_www_form_component(addr)}" \
+              "&messageId=#{URI.encode_www_form_component(msg_id)}",
+              headers: auth_headers
+            )
+            if msg_resp.ok?
+              msg_data = msg_resp.json
+              if msg_data.is_a?(Hash) && msg_data["success"] && msg_data["data"].is_a?(Hash)
+                full = msg_data["data"]
+              end
+            end
+          rescue StandardError
+            # 正文补全失败时退回列表元数据
+          end
+
+          row = {
+            "id" => first_val(full, "id"),
+            "from" => first_val(full, "from"),
+            "to" => first_val(full, "to").empty? ? addr : first_val(full, "to"),
+            "subject" => first_val(full, "subject"),
+            "text" => first_val(full, "text"),
+            "html" => first_val(full, "html"),
+            "date" => first_val(full, "date")
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/getnada.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "securerandom"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # GetNada 渠道实现 -- https://getnada.net
+    # 匿名 JSON API：拉取公开域名 -> 开信箱换取 token -> 拉取邮件列表/详情
+    module Getnada
+      CHANNEL = "getnada"
+      API_BASE = "https://getnada.net/api"
+      HEADERS_JSON = { "Accept" => "application/json" }.freeze
+      HEADERS_POST = { "Accept" => "application/json", "Content-Type" => "application/json" }.freeze
+      # 单个域名标签校验（大小写不敏感）
+      DOMAIN_LABEL_RE = /\A[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\z/i.freeze
+
+      module_function
+
+      # 生成随机本地部分：sdk + 16 位小写字母数字
+      def random_local
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        "sdk" + Array.new(16) { chars.sample }.join
+      end
+
+      # 清洗并校验域名，非法返回空串
+      def clean_domain(value)
+        domain = value.to_s.strip.downcase
+        return "" if domain.empty? || domain.length > 253 || domain.include?("..")
+
+        labels = domain.split(".")
+        return "" if labels.length < 2
+        return "" unless labels.all? { |label| DOMAIN_LABEL_RE.match?(label) }
+
+        domain
+      end
+
+      # 拉取公开域名列表，按偏好挑选，缺省优先 getnada.net
+      # @param preferred [String, nil]
+      # @return [String]
+      def pick_domain(preferred = nil)
+        resp = Http.get("#{API_BASE}/public/domains", headers: HEADERS_JSON, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        domains = data.is_a?(Hash) ? data["domains"] : []
+        domains = [] unless domains.is_a?(Array)
+        cleaned = domains.map { |d| clean_domain(d) }.reject(&:empty?)
+
+        wanted = preferred.to_s.strip.sub(/\A@/, "").downcase
+        unless wanted.empty?
+          found = cleaned.find { |d| d == wanted }
+          return found if found
+
+          raise "getnada: domain not available: #{wanted}"
+        end
+
+        default = cleaned.find { |d| d == "getnada.net" }
+        return default if default
+        return cleaned.first unless cleaned.empty?
+
+        raise "getnada: no domain available"
+      end
+
+      # 将原始邮件对象展平为 normalize 可识别的字段
+      def flatten_message(raw, recipient)
+        out = raw.dup
+        out["id"] = raw["id"]
+        out["from"] = first_non_empty(raw["from_addr"], raw["from"])
+        out["to"] = first_non_empty(raw["to"]).empty? ? recipient : raw["to"]
+        out["text"] = first_non_empty(raw["text_plain"], raw["text"])
+        out["html"] = first_non_empty(raw["html_sanitized"], raw["html"])
+        out["read"] = !raw["read_at"].to_s.empty? if raw.key?("read_at")
+        out
+      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
+
+      # 生成临时邮箱：选域名 -> 开信箱 -> 取 token/recipient
+      # @param domain [String, nil] 指定域名（多渠道别名派生用）
+      # @param channel [String] 渠道标识
+      # @return [EmailInfo]
+      def generate_email(domain = nil, channel = CHANNEL)
+        selected_domain = pick_domain(domain)
+        requested = "#{random_local}@#{selected_domain}"
+        resp = Http.post("#{API_BASE}/inbox/open", headers: HEADERS_POST,
+                                                   json: { "email" => requested }, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "getnada: invalid open response" unless data.is_a?(Hash)
+
+        token = data["token"].to_s.strip
+        email = (data["recipient"] || requested).to_s.strip
+        raise "getnada: invalid open response" if token.empty? || email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: channel, email: email, token: token, expires_at: data["activeUntil"])
+      end
+
+      # 拉取单封邮件详情，失败返回 nil
+      def fetch_detail(token, message_id)
+        url = "#{API_BASE}/inbox/message?id=#{URI.encode_www_form_component(message_id)}" \
+              "&token=#{URI.encode_www_form_component(token)}"
+        resp = Http.get(url, headers: HEADERS_JSON, timeout: 15)
+        return nil unless resp.ok?
+
+        data = resp.json
+        return data["message"] if data.is_a?(Hash) && data["message"].is_a?(Hash)
+
+        nil
+      end
+
+      # 拉取邮件列表并逐封获取详情
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        auth = token.to_s.strip
+        address = email.to_s.strip
+        raise "getnada: empty token" if auth.empty?
+        raise "getnada: empty email" if address.empty?
+
+        resp = Http.get("#{API_BASE}/inbox/messages?token=#{URI.encode_www_form_component(auth)}",
+                        headers: HEADERS_JSON, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        rows = data.is_a?(Hash) ? data["messages"] : []
+        return [] unless rows.is_a?(Array)
+
+        rows.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          message_id = item["id"].to_s.strip
+          detail = message_id.empty? ? nil : fetch_detail(auth, message_id)
+          Normalize.normalize_email(flatten_message(detail || item, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/gonebox_email.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # gonebox.email 渠道实现
+    # 一次性临时邮箱服务，无需认证
+    module GoneboxEmail
+      CHANNEL = "gonebox-email"
+      BASE_URL = "https://api.gonebox.email/api/v1"
+      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
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post(
+          "#{BASE_URL}/inboxes",
+          headers: HEADERS,
+          json: { "domain" => "gonebox.email" },
+          timeout: 15
+        )
+        resp.raise_for_status
+        body = resp.json
+        raise "gonebox-email: create failed" unless body.is_a?(Hash) && body["success"]
+
+        data = body["data"]
+        raise "gonebox-email: invalid data" unless data.is_a?(Hash)
+
+        address = data["address"].to_s
+        raise "gonebox-email: missing address" if address.empty?
+
+        # expiresAt 为秒级时间戳，转为毫秒
+        expires_at = nil
+        raw_expires = data["expiresAt"]
+        if raw_expires
+          begin
+            expires_at = raw_expires.to_i * 1000
+          rescue StandardError
+            # 忽略
+          end
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: address, token: "", expires_at: expires_at)
+      end
+
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        address = email.to_s.strip
+        raise "gonebox-email: missing email" if address.empty?
+
+        headers = HEADERS.reject { |k, _| k == "Content-Type" }
+        resp = Http.get("#{BASE_URL}/inboxes/#{address}/messages", headers: headers, timeout: 15)
+        return [] if resp.status_code == 404
+
+        resp.raise_for_status
+        body = resp.json
+        return [] unless body.is_a?(Hash) && body["success"]
+
+        data = body["data"]
+        return [] unless data.is_a?(Hash)
+
+        messages = data["messages"]
+        return [] unless messages.is_a?(Array) && !messages.empty?
+
+        messages.select { |m| m.is_a?(Hash) }.map do |msg|
+          raw = {
+            "id" => msg["id"].to_s,
+            "from" => (msg["from"] || msg["sender"]).to_s,
+            "to" => address,
+            "subject" => msg["subject"].to_s,
+            "text" => (msg["text"] || msg["body_plain"]).to_s,
+            "html" => (msg["html"] || msg["body_html"]).to_s,
+            "date" => (msg["date"] || msg["received_at"]).to_s,
+            "is_read" => false,
+            "attachments" => []
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/guerrillamail.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # guerrillamail.com 渠道实现
+    # API: https://api.guerrillamail.com/ajax.php
+    module Guerrillamail
+      CHANNEL = "guerrillamail"
+      BASE_URL = "https://api.guerrillamail.com/ajax.php"
+      DEFAULT_HEADERS = {
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+      }.freeze
+
+      module_function
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}?f=get_email_address&lang=en", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        if data["email_addr"].to_s.empty? || data["sid_token"].to_s.empty?
+          raise "Failed to generate email: missing email_addr or sid_token"
+        end
+
+        expires_at = nil
+        expires_at = (data["email_timestamp"] + 3600) * 1000 if data["email_timestamp"]
+        EmailInfo.new(channel: CHANNEL, email: data["email_addr"], token: data["sid_token"], expires_at: expires_at)
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        sid = URI.encode_www_form_component(token)
+        resp = Http.get("#{BASE_URL}?f=check_email&seq=0&sid_token=#{sid}", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        list = resp.json["list"]
+        return [] unless list.is_a?(Array)
+
+        list.map do |item|
+          body = item["mail_body"].to_s
+          if body.empty? && item["mail_id"]
+            begin
+              mid = URI.encode_www_form_component(item["mail_id"].to_s)
+              dr = Http.get("#{BASE_URL}?f=fetch_email&sid_token=#{sid}&email_id=#{mid}", headers: DEFAULT_HEADERS)
+              body = dr.json["mail_body"].to_s if dr.ok?
+            rescue StandardError
+              # 忽略单封详情失败
+            end
+          end
+          text = item["mail_excerpt"].to_s
+          text = body.gsub(/<[^>]+>/, " ").split.join(" ") if text.empty?
+          Normalize.normalize_email({
+                                      "id" => item["mail_id"], "from" => item["mail_from"], "to" => email,
+                                      "subject" => item["mail_subject"], "text" => text, "html" => body,
+                                      "date" => item["mail_date"] || "", "isRead" => item["mail_read"] == 1
+                                    }, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/guerrillamail_mirrors.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Guerrillamail 镜像渠道实现
+    # sharklasers.com / grr.la / guerrillamail.info / spam4.me 等共用同一套 ajax.php API，仅 baseURL 不同
+    module GuerrillamailMirrors
+      DEFAULT_HEADERS = {
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+      }.freeze
+
+      # 各镜像渠道的固定 baseURL 表
+      BASE_URLS = {
+        "sharklasers" => "https://www.sharklasers.com/ajax.php",
+        "grr-la" => "https://www.grr.la/ajax.php",
+        "guerrillamail-info" => "https://www.guerrillamail.info/ajax.php",
+        "spam4me" => "https://www.spam4.me/ajax.php",
+        "guerrillamail-com" => "https://guerrillamail.com/ajax.php",
+        "sharklasers-com" => "https://sharklasers.com/ajax.php",
+        "grr-la-com" => "https://grr.la/ajax.php",
+        "guerrillamail-net" => "https://www.guerrillamail.net/ajax.php",
+        "guerrillamail-org" => "https://www.guerrillamail.org/ajax.php",
+        "guerrillamailblock" => "https://www.guerrillamailblock.com/ajax.php",
+        "guerrillamail-com-www" => "https://www.guerrillamail.com/ajax.php"
+      }.freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # @param channel [String] 渠道标识
+      # @return [EmailInfo]
+      def generate_email(channel)
+        base_url = BASE_URLS.fetch(channel)
+        resp = Http.get("#{base_url}?f=get_email_address&lang=en", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        if data["email_addr"].to_s.empty? || data["sid_token"].to_s.empty?
+          raise "#{channel}: missing email_addr or sid_token"
+        end
+
+        expires_at = nil
+        expires_at = (data["email_timestamp"] + 3600) * 1000 if data["email_timestamp"]
+        EmailInfo.new(channel: channel, email: data["email_addr"], token: data["sid_token"], expires_at: expires_at)
+      end
+
+      # 获取邮件列表，对无正文的邮件调用 fetch_email 拉取完整正文
+      # @param channel [String] 渠道标识
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(channel, email, token)
+        base_url = BASE_URLS.fetch(channel)
+        sid = URI.encode_www_form_component(token)
+        resp = Http.get("#{base_url}?f=check_email&seq=0&sid_token=#{sid}", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+        list = resp.json["list"]
+        return [] unless list.is_a?(Array)
+
+        list.map do |item|
+          body = item["mail_body"].to_s
+          if body.empty? && item["mail_id"]
+            begin
+              mid = URI.encode_www_form_component(item["mail_id"].to_s)
+              dr = Http.get("#{base_url}?f=fetch_email&sid_token=#{sid}&email_id=#{mid}", headers: DEFAULT_HEADERS)
+              body = dr.json["mail_body"].to_s if dr.ok?
+            rescue StandardError
+              # 忽略单封详情失败
+            end
+          end
+          text = body.empty? ? item["mail_excerpt"].to_s : body.gsub(/<[^>]+>/, " ")
+          text = text.split.join(" ")
+          Normalize.normalize_email({
+                                      "id" => item["mail_id"], "from" => item["mail_from"], "to" => email,
+                                      "subject" => item["mail_subject"], "text" => text, "html" => body,
+                                      "date" => item["mail_date"] || "", "isRead" => item["mail_read"] == 1
+                                    }, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/harakirimail.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # harakirimail.com 渠道实现
+    # 无需认证、无需 Cookie、无需 Token 的简单 REST API
+    module Harakirimail
+      CHANNEL = "harakirimail"
+      BASE = "https://harakirimail.com"
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;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_name(length = 12)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        name = random_name
+        email = "#{name}@harakirimail.com"
+
+        # 调用收件箱接口验证地址可用
+        resp = Http.get("#{BASE}/api/v1/inbox/#{name}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+
+        EmailInfo.new(channel: CHANNEL, email: email)
+      end
+
+      # 获取单封邮件正文
+      def fetch_body(email_id)
+        return {} if email_id.to_s.empty?
+
+        begin
+          resp = Http.get("#{BASE}/api/v1/email/#{email_id}", headers: HEADERS, timeout: 15)
+          resp.raise_for_status
+          data = resp.json
+          data.is_a?(Hash) ? data : {}
+        rescue StandardError
+          {}
+        end
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        e = email.to_s.strip
+        raise "harakirimail: empty email" if e.empty?
+
+        name = e.include?("@") ? e.split("@").first.to_s : e
+
+        resp = Http.get("#{BASE}/api/v1/inbox/#{name}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        rows = data["emails"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map do |raw|
+          email_id = raw["_id"].to_s
+          detail = fetch_body(email_id)
+          flat = {
+            "id" => email_id,
+            "from" => raw["from"].to_s,
+            "to" => e,
+            "subject" => raw["subject"].to_s,
+            "date" => raw["received"].to_s,
+            "html" => (detail["body_html"] || detail["html"]).to_s,
+            "text" => (detail["body_text"] || detail["text"]).to_s,
+            "isRead" => false
+          }
+          Normalize.normalize_email(flat, e)
+        end
+      end
+    end
+  end
+end