---
title: Migration
slug: oip-next/releases-v3-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 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 :

```json
{
  "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 :

```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 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](https://github.com/fasst/oip-migration-doc/blob/main/v3/3.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 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.
