@bella-baxter/adonis

中文文档
0.1.1-preview.144发布于 2026/11/06MITTypeScriptES Module构建来源已验证近 30 天下载 2252

Bella Baxter AdonisJS v6 服务提供商——在IoC集装箱中注册BellaService

中文使用文档
文档目录8 节
  1. 安装
  2. 设置
  3. 1. 登记提供者
  4. 2. 创建配置文件
  5. 3. 输入控制器/服务
  6. 类型机密
  7. 环境变量
  8. 链接

翻译:

npm license: MIT

贝拉·巴克斯特 adonisJS v6/v7——登记册的服务提供者 BellaService 在IoC的容器中,为活地重装机密.

安装

npm install @bella-baxter/adonis
# or
pnpm add @bella-baxter/adonis

设置

1. 登记提供者

// adonisrc.ts
import { defineConfig } from '@adonisjs/core/build/config.js';

export default defineConfig({
  providers: [
    () => import('@bella-baxter/adonis'),
  ],
});

2. 创建配置文件

// config/bella.ts
import env from '#start/env'
import type { BellaConfigOptions } from '@bella-baxter/adonis';

const bellaConfig: BellaConfigOptions = {
  baxterUrl: env.get('BELLA_BAXTER_URL'),
  apiKey: env.get('BELLA_BAXTER_API_KEY'),
  projectSlug: env.get('BELLA_BAXTER_PROJECT', 'my-app'),
  environmentSlug: env.get('BELLA_BAXTER_ENV', 'production'),
};

export default bellaConfig;

3. 输入控制器/服务

import { inject } from '@adonisjs/core';
import { BellaService } from '@bella-baxter/adonis';

@inject()
export default class SecretsController {
  constructor(protected bella: BellaService) {}

  async show() {
    return { dbUrl: this.bella.getOrThrow('DATABASE_URL') }
  }
}

类型机密

运行 bella secrets generate typescript --declaration 生成 bella-secrets.d.ts编辑 BellaService 代理拾取扩展 BellaSecrets 接口 :

this.bella.DATABASE_URL  // string — typed!

环境变量

变量说明
BELLA_BAXTER_URLBella Baxter API 的基础 URL
BELLA_BAXTER_API_KEYAPI 密钥( E)bax-...(中文(简体) )
BELLA_BAXTER_PROJECT项目弹片
BELLA_BAXTER_ENV环境弹
BELLA_BAXTER_PRIVATE_KEYZKE 的私钥( 可选)

版本与发布记录

@bella-baxter/adonis 共发布 121 个版本,首次发布于 2026/03/25;过去 12 个月发布了 121 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.1-preview.144latest2026/11/062 天前
0.1.1-preview.1432026/11/062 天前
0.1.1-preview.1422026/10/2811 天前
0.1.1-preview.1412026/10/2613 天前
0.1.1-preview.1402026/10/2514 天前
0.1.1-preview.1382026/10/2019 天前

其他发布通道:preview → 0.1.1-preview.105。

关于 @bella-baxter/adonis 的常见问题

@bella-baxter/adonis 是什么?

Bella Baxter AdonisJS v6 服务提供商——在IoC集装箱中注册BellaService

如何安装 @bella-baxter/adonis?

在项目目录运行 npm install @bella-baxter/adonis,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@adonisjs/core(>=6)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bella-baxter/adonis 支持 TypeScript 吗?

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

@bella-baxter/adonis 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bella-baxter/adonis 可以商用吗?

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

@bella-baxter/adonis 的下载量有多少?

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

@bella-baxter/adonis 还在维护吗?

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