Almacenamiento
API REST por proyecto en almacenamiento S3 (SeaweedFS S3), transformaciones de imágenes sobre la marcha con caché derivada, URL firmadas HMAC, depósitos públicos o privados, papelera y restauración.
Un depósito, un origen, una CDN#
El aura-storage El servicio gestiona sus archivos binarios: carga, descarga, transformaciones de imágenes, URL firmadas, papelera. Expone su propio API DESCANSO bajo /v1/storage/{project_id} y depende del almacenamiento S3 (SeaweedFS S3) internamente; las herramientas S3 (rclone, boto3) no se conectan a él directamente.
Los objetos se organizan en depósitos . Cada depósito tiene una política (pública o privada), límites de tamaño, un TTL opcional y un conjunto de políticas RLS que controlan quién puede leer/escribir cada ruta.
Los metadatos se encuentran en el esquema del proyecto: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Los bytes están en el almacenamiento S3.
Ruta → RLS → CDN → origen#
Durante una lectura, el servicio verifica el acceso a la ruta solicitada y luego entrega los bytes desde el almacenamiento. Si la consulta lleva parámetros de transformación, la derivada correspondiente se reutiliza si ya existe; de lo contrario, se calcula y luego se almacena en caché. En la carga, el flujo se invierte: cliente → servicio → almacenamiento, después de escribir el control y los límites del depósito.
┌──── derivative cache ────┐
GET /v1/storage/{pid}/… ─▶ │ derivative cached? │
│ no ⇢ origin │
└──────────┬───────────────┘
│
┌──────────▼───────────────┐
│ aura-storage │
│ ─ access control │
│ ─ transforms │
│ ─ derivative cache │
└──────────┬───────────────┘
│
S3 storage (SeaweedFS S3)
Seis habilidades nativas#
- API REST por proyecto. Rutas /v1/storage/{project_id}/… en el almacenamiento S3 (SeaweedFS S3): esta no es una API S3: los SDK S3 no se conectan a ella.
- Se transforma sobre la marcha. ancho, alto, ajuste, formato (jpeg/png/webp/gif), calidad, rotar, voltear. Cada combinación se almacena en caché como una derivada.
- URL firmadas. HMAC firma en el método + depósito + clave + vencimiento. TTL 3600 s por defecto, rotación secreta por proyecto.
- Carga multiparte. Carga simple en multipart/form-data, o init/part/complete para archivos grandes.
- Papelera y restauración. Eliminación temporal: /trash enumera los objetos eliminados, /restore/{key} los restaura.
- Depósitos públicos o privados. El depósito contiene la política de acceso, los límites de tamaño y la lista de tipos MIME autorizados.
Cuatro operaciones básicas#
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
contentType: file.type,
upsert: true,
})
// Sin upsert, una ruta ya ocupada falla en 409 (código CONFLICTO)
Las URL de transformación son inmutables según los parámetros. ?width=240&format=png y ?width=240&format=webp son dos URL distintas, por lo tanto, dos derivadas distintas: cada combinación solo se calcula una vez y luego se vuelve a leer desde el caché de derivadas.
RLS en rutas de objetos#
Los metadatos del objeto se encuentran en la tabla storage_objects del esquema del proyecto (columnas bucket_name, key, owner_id, metadata, deleted_at), con RLS habilitado. No hay ningún esquema storage ni función storage.foldername(): las políticas están escritas en las columnas.
-- Leer: objeto propio o cualquier objeto de un depósito público
create policy storage_objects_select on storage_objects for select
using (
owner_id = auth.uid()
or exists (select 1 from storage_buckets b
where b.name = storage_objects.bucket_name and b.public)
);
-- Escritura: sólo tus propios objetos
create policy storage_objects_insert on storage_objects for insert
with check (owner_id = auth.uid());