tempmail_sdk 1.3.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4c42b7ddf14c615d07554a2d6aa7efb1954cadad4ecef1f052bb6af5fb22f2a8
+  data.tar.gz: 46ab91c0e8946782a83c60c020feeebf840e625be330839d62c69b1c8f1ab5bc
+SHA512:
+  metadata.gz: 175bf0d04d31f7db48739b559af1eba64bdc0c09b51bd18e90124fbf0f05727e4f2586157f714e6c76ee693d3b29725756c89f002fe9a484c4fc7bf969d26ba4
+  data.tar.gz: 4052cdcfa7f88faf5eff0461a40e427eea368a86ca976fdd7dc25de4900d638f1479401ae98240936ffa489af05cd17446fcec7e4354c9b8debd896c79f2de1c

data/README.md

@@ -0,0 +1,116 @@
+# tempmail-sdk-ruby
+
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+
+Ruby 语言临时邮箱 SDK，公开 **279** 个 `channel` 渠道标识，聚合 100+ 个第三方临时邮箱服务商，所有渠道返回**统一标准化格式**。渠道标识与顺序与 Go / npm / Rust / Python / C 等其余各端保持一致（十端同步）；随机生成邮箱时在本端独立打乱尝试顺序。
+
+## 安装
+
+需 Ruby 3.0+。
+
+```bash
+gem install tempmail_sdk
+```
+
+或在 `Gemfile` 中添加：
+
+```ruby
+gem "tempmail_sdk", "~> 1.0"
+```
+
+## 快速开始
+
+### 使用 Client（推荐）
+
+`TempEmailClient` 自动管理 `EmailInfo` 与内部 token，用户无需手动传递。
+
+```ruby
+require "tempmail_sdk"
+
+client = TempmailSdk::TempEmailClient.new
+
+# 创建临时邮箱（指定渠道，不指定则随机 fallback）
+info = client.generate(TempmailSdk::GenerateEmailOptions.new(channel: "tempmail"))
+puts "渠道: #{info.channel}"
+puts "邮箱: #{info.email}"
+
+# 获取邮件（Token 等由 SDK 内部自动维护）
+result = client.get_emails
+puts "收到 #{result.emails.size} 封邮件"
+
+result.emails.each do |email|
+  puts "发件人: #{email.from_addr}"
+  puts "主题: #{email.subject}"
+  puts "内容: #{email.text}"
+  puts "时间: #{email.date}"
+  puts "已读: #{email.is_read}"
+  puts "附件: #{email.attachments.size} 个"
+end
+```
+
+### 使用函数式 API
+
+```ruby
+require "tempmail_sdk"
+
+# 列出所有渠道
+TempmailSdk.list_channels.each do |ch|
+  puts "渠道: #{ch.channel}, 名称: #{ch.name}, 网站: #{ch.website}"
+end
+
+# 从随机渠道创建邮箱
+info = TempmailSdk.generate_email
+
+# 从指定渠道创建邮箱
+info2 = TempmailSdk.generate_email(TempmailSdk::GenerateEmailOptions.new(channel: "mail-tm"))
+
+# 自定义有效期（仅 tempmail 渠道，单位分钟）
+info3 = TempmailSdk.generate_email(
+  TempmailSdk::GenerateEmailOptions.new(channel: "tempmail", duration: 60)
+)
+
+# 获取邮件列表
+result = TempmailSdk.get_emails(info)
+```
+
+> **提示：** Token 等认证信息由 SDK 内部自动维护，用户无需关心。
+
+## 标准化邮件格式
+
+所有渠道返回的邮件均映射为统一的 `Email` 对象：
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `id` | `String` | 邮件唯一标识 |
+| `from_addr` | `String` | 发件人地址 |
+| `to` | `String` | 收件人地址 |
+| `subject` | `String` | 邮件主题 |
+| `text` | `String` | 纯文本内容 |
+| `html` | `String` | HTML 内容 |
+| `date` | `String` | ISO 8601 格式日期 |
+| `is_read` | `Boolean` | 是否已读 |
+| `attachments` | `Array<EmailAttachment>` | 附件列表 |
+
+## 配置
+
+支持通过环境变量零代码配置，作用于所有 HTTP 请求：
+
+| 变量 | 说明 |
+|------|------|
+| `TEMPMAIL_PROXY` | HTTP/SOCKS5 代理 URL |
+| `TEMPMAIL_TIMEOUT` | 超时秒数（默认 15） |
+| `TEMPMAIL_INSECURE` | `1`/`true` 跳过 TLS 验证 |
+| `TEMPMAIL_TELEMETRY_ENABLED` | `false`/`0`/`no` 关闭匿名遥测 |
+| `TEMPMAIL_TELEMETRY_URL` | 自定义遥测上报端点 |
+| `DROPMAIL_AUTH_TOKEN` | DropMail GraphQL `af_` 令牌 |
+| `APIHZ_ID` / `APIHZ_KEY` | apihz（接口盒子）渠道凭据，默认使用公共账号 |
+
+也可通过代码设置：
+
+```ruby
+TempmailSdk.set_config(proxy: "http://127.0.0.1:7890", timeout: 30, insecure: true)
+```
+
+## 许可证
+
+GPL-3.0

