import { DatasourceName } from "../../datasource-list.generated.js";
import { AdditionalConstraintName, ConstraintName } from "../../util/exec/types.js";
import { Timestamp } from "../../util/timestamp.js";
import { ModuleApi } from "../../types/base.js";
import "../../types/index.js";
import { ConstraintsFilter, CustomDatasourceConfig } from "../../config/types.js";
//#region lib/modules/datasource/types.d.ts
/**
 * The inputs of registry URL resolution, see `resolveRegistryUrls()` in the
 * datasource index.
 */
export interface RegistryUrlsConfig {
  defaultRegistryUrls?: string[];
  registryUrls?: string[] | null;
  additionalRegistryUrls?: string[];
}
/**
 * What a datasource's `getDigest()` receives: a single, already resolved
 * registry.
 */
export interface DigestConfig {
  packageName: string;
  lookupName?: string;
  registryUrl?: string;
  currentValue?: string;
  currentDigest?: string;
}
/**
 * What the datasource index's `getDigest()` receives from the lookup worker.
 */
export interface GetDigestInputConfig extends DigestConfig, RegistryUrlsConfig {
  datasource: string;
  replacementName?: string;
}
/**
 * What a datasource's `getReleases()` receives: a single, already resolved
 * registry.
 */
export interface GetReleasesConfig {
  customDatasources?: Record<string, CustomDatasourceConfig>;
  datasource?: string;
  packageName: string;
  registryUrl?: string;
  currentValue?: string;
  constraints?: Partial<Record<ConstraintName, string>>;
  /**
   * Any specific overrides for the versioning for the `AdditionalConstraintName`s.
   */
  constraintsVersioning?: Partial<Record<AdditionalConstraintName, string>>;
  constraintsFiltering?: ConstraintsFilter;
}
/**
 * What the datasource index's `getPkgReleases()` receives from the lookup
 * worker: the registry URL inputs plus the settings applied to the result.
 */
export interface GetPkgReleasesConfig extends GetReleasesConfig, RegistryUrlsConfig {
  datasource: string;
  npmrc?: string;
  versioning?: string;
  extractVersion?: string;
  versionCompatibility?: string;
  currentCompatibility?: string;
  replacementName?: string;
  replacementVersion?: string;
  registryStrategy?: RegistryStrategy;
}
export interface Release {
  changelogContent?: string;
  changelogUrl?: string;
  checksumUrl?: string;
  downloadUrl?: string;
  gitRef?: string;
  isDeprecated?: boolean;
  isStable?: boolean;
  releaseTimestamp?: Timestamp | null;
  version: string;
  /** The original value to which `extractVersion` was applied */
  versionOrig?: string;
  newDigest?: string | null;
  constraints?: Partial<Record<ConstraintName, string[]>>;
  dependencies?: Record<string, string>;
  devDependencies?: Record<string, string>;
  registryUrl?: string;
  sourceUrl?: string | undefined;
  sourceDirectory?: string;
  currentAge?: string;
  isLatest?: boolean;
  attestation?: boolean;
}
export interface ReleaseTags {
  /** The latest release, according to the datasource **/
  latest?: string;
  [key: string]: string | undefined;
}
export interface ReleaseResult {
  deprecationMessage?: string;
  isPrivate?: boolean;
  releases: Release[];
  tags?: ReleaseTags | undefined;
  changelogContent?: string;
  changelogUrl?: string;
  dependencyUrl?: string;
  homepage?: string | undefined;
  gitRef?: string;
  sourceUrl?: string | null;
  sourceDirectory?: string;
  registryUrl?: string;
  /**
   * The datasource which served the lookup when another one was configured,
   * e.g. `github-tags` for a `go` module hosted on GitHub.
   */
  effectiveDatasource?: DatasourceName;
  replacementName?: string;
  replacementVersion?: string;
  lookupName?: string;
  packageScope?: string;
  mostRecentTimestamp?: Timestamp;
  isAbandoned?: boolean;
  respectLatest?: boolean;
}
/**
 * A single tag as returned by a git hosting provider.
 *
 * `gitRef` is filled in by the `*-tags` datasource base class, which always
 * mirrors the tag name.
 */
