@unboundcx/sdk 2.6.2 → 2.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "2.6.2",
+  "version": "2.6.3",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/storage.js

@@ -6,11 +6,13 @@ export class StorageService {
   // Private helper method to detect content type from filename
   _getContentType(fileName) {
     if (!fileName) return 'application/octet-stream';
-    
+
     try {
       // Try to use mime-types package if available
       const mime = import('mime-types');
-      return mime.lookup ? mime.lookup(fileName) || 'application/octet-stream' : this._getFallbackContentType(fileName);
+      return mime.lookup
+        ? mime.lookup(fileName) || 'application/octet-stream'
+        : this._getFallbackContentType(fileName);
     } catch (error) {
       return this._getFallbackContentType(fileName);
     }
@@ -93,24 +95,40 @@ export class StorageService {
 
     // Add file field with proper MIME type detection
     const contentType = this._getContentType(fileName);
-    
+
     body += `--${boundary}${CRLF}`;
-    body += `Content-Disposition: form-data; name="files"; filename="${fileName || 'file'}"${CRLF}`;
+    body += `Content-Disposition: form-data; name="files"; filename="${
+      fileName || 'file'
+    }"${CRLF}`;
     body += `Content-Type: ${contentType}${CRLF}${CRLF}`;
 
     // Convert to buffers and combine
-    const headerBuffer = (typeof Buffer !== 'undefined') ? Buffer.from(body, 'utf8') : new TextEncoder().encode(body);
-    const fileBuffer = (typeof Buffer !== 'undefined' && Buffer.isBuffer && Buffer.isBuffer(file)) ? file : ((typeof Buffer !== 'undefined') ? Buffer.from(file) : new TextEncoder().encode(file));
+    const headerBuffer =
+      typeof Buffer !== 'undefined'
+        ? Buffer.from(body, 'utf8')
+        : new TextEncoder().encode(body);
+    const fileBuffer =
+      typeof Buffer !== 'undefined' && Buffer.isBuffer && Buffer.isBuffer(file)
+        ? file
+        : typeof Buffer !== 'undefined'
+          ? Buffer.from(file)
+          : new TextEncoder().encode(file);
 
     // Add form fields
-    let fieldsBuffer = (typeof Buffer !== 'undefined') ? Buffer.alloc(0) : new Uint8Array(0);
+    let fieldsBuffer =
+      typeof Buffer !== 'undefined' ? Buffer.alloc(0) : new Uint8Array(0);
     for (const [name, value] of formFields) {
       const fieldData = `${CRLF}--${boundary}${CRLF}Content-Disposition: form-data; name="${name}"${CRLF}${CRLF}${value}`;
-      const fieldDataBuffer = (typeof Buffer !== 'undefined') ? Buffer.from(fieldData, 'utf8') : new TextEncoder().encode(fieldData);
+      const fieldDataBuffer =
+        typeof Buffer !== 'undefined'
+          ? Buffer.from(fieldData, 'utf8')
+          : new TextEncoder().encode(fieldData);
       if (typeof Buffer !== 'undefined') {
         fieldsBuffer = Buffer.concat([fieldsBuffer, fieldDataBuffer]);
       } else {
-        const newBuffer = new Uint8Array(fieldsBuffer.length + fieldDataBuffer.length);
+        const newBuffer = new Uint8Array(
+          fieldsBuffer.length + fieldDataBuffer.length,
+        );
         newBuffer.set(fieldsBuffer);
         newBuffer.set(fieldDataBuffer, fieldsBuffer.length);
         fieldsBuffer = newBuffer;
@@ -118,27 +136,42 @@ export class StorageService {
     }
 
     // Final boundary
-    const endBoundary = (typeof Buffer !== 'undefined') ? Buffer.from(`${CRLF}--${boundary}--${CRLF}`, 'utf8') : new TextEncoder().encode(`${CRLF}--${boundary}--${CRLF}`);
+    const endBoundary =
+      typeof Buffer !== 'undefined'
+        ? Buffer.from(`${CRLF}--${boundary}--${CRLF}`, 'utf8')
+        : new TextEncoder().encode(`${CRLF}--${boundary}--${CRLF}`);
 
     // Combine all parts
     let formData;
     if (typeof Buffer !== 'undefined') {
-      formData = Buffer.concat([headerBuffer, fileBuffer, fieldsBuffer, endBoundary]);
+      formData = Buffer.concat([
+        headerBuffer,
+        fileBuffer,
+        fieldsBuffer,
+        endBoundary,
+      ]);
     } else {
-      const totalLength = headerBuffer.length + fileBuffer.length + fieldsBuffer.length + endBoundary.length;
+      const totalLength =
+        headerBuffer.length +
+        fileBuffer.length +
+        fieldsBuffer.length +
+        endBoundary.length;
       formData = new Uint8Array(totalLength);
       let offset = 0;
-      formData.set(headerBuffer, offset); offset += headerBuffer.length;
-      formData.set(fileBuffer, offset); offset += fileBuffer.length;
-      formData.set(fieldsBuffer, offset); offset += fieldsBuffer.length;
+      formData.set(headerBuffer, offset);
+      offset += headerBuffer.length;
+      formData.set(fileBuffer, offset);
+      offset += fileBuffer.length;
+      formData.set(fieldsBuffer, offset);
+      offset += fieldsBuffer.length;
       formData.set(endBoundary, offset);
     }
 
     return {
       formData,
       headers: {
-        'content-type': `multipart/form-data; boundary=${boundary}`
-      }
+        'content-type': `multipart/form-data; boundary=${boundary}`,
+      },
     };
   }
 
@@ -147,13 +180,19 @@ export class StorageService {
     const formData = new FormData();
 
     // Add the file - handle both Buffer and File objects
-    if ((typeof Buffer !== 'undefined') && Buffer.isBuffer && Buffer.isBuffer(file)) {
+    if (
+      typeof Buffer !== 'undefined' &&
+      Buffer.isBuffer &&
+      Buffer.isBuffer(file)
+    ) {
       const blob = new Blob([file]);
       formData.append('files', blob, fileName || 'file');
     } else if (file instanceof File) {
       formData.append('files', file);
     } else {
-      throw new Error('In browser environment, file must be a Buffer or File object');
+      throw new Error(
+        'In browser environment, file must be a Buffer or File object',
+      );
     }
 
     // Add other parameters
@@ -163,12 +202,17 @@ export class StorageService {
 
     return {
       formData,
-      headers: {} // Let browser handle content-type automatically
+      headers: {}, // Let browser handle content-type automatically
     };
   }
 
   // Shared upload logic
-  async _performUpload(file, fileName, formFields, endpoint = '/storage/upload') {
+  async _performUpload(
+    file,
+    fileName,
+    formFields,
+    endpoint = '/storage/upload',
+  ) {
     const isNode = typeof window === 'undefined';
     let formData, headers;
 
@@ -256,9 +300,11 @@ export class StorageService {
 
     // Handle different file input formats and convert to array for processing
     let fileArray = [];
-    
+
     if (typeof window !== 'undefined' && files instanceof FormData) {
-      throw new Error('FormData input not supported for uploadFiles. Use individual File objects or FileList.');
+      throw new Error(
+        'FormData input not supported for uploadFiles. Use individual File objects or FileList.',
+      );
     } else if (typeof window !== 'undefined' && files instanceof FileList) {
       // Browser FileList
       for (let i = 0; i < files.length; i++) {
@@ -268,11 +314,16 @@ export class StorageService {
       // File array (Node.js or Browser)
       fileArray = files.map((file, index) => ({
         file,
-        fileName: file.name || `file-${index}`
+        fileName: file.name || `file-${index}`,
       }));
-    } else if (typeof files === 'object' && (files.path || files instanceof File)) {
+    } else if (
+      typeof files === 'object' &&
+      (files.path || files instanceof File)
+    ) {
       // Single file object (Node.js) or File (Browser)
-      fileArray = [{ file: files, fileName: files.name || files.path || 'file' }];
+      fileArray = [
+        { file: files, fileName: files.name || files.path || 'file' },
+      ];
     } else {
       throw new Error(
         'Invalid files format. Expected FileList, File array, or File object',
@@ -287,52 +338,56 @@ export class StorageService {
 
     if (isNode) {
       // Node.js: Create multipart form data manually
-      const boundary = `----formdata-${Date.now()}-${Math.random().toString(36)}`;
+      const boundary = `----formdata-${Date.now()}-${Math.random().toString(
+        36,
+      )}`;
       const CRLF = '\r\n';
-      let body = '';
-      
+      const body = '';
+
       const bufferParts = [];
-      
+
       // Add all files
       for (const { file, fileName } of fileArray) {
         const contentType = this._getContentType(fileName);
         const fileHeader = `--${boundary}${CRLF}Content-Disposition: form-data; name="files"; filename="${fileName}"${CRLF}Content-Type: ${contentType}${CRLF}${CRLF}`;
-        
+
         bufferParts.push(Buffer.from(fileHeader, 'utf8'));
         bufferParts.push(Buffer.isBuffer(file) ? file : Buffer.from(file));
         bufferParts.push(Buffer.from(CRLF, 'utf8'));
       }
-      
+
       // Add form fields
       const formFields = [];
       if (classification) formFields.push(['classification', classification]);
       if (expireAfter) formFields.push(['expireAfter', expireAfter]);
-      if (isPublic !== undefined) formFields.push(['isPublic', isPublic.toString()]);
+      if (isPublic !== undefined)
+        formFields.push(['isPublic', isPublic.toString()]);
       if (metadata) formFields.push(['metadata', JSON.stringify(metadata)]);
-      
+
       for (const [name, value] of formFields) {
         const fieldData = `--${boundary}${CRLF}Content-Disposition: form-data; name="${name}"${CRLF}${CRLF}${value}${CRLF}`;
         bufferParts.push(Buffer.from(fieldData, 'utf8'));
       }
-      
+
       // Final boundary
       bufferParts.push(Buffer.from(`--${boundary}--${CRLF}`, 'utf8'));
-      
+
       formData = Buffer.concat(bufferParts);
       headers['content-type'] = `multipart/form-data; boundary=${boundary}`;
     } else {
       // Browser: Use native FormData
       formData = new FormData();
-      
+
       // Add all files
       for (const { file, fileName } of fileArray) {
         formData.append('files', file, fileName);
       }
-      
+
       // Add optional parameters
       if (classification) formData.append('classification', classification);
       if (expireAfter) formData.append('expireAfter', expireAfter);
-      if (isPublic !== undefined) formData.append('isPublic', isPublic.toString());
+      if (isPublic !== undefined)
+        formData.append('isPublic', isPublic.toString());
       if (metadata) formData.append('metadata', JSON.stringify(metadata));
     }
 
@@ -344,12 +399,13 @@ export class StorageService {
     return await this.sdk._fetch('/storage/upload', 'POST', params, true);
   }
 
-  async getFile(storageId, download = false) {
+  async getFile(storageId, path, download = false) {
     this.sdk.validateParams(
-      { storageId },
+      { storageId, path },
       {
-        storageId: { type: 'string', required: true },
+        storageId: { type: 'string', required: false },
         download: { type: 'boolean', required: false },
+        path: { type: 'string', require: false },
       },
     );
 
@@ -358,11 +414,12 @@ export class StorageService {
       params.query = { download: 'true' };
     }
 
-    const result = await this.sdk._fetch(
-      `/storage/file/${storageId}`,
-      'GET',
-      params,
-    );
+    let url = `/storage/${storageId}`;
+    if (path) {
+      url += `/storage/${path.startsWith('/') ? path.slice(1) : path}`;
+    }
+
+    const result = await this.sdk._fetch(url, 'GET', params);
     return result;
   }
 
@@ -432,7 +489,12 @@ export class StorageService {
     formFields.push(['classification', classification]);
 
     // Use the correct profile image endpoint with proper FormData
-    return this._performUpload(file, fileName || 'profile-image.jpg', formFields, '/storage/upload-profile-image');
+    return this._performUpload(
+      file,
+      fileName || 'profile-image.jpg',
+      formFields,
+      '/storage/upload-profile-image',
+    );
   }
 
   async getFileInfo(storageId) {