@darseen/vaze 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,170 @@
+# Vaze SDK
+
+<div align="center">
+
+<img src="../../.github/images/vaze.png" alt="logo" width="200"/>
+
+![NPM Downloads](https://img.shields.io/npm/dm/@darseen/vaze?style=for-the-badge)
+![NPM Version](https://img.shields.io/npm/v/@darseen/vaze?style=for-the-badge)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+
+**@darseen/vaze** The official JavaScript/TypeScript SDK for Vaze, a self-hosted, local-first file storage and hosting service. This SDK provides a simple and type-safe way to interact with your Vaze instance's API from your Node.js backend or frontend applications.
+
+## </div>
+
+# Installation
+
+Install the package using your preferred package manager:
+
+```
+npm install @darseen/vaze
+# or
+yarn add @darseen/vaze
+# or
+pnpm add @darseen/vaze
+```
+
+# Initialization
+
+To use the SDK, you must instantiate the `Vaze` client. You can provide your configuration either directly through the constructor options or via environment variables. Using Constructor Options
+
+```ts
+import Vaze from "@darseen/vaze";
+
+const vaze = new Vaze({
+  vazeUrl: "http://your-server-ip:3000",
+  apiKey: "YOUR_API_KEY",
+});
+```
+
+# Using Environment Variables
+
+If you set `VAZE_URL` and `VAZE_API_KEY` in your environment, you can initialize the client without passing arguments:
+
+```ts
+import Vaze from "@darseen/vaze";
+
+// Automatically picks up process.env.VAZE_URL and process.env.VAZE_API_KEY
+const vaze = new Vaze();
+```
+
+# API Documentation
+
+The SDK is divided into two main modules: `files` and `folders`. All methods are asynchronous and return a standard `ApiResponse` object containing either `data` or an `error`. Files API Access file-related methods via `vaze.files.getAll(options?)` Retrieve a paginated list of all files.
+
+- options (optional):
+  - `limit`
+  - `offset`
+  - `orderBy`
+  - `orderDirection`
+
+```ts
+const { data, error } = await vaze.files.getAll({
+  limit: 10,
+  orderBy: "created_at",
+  orderDirection: "DESC",
+});
+
+if (data) {
+  console.log(data.files);
+}
+```
+
+`getById(id)` Retrieve a specific file by its ID.
+
+```ts
+const { data, error } = await vaze.files.getById("file-id");
+```
+
+`getByName(name, options?)` Search for files by name.
+
+```ts
+const { data, error } = await vaze.files.getByName("document.pdf", {
+  limit: 5,
+});
+```
+
+`upload(data)` Upload one or multiple files to your Vaze instance.
+
+- data:
+  - `files` (File[]): An array of standard `File` objects.
+  - `folder?` (string): The ID or name of the target folder.
+
+```ts
+const { data, error } = await vaze.files.upload({
+  files,
+  folder: "optional-folder-name", // example: "documents" or "projects/work" (supports sub-folders)
+});
+```
+
+`rename(data)` Rename an existing file.
+
+- data:
+  - `id` (string): The ID of the file to rename.
+  - `name` (string): The new name for the file.
+
+```ts
+const { data, error } = await vaze.files.rename({
+  id: "file-id-123",
+  name: "new-document-name.pdf",
+});
+```
+
+`delete(id)` Delete a file by its ID.
+
+```ts
+const { data, error } = await vaze.files.delete("file-id-123");
+```
+
+Folders API Access folder-related methods via `vaze.folders`. `get(options?)` Retrieve folders and their contents.
+
+- options (optional):
+  - `id`
+  - `path` example: "projects/work"
+  - `limit`
+  - `offset`
+  - `orderBy`
+  - `orderDirection`
+
+```ts
+const { data, error } = await vaze.folders.get({
+  path: "/documents/work",
+  limit: 20,
+});
+
+if (data) {
+  console.log("Files:", data.files);
+  console.log("Sub-folders:", data.folders);
+}
+```
+
+`create(folder)` Create a new folder.
+
+- folder: The name or path of the new folder. Example: "projects" or "projects/work"
+
+```ts
+const { data, error } = await vaze.folders.create("projects/work");
+```
+
+`rename(data)` Rename an existing folder.
+
+- data:
+  - `id`: The ID of the folder to rename.
+  - `name`: The new name.
+
+```ts
+const { data, error } = await vaze.folders.rename({
+  id: "folder-id-456",
+  name: "new-name",
+});
+```
+
+`delete(id)` Delete a folder by its ID.
+
+```ts
+const { data, error } = await vaze.folders.delete("folder-id");
+```
+
+# Types
+
+This SDK is built with TypeScript and exports all necessary types to ensure type safety in your applications. Types such as `FileWithUrl`, `Folder`, and `ApiResponse`.

package/dist/index.cjs

@@ -46,6 +46,17 @@ var Base = class {
   }
 };
 
+// src/utils/index.ts
+function constructFileUrls({
+  vazeUrl,
+  files
+}) {
+  return files.map((file) => ({
+    ...file,
+    url: `${vazeUrl}/${file.url}`
+  }));
+}
+
 // src/files.ts
 var Files = class extends Base {
   async getAll(options) {
@@ -55,12 +66,36 @@ var Files = class extends Base {
         url.searchParams.set(key, value.toString());
       }
     }
-    return await this.request("GET", url.toString());
+    const { error, data } = await this.request(
+      "GET",
+      url.toString()
+    );
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        })
+      } : null
+    };
   }
   async getById(id) {
     const url = new URL(`/api/files`, this.vazeUrl);
     url.searchParams.set("id", id);
-    return await this.request("GET", url.toString());
+    const { data, error } = await this.request(
+      "GET",
+      url.toString()
+    );
+    return {
+      error,
+      data: data ? {
+        file: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: [data.file]
+        })[0]
+      } : null
+    };
   }
   async getByName(name, options) {
     const url = new URL(`/api/files`, this.vazeUrl);
@@ -70,7 +105,19 @@ var Files = class extends Base {
         url.searchParams.set(key, value.toString());
       }
     }
