@nocios/crudify-ui 1.2.36 → 1.3.1

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import crudify__default from '@nocios/crudify-browser';
 export * from '@nocios/crudify-browser';
 export { default as crudify } from '@nocios/crudify-browser';
 import React, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type BoxScreenType = "login" | "signUp" | "forgotPassword" | "resetPassword" | "checkCode";
 interface CrudifyLoginConfig {
@@ -917,4 +918,416 @@ declare function parseJavaScriptError(error: unknown): ParsedError;
  */
 declare function handleCrudifyError(error: unknown): ParsedError[];
 
-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, type LoginRequest, type LoginResponse, type ParsedError, type ResetPasswordRequest, type ResolvedConfig, type TransactionResponseData, type UseCrudifyAuthReturn, type UseCrudifyConfigReturn, type UseCrudifyDataReturn, type UseCrudifyInstanceReturn, type UseCrudifyUserOptions, type UseCrudifyUserReturn, 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, useUserProfile };
+type TokenData = {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    refreshExpiresAt: number;
+};
+type StorageType = 'localStorage' | 'sessionStorage' | 'none';
+declare class TokenStorage {
+    private static readonly TOKEN_KEY;
+    private static readonly ENCRYPTION_KEY;
+    private static storageType;
+    /**
+     * Configurar tipo de almacenamiento
+     */
+    static setStorageType(type: StorageType): void;
+    /**
+     * Verificar si el storage está disponible
+     */
+    private static isStorageAvailable;
+    /**
+     * Obtener instancia de storage
+     */
+    private static getStorage;
+    /**
+     * Encriptar datos sensibles
+     */
+    private static encrypt;
+    /**
+     * Desencriptar datos
+     */
+    private static decrypt;
+    /**
+     * Guardar tokens de forma segura
+     */
+    static saveTokens(tokens: TokenData): void;
+    /**
+     * Obtener tokens guardados
+     */
+    static getTokens(): TokenData | null;
+    /**
+     * Limpiar tokens almacenados
+     */
+    static clearTokens(): void;
+    /**
+     * Verificar si hay tokens válidos guardados
+     */
+    static hasValidTokens(): boolean;
+    /**
+     * Obtener información de expiración
+     */
+    static getExpirationInfo(): {
+        accessExpired: boolean;
+        refreshExpired: boolean;
+        accessExpiresIn: number;
+        refreshExpiresIn: number;
+    } | null;
+    /**
+     * Actualizar solo el access token (después de refresh)
+     */
+    static updateAccessToken(newAccessToken: string, newExpiresAt: number): void;
+}
+
+type SessionConfig = {
+    storageType?: StorageType;
+    autoRestore?: boolean;
+    enableLogging?: boolean;
+    onSessionExpired?: () => void;
+    onSessionRestored?: (tokens: TokenData) => void;
+    onLoginSuccess?: (tokens: TokenData) => void;
+    onLogout?: () => void;
+};
+type LoginResult = {
+    success: boolean;
+    tokens?: TokenData;
+    error?: string;
+};
+declare class SessionManager {
+    private static instance;
+    private config;
+    private initialized;
+    private constructor();
+    static getInstance(): SessionManager;
+    /**
+     * Inicializar el SessionManager
+     */
+    initialize(config?: SessionConfig): Promise<void>;
+    /**
+     * Login con persistencia automática
+     */
+    login(email: string, password: string): Promise<LoginResult>;
+    /**
+     * Logout con limpieza de tokens
+     */
+    logout(): Promise<void>;
+    /**
+     * Restaurar sesión desde storage
+     */
+    restoreSession(): Promise<boolean>;
+    /**
+     * Verificar si el usuario está autenticado
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Obtener información de tokens actuales
+     */
+    getTokenInfo(): {
+        isLoggedIn: boolean;
+        crudifyTokens: {
+            accessToken: string;
+            refreshToken: string;
+            expiresAt: number;
+            refreshExpiresAt: number;
+            isExpired: boolean;
+            isRefreshExpired: boolean;
+        };
+        storageInfo: {
+            accessExpired: boolean;
+            refreshExpired: boolean;
+            accessExpiresIn: number;
+            refreshExpiresIn: number;
+        } | null;
+        hasValidTokens: boolean;
+    };
+    /**
+     * Refrescar tokens manualmente
+     */
+    refreshTokens(): Promise<boolean>;
+    /**
+     * Configurar interceptor de respuesta para manejo automático de errores
+     */
+    setupResponseInterceptor(): void;
+    /**
+     * Limpiar sesión completamente
+     */
+    clearSession(): void;
+    private log;
+    private formatError;
+}
+
+type SessionState = {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    isInitialized: boolean;
+    tokens: TokenData | null;
+    error: string | null;
+};
+type UseSessionOptions = {
+    autoRestore?: boolean;
+    enableLogging?: boolean;
+    onSessionExpired?: () => void;
+    onSessionRestored?: (tokens: TokenData) => void;
+};
+declare function useSession(options?: UseSessionOptions): {
+    login: (email: string, password: string) => Promise<LoginResult>;
+    logout: () => Promise<void>;
+    refreshTokens: () => Promise<boolean>;
+    clearError: () => void;
+    getTokenInfo: () => {
+        isLoggedIn: boolean;
+        crudifyTokens: {
+            accessToken: string;
+            refreshToken: string;
+            expiresAt: number;
+            refreshExpiresAt: number;
+            isExpired: boolean;
+            isRefreshExpired: boolean;
+        };
+        storageInfo: {
+            accessExpired: boolean;
+            refreshExpired: boolean;
+            accessExpiresIn: number;
+            refreshExpiresIn: number;
+        } | null;
+        hasValidTokens: boolean;
+    };
+    isExpiringSoon: boolean;
+    expiresIn: number;
+    refreshExpiresIn: number;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    isInitialized: boolean;
+    tokens: TokenData | null;
+    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>;
+    clearError: () => void;
+    getTokenInfo: () => any;
+    isExpiringSoon: boolean;
+    expiresIn: number;
+    refreshExpiresIn: number;
+};
+type SessionProviderProps = {
+    children: ReactNode;
+    options?: UseSessionOptions;
+};
+/**
+ * Provider de sesión para envolver la aplicación
+ */
+declare function SessionProvider({ children, options }: SessionProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook para usar el contexto de sesión
+ */
+declare function useSessionContext(): SessionContextType;
+/**
+ * HOC para proteger rutas que requieren autenticación
+ */
+type ProtectedRouteProps = {
+    children: ReactNode;
+    fallback?: ReactNode;
+    redirectTo?: () => void;
+};
+declare function ProtectedRoute({ children, fallback, redirectTo }: ProtectedRouteProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Componente para mostrar información de la sesión (debug)
+ */
+declare function SessionDebugInfo(): react_jsx_runtime.JSX.Element;
+
+declare function LoginComponent(): react_jsx_runtime.JSX.Element;
+/**
+ * Componente simple de estado de sesión para mostrar en cualquier lugar
+ */
+declare function SessionStatus(): react_jsx_runtime.JSX.Element;
+
+/**
+ * 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 };