tempmail_sdk 1.3.4 → 1.3.5

data/lib/tempmail_sdk/providers/tmpkit.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # Tmpkit 渠道实现（tmpkit.com，Next.js tRPC 前端 + Go-Guerrilla SMTP 后端）
+    #
+    # 流程：
+    #   POST /api/rpc/tempmail/initSession（body 为 tRPC 包裹 {"json":{}}）建箱，
+    #     响应 session.sessionId 与 session.email（sessionId 同值 Set-Cookie）
+    #   POST /api/rpc/tempmail/getEmails（{"json":{"offset":0,"limit":20}} +
+    #     Cookie tempmail_session=<sessionId>）列信（列表键 mailId，无 id）
+    #   POST /api/rpc/tempmail/getEmailDetail（{"json":{"mailId":<数字>}}）取正文
+    # 会话粘性：token 保存 sessionId（tempMailSession=<sid>），读信显式携带
+    #   Cookie 请求头，防并行会话串箱。
+    module Tmpkit
+      CHANNEL = "tmpkit"
+      BASE_URL = "https://tmpkit.com"
+      RPC_PREFIX = "#{BASE_URL}/api/rpc/tempmail"
+
+      USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 " \
+                   "(KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36"
+
+      module_function
+
+      # tRPC 调用请求头（Content-Type JSON、Accept 通配、同站 Origin/Referer）
+      # @param cookie [String] sessionId，非空时携带 tempmail_session Cookie
+      # @return [Hash]
+      def rpc_headers(cookie = "")
+        hdrs = {
+          "User-Agent" => USER_AGENT,
+          "Accept" => "*/*",
+          "Content-Type" => "application/json",
+          "Origin" => BASE_URL,
+          "Referer" => "#{BASE_URL}/en"
+        }
+        hdrs["Cookie"] = "tempmail_session=#{cookie}" unless cookie.empty?
+        hdrs
+      end
+
+      # 对 tmpkit 发起 rpc 调用（tRPC 包裹 {"json":<reqBody>}）
+      # 响应外层 {"json":{...}} 解析为 Hash 返回。
+      # @param procedure [String] rpc 过程名
+      # @param req_body [Hash] 过程参数
+      # @param cookie [String] sessionId
+      # @return [Hash]
+      def rpc(procedure, req_body, cookie = "")
+        resp = Http.post("#{RPC_PREFIX}/#{procedure}",
+                         headers: rpc_headers(cookie),
+                         body: JSON.generate({ json: req_body }),
+                         timeout: 15)
+        resp.raise_for_status
+        outer = resp.json
+        payload = outer.is_a?(Hash) ? outer["json"] : nil
+        raise "tmpkit: #{procedure} 响应缺 json 载荷" unless payload.is_a?(Hash)
+
+        payload
+      end
+
+      # 创建 tmpkit.com 临时邮箱
+      # 调 initSession（tRPC 包裹 {"json":{}}），sessionId 与邮箱地址同返。
+      # @return [EmailInfo]
+      def generate_email
+        data = rpc("initSession", {})
+        sess = data["session"]
+        raise "tmpkit: 创建会话响应缺 session 字段" unless sess.is_a?(Hash)
+
+        email = sess["email"].to_s.strip
+        session_id = sess["sessionId"].to_s.strip
+        raise "tmpkit: 创建会话响应缺少必要字段（email/sessionId）" if email.empty? || session_id.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email,
+                      token: "tempMailSession=#{session_id}")
+      end
+
+      # 获取 tmpkit.com 邮件列表
+      # getEmails（offset 0 / limit 20）取摘要，逐封 getEmailDetail 拉详情并
+      # 将详情键并入摘要；详情失败回退列表摘要。getEmails 返回的 session.email
+      # 与收信邮箱不符时报错，防止会话被覆盖。
+      # @param email [String] 邮箱地址
+      # @param token [String] 会话凭据串（tempMailSession=<sessionId>）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        raw = token.to_s.strip
+        mailbox = raw.start_with?("tempMailSession=") ? raw.delete_prefix("tempMailSession=") : raw
+        raise "tmpkit: 会话 token 为空" if mailbox.empty?
+
+        data = rpc("getEmails", { offset: 0, limit: 20 }, mailbox)
+
+        # 会话指向校验：getEmails 响应自带 session.email（无 Cookie 时
+        # session 为 null，同样视为会话失效）
+        sess = data["session"]
+        if sess.is_a?(Hash)
+          got = sess["email"].to_s.strip
+          raise "tmpkit: 会话邮箱不匹配（响应 #{got}，请求 #{email}）" if !got.empty? && got != email
+        else
+          raise "tmpkit: 会话已失效（getEmails 返回空会话）"
+        end
+
+        list = data["emails"]
+        raise "tmpkit: 邮件列表响应缺 emails 字段" unless list.is_a?(Array)
+
+        list.map do |item|
+          next unless item.is_a?(Hash)
+
+          m = item.dup
+          # mailId 为数字：合法时逐封拉详情（详情键并入摘要，跳过会话类键）
+          mail_id = m["mailId"]
+          if mail_id.is_a?(Numeric) && mail_id.positive?
+            begin
+              detail = rpc("getEmailDetail", { mailId: mail_id.to_i }, mailbox)
+              if detail.is_a?(Hash)
+                detail.each do |k, v|
+                  next if %w[session emails total error].include?(k)
+
+                  m[k] = v
+                end
+              end
+            rescue StandardError
+              # 详情失败回退列表摘要
+            end
+          end
+          Normalize.normalize_email(m, email)
+        end.compact
+      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

