flowstride 1.0.14 → 1.0.15

package/README.md

@@ -4,6 +4,8 @@
 
 Flowstride OS combines the human-readable structure of Behavior-Driven Development (BDD) with the raw execution power of Playwright. It allows QA engineers and developers to write robust, maintainable UI and API tests using an intuitive domain-specific language (DSL), while providing a rich, interactive React dashboard to monitor, debug, and replay test runs in real time.
 
+[Documentation](https://docs.flowstride.io/)
+
 ---
 
 ## Why Flowstride?

package/dist/cli/commands/run.js

@@ -97,7 +97,11 @@ async function runAction(targetPath, options) {
         }
     }
     const config = {
-        headless: isCI ? true : (options.headless ?? localConfig.headless ?? true),
+        headless: isCI
+            ? true
+            : options.headed
+                ? false
+                : (localConfig.headless ?? true),
         timeout: localConfig.timeout ?? 30000,
         bail: options.bail ?? localConfig.bail ?? false,
         baseUrl: process.env.BASE_URL ?? localConfig.baseUrl,
@@ -129,15 +133,11 @@ async function runAction(targetPath, options) {
     const pluginManager = new plugin_manager_1.PluginManager(config, web, store, apiProxy);
     const vault = new persistent_vault_1.PersistentVault(root);
     const sessions = new manager_1.SessionManager(web, api, vault);
-    // ==========================================
-    // DYNAMIC ENGINE ROUTER (The Plugin Handoff)
-    // ==========================================
     let ActiveFlowWorker = flow_worker_1.FlowWorker;
     let ActiveFlowOrchestrator = flow_orchestrator_1.FlowOrchestrator;
     let engineMode = "Open Source";
     const proWorkerPath = path.join(process.cwd(), "node_modules", "@flowstride", "pro", "dist", "runner", "flow_worker.js");
     const proOrchPath = path.join(process.cwd(), "node_modules", "@flowstride", "pro", "dist", "runner", "flow_orchestrator.js");
-    // We only attempt to load the Pro Engine if the DRM Bouncer (index.ts) did NOT force OS Mode
     if (!options.forceOS &&
         fs.existsSync(proWorkerPath) &&
         fs.existsSync(proOrchPath)) {
@@ -153,7 +153,6 @@ async function runAction(targetPath, options) {
         }
     }
     console.log(`\n[Engine]: Booting Flowstride in ${engineMode} mode...`);
-    // ==========================================
     const worker = new ActiveFlowWorker(config, web, api, store, sessions, pluginManager);
     const orchestrator = new ActiveFlowOrchestrator(worker, workerCount, config);
     try {

package/dist/cli/index.js

@@ -54,7 +54,7 @@ const API_BASE = process.env.FLOWSTRIDE_API_URL || "https://cloud.flowstride.io"
 program
     .name("flowstride")
     .description("Flowstride: The Enterprise Flow-First Automation CLI")
-    .version("1.0.14");
+    .version("1.0.15");
 program
     .command("init")
     .description("Initialise a new Flowstride workspace in the current directory")
@@ -253,8 +253,8 @@ program
     .command("run [targetPath]")
     .description("Execute all .flow automation journeys in the ./flows directory")
     .option("-b, --bail", "Stop execution on first failure", false)
-    .option("--headed", "Run browser in headed mode", false)
-    .option("--headless <boolean>", "Run browser in headless mode", (val) => val === "true", true)
+    .option("--headed", "Run browser in headed mode")
+    .option("--headless", "Run browser in headless mode")
     .option("--workers <number>", "Number of parallel workers to spawn (Pro feature)")
     .action(async (targetPath, options) => {
     if (typeof targetPath === "object") {

package/dist/parser/parser.js

@@ -357,6 +357,7 @@ class Parser {
                     throw new Error(`Line ${viaToken.line}: Expected 'via'`);
                 payload.verb = this.consume(lexer_1.TokenType.COMMAND, "Expected API verb (e.g. POST)").value.toLowerCase();
                 payload.url = this.consume(lexer_1.TokenType.STRING, "Endpoint URL expected").value;
+                // --- ENSURE ARRAY FORMAT FOR API CLIENT ---
                 payload.headers = [];
                 this.parseApiModifiers(payload);
                 break;
@@ -367,6 +368,7 @@ class Parser {
             case "delete":
             case "graphql":
                 payload.url = this.consume(lexer_1.TokenType.STRING, "Endpoint URL expected").value;
+                // --- ENSURE ARRAY FORMAT FOR API CLIENT ---
                 payload.headers = [];
                 this.parseApiModifiers(payload);
                 break;
@@ -615,9 +617,33 @@ class Parser {
                     throw new Error(`Syntax Error on line ${targetToken.line}: Invalid keyword '${target}'. Flowstride uses strict camelCase. Did you mean 'reqHeader'?`);
                 }
                 if (target === "reqHeader") {
-                    const hKey = this.consume(lexer_1.TokenType.STRING, "Header key expected").value;
-                    const hVal = this.consume(lexer_1.TokenType.STRING, "Header value expected").value;
-                    payload.headers.push({ key: hKey, value: hVal });
+                    // --- THE NEW MULTI-FORMAT HEADER PARSER ---
+                    const firstToken = this.consume(lexer_1.TokenType.STRING, "Header key or JSON block expected");
+                    // Lookahead: If the next token is ALSO a string, use the legacy Key-Value parsing
+                    if (!this.isAtEnd() && this.peek().type === lexer_1.TokenType.STRING) {
+                        const hKey = firstToken.value;
+                        const hVal = this.advance().value;
+                        payload.headers.push({ key: hKey, value: hVal });
+                    }
+                    else {
+                        // Otherwise, it must be the new multi-line JSON Block format
+                        try {
+                            const headerObj = JSON.parse(firstToken.value);
+                            if (typeof headerObj !== "object" ||
+                                headerObj === null ||
+                                Array.isArray(headerObj)) {
+                                throw new Error("Parsed JSON is not a Key-Value object.");
+                            }
+                            // Loop through the parsed block and push them into the array for the API client
+                            for (const [k, v] of Object.entries(headerObj)) {
+                                payload.headers.push({ key: k, value: String(v) });
+                            }
+                        }
+                        catch (e) {
+                            throw new Error(`Line ${firstToken.line}: Invalid JSON format for reqHeader block. Ensure it is a valid JSON object, or use the legacy format with two strings (Key and Value).`);
+                        }
+                    }
+                    // ------------------------------------------
                 }
                 else if (target === "reqBody") {
                     payload.body = this.consume(lexer_1.TokenType.STRING, "Body content expected").value;

package/dist/runner/flow_orchestrator.js

@@ -276,22 +276,41 @@ class FlowOrchestrator {
                     }
                 });
             });
-            this.httpServer.listen(0, async () => {
-                const address = this.httpServer?.address();
-                const port = typeof address === "object" && address !== null ? address.port : null;
-                if (!port) {
-                    console.error(chalk_1.default.red("\n[Error]: Could not bind to an available port."));
-                    process.exit(1);
-                }
-                const localUrl = `http://localhost:${port}`;
-                const { default: open } = await import("open");
-                await open(localUrl);
-                console.log(chalk_1.default.yellow(`\n[Dashboard]: Local server running at ${localUrl}`));
-                console.log(chalk_1.default.yellow("[Dashboard]: Waiting for UI connection..."));
-                while (this.wss.clients.size === 0)
-                    await new Promise((r) => setTimeout(r, 250));
-                console.log(chalk_1.default.green("[Dashboard]: Connected to UI!"));
-                await this.executeTestRun(targetPath);
+            return new Promise((resolve, reject) => {
+                this.httpServer.listen(0, async () => {
+                    try {
+                        const address = this.httpServer?.address();
+                        const port = typeof address === "object" && address !== null
+                            ? address.port
+                            : null;
+                        if (!port) {
+                            console.error(chalk_1.default.red("\n[Error]: Could not bind to an available port."));
+                            return reject(new Error("No port available"));
+                        }
+                        const localUrl = `http://localhost:${port}`;
+                        console.log(chalk_1.default.yellow(`\n[Dashboard]: Local server running at ${localUrl}`));
+                        const isStrictHeadless = process.argv.includes("--headless") ||
+                            !!process.env.CI ||
+                            !!process.env.GITHUB_ACTIONS ||
+                            !!process.env.FLOWSTRIDE_API_KEY;
+                        if (!isStrictHeadless) {
+                            const { default: open } = await import("open");
+                            await open(localUrl);
+                            console.log(chalk_1.default.yellow("[Dashboard]: Waiting for UI connection..."));
+                            while (this.wss.clients.size === 0)
+                                await new Promise((r) => setTimeout(r, 250));
+                            console.log(chalk_1.default.green("[Dashboard]: Connected to UI!"));
+                        }
+                        else {
+                            console.log(chalk_1.default.gray("[Dashboard]: Headless mode active. Bypassing UI auto-launch..."));
+                        }
+                        await this.executeTestRun(targetPath);
+                        resolve(undefined);
+                    }
+                    catch (err) {
+                        reject(err);
+                    }
+                });
             });
         }
         catch (e) {

package/dist/runner/flow_worker.js

@@ -131,6 +131,9 @@ class FlowWorker extends events_1.EventEmitter {
         return context;
     }
     resolveTextVariables(text) {
+        if (typeof text !== "string") {
+            return text;
+        }
         let resolved = text;
         resolved = resolved.replace(/\{\{env\.([a-zA-Z0-9_]+)\}\}/g, (_, varName) => {
             const val = process.env[varName];
@@ -259,11 +262,21 @@ class FlowWorker extends events_1.EventEmitter {
         catch {
             rawBodyString = typeof body === "string" ? body : null;
         }
-        const curlString = this.web.synthesizeCurl(method, cleanUrl, headers || {}, rawBodyString);
+        let formattedHeaders = {};
+        if (Array.isArray(headers)) {
+            headers.forEach((h) => {
+                if (h && h.key)
+                    formattedHeaders[h.key] = h.value;
+            });
+        }
+        else if (headers && typeof headers === "object") {
+            formattedHeaders = headers;
+        }
+        const curlString = this.web.synthesizeCurl(method, cleanUrl, formattedHeaders, rawBodyString);
         this.emitLog("REST", (state.status || 500) < 400 ? "success" : "error", `${method.toUpperCase()} ${endpointName}`, {
             method: method.toUpperCase(),
             url: cleanUrl,
-            requestHeaders: headers,
+            requestHeaders: formattedHeaders,
             requestBody: parsedReqBody,
             responseStatus: state.status,
             responseHeaders: state.headers,
@@ -340,7 +353,14 @@ class FlowWorker extends events_1.EventEmitter {
         this.isAborted = true;
     }
     async runBatch(filesToProcess) {
-        this.config.headless = true;
+        // this.config.headless = true;
+        const isCliHeadless = process.argv.includes("--headless");
+        if (isCliHeadless) {
+            this.config.headless = true;
+        }
+        else if (this.config.headless === undefined) {
+            this.config.headless = false;
+        }
         this.activeAudioPath = undefined;
         this.isAborted = false;
         this.isDebugHalted = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowstride",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "An opensource flowfirst test automation framework",
   "workspaces": [
     "packages/flowstride_report"