tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/haribu.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+require "base64"
+require "cgi"
+require "json"
+
+module TempmailSdk
+  module Providers
+    # Haribu 渠道 — https://haribu.net
+    # Tempail 类模式，session cookies 维持会话
+    module Haribu
+      CHANNEL = "haribu"
+      BASE = "https://haribu.net"
+      TOK_PREFIX = "haribu1:"
+
+      HEADERS = {
+        "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",
+        "DNT" => "1",
+        "Pragma" => "no-cache",
+        "Upgrade-Insecure-Requests" => "1",
+        "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
+
+      # 匹配 <input id="eposta_adres" value="xxx@yyy.com">
+      EMAIL_INPUT_RE = /<input[^>]+id\s*=\s*["']eposta_adres["'][^>]+value\s*=\s*["']([^"']+)["']/i
+      EMAIL_INPUT_RE2 = /<input[^>]+value\s*=\s*["']([^"']+@[^"']+)["'][^>]+id\s*=\s*["']eposta_adres["']/i
+      MAIL_ITEM_RE = /<li\s+class\s*=\s*["']mail["'][^>]*>([\s\S]*?)<\/li>/mi
+      FROM_RE = /<span\s+class\s*=\s*["']mail_gonderen["'][^>]*>([\s\S]*?)<\/span>/mi
+      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
+      TAG_RE = /<[^>]+>/
+
+      module_function
+
+      def strip_tags(html_str)
+        html_str.gsub(TAG_RE, " ").strip
+      end
+
+      # 从响应中合并 cookies
+      def merge_cookies(prev, resp)
+        existing = {}
+        prev.to_s.split(";").each do |part|
+          part = part.strip
+          next unless part.include?("=")
+
+          k, v = part.split("=", 2)
+          existing[k.strip] = v.to_s.strip unless k.strip.empty?
+        end
+        resp.set_cookies.each do |line|
+          pair = line.split(";", 2).first.to_s.strip
+          next unless pair.include?("=")
+
+          k, v = pair.split("=", 2)
+          existing[k.strip] = v.to_s.strip unless k.strip.empty?
+        end
+        existing.keys.sort.map { |k| "#{k}=#{existing[k]}" }.join("; ")
+      end
+
+      # 编码 session token
+      def encode_sess(cookie_hdr)
+        payload = JSON.generate("c" => cookie_hdr)
+        TOK_PREFIX + Base64.strict_encode64(payload)
+      end
+
+      # 解码 session token
+      def decode_sess(token)
+        raise "haribu: 无效的会话令牌" unless token.to_s.start_with?(TOK_PREFIX)
+
+        raw = token[TOK_PREFIX.length..]
+        data = JSON.parse(Base64.strict_decode64(raw))
+        cookie_hdr = (data["c"] || "").strip
+        raise "haribu: 会话令牌中缺少 cookie" if cookie_hdr.empty?
+
+        cookie_hdr
+      rescue ArgumentError, JSON::ParserError
+        raise "haribu: 无效的会话令牌"
+      end
+
+      # 从 HTML 中提取邮箱地址
+      def extract_email(html_str)
+        m = html_str.match(EMAIL_INPUT_RE) || html_str.match(EMAIL_INPUT_RE2)
+        raise "haribu: 未找到邮箱地址" unless m
+
+        addr = CGI.unescapeHTML(m[1]).strip
+        raise "haribu: 邮箱地址无效" unless addr.include?("@")
+
+        addr
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get(BASE, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        raise "haribu: 首页响应为空" if resp.body.empty?
+
+        email_addr = extract_email(resp.body)
+        cookie_hdr = merge_cookies("", resp)
+        token = encode_sess(cookie_hdr)
+
+        EmailInfo.new(channel: CHANNEL, email: email_addr, token: token)
+      end
+
+      # 获取邮件详情页正文
+      def fetch_detail(detail_url, cookie_hdr)
+        hdrs = HEADERS.merge("Cookie" => cookie_hdr, "Referer" => BASE)
+        resp = Http.get(detail_url, headers: hdrs, timeout: 15)
+        return "" unless resp.ok?
+
+        m = resp.body.match(BODY_RE)
+        m ? m[1].strip : ""
+      rescue StandardError
+        ""
+      end
+
+      # 获取邮件列表
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        e = (email || "").strip
+        raise "haribu: 邮箱地址为空" if e.empty?
+
+        cookie_hdr = decode_sess(token)
+
+        # 触发新邮件检查
+        begin
+          kontrol_hdrs = HEADERS.merge(
+            "Cookie" => cookie_hdr,
+            "Referer" => BASE,
+            "X-Requested-With" => "XMLHttpRequest"
+          )
+          Http.get("#{BASE}/en/api-kontrol/", headers: kontrol_hdrs, timeout: 15)
+        rescue StandardError
+          # 忽略
+        end
+
+        # GET 首页获取收件箱
+        inbox_hdrs = HEADERS.merge("Cookie" => cookie_hdr, "Referer" => BASE)
+        resp = Http.get(BASE, headers: inbox_hdrs, timeout: 15)
+        resp.raise_for_status
+
+        items = resp.body.scan(MAIL_ITEM_RE).map(&:first)
+        return [] if items.empty?
+
+        items.each_with_index.filter_map do |content, idx|
+          raw = { "id" => "haribu-#{idx}", "to" => e }
+
+          fm = content.match(FROM_RE)
+          raw["from"] = CGI.unescapeHTML(strip_tags(fm[1])).strip if fm
+
+          sm = content.match(SUBJECT_RE)
+          raw["subject"] = CGI.unescapeHTML(strip_tags(sm[1])).strip if sm
+
+          dm = content.match(DATE_RE)
+          raw["date"] = CGI.unescapeHTML(strip_tags(dm[1])).strip if dm
+
+          lm = content.match(MAIL_LINK_RE)
+          if lm
+            detail_url = lm[1]
+            detail_url = "#{BASE}/#{detail_url.sub(%r{\A/}, '')}" unless detail_url.start_with?("http")
+            html_body = fetch_detail(detail_url, cookie_hdr)
+            raw["html"] = html_body unless html_body.empty?
+          end
+
+          Normalize.normalize_email(raw, e)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/inboxes.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # inboxes.com 渠道实现
+    module Inboxes
+      CHANNEL = "inboxes"
+      API_BASE = "https://inboxes.com/api/v2"
+      DEFAULT_DOMAIN = "blondmail.com"
+      HEADERS = {
+        "Accept" => "application/json",
+        "Origin" => "https://inboxes.com",
+        "Referer" => "https://inboxes.com/",
+        "User-Agent" => "Mozilla/5.0"
+      }.freeze
+
+      module_function
+
+      def random_local
+        chars = "abcdefghijklmnopqrstuvwxyz0123456789".chars
+        "sdk" + Array.new(16) { chars.sample }.join
+      end
+
+      # 获取可用域名列表
+      def get_domains
+        resp = Http.get("#{API_BASE}/domain", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        items = data.is_a?(Hash) ? (data["domains"] || []) : []
+        domains = items.select { |i| i.is_a?(Hash) && !i["qdn"].to_s.strip.empty? }
+                       .map { |i| i["qdn"].to_s.strip }
+        raise "inboxes: no domains" if domains.empty?
+
+        domains
+      end
+
+      def pick_domain(domains, preferred)
+        wanted = preferred.to_s.strip.delete_prefix("@").downcase
+        unless wanted.empty?
+          domains.each { |d| return d if d.downcase == wanted }
+        end
+        return DEFAULT_DOMAIN if domains.include?(DEFAULT_DOMAIN)
+
+        domains.first
+      end
+
+      def flatten(raw, recipient)
+        {
+          "id" => (raw["uid"] || "").to_s,
+          "from" => (raw["sf"] || raw["f"] || "").to_s,
+          "to" => (raw["ib"] || recipient).to_s,
+          "subject" => (raw["s"] || "").to_s,
+          "text" => (raw["text"] || "").to_s,
+          "html" => (raw["html"] || "").to_s,
+          "preview_text" => (raw["ph"] || "").to_s,
+          "date" => (raw["cr"] || "").to_s,
+          "isRead" => !!raw["ru"],
+          "attachments" => raw["at"].is_a?(Array) ? raw["at"] : []
+        }
+      end
+
+      # @param domain [String, nil] 可选指定域名
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        domains = get_domains
+        selected = pick_domain(domains, domain)
+        EmailInfo.new(channel: CHANNEL, email: "#{random_local}@#{selected}")
+      end
+
+      def fetch_detail(uid)
+        return nil if uid.to_s.strip.empty?
+
+        begin
+          resp = Http.get(
+            "#{API_BASE}/message/#{URI.encode_www_form_component(uid)}",
+            headers: HEADERS, timeout: 15
+          )
+          return nil unless resp.ok?
+
+          data = resp.json
+          data.is_a?(Hash) ? data : nil
+        rescue StandardError
+          nil
+        end
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "inboxes: empty email" if address.empty?
+
+        resp = Http.get(
+          "#{API_BASE}/inbox/#{URI.encode_www_form_component(address)}",
+          headers: HEADERS, timeout: 15
+        )
+        resp.raise_for_status
+        data = resp.json
+        rows = data.is_a?(Hash) ? (data["msgs"] || []) : []
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map do |row|
+          uid = (row["uid"] || "").to_s.strip
+          detail = uid.empty? ? nil : fetch_detail(uid)
+          Normalize.normalize_email(flatten(detail || row, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/inboxkitten.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # InboxKitten 渠道 — https://inboxkitten.com
+    module Inboxkitten
+      CHANNEL = "inboxkitten"
+      API_BASE = "https://inboxkitten.com/api/v1/mail"
+      DOMAIN = "inboxkitten.com"
+      HEADERS_JSON = { "Accept" => "application/json" }.freeze
+      HEADERS_HTML = { "Accept" => "text/html,*/*" }.freeze
+
+      module_function
+
+      def random_local
+        chars = "abcdefghijklmnopqrstuvwxyz0123456789".chars
+        "sdk" + Array.new(16) { chars.sample }.join
+      end
+
+      # 无需请求服务端，随机本地部分即可
+      # @return [EmailInfo]
+      def generate_email
+        EmailInfo.new(channel: CHANNEL, email: "#{random_local}@#{DOMAIN}")
+      end
+
+      def fetch_meta(region, key)
+        resp = Http.get(
+          "#{API_BASE}/getKey?region=#{URI.encode_www_form_component(region)}&key=#{URI.encode_www_form_component(key)}",
+          headers: HEADERS_JSON, timeout: 15
+        )
+        resp.raise_for_status
+        data = resp.json
+        data.is_a?(Hash) ? data : {}
+      end
+
+      def fetch_html(region, key)
+        resp = Http.get(
+          "#{API_BASE}/getHtml?region=#{URI.encode_www_form_component(region)}&key=#{URI.encode_www_form_component(key)}",
+          headers: HEADERS_HTML, timeout: 15
+        )
+        resp.raise_for_status
+        resp.body
+      end
+
+      def detail_raw(row, recipient)
+        storage = row["storage"].is_a?(Hash) ? row["storage"] : {}
+        message = row["message"].is_a?(Hash) ? row["message"] : {}
+        headers = message["headers"].is_a?(Hash) ? message["headers"] : {}
+        envelope = row["envelope"].is_a?(Hash) ? row["envelope"] : {}
+        region = storage["region"].to_s.strip
+        key = storage["key"].to_s.strip
+        raw = {
+          "id" => key, "messageId" => key,
+          "from" => headers["from"] || envelope["sender"] || "",
+          "to" => row["recipient"] || envelope["targets"] || recipient,
+          "subject" => headers["subject"] || "", "timestamp" => row["timestamp"]
+        }
+        return raw if region.empty? || key.empty?
+
+        begin
+          meta = fetch_meta(region, key)
+          html = fetch_html(region, key)
+          raw["from"] = meta["name"] || raw["from"]
+          raw["to"] = meta["recipients"] || raw["to"]
+          raw["subject"] = meta["subject"] || raw["subject"]
+          raw["text"] = HtmlUtils.html_to_text(html)
+          raw["html"] = html
+        rescue StandardError
+          # 忽略详情失败
+        end
+        raw
+      end
+
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        local = email.to_s.strip.split("@").first.to_s
+        raise "inboxkitten: empty email" if local.empty?
+
+        resp = Http.get("#{API_BASE}/list?recipient=#{URI.encode_www_form_component(local)}",
+                        headers: HEADERS_JSON, timeout: 15)
+        resp.raise_for_status
+        rows = resp.json
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |r| r.is_a?(Hash) }.map { |item| Normalize.normalize_email(detail_raw(item, email), email) }
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/linshiyou.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module TempmailSdk
+  module Providers
+    # linshiyou.com 临时邮 — NEXUS_TOKEN + tmail-emails Cookie，邮件接口返回 HTML 分片
+    module Linshiyou
+      CHANNEL = "linshiyou"
+      ORIGIN = "https://linshiyou.com"
+
+      DEFAULT_HEADERS = {
+        "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-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",
+        "priority" => "u=1, i",
+        "referer" => "#{ORIGIN}/",
+        "sec-ch-ua" => '"Chromium";v="146", "Not-A.Brand";v="24", "Microsoft Edge";v="146"',
+        "sec-ch-ua-mobile" => "?0",
+        "sec-ch-ua-platform" => '"Windows"',
+        "sec-fetch-dest" => "empty",
+        "sec-fetch-mode" => "cors",
+        "sec-fetch-site" => "same-origin"
+      }.freeze
+
+      RE_LIST_ID = /id="tmail-email-list-([a-f0-9]+)"/i
+      RE_DIV = /<div class="([^"]+)"[^>]*>([\s\S]*?)<\/div>/i
+      RE_SRCDOC = /\ssrcdoc="([^"]*)"/i
+      RE_DOWNLOAD = /href="(\/api\/download\?id=[^"]+)"/i
+      RE_TAGS = /<[^>]+>/
+
+      module_function
+
+      def strip_tags(s)
+        t = s.gsub(RE_TAGS, " ")
+        CGI.unescapeHTML(t).split.join(" ")
+      end
+
+      def pick_div(fragment, class_name)
+        fragment.scan(RE_DIV).each do |cls, inner|
+          return strip_tags(inner).strip if cls == class_name
+        end
+        ""
+      end
+
+      def parse_date(s)
+        s = s.to_s.strip
+        return "" if s.empty?
+
+        ["%Y-%m-%d %H:%M:%S", "%Y-%m-%dT%H:%M:%S"].each do |fmt|
+          begin
+            dt = Time.strptime(s, fmt)
+            return dt.utc.strftime("%Y-%m-%dT%H:%M:%SZ")
+          rescue ArgumentError
+            next
+          end
+        end
+        ""
+      end
+
+      def extract_srcdoc(body_part)
+        m = body_part.match(RE_SRCDOC)
+        return "" unless m
+
+        CGI.unescapeHTML(m[1])
+      end
+
+      # 解析邮件分段
+      def parse_segments(raw, recipient)
+        raw = raw.to_s.strip
+        return [] if raw.empty?
+
+        out = []
+        raw.split("<-----TMAILNEXTMAIL----->").each do |seg|
+          seg = seg.strip
+          next if seg.empty?
+
+          parts = seg.split("<-----TMAILCHOPPER----->", 2)
+          list_part = parts[0]
+          body_part = parts.length > 1 ? parts[1] : ""
+
+          mid = list_part.match(RE_LIST_ID)
+          next unless mid
+
+          mid_str = mid[1]
+
+          from_list = pick_div(list_part, "name")
+          subject_list = pick_div(list_part, "subject")
+          preview_list = pick_div(list_part, "body")
+
+          from_body = pick_div(body_part, "tmail-email-sender")
+          time_body = pick_div(body_part, "tmail-email-time")
+          title_body = pick_div(body_part, "tmail-email-title")
+          html_body = extract_srcdoc(body_part)
+
+          from_addr = from_body.empty? ? from_list : from_body
+          subject = title_body.empty? ? subject_list : title_body
+          text = preview_list.empty? ? strip_tags(html_body) : preview_list
+
+          attachments = []
+          dm = body_part.match(RE_DOWNLOAD)
+          if dm
+            attachments << EmailAttachment.new(filename: "", url: "#{ORIGIN}#{dm[1]}")
+          end
+
+          out << Email.new(
+            id: mid_str,
+            from_addr: from_addr,
+            to: recipient,
+            subject: subject,
+            text: text,
+            html: html_body,
+            date: parse_date(time_body),
+            is_read: false,
+            attachments: attachments
+          )
+        end
+        out
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.get("#{ORIGIN}/api/user?user", headers: DEFAULT_HEADERS)
+        resp.raise_for_status
+
+        nexus = resp.cookie_value("NEXUS_TOKEN")
+        raise "linshiyou: NEXUS_TOKEN not in Set-Cookie" if nexus.nil? || nexus.empty?
+
+        email = resp.body.strip
+        raise "linshiyou: invalid email in response body" if email.empty? || !email.include?("@")
+
+        token = "NEXUS_TOKEN=#{nexus}; tmail-emails=#{email}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取邮件列表
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email = "")
+        resp = Http.get(
+          "#{ORIGIN}/api/mail?unseen=1",
+          headers: DEFAULT_HEADERS.merge(
+            "Cookie" => token,
+            "x-requested-with" => "XMLHttpRequest"
+          )
+        )
+        resp.raise_for_status
+        parse_segments(resp.body, email)
+      end
+    end
+  end
+end