feat: add deleteBucket method

mod.ts

@@ -7,6 +7,7 @@ export type {
   CopyObjectResponse,
   CreateBucketConfiguration,
   CreateBucketOptions,
+  DeleteBucketOptions,
   DeleteObjectOptions,
   DeleteObjectResponse,
   GetObjectOptions,

src/client.ts

@@ -1,5 +1,5 @@
 import { AWSSignerV4 } from "../deps.ts";
-import type { CreateBucketOptions } from "./types.ts";
+import type { CreateBucketOptions, DeleteBucketOptions } from "./types.ts";
 import { S3Error } from "./error.ts";
 import { S3Bucket } from "./bucket.ts";
 import { doRequest, encoder } from "./request.ts";
@@ -121,4 +121,39 @@ export class S3 {
 
     return this.getBucket(bucket);
   }
+
+  /**
+   * Deletes the S3 bucket. All objects (including all object versions and
+   * delete markers) in the bucket must be deleted before the bucket itself can
+   * be deleted.
+   *
+   * ```
+   * await s3.deleteBucket("my-bucket");
+   * ```
+   */
+  async deleteBucket(
+    bucket: string,
+    options?: DeleteBucketOptions,
+  ): Promise<void> {
+    const headers: Params = {};
+
+    if (options?.expectedBucketOwner) {
+      headers["x-amz-expected-bucket-owner"] = options.expectedBucketOwner;
+    }
+
+    const resp = await doRequest({
+      host: this.#host,
+      signer: this.#signer,
+      path: bucket,
+      method: "DELETE",
+      headers,
+    });
+
+    if (resp.status !== 204) {
+      throw new S3Error(
+        `Failed to delete bucket "${bucket}": ${resp.status} ${resp.statusText}`,
+        await resp.text(),
+      );
+    }
+  }
 }

src/client_test.ts

@@ -47,6 +47,19 @@ Deno.test({
 
     // teardown
     await bucket.deleteObject("test");
-    // @TODO: delete also bucket once s3.deleteBucket is implemented.
+    await s3.deleteBucket("create-bucket-test");
+  },
+});
+
+Deno.test({
+  name: "[client] should delete a bucket",
+  async fn() {
+    await s3.createBucket("create-bucket-test");
+    await s3.deleteBucket("create-bucket-test");
+    await assertThrowsAsync(
+      () => s3.deleteBucket("create-bucket-test"),
+      S3Error,
+      'Failed to delete bucket "create-bucket-test": 404 Not Found',
+    );
   },
 });

src/types.ts

@@ -597,10 +597,20 @@ export interface CreateBucketOptions extends CreateBucketConfiguration {
 
   /**
    * Allows grantee to create new objects in the bucket.
-   * For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects.
+   * For the bucket and object owners of existing objects, also allows deletions
+   * and overwrites of those objects.
    */
   grantWrite?: string;
 
   /** Allows grantee to write the ACL for the applicable bucket. */
   grantWriteAcp?: string;
 }
+
+export interface DeleteBucketOptions {
+  /**
+   * The account ID of the expected bucket owner. If the bucket is owned by a
+   * different account, the request will fail with an HTTP 403 (Access Denied)
+   * error.
+   */
+  expectedBucketOwner?: string;
+}