@speedkit/cli 4.23.0 → 4.23.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [4.23.1](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.23.0...v4.23.1) (2026-08-21)
+
+
+### Bug Fixes
+
+* **cli:** resolve IPv4 addresses before IPv6 ([057fa59](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/057fa59bb06f3d49af5b8631681e7850a062d585))
+* **onboarding:** allow one hour Shopify staleness for local runs ([4e31124](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/4e31124aa3c217f698ef3bb48a51c83fb5395ca4))
+
 # [4.23.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.22.1...v4.23.0) (2026-08-21)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/4.23.0 linux-x64 node-v22.23.2
+@speedkit/cli/4.23.1 linux-x64 node-v22.23.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND

package/dist/hooks/init/dns-result-order.d.ts

@@ -0,0 +1,12 @@
+import { Hook } from "@oclif/core";
+/**
+ * Puts IPv4 addresses first for every lookup the CLI makes. This is the runtime equivalent of
+ * `NODE_OPTIONS=--dns-result-order=ipv4first`, so no entrypoint has to export that variable.
+ *
+ * Node resolves `localhost` to `::1` first. WSL in mirrored networking mode shares `localhost`
+ * between Windows and Linux, but Chrome's remote debugging port and the local dev server both
+ * listen on IPv4 only. A lookup that answers `::1` therefore never reaches the listener on the
+ * other side of the boundary, and the connection fails instead of crossing over.
+ */
+declare const hook: Hook<"init">;
+export default hook;

package/dist/hooks/init/dns-result-order.js

@@ -0,0 +1,14 @@
+import { setDefaultResultOrder } from "node:dns";
+/**
+ * Puts IPv4 addresses first for every lookup the CLI makes. This is the runtime equivalent of
+ * `NODE_OPTIONS=--dns-result-order=ipv4first`, so no entrypoint has to export that variable.
+ *
+ * Node resolves `localhost` to `::1` first. WSL in mirrored networking mode shares `localhost`
+ * between Windows and Linux, but Chrome's remote debugging port and the local dev server both
+ * listen on IPv4 only. A lookup that answers `::1` therefore never reaches the listener on the
+ * other side of the boundary, and the connection fails instead of crossing over.
+ */
+const hook = async () => {
+    setDefaultResultOrder("ipv4first");
+};
+export default hook;

package/dist/hooks/init/dns-result-order.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/init/dns-result-order.spec.js

@@ -0,0 +1,15 @@
+import { expect } from "chai";
+import { after, describe, it } from "mocha";
+import { getDefaultResultOrder, setDefaultResultOrder } from "node:dns";
+import hook from "./dns-result-order.js";
+describe("dns-result-order hook", () => {
+    const previousOrder = getDefaultResultOrder();
+    after(() => {
+        setDefaultResultOrder(previousOrder);
+    });
+    it("puts IPv4 addresses first", async () => {
+        setDefaultResultOrder("verbatim");
+        await hook.call(null, {});
+        expect(getDefaultResultOrder()).to.equal("ipv4first");
+    });
+});

package/dist/services/document-handler-runtime/context/document-handler-runtime-context.d.ts

@@ -6,6 +6,7 @@ export declare const LOCAL_DYNAMIC_FETCHER_CONFIG = "config_dynamicBlocks";
 export declare const LOCAL_STYLES = "config_dynamicStyles";
 export declare const LATEST_DOCUMENT_HANDLER_URL = "https://www.baqend.com/speed-kit-handler/latest/DocumentHandler.js";
 export declare const LATEST_DYNAMIC_FETCHER_URL = "https://www.baqend.com/speed-kit/latest/dynamic-fetcher.js";
+export declare const LOCAL_TRIGGERED_BY = "STREAM:QA";
 export declare const TEST_DOCUMENT_HANDLER_FILE_NAME = "testDocumentHandler";
 export declare const TEST_DATABASE_MOCK_FILE_NAME = "database-mock";
 export declare const TEST_ORESTES_MOCK_FILE_NAME = "orestes-mock";

package/dist/services/document-handler-runtime/context/document-handler-runtime-context.js

@@ -6,6 +6,10 @@ export const LOCAL_DYNAMIC_FETCHER_CONFIG = "config_dynamicBlocks";
 export const LOCAL_STYLES = "config_dynamicStyles";
 export const LATEST_DOCUMENT_HANDLER_URL = "https://www.baqend.com/speed-kit-handler/latest/DocumentHandler.js";
 export const LATEST_DYNAMIC_FETCHER_URL = "https://www.baqend.com/speed-kit/latest/dynamic-fetcher.js";
