@shell-shock/plugin-upgrade 0.1.5 → 0.1.7

package/dist/components/index.cjs

@@ -6,8 +6,10 @@ exports.FetchNpmPackageFunctionDeclaration = require_components_upgrade_builtin.
 exports.GetLatestVersionFunctionDeclaration = require_components_upgrade_builtin.GetLatestVersionFunctionDeclaration;
 exports.GetPackageManagerFunctionDeclaration = require_components_upgrade_builtin.GetPackageManagerFunctionDeclaration;
 exports.GetUpgradeCommandFunctionDeclaration = require_components_upgrade_builtin.GetUpgradeCommandFunctionDeclaration;
+exports.IsCheckForUpdatesRequiredFunctionDeclaration = require_components_upgrade_builtin.IsCheckForUpdatesRequiredFunctionDeclaration;
 exports.LocateLockfileFunctionDeclaration = require_components_upgrade_builtin.LocateLockfileFunctionDeclaration;
 exports.LocatePackageJsonFunctionDeclaration = require_components_upgrade_builtin.LocatePackageJsonFunctionDeclaration;
+exports.UpdateVersionCheckFileFunctionDeclaration = require_components_upgrade_builtin.UpdateVersionCheckFileFunctionDeclaration;
 exports.UpgradeBuiltin = require_components_upgrade_builtin.UpgradeBuiltin;
 exports.UpgradeCommand = require_components_upgrade_command.UpgradeCommand;
 exports.UpgradeFunctionDeclaration = require_components_upgrade_builtin.UpgradeFunctionDeclaration;

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-import { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration } from "./upgrade-builtin.cjs";
+import { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration } from "./upgrade-builtin.cjs";
 import { UpgradeCommand } from "./upgrade-command.cjs";
-export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeCommand, UpgradeFunctionDeclaration };
+export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeCommand, UpgradeFunctionDeclaration };

package/dist/components/index.d.mts

@@ -1,3 +1,3 @@
-import { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration } from "./upgrade-builtin.mjs";
+import { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration } from "./upgrade-builtin.mjs";
 import { UpgradeCommand } from "./upgrade-command.mjs";
-export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeCommand, UpgradeFunctionDeclaration };
+export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeCommand, UpgradeFunctionDeclaration };

package/dist/components/index.mjs

@@ -1,4 +1,4 @@
-import { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeFunctionDeclaration } from "./upgrade-builtin.mjs";
+import { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeFunctionDeclaration } from "./upgrade-builtin.mjs";
 import { UpgradeCommand } from "./upgrade-command.mjs";
 
-export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeCommand, UpgradeFunctionDeclaration };
+export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeCommand, UpgradeFunctionDeclaration };

package/dist/components/upgrade-builtin.cjs

@@ -247,7 +247,7 @@ function GetPackageManagerFunctionDeclaration() {
 				type: "GetPackageManagerOptions",
 				default: "{}"
 			}],
