Migration

7 min

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

Bibliothèques OIP mises à jour :

@fasstech/oip-core v2.23.4

@fasstech/oip-tools v2.4.5

Rappel des évolutions :

La version minimum requise de Node JS des bibliothèques OIP @fasstech/oip-core et @fasstech/oip-tools passe de la version 20 à la version 22 ;

Par ailleurs, ces bibliothèques sont compatibles avec Node JS v24 (version LTS actuelle).

Par conséquent, une version minimum de Node JS v22 est requise au niveau du projet pour mettre à jour @fasstech/oip-core et @fasstech/oip-tools (mais la mise à niveau vers Node JS v24 LTS est optionnelle).

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 potentiels 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": "2.23.4"
  },
  "devDependencies": {
    "@fasstech/oip-tools": "2.4.5"
  },
  "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 v2.4.2 et v2.4.4.

La version 2.4.5 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 v2.4.2 à v2.4.4, 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 NPM_TOKEN=$(cat /path/to/.npmrc | grep -oP '//registry.npmjs.org/:_authToken=\K.*') -t fasstech/oav-v2: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.