@emailmaker/emailmaker 1.0.111 → 1.0.113

package/CHANGELOG.en.md

@@ -64,10 +64,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Added
 
 **Integrations:**
+
 - Unisender integration and settings management
 - App-specific integration availability system
 
 **Editor:**
+
 - Free plan restrictions in ButtonsEmail component
 - mailto link support (subject, body) — DEV-13102
 - Mass blocks functionality
@@ -75,29 +77,35 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Insert link with correct color — DEV-13172
 
 **AI & UX:**
+
 - AI functionality in EmailPageHeader with payment verification
 - Improved modal animations
 
 **FileManager:**
+
 - Support for custom names when copying files and folders
 - Cache clearing
 
 ### Fixed
 
 **Table Editor:**
+
 - Dropdown menu layout for Table element — DEV-13370
 - Table editor functionality — DEV-13371
 
 **Paste & Links:**
+
 - Tag duplication when pasting text — DEV-13293
 - Link duplication when pasting — DEV-13378
 
 **Elements:**
+
 - Adding Button element to email — DEV-13312
 - Incorrect marker settings display — DEV-13313
 - Line break restriction for notifications — DEV-13143
 
 **Data & API:**
+
 - Tag and group changes when sending email data — DEV-10189
 - Recurring payment calculation with `is_only_first_period` — DEV-13377
 - Notification on test email send error
@@ -107,6 +115,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Changed
 
 **sandbox.js → TypeScript Refactoring:**
+
 - Migration to modular structure with types and centralized state
 - Modules for mouse, keyboard, and drag-and-drop event handling
 - Element settings handlers (links, variables, padding)
@@ -114,10 +123,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Utilities for text formatting, styles, and VML
 
 **Integrations:**
+
 - IntegrationSettings renamed to IntegrationSettingsData
 - Unisender integration migrated to flexible structure
 
 **UI:**
+
 - Updated layout for BlocksTable and EmailsTable
 - Improved checkbox styles in tables
 

package/CHANGELOG.md

@@ -59,10 +59,12 @@
 ### Добавлено
 
 **Интеграции:**
+
 - Интеграция с Unisender и управление настройками
 - Система доступности интеграций для конкретных приложений
 
 **Редактор:**
+
 - Ограничения для бесплатного плана в компоненте ButtonsEmail
 - Поддержка mailto ссылок (subject, body) — DEV-13102
 - Функциональность массовых блоков
@@ -70,29 +72,35 @@
 - Вставка ссылки с нужным цветом — DEV-13172
 
 **AI и UX:**
+
 - AI-функциональность в EmailPageHeader с проверкой оплаты
 - Улучшенные анимации модальных окон
 
 **FileManager:**
+
 - Поддержка задания нового имени при копировании файлов и папок
 - Очистка кеша
 
 ### Исправлено
 
 **Редактор таблиц:**
+
 - Вёрстка выпадающего меню элемента Таблица — DEV-13370
 - Работа редактора таблиц — DEV-13371
 
 **Вставка и ссылки:**
+
 - Дублирование тегов при вставке текста — DEV-13293
 - Дублирование ссылок при вставке — DEV-13378
 
 **Элементы:**
+
 - Добавление элемента Кнопка в письмо — DEV-13312
 - Некорректное отображение настроек маркеров — DEV-13313
 - Запрет переноса строки для уведомления — DEV-13143
 
 **Данные и API:**
+
 - Изменения тегов и групп при отправке данных письма — DEV-10189
 - Расчёт суммы рекуррентного платежа с `is_only_first_period` — DEV-13377
 - Уведомление при ошибке отправки тестового письма
@@ -102,6 +110,7 @@
 ### Изменено
 
 **Рефакторинг sandbox.js → TypeScript:**
+
 - Миграция на модульную структуру с типами и централизованным состоянием
 - Модули для обработки событий мыши, клавиатуры, drag-and-drop
 - Обработчики настроек элементов (ссылки, переменные, отступы)
@@ -109,10 +118,12 @@
 - Утилиты для текстового форматирования, стилей и VML
 
 **Интеграции:**
+
 - IntegrationSettings переименован в IntegrationSettingsData
 - Unisender интеграция мигрирована на гибкую структуру
 
 **UI:**
+
 - Обновлён layout для BlocksTable и EmailsTable
 - Улучшены стили чекбоксов в таблицах
 

package/README.md

@@ -3,45 +3,59 @@
 </p>
 
 # Установка