data/lib/tempmail_sdk/channels.rb

@@ -0,0 +1,289 @@
+# frozen_string_literal: true
+#
+# 渠道标识常量模块（279 个），常量值即渠道 slug。
+# 由 .channel_meta.json 生成，供用户以常量方式引用渠道，避免手写字符串出错。
+#
+module TempmailSdk
+  # 全部渠道标识常量，值为对应的 slug 字符串
+  module Channel
+    TEMPMAIL = "tempmail"
+    TEMPMAIL_CN = "tempmail-cn"
+    TA_EASY = "ta-easy"
+    C_10MINUTE_ONE = "10minute-one"
+    XGHFF_COM = "xghff-com"
+    OQQAJ_COM = "oqqaj-com"
+    PSOVV_COM = "psovv-com"
+    DBWOT_COM = "dbwot-com"
+    YGWPR_COM = "ygwpr-com"
+    IMXWE_COM = "imxwe-com"
+    LINSHIYOU = "linshiyou"
+    MFFAC = "mffac"
+    TEMPMAIL_LOL = "tempmail-lol"
+    CHATGPT_ORG_UK = "chatgpt-org-uk"
+    TEMP_MAIL_IO = "temp-mail-io"
+    MAIL_CX = "mail-cx"
+    DDKER_COM = "ddker-com"
+    CATCHMAIL = "catchmail"
+    CATCHMAIL_MAILISTRY = "catchmail-mailistry"
+    CATCHMAIL_ZEPPOST = "catchmail-zeppost"
+    MAILFORSPAM = "mailforspam"
+    MAILFORSPAM_TEMPMAIL_IO = "mailforspam-tempmail-io"
+    MAILFORSPAM_DISPOSABLE = "mailforspam-disposable"
+    TEMPMAILC = "tempmailc"
+    MAILNESIA = "mailnesia"
+    THROWAWAYMAIL = "throwawaymail"
+    TEMPMAIL_FISH = "tempmail-fish"
+    NEIGHBOURS_SH = "neighbours-sh"
+    SHITTY_EMAIL = "shitty-email"
+    TEMPMAILPRO = "tempmailpro"
+    DEVMAIL_UK = "devmail-uk"
+    INBOXKITTEN = "inboxkitten"
+    CLEANTEMPMAIL = "cleantempmail"
+    GETNADA = "getnada"
+    C_1VPN_NET = "1vpn-net"
+    ABEMATV_COM = "abematv-com"
+    ABEMATV_NET = "abematv-net"
+    ABEMATV_ORG = "abematv-org"
+    ACEH_CC = "aceh-cc"
+    BANGKABELITUNG_NET = "bangkabelitung-net"
+    CCTRUYEN_COM = "cctruyen-com"
+    GETNADA_COM = "getnada-com"
+    GETNADA_EMAIL = "getnada-email"
+    GETNADA_NET = "getnada-net"
+    JAWATENGAH_NET = "jawatengah-net"
+    JAWATIMUR_NET = "jawatimur-net"
+    KALIMANTANBARAT_NET = "kalimantanbarat-net"
+    KALIMANTANSELATAN_NET = "kalimantanselatan-net"
+    KALIMANTANTENGAH_NET = "kalimantantengah-net"
+    KALIMANTANTIMUR_NET = "kalimantantimur-net"
+    KALIMANTANUTARA_NET = "kalimantanutara-net"
+    KEPULAUANRIAU_NET = "kepulauanriau-net"
+    LUXURY345_COM = "luxury345-com"
+    MALUKUUTARA_NET = "malukuutara-net"
+    NUSATENGGARABARAT_NET = "nusatenggarabarat-net"
+    NUSATENGGARATIMUR_NET = "nusatenggaratimur-net"
+    PAPUABARAT_NET = "papuabarat-net"
+    PAPUABARATDAYA_NET = "papuabaratdaya-net"
+    PAPUASELATAN_NET = "papuaselatan-net"
+    PEHOL_COM = "pehol-com"
+    PTRUYEN_COM = "ptruyen-com"
+    PULAUBALI_NET = "pulaubali-net"
+    RIAU_NET = "riau-net"
+    SEOKEY_ORG = "seokey-org"
+    SULAWESIBARAT_NET = "sulawesibarat-net"
+    SULAWESISELATAN_NET = "sulawesiselatan-net"
+    SULAWESITENGAH_NET = "sulawesitengah-net"
+    SULAWESITENGGARA_NET = "sulawesitenggara-net"
+    SUMATERABARAT_NET = "sumaterabarat-net"
+    SUMATERASELATAN_NET = "sumateraselatan-net"
+    SUMATERAUTARA_NET = "sumaterautara-net"
+    VILLATOGEL_COM = "villatogel-com"
+    MAIL123 = "mail123"
+    MAIL10S = "mail10s"
+    WEBMAILTEMP = "webmailtemp"
+    TEMPFASTMAIL = "tempfastmail"
+    C_1SEC_MAIL = "1sec-mail"
+    FAKEMAIL = "fakemail"
+    OPENINBOX = "openinbox"
+    INBOXES = "inboxes"
+    UNCORREOTEMPORAL = "uncorreotemporal"
+    AWAMAIL = "awamail"
+    MAIL_TM = "mail-tm"
+    WEB_LIBRARY_NET = "web-library-net"
+    DROPMAIL = "dropmail"
+    GUERRILLAMAIL = "guerrillamail"
+    GUERRILLAMAIL_COM = "guerrillamail-com"
+    MAILDROP = "maildrop"
+    SMAIL_PW = "smail-pw"
+    VIP_215 = "vip-215"
+    FAKE_LEGAL = "fake-legal"
+    IMGUI_DE = "imgui-de"
+    PULSEWEBMENU_DE = "pulsewebmenu-de"
+    MOAKT = "moakt"
+    DRMAIL_IN = "drmail-in"
+    TEML_NET = "teml-net"
+    TMPEML_COM = "tmpeml-com"
+    TMPBOX_NET = "tmpbox-net"
+    MOAKT_CC = "moakt-cc"
+    DISBOX_NET = "disbox-net"
+    TMPMAIL_ORG = "tmpmail-org"
+    TMPMAIL_NET = "tmpmail-net"
+    TMAILS_NET = "tmails-net"
+    DISBOX_ORG = "disbox-org"
+    MOAKT_CO = "moakt-co"
+    MOAKT_WS = "moakt-ws"
+    TMAIL_WS = "tmail-ws"
+    BAREED_WS = "bareed-ws"
+    EMAIL10MIN = "email10min"
+    MJJ_CM = "mjj-cm"
+    LINSHI_CO = "linshi-co"
+    HARAKIRIMAIL = "harakirimail"
+    JQKJQK_XYZ = "jqkjqk-xyz"
+    LYHLEVI_COM = "lyhlevi-com"
+    TEMPMAIL_PLUS = "tempmail-plus"
+    FEXPOST_COM = "fexpost-com"
+    FEXBOX_ORG = "fexbox-org"
+    MAILBOX_IN_UA = "mailbox-in-ua"
+    ROVER_INFO = "rover-info"
+    CHITTHI_IN = "chitthi-in"
+    FEXTEMP_COM = "fextemp-com"
+    ANY_PINK = "any-pink"
+    MEREPOST_COM = "merepost-com"
+    TEMPMAIL_LOL_V2 = "tempmail-lol-v2"
+    TEMPGBOX = "tempgbox"
+    EMAILNATOR = "emailnator"
+    TEMPORAM = "temporam"
+    NEIGHBOURS = "neighbours"
+    SHARKLASERS = "sharklasers"
+    SHARKLASERS_COM = "sharklasers-com"
+    GRR_LA = "grr-la"
+    GRR_LA_COM = "grr-la-com"
+    GUERRILLAMAIL_INFO = "guerrillamail-info"
+    SPAM4ME = "spam4me"
+    GUERRILLAMAIL_NET = "guerrillamail-net"
+    GUERRILLAMAIL_ORG = "guerrillamail-org"
+    GUERRILLAMAILBLOCK = "guerrillamailblock"
+    GUERRILLAMAIL_COM_WWW = "guerrillamail-com-www"
+    M2U = "m2u"
+    TEMPY_EMAIL = "tempy-email"
+    FMAIL = "fmail"
+    OCKITO = "ockito"
+    ANONBOX = "anonbox"
+    DUCKMAIL = "duckmail"
+    MAILINATOR = "mailinator"
+    TEMPMAIL365 = "tempmail365"
+    TEMPINBOX = "tempinbox"
+    BYOM = "byom"
+    ANONYMMAIL = "anonymmail"
+    EYEPASTE = "eyepaste"
+    MAIL_SUNLS = "mail-sunls"
+    EXPRESSINBOXHUB = "expressinboxhub"
+    LROID = "lroid"
+    HARIBU = "haribu"
+    ROOTSH = "rootsh"
+    FAKE_EMAIL_SITE = "fake-email-site"
+    MOHMAL = "mohmal"
+    MAILGOLEM = "mailgolem"
+    BEST_TEMP_MAIL = "best-temp-mail"
+    DISPOSABLEMAIL_APP = "disposablemail-app"
+    MAILTEMP_CC = "mailtemp-cc"
+    MINUTEINBOX = "minuteinbox"
+    MAILCATCH = "mailcatch"
+    TEMPEMAIL_CO = "tempemail-co"
+    TEMPEMAILS_NET = "tempemails-net"
+    ALTMAILS = "altmails"
+    TEMPEMAIL_INFO = "tempemail-info"
+    SMAILPRO = "smailpro"
+    TEMPMAILTEN = "tempmailten"
+    MAILDROP_CC = "maildrop-cc"
+    C_10MINUTEMAIL_NET = "10minutemail-net"
+    LINSHIYOUXIANG_NET = "linshiyouxiang-net"
+    TEMPMAIL_FYI = "tempmail-fyi"
+    DISPOSABLEMAIL_COM = "disposablemail-com"
+    TEMPP_MAILS = "tempp-mails"
+    EMAILTEMP_ORG = "emailtemp-org"
+    MYTEMPMAIL_CC = "mytempmail-cc"
+    TEMP_MAIL_NOW = "temp-mail-now"
+    MAIL_TD = "mail-td"
+    MAILHOLE_DE = "mailhole-de"
+    TMAIL_LINK = "tmail-link"
+    C_24MAIL_CHACUO = "24mail-chacuo"
+    NIMAIL = "nimail"
+    FREECUSTOM = "freecustom"
+    C_16888888_CYOU = "16888888-cyou"
+    C_17666688_SHOP = "17666688-shop"
+    C_282MAIL_COM = "282mail-com"
+    BLACKHOLE_DJURBY_SE = "blackhole-djurby-se"
+    BLOCK_BDEA_CC = "block-bdea-cc"
+    BSDU32_BUZZ = "bsdu32-buzz"
+    B_SMELLY_CC = "b-smelly-cc"
+    CARLTON183_CHANGEIP_NET = "carlton183-changeip-net"
+    DEA_SOON_IT = "dea-soon-it"
+    DISPOSABLE_AL_SUDANI_COM = "disposable-al-sudani-com"
+    DISPOSABLE_NOGONAD_NL = "disposable-nogonad-nl"
+    DOXU243_BUZZ = "doxu243-buzz"
+    EASYME_PRO = "easyme-pro"
+    EBS_COM_AR = "ebs-com-ar"
+    ETGDEV_DE = "etgdev-de"
+    EVERGREENCO_SHOP = "evergreenco-shop"
+    FWD2M_ESZETT_ES = "fwd2m-eszett-es"
+    JAMA_TRENET_EU = "jama-trenet-eu"
+    J_FAIRUSE_ORG = "j-fairuse-org"
+    LAYUEMING_PICS = "layueming-pics"
+    M_887_AT = "m-887-at"
+    M8R_DAVIDFUHR_DE = "m8r-davidfuhr-de"
+    M8R_MCASAL_COM = "m8r-mcasal-com"
+    MAIL_BENTRASK_COM = "mail-bentrask-com"
+    MAIL_FSMASH_ORG = "mail-fsmash-org"
+    MAILINATORZZ_MOOO_COM = "mailinatorzz-mooo-com"
+    MI_MEON_BE = "mi-meon-be"
+    MINGYUEKEJI_ONLINE = "mingyuekeji-online"
+    MINGYUEMING_CLICK = "mingyueming-click"
+    MINGYUEMING_SHOP = "mingyueming-shop"
+    MINGYUKEJI_LOL = "mingyukeji-lol"
+    MN_CURPPA_COM = "mn-curppa-com"
+    M_NIK_ME = "m-nik-me"
+    MTMDEV_COM = "mtmdev-com"
+    NOSPAM_THURSTONS_US = "nospam-thurstons-us"
+    NOTFOND_404_MN = "notfond-404-mn"
+    NULL_K3VIN_NET = "null-k3vin-net"
+    NUXH62_SPACE = "nuxh62-space"
+    PROID_CLOUD_IP_CC = "proid-cloud-ip-cc"
+    RAMJANE_MOOO_COM = "ramjane-mooo-com"
+    RAUXA_SENY_CAT = "rauxa-seny-cat"
+    REALLY_ISTRASH_COM = "really-istrash-com"
+    SBOOK_PICS = "sbook-pics"
+    SPAM_HORTUK_OVH = "spam-hortuk-ovh"
+    SP_WOOT_AT = "sp-woot-at"
+    TEST_UNERGIE_COM = "test-unergie-com"
+    TORCH_YI_ORG = "torch-yi-org"
+    T_ZIBET_NET = "t-zibet-net"
+    XUE32_BUZZ = "xue32-buzz"
+    APIHZ = "apihz"
+    SOGETTHIS_COM = "sogetthis-com"
+    BOBMAIL_INFO = "bobmail-info"
+    SUREMAIL_INFO = "suremail-info"
+    BINKMAIL_COM = "binkmail-com"
+    VERYREALEMAIL_COM = "veryrealemail-com"
+    MAILMOMY = "mailmomy"
+    CHAMMY_INFO = "chammy-info"
+    THISISNOTMYREALEMAIL_COM = "thisisnotmyrealemail-com"
+    NOTMAILINATOR_COM = "notmailinator-com"
+    SPAMHEREPLEASE_COM = "spamhereplease-com"
+    SENDSPAMHERE_COM = "sendspamhere-com"
+    SENDFREE_ORG = "sendfree-org"
+    JUNK_BEATS_ORG = "junk-beats-org"
+    JUNK_IHMEHL_COM = "junk-ihmehl-com"
+    JUNK_NOPLAY_ORG = "junk-noplay-org"
+    JUNK_VANILLASYSTEM_COM = "junk-vanillasystem-com"
+    SPAM_JASONPEARCE_COM = "spam-jasonpearce-com"
+    FISH_SKYTALE_NET = "fish-skytale-net"
+    SPAM_MCCREW_COM = "spam-mccrew-com"
+    DROPMAIL_CLICK = "dropmail-click"
+    SPAM_COROIU_COM = "spam-coroiu-com"
+    SPAM_DELUSER_NET = "spam-deluser-net"
+    SPAM_DHSF_NET = "spam-dhsf-net"
+    SPAM_LUCATNT_COM = "spam-lucatnt-com"
+    SPAM_LYCEUM_LIFE_COM_RU = "spam-lyceum-life-com-ru"
+    SPAM_NETPIRATES_NET = "spam-netpirates-net"
+    SPAM_NO_IP_NET = "spam-no-ip-net"
+    SPAM_OZH_ORG = "spam-ozh-org"
+    SPAM_PYPHUS_ORG = "spam-pyphus-org"
+    SPAM_SHEP_PW = "spam-shep-pw"
+    SPAM_WTF_AT = "spam-wtf-at"
+    SPAM_WULCZER_ORG = "spam-wulczer-org"
+    CRAP_KAKADUA_NET = "crap-kakadua-net"
+    SPAM_JANLUGT_NL = "spam-janlugt-nl"
+    MIN_BURNINGFISH_NET = "min-burningfish-net"
+    SINK_FBLAY_COM = "sink-fblay-com"
+    TEMPGMAILER = "tempgmailer"
+    TEMP_MAIL_ORG = "temp-mail-org"
+    XKX_ME = "xkx-me"
+    GONEBOX_EMAIL = "gonebox-email"
+    MAILCAT_AI = "mailcat-ai"
+    TEMPGO_EMAIL = "tempgo-email"
+    RESTMAIL_NET = "restmail-net"
+    DROPMAIL_ME = "dropmail-me"
+    TEN_MINUTE_MAIL_NET = "ten-minute-mail-net"
+  end
+end