Release Note
13 min
- Type : mineure
- Services concernés : OIP Headless
- Bibliothèques concernées : OIP Core, OIP Starter Utils, OIP Tools
- Action attendue : migration mineure
- Breaking change : oui
- Impact : moyen
- Recommandation : recommandée
Résumé
La release OIP v4.2026.Q3 enrichit OIP Starter Utils et OIP Tools avec plusieurs nouvelles fonctionnalités :
- synchronisation des connexions clientes en temps réel via WebSocket — cf. doc ;
- support de la navigation via les boutons du navigateur — cf. doc ;
- configuration d'un chemin de base (basePath) pour les URLs du serveur — cf. doc ;
- résolution de métadonnées de session lors du décrochage — cf. doc ;
- enrichissement de l'objet Process dans le contexte GraphQL via process.extendWith — cf. doc ;
- prise en charge des règles de validation des propriétés dans la génération des entités (entities generate --oas-config).
Elle introduit également des points de migration à prendre en compte : renommage d'un endpoint de configuration, changement du schéma des sessions en base de données et évolution des headers HTTP. Consulter le guide de migration pour le détail des actions à appliquer.
Actions rapides
- Mettre à jour les dépendances OIP sur les projets actifs.
- Remplacer /graphqlwsurl par /ws-config dans la configuration Vite (proxy local dev) — action requise pour le bon fonctionnement en développement local.
- Vérifier la gestion des headers X-Fasst-Project-ID et X-Fasst-Client-ID si une logique personnalisée les consomme, ou si l'option corsOptions.allowedHeaders est configurée.
- Purger les sessions utilisateur en base de données lors de la mise à jour pour éviter des erreurs d'authentification.
- Mettre à jour le tag de l'image Docker oip-headless en 1.1.1.
Par bibliothèque
OIP Starter Utils v4.1.0
- Changement : synchronisation des connexions clientes via WebSocket. En savoir plus.
- Impact : moyen. Cette fonctionnalité améliore la cohérence de l'état applicatif entre clients connectés simultanément.
- Action : mise à jour simple. Consulter la documentation pour activer et configurer la synchronisation.
- Changement : le composant Router supporte désormais la navigation via les boutons du navigateur (précédent/suivant). En savoir plus.
- Impact : faible. Amélioration de l'expérience utilisateur sans impact sur les projets existants.
- Action : rien.
- Changement : ajout de l'option basePath permettant de préfixer toutes les URLs exposées par le serveur. En savoir plus.
- Impact : faible. Fonctionnalité additive sans effet sur les projets qui n'en ont pas l'usage.
- Action : mise à jour simple. Configurer l'option si un préfixe d'URL est requis dans le contexte de déploiement.
- Changement : ajout de la fonction de rappel session.resolveMetadata permettant de résoudre des métadonnées de session lors du décrochage. En savoir plus.
- Impact : faible. Fonctionnalité additive destinée aux projets ayant des besoins de contextualisation des sessions.
- Action : mise à jour simple. Implémenter la fonction de rappel uniquement si le besoin est identifié.
- Changement : appel à la fonction de rappel process.extendWith pour enrichir l'objet Process lors de la résolution du contexte GraphQL. En savoir plus.
- Impact : faible. Fonctionnalité additive pour les projets qui ont besoin d'enrichir le contexte de résolution GraphQL.
- Action : mise à jour simple. Implémenter la fonction de rappel uniquement si le besoin est identifié.
- Changement : le header HTTP fasst-oip-project-id est renommé X-Fasst-Project-ID ; un nouveau header X-Fasst-Client-ID est introduit. L'ancien header reste actif pour compatibilité ascendante.
- Impact : moyen. Toute logique personnalisée consommant directement ces headers, ou utilisant l'option corsOptions.allowedHeaders, doit être adaptée pour éviter des erreurs de type UNAUTHORIZED.
- Action : migration. Vérifier les usages des headers et ajouter X-Fasst-Project-ID et X-Fasst-Client-ID à corsOptions.allowedHeaders si cette option est configurée.
- Changement : l'endpoint GET /graphqlwsurl est remplacé par GET /ws-config.
- Impact : moyen. La configuration Vite du proxy local dev doit être mise à jour.
- Action : migration. Remplacer l'entrée /graphqlwsurl par /ws-config dans la propriété server.proxy du fichier de configuration Vite.
- Changement : changement du schéma de l'objet session en base de données.
- Impact : moyen. Des sessions existantes avant la mise à jour peuvent provoquer des erreurs de type UNAUTHORIZED.
- Action : migration. Purger les sessions utilisateur en base de données avant ou lors de la mise à jour.
- Changement : destruction automatique des processus enfants lorsqu'une tâche se termine.
- Impact : faible. Amélioration de la gestion des ressources sans changement fonctionnel visible.
- Action : rien.
- Changement : correction des messages d'erreur lors de la résolution du contexte GraphQL ; mise à jour de la requête access token vers le format URL-encoded.
- Impact : faible. Amélioration de la stabilité et du débogage.
- Action : rien.
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité sans impact fonctionnel.
- Action : rien.
OIP Tools v4.1.0
- Changement : la commande entities generate --oas-config prend désormais en charge les règles de validation des propriétés définies dans le fichier OpenAPI.
- Impact : moyen. Les projets utilisant cette commande bénéficieront d'une génération plus complète et fidèle au contrat OpenAPI.
- Action : mise à jour simple. Vérifier les fichiers générés et valider les règles de validation extraites.
- Changement : correction de la validation du schéma lors de la génération des entités.
- Impact : faible. Correction d'un comportement incorrect sans impact sur les projets ne rencontrant pas ce cas.
- Action : rien.
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité sans impact fonctionnel.
- Action : rien.
OIP Core v4.1.0
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité sans impact fonctionnel.
- Action : mettre à jour la version de la bibliothèque.
OIP Headless v1.1.0
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité sans impact fonctionnel.
- Action : mettre à jour le tag de l'image Docker.