@withvlibe/storage-sdk 1.0.0 → 1.1.0

package/dist/index.mjs

@@ -0,0 +1,445 @@
+// src/VlibeStorage.ts
+var DEFAULT_BASE_URL = "https://vlibe.app";
+var VlibeStorage = class {
+  constructor(config) {
+    this.authToken = null;
+    this.storageConfig = null;
+    this.appId = config.appId;
+    this.appSecret = config.appSecret;
+    this.baseUrl = config.baseUrl?.replace(/\/$/, "") || DEFAULT_BASE_URL;
+  }
+  /**
+   * Set the user's auth token (required for authenticated requests)
+   */
+  setAuthToken(token) {
+    this.authToken = token;
+  }
+  /**
+   * Clear the auth token
+   */
+  clearAuthToken() {
+    this.authToken = null;
+  }
+  /**
+   * Get storage configuration from the server
+   * This fetches the current storage provider and public URL base
+   */
+  async getStorageConfig() {
+    if (this.storageConfig) {
+      return this.storageConfig;
+    }
+    try {
+      const response = await this.request("/storage/config");
+      if (response.success && response.data) {
+        this.storageConfig = response.data;
+        return response.data;
+      }
+    } catch {
+    }
+    return {
+      provider: "wasabi",
+      publicUrlBase: "https://s3.eu-central-2.wasabisys.com/vlibe.com"
+    };
+  }
+  /**
+   * Clear cached storage config (call if config might have changed)
+   */
+  clearStorageConfigCache() {
+    this.storageConfig = null;
+  }
+  /**
+   * Make an authenticated API request
+   */
+  async request(path, options = {}) {
+    const url = `${this.baseUrl}/api${path}`;
+    const headers = {
+      "X-App-Id": this.appId,
+      "X-App-Secret": this.appSecret,
+      ...options.headers || {}
+    };
+    if (this.authToken) {
+      headers["Authorization"] = `Bearer ${this.authToken}`;
+    }
+    const response = await fetch(url, {
+      ...options,
+      headers
+    });
+    const data = await response.json();
+    if (!response.ok && !data.error) {
+      return {
+        success: false,
+        error: `HTTP ${response.status}: ${response.statusText}`
+      };
+    }
+    return data;
+  }
+  // ============================================
+  // UPLOAD METHODS
+  // ============================================
+  /**
+   * Upload a file directly
+   */
+  async upload(file, options = {}) {
+    const formData = new FormData();
+    formData.append("file", file);
+    if (options.folder) {
+      formData.append("folder", options.folder);
+    }
+    if (options.isPublic) {
+      formData.append("isPublic", "true");
+    }
+    const response = await this.request("/storage", {
+      method: "POST",
+      body: formData
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Upload failed");
+    }
+    return response.data;
+  }
+  /**
+   * Get a presigned URL for direct upload to storage
+   * Useful for large files or when you want upload progress
+   */
+  async getUploadUrl(filename, mimeType, size, options = {}) {
+    const response = await this.request("/storage/upload-url", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        filename,
+        mimeType,
+        size,
+        folder: options.folder,
+        isPublic: options.isPublic
+      })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to get upload URL");
+    }
+    return response.data;
+  }
+  /**
+   * Upload a file using presigned URL (for progress tracking)
+   */
+  async uploadWithProgress(file, options = {}) {
+    const { uploadUrl, key, expiresIn } = await this.getUploadUrl(
+      file.name,
+      file.type,
+      file.size,
+      options
+    );
+    await new Promise((resolve, reject) => {
+      const xhr = new XMLHttpRequest();
+      if (options.onProgress) {
+        xhr.upload.addEventListener("progress", (e) => {
+          if (e.lengthComputable) {
+            const percent = Math.round(e.loaded / e.total * 100);
+            options.onProgress(percent);
+          }
+        });
+      }
+      xhr.addEventListener("load", () => {
+        if (xhr.status >= 200 && xhr.status < 300) {
+          resolve();
+        } else {
+          reject(new Error(`Upload failed with status ${xhr.status}`));
+        }
+      });
+      xhr.addEventListener("error", () => {
+        reject(new Error("Upload failed"));
+      });
+      xhr.open("PUT", uploadUrl);
+      xhr.setRequestHeader("Content-Type", file.type);
+      xhr.send(file);
+    });
+    const response = await this.request("/storage/upload-url", {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        key,
+        filename: file.name,
+        mimeType: file.type,
+        size: file.size,
+        folder: options.folder,
+        isPublic: options.isPublic
+      })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to confirm upload");
+    }
+    return response.data;
+  }
+  // ============================================
+  // DOWNLOAD METHODS
+  // ============================================
+  /**
+   * Get a signed download URL for a file
+   */
+  async getDownloadUrl(fileId, expiresIn) {
+    const params = new URLSearchParams({ download: "true" });
+    if (expiresIn) {
+      params.set("expiresIn", expiresIn.toString());
+    }
+    const response = await this.request(
+      `/storage/${fileId}?${params}`
+    );
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to get download URL");
+    }
+    return response.data.url;
+  }
+  /**
+   * Get a public URL for a file (only works for public files in the public path)
+   * Returns the direct URL based on the configured storage provider
+   *
+   * Note: This is a sync method that uses cached config. Call getStorageConfig()
+   * first to ensure the config is loaded, or use getPublicUrlAsync() for a
+   * guaranteed fresh URL.
+   */
+  getPublicUrl(key) {
+    if (this.storageConfig) {
+      const base = this.storageConfig.publicUrlBase.replace(/\/$/, "");
+      return `${base}/${key}`;
+    }
+    const region = "eu-central-2";
+    const bucket = "vlibe.com";
+    return `https://s3.${region}.wasabisys.com/${bucket}/${key}`;
+  }
+  /**
+   * Get a public URL for a file (async version that ensures fresh config)
+   * Returns the direct URL based on the configured storage provider
+   */
+  async getPublicUrlAsync(key) {
+    const config = await this.getStorageConfig();
+    const base = config.publicUrlBase.replace(/\/$/, "");
+    return `${base}/${key}`;
+  }
+  /**
+   * Check if a storage key is in the public path
+   */
+  isPublicKey(key) {
+    return key.startsWith("vlibe-storage/public/");
+  }
+  // ============================================
+  // FILE MANAGEMENT
+  // ============================================
+  /**
+   * List files
+   */
+  async list(options = {}) {
+    const params = new URLSearchParams();
+    if (options.folder !== void 0) {
+      params.set("folder", options.folder);
+    }
+    if (options.limit) {
+      params.set("limit", options.limit.toString());
+    }
+    if (options.offset) {
+      params.set("offset", options.offset.toString());
+    }
+    const response = await this.request(
+      `/storage?${params}`
+    );
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to list files");
+    }
+    return response.data;
+  }
+  /**
+   * Get a single file's metadata
+   */
+  async get(fileId) {
+    const response = await this.request(`/storage/${fileId}`);
+    if (!response.success) {
+      if (response.error?.includes("not found")) {
+        return null;
+      }
+      throw new Error(response.error || "Failed to get file");
+    }
+    return response.data || null;
+  }
+  /**
+   * Delete a file
+   */
+  async delete(fileId) {
+    const response = await this.request(`/storage/${fileId}`, {
+      method: "DELETE"
+    });
+    if (!response.success) {
+      if (response.error?.includes("not found")) {
+        return false;
+      }
+      throw new Error(response.error || "Failed to delete file");
+    }
+    return true;
+  }
+  /**
+   * Delete multiple files
+   */
+  async deleteMany(fileIds) {
+    const deleted = [];
+    const failed = [];
+    const batchSize = 10;
+    for (let i = 0; i < fileIds.length; i += batchSize) {
+      const batch = fileIds.slice(i, i + batchSize);
+      const results = await Promise.allSettled(
+        batch.map((id) => this.delete(id))
+      );
+      results.forEach((result, index) => {
+        const id = batch[index];
+        if (result.status === "fulfilled" && result.value) {
+          deleted.push(id);
+        } else {
+          failed.push(id);
+        }
+      });
+    }
+    return { deleted, failed };
+  }
+  // ============================================
+  // USAGE & LIMITS
+  // ============================================
+  /**
+   * Get storage usage statistics
+   */
+  async getUsage() {
+    const response = await this.request("/storage/usage");
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to get usage");
+    }
+    return response.data;
+  }
+  /**
+   * Check if a file of given size can be uploaded
+   */
+  async canUpload(size) {
+    const response = await this.request("/storage/usage", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ size })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to check upload");
+    }
+    return response.data;
+  }
+  // ============================================
+  // FOLDER MANAGEMENT
+  // ============================================
+  /**
+   * List folders
+   */
+  async listFolders(options = {}) {
+    const params = new URLSearchParams();
+    if (options.parentId !== void 0) {
+      params.set("parentId", options.parentId === null ? "null" : options.parentId);
+    }
+    if (options.projectId) {
+      params.set("projectId", options.projectId);
+    }
+    const response = await this.request(`/storage/folders?${params}`);
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to list folders");
+    }
+    return response.data;
+  }
+  /**
+   * Create a folder
+   */
+  async createFolder(name, options = {}) {
+    const response = await this.request("/storage/folders", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        name,
+        parentId: options.parentId,
+        projectId: options.projectId,
+        isProjectRoot: options.isProjectRoot
+      })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to create folder");
+    }
+    return response.data;
+  }
+  /**
+   * Rename a folder
+   */
+  async renameFolder(folderId, name) {
+    const response = await this.request(`/storage/folders/${folderId}`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ name })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to rename folder");
+    }
+    return response.data;
+  }
+  /**
+   * Delete a folder (must be empty)
+   */
+  async deleteFolder(folderId) {
+    const response = await this.request(`/storage/folders/${folderId}`, {
+      method: "DELETE"
+    });
+    if (!response.success) {
+      if (response.error?.includes("not found")) {
+        return false;
+      }
+      throw new Error(response.error || "Failed to delete folder");
+    }
+    return true;
+  }
+  // ============================================
+  // FILE COPY & REFERENCE
+  // ============================================
+  /**
+   * Copy a file to another project
+   * Creates a new database record pointing to the same S3 object
+   */
+  async copyFileToProject(fileId, targetProjectId) {
+    const response = await this.request("/storage/files/copy", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ fileId, targetProjectId })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to copy file");
+    }
+    return response.data;
+  }
+  /**
+   * Create a file reference (link file to another project without copying)
+   * Does not count against storage quota
+   */
+  async createFileReference(fileId, targetProjectId) {
+    const response = await this.request("/storage/files/reference", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ fileId, targetProjectId })
+    });
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to create file reference");
+    }
+    return response.data;
+  }
+};
+export {
+  VlibeStorage
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/VlibeStorage.ts"],"sourcesContent":["/**\n * VlibeStorage - Main SDK class\n */\nimport type {\n  VlibeStorageConfig,\n  StorageFile,\n  UploadOptions,\n  UploadResult,\n  ListOptions,\n  ListResult,\n  StorageStats,\n  CanUploadResult,\n  PresignedUpload,\n  ApiResponse,\n  Folder,\n  CreateFolderOptions,\n  ListFoldersOptions,\n  FileReference,\n  FileCopyResult,\n  StorageConfig,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://vlibe.app';\n\nexport class VlibeStorage {\n  private appId: string;\n  private appSecret: string;\n  private baseUrl: string;\n  private authToken: string | null = null;\n  private storageConfig: StorageConfig | null = null;\n\n  constructor(config: VlibeStorageConfig) {\n    this.appId = config.appId;\n    this.appSecret = config.appSecret;\n    this.baseUrl = config.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n  }\n\n  /**\n   * Set the user's auth token (required for authenticated requests)\n   */\n  setAuthToken(token: string): void {\n    this.authToken = token;\n  }\n\n  /**\n   * Clear the auth token\n   */\n  clearAuthToken(): void {\n    this.authToken = null;\n  }\n\n  /**\n   * Get storage configuration from the server\n   * This fetches the current storage provider and public URL base\n   */\n  async getStorageConfig(): Promise<StorageConfig> {\n    // Return cached config if available\n    if (this.storageConfig) {\n      return this.storageConfig;\n    }\n\n    try {\n      const response = await this.request<StorageConfig>('/storage/config');\n      if (response.success && response.data) {\n        this.storageConfig = response.data;\n        return response.data;\n      }\n    } catch {\n      // Fall through to default\n    }\n\n    // Fallback to legacy Wasabi configuration\n    return {\n      provider: 'wasabi',\n      publicUrlBase: 'https://s3.eu-central-2.wasabisys.com/vlibe.com',\n    };\n  }\n\n  /**\n   * Clear cached storage config (call if config might have changed)\n   */\n  clearStorageConfigCache(): void {\n    this.storageConfig = null;\n  }\n\n  /**\n   * Make an authenticated API request\n   */\n  private async request<T>(\n    path: string,\n    options: RequestInit = {}\n  ): Promise<ApiResponse<T>> {\n    const url = `${this.baseUrl}/api${path}`;\n\n    const headers: Record<string, string> = {\n      'X-App-Id': this.appId,\n      'X-App-Secret': this.appSecret,\n      ...((options.headers as Record<string, string>) || {}),\n    };\n\n    if (this.authToken) {\n      headers['Authorization'] = `Bearer ${this.authToken}`;\n    }\n\n    const response = await fetch(url, {\n      ...options,\n      headers,\n    });\n\n    const data = await response.json();\n\n    if (!response.ok && !data.error) {\n      return {\n        success: false,\n        error: `HTTP ${response.status}: ${response.statusText}`,\n      };\n    }\n\n    return data;\n  }\n\n  // ============================================\n  // UPLOAD METHODS\n  // ============================================\n\n  /**\n   * Upload a file directly\n   */\n  async upload(\n    file: File | Blob,\n    options: UploadOptions = {}\n  ): Promise<UploadResult> {\n    const formData = new FormData();\n    formData.append('file', file);\n\n    if (options.folder) {\n      formData.append('folder', options.folder);\n    }\n    if (options.isPublic) {\n      formData.append('isPublic', 'true');\n    }\n\n    const response = await this.request<UploadResult>('/storage', {\n      method: 'POST',\n      body: formData,\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Upload failed');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Get a presigned URL for direct upload to storage\n   * Useful for large files or when you want upload progress\n   */\n  async getUploadUrl(\n    filename: string,\n    mimeType: string,\n    size: number,\n    options: Omit<UploadOptions, 'onProgress'> = {}\n  ): Promise<PresignedUpload> {\n    const response = await this.request<PresignedUpload>('/storage/upload-url', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        filename,\n        mimeType,\n        size,\n        folder: options.folder,\n        isPublic: options.isPublic,\n      }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to get upload URL');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Upload a file using presigned URL (for progress tracking)\n   */\n  async uploadWithProgress(\n    file: File,\n    options: UploadOptions = {}\n  ): Promise<UploadResult> {\n    // Get presigned URL\n    const { uploadUrl, key, expiresIn } = await this.getUploadUrl(\n      file.name,\n      file.type,\n      file.size,\n      options\n    );\n\n    // Upload directly to S3 with progress\n    await new Promise<void>((resolve, reject) => {\n      const xhr = new XMLHttpRequest();\n\n      if (options.onProgress) {\n        xhr.upload.addEventListener('progress', (e) => {\n          if (e.lengthComputable) {\n            const percent = Math.round((e.loaded / e.total) * 100);\n            options.onProgress!(percent);\n          }\n        });\n      }\n\n      xhr.addEventListener('load', () => {\n        if (xhr.status >= 200 && xhr.status < 300) {\n          resolve();\n        } else {\n          reject(new Error(`Upload failed with status ${xhr.status}`));\n        }\n      });\n\n      xhr.addEventListener('error', () => {\n        reject(new Error('Upload failed'));\n      });\n\n      xhr.open('PUT', uploadUrl);\n      xhr.setRequestHeader('Content-Type', file.type);\n      xhr.send(file);\n    });\n\n    // Confirm upload\n    const response = await this.request<UploadResult>('/storage/upload-url', {\n      method: 'PUT',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        key,\n        filename: file.name,\n        mimeType: file.type,\n        size: file.size,\n        folder: options.folder,\n        isPublic: options.isPublic,\n      }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to confirm upload');\n    }\n\n    return response.data;\n  }\n\n  // ============================================\n  // DOWNLOAD METHODS\n  // ============================================\n\n  /**\n   * Get a signed download URL for a file\n   */\n  async getDownloadUrl(fileId: string, expiresIn?: number): Promise<string> {\n    const params = new URLSearchParams({ download: 'true' });\n    if (expiresIn) {\n      params.set('expiresIn', expiresIn.toString());\n    }\n\n    const response = await this.request<{ url: string; expiresIn: number }>(\n      `/storage/${fileId}?${params}`\n    );\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to get download URL');\n    }\n\n    return response.data.url;\n  }\n\n  /**\n   * Get a public URL for a file (only works for public files in the public path)\n   * Returns the direct URL based on the configured storage provider\n   *\n   * Note: This is a sync method that uses cached config. Call getStorageConfig()\n   * first to ensure the config is loaded, or use getPublicUrlAsync() for a\n   * guaranteed fresh URL.\n   */\n  getPublicUrl(key: string): string {\n    // Use cached config if available\n    if (this.storageConfig) {\n      const base = this.storageConfig.publicUrlBase.replace(/\\/$/, '');\n      return `${base}/${key}`;\n    }\n\n    // Fallback to legacy Wasabi URL\n    const region = 'eu-central-2';\n    const bucket = 'vlibe.com';\n    return `https://s3.${region}.wasabisys.com/${bucket}/${key}`;\n  }\n\n  /**\n   * Get a public URL for a file (async version that ensures fresh config)\n   * Returns the direct URL based on the configured storage provider\n   */\n  async getPublicUrlAsync(key: string): Promise<string> {\n    const config = await this.getStorageConfig();\n    const base = config.publicUrlBase.replace(/\\/$/, '');\n    return `${base}/${key}`;\n  }\n\n  /**\n   * Check if a storage key is in the public path\n   */\n  isPublicKey(key: string): boolean {\n    return key.startsWith('vlibe-storage/public/');\n  }\n\n  // ============================================\n  // FILE MANAGEMENT\n  // ============================================\n\n  /**\n   * List files\n   */\n  async list(options: ListOptions = {}): Promise<ListResult> {\n    const params = new URLSearchParams();\n    if (options.folder !== undefined) {\n      params.set('folder', options.folder);\n    }\n    if (options.limit) {\n      params.set('limit', options.limit.toString());\n    }\n    if (options.offset) {\n      params.set('offset', options.offset.toString());\n    }\n\n    const response = await this.request<ListResult>(\n      `/storage?${params}`\n    );\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to list files');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Get a single file's metadata\n   */\n  async get(fileId: string): Promise<StorageFile | null> {\n    const response = await this.request<StorageFile>(`/storage/${fileId}`);\n\n    if (!response.success) {\n      if (response.error?.includes('not found')) {\n        return null;\n      }\n      throw new Error(response.error || 'Failed to get file');\n    }\n\n    return response.data || null;\n  }\n\n  /**\n   * Delete a file\n   */\n  async delete(fileId: string): Promise<boolean> {\n    const response = await this.request<void>(`/storage/${fileId}`, {\n      method: 'DELETE',\n    });\n\n    if (!response.success) {\n      if (response.error?.includes('not found')) {\n        return false;\n      }\n      throw new Error(response.error || 'Failed to delete file');\n    }\n\n    return true;\n  }\n\n  /**\n   * Delete multiple files\n   */\n  async deleteMany(fileIds: string[]): Promise<{ deleted: string[]; failed: string[] }> {\n    const deleted: string[] = [];\n    const failed: string[] = [];\n\n    // Delete in parallel batches\n    const batchSize = 10;\n    for (let i = 0; i < fileIds.length; i += batchSize) {\n      const batch = fileIds.slice(i, i + batchSize);\n      const results = await Promise.allSettled(\n        batch.map((id) => this.delete(id))\n      );\n\n      results.forEach((result, index) => {\n        const id = batch[index];\n        if (result.status === 'fulfilled' && result.value) {\n          deleted.push(id);\n        } else {\n          failed.push(id);\n        }\n      });\n    }\n\n    return { deleted, failed };\n  }\n\n  // ============================================\n  // USAGE & LIMITS\n  // ============================================\n\n  /**\n   * Get storage usage statistics\n   */\n  async getUsage(): Promise<StorageStats> {\n    const response = await this.request<StorageStats>('/storage/usage');\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to get usage');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Check if a file of given size can be uploaded\n   */\n  async canUpload(size: number): Promise<CanUploadResult> {\n    const response = await this.request<CanUploadResult>('/storage/usage', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({ size }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to check upload');\n    }\n\n    return response.data;\n  }\n\n  // ============================================\n  // FOLDER MANAGEMENT\n  // ============================================\n\n  /**\n   * List folders\n   */\n  async listFolders(options: ListFoldersOptions = {}): Promise<Folder[]> {\n    const params = new URLSearchParams();\n    if (options.parentId !== undefined) {\n      params.set('parentId', options.parentId === null ? 'null' : options.parentId);\n    }\n    if (options.projectId) {\n      params.set('projectId', options.projectId);\n    }\n\n    const response = await this.request<Folder[]>(`/storage/folders?${params}`);\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to list folders');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Create a folder\n   */\n  async createFolder(name: string, options: CreateFolderOptions = {}): Promise<Folder> {\n    const response = await this.request<Folder>('/storage/folders', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        name,\n        parentId: options.parentId,\n        projectId: options.projectId,\n        isProjectRoot: options.isProjectRoot,\n      }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to create folder');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Rename a folder\n   */\n  async renameFolder(folderId: string, name: string): Promise<Folder> {\n    const response = await this.request<Folder>(`/storage/folders/${folderId}`, {\n      method: 'PATCH',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({ name }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to rename folder');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Delete a folder (must be empty)\n   */\n  async deleteFolder(folderId: string): Promise<boolean> {\n    const response = await this.request<void>(`/storage/folders/${folderId}`, {\n      method: 'DELETE',\n    });\n\n    if (!response.success) {\n      if (response.error?.includes('not found')) {\n        return false;\n      }\n      throw new Error(response.error || 'Failed to delete folder');\n    }\n\n    return true;\n  }\n\n  // ============================================\n  // FILE COPY & REFERENCE\n  // ============================================\n\n  /**\n   * Copy a file to another project\n   * Creates a new database record pointing to the same S3 object\n   */\n  async copyFileToProject(fileId: string, targetProjectId: string): Promise<FileCopyResult> {\n    const response = await this.request<FileCopyResult>('/storage/files/copy', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({ fileId, targetProjectId }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to copy file');\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Create a file reference (link file to another project without copying)\n   * Does not count against storage quota\n   */\n  async createFileReference(fileId: string, targetProjectId: string): Promise<FileReference> {\n    const response = await this.request<FileReference>('/storage/files/reference', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({ fileId, targetProjectId }),\n    });\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to create file reference');\n    }\n\n    return response.data;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/react.d.mts

@@ -0,0 +1,68 @@
+import { VlibeStorage, StorageFile, UploadOptions, UploadResult, StorageStats } from './index.mjs';
+export { CanUploadResult, ListOptions, ListResult, PresignedUpload, VlibeStorageConfig } from './index.mjs';
+
+interface UseStorageOptions {
+    /** Initial folder to list files from */
+    folder?: string;
+    /** Auto-fetch files on mount */
+    autoFetch?: boolean;
+    /** Pagination limit */
+    limit?: number;
+}
+interface UseStorageReturn {
+    /** List of files */
+    files: StorageFile[];
+    /** Total file count */
+    total: number;
+    /** Loading state */
+    loading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Upload a file */
+    upload: (file: File, options?: UploadOptions) => Promise<UploadResult>;
+    /** Upload with progress tracking */
+    uploadWithProgress: (file: File, options?: UploadOptions) => Promise<UploadResult>;
+    /** Current upload progress (0-100) */
+    uploadProgress: number;
+    /** Uploading state */
+    uploading: boolean;
+    /** Delete a file */
+    remove: (fileId: string) => Promise<boolean>;
+    /** Refresh the file list */
+    refresh: () => Promise<void>;
+    /** Load more files (pagination) */
+    loadMore: () => Promise<void>;
+    /** Whether there are more files to load */
+    hasMore: boolean;
+}
+declare function useStorage(client: VlibeStorage, options?: UseStorageOptions): UseStorageReturn;
+
+interface UseStorageUsageOptions {
+    /** Auto-fetch usage on mount */
+    autoFetch?: boolean;
+    /** Refresh interval in milliseconds (0 = disabled) */
+    refreshInterval?: number;
+}
+interface UseStorageUsageReturn {
+    /** Storage usage statistics */
+    usage: StorageStats | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Check if a file of given size can be uploaded */
+    canUpload: (size: number) => boolean;
+    /** Refresh usage data */
+    refresh: () => Promise<void>;
+    /** Usage percentage (0-100) */
+    usagePercent: number;
+    /** Formatted usage string (e.g., "1.5 GB of 5 GB") */
+    usageFormatted: string;
+    /** Whether storage limit is reached */
+    isLimitReached: boolean;
+    /** Whether usage is above 80% */
+    isNearLimit: boolean;
+}
+declare function useStorageUsage(client: VlibeStorage, options?: UseStorageUsageOptions): UseStorageUsageReturn;
+
+export { StorageFile, StorageStats, UploadOptions, UploadResult, type UseStorageOptions, type UseStorageReturn, type UseStorageUsageOptions, type UseStorageUsageReturn, VlibeStorage, useStorage, useStorageUsage };

package/dist/react.d.ts

@@ -0,0 +1,68 @@
+import { VlibeStorage, StorageFile, UploadOptions, UploadResult, StorageStats } from './index.js';
+export { CanUploadResult, ListOptions, ListResult, PresignedUpload, VlibeStorageConfig } from './index.js';
+
+interface UseStorageOptions {
+    /** Initial folder to list files from */
+    folder?: string;
+    /** Auto-fetch files on mount */
+    autoFetch?: boolean;
+    /** Pagination limit */
+    limit?: number;
+}
+interface UseStorageReturn {
+    /** List of files */
+    files: StorageFile[];
+    /** Total file count */
+    total: number;
+    /** Loading state */
+    loading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Upload a file */
+    upload: (file: File, options?: UploadOptions) => Promise<UploadResult>;
+    /** Upload with progress tracking */
+    uploadWithProgress: (file: File, options?: UploadOptions) => Promise<UploadResult>;
+    /** Current upload progress (0-100) */
+    uploadProgress: number;
+    /** Uploading state */
+    uploading: boolean;
+    /** Delete a file */
+    remove: (fileId: string) => Promise<boolean>;
+    /** Refresh the file list */
+    refresh: () => Promise<void>;
+    /** Load more files (pagination) */
+    loadMore: () => Promise<void>;
+    /** Whether there are more files to load */
+    hasMore: boolean;
+}
+declare function useStorage(client: VlibeStorage, options?: UseStorageOptions): UseStorageReturn;
+
+interface UseStorageUsageOptions {
+    /** Auto-fetch usage on mount */
+    autoFetch?: boolean;
+    /** Refresh interval in milliseconds (0 = disabled) */
+    refreshInterval?: number;
+}
+interface UseStorageUsageReturn {
+    /** Storage usage statistics */
+    usage: StorageStats | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Check if a file of given size can be uploaded */
+    canUpload: (size: number) => boolean;
+    /** Refresh usage data */
+    refresh: () => Promise<void>;
+    /** Usage percentage (0-100) */
+    usagePercent: number;
+    /** Formatted usage string (e.g., "1.5 GB of 5 GB") */
+    usageFormatted: string;
+    /** Whether storage limit is reached */
+    isLimitReached: boolean;
+    /** Whether usage is above 80% */
+    isNearLimit: boolean;
+}
+declare function useStorageUsage(client: VlibeStorage, options?: UseStorageUsageOptions): UseStorageUsageReturn;
+
+export { StorageFile, StorageStats, UploadOptions, UploadResult, type UseStorageOptions, type UseStorageReturn, type UseStorageUsageOptions, type UseStorageUsageReturn, VlibeStorage, useStorage, useStorageUsage };