@flowscripter/dynamic-cli-framework 2.2.0 → 2.3.1

package/dist/src/cli/BaseCLI.d.ts

@@ -25,6 +25,8 @@ import type BaseCLIFeatureOptions from "./BaseCLIFeatureOptions.ts";
  *
  * * {@link ImagePrinterServiceProvider}
  * * {@link SpawnServiceProvider}
+ * * {@link CompletionServiceProvider}
+ * * {@link UpgradeServiceProvider}
  *
  * `keyReader` is optional. If omitted, or if the stderr {@link Terminal} is not a TTY, prompting is
  * unavailable: {@link PrompterServiceProvider} (and {@link ArgumentPrompterServiceProvider}, if

package/dist/src/cli/BaseCLI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCLI.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4BzE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AAapE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,YAAW,GAAG;;gBAavC,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,cAAc,EACpC,oBAAoB,EAAE,cAAc,EACpC,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB;IA4DjC;;;;;;;OAOG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe;IAI1D;;;;;;;;OAQG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO;IAU5B,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;CAuL3D"}
+{"version":3,"file":"BaseCLI.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4BzE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AAcpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,YAAW,GAAG;;gBAavC,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,cAAc,EACpC,oBAAoB,EAAE,cAAc,EACpC,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB;IA8DjC;;;;;;;OAOG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe;IAI1D;;;;;;;;OAQG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO;IAU5B,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;CA2L3D"}

package/dist/src/cli/BaseCLI.js

@@ -26,6 +26,7 @@ import DefaultCompletionService from "../service/completion/DefaultCompletionSer
 import CompletionServiceProvider from "../service/completion/CompletionServiceProvider.js";
 import ImagePrinterServiceProvider from "../service/imagePrinter/ImagePrinterServiceProvider.js";
 import SpawnServiceProvider from "../service/spawn/SpawnServiceProvider.js";
+import UpgradeServiceProvider from "../service/upgrade/UpgradeServiceProvider.js";
 const logger = getLogger("BaseCLI");
 /**
  * Base implementation of a {@link CLI}.
@@ -44,6 +45,8 @@ const logger = getLogger("BaseCLI");
  *
  * * {@link ImagePrinterServiceProvider}
  * * {@link SpawnServiceProvider}
+ * * {@link CompletionServiceProvider}
+ * * {@link UpgradeServiceProvider}
  *
  * `keyReader` is optional. If omitted, or if the stderr {@link Terminal} is not a TTY, prompting is
  * unavailable: {@link PrompterServiceProvider} (and {@link ArgumentPrompterServiceProvider}, if
@@ -92,6 +95,8 @@ export default class BaseCLI {
             completionServiceEnabled: false,
             imagePrinterServiceEnabled: false,
             spawnServiceEnabled: false,
+            upgradeServiceEnabled: false,
+            upgradeLocationsConfig: { supportedPlatforms: [] },
             validateAllCommands: false,
             promptingEnabled: true,
             ...options,
@@ -191,6 +196,9 @@ export default class BaseCLI {
             const completionService = new DefaultCompletionService();
             this.addServiceProvider(new CompletionServiceProvider(5, completionService, this.#commandRegistry));
         }
+        if (this.#options.upgradeServiceEnabled) {
+            this.addServiceProvider(new UpgradeServiceProvider(6, this.#options.upgradeLocationsConfig));
+        }
         const configurationServiceProvider = new ConfigurationServiceProvider(90, this.#options.envVarsSupportEnabled, this.#options.configFileSupportEnabled, this.#options.keyValueServiceEnabled, this.#options.secretServiceEnabled);
         this.addServiceProvider(configurationServiceProvider);
         for (const serviceProvider of this.#serviceProviderRegistry.getServiceProviders()) {

package/dist/src/cli/BaseCLIFeatureOptions.d.ts

@@ -1,3 +1,4 @@
+import type { UpgradeLocationsConfig } from "../service/upgrade/UpgradeLocationsConfig.ts";
 export default interface BaseCLIFeatureOptions {
     readonly configFileSupportEnabled?: boolean;
     readonly envVarsSupportEnabled?: boolean;
@@ -7,6 +8,8 @@ export default interface BaseCLIFeatureOptions {
     readonly completionServiceEnabled?: boolean;
     readonly imagePrinterServiceEnabled?: boolean;
     readonly spawnServiceEnabled?: boolean;
+    readonly upgradeServiceEnabled?: boolean;
+    readonly upgradeLocationsConfig?: UpgradeLocationsConfig;
     readonly validateAllCommands?: boolean;
     readonly promptingEnabled?: boolean;
 }

package/dist/src/cli/BaseCLIFeatureOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCLIFeatureOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLIFeatureOptions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,WAAW,qBAAqB;IAC5C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC"}
+{"version":3,"file":"BaseCLIFeatureOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLIFeatureOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAE3F,MAAM,CAAC,OAAO,WAAW,qBAAqB;IAC5C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAClD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC"}

package/dist/src/command/VersionCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VersionCommand.d.ts","sourceRoot":"","sources":["../../../src/command/VersionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAI7E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,aAAa;IAC1D,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,8BAA8B;IAClD,QAAQ,CAAC,UAAU,OAAO;IAEb,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAItD"}
+{"version":3,"file":"VersionCommand.d.ts","sourceRoot":"","sources":["../../../src/command/VersionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAM7E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,aAAa;IAC1D,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,8BAA8B;IAClD,QAAQ,CAAC,UAAU,OAAO;IAEb,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CActD"}

package/dist/src/command/VersionCommand.js

@@ -1,4 +1,5 @@
 import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { UPGRADE_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 /**
  * Implementation of a {@link GlobalCommand} which outputs the version of the CLI.
  */
@@ -8,6 +9,14 @@ export default class VersionCommand {
     shortAlias = "v";
     async execute(context) {
         const printerService = context.getServiceById(PRINTER_SERVICE_ID);
-        await printerService.print(`${context.cliConfig.version}\n`);
+        let line = context.cliConfig.version;
+        if (context.doesServiceExist(UPGRADE_SERVICE_ID)) {
+            const upgradeService = context.getServiceById(UPGRADE_SERVICE_ID);
+            const result = await upgradeService.checkForUpgrade().catch(() => undefined);
+            if (result?.updateAvailable) {
+                line += ` (${result.latestVersion} available, run '${context.cliConfig.name} upgrade')`;
+            }
+        }
+        await printerService.print(`${line}\n`);
     }
 }

package/dist/src/service/banner/BannerServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BannerServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/banner/BannerServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAI5F,OAAO,KAAK,4BAA4B,MAAM,kDAAkD,CAAC;AAGjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,eAAO,MAAM,iBAAiB,uDAAuD,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAsB,YAAW,eAAe;;IAoBjE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAqB;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAGjC;;OAEG;IACH,WAAW,UAAQ;IAEnB;;;;;;OAMG;gBAED,eAAe,EAAE,MAAM,EACvB,4BAA4B,CAAC,EAAE,4BAA4B,EAC1C,QAAQ,GAAE,MAAmB;IAMzC,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAM5D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAgCnD"}
+{"version":3,"file":"BannerServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/banner/BannerServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAI5F,OAAO,KAAK,4BAA4B,MAAM,kDAAkD,CAAC;AAGjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,eAAO,MAAM,iBAAiB,uDAAuD,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAsB,YAAW,eAAe;;IAoBjE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAqB;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAGjC;;OAEG;IACH,WAAW,UAAQ;IAEnB;;;;;;OAMG;gBAED,eAAe,EAAE,MAAM,EACvB,4BAA4B,CAAC,EAAE,4BAA4B,EAC1C,QAAQ,GAAE,MAAmB;IAMzC,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAM5D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA2CnD"}

package/dist/src/service/banner/BannerServiceProvider.js

@@ -1,6 +1,7 @@
 import NoBannerCommand from "./command/NoBannerCommand.js";
 import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import { ASCII_BANNER_GENERATOR_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { UPGRADE_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 export const BANNER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/banner-service";
 /**
  * Provides ascii banner functionality.
@@ -49,6 +50,13 @@ export default class BannerServiceProvider {
         if (cliConfig.version.length > 0) {
             await printerService.info(`  ${printerService.secondary("version: " + cliConfig.version)}\n`);
         }
+        if (context.doesServiceExist(UPGRADE_SERVICE_ID)) {
+            const upgradeService = context.getServiceById(UPGRADE_SERVICE_ID);
+            const result = await upgradeService.checkForUpgrade().catch(() => undefined);
+            if (result?.updateAvailable) {
+                await printerService.info(`  ${printerService.secondary(`(${result.latestVersion} available, run '${cliConfig.name} upgrade')`)}\n`);
+            }
+        }
         if (this.#configurationServiceProvider) {
             const configLocation = this.#configurationServiceProvider.configLocation;
             if (configLocation && configLocation.length > 0) {

package/dist/src/service/spawn/DefaultSpawnService.d.ts

@@ -1,4 +1,10 @@
 import type { PrinterService, ShutdownService, SpawnOptions, SpawnResult, SpawnService } from "@flowscripter/dynamic-cli-framework-api";
+/**
+ * On Windows, batch-file shims (e.g. `npm.cmd`, `bun.cmd`) cannot be launched directly via
+ * `CreateProcess` - they must be run through `cmd.exe /c`. Resolve the command through the shell
+ * in that case; leave it untouched on other platforms.
+ */
+export declare function resolveForPlatform(command: ReadonlyArray<string>): string[];
 export default class DefaultSpawnService implements SpawnService {
     #private;
     setDependencies(printerService: PrinterService, shutdownService: ShutdownService): void;

package/dist/src/service/spawn/DefaultSpawnService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultSpawnService.d.ts","sourceRoot":"","sources":["../../../../src/service/spawn/DefaultSpawnService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,yCAAyC,CAAC;AAOjD,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAIvD,eAAe,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI;IAkCjF,KAAK,CAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC;CAgExB"}
+{"version":3,"file":"DefaultSpawnService.d.ts","sourceRoot":"","sources":["../../../../src/service/spawn/DefaultSpawnService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,yCAAyC,CAAC;AAOjD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAa3E;AAED,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAIvD,eAAe,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI;IAkCjF,KAAK,CAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC;CAiExB"}

package/dist/src/service/spawn/DefaultSpawnService.js

@@ -1,6 +1,26 @@
+import process from "node:process";
 import getLogger from "../../util/logger.js";
 const logger = getLogger("DefaultSpawnService");
 const SHUTDOWN_GRACE_PERIOD_MS = 5000;
+/**
+ * On Windows, batch-file shims (e.g. `npm.cmd`, `bun.cmd`) cannot be launched directly via
+ * `CreateProcess` - they must be run through `cmd.exe /c`. Resolve the command through the shell
+ * in that case; leave it untouched on other platforms.
+ */
+export function resolveForPlatform(command) {
+    if (process.platform !== "win32") {
+        return [...command];
+    }
+    const [bin, ...args] = command;
+    if (bin === undefined) {
+        return [...command];
+    }
+    const resolved = Bun.which(bin) ?? bin;
+    if (!/\.(cmd|bat)$/i.test(resolved)) {
+        return [resolved, ...args];
+    }
+    return ["cmd.exe", "/d", "/s", "/c", resolved, ...args];
+}
 export default class DefaultSpawnService {
     #printerService;
     #shutdownService;
@@ -46,8 +66,9 @@ export default class DefaultSpawnService {
         }
         let proc;
         try {
-            proc = Bun.spawn([...command], {
+            proc = Bun.spawn(resolveForPlatform(command), {
                 cwd: options.cwd,
+                stdin: stdio === "wrapped" ? "ignore" : "inherit",
                 stdout: stdio === "wrapped" ? "pipe" : "inherit",
                 stderr: stdio === "wrapped" ? "pipe" : "inherit",
             });

package/dist/src/service/upgrade/DefaultUpgradeService.d.ts

@@ -0,0 +1,14 @@
+import type { CLIConfig, SpawnService, UpgradeCheckResult, UpgradeResult } from "@flowscripter/dynamic-cli-framework-api";
+import { InstallMethod, SupportedArch, SupportedOs, type UpgradeService } from "@flowscripter/dynamic-cli-framework-api";
+import type { UpgradeLocationsConfig } from "./UpgradeLocationsConfig.ts";
+export default class DefaultUpgradeService implements UpgradeService {
+    #private;
+    constructor(config: UpgradeLocationsConfig, cliConfig: CLIConfig);
+    setDependencies(spawnService: SpawnService): void;
+    detectOs(): SupportedOs | undefined;
+    detectArch(): SupportedArch | undefined;
+    detectInstallMethod(os: SupportedOs): Promise<InstallMethod | undefined>;
+    checkForUpgrade(osOverride?: SupportedOs, archOverride?: SupportedArch, installMethodOverride?: InstallMethod): Promise<UpgradeCheckResult | undefined>;
+    upgrade(osOverride?: SupportedOs, archOverride?: SupportedArch, installMethodOverride?: InstallMethod): Promise<UpgradeResult>;
+}
+//# sourceMappingURL=DefaultUpgradeService.d.ts.map

package/dist/src/service/upgrade/DefaultUpgradeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultUpgradeService.d.ts","sourceRoot":"","sources":["../../../../src/service/upgrade/DefaultUpgradeService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,KAAK,cAAc,EACpB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAW1E,MAAM,CAAC,OAAO,OAAO,qBAAsB,YAAW,cAAc;;gBAK/C,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,SAAS;IAKhE,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAIjD,QAAQ,IAAI,WAAW,GAAG,SAAS;IAanC,UAAU,IAAI,aAAa,GAAG,SAAS;IAWjC,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAgBxE,eAAe,CAC1B,UAAU,CAAC,EAAE,WAAW,EACxB,YAAY,CAAC,EAAE,aAAa,EAC5B,qBAAqB,CAAC,EAAE,aAAa,GACpC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAmC7B,OAAO,CAClB,UAAU,CAAC,EAAE,WAAW,EACxB,YAAY,CAAC,EAAE,aAAa,EAC5B,qBAAqB,CAAC,EAAE,aAAa,GACpC,OAAO,CAAC,aAAa,CAAC;CA6P1B"}

package/dist/src/service/upgrade/DefaultUpgradeService.js

@@ -0,0 +1,312 @@
+import process from "node:process";
+import { mkdtemp } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { InstallMethod, SupportedArch, SupportedOs, } from "@flowscripter/dynamic-cli-framework-api";
+import semver from "semver";
+import getLogger from "../../util/logger.js";
+const logger = getLogger("DefaultUpgradeService");
+const OS_LABELS = {
+    [SupportedOs.LINUX]: "Linux",
+    [SupportedOs.MACOS]: "MacOS",
+    [SupportedOs.WINDOWS]: "Windows",
+};
+export default class DefaultUpgradeService {
+    #spawnService;
+    #config;
+    #cliConfig;
+    constructor(config, cliConfig) {
+        this.#config = config;
+        this.#cliConfig = cliConfig;
+    }
+    setDependencies(spawnService) {
+        this.#spawnService = spawnService;
+    }
+    detectOs() {
+        switch (process.platform) {
+            case "linux":
+                return SupportedOs.LINUX;
+            case "darwin":
+                return SupportedOs.MACOS;
+            case "win32":
+                return SupportedOs.WINDOWS;
+            default:
+                return undefined;
+        }
+    }
+    detectArch() {
+        switch (process.arch) {
+            case "x64":
+                return SupportedArch.X64;
+            case "arm64":
+                return SupportedArch.ARM64;
+            default:
+                return undefined;
+        }
+    }
+    async detectInstallMethod(os) {
+        if (os === SupportedOs.MACOS && this.#config.homebrew && (await this.#isHomebrewInstalled())) {
+            return InstallMethod.HOMEBREW;
+        }
+        if (os === SupportedOs.WINDOWS && this.#config.winget && (await this.#isWingetInstalled())) {
+            return InstallMethod.WINGET;
+        }
+        if (os === SupportedOs.LINUX && this.#config.linuxScript && this.#isLinuxScriptInstall()) {
+            return InstallMethod.LINUX_SCRIPT;
+        }
+        if (this.#config.githubRelease) {
+            return InstallMethod.GITHUB_RELEASE;
+        }
+        return undefined;
+    }
+    async checkForUpgrade(osOverride, archOverride, installMethodOverride) {
+        const os = osOverride ?? this.detectOs();
+        const arch = archOverride ?? this.detectArch();
+        if (!os || !arch || !this.#isPlatformSupported(os, arch)) {
+            return undefined;
+        }
+        const installMethod = installMethodOverride ?? (await this.detectInstallMethod(os));
+        if (!installMethod) {
+            return undefined;
+        }
+        const latestVersion = await this.#getLatestVersion(installMethod);
+        if (!latestVersion) {
+            return undefined;
+        }
+        const currentVersion = this.#cliConfig.version;
+        const coercedCurrent = semver.coerce(currentVersion);
+        const coercedLatest = semver.coerce(latestVersion);
+        if (!coercedCurrent || !coercedLatest) {
+            logger.debug(() => `Unable to compare versions '${currentVersion}' and '${latestVersion}'`);
+            return undefined;
+        }
+        return {
+            currentVersion,
+            latestVersion,
+            updateAvailable: semver.gt(coercedLatest, coercedCurrent),
+            os,
+            arch,
+            installMethod,
+        };
+    }
+    async upgrade(osOverride, archOverride, installMethodOverride) {
+        const oldVersion = this.#cliConfig.version;
+        const checkResult = await this.checkForUpgrade(osOverride, archOverride, installMethodOverride);
+        if (!checkResult) {
+            return {
+                ok: false,
+                oldVersion,
+                error: new Error("No upgrade location configured for the detected or requested platform"),
+            };
+        }
+        if (!this.#spawnService) {
+            return { ok: false, oldVersion, error: new Error("SpawnService is not available") };
+        }
+        try {
+            switch (checkResult.installMethod) {
+                case InstallMethod.LINUX_SCRIPT:
+                    await this.#upgradeViaLinuxScript();
+                    break;
+                case InstallMethod.HOMEBREW:
+                    await this.#upgradeViaHomebrew();
+                    break;
+                case InstallMethod.WINGET:
+                    await this.#upgradeViaWinget();
+                    break;
+                case InstallMethod.GITHUB_RELEASE:
+                    await this.#upgradeViaGithubRelease(checkResult.os, checkResult.arch);
+                    break;
+            }
+            return { ok: true, oldVersion, newVersion: checkResult.latestVersion };
+        }
+        catch (error) {
+            return { ok: false, oldVersion, error: error };
+        }
+    }
+    #isPlatformSupported(os, arch) {
+        return this.#config.supportedPlatforms.some((platform) => platform.os === os && platform.arch === arch);
+    }
+    async #isHomebrewInstalled() {
+        if (!this.#spawnService || !this.#config.homebrew) {
+            return false;
+        }
+        const result = await this.#spawnService.spawn(["brew", "list", "--versions", this.#config.homebrew.formula], { stdio: "wrapped", longRunning: false });
+        return result.ok;
+    }
+    async #isWingetInstalled() {
+        if (!this.#spawnService || !this.#config.winget) {
+            return false;
+        }
+        const result = await this.#spawnService.spawn(["winget", "list", "--id", this.#config.winget.packageId], { stdio: "wrapped", longRunning: false });
+        return result.ok;
+    }
+    #isLinuxScriptInstall() {
+        return process.execPath.startsWith("/usr/local/bin/");
+    }
+    async #getLatestVersion(installMethod) {
+        switch (installMethod) {
+            case InstallMethod.GITHUB_RELEASE:
+            case InstallMethod.LINUX_SCRIPT:
+                return this.#getLatestGithubReleaseVersion();
+            case InstallMethod.HOMEBREW:
+                return this.#getLatestHomebrewVersion();
+            case InstallMethod.WINGET:
+                return this.#getLatestWingetVersion();
+            default:
+                return undefined;
+        }
+    }
+    async #getLatestGithubReleaseVersion() {
+        if (!this.#config.githubRelease) {
+            return undefined;
+        }
+        const { owner, repo } = this.#config.githubRelease;
+        try {
+            const response = await fetch(`https://api.github.com/repos/${owner}/${repo}/releases/latest`);
+            if (!response.ok) {
+                return undefined;
+            }
+            const data = (await response.json());
+            return data.tag_name?.replace(/^v/, "");
+        }
+        catch (error) {
+            logger.debug(() => `Failed to fetch latest GitHub release for ${owner}/${repo}: ${error}`);
+            return undefined;
+        }
+    }
+    async #getLatestHomebrewVersion() {
+        if (!this.#config.homebrew) {
+            return undefined;
+        }
+        const { tap, formula } = this.#config.homebrew;
+        const [tapOwner, tapName] = tap.split("/");
+        if (!tapOwner || !tapName) {
+            return undefined;
+        }
+        try {
+            const response = await fetch(`https://raw.githubusercontent.com/${tapOwner}/homebrew-${tapName}/main/${formula}.rb`);
+            if (!response.ok) {
+                return undefined;
+            }
+            const text = await response.text();
+            return /version\s+"v?([^"]+)"/.exec(text)?.[1];
+        }
+        catch (error) {
+            logger.debug(() => `Failed to fetch homebrew formula for ${tap}/${formula}: ${error}`);
+            return undefined;
+        }
+    }
+    async #getLatestWingetVersion() {
+        if (!this.#spawnService || !this.#config.winget) {
+            return undefined;
+        }
+        const lines = [];
+        const result = await this.#spawnService.spawn(["winget", "show", "--id", this.#config.winget.packageId], {
+            stdio: "wrapped",
+            longRunning: false,
+            onOutput: (line) => lines.push(line),
+        });
+        if (!result.ok) {
+            return undefined;
+        }
+        for (const line of lines) {
+            const match = /Version:\s*(\S+)/.exec(line);
+            if (match?.[1]) {
+                return match[1];
+            }
+        }
+        return undefined;
+    }
+    async #upgradeViaLinuxScript() {
+        const { scriptUrl } = this.#config.linuxScript;
+        const result = await this.#spawnService.spawn(["sh", "-c", `curl -fsSL ${scriptUrl} | sh`]);
+        if (!result.ok) {
+            throw new Error(`Install script failed: ${result.error?.message ?? `exit code ${result.exitCode}`}`);
+        }
+    }
+    async #upgradeViaHomebrew() {
+        const { tap, formula } = this.#config.homebrew;
+        const result = await this.#spawnService.spawn(["brew", "upgrade", `${tap}/${formula}`]);
+        if (!result.ok) {
+            throw new Error(`brew upgrade failed: ${result.error?.message ?? `exit code ${result.exitCode}`}`);
+        }
+    }
+    async #upgradeViaWinget() {
+        const { packageId } = this.#config.winget;
+        const result = await this.#spawnService.spawn([
+            "winget",
+            "upgrade",
+            "--id",
+            packageId,
+            "--silent",
+            "--accept-package-agreements",
+            "--accept-source-agreements",
+        ]);
+        if (!result.ok) {
+            throw new Error(`winget upgrade failed: ${result.error?.message ?? `exit code ${result.exitCode}`}`);
+        }
+    }
+    async #upgradeViaGithubRelease(os, arch) {
+        const { owner, repo, assetPattern } = this.#config.githubRelease;
+        const archLabel = os === SupportedOs.MACOS ? "aarch64" : arch === SupportedArch.X64 ? "x64" : "arm64";
+        const assetName = assetPattern.replace("{os}", OS_LABELS[os]).replace("{arch}", archLabel);
+        const url = `https://github.com/${owner}/${repo}/releases/latest/download/${assetName}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to download release asset '${assetName}': HTTP ${response.status}`);
+        }
+        const tmpDir = await mkdtemp(join(tmpdir(), "upgrade-"));
+        const archivePath = join(tmpDir, assetName);
+        await Bun.write(archivePath, await response.arrayBuffer());
+        const currentExecutable = process.execPath;
+        if (os === SupportedOs.WINDOWS) {
+            const extractResult = await this.#spawnService.spawn([
+                "powershell",
+                "-Command",
+                `Expand-Archive -Path '${archivePath}' -DestinationPath '${tmpDir}' -Force`,
+            ]);
+            if (!extractResult.ok) {
+                throw new Error("Failed to extract release archive");
+            }
+            const extractedBinary = join(tmpDir, `${this.#cliConfig.name}.exe`);
+            const oldPath = `${currentExecutable}.old.exe`;
+            const moveResult = await this.#spawnService.spawn([
+                "cmd",
+                "/c",
+                "move",
+                "/y",
+                currentExecutable,
+                oldPath,
+            ]);
+            if (!moveResult.ok) {
+                throw new Error("Failed to move current executable aside");
+            }
+            const copyResult = await this.#spawnService.spawn([
+                "cmd",
+                "/c",
+                "copy",
+                "/y",
+                extractedBinary,
+                currentExecutable,
+            ]);
+            if (!copyResult.ok) {
+                throw new Error("Failed to copy new executable into place");
+            }
+        }
+        else {
+            const extractResult = await this.#spawnService.spawn([
+                "unzip",
+                "-o",
+                archivePath,
+                "-d",
+                tmpDir,
+            ]);
+            if (!extractResult.ok) {
+                throw new Error("Failed to extract release archive");
+            }
+            const extractedBinary = join(tmpDir, this.#cliConfig.name);
+            await Bun.write(currentExecutable, Bun.file(extractedBinary));
+            await this.#spawnService.spawn(["chmod", "+x", currentExecutable]);
+        }
+    }
+}

