using System.Collections.Generic;

namespace AutoIngest.Engine
{
    /// <summary>
    /// A source of connected devices. The mass-storage source enumerates drive letters
    /// (SD cards / USB sticks); the MTP source enumerates portable devices (phones). The
    /// import coordinator polls every registered source each tick and imports from any
    /// device that passes the registry filter.
    /// </summary>
    public interface IDeviceSource
    {
        /// <summary>Snapshot of devices currently visible to this source.</summary>
        IEnumerable<DeviceIdentity> GetConnectedDevices();

        /// <summary>Human label for log lines ("SD/USB", "Phone (MTP)").</summary>
        string SourceName { get; }
    }
}
