feat: Implement token issue detection and enhance license validation middleware; add tests for token issue message detection

frontend/src/lib/api.ts

@@ -142,24 +142,32 @@ async function fetchApi<T = any>(
 			credentials: 'include' // Importante: envía cookies con cada request
 		});
 
-		// Si recibimos 401 o 403 y no es el endpoint de refresh, intentar refrescar el token
-		if ((response.status === 401 || response.status === 403) && !endpoint.includes('/auth/refresh') && retryCount === 0) {
-			// Si es 403 (Forbidden), mostrar toast de permisos insuficientes
-			if (response.status === 403) {
-				if (browser) {
-					toast.error('No tienes permisos para realizar esta acción', {
-						duration: 4000,
-						description: 'Contacta a tu administrador si crees que esto es un error'
-					});
-				}
-				// Retornar el error 403 sin intentar refresh
-				const data = await response.json();
-				return {
-					error: data.detail || 'No tienes permisos para realizar esta acción',
-					status: 403
-				};
+		// 403 = permisos, no autenticación: nunca intentar refresh.
+		if (response.status === 403 && !endpoint.includes('/auth/refresh') && retryCount === 0) {
+			if (browser) {
+				toast.error('No tienes permisos para realizar esta acción', {
+					duration: 4000,
+					description: 'Contacta a tu administrador si crees que esto es un error'
+				});
 			}
+			const data = await response.json();
+			return {
+				error: data.detail || 'No tienes permisos para realizar esta acción',
+				status: 403
+			};
+		}
 
+		// 402 = licencia inválida/expirada: no intentar refresh.
+		if (response.status === 402 && !endpoint.includes('/auth/refresh') && retryCount === 0) {
+			const data = await response.json().catch(() => ({}));
+			return {
+				error: data.message || data.detail || 'Licencia inválida o expirada',
+				status: 402
+			};
+		}
+
+		// Solo 401 dispara silent refresh.
+		if (response.status === 401 && !endpoint.includes('/auth/refresh') && retryCount === 0) {
 			// Si es 401, intentar refrescar el token
 			isRefreshing = true;