@tgtone/auth-sdk

SDK de autenticación centralizada para el ecosistema TGT One. OAuth PKCE + JWT + Session Cache via WebSocket.

npm install @tgtone/auth-sdk

Uso básico

React (hook)

import { useTGTAuth } from '@tgtone/auth-sdk';

function App() {
  const { session, loading, logout, hasRole } = useTGTAuth({
    coreApiUrl: 'https://dev-core.tgtone.cl/api',
    appDomain: window.location.host,
    appKey: 'console',
  });

  if (loading) return <Spinner />;
  if (!session) return null; // redirigiendo al login

  return (
    <div>
      <span>{session.user.name}</span>
      <button onClick={logout}>Cerrar sesión</button>
      {hasRole('console', 'admin') && <AdminPanel />}
    </div>
  );
}

Sin framework (TGTAuthClient)

import { TGTAuthClient } from '@tgtone/auth-sdk';

const auth = new TGTAuthClient({
    coreApiUrl: 'https://dev-core.tgtone.cl/api',
  appDomain: window.location.host,
  appKey: 'console',
});

const session = await auth.checkSession();
if (session) {
  console.log('Usuario:', session.user.email);
}

API rápida

| Método | Descripción | |--------|-------------| | checkSession() | Valida sesión, redirige a login si no hay | | checkSessionSilent() | Valida sin redirigir | | redirectToLogin(url?) | Redirige al login de Identity | | logout() | Cierra sesión + redirige a login | | localLogout() | Limpia sesión sin redirigir | | hasRole(app, role) | Verifica rol del usuario | | hasAccessToApp(app) | Verifica acceso a una app | | getToken() | Obtiene JWT actual | | isRedirecting() | true si está redirigiendo al login | | getBlockedRedirectUrl(error) | URL de página bloqueada | | getApplicationRoles(appId) | Obtiene roles de una aplicación desde el Core API | | listUsers(tenantId) | Lista usuarios de un tenant desde el Core API | | startSessionMonitor() | Inicia WS + refresh proactivo JWT | | stopSessionMonitor() | Detiene WS + refresh |

Documentación

• docs/API.md — Referencia completa de API
• docs/ARCHITECTURE.md — OAuth PKCE, WS, session cache
• docs/INTEGRATION_EXAMPLES.md — Vue, Next.js, Angular
• CHANGELOG.md — Historial de cambios

Estructura del usuario

interface TGTUser {
  sub: string;                          // ID del usuario
  email: string;
  emailVerified: boolean;
  name: string;
  tenantId: string;
  tenantName: string;
  roles: Record<string, string[]>;      // { console: ['admin'], baco: ['viewer'] }
}

Migración desde v3 a v4

En v4, identityUrl pasó a llamarse coreApiUrl. El login, signup, auth, roles y usuarios están todos en el mismo Core API.

-  identityUrl: 'https://identity.tgtone.cl',
+  coreApiUrl: 'https://dev-core.tgtone.cl/api',

Métodos nuevos:

| Método | Reemplaza | Descripción | |--------|-----------|-------------| | authClient.getApplicationRoles(appId) | core.applications.getRoles() | Roles de una aplicación | | authClient.listUsers(tenantId) | core.users.list() | Usuarios de un tenant |

Si estabas usando @tgtone/core-sdk solo para notificaciones, migra a @tgtone/notifications-sdk. Si lo usabas para auth, roles o usuarios, estos métodos ya están en @tgtone/auth-sdk v4.

Licencia

Privado — TGT Group