-    return await this.request("GET", url.toString());
+    const { error, data } = await this.request(
+      "GET",
+      url.toString()
+    );
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        })
+      } : null
+    };
   }
   async upload(data) {
     const { files, folder } = data;
@@ -80,11 +127,20 @@ var Files = class extends Base {
     files.forEach((file) => {
       formData.append("files", file);
     });
-    return await this.request(
+    const { error, data: responseData } = await this.request(
       "POST",
       url.toString(),
       formData
     );
+    return {
+      error,
+      data: responseData ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: responseData.files
+        })
+      } : null
+    };
   }
   async rename(data) {
     const url = new URL(`/api/files`, this.vazeUrl);
@@ -105,10 +161,17 @@ var Folders = class extends Base {
         url.searchParams.set(key, value.toString());
       }
     }
-    return await this.request(
-      "GET",
-      url.toString()
-    );
+    const { error, data } = await this.request("GET", url.toString());
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        }),
+        folders: data.folders
+      } : null
+    };
   }
   async create(folder) {
     const url = new URL("/api/folders", this.vazeUrl);

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as _repo_types from '@repo/types';
 import { ApiResponse, FileWithUrl, Folder } from '@repo/types';
+export { ApiResponse, FileWithUrl as File, Folder } from '@repo/types';
 
 declare class Base {
     private apiKey;
@@ -17,26 +18,86 @@ declare class Files extends Base {
         offset?: number;
         orderBy?: "created_at" | "updated_at" | "name" | "size";
         orderDirection?: "ASC" | "DESC";
-    }): Promise<_repo_types.ApiResponse<{
-        files: FileWithUrl[];
-    }>>;
-    getById(id: string): Promise<_repo_types.ApiResponse<{
-        file: FileWithUrl;
-    }>>;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+        } | null;
+    }>;
+    getById(id: string): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            file: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            } | undefined;
+        } | null;
+    }>;
     getByName(name: string, options?: {
         limit?: number;
         offset?: number;
         orderBy?: "created_at" | "updated_at" | "name" | "size";
         orderDirection?: "ASC" | "DESC";
-    }): Promise<_repo_types.ApiResponse<{
-        files: FileWithUrl[];
-    }>>;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+        } | null;
+    }>;
     upload(data: {
-        files: File[];
-        folder?: string;
-    }): Promise<_repo_types.ApiResponse<{
         files: FileWithUrl[];
-    }>>;
+        folder?: string;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+        } | null;
+    }>;
     rename(data: {
         id: string;
         name: string;
@@ -52,10 +113,25 @@ declare class Folders extends Base {
         offset?: number;
         orderBy?: "created_at" | "updated_at" | "name";
         orderDirection?: "ASC" | "DESC";
-    }): Promise<_repo_types.ApiResponse<{
-        files: FileWithUrl[];
-        folders: Folder[];
-    }>>;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+            folders: Folder[];
+        } | null;
+    }>;
     create(folder: string): Promise<_repo_types.ApiResponse<{
         folder: Folder;
     }>>;
