@astratra/saas-kit-ui 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +23 -0
  2. package/package.json +4 -1
package/README.md CHANGED
@@ -44,3 +44,26 @@ VITE_API_URL=http://localhost:4000 npm run dev
44
44
 
45
45
  Le package ne contient pas de serveur Express et ne fixe aucun domaine metier.
46
46
  Le backend reste fourni par `@astratra/saas-kit` ou par ton application.
47
+
48
+ ## `AuthProvider`/`useAuth` vs `@astratra/react`
49
+
50
+ Deux packages Astratra exposent des primitives de session React, avec des
51
+ choix différents et volontaires — ce n'est pas un doublon accidentel :
52
+
53
+ - **`AuthProvider`/`useAuth` (ce package)** : garde le JWT en mémoire JS et
54
+ l'attache en `Authorization: Bearer` via `apiFetch`. Couplé au dashboard
55
+ complet `AstratraDashboardApp` (login/users/settings/overview) — conçu
56
+ pour démarrer vite avec un backend `@astratra/saas-kit` standard, pas pour
57
+ être réutilisé isolément dans une UI déjà existante.
58
+ - **`SessionProvider`/`useSession` (`@astratra/react`)** : ne stocke aucun
59
+ token côté client — la session vit dans un cookie `HttpOnly` géré par le
60
+ backend, l'app injecte juste `getSession`/`signIn`/`signOut`. Pas de
61
+ dashboard imposé, pas de routes fixes ; à choisir quand tu construis ta
62
+ propre UI par-dessus `@astratra/saas-kit` (avec les cookies de session
63
+ activés côté `@astratra/security`) plutôt que d'utiliser
64
+ `AstratraDashboardApp` tel quel.
65
+
66
+ En résumé : utilise ce package si `AstratraDashboardApp` te convient tel
67
+ quel ; utilise `@astratra/react` si tu construis ta propre interface et que
68
+ ton backend utilise les sessions cookie `HttpOnly` plutôt qu'un token Bearer
69
+ géré côté client.
package/package.json CHANGED
@@ -1,7 +1,10 @@
1
1
  {
2
2
  "name": "@astratra/saas-kit-ui",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Reusable React dashboard shell for Astratra SaaS applications.",
5
+ "engines": {
6
+ "node": ">=20"
7
+ },
5
8
  "type": "module",
6
9
  "main": "src/index.jsx",
7
10
  "module": "src/index.jsx",