Storage

// From File or Blob
const file = new File(["content"], "file.txt", { type: "text/plain" });
const { id, url } = await cloud.storage.upload(file);

// From ArrayBuffer
const buffer = new TextEncoder().encode("Hello!").buffer;
const { id, url } = await cloud.storage.upload(buffer);

// From base64 string (auto-detects MIME type)
const base64 = "data:image/png;base64,iVBORw0KGgo...";
const { id, url } = await cloud.storage.upload(base64);

// With metadata
const { id, url } = await cloud.storage.upload(file, {
  userId: "123",
  category: "avatars",
  isPublic: true
});

interface UploadResponse {
  id: string; // Unique identifier for the uploaded file
  url: string; // Public CDN URL to access the file
}

const stream = getReadableStream(); // Your ReadableStream
const { id, url } = await cloud.storage.uploadStream(
  stream,
  "video/mp4", // Content type
  fileSize // Content length in bytes
);

const signedUrl = await cloud.storage.generateSignedUrl(
  "image/png", // Content type
  1024, // File size in bytes
  { userId: "123" } // Optional metadata
);

interface SignedUrlResponse {
  url: string; // The signed URL for uploading
  expiresAt: string; // Expiration time (ISO 8601)
  mediaId: string; // The ID the file will have after upload
  mediaUrl: string; // The public URL after upload
}

const { url, mediaId, mediaUrl } = await cloud.storage.generateSignedUrl(
  "image/png",
  fileSize
);

// Upload directly to the signed URL
await fetch(url, {
  method: "PUT",
  headers: { "Content-Length": fileSize.toString() },
  body: fileData
});

// File is now available at mediaUrl
console.log(`Uploaded: ${mediaUrl}`);

// Delete a single file
await cloud.storage.delete(mediaId);

// Delete multiple files (batched automatically, max 100 per batch)
await cloud.storage.delete([mediaId1, mediaId2, mediaId3]);

type FileMetadata = Record<string, string | number | boolean>;

// Example
const { id, url } = await cloud.storage.upload(file, {
  userId: "user_123",
  uploadedAt: Date.now(),
  isAvatar: true
});