@emailmaker/filemanager 0.10.30 → 0.10.31

package/notification.d.ts

@@ -1,5 +1,17 @@
+interface FileManageErrorInfo {
+  message?: string;            
+  code?: FileManagerErrorCode;
+  status?: number;
+  raw?: any; 
+  stack?: string;
+}
+
+
+/**
+ * Error codes for FileManager API operations.
+ */
 type FileManagerErrorCode =
-  // --- Файлы ---
+  // --- Files ---
   | 'FileNotFound'
   | 'FileAlreadyExists'
   | 'FileInvalidName'
@@ -10,8 +22,11 @@ type FileManagerErrorCode =
   | 'FileTypeNotAllowed'
   | 'FileCorrupted'
   | 'FileChecksumMismatch'
+  | 'FileStorageQuotaExceeded'
+  | 'FileLocked'
+  | 'FileVersionConflict'
 
-  // --- Папки / каталоги ---
+  // --- Folders / directories ---
   | 'FolderNotFound'
   | 'FolderAlreadyExists'
   | 'FolderInvalidName'
@@ -23,45 +38,47 @@ type FileManagerErrorCode =
   | 'FolderBackendError'
   | 'FolderTimeout'
 
-  // --- Операционные ограничения ---
+  // --- Operational restrictions ---
   | 'RenameNotAllowed'
   | 'MoveNotAllowed'
   | 'CopyNotAllowed'
   | 'DeleteNotAllowed'
   | 'MoveIntoSelf'
   | 'MoveIntoDescendant'
+  | 'CopyIntoSelf'
   | 'UnsupportedOperation'
   | 'ConfigError'
 
-  // --- Загрузка файлов ---
+  // --- File upload ---
   | 'FileUploadQuotaExceeded'
   | 'FileUploadNetworkError'
   | 'FileUploadTimeout'
   | 'FileUploadBackendError'
 
-  // --- Загрузка по URL ---
+  // --- URL upload ---
   | 'UploadUrlInvalid'
   | 'UploadUrlNotReachable'
   | 'UploadUrlContentTypeNotAllowed'
   | 'UploadUrlDownloadFailed'
 
-  // --- Скачивание файлов ---
+  // --- File download ---
   | 'FileDownloadNetworkError'
   | 'FileDownloadTimeout'
   | 'FileDownloadBackendError'
 
-  // --- Батчевые операции ---
+  // --- Batch operations ---
   | 'BatchPartialFailure'
   | 'BatchAllFailed'
   | 'BatchConflict'
   | 'BatchValidationFailed'
+  | 'BatchItemLimitExceeded'
 
-  // --- Валидация / данные ---
+  // --- Validation / data ---
   | 'ValidationError'
   | 'PayloadTooLarge'
   | 'UnsupportedMediaType'
 
-  // --- Сеть / сервер / инфраструктура ---
+  // --- Network / server / infrastructure ---
   | 'NetworkError'
   | 'BackendError'
   | 'Timeout'
@@ -70,35 +87,35 @@ type FileManagerErrorCode =
   | 'RateLimitExceeded'
   | 'ServiceUnavailable'
 
-  // --- AI / интеграции ---
+  // --- AI / integrations ---
   | 'AIResponseInvalid'
   | 'AIImageGenerationFailed'
   | 'AIImageGenerationLimitExceeded'
   | 'IntegrationError'
   | 'ThirdPartyError'
 
-  // --- Общее / запасной вариант ---
+  // --- General / fallback ---
   | 'UnknownError';
 
 /**
- * Интерфейс ошибки для FileManager API.
- * Реализован классом FileManagerApiError, который также экспортируется.
+ * Error interface for FileManager API.
+ * Implemented by FileManagerApiError class which is also exported.
  *
  * @example
  * ```typescript
- * // Использование класса
+ * // Using the class
  * throw new FileManagerApiError(
  *   'File not found',
  *   'FileNotFound',
  *   404
  * );
  *
- * // Или создание собственного класса
+ * // Or creating a custom class
  * class MyFileManagerError extends Error implements IFileManagerApiError {
  *   constructor(
  *     message: string,
  *     public code: FileManagerErrorCode,
- *     public httpStatus?: number,
+ *     public status?: number,
  *     public details?: unknown
  *   ) {
  *     super(message);
@@ -109,10 +126,13 @@ type FileManagerErrorCode =
  */
 interface IFileManagerApiError extends Error {
   code: FileManagerErrorCode;
-  httpStatus?: number;
+  status?: number;
   details?: unknown;
 }
 
