5 Min. Lesezeit0Aufrufe

NestJS 12 und das Ende des Glue-Codes

NestJS 12 hat das Fundament gelegt; die Wochen danach brachten den spannenden Teil. Ein offizielles Drizzle-Modul, ein fetch-basierter HTTP-Client und ein Adapter direkt auf `node:http`, angekündigt für das nächste Minor-Release, der in Benchmarks rund 50 % schneller als Express ist.

NestJSDrizzle ORMNode.jsTypeScriptExpress.jsFastifyZod

NestJS 12 erschien Ende August, und das Release selbst legt vor allem Fundamente: Alle Core-Pakete werden jetzt als ESM ausgeliefert, Routen-Decorators akzeptieren Standard-Schema-Validatoren wie Zod und Valibot, die CLI wurde rund um einen neuen Befehl nest upgrade neu gebaut, und es gibt ein offizielles Observability-SDK. Alles gut. Aber der Teil, zu dem ich immer wieder zurückkehre, kam nach dem Release: zwei neue offizielle Module und ein angekündigter Adapter, die zusammen den Glue-Code ersetzen, den jedes Nest-Projekt bisher mitschleppte.

DrizzleModule: Drizzle auf die Nest-Art

Drizzle hält das Schema in TypeScript und die Queries nah am SQL. Bisher hieß die Einbindung in Nest, einen Provider von Hand zu schreiben oder einen von mehreren Community-Wrappern auszuwählen. @nestjs/drizzle ist die offizielle Variante, im September vom Nest-Team veröffentlicht.

TypeScript
import { drizzle } from 'drizzle-orm/node-postgres';
import { DrizzleModule } from '@nestjs/drizzle';

@Module({
  imports: [
    DrizzleModule.forRoot({
      drizzle,
      connection: process.env.DATABASE_URL!,
    }),
  ],
})
export class AppModule {}

Die Option drizzle erhält die drizzle()-Funktion des gewünschten Treibers: hier node-postgres, aber MySQL, SQLite, Neon, Turso und D1 laufen über dieselbe Option. Die Datenbank ist global, einen forFeature()-Schritt gibt es also nicht. Ein Service fordert sie einfach an:

TypeScript
@Injectable()
export class UsersService {
  constructor(@InjectDrizzle() private readonly db: NodePgDatabase) {}

  findOne(id: number) {
    return this.db.select().from(users).where(eq(users.id, id));
  }
}

Einige Details zeigen, dass hier Leute am Werk waren, die sich schon einmal die Finger verbrannt haben:

  • forRootAsync() funktioniert mit ConfigService. Das ist wichtig, weil die Optionen von forRoot() beim Import ausgewertet werden, womöglich bevor die Env-Datei geladen ist.
  • Mehrere Datenbanken sind einfach benannte Imports, injiziert mit @InjectDrizzle('analytics').
  • Zum Testen genügt ein eigener Provider auf getDrizzleToken().
  • Die Doku sagt es klar: keine Migrationen beim Start ausführen, wenn mehrere Instanzen gleichzeitig hochfahren, sondern drizzle-kit migrate als eigenen Release-Schritt.

Es zielt auf den Release Candidate von Drizzle v1 und unterstützt auch v0.35 und neuer. Auf npm steht es bei 0.0.2, es wird sich also noch bewegen.

HttpClientModule: fetch, plus alles, was man sonst immer selbst schreibt

@nestjs/axios kapselt Axios und liefert RxJS-Observables, also ein firstValueFrom() um fast jeden Aufruf. @nestjs/http-client baut stattdessen auf dem nativen fetch von Node auf, hat keine Fremdabhängigkeiten und liefert Promises.

TypeScript
@Module({
  imports: [
    HttpClientModule.register({
      name: 'github',
      baseUrl: 'https://api.github.com',
      timeout: '5s',
      retry: 3,
    }),
  ],
})
export class ReposModule {}

