@sequent-org/moodboard 1.4.47 → 1.4.48

package/package.json

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

package/src/services/ai/AiClient.js

@@ -217,6 +217,57 @@ export class AiClient {
         return res.json();
     }
 
+    /**
+     * Отправляет джоб генерации видео.
+     * @param {object} args
+     * @param {string} [args.provider='gemini-video']
+     * @param {string} args.prompt
+     * @param {string} [args.negativePrompt]
+     * @param {string} [args.model]
+     * @param {string} [args.ratio]
+     * @param {string} [args.resolution]
+     * @param {number} [args.duration]
+     * @param {number} [args.seed]
+     * @param {File[]} [args.referenceImages]
+     * @param {AbortSignal} [args.signal]
+     * @returns {Promise<{jobId: string}>}
+     */
+    async submitVideo({ provider = 'gemini-video', signal, referenceImages: files, ...payload }) {
+        const referenceImages = await filesToBase64(files);
+        const body = referenceImages ? { ...payload, referenceImages } : payload;
+        const res = await this._fetch(`${this._baseUrl}/${provider}/video`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'Accept': 'application/json' },
+            body: JSON.stringify(body),
+            signal
+        });
+        if (!res.ok) {
+            const detail = await safeReadError(res);
+            throw new Error(`AiClient.submitVideo (${res.status}): ${detail}`);
+        }
+        return res.json();
+    }
+
+    /**
+     * Опрашивает статус джоба генерации видео.
+     * @param {string} jobId
+     * @param {AbortSignal} [signal]
+     * @param {string} [provider='gemini-video']
+     * @returns {Promise<object>}
+     */
+    async pollVideo(jobId, signal, provider = 'gemini-video') {
+        const res = await this._fetch(`${this._baseUrl}/${provider}/video/${jobId}`, {
+            method: 'GET',
+            headers: { 'Accept': 'application/json' },
+            signal
+        });
+        if (!res.ok) {
+            const detail = await safeReadError(res);
+            throw new Error(`AiClient.pollVideo (${res.status}): ${detail}`);
+        }
+        return res.json();
+    }
+
     /**
      * Отправляет джоб конвертации GLB -> FBX/STL.
      * @param {object} args

package/src/services/ai/VideoSessionController.js

@@ -0,0 +1,175 @@
+/**
+ * Контроллер сессии генерации видео.
+ *
+ * Одна ответственность: оркестрирует submit -> poll-цикл через AiClient,
+ * держит состояние джоба и уведомляет подписчиков об изменениях.
+ * Не знает про DOM, доску и UI.
+ *
+ * Состояние:
+ *   - status:   'idle' | 'submitting' | 'polling' | 'done' | 'error'
+ *   - progress: number (0–100)
+ *   - error:    string | null
+ *   - jobId:    string | null
+ *   - result:   { videoUrl: string, mimeType: string } | null
+ */
+
+const POLL_INTERVAL_MS = 3000;
+const JOB_TIMEOUT_MS   = 300_000; // 300с — видео генерируется до нескольких минут
+
+export class VideoSessionController {
+    /**
+     * @param {object} deps
+     * @param {import('./AiClient.js').AiClient} deps.aiClient
+     */
+    constructor({ aiClient }) {
+        this._client    = aiClient;
+        this._listeners = new Set();
+        this._abort     = null;
+
+        this._state = {
+            status:   'idle',
+            progress: 0,
+            error:    null,
+            jobId:    null,
+            result:   null,
+        };
+    }
+
+    getState() {
+        return this._state;
+    }
+
+    /**
+     * @param {function} listener
+     * @returns {function} unsubscribe
+     */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => this._listeners.delete(listener);
+    }
+
+    /**
+     * Запускает джоб генерации видео.
+     * @param {object} args
+     * @param {string} [args.provider='gemini-video']
+     * @param {string} args.prompt
+     * @param {string} [args.negativePrompt]
+     * @param {string} [args.model]
+     * @param {string} [args.ratio]
+     * @param {string} [args.resolution]
+     * @param {number} [args.duration]
+     * @param {number} [args.seed]
+     * @param {File[]} [args.referenceImages]
+     * @param {AbortSignal} [args.signal]
+     * @returns {Promise<void>}
+     */
+    async start({ provider = 'gemini-video', signal: externalSignal, ...rest } = {}) {
+        if (this._abort) this.abort();
+
+        const abort = new AbortController();
+        this._abort = abort;
+        const { signal } = abort;
+
+        if (externalSignal) {
+            if (externalSignal.aborted) { abort.abort(); return; }
+            externalSignal.addEventListener('abort', () => abort.abort(), { once: true });
+        }
+
+        this._setState({ status: 'submitting', progress: 0, error: null, jobId: null, result: null });
+
+        const timeoutId = setTimeout(() => {
+            if (this._abort === abort) {
+                abort.abort();
+                this._setState({ status: 'error', error: 'Таймаут: джоб превысил 300 секунд' });
+            }
+        }, JOB_TIMEOUT_MS);
+
+        try {
+            const { jobId } = await this._client.submitVideo({ provider, signal, ...rest });
+            if (signal.aborted) return;
+
+            this._setState({ status: 'polling', jobId });
+
+            const result = await this._pollLoop(jobId, signal, provider);
+            if (!result || signal.aborted) return;
+
+            const { videoUrl, mimeType } = result;
+            this._setState({ status: 'done', progress: 100, result: { videoUrl, mimeType } });
+        } catch (err) {
+            if (err?.name === 'AbortError' || signal.aborted) return;
+            this._setState({ status: 'error', error: err?.message || 'Ошибка запроса' });
+        } finally {
+            clearTimeout(timeoutId);
+            if (this._abort === abort) this._abort = null;
+        }
+    }
+
+    /** Прерывает submit или поллинг. */
+    abort() {
+        if (this._abort) {
+            try { this._abort.abort(); } catch { /* noop */ }
+            this._abort = null;
+        }
+    }
+
+    async _pollLoop(jobId, signal, provider) {
+        while (!signal.aborted) {
+            await sleep(POLL_INTERVAL_MS, signal);
+            if (signal.aborted) return null;
+
+            let data;
+            try {
+                data = await this._client.pollVideo(jobId, signal, provider);
+            } catch (err) {
+                if (err?.name === 'AbortError' || signal.aborted) return null;
+                this._setState({ status: 'error', error: err?.message || 'Ошибка поллинга' });
+                return null;
+            }
+
+            const { status, progress, error } = data;
+
+            if (status === 'done') return data;
+
+            if (status === 'error') {
+                this._setState({ status: 'error', error: error || 'Ошибка джоба' });
+                return null;
+            }
+
+            // 'pending' | 'running' — обновляем прогресс
+            this._setState({ progress: progress ?? this._state.progress });
+        }
+        return null;
+    }
+
+    _setState(patch) {
+        this._state = { ...this._state, ...patch };
+        this._emit();
+    }
+
+    _emit() {
+        for (const listener of this._listeners) {
+            try { listener(this._state); } catch (err) {
+                console.error('[VideoSession] listener error:', err);
+            }
+        }
+    }
+}
+
+/**
+ * Promise, который разрешается через ms миллисекунд или отклоняется по AbortSignal.
+ * @param {number} ms
+ * @param {AbortSignal} [signal]
+ */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException('Aborted', 'AbortError'));
+            return;
+        }
+        const id = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(id);
+            reject(new DOMException('Aborted', 'AbortError'));
+        }, { once: true });
+    });
+}

