@haneinfo/plugin-host-nest
NestJS host for Haneinfo plugins: composition from a resolved inventory, lifecycle runner, catalog, diagnostics, and host-owned authentication infrastructure.
IAM Configuration & Startup Checks
HaneinfoHostConfig accepts an optional iam field:
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,
},
});
Important: Apps must pass the same
IamDeploymentConfigobject to bothiam.deployment(used by the host for fail-closed startup verification) andruntime.iam(consumed by the IAM profile plugin'sconfigSchema).
When iam is omitted, the host performs no IAM startup checks and preserves existing behavior.
Error Codes (PluginContractError)
When iam is configured, the host enforces all checks fail-closed:
| Error Code | Phase | Meaning |
|---|---|---|
iam-profile-missing | prepare() / onApplicationBootstrap() | No haneinfo.iam-profile (IAM_PROFILE) provider was resolved in the plugin graph, or the IAM_PROFILE instance could not be resolved from the Nest injector. |
iam-profile-duplicate | prepare() | More than one provider for haneinfo.iam-profile was resolved in the graph (note: two unrelated plugins without replaces are rejected earlier by the resolver as duplicate-capability-provider). |
iam-core-capabilities-failed | prepare() | deployment.capabilities.corePassed is not true; the IAM cannot be enabled without passing core capabilities C1–C12. |
iam-admin-mfa-unavailable | prepare() | deployment.capabilities.adminMfa is false while deployment.mcp.admin.enabled is true. |
iam-token-exchange-missing | prepare() | deployment.capabilities.delegation is true, but no haneinfo.iam-token-exchange (IAM_TOKEN_EXCHANGE) provider was resolved. |
iam-profile-id-mismatch | onApplicationBootstrap() | profile.profileId does not match deployment.profileId. |
iam-issuer-mismatch | onApplicationBootstrap() | profile.issuer does not match deployment.issuer verbatim. |
iam-capability-mismatch | onApplicationBootstrap() | profile.mcpCapabilities differs from deployment.capabilities on any of adminMfa, offlineConnector, delegation, or clientResourceBinding. |