-			returnType: __alloy_js_core.code`Promise<"npm" | "yarn" | "deno" | "pnpm" | "bun">`,
+			returnType: __alloy_js_core.code`"npm" | "yarn" | "deno" | "pnpm" | "bun"`,
 			get children() {
 				return [
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
@@ -532,7 +532,7 @@ function FetchNpmPackageFunctionDeclaration() {
 				name: "packageName",
 				type: "string"
 			}],
-			returnType: __alloy_js_core.code`Promise<NpmPackage | undefined>`,
+			returnType: __alloy_js_core.code`NpmPackage | undefined`,
 			get children() {
 				return [
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
@@ -579,7 +579,7 @@ function GetLatestVersionFunctionDeclaration() {
 				default: `"${context.packageJson.name}"`
 			}];
 		},
-		returnType: __alloy_js_core.code`Promise<string | undefined>`,
+		returnType: __alloy_js_core.code`string | undefined`,
 		get children() {
 			return [
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
@@ -627,7 +627,7 @@ function GetUpgradeCommandFunctionDeclaration() {
 			type: "string",
 			default: "process.cwd()"
 		}],
-		returnType: "Promise<string[]>",
+		returnType: "string[]",
 		get children() {
 			return [
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
@@ -770,6 +770,92 @@ function UpgradeFunctionDeclaration() {
 	];
 }
 /**
+* The `updateVersionCheckFile` handler function declaration code for the Shell Shock project.
+*/
+function UpdateVersionCheckFileFunctionDeclaration() {
+	return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDoc, {
+		heading: "A helper function that updates the version check file.",
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDocRemarks, { children: `This function is used to update the version check file with the current timestamp. It can be used in the CLI upgrade command to record the last time a check for updates was performed. The function writes a "version-check.json" file in the data directory, which contains a timestamp of the last check for updates.` }),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDocReturns, { children: `A promise that resolves to a boolean indicating whether a check for updates is required.` })
+			];
+		}
+	}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+		"export": true,
+		async: true,
+		name: "updateVersionCheckFile",
+		returnType: "void",
+		get children() {
+			return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+				condition: __alloy_js_core.code`!existsSync(paths.data)`,
+				children: __alloy_js_core.code`await mkdir(paths.data, { recursive: true }); `
+			}), __alloy_js_core.code`await writeFile(join(paths.data, "version-check.json"), JSON.stringify({ timestamp: new Date().getTime() }), "utf8"); `];
+		}
+	})];
+}
+/**
+* The `isCheckForUpdatesRequired` handler function declaration code for the Shell Shock project.
+*/
+function IsCheckForUpdatesRequiredFunctionDeclaration() {
+	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDoc, {
+		heading: "A helper function that verifies if a check for updates is required.",
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDocRemarks, { children: `This function is used to determine if a check for updates is required based on the last time a check was performed. It can be used in the CLI upgrade command to avoid unnecessary checks for updates if one was recently performed. The function checks for the existence of a "version-check.json" file in the data directory, which contains a timestamp of the last check for updates. If the file does not exist or if the timestamp is older than a specified stale time, the function will return true, indicating that a check for updates is required. Otherwise, it will return false.` }),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDocReturns, { children: `A promise that resolves to a boolean indicating whether a check for updates is required.` })
+			];
+		}
+	}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+		"export": true,
+		async: true,
+		name: "isCheckForUpdatesRequired",
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+					condition: __alloy_js_core.code`!isInteractive || isCI || env.SKIP_VERSION_CHECK`,
+					children: __alloy_js_core.code`return false; `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+					"const": true,
+					name: "filePath",
+					initializer: __alloy_js_core.code`join(paths.data, "version-check.json"); `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+					condition: __alloy_js_core.code`existsSync(filePath)`,
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+								"const": true,
+								name: "file",
+								type: "{ timestamp: number; }",
+								initializer: __alloy_js_core.code` JSON.parse(await readFile(filePath, "utf8")); `
+							}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
+								condition: __alloy_js_core.code`!file.timestamp`,
+								children: __alloy_js_core.code`await updateVersionCheckFile();
+            return true; `
+							}),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+								get condition() {
+									return __alloy_js_core.code`new Date().getTime() - file.timestamp < ${context.config.upgrade.staleTime}`;
+								},
+								children: __alloy_js_core.code`return false; `
+							})
+						];
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseClause, { children: __alloy_js_core.code`await updateVersionCheckFile();
+          return true; ` })
+			];
+		}
+	})];
+}
+/**
 * The `checkForUpdates` handler function declaration code for the Shell Shock project.
 */
 function CheckForUpdatesFunctionDeclaration() {
@@ -779,13 +865,32 @@ function CheckForUpdatesFunctionDeclaration() {
 			"export": true,
 			name: "CheckForUpdatesOptions",
 			"extends": "GetPackageManagerOptions",
-			doc: "Options for the `checkForUpdates` handler function."
+			doc: "Options for the `checkForUpdates` handler function.",
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
+					name: "force",
+					optional: true,
+					type: "boolean",
+					doc: "Whether to force a check for updates regardless of the last check timestamp. If set to `true`, the function will bypass the timestamp check and perform a check for updates, updating the timestamp in the process. This can be useful if you want to ensure that a check for updates is performed even if one was recently done, such as when the user explicitly requests it or when certain conditions are met that warrant an immediate check."
+				});
+			}
 		}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceDeclaration, {
-			"export": true,
-			name: "CheckForUpdatesResult",
-			doc: "The result for the `checkForUpdates` handler function.",
+			name: "CheckForUpdatesBaseResult",
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
+					name: "isError",
+					type: "boolean",
+					optional: true,
+					doc: "Indicates whether an error occurred while checking for updates."
+				});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceDeclaration, {
+			name: "CheckForUpdatesSuccessResult",
+			"extends": "CheckForUpdatesBaseResult",
 			get children() {
 				return [
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
@@ -809,18 +914,32 @@ function CheckForUpdatesFunctionDeclaration() {
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
 						name: "package",
 						type: "NpmPackage",
+						optional: true,
 						doc: "The npm package that was checked for updates."
-					}),
-					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
-						name: "packageManager",
-						type: "'npm' | 'yarn' | 'pnpm' | 'deno' | 'bun'",
-						doc: "The package manager used to check for updates."
 					})
 				];
 			}
 		}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceDeclaration, {
+			name: "CheckForUpdatesErrorResult",
+			"extends": "CheckForUpdatesBaseResult",
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.InterfaceMember, {
+					name: "error",
+					type: "Error",
+					doc: "The error that occurred while checking for updates."
+				});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TypeDeclaration, {
+			"export": true,
+			name: "CheckForUpdatesResult",
+			doc: "The result for the `checkForUpdates` handler function.",
+			children: __alloy_js_core.code`CheckForUpdatesSuccessResult | CheckForUpdatesErrorResult;`
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript.TSDoc, {
 			heading: "Check for updates to the application dependencies.",
 			get children() {
@@ -844,67 +963,41 @@ function CheckForUpdatesFunctionDeclaration() {
 				type: "CheckForUpdatesOptions",
 				default: "{}"
 			}],
-			returnType: "Promise<CheckForUpdatesResult | undefined>",
+			returnType: "CheckForUpdatesResult",
 			get children() {
 				return [
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
-						"const": true,
-						name: "filePath",
-						initializer: __alloy_js_core.code`join(paths.data, "version-check.json"); `
-					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-						condition: __alloy_js_core.code`existsSync(filePath)`,
+						condition: __alloy_js_core.code`!options.force && !(await isCheckForUpdatesRequired())`,
 						get children() {
-							return [
-								(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
-									"const": true,
-									name: "file",
-									type: "{ timestamp: number; }",
-									initializer: __alloy_js_core.code` JSON.parse(await readFile(filePath, "utf8")); `
-								}),
-								(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-									condition: __alloy_js_core.code`!file.timestamp`,
-									children: __alloy_js_core.code`await writeFile(filePath, JSON.stringify({ timestamp: new Date().getTime() }), "utf8");
-            return undefined; `
-								}),
-								(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
-									get condition() {
-										return __alloy_js_core.code`new Date().getTime() - file.timestamp < ${context.config.upgrade.staleTime}`;
-									},
-									children: __alloy_js_core.code`return undefined; `
-								})
-							];
+							return __alloy_js_core.code`return {
+            latestVersion: "${context.packageJson.version}",
+            currentVersion: "${context.packageJson.version}",
+            isUpToDate: true,
+            isError: false,
+          }; `;
 						}
 					}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseClause, { children: __alloy_js_core.code`await writeFile(filePath, JSON.stringify({ timestamp: new Date().getTime() }), "utf8");
-              return undefined; ` }),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
-						"const": true,
-						name: "packageManager",
-						initializer: __alloy_js_core.code`await getPackageManager(options); `
-					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					__alloy_js_core.code`try { `,
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
 						"const": true,
 						name: "pkg",
