git.stella-ops.org/src/Scheduler/StellaOps.Scheduler.WebService/Options/SchedulerOptions.cs

using System;
using System.Collections.Generic;

namespace StellaOps.Scheduler.WebService.Options;

/// <summary>
/// Scheduler host configuration defaults consumed at startup for cross-cutting concerns
/// such as plug-in discovery.
/// </summary>
public sealed class SchedulerOptions
{
    public PluginOptions Plugins { get; set; } = new();

    public void Validate()
    {
        Plugins.Validate();
    }

    public sealed class PluginOptions
    {
        /// <summary>
        /// Base directory resolving relative plug-in paths. Defaults to solution root.
        /// </summary>
        public string? BaseDirectory { get; set; }

        /// <summary>
        /// Directory containing plug-in binaries. Defaults to <c>plugins/scheduler</c>.
        /// </summary>
        public string? Directory { get; set; }

        /// <summary>
        /// Controls whether sub-directories are scanned for plug-ins.
        /// </summary>
        public bool RecursiveSearch { get; set; } = false;

        /// <summary>
        /// Ensures the plug-in directory exists on startup.
        /// </summary>
        public bool EnsureDirectoryExists { get; set; } = true;

        /// <summary>
        /// Explicit plug-in discovery patterns (supports globbing).
        /// </summary>
        public IList<string> SearchPatterns { get; } = new List<string>();

        /// <summary>
        /// Optional ordered plug-in assembly names (without extension).
        /// </summary>
        public IList<string> OrderedPlugins { get; } = new List<string>();

        public void Validate()
        {
            foreach (var pattern in SearchPatterns)
            {
                if (string.IsNullOrWhiteSpace(pattern))
                {
                    throw new InvalidOperationException("Scheduler plug-in search patterns cannot contain null or whitespace entries.");
                }
            }

            foreach (var assemblyName in OrderedPlugins)
            {
                if (string.IsNullOrWhiteSpace(assemblyName))
                {
                    throw new InvalidOperationException("Scheduler ordered plug-in entries cannot contain null or whitespace values.");
                }
            }
        }
    }
}