NestJS 12

Construire une API de billetterie, de la première ligne à la production

L'architecture que NestJS impose, et pourquoi elle tient

NestJS ne laisse pas choisir sa structure. Modules, providers, décorateurs, chaîne de traitement : c'est ce qu'on lui reproche au premier projet, et ce qu'on lui doit au troisième, quand le code a doublé et reste lisible.

À quoi sert ce livre. Expliquer cette architecture assez précisément pour s'en servir, et non la subir. Ce que fait le conteneur d'injection quand il résout un token. Pourquoi une garde n'est pas un middleware. Où un pipe s'exécute par rapport au contrôleur. Ce que la sérialisation de sortie empêche de fuir. Et comment une seconde façade — GraphQL — se pose sur des services métier écrits pour REST, sans réécrire une ligne de domaine.

Ce que vous saurez faire après lecture

• Découper un backend par domaine : modules, providers, tokens, scopes, configuration validée au démarrage
• Traverser la chaîne de traitement complète d'une requête — middleware, garde, intercepteur, pipe, contrôleur, filtre — dans son ordre réel, mesuré et non supposé
• Valider ce qui entre avec des DTO, et sérialiser ce qui sort pour qu'un hachage de mot de passe ne quitte jamais le serveur
• Normaliser les erreurs sur une forme unique, traduire les codes Prisma, et ne rien dire à l'appelant qu'il ne doive savoir
• Modéliser des données avec Prisma 7 : schéma, migrations, client typé, relations, et le N+1 provoqué puis supprimé
• Authentifier par tokens d'accès et de rafraîchissement, avec rôles et propriété des ressources
• Écrire une transaction qui refuse de vendre deux fois la même place, sur-réservation reproduite avant d'être corrigée
• Rendre un paiement idempotent : clé d'idempotence, webhook signé, rejeu sans effet, machine à états
• Sortir le travail lourd de la requête : files BullMQ, réessais, file morte, e-mails, tâches différées, temps réel en SSE
• Tester en unitaire et de bout en bout avec Vitest, sur une base jetable en conteneur
• Publier un contrat OpenAPI engendré depuis vos DTO, puis une façade GraphQL avec DataLoader branchée sur les mêmes services
• Livrer : image multi-étapes, migrations au déploiement, sondes de santé, logs structurés, limitation de débit, chaîne GitHub Actions

Le livre enseigne NestJS 12 tel que sa CLI le produit en 2026 : projet en modules ECMAScript, avec les imports suffixés en .js qui déroutent tout le monde, Vitest comme lanceur de tests et non Jest, oxlint comme linter. Vous apprenez l'état de l'art, pas la configuration de la version précédente.

Chaque chapitre se ferme sur une section « Les pièges » : les erreurs que fait un débutant sur ce sujet précis, et ce qu'elles coûtent au chapitre suivant.

Pour qui

Aucune connaissance de TypeScript, de Node, de SQL ou de Docker n'est supposée : les quatre premiers chapitres les posent, puis le livre ne les quitte plus. Prérequis : un ordinateur et de la patience.

Écrit sur NestJS 12.0.1, Prisma 7.10.0 et TypeScript 6.0.3.

Ce que contient le livre

• 28 chapitres répartis sur 293 pages, soit environ 54 391 mots.
• 16 diagrammes pour les schémas d’architecture et les flux.
• Trois formats livrés : PDF pour la lecture à l’écran, EPUB et Kindle pour la liseuse.