@speedkit/cli 4.20.5 → 4.22.0

package/dist/services/setup/extension/webstore.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Pure helpers for dealing with the Chrome Web Store: extracting an extension
+ * id from user input, and building the Google update-service URLs used to
+ * download a CRX and to check for a newer version.
+ */
+/**
+ * Resolves a Chrome extension id from a bare id or a Web Store URL. Supports
+ * both the current `chromewebstore.google.com/detail/<slug>/<id>` and the
+ * legacy `chrome.google.com/webstore/detail/<slug>/<id>` layouts. Returns null
+ * when no valid id can be found.
+ */
+export declare function parseExtensionId(input: string): string | null;
+/**
+ * Builds the download URL for an extension's CRX. `response=redirect` makes the
+ * endpoint 302 to the actual CRX file, which fetch follows automatically.
+ */
+export declare function buildCrxUrl(id: string, chromeMajorVersion: string): string;
+/**
+ * Builds the update-check URL. `installsource=ondemand` makes the endpoint
+ * report the latest available version (without it, it answers "noupdate"),
+ * which we then compare against the installed version ourselves.
+ */
+export declare function buildUpdateCheckUrl(id: string, chromeMajorVersion: string): string;
+/**
+ * Parses the latest version from an update-check XML response. Returns null when
+ * the response reports no update or carries no version attribute.
+ */
+export declare function parseUpdateCheckVersion(xml: string): string | null;
+/**
+ * Compares two dotted numeric versions (handles Chrome's 4-part versions, which
+ * semver cannot parse). Returns >0 if a is newer, <0 if older, 0 if equal.
+ */
+export declare function compareVersions(a: string, b: string): number;

package/dist/services/setup/extension/webstore.js

@@ -0,0 +1,74 @@
+/**
+ * Pure helpers for dealing with the Chrome Web Store: extracting an extension
+ * id from user input, and building the Google update-service URLs used to
+ * download a CRX and to check for a newer version.
+ */
+const EXTENSION_ID = /[a-p]{32}/;
+const CRX_ENDPOINT = "https://clients2.google.com/service/update2/crx";
+/**
+ * Resolves a Chrome extension id from a bare id or a Web Store URL. Supports
+ * both the current `chromewebstore.google.com/detail/<slug>/<id>` and the
+ * legacy `chrome.google.com/webstore/detail/<slug>/<id>` layouts. Returns null
+ * when no valid id can be found.
+ */
+export function parseExtensionId(input) {
+    const trimmed = (input ?? "").trim();
+    if (!trimmed) {
+        return null;
+    }
+    if (new RegExp(`^${EXTENSION_ID.source}$`).test(trimmed)) {
+        return trimmed;
+    }
+    const detail = trimmed.match(new RegExp(`/detail/(?:[^/]+/)?(${EXTENSION_ID.source})`));
+    if (detail) {
+        return detail[1];
+    }
+    const anywhere = trimmed.match(EXTENSION_ID);
+    return anywhere ? anywhere[0] : null;
+}
+/**
+ * Builds the download URL for an extension's CRX. `response=redirect` makes the
+ * endpoint 302 to the actual CRX file, which fetch follows automatically.
+ */
+export function buildCrxUrl(id, chromeMajorVersion) {
+    const x = encodeURIComponent(`id=${id}&installsource=ondemand&uc`);
+    return (`${CRX_ENDPOINT}?response=redirect&acceptformat=crx2,crx3` +
+        `&prodversion=${chromeMajorVersion}&x=${x}`);
+}
+/**
+ * Builds the update-check URL. `installsource=ondemand` makes the endpoint
+ * report the latest available version (without it, it answers "noupdate"),
+ * which we then compare against the installed version ourselves.
+ */
+export function buildUpdateCheckUrl(id, chromeMajorVersion) {
+    const x = encodeURIComponent(`id=${id}&installsource=ondemand&uc`);
+    return (`${CRX_ENDPOINT}?response=updatecheck&acceptformat=crx2,crx3` +
+        `&prodversion=${chromeMajorVersion}&x=${x}`);
+}
+/**
+ * Parses the latest version from an update-check XML response. Returns null when
+ * the response reports no update or carries no version attribute.
+ */
+export function parseUpdateCheckVersion(xml) {
+    if (/status="noupdate"/.test(xml)) {
+        return null;
+    }
+    const match = xml.match(/<updatecheck[^>]*\bversion="([^"]+)"/);
+    return match ? match[1] : null;
+}
+/**
+ * Compares two dotted numeric versions (handles Chrome's 4-part versions, which
+ * semver cannot parse). Returns >0 if a is newer, <0 if older, 0 if equal.
+ */
+export function compareVersions(a, b) {
+    const partsA = a.split(".").map((part) => Number.parseInt(part, 10) || 0);
+    const partsB = b.split(".").map((part) => Number.parseInt(part, 10) || 0);
+    const length = Math.max(partsA.length, partsB.length);
+    for (let index = 0; index < length; index++) {
+        const diff = (partsA[index] || 0) - (partsB[index] || 0);
+        if (diff !== 0) {
+            return diff > 0 ? 1 : -1;
+        }
+    }
+    return 0;
+}

