tempmail_sdk 1.3.3

data/lib/tempmail_sdk/providers/moakt.rb

@@ -0,0 +1,296 @@
+# frozen_string_literal: true
+
+require "base64"
+require "cgi"
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # moakt.com 渠道实现（HTML 抓取型）
+    #
+    # 流程：
+    #   1. GET 语言首页，收集初始 Cookie 与可用域名 <option> 列表；
+    #   2. POST /{locale}/inbox 创建邮箱（随机域名或指定域名），从 302 响应捕获 tm_session Cookie；
+    #   3. GET /{locale}/inbox 解析 #email-address 得到邮箱地址；
+    #   4. 会话凭证（locale + 序列化 Cookie 头）经 base64 打包进 token；
+    #   5. 收信时列表解析 /{locale}/email/{uuid}，正文 GET .../html 解析 .email-body。
+    #
+    # 多个渠道别名（moakt.cc/moakt.co/moakt.ws/tmail.ws 等）共用此实现，仅固定域名不同。
+    module Moakt
+      CHANNEL = "moakt"
+      ORIGIN = "https://www.moakt.com"
+      TOK_PREFIX = "mok1:"
+
+      # 默认 User-Agent（config.headers 未指定时使用）
+      DEFAULT_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"
+
+      # 页面请求的固定基础头
+      DEFAULT_HEADERS = {
+        "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",
+        "Upgrade-Insecure-Requests" => "1"
+      }.freeze
+
+      EMAIL_DIV_RE = /<div\s+id="email-address"\s*>([^<]+)<\/div>/im
+      DOMAIN_OPTION_RE = /<option\s+value="([^"]+)">\s*@[^<]+<\/option>/im
+      MAIL_DOMAIN_RE = /\A[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)+\z/i
+      HREF_EMAIL_RE = /href="(\/[^"]+\/email\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})"/
+      TITLE_RE = /<li\s+class="title"\s*>([^<]*)<\/li>/im
+      DATE_RE = /<li\s+class="date"[^>]*>[\s\S]*?<span[^>]*>([^<]+)<\/span>/im
+      SENDER_RE = /<li\s+class="sender"[^>]*>[\s\S]*?<span[^>]*>([\s\S]*?)<\/span>\s*<\/li>/im
+      BODY_RE = /<div\s+class="email-body"\s*>([\s\S]*?)<\/div>/im
+      FROM_ADDR_RE = /<([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})>/
+      TAG_RE = /<[^>]+>/
+
+      module_function
+
+      # 解析域名参数，返回 [locale, mail_domain]
+      # - 空或含非法字符：语言页取默认 "zh"，随机域名
+      # - 形如域名：locale="zh"，使用指定域名
+      # - 其它字符串：视为 locale，随机域名
+      def request_parts(domain)
+        s = domain.to_s.strip
+        return ["zh", ""] if s.empty? || s.match?(/[\/?#\\]/)
+        return ["zh", s.sub(/\A@/, "").downcase] if s.match?(MAIL_DOMAIN_RE)
+
+        [s, ""]
+      end
+
+      # 从首页 HTML 收集服务端提供的可用域名集合
+      def parse_server_domains(page)
+        page.scan(DOMAIN_OPTION_RE)
+            .map { |m| m[0].strip.sub(/\A@/, "").downcase }
+            .reject(&:empty?)
+      end
+
+      # 生成随机本地部分（小写字母 + 数字）
+      def random_local(length = 12)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 提取邮箱地址的域名部分（小写）
+      def email_domain(email)
+        _head, sep, domain = email.to_s.rpartition("@")
+        sep.empty? ? "" : domain.strip.downcase
+      end
+
+      # 将 Cookie 头字符串解析为 name => value 映射
+      def parse_cookie_map(hdr)
+        map = {}
+        hdr.to_s.split(";").each do |part|
+          part = part.strip
+          next unless part.include?("=")
+
+          k, v = part.split("=", 2)
+          k = k.strip
+          map[k] = v.to_s.strip unless k.empty?
+        end
+        map
+      end
+
+      # 从响应的 Set-Cookie 头提取本次新设置的 Cookie
+      def cookies_from_response(resp)
+        map = {}
+        resp.set_cookies.each do |line|
+          pair = line.split(";", 2).first.to_s.strip
+          next unless pair.include?("=")
+
+          k, v = pair.split("=", 2)
+          k = k.strip
+          map[k] = v.to_s.strip unless k.empty?
+        end
+        map
+      end
+
+      # 合并旧 Cookie 头与响应新设置的 Cookie，按 key 排序拼接（保证稳定）
+      def merge_cookie_hdr(prev, resp)
+        d = parse_cookie_map(prev)
+        d.merge!(cookies_from_response(resp))
+        d.keys.sort.map { |k| "#{k}=#{d[k]}" }.join("; ")
+      end
+
+      # 构造页面请求头
+      def page_headers(referer, ua)
+        DEFAULT_HEADERS.merge(
+          "User-Agent" => ua,
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9," \
+                      "image/avif,image/webp,image/apng,*/*;q=0.8",
+          "Referer" => referer
+        )
+      end
+
+      # 从 config 取 UA，缺省用内置默认值
+      def user_agent
+        (Config.get_config.headers || {})["User-Agent"] || DEFAULT_UA
+      end
+
+      # 将会话（locale + Cookie 头）编码为不透明 token
+      def encode_sess(locale, cookie_hdr)
+        raw = JSON.generate("l" => locale, "c" => cookie_hdr)
+        TOK_PREFIX + Base64.strict_encode64(raw)
+      end
+
+      # 解码 token，返回 [locale, cookie_hdr]
+      def decode_sess(tok)
+        raise "moakt: invalid session token" unless tok.to_s.start_with?(TOK_PREFIX)
+
+        data = Base64.strict_decode64(tok[TOK_PREFIX.length..])
+        o = JSON.parse(data)
+        loc = o["l"].to_s.strip
+        c = o["c"].to_s.strip
+        raise "moakt: invalid session token" if loc.empty? || c.empty?
+
+        [loc, c]
+      rescue ArgumentError, JSON::ParserError
+        raise "moakt: invalid session token"
+      end
+
+      # 从收件箱页解析邮箱地址
+      def parse_inbox_email(html_s)
+        m = html_s.match(EMAIL_DIV_RE)
+        raise "moakt: email-address not found" unless m
+
+        addr = CGI.unescapeHTML(m[1].strip)
+        raise "moakt: empty email-address" if addr.empty?
+
+        addr
+      end
+
+      # 去除 HTML 标签，压缩为文本
+      def strip_tags(s)
+        s.gsub(TAG_RE, " ").strip
+      end
+
+      # 从收件箱页提取邮件 UUID 列表（去重、排除删除链接）
+      def list_mail_ids(html_s)
+        seen = {}
+        out = []
+        html_s.scan(HREF_EMAIL_RE).each do |cap|
+          path = cap[0]
+          next if path.include?("/delete")
+
+          mid = path.split("/").last
+          if mid.length == 36 && !seen[mid]
+            seen[mid] = true
+            out << mid
+          end
+        end
+        out
+      end
+
+      # 解析邮件详情页，返回标准化前的原始 Hash
+      def parse_detail(page, mid, recipient)
+        from_s = ""
+        if (sm = page.match(SENDER_RE))
+          inner = CGI.unescapeHTML(sm[1])
+          from_s = strip_tags(inner)
+          if (em = inner.match(FROM_ADDR_RE))
+            from_s = em[1].strip
+          end
+        end
+
+        subj = ""
+        subj = CGI.unescapeHTML(page.match(TITLE_RE)[1].strip) if page.match?(TITLE_RE)
+
+        date_s = ""
+        date_s = CGI.unescapeHTML(page.match(DATE_RE)[1].strip) if page.match?(DATE_RE)
+
+        body = ""
+        body = page.match(BODY_RE)[1].strip if page.match?(BODY_RE)
+
+        {
+          "id" => mid,
+          "to" => recipient,
+          "from" => from_s,
+          "subject" => subj,
+          "date" => date_s,
+          "html" => body
+        }
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil] 指定接入域名或语言标识
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        loc, mail_domain = request_parts(domain)
+        base = "#{ORIGIN}/#{loc}"
+        inbox = "#{base}/inbox"
+        ua = user_agent
+
+        r1 = Http.get(base, headers: page_headers(base, ua))
+        r1.raise_for_status
+        cookie_hdr = merge_cookie_hdr("", r1)
+
+        if mail_domain.empty?
+          post_data = { "random" => "1" }
+        else
+          unless parse_server_domains(r1.body).include?(mail_domain)
+            raise "moakt: unsupported domain #{mail_domain}"
+          end
+
+          post_data = {
+            "setemail" => "",
+            "username" => random_local,
+            "domain" => mail_domain,
+            "preferred_domain" => ""
+          }
+        end
+
+        # POST /inbox 创建邮箱，从 302 响应捕获 tm_session Cookie（Net::HTTP 默认不跟随重定向）
+        r2 = Http.post(
+          inbox,
+          headers: page_headers(base, ua).merge(
+            "Content-Type" => "application/x-www-form-urlencoded",
+            "Cookie" => cookie_hdr
+          ),
+          body: URI.encode_www_form(post_data)
+        )
+        cookie_hdr = merge_cookie_hdr(cookie_hdr, r2)
+
+        unless parse_cookie_map(cookie_hdr).key?("tm_session")
+          raise "moakt: missing tm_session cookie"
+        end
+
+        # GET /inbox 获取邮箱地址
+        r3 = Http.get(inbox, headers: page_headers(base, ua).merge("Cookie" => cookie_hdr))
+        r3.raise_for_status
+        cookie_hdr = merge_cookie_hdr(cookie_hdr, r3)
+
+        email = parse_inbox_email(r3.body)
+        if !mail_domain.empty? && email_domain(email) != mail_domain
+          raise "moakt: domain mismatch expected=#{mail_domain} actual=#{email_domain(email)}"
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: encode_sess(loc, cookie_hdr))
+      end
+
+      # 收取邮件列表
+      # @param email [String]
+      # @param token [String]
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        loc, cookie_hdr = decode_sess(token)
+        inbox = "#{ORIGIN}/#{loc}/inbox"
+        base_ref = "#{ORIGIN}/#{loc}"
+        ua = user_agent
+
+        r = Http.get(inbox, headers: page_headers(base_ref, ua).merge("Cookie" => cookie_hdr))
+        r.raise_for_status
+
+        list_mail_ids(r.body).filter_map do |mid|
+          detail = "#{ORIGIN}/#{loc}/email/#{mid}/html"
+          refer = "#{ORIGIN}/#{loc}/email/#{mid}"
+          rd = Http.get(detail, headers: page_headers(refer, ua).merge("Cookie" => cookie_hdr))
+          next unless rd.status_code == 200
+
+          Normalize.normalize_email(parse_detail(rd.body, mid, email), email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/neighbours.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Neighbours 渠道实现
+    # API: https://neighbours.sh/api/v1
+    # 支持多域名选择
+    module Neighbours
+      CHANNEL = "neighbours"
+      API_BASE = "https://neighbours.sh/api/v1"
+      HEADERS = {
+        "Accept" => "application/json",
+        "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"
+      }.freeze
+
+      module_function
+
+      # 生成随机用户名
+      def random_local
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        "sdk" + Array.new(16) { chars.sample }.join
+      end
+
+      # 从 from/to 结构中提取首个可用地址
+      def first_address(value)
+        return "" if value.nil?
+        return value.strip if value.is_a?(String)
+
+        if value.is_a?(Array)
+          value.each do |item|
+            hit = first_address(item)
+            return hit unless hit.empty?
+          end
+          return ""
+        end
+
+        if value.is_a?(Hash)
+          addr = value["address"].to_s.strip
+          return addr unless addr.empty?
+
+          text = value["text"].to_s.strip
+          return text if text.include?("@")
+
+          return first_address(value["value"])
+        end
+
+        value.to_s.strip
+      end
+
+      # 请求 JSON，allow_404 时 404 返回 nil
+      def request_json(path, allow_404: false)
+        resp = Http.get("#{API_BASE}#{path}", headers: HEADERS, timeout: 15)
+        return nil if allow_404 && resp.status_code == 404
+
+        resp.raise_for_status
+        data = resp.json
+        data.is_a?(Hash) ? data : nil
+      end
+
+      # 将邮件映射为标准化中间格式
+      def flatten_message(raw, recipient)
+        {
+          "id" => (raw["uid"] || "").to_s,
+          "from" => first_address(raw["from"]),
+          "to" => first_address(raw["to"]).then { |v| v.empty? ? recipient : v },
+          "subject" => (raw["subject"] || "").to_s,
+          "text" => (raw["text"] || raw["snippet"] || "").to_s,
+          "html" => (raw["html"] || "").to_s,
+          "date" => (raw["date"] || raw["received_at"] || "").to_s,
+          "is_read" => false,
+          "attachments" => raw["attachments"] || []
+        }
+      end
+
+      # 获取可用域名列表
+      def list_domains
+        data = request_json("/config/domains")
+        domains = []
+        if data.is_a?(Hash)
+          nested = data["data"]
+          if nested.is_a?(Hash)
+            (nested["domains"] || []).each do |item|
+              s = item.to_s.strip.downcase
+              domains << s unless s.empty?
+            end
+          end
+        end
+        raise "neighbours: 域名列表为空" if domains.empty?
+
+        domains
+      end
+
+      # 获取单封邮件详情
+      def fetch_detail(address, uid)
+        data = request_json("/inbox/#{URI.encode_www_form_component(address)}/#{URI.encode_www_form_component(uid)}", allow_404: true)
+        return nil unless data.is_a?(Hash)
+
+        detail = data["data"]
+        detail.is_a?(Hash) ? detail : nil
+      end
+
+      # 创建临时邮箱
+      # @param domain [String, nil]
+      # @return [EmailInfo]
+      def generate_email(domain = nil)
+        domains = list_domains
+        if domain && !domain.to_s.strip.empty?
+          wanted = domain.strip.downcase
+          raise "neighbours: 不支持的域名 #{domain}" unless domains.include?(wanted)
+
+          selected = wanted
+        else
+          selected = domains.sample
+        end
+        email = "#{random_local}@#{selected}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "neighbours: 邮箱地址为空" if address.empty?
+
+        data = request_json("/inbox/#{URI.encode_www_form_component(address)}", allow_404: true)
+        return [] unless data.is_a?(Hash)
+
+        rows = data["data"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |item| item.is_a?(Hash) }.map do |item|
+          uid = item["uid"].to_s.strip
+          detail = uid.empty? ? nil : fetch_detail(address, uid)
+          Normalize.normalize_email(flatten_message(detail || item, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/neighbours_sh.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # neighbours-sh 渠道实现
+    # 公共收件箱模式，任意用户名即可收信，无需注册
+    # API: https://neighbours.sh/api/v1
+    module NeighboursSh
+      CHANNEL = "neighbours-sh"
+      API_BASE = "https://neighbours.sh/api/v1"
+      DOMAIN = "neighbours.sh"
+      HEADERS = {
+        "Accept" => "application/json",
+        "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"
+      }.freeze
+
+      module_function
+
+      # 生成随机用户名：前缀 sdk + 10 位小写字母数字
+      def random_local
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        "sdk" + Array.new(10) { chars.sample }.join
+      end
+
+      # 从 from/to 结构中提取首个可用地址
+      def first_address(value)
+        return "" if value.nil?
+        return value.strip if value.is_a?(String)
+
+        if value.is_a?(Array)
+          value.each do |item|
+            hit = first_address(item)
+            return hit unless hit.empty?
+          end
+          return ""
+        end
+
+        if value.is_a?(Hash)
+          addr = value["address"].to_s.strip
+          return addr unless addr.empty?
+
+          text = value["text"].to_s.strip
+          return text if text.include?("@")
+
+          return first_address(value["value"])
+        end
+
+        value.to_s.strip
+      end
+
+      # 请求 JSON，allow_404 时 404 返回 nil
+      def request_json(path, allow_404: false)
+        resp = Http.get("#{API_BASE}#{path}", headers: HEADERS, timeout: 15)
+        return nil if allow_404 && resp.status_code == 404
+
+        resp.raise_for_status
+        data = resp.json
+        data.is_a?(Hash) ? data : nil
+      end
+
+      # 将邮件详情映射为标准化中间格式
+      def flatten_message(detail, recipient)
+        {
+          "id" => (detail["uid"] || "").to_s,
+          "from" => first_address(detail["from"]),
+          "to" => first_address(detail["to"]).then { |v| v.empty? ? recipient : v },
+          "subject" => (detail["subject"] || "").to_s,
+          "text" => (detail["text"] || "").to_s,
+          "html" => (detail["html"] || "").to_s,
+          "date" => (detail["date"] || "").to_s,
+          "is_read" => false,
+          "attachments" => detail["attachments"] || []
+        }
+      end
+
+      # 获取单封邮件详情
+      def fetch_detail(address, uid)
+        data = request_json("/inbox/#{URI.encode_www_form_component(address)}/#{URI.encode_www_form_component(uid)}", allow_404: true)
+        return nil unless data.is_a?(Hash)
+
+        detail = data["data"]
+        detail.is_a?(Hash) ? detail : nil
+      end
+
+      # 创建临时邮箱（公共收件箱，本地生成地址）
+      # @return [EmailInfo]
+      def generate_email
+        email = "#{random_local}@#{DOMAIN}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        address = email.to_s.strip
+        raise "neighbours-sh: 缺少邮箱地址" if address.empty?
+
+        data = request_json("/inbox/#{URI.encode_www_form_component(address)}", allow_404: true)
+        return [] unless data
+
+        rows = data["data"]
+        return [] unless rows.is_a?(Array)
+
+        rows.select { |item| item.is_a?(Hash) }.filter_map do |item|
+          uid = item["uid"].to_s.strip
+          next if uid.empty?
+
+          detail = fetch_detail(address, uid)
+          next unless detail
+
+          Normalize.normalize_email(flatten_message(detail, address), address)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/nimail.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # nimail 渠道实现
+    # API: https://www.nimail.cn
+    # POST 表单 API，无需认证，token 即邮箱地址本身
+    module Nimail
+      CHANNEL = "nimail"
+      BASE_URL = "https://www.nimail.cn"
+
+      module_function
+
+      # 生成随机邮箱前缀
+      def random_local(n = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(n) { chars.sample }.join
+      end
+
+      # 获取 User-Agent
+      def 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"
+      end
+
+      # 按优先级从消息字典中提取首个非空值
+      def first(msg, *keys)
+        keys.each do |key|
+          val = msg[key]
+          return val.to_s if !val.nil? && val.to_s != ""
+        end
+        ""
+      end
+
+      # 创建 nimail.cn 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        email = "#{random_local(10)}@nimail.cn"
+
+        resp = Http.post(
+          "#{BASE_URL}/api/applymail",
+          headers: {
+            "User-Agent" => user_agent,
+            "Content-Type" => "application/x-www-form-urlencoded",
+            "Origin" => BASE_URL,
+            "Referer" => "#{BASE_URL}/"
+          },
+          body: "mail=#{URI.encode_www_form_component(email)}"
+        )
+        resp.raise_for_status
+
+        data = resp.json
+        unless data.is_a?(Hash) && data["success"] == "true" && data["user"]
+          raise "nimail: 创建邮箱失败 #{data.inspect}"
+        end
+
+        user = data["user"].to_s
+        EmailInfo.new(channel: CHANNEL, email: user, token: user)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        addr = email.to_s.strip
+        raise "nimail: 缺少邮箱地址" if addr.empty?
+
+        resp = Http.post(
+          "#{BASE_URL}/api/getmails",
+          headers: {
+            "User-Agent" => user_agent,
+            "Content-Type" => "application/x-www-form-urlencoded",
+            "Origin" => BASE_URL,
+            "Referer" => "#{BASE_URL}/"
+          },
+          body: "mail=#{URI.encode_www_form_component(addr)}&time=0"
+        )
+        resp.raise_for_status
+
+        data = resp.json
+        return [] unless data.is_a?(Hash) && data["success"] == "true"
+
+        mail = data["mail"]
+        return [] unless mail.is_a?(Array)
+
+        mail.select { |msg| msg.is_a?(Hash) }.map do |msg|
+          row = {
+            "id" => first(msg, "id", "time"),
+            "from" => first(msg, "from", "sender"),
+            "to" => addr,
+            "subject" => first(msg, "subject", "title"),
+            "text" => first(msg, "text", "content"),
+            "html" => first(msg, "html", "content"),
+            "date" => first(msg, "date", "time")
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end