HTTP Guardian

HTTP Guardian est un client HTTP TypeScript construit autour de fetch. Il sert à rendre la couche API explicite : authentification, analyse des réponses, cache, guards, notifications et observabilité passent par un pipeline unique au lieu d'être dispersés dans les composants.

La documentation est écrite pour les équipes qui intègrent le package dans une application front-end, un SDK ou un runtime Node moderne. Elle privilégie les configurations lisibles et les comportements sans implicite.

Installer Voir les packages npm

Repères rapides

Runtime fetch + TypeScript

Node >= 22

Contrat ClientResult<T>

Mode Promise, RxJS optionnel

Parcours recommandé

1. Lire les concepts pour comprendre le pipeline.
2. Déclarer un client par API avec HttpClientOptions.
3. Encadrer l'auth avec les helpers auth.
4. Poser les options par appel avec RequestOptions.
5. Ajouter les guards et plugins seulement quand le comportement est nécessaire.

Packages principaux

Noyau

@cedvict/http-guardian

Client fetch, auth, parseurs, cache, guards, notifications et types publics.

npmjs.com

RxJS

@cedvict/http-guardian-rx

Adaptateur Observable qui conserve le même contrat de résultat.

npmjs.com

Plugins

retry, timeout, logger, Sentry, OTel

Extensions optionnelles pour politiques transversales et observabilité.

Voir la liste

Source de la documentation

Cette documentation consolide les README de packages, les contrats TypeScript exportés et les décisions d'intégration autour de HTTP Guardian. Elle n'est pas une page de présentation : chaque section doit aider à configurer ou diagnostiquer un usage concret.