container/Sources/ContainerClient/Core/ImageDetail.swift

//===----------------------------------------------------------------------===//
// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//   https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//===----------------------------------------------------------------------===//

import Containerization
import ContainerizationOCI

public struct ImageDetail: Codable {
    let name: String
    let index: Descriptor
    let variants: [Variants]

    struct Variants: Codable {
        let platform: Platform
        let config: ContainerizationOCI.Image
        let size: Int64

        init(platform: Platform, size: Int64, config: ContainerizationOCI.Image) {
            self.platform = platform
            self.config = config
            self.size = size
        }
    }

    init(name: String, index: Descriptor, variants: [Variants]) {
        self.name = name
        self.index = index
        self.variants = variants
    }
}

extension ClientImage {
    public func details() async throws -> ImageDetail {
        let indexDescriptor = self.descriptor
        let reference = self.reference
        var variants: [ImageDetail.Variants] = []
        for desc in try await self.index().manifests {
            guard let platform = desc.platform else {
                continue
            }
            let config: ContainerizationOCI.Image
            let manifest: ContainerizationOCI.Manifest
            do {
                config = try await self.config(for: platform)
                manifest = try await self.manifest(for: platform)
            } catch {
                continue
            }
            let size = desc.size + manifest.config.size + manifest.layers.reduce(0, { (l, r) in l + r.size })
            variants.append(.init(platform: platform, size: size, config: config))
        }
        return ImageDetail(name: reference, index: indexDescriptor, variants: variants)
    }
}