using StellaOps.Cli.Services.Models;

namespace StellaOps.Cli.Services;

public interface IOciRegistryClient
{
    Task<string> ResolveDigestAsync(OciImageReference reference, CancellationToken cancellationToken = default);

    /// <summary>
    /// Resolve a tag to its digest.
    /// </summary>
    Task<string> ResolveTagAsync(
        string registry,
        string repository,
        string tag,
        CancellationToken cancellationToken = default);

    Task<OciReferrersResponse> ListReferrersAsync(
        OciImageReference reference,
        string digest,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Get referrers for an image digest, optionally filtered by artifact type.
    /// Sprint: SPRINT_4300_0001_0001_oci_verdict_attestation_push
    /// </summary>
    Task<IReadOnlyList<OciReferrerDescriptor>> GetReferrersAsync(
        string registry,
        string repository,
        string digest,
        string? artifactType = null,
        CancellationToken cancellationToken = default);

    Task<OciManifest> GetManifestAsync(
        OciImageReference reference,
        string digest,
        CancellationToken cancellationToken = default);

    Task<byte[]> GetBlobAsync(
        OciImageReference reference,
        string digest,
        CancellationToken cancellationToken = default);
}