v0.18.0

La version v0.18.0, datée du 16 octobre 2026, introduit le composant de décision TypeSafe Jev et des remédiations complètes de sécurité, concurrence et fiabilité sur le moteur de routage, les composants et l’observabilité. Chaque module de composant et d’observabilité en v0.18.0 exige le cœur v0.18.0.

Composant de Décision Jev

Le nouveau composant Jev (components/jev, jev:decisions) intègre le modèle de décision TypeSafe Jev via l’API OpenRouter Decisions (/api/alpha/decisions). Il fonctionne en mode producteur uniquement et sans dépendance tierce :

  • Le corps de l’échange contient l’état à évaluer.
  • Les questions sont spécifiées via l’option d’URI questions (JSON, avec types de question noul, choice ou score).
  • Les réponses typées sont retournées sous la forme map[string]jev.Answer dans le corps du message sortant.
  • Options supportées : apiKey (repli sur OPENROUTER_API_KEY, masqué dans URI()), model (typesafe/jev-1.13 par défaut), baseURL, timeout et allowHeaderOverride (pour autoriser la surcharge via les en-têtes JevQuestions et JevModel).
  • Les charges utiles et les réponses d’erreur sont limitées en taille pour prévenir les épuisements de mémoire.
import (
    "github.com/tranchida/gocamel"
    jev "github.com/tranchida/gocamel/components/jev"
)

ctx := gocamel.NewCamelContext()
ctx.AddComponent("jev", jev.NewJevComponent())

_, err := ctx.CreateRouteBuilder().
    From("direct:decide").
    To("jev:decisions?questions=[{\"id\":\"approve\",\"type\":\"noul\",\"question\":\"Should this transaction be approved?\"}]").
    ProcessFunc(func(e *gocamel.Exchange) error {
        answers := e.GetIn().GetBody().(map[string]jev.Answer)
        log.Printf("Approved: %v", answers["approve"].Bool)
        return nil
    }).
    Build()

Sécurité & Renforcements

  • Vérification HMAC Deflate WinZip AES : vérification stricte du HMAC-SHA1 et du statut de fin de flux prématuré sur les flux deflate et store (aesDeflateReadCloser et aesStoreReadCloser) dans ZipDataFormat, éliminant le risque de contournement d’authentification sur les archives tronquées.
  • Protection contre les traversées de répertoires : validation par ValidatePath et ValidateRemotePath sur les paramètres move et moveFailed dans file, ftp, sftp et smb. Le consommateur SFTP ignore désormais les liens symboliques lors des parcours récursifs.
  • Protection contre les injections en routage dynamique : suppression de la seconde passe d’interpolation dans RecipientList, RoutingSlip et DynamicRouter, garantissant une résolution saine en une seule passe.
  • Protection des ressources & lectures bornées : remplacement des lectures non bornées dans bodyToBytes, normalizeJSONSource, CSVDataFormat et les producteurs distants (FTPProducer, SFTPProducer, SMBProducer) par ReadLimited borné à DefaultMaxBodySize.
  • Durcissement Simple Language : limitation de la longueur d’entrée pour padstart, padend et l’évaluation regex par MaxSimpleInputBytes, précompilation des regex au niveau du paquet.
  • Masquage des identifiants : ajout de passcode aux clés d’URI sensibles par défaut pour un masquage automatique dans STOMP.

Concurrence & Cycle de Vie

  • Baux de connexion exclusifs : ajout du bail de connexion (connCh) dans SFTPProducer et SMBProducer pour éliminer les courses aux données lors des envois et arrêts concurrents.
  • Comptage de références des connexions : ajout de connUsers pour les connexions partagées dans grpc, nats et stomp, empêchant les fermetures prématurées tant que des producteurs ou consommateurs sont actifs.
  • Nettoyage consommateur Redis : fermeture propre de pubSub et libération du client en cas d’erreur lors du démarrage de la souscription.
  • Robustesse Mail : encodage quoted-printable sécurisé via mime/quotedprintable.Writer, limitation de taille des parties MIME, et respect des délais d’attente réseau sur les connexions IMAP/POP3.
  • Sécurité EIP : adoption de DeepCopy() dans MemoryAggregationRepository et Resequencer pour isoler les branches concurrentes.
  • Préservation des erreurs DSL : conservation de la première erreur rencontrée dans RouteBuilder et ChoiceBuilder.

Observabilité

  • Intercepteur OpenTelemetry : ajout de TracingWith(tp) pour injecter un TracerProvider personnalisé, restauration du contexte Exchange.Context en sortie de route, et enregistrement du statut codes.Error en cas d’échec de route.

Voir le CHANGELOG pour la liste détaillée.