@nocios/crudify-components 2.0.32 → 2.0.38

package/dist/errorTranslation-DDlAXpMl.d.ts

@@ -0,0 +1,141 @@
+import { J as JwtPayload } from './tenantConfig-DqJqQkoR.js';
+
+interface JWTPayload extends JwtPayload {
+    "cognito:username"?: string;
+}
+declare const decodeJwtSafely: (token: string) => JWTPayload | null;
+declare const getCurrentUserEmail: () => string | null;
+declare const isTokenExpired: (token: string) => boolean;
+
+declare class SecureStorage {
+    private readonly storage;
+    private encryptionKey;
+    private salt;
+    private initPromise;
+    private initialized;
+    constructor(storageType?: "localStorage" | "sessionStorage");
+    /**
+     * Initialize encryption key asynchronously
+     * Must be called before using encryption methods
+     */
+    private ensureInitialized;
+    private initialize;
+    private generateFingerprint;
+    private clearLegacyData;
+    setItem(key: string, value: string, expiryMinutes?: number): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): void;
+    clear(): void;
+    setToken(token: string): Promise<void>;
+    getToken(): Promise<string | null>;
+    hasValidToken(): Promise<boolean>;
+    migrateFromLocalStorage(key: string): Promise<void>;
+    private uint8ArrayToBase64;
+    private base64ToUint8Array;
+}
+declare const secureSessionStorage: SecureStorage;
+declare const secureLocalStorage: SecureStorage;
+
+declare const ERROR_CODES: {
+    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly INVALID_API_KEY: "INVALID_API_KEY";
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly USER_NOT_ACTIVE: "USER_NOT_ACTIVE";
+    readonly NO_PERMISSION: "NO_PERMISSION";
+    readonly ITEM_NOT_FOUND: "ITEM_NOT_FOUND";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly IN_USE: "IN_USE";
+    readonly FIELD_ERROR: "FIELD_ERROR";
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly INVALID_EMAIL: "INVALID_EMAIL";
+    readonly INVALID_CODE: "INVALID_CODE";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly DATABASE_CONNECTION_ERROR: "DATABASE_CONNECTION_ERROR";
+    readonly INVALID_CONFIGURATION: "INVALID_CONFIGURATION";
+    readonly UNKNOWN_OPERATION: "UNKNOWN_OPERATION";
+    readonly TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
+};
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+type ErrorSeverity = "info" | "warning" | "error" | "critical";
+declare const ERROR_SEVERITY_MAP: Record<ErrorCode, ErrorSeverity>;
+interface ParsedError {
+    code: ErrorCode;
+    message: string;
+    severity: ErrorSeverity;
+    field?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Parse a Crudify API response and extract standardized error information
+ */
+declare function parseApiError(response: unknown): ParsedError[];
+/**
+ * Parse transaction response errors
+ */
+declare function parseTransactionError(response: unknown): ParsedError[];
+/**
+ * Get a human-readable error message for an error code
+ */
+declare function getErrorMessage(code: ErrorCode): string;
+/**
+ * Handle JavaScript/Network errors and convert to ParsedError
+ */
+declare function parseJavaScriptError(error: unknown): ParsedError;
+/**
+ * Universal error handler that can process any type of error from Crudify APIs
+ */
+declare function handleCrudifyError(error: unknown): ParsedError[];
+
+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: {
+        data?: {
+            response?: {
+                status?: string;
+            };
+        };
+        status?: string;
+        code?: string;
+    } | null | undefined) => string;
+};
+
+export { ERROR_CODES as E, type ParsedError as P, secureLocalStorage as a, parseTransactionError as b, parseJavaScriptError as c, decodeJwtSafely as d, getErrorMessage as e, ERROR_SEVERITY_MAP as f, getCurrentUserEmail as g, handleCrudifyError as h, isTokenExpired as i, translateErrorCodes as j, translateError as k, createErrorTranslator as l, type ErrorCode as m, type ErrorSeverity as n, type ErrorTranslationConfig as o, parseApiError as p, secureSessionStorage as s, translateErrorCode as t };

package/dist/hooks.d.mts

