@elogroup-sereduc/ser-front-core-client 1.1.1 → 2.0.1

package/OAUTH_MIGRATION.md

@@ -0,0 +1,86 @@
+# Migração para Ser OAuth System
+
+Esta biblioteca agora inclui um sistema completo de autenticação OAuth/OIDC (`ser-oauth-js`) além do sistema Keycloak original.
+
+## Nova Implementação: Ser OAuth
+
+### Características
+
+- ✅ **Silent SSO**: Autenticação invisível via iframe
+- ✅ **PKCE S256**: Segurança avançada para SPAs
+- ✅ **Token Refresh**: Renovação automática de tokens
+- ✅ **API Client**: Cliente HTTP com interceptadores automáticos
+- ✅ **Route Guards**: Proteção de rotas para TanStack Router
+- ✅ **Zustand Store**: Gerenciamento de estado reativo
+- ✅ **IDP Hint**: Redirecionamento automático para provedores específicos
+
+### Setup Básico
+
+```typescript
+import {
+  createKeycloakAuthFromUrl,
+  initAuth,
+  useAuthStore,
+} from "@elogroup-sereduc/ser-front-core-client";
+
+const kc = createKeycloakAuthFromUrl(
+  "https://sso.sereduc.com/realms/colaboradores/protocol/openid-connect/auth",
+  "seu-client-id",
+  "ser-oidc", // IDP hint opcional
+);
+
+const authenticated = await initAuth(kc, "/seu-base-path");
+```
+
+### Migração de Projetos
+
+1. **Instalar nova versão** da biblioteca
+2. **Copiar `silent-check-sso.html`** para pasta public
+3. **Substituir inicialização** do auth
+4. **Atualizar imports** dos hooks/stores
+5. **Testar Silent SSO** e fluxo completo
+
+### Exemplo de Context
+
+```typescript
+import { useAuthStore } from "@elogroup-sereduc/ser-front-core-client";
+
+export function useAuth() {
+  const authState = useAuthStore();
+
+  return {
+    authenticated: authState.authenticated,
+    token: authState.accessToken,
+    login: () => kc.login(),
+    logout: () => kc.logout(),
+  };
+}
+```
+
+### API Client
+
+```typescript
+import { createApiClient } from "@elogroup-sereduc/ser-front-core-client";
+
+const api = createApiClient(kc, "https://api.sereduc.com");
+
+// O cliente automaticamente:
+// - Adiciona Bearer token
+// - Renova em caso de 401
+// - Retenta requisição
+```
+
+### Route Guards
+
+```typescript
+import { createAuthGuard } from "@elogroup-sereduc/ser-front-core-client";
+
+const requireAuth = createAuthGuard(kc);
+
+export const Route = createFileRoute("/protected")({
+  beforeLoad: requireAuth,
+  component: ProtectedComponent,
+});
+```
+
+Ver documentação completa em `src/auth/README.md`.