feat(sdk): add docs for listBuckets, removeBucket and support of snapshots in get, head and list (#290)

* feat(sdk): add docs for list and remove bucket

* Update docs/sdks/tigris/using-sdk.mdx

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

* feat(sdk): docs for snapshotVersion support in get, head and list

* chore: typo

* chore: pr comments

* Apply suggestion from @MantasMiksys

* chore: linting

---------

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Co-authored-by: Mantas Miksys <[email protected]>

Author: 3 people

docs/sdks/tigris/snapshots-and-forks.mdx

@@ -49,7 +49,7 @@ await createBucketSnapshot("llm-base", {
 });
 ```
 
-### List snapshots for the bucket
+### List snapshots of a bucket
 
 A list of snapshots for the bucket can be retrieved using the
 `listBucketSnapshots` function.
@@ -64,11 +64,23 @@ if (result.error) {
 } else {
   console.log("Snapshots:");
   result.data.forEach((snapshot) => {
-    console.log(`- ${snapshot.snapshotName}: ${snapshot.creationDate}`);
+    console.log(`- ${snapshot.version}: ${snapshot.creationDate}`);
   });
 }
 ```
 
+### List objects in a snapshot
+
+Objects in a snapshot can be listed using the `list` function.
+
+```ts
+import { list } from "@tigrisdata/storage";
+
+const result = await list("llm-base", {
+  snapshotVersion: "1760550614083112540",
+});
+```
+
 ## Forks
 
 Fork is a new bucket created from an existing one, sharing data without
@@ -103,11 +115,11 @@ import { createBucket } from "@tigrisdata/storage";
 
 const forkName = "llm-fork";
 const sourceBucketName = "llm-base";
-const sourceBucketSnapshotName = "fine-tuned-model";
+const sourceBucketSnapshot = "1760550614083112540";
 
 const fromSnapshot = await createBucket(forkName, {
   sourceBucketName: sourceBucketName,
-  sourceBucketSnapshot: sourceBucketSnapshotName,
+  sourceBucketSnapshot: sourceBucketSnapshot,
 });
 
 if (fromSnapshot.error) {
@@ -133,3 +145,26 @@ await createBucketSnapshot({
 
 await listBucketSnapshots();
 ```
+
+## Getting an object from a snapshot
+
+An object from a snapshot can be retrieved using the `get` function.
+
+```ts
+import { get } from "@tigrisdata/storage";
+
+const result = await get("object.txt", {
+  snapshotVersion: "1760550614083112540",
+});
+```
+
+Similarly, `head` function can be used to get the metadata of an object from a
+specific snapshot.
+
+```ts
+import { head } from "@tigrisdata/storage";
+
+const result = await head("object.txt", {
+  snapshotVersion: "1760550614083112540",
+});
+```

docs/sdks/tigris/using-sdk.mdx

@@ -468,3 +468,87 @@ if (currentPage.data) {
 
 console.log(allFiles);
 ```
+
+## Listing buckets
+
+`listBuckets` function can be used to list all buckets that the user has access
+to.
+
+### `listBuckets`
+
+```ts
+listBuckets(options?: ListBucketsOptions): Promise<TigrisStorageResponse<ListBucketsResponse, Error>>;
+```
+
+`listBuckets` accepts the following parameters
+
+- `options`: (Optional) A JSON object with the following optional parameters:
+
+#### `options`
+
+| **Parameter**   | **Required** | **Values**                                                                       |
+| --------------- | ------------ | -------------------------------------------------------------------------------- |
+| limit           | No           | The maximum number of buckets to return.                                         |
+| paginationToken | No           | The pagination token to continue listing buckets from the previous request.      |
+| config          | No           | A configuration object to override the [default configuration](#authentication). |
+
+In case of successful `listBuckets`, the `data` property will be set to the list
+of buckets and will contain the following properties:
+
+- `buckets`: The list of buckets
+- `owner`: The owner of the buckets
+- `paginationToken`: The pagination token to continue listing buckets for the
+  next page.
+
+### Examples
+
+#### Listing buckets
+
+```ts
+const result = await listBuckets();
+
+if (result.error) {
+  console.error("Error listing buckets:", result.error);
+} else {
+  console.log("Buckets:", result.data);
+}
+```
+
+## Deleting a bucket
+
+`removeBucket` function can be used to delete a bucket.
+
+### `removeBucket`
+
+```ts
+removeBucket(bucketName: string, options?: RemoveBucketOptions): Promise<TigrisStorageResponse<void, Error>>;
+```
+
+`removeBucket` accepts the following parameters:
+
+- `bucketName`: (Required) A string specifying the name of the bucket
+- `options`: (Optional) A JSON object with the following optional parameters:
+
+#### `options`
+
+| **Parameter** | **Required** | **Values**                                                                       |
+| ------------- | ------------ | -------------------------------------------------------------------------------- |
+| force         | No           | When provided, forcefully delete the bucket.                                     |
+| config        | No           | A configuration object to override the [default configuration](#authentication). |
+
+In case of successful `removeBucket`, the `data` property will be set to
+`undefined` and the bucket will be deleted.
+
+### Examples
+
+#### Deleting a bucket
+
+```ts
+const result = await removeBucket("my-bucket");
+
+if (result.error) {
+  console.error("Error deleting bucket:", result.error);
+} else {
+  console.log("Bucket deleted successfully");
+}
+```