Querying files

StorageManager includes helpers for common read and delete operations on objects already in your bucket.

Check if a file exists

const exists = await manager.exists("uploads/photo.jpg");

Result	Meaning
`true`	Object exists
`false`	Object not found

exists returns false only for not found. Permission errors, network failures, and other problems throw — handle them with try/catch.

Get metadata

const meta = await manager.getMetadata("uploads/photo.jpg");
console.log(meta.size, meta.contentType, meta.customMetadata);

Throws if the object does not exist.

Get a download URL

const url = await manager.getDownloadURL("uploads/photo.jpg");

Returns a public or tokenized URL depending on your bucket rules and object ACLs.

Delete a file

await manager.delete("uploads/old.jpg");

List files and folders

List everything at one level with listAll:

const result = await manager.listAll("images/");

result.prefixes.forEach((folderPath) => {
  console.log("Folder:", folderPath);
});

result.items.forEach((item) => {
  console.log("File:", item.name);
});

For large directories, use paginated list:

let pageToken: string | undefined;

do {
  const page = await manager.list("images/", { maxResults: 100, pageToken });
  // ... use page.prefixes and page.items
  pageToken = page.nextPageToken;
} while (pageToken);

prefixes are folder paths at that level. Each item in items has name (file name) and path (full object path).

Full example

const path = "uploads/photo.jpg";

if (await manager.exists(path)) {
  const meta = await manager.getMetadata(path);
  const url = await manager.getDownloadURL(path);
  console.log(meta.size, url);
}

await manager.delete("uploads/old.jpg");

Content type

Set MIME type on upload for previews and downloads.

Custom metadata

Writing and reading customMetadata.

StorageManager API

Method signatures and return types.