data/lib/tempmail_sdk/registry.rb

@@ -18,20 +18,20 @@ module TempmailSdk
       Mailforspam: "mailforspam", FakeLegal: "fake_legal", TenminuteOne: "tenminute_one",
       Zhujump: "zhujump", Anonymmail: "anonymmail", Byom: "byom", Cleantempmail: "cleantempmail",
       DevmailUk: "devmail_uk", DropmailClick: "dropmail_click", FakeEmailSite: "fake_email_site",
-      Fmail: "fmail", Freecustom: "freecustom", GoneboxEmail: "gonebox_email",
+      Fmail: "fmail", Freecustom: "freecustom",
       Harakirimail: "harakirimail", Inboxes: "inboxes", M2u: "m2u", Mail10s: "mail10s",
       Mail123: "mail123", Mffac: "mffac", Tempmailc: "tempmailc", NeighboursSh: "neighbours_sh",
       Temporam: "temporam", Neighbours: "neighbours", TempyEmail: "tempy_email", Ockito: "ockito",
       Tempmail365: "tempmail365", Tempinbox: "tempinbox", MailSunls: "mail_sunls",
       Smailpro: "smailpro", MailholeDe: "mailhole_de", Nimail: "nimail", Rootsh: "rootsh",
-      ShittyEmail: "shitty_email", TaEasy: "ta_easy", TempMailNow: "temp_mail_now",
+      ShittyEmail: "shitty_email", TaEasy: "ta_easy",
       TempMailOrg: "temp_mail_org", TempemailCo: "tempemail_co", TempemailInfo: "tempemail_info",
       TempemailsNet: "tempemails_net", Tempfastmail: "tempfastmail", Tempgmailer: "tempgmailer",
       TempgoEmail: "tempgo_email", TempmailFish: "tempmail_fish", TempmailFyi: "tempmail_fyi",
       TempmailLolV2: "tempmail_lol_v2", Tempmailpro: "tempmailpro", Tempmailten: "tempmailten",
       TempMails: "tempp_mails", TenMinuteMailNet: "ten_minute_mail_net",
       Throwawaymail: "throwawaymail", TmailLink: "tmail_link",
