@emailmaker/filemanager 0.10.16 → 0.10.17

package/index.d.ts

@@ -17,5 +17,6 @@ export { FileContent } from './components/FileContent/FileContent';
 export { FileModals } from './components/FileModals/FileModals';
 export { FolderSidebar } from './components/FolderSidebar/FolderSidebar';
 export { installResizeObserverErrorHandler, uninstallResizeObserverErrorHandler } from './utils/resizeObserverHandler';
-export { type Folder, type File, type PathItem, type MenuItem, type FileManagerOptions, type FileManagerHookReturn, } from './types';
+export { type Folder, type File, type PathItem, type MenuItem, type FileManagerOptions, type FileManagerHookReturn, type FileManagerErrorCode, type IFileManagerApiError, } from './types';
+export { FileManagerApiError } from './shared/fileManagerApiError';
 export { type InitPixieEditorOptions, type Options as FileManagerInitOptions, type UniversalInitOptions, } from './file-manager';

package/notification.d.ts

@@ -1,3 +1,118 @@
+type FileManagerErrorCode =
+  // --- Файлы ---
+  | 'FileNotFound'
+  | 'FileAlreadyExists'
+  | 'FileInvalidName'
+  | 'FileAccessDenied'
+  | 'FileReadError'
+  | 'FileWriteError'
+  | 'FileTooLarge'
+  | 'FileTypeNotAllowed'
+  | 'FileCorrupted'
+  | 'FileChecksumMismatch'
+
+  // --- Папки / каталоги ---
+  | 'FolderNotFound'
+  | 'FolderAlreadyExists'
+  | 'FolderInvalidName'
+  | 'FolderAccessDenied'
+  | 'FolderReadError'
+  | 'FolderWriteError'
+  | 'FolderQuotaExceeded'
+  | 'FolderNotEmpty'
+  | 'FolderBackendError'
+  | 'FolderTimeout'
+
+  // --- Операционные ограничения ---
+  | 'RenameNotAllowed'
+  | 'MoveNotAllowed'
+  | 'CopyNotAllowed'
+  | 'DeleteNotAllowed'
+  | 'MoveIntoSelf'
+  | 'MoveIntoDescendant'
+  | 'UnsupportedOperation'
+  | 'ConfigError'
+
+  // --- Загрузка файлов ---
+  | 'FileUploadQuotaExceeded'
+  | 'FileUploadNetworkError'
+  | 'FileUploadTimeout'
+  | 'FileUploadBackendError'
+
+  // --- Загрузка по URL ---
+  | 'UploadUrlInvalid'
+  | 'UploadUrlNotReachable'
+  | 'UploadUrlContentTypeNotAllowed'
+  | 'UploadUrlDownloadFailed'
+
+  // --- Скачивание файлов ---
+  | 'FileDownloadNetworkError'
+  | 'FileDownloadTimeout'
+  | 'FileDownloadBackendError'
+
+  // --- Батчевые операции ---
+  | 'BatchPartialFailure'
+  | 'BatchAllFailed'
+  | 'BatchConflict'
+  | 'BatchValidationFailed'
+
+  // --- Валидация / данные ---
+  | 'ValidationError'
+  | 'PayloadTooLarge'
+  | 'UnsupportedMediaType'
+
+  // --- Сеть / сервер / инфраструктура ---
+  | 'NetworkError'
+  | 'BackendError'
+  | 'Timeout'
+  | 'AuthenticationFailed'
+  | 'AuthorizationFailed'
+  | 'RateLimitExceeded'
+  | 'ServiceUnavailable'
+
+  // --- AI / интеграции ---
+  | 'AIResponseInvalid'
+  | 'AIImageGenerationFailed'
+  | 'AIImageGenerationLimitExceeded'
+  | 'IntegrationError'
+  | 'ThirdPartyError'
+
+  // --- Общее / запасной вариант ---
+  | 'UnknownError';
+
+/**
+ * Интерфейс ошибки для FileManager API.
+ * Реализован классом FileManagerApiError, который также экспортируется.
+ * 
+ * @example
+ * ```typescript
+ * // Использование класса
+ * throw new FileManagerApiError(
+ *   'File not found',
+ *   'FileNotFound',
+ *   404
+ * );
+ * 
+ * // Или создание собственного класса
+ * class MyFileManagerError extends Error implements IFileManagerApiError {
+ *   constructor(
+ *     message: string,
+ *     public code: FileManagerErrorCode,
+ *     public httpStatus?: number,
+ *     public details?: unknown
+ *   ) {
+ *     super(message);
+ *     this.name = 'MyFileManagerError';
+ *   }
+ * }
+ * ```
+ */
+interface IFileManagerApiError extends Error {
+  code: FileManagerErrorCode;
+  httpStatus?: number;
+  details?: unknown;
+}
+
 interface FilesQueryParams {
   folderId?: string;
   search?: string;
@@ -42,8 +157,10 @@ declare namespace Notify {
 
   export interface OperationErrorDetail {
     itemId?: string;
-  itemName?: string;
+    itemName?: string;
     reason?: string;
+    code?: FileManagerErrorCode;
+    httpStatus?: number;
   }
 
   export interface OperationErrorPayload extends ItemContextPayload {
@@ -69,6 +186,8 @@ declare namespace Notify {
 
   export interface FileUploadErrorPayload extends FileUploadPayload {
     error?: string;
+    errorCode?: FileManagerErrorCode;
+    httpStatus?: number;
   }
 
   export interface UnsupportedFileTypePayload extends FileUploadErrorPayload {
@@ -84,11 +203,13 @@ declare namespace Notify {
   export interface JsonDataProviderErrorPayload {
     url?: string | null;
     reason?: string;
+    errorCode?: FileManagerErrorCode;
   }
 
   export interface FileUrlValidationErrorPayload {
     url?: string | null;
     reason?: string;
+    errorCode?: FileManagerErrorCode;
   }
 
   export interface ImageFilePayload extends SingleItemPayload {
@@ -244,4 +365,4 @@ declare namespace Notify {
 type NotifyEvent = Notify.SuccessEvent | Notify.ErrorEvent | Notify.WarningEvent | Notify.InfoEvent;
 
 export { Notify };
-export type { ItemContextPayload, NotifyEvent, NotifyPlacement };
+export type { FileManagerErrorCode, IFileManagerApiError, ItemContextPayload, NotifyEvent, NotifyPlacement };

package/package.json

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

package/shared/config.d.ts

@@ -1,7 +1,7 @@
 export interface Config {
     theme?: 'light' | 'dark' | 'system';
     activeTab?: string;
-    showDefaultNotification?: boolean;
+    showNotifications?: boolean;
     disableMockServer?: boolean;
     apiEndpoints?: {
         getFolders?: string;

package/shared/fileManagerApiError.d.ts

@@ -0,0 +1,20 @@
+import type { FileManagerErrorCode, IFileManagerApiError } from '../notification';
+/**
+ * Класс ошибки для FileManager API.
+ * Реализует интерфейс IFileManagerApiError.
+ *
+ * @example
+ * ```typescript
+ * throw new FileManagerApiError(
+ *   'File not found',
+ *   'FileNotFound',
+ *   404
+ * );
+ * ```
+ */
+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);
+}

package/types.d.ts

@@ -330,7 +330,7 @@ export interface Config {
     theme?: 'light' | 'dark' | 'system';
     disableMockServer?: boolean;
     activeTab?: string;
-    showDefaultNotification?: boolean;
+    showNotifications?: boolean;
     apiEndpoints?: ApiEndpoints;
     REACT_APP_GIPHY_KEY?: string;
     locale?: string;

package/utils/errorMessages.d.ts

@@ -0,0 +1,12 @@
+import type { FileManagerErrorCode, IFileManagerApiError } from 'notification';
+type TFunction = (key: string, params?: Record<string, unknown>) => string;
+/**
+ * Возвращает локализованное сообщение по коду ошибки, если для него есть i18n-ключ.
+ * Если кода нет или он не сопоставлен — вернёт undefined.
+ */
+export declare const getErrorMessageFromCode: (code: FileManagerErrorCode | undefined, t: TFunction) => string | undefined;
+/**
+ * Пытается извлечь IFileManagerApiError из unknown.
+ */
+export declare const asFileManagerApiError: (error: unknown) => IFileManagerApiError | undefined;
+export {};