package/dist/services/setup/extension/webstore.spec.d.ts

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

package/dist/services/setup/extension/webstore.spec.js

@@ -0,0 +1,51 @@
+import { expect } from "chai";
+import { describe, it } from "mocha";
+import { buildCrxUrl, buildUpdateCheckUrl, compareVersions, parseExtensionId, parseUpdateCheckVersion, } from "./webstore.js";
+const ID = "fmkadmapgofadopljbjfkapdkoienihi";
+describe("webstore.parseExtensionId", () => {
+    it("accepts a bare 32-char id", () => {
+        expect(parseExtensionId(ID)).to.equal(ID);
+    });
+    it("extracts the id from a current Web Store URL", () => {
+        expect(parseExtensionId(`https://chromewebstore.google.com/detail/react-developer-tools/${ID}`)).to.equal(ID);
+    });
+    it("extracts the id from a legacy Web Store URL with query", () => {
+        expect(parseExtensionId(`https://chrome.google.com/webstore/detail/react/${ID}?hl=en`)).to.equal(ID);
+    });
+    it("returns null for input without an id", () => {
+        expect(parseExtensionId("not-an-extension")).to.equal(null);
+        expect(parseExtensionId("")).to.equal(null);
+    });
+});
+describe("webstore URL builders", () => {
+    it("builds a redirecting CRX download URL with the id and prodversion", () => {
+        const url = buildCrxUrl(ID, "131");
+        expect(url).to.contain("response=redirect");
+        expect(url).to.contain("prodversion=131");
+        expect(url).to.contain(encodeURIComponent(`id=${ID}`));
+    });
+    it("builds an update-check URL that reports the latest version", () => {
+        const url = buildUpdateCheckUrl(ID, "131");
+        expect(url).to.contain("response=updatecheck");
+        expect(url).to.contain(encodeURIComponent("installsource=ondemand"));
+    });
+});
+describe("webstore.parseUpdateCheckVersion", () => {
+    it("parses the version from an update response", () => {
+        const xml = `<gupdate><app appid="${ID}">` +
+            `<updatecheck status="ok" codebase="https://x/ext.crx" version="4.28.0"/>` +
+            `</app></gupdate>`;
+        expect(parseUpdateCheckVersion(xml)).to.equal("4.28.0");
+    });
+    it("returns null when there is no update", () => {
+        const xml = `<updatecheck status="noupdate"/>`;
+        expect(parseUpdateCheckVersion(xml)).to.equal(null);
+    });
+});
+describe("webstore.compareVersions", () => {
+    it("handles 4-part Chrome-style versions", () => {
+        expect(compareVersions("1.2.3.4", "1.2.3.3")).to.be.greaterThan(0);
+        expect(compareVersions("1.2.0.0", "1.10.0.0")).to.be.lessThan(0);
+        expect(compareVersions("2.0", "2.0.0.0")).to.equal(0);
+    });
+});

package/dist/services/setup/index.d.ts

@@ -6,5 +6,9 @@ export * from "./browser/browser-manager.js";
 export * from "./browser/browser-setup-service.js";
 export * from "./difftool/difftool-detector.js";
 export * from "./difftool/difftool-setup-service.js";
+export * from "./extension/webstore.js";
+export * from "./extension/crx.js";
+export * from "./extension/extension-installer.js";
+export * from "./extension/extension-setup-service.js";
 export * from "./os/tool-registry.js";
 export * from "./os/detector-helper.js";

package/dist/services/setup/index.js

@@ -6,5 +6,9 @@ export * from "./browser/browser-manager.js";
 export * from "./browser/browser-setup-service.js";
 export * from "./difftool/difftool-detector.js";
 export * from "./difftool/difftool-setup-service.js";
+export * from "./extension/webstore.js";
+export * from "./extension/crx.js";
+export * from "./extension/extension-installer.js";
+export * from "./extension/extension-setup-service.js";
 export * from "./os/tool-registry.js";
 export * from "./os/detector-helper.js";

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