package/src/services/ai/imageModelCapabilities.js

@@ -0,0 +1,130 @@
+/**
+ * Конфигурация возможностей моделей генерации изображений.
+ *
+ * Одна ответственность: данные и чистые helper-функции.
+ * Никакого DOM, никаких импортов UI.
+ *
+ * @typedef {Object} ImageModelCapability
+ * @property {string}   id               - уникальный идентификатор
+ * @property {string}   label            - подпись в UI (бренд/название модели)
+ * @property {string}   description      - описание (провайдер · техническое имя)
+ * @property {string}   provider         - идентификатор провайдера для бэкенда
+ * @property {string}   model            - код модели для бэкенда
+ * @property {string|undefined} quality  - 'high' | 'medium' | 'low' | undefined
+ * @property {string[]} ratios           - поддерживаемые соотношения сторон (id из FORMAT_OPTIONS)
+ * @property {string[]} resolutions      - допустимые разрешения; [] = выбор не нужен
+ * @property {string|null} defaultResolution - дефолтное разрешение или null
+ * @property {number}   maxCount         - максимальное количество изображений в одном запросе
+ * @property {{
+ *   seed:           boolean,
+ *   negativePrompt: boolean,
+ *   background:     boolean,
+ *   outputFormat:   boolean,
+ *   promptExtend:   boolean,
+ *   watermark:      boolean
+ * }} supports - флаги поддерживаемых доп-настроек
+ */
+
+/** @type {ImageModelCapability[]} */
+export const IMAGE_MODELS = [
+    {
+        id: 'yandex-art',
+        label: 'Yandex GPT',
+        description: 'Yandex · Шедеврум',
+        provider: 'yandex-art',
+        model: 'yandex-art',
+        quality: undefined,
+        ratios: ['1:1', '16:9', '9:16', '3:4', '4:3'],
+        resolutions: [],
+        defaultResolution: null,
+        maxCount: 1,
+        supports: { seed: true, negativePrompt: true, background: false, outputFormat: false, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'nano-banana-pro',
+        label: 'Nano Banana Pro',
+        description: 'Google · Gemini 3 Pro Image',
+        provider: 'gemini-image',
+        model: 'gemini-3-pro-image',
+        quality: undefined,
+        ratios: ['1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 4,
+        supports: { seed: false, negativePrompt: false, background: false, outputFormat: false, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'nano-banana-2',
+        label: 'Nano Banana 2',
+        description: 'Google · Gemini 3.1 Flash Image',
+        provider: 'gemini-image',
+        model: 'gemini-3.1-flash-image',
+        quality: undefined,
+        ratios: ['1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9', '1:4', '4:1', '1:8', '8:1'],
+        resolutions: ['512', '1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 4,
+        supports: { seed: false, negativePrompt: false, background: false, outputFormat: false, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'gpt-image-2-high',
+        label: 'GPT-Image-2 High',
+        description: 'OpenAI · gpt-image-2 · High',
+        provider: 'openai-image',
+        model: 'gpt-image-2',
+        quality: 'high',
+        ratios: ['1:1', '3:2', '2:3', '16:9', '9:16'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, background: true, outputFormat: true, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'gpt-image-2-medium',
+        label: 'GPT-Image-2 Medium',
+        description: 'OpenAI · gpt-image-2 · Medium',
+        provider: 'openai-image',
+        model: 'gpt-image-2',
+        quality: 'medium',
+        ratios: ['1:1', '3:2', '2:3', '16:9', '9:16'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, background: true, outputFormat: true, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'gpt-image-2-low',
+        label: 'GPT-Image-2 Low',
+        description: 'OpenAI · gpt-image-2 · Low',
+        provider: 'openai-image',
+        model: 'gpt-image-2',
+        quality: 'low',
+        ratios: ['1:1', '3:2', '2:3', '16:9', '9:16'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, background: true, outputFormat: true, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'qwen-image-2-pro',
+        label: 'Qwen Image 2 Pro',
+        description: 'Alibaba · qwen-image-2.0-pro',
+        provider: 'qwen-image',
+        model: 'qwen-image-2.0-pro',
+        quality: undefined,
+        ratios: ['1:1', '16:9', '9:16', '4:3', '3:4', '2:3', '3:2', '21:9'],
+        resolutions: [],
+        defaultResolution: null,
+        maxCount: 6,
+        supports: { seed: true, negativePrompt: true, background: false, outputFormat: false, promptExtend: true, watermark: true }
+    }
+];
+
+/**
+ * Возвращает объект возможностей модели по id или null, если модель не найдена.
+ * @param {string} id
+ * @returns {ImageModelCapability|null}
+ */
+export function getImageModelCapability(id) {
+    return IMAGE_MODELS.find((m) => m.id === id) ?? null;
+}

package/src/services/ai/videoModelCapabilities.js

@@ -0,0 +1,120 @@
+/**
+ * Конфигурация возможностей моделей генерации видео.
+ *
+ * Одна ответственность: данные и чистые helper-функции.
+ * Никакого DOM, никаких импортов UI.
+ *
+ * ВНИМАНИЕ: provider-id (gemini-video, seedance, veo, kling, openai-video) — предварительные;
+ * подлежат сверке с бэкендом Futurello перед включением в prod.
+ *
+ * @typedef {Object} VideoModelCapability
+ * @property {string}      id              - уникальный идентификатор
+ * @property {string}      label           - подпись в UI
+ * @property {string}      description     - описание (провайдер · техническое имя)
+ * @property {string}      provider        - идентификатор провайдера для бэкенда
+ * @property {string}      model           - код модели для бэкенда
+ * @property {string[]}    ratios          - поддерживаемые соотношения сторон
+ * @property {string[]}    resolutions     - допустимые разрешения; [] = выбор не нужен
+ * @property {number[]}    durations       - допустимые длительности в секундах
+ * @property {number|null} defaultDuration - дефолтная длительность или null
+ * @property {number}      maxCount        - максимальное количество видео в одном запросе
+ * @property {{
+ *   seed:             boolean,
+ *   negativePrompt:   boolean,
+ *   audio:            boolean,
+ *   watermark:        boolean,
+ *   personGeneration: boolean,
+ *   cfgScale:         boolean
+ * }} supports
+ */
+
+/** @type {VideoModelCapability[]} */
+export const VIDEO_MODELS = [
+    {
+        id: 'gemini-omni-flash',
+        label: 'Gemini-Omni-Flash',
+        description: 'Google · gemini-omni-flash',
+        provider: 'gemini-video',
+        model: 'gemini-omni-flash',
+        ratios: ['16:9', '9:16'],
+        resolutions: [],
+        durations: [4, 6, 8, 10],
+        defaultDuration: 4,
+        maxCount: 1,
+        supports: { seed: true, negativePrompt: false, audio: true, watermark: false, personGeneration: false, cfgScale: false },
+    },
+    {
+        id: 'seedance-2',
+        label: 'Seedance 2.0',
+        description: 'ByteDance · doubao-seedance-2-0',
+        provider: 'seedance',
+        model: 'doubao-seedance-2-0',
+        ratios: ['16:9', '9:16', '4:3', '3:4', '1:1', '21:9'],
+        resolutions: ['480p', '720p', '1080p'],
+        durations: [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+        defaultDuration: 5,
+        maxCount: 1,
+        supports: { seed: true, negativePrompt: true, audio: true, watermark: true, personGeneration: false, cfgScale: false },
+    },
+    {
+        id: 'veo-3-1',
+        label: 'Veo 3.1',
+        description: 'Google · veo-3.1-generate-preview',
+        provider: 'veo',
+        model: 'veo-3.1-generate-preview',
+        ratios: ['16:9', '9:16'],
+        resolutions: ['720p', '1080p'],
+        durations: [4, 6, 8],
+        defaultDuration: 4,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: true, audio: false, watermark: false, personGeneration: true, cfgScale: false },
+    },
+    {
+        id: 'kling-3-pro',
+        label: 'Kling 3.0 Pro',
+        description: 'Kuaishou · kling-v3-pro',
+        provider: 'kling',
+        model: 'kling-v3-pro',
+        ratios: ['16:9', '9:16', '1:1'],
+        resolutions: ['720p', '1080p', '4K'],
+        durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+        defaultDuration: 5,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: true, audio: true, watermark: false, personGeneration: false, cfgScale: true },
+    },
+    {
+        id: 'kling-2-5-turbo-pro',
+        label: 'Kling 2.5 Turbo Pro',
+        description: 'Kuaishou · kling-v2.5-turbo-pro',
+        provider: 'kling',
+        model: 'kling-v2.5-turbo-pro',
+        ratios: ['16:9', '9:16', '1:1'],
+        resolutions: [],
+        durations: [5, 10],
+        defaultDuration: 5,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: true, audio: false, watermark: false, personGeneration: false, cfgScale: true },
+    },
+    {
+        id: 'sora-2',
+        label: 'Sora 2',
+        description: 'OpenAI · sora-2',
+        provider: 'openai-video',
+        model: 'sora-2',
+        ratios: ['16:9', '9:16'],
+        resolutions: [],
+        durations: [4, 8, 12],
+        defaultDuration: 4,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, audio: false, watermark: false, personGeneration: false, cfgScale: false },
+    },
+];
+
+/**
+ * Возвращает объект возможностей видео-модели по id или null, если модель не найдена.
+ * @param {string} id
+ * @returns {VideoModelCapability|null}
+ */
+export function getVideoModelCapability(id) {
+    return VIDEO_MODELS.find((m) => m.id === id) ?? null;
+}