+
 Выполните этот код в командной строке:
 
 ```cmd
-$ npm i @emailmaker/emailmaker@1.0.111 -save
+$ npm i @emailmaker/emailmaker@1.0.113 -save
 ```
 
 Добавьте EmailMaker plugin в ваш App config.
+
 ### Для сборщика Webpack
+
 Импорт пакета:
+
 ```javascript
-const emailMakerPlugin = require('@emailmaker/emailmaker/webpack')
+const emailMakerPlugin = require('@emailmaker/emailmaker/webpack');
 ```
+
 Определение пакета в приложении:
+
 ```javascript
 module.exports = {
-	plugins: [
-		new EmailmakerWebpackPlugin(),
-	]
-}
+  plugins: [new EmailmakerWebpackPlugin()],
+};
 ```
+
 ### Для сборщика Vite
+
 Импорт пакета:
+
 ```javascript
-import emailMakerPlugin from 'emailmaker/vite'
+import emailMakerPlugin from 'emailmaker/vite';
 ```
+
 Определение пакета в приложении:
+
 ```javascript
 export default defineConfig({
-	plugins: [emailMakerPlugin()],
-})
+  plugins: [emailMakerPlugin()],
+});
 ```
+
 # Инициализация
+
 Импортируйте EmailMaker plugin в вашем компоненте:
+
 ```javascript
-import * as emailmaker from "@emailmaker/emailmaker"
+import * as emailmaker from '@emailmaker/emailmaker';
 ```
+
 Параметры инициализации плагина содержат параметр `getAuthToken`. В него должна быть передана функция, которая запрашивает авторизационный OAuth токен по Client ID и Client Secret.
 
 ### Получение OAuth токена на бэкенде
+
 ```curl
 curl --location 'https://api.emailmaker.ru/oauth/token' \
 --header 'Content-Type: application/x-www-form-urlencoded' \
@@ -51,27 +65,34 @@ curl --location 'https://api.emailmaker.ru/oauth/token' \
 ```
 
 ### Создание сущности EmailMaker plugin
+
 ```javascript
-emailmaker.init({
-	getAuthToken: getAuthToken,
-	element: "#test",
-	content: {
-		title: "Email subject",
-		html: `КОД_ПИСЬМА`,
-	},
-	config: { }
-}).then(instance => {  })
+emailmaker
+  .init({
+    getAuthToken: getAuthToken,
+    element: '#test',
+    content: {
+      title: 'Email subject',
+      html: `КОД_ПИСЬМА`,
+    },
+    config: {},
+  })
+  .then((instance) => {});
 ```
+
 КОД_ПИСЬМА можно взять из <a href="https://emcdn.ru/plugin/new-email.html" target="_blank">нашего образца</a> или вставить HTML-код своего письма.
 
 # Конфигурация
+
 Конфигурация плагина представляет собой JSON с несколькими уровнями вложенности. В конфигурации вы можете настроить внешний вид, содержимое, с которым будет работать плагин и логику.
 
 ### element
+
 Вы можете передать строку `element` в конфигурацию плагина. Это селектор DOM-элемента, внутри которого нужно инициализировать плагин. Если элемент не определен, приложение будет запущено в фоновом режиме.
 
 ### content
-Секция `content` содержит параметры письма, которое нужно отобразить в редакторе. 
+
+Секция `content` содержит параметры письма, которое нужно отобразить в редакторе.
 В этот параметр может быть передано:
 
 #### {string}
