tempmail_sdk 1.3.3 → 1.3.5

data/lib/tempmail_sdk/providers/twentyfourmail_chacuo.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # 24mail.chacuo.net 渠道实现
+    # POST / 同一接口用于注册和收信，HTTP only
+    module TwentyfourmailChacuo
+      CHANNEL = "24mail-chacuo"
+      BASE_URL = "http://24mail.chacuo.net"
+      DOMAINS = %w[chacuo.net 027168.com].freeze
+
+      HEADERS = {
+        "Accept" => "application/json, text/javascript, */*; q=0.01",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
+        "Content-Type" => "application/x-www-form-urlencoded; charset=UTF-8",
+        "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",
+        "x-requested-with" => "XMLHttpRequest"
+      }.freeze
+
+      module_function
+
+      def random_local(length = 10)
+        chars = ("a".."z").to_a + ("0".."9").to_a
+        Array.new(length) { chars.sample }.join
+      end
+
+      # 创建 24mail-chacuo 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        name = random_local(10)
+        domain = DOMAINS.sample
+        body = "data=#{URI.encode_www_form_component("#{name}@#{domain}")}&type=refresh&arg="
+        resp = Http.post(BASE_URL + "/", headers: HEADERS, body: body, timeout: 15)
+        resp.raise_for_status
+        data = JSON.parse(resp.body)
+        raise "24mail-chacuo: 创建失败 status=#{data["status"]} info=#{data["info"]}" unless data["status"] == 1
+
+        email = "#{name}@#{domain}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 获取 24mail-chacuo 邮件列表
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(email)
+        addr = email.to_s.strip
+        raise "24mail-chacuo: 邮箱地址为空" if addr.empty?
+
+        at_idx = addr.index("@")
+        name = at_idx ? addr[0...at_idx] : addr
+        domain = at_idx ? addr[at_idx + 1..] : DOMAINS[0]
+
+        body = "data=#{URI.encode_www_form_component("#{name}@#{domain}")}&type=refresh&arg="
+        resp = Http.post(BASE_URL + "/", headers: HEADERS, body: body, timeout: 15)
+        resp.raise_for_status
+        data = JSON.parse(resp.body)
+        return [] unless data["status"] == 1 && data["data"].is_a?(Array) && !data["data"].empty?
+
+        list = data["data"][0]["list"]
+        return [] unless list.is_a?(Array)
+
+        list.map do |item|
+          flat = {
+            "id" => item["MID"],
+            "from" => item["FROM"],
+            "to" => addr,
+            "subject" => item["SUBJECT"],
+            "body" => item["CONTENT"],
+            "date" => item["TIME"],
+            "isRead" => false
+          }
+          Normalize.normalize_email(flat, addr)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/vip_215.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+require "cgi"
+
+module TempmailSdk
+  module Providers
+    # vip.215.im 渠道实现
+    # 流程：GET / 取首页 cookie → POST /api/temp-inbox 创建邮箱（得到 address + token）
+    #       GET /v1/messages 拉取邮件列表（HTTP 优先）
+    #       GET /v1/messages/{id} 补拉单封详情
+    # token 为 JWT，用于后续 API 鉴权
+    module Vip215
+      CHANNEL = "vip-215"
+      BASE = "https://vip.215.im"
+      UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+           "(KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36 Edg/148.0.0.0"
+
+      HOME_HEADERS = {
+        "User-Agent" => 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,en-GB;q=0.7,en-US;q=0.6",
+        "Cache-Control" => "no-cache",
+        "DNT" => "1",
+        "Pragma" => "no-cache",
+        "Sec-Fetch-Dest" => "document",
+        "Sec-Fetch-Mode" => "navigate",
+        "Sec-Fetch-Site" => "same-origin",
+        "Upgrade-Insecure-Requests" => "1"
+      }.freeze
+
+      API_HEADERS = {
+        "User-Agent" => UA,
+        "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",
+        "Content-Type" => "application/json",
+        "DNT" => "1",
+        "Origin" => BASE,
+        "Pragma" => "no-cache",
+        "Referer" => "#{BASE}/",
+        "Sec-Fetch-Dest" => "empty",
+        "Sec-Fetch-Mode" => "cors",
+        "Sec-Fetch-Site" => "same-origin",
+        "X-Locale" => "zh"
+      }.freeze
+
+      module_function
+
+      # 合并 Set-Cookie 响应头到 cookie 字符串
+      def merge_cookies(existing, set_cookie_lines)
+        map = {}
+        existing.to_s.split(";").each do |part|
+          part = part.strip
+          next unless part.include?("=")
+
+          k, v = part.split("=", 2)
+          map[k.strip] = v.to_s.strip unless k.strip.empty?
+        end
+        set_cookie_lines.each do |line|
+          pair = line.split(";", 2).first.to_s.strip
+          next unless pair.include?("=")
+
+          k, v = pair.split("=", 2)
+          map[k.strip] = v.to_s.strip unless k.strip.empty?
+        end
+        map.map { |k, v| "#{k}=#{v}" }.join("; ")
+      end
+
+      # 访问首页获取必要 cookie（yyds_homepage_bridge / yyds_homepage_device）
+      def establish_session
+        resp = Http.get(BASE + "/", headers: HOME_HEADERS, timeout: 15)
+        resp.raise_for_status
+        cookie = merge_cookies("", resp.set_cookies)
+        raise "vip-215: 缺少首页 cookie" unless cookie.include?("yyds_homepage_bridge=") &&
+                                                  cookie.include?("yyds_homepage_device=")
+
+        cookie
+      end
+
+      # 创建 vip-215 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        cookie = establish_session
+        resp = Http.post(
+          BASE + "/api/temp-inbox",
+          headers: API_HEADERS.merge("Cookie" => cookie),
+          body: "",
+          timeout: 15
+        )
+        resp.raise_for_status
+        data = JSON.parse(resp.body)
+        raise "vip-215: 创建失败" unless data["success"] && data["data"]
+
+        address = data["data"]["address"].to_s.strip
+        token = data["data"]["token"].to_s.strip
+        raise "vip-215: 响应缺少 address 或 token" if address.empty? || token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: address, token: token)
+      end
+
+      # 判断邮件条目是否已含真实正文
+      def has_real_body?(row)
+        %w[text body_text html body_html content body].any? do |key|
+          v = row[key]
+          v.is_a?(String) && !v.strip.empty?
+        end
+      end
+
+      # 提取邮件 ID
+      def extract_message_id(row)
+        %w[id messageId message_id].each do |key|
+          v = row[key]
+          next if v.nil?
+          return v.to_s.strip if v.is_a?(String) && !v.strip.empty?
+          return v.to_i.to_s if v.is_a?(Numeric)
+        end
+        ""
+      end
+
+      # 补拉单封邮件详情
+      def fetch_message_detail(token, id)
+        mid = id.to_s.strip
+        return nil if mid.empty?
+
+        resp = Http.get(
+          "#{BASE}/v1/messages/#{URI.encode_www_form_component(mid)}",
+          headers: API_HEADERS.merge("Authorization" => "Bearer #{token}"),
+          timeout: 15
+        )
+        return nil unless resp.status_code == 200
+
+        parsed = JSON.parse(resp.body)
+        return nil unless parsed["success"] && parsed["data"].is_a?(Hash)
+
+        parsed["data"]
+      rescue StandardError
+        nil
+      end
+
+      # 获取 vip-215 邮件列表（HTTP GET /v1/messages）
+      # @param token [String] JWT
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        raise "vip-215: token 为空" if token.to_s.strip.empty?
+
+        resp = Http.get(
+          BASE + "/v1/messages",
+          headers: API_HEADERS.merge("Authorization" => "Bearer #{token}"),
+          timeout: 15
+        )
+        resp.raise_for_status
+        parsed = JSON.parse(resp.body)
+        raise "vip-215: messages success=false" unless parsed["success"]
+
+        messages = parsed.dig("data", "messages") || []
+        messages.map do |row|
+          id = extract_message_id(row)
+          unless has_real_body?(row) || id.empty?
+            detail = fetch_message_detail(token, id)
+            row = row.merge(detail) if detail
+          end
+          row["to"] ||= email
+          Normalize.normalize_email(row, email)
+        end
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/zerodrop.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Zerodrop 渠道实现（zerodrop.dev）
+    #
+    # 无认证 REST：建箱无需请求，本地生成 "sdk"+8 位随机名，地址为 <名>@zerodrop-sandbox.online；
+    # 读信 GET /api/inbox/{name}?source=sdk，响应形如 {"emails":[...],"count":N}。
+    # 平台邮件对象只有 id/from/to/subject/receivedAt/raw/otp/magicLink，正文仅存在于
+    # raw（完整 MIME 原文），需剥离头部提取纯文本 body。
+    module Zerodrop
+      CHANNEL = "zerodrop"
+      BASE_URL = "https://zerodrop.dev"
+      DOMAIN = "zerodrop-sandbox.online"
+
+      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"+8 位 [a-z0-9] 随机本地名
+      CHARS = ("a".."z").to_a + ("0".."9").to_a
+      def random_name
+        "sdk" + Array.new(8) { CHARS.sample }.join
+      end
+
+      # 从 raw（完整 MIME 原文）提取纯文本正文：
+      # 定位首个空行（RFC 5322 头部/正文分隔，\r\n\r\n 或 \n\n），其后部分即 body
+      # @param raw [String] MIME 原文
+      # @return [String]
+      def raw_body(raw)
+        idx = raw.index("\r\n\r\n")
+        return raw[(idx + 4)..] if idx
+
+        idx = raw.index("\n\n")
+        return raw[(idx + 2)..] if idx
+
+        ""
+      end
+
+      # 创建临时邮箱
+      # 建箱无需请求，本地生成随机名，token 复用完整地址以便收件箱回查
+      # @return [EmailInfo]
+      def generate_email
+        email = "#{random_name}@#{DOMAIN}"
+        EmailInfo.new(channel: CHANNEL, email: email, token: email)
+      end
+
+      # 读取收件箱
+      # GET /api/inbox/{name}?source=sdk
+      # @param email [String] 邮箱地址
+      # @param _token [String] 令牌（本渠道忽略，以邮箱为准）
+      # @return [Array<Email>]
+      def get_emails(email, _token)
+        addr = email.to_s.strip
+        parts = addr.split("@", 2)
+        raise "zerodrop: 非 #{DOMAIN} 域邮箱地址" unless parts.size == 2 && parts[1] == DOMAIN
+
+        url = "#{BASE_URL}/api/inbox/#{URI.encode_www_form_component(parts[0])}?source=sdk"
+        resp = Http.get(url, 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["from"],
+            "to" => addr,
+            "subject" => m["subject"],
+            "date" => m["receivedAt"] || m["date"]
+          }
+          # 正文仅存在于 raw（完整 MIME 原文）：提取纯文本 body 作 text
+          raw = m["raw"].to_s
+          body = raw_body(raw)
+          row["text"] = body unless body.empty?
+          Normalize.normalize_email(row, addr)
+        end
+      end
+    end
+  end
+end