tempmail_sdk 1.3.3 → 1.3.5

data/lib/tempmail_sdk/providers/firetempmail.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Firetempmail 渠道实现（firetempmail.com）
+    #
+    # 无认证 REST：建箱无需请求，本地生成 随机词+0-999@<域>（域池与官网一致：
+    # offrework.click / service-today.click / jobsdeforyou.sa.com）；
+    # 读信 GET https://mail.firetempmail.com/mail/get?address=<邮箱 URL 编码>，
+    # 必须携带 Header Origin: https://firetempmail.com（否则 403 'Origin not allowed'）。
+    # 响应形如 {"status":"ok","code":200,"msg":"...","stats":{},"mails":[...]}，
+    # 邮件字段以 sender/subject/date + content-html/content-text/content-plain 多候选归一。
+    module Firetempmail
+      CHANNEL = "firetempmail"
+      API_BASE = "https://mail.firetempmail.com"
+      ORIGIN = "https://firetempmail.com"
+      # 官网 JS 中的完整平台域池，顺序与官网一致
+      DOMAINS = %w[offrework.click service-today.click jobsdeforyou.sa.com].freeze
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "Origin" => ORIGIN,
+        "Referer" => "#{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
+
+      module_function
+
+      # 生成 3-6 位小写随机词（模拟官网 1-5 字母词的观感）
+      LETTERS = ("a".."z").to_a
+      def random_word
+        Array.new(rand(3..6)) { LETTERS.sample }.join
+      end
+
+      # 创建临时邮箱
+      # 建箱无需请求，本地随机生成 随机词+0-999@域名；token 复用完整地址
+      # @return [EmailInfo]
+      def generate_email
+        email = "#{random_word}#{rand(0..999)}@#{DOMAINS.sample}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 读取收件箱
+      # GET https://mail.firetempmail.com/mail/get?address=<URL 编码完整邮箱>，必带 Origin 头
+      # @param email [String] 邮箱地址
+      # @param _token [String] 令牌（本渠道忽略，以邮箱为准）
+      # @return [Array<Email>]
+      def get_emails(email, _token)
+        addr = email.to_s.strip
+        raise "firetempmail: 邮箱地址为空" if addr.empty?
+
+        url = "#{API_BASE}/mail/get?address=#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(url, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        return [] unless data.is_a?(Hash)
+
+        # 错误与成功共用同一信封：status 非 ok 时抛错
+        status = data["status"].to_s
+        if !status.empty? && status != "ok"
+          raise "firetempmail: #{data["msg"] || "读信失败"}"
+        end
+
+        mails = data["mails"]
+        return [] unless mails.is_a?(Array)
+
+        mails.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          row = {
+            "from" => m["sender"] || m["from"] || m["from_address"],
+            "to" => addr,
+            "subject" => m["subject"] || m["title"],
+            "date" => m["date"] || m["received_at"] || m["created_at"],
+            "html" => m["content-html"] || m["html"],
+            "text" => m["content-text"] || m["content-plain"] || m["text"]
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/flybymail.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Flybymail 渠道实现（flybymail.com）
+    #
+    # POST /api/recipients 建箱（空 JSON body，响应 id/email/createdAt/expiresAt，
+    #   expiresAt 为毫秒时间戳），GET /api/recipients/{email}/emails 读信
+    #   （按邮箱地址、非 id 查询，响应 {"emails":[...]}）。
+    # 信件字段：id/from/to/subject/body（纯文本）/htmlBody（HTML 正文）/preview/time/read。
+    module Flybymail
+      CHANNEL = "flybymail"
+      BASE_URL = "https://flybymail.com"
+
+      HEADERS = {
+        "Content-Type" => "application/json",
+        "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
+
+      # 创建 flybymail.com 临时邮箱
+      # POST /api/recipients（空 JSON body）返回 id/email/createdAt/expiresAt，
+      # expiresAt 为毫秒时间戳（约 4 小时），转换为毫秒值供 EmailInfo 统一展示。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/recipients",
+                         headers: HEADERS, json: {}, timeout: 15)
+        raise "flybymail: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "flybymail: 创建响应非对象" unless data.is_a?(Hash)
+
+        id = data["id"].to_s.strip
+        email = data["email"].to_s.strip
+        raise "flybymail: 创建邮箱响应缺少必要字段" if id.empty? || email.empty? || !email.include?("@")
+
+        expires_at = data["expiresAt"].to_i.positive? ? data["expiresAt"].to_i : nil
+        EmailInfo.new(channel: CHANNEL, email: email, token: id, expires_at: expires_at)
+      end
+
+      # 获取 flybymail.com 邮件列表
+      # GET /api/recipients/{email}/emails（按地址查询）返回 {"emails":[...]}。
+      # @param email [String] 邮箱地址
+      # @param token [String] 建箱返回的收件人 ID（读信端点按邮箱地址查询，令牌保留）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "flybymail: 邮箱地址为空或格式错误" if addr.empty? || !addr.include?("@")
+
+        uri = "#{BASE_URL}/api/recipients/#{URI.encode_www_form_component(addr)}/emails"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        raise "flybymail: 获取邮件列表失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        emails = data.is_a?(Hash) ? data["emails"] : nil
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          # id 为数字时按字符串归一，time 为毫秒时间戳时按 timestamp 归一
+          row = {
+            "id" => raw["id"].to_s.strip,
+            "from" => raw["from"],
+            "to" => raw["to"],
+            "subject" => raw["subject"],
+            "text" => raw["body"],
+            "html" => raw["htmlBody"],
+            "time" => raw["time"],
+            "read" => raw["read"],
+            "attachments" => raw["attachments"],
+            "timestamp" => timestamp_of(raw)
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 归一邮件时间：候选 time/date 字段（time 为毫秒时间戳）
+      # @param m [Hash]
+      # @return [Object, nil]
+      def timestamp_of(m)
+        return m["time"] if m.key?("time") && !m["time"].nil?
+
+        m["date"]
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/generator_email.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # GeneratorEmail 渠道实现（generator.email，PHP SSR 网页型）
+    #
+    # 流程：
+    #   GET /inbox4/ 首页 SSR：解析 window.SITE_DATA 的 cur_user/cur_domain
+    #     快照生成邮箱（邮箱=user@domain），同页 Set-Cookie inbox_ctx
+    #     选中该邮箱会话
+    #   GET /inbox4/（带 inbox_ctx Cookie）收信页：列为 class 含
+    #     list-group-item2 的行（平台实测真实类为 list-group-item2，
+    #     非 list-group-item），内含 from_div_45g45gg / subj_div_45g45gg /
+    #     time_div_45g45gg 三要素块
+    # 限制：本站不提供原文正文，按列表三要素归一。
+    # token 语义：{email, domain, user} JSON 快照。
+    module GeneratorEmail
+      CHANNEL = "generator-email"
+      BASE_URL = "https://generator.email"
+      INBOX_URL = "#{BASE_URL}/inbox4/"
+
+      USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 " \
+                   "(KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36"
+
+      USER_RE = /cur_user:"([^"]*)"/
+      DOMAIN_RE = /cur_domain:"([^"]*)"/
+      # 列表条目与三要素块（平台实测真实类为 list-group-item2，按类名后缀锚定）
+      ITEM_RE = /<div[^>]*class="[^"]*list-group-item2[^"]*"[^>]*>(.*?)(?:<\/div>\s*){3}/m
+      FROM_RE = /class="[^"]*from_div_45g45gg[^"]*"[^>]*>(.*?)<\/div>/m
+      SUBJ_RE = /class="[^"]*subj_div_45g45gg[^"]*"[^>]*>(.*?)<\/div>/m
+      TIME_RE = /class="[^"]*time_div_45g45gg[^"]*"[^>]*>(.*?)<\/div>/m
+      SCRIPT_RE = /<(script|style)[\s\S]*?<\/\1>/i
+      TAG_RE = /<[^>]+>/
+
+      module_function
+
+      # 请求收件箱渲染页并返回 HTML（邮箱由服务端依据 inbox_ctx Cookie 选择）
+      # @return [String]
+      def fetch_page
+        headers = {
+          "User-Agent" => USER_AGENT,
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9," \
+                      "image/avif,image/webp,*/*;q=0.8",
+          "Accept-Language" => "en-US,en;q=0.9",
+          "Referer" => "#{BASE_URL}/"
+        }
+        ctx = @inbox_ctx
+        headers["Cookie"] = "inbox_ctx=#{ctx}" if ctx && !ctx.empty?
+        resp = Http.get(INBOX_URL, headers: headers, timeout: 20)
+        # 收下响应 Set-Cookie 的 inbox_ctx 最新值（同页刷新）
+        resp.set_cookies.each do |line|
+          kv = line.split(";").first.to_s.strip
+          @inbox_ctx = kv.delete_prefix("inbox_ctx=") if kv.start_with?("inbox_ctx=")
+        end
+        resp.raise_for_status
+        resp.body.to_s
+      end
+
+      # 取正则第一个捕获组，无匹配返回空串
+      # @param re [Regexp]
+      # @param src [String]
+      # @return [String]
+      def match_first(re, src)
+        m = re.match(src)
+        m ? m[1].to_s : ""
+      end
+
+      # 去标签与脚本/样式块，压缩空白
+      # @param s [String]
+      # @return [String]
+      def strip_tags(s)
+        out = s.gsub(SCRIPT_RE, " ")
+        out = out.gsub(TAG_RE, " ")
+        out.gsub(/\s+/, " ").strip
+      end
+
+      # 创建 generator.email 临时邮箱
+      # 解析首页 SITE_DATA 快照（cur_user/cur_domain）得到邮箱地址。
+      # @return [EmailInfo]
+      def generate_email
+        src = fetch_page
+        user = match_first(USER_RE, src)
+        domain = match_first(DOMAIN_RE, src)
+        if user.empty? || domain.empty?
+          raise "generator-email: 首页未携带邮箱快照（cur_user/cur_domain）"
+        end
+
+        email = "#{user}@#{domain}"
+        token = JSON.generate({ email: email, domain: domain, user: user })
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 generator.email 收件箱
+      # 解析收件箱渲染页的列表条目（from/subj/time 三要素）；本站不提供
+      # 原文正文，SDK 按摘要归一。
+      # @param email [String] 邮箱地址
+      # @param token [String] 会话凭据 JSON（{email, domain, user}）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        sess = JSON.parse(token.to_s)
+        raise "generator-email: 会话凭据解析失败（非对象）" unless sess.is_a?(Hash)
+
+        raise "generator-email: 会话邮箱与查询邮箱不匹配" if sess["email"] != email
+
+        sess_domain = sess["domain"].to_s
+        src = fetch_page
+        # 服务端当前渲染邮箱与 token 不一致说明 Cookie 上下文已被切换
+        got_domain = match_first(DOMAIN_RE, src)
+        if got_domain != sess_domain
+          raise "generator-email: 会话域名已切换（token #{sess_domain}，服务端 #{got_domain}）"
+        end
+
+        # 列表区域锚定（#email-table ... #markodile 之间）
+        list_start = src.index('id="email-table"')
+        list_end = src.index('id="markodile"')
+        region = if list_start && list_end && list_end > list_start
+                   src[list_start...list_end]
+                 else
+                   ""
+                 end
+
+        out = []
+        src.scan(ITEM_RE) do |raw|
+          raw = raw.to_s
+          # 跳过列表容器外的候选：要求条目文本来自列表区域
+          next if !region.empty? && !region.include?(raw)
+
+          from = strip_tags(match_first(FROM_RE, raw))
+          subject = strip_tags(match_first(SUBJ_RE, raw))
+          when_str = strip_tags(match_first(TIME_RE, raw))
+          next if from.empty? && subject.empty? && when_str.empty?
+
+          out << Normalize.normalize_email(
+            { "from" => from, "to" => email, "subject" => subject, "date" => when_str },
+            email
+          )
+        end
+        out
+      rescue JSON::ParserError => e
+        raise "generator-email: 会话凭据解析失败: #{e.message}"
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/haribu.rb

@@ -32,7 +32,7 @@ module TempmailSdk
       SUBJECT_RE = /<span\s+class\s*=\s*["']mail_konu["'][^>]*>([\s\S]*?)<\/span>/mi
       DATE_RE = /<span\s+class\s*=\s*["']mail_zaman["'][^>]*>([\s\S]*?)<\/span>/mi
       MAIL_LINK_RE = /href\s*=\s*["']([^"']*(?:mail|read|view)[^"']*)["']/i
-      BODY_RE = /<div\s+(?:id|class)\s*=\s*["'](?:mail_icerik|icerik|mail-content|message-body)["'][^>]*>([\s\S]*?)<\/div>/mi
+      BODY_OPEN_RE = /<div\s+(?:id|class)\s*=\s*["'](?:mail_icerik|icerik|mail-content|message-body)["'][^>]*>/mi
       TAG_RE = /<[^>]+>/
 
       module_function
@@ -112,8 +112,34 @@ module TempmailSdk
         resp = Http.get(detail_url, headers: hdrs, timeout: 15)
         return "" unless resp.ok?
 
-        m = resp.body.match(BODY_RE)
-        m ? m[1].strip : ""
+        extract_body_html(resp.body)
+      end
+
+      # 使用栈式深度匹配提取正文 div 的完整内部 HTML，
+      # 避免非贪婪正则在嵌套 div 时截断正文。
+      def extract_body_html(page)
+        m = page.match(BODY_OPEN_RE)
+        return "" unless m
+
+        start = m.end(0)
+        pos = start
+        depth = 1
+        while pos < page.length && depth > 0
+          next_open = page.index("<div", pos)
+          next_close = page.index("</div>", pos)
+          break unless next_close
+
+          if next_open && next_open < next_close
+            depth += 1
+            pos = next_open + 4
+          else
+            depth -= 1
+            return page[start...next_close].strip if depth.zero?
+
+            pos = next_close + 6
+          end
+        end
+        ""
       rescue StandardError
         ""
       end

data/lib/tempmail_sdk/providers/huskmail.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Huskmail 渠道实现（huskmail.xyz，API 域 api.huskmail.space）
+    #
+    # 流程：
+    #   POST /v1/accounts 建箱（空 JSON body，响应 id/address/password/token/expiresAt/tier，
+    #                          token 为 JWT）
+    #   GET /v1/messages 读信（Header Authorization: Bearer <token>，响应 {"messages":[...]}）
+    #   GET /v1/messages/{id} 取单封详情（Bearer）
+    # 收信域固定为 @huskmail.xyz。
+    module Huskmail
+      CHANNEL = "huskmail"
+      BASE_URL = "https://api.huskmail.space"
+
+      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
+
+      # 可行 ID 候选键，按序提取
+      ID_KEYS = %w[id Id slug messageId message_id].freeze
+
+      module_function
+
+      # 设置 huskmail 请求的通用请求头
+      # @param token [String] 认证令牌，非空时携带 Authorization: Bearer
+      # @return [Hash]
+      def auth_headers(token = "")
+        hdrs = HEADERS.dup
+        hdrs["Authorization"] = "Bearer #{token}" unless token.to_s.empty?
+        hdrs
+      end
+
+      # 创建 huskmail（@huskmail.xyz）临时邮箱
+      # POST /v1/accounts（空 JSON body）返回 address 与 JWT token
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/v1/accounts",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: {}, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        address = data.is_a?(Hash) ? data["address"].to_s.strip : ""
+        token = data.is_a?(Hash) ? data["token"].to_s.strip : ""
+        raise "huskmail: 创建邮箱响应缺少必要字段" if address.empty? || token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: address, token: token,
+                      expires_at: data["expiresAt"])
+      end
+
+      # 获取 huskmail 邮件列表
+      # GET /v1/messages（{"messages":[...]}）；对每个元素按 id 逐封请求详情合并，
+      # 详情失败时以列表摘要归一。
+      # @param token [String] JWT 认证令牌
+      # @param email [String] 邮箱地址（@huskmail.xyz）
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        tk = token.to_s.strip
+        raise "huskmail: token 为空" if tk.empty?
+
+        resp = Http.get("#{BASE_URL}/v1/messages", headers: auth_headers(tk), timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        list = data.is_a?(Hash) ? data["messages"] : nil
+        return [] unless list.is_a?(Array)
+
+        addr = email.to_s.strip
+        list.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          Normalize.normalize_email(detail_row(tk, m, addr), addr)
+        end
+      end
+
+      # 从列表元素中提取消息 ID（候选键 id/Id/slug/messageId/message_id）
+      # @param row [Hash]
+      # @return [String]
+      def message_id_of(row)
+        ID_KEYS.each do |key|
+          val = row[key]
+          return val.to_s.strip unless val.nil? || val.to_s.strip.empty?
+        end
+        ""
+      end
+
+      # 逐封拉取详情并合并到列表摘要；无 ID 或详情失败时以摘要归一
+      # @param token [String] JWT 认证令牌
+      # @param summary [Hash] 列表元素摘要
+      # @param email [String] 收件人邮箱
+      # @return [Hash] 归一化输入行
+      def detail_row(token, summary, email)
+        id = message_id_of(summary)
+        uri = "#{BASE_URL}/v1/messages/#{URI.encode_www_form_component(id)}"
+        resp = Http.get(uri, headers: auth_headers(token), timeout: 15)
+        merged = summary
+        if resp.ok?
+          detail = begin
+            resp.json
+          rescue StandardError
+            nil
+          end
+          # 详情缺失字段不覆盖列表摘要（包含 null 的键跳过）
+          merged = summary.merge(detail.reject { |_k, v| v.nil? }) if detail.is_a?(Hash)
+        end
+        to_normalized_row(merged, email)
+      rescue StandardError
+        to_normalized_row(summary, email)
+      end
+
+      # 将原始消息 Hash 转换为归一化输入行
+      # @param raw [Hash]
+      # @param email [String]
+      # @return [Hash]
+      def to_normalized_row(raw, email)
+        {
+          "id" => raw["id"] || raw["messageId"] || raw["message_id"],
+          "from" => raw["from"],
+          "to" => email,
+          "subject" => raw["subject"],
+          "text" => raw["text"],
+          "html" => raw["html"],
+          "date" => raw["date"]
+        }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/internxt.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # Internxt 渠道实现（internxt.com/temporary-email，Next.js + OpenNext）
+    #
+    # 流程：
+    #   GET /temporary-email 夺取 XSRF-TOKEN Cookie（同气 csrfSecret）
+    #   GET /api/temp-mail/create-email（头 csrf-token=<XSRF-TOKEN 值>）建箱
+    #   GET /api/temp-mail/get-inbox?email=&token=（顶层数组）列信
+    #   GET /api/temp-mail/get-message?email=&token=&messageId= 取单封全文
+    # CSRF 要点：csrf-token 头的值必须是罐中 XSRF-TOKEN（每次 API 响应都会
+    #   刷新该 Cookie，故每次请求前重取），不是 csrfSecret。
+    # token 语义：{address, token} JSON。
+    module Internxt
+      CHANNEL = "internxt"
+      SITE = "https://internxt.com"
+      REF = "#{SITE}/temporary-email"
+      API_BASE = "#{SITE}/api/temp-mail"
+
+      USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 " \
+                   "(KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36"
+
+      # 简单查询编码（取值均为 URL 安全字符）
+      REQUIRE_URI = true
+
+      module_function
+
+      # 收下响应 Set-Cookie：XSRF-TOKEN/csrfSecret 同名覆写模块级状态
+      # @param resp [Http::Response]
+      def merge_cookies(resp)
+        resp.set_cookies.each do |line|
+          kv = line.split(";").first.to_s.strip
+          name, value = kv.split("=", 2)
+          @xsrf = value if name == "XSRF-TOKEN" && value
+          @secret = value if name == "csrfSecret" && value
+        end
+      end
+
+      # 组装 Cookie 请求头（有则携带）
+      # @return [String]
+      def cookie_header
+        parts = []
+        parts << "csrfSecret=#{@secret}" if @secret && !@secret.empty?
+        parts << "XSRF-TOKEN=#{@xsrf}" if @xsrf && !@xsrf.empty?
+        parts.join("; ")
+      end
+
+      # 确保已取得 XSRF-TOKEN：无则 GET /temporary-email 夺取
+      # @return [String] 罐中 XSRF-TOKEN 最新值
+      def prepare_xsrf
+        return @xsrf if @xsrf && !@xsrf.empty?
+
+        resp = Http.get(REF, headers: {
+          "User-Agent" => USER_AGENT,
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9," \
+                      "image/avif,image/webp,*/*;q=0.8",
+          "Accept-Language" => "en-US,en;q=0.9"
+        }, timeout: 20)
+        resp.raise_for_status
+        merge_cookies(resp)
+        raise "internxt: 未取得 XSRF-TOKEN Cookie" if @xsrf.to_s.empty?
+
+        @xsrf
+      end
+
+      # 带 CSRF 头请求 internxt 数据接口（GET），返回解析后的 JSON。
+      # csrf-token 头取罐中 XSRF-TOKEN 最新值（每次请求前重取，因每个 API
+      # 响应都会刷新该 Cookie）。
+      # @param path [String] 接口路径
+      # @param params [Hash, nil] 查询参数
+      # @return [Object]
+      def api_get(path, params = nil)
+        csrf = prepare_xsrf
+        url = "#{API_BASE}#{path}"
+        unless params.nil? || params.empty?
+          qs = params.map { |k, v| "#{k}=#{v}" }.join("&")
+          url = "#{url}?#{qs}"
+        end
+        headers = {
+          "User-Agent" => USER_AGENT,
+          "Accept" => "application/json, text/plain, */*",
+          "Origin" => SITE,
+          "Referer" => REF,
+          "csrf-token" => csrf
+        }
+        cookie = cookie_header
+        headers["Cookie"] = cookie unless cookie.empty?
+        resp = Http.get(url, headers: headers, timeout: 20)
+        merge_cookies(resp)
+        resp.raise_for_status
+        body = resp.body.to_s.strip
+        body.empty? ? nil : JSON.parse(body)
+      end
+
+      # 创建 internxt.com 临时邮箱
+      # 先确保已取得 XSRF-TOKEN，再 GET /api/temp-mail/create-email
+      # （带 csrf-token 头），响应 {"address","token"}。
+      # @return [EmailInfo]
+      def generate_email
+        prepare_xsrf
+        data = api_get("/create-email")
+        unless data.is_a?(Hash)
+          raise "internxt: 解析建箱响应失败"
+        end
+
+        address = data["address"].to_s.strip
+        api_token = data["token"].to_s.strip
+        if address.empty? || api_token.empty? || !address.include?("@")
+          raise "internxt: 创建邮箱响应缺少必要字段（address/token）"
+        end
+
+        token = JSON.generate({ address: address, token: api_token })
+        EmailInfo.new(channel: CHANNEL, email: address, token: token)
+      end
+
+      # 从列表元素中提取邮件 ID（字符串形态，与 Go 端 messageIDOf 一致）
+      # @param row [Hash]
+      # @return [String]
+      def message_id_of(row)
+        %w[id messageId message_id].each do |key|
+          val = row[key]
+          return val.to_s.strip unless val.nil? || val.to_s.strip.empty?
+        end
+        ""
+      end
+
+      # 获取 internxt.com 收件箱
+      # get-inbox 返回顶层数组（列表元素含 id/from/subject/date/seen 等）；
+      # 逐条 get-message 拉单封全文（响应为单封对象，含 html 渲染全文），
+      # 详情失败回退列表摘要。
+      # @param email [String] 邮箱地址
+      # @param token [String] 会话凭据 JSON（address/token）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        begin
+          sess = JSON.parse(token.to_s)
+        rescue JSON::ParserError => e
+          raise "internxt: 会话凭据解析失败: #{e.message}"
+        end
+        raise "internxt: 会话凭据解析失败（非对象）" unless sess.is_a?(Hash)
+
+        address = sess["address"].to_s.strip
+        api_token = sess["token"].to_s.strip
+        raise "internxt: 会话凭据缺少必要字段" if address.empty? || api_token.empty?
+
+        raise "internxt: 会话邮箱与查询邮箱不匹配" if address != email
+
+        inbox = api_get("/get-inbox", email: address, token: api_token)
+        raise "internxt: 解析收件箱响应失败" unless inbox.is_a?(Array)
+
+        inbox.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          m = item.dup
+          mid = message_id_of(m)
+          unless mid.empty?
+            begin
+              detail = api_get("/get-message",
+                               email: address, token: api_token, messageId: mid)
+              if detail.is_a?(Hash)
+                # 列表字段优先，详情仅补齐缺失字段
+                detail.each { |k, v| m[k] = v unless m.key?(k) }
+              end
+            rescue StandardError
+              # 详情失败回退列表摘要
+            end
+          end
+          Normalize.normalize_email(m, email)
+        end
+      end
+    end
+  end
+end