@darseen/vaze 2.1.0 → 2.3.0

package/README.md

@@ -109,6 +109,17 @@ if (data) {
 }
 ```
 
+`downloadMany(ids)` Download several files as one zip. Entries keep their paths below the folder the files share.
+
+```ts
+const { data, error } = await vaze.files.downloadMany(["file-id-123", "file-id-456"]);
+
+if (data) {
+  console.log(data.filename); // e.g. "photos.zip"
+  const buffer = Buffer.from(await data.blob.arrayBuffer());
+}
+```
+
 `rename(data)` Rename an existing file.
 
 - data:
@@ -171,6 +182,17 @@ const { data, error } = await vaze.folders.rename({
 });
 ```
 
+`download(options?)` Download a folder and everything below it as one zip. With no `id` or `key`, the root folder is archived.
+
+```ts
+const { data, error } = await vaze.folders.download({ key: "projects/work" });
+
+if (data) {
+  console.log(data.filename); // "work.zip", with every entry under work/
+  const buffer = Buffer.from(await data.blob.arrayBuffer());
+}
+```
+
 `delete(id)` Delete a folder by its ID.
 
 ```ts

package/dist/index.cjs

@@ -92,10 +92,14 @@ var Base = class {
       };
     }
   }
-  async requestBlob(url) {
+  async requestBlob(url, method = "GET", body) {
     try {
+      const headers = { "API-Key": this.apiKey };
+      if (body !== void 0) headers["Content-Type"] = "application/json";
       const response = await fetch(url, {
-        headers: { "API-Key": this.apiKey }
+        method,
+        headers,
+        body: body !== void 0 ? JSON.stringify(body) : null
       });
       const contentType = _nullishCoalesce(response.headers.get("content-type"), () => ( ""));
       if (!response.ok) {
@@ -219,12 +223,49 @@ var Files = class extends Base {
     const url = this.apiUrl(`/api/files/download/${encodeURIComponent(id)}`);
     return await this.requestBlob(url);
   }
+  /** Download several files as one zip, with paths below their shared folder. */
+  async downloadMany(ids) {
+    return await this.requestBlob(this.apiUrl("/api/files/download"), "POST", {
+      ids
+    });
+  }
   async rename(data) {
     return await this.request("PUT", this.apiUrl("/api/files"), data);
   }
   async setVisibility(data) {
     return await this.request("PUT", this.apiUrl("/api/files"), data);
   }
+  /** Move a file into another folder; its key and URL change with it. */
+  async move(data) {
+    const { data: responseData, error } = await this.request("POST", this.apiUrl("/api/files/move"), data);
+    return {
+      error,
+      data: responseData ? {
+        file: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: [responseData.file]
+        })[0]
+      } : null
+    };
+  }
+  /** Move several files into one folder; each id reports its own outcome. */
+  async moveMany(ids, destination) {
+    const { data, error } = await this.request(
+      "POST",
+      this.apiUrl("/api/files/move"),
+      { ids, ...destination }
+    );
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        }),
+        failed: data.failed
+      } : null
+    };
+  }
   /** Mint a time-limited URL that reads a file without an API key. */
   async sign(options) {
     const { data, error } = await this.request(
@@ -242,6 +283,14 @@ var Files = class extends Base {
       id
     });
   }
+  /** Delete several files in one request; each id reports its own outcome. */
+  async deleteMany(ids) {
+    return await this.request(
+      "DELETE",
+      this.apiUrl("/api/files"),
+      { ids }
+    );
+  }
 };
 
 // src/folders.ts
@@ -260,6 +309,12 @@ var Folders = class extends Base {
       } : null
     };
   }
+  /** Download a folder and everything below it as a zip; the root by default. */
+  async download(options) {
+    return await this.requestBlob(
+      this.apiUrl("/api/folders/download", options)
+    );
+  }
   async create(folder) {
     return await this.request(
       "POST",
@@ -270,6 +325,14 @@ var Folders = class extends Base {
   async rename(data) {
     return await this.request("PUT", this.apiUrl("/api/folders"), data);
   }
+  /** Move a folder, and everything inside it, into another folder. */
+  async move(data) {
+    return await this.request(
+      "POST",
+      this.apiUrl("/api/folders/move"),
+      data
+    );
+  }
   /** Apply a visibility to every file at or below this folder. */
   async setVisibility(data) {
     return await this.request("PUT", this.apiUrl("/api/folders"), data);

package/dist/index.d.cts

@@ -779,6 +779,12 @@ declare class Files extends Base {
         filename: string | null;
         contentType: string;
     }>>;
+    /** Download several files as one zip, with paths below their shared folder. */
+    downloadMany(ids: string[]): Promise<ApiResponse<{
+        blob: Blob;
+        filename: string | null;
+        contentType: string;
+    }>>;
     rename(data: {
         id: string;
         name: string;
@@ -787,6 +793,30 @@ declare class Files extends Base {
         id: string;
         visibility: Visibility;
     }): Promise<ApiResponse<null>>;
+    /** Move a file into another folder; its key and URL change with it. */
+    move(data: {
+        id: string;
+    } & MoveDestination): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            file: any;
+        } | null;
+    }>;
+    /** Move several files into one folder; each id reports its own outcome. */
+    moveMany(ids: string[], destination: MoveDestination): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: any[];
+            failed: {
+                id: string;
+                message: string;
+            }[];
+        } | null;
+    }>;
     /** Mint a time-limited URL that reads a file without an API key. */
     sign(options: SignOptions): Promise<{
         error: {
@@ -798,6 +828,8 @@ declare class Files extends Base {
         } | null;
     }>;
     delete(id: string): Promise<ApiResponse<null>>;
+    /** Delete several files in one request; each id reports its own outcome. */
+    deleteMany(ids: string[]): Promise<ApiResponse<BulkDeleteResult>>;
 }
 
 declare class Folders extends Base {
@@ -814,6 +846,15 @@ declare class Folders extends Base {
             folders: Folder[];
         } | null;
     }>;
+    /** Download a folder and everything below it as a zip; the root by default. */
+    download(options?: {
+        id?: string;
+        key?: string;
+    }): Promise<ApiResponse<{
+        blob: Blob;
+        filename: string | null;
+        contentType: string;
+    }>>;
     create(folder: string): Promise<ApiResponse<{
         folder: Folder;
     }>>;
@@ -821,6 +862,12 @@ declare class Folders extends Base {
         id: string;
         name: string;
     }): Promise<ApiResponse<null>>;
+    /** Move a folder, and everything inside it, into another folder. */
+    move(data: {
+        id: string;
+    } & MoveDestination): Promise<ApiResponse<{
+        folder: Folder;
+    }>>;
     /** Apply a visibility to every file at or below this folder. */
     setVisibility(data: {
         id: string;
@@ -853,6 +900,26 @@ type SignedUrl = {
     url: string;
     expiresAt: string;
 };
+type MoveDestination = {
+    /** The destination folder's id. Either this or `folder` is required. */
+    folderId?: string;
+    /** The destination folder's key, created if missing; `""` is the root. */
+    folder?: string;
+};
+type BulkMoveResult = {
+    files: FileWithUrl[];
+    failed: {
+        id: string;
+        message: string;
+    }[];
+};
+type BulkDeleteResult = {
+    deleted: string[];
+    failed: {
+        id: string;
+        message: string;
+    }[];
+};
 
 declare class Base {
     private apiKey;
@@ -860,7 +927,7 @@ declare class Base {
     constructor(options?: VazeOptions);
     protected apiUrl(path: string, params?: Record<string, string | number | undefined>): string;
     protected request<T>(method: string, url: string, body?: Record<string, any> | FormData, headers?: Record<string, string>): Promise<ApiResponse<T>>;
-    protected requestBlob(url: string): Promise<ApiResponse<{
+    protected requestBlob(url: string, method?: string, body?: Record<string, any>): Promise<ApiResponse<{
         blob: Blob;
         filename: string | null;
         contentType: string;
@@ -876,4 +943,4 @@ declare class Vaze extends Base implements IVaze {
     }>>;
 }
 
-export { type ApiResponse, type FileWithUrl as File, type Folder, type ListOptions, type SignOptions, type SignedUrl, type VazeOptions, type Visibility, Vaze as default };
+export { type ApiResponse, type BulkDeleteResult, type BulkMoveResult, type FileWithUrl as File, type Folder, type ListOptions, type MoveDestination, type SignOptions, type SignedUrl, type VazeOptions, type Visibility, Vaze as default };

package/dist/index.d.ts

@@ -779,6 +779,12 @@ declare class Files extends Base {
         filename: string | null;
         contentType: string;
     }>>;
+    /** Download several files as one zip, with paths below their shared folder. */
+    downloadMany(ids: string[]): Promise<ApiResponse<{
+        blob: Blob;
+        filename: string | null;
+        contentType: string;
+    }>>;
     rename(data: {
         id: string;
         name: string;
@@ -787,6 +793,30 @@ declare class Files extends Base {
         id: string;
         visibility: Visibility;
     }): Promise<ApiResponse<null>>;
+    /** Move a file into another folder; its key and URL change with it. */
+    move(data: {
+        id: string;
+    } & MoveDestination): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            file: any;
+        } | null;
+    }>;
+    /** Move several files into one folder; each id reports its own outcome. */
+    moveMany(ids: string[], destination: MoveDestination): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: any[];
+            failed: {
+                id: string;
+                message: string;
+            }[];
+        } | null;
+    }>;
     /** Mint a time-limited URL that reads a file without an API key. */
     sign(options: SignOptions): Promise<{
         error: {
@@ -798,6 +828,8 @@ declare class Files extends Base {
         } | null;
     }>;
     delete(id: string): Promise<ApiResponse<null>>;
+    /** Delete several files in one request; each id reports its own outcome. */
+    deleteMany(ids: string[]): Promise<ApiResponse<BulkDeleteResult>>;
 }
 
 declare class Folders extends Base {
@@ -814,6 +846,15 @@ declare class Folders extends Base {
             folders: Folder[];
         } | null;
     }>;
+    /** Download a folder and everything below it as a zip; the root by default. */
+    download(options?: {
+        id?: string;
+        key?: string;
+    }): Promise<ApiResponse<{
+        blob: Blob;
+        filename: string | null;
+        contentType: string;
+    }>>;
     create(folder: string): Promise<ApiResponse<{
         folder: Folder;
     }>>;
@@ -821,6 +862,12 @@ declare class Folders extends Base {
         id: string;
         name: string;
     }): Promise<ApiResponse<null>>;
+    /** Move a folder, and everything inside it, into another folder. */
+    move(data: {
+        id: string;
+    } & MoveDestination): Promise<ApiResponse<{
+        folder: Folder;
+    }>>;
     /** Apply a visibility to every file at or below this folder. */
     setVisibility(data: {
         id: string;
@@ -853,6 +900,26 @@ type SignedUrl = {
     url: string;
     expiresAt: string;
 };
+type MoveDestination = {
+    /** The destination folder's id. Either this or `folder` is required. */
+    folderId?: string;
+    /** The destination folder's key, created if missing; `""` is the root. */
+    folder?: string;
+};
+type BulkMoveResult = {
+    files: FileWithUrl[];
+    failed: {
+        id: string;
+        message: string;
+    }[];
+};
+type BulkDeleteResult = {
+    deleted: string[];
+    failed: {
+        id: string;
+        message: string;
+    }[];
+};
 
 declare class Base {
     private apiKey;
@@ -860,7 +927,7 @@ declare class Base {
     constructor(options?: VazeOptions);
     protected apiUrl(path: string, params?: Record<string, string | number | undefined>): string;
     protected request<T>(method: string, url: string, body?: Record<string, any> | FormData, headers?: Record<string, string>): Promise<ApiResponse<T>>;
-    protected requestBlob(url: string): Promise<ApiResponse<{
+    protected requestBlob(url: string, method?: string, body?: Record<string, any>): Promise<ApiResponse<{
         blob: Blob;
         filename: string | null;
         contentType: string;
@@ -876,4 +943,4 @@ declare class Vaze extends Base implements IVaze {
     }>>;
 }
 
-export { type ApiResponse, type FileWithUrl as File, type Folder, type ListOptions, type SignOptions, type SignedUrl, type VazeOptions, type Visibility, Vaze as default };
+export { type ApiResponse, type BulkDeleteResult, type BulkMoveResult, type FileWithUrl as File, type Folder, type ListOptions, type MoveDestination, type SignOptions, type SignedUrl, type VazeOptions, type Visibility, Vaze as default };

package/dist/index.js

@@ -92,10 +92,14 @@ var Base = class {
       };
     }
   }
-  async requestBlob(url) {
+  async requestBlob(url, method = "GET", body) {
     try {
+      const headers = { "API-Key": this.apiKey };
+      if (body !== void 0) headers["Content-Type"] = "application/json";
       const response = await fetch(url, {
-        headers: { "API-Key": this.apiKey }
+        method,
+        headers,
+        body: body !== void 0 ? JSON.stringify(body) : null
       });
       const contentType = response.headers.get("content-type") ?? "";
       if (!response.ok) {
@@ -219,12 +223,49 @@ var Files = class extends Base {
     const url = this.apiUrl(`/api/files/download/${encodeURIComponent(id)}`);
     return await this.requestBlob(url);
   }
+  /** Download several files as one zip, with paths below their shared folder. */
+  async downloadMany(ids) {
+    return await this.requestBlob(this.apiUrl("/api/files/download"), "POST", {
+      ids
+    });
+  }
   async rename(data) {
     return await this.request("PUT", this.apiUrl("/api/files"), data);
   }
   async setVisibility(data) {
     return await this.request("PUT", this.apiUrl("/api/files"), data);
   }
+  /** Move a file into another folder; its key and URL change with it. */
+  async move(data) {
+    const { data: responseData, error } = await this.request("POST", this.apiUrl("/api/files/move"), data);
+    return {
+      error,
+      data: responseData ? {
+        file: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: [responseData.file]
+        })[0]
+      } : null
+    };
+  }
+  /** Move several files into one folder; each id reports its own outcome. */
+  async moveMany(ids, destination) {
+    const { data, error } = await this.request(
+      "POST",
+      this.apiUrl("/api/files/move"),
+      { ids, ...destination }
+    );
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        }),
+        failed: data.failed
+      } : null
+    };
+  }
   /** Mint a time-limited URL that reads a file without an API key. */
   async sign(options) {
     const { data, error } = await this.request(
@@ -242,6 +283,14 @@ var Files = class extends Base {
       id
     });
   }
+  /** Delete several files in one request; each id reports its own outcome. */
+  async deleteMany(ids) {
+    return await this.request(
+      "DELETE",
+      this.apiUrl("/api/files"),
+      { ids }
+    );
+  }
 };
 
 // src/folders.ts
@@ -260,6 +309,12 @@ var Folders = class extends Base {
       } : null
     };
   }
+  /** Download a folder and everything below it as a zip; the root by default. */
+  async download(options) {
+    return await this.requestBlob(
+      this.apiUrl("/api/folders/download", options)
+    );
+  }
   async create(folder) {
     return await this.request(
       "POST",
@@ -270,6 +325,14 @@ var Folders = class extends Base {
   async rename(data) {
     return await this.request("PUT", this.apiUrl("/api/folders"), data);
   }
+  /** Move a folder, and everything inside it, into another folder. */
+  async move(data) {
+    return await this.request(
+      "POST",
+      this.apiUrl("/api/folders/move"),
+      data
+    );
+  }
   /** Apply a visibility to every file at or below this folder. */
   async setVisibility(data) {
     return await this.request("PUT", this.apiUrl("/api/folders"), data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darseen/vaze",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Vaze Self-Hosted file storage and hosting service SDK.",
   "keywords": [
     "api",
@@ -42,10 +42,10 @@
     "dist"
   ],
   "devDependencies": {
-    "@types/node": "^25.5.0",
+    "@repo/types": "1.0.0",
+    "@types/node": "^26.6.2",
     "rimraf": "^6.1.3",
-    "tsup": "^8.5.1",
-    "@repo/types": "1.0.0"
+    "tsup": "^8.5.1"
   },
   "scripts": {
     "lint": "tsc --noEmit",