@nocios/crudify-ui 3.0.20 → 3.0.24

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { CrudifyResponse } from '@nocios/crudify-browser';
 export * from '@nocios/crudify-browser';
 export { default as crudify } from '@nocios/crudify-browser';
 import React, { ReactNode } from 'react';
@@ -378,15 +379,27 @@ type SessionContextType = {
     expiresIn: number;
     refreshExpiresIn: number;
 };
+type NotificationOptions = {
+    enabled?: boolean;
+    maxNotifications?: number;
+    defaultAutoHideDuration?: number;
+    position?: {
+        vertical: "top" | "bottom";
+        horizontal: "left" | "center" | "right";
+    };
+};
 type SessionProviderProps = {
     children: ReactNode;
     options?: UseSessionOptions;
     config?: CrudifyConfig;
+    showNotifications?: boolean;
+    notificationOptions?: NotificationOptions;
 };
 /**
  * Provider de sesión para envolver la aplicación
  */
-declare function SessionProvider({ children, options, config: propConfig }: SessionProviderProps): react_jsx_runtime.JSX.Element;
+declare function SessionProvider({ children, options, config: propConfig, showNotifications, // ✅ Por defecto DESACTIVADO
+notificationOptions, }: SessionProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook para usar el contexto de sesión
  */
@@ -675,4 +688,100 @@ declare function parseJavaScriptError(error: unknown): ParsedError;
  */
 declare function handleCrudifyError(error: unknown): ParsedError[];
 
-export { type ApiError, type BoxScreenType, type CrudifyApiResponse, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, POLICY_ACTIONS, PREFERRED_POLICY_ORDER, type ParsedError, Policies, type PolicyAction, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseAuthReturn, type UseDataReturn, type UseSessionOptions, type UseUserDataOptions, type UseUserDataReturn, type UserData, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, decodeJwtSafely, getCookie, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, useAuth, useData, useSession, useSessionContext, useUserData, useUserProfile };
+/**
+ * Utilidad robusta para traducir códigos de error con fallbacks inteligentes
+ * Busca en múltiples namespaces y devuelve la traducción más específica disponible
+ */
+interface ErrorTranslationConfig {
+    /** Función de traducción de i18next */
+    translateFn: (key: string) => string;
+    /** Idioma actual (opcional, para logging) */
+    currentLanguage?: string;
+    /** Habilitar logs de debug */
+    enableDebug?: boolean;
+}
+/**
+ * Traduce un código de error usando jerarquía de fallbacks
+ */
+declare function translateErrorCode(errorCode: string, config: ErrorTranslationConfig): string;
+/**
+ * Traduce múltiples códigos de error
+ */
+declare function translateErrorCodes(errorCodes: string[], config: ErrorTranslationConfig): string[];
+/**
+ * Traduce un error completo (código + mensaje personalizado)
+ */
+declare function translateError(error: {
+    code: string;
+    message?: string;
+    field?: string;
+}, config: ErrorTranslationConfig): string;
+/**
+ * Hook para usar en componentes React con i18next
+ */
+declare function createErrorTranslator(translateFn: (key: string) => string, options?: {
+    currentLanguage?: string;
+    enableDebug?: boolean;
+}): {
+    translateErrorCode: (code: string) => string;
+    translateErrorCodes: (codes: string[]) => string[];
+    translateError: (error: {
+        code: string;
+        message?: string;
+        field?: string;
+    }) => string;
+    translateApiError: (apiResponse: any) => string;
+};
+
+type NotificationSeverity = "error" | "info" | "success" | "warning";
+interface Notification {
+    id: string;
+    message: string;
+    severity: NotificationSeverity;
+    autoHideDuration?: number;
+    persistent?: boolean;
+}
+interface GlobalNotificationContextValue {
+    showNotification: (message: string, severity?: NotificationSeverity, options?: {
+        autoHideDuration?: number;
+        persistent?: boolean;
+    }) => string;
+    hideNotification: (id: string) => void;
+    clearAllNotifications: () => void;
+}
+interface GlobalNotificationProviderProps {
+    children: React.ReactNode;
+    maxNotifications?: number;
+    defaultAutoHideDuration?: number;
+    position?: {
+        vertical: "top" | "bottom";
+        horizontal: "left" | "center" | "right";
+    };
+    enabled?: boolean;
+}
+declare const GlobalNotificationProvider: React.FC<GlobalNotificationProviderProps>;
+declare const useGlobalNotification: () => GlobalNotificationContextValue;
+
+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 ApiError, type BoxScreenType, type CrudifyApiResponse, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ErrorTranslationConfig, type ForgotPasswordRequest, GlobalNotificationProvider, type GlobalNotificationProviderProps, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, type Notification, type NotificationOptions, type NotificationSeverity, POLICY_ACTIONS, PREFERRED_POLICY_ORDER, type ParsedError, Policies, type PolicyAction, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseAuthReturn, type UseDataReturn, type UseSessionOptions, type UseUserDataOptions, type UseUserDataReturn, type UserData, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, createErrorTranslator, decodeJwtSafely, getCookie, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, translateError, translateErrorCode, translateErrorCodes, useAuth, useCrudifyWithNotifications, useData, useGlobalNotification, useSession, useSessionContext, useUserData, useUserProfile };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { CrudifyResponse } from '@nocios/crudify-browser';
 export * from '@nocios/crudify-browser';
 export { default as crudify } from '@nocios/crudify-browser';
 import React, { ReactNode } from 'react';