export type GitHostTag = Omit<Release, 'gitRef'>;
export interface PostprocessReleaseConfig {
  packageName: string;
  registryUrl: string | null;
}
export type PostprocessReleaseResult = Release | 'reject';
export type RegistryStrategy =
/**
 * Only the first registry URL is queried.
 *
 * If multiple URLs are configured a warning is logged and the rest are ignored. Returns whatever the first registry returns, including `null`.
 *
 * The default.
 */
'first' |
/**
 * Registries are tried in order, returning the first non-null result.
 *
 * `null` results and non-fatal errors (HTTP 401/403/404 and generic errors) are skipped and the next registry is tried.
 * An `ExternalHostError` aborts immediately (unless the cause is `HOST_DISABLED`, which returns `null`).
 *
 * Returns `null` when all registries are exhausted without a result.
 */
'hunt' |
/**
 * All registries are queried.
 *
 * Releases are merged and deduplicated by version; tags are merged with later registries' values taking precedence for duplicate keys.
 *
 * An `ExternalHostError` aborts immediately.
 *
 * Returns `null` when all registries fail.
 */
'merge';
export type SourceUrlSupport = 'package' | 'release' | 'none';
export interface DatasourceApi extends ModuleApi {
  id: string;
  /**
   * `newValue` may be `undefined`, for example when only the digest of the
   * current value is being resolved. Implementations must handle that case
   * explicitly, for example by resolving the digest of a default branch or
   * by returning `null`.
   */
  getDigest?(config: DigestConfig, newValue?: string): Promise<string | null>;
  getReleases(config: GetReleasesConfig): Promise<ReleaseResult | null>;
  /** Return registry URLs for package-specific datasource defaults. */
  getDefaultRegistryUrls(packageName: string): string[] | undefined;
  /** Return whether custom registry URLs are supported for this package. */
  supportsCustomRegistry(packageName: string): boolean;
  defaultVersioning?: string | undefined;
  defaultConfig?: Record<string, unknown> | undefined;
  /**
   * Strategy to use when multiple registryUrls are available to the datasource.
   * Defaults to `first`.
   *
   * @see RegistryStrategy
   */
  registryStrategy: RegistryStrategy;
  /**
   * Whether release timestamp can be returned.
   */
  releaseTimestampSupport: boolean;
  /**
   * Notes on how release timestamp is determined.
   */
  releaseTimestampNote?: string;
  /**
   * Whether sourceURL can be returned.
   */
  sourceUrlSupport: SourceUrlSupport;
  /**
   * Notes on how sourceURL is determined.
   */
  sourceUrlNote?: string;
  /**
   * Whether to perform centralized caching in the datasource index/wrapper or not.
   *
   * - `true`: datasource index wrapper will cache all results (based on registryUrl/packageName)
   *   - **Must be set only if datasource is able to determine and return `isPrivate` flag**
   * - `false`: centralized caching is not performed, implementation still could do caching internally
   */
  caching?: boolean | undefined;
  /**
   * When the candidate for update is formed, this method could be called
   * to fetch additional information such as `releaseTimestamp`.
   *
   * Also, the release could be checked (and potentially rejected)
   * via some datasource-specific external call.
   *
   * In case of reject, the next candidate release is selected,
   * and `postprocessRelease` is called again.
   *
   * Rejection must happen only when the release will lead to downstream error,
   * e.g. the release turned out to be yanked or doesn't exist for some reason.
   *
   * In other cases, the original `Release` parameter should be returned.
   */
  postprocessRelease?(config: PostprocessReleaseConfig, release: Release): Promise<PostprocessReleaseResult>;
}
//#endregion
//# sourceMappingURL=types.d.ts.map