@nocios/crudify-ui 1.2.28 → 1.2.32

package/MIGRATION.md

@@ -0,0 +1,201 @@
+# Guía de Migración - useCrudifyUser v1.2.25+
+
+## Cambios Importantes
+
+A partir de la versión 1.2.25, el hook `useCrudifyUser` ha sido completamente reestructurado para ser más simple y claro.
+
+## Antes (❌ Estructura Anterior)
+
+```typescript
+const {
+  userEmail,
+  userId,
+  userIdentifier,
+  userProfile,
+  profileLoading,
+  profileError,
+  extendedData,
+  refreshProfile,
+  clearProfile
+} = useCrudifyUser();
+
+// Acceso a datos
+console.log(extendedData.fullProfile);
+console.log(extendedData.displayData);
+console.log(extendedData.totalFields);
+```
+
+## Ahora (✅ Nueva Estructura)
+
+```typescript
+const {
+  user,
+  loading,
+  error,
+  refreshProfile,
+  clearProfile
+} = useCrudifyUser();
+
+// Acceso a datos
+console.log(user.session); // Datos del JWT token
+console.log(user.data);    // Datos de la base de datos
+```
+
+## Estructura del objeto `user`
+
+```typescript
+interface CrudifyUserData {
+  session: JWTPayload | null;  // Datos del token JWT
+  data: UserProfile | null;    // Datos de la base de datos
+}
+```
+
+### `user.session` (Datos del JWT)
+- `user.session.sub` - User ID
+- `user.session.email` - Email del usuario
+- `user.session.name` - Nombre del usuario
+- `user.session.exp` - Timestamp de expiración
+- `user.session.iat` - Timestamp de emisión
+- Y todos los demás campos del JWT token
+
+### `user.data` (Datos de la Base de Datos)
+- `user.data.id` - ID del perfil en la BD
+- `user.data.email` - Email del perfil
+- `user.data.firstName` - Nombre
+- `user.data.lastName` - Apellido
+- `user.data.role` - Rol del usuario
+- Y todos los demás campos del perfil de usuario
+
+## Migraciones Necesarias
+
+### 1. Cambiar las destructuraciones
+```typescript
+// ❌ Antes
+const { userProfile, profileLoading, profileError } = useCrudifyUser();
+
+// ✅ Ahora
+const { user, loading, error } = useCrudifyUser();
+```
+
+### 2. Actualizar acceso a datos de sesión
+```typescript
+// ❌ Antes
+const email = userEmail;
+const userId = userId;
+
+// ✅ Ahora
+const email = user.session?.email;
+const userId = user.session?.sub;
+```
+
+### 3. Actualizar acceso a datos de perfil
+```typescript
+// ❌ Antes
+const profileData = userProfile;
+const fullName = extendedData.displayData.fullName;
+
+// ✅ Ahora
+const profileData = user.data;
+const fullName = user.data?.fullName;
+```
+
+### 4. Actualizar estados de carga y error
+```typescript
+// ❌ Antes
+if (profileLoading) return <Loading />;
+if (profileError) return <Error message={profileError} />;
+
+// ✅ Ahora
+if (loading) return <Loading />;
+if (error) return <Error message={error} />;
+```
+
+## Beneficios de la Nueva Estructura
+
+1. **Más Simple**: Solo un objeto `user` con `session` y `data`
+2. **Más Claro**: Es obvio qué viene del JWT (`session`) y qué de la DB (`data`)
+3. **Sin Duplicación**: La información no se repite en múltiples lugares
+4. **Mejor TypeScript**: Tipos más precisos y claros
+5. **Más Fácil de Usar**: Los desarrolladores entienden inmediatamente la estructura
+
+## Ejemplo Completo de Migración
+
+### Antes
+```tsx
+function UserProfile() {
+  const {
+    userEmail,
+    userProfile,
+    profileLoading,
+    profileError,
+    extendedData,
+    refreshProfile
+  } = useCrudifyUser();
+
+  if (profileLoading) return <div>Cargando...</div>;
+  if (profileError) return <div>Error: {profileError}</div>;
+
+  return (
+    <div>
+      <h1>Welcome {userProfile?.fullName || userEmail}</h1>
+      <p>Total fields: {extendedData.totalFields}</p>
+      <pre>{JSON.stringify(extendedData.displayData, null, 2)}</pre>
+      <button onClick={refreshProfile}>Refresh</button>
+    </div>
+  );
+}
+```
+
+### Después
+```tsx
+function UserProfile() {
+  const {
+    user,
+    loading,
+    error,
+    refreshProfile
+  } = useCrudifyUser();
+
+  if (loading) return <div>Cargando...</div>;
+  if (error) return <div>Error: {error}</div>;
+
+  return (
+    <div>
+      <h1>Welcome {user.data?.fullName || user.session?.email}</h1>
+      <h2>Datos de Sesión:</h2>
+      <pre>{JSON.stringify(user.session, null, 2)}</pre>
+      <h2>Datos de Perfil:</h2>
+      <pre>{JSON.stringify(user.data, null, 2)}</pre>
+      <button onClick={refreshProfile}>Refresh</button>
+    </div>
+  );
+}
+```
+
+## Retrocompatibilidad
+
+Para mantener compatibilidad temporal, puedes crear un wrapper:
+
+```typescript
+// wrapper temporal para compatibilidad
+export const useLegacyUserProfile = () => {
+  const { user, loading, error, refreshProfile, clearProfile } = useCrudifyUser();
+
+  return {
+    userEmail: user.session?.email || null,
+    userId: user.session?.sub || null,
+    userProfile: user.data,
+    profileLoading: loading,
+    profileError: error,
+    extendedData: {
+      fullProfile: user.data,
+      displayData: user.data,
+      totalFields: user.data ? Object.keys(user.data).length : 0
+    },
+    refreshProfile,
+    clearProfile
+  };
+};
+```
+
+**Nota**: Este wrapper es solo para facilitar la migración. Se recomienda migrar completamente a la nueva estructura.

package/dist/{CrudifyDataProvider-VQUGF4OL.mjs → CrudifyDataProvider-5GXGNQKI.mjs}

@@ -2,9 +2,11 @@ import {
   CrudifyDataProvider,
   configurationManager,
   crudifyInitializer,
-  tokenManager,
   useCrudifyDataContext
-} from "./chunk-UAYA54B3.mjs";
+} from "./chunk-GY5F6KOF.mjs";
+import {
+  tokenManager
+} from "./chunk-M7V4UGCN.mjs";
 export {
   CrudifyDataProvider,
   configurationManager,

package/dist/TokenManager-AYUNIXQU.mjs

@@ -0,0 +1,8 @@
+import {
+  TokenManager,
+  tokenManager
+} from "./chunk-M7V4UGCN.mjs";
+export {
+  TokenManager,
+  tokenManager
+};