Хранилища для загрузок

Конфигурация

Настройка хранилища

• Сервер, который отвечает на POST {baseUrl}/upload (multipart) и POST {baseUrl}/upload-by-url ({ url }) JSON-объектом { url, fileName? }.
• Эндпоинт сам решает, где хранить файл: S3, дисковый том или Supabase. Пресет об этом ничего не знает.
• URL, который получает ваш эндпоинт /upload-by-url, приходит от пользователя. Проверяйте его на сервере и блокируйте внутренние и приватные адреса до того, как обращаться по нему. Иначе вы построили SSRF-вектор.

Пример использования

import { fetchStorage } from '@bloklabs/presets';

new Blok({
  holder: 'editor',
  uploader: fetchStorage({ baseUrl: 'https://api.myapp.com' }),
});

Конфигурация

Настройка хранилища

• Создайте бакет в панели Supabase (имя по умолчанию "blok" или то, которое вернёт `bucket`).
• Сделайте бакет публичным или добавьте политику Storage, дающую роли anon права на SELECT. Пресет возвращает результат getPublicUrl() напрямую, поэтому нечитаемый объект превращается в битую картинку.
• Добавьте политику Storage на INSERT для той роли, под которой аутентифицируется клиент.

Пример использования

import { createClient } from '@supabase/supabase-js';
import { supabaseStorage } from '@bloklabs/presets';

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
new Blok({ holder: 'editor', uploader: supabaseStorage(supabase, { bucket: 'blok' }) });

Конфигурация

Настройка хранилища

• Эндпоинт на бэкенде, который создаёт presigned PUT-URL (например, через S3 PutObjectCommand) и возвращает его как SignedTarget.
• Правило CORS на бакете, которое разрешает PUT с origin вашего приложения. Оно должно разрешать и заголовки, которые шлёт этот пресет, в первую очередь Content-Type. Браузер делает PUT прямо в бакет, поэтому именно на этом шаге обычно всё и застревает.

Пример использования

import { presignedStorage } from '@bloklabs/presets';

new Blok({
  holder: 'editor',
  uploader: presignedStorage({ sign: (request) => api.sign(request) }),
});

Конфигурация

Настройка хранилища

• Аккаунт Cloudinary и его cloud name.
• Upload preset с режимом подписи Unsigned (Settings → Upload → Upload presets). Подписанный пресет молча падает из браузера, потому что подписать запрос некому.
• По замыслу самого Cloudinary аудио проходит через его видеоконвейер. Пресет раскладывает типы по resource types с учётом этого. Настраивать тут ничего не нужно.

Пример использования

import { cloudinaryStorage } from '@bloklabs/presets';

new Blok({
  holder: 'editor',
  uploader: cloudinaryStorage({ cloudName: 'my-cloud', uploadPreset: 'blok-unsigned' }),
});

Конфигурация

Настройка хранилища

• Ничего. Пресету не нужен внешний сервис, в этом и смысл.
• Подключите экспортируемый хелпер resolveBlokObjectUrl(url) везде, где вы отрисовываете загруженный файл. uploadByFile возвращает ссылку вида blok:asset/…, а не готовый URL. Ничто не превратит её обратно в blob: URL автоматически.
• Если вы передали свой dbName в indexedDBStorage(), передайте тот же dbName в resolveBlokObjectUrl(url, { dbName }). При расхождении будет прочитана не та база. Вы получите null без ошибки, исключения не будет.

Пример использования

import { indexedDBStorage, resolveBlokObjectUrl } from '@bloklabs/presets';

new Blok({ holder: 'editor', uploader: indexedDBStorage() });

// Wherever you render a stored asset's url, e.g. an <img src>:
const displayUrl = await resolveBlokObjectUrl(asset.url);