tempmail_sdk 1.3.3 → 1.3.5

data/lib/tempmail_sdk/providers/nullmail.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Nullmail 渠道实现（nullmail.cc / maildock.store）
+    #
+    # 无认证 REST：
+    #   POST /api/emails（空 JSON body）建箱，响应
+    #   {"address":"...@maildock.store","expiry":"2026-09-27T02:25:28.778Z"}；
+    #   GET /api/emails/{address}（URL 编码）读信，响应 {"expiry":"...","emails":[...]}，
+    #   列表项只有 id/sender/subject/delivered，正文须逐封二拉 GET /api/emails/{addr}/body/{id}
+    #   （响应 {"body":...}）。
+    module Nullmail
+      CHANNEL = "nullmail"
+      BASE_URL = "https://www.nullmail.cc"
+      DOMAIN = "maildock.store"
+
+      HEADERS = {
+        "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/146.0.0.0 Safari/537.36 Edg/146.0.0.0"
+      }.freeze
+
+      module_function
+
+      # 创建 nullmail 临时邮箱
+      # POST /api/emails（空 JSON body），token 复用完整地址以便收件箱回查
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/emails",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: {}, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        addr = data.is_a?(Hash) ? data["address"].to_s.strip : ""
+        raise "nullmail: 建箱响应缺少 address 字段" if addr.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: addr, token: addr,
+                      expires_at: data["expiry"])
+      end
+
+      # 单封正文二拉
+      # GET /api/emails/{addr}/body/{id}，响应 {"body":"<完整纯文本正文>"}
+      # @param addr [String] 邮箱地址
+      # @param id [Object] 邮件 ID
+      # @return [String]
+      def fetch_body(addr, id)
+        uri = "#{BASE_URL}/api/emails/#{URI.encode_www_form_component(addr)}" \
+              "/body/#{URI.encode_www_form_component(id.to_s)}"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        data.is_a?(Hash) ? data["body"].to_s : ""
+      end
+
+      # 读取收件箱
+      # GET /api/emails/{address}（完整地址 URL 编码），列表项无正文，逐封二拉 body 端点；
+      # 正文拉取失败降级留空不阻断列表。
+      # @param email [String] 邮箱地址
+      # @param _token [String] 令牌（本渠道忽略，以邮箱为准）
+      # @return [Array<Email>]
+      def get_emails(email, _token)
+        addr = email.to_s.strip
+        raise "nullmail: 邮箱地址为空" if addr.empty?
+
+        uri = "#{BASE_URL}/api/emails/#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        emails = data.is_a?(Hash) ? data["emails"] : nil
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          row = {
+            "id" => m["id"],
+            "from" => m["sender"] || m["from"],
+            "to" => addr,
+            "subject" => m["subject"],
+            # 列表只有 id/sender/subject/delivered，delivered 显式映射为 date
+            "date" => m["delivered"] || m["date"]
+          }
+          body = fetch_body(addr, m["id"]) if m["id"]
+          row["text"] = body unless body.to_s.empty?
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/openinbox.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # openinbox.io 渠道实现
+    #
+    # 流程：POST /api/inbox 创建邮箱，返回 id + email
+    #       GET /api/emails/inbox/{id}?page=1&limit=50 获取邮件列表
+    #       GET /api/emails/{messageId} 获取邮件详情
+    # token 存储 inbox id
+    module Openinbox
+      CHANNEL = "openinbox"
+      BASE_URL = "https://api.openinbox.io/api"
+
+      HEADERS = {
+        "Accept" => "application/json, text/plain, */*",
+        "Origin" => "https://openinbox.io",
+        "Referer" => "https://openinbox.io/",
+        "User-Agent" => "Mozilla/5.0"
+      }.freeze
+
+      module_function
+
+      # 发起 JSON 请求
+      # @param method [String] "GET" 或 "POST"
+      # @param url [String]
+      # @return [Object] 解析后的 JSON
+      def json_request(method, url)
+        hdrs = HEADERS.dup
+        hdrs["Content-Type"] = "application/json" if method == "POST"
+        resp = method == "POST" ? Http.post(url, headers: hdrs, timeout: 15) : Http.get(url, headers: hdrs, timeout: 15)
+        resp.raise_for_status
+        resp.json
+      end
+
+      # 将邮件 raw map 展平为标准字段
+      # @param raw [Hash]
+      # @param recipient [String]
+      # @return [Hash]
+      def flatten(raw, recipient)
+        {
+          "id" => raw["id"],
+          "from" => raw["from"],
+          "to" => recipient,
+          "subject" => raw["subject"],
+          "text" => raw["textBody"],
+          "html" => raw["htmlBody"],
+          "receivedAt" => raw["receivedAt"],
+          "isRead" => raw["isRead"],
+          "attachments" => []
+        }
+      end
+
+      # 创建 openinbox.io 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        data = json_request("POST", BASE_URL + "/inbox")
+        id = data["id"].to_s.strip
+        email = data["email"].to_s.strip
+        raise "openinbox: 无效的邮箱响应" if id.empty? || email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: id)
+      end
+
+      # 获取 openinbox.io 邮件列表
+      # @param inbox_id [String] inbox id（token）
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(inbox_id, email)
+        inbox_id = inbox_id.to_s.strip
+        raise "openinbox: empty inbox id" if inbox_id.empty?
+
+        url = "#{BASE_URL}/emails/inbox/#{URI.encode_uri_component(inbox_id)}?page=1&limit=50"
+        data = json_request("GET", url)
+        rows = data.is_a?(Hash) ? Array(data["emails"]) : []
+
+        rows.filter_map do |row|
+          next unless row.is_a?(Hash)
+
+          raw = row
+          msg_id = row["id"].to_s.strip
+          unless msg_id.empty?
+            detail = fetch_detail(msg_id)
+            raw = detail if detail.is_a?(Hash)
+          end
+          Normalize.normalize_email(flatten(raw, email), email)
+        end
+      end
+
+      # 获取单封邮件详情
+      # @param message_id [String]
+      # @return [Hash, nil]
+      def fetch_detail(message_id)
+        json_request("GET", "#{BASE_URL}/emails/#{URI.encode_uri_component(message_id)}")
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/shadowmail.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Shadowmail 渠道实现（shadowmail.win）
+    #
+    # 完整接入契约：
+    #   注册 POST /api/register {"email":"<随机前缀>@gmail.com","password":"Abcd1234!"}
+    #     → 200 {"message":"Successfully Registered"}；
+    #   登录 POST /api/login → 200 {"message":"Successfull Login"}
+    #     并 Set-Cookie: sessionId=<uuid>（HttpOnly; Secure; Max-Age 3600）；
+    #   建箱 POST /api/new-address → 200 {...,"address":"<id>@shadowmail.win","id":<id>}；
+    #   读信 POST /api/get-emails {"address":"<地址>"} → 200 {"message":"Emails read",
+    #     "mails":[...]}；mails 元素字段 id/address_id/sender/subject/body/created_at。
+    # 会话隔离：全域使用显式 Cookie 头（sessionId=<uuid>），凭据串 token 持久化
+    #   注册邮箱/密码/会话 id，便于会话过期后自动重生。
+    module Shadowmail
+      CHANNEL = "shadowmail"
+      BASE_URL = "https://shadowmail.win"
+      # 固定注册密码（平台无自选密码入口，注册即固定）
+      PW = "Abcd1234!"
+      # 平台唯一收信域
+      DOMAIN = "shadowmail.win"
+      # 本渠道凭据串前缀
+      TOKEN_PREFIX = "shadowmail|"
+
+      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
+
+      # 生成随机注册邮箱前缀（sdk+8 位小写字母）
+      # @return [String]
+      def random_account
+        chars = "abcdefghijklmnopqrstuvwxyz"
+        "sdk" + Array.new(8) { chars[rand(chars.length)] }.join
+      end
+
+      # 携带显式 Cookie 的 JSON POST 请求，返回 [body, status, set_cookies]
+      # @param path [String] 请求路径
+      # @param body [Hash] JSON 请求体
+      # @param cookie [String] Cookie 头（可为空）
+      # @return [Array(Array, Integer, Array<String>)]
+      def do_post(path, body, cookie)
+        headers = HEADERS.dup
+        headers["Cookie"] = cookie unless cookie.to_s.empty?
+        resp = Http.post("#{BASE_URL}#{path}", headers: headers, json: body, timeout: 15)
+        [resp.json, resp.status_code, resp.set_cookies]
+      end
+
+      # 从 Set-Cookie 中提取 sessionId 值（纯 uuid，不含键名）
+      # @param cookies [Array<String>]
+      # @return [String]
+      def session_from(cookies)
+        cookies.each do |line|
+          kv = line.split(";").first.to_s.strip
+          return kv.split("=", 2)[1].to_s if kv.start_with?("sessionId=")
+        end
+        ""
+      end
+
+      # 注册或登录（POST /api/register、/api/login），返回会话 sessionId
+      # @param account [String] 注册邮箱
+      # @param password [String] 密码
+      # @param is_login [Boolean] true 走登录，false 走注册
+      # @return [String] sessionId 值
+      def register_login(account, password, is_login)
+        path = is_login ? "/api/login" : "/api/register"
+        body = { "email" => account, "password" => password }
+        data, status, cookies = do_post(path, body, "")
+        raise "shadowmail #{path}: http #{status}" if status < 200 || status >= 300
+
+        msg = data.is_a?(Hash) ? data["message"].to_s : ""
+        if is_login
+          raise "shadowmail login: #{msg}" unless msg == "Successfull Login"
+        else
+          # 重复注册（幂等）：消息为 Email already in use 时视为账号已存在，继续走登录
+          unless ["Successfully Registered", "Email already in use"].include?(msg)
+            raise "shadowmail register: #{msg}"
+          end
+        end
+        session = session_from(cookies)
+        if is_login && session.empty?
+          raise "shadowmail login: 未下发 sessionId Cookie"
+        end
+        session
+      end
+
+      # 注册账号并创建临时邮箱地址
+      # @return token 凭据串格式："shadowmail|<account>|<password>|<sessionId>"
+      # @return [EmailInfo]
+      def generate_email
+        account = "#{random_account}@gmail.com"
+
+        # 1) 注册（幂等：已存在同名账号则跳过）
+        register_login(account, PW, false)
+        # 2) 登录取得 sessionId
+        session = register_login(account, PW, true)
+        # 3) 创建地址（每账号 12 槽）：SDK 层显式 Cookie 头传 sessionId
+        data, status, = do_post("/api/new-address", {}, "sessionId=#{session}")
+        raise "shadowmail new-address: http #{status}" if status < 200 || status >= 300
+
+        address = data.is_a?(Hash) ? data["address"].to_s.strip : ""
+        raise "shadowmail new-address: 响应缺少有效地址" unless address.end_with?("@#{DOMAIN}")
+
+        # Token 持久化：account|password|sessionId（sessionId 为 uuid，无分隔符冲突）
+        token = TOKEN_PREFIX + [account, PW, session].join("|")
+        EmailInfo.new(channel: CHANNEL, email: address.downcase.strip, token: token)
+      end
+
+      # 解析凭据串为 account/password/sessionId 三元组
+      # @param token [String]
+      # @return [Array(String, String, String)]
+      def parse_token(token)
+        raise "shadowmail: token 格式错误" unless token.to_s.start_with?(TOKEN_PREFIX)
+
+        parts = token.to_s[TOKEN_PREFIX.length..].to_s.split("|", -1)
+        raise "shadowmail: token 字段缺失" unless parts.length == 3
+
+        account, password, session = parts
+        raise "shadowmail: token 凭据字段为空" if account.empty? || password.empty? || session.empty?
+
+        [account, password, session]
+      end
+
+      # 读取收件箱
+      # 会话失效时自动以凭据内 account/password 重新登录换新 sessionId。
+      # @param email [String] 平台新地址（<id>@shadowmail.win）
+      # @param token [String] 建箱下发的凭据串
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        account, password, session = parse_token(token)
+        addr = email.to_s.strip
+
+        do_fetch = lambda do
+          do_post("/api/get-emails", { "address" => addr }, "sessionId=#{session}")
+        end
+
+        data, status, = do_fetch.call
+        # sessionId 最长 1 小时（Max-Age 3600），过期后重登录重试一次
+        if status == 401 || status == 404
+          new_session = register_login(account, password, true)
+          unless new_session.empty?
+            session = new_session
+            data, status, = do_fetch.call
+          end
+        end
+        raise "shadowmail get-emails: http #{status}" if status < 200 || status >= 300
+
+        msg = data.is_a?(Hash) ? data["message"].to_s : ""
+        raise "shadowmail get-emails: #{msg}" unless msg == "Emails read"
+
+        mails = data.is_a?(Hash) ? data["mails"] : nil
+        return [] unless mails.is_a?(Array)
+
+        mails.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          flat = m.dup
+          flat["from"] = m["sender"]
+          flat["to"] = addr
+          flat["date"] = m["created_at"]
+          # 平台无 text/html 区分，body 为正文（默认按纯文本处理，普通化可按需互转）
+          flat["text"] = m["body"]
+          Normalize.normalize_email(flat, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/shitpost_email.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # shitpost.email 渠道实现（公共实例，克隆自 shamu4life/throwaway-email）
+    #
+    # 无认证 REST：
+    #   POST /api/create 建箱（username/domain/ttl → email/token/type/expires）
+    #   GET /api/inbox?email=&token= 读信（messages[] 含 from/fromName/subject/text/html/date）
+    # 域名池：shitpost.email / letsfuckingpiss.party
+    module ShitpostEmail
+      CHANNEL = "shitpost-email"
+      BASE_URL = "https://shitpost.email"
+      DOMAINS = %w[shitpost.email letsfuckingpiss.party].freeze
+
+      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
+
+      module_function
+
+      # 生成 "sdk"+10 位 [a-z0-9] 随机用户名
+      CHARS = ("a".."z").to_a + ("0".."9").to_a
+      def random_username
+        "sdk" + Array.new(10) { CHARS.sample }.join
+      end
+
+      # 创建临时邮箱
+      # POST /api/create，body 为 {username, domain, ttl}
+      # @return [EmailInfo]
+      def generate_email
+        body = { "username" => random_username, "domain" => DOMAINS.sample, "ttl" => 3600 }
+        resp = Http.post("#{BASE_URL}/api/create",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: body, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        email = data.is_a?(Hash) ? data["email"].to_s.strip : ""
+        token = data.is_a?(Hash) ? data["token"].to_s.strip : ""
+        raise "shitpost-email: 建箱响应缺少 email 或 token" if email.empty? || token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token,
+                      expires_at: data["expires"])
+      end
+
+      # 读取收件箱
+      # GET /api/inbox?email=&token=
+      # @param email [String] 邮箱地址
+      # @param token [String] 建箱返回的令牌
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        tk = token.to_s
+        raise "shitpost-email: token 为空" if tk.strip.empty?
+
+        url = "#{BASE_URL}/api/inbox?email=#{URI.encode_www_form_component(addr)}" \
+              "&token=#{URI.encode_www_form_component(tk)}"
+        resp = Http.get(url, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        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 = {
+            "id" => m["id"],
+            "from" => m["from"],
+            "to" => addr,
+            "subject" => m["subject"],
+            "text" => m["text"],
+            "html" => m["html"],
+            "date" => m["date"]
+          }
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/smail_pw.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # smail.pw 渠道实现
+    #
+    # 流程：POST /_root.data body: intent=generate 创建邮箱，保存 __session cookie
+    #       GET /_root.data + Cookie 获取邮件列表（解析 React Flight 格式或正则提取）
+    #       GET /api/email/{id} 获取单封邮件正文
+    # token 存储 __session=xxx cookie 字符串
+    module SmailPw
+      CHANNEL = "smail-pw"
+      ROOT_DATA_URL = "https://smail.pw/_root.data"
+
+      HEADERS = {
+        "Accept" => "*/*",
+        "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",
+        "origin" => "https://smail.pw",
+        "pragma" => "no-cache",
+        "referer" => "https://smail.pw/",
+        "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 Edg/146.0.0.0"
+      }.freeze
+
+      QUOTED_INBOX_RE = /"([a-z0-9][a-z0-9.\-]*@smail\.pw)"/i
+      PLAIN_INBOX_RE  = /\b([a-z0-9][a-z0-9.\-]*@smail\.pw)\b/i
+      MAIL_BLOCK_RE   = /"id","([^"]+)","to_address","([^"]*)","from_name","([^"]*)","from_address","([^"]*)","subject","([^"]*)","time",(\d+)/
+      MAIL_BLOCK2_RE  = /"id","([^"]+)","from_name","([^"]*)","from_address","([^"]*)","subject","([^"]*)","time",(\d+)/
+
+      module_function
+
+      # 从响应 Set-Cookie 中提取 __session cookie
+      # @param set_cookie_lines [Array<String>]
+      # @return [String]
+      def extract_session(set_cookie_lines)
+        set_cookie_lines.each do |line|
+          pair = line.split(";", 2).first.to_s.strip
+          return pair if pair.start_with?("__session=")
+        end
+        ""
+      end
+
+      # 从响应体中提取邮箱地址
+      # @param body [String]
+      # @return [String]
+      def extract_inbox(body)
+        m = body.match(QUOTED_INBOX_RE)
+        return m[1] if m
+
+        m = body.match(PLAIN_INBOX_RE)
+        m ? m[1] : ""
+      end
+
+      # 从响应体解析邮件列表
+      # @param body [String]
+      # @param recipient [String]
+      # @return [Array<Hash>]
+      def parse_mails(body, recipient)
+        out = []
+        body.scan(MAIL_BLOCK_RE) do |id, to_addr, from_name, from_addr, subj, ts|
+          out << {
+            "id" => id, "to_address" => to_addr.empty? ? recipient : to_addr,
+            "from_name" => from_name, "from_address" => from_addr,
+            "subject" => subj, "date" => ts.to_f,
+            "text" => "", "html" => "", "attachments" => []
+          }
+        end
+        return out unless out.empty?
+
+        body.scan(MAIL_BLOCK2_RE) do |id, from_name, from_addr, subj, ts|
+          out << {
+            "id" => id, "to_address" => recipient,
+            "from_name" => from_name, "from_address" => from_addr,
+            "subject" => subj, "date" => ts.to_f,
+            "text" => "", "html" => "", "attachments" => []
+          }
+        end
+        out
+      end
+
+      # 创建 smail.pw 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post(
+          ROOT_DATA_URL,
+          headers: HEADERS.merge("Content-Type" => "application/x-www-form-urlencoded;charset=UTF-8"),
+          body: "intent=generate",
+          timeout: 15
+        )
+        raise "smail.pw generate failed: #{resp.status_code}" unless resp.ok?
+
+        cookie = extract_session(resp.set_cookies)
+        raise "smail.pw: 未能提取 __session cookie" if cookie.empty?
+
+        email = extract_inbox(resp.body)
+        raise "smail.pw: 未能解析邮箱地址" if email.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: cookie)
+      end
+
+      # 获取 smail.pw 邮件列表
+      # @param token [String] __session=xxx cookie 字符串
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        resp = Http.get(
+          ROOT_DATA_URL,
+          headers: HEADERS.merge("Cookie" => token),
+          timeout: 15
+        )
+        raise "smail.pw get emails failed: #{resp.status_code}" unless resp.ok?
+
+        mails = parse_mails(resp.body, email)
+        return [] if mails.empty?
+
+        mails.map do |m|
+          ne = Normalize.normalize_email(m, email)
+          id = m["id"].to_s
+          unless id.empty?
+            body_html = fetch_body(token, id)
+            ne.html = body_html unless body_html.empty?
+          end
+          ne
+        end
+      end
+
+      # 获取单封邮件正文
+      # @param token [String]
+      # @param id [String]
+      # @return [String]
+      def fetch_body(token, id)
+        return "" if id.empty?
+
+        resp = Http.get(
+          "https://smail.pw/api/email/#{URI.encode_uri_component(id)}",
+          headers: HEADERS.merge("Cookie" => token, "Accept" => "application/json"),
+          timeout: 15
+        )
+        return "" unless resp.ok?
+
+        data = resp.json
+        data.is_a?(Hash) ? data["body"].to_s : ""
+      rescue StandardError
+        ""
+      end
+    end
+  end
+end