tempmail_sdk 1.3.4 → 1.3.6

data/lib/tempmail_sdk/providers/linshi_xyz.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # LinshiXYZ 渠道实现（linshi.xyz）
+    #
+    # 无建箱请求：本地随机 6 位 hex 前缀（官网 client 即用短 id）+ @linshi.xyz。
+    # 读信 GET https://linshi.xyz/api/mails/{前缀}，无邮件时返回空数组 []，
+    #   有邮件时为邮件对象数组（元素含 headers{from,to,subject,date} 与 html 正文）。
+    # 归一化时将 headers 平铺并注入收件人地址；非数组骨架（如 {ok:false}）整体失败，
+    # 交由上层 fallback 渠道处理。
+    module LinshiXyz
+      CHANNEL = "linshi-xyz"
+      BASE_URL = "https://linshi.xyz"
+      DOMAIN = "linshi.xyz"
+      HEX_DIGITS = "0123456789abcdef"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      module_function
+
+      # 生成本地随机 6 位 hex 前缀（与官网 client 相同格式）
+      # @return [String]
+      def local_name
+        Array.new(6) { HEX_DIGITS[rand(HEX_DIGITS.length)] }.join
+      end
+
+      # 创建 linshi.xyz 临时邮箱
+      # 无需建箱请求，本地随机 6 位 hex 前缀；token 复用完整地址。
+      # @return [EmailInfo]
+      def generate_email
+        addr = "#{local_name}@#{DOMAIN}"
+        EmailInfo.new(channel: CHANNEL, email: addr, token: addr)
+      end
+
+      # 读取 linshi.xyz 收件箱
+      # GET /api/mails/{前缀}（URL 编码），响应为邮件对象数组。
+      # @param email [String] 完整邮箱地址（前缀@linshi.xyz）
+      # @param token [String] 复用完整地址
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "linshi-xyz: 邮箱地址无效: #{addr.inspect}" if addr.empty? || !addr.include?("@")
+
+        local = addr.split("@", 2).first.to_s
+        resp = Http.get("#{BASE_URL}/api/mails/#{URI.encode_www_form_component(local)}",
+                        headers: HEADERS, timeout: 15)
+        raise "linshi-xyz: 读取收件箱失败 http #{resp.status_code}" unless resp.ok?
+
+        list = resp.json
+        raise "linshi-xyz: 收件箱响应非数组" unless list.is_a?(Array)
+
+        list.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          Normalize.normalize_email(normalize_row(m, addr), addr)
+        end
+      end
+
+      # 将 linshi.xyz 邮件对象归一化：headers 平铺为顶层字段并注入收件人。
+      # @param m [Hash] 原始邮件对象
+      # @param email [String] 收件人地址
+      # @return [Hash]
+      def normalize_row(m, email)
+        flat = m.dup
+        headers = m["headers"]
+        flat.merge!(headers) if headers.is_a?(Hash)
+        flat["to"] = email unless flat.key?("to")
+        flat
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mail_tm.rb

@@ -25,7 +25,7 @@ module TempmailSdk
         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"] }
+        members.select { |d| d["isActive"] || d["isVerified"] }.map { |d| d["domain"] }
       end
 
       def create_account(address, password)
@@ -48,7 +48,14 @@ module TempmailSdk
         domains = fetch_domains
         raise "No available domains" if domains.empty?
 
-        address = "#{random_string(12)}@#{domains.sample}"
+        generate_email_at_domain(domains.sample)
+      end
+
+      # 为 mail.tm 指定域名的镜像渠道创建账号（跳过随机选域）
+      # @param domain [String]
+      # @return [EmailInfo]
+      def generate_email_at_domain(domain)
+        address = "#{random_string(12)}@#{domain}"
         password = random_string(16)
         account = create_account(address, password)
         token = fetch_token(address, password)

data/lib/tempmail_sdk/providers/mailmomy.rb

@@ -12,7 +12,7 @@ module TempmailSdk
     #   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 等）复用同一后端，
+    # 域名变体渠道（如 17666688.shop、sbook.pics 等）复用同一后端，
     # 仅在 generate_email(domain) 传入固定域名即可，收信逻辑完全一致。
     module Mailmomy
       CHANNEL = "mailmomy"