@Injectable()
export class ReposService {
  constructor(@InjectHttpClient('github') private readonly github: HttpClient) {}

  async find(owner: string, repo: string) {
    const { data } = await this.github.get<Repo>('/repos/:owner/:repo', {
      params: { owner, repo },
    });
    return data;
  }
}

Mir gefällt, dass die Dinge, die jedes Projekt neu implementiert, jetzt Optionen sind: Timeouts pro Versuch als Dauer-Strings, Retries mit Backoff, :name-Pfadparameter, ein benannter Client pro Upstream-API und Interceptors als einfache Funktionen oder als Klassen. Fehler sind typisiert (HttpResponseError, HttpTimeoutError, HttpNetworkError und HttpParseError, alle abgeleitet von HttpClientError), und toHttpException() bildet sie auf Nest-Exceptions ab: Ein Upstream-Fehler wird zu 502, ein Timeout zu 504. Genau diese Abbildung würde ich sonst in jedem Gateway-Service von Hand schreiben.

@nestjs/axios bleibt bestehen; die Doku liefert eine Migrationstabelle, keinen Deprecation-Hinweis.

platform-node: kommt im nächsten Minor-Release, und darauf freue ich mich am meisten

Nest hat zwei HTTP-Adapter. Express ist der Standard und der langsamere; Fastify ist schnell, aber der Umstieg bedeutet, Middleware im Express-Stil und @Res()-Code auf Fastifys eigene API umzuschreiben. Am 9. Oktober hat Kamil Myśliwiec einen Pull Request für einen dritten eröffnet: @nestjs/platform-node, der direkt auf node:http aufsetzt. Drei Tage später kündigte der offizielle NestJS-Account ihn für das nächste Minor-Release an, mit der Frage, was Nest wäre, wenn es „einfach Nest“ wäre.

Nest-Kern

platform-express

Express

node:http

platform-fastify

Fastify

platform-node

TypeScript
const app = await NestFactory.create(AppModule, new NodeAdapter());

Requests und Responses sind Unterklassen von Nodes eigenen IncomingMessage und ServerResponse und bringen die Express-artigen Helfer mit, die Middleware tatsächlich aufruft. Laut PR verhielten sich helmet, compression, express-session, passport und weitere (insgesamt 21 verbreitete Middleware-Pakete) genauso wie auf dem Express-Adapter. Das Body-Parsing ist eingebaut und weist Prototype Poisoning ab, so wie Fastify.

Der Benchmark im PR ist das Highlight. Eine Runde wrk auf einem M1 Pro mit Node 24, in Requests pro Sekunde:

GET / GET /users/:id POST JSON
Nest + Express 37.1k 34.5k 28.2k
Nest + Fastify 52.4k 48.4k 40.2k
Nest + Node 55.1k 51.0k 42.4k

Rund 50 % schneller als Express und knapp vor Fastify, ohne das Programmiermodell von Express zu verlassen. An einigen Stellen weicht er allerdings von Express ab, was man vor dem Umstieg wissen sollte: Routen werden nach Spezifität statt nach Deklarationsreihenfolge gematcht, Pfade unterscheiden Groß- und Kleinschreibung, und von Handlern zurückgegebene Strings gehen als text/plain raus.

Während ich das schreibe, ist er noch nicht auf npm; der Pull Request ist noch offen. Sobald das nächste Minor-Release erscheint, ist der Wechsel die eine Zeile oben.

Was das für NestJS bedeutet

Zusammengenommen kann eine neue Nest-App Persistenz, ausgehende HTTP-Aufrufe und bald auch ihren eigenen HTTP-Server allein mit offiziellen Paketen abdecken, auf ESM, validiert mit der Schema-Bibliothek, die man ohnehin schon nutzt. Das Framework schluckt den Glue-Code, den ich von Projekt zu Projekt kopiert habe, und das ist die beste Art von Release.

Quellen