@speedkit/cli 3.36.0 → 3.37.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [3.37.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.36.0...v3.37.0) (2026-03-30)
+
+
+### Features
+
+* **onboarding:** headless ([4f6e1b0](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/4f6e1b0c89861a2bf93027028081a6b7d664e9a8))
+
 # [3.36.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.35.0...v3.36.0) (2026-03-27)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/3.36.0 linux-x64 node-v20.20.2
+@speedkit/cli/3.37.0 linux-x64 node-v20.20.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -383,7 +383,7 @@ Start a local dev environment for building and testing the Speed Kit configurati
 
 ```
 USAGE
-  $ sk onboarding CUSTOMERPATH [-c <value>] [-t] [-d <value>] [-l] [-p] [-v] [-s]
+  $ sk onboarding CUSTOMERPATH [-c <value>] [-t] [-d <value>] [-l] [-p] [-v] [-s] [--headless]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -396,6 +396,8 @@ FLAGS
   -s, --ignoreContentSecurityPolicy  Removes header/meta "content-security-policy" for origin-responses
   -t, --useTestConfig                Override app with configured testApp
   -v, --verboseLevel                 Show all messages
+      --headless                     Run Chrome in headless mode (for CI environments). Implicitly enables remote
+                                     debugging port.
 
 DESCRIPTION
   Start a local dev environment for building and testing the Speed Kit configuration

package/dist/commands/onboarding.js

@@ -13,8 +13,8 @@ class Onboarding extends core_1.Command {
         `$ sk onboarding ${cli_parameters_1.CLIParametersExample.CustomerPath} -${cli_parameters_1.CLIParametersChar.ConfigName} ${cli_parameters_1.CLIParametersExample.ConfigName} -${cli_parameters_1.CLIParametersChar.Domain} ${cli_parameters_1.CLIParametersExample.Domain}`,
     ];
     async run() {
-        const { args: { customerPath }, flags: { configName, domain, local, verboseLevel, ignoreContentSecurityPolicy, useTestConfig, debuggingPort, }, } = await this.parse(Onboarding);
-        const service = await new onboarding_1.OnboardingServiceFactory(new onboarding_1.OnboardingContext(customerPath, configName, domain, local, ignoreContentSecurityPolicy, this.config.root, verboseLevel, useTestConfig, debuggingPort), new cli_config_1.CliConfig(this.config).load(customerPath)).getService();
+        const { args: { customerPath }, flags: { configName, domain, local, verboseLevel, ignoreContentSecurityPolicy, useTestConfig, debuggingPort, headless, }, } = await this.parse(Onboarding);
+        const service = await new onboarding_1.OnboardingServiceFactory(new onboarding_1.OnboardingContext(customerPath, configName, domain, local, ignoreContentSecurityPolicy, this.config.root, verboseLevel, useTestConfig, debuggingPort, headless), new cli_config_1.CliConfig(this.config).load(customerPath)).getService();
         await service.run();
     }
 }

package/dist/services/onboarding/onboarding-model.d.ts

@@ -37,9 +37,10 @@ export declare class BrowserContext {
     readonly userConfig?: UserCliConfig;
     userAgent?: string;
     readonly debuggingPort: boolean;
+    readonly headless: boolean;
     readonly browserArgs: string[];
     readonly chromePath: string;
-    constructor(domain: string, browserVersionString?: string, chromeFlags?: string[], userConfig?: UserCliConfig, userAgent?: string, debuggingPort?: boolean);
+    constructor(domain: string, browserVersionString?: string, chromeFlags?: string[], userConfig?: UserCliConfig, userAgent?: string, debuggingPort?: boolean, headless?: boolean);
     private isChromeBrowser;
     private getBrowserExtensionPath;
     getPuppeteerLaunchOptions(): Parameters<VanillaPuppeteer["launch"]>[0];
@@ -58,12 +59,13 @@ export declare class OnboardingContext {
     readonly verboseLevel?: boolean;
     readonly useTestConfig: boolean;
     readonly debuggingPort: boolean;
+    readonly headless: boolean;
     static flags: FlagInput;
     readonly DEFAULT_DF_PATH = "https://www.baqend.com/speed-kit/latest/dynamic-fetcher.js";
     readonly DEFAULT_DOCUMENT_HANDLER_PATH = "https://www.baqend.com/speed-kit-handler/latest/DocumentHandler.js";
     readonly DEFAULT_SNIPPET_PATH = "https://www.baqend.com/speed-kit/latest/snippet.js";
     readonly DEFAULT_SW_PATH = "https://www.baqend.com/speed-kit/latest/sw.js";
-    constructor(customerPath: string, configName: string, domain: string, local: boolean, ignoreContentSecurityPolicy: boolean, cliPath: string, verboseLevel?: boolean, useTestConfig?: boolean, debuggingPort?: boolean);
+    constructor(customerPath: string, configName: string, domain: string, local: boolean, ignoreContentSecurityPolicy: boolean, cliPath: string, verboseLevel?: boolean, useTestConfig?: boolean, debuggingPort?: boolean, headless?: boolean);
 }
 export type SpeedKitServerConfigAuthentication = {
     password: string;

package/dist/services/onboarding/onboarding-model.js

@@ -45,15 +45,17 @@ class BrowserContext {
     userConfig;
     userAgent;
     debuggingPort;
+    headless;
     browserArgs;
     chromePath;
-    constructor(domain, browserVersionString = "unknown", chromeFlags, userConfig, userAgent, debuggingPort = false) {
+    constructor(domain, browserVersionString = "unknown", chromeFlags, userConfig, userAgent, debuggingPort = false, headless = false) {
         this.domain = domain;
         this.browserVersionString = browserVersionString;
         this.chromeFlags = chromeFlags;
         this.userConfig = userConfig;
         this.userAgent = userAgent;
         this.debuggingPort = debuggingPort;
+        this.headless = headless;
         this.domain = domain;
         this.chromeFlags = chromeFlags || [];
         this.chromePath = (0, node_path_1.resolve)(userConfig.chromePath);
@@ -83,10 +85,10 @@ class BrowserContext {
     }
     getPuppeteerLaunchOptions() {
         const options = {
-            devtools: true,
+            devtools: !this.headless,
             timeout: 0,
             defaultViewport: null,
-            headless: false /* ignoreDefaultArgs: true, */,
+            headless: this.headless,
             executablePath: this.chromePath,
             args: this.browserArgs,
         };
@@ -100,7 +102,7 @@ class BrowserContext {
                 options.args.push(`--load-extension=${this.userConfig?.chromeExtensionPaths}`, `--disable-extensions-except=${this.userConfig?.chromeExtensionPaths}`);
             }
         }
-        if (this.debuggingPort) {
+        if (this.debuggingPort || this.headless) {
             options.args.push("--remote-debugging-port=9222");
         }
         return options;
@@ -117,6 +119,7 @@ class OnboardingContext {
     verboseLevel;
     useTestConfig;
     debuggingPort;
+    headless;
     static flags = {
         ...cli_parameters_1.CLI_CONFIG_NAME,
         ...cli_parameters_1.CLI_CONFIG_IS_TEST,
@@ -144,12 +147,16 @@ class OnboardingContext {
             default: false,
             description: `Removes header/meta "content-security-policy" for origin-responses`,
         }),
+        headless: core_1.Flags.boolean({
+            default: false,
+            description: "Run Chrome in headless mode (for CI environments). Implicitly enables remote debugging port.",
+        }),
     };
     DEFAULT_DF_PATH = "https://www.baqend.com/speed-kit/latest/dynamic-fetcher.js";
     DEFAULT_DOCUMENT_HANDLER_PATH = "https://www.baqend.com/speed-kit-handler/latest/DocumentHandler.js";
     DEFAULT_SNIPPET_PATH = "https://www.baqend.com/speed-kit/latest/snippet.js";
     DEFAULT_SW_PATH = "https://www.baqend.com/speed-kit/latest/sw.js";
-    constructor(customerPath, configName, domain, local, ignoreContentSecurityPolicy = false, cliPath, verboseLevel, useTestConfig = false, debuggingPort = false) {
+    constructor(customerPath, configName, domain, local, ignoreContentSecurityPolicy = false, cliPath, verboseLevel, useTestConfig = false, debuggingPort = false, headless = false) {
         this.customerPath = customerPath;
         this.configName = configName;
         this.domain = domain;
@@ -159,6 +166,7 @@ class OnboardingContext {
         this.verboseLevel = verboseLevel;
         this.useTestConfig = useTestConfig;
         this.debuggingPort = debuggingPort;
+        this.headless = headless;
     }
 }
 exports.OnboardingContext = OnboardingContext;

package/dist/services/onboarding/onboarding-service-factory.js

@@ -75,10 +75,13 @@ class OnboardingServiceFactory {
         this.cliConfig.chromeExtensionPaths = extensionPaths.join(",");
         const browserValidator = new executable_validator_1.ExecutableValidator(this.cliConfig, cli);
         const browserVersionString = await browserValidator.validateOrInstall();
-        const browserContext = new onboarding_model_1.BrowserContext(domainToStart, browserVersionString, customerConfig.chromeFlags || [], this.cliConfig, undefined, this.context.debuggingPort);
-        if (this.context.debuggingPort) {
+        const browserContext = new onboarding_model_1.BrowserContext(domainToStart, browserVersionString, customerConfig.chromeFlags || [], this.cliConfig, undefined, this.context.debuggingPort, this.context.headless);
+        if (this.context.debuggingPort || this.context.headless) {
             cli.writeWarning("Chrome remote debugging enabled on port 9222.");
         }
+        if (this.context.headless) {
+            cli.writeWarning("Running in headless mode.");
+        }
         const fileWatcher = new file_watcher_1.FileWatcher(cli, customerConfig, files, documentHandler, browserContext, cache);
         const athenaClient = (await this.getAthenaClient()) || null;
         const fetchHandler = await this.getFetchEventHandler(files, customerConfig, documentHandler, cache, cli, browserContext, athenaClient);

package/oclif.manifest.json

@@ -513,6 +513,12 @@
           "name": "ignoreContentSecurityPolicy",
           "allowNo": false,
           "type": "boolean"
+        },
+        "headless": {
+          "description": "Run Chrome in headless mode (for CI environments). Implicitly enables remote debugging port.",
+          "name": "headless",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -745,5 +751,5 @@
       ]
     }
   },
-  "version": "3.36.0"
+  "version": "3.37.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@speedkit/cli",
   "description": "Speed Kit CLI",
-  "version": "3.36.0",
+  "version": "3.37.0",
   "author": {
     "name": "Baqend.com",
     "email": "info@baqend.com"