Intégrations

Pithos est framework-agnostic. Un seul package, zéro adaptateur, zéro plugin. Vous importez ce dont vous avez besoin, et ça marche, quel que soit votre stack.

Parce que chaque technologie répond à un besoin différent, nous avons écrit plusieurs intégrations de Pithos avec les stacks les plus courantes afin de montrer comment il peut s'intégrer sans friction. Ces pages sont là pour vous aider à comprendre comment l'utiliser en harmonie avec votre techno préférée.

Pas besoin de vous convaincre que Pithos est framework-agnostic... ces intégrations parlent d'elles-mêmes.

Philosophie

Pithos comble les lacunes, il ne remplace pas ce qui existe. Quand un framework gère déjà une feature nativement, on l'utilise. Par exemple :

• Angular : on passe par HttpClient pour les appels réseau, puis on encapsule le résultat dans ResultAsync pour la validation
• SvelteKit : on utilise fail() et error() natifs pour la gestion d'erreurs, Sphalma n'est pas nécessaire
• Nuxt : on s'appuie sur createError et les server routes natives

L'objectif n'est jamais de réinventer la roue, mais de s'intégrer de la façon la plus naturelle possible.

---

Frontend (SPA)

Applications client-only qui communiquent avec un backend via fetch.

Techno	Pithos	Natif
React	Validation, pipeline async, tri et groupement	State management, routing, rendu
Angular	Validation des réponses API, normalisation des données	HttpClient, Signals, Reactive Forms, DI
Preact	Même pipeline que React, bundle minimal (~3 Ko)	Hooks, rendu

Fullstack (SSR)

Frameworks avec rendu serveur. Le schéma Kanon est partagé entre client et serveur, une seule source de vérité.

Techno	Pithos	Natif
Next.js	Validation dans les Server Actions, normalisation	App Router, Server Components, useActionState
Nuxt	Validation dans les server routes, composables de tri	Auto-imports, createError, defineEventHandler
SvelteKit	Validation dans les form actions, load functions	fail(), error(), runes Svelte 5

Backend

Serveurs API purs. Pithos gère la validation des entrées et la normalisation.

Techno	Pithos	Natif
Express	Validation, normalisation, erreurs métier structurées (CodedError)	Routing, middleware, ErrorRequestHandler
Hono	Même pipeline que Express	app.onError, routing
Bun	Même pipeline, zéro framework	Bun.serve(), Web Standards API

---

Le pattern commun

Quel que soit le framework, le pipeline reste le même :

1. Valider les entrées avec Kanon via ensure ou ensurePromise
2. Normaliser les données avec Arkhe (capitalize, titleCase, groupBy, orderBy)
3. Gérer les erreurs avec Zygos (Result, ResultAsync) ou les mécanismes natifs du framework
4. Structurer les erreurs métier avec Sphalma quand le framework n'a pas d'équivalent natif

Code source complet

Chaque intégration est une app fonctionnelle complète avec tests. Les démos frontend et backend sont interchangeables : vous pouvez combiner n'importe quel frontend (React, Angular, Preact) avec n'importe quel backend (Express, Hono, Bun), ils partagent le même contrat API. Explorez le code dans packages/main/integrations/.