À propos de ce cours
Objectifs de la leçon
- Organiser Angular et NestJS dans un monorepo avec les workspaces npm.
- Créer un paquet d'interfaces partagées entre les deux applications.
- Utiliser import type et comprendre ses limites.
- Situer Nx et les outils de monorepo plus complets.
Pourquoi un monorepo ?
Avec deux dépôts séparés, chaque modification du contrat (une propriété ajoutée, renommée) doit être faite deux fois, en espérant ne rien oublier. Dans un monorepo, client et API sont dans le même dépôt : une seule branche, un seul commit pour une fonctionnalité complète (route NestJS + écran Angular), et surtout des types partagés.
Deux applications et un paquet partagé, installés en une fois.
Les workspaces npm
Le champ workspaces du package.json racine (leçon 18.1) déclare les sous-projets. npm install à la racine installe les dépendances de tous dans un seul node_modules, et crée un lien pour chaque paquet local : node_modules/@formation/partage pointe vers packages/partage.
npm install # à la racine : tout le monorepo
npm install bcrypt -w api # une dépendance pour l'API seulement
npm run build -w web # lancer le script « build » d'Angular
npm run dev # script de la racine (concurrently)
Le paquet partagé
📄 packages/partage/package.json
{
"name": "@formation/partage",
"version": "1.0.0",
"private": true,
"description": "Interfaces TypeScript partagées entre l'API NestJS et l'application Angular",
"types": "./src/index.ts",
"exports": {
".": { "types": "./src/index.ts" }
}
}
📄 packages/partage/src/index.ts
// Contrat entre l'API et le client : uniquement des TYPES (aucun code exécuté).
// Importez-les avec « import type » : ils disparaissent à la compilation.
export type Niveau = 'debutant' | 'intermediaire' | 'avance';
export interface Formation {
id: number;
intitule: string;
description: string;
niveau: Niveau;
dureeHeures: number;
places: number;
}
export type CreerFormation = Omit<Formation, 'id'>;
export type ModifierFormation = Partial<CreerFormation>;
export interface Page<T> {
donnees: T[];
total: number;
}
export type Role = 'admin' | 'formateur' | 'stagiaire';
export interface Utilisateur {
id: number;
email: string;
nom: string;
role: Role;
}
export interface Connexion {
email: string;
motDePasse: string;
}
export interface ReponseConnexion {
access_token: string;
expires_in: number;
utilisateur: Utilisateur;
}
export interface ErreurApi {
statusCode: number;
message: string | string[];
error?: string;
}
Le paquet ne contient que des types: il n'a pas besoin d'être compilé. Le champ types (et la condition types de exports) indique directement le fichier source à TypeScript. Pour qu'il soit utilisable, ajoutez-le aux dépendances de chaque application ("@formation/partage": "*") ou, plus simplement, laissez npm le relier au premier npm install à la racine.
Utilisation des deux côtés
📄 apps/api/src/formations/formation.dto.ts
import { PartialType } from '@nestjs/mapped-types';
import { Type } from 'class-transformer';
import { IsIn, IsInt, IsOptional, IsString, Length, Max, Min } from 'class-validator';
import type { CreerFormation, Niveau } from '@formation/partage';
// Une VALEUR utilisée à l'exécution : elle reste dans l'API (le paquet partagé ne contient que des types)
export const NIVEAUX = ['debutant', 'intermediaire', 'avance'] as const satisfies readonly Niveau[];
// « implements CreerFormation » : si l'interface partagée change, ce DTO ne compile plus
export class CreerFormationDto implements CreerFormation {
@IsString() @Length(3, 80) intitule: string;
@IsString() @Length(10, 500) description: string;
@IsIn(NIVEAUX) niveau: Niveau;
@IsInt() @Min(1) @Max(1000) dureeHeures: number;
@IsInt() @Min(1) @Max(40) places: number;
}
export class ModifierFormationDto extends PartialType(CreerFormationDto) {}
export class FiltreFormationsDto {
@IsOptional() @IsString() q?: string;
@IsOptional() @IsIn(NIVEAUX) niveau?: Niveau;
}
import type: l'import disparaît à la compilation. NestJS (CommonJS) ne chargera jamais@formation/partageà l'exécution.implements CreerFormation: le DTO (classe avec décorateurs de validation) doit avoir exactement les propriétés du contrat.NIVEAUXest une valeur utilisée à l'exécution par@IsIn: elle reste dans l'API ;satisfiesvérifie qu'elle correspond au type partagéNiveau.
Côté Angular, les services et composants des leçons 18.3 et 18.4 importent les mêmes types : import type { Formation, Page } from '@formation/partage';
L'intérêt, démontré
Renommons places en placesMax dans l'interface partagée, sans toucher aux applications :
Résultat réellement obtenu :
$ npm run build (racine du monorepo)
> build
> npm run build -w api && npm run build -w web
> api@0.0.1 build
> nest build
> web@0.0.0 build
> ng build
❯ Building...
✔ Building...
Application bundle generation complete. [3.404 seconds] - 2026-11-15T15:33:13.482Z
Output location: apps/web/dist/web
$ npm run build (après avoir renommé places en placesMax dans packages/partage)
src/formations/formation.dto.ts:10:14 - error TS2420: Class 'CreerFormationDto' incorrectly implements interface 'CreerFormation'.
src/formations/formations.service.ts:9:161 - error TS2353: Object literal may only specify known properties, and 'places' does not exist in type 'Formation'.
src/formations/formations.service.ts:10:157 - error TS2353: Object literal may only specify known properties, and 'places' does not exist in type 'Formation'.
src/formations/formations.service.ts:11:156 - error TS2353: Object literal may only specify known properties, and 'places' does not exist in type 'Formation'.
src/formations/formations.service.ts:12:152 - error TS2353: Object literal may only specify known properties, and 'places' does not exist in type 'Formation'.
src/formations/formations.service.ts:31:26 - error TS2345: Argument of type '{ intitule: string; description: string; niveau: Niveau; dureeHeures: number; places: number; id: number; }' is not assignable to parameter of type 'Formation'.
src/formations/formations.service.ts:32:5 - error TS2741: Property 'placesMax' is missing in type '{ intitule: string; description: string; niveau: Niveau; dureeHeures: number; places: number; id: number; }' but required in type 'Formation'.
Found 7 error(s).
…
✘ [ERROR] TS2339: Property 'places' does not exist on type 'Formation'. [plugin angular-compiler]
apps/web/src/app/formations/liste.ts:38:48:
✘ [ERROR] TS2339: Property 'places' does not exist on type 'Formation'. [plugin angular-compiler]
apps/web/src/app/formations/detail.ts:15:100:
✘ [ERROR] TS2345: Argument of type '{ intitule: string; description: string; niveau: "debutant" | "intermediaire" | "avance"; dureeHeures: number; places: number; }' is not assignable to parameter of type 'CreerFormation'.
apps/web/src/app/formations/formulaire.ts:50:23:
packages/partage/src/index.ts:12:2:
Les deux applications refusent de compiler et indiquent chaque endroit à corriger : le DTO qui n'implémente plus le contrat, les données d'exemple du service, les templates Angular et le formulaire. Sans types partagés, les deux compilations auraient réussi et l'erreur ne serait apparue qu'à l'exécution, dans le navigateur d'un utilisateur.
Le piège : une valeur dans le paquet de types
Tentation naturelle : mettre aussi la constante NIVEAUX dans le paquet partagé et l'importer dans l'API.
Résultat réellement obtenu :
$ npm run build -w api && node apps/api/dist/main.js (NIVEAUX, une valeur, importée du paquet partagé)
Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in node_modules/@formation/partage/package.json
code: 'ERR_PACKAGE_PATH_NOT_EXPORTED'
La compilation passe (TypeScript trouve les types), mais Node.js, à l'exécution, doit vraiment charger le paquet. Or celui-ci n'exporte que des types et ne contient que du TypeScript non compilé : l'API ne démarre pas. Deux solutions : garder le paquet strictement « types seulement » (choix de ce chapitre), ou en faire un vrai paquet compilé (tsc vers un dossier dist, champs main/exports pointant dessus, compilation avant les deux applications).
Aller plus loin : Nx
Nx est un outil de monorepo très utilisé avec Angular et NestJS (npx create-nx-workspace, puis les extensions @nx/angular et @nx/nest). Il ajoute aux workspaces : des générateurs (applications, bibliothèques partagées compilées), un graphe des dépendances entre projets, le cache des compilations et des tests, et l'exécution des seules tâches touchées par une modification (nx affected). Il est précieux pour de grands dépôts ; pour deux applications et un paquet de types, les workspaces npm suffisent et n'ajoutent aucun outil à apprendre.
Activités
Activité 1 Ajouter un type
Ajoutez au paquet partagé une interface Inscription (id, formationId, email, creeLe) et le type CreerInscription. Utilisez-les dans un DTO NestJS (implements) et dans un service Angular. Comment vérifier que le contrat est respecté des deux côtés ?
Voir le corrigé
export type CreerInscription = Pick<Inscription, 'formationId' | 'email'>;. Vérification : npm run build à la racine compile les deux applications ; une différence entre le DTO et l'interface, ou une propriété mal utilisée dans Angular, fait échouer la compilation.
Activité 2 Erreur d'import
Dans Angular, un étudiant écrit import { Formation } from '@formation/partage'; (sans type) et cela fonctionne. Dans NestJS, la même ligne fonctionne aussi. Pourquoi, alors que la leçon recommande import type?
Voir le corrigé
Les deux compilateurs suppriment les imports qui ne servent qu'à des types, même sans le mot type. Mais rien ne le garantit à la lecture du code : le jour où l'on importe une valeur par erreur, l'API plante au démarrage (démonstration de la leçon). import type rend l'intention explicite, et TypeScript refuse alors d'utiliser l'élément importé comme une valeur. Avec isolatedModules (activé dans les deux projets), il est même exigé dans certains cas (chapitre 15).
Activité 3 Un script de vérification
Ajoutez à la racine un script verifier qui compile les deux applications et lance les tests unitaires de l'API. Pourquoi l'exécuter avant chaque push, et comment l'automatiser ?
Voir le corrigé
"scripts": {
"verifier": "npm run build -w api && npm run build -w web && npm test -w api"
}
Une modification d'un côté peut casser l'autre : seule une vérification globale le détecte. On l'automatise avec un hook Git (husky, pre-push) ou, mieux, dans l'intégration continue (GitHub Actions) à chaque push.
Activité 4 Types générés ou écrits ?
Comparez deux façons de partager le contrat : (a) le paquet d'interfaces écrit à la main de cette leçon ; (b) les types générés à partir de Swagger avec openapi-typescript (leçon 14.3). Donnez un avantage de chacune.
Voir le corrigé
(a) Simple, lisible, immédiat dans un monorepo ; les DTO l'implémentent, donc l'API ne peut pas s'en écarter sans erreur de compilation. (b) Fonctionne même avec des dépôts séparés ou une équipe front externe, et décrit exactement ce que l'API expose (routes, paramètres, erreurs), à condition que la documentation Swagger soit complète et régénérée à chaque modification.
À retenir
- Monorepo : client et API dans un dépôt ; workspaces npm : une installation, des liens vers les paquets locaux.
- npm install -w <projet>, npm run <script> -w <projet> ; scripts communs à la racine.
- Paquet partagé de types seulement : import type des deux côtés ; DTO NestJS « implements » les interfaces.
- Changer le contrat fait échouer la compilation des deux applications : les erreurs sont trouvées avant l'exécution.
- Une valeur importée d'un paquet de types fait planter l'API ; Nx pour les grands monorepos.
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !