# @haneinfo/common 中文文档

规范地址：https://npmcn.com/package/%40haneinfo/common/

版本：0\.7\.0
npm 元数据更新时间：2026-11-04T14:28:07.739Z
中文译文更新时间：2026-11-17T07:43:15.549Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40haneinfo/common
原文对照：https://npmcn.com/package/%40haneinfo/common/?lang=original

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

- 包体积（解压后）：78.4 kB，65 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：zod ^4\.4\.0，express ^5\.1\.0，@nestjs/core ^11\.0\.0 \|\| ^12\.0\.0，@nestjs/common ^11\.0\.0 \|\| ^12\.0\.0，@prisma/client ^6\.19\.0 \|\| ^7\.10\.1
- 首次发布：2026-10-02T05:25:50.296Z
- 最新版本发布：2026-11-04T14:28:07.506Z
- 近 30 天下载量：5785（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @haneinfo/common
```

也可以使用：`pnpm add @haneinfo/common`、`yarn add @haneinfo/common`、`bun add @haneinfo/common`

## README

# @ haneinfo/ 常见

## Prisma 6和7消费者

`PrismaModule` 无选项保留 Prisma 6 行为。 用于 Prisma 7, 导入 `PrismaModule.forRoot({ adapter })` 一次在App的平台组成。 应用程序创建 拥有 `@prisma/adapter-pg` 适配器和配置连接字符串、池、超时和TLS. 删除其它赤裸的 PrismaModule 导入, 因此配置的模块拥有单个 PrismaService . `PRISMA_CLIENT_OPTIONS` 是一个明确的可选注射符; 没有数据库配置 本包推断或读取。 Prisma Service 将选项转发给消费者- CWD 解决 生成客户端,并保留连接/断开的生命周期钩.

在升级消费针前发布相容性发布. NestJS 11和Prisma 6 保留下来 支持; 开发树演练 NestJS 12和Prisma 7. NestJS 12 需要现代节点 (b) 伐木机5需要22.12+. Prisma 7仍然支持消费者解析器使用的现有棱镜-客户端-js输出.

Prisma 7的运行时间 DMMF省略了enum,文档,字段限制和关系元数据. 在 App 的计划文件夹中添加第二个生成器 `prisma:generate` 保存完整 默认客户端旁边的数据模型 :

```prisma
generator haneinfoMetadata {
  provider = "node ./node_modules/@haneinfo/common/dist/prisma/prisma-generator.js"
  output   = "../../node_modules/.prisma/haneinfo-metadata"
}
```

提供者相对后端工作目录;输出相对 `backend/prisma/schema`。PrismaService 和导出的 Prisma 命名空间继续使用 App 拥有生成的客户端。 对于Prisma 7, 通常通过节点解析负载这个 JSON 并检查它 与客户端的嵌入式计划相对立 缺少、陈旧或紧凑的元数据失败 当然 Prisma 6继续使用其最初的完整DMMF. 漂移脚本必须导入 `Prisma` 从 `@haneinfo/common`; 直接从 `@prisma/client` 仍然提供紧凑的元数据 . 在已部署的依赖树上再生成两件文物; 不要复制 App 的快照 .

## HTTP 例外信封

GlobalExceptionFilter 保留状态代码、消息、微量ID、时间戳、路径和现有 验证阵列详细介绍了行为. 它只为 MattleError 形状的错误添加可选代码 或使用 Madela Error.toJSON () 代码/消息形状的平面 HTTP 响应 。 代码必须匹配 `^[A-Z][A-Z0-9_]{1,63}$` 完全没有线性终点 承认不 导入插件- api 或引用例外序列器。 一般错误和任意编码错误 实例不获取代码 。 直接的非HTTP错误保留了现有的HTTP 500处理.

只有代码被预测。 自定义例外属性、问题、诊断数组、机制 细节、建议和堆栈从未被复制到信封中。 现有信息 验证-阵列详细合同不变;UI消费者应翻译已知代码并 显示一个非通用错误,而不提供后端的正文。 保留服务器侧日志 它的现有行为.

安装此过滤器的应用程序在升级后接收添加剂字段 。 自定义过滤器需要其 自己的领养工作; 插件- host-nest 不安装或复制全局例外过滤器.

## 表单校验错误

对于带有HTTP 422的INVALID DATA, 全球例外 过滤项目只包含细节. field 错误 ({路径,代码}从表格诊断。 贾森 指针必须处理/ 值/, 有限 至300个字符,列表仅限于100个条目. 超大小路径或额外条目为 并标出细节。 表单以外的错误项目和代码 被跳过。 信息、建议、价值和原始诊断从未预测。 其它 机制细节保留其现有的保护(只有修订冲突和费率限制).

## 被屏蔽的定义被发布

用于 PUBLISH BLOCKED 与 HTTP 409 (`@haneinfo/definition-registry`),全球例外 过滤项目 细节。定义:每个被封锁的定义有一个条目,其中包含其类型、代码和理由(`invalid` 页:1 草案即将公布, `affected` 对于一个公布的定义,它会打破),每个 诊断代码和JSON指针路径 最多50个定义和100个诊断 预测; 路径超过 300 个字符或额外条目被丢弃并标记细节 。 被截断了. 错误的种类,代码,诊断代码和指针被跳过. 诊断信息和 建议引用定义内容,从未预测.

## 缓冲查询

`paginationQuerySchema` 接受 `page` 1至10 000岁, `limit` 从1到100(违约20)和a `search` 最多200个字符; 外部任何东西都是验证错误( HTTP 400 至 (原始内容存档于2018-10-12). ZodValidation Pipe.

## 常见问题

### 如何安装 @haneinfo/common？

在项目目录运行 npm install @haneinfo/common，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.4\.0）、express（^5\.1\.0）、@nestjs/core（^11\.0\.0 \|\| ^12\.0\.0）、@nestjs/common（^11\.0\.0 \|\| ^12\.0\.0）、@prisma/client（^6\.19\.0 \|\| ^7\.10\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 haneinfo-prisma-metadata，可以用 npx haneinfo-prisma-metadata 直接运行。

### @haneinfo/common 支持 TypeScript 吗？

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

### @haneinfo/common 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @haneinfo/common 可以商用吗？

@haneinfo/common 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @haneinfo/common 的下载量有多少？

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

### @haneinfo/common 还在维护吗？

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