package/dist/src/service/upgrade/UpgradeLocationsConfig.d.ts

@@ -0,0 +1,51 @@
+import type { SupportedArch, SupportedOs } from "@flowscripter/dynamic-cli-framework-api";
+/**
+ * Location of a manual GitHub release asset, and how to determine the latest available version.
+ */
+export interface GithubReleaseLocation {
+    readonly owner: string;
+    readonly repo: string;
+    /**
+     * Asset filename pattern for a release, e.g. `"example-cli_{os}_{arch}.zip"`.
+     * `{os}` is substituted with `Linux`, `MacOS` or `Windows`; `{arch}` with `x64`, `arm64` or
+     * `aarch64` (macOS).
+     */
+    readonly assetPattern: string;
+}
+/**
+ * Location of a Linux install script, e.g. as documented for `curl -fsSL <scriptUrl> | sh`.
+ */
+export interface LinuxScriptLocation {
+    readonly scriptUrl: string;
+}
+/**
+ * Location of a Homebrew tap formula, e.g. `brew install <tap>/<formula>`.
+ */
+export interface HomebrewLocation {
+    readonly tap: string;
+    readonly formula: string;
+}
+/**
+ * Identifier of a Winget package, e.g. `winget install <packageId>`.
+ */
+export interface WingetLocation {
+    readonly packageId: string;
+}
+/**
+ * CLI-author supplied configuration describing which os/arch combinations a CLI supports
+ * upgrading, and where to find the latest release for each supported install method.
+ *
+ * An install method is only usable for an os/arch combination if both its config block is
+ * present here AND that combination appears in {@link supportedPlatforms}.
+ */
+export interface UpgradeLocationsConfig {
+    readonly supportedPlatforms: ReadonlyArray<{
+        os: SupportedOs;
+        arch: SupportedArch;
+    }>;
+    readonly githubRelease?: GithubReleaseLocation;
+    readonly linuxScript?: LinuxScriptLocation;
+    readonly homebrew?: HomebrewLocation;
+    readonly winget?: WingetLocation;
+}
+//# sourceMappingURL=UpgradeLocationsConfig.d.ts.map

package/dist/src/service/upgrade/UpgradeLocationsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeLocationsConfig.d.ts","sourceRoot":"","sources":["../../../../src/service/upgrade/UpgradeLocationsConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAClC"}

package/dist/src/service/upgrade/UpgradeServiceProvider.d.ts

@@ -0,0 +1,13 @@
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
+import type { UpgradeLocationsConfig } from "./UpgradeLocationsConfig.ts";
+export default class UpgradeServiceProvider implements ServiceProvider {
+    #private;
+    readonly serviceId: string;
+    readonly servicePriority: number;
+    constructor(servicePriority: number, config: UpgradeLocationsConfig);
+    getServiceInfo(cliConfig: CLIConfig): Promise<ServiceInfo>;
+    initService(context: Context): Promise<void>;
+}
+//# sourceMappingURL=UpgradeServiceProvider.d.ts.map

package/dist/src/service/upgrade/UpgradeServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/upgrade/UpgradeServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAK1E,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAKd,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB;IAKnE,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IASpD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA6G1D"}