@haneinfo/plugin-host-nest

中文文档
2.2.0发布于 2026/11/16UNLICENSEDTypeScriptCommonJS零依赖近 30 天下载 5036

Haneinfo插件的NestJS主机:来自已解析的目录,生命周期,目录和诊断的成分,外加主机拥有的认证策略注册和主上下文.

中文使用文档

@haneinfo/plugin-host-nest (英语)

Haneinfo插件的NestJS主机:来自已解析的库存,生命周期跑车,目录,诊断,以及主机拥有的认证基础设施的成分.

IAM 配置和启动检查

HaneinfoHostConfig 接受可选选项 iam 字段 :

import { defineHaneinfoConfig } from '@haneinfo/plugin-host-nest';
import type { IamDeploymentConfig } from '@haneinfo/plugin-api';

const iamDeployment: IamDeploymentConfig = {
  // single source of truth for IAM profile, issuer, and capability assessment
  ...
};

export default defineHaneinfoConfig({
  inventory,
  plugins,
  iam: { deployment: iamDeployment },
  runtime: {
    iam: iamDeployment,
  },
});

重要内容: Apps必须经过 不变 IamDeploymentConfig 两者均为对象 iam.deployment (由主机用于故障关闭启动验证)和 runtime.iam (由 IAM 配置插件完成) configSchema) (中文(简体) ).

何时 iam 被省略,主机不执行 IAM 启动检查并保存已存在的行为.

错误代码( E)PluginContractError(中文(简体) )

何时 iam 已配置, 主机执行所有检查失败关闭 :

错误代码阶段含义
iam-profile-missingprepare() 编号 : onApplicationBootstrap()没有 haneinfo.iam-profile (单位:千美元)IAM_PROFILE提供者在插件图中解决,或 IAM_PROFILE 无法从 Nest 注入器中解决实例.
iam-profile-duplicateprepare()不止一个供应商 haneinfo.iam-profile 已在图表中解决(注:没有 replaces 先前被解析者拒绝为 duplicate-capability-provider) (中文(简体) ).
iam-core-capabilities-failedprepare()deployment.capabilities.corePassed 没有 true;不通过核心能力C1–C12,IAM就无法被启用.
iam-admin-mfa-unavailableprepare()deployment.capabilities.adminMfa 实值 false 时 deployment.mcp.admin.enabled 实值 true。 。 。 .
iam-token-exchange-missingprepare()deployment.capabilities.delegation 实值 true,但没有 haneinfo.iam-token-exchange (单位:千美元)IAM_TOKEN_EXCHANGE供应商得到了解决.
iam-profile-id-mismatchonApplicationBootstrap()profile.profileId 不匹配 deployment.profileId。 。 。 .
iam-issuer-mismatchonApplicationBootstrap()profile.issuer 不匹配 deployment.issuer 逐字记录.
iam-capability-mismatchonApplicationBootstrap()profile.mcpCapabilities 与 deployment.capabilities 任何一项 adminMfa, (中文(简体) ), offlineConnector, (中文(简体) ), delegation,或 clientResourceBinding。 。 。 .

版本与发布记录

@haneinfo/plugin-host-nest 共发布 5 个版本,首次发布于 2026/10/02;过去 12 个月发布了 5 个版本。

版本发布日期距今
2.2.0latest2026/11/161 天前
2.1.22026/11/0412 天前
2.1.12026/10/2721 天前
2.1.02026/10/151 个月前
2.0.02026/10/021 个月前

关于 @haneinfo/plugin-host-nest 的常见问题

@haneinfo/plugin-host-nest 是什么?

Haneinfo插件的NestJS主机:来自已解析的目录,生命周期,目录和诊断的成分,外加主机拥有的认证策略注册和主上下文.

如何安装 @haneinfo/plugin-host-nest?

在项目目录运行 npm install @haneinfo/plugin-host-nest,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:rxjs(^7.8.2)、@nestjs/core(^11.0.0 || ^12.0.0)、@nestjs/common(^11.0.0 || ^12.0.0)、@haneinfo/plugin-api(^1.5.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haneinfo/plugin-host-nest 支持 TypeScript 吗?

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

@haneinfo/plugin-host-nest 支持 ESM 还是 CommonJS?

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

@haneinfo/plugin-host-nest 需要什么版本的 Node.js?

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

@haneinfo/plugin-host-nest 可以商用吗?

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

@haneinfo/plugin-host-nest 的下载量有多少?

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

@haneinfo/plugin-host-nest 还在维护吗?

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