sailfork / t3code-github / .repos/ alchemy-effect/ packages/ docker/ src/ Registry.ts

import type * as Redacted from "effect/Redacted";

export interface ImageRegistry {
  /** Registry host, e.g. `ghcr.io`. */
  server: string;
  /** Registry username. */
  username: string;
  /** Registry password. Use `Redacted.make(...)` or `Config.Redacted(...)`. */
  password: Redacted.Redacted<string>;
}

/** Strips the tag and digest from an image reference, leaving the repository. */
export const repositoryFromImageRef = (imageRef: string): string => {
  const withoutDigest = imageRef.includes("@")
    ? imageRef.slice(0, imageRef.indexOf("@"))
    : imageRef;
  const tagSeparator = withoutDigest.lastIndexOf(":");
  const pathSeparator = withoutDigest.lastIndexOf("/");
  return tagSeparator > pathSeparator ? withoutDigest.slice(0, tagSeparator) : withoutDigest;
};

/**
 * Prefixes an image reference with the registry host unless the reference
 * already carries a registry prefix (a dotted host, a host:port, or `localhost`).
 */
export const withRegistryHost = (imageRef: string, registry: { server: string }): string => {
  const registryHost = registry.server.replace(/\/$/, "");
  const firstSegment = imageRef.split("/")[0];
  const hasRegistryPrefix =
    imageRef.includes("/") &&
    (firstSegment.includes(".") || firstSegment.includes(":") || firstSegment === "localhost");
  return hasRegistryPrefix ? imageRef : `${registryHost}/${imageRef}`;
};

/** Extracts the `repository@sha256:...` digest from `docker push` output. */
export const parseRepoDigest = (imageRef: string, output: string): string | undefined => {
  const match = /digest:\s+([a-z0-9]+:[a-f0-9]{64})/i.exec(output);
  if (!match) return undefined;
  return `${repositoryFromImageRef(imageRef)}@${match[1]}`;
};

/**
 * Picks the `repository@digest` that inspect reports for this image.
 *
 * A fallback when push output has no `digest:` line. Podman pushes report the
 * published digest through `--digestfile` instead, because Podman can list a
 * pulled image's source digest under the pushed name here.
 */
export const repoDigestFromInspect = (
  imageRef: string,
  repoDigests: ReadonlyArray<string> | null | undefined,
): string | undefined => {
  const repository = repositoryFromImageRef(imageRef);
  for (const digest of repoDigests ?? []) {
    const at = digest.lastIndexOf("@");
    if (at > 0 && digest.slice(0, at) === repository) return digest;
  }
  return undefined;
};

/**
 * Digest from push output when the engine prints one, otherwise the matching
 * `RepoDigests` entry. `registryRef` is the host-qualified name when it
 * differs from the local reference that was pushed.
 */
export const publishedRepoDigest = (
  imageRef: string,
  output: { stdout: string; stderr: string },
  repoDigests: ReadonlyArray<string> | null | undefined,
  registryRef?: string,
): string | undefined => {
  const text = `${output.stdout}\n${output.stderr}`;
  return (
    parseRepoDigest(imageRef, text) ??
    (registryRef === undefined ? undefined : repoDigestFromInspect(registryRef, repoDigests)) ??
    repoDigestFromInspect(imageRef, repoDigests)
  );
};

/**
 * Parses an image's RFC 3339 `Created` timestamp into epoch milliseconds.
 *
 * Docker only reports `Created` when the image config carries a creation time:
 * API >= 1.44 omits it, older APIs backfill the year-1 zero value
 * (`0001-01-01T00:00:00Z`), and 25.0.0–25.0.3 returned an empty string. In any
 * of those cases there is no real build time, so we fall back to the wall clock.
 */
export const parseCreatedAt = (created: string | undefined): number => {
  const parsed = created ? Date.parse(created) : Number.NaN;
  return Number.isNaN(parsed) || parsed <= 0 ? Date.now() : parsed;
};