Paquets supportés

Le fichier supported.json, les versions tierces que LRVO garantit, et comment lrvo-doctor et lrvo-update s'en servent.

supported.json est livré à la racine du package @lrvo/core. Il déclare les versions de paquets tiers avec lesquelles la version installée du core est garantie de fonctionner.

Il se lit depuis node_modules/@lrvo/core/supported.json.

Pourquoi un fichier séparé des `peerDependencies`

Une peerDependency ne sait exprimer qu'une contrainte d'installation, et npm la traite comme un échec dur. Le besoin est plus nuancé.

Information	Champ	Usage
En dessous, LRVO n'est pas supporté	`floor`	`lrvo-doctor` sort un constat bloquant.
Jusqu'où monter sans quitter le supporté	`range`	`lrvo-update --deps` ne propose rien au-delà.
La version contre laquelle la release a été validée	`tested`	Cible des recommandations de mise à jour de sécurité.

Trois informations distinctes qu'un simple champ peerDependencies ne porte pas.

Structure

{
  "runtime": {
    "node": { "floor": "20.0.0", "range": ">=20.0.0", "tested": "22.0.0" }
  },
  "packages": {
    "next":  { "floor": "14.0.0", "range": ">=14.0.0 <17.0.0", "tested": "16.3.5" },
    "sharp": { "floor": "0.35.0", "range": ">=0.35.0 <1.0.0", "tested": "0.35.5",
               "requiredBy": ["@lrvo/module-medias"] }
  }
}

Clé	Rôle
`floor`	Plancher supporté.
`range`	Plage dans laquelle une montée est proposée.
`tested`	Version exacte validée pour cette release.
`requiredBy`	Restreint la vérification aux projets où ces modules sont installés.
`note`	Explication affichée avec le constat. Optionnelle.

Ce qui est déclaré

Paquet	Plancher	Raison du plancher
`node`	20.0.0	Imposé par le SDK Resend v6, livré quel que soit le fournisseur de courriel actif.
`next`	14.0.0	App Router et `instrumentation.js`.
`react`	19.0.0	Composants serveur et `use`.
`react-dom`	19.0.0	Aligné sur `react`.
`sharp`	0.35.0	Requis par `@lrvo/module-medias` uniquement.

Comment s'en servir

npx lrvo-doctor          # signale ce qui est sous le plancher ou hors plage
npx lrvo-update --deps   # propose les montées, dans les bornes seulement

Un paquet sous le plancher est bloquant. Un paquet au-dessus de la plage est un avertissement : il fonctionne peut-être, mais la combinaison n'a pas été validée.

Vulnérabilités

lrvo-doctor remonte chaque alerte de npm audit jusqu'au paquet de premier niveau qui la tire. Si ce paquet figure ici et qu'il est sous tested, le remède proposé est npm update <paquet>.

Ce n'est que lorsqu'il est déjà à jour que la piste overrides est évoquée. Un overrides posé alors qu'un correctif amont existe fige une version pour rien et donne une fausse impression de correctif. Voir Sécurité.

Notes

Le fichier est versionné avec le core. Chaque release du core met à jour ses tested, et éventuellement ses floor quand une version minimale change.

Il n'est pas dans package.json#exports. C'est un fichier de données lu par chemin, comme .env.example. Aucune sous-entrée n'est nécessaire.

Un core antérieur à ce fichier reste diagnosticable. Son absence est traitée comme une information, pas comme une panne, et les autres vérifications se poursuivent.