Migration

5 min

Services OIP mis à jour :

fasstech/oip-headless v1.0.0

Bibliothèques OIP mises à jour :

@fasstech@oip-core v4.0.0

@fasstech/oip-tools v4.0.0

fasstech/oip-starter-utils v4.0.0

Cette nouvelle release de la stack OIP induit également une mise à niveau de la dépendance partagée vite JS v7 à v8 et demande quelques ajustements au niveau de votre configuration.

Mise à jour des dépendances

{
  "dependencies": {
    "@fasstech/oip-core": "4.0.0",
    "@fasstech/oip-starter-utils": "4.0.0"
  },
  "devDependencies": {
    "@fasstech/oip-tools": "4.0.0",
    "@vitejs/plugin-react": "6.0.1", // ajout
    "vite": "8.0.5",
    "vitest": "4.1.2"
  }
}

Dépendances à supprimer

@vitejs/plugin-react-swc

Configuration de vite JS

Changements minimaux requis au niveau de votre fichier de configuration vite :

// before
import react from '@vitejs/plugin-react-swc';

// after
import react from '@vitejs/plugin-react';

Selon votre configuration, d'autres changements potentiels sont à appliquer suite à la montée de version de vite JS. Pour connaitre la liste détaillée des changements, veuillez vous référer au guide de migration officiel v7 to v8 de la dépendance.

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

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

avant la v4.0.0, le nom d'un fichier hook d'une mutation graphQL était 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 sera 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

Fichiers docker-compose.yml et les environnements Portainer (dev, recette, prod, etc.)

Mettre à jour le tag de l'image du service oip-headless-api en v1.0.0 :

services:
  oip-headless-api:
    image: fasstech/fasstech/oip-headless:1.0.0
    # ...