---

nestjs-codegen

Codegen for NestJS — generates typed client artifacts (routes, typed API client, validation schemas) from your controllers, contracts, and DTOs. This is the full codegen extracted from nestjs-inertia into its own repo, with pluggable validation, optional TanStack Query / superjson, and built-in nestjs-inertia and nestjs-filter integrations.

Packages

Package	Role
@dudousxd/nestjs-codegen	The codegen: discovery (controllers, defineContract, DTOs, pages, shared props, filters), emitters (routes.ts/api.ts/forms.ts/pages.d.ts/components.json), config loader, watch mode, and the codegen/init/doctor CLI. Bundles the schema IR (no adapter is bundled — pick one below).
@dudousxd/nestjs-codegen-zod	Zod validation adapter.
@dudousxd/nestjs-codegen-valibot	Valibot validation adapter.
@dudousxd/nestjs-codegen-arktype	ArkType validation adapter.
@dudousxd/nestjs-client	Framework-neutral runtime (typed fetcher + superjson transformer hook) for generated api.ts in plain (non-Inertia) mode.

Features

• Pluggable validation — a neutral SchemaNode IR with adapters for zod, valibot, and arktype (each a separate adapter package), designed around the Standard Schema shape.
• Optional TanStack Query — framework-agnostic queryOptions/mutationOptions.
• Optional superjson — a transformer on the runtime fetcher round-trips rich types (Date, Map, …) end-to-end.
• nestjs-inertia integration — pages.d.ts + components.json + shared-props discovery, and Inertia router mutations in api.ts.
• nestjs-filter integration — @FilterFor/@ApplyFilter discovery emits TypedFilterQuery<…> against @dudousxd/nestjs-filter-client.

CLI

# one-shot generate (reads nestjs-inertia.config.ts)
nestjs-codegen codegen
nestjs-codegen codegen --watch     # regenerate on change
nestjs-codegen init                # scaffold config + Inertia app
nestjs-codegen doctor              # diagnose setup

Programmatic

import { defineConfig, loadConfig, generate, watch } from '@dudousxd/nestjs-codegen';

const config = await loadConfig(process.cwd());
await generate(config /*, routes */);

Use a validation lib other than zod by passing the adapter instance:

import { valibotAdapter } from '@dudousxd/nestjs-codegen-valibot';
// (wired via config — see docs/superpowers/specs)

Development

pnpm install
pnpm test        # 522 tests
pnpm typecheck
pnpm build
pnpm lint