@speedkit/cli 3.32.0 → 3.33.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+# [3.33.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.32.1...v3.33.0) (2026-03-25)
+
+
+### Features
+
+* change formatLib add autoFormat for htmlDiffs ([8d29341](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/8d293419d29a555196b57974a7917447154fd32c))
+* implement htmlFormat for html-diff ([5e4524f](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/5e4524fb920e4cb6fdeb45f5a712b8d3efdeba3f))
+* **onboarding:** args ([572729d](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/572729db87180ac7499945b1fadd9339f2d47064))
+* **onboarding:** args ([1e76105](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/1e761057b274a648b2fc62374857e9317995dd2a))
+
+## [3.32.1](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.32.0...v3.32.1) (2026-03-23)
+
+
+### Bug Fixes
+
+* **customer-config:** prevent null pointer exception in soft2hard nav conversion ([9277a1c](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/9277a1c0a188b5e0f8f143435712d84255d9ff8c))
+
 # [3.32.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.31.2...v3.32.0) (2026-03-11)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/3.32.0 linux-x64 node-v20.20.1
+@speedkit/cli/3.33.0 linux-x64 node-v20.20.1
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -382,7 +382,7 @@ Start a local dev environment for building and testing the Speed Kit configurati
 
 ```
 USAGE
-  $ sk onboarding CUSTOMERPATH [-c <value>] [-t] [-d <value>] [-l] [-v] [-s]
+  $ sk onboarding CUSTOMERPATH [-c <value>] [-t] [-d <value>] [-l] [-p] [-v] [-s]
 
 ARGUMENTS
   CUSTOMERPATH  The customer config path
@@ -391,6 +391,7 @@ FLAGS
   -c, --configName=<value>           [default: production] The costumer config name
   -d, --domain=<value>               Startup domain (optional)
   -l, --local                        Run with local documentHandler
+  -p, --debuggingPort                Enable remote debugging port (disables speculation rules/prerendering)
   -s, --ignoreContentSecurityPolicy  Removes header/meta "content-security-policy" for origin-responses
   -t, --useTestConfig                Override app with configured testApp
   -v, --verboseLevel                 Show all messages

package/dist/commands/diff-url-parameters.js

@@ -8,6 +8,7 @@ const cli_1 = require("../services/cli");
 const url = tslib_1.__importStar(require("node:url"));
 const diff_1 = require("../services/diff");
 const cli_config_1 = require("../helpers/cli-config");
+const html_format_helper_1 = require("../helpers/html-format-helper");
 class DiffUrlParameters extends core_1.Command {
     cli;
     static description = "Shows difference in documents with query parameters on/off";
@@ -60,8 +61,8 @@ class DiffUrlParameters extends core_1.Command {
         const userConfig = new cli_config_1.CliConfig(this.config).load();
         const context = new diff_1.DiffContext(userConfig.diffExec, userConfig.diffExecTemplate);
         const diffService = new diff_1.DiffServiceFactory(context).getService();
-        const originalFilePath = await diffService.writeContentToTemporalFile("original.html", originalData);
-        const withoutAnyParametersFilePath = await diffService.writeContentToTemporalFile("without-any-params.html", withoutAnyParametersData);
+        const originalFilePath = await diffService.writeContentToTemporalFile("original.html", (0, html_format_helper_1.formatHtml)(originalData));
+        const withoutAnyParametersFilePath = await diffService.writeContentToTemporalFile("without-any-params.html", (0, html_format_helper_1.formatHtml)(withoutAnyParametersData));
         this.cli.spacer();
         this.cli.write(`Checking any parameter...`);
         this.cli.write(`- with: ${originalUrl}`);
@@ -89,7 +90,7 @@ class DiffUrlParameters extends core_1.Command {
             if (!withoutCurrentParameterData) {
                 this.logError(`Failed to fetch document without "${parameter}" parameter`);
             }
-            const withoutCurrentParameterFilePath = await diffService.writeContentToTemporalFile(`without-${parameter}-param.html`, withoutCurrentParameterData);
+            const withoutCurrentParameterFilePath = await diffService.writeContentToTemporalFile(`without-${parameter}-param.html`, (0, html_format_helper_1.formatHtml)(withoutCurrentParameterData));
             this.cli.spacer();
             this.cli.write(`Checking "${parameter}" parameter...`);
             this.cli.write(`- with: ${originalUrl}`);

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, }, } = 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), new cli_config_1.CliConfig(this.config).load(customerPath)).getService();
+        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();
         await service.run();
     }
 }

package/dist/helpers/html-format-helper.d.ts

@@ -0,0 +1 @@
+export declare function formatHtml(html: string): string;

package/dist/helpers/html-format-helper.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatHtml = formatHtml;
+const htmlfy_1 = require("htmlfy");
+function formatHtml(html) {
+    return (0, htmlfy_1.prettify)(html);
+}

package/dist/services/customer-config/templates/config_loadHandler.js.hbs

@@ -277,9 +277,9 @@ import { PredictivePreloading } from 'predictive-preloading/predictivePreloading
     track: () => {
       if (
         // check that dashboard is not disabled and user is in group A
-        window?.SpeedKit.lastNavigate.disconnectCause.indexOf("DashboardDisabled") > -1 ||
+        window?.SpeedKit?.lastNavigate?.disconnectCause?.indexOf("DashboardDisabled") > -1 ||
         !window?.SpeedKit?.skSupported ||
-        SpeedKit.group !== "A"
+        window?.SpeedKit?.group !== "A"
       ) {
         return;
       }

package/dist/services/onboarding/dashboard/diff-against-current-page.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DiffAgainstCurrentPage = void 0;
 const cli_1 = require("../../cli");
+const html_format_helper_1 = require("../../../helpers/html-format-helper");
 class DiffAgainstCurrentPage {
     diffService;
     documentHandlerRuntime;
@@ -13,10 +14,10 @@ class DiffAgainstCurrentPage {
         this.crawler = crawler;
         this.cli = cli;
     }
-    async postDiff(currentHtml, currentUrl, variant = "DEFAULT", transform = false) {
+    async postDiff(currentHtml, currentUrl, variant = "default", transform = false) {
         this.cli.writeWarning(`received diff for url: ${currentUrl}`);
         this.cli.startAction(`fetch remote`);
-        const originResponse = await this.crawler.fetchRemote(currentUrl, variant.toUpperCase());
+        const originResponse = await this.crawler.fetchRemote(currentUrl, variant);
         let originHtml = await originResponse?.text();
         if (!originHtml) {
             this.cli.endAction(cli_1.CliActionStatus.FAILED);
@@ -42,8 +43,8 @@ class DiffAgainstCurrentPage {
             originHtml = originResponse;
         }
         this.cli.endAction(cli_1.CliActionStatus.COMPLETED);
-        const remoteFilePath = await this.diffService.writeContentToTemporalFile(`remote-${variant}.html`, originHtml);
-        const localFilePath = await this.diffService.writeContentToTemporalFile("current.html", currentHtml);
+        const remoteFilePath = await this.diffService.writeContentToTemporalFile(`remote-${variant}.html`, (0, html_format_helper_1.formatHtml)(originHtml));
+        const localFilePath = await this.diffService.writeContentToTemporalFile("current.html", (0, html_format_helper_1.formatHtml)(currentHtml));
         return await this.diffService.executeDiff(remoteFilePath, localFilePath);
     }
 }

package/dist/services/onboarding/dashboard/index.js

@@ -80,7 +80,7 @@ class Dashboard {
             const transform = data.transform || false;
             const diffResult = await (0, safe_1.safe)(this.currentPageDiff.postDiff(currentHtml, currentUrl, variant, transform));
             if (diffResult.success === true) {
-                return this.createBaqendResponse(requestOrigin, JSON.stringify({ success: true }), "application/json; charset=UTF-8", [], 200);
+                return this.createBaqendResponse(requestOrigin, JSON.stringify({ success: diffResult.data }), "application/json; charset=UTF-8", [], 200);
             }
             return this.createBaqendResponse(requestOrigin, JSON.stringify({ success: false, error: diffResult.error }), "application/json; charset=UTF-8", [], 500);
         }

package/dist/services/onboarding/dashboard/request-diff-service.js

@@ -7,6 +7,7 @@ const safe_1 = require("../../../helpers/safe");
 const node_https_1 = require("node:https");
 const node_crypto_1 = tslib_1.__importDefault(require("node:crypto"));
 const node_fetch_1 = tslib_1.__importDefault(require("node-fetch"));
+const html_format_helper_1 = require("../../../helpers/html-format-helper");
 class RequestDiffService {
     diffService;
     documentHandlerRuntime;
@@ -59,8 +60,8 @@ class RequestDiffService {
         if (checkIsEqual) {
             return this.diffService.isContentEqual(transformedHtmlWithParameter, transformedHtmlWithoutParameter);
         }
-        const parametersFilePath = await this.diffService.writeContentToTemporalFile("params", transformedHtmlWithParameter);
-        const pureFilePath = await this.diffService.writeContentToTemporalFile("pure", transformedHtmlWithoutParameter);
+        const parametersFilePath = await this.diffService.writeContentToTemporalFile("params", (0, html_format_helper_1.formatHtml)(transformedHtmlWithParameter));
+        const pureFilePath = await this.diffService.writeContentToTemporalFile("pure", (0, html_format_helper_1.formatHtml)(transformedHtmlWithoutParameter));
         return await this.diffService.executeDiff(parametersFilePath, pureFilePath);
     }
     async fetchHtml(url) {

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

@@ -36,9 +36,10 @@ export declare class BrowserContext {
     readonly chromeFlags?: string[];
     readonly userConfig?: UserCliConfig;
     userAgent?: string;
+    readonly debuggingPort: boolean;
     readonly browserArgs: string[];
     readonly chromePath: string;
-    constructor(domain: string, browserVersionString?: string, chromeFlags?: string[], userConfig?: UserCliConfig, userAgent?: string);
+    constructor(domain: string, browserVersionString?: string, chromeFlags?: string[], userConfig?: UserCliConfig, userAgent?: string, debuggingPort?: boolean);
     private isChromeBrowser;
     private getBrowserExtensionPath;
     getPuppeteerLaunchOptions(): Parameters<VanillaPuppeteer["launch"]>[0];
@@ -56,12 +57,13 @@ export declare class OnboardingContext {
     readonly cliPath: string;
     readonly verboseLevel?: boolean;
     readonly useTestConfig: boolean;
+    readonly debuggingPort: 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);
+    constructor(customerPath: string, configName: string, domain: string, local: boolean, ignoreContentSecurityPolicy: boolean, cliPath: string, verboseLevel?: boolean, useTestConfig?: boolean, debuggingPort?: boolean);
 }
 export type SpeedKitServerConfigAuthentication = {
     password: string;

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

@@ -44,14 +44,16 @@ class BrowserContext {
     chromeFlags;
     userConfig;
     userAgent;
+    debuggingPort;
     browserArgs;
     chromePath;
-    constructor(domain, browserVersionString = "unknown", chromeFlags, userConfig, userAgent) {
+    constructor(domain, browserVersionString = "unknown", chromeFlags, userConfig, userAgent, debuggingPort = false) {
         this.domain = domain;
         this.browserVersionString = browserVersionString;
         this.chromeFlags = chromeFlags;
         this.userConfig = userConfig;
         this.userAgent = userAgent;
+        this.debuggingPort = debuggingPort;
         this.domain = domain;
         this.chromeFlags = chromeFlags || [];
         this.chromePath = (0, node_path_1.resolve)(userConfig.chromePath);
@@ -90,13 +92,17 @@ class BrowserContext {
         };
         if (this.userConfig?.chromeExtensionPaths) {
             if (this.isChromeBrowser()) {
-                options["pipe"] = true;
                 options["enableExtensions"] = this.getBrowserExtensionPath();
+                options["pipe"] = true;
+                options.args.push("--remote-debugging-pipe");
             }
             else {
-                options.args.push(`--load-extension=${this.userConfig?.chromeExtensionPaths}`, "--remote-debugging-port=9222", `--disable-extensions-except=${this.userConfig?.chromeExtensionPaths}`);
+                options.args.push(`--load-extension=${this.userConfig?.chromeExtensionPaths}`, `--disable-extensions-except=${this.userConfig?.chromeExtensionPaths}`);
             }
         }
+        if (this.debuggingPort) {
+            options.args.push("--remote-debugging-port=9222");
+        }
         return options;
     }
 }
@@ -110,6 +116,7 @@ class OnboardingContext {
     cliPath;
     verboseLevel;
     useTestConfig;
+    debuggingPort;
     static flags = {
         ...cli_parameters_1.CLI_CONFIG_NAME,
         ...cli_parameters_1.CLI_CONFIG_IS_TEST,
@@ -122,6 +129,11 @@ class OnboardingContext {
             default: false,
             description: "Run with local documentHandler",
         }),
+        debuggingPort: core_1.Flags.boolean({
+            char: "p",
+            default: false,
+            description: "Enable remote debugging port (disables speculation rules/prerendering)",
+        }),
         verboseLevel: core_1.Flags.boolean({
             char: "v",
             default: false,
@@ -137,7 +149,7 @@ class OnboardingContext {
     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) {
+    constructor(customerPath, configName, domain, local, ignoreContentSecurityPolicy = false, cliPath, verboseLevel, useTestConfig = false, debuggingPort = false) {
         this.customerPath = customerPath;
         this.configName = configName;
         this.domain = domain;
@@ -146,6 +158,7 @@ class OnboardingContext {
         this.cliPath = cliPath;
         this.verboseLevel = verboseLevel;
         this.useTestConfig = useTestConfig;
+        this.debuggingPort = debuggingPort;
     }
 }
 exports.OnboardingContext = OnboardingContext;

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

@@ -75,7 +75,10 @@ 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);
+        const browserContext = new onboarding_model_1.BrowserContext(domainToStart, browserVersionString, customerConfig.chromeFlags || [], this.cliConfig, undefined, this.context.debuggingPort);
+        if (this.context.debuggingPort) {
+            cli.writeWarning("Chrome remote debugging enabled on port 9222.");
+        }
         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

@@ -486,6 +486,13 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "debuggingPort": {
+          "char": "p",
+          "description": "Enable remote debugging port (disables speculation rules/prerendering)",
+          "name": "debuggingPort",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "verboseLevel": {
           "char": "v",
           "description": "Show all messages",
@@ -731,5 +738,5 @@
       ]
     }
   },
-  "version": "3.32.0"
+  "version": "3.33.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@speedkit/cli",
   "description": "Speed Kit CLI",
-  "version": "3.32.0",
+  "version": "3.33.0",
   "author": {
     "name": "Baqend.com",
     "email": "info@baqend.com"
@@ -90,6 +90,7 @@
     "fluent-ffmpeg": "^2.1.3",
     "fs-extra": "^11.2.0",
     "handlebars": "^4.7.8",
+    "htmlfy": "^1.0.1",
     "htmlparser2": "8.0.2",
     "iconv-lite": "^0.7.2",
     "json2csv": "^6.0.0-alpha.2",