data/lib/tempmail_sdk/providers/mailticking.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Mailticking 渠道实现（www.mailticking.com，旧域名 temporary-mail.net 的更名站）
+    #
+    # 实测协议（三类请求均以 application/json 交流，站点在 Cloudflare 后）：
+    #   1. 建箱 POST /get-mailbox body {"types":["4"]}（4=独立域名，排除 Gmail 别名）
+    #      响应 {"success":true,"email":"xxx@domain","activate_token":"..."}
+    #   2. 激活 POST /activate-email body {"email":..,"source":"api","activate_token":..}
+    #      响应 {"success":true}
+    #   3. 列信 POST /get-emails?lang=en body {"email":..,"code":..}
+    #      空箱实测响应 {"emails":[],"success":true}；空闲超时/被改绑后返回
+    #      {"success":false,"needNewEmail":true,...}，此时返回错误提示换箱。
+    #
+    # 读信正文无公开端点：GetEmails 只具备列表能力，列表字段名采用多候选提取
+    # 策略，命中多少映射多少（Normalize 既有候选字段负责兜底）。
+    module Mailticking
+      CHANNEL = "mailticking"
+      BASE_URL = "https://www.mailticking.com"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "Accept-Language" => "en-US,en;q=0.9",
+        "Content-Type" => "application/json",
+        "Referer" => "#{BASE_URL}/",
+        "Origin" => BASE_URL,
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      module_function
+
+      # 执行 JSON POST 请求并解析响应；响应非 2xx 或 success=false 时抛错
+      # @param path [String] 请求路径
+      # @param payload [Hash] JSON 请求体
+      # @return [Hash]
+      def do_post(path, payload)
+        resp = Http.post("#{BASE_URL}#{path}", headers: HEADERS, json: payload, timeout: 15)
+        data = resp.json
+        unless resp.ok?
+          msg = data.is_a?(Hash) ? (data["error"] || data["message"]).to_s : ""
+          msg = resp.body.to_s if msg.empty?
+          raise "mailticking: http #{resp.status_code}: #{msg}"
+        end
+        unless data.is_a?(Hash) && data["success"] == true
+          msg = data.is_a?(Hash) ? (data["error"] || data["message"]).to_s : ""
+          msg = "unknown error" if msg.empty?
+          raise "mailticking: 请求失败: #{msg}"
+        end
+        data
+      end
+
+      # 创建 mailticking 邮箱账号
+      # 请求 type=4（独立域名）固定取独立域名邮箱，建箱后立即激活会话；
+      # token 必须携带 activate_token（列信协议依赖激活会话），不能为空。
+      # @return [EmailInfo]
+      def generate_email
+        box = do_post("/get-mailbox", { "types" => ["4"] })
+        token = box["code"].to_s.strip
+        token = box["email"].to_s.strip if token.empty?
+        email = box["email"].to_s.strip
+        if token.empty? || email.empty?
+          raise "mailticking: get-mailbox 返回空 email/activate_token"
+        end
+
+        # 激活邮箱，使后续列信请求与服务器记录的最新会话一致
+        do_post("/activate-email", {
+                  "email" => email,
+                  "source" => "api",
+                  "activate_token" => token
+                })
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 mailticking 邮箱的邮件列表
+      # 空箱返回空列表不报错；需要换箱的响应（needNewEmail）返回语义错误。
+      # @param email [String] 邮箱地址
+      # @param token [String] 建箱返回的激活令牌
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        tk = token.to_s.strip
+        raise "mailticking: 邮箱地址为空" if addr.empty?
+        raise "mailticking: activate code 为空" if tk.empty?
+
+        resp = Http.post("#{BASE_URL}/get-emails?lang=en",
+                         headers: HEADERS,
+                         json: { "email" => addr, "code" => tk },
+                         timeout: 15)
+        data = resp.json
+        unless resp.ok?
+          msg = data.is_a?(Hash) ? (data["error"] || data["message"]).to_s : ""
+          msg = resp.body.to_s if msg.empty?
+          raise "mailticking: http #{resp.status_code}: #{msg}"
+        end
+        unless data.is_a?(Hash) && data["success"] == true
+          raise "mailticking: 邮箱已过期，请重新建箱" if data.is_a?(Hash) && data["needNewEmail"] == true
+
+          raise "mailticking: get-emails 失败"
+        end
+        emails = data["emails"]
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(migrated_fields(raw), addr)
+        end
+      end
+
+      # 尽量映射列表字段到统一字段名
+      # 官网首页表格只有 SENDER/SUBJECT/TIME 三列，字段全名缺少可观测证据，
+      # 因此对常见字段做多候选提取；未命中的字段留给 Normalize 自己处理。
+      # @param raw [Hash]
+      # @return [Hash]
+      def migrated_fields(raw)
+        m = raw.dup
+        unless m.key?("from")
+          %w[mail_from from_mail from_email sender_address from_address
+             send_addr mail_addr address_from ho_from fromname fromS].each do |key|
+            v = m[key]
+            if v.is_a?(String) && v.strip != ""
+              m["from"] = v
+              break
+            end
+          end
+        end
+        if !m.key?("sender") && m["from"].is_a?(String) && m["from"].strip != ""
+          m["sender"] = m["from"]
+        end
+        m["id"] = m["mail_id"] if !m.key?("id") && m.key?("mail_id")
+        m["date"] = m["received_at"] if !m.key?("date") && m.key?("received_at")
+        m
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mtempmail.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Mtempmail 渠道实现（mtempmail.com，公共 key 认证）
+    #
+    # 建箱: POST /api/emails/{apiKey}（空 JSON body）→
+    #   {"status":true,"data":{"email":"...@domain","domain":"..","ip":"..",
+    #    "fingerprint":"..","expire_at":"..","created_at":"..","id":..,"email_token":"..."}}
+    # 读信: GET /api/messages/{apiKey}/{email} →
+    #   {"status":true,"mailbox":"..","email_token":"..","messages":[...]}
+    #   消息为 mailgun 入站 webhook 风格：to/from 为对象数组，
+    #   body 为 [{content_type:"text/html",value:".."},...] 分段。
+    # 邮箱 24 小时有效（过期时间标注不一致，以服务端为准）。
+    module Mtempmail
+      CHANNEL = "mtempmail"
+      BASE_URL = "https://mtempmail.com"
+
+      # 公共固定 API key（mtempmail.com 官方提供）
+      PUBLIC_KEY = "pub_nRn1hUwpdmZvxQNVWDfoXgKyF7dIm9nRIIIt1qDw"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "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
+
+      # 剥离后台拼接的 "• " 前缀（或实收分隔符）
+      BULLET_RE = /^[•·]+\s*/.freeze
+
+      module_function
+
+      # 清洗主题前导分隔符（后台可能以 "• " 开头拼接微件）
+      # @param subject [String]
+      # @return [String]
+      def clean_subject(subject)
+        subject.to_s.strip.sub(BULLET_RE, "")
+      end
+
+      # 拼接正文纯文本（body[].value 按序）
+      # @param parts [Array]
+      # @return [String]
+      def body_text(parts)
+        parts.filter_map { |p| p["value"].to_s unless p.nil? || !p.is_a?(Hash) || p["value"].to_s.empty? }
+             .join("\n")
+      end
+
+      # 提取首个 text/html 段
+      # @param parts [Array]
+      # @return [String]
+      def body_html(parts)
+        parts.each do |p|
+          next unless p.is_a?(Hash) && p["content_type"].to_s == "text/html"
+
+          val = p["value"].to_s
+          return val unless val.empty?
+        end
+        ""
+      end
+
+      # 创建 mtempmail 临时邮箱
+      # POST /api/emails/{apiKey}（空 JSON body）
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/emails/#{PUBLIC_KEY}",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: {}, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        payload = data.is_a?(Hash) ? data["data"] : nil
+        email = payload.is_a?(Hash) ? payload["email"].to_s.strip : ""
+        if (data.is_a?(Hash) && !data["status"]) || email.empty?
+          raise "mtempmail: 建箱响应缺少邮箱"
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: email,
+                      token: payload["email_token"].to_s,
+                      expires_at: payload["expire_at"],
+                      created_at: payload["created_at"])
+      end
+
+      # 读取 mtempmail 收件箱
+      # GET /api/messages/{apiKey}/{email}；token 元数据仅为校验，不参与请求
+      # @param email [String] 邮箱地址
+      # @param token [String] email_token（仅校验非空）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "mtempmail: 邮箱为空" if addr.empty?
+        raise "mtempmail: token 为空" if token.to_s.strip.empty?
+
+        uri = "#{BASE_URL}/api/messages/#{PUBLIC_KEY}/#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        messages = data.is_a?(Hash) ? data["messages"] : nil
+        return [] unless messages.is_a?(Array)
+
+        messages.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          to_str = flatten_contact(m["to"])
+          row = {
+            "id" => m["id"],
+            "from" => flatten_contact(m["from"]),
+            "to" => to_str.empty? ? addr : to_str,
+            "subject" => clean_subject(m["subject"]),
+            "date" => m["created_at"] || m["date"]
+          }
+          body_parts = m["body"]
+          if body_parts.is_a?(Array)
+            parts = body_parts.select { |p| p.is_a?(Hash) }
+            text = body_text(parts)
+            row["text"] = text unless text.empty?
+            html_part = body_html(parts)
+            row["html"] = html_part unless html_part.empty?
+          end
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 将 mailgun 风格 [{"full":"Sender <a@b.com>"},{...}] 展平为字符串
+      # 优先取 full 字段，否则回退 address；空列表返回空串
+      # @param contacts [Object]
+      # @return [String]
+      def flatten_contact(contacts)
+        return contacts.to_s unless contacts.is_a?(Array)
+        return "" if contacts.empty?
+
+        first = contacts.first
+        return "" unless first.is_a?(Hash)
+
+        full = first["full"].to_s.strip
+        full.empty? ? first["address"].to_s.strip : full
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/nowtempmail.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # NowtempMail 渠道实现（nowtempmail.com）
+    #
+    # POST /mailbox 建箱（无 body 或 {}，响应 token（JWT）/mailbox），
+    # GET /messages 读信列表（Header Authorization: Bearer <token>，
+    #   响应 {"messages":[...]}），GET /message/{id} 取单封详情（Bearer）。
+    # 列表元素按多候选字段归一；详情拉取失败时以列表摘要兜底。
+    module Nowtempmail
+      CHANNEL = "nowtempmail"
+      BASE_URL = "https://nowtempmail.com"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      RETRY_KEYS = %w[id Id slug messageId message_id].freeze
+
+      module_function
+
+      # 设置 nowtempmail 请求的通用请求头（可选附带 Bearer token）
+      # @param token [String] 认证令牌
+      # @return [Hash]
+      def auth_headers(token)
+        hdrs = HEADERS.dup
+        hdrs["Authorization"] = "Bearer #{token}" unless token.to_s.empty?
+        hdrs
+      end
+
+      # 创建 nowtempmail.com 临时邮箱
+      # POST /mailbox（空 body）返回 token（JWT）与 mailbox 地址。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/mailbox",
+                         headers: auth_headers("").merge("Content-Type" => "application/json"),
+                         timeout: 15)
+        raise "nowtempmail: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "nowtempmail: 创建响应非对象" unless data.is_a?(Hash)
+
+        token = data["token"].to_s.strip
+        mailbox = data["mailbox"].to_s.strip
+        raise "nowtempmail: 创建邮箱响应缺少必要字段" if token.empty? || mailbox.empty? || !mailbox.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: mailbox, token: token)
+      end
+
+      # 获取 nowtempmail.com 邮件列表
+      # 流程：GET /messages 取列表，对每个元素按 id 逐封 GET /message/{id} 合并详情；
+      # 详情失败时以列表摘要归一。
+      # @param email [String] 邮箱地址
+      # @param token [String] 建箱返回的 JWT 认证令牌
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        resp = Http.get("#{BASE_URL}/messages", headers: auth_headers(token), timeout: 15)
+        raise "nowtempmail: 获取邮件列表失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        messages = data.is_a?(Hash) ? data["messages"] : nil
+        return [] unless messages.is_a?(Array)
+
+        messages.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          detail = get_detail(token, message_id_of(m))
+          row = m.dup
+          if detail.is_a?(Hash)
+            detail.each { |k, v| row[k] = v unless row.key?(k) }
+          end
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 从列表元素中提取邮件 ID（候选键 id/Id/slug/messageId/message_id）
+      # @param row [Hash]
+      # @return [String]
+      def message_id_of(row)
+        RETRY_KEYS.each do |key|
+          val = row[key]
+          return val.to_s.strip unless val.nil? || val.to_s.strip.empty?
+        end
+        ""
+      end
+
+      # 获取 nowtempmail.com 单封邮件详情
+      # GET /message/{id}（Bearer token），响应为单封对象，含 text/html 等完整字段。
+      # @param token [String] JWT
+      # @param id [String] 邮件 ID
+      # @return [Hash, nil]
+      def get_detail(token, id)
+        return nil if id.to_s.empty?
+
+        uri = "#{BASE_URL}/message/#{URI.encode_www_form_component(id)}"
+        resp = Http.get(uri, headers: auth_headers(token), timeout: 15)
+        return nil unless resp.ok?
+
+        detail = resp.json
+        detail.is_a?(Hash) ? detail : nil
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end