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.