@nocios/crudify-ui 4.0.8 → 4.0.9

package/dist/index-CjC4JwH9.d.ts

@@ -0,0 +1,427 @@
+import { U as UserProfile, C as CrudifyApiResponse } from './api-Djqihi4n.js';
+import { b as NotificationSeverity } from './GlobalNotificationProvider-C3iWgM1z.js';
+import { CrudifyResponse } from '@nocios/crudify-browser';
+
+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_STORAGE;
+    private static encryptionKey;
+    private static storageType;
+    /**
+     * Configurar tipo de almacenamiento
+     */
+    static setStorageType(type: StorageType): void;
+    /**
+     * Generar clave de encriptación única y persistente
+     */
+    private static generateEncryptionKey;
+    /**
+     * Obtener o generar clave de encriptación
+     */
+    private static getEncryptionKey;
+    /**
+     * 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;
+    /**
+     * Rotar clave de encriptación (limpia tokens existentes por seguridad)
+     */
+    static rotateEncryptionKey(): 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;
+    showNotification?: (message: string, severity?: "error" | "info" | "success" | "warning") => void;
+    translateFn?: (key: string) => string;
+};
+type LoginResult = {
+    success: boolean;
+    tokens?: TokenData;
+    data?: any;
+    error?: string;
+    rawResponse?: any;
+};
+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;
+    /**
+     * Detectar errores de autorización en todos los formatos posibles
+     */
+    private detectAuthorizationError;
+    /**
+     * Limpiar sesión completamente
+     */
+    clearSession(): void;
+    /**
+     * Obtener mensaje de sesión expirada traducido
+     */
+    private getSessionExpiredMessage;
+    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;
+    showNotification?: (message: string, severity?: "error" | "info" | "success" | "warning") => void;
+    translateFn?: (key: string) => string;
+};
+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;
+};
+
+/**
+ * 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;
+
+interface UseUserProfileOptions {
+    autoFetch?: boolean;
+    retryOnError?: boolean;
+    maxRetries?: number;
+}
+interface UseUserProfileReturn {
+    userProfile: UserProfile | null;
+    loading: boolean;
+    error: string | null;
+    extendedData: Record<string, any>;
+    refreshProfile: () => Promise<void>;
+    clearProfile: () => void;
+}
+declare const useUserProfile: (options?: UseUserProfileOptions) => UseUserProfileReturn;
+
+interface CrudifyWithNotificationsOptions {
+    showSuccessNotifications?: boolean;
+    showErrorNotifications?: boolean;
+    customErrorMessages?: Record<string, string>;
+    defaultErrorMessage?: string;
+    autoHideDuration?: number;
+    appStructure?: any[];
+    translateFn?: (key: string, options?: any) => string;
+}
+declare const useCrudifyWithNotifications: (options?: CrudifyWithNotificationsOptions) => {
+    createItem: (moduleKey: string, data: object, options?: any) => Promise<CrudifyResponse>;
+    updateItem: (moduleKey: string, data: object, options?: any) => Promise<CrudifyResponse>;
+    deleteItem: (moduleKey: string, id: string, options?: any) => Promise<CrudifyResponse>;
+    readItem: (moduleKey: string, filter: object, options?: any) => Promise<CrudifyResponse>;
+    readItems: (moduleKey: string, filter: object, options?: any) => Promise<CrudifyResponse>;
+    transaction: (data: any, options?: any) => Promise<CrudifyResponse>;
+    handleResponse: (response: CrudifyResponse, successMessage?: string) => CrudifyResponse;
+    getErrorMessage: (response: CrudifyResponse) => string;
+    getErrorSeverity: (response: CrudifyResponse) => NotificationSeverity;
+    shouldShowNotification: (response: CrudifyResponse) => boolean;
+};
+
+export { type LoginResult as L, SessionManager as S, type TokenData as T, type UseSessionOptions as U, type SessionConfig as a, TokenStorage as b, type StorageType as c, type SessionState as d, useUserData as e, type UseUserDataReturn as f, type UseUserDataOptions as g, type UserData as h, useAuth as i, type UseAuthReturn as j, useData as k, type UseDataReturn as l, useUserProfile as m, useCrudifyWithNotifications as n, useSession as u };

package/dist/index-DxFMT2hN.d.ts

@@ -0,0 +1,78 @@
+import React from 'react';
+import './GlobalNotificationProvider-C3iWgM1z.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type BoxScreenType = "login" | "signUp" | "forgotPassword" | "resetPassword" | "checkCode";
+interface CrudifyLoginConfig {
+    publicApiKey?: string | null;
+    env?: "dev" | "stg" | "api" | "prod";
+    appName?: string;
+    logo?: string;
+    loginActions?: string[];
+}
+interface CrudifyLoginTranslations {
+    [key: string]: string | CrudifyLoginTranslations;
+}
+interface UserLoginData {
+    token: string;
+    username?: string;
+    email?: string;
+    userId?: string;
+    profile?: any;
+    [key: string]: any;
+}
+interface CrudifyLoginProps {
+    onScreenChange?: (screen: BoxScreenType, params?: Record<string, string>) => void;
+    onExternalNavigate?: (path: string) => void;
+    onLoginSuccess?: (userData: UserLoginData, redirectUrl?: string) => void;
+    onError?: (error: string) => void;
+    initialScreen?: BoxScreenType;
+    redirectUrl?: string;
+    autoReadFromCookies?: boolean;
+    translations?: CrudifyLoginTranslations;
+    translationsUrl?: string;
+    language?: string;
+}
+
+declare const CrudifyLogin: React.FC<CrudifyLoginProps>;
+
+interface UserProfileDisplayProps {
+    showExtendedData?: boolean;
+    showProfileCard?: boolean;
+    autoRefresh?: boolean;
+}
+declare const UserProfileDisplay: React.FC<UserProfileDisplayProps>;
+
+declare const POLICY_ACTIONS: readonly ["create", "read", "update", "delete"];
+type PolicyAction = typeof POLICY_ACTIONS[number];
+declare const PREFERRED_POLICY_ORDER: PolicyAction[];
+
+type Policy = {
+    id: string;
+    action: PolicyAction;
+    fields?: {
+        allow: string[];
+        owner_allow: string[];
+        deny: string[];
+    };
+    permission?: string;
+};
+type FieldErrorMap = string | ({
+    _error?: string;
+} & Record<string, string | undefined>);
+interface PoliciesProps {
+    policies: Policy[];
+    onChange: (next: Policy[]) => void;
+    availableFields: string[];
+    errors?: FieldErrorMap;
+    isSubmitting?: boolean;
+}
+declare const Policies: React.FC<PoliciesProps>;
+
+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;
+
+export { type BoxScreenType as B, CrudifyLogin as C, LoginComponent as L, Policies as P, SessionStatus as S, UserProfileDisplay as U, POLICY_ACTIONS as a, PREFERRED_POLICY_ORDER as b, type PolicyAction as c, type CrudifyLoginConfig as d, type CrudifyLoginProps as e, type CrudifyLoginTranslations as f, type UserLoginData as g };