npm.io
0.13.1 • Published 2d agoCLI

@dudousxd/nestjs-codegen

Licence
MIT
Version
0.13.1
Deps
4
Size
3.9 MB
Vulns
0
Weekly
0
Stars
1
SummaryDependencyVersions

@dudousxd/nestjs-codegen — an Aviary library. Call sign: Weaver.

Read the documentation  ·  part of the Aviary ecosystem for NestJS

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

Keywords

tanstack-intent