Migration

7 min

Documentation détaillée des changements requis au niveau de la code-base d'un projet v3.

Bibliothèques OIP mises à jour :

@fasstech/oip-core v3.20.3

@fasstech/oip-starter-utils v3.7.3

@fasstech/oip-tools v3.5.4

@fasstech/oip-transition-manager v1.0.2

En plus des opérations de maintenance cette release garantie la compatibilité des bibliothèques OIP dans un environnement Node JS v24. La version minimale requise de Node JS est inchangée : v22.

Les chapitres suivants indiquent les changements requis pour la mise à jour de votre projet avec une mise à niveau de Node JS en version 24.

AVERTISSEMENT : Une mise à niveau de la version de Node JS peut introduire des breaking-changes éventuels liés à des dépendances spécifiques du projet (hors dépendances OIP). Ces breaking-changes éventuels ne sont pas converts par cette documentation.

Mise à jour des dépendances

Mettre à jour les versions des dépendances suivantes dans le fichier package.json du projet ainsi que la version minimale de Node JS :

{
  "dependencies": {
    "@fasstech/oip-core": "3.20.3",
    "@fasstech/oip-starter-utils": "3.7.3",
    "@fasstech/oip-transition-manager": "1.0.2"
  },
  "devDependencies": {
    "@fasstech/oip-tools": "3.5.4"
  },
  "engines": {
    "node": ">=24"
  }
}

Puis installer les mises à jour :

npm i

Migration du nom des fichiers générés des hooks des mutations GQL

[!IMPORTANT] Ne concerne uniquement les projets qui utilisent (avant MAJ) une version de @fasstech/oip-tools comprise entre v3.3.3 et v3.5.3.

La version 3.5.4 de la dépendance @fasstech/oip-tools embarque un correctif pour la commande views build qui impacte les hooks générés des mutations graphQL des vues :

de v3.3.3 à v3.5.3, le nom d'un fichier hook d'une mutation graphQL est généré de la manière suivante : use[HookName]MutationQuery.js

après la mise à jour, le nom d'un fichier de ce type est généré de la manière suivante : use[HookName]Mutation.js (suppression du suffixe Query)

Vous pouvez utiliser le script 00-migrate-mutation-hooks.mjs pour migrer les fichiers impactés de vos vues (renommage des fichiers et mise à jour des imports).

Téléchargez le script, le placer à la racine de votre projet et exécutez le (mode DRY RUN par défaut, passer --apply pour appliquer les changements détectés) :

node 00-migrate-mutation-hooks.mjs

Mise à jour du Dockerfile

Mettre à jour la version de l'image de base dans le fichier Dockerfile, exemple :

# before
FROM node:20-alpine AS base

# after
FROM node:24-alpine AS base

Build de l'image

Tester le build de l'image de l'OAV avec la commande suivante :

docker buildx build --build-arg BUILD_DATE=2026-03-19 --secret id=npmrc,src=/path/to/.npmrc -t fasstech/oav-v3:latest --no-cache .

Pipeline CI

Vérifier et mettre à jour également la version de Node dans les fichiers de configuration CI (github actions, drone, etc) si nécessaire.