Function checkForUpdate

packages/core/api/src/update-check.ts:267–286

(
  currentVersion: string,
  options?: ResolveDistTagsOptions,
)

 * Best-effort: an unreachable registry yields `updateAvailable: false`.
 */
export const checkForUpdate = async (
  currentVersion: string,
  options?: ResolveDistTagsOptions,
): Promise<UpdateStatus> => {
  const channel = resolveUpdateChannel(currentVersion);
  const command = `npm i -g ${EXECUTOR_PACKAGE_NAME}@${channel}`;

  // No dist-tag can legitimately be compared against this version (unstamped
  // dev build, or a prerelease channel that never gets published) — do not
  // even hit the registry, since the answer is already known.
  const comparisonChannel = resolveComparisonChannel(currentVersion);
  if (comparisonChannel === null) {
    return { updateAvailable: false, currentVersion, latestVersion: null, channel, command };
  }

  const tags = await resolveDistTags(options);
  const latestVersion = tags[comparisonChannel] ?? null;
  const updateAvailable = isUpdateAvailable(currentVersion, latestVersion);
  return { updateAvailable, currentVersion, latestVersion, channel, command };
};