tempmail_sdk 1.3.3 → 1.3.5

data/lib/tempmail_sdk/providers/chatgpt_org_uk.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # chatgpt.org.uk 渠道实现
+    #
+    # 流程：
+    #   1. GET /api/domains/public 获取可用域名列表（过滤 is_active=1）
+    #   2. 本地生成随机用户名，拼接邮箱地址
+    #   3. POST /api/inbox-token {"email":"..."} 创建收件箱，返回 inbox JWT 和 gm_sid cookie
+    #   4. GET /api/emails?email=... 携带 x-inbox-token 和 gm_sid cookie 获取邮件
+    # token 格式: JSON {"gmSid":"...","inbox":"..."}
+    module ChatgptOrgUk
+      CHANNEL = "chatgpt-org-uk"
+      API_BASE = "https://mail.chatgpt.org.uk/api"
+      USERNAME_CHARS = ("a".."z").to_a + ("0".."9").to_a
+
+      HEADERS = {
+        "Accept" => "*/*",
+        "DNT" => "1",
+        "Origin" => "https://mail.chatgpt.org.uk",
+        "Referer" => "https://mail.chatgpt.org.uk/zh/",
+        "sec-fetch-dest" => "empty",
+        "sec-fetch-mode" => "cors",
+        "sec-fetch-site" => "same-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"
+      }.freeze
+
+      module_function
+
+      # 生成随机用户名
+      def random_username(length = 10)
+        Array.new(length) { USERNAME_CHARS.sample }.join
+      end
+
+      # 获取可用域名列表
+      def fetch_domains
+        resp = Http.get("#{API_BASE}/domains/public", headers: HEADERS)
+        resp.raise_for_status
+        data = resp.json
+        raise "chatgpt-org-uk: 获取域名失败" unless data["success"]
+
+        domains = data.dig("data", "domains") || []
+        active = domains.select { |d| d["is_active"] == 1 && !d["domain_name"].to_s.empty? }
+                        .map { |d| d["domain_name"] }
+        raise "chatgpt-org-uk: 无可用域名" if active.empty?
+
+        active
+      end
+
+      # 创建收件箱，返回 [inbox_token, gm_sid]
+      def create_inbox(email)
+        resp = Http.post("#{API_BASE}/inbox-token",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: { "email" => email })
+        resp.raise_for_status
+        gm_sid = resp.cookie_value("gm_sid").to_s
+        data = resp.json
+        raise "chatgpt-org-uk: inbox-token 响应缺少 token" \
+          unless data["success"] && !data.dig("auth", "token").to_s.empty?
+
+        [data.dig("auth", "token"), gm_sid]
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        domains = fetch_domains
+        domain = domains.sample
+        email = "#{random_username}@#{domain}"
+        inbox, gm_sid = create_inbox(email)
+        packed = JSON.generate("gmSid" => gm_sid, "inbox" => inbox)
+        EmailInfo.new(channel: CHANNEL, email: email, token: packed)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String] JSON {"gmSid":"...","inbox":"..."}
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        parsed = JSON.parse(token)
+        gm_sid = parsed["gmSid"].to_s
+        inbox = parsed["inbox"].to_s
+        raise "chatgpt-org-uk: inbox token 缺失" if inbox.empty?
+
+        # gm_sid 丢失时重新创建 session
+        if gm_sid.empty?
+          inbox, gm_sid = create_inbox(email)
+        end
+
+        fetch_emails_with(email, inbox, gm_sid)
+      rescue JSON::ParserError
+        raise "chatgpt-org-uk: 无效的 token 格式"
+      end
+
+      # 实际拉取邮件，401/403 时重建 session 重试一次
+      def fetch_emails_with(email, inbox, gm_sid)
+        encoded = URI.encode_www_form_component(email)
+        resp = Http.get("#{API_BASE}/emails?email=#{encoded}",
+                        headers: HEADERS.merge(
+                          "Cookie" => "gm_sid=#{gm_sid}",
+                          "x-inbox-token" => inbox
+                        ))
+        if [401, 403].include?(resp.status_code)
+          new_inbox, new_sid = create_inbox(email)
+          resp = Http.get("#{API_BASE}/emails?email=#{encoded}",
+                          headers: HEADERS.merge(
+                            "Cookie" => "gm_sid=#{new_sid}",
+                            "x-inbox-token" => new_inbox
+                          ))
+        end
+        resp.raise_for_status
+        data = resp.json
+        raise "chatgpt-org-uk: 获取邮件失败" unless data["success"]
+
+        emails_raw = data.dig("data", "emails") || []
+        emails_raw.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(raw, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/clawdemail.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # ClawdEmail 渠道实现（clawdemail.com，API 域 api.clawdemail.com）
+    #
+    # POST /register 建箱（无验证码，body {"name":"xxx"}，响应 success/email/token），
+    # GET /inbox 读信列表（Header Authorization: Bearer <token>，
+    #   响应 success/email/count/unread/emails[]），GET /email/{id} 取单封详情（Bearer）。
+    # 信件保留 30 分钟，仅接收不发送，正文仅纯文本。
+    module Clawdemail
+      CHANNEL = "clawdemail"
+      BASE_URL = "https://api.clawdemail.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
+
+      # 设置 clawdemail 请求的通用请求头（可选附带 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
+
+      # 创建 clawdemail.com 临时邮箱
+      # POST /register（body {"name":""}）返回 email 与 token。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/register",
+                         headers: auth_headers("").merge("Content-Type" => "application/json"),
+                         json: { "name" => "" }, timeout: 15)
+        raise "clawdemail: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "clawdemail: 创建响应非对象" unless data.is_a?(Hash)
+
+        email = data["email"].to_s.strip
+        token = data["token"].to_s.strip
+        raise "clawdemail: 创建邮箱响应缺少必要字段" if email.empty? || token.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 clawdemail.com 邮件列表
+      # 流程：GET /inbox?limit=50 取列表，对每个元素按 id 逐封 GET /email/{id} 合并详情；
+      # 详情失败时以列表摘要归一。
+      # @param email [String] 邮箱地址
+      # @param token [String] 注册返回的认证令牌
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        resp = Http.get("#{BASE_URL}/inbox?limit=50",
+                        headers: auth_headers(token), timeout: 15)
+        raise "clawdemail: 获取邮件列表失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        raise "clawdemail: 收件箱响应非对象" unless data.is_a?(Hash)
+
+        unless data["success"] == true
+          raise "clawdemail: 读取收件箱失败: #{data["error"]}"
+        end
+        emails = data["emails"]
+        return [] unless emails.is_a?(Array)
+
+        emails.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
+
+      # 获取 clawdemail.com 单封邮件详情
+      # GET /email/{id}（Bearer token），响应含 email 嵌套对象（from_addr/body_text/received_at）
+      # 时提升嵌套对象。
+      # @param token [String] 认证令牌
+      # @param id [String] 邮件 ID
+      # @return [Hash, nil]
+      def get_detail(token, id)
+        return nil if id.to_s.empty?
+
+        uri = "#{BASE_URL}/email/#{URI.encode_www_form_component(id)}"
+        resp = Http.get(uri, headers: auth_headers(token), timeout: 15)
+        return nil unless resp.ok?
+
+        detail = resp.json
+        return nil unless detail.is_a?(Hash)
+
+        nested = detail["email"]
+        nested.is_a?(Hash) ? nested : detail
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/crazymailing.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Crazymailing 渠道实现（crazymailing.com）
+    #
+    # Next.js 全栈站点，API 结构：
+    #   POST /api/mailbox（空 JSON body）建箱，响应
+    #     {"mailbox":{"id":"...","address":"...@crazymailing.com","expiresAt":"<RFC3339>"}}；
+    #   GET /api/messages?mailbox=<完整地址 URL 编码> 读信，响应 {"messages":[...]}；
+    #   GET /api/message/{id}/body 取单封正文（完整 HTML 页面）。
+    # 请求需携带 Origin/Referer 浏览器形态头。
+    module Crazymailing
+      CHANNEL = "crazymailing"
+      BASE_URL = "https://crazymailing.com"
+
+      HEADERS = {
+        "Content-Type" => "application/json",
+        "Accept" => "application/json",
+        "Origin" => BASE_URL,
+        "Referer" => "#{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
+
+      RETRY_KEYS = %w[id Id slug messageId message_id].freeze
+
+      module_function
+
+      # 创建临时邮箱
+      # POST /api/mailbox（空 JSON body）；域名由服务端统一分配（当前仅 @crazymailing.com）。
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/mailbox",
+                         headers: HEADERS, json: {}, timeout: 15)
+        raise "crazymailing: 创建邮箱失败 http #{resp.status_code}" unless resp.ok?
+
+        data = resp.json
+        mailbox = data.is_a?(Hash) ? data["mailbox"] : nil
+        raise "crazymailing: 创建响应缺少 mailbox" unless mailbox.is_a?(Hash)
+
+        address = mailbox["address"].to_s.strip
+        raise "crazymailing: 创建响应缺少 mailbox.address" if address.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: address,
+                      token: mailbox["id"].to_s, expires_at: mailbox["expiresAt"].to_s)
+      end
+
+      # 读取收件箱
+      # GET /api/messages?mailbox=<完整地址 URL 编码>，响应 {"messages":[...]}；
+      # 对每个元素逐封 GET /api/message/{id}/body 拉取正文（失败不阻断列表）。
+      # @param email [String] 完整邮箱地址
+      # @param token [String] 建箱返回的 mailbox id
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "crazymailing: 邮箱地址为空" if addr.empty?
+
+        uri = "#{BASE_URL}/api/messages?mailbox=#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        raise "crazymailing: 读取收件箱失败 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)
+
+          row = m.dup
+          row["to"] = addr unless row.key?("to")
+          id = message_id_of(row)
+          unless id.empty?
+            # 列表元素为摘要，正文须逐封二拉（失败不阻断）
+            html = get_body(id)
+            row["html"] = html if !html.empty?
+          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
+
+      # 拉取单封正文（GET /api/message/{id}/body，响应为完整 HTML 页面）
+      # @param id [String] 邮件 ID
+      # @return [String]
+      def get_body(id)
+        uri = "#{BASE_URL}/api/message/#{URI.encode_www_form_component(id)}/body"
+        resp = Http.get(uri,
+                        headers: {
+                          "Accept" => "text/html,application/xhtml+xml,*/*;q=0.8",
+                          "Origin" => BASE_URL,
+                          "Referer" => "#{BASE_URL}/",
+                          "User-Agent" => HEADERS["User-Agent"]
+                        },
+                        timeout: 15)
+        return "" unless resp.ok?
+
+        resp.body.to_s
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/disposablemail.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # disposablemail.com 渠道实现
+    #
+    # 流程：
+    #   1. GET / 获取 PHPSESSID cookie + HTML 中的 CSRF token（CSRF="xxx"）
+    #   2. GET /index/index?csrf_token={csrf} 创建邮箱，返回 {"email":"user@domain.com"}
+    #   3. GET /index/refresh 携带 session cookie 获取邮件列表（捷克语字段: predmet/od/kdy/precteno）
+    #   4. GET /email/id/{id} 获取邮件正文 HTML
+    # token 存储 "PHPSESSID=xxx" cookie 字符串。
+    module Disposablemail
+      CHANNEL = "disposablemail"
+      BASE_URL = "https://www.disposablemail.com"
+
+      CSRF_RE = /CSRF="([^"]+)"/.freeze
+
+      BROWSER_HEADERS = {
+        "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",
+        "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
+
+      AJAX_HEADERS = {
+        "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",
+        "Referer" => "#{BASE_URL}/",
+        "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",
+        "X-Requested-With" => "XMLHttpRequest"
+      }.freeze
+
+      module_function
+
+      # 提取 Set-Cookie 中的 PHPSESSID
+      def extract_session(resp)
+        resp.set_cookies.each do |line|
+          first = line.split(";", 2).first.to_s.strip
+          k, v = first.split("=", 2)
+          return "#{k}=#{v}" if k == "PHPSESSID"
+        end
+        ""
+      end
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        r1 = Http.get("#{BASE_URL}/", headers: BROWSER_HEADERS)
+        r1.raise_for_status
+        m = r1.body.match(CSRF_RE)
+        raise "disposablemail: 未能从首页提取 CSRF token" unless m
+
+        csrf = m[1]
+        session_cookie = extract_session(r1)
+
+        r2 = Http.get("#{BASE_URL}/index/index?csrf_token=#{csrf}",
+                      headers: AJAX_HEADERS.merge(session_cookie.empty? ? {} : { "Cookie" => session_cookie }))
+        r2.raise_for_status
+
+        # 若 index 阶段刷新了 PHPSESSID，改用新的
+        new_sess = extract_session(r2)
+        session_cookie = new_sess unless new_sess.empty?
+
+        data = JSON.parse(r2.body)
+        email = data["email"].to_s.strip
+        raise "disposablemail: 邮箱地址无效: #{email.inspect}" if email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: session_cookie)
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String] PHPSESSID cookie 字符串
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        raise "disposablemail: 邮箱地址为空" if email.to_s.strip.empty?
+
+        headers = AJAX_HEADERS.dup
+        headers = headers.merge("Cookie" => token) unless token.to_s.empty?
+
+        resp = Http.get("#{BASE_URL}/index/refresh", headers: headers)
+        resp.raise_for_status
+        trimmed = resp.body.strip
+        return [] if trimmed == "0" || trimmed.empty? || trimmed == "[]"
+
+        list = begin
+          JSON.parse(trimmed)
+        rescue JSON::ParserError
+          []
+        end
+        return [] unless list.is_a?(Array) && !list.empty?
+
+        list.map do |item|
+          mail_id = item["id"].to_s
+          html_body = fetch_body(mail_id, token)
+          Normalize.normalize_email({
+            "id" => mail_id,
+            "from" => item["od"].to_s,
+            "to" => email,
+            "subject" => item["predmet"].to_s,
+            "html" => html_body,
+            "date" => item["kdy"].to_s,
+            "isRead" => item["precteno"] == "precteno"
+          }, email)
+        end
+      end
+
+      # 获取单封邮件 HTML 正文
+      def fetch_body(mail_id, token)
+        return "" if mail_id.empty?
+
+        headers = AJAX_HEADERS.dup
+        headers = headers.merge("Cookie" => token) unless token.to_s.empty?
+        resp = Http.get("#{BASE_URL}/email/id/#{mail_id}", headers: headers)
+        resp.ok? ? resp.body : ""
+      rescue StandardError
+        ""
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/disposablemail_app.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # disposablemail.app 渠道实现
+    #
+    # 纯 REST JSON API，无需认证。
+    # 创建收件箱: POST /api/inbox （body: {}）
+    # 获取邮件: GET /api/inbox/emails?token={token}
+    module DisposablemailApp
+      CHANNEL = "disposablemail-app"
+      API_BASE = "https://disposablemail.app/api"
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+        "Content-Type" => "application/json",
+        "Origin" => "https://disposablemail.app",
+        "Referer" => "https://disposablemail.app/",
+        "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
+
+      # 创建临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{API_BASE}/inbox", headers: HEADERS, body: "{}")
+        resp.raise_for_status
+        data = resp.json
+        address = data["address"].to_s.strip
+        token = data["token"].to_s.strip
+        raise "disposablemail-app: address 或 token 为空" if address.empty? || token.empty?
+
+        info = EmailInfo.new(channel: CHANNEL, email: address, token: token)
+        info.expires_at = data["expiresAt"].to_s
+        info.created_at = data["createdAt"].to_s
+        info
+      end
+
+      # 获取邮件列表
+      # @param email [String]
+      # @param token [String] API 返回的 token
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        raise "disposablemail-app: token 为空" if token.to_s.empty?
+
+        get_headers = HEADERS.reject { |k, _| k == "Content-Type" }
+        resp = Http.get("#{API_BASE}/inbox/emails?token=#{token}", headers: get_headers)
+        resp.raise_for_status
+        data = resp.json
+        emails_raw = data["emails"]
+        return [] unless emails_raw.is_a?(Array) && !emails_raw.empty?
+
+        emails_raw.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(raw, email)
+        end
+      end
+    end
+  end
+end