-      Uncorreotemporal: "uncorreotemporal", Webmailtemp: "webmailtemp", XkxMe: "xkx_me",
+      Uncorreotemporal: "uncorreotemporal", XkxMe: "xkx_me",
       Altmails: "altmails", Apihz: "apihz", Awamail: "awamail", BestTempMail: "best_temp_mail",
       ChatgptOrgUk: "chatgpt_org_uk", Disposablemail: "disposablemail",
       DisposablemailApp: "disposablemail_app", Email10min: "email10min",
@@ -41,11 +41,21 @@ module TempmailSdk
       TempmailCn: "tempmail_cn", Linshiyou: "linshiyou", Mailnesia: "mailnesia",
       Dropmail: "dropmail", SmailPw: "smail_pw", Vip215: "vip_215",
       Tempgbox: "tempgbox", Anonbox: "anonbox", Eyepaste: "eyepaste",
-      Lroid: "lroid", Haribu: "haribu", Mohmal: "mohmal", Mailgolem: "mailgolem",
+      Lroid: "lroid", Haribu: "haribu", Mailgolem: "mailgolem",
       MytempmailCc: "mytempmail_cc", MailtempCc: "mailtemp_cc", Minuteinbox: "minuteinbox",
       Mailcatch: "mailcatch", MaildropCc: "maildrop_cc", TenminutemailNet: "tenminutemail_net",
       Openinbox: "openinbox", MailcatAi: "mailcat_ai", DropmailMe: "dropmail_me",
-      TwentyfourmailChacuo: "twentyfourmail_chacuo"
+      TwentyfourmailChacuo: "twentyfourmail_chacuo",
+      TempmailsIo: "tempmails_io", ShitpostEmail: "shitpost_email", Smails: "smails",
+      Tempmailportal: "tempmailportal", Huskmail: "huskmail", Zerodrop: "zerodrop",
+      Firetempmail: "firetempmail", Nullmail: "nullmail", TenminApp: "tenmin_app",
+      Mtempmail: "mtempmail", TempmailEe: "tempmail_ee", Mailticking: "mailticking",
+      TemporarymailCom: "temporarymail_com", ThirtyMinEmail: "thirty_min_email",
+      LinshiXyz: "linshi_xyz", Crazymailing: "crazymailing", NoxenDe5Net: "noxen_de5_net",
+      Nukemail: "nukemail", Shadowmail: "shadowmail", Flybymail: "flybymail",
+      Nowtempmail: "nowtempmail", Clawdemail: "clawdemail", Tempmail100: "tempmail100",
+      Tempmailto: "tempmailto", TempMailGg: "temp_mail_gg",
+      Tmpkit: "tmpkit", Internxt: "internxt", GeneratorEmail: "generator_email"
     }.freeze
 
     PROVIDER_AUTOLOADS.each do |mod_name, file|
@@ -463,10 +473,6 @@ module TempmailSdk
           get_emails: ->(e, t) { p::Getnada.get_emails(require_token(t, "getnada"), e) }
         },
         # mailmomy 家族：mailmomy 主渠道从域名池随机选域，其余为固定域名变体（同后端 API）
-        "16888888-cyou" => {
-          generate: ->(_o) { with_channel(p::Mailmomy.generate_email("16888888.cyou"), "16888888-cyou") },
-          get_emails: ->(e, _t) { p::Mailmomy.get_emails(e) }
-        },
         "17666688-shop" => {
           generate: ->(_o) { with_channel(p::Mailmomy.generate_email("17666688.shop"), "17666688-shop") },
           get_emails: ->(e, _t) { p::Mailmomy.get_emails(e) }
@@ -487,10 +493,6 @@ module TempmailSdk
           generate: ->(_o) { with_channel(p::Mailmomy.generate_email("easyme.pro"), "easyme-pro") },
           get_emails: ->(e, _t) { p::Mailmomy.get_emails(e) }
         },