@@ -378,15 +379,27 @@ type SessionContextType = {
     expiresIn: number;
     refreshExpiresIn: number;
 };
+type NotificationOptions = {
+    enabled?: boolean;
+    maxNotifications?: number;
+    defaultAutoHideDuration?: number;
+    position?: {
+        vertical: "top" | "bottom";
+        horizontal: "left" | "center" | "right";
+    };
+};
 type SessionProviderProps = {
     children: ReactNode;
     options?: UseSessionOptions;
     config?: CrudifyConfig;
+    showNotifications?: boolean;
+    notificationOptions?: NotificationOptions;
 };
 /**
  * Provider de sesión para envolver la aplicación
  */
-declare function SessionProvider({ children, options, config: propConfig }: SessionProviderProps): react_jsx_runtime.JSX.Element;
+declare function SessionProvider({ children, options, config: propConfig, showNotifications, // ✅ Por defecto DESACTIVADO
+notificationOptions, }: SessionProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook para usar el contexto de sesión
  */
@@ -675,4 +688,100 @@ declare function parseJavaScriptError(error: unknown): ParsedError;
  */
 declare function handleCrudifyError(error: unknown): ParsedError[];
 
-export { type ApiError, type BoxScreenType, type CrudifyApiResponse, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, POLICY_ACTIONS, PREFERRED_POLICY_ORDER, type ParsedError, Policies, type PolicyAction, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseAuthReturn, type UseDataReturn, type UseSessionOptions, type UseUserDataOptions, type UseUserDataReturn, type UserData, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, decodeJwtSafely, getCookie, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, useAuth, useData, useSession, useSessionContext, useUserData, useUserProfile };
+/**
+ * Utilidad robusta para traducir códigos de error con fallbacks inteligentes
+ * Busca en múltiples namespaces y devuelve la traducción más específica disponible
+ */
+interface ErrorTranslationConfig {
+    /** Función de traducción de i18next */
+    translateFn: (key: string) => string;
+    /** Idioma actual (opcional, para logging) */
+    currentLanguage?: string;
+    /** Habilitar logs de debug */
+    enableDebug?: boolean;
+}
+/**
+ * Traduce un código de error usando jerarquía de fallbacks
+ */
+declare function translateErrorCode(errorCode: string, config: ErrorTranslationConfig): string;
+/**
+ * Traduce múltiples códigos de error
+ */
+declare function translateErrorCodes(errorCodes: string[], config: ErrorTranslationConfig): string[];
+/**
+ * Traduce un error completo (código + mensaje personalizado)
+ */
+declare function translateError(error: {
+    code: string;
+    message?: string;
+    field?: string;
+}, config: ErrorTranslationConfig): string;
+/**
+ * Hook para usar en componentes React con i18next
+ */
+declare function createErrorTranslator(translateFn: (key: string) => string, options?: {
+    currentLanguage?: string;
+    enableDebug?: boolean;
+}): {
+    translateErrorCode: (code: string) => string;
+    translateErrorCodes: (codes: string[]) => string[];
+    translateError: (error: {
+        code: string;
+        message?: string;
+        field?: string;
+    }) => string;
+    translateApiError: (apiResponse: any) => string;
+};
+
+type NotificationSeverity = "error" | "info" | "success" | "warning";
+interface Notification {
+    id: string;
+    message: string;
+    severity: NotificationSeverity;
+    autoHideDuration?: number;
+    persistent?: boolean;
+}
+interface GlobalNotificationContextValue {
+    showNotification: (message: string, severity?: NotificationSeverity, options?: {
+        autoHideDuration?: number;
+        persistent?: boolean;
+    }) => string;
+    hideNotification: (id: string) => void;
+    clearAllNotifications: () => void;
+}
+interface GlobalNotificationProviderProps {
+    children: React.ReactNode;
+    maxNotifications?: number;
+    defaultAutoHideDuration?: number;
+    position?: {
+        vertical: "top" | "bottom";
+        horizontal: "left" | "center" | "right";
+    };
+    enabled?: boolean;
+}
+declare const GlobalNotificationProvider: React.FC<GlobalNotificationProviderProps>;
+declare const useGlobalNotification: () => GlobalNotificationContextValue;
+
+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 ApiError, type BoxScreenType, type CrudifyApiResponse, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ErrorTranslationConfig, type ForgotPasswordRequest, GlobalNotificationProvider, type GlobalNotificationProviderProps, type JwtPayload, LoginComponent, type LoginRequest, type LoginResponse, type LoginResult, type Notification, type NotificationOptions, type NotificationSeverity, POLICY_ACTIONS, PREFERRED_POLICY_ORDER, type ParsedError, Policies, type PolicyAction, ProtectedRoute, type ProtectedRouteProps, type ResetPasswordRequest, type SessionConfig, SessionDebugInfo, SessionManager, SessionProvider, type SessionProviderProps, type SessionState, SessionStatus, type StorageType, type TokenData, TokenStorage, type TransactionResponseData, type UseAuthReturn, type UseDataReturn, type UseSessionOptions, type UseUserDataOptions, type UseUserDataReturn, type UserData, type UserLoginData, type UserProfile, UserProfileDisplay, type ValidateCodeRequest, type ValidationError, createErrorTranslator, decodeJwtSafely, getCookie, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, translateError, translateErrorCode, translateErrorCodes, useAuth, useCrudifyWithNotifications, useData, useGlobalNotification, useSession, useSessionContext, useUserData, useUserProfile };