@sequent-org/moodboard 1.4.5 → 1.4.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sequent-org/moodboard",
-  "version": "1.4.5",
+  "version": "1.4.7",
   "type": "module",
   "description": "Interactive moodboard",
   "main": "./src/index.js",

package/src/core/ApiClient.js

@@ -1,3 +1,5 @@
+import { isV2ImageDownloadUrl } from '../services/AssetUrlPolicy.js';
+
 // src/core/ApiClient.js
 export class ApiClient {
     constructor(baseUrl, authToken = null) {
@@ -159,6 +161,12 @@ export class ApiClient {
                 if (hasForbiddenInlineSrc) {
                     throw new Error(`Image object "${obj.id || 'unknown'}" contains forbidden data/blob src. Save is blocked.`);
                 }
+                if (topSrc && !isV2ImageDownloadUrl(topSrc)) {
+                    throw new Error(`Image object "${obj.id || 'unknown'}" has non-v2 src URL. Save is blocked.`);
+                }
+                if (propSrc && !isV2ImageDownloadUrl(propSrc)) {
+                    throw new Error(`Image object "${obj.id || 'unknown'}" has non-v2 properties.src URL. Save is blocked.`);
+                }
 
                 const cleanedObj = { ...obj };
 
@@ -221,7 +229,7 @@ export class ApiClient {
                     if (obj.imageId && (!obj.src && !obj.properties?.src)) {
                         try {
                             // Формируем URL изображения
-                            const imageUrl = `/api/images/${obj.imageId}/file`;
+                            const imageUrl = `/api/v2/images/${obj.imageId}/download`;
                             
                             return {
                                 ...obj,
@@ -243,7 +251,7 @@ export class ApiClient {
                     if (obj.fileId) {
                         try {
                             // Формируем URL файла для скачивания
-                            const fileUrl = `/api/files/${obj.fileId}/download`;
+                            const fileUrl = `/api/v2/files/${obj.fileId}/download`;
                             
                             // Создаем обновленный объект с восстановленными данными
                             const restoredObj = {
@@ -259,7 +267,7 @@ export class ApiClient {
                             // (Это будет выполнено асинхронно, чтобы не блокировать загрузку)
                             setTimeout(async () => {
                                 try {
-                                    const response = await fetch(`/api/files/${obj.fileId}`, {
+                                    const response = await fetch(`/api/v2/files/${obj.fileId}`, {
                                         headers: {
                                             'Accept': 'application/json',
                                             'X-Requested-With': 'XMLHttpRequest'

package/src/core/SaveManager.js

@@ -3,6 +3,7 @@
  */
 import { Events } from './events/Events.js';
 import { logMindmapCompoundDebug } from '../mindmap/MindmapCompoundContract.js';
+import { isV2ImageDownloadUrl } from '../services/AssetUrlPolicy.js';
 export class SaveManager {
     constructor(eventBus, options = {}) {
         this.eventBus = eventBus;
@@ -245,6 +246,12 @@ export class SaveManager {
             if (/^data:/i.test(topSrc) || /^blob:/i.test(topSrc) || /^data:/i.test(propSrc) || /^blob:/i.test(propSrc)) {
                 throw new Error(`Image object "${obj.id || 'unknown'}" contains forbidden data/blob src. Save is blocked.`);
             }
+            if (topSrc && !isV2ImageDownloadUrl(topSrc)) {
+                throw new Error(`Image object "${obj.id || 'unknown'}" has non-v2 src URL. Save is blocked.`);
+            }
+            if (propSrc && !isV2ImageDownloadUrl(propSrc)) {
+                throw new Error(`Image object "${obj.id || 'unknown'}" has non-v2 properties.src URL. Save is blocked.`);
+            }
         }
     }
 

package/src/core/commands/CreateObjectCommand.js

@@ -33,14 +33,6 @@ export class CreateObjectCommand extends BaseCommand {
     }
 
     undo() {
-        // Удаляем объект из состояния и PIXI
-        this.coreMoodboard.state.removeObject(this.objectData.id);
-        this.coreMoodboard.pixi.removeObject(this.objectData.id);
-        
-
-        
-        this.coreMoodboard.eventBus.emit(Events.Object.Deleted, { 
-            objectId: this.objectData.id 
-        });
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 }

package/src/core/commands/DeleteObjectCommand.js

@@ -9,116 +9,47 @@ export class DeleteObjectCommand extends BaseCommand {
         super('delete_object', `Удалить объект`);
         this.coreMoodboard = coreMoodboard;
         this.objectId = objectId;
-        
-        // Сохраняем данные объекта для возможности восстановления
-        const objects = this.coreMoodboard.state.getObjects();
-        const originalData = objects.find(obj => obj.id === objectId);
-        
-        if (!originalData) {
-            throw new Error(`Object with id ${objectId} not found`);
-        }
 
-        // Делаем глубокую копию данных объекта
-        this.objectData = JSON.parse(JSON.stringify(originalData));
-        
-        // Для изображений убедимся, что есть src URL для восстановления
-        if (this.objectData.type === 'image') {
-            
-            if (this.objectData.imageId) {
-                const imageUrl = `/api/images/${this.objectData.imageId}/file`;
-                
-                // Всегда восстанавливаем URL из imageId для гарантии
-                // (может быть удален при предыдущих сохранениях)
-                this.objectData.src = imageUrl;
-                
-                if (!this.objectData.properties) {
-                    this.objectData.properties = {};
-                }
-                this.objectData.properties.src = imageUrl;
-                
-            } else {
-            }
-        }
-        
-        // Для файлов сохраняем информацию для возможной очистки с сервера
-        if (this.objectData.type === 'file') {
-            
-            if (this.objectData.fileId) {
-                // Сохраняем fileId для удаления с сервера
-                this.fileIdToDelete = this.objectData.fileId;
-            }
+        const currentObject = this._getCurrentObject();
+        if (!currentObject) {
+            throw new Error(`Object with id ${objectId} not found`);
         }
-        
-        // Обновляем описание с типом объекта
-        this.description = `Удалить ${this.objectData.type}`;
+        this.description = `Удалить ${currentObject.type}`;
     }
 
     async execute() {
         console.log('🗑️ DeleteObjectCommand: начинаем удаление объекта:', this.objectId);
-        
+
+        const currentObject = this._getCurrentObject();
+        const blobSrc = currentObject?.properties?.src || currentObject?.src;
+
         // Удаляем объект из состояния и PIXI
         this.coreMoodboard.state.removeObject(this.objectId);
         this.coreMoodboard.pixi.removeObject(this.objectId);
-        
+
         console.log('🗑️ DeleteObjectCommand: объект удален из state и PIXI');
 
         // Освобождаем blob URL у изображений (утечка памяти при fallback без upload)
-        const blobSrc = this.objectData?.properties?.src || this.objectData?.src;
         if (typeof blobSrc === 'string' && blobSrc.startsWith('blob:')) {
             try {
                 URL.revokeObjectURL(blobSrc);
             } catch (_) {}
         }
-        
-        // Если это файловый объект с fileId, удаляем файл с сервера
-        if (this.fileIdToDelete && this.coreMoodboard.fileUploadService) {
-            try {
-                console.log('🗑️ Удаляем файл с сервера:', this.fileIdToDelete);
-                await this.coreMoodboard.fileUploadService.deleteFile(this.fileIdToDelete);
-                console.log('✅ Файл успешно удален с сервера:', this.fileIdToDelete);
-            } catch (error) {
-                console.warn('⚠️ Ошибка удаления файла с сервера:', error);
-                // Не останавливаем выполнение команды, так как объект уже удален из UI
-            }
-        }
-        
+
         // Эмитим событие удаления для обновления всех UI компонентов
-        this.coreMoodboard.eventBus.emit(Events.Object.Deleted, { 
-            objectId: this.objectId 
+        this.coreMoodboard.eventBus.emit(Events.Object.Deleted, {
+            objectId: this.objectId
         });
-        
+
         console.log('✅ DeleteObjectCommand: событие Events.Object.Deleted отправлено');
     }
 
     undo() {
-        
-        // Специальная обработка для файловых объектов
-        if (this.objectData.type === 'file' && this.fileIdToDelete) {
-            
-            // Файл был удален с сервера, создаем объект с предупреждением
-            const restoredObjectData = { ...this.objectData };
-            if (restoredObjectData.properties) {
-                restoredObjectData.properties = {
-                    ...restoredObjectData.properties,
-                    fileName: `[УДАЛЕН] ${restoredObjectData.properties.fileName || 'файл'}`,
-                    isDeleted: true // Флаг для FileObject чтобы показать другую иконку
-                };
-            }
-            
-            // Восстанавливаем объект с измененными данными
-            this.coreMoodboard.state.addObject(restoredObjectData);
-            this.coreMoodboard.pixi.createObject(restoredObjectData);
-            
-            console.warn('⚠️ Файл восстановлен на холсте, но был удален с сервера');
-        } else {
-            // Восстанавливаем объект с сохраненными данными (для всех остальных типов)
-            this.coreMoodboard.state.addObject(this.objectData);
-            this.coreMoodboard.pixi.createObject(this.objectData);
-        }
-        
-        this.coreMoodboard.eventBus.emit(Events.Object.Created, { 
-            objectId: this.objectId, 
-            objectData: this.objectData 
-        });
+        // Локальный undo-restore отключен: история состояния загружается с сервера по версиям.
+    }
+
+    _getCurrentObject() {
+        const objects = this.coreMoodboard.state.getObjects();
+        return objects.find(obj => obj.id === this.objectId);
     }
 }

package/src/core/commands/EditFileNameCommand.js

@@ -22,8 +22,7 @@ export class EditFileNameCommand extends BaseCommand {
     }
 
     async undo() {
-        // Возвращаем старое название
-        await this._setFileName(this.oldName);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     /**

package/src/core/commands/GroupDeleteCommand.js

@@ -10,66 +10,33 @@ export class GroupDeleteCommand extends BaseCommand {
         super('group_delete', `Удалить группу (${objectIds.length} объектов)`);
         this.coreMoodboard = coreMoodboard;
         this.objectIds = Array.isArray(objectIds) ? [...objectIds] : [];
-
-        const objects = this.coreMoodboard.state.getObjects();
-        this.objectsData = [];
-        for (const id of this.objectIds) {
-            const obj = objects.find((o) => o.id === id);
-            if (obj) {
-                const data = JSON.parse(JSON.stringify(obj));
-                if (data.type === 'image') {
-                    if (data.imageId) {
-                        const imageUrl = `/api/images/${data.imageId}/file`;
-                        data.src = imageUrl;
-                        if (!data.properties) data.properties = {};
-                        data.properties.src = imageUrl;
-                    }
-                }
-                this.objectsData.push({ id, data });
-            }
-        }
     }
 
     async execute() {
-        for (const { id, data } of this.objectsData) {
+        for (const id of this.objectIds) {
+            const obj = this._getObjectById(id);
+            if (!obj) continue;
+
+            const blobSrc = obj?.properties?.src || obj?.src;
             this.coreMoodboard.state.removeObject(id);
             this.coreMoodboard.pixi.removeObject(id);
 
-            const blobSrc = data?.properties?.src || data?.src;
             if (typeof blobSrc === 'string' && blobSrc.startsWith('blob:')) {
                 try {
                     URL.revokeObjectURL(blobSrc);
                 } catch (_) {}
             }
 
-            if (data.type === 'file' && data.fileId && this.coreMoodboard.fileUploadService) {
-                try {
-                    await this.coreMoodboard.fileUploadService.deleteFile(data.fileId);
-                } catch (_) {}
-            }
-
             this.coreMoodboard.eventBus.emit(Events.Object.Deleted, { objectId: id });
         }
     }
 
     undo() {
-        for (const { id, data } of this.objectsData) {
-            if (data.type === 'file' && data.fileId) {
-                const restored = { ...data };
-                if (restored.properties) {
-                    restored.properties = {
-                        ...restored.properties,
-                        fileName: `[УДАЛЕН] ${restored.properties.fileName || 'файл'}`,
-                        isDeleted: true,
-                    };
-                }
-                this.coreMoodboard.state.addObject(restored);
-                this.coreMoodboard.pixi.createObject(restored);
-            } else {
-                this.coreMoodboard.state.addObject(data);
-                this.coreMoodboard.pixi.createObject(data);
-            }
-            this.coreMoodboard.eventBus.emit(Events.Object.Created, { objectId: id, objectData: data });
-        }
+        // Локальный undo-restore отключен: история состояния загружается с сервера по версиям.
+    }
+
+    _getObjectById(id) {
+        const objects = this.coreMoodboard.state.getObjects();
+        return objects.find((obj) => obj.id === id);
     }
 }

package/src/core/commands/GroupMoveCommand.js

@@ -47,32 +47,7 @@ export class GroupMoveCommand extends BaseCommand {
     }
 
     undo() {
-        // Возвращаем исходные позиции
-        for (const item of this.moves) {
-            if (this.coordinatesAreTopLeft) {
-                // Координаты уже левый-верх (Frame перемещение)
-                this.core.updateObjectPositionDirect(item.id, item.from);
-                this.emit(Events.Object.TransformUpdated, {
-                    objectId: item.id,
-                    type: 'position',
-                    position: item.from
-                });
-            } else {
-                // Координаты - центры PIXI (обычное групповое перемещение)
-                const pixiObject = this.core?.pixi?.objects?.get(item.id);
-                if (pixiObject) {
-                    const halfW = (pixiObject.width || 0) / 2;
-                    const halfH = (pixiObject.height || 0) / 2;
-                    const topLeft = { x: item.from.x - halfW, y: item.from.y - halfH };
-                    this.core.updateObjectPositionDirect(item.id, topLeft);
-                    this.emit(Events.Object.TransformUpdated, {
-                        objectId: item.id,
-                        type: 'position',
-                        position: topLeft
-                    });
-                }
-            }
-        }
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     getDescription() {

package/src/core/commands/GroupReorderZCommand.js

@@ -22,8 +22,7 @@ export class GroupReorderZCommand extends BaseCommand {
     }
 
     undo() {
-        if (!this.beforeOrder) return;
-        this.applyOrder(this.beforeOrder);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     applyOrder(idOrder) {

package/src/core/commands/GroupResizeCommand.js

@@ -23,10 +23,7 @@ export class GroupResizeCommand extends BaseCommand {
     }
 
     undo() {
-        for (const c of this.changes) {
-            this.core.updateObjectSizeAndPositionDirect(c.id, c.fromSize, c.fromPos, c.type || null);
-            this.emit(Events.Object.TransformUpdated, { objectId: c.id, type: 'resize', size: c.fromSize, position: c.fromPos });
-        }
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     getDescription() {

package/src/core/commands/GroupRotateCommand.js

@@ -28,15 +28,7 @@ export class GroupRotateCommand extends BaseCommand {
     }
 
     undo() {
-        for (const c of this.changes) {
-            if (this.core.pixi?.updateObjectRotation) {
-                this.core.pixi.updateObjectRotation(c.id, c.fromAngle);
-            }
-            this.core.updateObjectRotationDirect(c.id, c.fromAngle);
-            this.core.updateObjectPositionDirect(c.id, c.fromPos);
-            this.emit(Events.Object.TransformUpdated, { objectId: c.id, type: 'rotation', angle: c.fromAngle });
-            this.emit(Events.Object.TransformUpdated, { objectId: c.id, type: 'position', position: c.fromPos });
-        }
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     getDescription() {

package/src/core/commands/MindmapStatePatchCommand.js

@@ -29,7 +29,7 @@ export class MindmapStatePatchCommand extends BaseCommand {
     }
 
     undo() {
-        this._applyEntries(this.beforeEntries);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     _applyEntries(entries) {

package/src/core/commands/MoveObjectCommand.js

@@ -23,9 +23,7 @@ export class MoveObjectCommand extends BaseCommand {
     }
 
     undo() {
-        // Возвращаем старую позицию
-        this._setPosition(this.oldPosition);
-
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     _setPosition(position) {

package/src/core/commands/PasteObjectCommand.js

@@ -96,16 +96,7 @@ export class PasteObjectCommand extends BaseCommand {
     }
 
     undo() {
-        if (this.newObjectId) {
-            // Удаляем созданный объект
-            this.coreMoodboard.state.removeObject(this.newObjectId);
-            this.coreMoodboard.pixi.removeObject(this.newObjectId);
-            
-            // Соответствующего константного события нет — остаёмся без эмита или используем Object.Deleted, если надо глобально
-            this.emit(Events.Object.Deleted, {
-                objectId: this.newObjectId
-            });
-        }
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     getDescription() {

package/src/core/commands/ReorderZCommand.js

@@ -18,7 +18,7 @@ export class ReorderZCommand extends BaseCommand {
     }
 
     undo() {
-        this.apply(this.toIndex, this.fromIndex);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     apply(from, to) {

package/src/core/commands/ResizeObjectCommand.js

@@ -25,9 +25,7 @@ export class ResizeObjectCommand extends BaseCommand {
     }
 
     undo() {
-        // Возвращаем старый размер и позицию
-        this._setSizeAndPosition(this.oldSize, this.oldPosition);
-        this._updateResizeHandles();
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     _setSizeAndPosition(size, position = null) {

package/src/core/commands/RotateObjectCommand.js

@@ -25,15 +25,7 @@ export class RotateObjectCommand extends BaseCommand {
     }
 
     undo() {
-        // Обновляем угол поворота в состоянии
-        this._setRotation(this.oldAngle);
-        
-        // Возвращаем старый угол поворота
-        this.emit(Events.Object.Rotate, {
-            objectId: this.objectId,
-            angle: this.oldAngle
-        });
-        console.log(`↩️ Отменяем поворот объекта ${this.objectId}, возвращаем ${this.oldAngle}°`);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     /**

package/src/core/commands/UpdateContentCommand.js

@@ -22,7 +22,7 @@ export class UpdateContentCommand extends BaseCommand {
     }
 
     undo() {
-        this._applyContent(this.oldContent, this.oldSize, this.oldPosition);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     canMergeWith(otherCommand) {

package/src/core/commands/UpdateFramePropertiesCommand.js

@@ -34,7 +34,7 @@ export class UpdateFramePropertiesCommand extends BaseCommand {
     }
 
     undo() {
-        this._apply(this.oldValue);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     canMergeWith(otherCommand) {

package/src/core/commands/UpdateFrameTypeCommand.js

@@ -32,7 +32,7 @@ export class UpdateFrameTypeCommand extends BaseCommand {
     }
 
     undo() {
-        this._apply(this.oldType, this.oldSize, this.oldPosition);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     _apply(typeValue, size, position) {

package/src/core/commands/UpdateNoteStyleCommand.js

@@ -29,7 +29,7 @@ export class UpdateNoteStyleCommand extends BaseCommand {
     }
 
     undo() {
-        this._apply(this.oldValue);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     canMergeWith(otherCommand) {

package/src/core/commands/UpdateTextStyleCommand.js

@@ -28,7 +28,7 @@ export class UpdateTextStyleCommand extends BaseCommand {
     }
 
     undo() {
-        this._apply(this.oldValue);
+        // Локальный undo отключен: история состояния загружается с сервера по версиям.
     }
 
     canMergeWith(otherCommand) {

package/src/core/flows/ClipboardFlow.js

@@ -1,6 +1,7 @@
 import { Events } from '../events/Events.js';
 import { PasteObjectCommand } from '../commands/index.js';
 import { RevitScreenshotMetadataService } from '../../services/RevitScreenshotMetadataService.js';
+import { isV2ImageDownloadUrl } from '../../services/AssetUrlPolicy.js';
 
 export function setupClipboardFlow(core) {
     const revitMetadataService = new RevitScreenshotMetadataService(console);
@@ -21,7 +22,12 @@ export function setupClipboardFlow(core) {
 
     const ensureServerImage = async ({ src, name, imageId }) => {
         if (imageId) {
-            return { src, name, imageId };
+            const serverUrl = typeof src === 'string' ? src.trim() : '';
+            if (!isV2ImageDownloadUrl(serverUrl)) {
+                alert('Некорректный адрес изображения. Изображение не добавлено.');
+                return null;
+            }
+            return { src: serverUrl, name, imageId };
         }
         if (!core.imageUploadService) {
             alert('Сервис загрузки изображений недоступен. Изображение не добавлено.');
@@ -39,8 +45,12 @@ export function setupClipboardFlow(core) {
                 const blob = await response.blob();
                 uploadResult = await core.imageUploadService.uploadImage(blob, name || 'clipboard-image');
             }
+            const serverUrl = typeof uploadResult.url === 'string' ? uploadResult.url.trim() : '';
+            if (!isV2ImageDownloadUrl(serverUrl)) {
+                throw new Error('Сервер вернул некорректный URL изображения');
+            }
             return {
-                src: uploadResult.url,
+                src: serverUrl,
                 name: uploadResult.name || name,
                 imageId: uploadResult.imageId || uploadResult.id
             };
@@ -272,10 +282,12 @@ export function setupClipboardFlow(core) {
             const img = new Image();
             img.decoding = 'async';
             img.onload = () => { void placeWithAspect(img.naturalWidth || 0, img.naturalHeight || 0); };
-            img.onerror = () => { void placeWithAspect(0, 0); };
+            img.onerror = () => {
+                alert('Не удалось загрузить изображение с сервера. Изображение не добавлено.');
+            };
             img.src = uploaded.src;
         } catch (_) {
-            void placeWithAspect(0, 0);
+            alert('Не удалось загрузить изображение с сервера. Изображение не добавлено.');
         }
     });
 
@@ -320,10 +332,12 @@ export function setupClipboardFlow(core) {
             const img = new Image();
             img.decoding = 'async';
             img.onload = () => { void placeWithAspect(img.naturalWidth || 0, img.naturalHeight || 0); };
-            img.onerror = () => { void placeWithAspect(0, 0); };
+            img.onerror = () => {
+                alert('Не удалось загрузить изображение с сервера. Изображение не добавлено.');
+            };
             img.src = uploaded.src;
         } catch (_) {
-            void placeWithAspect(0, 0);
+            alert('Не удалось загрузить изображение с сервера. Изображение не добавлено.');
         }
     });
 

package/src/core/flows/SaveFlow.js

@@ -25,8 +25,6 @@ export function setupSaveFlow(core) {
     core.eventBus.on(Events.Save.Success, async () => {
         if (typeof core.revealPendingObjectsAfterSave === 'function') {
             core.revealPendingObjectsAfterSave();
-        } else if (typeof core.revealPendingImageObjectsAfterSave === 'function') {
-            core.revealPendingImageObjectsAfterSave();
         }
         // ВРЕМЕННО ОТКЛЮЧЕНО:
         // cleanup-фича требует доработки контракта и серверной поддержки.

package/src/core/index.js

@@ -465,11 +465,6 @@ export class CoreMoodBoard {
         this._pendingPersistAckVisibilityIds.clear();
     }
 
-    // Backward-compat alias for tests/integrations created in previous step.
-    revealPendingImageObjectsAfterSave() {
-        this.revealPendingObjectsAfterSave();
-    }
-
     // === Прикрепления к фреймам ===
     // Логика фреймов перенесена в FrameService
 

package/src/moodboard/integration/MoodBoardLoadApi.js

@@ -21,12 +21,10 @@ function resolveMoodboardApiBase(board) {
     const raw = String(board?.options?.apiUrl || '').trim();
     if (!raw) return '/api/v2/moodboard';
 
-    // Совместимость с legacy конфигом: /api/moodboard -> /api/v2/moodboard
-    if (raw.endsWith('/api/moodboard')) {
-        return raw.replace(/\/api\/moodboard$/, '/api/v2/moodboard');
-    }
-    if (raw.endsWith('/api/moodboard/')) {
-        return raw.replace(/\/api\/moodboard\/$/, '/api/v2/moodboard/');
+    const hasLegacyPath = /\/api\/moodboard(?:\/|$)/i.test(raw);
+    const hasV2Path = /\/api\/v2\/moodboard(?:\/|$)/i.test(raw);
+    if (hasLegacyPath && !hasV2Path) {
+        throw new Error('Legacy apiUrl "/api/moodboard" is not supported. Use "/api/v2/moodboard".');
     }
 
     return raw;

package/src/services/AssetUrlPolicy.js

@@ -0,0 +1,8 @@
+export function isV2ImageDownloadUrl(url) {
+    return typeof url === 'string' && /^\/api\/v2\/images\/[^/]+\/download$/i.test(url.trim());
+}
+
+export function isV2FileDownloadUrl(url) {
+    return typeof url === 'string' && /^\/api\/v2\/files\/[^/]+\/download$/i.test(url.trim());
+}
+

package/src/services/FileUploadService.js

@@ -1,11 +1,13 @@
+import { isV2FileDownloadUrl } from './AssetUrlPolicy.js';
+
 /**
  * Сервис для загрузки и управления файлами на сервере
  */
 export class FileUploadService {
     constructor(apiClient, options = {}) {
         this.apiClient = apiClient;
-        this.uploadEndpoint = '/api/files/upload';
-        this.deleteEndpoint = '/api/files';
+        this.uploadEndpoint = '/api/v2/files/upload';
+        this.deleteEndpoint = '/api/v2/files';
         this.options = {
             csrfToken: null, // Можно передать токен напрямую
             csrfTokenSelector: 'meta[name="csrf-token"]', // Селектор для поиска токена в DOM
@@ -92,10 +94,19 @@ export class FileUploadService {
                 throw new Error(result.message || 'Ошибка загрузки файла');
             }
 
+            const fileId = result.data.fileId || result.data.id;
+            const serverUrl = typeof result.data.url === 'string' ? result.data.url.trim() : '';
+            if (!fileId) {
+                throw new Error('Сервер не вернул fileId.');
+            }
+            if (!isV2FileDownloadUrl(serverUrl)) {
+                throw new Error('Некорректный URL файла от сервера. Ожидается /api/v2/files/{fileId}/download');
+            }
+
             return {
-                id: result.data.fileId || result.data.id, // Используем fileId как основное поле, id для обратной совместимости
-                fileId: result.data.fileId || result.data.id, // Добавляем fileId для явного доступа
-                url: result.data.url,
+                id: fileId, // Используем fileId как основное поле, id для обратной совместимости
+                fileId, // Добавляем fileId для явного доступа
+                url: serverUrl,
                 size: result.data.size,
                 name: result.data.name,
                 type: result.data.type

package/src/services/ImageUploadService.js

@@ -1,11 +1,13 @@
+import { isV2ImageDownloadUrl } from './AssetUrlPolicy.js';
+
 /**
  * Сервис для загрузки и управления изображениями на сервере
  */
 export class ImageUploadService {
     constructor(apiClient, options = {}) {
         this.apiClient = apiClient;
-        this.uploadEndpoint = '/api/images/upload';
-        this.deleteEndpoint = '/api/images';
+        this.uploadEndpoint = '/api/v2/images/upload';
+        this.deleteEndpoint = '/api/v2/images';
         this.options = {
             csrfToken: null, // Можно передать токен напрямую
             csrfTokenSelector: 'meta[name="csrf-token"]', // Селектор для поиска токена в DOM
@@ -97,10 +99,19 @@ export class ImageUploadService {
                 throw new Error(result.message || 'Ошибка загрузки изображения');
             }
 
+            const imageId = result.data.imageId || result.data.id;
+            const serverUrl = typeof result.data.url === 'string' ? result.data.url.trim() : '';
+            if (!imageId) {
+                throw new Error('Сервер не вернул imageId.');
+            }
+            if (!isV2ImageDownloadUrl(serverUrl)) {
+                throw new Error('Некорректный URL изображения от сервера. Ожидается /api/v2/images/{imageId}/download');
+            }
+
             return {
-                id: result.data.imageId || result.data.id, // Используем imageId как основное поле, id для обратной совместимости
-                imageId: result.data.imageId || result.data.id, // Добавляем imageId для явного доступа
-                url: result.data.url,
+                id: imageId, // Используем imageId как основное поле, id для обратной совместимости
+                imageId, // Добавляем imageId для явного доступа
+                url: serverUrl,
                 width: result.data.width,
                 height: result.data.height,
                 name: result.data.name,