# @astram/messaging 中文文档

规范地址：https://npmcn.com/package/%40astram/messaging/

版本：0\.1\.22
npm 元数据更新时间：2026-11-06T15:42:47.769Z
中文译文更新时间：2026-11-07T01:00:31.490Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40astram/messaging
原文对照：https://npmcn.com/package/%40astram/messaging/?lang=original
项目主页：https://github.com/ASTRAM-2-0/astram-framework#readme
源码仓库：https://github.com/ASTRAM-2-0/astram-framework

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：59.8 kB，36 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.3\.0
- 运行依赖：1 个
- peer 依赖：@astram/core ^1\.19\.0
- 首次发布：2026-10-15T01:36:33.346Z
- 最新版本发布：2026-11-06T15:42:47.458Z
- 近 30 天下载量：3416（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

Astram 框架 — @astram/ core Email Provider 端口后方的电子邮件发送适配器(SMTP over nodemailer; Brevo, SendGrid和Mailgun over plain fust). 被捆绑的发信人 一次对瞬间故障的惊恐重试 从未携带过胆汁的消毒错误

## 安装

```sh
npm install @astram/messaging
```

也可以使用：`pnpm add @astram/messaging`、`yarn add @astram/messaging`、`bun add @astram/messaging`

## README

# @ 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 框架 — @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 和提交记录判断。