ajolote

Changed

• Rewrote README with clear quickstart, feature overview, and installation instructions.
• Renamed AppId enum to a plain String parameter for generality across consumers.
• Translated public-facing doc comments to English.

Added

• Refresh automático del access token con dedupe de concurrencia (TokenRefresher).
  • AjoloteClient.getValidToken() devuelve un JWT siempre fresco.
  • N requests concurrentes con JWT expirado disparan 1 sola llamada de refresh.
• OAuth social (Google) con deep links + validación de state contra CSRF.
  • Nuevo módulo SocialAuth con SocialAuthConfig y SocialProvider.
  • DeepLinkListener abstracto (la app provee implementación con app_links).
  • El SDK NO depende de app_links ni url_launcher — pattern de factory.
• Contract compartido con TS: cuando agregás un AppId o cambiás AuthUser, los tests de conformance del paquete @anfibia/ajolote-schemas fallan si los modelos Dart y TS divergen.

Changed

• AjoloteClient ahora maneja dos tokens internamente: session token (largo, en SecureStore) y access token JWT (corto, en memoria).
• El access token se refresca automáticamente cuando le quedan <60s de vida (configurable con refreshThreshold).

Migration desde 0.1.0

Si usabas auth.http.getToken() para firmar requests a tu API, cambiar a:

// Antes
final token = await auth.http.getToken();

// Después
final token = await auth.getValidToken();

getValidToken() lanza AuthException(expiredToken) si la sesión también expiró — usar try/catch y redirigir a login.