+// Local runs have no persistent cache, so an origin HTML is served straight to the developer and may
+// legitimately be older than the default five minutes. STREAM:QA relaxes the document handler's
+// Shopify staleness check to one hour, see ONE_HOUR_STALENESS_TRIGGERS in document-handler.
+export const LOCAL_TRIGGERED_BY = "STREAM:QA";
 export const TEST_DOCUMENT_HANDLER_FILE_NAME = "testDocumentHandler";
 export const TEST_DATABASE_MOCK_FILE_NAME = "database-mock";
 export const TEST_ORESTES_MOCK_FILE_NAME = "orestes-mock";

package/dist/services/document-handler-runtime/server/request.d.ts

@@ -2,6 +2,7 @@ interface query {
     url: string;
     variation: string;
     headers: string;
+    triggeredBy: string;
 }
 export declare class Request {
     query: query;

package/dist/services/document-handler-runtime/server/request.js

@@ -1,9 +1,15 @@
+import { LOCAL_TRIGGERED_BY } from "../context/document-handler-runtime-context.js";
 export class Request {
     query;
     body;
     headers;
     constructor(url, body, variation, originalHeaders, requestHeaders = {}) {
-        this.query = { variation, headers: JSON.stringify(originalHeaders), url };
+        this.query = {
+            variation,
+            headers: JSON.stringify(originalHeaders),
+            url,
+            triggeredBy: LOCAL_TRIGGERED_BY,
+        };
         this.body = body;
         this.headers = {};
         for (const key of Object.keys(requestHeaders)) {

package/dist/services/document-handler-runtime/templates/execute-document-handler.js

@@ -1,4 +1,5 @@
 import AbstractTemplate from "./abstract-template.js";
+import { LOCAL_TRIGGERED_BY } from "../context/document-handler-runtime-context.js";
 export default class ExecuteDocumentHandler extends AbstractTemplate {
     buildContext(domain, file) {
         return { domain, file };
@@ -35,6 +36,7 @@ async function run(iterator) {
             variation: item.variation || 'DEFAULT',
             headers: item?.headers ? item.headers : JSON.stringify(DEFAULT_HEADERS),
             url: item.url,
+            triggeredBy: '${LOCAL_TRIGGERED_BY}',
         }
         let req = {
             query, body: file

package/dist/services/document-handler-runtime/templates/orestes-mock.js

@@ -1,4 +1,5 @@
 import AbstractTemplate from "./abstract-template.js";
+import { LOCAL_TRIGGERED_BY } from "../context/document-handler-runtime-context.js";
 export default class OrestesMock extends AbstractTemplate {
     buildContext() {
         return {};
@@ -79,6 +80,7 @@ const server = http.createServer(async function (request, response) {
         variation: UrlObject.searchParams.has('bqvariation')?UrlObject.searchParams.get('bqvariation'):'DEFAULT',
         headers: '',
         url: url,
+        triggeredBy: '${LOCAL_TRIGGERED_BY}',
       }
       let req = {query, body}
       const output =  await documentHandler.transform(database,req)

package/dist/services/document-handler-runtime/templates/test.js

@@ -1,4 +1,5 @@
 import AbstractTemplate from "./abstract-template.js";
+import { LOCAL_TRIGGERED_BY } from "../context/document-handler-runtime-context.js";
 export default class Test extends AbstractTemplate {
     buildContext(domain, name, timeout = 2000) {
         return { domain, name, timeout };
@@ -25,6 +26,7 @@ describe(\`documentHandler run on \${file}\`, function () {
         variation: 'DEFAULT',
         headers: JSON.stringify(DEFAULT_HEADERS),
         url: url,
+        triggeredBy: '${LOCAL_TRIGGERED_BY}',
     }
 
     let req = {query, body}
@@ -42,6 +44,7 @@ describe(\`create files to diff for \${file}\`,function (){
       variation: 'DEFAULT',
       headers: JSON.stringify(DEFAULT_HEADERS),
       url: url,
+      triggeredBy: '${LOCAL_TRIGGERED_BY}',
     }
 
     let req = {query, body}

package/oclif.manifest.json

@@ -1220,5 +1220,5 @@
       ]
     }
   },
-  "version": "4.23.0"
+  "version": "4.23.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@speedkit/cli",
   "description": "Speed Kit CLI",
-  "version": "4.23.0",
+  "version": "4.23.1",
   "author": {
     "name": "Baqend.com",
     "email": "info@baqend.com"
@@ -64,6 +64,11 @@
   ],
   "oclif": {
     "commands": "./dist/commands",
+    "hooks": {
+      "init": [
+        "./dist/hooks/init/dns-result-order.js"
+      ]
+    },
     "bin": "sk",
     "dirname": "speed-kit-cli",
     "plugins": [