Support Policy

The supported runtime and peer lines for @nest-native/ai-sdk.

Supported Versions

Item	Supported line
Node.js	>=20
NestJS	11.x
Vercel AI SDK (ai)	^6 (tracks the current major; older majors not supported)
HTTP adapter	Express and Fastify (parity is a project goal)
Validation	Zod and class-validator, both app-owned

The published package keeps "dependencies": {}. The AI SDK and the NestJS packages are declared as peerDependencies, so applications install only the ecosystems they actually use.

AI SDK Major Version

The AI SDK major is critical. The peer range tracks the current major: ai ^6. Older majors are not supported — each AI SDK major reworks the stream protocol and/or the provider specification (v6 moved the language-model provider interface from v2 to v3), so an application on an older major must upgrade the AI SDK before adopting the matching release of this package. See the Migration Guide for the v5 → v6 note.

Rather than holding a legacy major, the package adopts each new AI SDK major: the peer range is bumped, the source/samples/fixtures are migrated to the new API, and the change ships as a breaking peer release. Review the AI SDK changelog at every bump.

@Sse Bug Tracking

Part of this package's design works around nestjs/nest#12670 (the @Sse connection opens before the handler runs). If Nest core fixes that defect, parts of the design may be re-evaluated at the corresponding Nest minor. The package does not depend on the bug being fixed and does not pre-fix it.

Stability

The package is pre-1.0. The public API surface (@AiStream, @AiAbortSignal, AiModule) is the current 0.x public API described in the API Reference; per semver it may still change before 1.0 (pin a version), and the Roadmap covers what is intentionally out of scope.