@@ -1,6 +1,6 @@
-export { F as FileItem, v as FileStatus, d as SessionState, n as UseAuthReturn, p as UseDataReturn, s as UseFileUploadOptions, t as UseFileUploadReturn, U as UseSessionOptions, k as UseUserDataOptions, j as UseUserDataReturn, l as UserData, m as useAuth, w as useCrudifyWithNotifications, o as useData, r as useFileUpload, u as useSession, i as useUserData, q as useUserProfile } from './index-DY90WVQQ.mjs';
+export { F as FileItem, v as FileStatus, d as SessionState, n as UseAuthReturn, p as UseDataReturn, s as UseFileUploadOptions, t as UseFileUploadReturn, U as UseSessionOptions, k as UseUserDataOptions, j as UseUserDataReturn, l as UserData, m as useAuth, w as useCrudifyWithNotifications, o as useData, r as useFileUpload, u as useSession, i as useUserData, q as useUserProfile } from './index-U--xRr8A.mjs';
 export { A as AutoGenerateConfig, d as UseAutoGenerateOptions, U as UseAutoGenerateReturn, c as useAutoGenerate } from './GlobalNotificationProvider-Zq18OkpI.mjs';
-import './api-B4uXiHF0.mjs';
+import './tenantConfig-DqJqQkoR.mjs';
 import 'react/jsx-runtime';
 import 'react';
 import '@nocios/crudify-sdk';

package/dist/hooks.d.ts

@@ -1,6 +1,6 @@
-export { F as FileItem, v as FileStatus, d as SessionState, n as UseAuthReturn, p as UseDataReturn, s as UseFileUploadOptions, t as UseFileUploadReturn, U as UseSessionOptions, k as UseUserDataOptions, j as UseUserDataReturn, l as UserData, m as useAuth, w as useCrudifyWithNotifications, o as useData, r as useFileUpload, u as useSession, i as useUserData, q as useUserProfile } from './index-d1vE803G.js';
+export { F as FileItem, v as FileStatus, d as SessionState, n as UseAuthReturn, p as UseDataReturn, s as UseFileUploadOptions, t as UseFileUploadReturn, U as UseSessionOptions, k as UseUserDataOptions, j as UseUserDataReturn, l as UserData, m as useAuth, w as useCrudifyWithNotifications, o as useData, r as useFileUpload, u as useSession, i as useUserData, q as useUserProfile } from './index-dXVRVcEB.js';
 export { A as AutoGenerateConfig, d as UseAutoGenerateOptions, U as UseAutoGenerateReturn, c as useAutoGenerate } from './GlobalNotificationProvider-Zq18OkpI.js';
-import './api-B4uXiHF0.js';
+import './tenantConfig-DqJqQkoR.js';
 import 'react/jsx-runtime';
 import 'react';
 import '@nocios/crudify-sdk';

package/dist/hooks.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkT6R65ROUjs = require('./chunk-T6R65ROU.js');var _chunk6ONAT4QUjs = require('./chunk-6ONAT4QU.js');require('./chunk-CR5KJUST.js');exports.useAuth = _chunkT6R65ROUjs.b; exports.useAutoGenerate = _chunk6ONAT4QUjs.o; exports.useCrudifyWithNotifications = _chunkT6R65ROUjs.d; exports.useData = _chunkT6R65ROUjs.c; exports.useFileUpload = _chunk6ONAT4QUjs.r; exports.useSession = _chunk6ONAT4QUjs.e; exports.useUserData = _chunkT6R65ROUjs.a; exports.useUserProfile = _chunk6ONAT4QUjs.n;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkNIRLP2TCjs = require('./chunk-NIRLP2TC.js');var _chunkH6XXWDUTjs = require('./chunk-H6XXWDUT.js');require('./chunk-4LMFQECS.js');exports.useAuth = _chunkNIRLP2TCjs.b; exports.useAutoGenerate = _chunkH6XXWDUTjs.o; exports.useCrudifyWithNotifications = _chunkNIRLP2TCjs.d; exports.useData = _chunkNIRLP2TCjs.c; exports.useFileUpload = _chunkH6XXWDUTjs.r; exports.useSession = _chunkH6XXWDUTjs.e; exports.useUserData = _chunkNIRLP2TCjs.a; exports.useUserProfile = _chunkH6XXWDUTjs.n;

package/dist/hooks.mjs