-        "evergreenco-shop" => {
-          generate: ->(_o) { with_channel(p::Mailmomy.generate_email("evergreenco.shop"), "evergreenco-shop") },
-          get_emails: ->(e, _t) { p::Mailmomy.get_emails(e) }
-        },
         "layueming-pics" => {
           generate: ->(_o) { with_channel(p::Mailmomy.generate_email("layueming.pics"), "layueming-pics") },
           get_emails: ->(e, _t) { p::Mailmomy.get_emails(e) }
@@ -914,10 +916,6 @@ module TempmailSdk
           generate: ->(_o) { p::Freecustom.generate_email },
           get_emails: ->(e, t) { p::Freecustom.get_emails(t.to_s.empty? ? e : t) }
         },
-        "gonebox-email" => {
-          generate: ->(_o) { p::GoneboxEmail.generate_email },
-          get_emails: ->(e, t) { p::GoneboxEmail.get_emails(t.to_s, e) }
-        },
         "harakirimail" => {
           generate: ->(_o) { p::Harakirimail.generate_email },
           get_emails: ->(e, _t) { p::Harakirimail.get_emails(e) }
@@ -1004,10 +1002,6 @@ module TempmailSdk
           generate: ->(_o) { p::TaEasy.generate_email },
           get_emails: ->(e, t) { p::TaEasy.get_emails(e, require_token(t, "ta-easy")) }
         },
-        "temp-mail-now" => {
-          generate: ->(_o) { p::TempMailNow.generate_email },
-          get_emails: ->(e, t) { p::TempMailNow.get_emails(require_token(t, "temp-mail-now"), e) }
-        },
         "temp-mail-org" => {
           generate: ->(_o) { p::TempMailOrg.generate_email },
           get_emails: ->(e, t) { p::TempMailOrg.get_emails(require_token(t, "temp-mail-org"), e) }
@@ -1076,10 +1070,6 @@ module TempmailSdk
           generate: ->(_o) { p::Uncorreotemporal.generate_email },
           get_emails: ->(e, t) { p::Uncorreotemporal.get_emails(require_token(t, "uncorreotemporal"), e) }
         },
-        "webmailtemp" => {
-          generate: ->(_o) { p::Webmailtemp.generate_email },
-          get_emails: ->(e, t) { p::Webmailtemp.get_emails(require_token(t, "webmailtemp"), e) }
-        },
         "xkx-me" => {
           generate: ->(_o) { p::XkxMe.generate_email },
           get_emails: ->(e, t) { p::XkxMe.get_emails(require_token(t, "xkx-me"), e) }
@@ -1132,10 +1122,6 @@ module TempmailSdk
           generate: ->(_o) { p::Haribu.generate_email },
           get_emails: ->(e, t) { p::Haribu.get_emails(require_token(t, "haribu"), e) }
         },
-        "mohmal" => {
-          generate: ->(_o) { p::Mohmal.generate_email },
-          get_emails: ->(e, t) { p::Mohmal.get_emails(e, require_token(t, "mohmal")) }
-        },
         "mailgolem" => {
           generate: ->(_o) { p::Mailgolem.generate_email },
           get_emails: ->(e, t) { p::Mailgolem.get_emails(e, require_token(t, "mailgolem")) }
@@ -1232,6 +1218,120 @@ module TempmailSdk
           generate: ->(_o) { p::Email10min.generate_email },
           get_emails: ->(e, t) { p::Email10min.get_emails(e, require_token(t, "email10min")) }
         },
