# @haatlabs-core/nest-common 中文文档

规范地址：https://npmcn.com/package/%40haatlabs-core/nest-common/

版本：0\.18\.5
npm 元数据更新时间：2026-11-13T18:16:01.156Z
中文译文更新时间：2026-11-17T07:20:27.167Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40haatlabs-core/nest-common
原文对照：https://npmcn.com/package/%40haatlabs-core/nest-common/?lang=original
项目主页：https://haatlabs.shop/docs/packages/nest-common/
源码仓库：https://github.com/Haatlabs/haatlabs-platform

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

- 包体积（解压后）：113 kB，64 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：5 个
- peer 依赖：zod ^4\.6\.5，rxjs ^7\.8\.2，fastify ^5\.12\.5，ioredis ^6\.0\.0，drizzle-orm ^0\.45\.3，@nestjs/core ^12\.1\.2，@nestjs/common ^12\.1\.2，@fastify/cookie ^11\.1\.2，@fastify/helmet ^13\.1\.1，@nestjs/swagger ^12\.0\.2，reflect-metadata ^0\.2\.2，@nestjs/platform-fastify ^12\.1\.2
- 首次发布：2026-10-22T23:23:25.934Z
- 最新版本发布：2026-11-13T18:16:00.531Z
- 近 30 天下载量：5260（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

认证下面的每个 NestJS API 共享内容:错误,验证,健康检查和快速化应用设置.

## 安装

```sh
npm install @haatlabs-core/nest-common
```

也可以使用：`pnpm add @haatlabs-core/nest-common`、`yarn add @haatlabs-core/nest-common`、`bun add @haatlabs-core/nest-common`

## README

# @haatlabs-core/nest-common (英语)

每个应用程序的 NestJS API 股份, 低于认证.

-   **键** (单位:千美元)`CONFIG`, (中文(简体) ), `LOGGER`, (中文(简体) ), `APP_DB`, (中文(简体) ), `SYSTEM_DB`, (中文(简体) ), `REDIS`, (中文(简体) ), `RATE_LIMITER`, (中文(简体) ), `METRICS`, (中文(简体) ), `PLAIN_FETCH`, (中文(简体) ), `FETCH`, (中文(简体) ), `MAILER`, (中文(简体) ), `TOKEN_CIPHER`, (中文(简体) ), `STORE_TOKENS`:已注册符号,所以 两个安装的拷贝名称是同一个供应商。 一个应用 `infra/tokens.ts` 再出口他们 除了它自己,还有它自己.
-   `AppExceptionFilter`: 每个错误为 `{ error: { code, message, requestId } }`; 过失 我们的是INNAL,没有SQL或约束值记录,并且从未显示.
-   `HtmlProblemFilter` 与提供者 `HTML_PROBLEM_OPTIONS`:一个页面,而不是JSON, 对于一个 拒绝给个人的浏览器.
-   `ZodPipe`, (中文(简体) ), `Public` 编号 : `OptionalAuth` (auth mode count -auth的卫视).
-   `MAILER` 被应用程序绑定为 `@haatlabs-core/mailer`是因为 `mailerFromConfig(config.mail)`。 。 。 .
-   `requireFeature` 编号 : `requireFeatureFor` 一个以上 `FeatureSource`,与 `FEATURE_ERRORS` (扩展为: `defineErrors` 以有计划的应用程序进行.
-   `HealthController` (单位:千美元)`/health/live`, (中文(简体) ), `/health/ready`超过提供者 `HEALTH_CHECKS`, (中文(简体) ), 与 `postgresCheck` 财务报告和审定财务报表 `redisCheck`; 检查可能是 `advisory` 缓存( e)`cacheMs`) (中文(简体) ).
-   `createFastifyApp(module, options)`: 请求ID、每个请求的跨度、按路由分列的指标 模式、头盔、饼干、 CORS 和 OpenAPI 文档. `installShutdown` 财务报告和审定财务报表 `warnAuthMisconfig` 应用的主. `oneMonthAfter`。 。 。 . `observeHttp` 于 应用程序存在,所以一个应用程序在 `main` (与 `@haatlabs-core/observability/metrics`(中文(简体) ) ,然后将相同的对象交给其模块 `METRICS`。 。 。 .

每个 `@nestjs/*` 软件包, `fastify`, (中文(简体) ), `ioredis`, (中文(简体) ), `drizzle-orm` 财务报告和审定财务报表 `zod` 是同龄人.

## 安装

```
pnpm add @haatlabs-core/nest-common
```

这些软件包留给你的应用程序,所以应用程序持有一份: `@fastify/cookie`, (中文(简体) ), `@fastify/helmet`, (中文(简体) ), `@nestjs/common`, (中文(简体) ), `@nestjs/core`, (中文(简体) ), `@nestjs/platform-fastify`, (中文(简体) ), `@nestjs/swagger`, (中文(简体) ), `drizzle-orm`, (中文(简体) ), `fastify`, (中文(简体) ), `ioredis`, (中文(简体) ), `reflect-metadata`, (中文(简体) ), `rxjs`, (中文(简体) ), `zod`。 。 。 .

## 常见问题

### @haatlabs-core/nest-common 是什么？

认证下面的每个 NestJS API 共享内容:错误,验证,健康检查和快速化应用设置\.

### 如何安装 @haatlabs-core/nest-common？

在项目目录运行 npm install @haatlabs-core/nest-common，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.6\.5）、rxjs（^7\.8\.2）、fastify（^5\.12\.5）、ioredis（^6\.0\.0）、drizzle-orm（^0\.45\.3）、@nestjs/core（^12\.1\.2）、@nestjs/common（^12\.1\.2）、@fastify/cookie（^11\.1\.2）、@fastify/helmet（^13\.1\.1）、@nestjs/swagger（^12\.0\.2）、reflect-metadata（^0\.2\.2）、@nestjs/platform-fastify（^12\.1\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @haatlabs-core/nest-common 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @haatlabs-core/nest-common 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @haatlabs-core/nest-common 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @haatlabs-core/nest-common 可以商用吗？

@haatlabs-core/nest-common 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @haatlabs-core/nest-common 的下载量有多少？

根据 npm 官方下载统计，@haatlabs-core/nest-common 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,260 次，日均约 175 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @haatlabs-core/nest-common 还在维护吗？

最新版本 0\.18\.5 发布于 2026/11/14（3 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/10/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