@@ -6,6 +6,8 @@ import { BrowserManager } from "./browser/browser-manager.js";
 import { BrowserSetupService } from "./browser/browser-setup-service.js";
 import { DiffToolDetector } from "./difftool/difftool-detector.js";
 import { DiffToolSetupService } from "./difftool/difftool-setup-service.js";
+import { ExtensionInstaller, resolveChromeMajorVersion, } from "./extension/extension-installer.js";
+import { ExtensionSetupService } from "./extension/extension-setup-service.js";
 import { SetupContext } from "./setup-context.js";
 import { SetupService } from "./setup-service.js";
 export class SetupServiceFactory {
@@ -31,7 +33,9 @@ export class SetupServiceFactory {
         const browserSetup = new BrowserSetupService(cli, cliConfig, userConfig, browserDetector, browserManager);
         const diffDetector = new DiffToolDetector(platform, home);
         const diffSetup = new DiffToolSetupService(cli, cliConfig, userConfig, diffDetector);
-        this.service = new SetupService(cli, cliConfig, userConfig, browserSetup, diffSetup, this.context);
+        const extensionInstaller = new ExtensionInstaller(cacheDir, resolveChromeMajorVersion(userConfig.browserBuildId));
+        const extensionSetup = new ExtensionSetupService(cli, cliConfig, userConfig, extensionInstaller);
+        this.service = new SetupService(cli, cliConfig, userConfig, browserSetup, diffSetup, extensionSetup, this.context);
         return this.service;
     }
 }

package/dist/services/setup/setup-service.d.ts

@@ -2,6 +2,7 @@ import { CliServiceInterface } from "../cli/index.js";
 import { CliConfig, UserCliConfig } from "../../helpers/cli-config.js";
 import { BrowserSetupService } from "./browser/browser-setup-service.js";
 import { DiffToolSetupService } from "./difftool/difftool-setup-service.js";
