@emailmaker/filemanager 0.0.1

package/types.d.ts

@@ -0,0 +1,379 @@
+import React, { ReactNode, RefObject } from 'react';
+import { FormInstance } from 'antd/es/form';
+import { MY_FILES, GIF, STOCK_IMAGES, AI, EDITOR } from './constants';
+import type { InputRef } from 'antd';
+export interface Folder {
+    id: string;
+    name: string;
+    parentId?: string | null;
+}
+export interface ThumbnailFile {
+    thumbnail: string;
+    name?: string;
+    id?: string;
+}
+export interface File {
+    id: string;
+    name: string;
+    size: string;
+    date: string;
+    folderId: string;
+    type?: string;
+    thumbnail?: string;
+    dimensions?: string;
+    aspectRatio?: string;
+    extension?: string;
+    selected?: boolean;
+    isFolder?: boolean;
+    lastEdited?: string;
+}
+export interface PathItem {
+    id: string;
+    name: string;
+}
+export interface PaginationState {
+    current: number;
+    pageSize: number;
+    total: number;
+}
+export interface FilesQueryParams {
+    folderId?: string;
+    search?: string;
+    page?: number;
+    limit?: number;
+    sortBy?: 'name' | 'size' | 'date' | 'type';
+    sortOrder?: 'asc' | 'desc';
+}
+export interface ApiPaginationResponse {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface FilesApiResponse {
+    data: File[];
+    pagination: ApiPaginationResponse;
+}
+export interface SortState {
+    sortBy: 'name' | 'size' | 'date' | 'type';
+    sortOrder: 'asc' | 'desc';
+}
+export interface MenuItem {
+    key: string;
+    label: string | ReactNode;
+    icon?: ReactNode;
+    children?: MenuItem[];
+}
+export interface ApiEndpoints {
+    getFolders?: string;
+    getFiles?: string;
+    createFolder?: string;
+    deleteFolder?: string;
+    addFile?: string;
+    deleteFile?: string;
+    renameFile?: string;
+    moveFile?: string;
+    updateFile?: string;
+}
+export interface IconProps {
+    style?: React.CSSProperties;
+    className?: string;
+    onClick?: React.MouseEventHandler<HTMLElement>;
+    [key: string]: unknown;
+}
+export interface CustomIcons {
+    rootFolder?: React.ComponentType<IconProps>;
+    folder?: React.ComponentType<IconProps>;
+    folderOpen?: React.ComponentType<IconProps>;
+    addFolder?: React.ComponentType<IconProps>;
+    file?: React.ComponentType<IconProps>;
+    upload?: React.ComponentType<IconProps>;
+    uploadByUrl?: React.ComponentType<IconProps>;
+    expandArrow?: React.ComponentType<IconProps>;
+    collapseArrow?: React.ComponentType<IconProps>;
+    gridView?: React.ComponentType<IconProps>;
+    listView?: React.ComponentType<IconProps>;
+    folderPreview?: React.ComponentType<IconProps>;
+}
+export interface FileManagerOptions {
+    apiEndpoints?: {
+        getFolders?: string;
+        getFiles?: string;
+        addFile?: string;
+        deleteFile?: string;
+        createFolder?: string;
+        deleteFolder?: string;
+        renameFile?: string;
+        moveFile?: string;
+        updateFile?: string;
+    };
+    dataProviders?: FileManagerDataProviders;
+    searchQuery?: string;
+    sortBySize?: string;
+    onPathChange?: (path: string[]) => void;
+    onChangeSelection?: (files: File[]) => void;
+    config?: Config;
+    publicPath?: string;
+    customIcons?: CustomIcons;
+    dragDropIcon?: string;
+}
+export interface FileManagerDataProviders {
+    getFile: (fileId: string) => Promise<Blob>;
+    getFolders: () => Promise<Folder[]>;
+    getFiles: (options: {
+        folderId?: string;
+        search?: string;
+    }) => Promise<File[]>;
+    createFolder: (data: {
+        name: string;
+        parentId?: string | null;
+    }) => Promise<Folder>;
+    deleteFolder?: (folderId: string) => Promise<boolean>;
+    uploadFile: (file: {
+        name: string;
+        size: string;
+        type: string;
+        folderId?: string | null;
+        data: Blob | string;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
+        extension?: string;
+    }) => Promise<File>;
+    uploadFileByUrl?: (data: {
+        url: string;
+        folderId?: string | null;
+    }) => Promise<File>;
+    deleteFile: (fileId: string) => Promise<boolean>;
+    renameFile?: (fileId: string, newName: string) => Promise<File>;
+    moveItem?: (options: {
+        itemId: string;
+        targetFolderId: string;
+        isFolder: boolean;
+    }) => Promise<boolean>;
+}
+export interface FileManagerHookReturn {
+    folders: Folder[];
+    files: File[];
+    filteredItems: File[];
+    paginatedItems: File[];
+    pagination: PaginationState;
+    selectedFolder: string | null;
+    searchTerm: string;
+    sortField: string;
+    pathHistory: PathItem[];
+    selectedFiles: Set<string>;
+    loading: boolean;
+    isModalVisible: boolean;
+    isUrlModalVisible: boolean;
+    isRenameModalVisible: boolean;
+    isMoveModalVisible: boolean;
+    form: FormInstance;
+    urlForm: FormInstance;
+    renameForm: FormInstance;
+    moveForm: FormInstance;
+    fileToRename: string | null;
+    fetchFolders: () => Promise<void>;
+    fetchFiles: (folderId?: string) => Promise<void>;
+    handleCreateFolder: () => void;
+    handleModalOk: () => Promise<void>;
+    handleModalCancel: () => void;
+    handleDeleteFile: (fileId: string) => Promise<void>;
+    handleAddFile: () => void;
+    handleFolderSelect: (folderId: string) => void;
+    toggleFileSelection: (fileId: string) => void;
+    handleBreadcrumbClick: (index: number) => void;
+    handleItemClick: (record: File) => void;
+    handleAddFileByUrl: (url?: string | null) => Promise<void>;
+    setIsUrlModalVisible: (visible: boolean) => void;
+    setSearchTerm: (term: string) => void;
+    setSortField: (field: string) => void;
+    setPagination: (pagination: Partial<PaginationState>) => void;
+    generateMenuItems: () => MenuItem[];
+    setPathHistory: (history: PathItem[]) => void;
+    showRenameModal: (fileId: string) => void;
+    handleRenameCancel: () => void;
+    handleRenameOk: () => Promise<void>;
+    handleDroppedFiles: (droppedFiles: globalThis.File[]) => Promise<void>;
+    showMoveModal: () => void;
+    handleMoveCancel: () => void;
+    handleMoveOk: () => Promise<void>;
+}
+interface Counters {
+    optimization_counter: number;
+    ai_counter: number;
+    ai_img_counter: number;
+    ai_generator_limit: number;
+}
+interface Limits {
+    optimization_limit?: number;
+    ai_limit?: number;
+    ai_img_limit?: number;
+    ai_generator_limit?: number;
+}
+export interface Config {
+    theme?: 'light' | 'dark';
+    disableMockServer?: boolean;
+    activeTab?: string;
+    showDefaultNotification?: boolean;
+    apiEndpoints?: ApiEndpoints;
+    REACT_APP_GIPHY_KEY?: string;
+    locale?: string;
+    mode?: 'fileManager' | 'imageCenter' | 'plugin';
+    enabledTabs?: string[];
+    customTheme?: {
+        colors?: {
+            primary?: string;
+            secondary?: string;
+            success?: string;
+            warning?: string;
+            error?: string;
+            info?: string;
+            textPrimary?: string;
+            textSecondary?: string;
+            textTertiary?: string;
+            bgPrimary?: string;
+            bgSecondary?: string;
+            bgTertiary?: string;
+            borderPrimary?: string;
+            borderSecondary?: string;
+        };
+        borderRadius?: {
+            none?: string;
+            xs?: string;
+            sm?: string;
+            md?: string;
+            lg?: string;
+            xl?: string;
+            full?: string;
+        };
+    };
+    UNSPLASH_KEY?: string;
+    APP_NAME_UNSPLASH?: string;
+    pushToGTM?: boolean;
+    projectId?: string;
+    elementId?: string;
+    baseUrl?: string;
+    /** Counters and limits */
+    counters?: Counters;
+    limits?: Limits;
+    /** billing page url */
+    billingPageUrl?: string;
+    notification?: void;
+    sendAIImageRequest?: any;
+    sseQuery?: () => Promise<void>;
+    customLocale?: object;
+    activeLibraryItem?: LibraryMenuKey;
+    fileForEdit?: string;
+}
+export type LibraryMenuKey = typeof MY_FILES | typeof GIF | typeof STOCK_IMAGES | typeof AI | typeof EDITOR;
+export interface GifItem {
+    id: string;
+    title: string;
+    images: {
+        downsized: {
+            url: string;
+        };
+    };
+}
+export interface CurrentReqGif {
+    keywords: string;
+}
+export interface ImageGifProps {
+    setImageGifList: React.Dispatch<React.SetStateAction<GifItem[]>>;
+    imageGifList: GifItem[];
+    currentReqGif: CurrentReqGif;
+    setCurrentReqGif: React.Dispatch<React.SetStateAction<CurrentReqGif>>;
+    inputRef: React.RefObject<InputRef>;
+    customRequest: (data: string) => void;
+}
+export interface UnsplashImage {
+    id: string;
+    description: string;
+    urls: {
+        raw: string;
+    };
+    links: {
+        download_location: string;
+    };
+    user: {
+        name: string;
+        links: {
+            html: string;
+        };
+    };
+}
+export interface CurrentReqStock {
+    keywords: string;
+    color: string;
+    orientation: string;
+}
+export interface ImageStockProps {
+    imageStockList: UnsplashImage[];
+    setImageStockList: React.Dispatch<React.SetStateAction<UnsplashImage[]>>;
+    currentReq: CurrentReqStock;
+    setCurrentReq: React.Dispatch<React.SetStateAction<CurrentReqStock>>;
+    inputRef: React.RefObject<InputRef>;
+    customRequest: (data: string) => void;
+}
+export interface ImageAIProps {
+    setModalHeight: React.Dispatch<React.SetStateAction<string | number>>;
+    customRequest: (args: {
+        file: File;
+    }) => void;
+    aiTabRef: RefObject<HTMLElement>;
+    inputAiRef: RefObject<any>;
+    isImageUploaded: boolean;
+    setIsImageUploaded: (val: boolean) => void;
+    aiImageRequest: string;
+    setAiImageRequest: React.Dispatch<React.SetStateAction<string>>;
+    imageAiList: string[];
+    setImageAiList: React.Dispatch<React.SetStateAction<string[]>>;
+    isLoadingAi: boolean;
+    setIsLoadingAi: React.Dispatch<React.SetStateAction<boolean>>;
+}
+export interface ArrowProps {
+    className?: string;
+    onClick?: () => void;
+}
+export interface UseImageAIGenerationProps {
+    setModalHeight: React.Dispatch<React.SetStateAction<string | number>>;
+    customRequest: (args: {
+        file: File;
+    }) => void;
+    aiTabRef: React.RefObject<HTMLElement>;
+    isImageUploaded: boolean;
+    setIsImageUploaded: (val: boolean) => void;
+    aiImageRequest: string;
+    imageAiList: string[];
+    setImageAiList: React.Dispatch<React.SetStateAction<string[]>>;
+    isLoadingAi: boolean;
+    setIsLoadingAi: React.Dispatch<React.SetStateAction<boolean>>;
+}
+export interface UseImageAIGenerationReturn {
+    aiImageCounter: number;
+    setAiImageCounter: React.Dispatch<React.SetStateAction<number>>;
+    currentAiImgLimits: number;
+    isFieldsDisabled: boolean;
+    canGenerateImage: boolean;
+    aiImageRequest: string;
+    imageAiList: string[];
+    setImageAiList: React.Dispatch<React.SetStateAction<string[]>>;
+    isLoadingAi: boolean;
+    setIsLoadingAi: React.Dispatch<React.SetStateAction<boolean>>;
+    loadingDuringGeneration: boolean;
+    setLoadingDuringGeneration: React.Dispatch<React.SetStateAction<boolean>>;
+    requestStatus: string;
+    setRequestStatus: React.Dispatch<React.SetStateAction<string>>;
+    handleGenerate: () => void;
+    handleLimitAiImgCount: () => void;
+    convertBase64ToFile: (base64String: string) => void;
+    isShiftPressed: boolean;
+    setIsShiftPressed: React.Dispatch<React.SetStateAction<boolean>>;
+    currentReqId: string | null;
+    setCurrentReqId: React.Dispatch<React.SetStateAction<string | null>>;
+    limitsInPlugin: boolean;
+}
+export {};

package/utils/fileValidation.d.ts

@@ -0,0 +1,34 @@
+export declare const MAX_FILE_SIZE: number;
+export declare const MIN_FILE_SIZE = 1;
+export declare const ALLOWED_FILE_TYPES: {
+    images: string[];
+    documents: string[];
+    archives: string[];
+    videos: string[];
+    audio: string[];
+};
+export declare const ALL_ALLOWED_TYPES: string[];
+export interface FileValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+export interface FileValidationOptions {
+    maxSize?: number;
+    minSize?: number;
+    allowedTypes?: string[];
+    allowAllTypes?: boolean;
+    maxFileNameLength?: number;
+}
+export declare const validateFile: (file: File, options?: FileValidationOptions) => FileValidationResult;
+export declare const validateFiles: (files: File[], options?: FileValidationOptions) => {
+    valid: File[];
+    invalid: {
+        file: File;
+        result: FileValidationResult;
+    }[];
+};
+export declare const validateFileUrl: (url: string) => Promise<FileValidationResult>;
+export declare const getFileCategory: (file: File) => string;
+export declare const formatFileSize: (bytes: number) => string;
+export declare const sanitizeFileName: (fileName: string) => string;

package/utils/resizeObserverHandler.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Утилита для подавления ошибок ResizeObserver
+ * Эти ошибки часто возникают при работе с модальными окнами и динамическими компонентами
+ */
+export declare const installResizeObserverErrorHandler: () => void;
+export declare const uninstallResizeObserverErrorHandler: () => void;

package/utils/themeUtils.d.ts

@@ -0,0 +1,17 @@
+import { Config } from '../types';
+/**
+ * Применяет кастомную тему к CSS переменным
+ */
+export declare const applyCustomTheme: (config?: Config) => void;
+/**
+ * Сбрасывает кастомную тему к значениям по умолчанию
+ */
+export declare const resetCustomTheme: () => void;
+/**
+ * Устанавливает тему (светлая/темная)
+ */
+export declare const setTheme: (theme: "light" | "dark") => void;
+/**
+ * Получает текущую тему
+ */
+export declare const getCurrentTheme: () => "light" | "dark";

package/widgets/layout/errorBoundary/errorBoundary.d.ts

@@ -0,0 +1,19 @@
+import React, { Component, ReactNode } from 'react';
+import './errorBoundary.scss';
+interface ErrorBoundaryProps {
+    children: ReactNode;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): {
+        hasError: boolean;
+        error: Error;
+    };
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};