Conceptes fonamentals
Conceptes bàsics del disseny i la integració de l'SDK Eixam.
SDK-first
Eixam està construït amb arquitectura SDK-first. L'SDK posseeix la lògica central de seguretat i runtime. L'app amfitriona consumeix aquesta lògica a través de contractes documentats i estables.
Bootstrap vs cicle de vida de sessió
Bootstrap
bootstrap(...) crea la instància de l'SDK i resol la configuració de l'entorn. S'executa una vegada en iniciar l'app.
Cicle de vida de sessió
| Mètode | Descripció |
|---|---|
setSession(...) | Aplicar una sessió signada nova o actualitzada |
clearSession() | Eliminar la sessió actual |
getCurrentSession() | Llegir la sessió signada actual |
Identitat signada vs identitat canònica
Identitat signada
Proporcionada pel backend del partner: appId, externalUserId, userHash
Identitat canònica
L'SDK pot enriquir la identitat signada a través de GET /v1/sdk/me. Els fluxos interns del runtime usen aquesta identitat canònica per a la resolució del transport i els topics.
Entorns estàndard vs personalitzats
| Entorn | Ús |
|---|---|
production | Desplegaments en producció |
sandbox | Desenvolupament i proves d'integració |
staging | Validació pre-producció |
custom | Endpoints gestionats pel partner |
Accions sensibles al runtime
Aquestes capacitats són deliberadament sensibles a la UX i han de romandre com a decisions explícites de l'app amfitriona: sol·licitar permisos, entrar en Mode Protecció, emparellament i connexió de dispositius, iniciar tracking, mostrar fluxos d'UI específics del partner.