Iniciar upload: obtener signed URL

Paso 1 del patrón 2-step. Valida mime_type + size_bytes + cuota del business, reserva una fila pending en business_files y devuelve un signed URL con TTL de 5 minutos.

Flujo completo

Paso 1 — Este endpoint

Declara la metadata del archivo y recibe el signed URL.

Paso 2 — PUT directo a Supabase (NO es un endpoint nuestro)

El cliente sube el binario directo a Storage. El server nunca ve el binario. El Content-Type del PUT debe estar en el catálogo permitido del bucket (si no, Storage responde 400). En /confirm el server lee los magic bytes del blob ya subido y los compara contra el mime_type declarado en el paso 1 (persistido en DB): si los magic bytes no corresponden a ese mime_type, la confirmación falla con MIME_MISMATCH.

curl:

curl -X PUT "<upload_url del paso 1>" \
  -H "Content-Type: application/pdf" \
  --data-binary "@./invoice.pdf"

JavaScript (Node 20+ / browser):

await fetch(uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': 'application/pdf' },
  body: file, // File object del input o ReadStream
})

n8n: nodo HTTP Request con method PUT, URL del paso 1, Body Type “Binary”, field del nodo “Read Binary File” anterior.

Paso 3 — POST /files/confirm

Tras completar el PUT, llama a /files/confirm con el file_uuid para validar el binario y recibir un signed URL de descarga usable en mensajes.

Cómo obtener mime_type y size_bytes

La metadata debe declararse antes de subir. Si la herramienta no la expone:

• JS File API: file.type y file.size vienen gratis en un objeto File.
• Node fs: fs.statSync(path).size para bytes; mime-types package para el MIME.
• curl: stat -c%s file (Linux) / stat -f%z file (macOS) / (Get-Item file).Length (PowerShell) para bytes. file --mime-type -b file para MIME.
• n8n: el nodo “Read Binary File” expone binary.data.mimeType y binary.data.fileSize.