@@ -1 +1 @@
-import{a as s,b as p,c as u,d as a}from"./chunk-H5M2Q6PB.mjs";import{e,n as t,o,r}from"./chunk-PTUSZGL4.mjs";import"./chunk-4ILUXVPW.mjs";export{p as useAuth,o as useAutoGenerate,a as useCrudifyWithNotifications,u as useData,r as useFileUpload,e as useSession,s as useUserData,t as useUserProfile};
+import{a as s,b as p,c as u,d as a}from"./chunk-77UKXG5L.mjs";import{e,n as t,o,r}from"./chunk-O4FUHIQG.mjs";import"./chunk-44VU4TSP.mjs";export{p as useAuth,o as useAutoGenerate,a as useCrudifyWithNotifications,u as useData,r as useFileUpload,e as useSession,s as useUserData,t as useUserProfile};

package/dist/{index-DY90WVQQ.d.mts → index-U--xRr8A.d.mts}

@@ -1,8 +1,8 @@
-import { U as UserProfile, e as CrudifyRequestOptions, C as CrudifyApiResponse, g as TransactionInput, d as CrudifyOperationOptions } from './api-B4uXiHF0.mjs';
+import { U as UserProfile, m as CrudifyRequestOptions, f as CrudifyApiResponse, o as TransactionInput, l as CrudifyOperationOptions } from './tenantConfig-DqJqQkoR.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { b as NotificationSeverity } from './GlobalNotificationProvider-Zq18OkpI.mjs';
 import { CrudifyResponse } from '@nocios/crudify-sdk';
