tempmail_sdk 1.3.3 → 1.3.4

data/lib/tempmail_sdk/providers/mytempmail_cc.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # mytempmail.cc 渠道实现
+    #
+    # 流程：POST /api/address 创建邮箱（JSON body），返回 token + address
+    #       GET /api/mails/{token} 获取邮件列表
+    # 域名固定 nilvaro.com，有效期 600 秒
+    module MytempmailCc
+      CHANNEL = "mytempmail-cc"
+      BASE_URL = "https://api.mytempmail.cc"
+
+      HEADERS = {
+        "Content-Type" => "application/json",
+        "Accept" => "application/json"
+      }.freeze
+
+      CHARS = ("a".."z").to_a.freeze
+
+      module_function
+
+      # 生成随机 8 位小写字母用户名
+      # @return [String]
+      def random_name
+        Array.new(8) { CHARS.sample }.join
+      end
+
+      # 创建 mytempmail.cc 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        body = JSON.generate("domain" => "nilvaro.com", "name" => random_name, "expiry" => 600)
+        resp = Http.post(BASE_URL + "/api/address", headers: HEADERS, body: body, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        email = data["address"].to_s.strip
+        token = data["token"].to_s.strip
+        raise "mytempmail-cc: 无效的邮箱响应" if email.empty? || !email.include?("@")
+        raise "mytempmail-cc: 响应中缺少 token" if token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 mytempmail.cc 邮件列表
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        token = token.to_s.strip
+        raise "mytempmail-cc: token 为空" if token.empty?
+
+        resp = Http.get("#{BASE_URL}/api/mails/#{token}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        results = data.is_a?(Hash) ? Array(data["results"]) : []
+
+        results.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          flat = {
+            "id" => msg["id"],
+            "from" => msg["from"],
+            "to" => email,
+            "subject" => msg["subject"],
+            "text" => msg["body_text"],
+            "html" => msg["body_html"],
+            "received_at" => msg["received_at"]
+          }
+          Normalize.normalize_email(flat, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/openinbox.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # openinbox.io 渠道实现
+    #
+    # 流程：POST /api/inbox 创建邮箱，返回 id + email
+    #       GET /api/emails/inbox/{id}?page=1&limit=50 获取邮件列表
+    #       GET /api/emails/{messageId} 获取邮件详情
+    # token 存储 inbox id
+    module Openinbox
+      CHANNEL = "openinbox"
+      BASE_URL = "https://api.openinbox.io/api"
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Origin" => "https://openinbox.io",
+        "Referer" => "https://openinbox.io/",
+        "User-Agent" => "Mozilla/5.0"
+      }.freeze
+
+      module_function
+
+      # 发起 JSON 请求
+      # @param method [String] "GET" 或 "POST"
+      # @param url [String]
+      # @return [Object] 解析后的 JSON
+      def json_request(method, url)
+        hdrs = HEADERS.dup
+        hdrs["Content-Type"] = "application/json" if method == "POST"
+        resp = method == "POST" ? Http.post(url, headers: hdrs, timeout: 15) : Http.get(url, headers: hdrs, timeout: 15)
+        resp.raise_for_status
+        resp.json
+      end
+
+      # 将邮件 raw map 展平为标准字段
+      # @param raw [Hash]
+      # @param recipient [String]
+      # @return [Hash]
+      def flatten(raw, recipient)
+        {
+          "id" => raw["id"],
+          "from" => raw["from"],
+          "to" => recipient,
+          "subject" => raw["subject"],
+          "text" => raw["textBody"],
+          "html" => raw["htmlBody"],
+          "receivedAt" => raw["receivedAt"],
+          "isRead" => raw["isRead"],
+          "attachments" => []
+        }
+      end
+
+      # 创建 openinbox.io 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        data = json_request("POST", BASE_URL + "/inbox")
+        id = data["id"].to_s.strip
+        email = data["email"].to_s.strip
+        raise "openinbox: 无效的邮箱响应" if id.empty? || email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: id)
+      end
+
+      # 获取 openinbox.io 邮件列表
+      # @param inbox_id [String] inbox id（token）
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(inbox_id, email)
+        inbox_id = inbox_id.to_s.strip
+        raise "openinbox: empty inbox id" if inbox_id.empty?
+
+        url = "#{BASE_URL}/emails/inbox/#{URI.encode_uri_component(inbox_id)}?page=1&limit=50"
+        data = json_request("GET", url)
+        rows = data.is_a?(Hash) ? Array(data["emails"]) : []
+
+        rows.filter_map do |row|
+          next unless row.is_a?(Hash)
+
+          raw = row
+          msg_id = row["id"].to_s.strip
+          unless msg_id.empty?
+            detail = fetch_detail(msg_id)
+            raw = detail if detail.is_a?(Hash)
+          end
+          Normalize.normalize_email(flatten(raw, email), email)
+        end
+      end
+
+      # 获取单封邮件详情
+      # @param message_id [String]
+      # @return [Hash, nil]
+      def fetch_detail(message_id)
+        json_request("GET", "#{BASE_URL}/emails/#{URI.encode_uri_component(message_id)}")
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/smail_pw.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # smail.pw 渠道实现
+    #
+    # 流程：POST /_root.data body: intent=generate 创建邮箱，保存 __session cookie
+    #       GET /_root.data + Cookie 获取邮件列表（解析 React Flight 格式或正则提取）
+    #       GET /api/email/{id} 获取单封邮件正文
+    # token 存储 __session=xxx cookie 字符串
+    module SmailPw
+      CHANNEL = "smail-pw"
+      ROOT_DATA_URL = "https://smail.pw/_root.data"
+
+      HEADERS = {
+        "Accept" => "*/*",
+        "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",
+        "dnt" => "1",
+        "origin" => "https://smail.pw",
+        "pragma" => "no-cache",
+        "referer" => "https://smail.pw/",
+        "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
+
+      QUOTED_INBOX_RE = /"([a-z0-9][a-z0-9.\-]*@smail\.pw)"/i
+      PLAIN_INBOX_RE  = /\b([a-z0-9][a-z0-9.\-]*@smail\.pw)\b/i
+      MAIL_BLOCK_RE   = /"id","([^"]+)","to_address","([^"]*)","from_name","([^"]*)","from_address","([^"]*)","subject","([^"]*)","time",(\d+)/
+      MAIL_BLOCK2_RE  = /"id","([^"]+)","from_name","([^"]*)","from_address","([^"]*)","subject","([^"]*)","time",(\d+)/
+
+      module_function
+
+      # 从响应 Set-Cookie 中提取 __session cookie
+      # @param set_cookie_lines [Array<String>]
+      # @return [String]
+      def extract_session(set_cookie_lines)
+        set_cookie_lines.each do |line|
+          pair = line.split(";", 2).first.to_s.strip
+          return pair if pair.start_with?("__session=")
+        end
+        ""
+      end
+
+      # 从响应体中提取邮箱地址
+      # @param body [String]
+      # @return [String]
+      def extract_inbox(body)
+        m = body.match(QUOTED_INBOX_RE)
+        return m[1] if m
+
+        m = body.match(PLAIN_INBOX_RE)
+        m ? m[1] : ""
+      end
+
+      # 从响应体解析邮件列表
+      # @param body [String]
+      # @param recipient [String]
+      # @return [Array<Hash>]
+      def parse_mails(body, recipient)
+        out = []
+        body.scan(MAIL_BLOCK_RE) do |id, to_addr, from_name, from_addr, subj, ts|
+          out << {
+            "id" => id, "to_address" => to_addr.empty? ? recipient : to_addr,
+            "from_name" => from_name, "from_address" => from_addr,
+            "subject" => subj, "date" => ts.to_f,
+            "text" => "", "html" => "", "attachments" => []
+          }
+        end
+        return out unless out.empty?
+
+        body.scan(MAIL_BLOCK2_RE) do |id, from_name, from_addr, subj, ts|
+          out << {
+            "id" => id, "to_address" => recipient,
+            "from_name" => from_name, "from_address" => from_addr,
+            "subject" => subj, "date" => ts.to_f,
+            "text" => "", "html" => "", "attachments" => []
+          }
+        end
+        out
+      end
+
+      # 创建 smail.pw 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post(
+          ROOT_DATA_URL,
+          headers: HEADERS.merge("Content-Type" => "application/x-www-form-urlencoded;charset=UTF-8"),
+          body: "intent=generate",
+          timeout: 15
+        )
+        raise "smail.pw generate failed: #{resp.status_code}" unless resp.ok?
+
+        cookie = extract_session(resp.set_cookies)
+        raise "smail.pw: 未能提取 __session cookie" if cookie.empty?
+
+        email = extract_inbox(resp.body)
+        raise "smail.pw: 未能解析邮箱地址" if email.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: cookie)
+      end
+
+      # 获取 smail.pw 邮件列表
+      # @param token [String] __session=xxx cookie 字符串
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        resp = Http.get(
+          ROOT_DATA_URL,
+          headers: HEADERS.merge("Cookie" => token),
+          timeout: 15
+        )
+        raise "smail.pw get emails failed: #{resp.status_code}" unless resp.ok?
+
+        mails = parse_mails(resp.body, email)
+        return [] if mails.empty?
+
+        mails.map do |m|
+          ne = Normalize.normalize_email(m, email)
+          id = m["id"].to_s
+          unless id.empty?
+            body_html = fetch_body(token, id)
+            ne.html = body_html unless body_html.empty?
+          end
+          ne
+        end
+      end
+
+      # 获取单封邮件正文
+      # @param token [String]
+      # @param id [String]
+      # @return [String]
+      def fetch_body(token, id)
+        return "" if id.empty?
+
+        resp = Http.get(
+          "https://smail.pw/api/email/#{URI.encode_uri_component(id)}",
+          headers: HEADERS.merge("Cookie" => token, "Accept" => "application/json"),
+          timeout: 15
+        )
+        return "" unless resp.ok?
+
+        data = resp.json
+        data.is_a?(Hash) ? data["body"].to_s : ""
+      rescue StandardError
+        ""
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/socketio_mail.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # socketio-mail 渠道桩实现
+    #
+    # 该渠道依赖 WebSocket/Socket.IO 协议，Ruby 标准 HTTP 客户端无法实现。
+    # 当前注册为桩，调用时抛出 NotImplementedProviderError。
+    module SocketioMail
+      CHANNEL = "socketio-mail"
+
+      module_function
+
+      # @raise [NotImplementedError]
+      def generate_email
+        raise NotImplementedProviderError, "channel not implemented yet: #{CHANNEL}"
+      end
+
+      # @raise [NotImplementedError]
+      def get_emails(_email, _token)
+        raise NotImplementedProviderError, "channel not implemented yet: #{CHANNEL}"
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempgbox.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # tempgbox.net 渠道实现
+    #
+    # 流程：POST /api/proxy?route=generate 创建邮箱（JSON body，X-Device-ID 头）
+    #       POST /api/proxy?route=inbox 获取邮件列表
+    # 响应体为 HTML 页面，实际数据编码在 data-x 属性（base64 JSON）
+    # token 存储 device_id
+    module Tempgbox
+      CHANNEL = "tempgbox"
+      API_URL = "https://tempgbox.net/api/proxy"
+
+      module_function
+
+      # 生成随机 64 位十六进制 device id
+      # @return [String]
+      def random_device_id
+        require "securerandom"
+        SecureRandom.hex(32)
+      end
+
+      # 生成随机 IP 地址
+      # @return [String]
+      def random_ip
+        "#{rand(1..254)}.#{rand(1..254)}.#{rand(1..254)}.#{rand(1..254)}"
+      end
+
+      # 构造请求头
+      # @param device_id [String]
+      # @return [Hash]
+      def build_headers(device_id)
+        ip = random_ip
+        {
+          "Accept" => "text/html,application/json",
+          "Content-Type" => "application/json",
+          "Origin" => "https://tempgbox.net",
+          "Referer" => "https://tempgbox.net/",
+          "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-Device-ID" => device_id,
+          "X-Forwarded-For" => ip,
+          "X-Real-IP" => ip,
+          "X-Originating-IP" => ip
+        }
+      end
+
+      # 从响应 HTML 中解码 data-x 属性（base64 JSON）
+      # @param body [String]
+      # @return [Hash]
+      def decode_payload(body)
+        require "base64"
+        m = body.match(/data-x=["']([^"']+)["']/)
+        raise "tempgbox: 响应中缺少 data-x 属性" unless m
+
+        raw = Base64.strict_decode64(m[1])
+        JSON.parse(raw)
+      end
+
+      # 发起 POST 请求并解码响应
+      # @param route [String]
+      # @param device_id [String]
+      # @param body [Hash]
+      # @return [Hash]
+      def post_route(route, device_id, body)
+        resp = Http.post(
+          "#{API_URL}?route=#{route}",
+          headers: build_headers(device_id),
+          body: JSON.generate(body),
+          timeout: 15
+        )
+        resp.raise_for_status
+        decode_payload(resp.body)
+      end
+
+      # 创建 tempgbox.net 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        device_id = random_device_id
+        payload = post_route("generate", device_id, "variant" => "googlemail")
+        alias_data = payload["alias"]
+        raise "tempgbox: 响应缺少 alias" unless alias_data.is_a?(Hash)
+
+        email = alias_data["email"].to_s.strip
+        email = alias_data["alias"].to_s.strip if email.empty?
+        raise "tempgbox: 响应缺少 email" if email.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: device_id)
+      end
+
+      # 获取 tempgbox.net 邮件列表
+      # @param device_id [String] token
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(device_id, email)
+        raise "tempgbox: missing device id" if device_id.to_s.strip.empty?
+
+        payload = post_route("inbox", device_id, "email" => email)
+        messages = Array(payload["messages"])
+
+        messages.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          raw["from"] ||= raw["sender"]
+          raw["text"] ||= raw["body_text"]
+          raw["html"] ||= raw["body_html"]
+          raw["date"] ||= raw["received_at"]
+          raw["messageId"] ||= raw["message_id"]
+          raw["attachments"] ||= raw["attachments_info"]
+          Normalize.normalize_email(raw.merge("to" => email), email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempmail_cn.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "uri"
+require "json"
+
+module TempmailSdk
+  module Providers
+    # tempmail.cn 渠道实现（HTTP API 模式）
+    #
+    # 流程：WebSocket 创建邮箱（request mailbox 事件），获取 shortID
+    #       GET /api/mails/{email} 获取邮件列表（HTTP API）
+    # Ruby 端使用 HTTP API 拉取邮件，不实现 WebSocket 推送
+    # token 不需要（无状态 HTTP API）
+    module TempmailCn
+      CHANNEL = "tempmail-cn"
+      DEFAULT_HOST = "tempmail.cn"
+
+      module_function
+
+      # 规范化 host（去除协议前缀、路径、@ 符号等）
+      # @param domain [String, nil]
+      # @return [String]
+      def normalize_host(domain)
+        return DEFAULT_HOST if domain.nil? || domain.to_s.strip.empty?
+
+        host = domain.to_s.strip
+        if host.start_with?("http://", "https://")
+          begin
+            uri = URI.parse(host)
+            host = uri.host.to_s unless uri.host.to_s.empty?
+          rescue URI::InvalidURIError
+            nil
+          end
+        elsif host.include?("/")
+          host = host.split("/").first.to_s
+        end
+        host = host.split("@").last.to_s if host.include?("@")
+        host = host.strip.gsub(/\A\.+|\.+\z/, "")
+        host.empty? ? DEFAULT_HOST : host
+      end
+
+      # 生成随机本地部分（小写字母 + 数字）
+      # @param length [Integer]
+      # @return [String]
+      def random_local(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 创建 tempmail.cn 临时邮箱
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        host = normalize_host(domain)
+        # 直接生成随机邮箱（HTTP 模式，不走 WebSocket）
+        email = "#{random_local}@#{host}"
+        EmailInfo.new(channel: CHANNEL, email: email)
+      end
+
+      # 获取 tempmail.cn 邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        email = email.to_s.strip
+        raise "tempmail-cn: 邮箱地址为空" if email.empty?
+
+        at_idx = email.index("@")
+        host = at_idx ? email[(at_idx + 1)..] : DEFAULT_HOST
+        host = normalize_host(host)
+
+        api_url = "https://#{host}/api/mails/#{URI.encode_uri_component(email)}"
+        hdrs = {
+          "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",
+          "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",
+          "DNT" => "1",
+          "Pragma" => "no-cache",
+          "Referer" => "https://#{host}/"
+        }
+
+        resp = Http.get(api_url, headers: hdrs, timeout: 15)
+        resp.raise_for_status
+
+        data = resp.json
+        mails = data.is_a?(Hash) ? Array(data["mails"]) : []
+
+        mails.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          id = raw["id"].to_s
+          id = raw["_id"].to_s if id.empty?
+          flat = {
+            "id" => id,
+            "from" => raw["from"].to_s,
+            "to" => email,
+            "subject" => raw["subject"].to_s,
+            "text" => raw["text"].to_s,
+            "html" => raw["html"].to_s,
+            "date" => raw["date"].to_s,
+            "isRead" => false,
+            "attachments" => raw["attachments"]
+          }
+          flat["text"] = raw["body"].to_s if flat["text"].empty?
+          Normalize.normalize_email(flat, email)
+        end
+      end
+    end
+  end
+end