@speedkit/cli 3.20.0 → 3.21.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [3.21.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.20.0...v3.21.0) (2026-01-30)
+
+
+### Bug Fixes
+
+* **wizard:** soft to hard nav conversion ([501c490](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/501c49092a50d91a2b7986ffa41ea6916282c005))
+* **wizard:** soft to hard nav conversion ([9801d0f](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/9801d0f90b6cbf4f2d895aed56483c505b84a8cc))
+
+
+### Features
+
+* **customer-config:** prevent soft2hard nav conversion for product variant switches ([66c0923](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/66c0923a22e15965c26c11a0ae4370170ec4ccf5))
+* **customer-config:** remove conditional for predictive preloading as it is not necessary ([eead957](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/eead957e2c8b3e094edd7204858c2cb87036c1e7))
+* **customer-config:** update general logic for soft2hard nav conversion ([05a5a61](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/05a5a611476b9dbda9d3afe22a15a7dc637d4d66))
+
 # [3.20.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v3.19.0...v3.20.0) (2026-01-06)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/3.20.0 linux-x64 node-v20.19.6
+@speedkit/cli/3.21.0 linux-x64 node-v20.20.0
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND

package/dist/services/customer-config/customer-config-service-model.d.ts

@@ -37,6 +37,7 @@ export interface CustomerConfigSettings {
     withGoogleOptimize?: boolean;
     activateCfRocketLoaderPlugin?: boolean;
     hasSoftNavigations?: boolean;
+    convertSoftToHardNavigations?: boolean;
     isPOV?: boolean;
     isShopify?: boolean;
     isShopware?: boolean;

package/dist/services/customer-config/customer-config-service.js

@@ -136,7 +136,7 @@ class CustomerConfigService {
         return true;
     }
     async getConfigSettings() {
-        let { production, staging, activateScopedDeployments, subRouteScope, includeServiceWorker, activateImageOptimisation, removeLazyLoading, addSSR, addSSRInnerShadowDomSupport, addDeviceDetection, useGATracking, useScrapingBee, withGoogleOptimize, activateCfRocketLoaderPlugin, hasSoftNavigations, isShopify, isShopware, isSalesforce, isOxid, isPlentymarkets, isPOV, } = {};
+        let { production, staging, activateScopedDeployments, subRouteScope, includeServiceWorker, activateImageOptimisation, removeLazyLoading, addSSR, addSSRInnerShadowDomSupport, addDeviceDetection, useGATracking, useScrapingBee, withGoogleOptimize, activateCfRocketLoaderPlugin, hasSoftNavigations, convertSoftToHardNavigations, isShopify, isShopware, isSalesforce, isOxid, isPlentymarkets, isPOV, } = {};
         this.appName = await this.cli.prompt(`[App Name] Enter desired SK app name:`, {
             validator: (input) => /^[\da-z]+(?:-[\da-z]+)*$/.test(input) ? "" : "No valid kebab-case",
             defaultAnswer: this.appName,
@@ -198,6 +198,9 @@ class CustomerConfigService {
             useGATracking = await this.cli.confirm("[Tracking] Add tracking based on Google Analytics' DataLayer?");
         }
         hasSoftNavigations = await this.cli.confirm("[Tracking] Add tracking for Soft Navigations?", false);
+        if (hasSoftNavigations) {
+            convertSoftToHardNavigations = await this.cli.confirm("[Soft2Hard Navigations] Should soft navigations be converted to hard navigations?", false);
+        }
         isPOV = await this.cli.confirm("[Tracking] Is a POV (proof of value) anticipated, so that additional tracking is needed?", false);
         withGoogleOptimize = await this.cli.confirm("[Services] Is Google Optimize used?", false);
         activateCfRocketLoaderPlugin = await this.cli.confirm("[Services] Is Cloudflare's Rocket Loader used, for which we need to activate our rocket loader plugin?", false);
@@ -218,6 +221,7 @@ class CustomerConfigService {
             withGoogleOptimize,
             activateCfRocketLoaderPlugin,
             hasSoftNavigations,
+            convertSoftToHardNavigations,
             isShopify,
             isShopware,
             isSalesforce,

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

@@ -269,6 +269,22 @@ import { PredictivePreloading } from 'predictive-preloading/predictivePreloading
     },
   {{/if}}
 {{/if}}
+{{#if convertSoftToHardNavigations}}
+  {
+    on: "domInteractive",
+    track: () => {
+      if (
+        // check that dashboard is not disabled and user is in group A
+        window?.SpeedKit.lastNavigate.disconnectCause.indexOf("DashboardDisabled") > -1 ||
+        !window?.SpeedKit?.skSupported ||
+        SpeedKit.group !== "A"
+      ) {
+        return;
+      }
+      convertSoftToHardNavigation();
+    },
+  },
+{{/if}}
 {{#if isPlentymarkets}}
   {
     on: "domInteractive",
@@ -367,12 +383,81 @@ import { PredictivePreloading } from 'predictive-preloading/predictivePreloading
   });
 {{/if}}
 
-{{#if hasSoftNavigations}}
-  new PredictivePreloading({
-    // TODO: configure according to the needs of the customer e.g. preload API-calls, soft-nav to hard-nav conversion...
-  });
-{{else}}
+{{#if convertSoftToHardNavigations}}
+  function softNavShouldBeConverted(url) {
+    // no link item found
+    if (!url || url === location.href) {
+      return false;
+    }
+
+    try {
+      // Always resolve the target relative to the current location
+      var resolvedTarget = new URL(url, location.href);
+
+      if (location.origin !== resolvedTarget?.origin) {
+        return false;
+      }
+
+      // must be a different path
+      if (location.pathname === resolvedTarget?.pathname) {
+        return false;
+      }
+
+      if (!SpeedKit?.isPageTypeEnabled(resolvedTarget.href)) {
+        return false;
+      }
+
+      if (
+        // speedKit sw is known
+        window?.speedKit?.sw &&
+        // can detect sw
+        navigator?.serviceWorker?.controller?.scriptURL &&
+        navigator.serviceWorker.controller.scriptURL.indexOf(new URL(window.speedKit.sw, location.origin).pathname) > -1
+      ) {
+        return true;
+      }
+    } catch (e) {}
+    return false;
+  }
+
+  function convertSoftToHardNavigation() {
+    function speedKitClickEventListener(event) {
+      var target = event.target.closest("a");
+
+      // Drop out if no link address is found or the target is the current page
+      if (!target || !target.href || target.href === location.href) {
+        return;
+      }
+
+      // Don't convert to hard navigation if it is just a product variant switch
+      // TODO: adjust conditions to customer-specific implementation as needed
+      var targetPathname = new URL(target.href).pathname;
+      var isPDP = targetPathname.indexOf("/p/") !== -1;
+      var isSamePathname = new URL(location.href).pathname === targetPathname;
+      var variantSwitchIdentifier = target.matches('.color-option, .size-option, .swatch-option');
+      if (
+        (isPDP && isSamePathname) || // url-based check
+        variantSwitchIdentifier // element-based check
+      ) {
+        return;
+      }
+
+      // Check if the target is enabled by SpeedKit and is a valid page for conversion
+      if (!softNavShouldBeConverted(target?.href)) {
+        return;
+      }
+
+      // Prevent soft navigation
+      event.preventDefault();
+
+      // Execute hard navigation instead
+      location.href = target.href;
+    }
+    window.addEventListener("click", speedKitClickEventListener, true);
+  }
+
+{{/if}}
+
   // TODO: check if prerendering needs to be scoped to certain pages
   new PredictivePreloading({ prerender: true });
-{{/if}}
 }();

package/oclif.manifest.json

@@ -738,5 +738,5 @@
       ]
     }
   },
-  "version": "3.20.0"
+  "version": "3.21.0"
 }

package/package.json

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