wolfronix-sdk 1.1.0 → 1.2.0

package/README.md

@@ -16,6 +16,17 @@ Official JavaScript/TypeScript SDK for Wolfronix - Zero-knowledge encryption mad
 - ⚡ **Streaming** - Handle large files with progress tracking
 - 🔄 **Auto Retry** - Built-in retry logic with exponential backoff
 
+## Backend Integration (Enterprise Mode)
+
+To use this SDK, your backend API must implement 3 storage endpoints that Wolfronix will call:
+
+1.  **POST** `/wolfronix/files/upload` - Store encrypted file + metadata
+2.  **GET** `/wolfronix/files/{id}` - Retrieve metadata
+3.  **GET** `/wolfronix/files/{id}/data` - Retrieve encrypted file blob
+
+Wolfronix handles all encryption/decryption keys and logic; you only handle the encrypted blobs.
+
+
 ## Installation
 
 ```bash
@@ -37,7 +48,10 @@ const wfx = new Wolfronix({
   clientId: 'your-enterprise-client-id'
 });
 
-// Login
+// Register (First time only) - Generates keys client-side
+await wfx.register('user@example.com', 'password123');
+
+// Login (Subsequent visits)
 await wfx.login('user@example.com', 'password123');
 
 // Encrypt a file

package/dist/index.d.mts

@@ -3,7 +3,7 @@
  * Zero-knowledge encryption made simple
  *
  * @package @wolfronix/sdk
- * @version 1.1.0
+ * @version 1.2.0
  */
 interface WolfronixConfig {
     /** Wolfronix server base URL */
@@ -24,11 +24,10 @@ interface AuthResponse {
     message: string;
 }
 interface EncryptResponse {
-    success: boolean;
-    file_id: string;
-    original_name: string;
-    encrypted_size: number;
-    message: string;
+    status: string;
+    file_id: number;
+    file_size: number;
+    enc_time_ms: number;
 }
 interface FileInfo {
     file_id: string;
@@ -52,10 +51,6 @@ interface MetricsResponse {
     total_bytes_encrypted: number;
     total_bytes_decrypted: number;
 }
-interface StreamToken {
-    token: string;
-    expires_at: string;
-}
 declare class WolfronixError extends Error {
     readonly code: string;
     readonly statusCode?: number;
@@ -155,17 +150,6 @@ declare class Wolfronix {
      * ```
      */
     encrypt(file: File | Blob | ArrayBuffer | Uint8Array, filename?: string): Promise<EncryptResponse>;
-    /**
-     * Encrypt a file using streaming (for large files)
-     *
-     * @example
-     * ```typescript
-     * const result = await wfx.encryptStream(largeFile, (progress) => {
-     *   console.log(`Progress: ${progress}%`);
-     * });
-     * ```
-     */
-    encryptStream(file: File | Blob, onProgress?: (percent: number) => void): Promise<EncryptResponse>;
     /**
      * Decrypt and retrieve a file
      *
@@ -185,10 +169,6 @@ declare class Wolfronix {
      * Decrypt and return as ArrayBuffer
      */
     decryptToBuffer(fileId: string): Promise<ArrayBuffer>;
-    /**
-     * Decrypt using streaming (for large files)
-     */
-    decryptStream(fileId: string, onProgress?: (percent: number) => void): Promise<Blob>;
     /**
      * List all encrypted files for current user
      *
@@ -238,4 +218,4 @@ declare class Wolfronix {
  */
 declare function createClient(config: WolfronixConfig | string): Wolfronix;
 
-export { type AuthResponse, AuthenticationError, type DeleteResponse, type EncryptResponse, type FileInfo, FileNotFoundError, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, type StreamToken, ValidationError, Wolfronix, type WolfronixConfig, WolfronixError, createClient, Wolfronix as default };
+export { type AuthResponse, AuthenticationError, type DeleteResponse, type EncryptResponse, type FileInfo, FileNotFoundError, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, ValidationError, Wolfronix, type WolfronixConfig, WolfronixError, createClient, Wolfronix as default };

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * Zero-knowledge encryption made simple
  *
  * @package @wolfronix/sdk