+        # 渠道追加批次：与 baseline 尾部 11 个新增渠道一一对应（顺序固定）
+        "tempmails-io" => {
+          generate: ->(_o) { p::TempmailsIo.generate_email },
+          get_emails: ->(e, t) { p::TempmailsIo.get_emails(e, require_token(t, "tempmails-io")) }
+        },
+        "shitpost-email" => {
+          generate: ->(_o) { p::ShitpostEmail.generate_email },
+          get_emails: ->(e, t) { p::ShitpostEmail.get_emails(e, require_token(t, "shitpost-email")) }
+        },
+        "smails" => {
+          generate: ->(_o) { p::Smails.generate_email },
+          get_emails: ->(e, t) { p::Smails.get_emails(require_token(t, "smails"), e) }
+        },
+        "tempmailportal" => {
+          generate: ->(_o) { p::Tempmailportal.generate_email },
+          get_emails: ->(e, t) { p::Tempmailportal.get_emails(require_token(t, "tempmailportal"), e) }
+        },
+        "huskmail" => {
+          generate: ->(_o) { p::Huskmail.generate_email },
+          get_emails: ->(e, t) { p::Huskmail.get_emails(require_token(t, "huskmail"), e) }
+        },
+        "zerodrop" => {
+          generate: ->(_o) { p::Zerodrop.generate_email },
+          get_emails: ->(e, t) { p::Zerodrop.get_emails(e, t) }
+        },
+        "firetempmail" => {
+          generate: ->(_o) { p::Firetempmail.generate_email },
+          get_emails: ->(e, t) { p::Firetempmail.get_emails(e, t) }
+        },
+        "nullmail" => {
+          generate: ->(_o) { p::Nullmail.generate_email },
+          get_emails: ->(e, t) { p::Nullmail.get_emails(e, t) }
+        },
+        "tenmin-app" => {
+          generate: ->(_o) { p::TenminApp.generate_email },
+          get_emails: ->(e, t) { p::TenminApp.get_emails(e, require_token(t, "tenmin-app")) }
+        },
+        "mtempmail" => {
+          generate: ->(_o) { p::Mtempmail.generate_email },
+          get_emails: ->(e, t) { p::Mtempmail.get_emails(e, t) }
+        },
+        "tempmail-ee" => {
+          generate: ->(_o) { p::TempmailEe.generate_email },
+          get_emails: ->(e, t) { p::TempmailEe.get_emails(e, require_token(t, "tempmail-ee")) }
+        },
+        "mailticking" => {
+          generate: ->(_o) { p::Mailticking.generate_email },
+          get_emails: ->(e, t) { p::Mailticking.get_emails(e, require_token(t, "mailticking")) }
+        },
+        # 渠道追加批次：与 baseline 尾部 11 个新增渠道一一对应（顺序固定）
+        "temporarymail-com" => {
+          generate: ->(_o) { p::TemporarymailCom.generate_email },
+          get_emails: ->(e, t) { p::TemporarymailCom.get_emails(e, require_token(t, "temporarymail-com")) }
+        },
+        "30minemail" => {
+          generate: ->(_o) { p::ThirtyMinEmail.generate_email },
+          get_emails: ->(e, t) { p::ThirtyMinEmail.get_emails(e, require_token(t, "30minemail")) }
+        },
+        "linshi-xyz" => {
+          generate: ->(_o) { p::LinshiXyz.generate_email },
+          get_emails: ->(e, t) { p::LinshiXyz.get_emails(e, require_token(t, "linshi-xyz")) }
+        },
+        "crazymailing" => {
+          generate: ->(_o) { p::Crazymailing.generate_email },
+          get_emails: ->(e, t) { p::Crazymailing.get_emails(e, require_token(t, "crazymailing")) }
+        },
+        "noxen-de5-net" => {
+          generate: ->(o) { p::NoxenDe5Net.generate_email(o.domain) },
+          get_emails: ->(e, t) { p::NoxenDe5Net.get_emails(e, require_token(t, "noxen-de5-net")) }
+        },
+        "nukemail" => {
+          generate: ->(_o) { p::Nukemail.generate_email },
+          get_emails: ->(e, t) { p::Nukemail.get_emails(e, require_token(t, "nukemail")) }
+        },
+        "shadowmail" => {
+          generate: ->(_o) { p::Shadowmail.generate_email },
+          get_emails: ->(e, t) { p::Shadowmail.get_emails(e, require_token(t, "shadowmail")) }
+        },
+        "flybymail" => {
+          generate: ->(_o) { p::Flybymail.generate_email },
+          get_emails: ->(e, t) { p::Flybymail.get_emails(e, require_token(t, "flybymail")) }
+        },
+        "nowtempmail" => {
+          generate: ->(_o) { p::Nowtempmail.generate_email },
+          get_emails: ->(e, t) { p::Nowtempmail.get_emails(e, require_token(t, "nowtempmail")) }
+        },
+        "clawdemail" => {
+          generate: ->(_o) { p::Clawdemail.generate_email },
+          get_emails: ->(e, t) { p::Clawdemail.get_emails(e, require_token(t, "clawdemail")) }
+        },
+        "tempmail100" => {
+          generate: ->(_o) { p::Tempmail100.generate_email },
+          get_emails: ->(e, t) { p::Tempmail100.get_emails(e, require_token(t, "tempmail100")) }
+        },
+        "tempmailto" => {
+          generate: ->(_o) { p::Tempmailto.generate_email },
+          get_emails: ->(e, t) { p::Tempmailto.get_emails(e, require_token(t, "tempmailto")) }
+        },
+        "temp-mail-gg" => {
+          generate: ->(_o) { p::TempMailGg.generate_email },
+          get_emails: ->(e, t) { p::TempMailGg.get_emails(e, require_token(t, "temp-mail-gg")) }
+        },
+        "tmpkit" => {
+          generate: ->(_o) { p::Tmpkit.generate_email },
+          get_emails: ->(e, t) { p::Tmpkit.get_emails(e, require_token(t, "tmpkit")) }
+        },
+        "internxt" => {
+          generate: ->(_o) { p::Internxt.generate_email },
+          get_emails: ->(e, t) { p::Internxt.get_emails(e, require_token(t, "internxt")) }
+        },
+        "generator-email" => {
+          generate: ->(_o) { p::GeneratorEmail.generate_email },
+          get_emails: ->(e, t) { p::GeneratorEmail.get_emails(e, require_token(t, "generator-email")) }
+        },
       }
     end
 

