chore: update sdk docs (#312)

Author: designcode

docs/sdks/tigris/client-uploads.mdx

@@ -25,7 +25,7 @@ import { upload } from "@tigrisdata/storage/client";
 
 `upload` accepts the following parameters:
 
-- `path`: (Required) A string specifying the path to the object
+- `name`: (Required) A string specifying the name of the object
 - `body`: (Required) A blob object as File or Blob
 - `options`: (Optional) A JSON object with the following optional parameters:
 
@@ -49,7 +49,7 @@ contains the following properties:
 - `contentDisposition`: content disposition of the object
 - `contentType`: content type of the object
 - `modified`: Last modified date of the object
-- `path`: Path to the object
+- `name`: Name of the object
 - `size`: Size of the object
 - `url`: A presigned URL to the object
 

docs/sdks/tigris/examples.mdx

@@ -152,60 +152,24 @@ We leverage the
 [presigned URLs](/docs/sdks/tigris/using-sdk#presigning-an-object) features to
 allow you to upload files directly to Tigris from the client side.
 
-### Multipart upload
-
 <Tabs>  
 <TabItem value="server" label="Server" default>
 
 ```ts
 // app/api/upload/route.ts
 import { NextRequest, NextResponse } from "next/server";
-import {
-  initMultipartUpload,
-  getPartsPresignedUrls,
-  completeMultipartUpload,
-  UploadAction,
-} from "@tigrisdata/storage";
+import { handleClientUpload } from "@tigrisdata/storage";
 
 export async function POST(request: NextRequest) {
   try {
-    const { path, operation, action, contentType, uploadId, parts, partIds } =
-      await request.json();
-
-    switch (action) {
-      case UploadAction.MultipartInit: {
-        const result = await initMultipartUpload(path, {});
-        return NextResponse.json({ data: result.data });
-      }
-
-      case UploadAction.MultipartGetParts: {
-        if (!uploadId || !parts) {
-          return NextResponse.json(
-            { error: "uploadId and parts are required for multipart-parts" },
-            { status: 400 },
-          );
-        }
-        const result = await getPartsPresignedUrls(path, parts, uploadId, {});
-        return NextResponse.json({ data: result.data });
-      }
-
-      case UploadAction.MultipartComplete:
-        {
-          if (!uploadId) {
-            return NextResponse.json(
-              { error: "uploadId is required for multipart-complete" },
-              { status: 400 },
-            );
-          }
-          const result = await completeMultipartUpload(path, uploadId, partIds);
-          return NextResponse.json({ data: result.data });
-        }
-
-        return NextResponse.json(
-          { error: `Unsupported action: ${action}` },
-          { status: 400 },
-        );
+    const body = await request.json();
+    const { data, error } = await handleClientUpload(body);
+
+    if (error) {
+      return NextResponse.json({ error: error.message }, { status: 500 });
     }
+
+    return NextResponse.json({ data });
   } catch (error) {
     return NextResponse.json(
       { error: "Failed to process upload request" },
@@ -261,77 +225,3 @@ export default function ClientUpload() {
 </TabItem>
 
 </Tabs>
-
-### Simple upload
-
-<Tabs>  
-<TabItem value="server" label="Server" default>
-
-```ts
-// app/api/upload/route.ts
-import { NextRequest, NextResponse } from "next/server";
-import { getPresignedUrl } from "@tigrisdata/storage";
-
-export async function POST(request: NextRequest) {
-  try {
-    const { path, contentType } = await request.json();
-    const result = await getPresignedUrl(path, {
-      operation: "put",
-      expiresIn: 3600, // 1 hour
-    });
-
-    return NextResponse.json({ data: result.data });
-  } catch (error) {
-    console.error("Upload error:", error);
-    return NextResponse.json(
-      { error: "Failed to generate presigned URL" },
-      { status: 500 },
-    );
-  }
-}
-```
-
-</TabItem>
-
-<TabItem value="client" label="Client">
-
-```tsx
-"use client";
-
-import { upload } from "@tigrisdata/storage/client";
-import { useState } from "react";
-
-export default function ClientUpload() {
-  const [progress, setProgress] = useState<number>(0);
-  const [url, setUrl] = useState<string | null>(null);
-  const handleFileChange = async (e: React.ChangeEvent<HTMLInputElement>) => {
-    const file = e.target.files?.[0];
-    setProgress(0);
-    if (file) {
-      const result = await upload(`${file.name}`, file, {
-        url: "/api/upload",
-        access: "private",
-        onUploadProgress: ({ loaded, total, percentage }) => {
-          setProgress(percentage);
-          if (percentage === 100) {
-            setProgress(0);
-          }
-        },
-      });
-      setUrl(result.url);
-    }
-  };
-
-  return (
-    <>
-      <input type="file" onChange={handleFileChange} />{" "}
-      {url && <div>Uploaded to: {url}</div>}{" "}
-      {progress > 0 && progress < 100 && <div>{progress}%</div>}{" "}
-    </>
-  );
-}
-```
-
-</TabItem>
-
-</Tabs>

docs/sdks/tigris/using-sdk.mdx

@@ -415,6 +415,8 @@ list(options?: ListOptions): Promise<TigrisStorageResponse<ListResponse, Error>>
 
 | **Parameter**                             | **Required** | **Values**                                                                      |
 | ----------------------------------------- | ------------ | ------------------------------------------------------------------------------- |
+| delimiter                                 | No           | A delimiter is a character that you use to group keys.                          |
+| prefix                                    | No           | Limits the items to keys that begin with the specified prefix.                  |
 | limit                                     | No           | The maximum number of objects to return. By default, returns up to 100 objects. |
 | paginationToken                           | No           | The pagination token to continue listing objects from the previous request.     |
 | config                                    | No           | A configuration object to override the                                          |