- * @version 1.1.0
+ * @version 1.2.0
  */
 interface WolfronixConfig {
     /** Wolfronix server base URL */
@@ -24,11 +24,10 @@ interface AuthResponse {
     message: string;
 }
 interface EncryptResponse {
-    success: boolean;
-    file_id: string;
-    original_name: string;
-    encrypted_size: number;
-    message: string;
+    status: string;
+    file_id: number;
+    file_size: number;
+    enc_time_ms: number;
 }
 interface FileInfo {
     file_id: string;
@@ -52,10 +51,6 @@ interface MetricsResponse {
     total_bytes_encrypted: number;
     total_bytes_decrypted: number;
 }
-interface StreamToken {
-    token: string;
-    expires_at: string;
-}
 declare class WolfronixError extends Error {
     readonly code: string;
     readonly statusCode?: number;
@@ -155,17 +150,6 @@ declare class Wolfronix {
      * ```
      */
     encrypt(file: File | Blob | ArrayBuffer | Uint8Array, filename?: string): Promise<EncryptResponse>;
-    /**
-     * Encrypt a file using streaming (for large files)
-     *
-     * @example
-     * ```typescript
-     * const result = await wfx.encryptStream(largeFile, (progress) => {
-     *   console.log(`Progress: ${progress}%`);
-     * });
-     * ```
-     */
-    encryptStream(file: File | Blob, onProgress?: (percent: number) => void): Promise<EncryptResponse>;
     /**
      * Decrypt and retrieve a file
      *
@@ -185,10 +169,6 @@ declare class Wolfronix {
      * Decrypt and return as ArrayBuffer
      */
     decryptToBuffer(fileId: string): Promise<ArrayBuffer>;
-    /**
-     * Decrypt using streaming (for large files)
-     */
-    decryptStream(fileId: string, onProgress?: (percent: number) => void): Promise<Blob>;
     /**
      * List all encrypted files for current user
      *
@@ -238,4 +218,4 @@ declare class Wolfronix {
  */
 declare function createClient(config: WolfronixConfig | string): Wolfronix;
 
-export { type AuthResponse, AuthenticationError, type DeleteResponse, type EncryptResponse, type FileInfo, FileNotFoundError, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, type StreamToken, ValidationError, Wolfronix, type WolfronixConfig, WolfronixError, createClient, Wolfronix as default };
+export { type AuthResponse, AuthenticationError, type DeleteResponse, type EncryptResponse, type FileInfo, FileNotFoundError, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, ValidationError, Wolfronix, type WolfronixConfig, WolfronixError, createClient, Wolfronix as default };

package/dist/index.js

@@ -261,6 +261,9 @@ var Wolfronix = class {
     }
     if (includeAuth && this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
+      if (this.userId) {
+        headers["X-User-ID"] = this.userId;
+      }
     }
     return headers;
   }
@@ -493,57 +496,6 @@ var Wolfronix = class {
       formData
     });
   }
-  /**
-   * Encrypt a file using streaming (for large files)
-   * 
-   * @example
-   * ```typescript
-   * const result = await wfx.encryptStream(largeFile, (progress) => {
-   *   console.log(`Progress: ${progress}%`);
-   * });
-   * ```
-   */
-  async encryptStream(file, onProgress) {
-    this.ensureAuthenticated();
-    const tokenResponse = await this.request("POST", "/api/v1/stream/token", {
-      body: {
-        user_id: this.userId,
-        client_id: this.config.clientId
-      }
-    });
-    const formData = new FormData();
-    formData.append("file", file);
-    formData.append("user_id", this.userId || "");
-    formData.append("stream_token", tokenResponse.token);
-    if (onProgress && typeof XMLHttpRequest !== "undefined") {
-      return new Promise((resolve, reject) => {
-        const xhr = new XMLHttpRequest();
-        xhr.upload.onprogress = (event) => {
-          if (event.lengthComputable) {
-            onProgress(Math.round(event.loaded / event.total * 100));
-          }
-        };
-        xhr.onload = () => {
-          if (xhr.status >= 200 && xhr.status < 300) {
-            resolve(JSON.parse(xhr.responseText));
-          } else {
-            reject(new WolfronixError("Upload failed", "UPLOAD_ERROR", xhr.status));
-          }
-        };
-        xhr.onerror = () => reject(new NetworkError("Upload failed"));
-        xhr.open("POST", `${this.config.baseUrl}/api/v1/stream/encrypt`);
-        const headers = this.getHeaders();
-        Object.entries(headers).forEach(([key, value]) => {
-          xhr.setRequestHeader(key, value);
-        });
-        xhr.send(formData);
-      });
-    }
-    return this.request("POST", "/api/v1/stream/encrypt", {
-      formData
-      // Stream endpoint might need update to accept public key too if re-implemented
-    });
-  }
   /**
    * Decrypt and retrieve a file
    * 
@@ -567,9 +519,6 @@ var Wolfronix = class {
       throw new Error("Private key not available. Is user logged in?");
     }
     const privateKeyPEM = await exportKeyToPEM(this.privateKey, "private");
-    const headers = this.getHeaders();
-    headers["X-Private-Key"] = privateKeyPEM;
-    headers["X-User-Role"] = "owner";
     return this.request("POST", `/api/v1/files/${fileId}/decrypt`, {
       responseType: "blob",
       headers: {
@@ -598,51 +547,6 @@ var Wolfronix = class {
       }
     });
   }
-  /**
-   * Decrypt using streaming (for large files)
-   */
-  async decryptStream(fileId, onProgress) {
-    this.ensureAuthenticated();
-    if (!fileId) {
-      throw new ValidationError("File ID is required");
-    }
-    if (!this.privateKey) {
-      throw new Error("Private key not available. Is user logged in?");
-    }
-    const privateKeyPEM = await exportKeyToPEM(this.privateKey, "private");
-    if (onProgress && typeof XMLHttpRequest !== "undefined") {
-      return new Promise((resolve, reject) => {
-        const xhr = new XMLHttpRequest();
-        xhr.responseType = "blob";
-        xhr.onprogress = (event) => {
-          if (event.lengthComputable) {
-            onProgress(Math.round(event.loaded / event.total * 100));
-          }
-        };
-        xhr.onload = () => {
-          if (xhr.status >= 200 && xhr.status < 300) {
-            resolve(xhr.response);
-          } else {
-            reject(new WolfronixError("Download failed", "DOWNLOAD_ERROR", xhr.status));
-          }
-        };
-        xhr.onerror = () => reject(new NetworkError("Download failed"));
-        xhr.open("POST", `${this.config.baseUrl}/api/v1/files/${fileId}/decrypt`);
-        const headers = { ...this.getHeaders(), "X-Private-Key": privateKeyPEM, "X-User-Role": "owner" };
-        Object.entries(headers).forEach(([key, value]) => {
-          xhr.setRequestHeader(key, value);
-        });
-        xhr.send();
-      });
-    }
-    return this.request("POST", `/api/v1/files/${fileId}/decrypt`, {
-      responseType: "blob",
-      headers: {
-        "X-Private-Key": privateKeyPEM,
-        "X-User-Role": "owner"
-      }
-    });
-  }
   /**
    * List all encrypted files for current user
    * 
@@ -654,7 +558,17 @@ var Wolfronix = class {
    */
   async listFiles() {
     this.ensureAuthenticated();
-    return this.request("GET", "/api/v1/files");
+    const files = await this.request("GET", "/api/v1/files");
+    return {
+      success: true,
+      files: (files || []).map((f) => ({
+        file_id: f.id,
+        original_name: f.name,
+        encrypted_size: f.size_bytes,
+        created_at: f.date
+      })),
+      total: (files || []).length
+    };
   }
   /**
    * Delete an encrypted file
@@ -685,7 +599,7 @@ var Wolfronix = class {
    */
   async getMetrics() {
     this.ensureAuthenticated();
-    return this.request("GET", "/api/v1/metrics");
+    return this.request("GET", "/api/v1/metrics/summary");
   }
   /**
    * Check if server is healthy

package/dist/index.mjs

@@ -227,6 +227,9 @@ var Wolfronix = class {
     }
     if (includeAuth && this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
+      if (this.userId) {
+        headers["X-User-ID"] = this.userId;
+      }
     }
     return headers;
   }
@@ -459,57 +462,6 @@ var Wolfronix = class {
       formData
     });
   }
-  /**
-   * Encrypt a file using streaming (for large files)
-   * 
-   * @example
-   * ```typescript
-   * const result = await wfx.encryptStream(largeFile, (progress) => {
-   *   console.log(`Progress: ${progress}%`);
-   * });
-   * ```
-   */
-  async encryptStream(file, onProgress) {
-    this.ensureAuthenticated();
-    const tokenResponse = await this.request("POST", "/api/v1/stream/token", {
-      body: {
-        user_id: this.userId,
-        client_id: this.config.clientId
-      }
-    });
-    const formData = new FormData();
-    formData.append("file", file);
-    formData.append("user_id", this.userId || "");
-    formData.append("stream_token", tokenResponse.token);
-    if (onProgress && typeof XMLHttpRequest !== "undefined") {
-      return new Promise((resolve, reject) => {
-        const xhr = new XMLHttpRequest();
-        xhr.upload.onprogress = (event) => {
-          if (event.lengthComputable) {
-            onProgress(Math.round(event.loaded / event.total * 100));
-          }
-        };
-        xhr.onload = () => {
-          if (xhr.status >= 200 && xhr.status < 300) {
-            resolve(JSON.parse(xhr.responseText));
-          } else {
-            reject(new WolfronixError("Upload failed", "UPLOAD_ERROR", xhr.status));
-          }
-        };
-        xhr.onerror = () => reject(new NetworkError("Upload failed"));
-        xhr.open("POST", `${this.config.baseUrl}/api/v1/stream/encrypt`);
-        const headers = this.getHeaders();
-        Object.entries(headers).forEach(([key, value]) => {
-          xhr.setRequestHeader(key, value);
-        });
-        xhr.send(formData);
-      });
-    }
-    return this.request("POST", "/api/v1/stream/encrypt", {
-      formData
-      // Stream endpoint might need update to accept public key too if re-implemented
-    });
-  }
   /**
    * Decrypt and retrieve a file
    * 
@@ -533,9 +485,6 @@ var Wolfronix = class {
       throw new Error("Private key not available. Is user logged in?");
     }
     const privateKeyPEM = await exportKeyToPEM(this.privateKey, "private");
-    const headers = this.getHeaders();
-    headers["X-Private-Key"] = privateKeyPEM;
-    headers["X-User-Role"] = "owner";
     return this.request("POST", `/api/v1/files/${fileId}/decrypt`, {
       responseType: "blob",
       headers: {
@@ -564,51 +513,6 @@ var Wolfronix = class {
       }
     });
   }
-  /**
-   * Decrypt using streaming (for large files)
-   */
-  async decryptStream(fileId, onProgress) {
-    this.ensureAuthenticated();
-    if (!fileId) {
-      throw new ValidationError("File ID is required");
-    }
-    if (!this.privateKey) {
-      throw new Error("Private key not available. Is user logged in?");
-    }
-    const privateKeyPEM = await exportKeyToPEM(this.privateKey, "private");
-    if (onProgress && typeof XMLHttpRequest !== "undefined") {
-      return new Promise((resolve, reject) => {
-        const xhr = new XMLHttpRequest();
-        xhr.responseType = "blob";
-        xhr.onprogress = (event) => {
-          if (event.lengthComputable) {
-            onProgress(Math.round(event.loaded / event.total * 100));
-          }
-        };
-        xhr.onload = () => {
-          if (xhr.status >= 200 && xhr.status < 300) {
-            resolve(xhr.response);
-          } else {
-            reject(new WolfronixError("Download failed", "DOWNLOAD_ERROR", xhr.status));
-          }
-        };
-        xhr.onerror = () => reject(new NetworkError("Download failed"));
-        xhr.open("POST", `${this.config.baseUrl}/api/v1/files/${fileId}/decrypt`);
-        const headers = { ...this.getHeaders(), "X-Private-Key": privateKeyPEM, "X-User-Role": "owner" };
-        Object.entries(headers).forEach(([key, value]) => {
-          xhr.setRequestHeader(key, value);
-        });
-        xhr.send();
-      });
-    }
-    return this.request("POST", `/api/v1/files/${fileId}/decrypt`, {
-      responseType: "blob",
-      headers: {
-        "X-Private-Key": privateKeyPEM,
-        "X-User-Role": "owner"
-      }
-    });
-  }
   /**
    * List all encrypted files for current user
    * 
@@ -620,7 +524,17 @@ var Wolfronix = class {
    */
   async listFiles() {
     this.ensureAuthenticated();
-    return this.request("GET", "/api/v1/files");
+    const files = await this.request("GET", "/api/v1/files");
+    return {
+      success: true,
+      files: (files || []).map((f) => ({
+        file_id: f.id,
+        original_name: f.name,
+        encrypted_size: f.size_bytes,
+        created_at: f.date
+      })),
+      total: (files || []).length
+    };
   }
   /**
    * Delete an encrypted file
@@ -651,7 +565,7 @@ var Wolfronix = class {
    */
   async getMetrics() {
     this.ensureAuthenticated();
-    return this.request("GET", "/api/v1/metrics");
+    return this.request("GET", "/api/v1/metrics/summary");
   }
   /**
    * Check if server is healthy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfronix-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Official Wolfronix SDK for JavaScript/TypeScript - Zero-knowledge encryption made simple",
   "main": "dist/index.js",
   "module": "dist/index.mjs",