Reliability, mail, webhooks, workflows & AI

NestRS 1.7 adds Axum-native crates for reliability, outbound integrations, durable workflows, and LLM agents. Enable them with umbrella features on nestrs, or depend on the crates directly. This page is the hub; each package has an ecosystem guide and an API reference.

Explicit exceptions (not silent gaps): Express/Fastify adapters (ADR-0001 Axum-only), Nest Observe SaaS / Mau deploy (open OTel instead), and nestrs-drizzle until upstream publishes. See roadmap.

Install

[dependencies]
nestrs = { version = "1.7.1", features = [
  "resilience", "idempotency", "outbox", "locks",
  "mail", "webhooks", "workflows", "ai",
] }

Or depend on individual crates (nestrs-resilience = "1.7.1", …) for a thinner graph.

Package map

NestRS crate	Feature	Guide	API
`nestrs-resilience`	`resilience`	Resilience	API
`nestrs-idempotency`	`idempotency`	Idempotency	API
`nestrs-outbox`	`outbox`	Outbox	API
`nestrs-locks`	`locks`	Locks	API
`nestrs-mail`	`mail`	Mail	API
`nestrs-webhooks`	`webhooks`	Webhooks	API
`nestrs-workflows`	`workflows`	Workflows	API
`nestrs-ai`	`ai`	AI	API
Open telemetry	`otel`	Observability	—

Coming from Nest? See the migration guide for Nest package names.

Foundation features

These live in core nestrs / nestrs-core / nestrs-openapi — no extra crate:

Capability	NestRS API
Stable machine-readable error codes	`HttpException::with_error_code("WEAK_PASSWORD")` → JSON `errorCode`
Schema + validation for DTOs	`NestrsSchema` + `SchemaValidationPipe` (`Validate` + `JsonSchema`)
OpenAPI DTO `$ref` auto-link	`OpenApiRouteSpec::{request_body_schema, response_schema}`
Route conflict / shadow diagnostics	`RouteConflictPolicy` on `NestApplication`
Richer `ExecutionContext`	`get_class` / `get_handler` / name accessors
Controller-level pipes	`controller_pipes = …` on `#[routes]`
Span attrs for handlers	OTel attrs `nestrs.controller` / `nestrs.handler`

use nestrs::prelude::*;

#[get("/signup")]
async fn signup() -> Result<Json<Value>, HttpException> {
    Err(BadRequestException::new("Password is too weak").with_error_code("WEAK_PASSWORD"))
}

Response body:

{
  "statusCode": 400,
  "message": "Password is too weak",
  "error": "Bad Request",
  "errorCode": "WEAK_PASSWORD"
}

Wire modules like other NestRS dynamic modules

Every reliability crate follows the same pattern as CacheModule / ThrottlerModule:

Call FooModule::register(options) → DynamicModule
Put it in #[module(imports = [...])]
Inject the exported service (Arc<FooService>) into an #[injectable] provider

use nestrs::prelude::*;
use std::sync::Arc;

#[injectable]
struct OrdersService {
    resilience: Arc<nestrs::resilience::ResilienceService>,
    mail: Arc<nestrs::mail::MailService>,
}

#[module(
    imports = [
        nestrs::resilience::ResilienceModule::register(
            nestrs::resilience::ResilienceOptions::default()
        ),
        nestrs::mail::MailModule::register(
            nestrs::mail::MailOptions::default()
        ),
    ],
    providers = [OrdersService],
    controllers = [OrdersController],
)]
struct AppModule;

DynamicModule only exports listed TypeIds. These modules export their services; if you build a custom dynamic module, pass vec![TypeId::of::<YourService>()] to from_parts or importers cannot inject it.

Try it in the lab

cargo run -p lab --bin lab9_nestjs12
# optional live server on :3612
cargo run -p lab --bin lab9_nestjs12 -- serve

The smoke hits errorCode, resilience retries, mail escaping, AI FakeModel, locks, outbox relay, workflows, webhooks sign/verify, and an idempotency race.

Security

Threat-model notes for key scope, SSRF, poison outbox messages, and AI tool authz: Reliability security notes.

Roadmap

Full matrix (including exceptions): roadmap parity in-repo, or the migration guide.

Get Started

Core Concepts

API Development

Security & Auth

Transports & Protocols

Reliability & agents

Operations

Reliability, mail, webhooks, workflows & AI

Install

Package map

Foundation features

Wire modules like other NestRS dynamic modules

Try it in the lab

Security

Roadmap

​Install

​Package map

​Foundation features

​Wire modules like other NestRS dynamic modules

​Try it in the lab

​Security

​Roadmap

Install

Package map

Foundation features

Wire modules like other NestRS dynamic modules

Try it in the lab

Security

Roadmap