create objects manager delete method

Author: joaotonaco

.changeset/loud-singers-listen.md

@@ -0,0 +1,5 @@
+---
+"@squarecloud/blob": minor
+---
+
+Add `BlobObjectsManager#delete` method for deleting blobs

src/managers/objects.ts

@@ -8,6 +8,16 @@ import type { PutObjectResponse, PutObjectType } from "../types/put";
 export class BlobObjectsManager {
 	constructor(private readonly client: SquareCloudBlob) {}
 
+	/**
+	 * Uploads an object to the storage.
+	 *
+	 * @param object - An object to upload
+	 *
+	 * @example
+	 * ```js
+	 * await blob.objects.put({ file: "path/to/file.jpeg", name: "my_image" });
+	 * ```
+	 */
 	async put(object: PutObjectType) {
 		const payload = putObjectPayloadSchema.parse(object);
 		const file = await this.parseFile(payload.file);
@@ -23,6 +33,27 @@ export class BlobObjectsManager {
 		return assertPutObjectResponse(response);
 	}
 
+	/**
+	 * Deletes multiple objects.
+	 *
+	 * @param objects - An array of object IDs
+	 *
+	 * @example
+	 * ```js
+	 * await blob.objects.delete("ID/prefix/name1_xxx-xxx.zip", "ID/prefix/name_xxx-xxx-xxx.png");
+	 * ```
+	 */
+	async delete(...objects: string[] | string[][]) {
+		const ids = objects.flat();
+
+		const response = await this.client.api.request("delete", {
+			method: "DELETE",
+			body: { objects: ids },
+		});
+
+		return response.status === "success";
+	}
+
 	private async parseFile(file: string | Buffer) {
 		let result: Buffer | undefined;