tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/temporam.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "securerandom"
+
+module TempmailSdk
+  module Providers
+    # Temporam 渠道实现
+    # API: https://temporam.com/api
+    module Temporam
+      CHANNEL = "temporam"
+      ORIGIN = "https://temporam.com"
+
+      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"
+      }.freeze
+
+      module_function
+
+      # 生成随机用户名
+      def random_local(length = 18)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        "sdk" + Array.new(length) { chars.sample }.join
+      end
+
+      # GET 请求并解析 JSON
+      def get_json(path)
+        resp = Http.get("#{ORIGIN}#{path}", headers: HEADERS)
+        resp.raise_for_status
+        resp.json
+      end
+
+      # 获取可用域名列表
+      def fetch_domains
+        data = get_json("/api/domains")
+        domains = (data["data"] || []).select { |item| item.is_a?(Hash) }.map { |item| (item["domain"] || "").strip }.reject(&:empty?)
+        raise "temporam: 域名列表为空" if domains.empty?
+
+        domains
+      end
+
+      # 将原始邮件映射为标准化格式
+      def normalize_raw(raw, email)
+        flat = raw.merge(
+          "id" => raw["id"] || raw["uuid"] || "",
+          "from" => raw["fromEmail"] || raw["from"] || "",
+          "to" => raw["toEmail"] || raw["to"] || email,
+          "date" => raw["createdAt"] || raw["created_at"] || raw["date"] || ""
+        )
+        Normalize.normalize_email(flat, email)
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        domains = fetch_domains
+        if domain && !domain.empty?
+          raise "temporam: 不支持的域名 #{domain}" unless domains.include?(domain)
+
+          selected = domain
+        else
+          selected = domains.sample
+        end
+        email = "#{random_local}@#{selected}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取邮件列表
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        recipient = token.to_s.empty? ? email : token
+        raise "temporam: 缺少邮箱地址" if recipient.to_s.strip.empty?
+
+        data = get_json("/api/emails?email=#{URI.encode_www_form_component(recipient)}&limit=50")
+        rows = data["data"] || []
+        rows.select { |row| row.is_a?(Hash) }.map do |row|
+          raw = row
+          msg_id = (row["id"] || row["uuid"] || "").to_s
+          unless msg_id.empty?
+            begin
+              detail = get_json("/api/emails/#{URI.encode_www_form_component(msg_id)}")
+              raw = detail["data"] if detail["data"].is_a?(Hash)
+            rescue StandardError
+              # 详情获取失败时使用列表数据
+            end
+          end
+          normalize_raw(raw, recipient)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempp_mails.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # tempp-mails.com 临时邮箱渠道（Laravel + CSRF，与 tempmailten 共享模板）
+    # GET /en 获取 session cookie + CSRF token
+    # POST /messages 获取邮箱地址和邮件列表
+    # GET /view/{id} 获取单封邮件 HTML 正文
+    module TempMails
+      CHANNEL = "tempp-mails"
+      BASE_URL = "https://tempp-mails.com"
+      TOK_PREFIX = "tpm1:"
+
+      CSRF_RE = /<meta\s+name="csrf-token"\s+content="([^"]+)"/
+
+      UA = "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"
+
+      module_function
+
+      def browser_headers
+        {
+          "User-Agent" => UA,
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
+          "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7"
+        }
+      end
+
+      def ajax_headers
+        {
+          "User-Agent" => UA,
+          "Accept" => "application/json, text/javascript, */*; q=0.01",
+          "Accept-Language" => "en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7",
+          "X-Requested-With" => "XMLHttpRequest",
+          "Referer" => "#{BASE_URL}/en"
+        }
+      end
+
+      def extract_cookie_header(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.sort.map { |k, v| "#{k}=#{v}" }.join("; ")
+      end
+
+      def encode_token(csrf, cookie_hdr)
+        raw = JSON.generate({ "t" => csrf, "c" => cookie_hdr })
+        "#{TOK_PREFIX}#{Base64.strict_encode64(raw)}"
+      end
+
+      def decode_token(token)
+        raise "tempp-mails: 无效的 token" unless token&.start_with?(TOK_PREFIX)
+
+        data = JSON.parse(Base64.decode64(token[TOK_PREFIX.length..]))
+        csrf = (data["t"] || "").strip
+        cookie_hdr = (data["c"] || "").strip
+        raise "tempp-mails: token 中缺少 CSRF" if csrf.empty?
+
+        [csrf, cookie_hdr]
+      end
+
+      def post_messages(csrf, cookie_hdr)
+        headers = ajax_headers.merge(
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "X-CSRF-TOKEN" => csrf
+        )
+        headers["Cookie"] = cookie_hdr unless cookie_hdr.empty?
+
+        resp = Http.post("#{BASE_URL}/messages", headers: headers,
+                                                  body: "_token=#{URI.encode_www_form_component(csrf)}&captcha=")
+        resp.raise_for_status
+        data = resp.json
+        raise "tempp-mails: 解析响应 JSON 失败" unless data.is_a?(Hash)
+
+        data
+      end
+
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{BASE_URL}/en", headers: browser_headers)
+        resp.raise_for_status
+
+        cookie_hdr = extract_cookie_header(resp)
+        m = resp.body.match(CSRF_RE)
+        raise "tempp-mails: 未能从首页提取 CSRF token" unless m
+
+        csrf = m[1]
+        data = post_messages(csrf, cookie_hdr)
+        mailbox = (data["mailbox"] || "").strip
+        raise "tempp-mails: 邮箱地址无效" if mailbox.empty? || !mailbox.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: mailbox, token: encode_token(csrf, cookie_hdr))
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = (email || "").strip
+        raise "tempp-mails: 邮箱地址为空" if addr.empty?
+
+        csrf, cookie_hdr = decode_token((token || "").strip)
+        data = post_messages(csrf, cookie_hdr)
+
+        msgs = data["messages"]
+        return [] unless msgs.is_a?(Array) && !msgs.empty?
+
+        msgs.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          mid = (msg["id"] || "").to_s.strip
+          next if mid.empty?
+
+          from_addr = (msg["from_email"] || "").to_s
+          from_name = (msg["from"] || "").to_s
+          from_addr = "#{from_name} <#{from_addr}>" if !from_name.empty? && from_name != from_addr
+
+          raw = {
+            "id" => mid,
+            "from" => from_addr,
+            "to" => addr,
+            "subject" => msg["subject"] || "",
+            "html" => fetch_view(cookie_hdr, mid),
+            "isRead" => !!msg["is_seen"]
+          }
+          Normalize.normalize_email(raw, addr)
+        end
+      end
+
+      def fetch_view(cookie_hdr, mid)
+        return "" if mid.nil? || mid.empty?
+
+        headers = browser_headers.merge("Referer" => "#{BASE_URL}/en")
+        headers["Cookie"] = cookie_hdr unless cookie_hdr.empty?
+        resp = Http.get("#{BASE_URL}/view/#{URI.encode_www_form_component(mid)}", headers: headers)
+        return "" unless resp.ok?
+
+        resp.body
+      rescue StandardError
+        ""
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tempy_email.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Tempy Email 渠道实现
+    # API: https://tempy.email/api/v1
+    module TempyEmail
+      CHANNEL = "tempy-email"
+      API_BASE = "https://tempy.email/api/v1"
+      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"
+      }.freeze
+
+      module_function
+
+      # 扁平化邮件字段
+      def flatten_message(raw, recipient)
+        {
+          "id" => raw["id"] || raw["messageId"] || raw["message_id"] || raw["mail_id"] || "",
+          "from" => raw["from"] || raw["sender"] || raw["from_addr"] || raw["from_address"] || "",
+          "to" => raw["to"] || recipient,
+          "subject" => raw["subject"] || raw["mail_title"] || "",
+          "text" => raw["text"] || raw["body_text"] || raw["text_body"] || raw["body"] || "",
+          "html" => raw["html"] || raw["body_html"] || raw["html_body"] || "",
+          "date" => raw["date"] || raw["received_at"] || raw["created_at"] || "",
+          "is_read" => raw["is_read"] || raw["isRead"] || raw["seen"] || false,
+          "attachments" => raw["attachments"] || []
+        }
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        body = {}
+        wanted = domain.to_s.strip
+        body["domain"] = wanted unless wanted.empty?
+
+        resp = Http.post("#{API_BASE}/mailbox",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: body, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "tempy-email: 无效的创建响应" unless data.is_a?(Hash)
+
+        email = data["email"].to_s.strip
+        raise "tempy-email: 无效的创建响应" if email.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, expires_at: data["expires_at"])
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "tempy-email: 邮箱地址为空" if address.empty?
+
+        resp = Http.get("#{API_BASE}/mailbox/#{URI.encode_www_form_component(address)}/messages",
+                        headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        rows = data.is_a?(Hash) ? data["messages"] : data
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |item| item.is_a?(Hash) }.map do |item|
+          Normalize.normalize_email(flatten_message(item, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/ten_minute_mail_net.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # 10minutemail.net 临时邮箱渠道
+    # GET /address.api.php 创建邮箱（获取 PHPSESSID）
+    # GET /address.api.php 获取邮件列表（带 session cookie）
+    # GET /mail.api.php?mailid={id} 获取单封邮件详情
+    module TenMinuteMailNet
+      CHANNEL = "10minutemail-net"
+      BASE_URL = "https://10minutemail.net"
+
+      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.get("#{BASE_URL}/address.api.php", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        raise "10minutemail-net: 响应格式无效" unless data.is_a?(Hash)
+
+        address = (data["mail_get_mail"] || "").strip
+        raise "10minutemail-net: 创建邮箱失败" if address.empty?
+
+        phpsessid = resp.cookie_value("PHPSESSID")
+        raise "10minutemail-net: 未获取到 PHPSESSID cookie" if phpsessid.nil? || phpsessid.empty?
+
+        token = JSON.generate({ "cookie" => "PHPSESSID=#{phpsessid}" })
+
+        expires_at = nil
+        duetime = data["mail_get_duetime"]
+        if duetime
+          begin
+            expires_at = duetime.to_i * 1000
+          rescue StandardError
+            # 忽略
+          end
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: address, token: token, expires_at: expires_at)
+      end
+
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        address = (email || "").strip
+        raise "10minutemail-net: 邮箱地址为空" if address.empty?
+
+        token_data = JSON.parse(token)
+        cookie_str = token_data["cookie"] || ""
+
+        headers = HEADERS.merge("Cookie" => cookie_str)
+
+        resp = Http.get("#{BASE_URL}/address.api.php", headers: headers, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+
+        mail_list = data["mail_list"]
+        return [] unless mail_list.is_a?(Array)
+
+        mail_list.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          mail_id = (item["mail_id"] || "").to_s.strip
+          next if mail_id.empty? || mail_id == "welcome"
+
+          detail = fetch_detail(headers, mail_id)
+          next unless detail.is_a?(Hash)
+
+          html_body = ""
+          text_body = ""
+          body_list = detail["body"]
+          if body_list.is_a?(Array)
+            body_list.each do |part|
+              next unless part.is_a?(Hash)
+
+              content_type = part["content"] || ""
+              if content_type.include?("text/html")
+                html_body = part["body"] || ""
+              elsif content_type.include?("text/plain")
+                text_body = part["body"] || ""
+              end
+            end
+          end
+
+          if text_body.empty?
+            plain_list = detail["plain"]
+            if plain_list.is_a?(Array) && !plain_list.empty? && plain_list[0].is_a?(String)
+              text_body = plain_list[0]
+            end
+          end
+
+          raw = {
+            "id" => mail_id,
+            "from" => (detail["from"] || item["from"] || "").to_s,
+            "to" => (detail["to"] || address).to_s,
+            "subject" => (detail["subject"] || item["subject"] || "").to_s,
+            "text" => text_body,
+            "html" => html_body,
+            "date" => (detail["datetime"] || item["datetime"] || "").to_s
+          }
+          Normalize.normalize_email(raw, address)
+        end
+      end
+
+      def fetch_detail(headers, mail_id)
+        resp = Http.get("#{BASE_URL}/mail.api.php?mailid=#{URI.encode_www_form_component(mail_id)}",
+                        headers: headers, timeout: 15)
+        resp.raise_for_status
+        resp.json
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/tenminute_one.rb

@@ -0,0 +1,255 @@
+# frozen_string_literal: true
+
+require "uri"
+require "json"
+require "securerandom"
+require "base64"
+require "time"
+
+module TempmailSdk
+  module Providers
+    # 10minutemail.one 渠道
+    # SSR __NUXT_DATA__ 中的 mailServiceToken（JWT）+ 页面 emailDomains；
+    # 收信 GET web.10minutemail.one/api/v1/mailbox/{email}
+    module TenminuteOne
+      CHANNEL = "10minute-one"
+      SITE_ORIGIN = "https://10minutemail.one"
+      API_BASE = "https://web.10minutemail.one/api/v1"
+      KNOWN_EMAIL_DOMAINS = %w[xghff.com oqqaj.com psovv.com dbwot.com ygwpr.com imxwe.com].freeze
+      DEFAULT_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+
+      NUXT_DATA_RE = /<script[^>]*\bid="__NUXT_DATA__"[^>]*>([\s\S]*?)<\/script>/i
+      JWT_RE = /\A[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\z/
+
+      module_function
+
+      # URL 编码邮箱（@ 编码为 %40）
+      def enc_mailbox_email(email)
+        if email.include?("@")
+          local, _, dom = email.partition("@")
+          "#{URI.encode_www_form_component(local)}%40#{URI.encode_www_form_component(dom)}"
+        else
+          URI.encode_www_form_component(email)
+        end
+      end
+
+      # 解析 __NUXT_DATA__ JSON 数组
+      def parse_nuxt_array(html)
+        m = html.match(NUXT_DATA_RE)
+        raise "10minute-one: __NUXT_DATA__ not found" unless m
+
+        JSON.parse(m[1].strip)
+      end
+
+      # 解引用 NUXT 数组中的值（递归追踪索引引用）
+      def resolve_ref(arr, value, depth = 0)
+        return value if depth > 64
+        return value if value == true || value == false
+        return value unless value.is_a?(Integer) && value >= 0 && value < arr.length
+
+        resolve_ref(arr, arr[value], depth + 1)
+      end
+
+      # 从 NUXT 数组中提取 mailServiceToken（JWT）
+      def parse_mail_service_token(arr)
+        # 先扫描前 48 项
+        n = [arr.length, 48].min
+        n.times do |i|
+          el = arr[i]
+          next unless el.is_a?(Hash) && el.key?("mailServiceToken")
+
+          t = resolve_ref(arr, el["mailServiceToken"])
+          return t if t.is_a?(String) && t.match?(JWT_RE)
+        end
+        # 全量扫描
+        arr.each do |el|
+          next unless el.is_a?(Hash) && el.key?("mailServiceToken")
+
+          t = resolve_ref(arr, el["mailServiceToken"])
+          return t if t.is_a?(String) && t.match?(JWT_RE)
+        end
+        # 最后尝试找裸 JWT 字符串
+        arr.each do |el|
+          return el if el.is_a?(String) && el.match?(JWT_RE)
+        end
+        raise "10minute-one: mailServiceToken not found"
+      end
+
+      # 从 HTML 页面中提取字段对应的 JSON 数组（如 emailDomains、blockedUsernames）
+      def parse_quoted_json_array(html, field)
+        key = "#{field}:\""
+        start = html.index(key)
+        return [] unless start
+
+        slice_start = start + key.length
+        return [] if slice_start >= html.length || html[slice_start] != "["
+
+        depth = 0
+        j = slice_start
+        while j < html.length
+          c = html[j]
+          if c == "["
+            depth += 1
+          elsif c == "]"
+            depth -= 1
+            if depth.zero?
+              j += 1
+              break
+            end
+          end
+          j += 1
+        end
+        raw = html[slice_start...j]
+        unesc = raw.gsub('\\"', '"')
+        v = JSON.parse(unesc)
+        v.is_a?(Array) ? v : []
+      rescue JSON::ParserError
+        []
+      end
+
+      def pick_locale(domain)
+        s = domain.to_s.strip
+        return "zh" if s.empty?
+        return "zh" if s.include?(".") && !s.include?("/")
+
+        s
+      end
+
+      def pick_mailbox_domain(hint, available)
+        raise "10minute-one: no email domains" if available.empty?
+
+        if hint && !hint.empty?
+          h = hint.strip.downcase
+          if h.include?(".")
+            found = available.find { |d| d.downcase == h }
+            return found if found
+          end
+        end
+        available.sample
+      end
+
+      def random_local(n)
+        chars = "abcdefghijklmnopqrstuvwxyz0123456789"
+        Array.new(n) { chars[rand(chars.length)] }.join
+      end
+
+      # 从 JWT 中提取过期时间戳（毫秒）
+      def jwt_exp_ms(token)
+        parts = token.split(".")
+        return nil if parts.length < 2
+
+        b = parts[1]
+        # 补齐 Base64 填充
+        b += "=" * ((-b.length) % 4)
+        b = b.tr("-_", "+/")
+        payload = JSON.parse(Base64.decode64(b))
+        exp = payload["exp"]
+        return (exp * 1000).to_i if exp.is_a?(Numeric)
+
+        nil
+      rescue StandardError
+        nil
+      end
+
+      def api_headers(tok)
+        {
+          "Accept" => "*/*",
+          "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+          "Authorization" => "Bearer #{tok}",
+          "Cache-Control" => "no-cache",
+          "Content-Type" => "application/json",
+          "DNT" => "1",
+          "Origin" => SITE_ORIGIN,
+          "Pragma" => "no-cache",
+          "Referer" => "#{SITE_ORIGIN}/",
+          "User-Agent" => DEFAULT_UA,
+          "X-Request-ID" => SecureRandom.hex(16),
+          "X-Timestamp" => Time.now.to_i.to_s
+        }
+      end
+
+      def item_needs_detail(m)
+        return false if m["id"].to_s.strip.empty?
+
+        body = (m["text"] || m["body"] || m["html"] || m["mail_text"] || "").to_s.strip
+        body.empty?
+      end
+
+      # @param domain [String, nil] 域名或 locale 提示
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        loc = pick_locale(domain)
+        page_url = "#{SITE_ORIGIN}/#{loc}"
+        r = Http.get(page_url, headers: {
+                       "User-Agent" => DEFAULT_UA,
+                       "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                       "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+                       "Cache-Control" => "no-cache",
+                       "Pragma" => "no-cache",
+                       "DNT" => "1",
+                       "Referer" => page_url
+                     })
+        r.raise_for_status
+        html = r.body
+
+        arr = parse_nuxt_array(html)
+        token = parse_mail_service_token(arr)
+
+        domains = (parse_quoted_json_array(html, "emailDomains") + KNOWN_EMAIL_DOMAINS).uniq
+        domains = KNOWN_EMAIL_DOMAINS.dup if domains.empty?
+
+        blocked = parse_quoted_json_array(html, "blockedUsernames").map(&:downcase).to_set
+
+        dom_hint = domain && domain.to_s.strip.include?(".") ? domain.to_s.strip : nil
+        mail_domain = pick_mailbox_domain(dom_hint, domains)
+
+        local = nil
+        32.times do
+          cand = random_local(10)
+          unless blocked.include?(cand.downcase)
+            local = cand
+            break
+          end
+        end
+        raise "10minute-one: could not pick username" unless local
+
+        address = "#{local}@#{mail_domain}"
+        exp_ms = jwt_exp_ms(token)
+        EmailInfo.new(channel: CHANNEL, email: address, token: token, expires_at: exp_ms)
+      end
+
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        url = "#{API_BASE}/mailbox/#{enc_mailbox_email(email)}"
+        r = Http.get(url, headers: api_headers(token))
+        r.raise_for_status
+        data = r.json
+        raise "10minute-one: invalid inbox JSON" unless data.is_a?(Array)
+
+        data.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          row = raw.dup
+          if item_needs_detail(row)
+            mid = row["id"].to_s
+            detail_url = "#{API_BASE}/mailbox/#{enc_mailbox_email(email)}/#{URI.encode_www_form_component(mid)}"
+            begin
+              d = Http.get(detail_url, headers: api_headers(token))
+              if d.ok?
+                detail = d.json
+                if detail.is_a?(Hash)
+                  detail.each { |k, v| row[k] = v unless row.key?(k) }
+                end
+              end
+            rescue StandardError
+              # 忽略详情失败
+            end
+          end
+          Normalize.normalize_email(row, email)
+        end
+      end
+    end
+  end
+end