Interface: StorageActionWriter

// In an action, download and re-upload a file:
const blob = await ctx.storage.get(storageId);
if (blob) {
  const newStorageId = await ctx.storage.store(blob);
}

const url = await ctx.storage.getUrl(storageId);

const metadata = await ctx.db.system.get("_storage", storageId);
// { _id, _creationTime, sha256, size, contentType? }

// In a mutation, generate the upload URL:
export const generateUploadUrl = mutation({
  args: {},
  returns: v.string(),
  handler: async (ctx) => {
    return await ctx.storage.generateUploadUrl();
  },
});

// On the client, upload the file:
// const uploadUrl = await generateUploadUrl();
// const result = await fetch(uploadUrl, { method: "POST", body: file });
// const { storageId } = await result.json();

await ctx.storage.delete(storageId);

const storageId = await ctx.storage.store(blob);
// Save storageId to the database via ctx.runMutation