data/lib/tempmail_sdk/types.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "time"
+
 module TempmailSdk
   # 创建临时邮箱后返回的邮箱信息
   # Token 等认证信息由 SDK 内部维护，不对外暴露（token 通过私有读取器访问）
@@ -78,6 +80,17 @@ module TempmailSdk
     end
     # rubocop:enable Metrics/ParameterLists
 
+    # 发信地址的域名部分；无法从 from_addr 提取时返回空串
+    # @return [String]
+    def from_domain
+      addr = from_addr.to_s
+      if (m = addr.match(/<?([^@\s<>]+)@([^@\s<>]+)>?/))
+        return m[2]
+      end
+
+      ""
+    end
+
     def to_h
       {
         id: @id, from_addr: @from_addr, to: @to, subject: @subject,

data/lib/tempmail_sdk/version.rb

@@ -2,5 +2,5 @@
 
 module TempmailSdk
   # SDK 版本号
-  VERSION = "1.3.4"
+  VERSION = "1.3.5"
 end

data/lib/tempmail_sdk.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # 临时邮箱 SDK (Ruby)
-# 聚合 279 个第三方临时邮箱渠道，所有渠道返回统一标准化格式。
+# 聚合 296 个第三方临时邮箱渠道，所有渠道返回统一标准化格式。
 # 与 Go / npm / Rust / Python / C / PHP 各端共享相同的渠道标识与顺序。
 
 require_relative "tempmail_sdk/version"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tempmail_sdk
 version: !ruby/object:Gem::Version
-  version: 1.3.4
+  version: 1.3.5
 platform: ruby
 authors:
 - tempmail-sdk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-23 00:00:00.000000000 Z
+date: 2026-09-28 00:00:00.000000000 Z
 dependencies: []
 description: 五端（Go/npm/Rust/Python/C）之外的 Ruby 版临时邮箱 SDK，共享相同的渠道标识与顺序，提供统一的 Email 结构、渠道
   fallback、代理/超时/TLS/遥测配置。
@@ -36,7 +36,9 @@ files:
 - lib/tempmail_sdk/providers/byom.rb
 - lib/tempmail_sdk/providers/catchmail.rb
 - lib/tempmail_sdk/providers/chatgpt_org_uk.rb
+- lib/tempmail_sdk/providers/clawdemail.rb
 - lib/tempmail_sdk/providers/cleantempmail.rb
+- lib/tempmail_sdk/providers/crazymailing.rb
 - lib/tempmail_sdk/providers/devmail_uk.rb
 - lib/tempmail_sdk/providers/disposablemail.rb
 - lib/tempmail_sdk/providers/disposablemail_app.rb
@@ -52,16 +54,21 @@ files:
 - lib/tempmail_sdk/providers/fake_email_site.rb
 - lib/tempmail_sdk/providers/fake_legal.rb
 - lib/tempmail_sdk/providers/fakemail.rb
+- lib/tempmail_sdk/providers/firetempmail.rb
+- lib/tempmail_sdk/providers/flybymail.rb
 - lib/tempmail_sdk/providers/fmail.rb
 - lib/tempmail_sdk/providers/freecustom.rb
+- lib/tempmail_sdk/providers/generator_email.rb
 - lib/tempmail_sdk/providers/getnada.rb
-- lib/tempmail_sdk/providers/gonebox_email.rb
 - lib/tempmail_sdk/providers/guerrillamail.rb
 - lib/tempmail_sdk/providers/guerrillamail_mirrors.rb
 - lib/tempmail_sdk/providers/harakirimail.rb
 - lib/tempmail_sdk/providers/haribu.rb
+- lib/tempmail_sdk/providers/huskmail.rb
 - lib/tempmail_sdk/providers/inboxes.rb
 - lib/tempmail_sdk/providers/inboxkitten.rb
+- lib/tempmail_sdk/providers/internxt.rb
+- lib/tempmail_sdk/providers/linshi_xyz.rb
 - lib/tempmail_sdk/providers/linshiyou.rb
 - lib/tempmail_sdk/providers/linshiyouxiang_net.rb
 - lib/tempmail_sdk/providers/lroid.rb
@@ -83,26 +90,34 @@ files:
 - lib/tempmail_sdk/providers/mailmomy.rb
 - lib/tempmail_sdk/providers/mailnesia.rb
 - lib/tempmail_sdk/providers/mailtemp_cc.rb
+- lib/tempmail_sdk/providers/mailticking.rb
 - lib/tempmail_sdk/providers/mffac.rb
 - lib/tempmail_sdk/providers/minuteinbox.rb
 - lib/tempmail_sdk/providers/moakt.rb
-- lib/tempmail_sdk/providers/mohmal.rb
+- lib/tempmail_sdk/providers/mtempmail.rb
 - lib/tempmail_sdk/providers/mytempmail_cc.rb
 - lib/tempmail_sdk/providers/neighbours.rb
 - lib/tempmail_sdk/providers/neighbours_sh.rb
 - lib/tempmail_sdk/providers/nimail.rb
+- lib/tempmail_sdk/providers/nowtempmail.rb
+- lib/tempmail_sdk/providers/noxen_de5_net.rb
+- lib/tempmail_sdk/providers/nukemail.rb
+- lib/tempmail_sdk/providers/nullmail.rb
 - lib/tempmail_sdk/providers/ockito.rb
 - lib/tempmail_sdk/providers/one_sec_mail.rb
 - lib/tempmail_sdk/providers/openinbox.rb
 - lib/tempmail_sdk/providers/restmail_net.rb
 - lib/tempmail_sdk/providers/rootsh.rb
+- lib/tempmail_sdk/providers/shadowmail.rb
+- lib/tempmail_sdk/providers/shitpost_email.rb
 - lib/tempmail_sdk/providers/shitty_email.rb
 - lib/tempmail_sdk/providers/smail_pw.rb
 - lib/tempmail_sdk/providers/smailpro.rb
+- lib/tempmail_sdk/providers/smails.rb
 - lib/tempmail_sdk/providers/socketio_mail.rb
 - lib/tempmail_sdk/providers/ta_easy.rb
+- lib/tempmail_sdk/providers/temp_mail_gg.rb
 - lib/tempmail_sdk/providers/temp_mail_io.rb
-- lib/tempmail_sdk/providers/temp_mail_now.rb
 - lib/tempmail_sdk/providers/temp_mail_org.rb
 - lib/tempmail_sdk/providers/tempemail_co.rb
 - lib/tempmail_sdk/providers/tempemail_info.rb
@@ -113,29 +128,38 @@ files:
 - lib/tempmail_sdk/providers/tempgo_email.rb
 - lib/tempmail_sdk/providers/tempinbox.rb
 - lib/tempmail_sdk/providers/tempmail.rb
+- lib/tempmail_sdk/providers/tempmail100.rb
 - lib/tempmail_sdk/providers/tempmail365.rb
 - lib/tempmail_sdk/providers/tempmail_cn.rb
+- lib/tempmail_sdk/providers/tempmail_ee.rb
 - lib/tempmail_sdk/providers/tempmail_fish.rb
 - lib/tempmail_sdk/providers/tempmail_fyi.rb
 - lib/tempmail_sdk/providers/tempmail_lol.rb
 - lib/tempmail_sdk/providers/tempmail_lol_v2.rb
 - lib/tempmail_sdk/providers/tempmail_plus.rb
 - lib/tempmail_sdk/providers/tempmailc.rb
+- lib/tempmail_sdk/providers/tempmailportal.rb
 - lib/tempmail_sdk/providers/tempmailpro.rb
+- lib/tempmail_sdk/providers/tempmails_io.rb
 - lib/tempmail_sdk/providers/tempmailten.rb
+- lib/tempmail_sdk/providers/tempmailto.rb
 - lib/tempmail_sdk/providers/temporam.rb
+- lib/tempmail_sdk/providers/temporarymail_com.rb
 - lib/tempmail_sdk/providers/tempp_mails.rb
 - lib/tempmail_sdk/providers/tempy_email.rb
 - lib/tempmail_sdk/providers/ten_minute_mail_net.rb
+- lib/tempmail_sdk/providers/tenmin_app.rb
 - lib/tempmail_sdk/providers/tenminute_one.rb
 - lib/tempmail_sdk/providers/tenminutemail_net.rb
+- lib/tempmail_sdk/providers/thirty_min_email.rb
 - lib/tempmail_sdk/providers/throwawaymail.rb
 - lib/tempmail_sdk/providers/tmail_link.rb
+- lib/tempmail_sdk/providers/tmpkit.rb
 - lib/tempmail_sdk/providers/twentyfourmail_chacuo.rb
 - lib/tempmail_sdk/providers/uncorreotemporal.rb
 - lib/tempmail_sdk/providers/vip_215.rb
-- lib/tempmail_sdk/providers/webmailtemp.rb
 - lib/tempmail_sdk/providers/xkx_me.rb
+- lib/tempmail_sdk/providers/zerodrop.rb
 - lib/tempmail_sdk/providers/zhujump.rb
 - lib/tempmail_sdk/registry.rb
 - lib/tempmail_sdk/retry.rb
@@ -166,5 +190,5 @@ requirements: []
 rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
-summary: 临时邮箱 SDK，聚合 279 个第三方临时邮箱渠道，返回统一标准化格式
+summary: 临时邮箱 SDK，聚合 296 个第三方临时邮箱渠道，返回统一标准化格式
 test_files: []