shogun-relay-sdk 1.2.8 → 1.2.10

package/dist/client.js

@@ -20,6 +20,10 @@ class ApiClient {
             if (this.config.token) {
                 req.headers["Authorization"] = `Bearer ${this.config.token}`;
             }
+            // If data is FormData, remove Content-Type header to let browser set it with boundary
+            if (req.data instanceof FormData) {
+                delete req.headers["Content-Type"];
+            }
             return req;
         });
     }

package/dist/modules/ipfs.d.ts

@@ -1,6 +1,6 @@
 import { ApiClient } from "../client";
 export declare class IpfsModule {
-    private client;
+    private readonly client;
     constructor(client: ApiClient);
     getStatus(): Promise<any>;
     uploadFile(fileBuffer: Buffer, filename: string, contentType: string, userAddress?: string): Promise<any>;
@@ -34,4 +34,33 @@ export declare class IpfsModule {
     repoGC(): Promise<any>;
     repoStat(): Promise<any>;
     getVersion(): Promise<any>;
+    /**
+     * Upload a file using browser FormData (for browser environments)
+     * @param file File object from browser File API
+     * @param userAddress Optional user address for authentication
+     * @returns Promise with upload result
+     */
+    uploadFileBrowser(file: File, userAddress?: string): Promise<any>;
+    /**
+     * Upload multiple files as a directory using browser FormData (for browser environments)
+     * Maintains directory structure using relative paths from File.webkitRelativePath or file.name
+     *
+     * @param files Array of File objects from browser File API
+     * @param userAddress Optional user address for authentication
+     * @returns Promise with directory CID and file information
+     */
+    uploadDirectoryBrowser(files: File[], userAddress?: string): Promise<any>;
+    /**
+     * Cat a file and return as Blob (for browser environments)
+     * @param cid The CID of the file
+     * @returns Promise with file content as Blob
+     */
+    catBlob(cid: string): Promise<Blob>;
+    /**
+     * Cat a file from directory and return as Blob (for browser environments)
+     * @param directoryCid The CID of the directory
+     * @param filePath The relative path to the file within the directory
+     * @returns Promise with file content as Blob
+     */
+    catFromDirectoryBlob(directoryCid: string, filePath: string): Promise<Blob>;
 }

package/dist/modules/ipfs.js

@@ -71,8 +71,11 @@ class IpfsModule {
         // Format: /api/v0/cat?arg=QmDirectory/index.html
         const fullPath = `${directoryCid}/${filePath}`;
         // Encode only the CID part, keep slashes for navigation
-        const encodedPath = fullPath.includes('/')
-            ? `${encodeURIComponent(directoryCid)}/${filePath.split('/').map(p => encodeURIComponent(p)).join('/')}`
+        const encodedPath = fullPath.includes("/")
+            ? `${encodeURIComponent(directoryCid)}/${filePath
+                .split("/")
+                .map((p) => encodeURIComponent(p))
+                .join("/")}`
             : encodeURIComponent(fullPath);
         // Use GET instead of POST, or send empty string instead of null to avoid JSON parser error
         // IPFS API v0 cat accepts POST with empty body, but Express JSON parser fails on null
@@ -118,5 +121,98 @@ class IpfsModule {
     async getVersion() {
         return this.client.get("/api/v1/ipfs/version");
     }
+    /**
+     * Upload a file using browser FormData (for browser environments)
+     * @param file File object from browser File API
+     * @param userAddress Optional user address for authentication
+     * @returns Promise with upload result
+     */
+    async uploadFileBrowser(file, userAddress) {
+        const formData = new form_data_1.default();
+        formData.append("file", file, file.name);
+        const headers = {};
+        if (userAddress) {
+            headers["x-user-address"] = userAddress;
+        }
+        // Explicitly don't set Content-Type - let browser set it with boundary for FormData
+        return this.client.post("/api/v1/ipfs/upload", formData, {
+            headers: headers,
+            // Ensure axios doesn't serialize FormData as JSON
+            transformRequest: [(data) => {
+                    // If it's FormData, return as-is (axios will handle it)
+                    if (data instanceof form_data_1.default) {
+                        return data;
+                    }
+                    return data;
+                }],
+        });
+    }
+    /**
+     * Upload multiple files as a directory using browser FormData (for browser environments)
+     * Maintains directory structure using relative paths from File.webkitRelativePath or file.name
+     *
+     * @param files Array of File objects from browser File API
+     * @param userAddress Optional user address for authentication
+     * @returns Promise with directory CID and file information
+     */
+    async uploadDirectoryBrowser(files, userAddress) {
+        if (!files || files.length === 0) {
+            throw new Error("At least one file is required for directory upload");
+        }
+        const formData = new form_data_1.default();
+        // Add all files to FormData maintaining directory structure
+        files.forEach((file) => {
+            // Use webkitRelativePath if available (from folder input), otherwise use file.name
+            const relativePath = file.webkitRelativePath || file.name;
+            formData.append("files", file, relativePath);
+        });
+        const headers = {};
+        if (userAddress) {
+            headers["x-user-address"] = userAddress;
+        }
+        // Explicitly don't set Content-Type - let browser set it with boundary for FormData
+        return this.client.post("/api/v1/ipfs/upload-directory", formData, {
+            headers: headers,
+            // Ensure axios doesn't serialize FormData as JSON
+            transformRequest: [(data) => {
+                    // If it's FormData, return as-is (axios will handle it)
+                    if (data instanceof form_data_1.default) {
+                        return data;
+                    }
+                    return data;
+                }],
+        });
+    }
+    /**
+     * Cat a file and return as Blob (for browser environments)
+     * @param cid The CID of the file
+     * @returns Promise with file content as Blob
+     */
+    async catBlob(cid) {
+        return this.client.get(`/api/v1/ipfs/cat/${cid}`, {
+            responseType: "blob",
+        });
+    }
+    /**
+     * Cat a file from directory and return as Blob (for browser environments)
+     * @param directoryCid The CID of the directory
+     * @param filePath The relative path to the file within the directory
+     * @returns Promise with file content as Blob
+     */
+    async catFromDirectoryBlob(directoryCid, filePath) {
+        const fullPath = `${directoryCid}/${filePath}`;
+        const encodedPath = fullPath.includes("/")
+            ? `${encodeURIComponent(directoryCid)}/${filePath
+                .split("/")
+                .map((p) => encodeURIComponent(p))
+                .join("/")}`
+            : encodeURIComponent(fullPath);
+        return this.client.post(`/api/v1/ipfs/api/v0/cat?arg=${encodedPath}`, "", {
+            responseType: "blob",
+            headers: {
+                "Content-Type": "application/octet-stream",
+            },
+        });
+    }
 }
 exports.IpfsModule = IpfsModule;

package/dist/modules/system.d.ts

@@ -9,8 +9,13 @@ export interface HealthResponse {
     };
 }
 export declare class SystemModule {
-    private client;
+    private readonly client;
     constructor(client: ApiClient);
     getHealth(): Promise<HealthResponse>;
     getStats(): Promise<any>;
+    /**
+     * Simple health check endpoint
+     * @returns Promise with health status
+     */
+    health(): Promise<any>;
 }

package/dist/modules/system.js

@@ -12,5 +12,12 @@ class SystemModule {
     async getStats() {
         return this.client.get("/api/v1/system/stats");
     }
+    /**
+     * Simple health check endpoint
+     * @returns Promise with health status
+     */
+    async health() {
+        return this.client.get("/health");
+    }
 }
 exports.SystemModule = SystemModule;

package/dist/modules/uploads.d.ts

@@ -5,4 +5,45 @@ export declare class UploadsModule {
     getUserUploads(identifier: string): Promise<any>;
     deleteUpload(identifier: string, hash: string): Promise<any>;
     getSystemHashes(): Promise<any>;
+    /**
+     * Get the complete system hashes map with metadata for all files
+     * @returns Promise with system hashes map object
+     */
+    getSystemHashesMap(): Promise<any>;
+    /**
+     * Save file metadata to system hash map
+     * @param metadata Metadata object containing hash, userAddress, fileName, etc.
+     * @returns Promise with save result
+     */
+    saveSystemHash(metadata: {
+        hash: string;
+        userAddress?: string;
+        fileName?: string;
+        displayName?: string;
+        originalName?: string;
+        fileSize?: number;
+        contentType?: string;
+        isEncrypted?: boolean;
+        isDirectory?: boolean;
+        fileCount?: number;
+        files?: Array<{
+            name: string;
+            path?: string;
+            size?: number;
+            mimetype?: string;
+            originalName?: string;
+            isEncrypted?: boolean;
+        }>;
+        relayUrl?: string;
+        uploadedAt?: number;
+        timestamp?: number;
+        [key: string]: any;
+    }): Promise<any>;
+    /**
+     * Remove a hash from system hash map
+     * @param cid The CID/hash to remove
+     * @param userAddress User address (defaults to "drive-user")
+     * @returns Promise with removal result
+     */
+    removeSystemHash(cid: string, userAddress?: string): Promise<any>;
 }

package/dist/modules/uploads.js

@@ -14,5 +14,34 @@ class UploadsModule {
     async getSystemHashes() {
         return this.client.get("/api/v1/user-uploads/system-hashes");
     }
+    /**
+     * Get the complete system hashes map with metadata for all files
+     * @returns Promise with system hashes map object
+     */
+    async getSystemHashesMap() {
+        return this.client.get("/api/v1/user-uploads/system-hashes-map");
+    }
+    /**
+     * Save file metadata to system hash map
+     * @param metadata Metadata object containing hash, userAddress, fileName, etc.
+     * @returns Promise with save result
+     */
+    async saveSystemHash(metadata) {
+        return this.client.post("/api/v1/user-uploads/save-system-hash", metadata);
+    }
+    /**
+     * Remove a hash from system hash map
+     * @param cid The CID/hash to remove
+     * @param userAddress User address (defaults to "drive-user")
+     * @returns Promise with removal result
+     */
+    async removeSystemHash(cid, userAddress = "drive-user") {
+        return this.client.delete(`/api/v1/user-uploads/remove-system-hash/${cid}`, {
+            data: { userAddress },
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+    }
 }
 exports.UploadsModule = UploadsModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shogun-relay-sdk",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "description": "SDK for interacting with Shogun Relay API - HTTP client for IPFS, deals, registry, and network operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",