@flowscripter/dynamic-cli-framework-api 1.1.1 → 1.3.0

package/dist/index.d.ts

@@ -74,4 +74,7 @@ export { default as createCLIPlugin } from "./src/plugin/createCLIPlugin.ts";
 export type { CLIPluginOptions } from "./src/plugin/createCLIPlugin.ts";
 export { PLUGIN_SERVICE_ID } from "./src/service/core/PluginService.ts";
 export type { default as PluginService } from "./src/service/core/PluginService.ts";
+export { UPGRADE_SERVICE_ID, InstallMethod, SupportedArch, SupportedOs, } from "./src/service/core/UpgradeService.ts";
+export type { default as UpgradeService } from "./src/service/core/UpgradeService.ts";
+export type { UpgradeCheckResult, UpgradeResult } from "./src/service/core/UpgradeService.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACnG,YAAY,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,oCAAoC,EAAE,MAAM,iCAAiC,CAAC;AACvF,YAAY,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,YAAY,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChG,YAAY,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG1E,YAAY,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/E,YAAY,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/F,YAAY,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7E,YAAY,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7E,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGrF,YAAY,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpF,YAAY,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGpG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mDAAmD,CAAC;AACtG,YAAY,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAChH,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mDAAmD,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,YAAY,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxF,YAAY,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEhG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,YAAY,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,YAAY,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AAC/F,YAAY,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC1G,YAAY,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAElF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,YAAY,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,YAAY,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhG,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,YAAY,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9F,YAAY,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,YAAY,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpG,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAChG,YAAY,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,EACL,KAAK,cAAc,EACnB,UAAU,EACV,KAAK,sBAAsB,GAC5B,MAAM,gDAAgD,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,YAAY,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,YAAY,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EACL,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,UAAU,GACX,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAC7F,YAAY,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxG,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnD,YAAY,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,qDAAqD,EAAE,MAAM,gCAAgC,CAAC;AACvG,YAAY,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChG,OAAO,EAAE,8DAA8D,EAAE,MAAM,wCAAwC,CAAC;AACxH,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,WAAW,GACZ,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,OAAO,IAAI,SAAS,EACpB,iCAAiC,EACjC,yCAAyC,GAC1C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,YAAY,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtF,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -28,3 +28,4 @@ export { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./src/plu
 export { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./src/plugin/ServiceProviderFactory.js";
 export { default as createCLIPlugin } from "./src/plugin/createCLIPlugin.js";
 export { PLUGIN_SERVICE_ID } from "./src/service/core/PluginService.js";
+export { UPGRADE_SERVICE_ID, InstallMethod, SupportedArch, SupportedOs, } from "./src/service/core/UpgradeService.js";

package/dist/src/service/core/SpawnService.d.ts

@@ -4,7 +4,7 @@ export declare const SPAWN_SERVICE_ID = "@flowscripter/dynamic-cli-framework/spa
  *
  * `ok` is `true` only when the process launched and exited with code `0`. A launch failure (e.g.
  * the binary was not found) sets `error` with no `exitCode`; a non-zero exit sets `exitCode` with
- * no `error`.
+ * no `error`; a process that did not exit within {@link SpawnOptions.timeoutMs} sets `timedOut`.
  */
 export type SpawnResult = {
     ok: true;
@@ -13,6 +13,9 @@ export type SpawnResult = {
     ok: false;
     exitCode?: number;
     error?: Error;
+} | {
+    ok: false;
+    timedOut: true;
 };
 /**
  * Options for {@link SpawnService.spawn}.
@@ -40,6 +43,12 @@ export interface SpawnOptions {
      * `true`.
      */
     longRunning?: boolean;
+    /**
+     * If specified, the spawned process is aborted (`SIGTERM`, followed by `SIGKILL` if it has not
+     * exited after a grace period) if it has not exited within this many milliseconds. Defaults to
+     * unbounded.
+     */
+    timeoutMs?: number;
 }
 /**
  * Service allowing a {@link Command} to spawn a child process, with output optionally captured

package/dist/src/service/core/SpawnService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpawnService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/SpawnService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,sDAAsD,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAE/D;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,YAAY;IACnC;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACrF"}
+{"version":3,"file":"SpawnService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/SpawnService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,sDAAsD,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAE/D;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,YAAY;IACnC;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACrF"}

package/dist/src/service/core/UpgradeService.d.ts

@@ -0,0 +1,105 @@
+export declare const UPGRADE_SERVICE_ID = "@flowscripter/dynamic-cli-framework/upgrade-service";
+/**
+ * Operating systems an {@link UpgradeService} implementation may support.
+ */
+export declare enum SupportedOs {
+    LINUX = "linux",
+    MACOS = "macos",
+    WINDOWS = "windows"
+}
+/**
+ * CPU architectures an {@link UpgradeService} implementation may support.
+ */
+export declare enum SupportedArch {
+    X64 = "x64",
+    ARM64 = "arm64"
+}
+/**
+ * Mechanism by which the CLI was originally installed, and therefore how it should be upgraded.
+ */
+export declare enum InstallMethod {
+    LINUX_SCRIPT = "linux-script",
+    HOMEBREW = "homebrew",
+    WINGET = "winget",
+    GITHUB_RELEASE = "github-release"
+}
+/**
+ * Outcome of an {@link UpgradeService.checkForUpgrade} call.
+ */
+export interface UpgradeCheckResult {
+    readonly currentVersion: string;
+    readonly latestVersion: string;
+    readonly updateAvailable: boolean;
+    readonly os: SupportedOs;
+    readonly arch: SupportedArch;
+    readonly installMethod: InstallMethod;
+}
+/**
+ * Outcome of an {@link UpgradeService.upgrade} call.
+ */
+export interface UpgradeResult {
+    readonly ok: boolean;
+    readonly oldVersion: string;
+    readonly newVersion?: string;
+    readonly error?: Error;
+}
+/**
+ * Service allowing a {@link Command} to check for and install a newer version of the CLI itself.
+ */
+export default interface UpgradeService {
+    /**
+     * Detect the operating system the CLI is currently running on.
+     *
+     * @return the detected {@link SupportedOs}, or `undefined` if it is not supported.
+     */
+    detectOs(): SupportedOs | undefined;
+    /**
+     * Detect the CPU architecture the CLI is currently running on.
+     *
+     * @return the detected {@link SupportedArch}, or `undefined` if it is not supported.
+     */
+    detectArch(): SupportedArch | undefined;
+    /**
+     * Detect the mechanism by which the CLI was installed for the specified operating system.
+     *
+     * @param os the {@link SupportedOs} to detect the install method for.
+     *
+     * @return the detected {@link InstallMethod}, or `undefined` if it could not be determined.
+     */
+    detectInstallMethod(os: SupportedOs): Promise<InstallMethod | undefined>;
+    /**
+     * Check whether a newer version of the CLI is available.
+     *
+     * @param os optional {@link SupportedOs} override, defaults to the detected value.
+     * @param arch optional {@link SupportedArch} override, defaults to the detected value.
+     * @param installMethod optional {@link InstallMethod} override, defaults to the detected value.
+     *
+     * @return the {@link UpgradeCheckResult}, or `undefined` if the resolved os/arch/installMethod
+     * combination is not supported or not configured. Never rejects.
+     */
+    checkForUpgrade(os?: SupportedOs, arch?: SupportedArch, installMethod?: InstallMethod): Promise<UpgradeCheckResult | undefined>;
+    /**
+     * Upgrade the CLI to the latest available version.
+     *
+     * @param os optional {@link SupportedOs} override, defaults to the detected value.
+     * @param arch optional {@link SupportedArch} override, defaults to the detected value.
+     * @param installMethod optional {@link InstallMethod} override, defaults to the detected value.
+     *
+     * @return the {@link UpgradeResult}. Never rejects.
+     */
+    upgrade(os?: SupportedOs, arch?: SupportedArch, installMethod?: InstallMethod): Promise<UpgradeResult>;
+    /**
+     * Returns the result of the version check that was started eagerly once this service's
+     * dependencies were set (or starts one now, with default/no-override detection, if none has
+     * started yet). Every call is backed by the same cached promise.
+     *
+     * @param waitForResult if `true`, waits for the check to fully resolve. If `false` (default),
+     * gives up and resolves to `undefined` after an internal bounded delay, so callers on a
+     * startup/opportunistic path are never blocked by a slow network/spawn call.
+     *
+     * @return the {@link UpgradeCheckResult}, or `undefined` if unsupported/unconfigured or the
+     * bounded wait elapsed. Never rejects.
+     */
+    getUpgradeCheckResult(waitForResult?: boolean): Promise<UpgradeCheckResult | undefined>;
+}
+//# sourceMappingURL=UpgradeService.d.ts.map

package/dist/src/service/core/UpgradeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/UpgradeService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,wDAAwD,CAAC;AAExF;;GAEG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc;IACrC;;;;OAIG;IACH,QAAQ,IAAI,WAAW,GAAG,SAAS,CAAC;IAEpC;;;;OAIG;IACH,UAAU,IAAI,aAAa,GAAG,SAAS,CAAC;IAExC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEzE;;;;;;;;;OASG;IACH,eAAe,CACb,EAAE,CAAC,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAE3C;;;;;;;;OAQG;IACH,OAAO,CACL,EAAE,CAAC,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,qBAAqB,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;CACzF"}

package/dist/src/service/core/UpgradeService.js

@@ -0,0 +1,28 @@
+export const UPGRADE_SERVICE_ID = "@flowscripter/dynamic-cli-framework/upgrade-service";
+/**
+ * Operating systems an {@link UpgradeService} implementation may support.
+ */
+export var SupportedOs;
+(function (SupportedOs) {
+    SupportedOs["LINUX"] = "linux";
+    SupportedOs["MACOS"] = "macos";
+    SupportedOs["WINDOWS"] = "windows";
+})(SupportedOs || (SupportedOs = {}));
+/**
+ * CPU architectures an {@link UpgradeService} implementation may support.
+ */
+export var SupportedArch;
+(function (SupportedArch) {
+    SupportedArch["X64"] = "x64";
+    SupportedArch["ARM64"] = "arm64";
+})(SupportedArch || (SupportedArch = {}));
+/**
+ * Mechanism by which the CLI was originally installed, and therefore how it should be upgraded.
+ */
+export var InstallMethod;
+(function (InstallMethod) {
+    InstallMethod["LINUX_SCRIPT"] = "linux-script";
+    InstallMethod["HOMEBREW"] = "homebrew";
+    InstallMethod["WINGET"] = "winget";
+    InstallMethod["GITHUB_RELEASE"] = "github-release";
+})(InstallMethod || (InstallMethod = {}));

package/index.ts

@@ -140,3 +140,12 @@ export { default as createCLIPlugin } from "./src/plugin/createCLIPlugin.ts";
 export type { CLIPluginOptions } from "./src/plugin/createCLIPlugin.ts";
 export { PLUGIN_SERVICE_ID } from "./src/service/core/PluginService.ts";
 export type { default as PluginService } from "./src/service/core/PluginService.ts";
+
+export {
+  UPGRADE_SERVICE_ID,
+  InstallMethod,
+  SupportedArch,
+  SupportedOs,
+} from "./src/service/core/UpgradeService.ts";
+export type { default as UpgradeService } from "./src/service/core/UpgradeService.ts";
+export type { UpgradeCheckResult, UpgradeResult } from "./src/service/core/UpgradeService.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework-api",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "API for https://github.com/flowscripter/dynamic-cli-framework",
   "keywords": [
     "bun",

package/src/service/core/SpawnService.ts

@@ -5,11 +5,12 @@ export const SPAWN_SERVICE_ID = "@flowscripter/dynamic-cli-framework/spawn-servi
  *
  * `ok` is `true` only when the process launched and exited with code `0`. A launch failure (e.g.
  * the binary was not found) sets `error` with no `exitCode`; a non-zero exit sets `exitCode` with
- * no `error`.
+ * no `error`; a process that did not exit within {@link SpawnOptions.timeoutMs} sets `timedOut`.
  */
 export type SpawnResult =
   | { ok: true; exitCode: number }
-  | { ok: false; exitCode?: number; error?: Error };
+  | { ok: false; exitCode?: number; error?: Error }
+  | { ok: false; timedOut: true };
 
 /**
  * Options for {@link SpawnService.spawn}.
@@ -40,6 +41,13 @@ export interface SpawnOptions {
    * `true`.
    */
   longRunning?: boolean;
+
+  /**
+   * If specified, the spawned process is aborted (`SIGTERM`, followed by `SIGKILL` if it has not
+   * exited after a grace period) if it has not exited within this many milliseconds. Defaults to
+   * unbounded.
+   */
+  timeoutMs?: number;
 }
 
 /**

package/src/service/core/UpgradeService.ts

@@ -0,0 +1,123 @@
+export const UPGRADE_SERVICE_ID = "@flowscripter/dynamic-cli-framework/upgrade-service";
+
+/**
+ * Operating systems an {@link UpgradeService} implementation may support.
+ */
+export enum SupportedOs {
+  LINUX = "linux",
+  MACOS = "macos",
+  WINDOWS = "windows",
+}
+
+/**
+ * CPU architectures an {@link UpgradeService} implementation may support.
+ */
+export enum SupportedArch {
+  X64 = "x64",
+  ARM64 = "arm64",
+}
+
+/**
+ * Mechanism by which the CLI was originally installed, and therefore how it should be upgraded.
+ */
+export enum InstallMethod {
+  LINUX_SCRIPT = "linux-script",
+  HOMEBREW = "homebrew",
+  WINGET = "winget",
+  GITHUB_RELEASE = "github-release",
+}
+
+/**
+ * Outcome of an {@link UpgradeService.checkForUpgrade} call.
+ */
+export interface UpgradeCheckResult {
+  readonly currentVersion: string;
+  readonly latestVersion: string;
+  readonly updateAvailable: boolean;
+  readonly os: SupportedOs;
+  readonly arch: SupportedArch;
+  readonly installMethod: InstallMethod;
+}
+
+/**
+ * Outcome of an {@link UpgradeService.upgrade} call.
+ */
+export interface UpgradeResult {
+  readonly ok: boolean;
+  readonly oldVersion: string;
+  readonly newVersion?: string;
+  readonly error?: Error;
+}
+
+/**
+ * Service allowing a {@link Command} to check for and install a newer version of the CLI itself.
+ */
+export default interface UpgradeService {
+  /**
+   * Detect the operating system the CLI is currently running on.
+   *
+   * @return the detected {@link SupportedOs}, or `undefined` if it is not supported.
+   */
+  detectOs(): SupportedOs | undefined;
+
+  /**
+   * Detect the CPU architecture the CLI is currently running on.
+   *
+   * @return the detected {@link SupportedArch}, or `undefined` if it is not supported.
+   */
+  detectArch(): SupportedArch | undefined;
+
+  /**
+   * Detect the mechanism by which the CLI was installed for the specified operating system.
+   *
+   * @param os the {@link SupportedOs} to detect the install method for.
+   *
+   * @return the detected {@link InstallMethod}, or `undefined` if it could not be determined.
+   */
+  detectInstallMethod(os: SupportedOs): Promise<InstallMethod | undefined>;
+
+  /**
+   * Check whether a newer version of the CLI is available.
+   *
+   * @param os optional {@link SupportedOs} override, defaults to the detected value.
+   * @param arch optional {@link SupportedArch} override, defaults to the detected value.
+   * @param installMethod optional {@link InstallMethod} override, defaults to the detected value.
+   *
+   * @return the {@link UpgradeCheckResult}, or `undefined` if the resolved os/arch/installMethod
+   * combination is not supported or not configured. Never rejects.
+   */
+  checkForUpgrade(
+    os?: SupportedOs,
+    arch?: SupportedArch,
+    installMethod?: InstallMethod,
+  ): Promise<UpgradeCheckResult | undefined>;
+
+  /**
+   * Upgrade the CLI to the latest available version.
+   *
+   * @param os optional {@link SupportedOs} override, defaults to the detected value.
+   * @param arch optional {@link SupportedArch} override, defaults to the detected value.
+   * @param installMethod optional {@link InstallMethod} override, defaults to the detected value.
+   *
+   * @return the {@link UpgradeResult}. Never rejects.
+   */
+  upgrade(
+    os?: SupportedOs,
+    arch?: SupportedArch,
+    installMethod?: InstallMethod,
+  ): Promise<UpgradeResult>;
+
+  /**
+   * Returns the result of the version check that was started eagerly once this service's
+   * dependencies were set (or starts one now, with default/no-override detection, if none has
+   * started yet). Every call is backed by the same cached promise.
+   *
+   * @param waitForResult if `true`, waits for the check to fully resolve. If `false` (default),
+   * gives up and resolves to `undefined` after an internal bounded delay, so callers on a
+   * startup/opportunistic path are never blocked by a slow network/spawn call.
+   *
+   * @return the {@link UpgradeCheckResult}, or `undefined` if unsupported/unconfigured or the
+   * bounded wait elapsed. Never rejects.
+   */
+  getUpgradeCheckResult(waitForResult?: boolean): Promise<UpgradeCheckResult | undefined>;
+}