@haneinfo/common

中文文档
0.7.0发布于 2026/11/04UNLICENSEDTypeScriptCommonJS近 30 天下载 5785
中文使用文档
文档目录5 节
  1. Prisma 6和7消费者
  2. HTTP 例外信封
  3. 表单校验错误
  4. 被屏蔽的定义被发布
  5. 缓冲查询

@ 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 保存完整 默认客户端旁边的数据模型 :

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 共发布 6 个版本,首次发布于 2026/10/02;过去 12 个月发布了 6 个版本。

版本发布日期距今
0.7.0latest2026/11/0412 天前
0.6.12026/10/2721 天前
0.6.02026/10/2523 天前
0.5.02026/10/2226 天前
0.4.02026/10/2127 天前
0.3.42026/10/021 个月前

关于 @haneinfo/common 的常见问题

如何安装 @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 和提交记录判断。