Blobs

A blob is an opaque binary object stored on the node — an application bundle or arbitrary app data. mero.admin covers the full lifecycle; blob bytes are plain Data.

Upload

let bytes: Data = try Data(contentsOf: fileURL)

let info = try await mero.admin.uploadBlob(
  UploadBlobRequest(data: bytes, hash: nil, contextId: contextId)  // hash & contextId optional
)
let blobId = info.blobId

The body is sent as raw application/octet-stream to PUT /admin-api/blobs.

List

let blobs = try await mero.admin.listBlobs().blobs   // [BlobInfo] — blobId, size

Inspect without downloading

getBlobInfo issues a HEAD request — size, hash, and MIME type come from the response headers without transferring the body:

let meta = try await mero.admin.getBlobInfo(blobId)
// meta.blobId, meta.size, meta.hash, meta.mimeType

Download

getBlob returns the raw bytes as Data (the endpoint streams the content, not JSON):

let data: Data = try await mero.admin.getBlob(blobId)

Tip

Use listBlobs() / getBlobInfo() when you only need { blobId, size } metadata; reserve getBlob() for when you actually need the bytes.

Caution

getBlob() buffers the entire blob into memory as Data. For large objects, stream to disk instead via the transport’s download(_:to:) on mero.http (URLSessionHttpClient), which writes the response to a file URL without holding it all in memory.

Delete

let result = try await mero.admin.deleteBlob(blobId)   // result.deleted