mas/MasKit/AppLibrary.swift

//
//  AppLibrary.swift
//  MasKit
//
//  Created by Ben Chatelain on 12/27/18.
//  Copyright © 2018 mas-cli. All rights reserved.
//

/// Utility for managing installed apps.
public protocol AppLibrary {
    /// Entire set of installed apps.
    var installedApps: [SoftwareProduct] { get }

    /// Map of app name to ID.
    var appIdsByName: [String: UInt64] { get }

    /// Finds an app by ID.
    ///
    /// - Parameter forId: MAS ID for app.
    /// - Returns: Software Product of app if found; nil otherwise.
    func installedApp(forId: UInt64) -> SoftwareProduct?

    /// Finds an app by it's bundle identifier.
    ///
    /// - Parameter forBundleId: Bundle identifier of app.
    /// - Returns: Software Product of app if found; nil otherwise.
    func installedApp(forBundleId: String) -> SoftwareProduct?

    /// Finds an app by name.
    ///
    /// - Parameter named: Name of app.
    /// - Returns: Software Product of app if found; nil otherwise.
    func installedApp(named: String) -> SoftwareProduct?

    /// Uninstalls an app.
    ///
    /// - Parameter app: App to be removed.
    /// - Throws: Error if there is a problem.
    func uninstallApp(app: SoftwareProduct) throws
}

/// Common logic
extension AppLibrary {
    /// Map of app name to ID.
    public var appIdsByName: [String: UInt64] {
        get {
            var destMap = [String: UInt64]()
            for product in installedApps {
                destMap[product.appName] = product.itemIdentifier.uint64Value
            }
            return destMap
        }
    }

    /// Finds an app by name.
    ///
    /// - Parameter id: MAS ID for app.
    /// - Returns: Software Product of app if found; nil otherwise.
    public func installedApp(forId id: UInt64) -> SoftwareProduct? {
        let appId = NSNumber(value: id)
        return installedApps.first { $0.itemIdentifier == appId }
    }

    /// Finds an app by name.
    ///
    /// - Parameter appName: Full title of an app.
    /// - Returns: Software Product of app if found; nil otherwise.
    public func installedApp(named appName: String) -> SoftwareProduct? {
        return installedApps.first { $0.appName == appName }
    }
}