@@ -68,6 +144,7 @@ declare class Folders extends Base {
 
 interface IVaze {
     files: Files;
+    folders: Folders;
 }
 
 declare class Vaze extends Base implements IVaze {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as _repo_types from '@repo/types';
 import { ApiResponse, FileWithUrl, Folder } from '@repo/types';
+export { ApiResponse, FileWithUrl as File, Folder } from '@repo/types';
 
 declare class Base {
     private apiKey;
@@ -17,26 +18,86 @@ declare class Files extends Base {
         offset?: number;
         orderBy?: "created_at" | "updated_at" | "name" | "size";
         orderDirection?: "ASC" | "DESC";
-    }): Promise<_repo_types.ApiResponse<{
-        files: FileWithUrl[];
-    }>>;
-    getById(id: string): Promise<_repo_types.ApiResponse<{
-        file: FileWithUrl;
-    }>>;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+        } | null;
+    }>;
+    getById(id: string): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            file: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            } | undefined;
+        } | null;
+    }>;
     getByName(name: string, options?: {
         limit?: number;
         offset?: number;
         orderBy?: "created_at" | "updated_at" | "name" | "size";
         orderDirection?: "ASC" | "DESC";
-    }): Promise<_repo_types.ApiResponse<{
-        files: FileWithUrl[];
-    }>>;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+        } | null;
+    }>;
     upload(data: {
-        files: File[];
-        folder?: string;
-    }): Promise<_repo_types.ApiResponse<{
         files: FileWithUrl[];
-    }>>;
+        folder?: string;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+        } | null;
+    }>;
     rename(data: {
         id: string;
         name: string;
@@ -52,10 +113,25 @@ declare class Folders extends Base {
         offset?: number;
         orderBy?: "created_at" | "updated_at" | "name";
         orderDirection?: "ASC" | "DESC";
-    }): Promise<_repo_types.ApiResponse<{
-        files: FileWithUrl[];
-        folders: Folder[];
-    }>>;
+    }): Promise<{
+        error: {
+            message: string;
+        } | null;
+        data: {
+            files: {
+                url: string;
+                id: string;
+                name: string;
+                folder_id: string;
+                path: string;
+                size: number;
+                type: string;
+                created_at: string;
+                updated_at: string;
+            }[];
+            folders: Folder[];
+        } | null;
+    }>;
     create(folder: string): Promise<_repo_types.ApiResponse<{
         folder: Folder;
     }>>;
@@ -68,6 +144,7 @@ declare class Folders extends Base {
 
 interface IVaze {
     files: Files;
+    folders: Folders;
 }
 
 declare class Vaze extends Base implements IVaze {

package/dist/index.js

@@ -46,6 +46,17 @@ var Base = class {
   }
 };
 
+// src/utils/index.ts
+function constructFileUrls({
+  vazeUrl,
+  files
+}) {
+  return files.map((file) => ({
+    ...file,
+    url: `${vazeUrl}/${file.url}`
+  }));
+}
+
 // src/files.ts
 var Files = class extends Base {
   async getAll(options) {
@@ -55,12 +66,36 @@ var Files = class extends Base {
         url.searchParams.set(key, value.toString());
       }
     }
-    return await this.request("GET", url.toString());
+    const { error, data } = await this.request(
+      "GET",
+      url.toString()
+    );
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        })
+      } : null
+    };
   }
   async getById(id) {
     const url = new URL(`/api/files`, this.vazeUrl);
     url.searchParams.set("id", id);
-    return await this.request("GET", url.toString());
+    const { data, error } = await this.request(
+      "GET",
+      url.toString()
+    );
+    return {
+      error,
+      data: data ? {
+        file: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: [data.file]
+        })[0]
+      } : null
+    };
   }
   async getByName(name, options) {
     const url = new URL(`/api/files`, this.vazeUrl);
@@ -70,7 +105,19 @@ var Files = class extends Base {
         url.searchParams.set(key, value.toString());
       }
     }
-    return await this.request("GET", url.toString());
+    const { error, data } = await this.request(
+      "GET",
+      url.toString()
+    );
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        })
+      } : null
+    };
   }
   async upload(data) {
     const { files, folder } = data;
@@ -80,11 +127,20 @@ var Files = class extends Base {
     files.forEach((file) => {
       formData.append("files", file);
     });
-    return await this.request(
+    const { error, data: responseData } = await this.request(
       "POST",
       url.toString(),
       formData
     );
+    return {
+      error,
+      data: responseData ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: responseData.files
+        })
+      } : null
+    };
   }
   async rename(data) {
     const url = new URL(`/api/files`, this.vazeUrl);
@@ -105,10 +161,17 @@ var Folders = class extends Base {
         url.searchParams.set(key, value.toString());
       }
     }
-    return await this.request(
-      "GET",
-      url.toString()
-    );
+    const { error, data } = await this.request("GET", url.toString());
+    return {
+      error,
+      data: data ? {
+        files: constructFileUrls({
+          vazeUrl: this.vazeUrl,
+          files: data.files
+        }),
+        folders: data.folders
+      } : null
+    };
   }
   async create(folder) {
     const url = new URL("/api/folders", this.vazeUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@darseen/vaze",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Vaze Self-Hosted file storage and hosting service SKD.",
   "keywords": [
     "api",

package/.turbo/turbo-build.log

@@ -1,28 +0,0 @@
-
-> @darseen/vaze@1.0.0 prebuild /home/runner/work/vaze/vaze/packages/sdk
-> pnpm lint && rimraf ./dist
-
-
-> @darseen/vaze@1.0.0 lint /home/runner/work/vaze/vaze/packages/sdk
-> tsc --noEmit
-
-
-> @darseen/vaze@1.0.0 build /home/runner/work/vaze/vaze/packages/sdk
-> tsup
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/vaze/vaze/packages/sdk/tsup.config.ts
-CLI Target: esnext
-CLI Cleaning output folder
-CJS Build start
-ESM Build start
-ESM dist/index.js 3.70 KB
-ESM ⚡️ Build success in 67ms
-CJS dist/index.cjs 3.74 KB
-CJS ⚡️ Build success in 71ms
-DTS Build start
-DTS ⚡️ Build success in 776ms
-DTS dist/index.d.cts 2.23 KB
-DTS dist/index.d.ts  2.23 KB