@nocios/crudify-ui 1.3.0 → 1.3.1

package/dist/index.d.mts

@@ -1103,12 +1103,19 @@ declare function useSession(options?: UseSessionOptions): {
     error: string | null;
 };
 
+type SessionData = {
+    _id: string;
+    email: string;
+    subscriberKey: string;
+    [key: string]: any;
+} | null;
 type SessionContextType = {
     isAuthenticated: boolean;
     isLoading: boolean;
     isInitialized: boolean;
     tokens: TokenData | null;
     error: string | null;
+    sessionData: SessionData;
     login: (email: string, password: string) => Promise<LoginResult>;
     logout: () => Promise<void>;
     refreshTokens: () => Promise<boolean>;
@@ -1150,4 +1157,177 @@ declare function LoginComponent(): react_jsx_runtime.JSX.Element;
  */
 declare function SessionStatus(): react_jsx_runtime.JSX.Element;
 
-export { type ApiError, type BoxScreenType, type CrudifyApiResponse, type CrudifyConfig, type CrudifyDataContextState, CrudifyDataProvider, type CrudifyDataProviderProps, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, type CrudifyUserData, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JWTPayload$1 as JWTPayload, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, type ParsedError, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type ResolvedConfig, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseCrudifyAuthReturn, type UseCrudifyConfigReturn, type UseCrudifyDataReturn, type UseCrudifyInstanceReturn, type UseCrudifyUserOptions, type UseCrudifyUserReturn, type UseSessionOptions, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, configurationManager, crudifyInitializer, decodeJwtSafely, getCookie, getCrudifyInstanceAsync, getCrudifyInstanceSync, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, tokenManager, useCrudifyAuth, useCrudifyConfig, useCrudifyData, useCrudifyDataContext, useCrudifyInstance, useCrudifyLogin, useCrudifyUser, useSession, useSessionContext, useUserProfile };
+/**
+ * Complete user data structure (compatible con legacy)
+ */
+interface UserData {
+    session: any | null;
+    data: UserProfile | null;
+}
+/**
+ * Return type compatible con useCrudifyUser legacy
+ */
+interface UseUserDataReturn {
+    user: UserData;
+    loading: boolean;
+    error: string | null;
+    refreshProfile: () => Promise<void>;
+    clearProfile: () => void;
+}
+/**
+ * Options compatible con useCrudifyUser legacy
+ */
+interface UseUserDataOptions {
+    autoFetch?: boolean;
+    retryOnError?: boolean;
+    maxRetries?: number;
+}
+/**
+ * useUserData - Hook completo que reemplaza useCrudifyUser del sistema legacy
+ *
+ * Funcionalidades completas:
+ * - Auto-fetch de datos del usuario desde la base de datos
+ * - Manejo inteligente de caché y deduplicación
+ * - Mecanismo de retry para errores de red
+ * - Sincronización cross-tab vía SessionProvider
+ * - Formateo extendido de datos para display
+ * - Limpieza apropiada y gestión de memoria
+ * - Compatible 100% con API de useCrudifyUser legacy
+ * - Usa el nuevo sistema de refresh tokens por debajo
+ */
+declare const useUserData: (options?: UseUserDataOptions) => UseUserDataReturn;
+
+/**
+ * Return type compatible con useCrudifyAuth legacy
+ */
+interface UseAuthReturn {
+    isAuthenticated: boolean;
+    loading: boolean;
+    error: string | null;
+    token: string | null;
+    user: any | null;
+    tokenExpiration: Date | null;
+    setToken: (token: string | null) => void;
+    logout: () => Promise<void>;
+    refreshToken: () => Promise<boolean>;
+    login: (email: string, password: string) => Promise<any>;
+    isExpiringSoon: boolean;
+    expiresIn: number;
+    refreshExpiresIn: number;
+    getTokenInfo: () => any;
+    clearError: () => void;
+}
+/**
+ * useAuth - Hook de autenticación completo
+ *
+ * Este hook reemplaza completamente a useCrudifyAuth del sistema legacy
+ * manteniendo 100% compatibilidad de API pero usando el nuevo SessionProvider
+ * que incluye Refresh Token Pattern, almacenamiento seguro, y gestión automática
+ * de expiración de tokens.
+ *
+ * Funcionalidades completas:
+ * - Estado de autenticación en tiempo real
+ * - Validación automática de tokens
+ * - Sincronización cross-tab
+ * - Acciones simples login/logout
+ * - Acceso al payload JWT vía sessionData
+ * - Refresh automático de tokens
+ * - Gestión de expiración de sesiones
+ * - Almacenamiento seguro y encriptado
+ * - Compatibilidad 100% con API legacy
+ *
+ * @example
+ * ```tsx
+ * function LoginComponent() {
+ *   const { isAuthenticated, login, logout, user } = useAuth();
+ *
+ *   if (isAuthenticated) {
+ *     return (
+ *       <div>
+ *         Welcome {user?.email}!
+ *         <button onClick={logout}>Logout</button>
+ *       </div>
+ *     );
+ *   }
+ *
+ *   return <LoginForm onLogin={login} />;
+ * }
+ * ```
+ */
+declare const useAuth: () => UseAuthReturn;
+
+/**
+ * Return type compatible con useCrudifyData legacy
+ */
+interface UseDataReturn {
+    readItems: (moduleKey: string, filter?: object, options?: any) => Promise<CrudifyApiResponse>;
+    readItem: (moduleKey: string, filter: object, options?: any) => Promise<CrudifyApiResponse>;
+    createItem: (moduleKey: string, data: object, options?: any) => Promise<CrudifyApiResponse>;
+    updateItem: (moduleKey: string, data: object, options?: any) => Promise<CrudifyApiResponse>;
+    deleteItem: (moduleKey: string, id: string, options?: any) => Promise<CrudifyApiResponse>;
+    transaction: (operations: any[], options?: any) => Promise<CrudifyApiResponse>;
+    login: (email: string, password: string) => Promise<CrudifyApiResponse>;
+    isInitialized: boolean;
+    isInitializing: boolean;
+    initializationError: string | null;
+    isReady: () => boolean;
+    waitForReady: () => Promise<void>;
+}
+/**
+ * useData - Hook completo para operaciones de datos
+ *
+ * Este hook reemplaza completamente a useCrudifyData del sistema legacy
+ * manteniendo 100% compatibilidad de API pero usando el nuevo SessionProvider
+ * que proporciona mejor manejo de estados y errores.
+ *
+ * Funcionalidades completas:
+ * - Verificación automática de inicialización
+ * - Operaciones CRUD type-safe
+ * - Soporte para transacciones
+ * - Operaciones de login
+ * - Gestión de estados ready
+ * - Manejo apropiado de errores
+ * - Compatible 100% con API legacy
+ *
+ * Todas las operaciones verifican que el sistema esté inicializado correctamente,
+ * asegurando integridad de datos y previniendo fallas silenciosas.
+ *
+ * @example
+ * ```tsx
+ * function DataComponent() {
+ *   const {
+ *     readItems,
+ *     createItem,
+ *     isInitialized,
+ *     isReady
+ *   } = useData();
+ *
+ *   const loadUsers = async () => {
+ *     if (!isReady()) {
+ *       console.warn("System not ready yet");
+ *       return;
+ *     }
+ *
+ *     try {
+ *       const response = await readItems("users", { limit: 10 });
+ *       if (response.success) {
+ *         console.log("Users:", response.data);
+ *       }
+ *     } catch (error) {
+ *       console.error("Error loading users:", error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={loadUsers} disabled={!isInitialized}>
+ *         Load Users
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare const useData: () => UseDataReturn;
+
+export { type ApiError, type BoxScreenType, type CrudifyApiResponse, type CrudifyConfig, type CrudifyDataContextState, CrudifyDataProvider, type CrudifyDataProviderProps, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, type CrudifyUserData, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JWTPayload$1 as JWTPayload, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, type ParsedError, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type ResolvedConfig, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseAuthReturn, type UseCrudifyAuthReturn, type UseCrudifyConfigReturn, type UseCrudifyDataReturn, type UseCrudifyInstanceReturn, type UseCrudifyUserOptions, type UseCrudifyUserReturn, type UseDataReturn, type UseSessionOptions, type UseUserDataOptions, type UseUserDataReturn, type UserData, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, configurationManager, crudifyInitializer, decodeJwtSafely, getCookie, getCrudifyInstanceAsync, getCrudifyInstanceSync, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, tokenManager, useAuth, useCrudifyAuth, useCrudifyConfig, useCrudifyData, useCrudifyDataContext, useCrudifyInstance, useCrudifyLogin, useCrudifyUser, useData, useSession, useSessionContext, useUserData, useUserProfile };

package/dist/index.d.ts

@@ -1103,12 +1103,19 @@ declare function useSession(options?: UseSessionOptions): {
     error: string | null;
 };
 
+type SessionData = {
+    _id: string;
+    email: string;
+    subscriberKey: string;
+    [key: string]: any;
+} | null;
 type SessionContextType = {
     isAuthenticated: boolean;
     isLoading: boolean;
     isInitialized: boolean;
     tokens: TokenData | null;
     error: string | null;
+    sessionData: SessionData;
     login: (email: string, password: string) => Promise<LoginResult>;
     logout: () => Promise<void>;
     refreshTokens: () => Promise<boolean>;
@@ -1150,4 +1157,177 @@ declare function LoginComponent(): react_jsx_runtime.JSX.Element;
  */
 declare function SessionStatus(): react_jsx_runtime.JSX.Element;
 
-export { type ApiError, type BoxScreenType, type CrudifyApiResponse, type CrudifyConfig, type CrudifyDataContextState, CrudifyDataProvider, type CrudifyDataProviderProps, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, type CrudifyUserData, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JWTPayload$1 as JWTPayload, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, type ParsedError, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type ResolvedConfig, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseCrudifyAuthReturn, type UseCrudifyConfigReturn, type UseCrudifyDataReturn, type UseCrudifyInstanceReturn, type UseCrudifyUserOptions, type UseCrudifyUserReturn, type UseSessionOptions, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, configurationManager, crudifyInitializer, decodeJwtSafely, getCookie, getCrudifyInstanceAsync, getCrudifyInstanceSync, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, tokenManager, useCrudifyAuth, useCrudifyConfig, useCrudifyData, useCrudifyDataContext, useCrudifyInstance, useCrudifyLogin, useCrudifyUser, useSession, useSessionContext, useUserProfile };
+/**
+ * Complete user data structure (compatible con legacy)
+ */
+interface UserData {
+    session: any | null;
+    data: UserProfile | null;
+}
+/**
+ * Return type compatible con useCrudifyUser legacy
+ */
+interface UseUserDataReturn {
+    user: UserData;
+    loading: boolean;
+    error: string | null;
+    refreshProfile: () => Promise<void>;
+    clearProfile: () => void;
+}
+/**
+ * Options compatible con useCrudifyUser legacy
+ */
+interface UseUserDataOptions {
+    autoFetch?: boolean;
+    retryOnError?: boolean;
+    maxRetries?: number;
+}
+/**
+ * useUserData - Hook completo que reemplaza useCrudifyUser del sistema legacy
+ *
+ * Funcionalidades completas:
+ * - Auto-fetch de datos del usuario desde la base de datos
+ * - Manejo inteligente de caché y deduplicación
+ * - Mecanismo de retry para errores de red
+ * - Sincronización cross-tab vía SessionProvider
+ * - Formateo extendido de datos para display
+ * - Limpieza apropiada y gestión de memoria
+ * - Compatible 100% con API de useCrudifyUser legacy
+ * - Usa el nuevo sistema de refresh tokens por debajo
+ */
+declare const useUserData: (options?: UseUserDataOptions) => UseUserDataReturn;
+
+/**
+ * Return type compatible con useCrudifyAuth legacy
+ */
+interface UseAuthReturn {
+    isAuthenticated: boolean;
+    loading: boolean;
+    error: string | null;
+    token: string | null;
+    user: any | null;
+    tokenExpiration: Date | null;
+    setToken: (token: string | null) => void;
+    logout: () => Promise<void>;
+    refreshToken: () => Promise<boolean>;
+    login: (email: string, password: string) => Promise<any>;
+    isExpiringSoon: boolean;
+    expiresIn: number;
+    refreshExpiresIn: number;
+    getTokenInfo: () => any;
+    clearError: () => void;
+}
+/**
+ * useAuth - Hook de autenticación completo
+ *
+ * Este hook reemplaza completamente a useCrudifyAuth del sistema legacy
+ * manteniendo 100% compatibilidad de API pero usando el nuevo SessionProvider
+ * que incluye Refresh Token Pattern, almacenamiento seguro, y gestión automática
+ * de expiración de tokens.
+ *
+ * Funcionalidades completas:
+ * - Estado de autenticación en tiempo real
+ * - Validación automática de tokens
+ * - Sincronización cross-tab
+ * - Acciones simples login/logout
+ * - Acceso al payload JWT vía sessionData
+ * - Refresh automático de tokens
+ * - Gestión de expiración de sesiones
+ * - Almacenamiento seguro y encriptado
+ * - Compatibilidad 100% con API legacy
+ *
+ * @example
+ * ```tsx
+ * function LoginComponent() {
+ *   const { isAuthenticated, login, logout, user } = useAuth();
+ *
+ *   if (isAuthenticated) {
+ *     return (
+ *       <div>
+ *         Welcome {user?.email}!
+ *         <button onClick={logout}>Logout</button>
+ *       </div>
+ *     );
+ *   }
+ *
+ *   return <LoginForm onLogin={login} />;
+ * }
+ * ```
+ */
+declare const useAuth: () => UseAuthReturn;
+
+/**
+ * Return type compatible con useCrudifyData legacy
+ */
+interface UseDataReturn {
+    readItems: (moduleKey: string, filter?: object, options?: any) => Promise<CrudifyApiResponse>;
+    readItem: (moduleKey: string, filter: object, options?: any) => Promise<CrudifyApiResponse>;
+    createItem: (moduleKey: string, data: object, options?: any) => Promise<CrudifyApiResponse>;
+    updateItem: (moduleKey: string, data: object, options?: any) => Promise<CrudifyApiResponse>;
+    deleteItem: (moduleKey: string, id: string, options?: any) => Promise<CrudifyApiResponse>;
+    transaction: (operations: any[], options?: any) => Promise<CrudifyApiResponse>;
+    login: (email: string, password: string) => Promise<CrudifyApiResponse>;
+    isInitialized: boolean;
+    isInitializing: boolean;
+    initializationError: string | null;
+    isReady: () => boolean;
+    waitForReady: () => Promise<void>;
+}
+/**
+ * useData - Hook completo para operaciones de datos
+ *
+ * Este hook reemplaza completamente a useCrudifyData del sistema legacy
+ * manteniendo 100% compatibilidad de API pero usando el nuevo SessionProvider
+ * que proporciona mejor manejo de estados y errores.
+ *
+ * Funcionalidades completas:
+ * - Verificación automática de inicialización
+ * - Operaciones CRUD type-safe
+ * - Soporte para transacciones
+ * - Operaciones de login
+ * - Gestión de estados ready
+ * - Manejo apropiado de errores
+ * - Compatible 100% con API legacy
+ *
+ * Todas las operaciones verifican que el sistema esté inicializado correctamente,
+ * asegurando integridad de datos y previniendo fallas silenciosas.
+ *
+ * @example
+ * ```tsx
+ * function DataComponent() {
+ *   const {
+ *     readItems,
+ *     createItem,
+ *     isInitialized,
+ *     isReady
+ *   } = useData();
+ *
+ *   const loadUsers = async () => {
+ *     if (!isReady()) {
+ *       console.warn("System not ready yet");
+ *       return;
+ *     }
+ *
+ *     try {
+ *       const response = await readItems("users", { limit: 10 });
+ *       if (response.success) {
+ *         console.log("Users:", response.data);
+ *       }
+ *     } catch (error) {
+ *       console.error("Error loading users:", error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={loadUsers} disabled={!isInitialized}>
+ *         Load Users
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare const useData: () => UseDataReturn;
+
+export { type ApiError, type BoxScreenType, type CrudifyApiResponse, type CrudifyConfig, type CrudifyDataContextState, CrudifyDataProvider, type CrudifyDataProviderProps, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, type CrudifyUserData, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JWTPayload$1 as JWTPayload, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, type ParsedError, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type ResolvedConfig, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseAuthReturn, type UseCrudifyAuthReturn, type UseCrudifyConfigReturn, type UseCrudifyDataReturn, type UseCrudifyInstanceReturn, type UseCrudifyUserOptions, type UseCrudifyUserReturn, type UseDataReturn, type UseSessionOptions, type UseUserDataOptions, type UseUserDataReturn, type UserData, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, configurationManager, crudifyInitializer, decodeJwtSafely, getCookie, getCrudifyInstanceAsync, getCrudifyInstanceSync, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, tokenManager, useAuth, useCrudifyAuth, useCrudifyConfig, useCrudifyData, useCrudifyDataContext, useCrudifyInstance, useCrudifyLogin, useCrudifyUser, useData, useSession, useSessionContext, useUserData, useUserProfile };