using Microsoft.Extensions.DependencyInjection;

namespace ScadaLink.SiteCallAudit;

/// <summary>
/// Composition root for the Site Call Audit (#22) component.
/// </summary>
/// <remarks>
/// <para>
/// M3 Bundle C ships the ingest-only minimum surface (the actor itself); the
/// full DI surface — reconciliation puller, KPI projector, central→site
/// Retry/Discard relay, options + validators — is deferred to a follow-up.
/// </para>
/// <para>
/// The repository (<c>ISiteCallAuditRepository</c>) is registered by
/// <c>ScadaLink.ConfigurationDatabase.ServiceCollectionExtensions.AddConfigurationDatabase</c>,
/// so callers (the Host on the central node) must also call that. The actor's
/// <c>Props</c> are wired up in Host registration (Bundle F); this extension
/// is currently a no-op placeholder kept for symmetry with the AuditLog and
/// NotificationOutbox composition roots — adding it now means consumers can
/// reference the method without re-touching the Host project later.
/// </para>
/// </remarks>
public static class ServiceCollectionExtensions
{
    /// <summary>
    /// Registers Site Call Audit (#22) services. Currently a no-op
    /// placeholder — Bundle F will populate this with the actor's Props
    /// factory + options bindings. The method is exposed now so the Host
    /// wiring call already exists at the API boundary.
    /// </summary>
    public static IServiceCollection AddSiteCallAudit(this IServiceCollection services)
    {
        ArgumentNullException.ThrowIfNull(services);
        // Actor props are constructed in Host wiring (Bundle F). This
        // extension is a placeholder for future config + DI.
        return services;
    }
}