---
title: Migration
slug: oip-next/releases-v2-q2-migration
createdAt: 2026-10-05T13:04:46.647Z
---

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 :

```json
{
  "dependencies": {
    "@fasstech/oip-core": "2.23.4"
  },
  "devDependencies": {
    "@fasstech/oip-tools": "2.4.5"
  },
  "engines": {
    "node": ">=24"
  }
}
```

Puis installer les mises à jour :

```shell
npm i
```

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

:::BlockQuote
\[!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](https://github.com/fasst/oip-migration-doc/blob/main/v2/2.2026.Q2/scripts/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) :

```shell
node 00-migrate-mutation-hooks.mjs
```

# Mise à jour du Dockerfile

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

```dockerfile
# 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 :

```shell
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.
