shogun-relay-sdk 1.2.3 → 1.2.5

package/dist/modules/ipfs.d.ts

@@ -4,7 +4,28 @@ export declare class IpfsModule {
     constructor(client: ApiClient);
     getStatus(): Promise<any>;
     uploadFile(fileBuffer: Buffer, filename: string, contentType: string, userAddress?: string): Promise<any>;
+    /**
+     * Upload multiple files as a directory to IPFS
+     * Maintains directory structure using relative paths
+     *
+     * @param files Array of file objects with buffer, filename, path, and contentType
+     * @param userAddress Optional user address for authentication
+     * @returns Promise with directory CID and file information
+     */
+    uploadDirectory(files: Array<{
+        buffer: Buffer;
+        filename: string;
+        path: string;
+        contentType?: string;
+    }>, userAddress?: string): Promise<any>;
     cat(cid: string): Promise<Buffer>;
+    /**
+     * Cat a file from an IPFS directory using a relative path
+     * @param directoryCid The CID of the directory
+     * @param filePath The relative path to the file within the directory (e.g., "index.html" or "css/style.css")
+     * @returns Promise with file content as Buffer
+     */
+    catFromDirectory(directoryCid: string, filePath: string): Promise<Buffer>;
     pinAdd(cid: string): Promise<any>;
     pinRm(cid: string): Promise<any>;
     pinLs(): Promise<any>;

package/dist/modules/ipfs.js

@@ -26,11 +26,54 @@ class IpfsModule {
             headers: headers,
         });
     }
+    /**
+     * Upload multiple files as a directory to IPFS
+     * Maintains directory structure using relative paths
+     *
+     * @param files Array of file objects with buffer, filename, path, and contentType
+     * @param userAddress Optional user address for authentication
+     * @returns Promise with directory CID and file information
+     */
+    async uploadDirectory(files, userAddress) {
+        if (!files || files.length === 0) {
+            throw new Error("At least one file is required for directory upload");
+        }
+        const form = new form_data_1.default();
+        // Add all files to FormData maintaining directory structure
+        files.forEach((file) => {
+            form.append("files", file.buffer, {
+                filename: file.path, // Use path to maintain directory structure
+                contentType: file.contentType || "application/octet-stream",
+            });
+        });
+        const headers = form.getHeaders();
+        if (userAddress) {
+            headers["x-user-address"] = userAddress;
+        }
+        return this.client.post("/api/v1/ipfs/upload-directory", form, {
+            headers: headers,
+        });
+    }
     async cat(cid) {
         return this.client.get(`/api/v1/ipfs/cat/${cid}`, {
             responseType: "arraybuffer",
         });
     }
+    /**
+     * Cat a file from an IPFS directory using a relative path
+     * @param directoryCid The CID of the directory
+     * @param filePath The relative path to the file within the directory (e.g., "index.html" or "css/style.css")
+     * @returns Promise with file content as Buffer
+     */
+    async catFromDirectory(directoryCid, filePath) {
+        const fullPath = `${directoryCid}/${filePath}`;
+        return this.client.post(`/api/v1/ipfs/api/v0/cat?arg=${encodeURIComponent(fullPath)}`, null, {
+            responseType: "arraybuffer",
+            headers: {
+                "Content-Length": "0",
+            },
+        });
+    }
     async pinAdd(cid) {
         return this.client.post("/api/v1/ipfs/pin/add", { cid });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shogun-relay-sdk",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "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",