package.json et scripts npm

Objectifs

À la fin de cette leçon, vous saurez :

• lire et écrire un package.json complet ;
• créer des scripts npm pour vos commandes récurrentes ;
• installer, désinstaller, mettre à jour proprement.

Anatomie du manifeste

npm init -y

{
  "name": "todo-api",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "node serveur.js",
    "dev": "node --watch serveur.js"
  },
  "dependencies": {},
  "devDependencies": {}
}

Champ type: "module" : active la syntaxe import/export dans tout le projet (sinon CommonJS require). Vous l'utilisez depuis le début de vos projets modernes.

Les scripts : vos raccourcis nommés

"scripts": {
  "start": "node serveur.js",
  "dev": "node --watch serveur.js",
  "test": "node --test",
  "db:init": "node scripts/init-db.js"
}

npm run dev        # lance n'importe quel script
npm start          # raccourci réservé à start/test/stop/restart

Ce que ça change : plus besoin de retenir les commandes exactes (node --watch --env-file=.env src/serveur.js) — un nom stable suffit. Et votre plateforme Devmind fait exactement cela : npm run db:migrate, npm run dev:api sont des scripts du workspace racine.

Installer / retirer

npm install pg              # ajoute aux dependencies
npm install -D jest         # ajoute aux devDependencies (-D)
npm uninstall express       # retire proprement des deux fichiers
npm update                  # met à jour dans les plages autorisées

install <pkg> écrit automatiquement dans package.json : jamais d'édition manuelle des versions.

Le réflexe avant d'ajouter une dépendance

Une dépendance est un engagement : code à maintenir par autrui, surface d'attaque, poids d'installation. Trois questions avant chaque install :

1. Ne puis-je l'écrire en 20 lignes moi-même ? (souvent oui pour les petits utilitaires)
2. Est-elle maintenue ? (dernière version, téléchargements hebdo, issues actives)
3. Combien de dépendances ELLE entraîne ? (voir chapitre suivant)

Exercice

1. Ajoutez à votre projet : dev, start, init-db, test.
2. Installez un vrai outil de test en devDependency.
3. Vérifiez avec npm run la liste des scripts disponibles.
4. Pourquoi npm start sans « run » mais pas npm dev ?

Résumé

• package.json = identité + scripts + dépendances ; type module pour import/export.
• Scripts nommés = interface stable sur des commandes mouvantes.
• Chaque dépendance est un engagement : questionner avant d'installer.