flowscale 1.0.14 → 1.0.16

package/README.md

@@ -1,6 +1,25 @@
 # Flowscale Node.js SDK
 
-A comprehensive Node.js SDK designed to simplify interaction with the FlowScale ComfyUI API. This library abstracts away the complexities of API calls, enabling you to effortlessly invoke workflows, retrieve outputs, manage workflow runs, and monitor system health.
+A comprehensive SDK designed to simplify interaction with the FlowScale ComfyUI API. This library works in both Node.js and browser environments.
+
+---
+
+## ⚠️ Important Security Notice for Browser Usage
+
+When using this SDK in a browser environment, your API key will be exposed to end users. This is a significant security risk. We strongly recommend:
+
+1. Using this SDK in a Node.js backend environment
+2. Creating a proxy API that securely handles the API key server-side
+
+If you understand the risks and still need to use the SDK directly in the browser, you must explicitly acknowledge this by setting the `allowDangerouslyExposeApiKey` option:
+
+```javascript
+const flowscale = new FlowscaleAPI({
+  apiKey: 'your-api-key',
+  baseUrl: 'your-api-url',
+  allowDangerouslyExposeApiKey: false // Only set to true if you understand the security risks
+});
+```
 
 ---
 
@@ -29,18 +48,35 @@ To get started, import the Flowscale SDK into your project:
 ```javascript
 import { FlowscaleAPI } from 'flowscale';
 
-// Initialize the SDK
+// Node.js Environment (Recommended)
 const apiKey = process.env.FLOWSCALE_API_KEY;
 const apiUrl = process.env.FLOWSCALE_API_URL;
 
-if (!apiKey || !apiUrl) {
-  console.error('FLOWSCALE_API_KEY or FLOWSCALE_API_URL not set in .env');
-  process.exit(1);
-}
-
-const flowscale = new FlowscaleAPI(apiKey, apiUrl);
+const flowscale = new FlowscaleAPI({
+  apiKey,
+  baseUrl: apiUrl
+});
+
+// Browser Environment (Not Recommended)
+const flowscale = new FlowscaleAPI({
+  apiKey: 'your-api-key', // ⚠️ WARNING: This will be exposed to users
+  baseUrl: 'https://your-api-url.pod.flowscale.ai',
+  allowDangerouslyExposeApiKey: true // Explicitly acknowledge the security risk
+});
 ```
 
+### Environment-Specific Considerations
+
+#### Node.js (Recommended)
+- Store API keys in environment variables
+- Use `.env` files for configuration
+- Full access to all SDK features
+
+#### Browser
+- API key will be visible in network requests
+- Supports File/Blob uploads directly from browser
+- Consider implementing a backend proxy instead
+
 **Environment Variables:** Add the following to your `.env` file:
 
 ```plaintext

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { HealthCheckResponse, QueueResponse, ExecuteWorkflowResponse, GetOutputResponse, RunDetailResponse, RunListResponse, CancelRunResponse } from './types';
+import { HealthCheckResponse, QueueResponse, ExecuteWorkflowResponse, GetOutputResponse, RunDetailResponse, RunListResponse, CancelRunResponse, FlowscaleConfig } from './types';
 export declare class FlowscaleAPI {
     private apiKey;
     private baseUrl;
     private client;
-    constructor(apiKey: string, baseUrl: string);
+    private isNode;
+    constructor(config: FlowscaleConfig);
     /**
      * Checks the health status of all ComfyUI instances within the specified cluster.
      */

package/dist/index.js

@@ -1,15 +1,4 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -52,14 +41,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowscaleAPI = void 0;
 var axios_1 = __importDefault(require("axios"));
-var form_data_1 = __importDefault(require("form-data"));
-var fs_1 = __importDefault(require("fs"));
-var path_1 = __importDefault(require("path"));
 var FlowscaleAPI = /** @class */ (function () {
-    function FlowscaleAPI(apiKey, baseUrl) {
+    function FlowscaleAPI(config) {
         var _this = this;
-        this.apiKey = apiKey;
-        this.baseUrl = baseUrl;
+        // Check if we're in a Node.js environment
+        this.isNode = typeof process !== 'undefined' &&
+            process.versions != null &&
+            process.versions.node != null;
+        // Warn about API key exposure in browser environment
+        if (!this.isNode && !config.allowDangerouslyExposeApiKey) {
+            throw new Error('WARNING: Using FlowscaleAPI in a browser environment will expose your API key to end users. ' +
+                'This is a security risk. If you understand the risks and still want to proceed, ' +
+                'set allowDangerouslyExposeApiKey to true. ' +
+                'We strongly recommend using a backend proxy instead.');
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl;
         this.client = axios_1.default.create({
             baseURL: this.baseUrl,
         });
@@ -132,7 +129,7 @@ var FlowscaleAPI = /** @class */ (function () {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 2, , 3]);
-                        formData_1 = new form_data_1.default();
+                        formData_1 = new FormData();
                         _loop_1 = function (key) {
                             if (data.hasOwnProperty(key)) {
                                 var value = data[key];
@@ -152,7 +149,10 @@ var FlowscaleAPI = /** @class */ (function () {
                         for (key in data) {
                             _loop_1(key);
                         }
-                        headers = __assign(__assign({}, formData_1.getHeaders()), { 'X-API-KEY': this.apiKey });
+                        headers = {
+                            'Content-Type': 'multipart/form-data',
+                            'X-API-KEY': this.apiKey,
+                        };
                         url = "/api/v1/runs?workflow_id=".concat(encodeURIComponent(workflowId)).concat(groupId ? "&group_id=".concat(encodeURIComponent(groupId)) : '');
                         return [4 /*yield*/, this.client.post(url, formData_1, { headers: headers })];
                     case 1:
@@ -333,21 +333,16 @@ var FlowscaleAPI = /** @class */ (function () {
      * Helper method to append data to FormData.
      */
     FlowscaleAPI.prototype.appendFormData = function (formData, key, value) {
-        if (value instanceof fs_1.default.ReadStream) {
-            // It's a file stream
+        if (value instanceof Blob || value instanceof File) {
+            // Handle File and Blob objects directly
             formData.append(key, value);
         }
-        else if (Buffer.isBuffer(value)) {
-            // It's a Buffer
-            formData.append(key, value, { filename: "".concat(key, ".dat") });
-        }
-        else if (typeof value === 'string' && fs_1.default.existsSync(value)) {
-            // If the value is a file path
-            var fileName = path_1.default.basename(value);
-            formData.append(key, fs_1.default.createReadStream(value), fileName);
+        else if (typeof value === 'object' && value !== null) {
+            // Handle plain objects by stringifying
+            formData.append(key, JSON.stringify(value));
         }
         else {
-            // Assume it's a string or other value
+            // Handle primitive values
             formData.append(key, value);
         }
     };

package/dist/types.d.ts

@@ -70,3 +70,8 @@ export interface ErrorResponse {
     status: string;
     errors: string;
 }
+export interface FlowscaleConfig {
+    apiKey: string;
+    baseUrl: string;
+    allowDangerouslyExposeApiKey?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowscale",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "An NPM library for communicating with the Flowscale APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",