Function checkForUpdates

packages/cli/src/utils/update-check.ts:218–259

(
  options: CheckForUpdatesOptions = {}
)

}

export async function checkForUpdates(
  options: CheckForUpdatesOptions = {}
): Promise<UpdateInfo | null> {
  const now = options.now ?? Date.now();
  const cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
  const stateFile = options.stateFile;
  const state = await readUpdateState(stateFile);
  const isStale =
    options.force ||
    !state.lastCheckedAt ||
    now - state.lastCheckedAt >= cacheTtlMs ||
    !state.latestVersion;

  let latestVersion = state.latestVersion ?? null;

  if (isStale) {
    const fetchedVersion = await fetchLatestVersion();
    if (fetchedVersion) {
      latestVersion = fetchedVersion;
      await writeUpdateState(
        {
          ...state,
          latestVersion: fetchedVersion,
          lastCheckedAt: now,
        },
        stateFile
      );
    }
  }

  if (!latestVersion) return null;

  const installMethod = detectInstallMethod();

  return {
    currentVersion: VERSION,
    latestVersion,
    updateAvailable: compareVersions(latestVersion, VERSION) > 0,
    installMethod,
    upgradePlan: getUpgradePlan(installMethod),
  };
}

export async function shouldShowUpdateNotification(
  info: UpdateInfo,