@@ -79,6 +100,7 @@ emailmaker.init({
 HTML верстка письма.
 
 #### {object} email options
+
 ```javascript
 {
 	id?: string; // Уникальный ID проекта в вашей системе.
@@ -89,6 +111,7 @@ HTML верстка письма.
 ```
 
 #### {object} full description
+
 ```javascript
 {
 	temlateId?: string; // ID шаблона внутри EmailMaker.
@@ -100,8 +123,10 @@ HTML верстка письма.
 
 Можно изменить содержимое в любой момент после инициализации с помощью метода `instance.show(content)`.
 
-### config 
+### config
+
 Раздел для настройки внешнего вида и настроек редактора. Вы можете изменить конфигурацию этого раздела после инициализации, используя `emailmaker.setConfig` или `emailmaker.updateConfig`.
+
 ##### Список параметров секции config
 | Параметр                               | Описание                                                                    | Значение по умолчанию |
 | -------------------------------------- | --------------------------------------------------------------------------- | --------------------- |
@@ -240,10 +265,12 @@ HTML верстка письма.
 | imageCenterEditorEnabled               | Таб редактора изображений.                                                  | true                  |
 | compressMaxSize                        | Макс. вес картинки после оптимизации, Мб.                                   | true                  |
 | compressMaxWidthOrHeight               | Макс. ширина картинки после оптимизации, px.                                | true                  |
-
 ### Обработка событий
+
 События могут быть переданы в конфигурации или добавлены после при работе с экземпляром плагина. Все подписчики событий могут быть асинхронными функциями.
-#### Пример 
+
+#### Пример
+
 ```javascript
 emailmaker.init({
 	....,
@@ -256,8 +283,11 @@ emailmaker.init({
 	const dispose = instance.handleSaveEmail(async (e) => {});
 });
 ```
+
 Передавая асинхронную функцию, вы можете реализовать асинхронную загрузку данных.
-#### Пример 
+
+#### Пример
+
 ```javascript
 emailmaker.init({
 	element: "#test",
@@ -267,54 +297,58 @@ emailmaker.init({
 	handleReadEmail: async (id) => {
 		return await  fetchData(id); // Ваша функция получения данных.
 	}
-}).then((instance) => { 
+}).then((instance) => {
 	setTimeout(() => instance.show({ id: "2" }), 1000)
 });
 ```
+
 ### События
-| Обработчик события        | Описание                                     |
-| ------------------------- | -------------------------------------------- |
-| handleReadEmail           | Чтение письма                                |
-| handleSaveEmail           | Сохранение / обновление письма               |
-| handleReadEmailRevisions  | Чтение списка автосохранений                 |
-| handleEmailAutosave       | Автосохранение                               |
-| handleReadBlocks          | Чтение списка блоков проекта                 |
-| handleSaveBlock           | Сохранение / обновление блока проекта        |
-| handleRemoveBlock         | Удаление блока проекта                       |
-| handleReadComments        | Чтение списка комментариев письма            |
-| handleSaveComment         | Сохранение / обновление комментария          |
-| handleRemoveComment       | Удаление комментария письма                  |
-| handleSaveButtonClick     | Нажатие кнопки сохранения письма             |
-| handleNextButtonClick     | Нажатие кнопки Далее                         |
-| handlePreviousButtonClick | Нажатие кнопки Назад                         |
-| handleEmailChanged        | Изменение любого параметра письма            |
-| handleHtmlChanged         | Изменение кода письма                        |
-| handleDestroy             | Деструкция плагина                           |
-| handleLoad                | Окончание инициализации экземпляра плагина   |
-| handleLoadImage           | Загрузка изображений                         |
-| handleNotify              | Уведомление                                  |
-| handleError               | Уведомление типа Ошибка                      |
-| handleSuccess             | Уведомление типа Успех                       |
-| handleTestEmailSend       | Отправка тестового письма                    |
-| handleTestEmailModal      | Открытие модального окна тестового письма    |
+
+| Обработчик события        | Описание                                   |
+| ------------------------- | ------------------------------------------ |
+| handleReadEmail           | Чтение письма                              |
+| handleSaveEmail           | Сохранение / обновление письма             |
+| handleReadEmailRevisions  | Чтение списка автосохранений               |
+| handleEmailAutosave       | Автосохранение                             |
+| handleReadBlocks          | Чтение списка блоков проекта               |
+| handleSaveBlock           | Сохранение / обновление блока проекта      |
+| handleRemoveBlock         | Удаление блока проекта                     |
+| handleReadComments        | Чтение списка комментариев письма          |
+| handleSaveComment         | Сохранение / обновление комментария        |
+| handleRemoveComment       | Удаление комментария письма                |
+| handleSaveButtonClick     | Нажатие кнопки сохранения письма           |
+| handleNextButtonClick     | Нажатие кнопки Далее                       |
+| handlePreviousButtonClick | Нажатие кнопки Назад                       |
+| handleEmailChanged        | Изменение любого параметра письма          |
+| handleHtmlChanged         | Изменение кода письма                      |
+| handleDestroy             | Деструкция плагина                         |
+| handleLoad                | Окончание инициализации экземпляра плагина |
+| handleLoadImage           | Загрузка изображений                       |
+| handleNotify              | Уведомление                                |
+| handleError               | Уведомление типа Ошибка                    |
+| handleSuccess             | Уведомление типа Успех                     |
+| handleTestEmailSend       | Отправка тестового письма                  |
+| handleTestEmailModal      | Открытие модального окна тестового письма  |
+
 ### Методы
-| Метод                     | Описание                                     |
-| ------------------------- | -------------------------------------------- |
-| init                      | Инициализация (async)                        |
-| show                      | Изменение содержимого после инициализации    |
-| destroy                   | Деструкция экземпляра                        |
-| reset                     | Сброс всей конфигурации                      |
-| getEmail                  | Получение текущего письма                    |
-| getConfig                 | Получение конфигурации                       |
-| getBlocks                 | Получение блоков проекта                     |
-| getComments               | Получение комментариев письма                |
-| getEmailRevisions         | Получение списка контроля версий             |
-| setConfig                 | Установка новых парамеров config             |
-| updateConfig              | Добавление к параметрам config               |
-| notify                    | Показ уведомлений                            |
-| getElement                | Получение элемента инициализации             |
-| save                      | Сохраенние письма.                           |
-| compileEmail              | Получение скопмилированного письма           |
+
+| Метод             | Описание                                  |
+| ----------------- | ----------------------------------------- |
+| init              | Инициализация (async)                     |
+| show              | Изменение содержимого после инициализации |
+| destroy           | Деструкция экземпляра                     |
+| reset             | Сброс всей конфигурации                   |
+| getEmail          | Получение текущего письма                 |
+| getConfig         | Получение конфигурации                    |
+| getBlocks         | Получение блоков проекта                  |
+| getComments       | Получение комментариев письма             |
+| getEmailRevisions | Получение списка контроля версий          |
+| setConfig         | Установка новых парамеров config          |
+| updateConfig      | Добавление к параметрам config            |
+| notify            | Показ уведомлений                         |
+| getElement        | Получение элемента инициализации          |
+| save              | Сохраенние письма.                        |
+| compileEmail      | Получение скопмилированного письма        |
 
 ### 📂 Файловый менеджер
 
@@ -376,45 +410,44 @@ emailmaker.init({
   - **comparator** — функция сравнения двух файлов для сортировки. По умолчанию сравнение по имени
   - **filterMatch** — функция проверки, проходит ли файл текущий фильтр. По умолчанию поиск по имени
 
-
 ### Интерфейс `StorageProvider`
 
 #### Свойства
 
-| Свойство | Тип | Описание | По умолчанию |
-|----------|------|-------------|---------|
-| `pathMode` | `boolean` | Использовать путь как идентификатор для папок | - |
-| `rootId` | `string` | Пользовательский идентификатор корневой папки | `''` |
-| `trashPath` | `string` | Путь к корзине/папке для удаленных файлов | - |
-| `tempPath` | `string` | Путь к временной папке для загрузок | - |
-| `useSoftDelete` | `boolean` | Включить программное мягкое удаление | `false` |
-| `ensureFolderTrailingSlash` | `boolean` | Добавлять к путям папок завершающий слэш | `true` |
-| `validateDuplicates` | `boolean` | Проверка на существование при операциях с файлами и папками | - |
+| Свойство                    | Тип       | Описание                                                    | По умолчанию |
+| --------------------------- | --------- | ----------------------------------------------------------- | ------------ |
+| `pathMode`                  | `boolean` | Использовать путь как идентификатор для папок               | -            |
+| `rootId`                    | `string`  | Пользовательский идентификатор корневой папки               | `''`         |
+| `trashPath`                 | `string`  | Путь к корзине/папке для удаленных файлов                   | -            |
+| `tempPath`                  | `string`  | Путь к временной папке для загрузок                         | -            |
+| `useSoftDelete`             | `boolean` | Включить программное мягкое удаление                        | `false`      |
+| `ensureFolderTrailingSlash` | `boolean` | Добавлять к путям папок завершающий слэш                    | `true`       |
+| `validateDuplicates`        | `boolean` | Проверка на существование при операциях с файлами и папками | -            |
 
 #### Методы
 
-##### Основные методы 
-
-| Метод | Параметры | Возвращает | Описание |
-|--------|------------|---------|-------------|
-| **getItems** | `options`:<br>- `folderId?: string`<br>- `search?: string`<br>- `sortBy?: string`<br>- `sortOrder?: 'asc'\|'desc'`<br>- `page?: number`<br>- `limit?: number`<br>- `itemType: 'all'\|'file'\|'folder'` | `{ items: FileSystemItem[], pagination?: Partial<ApiPaginationResponse> }` | Получить список файлов и папок с фильтрацией, сортировкой, пагинацией |
-| **createFolder** | `name: string`, `parentid?: string` | `FileSystemItem` | Создать новую папку |
-| uploadFile | `file`: <br>- `name: string`<br>- `size: number`<br>- `type: string`<br>- `folderId?: string`<br>- `data: Blob \| string`<br>- `thumbnail?: string`<br>- `dimensions?: string`<br>- `aspectRatio?: string`<br>- `extension?: string` | `FileSystemItemUpdate` | Загрузить файл с метаданными |
-| uploadFiles | `request`:<br>- `items`: массив объектов:<br>&nbsp;&nbsp;&nbsp;&nbsp;- `requestId?: string` — необязательный идентификатор для сопоставления результата<br>&nbsp;&nbsp;&nbsp;&nbsp;- `name: string` — имя файла<br>&nbsp;&nbsp;&nbsp;&nbsp;- `size: number` — размер файла в байтах<br>&nbsp;&nbsp;&nbsp;&nbsp;- `type: string` — MIME-тип файла<br>&nbsp;&nbsp;&nbsp;&nbsp;- `folderId?: string \| null` — целевая папка<br>&nbsp;&nbsp;&nbsp;&nbsp;- `data: Blob \| string` — содержимое файла<br>&nbsp;&nbsp;&nbsp;&nbsp;- `extension?: string` — расширение файла<br>- `folderId?: string \| null` — папка для загрузки по умолчанию | `BatchResult<UploadFileResultData>` | Загрузить несколько файлов. Порядок элементов важен — при отсутствии `requestId` результаты сопоставляются по индексу |
-| **uploadFileByUrl** | `url: string`, `folderId?: string` | `FileSystemItem` | Загрузить файл по URL (проверять существующие файлы) |
-| `findItemByPath` | `path: string` | `FileSystemItem \| undefined` | Найти системные файлы/папки по пути |
-| `setController` | `controller: StorageProviderController` | `void` | Установить контроллер управления кэшем |
-| `getFileData` | `file: FileSystemItem` | `Blob` | Получить содержимое файла как blob |
-| `getUrl` | `file: FileSystemItem` | `string` | Получить URL для доступа к файлу |
-| `getThumbnailUrl` | `file: FileSystemItem` | `string` | Получить URL миниатюры |
-| `renameItem` | `item: FileSystemItem`, `newName: string` | `FileSystemItemUpdate` | Переименовать файл/папку |
-| `deleteItem` | `item: FileSystemItem` | `void` | Удалить один элемент (перемещает в корзину при мягком удалении) |
-| `deleteItems` | `items: FileSystemItem[]` | `BatchResult<never>` | Удалить несколько элементов |
-| `moveItem` | `item: FileSystemItem`, `targetFolderId?: string` | `FileSystemItemUpdate` | Переместить один элемент |
-| `moveItems` | `items: FileSystemItem[]`, `targetFolderId?: string` | `BatchResult<FileSystemItemUpdate>` | Переместить несколько элементов |
-| `copyItem` | `item: FileSystemItem`, `targetFolderId?: string` | `FileSystemItemUpdate` | Копировать один элемент |
-| `copyItems` | `items: FileSystemItem[]`, `targetFolderId?: string` | `BatchResult<FileSystemItemUpdate>` | Копировать несколько элементов |
-| `updateFile` | `file: FileSystemItem`, `updates`: объект с метаданными | `FileSystemItemUpdate` | Обновить метаданные/содержимое файла |
+##### Основные методы
+
+| Метод               | Параметры                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Возвращает                                                                 | Описание                                                                                                              |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| **getItems**        | `options`:<br>- `folderId?: string`<br>- `search?: string`<br>- `sortBy?: string`<br>- `sortOrder?: 'asc'\|'desc'`<br>- `page?: number`<br>- `limit?: number`<br>- `itemType: 'all'\|'file'\|'folder'`                                                                                                                                                                                                                                                                                                                                                                                                                                   | `{ items: FileSystemItem[], pagination?: Partial<ApiPaginationResponse> }` | Получить список файлов и папок с фильтрацией, сортировкой, пагинацией                                                 |
+| **createFolder**    | `name: string`, `parentid?: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `FileSystemItem`                                                           | Создать новую папку                                                                                                   |
+| uploadFile          | `file`: <br>- `name: string`<br>- `size: number`<br>- `type: string`<br>- `folderId?: string`<br>- `data: Blob \| string`<br>- `thumbnail?: string`<br>- `dimensions?: string`<br>- `aspectRatio?: string`<br>- `extension?: string`                                                                                                                                                                                                                                                                                                                                                                                                     | `FileSystemItemUpdate`                                                     | Загрузить файл с метаданными                                                                                          |
+| uploadFiles         | `request`:<br>- `items`: массив объектов:<br>&nbsp;&nbsp;&nbsp;&nbsp;- `requestId?: string` — необязательный идентификатор для сопоставления результата<br>&nbsp;&nbsp;&nbsp;&nbsp;- `name: string` — имя файла<br>&nbsp;&nbsp;&nbsp;&nbsp;- `size: number` — размер файла в байтах<br>&nbsp;&nbsp;&nbsp;&nbsp;- `type: string` — MIME-тип файла<br>&nbsp;&nbsp;&nbsp;&nbsp;- `folderId?: string \| null` — целевая папка<br>&nbsp;&nbsp;&nbsp;&nbsp;- `data: Blob \| string` — содержимое файла<br>&nbsp;&nbsp;&nbsp;&nbsp;- `extension?: string` — расширение файла<br>- `folderId?: string \| null` — папка для загрузки по умолчанию | `BatchResult<UploadFileResultData>`                                        | Загрузить несколько файлов. Порядок элементов важен — при отсутствии `requestId` результаты сопоставляются по индексу |
+| **uploadFileByUrl** | `url: string`, `folderId?: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `FileSystemItem`                                                           | Загрузить файл по URL (проверять существующие файлы)                                                                  |
+| `findItemByPath`    | `path: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | `FileSystemItem \| undefined`                                              | Найти системные файлы/папки по пути                                                                                   |
+| `setController`     | `controller: StorageProviderController`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `void`                                                                     | Установить контроллер управления кэшем                                                                                |
+| `getFileData`       | `file: FileSystemItem`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `Blob`                                                                     | Получить содержимое файла как blob                                                                                    |
+| `getUrl`            | `file: FileSystemItem`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `string`                                                                   | Получить URL для доступа к файлу                                                                                      |
+| `getThumbnailUrl`   | `file: FileSystemItem`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `string`                                                                   | Получить URL миниатюры                                                                                                |
+| `renameItem`        | `item: FileSystemItem`, `newName: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `FileSystemItemUpdate`                                                     | Переименовать файл/папку                                                                                              |
+| `deleteItem`        | `item: FileSystemItem`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `void`                                                                     | Удалить один элемент (перемещает в корзину при мягком удалении)                                                       |
+| `deleteItems`       | `items: FileSystemItem[]`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `BatchResult<never>`                                                       | Удалить несколько элементов                                                                                           |
+| `moveItem`          | `item: FileSystemItem`, `targetFolderId?: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | `FileSystemItemUpdate`                                                     | Переместить один элемент                                                                                              |
+| `moveItems`         | `items: FileSystemItem[]`, `targetFolderId?: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `BatchResult<FileSystemItemUpdate>`                                        | Переместить несколько элементов                                                                                       |
+| `copyItem`          | `item: FileSystemItem`, `targetFolderId?: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | `FileSystemItemUpdate`                                                     | Копировать один элемент                                                                                               |
+| `copyItems`         | `items: FileSystemItem[]`, `targetFolderId?: string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `BatchResult<FileSystemItemUpdate>`                                        | Копировать несколько элементов                                                                                        |
+| `updateFile`        | `file: FileSystemItem`, `updates`: объект с метаданными                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `FileSystemItemUpdate`                                                     | Обновить метаданные/содержимое файла                                                                                  |
 
 ##### Определения типов
 
@@ -431,4 +464,4 @@ emailmaker.init({
 - **Разрешение путей**: `trashPath` и `tempPath` преобразуются в реальные идентификаторы папок
 - **Загрузка по URL**: Должна проверять, существует ли файл уже на текущем сервере
 - **Управление кэшем**: Используйте `setController` для запросов инвалидации кэша
-- **Двойное мягкое удаление**: Если бэкенд уже реализует мягкое удаление, оставьте `useSoftDelete=false`
+- **Двойное мягкое удаление**: Если бэкенд уже реализует мягкое удаление, оставьте `useSoftDelete=false`