@ astram/ 邮件
Astram框架的电子邮件发送适配器(G-010). 各执行 EmailProvider
端口从 @astram/core。 。 。 .
Apps 通常不导入此软件包 。 在旁边安装 @astram/guard 设置
ShieldModule.forRoot({ emailSender: 'env' })警卫阅读和检查 EMAIL_* 编号 : SMTP_* 编号 :
在启动时装入此包和呼叫 createEmailProvider 与结果.
警卫还约束和审计每一个发送.
供应商
EMAIL_PROVIDER | 运输 | 探测( 发送无) |
|---|
smtp | nodemailer (在配置 SMTP 时才装入); TLS starttls, (中文(简体) ), implicit 或者说 none (只返回); 证书总是被验证 | verify():连接、STATLS、AUTH、QUIT |
brevo | POST /v3/smtp/email简洁 fetch | GET /v3/account |
sendgrid | POST /v3/mail/send简洁 fetch | GET /v3/scopes (必须包括 mail.send(中文(简体) ) |
mailgun | POST /v3/{domain}/messages简洁 fetch美国或欧盟东道国 | GET /v3/domains/{domain} |
行为
- 每个发送和探测器都以
timeoutMs (默认10000,最大30000). 接到电话
并放弃其套接字或请求.
- A 类
transient 失败(Network,HTTP 429/5xx,SMTP 4xx) 被重试一次,有焦急回放,
只有束缚有空间。 A 类 permanent 失败或a timeout 从来没有被重审.
- HTTP 提供者只使用 https 而不遵循重定向 .
- 失败的是
MessageDeliveryError (单位:千美元)transient | permanent | timeout) (中文(简体) ). 他们的信息已经建立
从提供者名称, 类和 HTTP 状态。 它从来没有包括证书,a
接收者,消息,或提供者的响应机构.
- 一个无法使用的配置( 非 https)
baseUrl,超时,以标题值表示 CR/LF)为
以平地拒绝 Error 字段的名称,从不值.
@astram/core 是一个对等依赖, 所以一个应用程序会安装一个副本 .
关于 @astram/messaging 的常见问题
@astram/messaging 是什么？
Astram 框架 — @astram/ core Email Provider 端口后方的电子邮件发送适配器(SMTP over nodemailer; Brevo, SendGrid和Mailgun over plain fust). 被捆绑的发信人 一次对瞬间故障的惊恐重试 从未携带过胆汁的消毒错误
如何安装 @astram/messaging？
在项目目录运行 npm install @astram/messaging，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@astram/core（^1.19.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@astram/messaging 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@astram/messaging 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。
@astram/messaging 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=20.3.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@astram/messaging 可以商用吗？
@astram/messaging 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@astram/messaging 的下载量有多少？
根据 npm 官方下载统计，@astram/messaging 在 2026/10/07 – 2026/11/05 这 30 天内被下载 3,416 次，日均约 114 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@astram/messaging 还在维护吗？
最新版本 0.1.22 发布于 2026/11/06（1 天前）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/10/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。