Concepts fondamentaux
Concepts de base de la conception et de l'intégration du SDK Eixam.
SDK-first
Eixam est construit avec une architecture SDK-first. Le SDK détient la logique de sécurité et de runtime principale. L'app hôte consomme cette logique via des contrats stables et documentés.
Bootstrap vs cycle de vie de session
Bootstrap
bootstrap(...) crée l'instance du SDK et résout la configuration de l'environnement. S'exécute une fois au démarrage de l'app.
Cycle de vie de session
| Méthode | Description |
|---|---|
setSession(...) | Appliquer une session signée nouvelle ou mise à jour |
clearSession() | Supprimer la session actuelle |
getCurrentSession() | Lire la session signée actuelle |
Identité signée vs identité canonique
Signée : fournie par le backend partenaire — appId, externalUserId, userHash
Canonique : le SDK enrichit l'identité via GET /v1/sdk/me. Les flux internes du runtime utilisent cette identité canonique pour la résolution du transport et des topics.
Environnements standard vs personnalisés
| Environnement | Usage |
|---|---|
production | Déploiements en production |
sandbox | Développement et tests d'intégration |
staging | Validation pré-production |
custom | Endpoints gérés par le partenaire |
Actions sensibles au runtime
Ces capacités sont délibérément sensibles à l'UX et doivent rester des décisions explicites de l'app hôte : demander des permissions, entrer en Mode Protection, appairage et connexion de dispositifs, démarrer le tracking, afficher des flux UI spécifiques au partenaire.