@fluojs/cli 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/transforms/nestjs-migrate.js

@@ -1,8 +1,29 @@
 import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { basename, extname, posix, resolve } from 'node:path';
 import ts from 'typescript';
+
+/**
+ * Provides the migration transforms value.
+ */
 export const MIGRATION_TRANSFORMS = ['imports', 'injectable', 'scope', 'bootstrap', 'testing', 'tsconfig'];
+
+/**
+ * Defines the migration transform kind type.
+ */
+
+/**
+ * Provides the warning categories value.
+ */
 export const WARNING_CATEGORIES = ['inject-token', 'request-dto', 'pipe-converter', 'bootstrap-unsupported', 'testing-unsupported', 'import-unsupported', 'injectable-options', 'tsconfig-parse', 'bootstrap-port'];
+
+/**
+ * Defines the warning category type.
+ */
+
+/**
+ * Defines the migration warning type.
+ */
+
 const WARNING_CATEGORY_LABEL = {
   'inject-token': 'DI token migration (@Inject)',
   'request-dto': 'Request DTO migration (handler parameter decorators)',
@@ -14,9 +35,23 @@ const WARNING_CATEGORY_LABEL = {
   'tsconfig-parse': 'tsconfig parse failure',
   'bootstrap-port': 'Bootstrap port folding issue'
 };
+
+/**
+ * Get warning category label.
+ *
+ * @param category The category.
+ * @returns The get warning category label result.
+ */
 export function getWarningCategoryLabel(category) {
   return WARNING_CATEGORY_LABEL[category];
 }
+
+/**
+ * Group warnings by category.
+ *
+ * @param warnings The warnings.
+ * @returns The group warnings by category result.
+ */
 export function groupWarningsByCategory(warnings) {
   const groups = new Map();
   for (const warning of warnings) {
@@ -26,6 +61,19 @@ export function groupWarningsByCategory(warnings) {
   }
   return groups;
 }
+
+/**
+ * Defines the file migration result type.
+ */
+
+/**
+ * Defines the migration report type.
+ */
+
+/**
+ * Defines the run nest js migration options type.
+ */
+
 const printer = ts.createPrinter({
   newLine: ts.NewLineKind.LineFeed
 });
@@ -841,6 +889,13 @@ function runTypeScriptTransforms(source, filePath, enabledTransforms) {
     warnings
   };
 }
+
+/**
+ * Run nest js migration.
+ *
+ * @param options The options.
+ * @returns The run nest js migration result.
+ */
 export function runNestJsMigration(options) {
   const resolvedTargetPath = resolve(options.targetPath);
   if (!existsSync(resolvedTargetPath)) {
@@ -886,6 +941,13 @@ export function runNestJsMigration(options) {
     fileResults
   };
 }
+
+/**
+ * Render transform list.
+ *
+ * @param kinds The kinds.
+ * @returns The render transform list result.
+ */
 export function renderTransformList(kinds) {
   return kinds.map(kind => `${kind} (${TRANSFORM_KIND_LABEL[kind]})`).join(', ');
 }

package/dist/update-check.d.ts

@@ -0,0 +1,82 @@
+type CliStream = {
+    isTTY?: boolean;
+    write(message: string): unknown;
+};
+type CliReadableStream = {
+    isTTY?: boolean;
+};
+/**
+ * Defines the cli update check result type.
+ */
+export type CliUpdateCheckResult = {
+    action: 'continue';
+} | {
+    action: 'reran';
+    exitCode: number;
+};
+/**
+ * Defines the update install command type.
+ */
+export type UpdateInstallCommand = {
+    args: string[];
+    command: string;
+    display: string;
+};
+/** Package manager that can install the CLI globally. */
+export type UpdatePackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
+/**
+ * Defines the update command runtime type.
+ */
+export type UpdateCommandRuntime = {
+    env: NodeJS.ProcessEnv;
+    stderr: CliStream;
+};
+/**
+ * Defines the update prompter type.
+ */
+export type UpdatePrompter = {
+    confirm(message: string, defaultValue: boolean): Promise<boolean>;
+};
+/**
+ * Describes the cli update check runtime options contract.
+ */
+export interface CliUpdateCheckRuntimeOptions {
+    cacheFile?: string;
+    cacheTtlMs?: number;
+    ci?: boolean;
+    currentVersion?: string;
+    env?: NodeJS.ProcessEnv;
+    fetchLatestVersion?: (packageName: string) => Promise<string | undefined>;
+    installPackage?: (installCommand: UpdateInstallCommand, runtime: UpdateCommandRuntime) => Promise<number>;
+    interactive?: boolean;
+    now?: () => Date;
+    packageName?: string;
+    packageManager?: UpdatePackageManager;
+    packageRoot?: string;
+    prompt?: UpdatePrompter;
+    rerunCli?: (argv: string[], runtime: UpdateCommandRuntime) => Promise<number>;
+    skip?: boolean;
+    stderr?: CliStream;
+    stdin?: CliReadableStream;
+    stdout?: CliStream;
+}
+/**
+ * Remove update check flags.
+ *
+ * @param argv The argv.
+ * @returns The remove update check flags result.
+ */
+export declare function removeUpdateCheckFlags(argv: string[]): {
+    argv: string[];
+    skipUpdateCheck: boolean;
+};
+/**
+ * Run cli update check.
+ *
+ * @param argv The argv.
+ * @param options The options.
+ * @returns The run cli update check result.
+ */
+export declare function runCliUpdateCheck(argv: string[], options?: CliUpdateCheckRuntimeOptions): Promise<CliUpdateCheckResult>;
+export {};
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAOA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAscD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAcnG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkEjI"}

package/dist/update-check.js

@@ -0,0 +1,475 @@
+import { spawnSync } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, dirname, join, sep } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * Defines the cli update check result type.
+ */
+
+/**
+ * Defines the update install command type.
+ */
+
+/** Package manager that can install the CLI globally. */
+
+/**
+ * Defines the update command runtime type.
+ */
+
+/**
+ * Defines the update prompter type.
+ */
+
+/**
+ * Describes the cli update check runtime options contract.
+ */
+
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_PACKAGE_NAME = '@fluojs/cli';
+const DEFAULT_REGISTRY_TIMEOUT_MS = 5_000;
+const UPDATE_CHECK_FLAGS = new Set(['--no-update-check', '--no-update-notifier']);
+const UPDATE_PACKAGE_MANAGERS = new Set(['bun', 'npm', 'pnpm', 'yarn']);
+function isRecord(value) {
+  return typeof value === 'object' && value !== null;
+}
+function isTruthyEnvValue(value) {
+  if (!value) {
+    return false;
+  }
+  return ['1', 'true', 'yes'].includes(value.toLowerCase());
+}
+function parseSemver(version) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(version.trim());
+  if (!match) {
+    return undefined;
+  }
+  const [, major, minor, patch, prerelease] = match;
+  if (major === undefined || minor === undefined || patch === undefined) {
+    return undefined;
+  }
+  return {
+    major: Number.parseInt(major, 10),
+    minor: Number.parseInt(minor, 10),
+    patch: Number.parseInt(patch, 10),
+    prerelease: prerelease ? prerelease.split('.') : []
+  };
+}
+function compareNumericPart(left, right) {
+  if (left > right) {
+    return 1;
+  }
+  if (left < right) {
+    return -1;
+  }
+  return 0;
+}
+function comparePrereleaseIdentifier(left, right) {
+  if (left === undefined && right === undefined) {
+    return 0;
+  }
+  if (left === undefined) {
+    return -1;
+  }
+  if (right === undefined) {
+    return 1;
+  }
+  const leftNumber = /^\d+$/.test(left) ? Number.parseInt(left, 10) : undefined;
+  const rightNumber = /^\d+$/.test(right) ? Number.parseInt(right, 10) : undefined;
+  if (leftNumber !== undefined && rightNumber !== undefined) {
+    return compareNumericPart(leftNumber, rightNumber);
+  }
+  if (leftNumber !== undefined) {
+    return -1;
+  }
+  if (rightNumber !== undefined) {
+    return 1;
+  }
+  if (left > right) {
+    return 1;
+  }
+  if (left < right) {
+    return -1;
+  }
+  return 0;
+}
+function compareSemver(left, right) {
+  const major = compareNumericPart(left.major, right.major);
+  if (major !== 0) {
+    return major;
+  }
+  const minor = compareNumericPart(left.minor, right.minor);
+  if (minor !== 0) {
+    return minor;
+  }
+  const patch = compareNumericPart(left.patch, right.patch);
+  if (patch !== 0) {
+    return patch;
+  }
+  if (left.prerelease.length === 0 && right.prerelease.length === 0) {
+    return 0;
+  }
+  if (left.prerelease.length === 0) {
+    return 1;
+  }
+  if (right.prerelease.length === 0) {
+    return -1;
+  }
+  const maxLength = Math.max(left.prerelease.length, right.prerelease.length);
+  for (let index = 0; index < maxLength; index += 1) {
+    const comparison = comparePrereleaseIdentifier(left.prerelease[index], right.prerelease[index]);
+    if (comparison !== 0) {
+      return comparison;
+    }
+  }
+  return 0;
+}
+function isNewerVersion(latestVersion, currentVersion) {
+  const latest = parseSemver(latestVersion);
+  const current = parseSemver(currentVersion);
+  if (!latest || !current) {
+    return false;
+  }
+  return compareSemver(latest, current) > 0;
+}
+function parseCache(contents) {
+  const parsed = JSON.parse(contents);
+  if (!isRecord(parsed)) {
+    return undefined;
+  }
+  const checkedAt = parsed.checkedAt;
+  const latestVersion = parsed.latestVersion;
+  if (typeof checkedAt !== 'number' || typeof latestVersion !== 'string') {
+    return undefined;
+  }
+  return {
+    checkedAt,
+    latestVersion
+  };
+}
+function resolveCacheFile(env) {
+  const cacheRoot = env.XDG_CACHE_HOME ?? join(homedir(), '.cache');
+  return join(cacheRoot, 'fluo', 'cli-update-check.json');
+}
+async function readCachedLatestVersion(cacheFile, nowMs, cacheTtlMs) {
+  try {
+    const cache = parseCache(await readFile(cacheFile, 'utf8'));
+    if (!cache) {
+      return undefined;
+    }
+    if (nowMs - cache.checkedAt > cacheTtlMs) {
+      return undefined;
+    }
+    return cache.latestVersion;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      return undefined;
+    }
+    return undefined;
+  }
+}
+async function writeLatestVersionCache(cacheFile, latestVersion, nowMs) {
+  await mkdir(dirname(cacheFile), {
+    recursive: true
+  });
+  await writeFile(cacheFile, `${JSON.stringify({
+    checkedAt: nowMs,
+    latestVersion
+  }, null, 2)}\n`, 'utf8');
+}
+async function fetchLatestDistTag(packageName) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), DEFAULT_REGISTRY_TIMEOUT_MS);
+  try {
+    const encodedPackageName = encodeURIComponent(packageName);
+    const response = await fetch(`https://registry.npmjs.org/-/package/${encodedPackageName}/dist-tags`, {
+      headers: {
+        accept: 'application/json'
+      },
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      return undefined;
+    }
+    const payload = await response.json();
+    if (!isRecord(payload) || typeof payload.latest !== 'string') {
+      return undefined;
+    }
+    return payload.latest;
+  } catch (_error) {
+    return undefined;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function resolveLatestVersion(packageName, cacheFile, cacheTtlMs, nowMs, fetchLatestVersion) {
+  const cachedLatestVersion = await readCachedLatestVersion(cacheFile, nowMs, cacheTtlMs);
+  if (cachedLatestVersion) {
+    return cachedLatestVersion;
+  }
+  let latestVersion;
+  try {
+    latestVersion = await fetchLatestVersion(packageName);
+  } catch (_error) {
+    return undefined;
+  }
+  if (!latestVersion) {
+    return undefined;
+  }
+  try {
+    await writeLatestVersionCache(cacheFile, latestVersion, nowMs);
+  } catch (_error) {
+    return latestVersion;
+  }
+  return latestVersion;
+}
+async function readOwnPackageVersion() {
+  const packageJsonPath = fileURLToPath(new URL('../package.json', import.meta.url));
+  try {
+    const manifest = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    if (!isRecord(manifest) || typeof manifest.version !== 'string') {
+      return undefined;
+    }
+    return manifest.version;
+  } catch (_error) {
+    return undefined;
+  }
+}
+function normalizePathForDetection(path) {
+  return (path ?? '').replaceAll('\\', '/').toLowerCase();
+}
+function parsePackageManagerName(value) {
+  if (!value) {
+    return undefined;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (UPDATE_PACKAGE_MANAGERS.has(normalized)) {
+    return normalized;
+  }
+  return undefined;
+}
+function parsePackageManagerFromUserAgent(userAgent) {
+  const name = userAgent?.split(' ')[0]?.split('/')[0];
+  return parsePackageManagerName(name);
+}
+function parsePackageManagerFromExecPath(execPath) {
+  const executableName = basename(execPath ?? '', '.cmd').toLowerCase();
+  const packageManager = parsePackageManagerName(executableName.replace(/\.(?:cjs|mjs|js)$/, ''));
+  if (packageManager) {
+    return packageManager;
+  }
+  const normalizedPath = normalizePathForDetection(execPath);
+  if (normalizedPath.includes('/pnpm/')) {
+    return 'pnpm';
+  }
+  if (normalizedPath.includes('/yarn/')) {
+    return 'yarn';
+  }
+  if (normalizedPath.includes('/bun/')) {
+    return 'bun';
+  }
+  if (normalizedPath.includes('/npm/')) {
+    return 'npm';
+  }
+  return undefined;
+}
+function parsePackageManagerFromPackageRoot(packageRoot) {
+  const normalizedPath = normalizePathForDetection(`${sep}${packageRoot}${sep}`);
+  if (normalizedPath.includes('/.pnpm/') || normalizedPath.includes('/pnpm/global/')) {
+    return 'pnpm';
+  }
+  if (normalizedPath.includes('/.bun/install/global/') || normalizedPath.includes('/bun/install/global/')) {
+    return 'bun';
+  }
+  if (normalizedPath.includes('/.config/yarn/global/') || normalizedPath.includes('/yarn/global/')) {
+    return 'yarn';
+  }
+  if (normalizedPath.includes('/node_modules/')) {
+    return 'npm';
+  }
+  return undefined;
+}
+function resolveUpdatePackageManager(env, packageRoot) {
+  return parsePackageManagerName(env.FLUO_UPDATE_PACKAGE_MANAGER) ?? parsePackageManagerFromPackageRoot(packageRoot) ?? parsePackageManagerFromUserAgent(env.npm_config_user_agent) ?? parsePackageManagerFromExecPath(env.npm_execpath) ?? 'npm';
+}
+function resolveInstallCommand(packageName, latestVersion, packageManager) {
+  const packageSpecifier = `${packageName}@${latestVersion}`;
+  if (packageManager === 'bun') {
+    return {
+      args: ['add', '-g', packageSpecifier],
+      command: 'bun',
+      display: `bun add -g ${packageSpecifier}`
+    };
+  }
+  if (packageManager === 'pnpm') {
+    return {
+      args: ['add', '-g', packageSpecifier],
+      command: 'pnpm',
+      display: `pnpm add -g ${packageSpecifier}`
+    };
+  }
+  if (packageManager === 'yarn') {
+    return {
+      args: ['global', 'add', packageSpecifier],
+      command: 'yarn',
+      display: `yarn global add ${packageSpecifier}`
+    };
+  }
+  return {
+    args: ['install', '-g', packageSpecifier],
+    command: 'npm',
+    display: `npm install -g ${packageSpecifier}`
+  };
+}
+async function defaultPromptConfirm(message, defaultValue) {
+  const promptSuffix = defaultValue ? 'Y/n' : 'y/N';
+  const readline = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    const answer = (await readline.question(`${message} (${promptSuffix}) `)).trim().toLowerCase();
+    if (answer.length === 0) {
+      return defaultValue;
+    }
+    return answer === 'y' || answer === 'yes';
+  } finally {
+    readline.close();
+  }
+}
+async function defaultInstallPackage(installCommand, runtime) {
+  const result = spawnSync(installCommand.command, installCommand.args, {
+    env: runtime.env,
+    stdio: 'inherit'
+  });
+  if (result.error) {
+    runtime.stderr.write(`Failed to run ${installCommand.display}: ${result.error.message}\n`);
+    return 1;
+  }
+  return result.status ?? 1;
+}
+async function defaultRerunCli(argv, runtime) {
+  const command = process.platform === 'win32' ? 'fluo.cmd' : 'fluo';
+  const result = spawnSync(command, argv, {
+    env: {
+      ...runtime.env,
+      FLUO_UPDATE_CHECK_REEXEC: '1'
+    },
+    stdio: 'inherit'
+  });
+  if (result.error) {
+    runtime.stderr.write(`Failed to restart fluo after updating: ${result.error.message}\n`);
+    return 1;
+  }
+  return result.status ?? 1;
+}
+function shouldSkipForEnvironment(env, ci) {
+  return Boolean(ci) || isTruthyEnvValue(env.CI) || isTruthyEnvValue(env.GITHUB_ACTIONS) || isTruthyEnvValue(env.FLUO_NO_UPDATE_CHECK) || isTruthyEnvValue(env.NO_UPDATE_NOTIFIER) || isTruthyEnvValue(env.FLUO_UPDATE_CHECK_REEXEC) || Boolean(env.npm_lifecycle_event) || Boolean(env.npm_lifecycle_script);
+}
+function shouldRunInteractiveUpdateCheck(options, env) {
+  if (options.skip || options.interactive === false || shouldSkipForEnvironment(env, options.ci)) {
+    return false;
+  }
+  return Boolean(options.stdin?.isTTY ?? process.stdin.isTTY) && Boolean(options.stdout?.isTTY ?? process.stdout.isTTY);
+}
+
+/**
+ * Remove update check flags.
+ *
+ * @param argv The argv.
+ * @returns The remove update check flags result.
+ */
+export function removeUpdateCheckFlags(argv) {
+  const filteredArgv = [];
+  let skipUpdateCheck = false;
+  for (const arg of argv) {
+    if (UPDATE_CHECK_FLAGS.has(arg)) {
+      skipUpdateCheck = true;
+      continue;
+    }
+    filteredArgv.push(arg);
+  }
+  return {
+    argv: filteredArgv,
+    skipUpdateCheck
+  };
+}
+
+/**
+ * Run cli update check.
+ *
+ * @param argv The argv.
+ * @param options The options.
+ * @returns The run cli update check result.
+ */
+export async function runCliUpdateCheck(argv, options = {}) {
+  const env = options.env ?? {};
+  const stderr = options.stderr ?? process.stderr;
+  const stdout = options.stdout ?? process.stdout;
+  if (!shouldRunInteractiveUpdateCheck({
+    ...options,
+    stderr,
+    stdout
+  }, env)) {
+    return {
+      action: 'continue'
+    };
+  }
+  const packageName = options.packageName ?? DEFAULT_PACKAGE_NAME;
+  const now = options.now ?? (() => new Date());
+  const nowMs = now().getTime();
+  const cacheFile = options.cacheFile ?? resolveCacheFile(env);
+  const cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+  const currentVersion = options.currentVersion ?? (await readOwnPackageVersion());
+  const packageRoot = options.packageRoot ?? dirname(fileURLToPath(new URL('../package.json', import.meta.url)));
+  if (!currentVersion) {
+    return {
+      action: 'continue'
+    };
+  }
+  const latestVersion = await resolveLatestVersion(packageName, cacheFile, cacheTtlMs, nowMs, options.fetchLatestVersion ?? fetchLatestDistTag);
+  if (!latestVersion || !isNewerVersion(latestVersion, currentVersion)) {
+    return {
+      action: 'continue'
+    };
+  }
+  stderr.write(`A newer ${packageName} version is available: ${currentVersion} -> ${latestVersion}.\n`);
+  const prompt = options.prompt ?? {
+    confirm: defaultPromptConfirm
+  };
+  const shouldInstall = await prompt.confirm(`Install ${packageName}@${latestVersion} now and restart this command?`, false);
+  if (!shouldInstall) {
+    stderr.write(`Continuing with ${packageName}@${currentVersion}.\n`);
+    return {
+      action: 'continue'
+    };
+  }
+  const packageManager = options.packageManager ?? resolveUpdatePackageManager(env, packageRoot);
+  const installCommand = resolveInstallCommand(packageName, latestVersion, packageManager);
+  stderr.write(`Installing ${packageName}@${latestVersion} with \`${installCommand.display}\`...\n`);
+  const commandRuntime = {
+    env,
+    stderr
+  };
+  const installExitCode = await (options.installPackage ?? defaultInstallPackage)(installCommand, commandRuntime);
+  if (installExitCode !== 0) {
+    stderr.write(`Update install failed with exit code ${installExitCode}; continuing with ${packageName}@${currentVersion}.\n`);
+    return {
+      action: 'continue'
+    };
+  }
+  stderr.write(`Updated ${packageName} to ${latestVersion}. Restarting fluo...\n`);
+  const rerunExitCode = await (options.rerunCli ?? defaultRerunCli)(argv, {
+    env: {
+      ...env,
+      FLUO_UPDATE_CHECK_REEXEC: '1'
+    },
+    stderr
+  });
+  return {
+    action: 'reran',
+    exitCode: rerunExitCode
+  };
+}

package/package.json

@@ -9,7 +9,7 @@
     "migration",
     "diagnostics"
   ],
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -44,7 +44,15 @@
     "ejs": "^3.1.10",
     "tsx": "^4.20.4",
     "typescript": "^6.0.2",
-    "@fluojs/runtime": "^1.0.0-beta.1"
+    "@fluojs/runtime": "^1.0.0-beta.9"
+  },
+  "peerDependencies": {
+    "@fluojs/studio": "^1.0.0-beta.3"
+  },
+  "peerDependenciesMeta": {
+    "@fluojs/studio": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/ejs": "^3.1.5",