Function checkForUpdateNotice

packages/foam-cli/src/support/version.ts:71–109

()

}

export function checkForUpdateNotice(): string | null {
  const cache = State.readUpdateCheck();

  const shouldFetch =
    !cache || Date.now() - new Date(cache.lastChecked).getTime() > CHECK_INTERVAL_MS;

  if (shouldFetch) {
    // Fire-and-forget background refresh — never awaited
    fetchLatestVersion({ unref: true })
      .then(latestVersion => {
        State.writeUpdateCheck({
          ...cache,
          lastChecked: new Date().toISOString(),
          latestVersion,
        });
      })
      .catch(() => {
        // non-critical
      });
  }

  if (!cache || !isNewerVersion(cache.latestVersion, getCurrentVersion())) {
    return null;
  }

  // Rate-limit: show the notice at most once per NOTIFY_INTERVAL_MS, regardless
  // of how often the user invokes the CLI.
  const lastNotifiedMs = cache.lastNotified ? new Date(cache.lastNotified).getTime() : 0;
  if (Date.now() - lastNotifiedMs < NOTIFY_INTERVAL_MS) {
    return null;
  }

  State.writeUpdateCheck({
    ...cache,
    lastNotified: new Date().toISOString(),
  });

  return formatUpdateNotice(cache.latestVersion);
}