-						initializer: __alloy_js_core.code`await fetchNpmPackage(); `
-					}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.IfStatement, {
-						condition: __alloy_js_core.code`!pkg`,
-						children: __alloy_js_core.code`return undefined; `
+						get initializer() {
+							return __alloy_js_core.code`await fetchNpmPackage("${context.packageJson.name}"); `;
+						}
 					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`await writeFile(filePath, JSON.stringify({ timestamp: new Date().getTime() }), "utf8");
-
+					(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
           return {
-          latestVersion: pkg?.version ?? "0.0.0",
-          currentVersion: "${context.packageJson.version}",
-          isUpToDate: pkg ? "${context.packageJson.version}" === pkg.version : true,
-          package: pkg,
-          packageManager,
-        }; `)
+            latestVersion: pkg?.version || "${context.packageJson.version}",
+            currentVersion: "${context.packageJson.version}",
+            isUpToDate: pkg ? "${context.packageJson.version}" === pkg.version : true,
+            package: pkg,
+            isError: false,
+          };
+        } catch (err) {
+          return { isError: true, error: err instanceof Error ? err : new Error(String(err)) };
+        } `)
 				];
 			}
 		})
@@ -924,7 +1017,11 @@ function UpgradeBuiltin(props) {
 				"node:os": "os",
 				"node:path": ["join", "resolve"],
 				"node:fs": ["existsSync"],
-				"node:fs/promises": ["readFile", "writeFile"],
+				"node:fs/promises": [
+					"readFile",
+					"writeFile",
+					"mkdir"
+				],
 				"node:process": "process"
 			});
 		},
@@ -935,8 +1032,17 @@ function UpgradeBuiltin(props) {
 					"verbose",
 					"writeLine"
 				],
-				env: ["paths", "isWindows"],
-				utils: ["isColorSupported", "spawn"]
+				env: [
+					"paths",
+					"isWindows",
+					"isCI",
+					"env"
+				],
+				utils: [
+					"isColorSupported",
+					"isInteractive",
+					"spawn"
+				]
 			});
 		},
 		get children() {
@@ -971,6 +1077,10 @@ function UpgradeBuiltin(props) {
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(CheckForUpdatesFunctionDeclaration, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(IsCheckForUpdatesRequiredFunctionDeclaration, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(UpdateVersionCheckFileFunctionDeclaration, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 					get when() {
 						return Boolean(children);
@@ -988,7 +1098,9 @@ exports.FetchNpmPackageFunctionDeclaration = FetchNpmPackageFunctionDeclaration;
 exports.GetLatestVersionFunctionDeclaration = GetLatestVersionFunctionDeclaration;
 exports.GetPackageManagerFunctionDeclaration = GetPackageManagerFunctionDeclaration;
 exports.GetUpgradeCommandFunctionDeclaration = GetUpgradeCommandFunctionDeclaration;
+exports.IsCheckForUpdatesRequiredFunctionDeclaration = IsCheckForUpdatesRequiredFunctionDeclaration;
 exports.LocateLockfileFunctionDeclaration = LocateLockfileFunctionDeclaration;
 exports.LocatePackageJsonFunctionDeclaration = LocatePackageJsonFunctionDeclaration;
+exports.UpdateVersionCheckFileFunctionDeclaration = UpdateVersionCheckFileFunctionDeclaration;
 exports.UpgradeBuiltin = UpgradeBuiltin;
 exports.UpgradeFunctionDeclaration = UpgradeFunctionDeclaration;

package/dist/components/upgrade-builtin.d.cts

@@ -30,6 +30,14 @@ declare function GetUpgradeCommandFunctionDeclaration(): _alloy_js_core0.Childre
  * The `upgrade` handler function declaration code for the Shell Shock project.
  */
 declare function UpgradeFunctionDeclaration(): _alloy_js_core0.Children;
+/**
+ * The `updateVersionCheckFile` handler function declaration code for the Shell Shock project.
+ */
+declare function UpdateVersionCheckFileFunctionDeclaration(): _alloy_js_core0.Children;
+/**
+ * The `isCheckForUpdatesRequired` handler function declaration code for the Shell Shock project.
+ */
+declare function IsCheckForUpdatesRequiredFunctionDeclaration(): _alloy_js_core0.Children;
 /**
  * The `checkForUpdates` handler function declaration code for the Shell Shock project.
  */
@@ -40,5 +48,5 @@ interface UpgradeBuiltinProps extends Omit<BuiltinFileProps, "id" | "description
  */
 declare function UpgradeBuiltin(props: UpgradeBuiltinProps): _alloy_js_core0.Children;
 //#endregion
-export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration };
+export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration };
 //# sourceMappingURL=upgrade-builtin.d.cts.map

package/dist/components/upgrade-builtin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade-builtin.d.cts","names":[],"sources":["../../src/components/upgrade-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA6CgB,iBAAA,oCAAA,CAAA,CAAoC,EAAA,eAAA,CAAA,QAAA;AAgGpD;AAuFA;AAkJA;AA6KgB,iBAtZA,iCAAA,CAAA,CAsZmC,EAtZF,eAAA,CAAA,QAsZE;AA2CnD;AAyEA;AAyFA;AAgIiB,iBA5oBD,oCAAA,CAAA,CA4oBiC,EA5oBG,eAAA,CAAA,QA4oBH;AAQjD;;;iBAlgBgB,kCAAA,CAAA,GAAkC,eAAA,CAAA;;;;iBA6KlC,mCAAA,CAAA,GAAmC,eAAA,CAAA;;;;iBA2CnC,oCAAA,CAAA,GAAoC,eAAA,CAAA;;;;iBAyEpC,0BAAA,CAAA,GAA0B,eAAA,CAAA;;;;iBAyF1B,kCAAA,CAAA,GAAkC,eAAA,CAAA;UAgIjC,mBAAA,SAA4B,KAC3C;;;;iBAOc,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}
+{"version":3,"file":"upgrade-builtin.d.cts","names":[],"sources":["../../src/components/upgrade-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA6CgB,iBAAA,oCAAA,CAAA,CAAoC,EAAA,eAAA,CAAA,QAAA;AAgGpD;AAuFA;AAkJA;AA6KgB,iBAtZA,iCAAA,CAAA,CAsZmC,EAtZF,eAAA,CAAA,QAsZE;AA2CnD;AAyEA;AAyFA;AA6BgB,iBAziBA,oCAAA,CAAA,CAyiB4C,EAziBR,eAAA,CAAA,QAyiBQ;AAuD5D;AAoIA;AAQA;iBA1lBgB,kCAAA,CAAA,GAAkC,eAAA,CAAA;;;;iBA6KlC,mCAAA,CAAA,GAAmC,eAAA,CAAA;;;;iBA2CnC,oCAAA,CAAA,GAAoC,eAAA,CAAA;;;;iBAyEpC,0BAAA,CAAA,GAA0B,eAAA,CAAA;;;;iBAyF1B,yCAAA,CAAA,GAAyC,eAAA,CAAA;;;;iBA6BzC,4CAAA,CAAA,GAA4C,eAAA,CAAA;;;;iBAuD5C,kCAAA,CAAA,GAAkC,eAAA,CAAA;UAoIjC,mBAAA,SAA4B,KAC3C;;;;iBAOc,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}

package/dist/components/upgrade-builtin.d.mts

@@ -30,6 +30,14 @@ declare function GetUpgradeCommandFunctionDeclaration(): _alloy_js_core0.Childre
  * The `upgrade` handler function declaration code for the Shell Shock project.
  */
 declare function UpgradeFunctionDeclaration(): _alloy_js_core0.Children;
+/**
+ * The `updateVersionCheckFile` handler function declaration code for the Shell Shock project.
+ */
+declare function UpdateVersionCheckFileFunctionDeclaration(): _alloy_js_core0.Children;
+/**
+ * The `isCheckForUpdatesRequired` handler function declaration code for the Shell Shock project.
+ */
+declare function IsCheckForUpdatesRequiredFunctionDeclaration(): _alloy_js_core0.Children;
 /**
  * The `checkForUpdates` handler function declaration code for the Shell Shock project.
  */
@@ -40,5 +48,5 @@ interface UpgradeBuiltinProps extends Omit<BuiltinFileProps, "id" | "description
  */
 declare function UpgradeBuiltin(props: UpgradeBuiltinProps): _alloy_js_core0.Children;
 //#endregion
-export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration };
+export { CheckForUpdatesFunctionDeclaration, FetchNpmPackageFunctionDeclaration, GetLatestVersionFunctionDeclaration, GetPackageManagerFunctionDeclaration, GetUpgradeCommandFunctionDeclaration, IsCheckForUpdatesRequiredFunctionDeclaration, LocateLockfileFunctionDeclaration, LocatePackageJsonFunctionDeclaration, UpdateVersionCheckFileFunctionDeclaration, UpgradeBuiltin, UpgradeBuiltinProps, UpgradeFunctionDeclaration };
 //# sourceMappingURL=upgrade-builtin.d.mts.map

package/dist/components/upgrade-builtin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade-builtin.d.mts","names":[],"sources":["../../src/components/upgrade-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA6CgB,iBAAA,oCAAA,CAAA,CAAoC,EAAA,eAAA,CAAA,QAAA;AAgGpD;AAuFA;AAkJA;AA6KgB,iBAtZA,iCAAA,CAAA,CAsZmC,EAtZF,eAAA,CAAA,QAsZE;AA2CnD;AAyEA;AAyFA;AAgIiB,iBA5oBD,oCAAA,CAAA,CA4oBiC,EA5oBG,eAAA,CAAA,QA4oBH;AAQjD;;;iBAlgBgB,kCAAA,CAAA,GAAkC,eAAA,CAAA;;;;iBA6KlC,mCAAA,CAAA,GAAmC,eAAA,CAAA;;;;iBA2CnC,oCAAA,CAAA,GAAoC,eAAA,CAAA;;;;iBAyEpC,0BAAA,CAAA,GAA0B,eAAA,CAAA;;;;iBAyF1B,kCAAA,CAAA,GAAkC,eAAA,CAAA;UAgIjC,mBAAA,SAA4B,KAC3C;;;;iBAOc,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}
+{"version":3,"file":"upgrade-builtin.d.mts","names":[],"sources":["../../src/components/upgrade-builtin.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA6CgB,iBAAA,oCAAA,CAAA,CAAoC,EAAA,eAAA,CAAA,QAAA;AAgGpD;AAuFA;AAkJA;AA6KgB,iBAtZA,iCAAA,CAAA,CAsZmC,EAtZF,eAAA,CAAA,QAsZE;AA2CnD;AAyEA;AAyFA;AA6BgB,iBAziBA,oCAAA,CAAA,CAyiB4C,EAziBR,eAAA,CAAA,QAyiBQ;AAuD5D;AAoIA;AAQA;iBA1lBgB,kCAAA,CAAA,GAAkC,eAAA,CAAA;;;;iBA6KlC,mCAAA,CAAA,GAAmC,eAAA,CAAA;;;;iBA2CnC,oCAAA,CAAA,GAAoC,eAAA,CAAA;;;;iBAyEpC,0BAAA,CAAA,GAA0B,eAAA,CAAA;;;;iBAyF1B,yCAAA,CAAA,GAAyC,eAAA,CAAA;;;;iBA6BzC,4CAAA,CAAA,GAA4C,eAAA,CAAA;;;;iBAuD5C,kCAAA,CAAA,GAAkC,eAAA,CAAA;UAoIjC,mBAAA,SAA4B,KAC3C;;;;iBAOc,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}