renovate/lib/modules/manager/util.ts

import { isNonEmptyString } from '@sindresorhus/is';
import type { MaybePromise } from '../../types/index.ts';
import { detectPlatform } from '../../util/common.ts';
import type { ExecError } from '../../util/exec/exec-error.ts';
import type { ConstraintName } from '../../util/exec/types.ts';
import { parseGitUrl } from '../../util/git/url.ts';
import { GitRefsDatasource } from '../datasource/git-refs/index.ts';
import { GitTagsDatasource } from '../datasource/git-tags/index.ts';
import { GithubTagsDatasource } from '../datasource/github-tags/index.ts';
import { GitlabTagsDatasource } from '../datasource/gitlab-tags/index.ts';
import type { PackageDependency, ToolConstraintsConfig } from './types.ts';

export function applyGitSource(
  dep: PackageDependency,
  git: string,
  rev: string | undefined,
  tag: string | undefined,
  branch: string | undefined,
): void {
  if (tag) {
    const platform = detectPlatform(git);
    if (platform === 'github' || platform === 'gitlab') {
      dep.datasource =
        platform === 'github'
          ? GithubTagsDatasource.id
          : GitlabTagsDatasource.id;
      const { host, full_name } = parseGitUrl(git);

      // Always use HTTPS for GitHub/GitLab API endpoints, even if the git URL protocol is SSH.
      dep.registryUrls = [`https://${host}`];
      dep.packageName = full_name;
    } else {
      dep.datasource = GitTagsDatasource.id;
      dep.packageName = git;
    }
    dep.currentValue = tag;
    dep.skipReason = undefined;
  } else if (rev) {
    dep.datasource = GitRefsDatasource.id;
    dep.packageName = git;
    dep.currentDigest = rev;
    dep.replaceString = rev;
    dep.skipReason = undefined;
  } else {
    dep.datasource = GitRefsDatasource.id;
    dep.packageName = git;
    dep.currentValue = branch;
    dep.skipReason = branch ? 'git-dependency' : 'unspecified-version';
  }
}

/**
 * Given an {@link ExecError}, retrieve the message which will be used for an {@link ArtifactError}.
 *
 * An `ExecError` always carries a `stderr` property, so nullish coalescing would keep an empty string and render an artifact error with no message at all.
 *
 */
export function artifactErrorMessageFromExecError(
  err: Partial<ExecError>,
  message: string,
): string {
  if (err.stderr?.trim()) {
    return err.stderr;
  }

  if (err.stdout?.trim()) {
    return err.stdout;
  }

  return message;
}

/**
 * Resolve the constraint for a tool that `updateArtifacts()` has to run.
 *
 * The precedence is:
 *
 * 1. `constraints`, because the user asked for it explicitly
 * 2. `derive`, because it reads the package files as the branch changed them,
 *    so it can be newer than what extraction saw
 * 3. `extractedConstraints`, as collected while extracting the base branch
 *
 * Managers that have no way to derive the constraint at artifact time can omit
 * `derive`. An empty string counts as "not set" at every step, so it never
 * shadows a value further down the list.
 *
 * This is the only place that reads `constraints` and `extractedConstraints`
 * from the config; the `renovate/prefer-resolve-tool-constraint` lint rule
 * keeps managers from reading them directly.
 */
export async function resolveToolConstraint(
  config: ToolConstraintsConfig,
  toolName: ConstraintName,
  derive?: () => MaybePromise<string | null | undefined>,
): Promise<string | undefined> {
  const configured = config.constraints?.[toolName];
  if (isNonEmptyString(configured)) {
    return configured;
  }
  const derived = await derive?.();
  if (isNonEmptyString(derived)) {
    return derived;
  }
  const extracted = config.extractedConstraints?.[toolName];
  return isNonEmptyString(extracted) ? extracted : undefined;
}