API REST + SDK TypeScript per upload, URL firmati, scansione antivirus, varianti immagini e webhook. Multi-tenant out of the box.
import { FileHubClient } from "@mischio95/file-hub-sdk";
const client = new FileHubClient({
baseUrl: "https://api.filehub.foreachsoftware.it",
apiKey: process.env.FILE_HUB_API_KEY!,
});
const upload = await client.upload.single({
file,
bucketSlug: "st-media",
visibility: "PUBLIC",
});
const signed = await client.signedUrl.generate({
fileId: upload.data.id,
expiryMinutes: 60,
});Ogni utente vede solo i propri bucket, file e API key. Isolamento basato su ownerId, applicato lato server.
Ogni mutazione viene registrata. Sottoscrivi gli eventi con payload webhook firmati HMAC.
ClamAV scansiona ogni upload prima dell'archiviazione. Quarantena al rilevamento.
URL firmati HMAC con scadenza per file privati. Distribuzione CDN senza intervento.
Genera automaticamente thumbnail e varianti small/medium/large. Sharp + WebP.
@mischio95/file-hub-sdk ti dà un client completamente tipizzato per ogni endpoint.
Schema completo su /docs. API key Bearer su ogni richiesta.
/api/v1/upload/api/v1/batch-upload/api/v1/files/api/v1/files/:id/api/v1/files/:id/download/api/v1/files/:id/serve/api/v1/signed-url/api/v1/buckets/api/v1/buckets/api/v1/api-keys/api/v1/webhooks/api/v1/audit-log