+import { ExtensionSetupService } from "./extension/extension-setup-service.js";
 import { SetupContext } from "./setup-context.js";
 export declare class SetupService {
     private readonly cli;
@@ -9,12 +10,20 @@ export declare class SetupService {
     private readonly userConfig;
     private readonly browserSetup;
     private readonly diffSetup;
+    private readonly extensionSetup;
     private readonly context;
-    constructor(cli: CliServiceInterface, cliConfig: CliConfig, userConfig: UserCliConfig, browserSetup: BrowserSetupService, diffSetup: DiffToolSetupService, context: SetupContext);
-    /** Runs the full first-run wizard (browser + diff tool) and marks it done. */
+    constructor(cli: CliServiceInterface, cliConfig: CliConfig, userConfig: UserCliConfig, browserSetup: BrowserSetupService, diffSetup: DiffToolSetupService, extensionSetup: ExtensionSetupService, context: SetupContext);
+    /**
+     * Runs the full first-run wizard (browser + diff tool + extensions) and marks
+     * it done.
+     */
     run(): Promise<void>;
     /** True when the first-run wizard has already been completed once. */
     isFirstRunCompleted(): boolean;
     /** Update-reminder check for the browser, used by the init hook. */
     remindBrowserUpdate(): Promise<void>;
+    /** Daily update-reminder check for managed extensions, used by the init hook. */
+    remindExtensionUpdates(): Promise<void>;
+    /** Extension management operations exposed for the `sk extension` commands. */
+    get extensions(): ExtensionSetupService;
 }

package/dist/services/setup/setup-service.js

@@ -4,24 +4,31 @@ export class SetupService {
     userConfig;
     browserSetup;
     diffSetup;
+    extensionSetup;
     context;
-    constructor(cli, cliConfig, userConfig, browserSetup, diffSetup, context) {
+    constructor(cli, cliConfig, userConfig, browserSetup, diffSetup, extensionSetup, context) {
         this.cli = cli;
         this.cliConfig = cliConfig;
         this.userConfig = userConfig;
         this.browserSetup = browserSetup;
         this.diffSetup = diffSetup;
+        this.extensionSetup = extensionSetup;
         this.context = context;
     }
-    /** Runs the full first-run wizard (browser + diff tool) and marks it done. */
+    /**
+     * Runs the full first-run wizard (browser + diff tool + extensions) and marks
+     * it done.
+     */
     async run() {
         this.cli.spacer();
         this.cli.write(this.cli.style.bold("Speed Kit CLI — setup"));
-        this.cli.comment("Configure the browser and diff tool used for onboarding and deploys.");
+        this.cli.comment("Configure the browser, diff tool and extensions used for onboarding.");
         this.cli.spacer();
         await this.browserSetup.run();
         this.cli.spacer();
         await this.diffSetup.run();
+        this.cli.spacer();
+        await this.extensionSetup.run();
         this.cliConfig.save({ firstRunCompleted: true });
         this.cli.spacer();
         this.cli.writeSuccess("Setup complete. Re-run any time with `sk config setup`.");
@@ -34,4 +41,12 @@ export class SetupService {
     async remindBrowserUpdate() {
         await this.browserSetup.remindIfDue();
     }
+    /** Daily update-reminder check for managed extensions, used by the init hook. */
+    async remindExtensionUpdates() {
+        await this.extensionSetup.remindIfDue();
+    }
+    /** Extension management operations exposed for the `sk extension` commands. */
+    get extensions() {
+        return this.extensionSetup;
+    }
 }

package/oclif.manifest.json

@@ -402,6 +402,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "templates": {
+          "description": "Path to the templates/ root (default: the sk-onboarding checkout the CLI runs in, or the sk-onboarding repo on GitLab when run standalone)",
+          "name": "templates",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "mode": {
+          "description": "Which config to scaffold: the full acceleration config, or the tracking-only pre-PoC config",
+          "name": "mode",
+          "default": "customer-config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "customer-config",
+            "pre-poc"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -999,7 +1018,118 @@
         "config",
         "setup.js"
       ]
+    },
+    "extension:add": {
+      "aliases": [],
+      "args": {
+        "ref": {
+          "description": "Chrome Web Store link or extension id",
+          "name": "ref",
+          "required": false
+        }
+      },
+      "description": "Install a Chrome extension into the onboarding browser by Web Store link or id",
+      "examples": [
+        "$ sk extension add fmkadmapgofadopljbjfkapdkoienihi",
+        "$ sk extension add https://chromewebstore.google.com/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi",
+        "$ sk extension add"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "extension:add",
+      "pluginAlias": "@speedkit/cli",
+      "pluginName": "@speedkit/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "extension",
+        "add.js"
+      ]
+    },
+    "extension:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Chrome extensions managed by the setup wizard",
+      "examples": [
+        "$ sk extension list"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "extension:list",
+      "pluginAlias": "@speedkit/cli",
+      "pluginName": "@speedkit/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "extension",
+        "list.js"
+      ]
+    },
+    "extension:remove": {
+      "aliases": [],
+      "args": {
+        "ref": {
+          "description": "Chrome Web Store link or extension id",
+          "name": "ref",
+          "required": false
+        }
+      },
+      "description": "Remove a managed Chrome extension",
+      "examples": [
+        "$ sk extension remove",
+        "$ sk extension remove <id>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "extension:remove",
+      "pluginAlias": "@speedkit/cli",
+      "pluginName": "@speedkit/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "extension",
+        "remove.js"
+      ]
+    },
+    "extension:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Check managed Chrome extensions for updates and install them",
+      "examples": [
+        "$ sk extension update"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "extension:update",
+      "pluginAlias": "@speedkit/cli",
+      "pluginName": "@speedkit/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "extension",
+        "update.js"
+      ]
     }
   },
-  "version": "4.20.5"
+  "version": "4.22.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@speedkit/cli",
   "description": "Speed Kit CLI",
-  "version": "4.20.5",
+  "version": "4.22.0",
   "author": {
     "name": "Baqend.com",
     "email": "info@baqend.com"
@@ -110,6 +110,7 @@
     "iconv-lite": "^0.7.2",
     "json2csv": "^6.0.0-alpha.2",
     "node-fetch": "^3.3.2",
+    "nunjucks": "^3.2.4",
     "nypm": "^0.6.6",
     "puppeteer": "^24.41.0",
     "puppeteer-extra": "^3.3.6",
@@ -128,6 +129,7 @@
     "@oclif/test": "^4.1.18",
     "@types/chai": "^4.3.10",
     "@types/node": "^25.6.0",
+    "@types/nunjucks": "^3.2.6",
     "@types/uuid": "^9.0.8",
     "chai": "^4.4.1",
     "copyfiles": "^2.4.1",
@@ -154,5 +156,10 @@
     "*.ts": [
       "eslint --fix --quiet"
     ]
+  },
+  "overrides": {
+    "nunjucks": {
+      "chokidar": "$chokidar"
+    }
   }
 }