@darseen/vaze 2.1.0 → 2.2.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,6 +223,12 @@ 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);
   }
@@ -242,6 +252,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 +278,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",

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;
@@ -798,6 +804,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 +822,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;
     }>>;
@@ -853,6 +870,13 @@ type SignedUrl = {
     url: string;
     expiresAt: string;
 };
+type BulkDeleteResult = {
+    deleted: string[];
+    failed: {
+        id: string;
+        message: string;
+    }[];
+};
 
 declare class Base {
     private apiKey;
@@ -860,7 +884,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 +900,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 FileWithUrl as File, type Folder, type ListOptions, 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;
@@ -798,6 +804,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 +822,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;
     }>>;
@@ -853,6 +870,13 @@ type SignedUrl = {
     url: string;
     expiresAt: string;
 };
+type BulkDeleteResult = {
+    deleted: string[];
+    failed: {
+        id: string;
+        message: string;
+    }[];
+};
 
 declare class Base {
     private apiKey;
@@ -860,7 +884,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 +900,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 FileWithUrl as File, type Folder, type ListOptions, 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,6 +223,12 @@ 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);
   }
@@ -242,6 +252,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 +278,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darseen/vaze",
-  "version": "2.1.0",
+  "version": "2.2.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",