Configuration des applications TypeScript : outils et…

Configuration des applications TypeScript : aperçu des outils et bibliothèques

Une application TypeScript moderne fonctionne rarement en isolation. Elle doit savoir à quelle base de données se connecter, quel port utiliser, où se trouvent les API tierces et comment se comporter dans différents environnements (development, staging, production). Une configuration judicieuse n'est pas simplement un stockage de paramètres, mais une véritable discipline incluant la validation, le typage et la sécurité.

Dans cet article, nous allons examiner les outils et bibliothèques clés pour la gestion de la configuration dans les projets TypeScript, des solutions simples aux standards industriels.

Pourquoi une configuration dédiée est-elle nécessaire ?

Il existe plusieurs approches pour stocker les paramètres, chacune avec ses inconvénients :

Codage en dur dans les sources — viole le principe de l'application 12-factor, la configuration se mélange au code, impossible de modifier le comportement sans recompilation.
Variables d'environnement (process.env) — méthode standard, mais toutes les valeurs sont des chaînes, pas de validation, facile de faire une faute de frappe.
Fichiers JSON/YAML — pratiques, mais doivent être versionnés avec précaution pour ne pas exposer les secrets dans le dépôt.

TypeScript ajoute une couche supplémentaire : nous voulons que la configuration soit strictement typée et que les erreurs soient détectées à la compilation, et non à l'exécution.

Bibliothèques pour travailler avec les variables d'environnement

dotenv

La bibliothèque la plus populaire pour charger les variables depuis les fichiers .env. Dans les projets TypeScript, elle est presque toujours utilisée.

// npm install dotenv @types/dotenvimport dotenv from 'dotenv';

dotenv.config(); // charge .env dans process.env

console.log(process.env.PORT); // '3000' — chaîne de caractères

Caractéristiques :

Fonctionne avec tous les frameworks (Express, NestJS, Next.js).
Prend en charge plusieurs fichiers (.env.local, .env.production).
N'effectue pas de validation — seulement le chargement.

env-var

Une surcouche de process.env qui ajoute la validation et la conversion de types directement à l'exécution.

// npm install env-varimport env from 'env-var';

export const config = {    PORT: env.get('PORT').required().asPortNumber(),    DB_HOST: env.get('DB_HOST').required().asString(),    DEBUG: env.get('DEBUG').default('false').asBool(),    API_KEYS: env.get('API_KEYS').asArray()};

Avantages : API simple, convertisseurs intégrés (nombre, port, booléen, tableau).
Inconvénients : pas d'intégration avec TypeScript au niveau des types — le résultat est toujours string | number | boolean.

Solutions industrielles : convict et node-config

Convict

Bibliothèque pour décrire un schéma de configuration avec validation, valeurs par défaut et prise en charge de différentes sources (fichiers, env, arguments de ligne de commande).

// npm install convict @types/convictimport convict from 'convict';

const config = convict({    env: {        format: ['production', 'development', 'test'],        default: 'development',        env: 'NODE_ENV'    },    server: {        port: {            format: 'port',            default: 3000,            env: 'PORT'        }    },    db: {        host: {            format: String,            default: 'localhost',            env: 'DB_HOST'        }    }});

config.validate({ allowed: 'strict' }); // lèvera une erreur en cas de données invalides

export default config;

Caractéristiques de convict :