+/**
+ * Parameters for file query operations.
+ */
 interface FilesQueryParams {
   folderId?: string;
   search?: string;
@@ -123,6 +143,9 @@ interface FilesQueryParams {
   itemType?: 'file' | 'folder' | 'all';
 }
 
+/**
+ * Context payload for operations involving items (files/folders).
+ */
 interface ItemContextPayload {
   itemIds?: string[];
   itemNames?: string[];
@@ -130,6 +153,9 @@ interface ItemContextPayload {
   folderName?: string | null;
 }
 
+/**
+ * Placement options for notification display.
+ */
 type NotifyPlacement = 'top' | 'topLeft' | 'topRight' | 'bottom' | 'bottomLeft' | 'bottomRight';
 
 type Notify = {
@@ -150,25 +176,90 @@ type Notify = {
 };
 
 declare namespace Notify {
+  /**
+   * Payload for successful batch operations.
+   */
   export interface OperationSuccessPayload extends ItemContextPayload {
     successCount: number;
     totalCount: number;
   }
 
+  /**
+   * Details of an error for a single item in a batch operation.
+   */
   export interface OperationErrorDetail {
     itemId?: string;
     itemName?: string;
-    reason?: string;
-    code?: FileManagerErrorCode;
-    httpStatus?: number;
+    error: FileManageErrorInfo;
   }
 
+  /**
+   * Payload for batch operation errors.
+   * Extends ItemContextPayload with error-specific fields.
+   */
   export interface OperationErrorPayload extends ItemContextPayload {
     failCount: number;
     totalCount: number;
     errors?: OperationErrorDetail[];
+    /**
+     * Flag indicating if this is a move-to-trash operation (true) or permanent delete (false).
+     * Used to differentiate between soft delete (trash) and hard delete operations.
+     */
+    isTrashMove?: boolean;
+  }
+
+  /**
+   * Details of a single item in batch operation results.
+   * Used in the `detailed` array for batch operations (deleteItems, moveItems, copyItems, uploadFiles).
+   * 
+   * @template T - Type of successful operation result data
+   */
+  export interface BatchOperationDetail<T = unknown> {
+    /** Correlation identifier for the request item (preferred) */
+    requestId?: string;
+    /** Item identifier (for backward compatibility) */
+    id?: string;
+    /** Success flag for the operation */
+    success: boolean;
+    /** Successful operation result data */
+    data?: T;
+    /** Error for failed operation */
+    error?: FileManageErrorInfo;
   }
 
+  /**
+   * Result of a batch operation with support for detailed results.
+   * Unified type for all batch operations in the file manager.
+   * 
+   * @template T - Type of successful operation result data
+   */
+  export interface BatchOperationResult<T = unknown> {
+    /** Overall success flag (true if all items succeeded) */
+    success: boolean;
+    /** Overall operation error (if the entire operation failed) */
+    error?: string | unknown;
+    /** Detailed results for each item */
+    detailed?: BatchOperationDetail<T>[];
+  }
+
+  /**
+   * Summary of batch operation results for notifications.
+   * Used for aggregated error and success notifications.
+   */
+  export interface BatchOperationSummary {
+    /** Number of successfully processed items */
+    successCount: number;
+    /** Number of items with errors */
+    failCount: number;
+    /** Total number of items */
+    totalCount: number;
+    /** Error details for each item */
+    errors: OperationErrorDetail[];
+  }
+
+  /**
+   * Payload for operations involving a single item (file or folder).
+   */
   export interface SingleItemPayload {
     itemId?: string;
     itemName?: string;
@@ -176,24 +267,37 @@ declare namespace Notify {
     folderName?: string | null;
   }
 
+  /**
+   * Payload for rename operation errors.
+   */
   export interface RenameErrorPayload extends SingleItemPayload {
-    reason?: string;
+    error: FileManageErrorInfo;
   }
 
+  /**
+   * Payload for file upload operations.
+   */
   export interface FileUploadPayload extends SingleItemPayload {
     uploadId?: string;
   }
 
+  /**
+   * Payload for file upload errors.
+   */
   export interface FileUploadErrorPayload extends FileUploadPayload {
-    error?: string;
-    errorCode?: FileManagerErrorCode;
-    httpStatus?: number;
+    error?: FileManageErrorInfo;
   }
 
+  /**
+   * Payload for unsupported file type errors.
+   */
   export interface UnsupportedFileTypePayload extends FileUploadErrorPayload {
     fileType: string;
   }
 
+  /**
+   * Payload for folder operation errors and successes.
+   */
   export interface FolderOperationPayload extends ItemContextPayload {
     folderId?: string | null;
     folderName?: string;
@@ -201,65 +305,177 @@ declare namespace Notify {
     is_force_create?: boolean;
   }
 
-  export interface JsonDataProviderErrorPayload {
-    url?: string | null;
-    reason?: string;
-    errorCode?: FileManagerErrorCode;
-  }
-
+  /**
+   * Payload for file URL validation errors.
+   */
   export interface FileUrlValidationErrorPayload {
     url?: string | null;
-    reason?: string;
-    errorCode?: FileManagerErrorCode;
+    error: FileManageErrorInfo;
   }
 
+  /**
+   * Payload for image file operations.
+   */
   export interface ImageFilePayload extends SingleItemPayload {
     thumbnail?: string | null;
   }
 
+  /**
+   * Payload for URL upload operations.
+   */
   export interface UrlUploadPayload {
     url?: string | null;
     folderId?: string | null;
     folderName?: string | null;
   }
 
+  /**
+   * Payload for URL upload errors.
+   */
   export interface UrlUploadErrorPayload extends UrlUploadPayload {
-    reason?: string;
+    error: FileManageErrorInfo;
   }
 
+  /**
+   * Payload for file fetch errors.
+   */
   export interface FetchFilesErrorPayload {
     params?: FilesQueryParams;
   }
 
+  /**
+   * Base payload for AI image generation operations.
+   */
   interface AIImageGenerationBasePayload {
     request: string;
     taskId?: string | null;
   }
 
+  /**
+   * Payload for AI image generation started event.
+   */
   export interface AIImageGenerationStartedPayload extends AIImageGenerationBasePayload {
     response?: unknown;
   }
 
+  /**
+   * Payload for successful AI image generation.
+   */
   export interface AIImageGenerationSuccessPayload extends AIImageGenerationBasePayload {
     images: string[];
   }
 
+  /**
+   * Payload for failed AI image generation.
+   */
   export interface AIImageGenerationFailedPayload extends AIImageGenerationBasePayload {
     response?: unknown;
-    error?: unknown;
+    error?: FileManageErrorInfo;
   }
 
-  export type EventBase<TId extends string, TData> = {
+  /**
+   * Base type for error notification events.
+   * Includes innerException field for error details.
+   * 
+   * @template TId - Notification event ID type
+   * @template TData - Payload data type
+   */
+  export type ErrorEventBase<TId extends string, TData> = {
     id: TId;
     data?: TData;
     innerException?: unknown;
     message: string;
     placement?: NotifyPlacement;
     description?: string;
+    /**
+     * Visibility flag for the notification.
+     * If true, notification will be shown; if false, it will be silent.
+     * Derived from the `silent` parameter (visibility = !silent).
+     * Can be modified by event interceptors.
+     */
+    visibility?: boolean;
+    /**
+     * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
+     */
+    level?: 'item' | 'batch';
+  };
 
+  /**
+   * Base type for success, warning, and info notification events.
+   * Does not include innerException field.
+   * 
+   * @template TId - Notification event ID type
+   * @template TData - Payload data type
+   */
+  export type NotificationEventBase<TId extends string, TData> = {
+    id: TId;
+    data?: TData;
+    message: string;
+    placement?: NotifyPlacement;
+    description?: string;
+    /**
+     * Visibility flag for the notification.
+     * If true, notification will be shown; if false, it will be silent.
+     * Derived from the `silent` parameter (visibility = !silent).
+     * Can be modified by event interceptors.
+     */
+    visibility?: boolean;
+    /**
+     * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
+     */
+    level?: 'item' | 'batch';
   };
 
-  export interface ErrorMap {
+  /**
+   * Map of error notification IDs to their payload types for single item operations.
+   * All item operation errors extend OperationErrorPayload with failCount: 1 and totalCount: 1.
+   */
+  export interface ItemErrorMap {
+    FILE_DELETE_ERROR: OperationErrorPayload;
+    FILE_MOVE_ERROR: OperationErrorPayload;
+    FILE_COPY_ERROR: OperationErrorPayload;
+  }
+
+  /**
+   * Map of error notification IDs to their payload types for batch operations.
+   * All batch operation errors extend OperationErrorPayload.
+   */
+  export interface BatchErrorMap {
+    FILES_DELETE_ERROR: OperationErrorPayload;
+    FOLDER_DELETE_ERROR: OperationErrorPayload;
+    FILES_UPLOAD_BATCH_FAILED: OperationErrorPayload;
+    FILES_MOVE_ERROR: OperationErrorPayload;
+    FILES_COPY_ERROR: OperationErrorPayload;
+  }
+
+  /**
+   * Map of success notification IDs to their payload types for single item operations.
+   * All item operation successes extend OperationSuccessPayload with successCount: 1 and totalCount: 1.
+   */
+  export interface ItemSuccessMap {
+    FILE_DELETE_SUCCESS: OperationSuccessPayload;
+    FILE_MOVE_SUCCESS: OperationSuccessPayload;
+    FILE_COPY_SUCCESS: OperationSuccessPayload;
+  }
+
+  /**
+   * Map of success notification IDs to their payload types for batch operations.
+   * All batch operation successes extend OperationSuccessPayload.
+   */
+  export interface BatchSuccessMap {
+    FILES_DELETE_SUCCESS: OperationSuccessPayload;
+    FILES_MOVE_SUCCESS: OperationSuccessPayload;
+    FILES_COPY_SUCCESS: OperationSuccessPayload;
+    FOLDER_DELETE_SUCCESS: OperationSuccessPayload;
+    FILES_UPLOAD_BATCH_SUCCESS: OperationSuccessPayload;
+  }
+
+  /**
+   * Map of all error notification IDs to their payload types.
+   * Extends ItemErrorMap for single item operations and BatchErrorMap for batch operations.
+   */
+  export interface ErrorMap extends ItemErrorMap, BatchErrorMap {
+
     FILE_DOWNLOAD_FAILED: ImageFilePayload;
     IMAGE_DOWNLOAD_FAILED: ImageFilePayload;
     IMAGE_SAVE_FAILED: ImageFilePayload;
@@ -271,10 +487,6 @@ declare namespace Notify {
 
     FILES_FETCH_FAILED: FetchFilesErrorPayload;
 
-    FILES_DELETE_ERROR: OperationErrorPayload;
-
-    FOLDER_DELETE_ERROR: OperationErrorPayload;
-
     FILE_RENAME_DISABLED_BY_CONFIG: SingleItemPayload;
     FILE_RENAME_FAILED: RenameErrorPayload;
 
@@ -285,8 +497,6 @@ declare namespace Notify {
 
     FILE_UPLOAD_ITEM_FAILED: FileUploadErrorPayload;
 
-    FILES_UPLOAD_BATCH_FAILED: OperationErrorPayload;
-
     FILES_UPLOAD_URL_VALIDATION_FAILED: UrlUploadPayload;
 
     FILES_UPLOAD_URL_NOT_SUPPORTED: UrlUploadPayload;
@@ -295,12 +505,8 @@ declare namespace Notify {
     FILES_UPLOAD_PROVIDER_NOT_CONFIGURED: never;
 
     FILES_MOVE_DIRECTORY_NOT_SELECTED: never;
-    FILES_MOVE_ERROR: OperationErrorPayload;
 
     FILES_COPY_DIRECTORY_NOT_SELECTED: never;
-    FILES_COPY_ERROR: OperationErrorPayload;
-
-    FILES_MOVE_TO_TRASH_ERROR: OperationErrorPayload;
 
     FOLDERS_FETCH_FAILED: FolderOperationPayload;
     FOLDER_CREATE_PROVIDER_NOT_CONFIGURED: FolderOperationPayload;
@@ -312,58 +518,90 @@ declare namespace Notify {
     FILE_URL_VALIDATION_FAILED: FileUrlValidationErrorPayload;
   }
 
+  /**
+   * Union type of all error events.
+   */
   export type Error = {
-    [K in keyof ErrorMap]: EventBase<K, ErrorMap[K]>;
+    [K in keyof ErrorMap]: ErrorEventBase<K, ErrorMap[K]>;
   }[keyof ErrorMap];
 
+  /**
+   * Error notification event type.
+   */
   export type ErrorEvent = { type: 'error' } & Error;
 
-  export interface SuccessMap {
+  /**
+   * Map of all success notification IDs to their payload types.
+   * Extends ItemSuccessMap for single item operations and BatchSuccessMap for batch operations.
+   */
+  export interface SuccessMap extends ItemSuccessMap, BatchSuccessMap {
     AI_IMAGE_GENERATION_STARTED: AIImageGenerationStartedPayload;
     AI_IMAGE_GENERERATION_SUCCESS: AIImageGenerationSuccessPayload;
 
     // EDITOR_IMAGE_DOWNLOAD_SUCCESS: ImageFilePayload;
     IMAGE_UPDATE_SUCCESS: ImageFilePayload;
 
-    FILES_DELETE_SUCCESS: OperationSuccessPayload;
-    FILES_MOVE_SUCCESS: OperationSuccessPayload;
-    FILES_COPY_SUCCESS: OperationSuccessPayload;
     FILE_RENAME_SUCCESS: SingleItemPayload;
     FOLDER_RENAME_SUCCESS: SingleItemPayload;
-    FOLDER_DELETE_SUCCESS: OperationSuccessPayload;
     FOLDER_CREATE_SUCCESS: FolderOperationPayload;
-    FILES_UPLOAD_BATCH_SUCCESS: OperationSuccessPayload;
 
     FILE_UPLOAD_ITEM_SUCCESS: FileUploadPayload;
   }
 
+  /**
+   * Union type of all success events.
+   */
   export type Success = {
-    [K in keyof SuccessMap]: EventBase<K, SuccessMap[K]>;
+    [K in keyof SuccessMap]: NotificationEventBase<K, SuccessMap[K]>;
   }[keyof SuccessMap];
 
+  /**
+   * Success notification event type.
+   */
   export type SuccessEvent = { type: 'success' } & Success;
 
+  /**
+   * Map of warning notification IDs to their payload types.
+   */
   export interface WarningMap {
     FILES_UPLOAD_UNSUPPORTED_TYPE: UnsupportedFileTypePayload;
     FOLDER_OPERATION_VALIDATION_FAILED: FolderOperationPayload;
   }
 
+  /**
+   * Union type of all warning events.
+   */
   export type Warning = {
-    [K in keyof WarningMap]: EventBase<K, WarningMap[K]>;
+    [K in keyof WarningMap]: NotificationEventBase<K, WarningMap[K]>;
   }[keyof WarningMap];
 
+  /**
+   * Warning notification event type.
+   */
   export type WarningEvent = { type: 'warning' } & Warning;
 
+  /**
+   * Map of info notification IDs to their payload types.
+   */
   export interface InfoMap {}
 
+  /**
+   * Union type of all info events.
+   */
   export type Info = {
-    [K in keyof InfoMap]: EventBase<K, InfoMap[K]>;
+    [K in keyof InfoMap]: NotificationEventBase<K, InfoMap[K]>;
   }[keyof InfoMap];
 
+  /**
+   * Info notification event type.
+   */
   export type InfoEvent = { type: 'info' } & Info;
 }
 
+/**
+ * Union type of all notification events (error, success, warning, info).
+ */
 type NotifyEvent = Notify.SuccessEvent | Notify.ErrorEvent | Notify.WarningEvent | Notify.InfoEvent;
 
 export { Notify };
-export type { FileManagerErrorCode, IFileManagerApiError, ItemContextPayload, NotifyEvent, NotifyPlacement };
+export type { FileManageErrorInfo, FileManagerErrorCode, FilesQueryParams, IFileManagerApiError, ItemContextPayload, NotifyEvent, NotifyPlacement };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailmaker/filemanager",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "main": "./file-manager.js",
   "module": "./file-manager.esm.js",
   "types": "./index.d.ts",

package/shared/fileManagerApiError.d.ts

@@ -14,7 +14,7 @@ import type { FileManagerErrorCode, IFileManagerApiError } from '../notification
  */
 export declare class FileManagerApiError extends Error implements IFileManagerApiError {
     readonly code: FileManagerErrorCode;
-    readonly httpStatus?: number;
-    readonly details?: unknown;
-    constructor(message: string, code: FileManagerErrorCode, httpStatus?: number, details?: unknown);
+    readonly status?: number | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: FileManagerErrorCode, status?: number | undefined, details?: unknown | undefined);
 }

package/shared/mapHttpStatusToErrorCode.d.ts

@@ -0,0 +1,5 @@
+import { FileManagerErrorCode } from "types";
+/**
+ * Преобразует HTTP статус-код в код ошибки FileManager
+ */
+export declare function mapHttpStatusToErrorCode(status: number, defaultCode?: FileManagerErrorCode): FileManagerErrorCode;

package/types.d.ts

@@ -2,7 +2,7 @@ import React, { ReactNode, RefObject } from 'react';
 import { FormInstance } from 'antd/es/form';
 import { MY_FILES, GIF, STOCK_IMAGES, AI, EDITOR, IMAGE_EXTENSIONS } from './constants';
 import type { InputRef } from 'antd';
-import type { Notify, NotifyEvent } from 'notification';
+import type { FileManageErrorInfo, Notify, NotifyEvent } from 'notification';
 export * from 'notification';
 export interface Folder {
     id: string;
@@ -150,14 +150,14 @@ export interface OperationResult<T = void> {
     requestId?: string;
     success?: boolean;
     data?: T;
-    error?: string;
+    error?: FileManageErrorInfo;
 }
 /**
  * Результат групповой операции
  */
 export type BatchResult<T> = {
     success: boolean;
-    error?: string;
+    error?: FileManageErrorInfo;
     detailed?: OperationResult<T>[];
 };
 export type UploadBinary = Blob | globalThis.File;
@@ -235,16 +235,10 @@ export interface FileManagerDataProviders {
         folderId?: string | null;
         noFolder?: boolean;
     }) => Promise<File>;
-    deleteFile: (fileId: string) => Promise<boolean>;
     deleteItems?: (items: string[], options?: {
         permanent?: boolean;
     }) => Promise<BatchResult<unknown>>;
     renameFile?: (fileId: string, newName: string) => Promise<File>;
-    moveItem?: (options: {
-        itemId: string;
-        targetFolderId: string;
-        isFolder: boolean;
-    }) => Promise<boolean>;
     moveItems?: (targetFolderId: string, files: string[]) => Promise<BatchResult<unknown>>;
     copyItem?: (options: {
         itemId: string;