+import { b as NotificationSeverity } from './GlobalNotificationProvider-Zq18OkpI.mjs';
 
 type TokenData = {
     accessToken: string;
@@ -462,6 +462,199 @@ declare function useSessionContext(): SessionContextType;
  */
 declare function SessionDebugInfo(): react_jsx_runtime.JSX.Element;
 
+/**
+ * Individual file status
+ */
+type FileStatus = "pending" | "uploading" | "completed" | "error" | "removing" | "pendingDeletion";
+/**
+ * Represents a file in the system
+ */
+interface FileItem {
+    /** Unique file ID (generated or from server) */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** Size in bytes */
+    size: number;
+    /** MIME content type */
+    contentType: string;
+    /** Current file status */
+    status: FileStatus;
+    /** Upload progress (0-100) */
+    progress: number;
+    /**
+     * Relative file path (includes visibility)
+     * Format: "public/path/file.ext" or "private/path/file.ext"
+     */
+    filePath?: string;
+    /**
+     * File visibility
+     * Extracted from filePath for convenience
+     */
+    visibility?: "public" | "private";
+    /** Public URL for public files */
+    publicUrl?: string;
+    /** Preview URL (for images) */
+    previewUrl?: string;
+    /** Error message if failed */
+    errorMessage?: string;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Original file (only during upload) */
+    file?: File;
+    /** Whether this file existed before (was loaded from server) */
+    isExisting?: boolean;
+}
+/**
+ * Hook configuration
+ */
+interface UseFileUploadOptions {
+    /** Allowed MIME types (e.g., ["image/png", "image/jpeg", "application/pdf"]) */
+    acceptedTypes?: string[];
+    /** Maximum file size in bytes (default: 10MB) */
+    maxFileSize?: number;
+    /** Maximum number of files (undefined = no limit) */
+    maxFiles?: number;
+    /** Minimum number of required files (default: 0) */
+    minFiles?: number;
+    /**
+     * Visibility of uploaded files
+     * @default "private"
+     */
+    visibility?: "public" | "private";
+    /** Callback when an upload completes successfully */
+    onUploadComplete?: (file: FileItem) => void;
+    /** Callback when an upload fails */
+    onUploadError?: (file: FileItem, error: string) => void;
+    /** Callback when a file is removed */
+    onFileRemoved?: (file: FileItem) => void;
+    /** Callback when the file list changes */
+    onFilesChange?: (files: FileItem[]) => void;
+    /** Form mode: 'create' or 'edit' - affects delete behavior */
+    mode?: "create" | "edit";
+}
+/**
+ * Hook return type
+ */
+interface UseFileUploadReturn {
+    /** Current file list */
+    files: FileItem[];
+    /** Active files (excluding pendingDeletion) */
+    activeFiles: FileItem[];
+    /** Count of active files */
+    activeFileCount: number;
+    /** Whether uploads are in progress */
+    isUploading: boolean;
+    /** Number of pending uploads */
+    pendingCount: number;
+    /** Add files (triggers automatic upload) */
+    addFiles: (files: FileList | File[]) => Promise<void>;
+    /** Remove a file - returns whether confirmation is needed */
+    removeFile: (fileId: string) => Promise<{
+        needsConfirmation: boolean;
+        isExisting: boolean;
+    }>;
+    /** Delete a file immediately from server (for new files or create mode) */
+    deleteFileImmediately: (fileId: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Restore a file that was marked for deletion */
+    restoreFile: (fileId: string) => boolean;
+    /** Clear all files */
+    clearFiles: () => void;
+    /** Retry upload for a failed file */
+    retryUpload: (fileId: string) => Promise<void>;
+    /** Validate if minimum requirements are met */
+    isValid: boolean;
+    /** Validation error message (i18n key) */
+    validationError: string | null;
+    /** Validation error i18n key */
+    validationErrorKey: string | null;
+    /** Validation error params for i18n interpolation */
+    validationErrorParams: Record<string, string | number>;
+    /** Wait for all uploads to complete and return completed file paths */
+    waitForUploads: () => Promise<string[]>;
+    /**
+     * Completed file paths (for saving in form)
+     * Relative paths with visibility - subscriberKey is added in backend
+     */
+    completedFilePaths: string[];
+    /** Initialize with existing files (for editing) */
+    initializeFiles: (existingFiles: Array<{
+        filePath: string;
+        name: string;
+        size?: number;
+        contentType?: string;
+    }>, baseUrl?: string) => void;
+    /** Whether the user has interacted with the field */
+    isTouched: boolean;
+    /** Mark the field as touched (to show validation errors) */
+    markAsTouched: () => void;
+    /** Whether the form has been submitted */
+    isSubmitted: boolean;
+    /** Mark the form as submitted (to show all validation errors) */
+    markAsSubmitted: () => void;
+    /**
+     * Get URL for file preview
+     * - Public: returns publicUrl directly
+     * - Private: requests signed URL from backend
+     */
+    getPreviewUrl: (fileId: string) => Promise<string | null>;
+    /** List of file IDs pending deletion */
+    pendingDeletions: string[];
+    /** Whether there are files pending deletion */
+    hasPendingDeletions: boolean;
+    /** Execute all pending deletions (call this on form submit) */
+    commitDeletions: () => Promise<{
+        success: boolean;
+        errors: string[];
+    }>;
+    /** Cancel all pending deletions and restore files */
+    restorePendingDeletions: () => void;
+}
+
+/**
+ * Complete hook for file handling with:
+ * - Progressive upload to S3 with pre-signed URLs
+ * - Per-file progress tracking
+ * - Type and size validation
+ * - Soft delete (disableFile)
+ * - Multiple file support
+ */
+
+/**
+ * Hook for complete file handling with S3 upload
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   files,
+ *   addFiles,
+ *   removeFile,
+ *   isUploading,
+ *   isValid,
+ *   completedS3Keys
+ * } = useFileUpload({
+ *   acceptedTypes: ["image/png", "image/jpeg", "application/pdf"],
+ *   maxFileSize: 5 * 1024 * 1024, // 5MB
+ *   maxFiles: 3,
+ *   minFiles: 1
+ * });
+ *
+ * // In form submit
+ * const handleSubmit = async () => {
+ *   await waitForUploads(); // Wait for pending uploads
+ *   if (!isValid) return;
+ *
+ *   await crudify.createItem("documents", {
+ *     files: completedS3Keys
+ *   });
+ * };
+ * ```
+ */
+declare const useFileUpload: (options?: UseFileUploadOptions) => UseFileUploadReturn;
+
 /**
  * Complete user data structure (compatible con legacy)
  */
@@ -651,202 +844,20 @@ interface UseUserProfileReturn {
 declare const useUserProfile: (options?: UseUserProfileOptions) => UseUserProfileReturn;
 
 /**
- * Complete hook for file handling with:
- * - Progressive upload to S3 with pre-signed URLs
- * - Per-file progress tracking
- * - Type and size validation
- * - Soft delete (disableFile)
- * - Multiple file support
- */
-/**
- * Individual file status
- */
-type FileStatus = "pending" | "uploading" | "completed" | "error" | "removing" | "pendingDeletion";
-/**
- * Represents a file in the system
- */
-interface FileItem {
-    /** Unique file ID (generated or from server) */
-    id: string;
-    /** Original file name */
-    name: string;
-    /** Size in bytes */
-    size: number;
-    /** MIME content type */
-    contentType: string;
-    /** Current file status */
-    status: FileStatus;
-    /** Upload progress (0-100) */
-    progress: number;
-    /**
-     * Relative file path (includes visibility)
-     * Format: "public/path/file.ext" or "private/path/file.ext"
-     */
-    filePath?: string;
-    /**
-     * File visibility
-     * Extracted from filePath for convenience
-     */
-    visibility?: "public" | "private";
-    /** Public URL for public files */
-    publicUrl?: string;
-    /** Preview URL (for images) */
-    previewUrl?: string;
-    /** Error message if failed */
-    errorMessage?: string;
-    /** Creation timestamp */
-    createdAt: number;
-    /** Original file (only during upload) */
-    file?: File;
-    /** Whether this file existed before (was loaded from server) */
-    isExisting?: boolean;
-}
-/**
- * Hook configuration
+ * Types and interfaces for useCrudifyWithNotifications
  */
-interface UseFileUploadOptions {
-    /** Allowed MIME types (e.g., ["image/png", "image/jpeg", "application/pdf"]) */
-    acceptedTypes?: string[];
-    /** Maximum file size in bytes (default: 10MB) */
-    maxFileSize?: number;
-    /** Maximum number of files (undefined = no limit) */
-    maxFiles?: number;
-    /** Minimum number of required files (default: 0) */
-    minFiles?: number;
-    /**
-     * Visibility of uploaded files
-     * @default "private"
-     */
-    visibility?: "public" | "private";
-    /** Callback when an upload completes successfully */
-    onUploadComplete?: (file: FileItem) => void;
-    /** Callback when an upload fails */
-    onUploadError?: (file: FileItem, error: string) => void;
-    /** Callback when a file is removed */
-    onFileRemoved?: (file: FileItem) => void;
-    /** Callback when the file list changes */
-    onFilesChange?: (files: FileItem[]) => void;
-    /** Form mode: 'create' or 'edit' - affects delete behavior */
-    mode?: "create" | "edit";
-}
-/**
- * Hook return type
- */
-interface UseFileUploadReturn {
-    /** Current file list */
-    files: FileItem[];
-    /** Active files (excluding pendingDeletion) */
-    activeFiles: FileItem[];
-    /** Count of active files */
-    activeFileCount: number;
-    /** Whether uploads are in progress */
-    isUploading: boolean;
-    /** Number of pending uploads */
-    pendingCount: number;
-    /** Add files (triggers automatic upload) */
-    addFiles: (files: FileList | File[]) => Promise<void>;
-    /** Remove a file - returns whether confirmation is needed */
-    removeFile: (fileId: string) => Promise<{
-        needsConfirmation: boolean;
-        isExisting: boolean;
-    }>;
-    /** Delete a file immediately from server (for new files or create mode) */
-    deleteFileImmediately: (fileId: string) => Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    /** Restore a file that was marked for deletion */
-    restoreFile: (fileId: string) => boolean;
-    /** Clear all files */
-    clearFiles: () => void;
-    /** Retry upload for a failed file */
-    retryUpload: (fileId: string) => Promise<void>;
-    /** Validate if minimum requirements are met */
-    isValid: boolean;
-    /** Validation error message (i18n key) */
-    validationError: string | null;
-    /** Validation error i18n key */
-    validationErrorKey: string | null;
-    /** Validation error params for i18n interpolation */
-    validationErrorParams: Record<string, string | number>;
-    /** Wait for all uploads to complete and return completed file paths */
-    waitForUploads: () => Promise<string[]>;
-    /**
-     * Completed file paths (for saving in form)
-     * Relative paths with visibility - subscriberKey is added in backend
-     */
-    completedFilePaths: string[];
-    /** Initialize with existing files (for editing) */
-    initializeFiles: (existingFiles: Array<{
-        filePath: string;
-        name: string;
-        size?: number;
-        contentType?: string;
-    }>, baseUrl?: string) => void;
-    /** Whether the user has interacted with the field */
-    isTouched: boolean;
-    /** Mark the field as touched (to show validation errors) */
-    markAsTouched: () => void;
-    /** Whether the form has been submitted */
-    isSubmitted: boolean;
-    /** Mark the form as submitted (to show all validation errors) */
-    markAsSubmitted: () => void;
-    /**
-     * Get URL for file preview
-     * - Public: returns publicUrl directly
-     * - Private: requests signed URL from backend
-     */
-    getPreviewUrl: (fileId: string) => Promise<string | null>;
-    /** List of file IDs pending deletion */
-    pendingDeletions: string[];
-    /** Whether there are files pending deletion */
-    hasPendingDeletions: boolean;
-    /** Execute all pending deletions (call this on form submit) */
-    commitDeletions: () => Promise<{
-        success: boolean;
-        errors: string[];
-    }>;
-    /** Cancel all pending deletions and restore files */
-    restorePendingDeletions: () => void;
-}
+
 /**
- * Hook for complete file handling with S3 upload
- *
- * @example
- * ```tsx
- * const {
- *   files,
- *   addFiles,
- *   removeFile,
- *   isUploading,
- *   isValid,
- *   completedS3Keys
- * } = useFileUpload({
- *   acceptedTypes: ["image/png", "image/jpeg", "application/pdf"],
- *   maxFileSize: 5 * 1024 * 1024, // 5MB
- *   maxFiles: 3,
- *   minFiles: 1
- * });
- *
- * // In form submit
- * const handleSubmit = async () => {
- *   await waitForUploads(); // Wait for pending uploads
- *   if (!isValid) return;
- *
- *   await crudify.createItem("documents", {
- *     files: completedS3Keys
- *   });
- * };
- * ```
+ * App structure action configuration
  */
-declare const useFileUpload: (options?: UseFileUploadOptions) => UseFileUploadReturn;
-
-/** App structure action configuration */
 interface AppStructureAction {
     key: string;
     moduleKey?: string;
     [key: string]: unknown;
 }
+/**
+ * Options for the useCrudifyWithNotifications hook
+ */
 interface CrudifyWithNotificationsOptions {
     showSuccessNotifications?: boolean;
     showErrorNotifications?: boolean;
@@ -856,6 +867,29 @@ interface CrudifyWithNotificationsOptions {
     appStructure?: AppStructureAction[];
     translateFn?: (key: string, options?: Record<string, unknown>) => string;
 }
+
+/**
+ * Notification filtering utilities
+ *
+ * Determines when and which notifications should be shown
+ */
+
+/**
+ * Determines if a notification should be shown for a given response
+ *
+ * Returns false for:
+ * - Field validation errors (these go to form validation)
+ * - ONE_OR_MORE_OPERATIONS_FAILED (generic transaction error)
+ * - TOO_MANY_REQUESTS (handled by forms)
+ */
+declare function shouldShowNotification(response: CrudifyResponse): boolean;
+
+/**
+ * Hook that wraps crudify SDK operations with automatic notifications
+ *
+ * @param options - Configuration options
+ * @returns Object with wrapped CRUD operations and utility functions
+ */
 declare const useCrudifyWithNotifications: (options?: CrudifyWithNotificationsOptions) => {
     createItem: (moduleKey: string, data: object, options?: CrudifyOperationOptions) => Promise<CrudifyResponse>;
     updateItem: (moduleKey: string, data: object, options?: CrudifyOperationOptions) => Promise<CrudifyResponse>;
@@ -866,7 +900,7 @@ declare const useCrudifyWithNotifications: (options?: CrudifyWithNotificationsOp
     handleResponse: (response: CrudifyResponse, successMessage?: string) => CrudifyResponse;
     getErrorMessage: (response: CrudifyResponse) => string;
     getErrorSeverity: (response: CrudifyResponse) => NotificationSeverity;
-    shouldShowNotification: (response: CrudifyResponse) => boolean;
+    shouldShowNotification: typeof shouldShowNotification;
 };
 
 export { type FileItem as F, type LoginResult as L, type NotificationOptions as N, SessionManager as S, TokenStorage as T, type UseSessionOptions as U, type SessionConfig as a, type TokenData as b, type StorageType as c, type SessionState as d, SessionProvider as e, useSessionContext as f, SessionDebugInfo as g, type SessionProviderProps as h, useUserData as i, type UseUserDataReturn as j, type UseUserDataOptions as k, type UserData as l, useAuth as m, type UseAuthReturn as n, useData as o, type UseDataReturn as p, useUserProfile as q, useFileUpload as r, type UseFileUploadOptions as s, type UseFileUploadReturn as t, useSession as u, type FileStatus as v, useCrudifyWithNotifications as w };