@btravstack/config

中文文档
0.58.0发布于 2026/11/08MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 1.2万

配置 @ btravstack/ di 的十二因子方式: 来自环境的输入值, 验证一次, 像其它服务一样注入

中文使用文档
文档目录3 节
  1. 作为港口的环境的一部分
  2. 字段
  3. 许可证

@ btravstack/ 配置

配置十二要素方式,用于 @btravstack/di: 键入 受环境约束的数值,当图形构建时验证, 和其他服务一样注射。 一个糟糕的环境是一个模型 ConfigInvalid 指定每个违法变量——其中 @btravstack/core是因为 runMain 报告 startFailed 事件和 退出代码 78。 。 。 .

📖 文档 • 妇女 参考文献 • 妇女 API 参考

pnpm add @btravstack/config @btravstack/di unthrown

@btravstack/di 财务报告和审定财务报表 unthrown 是同伴的依赖关系; 软件包取决于 没有别的了.. Config.object 是一个手卷式标准Schema。 节点 >=22。 。 。 .

作为港口的环境的一部分

import { Config, Env } from "@btravstack/config";
import { Module, Provider } from "@btravstack/di";

const databaseConfig = Config.provider("DatabaseConfig")(
  Config.object({
    url: Config.string("DATABASE_URL"),
    poolSize: Config.integer("DATABASE_POOL_SIZE", {
      min: 1,
      max: 64,
      default: 8,
    }),
  }),
);

const Persistence = Module("Persistence")({
  needs: [Env],
  provides: [
    databaseConfig,
    Provider(Database)({
      inject: { config: databaseConfig.port },
      acquire: ({ config }) => openDatabase(config.url),
      release: (db) => db.close(),
    }),
  ],
  exports: [Database],
});

Config.provider("DatabaseConfig")(schema) 薄荷港口——其服务是 schema的输出, { url: string; poolSize: number } 手拿回来 供应商携带: databaseConfig.port 所依赖的列表 道诸相. 一个是公共API的切片——一个启动器 HttpConfig,其他哪个 软件包名称 – 声明其端口并经过该类 : Config.provider(HttpConfig)(schema)。 。 。 .

Env 这是什么 Config.provider 读取。 下 @btravstack/core 内核 把它提供给它所有的图.. process.env,或 StartOptions.env 页:1 测试。 任何地方,你自己提供: Provider(Env)({ inject: {}, value: process.env })。 。 。 .

字段

外地数值
Config.string(VAR, { default? })非空字符串
Config.integer(VAR, { min?, max?, default? })以十进制表示的整数,包含
Config.boolean(VAR, { default? })旗帜 : true编号 :false, (中文(简体) ), 1编号 :0, (中文(简体) ), yes编号 :no, (中文(简体) ), on编号 :off
Config.port(VAR, { default? })整个数字在 0..65535 —— 说 0 包括:
Config.url(VAR, { default? })a URL, 保留为已写入; 错误的 URL 被命名为已编辑的用户信息
Config.list(VAR, { min?, default? })以逗号分隔的列表、 已剪切的条目和已空的条目

未设置的变量取其 default (或 is required页:1 设为空或 空白 一个是错误,绝不是默认; abc, (中文(简体) ), 3.5, (中文(简体) ), 0x1F90 财务报告和审定财务报表 域外值被命名; 每个字段在回答前被读取, 所以一个验证 立即点出每个错. Config.pinned(value, field) 如何启动者 选项比环境,每个字段,以及字段带有规则的地方 关于VALUE(integer, (中文(简体) ), port针被它检查,所以绑住 部署不能跨越,也不是一个构成根也可以接上. Config.string 故意不带: “ 设定但空” 是关于生的 变量,其中被绑定 "" 是一个决定(http({ cors: false }) 针头 就是这样。 任何标准Schema(zod, (中文(简体) ), valibot, (中文(简体) ), arktype(d) 被接受以代替 Config.object。 。 。 .

每个字段都命名其类型中的变量,一个模块的需要带有 名称最多 start页:1 env 接受模块配置读取的内容, 不需要任何默认或默认的指针,并拒绝错误或未读 调用时变量. StartEnvironment<typeof Root> 类型 : 从电话。 全数 语义学, ConfigInvalid信息与资讯 ConfigFieldInvalid 正在运行中 文档网站。 。 。 .

许可证

麻省理工学院 贝诺伊特旅行社

版本与发布记录

@btravstack/config 共发布 62 个版本,首次发布于 2026/08/26;过去 12 个月发布了 62 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.58.0latest2026/11/08今天
0.57.02026/11/071 天前
0.56.12026/11/062 天前
0.56.02026/11/062 天前
0.55.12026/11/035 天前
0.55.02026/11/035 天前

关于 @btravstack/config 的常见问题

@btravstack/config 是什么?

配置 @ btravstack/ di 的十二因子方式: 来自环境的输入值, 验证一次, 像其它服务一样注入

如何安装 @btravstack/config?

在项目目录运行 npm install @btravstack/config,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:unthrown(^5.0.0)、@btravstack/di(^0.58.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@btravstack/config 支持 TypeScript 吗?

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

@btravstack/config 支持 ESM 还是 CommonJS?

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

@btravstack/config 需要什么版本的 Node.js?

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

@btravstack/config 可以商用吗?

@btravstack/config 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@btravstack/config 的下载量有多少?

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

@btravstack/config 还在维护吗?

最新版本 0.58.0 发布于 2026/11/08(今天);至今共发布 62 个版本,其中过去 12 个月发布了 62 个;首次发布于 2026/08/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。