using System.Text.Json; using System.Text.Json.Nodes; using Chronos.Core.IO; using Chronos.Core.Localization; using Chronos.Core.Model; using Chronos.Data.Jobs; using Chronos.Protocol; using Chronos.Server.Hosting; using LogRotation = Chronos.Core.Diagnostics.LogRotation; namespace Chronos.Server.Configuration; /// /// The admin panel's view of the configuration (BRIEF ยง14.8 Settings). Saving writes /data/server.json (only the /// edited keys; secrets and environment values are never written) and applies what can change while running, the /// parallelism and the priority queue included (owner review 1), and the log settings through /// (owner review 2, R11); ports, TLS and chunk size wait for a restart. Job history is what the housekeeping system /// schedule is reset to (owner review 2, R10): the schedule's own value applies. The audit retention is what the audit /// clean-up schedule is reset to, and saving a new one also sets that schedule's age limit (the endpoint does it through /// SchedulerHost.ApplyAuditRetentionAsync). /// public sealed class ServerSettingsStore(ServerOptions options, ServerLogging logging) { /// The kinds of job the server runs, in the order the admin panel lists their levels (downloads and uploads are a client's). public static IReadOnlyList Kinds { get; } = [ JobKind.Render, JobKind.Import, JobKind.Scan, JobKind.Rebuild, JobKind.Verify, JobKind.LightAnalyse, JobKind.DeepAnalyse, JobKind.Thumbs, JobKind.Proxies, JobKind.Maintenance, JobKind.Duplicates, JobKind.Orphans, JobKind.Adopt, JobKind.Move, JobKind.Backup, JobKind.Cleanup, ]; private readonly Lock _gate = new(); private ServerSettingsDto? _saved; public ServerSettingsDto Current() { lock (_gate) return _saved ?? Snapshot(options, restartRequired: false); } /// The priority queue as the settings have it now (, ). public static JobPriorityQueue PriorityQueue(ServerOptions options) => JobPriorityQueue.From(options.PriorityQueue, options.JobPriorities); /// Validates and saves; returns the error code and the offending setting, or null on success. public (string Code, string Setting)? Save(ServerSettingsDto request) { // A panel without the log group keeps the log settings as they are. if (request.Logs is null) request = request with { Logs = Current().Logs }; if (Validate(request) is { } invalid) return ("invalid_setting", invalid); lock (_gate) { var current = _saved ?? Snapshot(options, restartRequired: false); var changes = Changes(current, request); if (changes.FirstOrDefault(c => options.Locked.Contains(c.Name)) is { Name: { } locked }) return ("setting_locked", locked); if (changes.Count == 0) return null; var file = File.Exists(options.SettingsFile) ? JsonNode.Parse(File.ReadAllText(options.SettingsFile)) as JsonObject ?? [] : []; foreach (var (name, value) in changes) file[name] = value; // The former name of the parallelism (jobs run at once before owner review 1) would set it again at the next start. if (changes.Any(c => c.Name == nameof(ServerOptions.Parallelism))) file.Remove("Workers"); Directory.CreateDirectory(options.DataPath); AtomicFile.WriteAllText(options.SettingsFile, file.ToJsonString(new JsonSerializerOptions { WriteIndented = true })); options.ServerName = request.ServerName.Trim(); options.Discovery = request.Discovery; options.Language = request.Language; options.MaxUploadBytes = request.MaxUploadBytes; options.TokenLifetimeDays = request.TokenLifetimeDays; options.UploadRetentionHours = request.UploadRetentionHours; options.JobHistoryDays = request.JobHistoryDays; options.Parallelism = request.Parallelism; options.PriorityQueue = request.PriorityQueue; options.JobPriorities = JobPriorityQueue.Changed(Levels(request.JobPriorities)); var logs = request.Logs; options.LogLevel = Level(logs.FileLevel); options.ConsoleLogLevel = Level(logs.ConsoleLevel); options.LogRetentionDays = logs.RetentionDays; options.LogMaxFileMb = logs.MaxFileMb; options.LogMaxTotalMb = logs.MaxTotalMb; options.LogRotation = Rotation(logs.Rotation); options.AuditRetentionDays = logs.AuditRetentionDays; options.DiagnosticsLogMb = logs.DiagnosticsLogMb; logging.Apply(options); var restart = request.HttpPort != options.HttpPort || request.HttpsPort != options.HttpsPort || !string.Equals(request.TlsMode, options.TlsMode.ToString(), StringComparison.OrdinalIgnoreCase) || request.TlsCert != options.TlsCert || request.TlsKey != options.TlsKey || request.ChunkSizeBytes != options.ChunkSizeBytes; _saved = request with { ServerName = request.ServerName.Trim(), JobPriorities = Priorities(PriorityQueue(options)), Logs = Logs(options), Locked = [.. options.Locked], LockedBy = LockedBy(options), RestartRequired = restart, ProxyWarning = false, }; return null; } } private static ServerSettingsDto Snapshot(ServerOptions o, bool restartRequired) => new( o.ServerName, o.HttpPort, o.HttpsPort, o.TlsMode.ToString().ToLowerInvariant(), o.TlsCert, o.TlsKey, o.Language, o.Parallelism, o.PriorityQueue, Priorities(PriorityQueue(o)), o.Discovery, o.MaxUploadBytes, o.ChunkSizeBytes, o.JobHistoryDays, o.TokenLifetimeDays, o.UploadRetentionHours, Logs(o), [.. o.Locked], LockedBy(o), restartRequired, ProxyWarning: false); /// The variable that fixes every locked setting (for one a test locks directly, the variable that would). private static Dictionary LockedBy(ServerOptions o) => o.Locked.Distinct(StringComparer.Ordinal).ToDictionary(s => s, s => o.LockedBy.TryGetValue(s, out var variable) ? variable : ServerOptions.VariableOf(s) ?? s, StringComparer.Ordinal); private static LogSettingsDto Logs(ServerOptions o) => new(ServerLogging.Wire(o.LogLevel), ServerLogging.Wire(o.ConsoleLogLevel), o.LogRetentionDays, o.LogMaxFileMb, o.LogMaxTotalMb, ServerLogging.Wire(o.LogRotation), o.AuditRetentionDays, o.DiagnosticsLogMb); /// A level has checked. private static LogLevel Level(string wire) => ServerLogging.TryParseLevel(wire, out var level) ? level : LogLevel.Information; /// A rotation has checked. private static LogRotation Rotation(string wire) => ServerLogging.TryParseRotation(wire, out var rotation) ? rotation : LogRotation.Daily; /// The level of every kind the server runs in . private static List Priorities(JobPriorityQueue queue) => [.. Kinds.Select(k => new JobPriorityDto(JobWire.Kind(k), JobPriorityQueue.Wire(queue.LevelOf(k))))]; /// The levels a request sets; has checked their names. private static Dictionary Levels(IReadOnlyList? priorities) { var levels = new Dictionary(); foreach (var p in priorities ?? []) { if (JobWire.TryParseKind(p.Kind, out var kind) && JobPriorityQueue.TryParse(p.Level, out var level)) levels[kind] = level; } return levels; } private static string? Validate(ServerSettingsDto r) { if (string.IsNullOrWhiteSpace(r.ServerName) || r.ServerName.Trim().Length > 60) return nameof(ServerOptions.ServerName); if (r.HttpPort is < 1 or > 65535) return nameof(ServerOptions.HttpPort); if (r.HttpsPort is < 1 or > 65535 || r.HttpsPort == r.HttpPort) return nameof(ServerOptions.HttpsPort); if (!Enum.TryParse(r.TlsMode, ignoreCase: true, out var tls) || !Enum.IsDefined(tls)) return nameof(ServerOptions.TlsMode); if (tls == TlsMode.Pem && (string.IsNullOrWhiteSpace(r.TlsCert) || !File.Exists(r.TlsCert))) return nameof(ServerOptions.TlsCert); if (tls == TlsMode.Pem && (string.IsNullOrWhiteSpace(r.TlsKey) || !File.Exists(r.TlsKey))) return nameof(ServerOptions.TlsKey); if (!Languages.Shipped.Contains(r.Language, StringComparer.OrdinalIgnoreCase)) return nameof(ServerOptions.Language); if (r.Parallelism is < 1 or > ServerOptions.MaxParallelism) return nameof(ServerOptions.Parallelism); if ((r.JobPriorities ?? []).Any(p => !JobWire.TryParseKind(p.Kind, out var kind) || !Kinds.Contains(kind) || !JobPriorityQueue.TryParse(p.Level, out _))) return nameof(ServerOptions.JobPriorities); if (r.MaxUploadBytes < 1024 * 1024) return nameof(ServerOptions.MaxUploadBytes); if (r.ChunkSizeBytes is < 64 * 1024 or > 64 * 1024 * 1024) return nameof(ServerOptions.ChunkSizeBytes); if (r.JobHistoryDays is < 1 or > 3650) return nameof(ServerOptions.JobHistoryDays); if (r.TokenLifetimeDays is < 1 or > 365) return nameof(ServerOptions.TokenLifetimeDays); if (r.UploadRetentionHours is < 1 or > 8760) return nameof(ServerOptions.UploadRetentionHours); var logs = r.Logs; if (!ServerLogging.TryParseLevel(logs.FileLevel, out _)) return nameof(ServerOptions.LogLevel); if (!ServerLogging.TryParseLevel(logs.ConsoleLevel, out _)) return nameof(ServerOptions.ConsoleLogLevel); if (!ServerLogging.TryParseRotation(logs.Rotation, out _)) return nameof(ServerOptions.LogRotation); return ServerLogging.Problem(logs.RetentionDays, logs.MaxFileMb, logs.MaxTotalMb, logs.AuditRetentionDays, logs.DiagnosticsLogMb); } /// Settings whose value differs, as server.json keys and JSON values. private static List<(string Name, JsonNode? Value)> Changes(ServerSettingsDto a, ServerSettingsDto b) { var changes = new List<(string, JsonNode?)>(); void Add(string name, T before, T after, Func json) { if (!EqualityComparer.Default.Equals(before, after)) changes.Add((name, json(after))); } Add(nameof(ServerOptions.ServerName), a.ServerName, b.ServerName.Trim(), v => JsonValue.Create(v)); Add(nameof(ServerOptions.HttpPort), a.HttpPort, b.HttpPort, v => JsonValue.Create(v)); Add(nameof(ServerOptions.HttpsPort), a.HttpsPort, b.HttpsPort, v => JsonValue.Create(v)); Add(nameof(ServerOptions.TlsMode), a.TlsMode.ToLowerInvariant(), b.TlsMode.ToLowerInvariant(), v => JsonValue.Create(v)); Add(nameof(ServerOptions.TlsCert), a.TlsCert, b.TlsCert, v => v is null ? null : JsonValue.Create(v)); Add(nameof(ServerOptions.TlsKey), a.TlsKey, b.TlsKey, v => v is null ? null : JsonValue.Create(v)); Add(nameof(ServerOptions.Language), a.Language, b.Language, v => JsonValue.Create(v)); Add(nameof(ServerOptions.Parallelism), a.Parallelism, b.Parallelism, v => JsonValue.Create(v)); Add(nameof(ServerOptions.PriorityQueue), a.PriorityQueue, b.PriorityQueue, v => JsonValue.Create(v)); // Only levels that differ from the defaults are stored, as the desktop does. var before = JobPriorityQueue.Changed(Levels(a.JobPriorities)); var after = JobPriorityQueue.Changed(Levels(b.JobPriorities)); if (!before.OrderBy(l => l.Key).SequenceEqual(after.OrderBy(l => l.Key))) changes.Add((nameof(ServerOptions.JobPriorities), new JsonObject(after.Select(l => KeyValuePair.Create(l.Key, (JsonNode?)JsonValue.Create(l.Value)))))); Add(nameof(ServerOptions.Discovery), a.Discovery, b.Discovery, v => JsonValue.Create(v)); Add(nameof(ServerOptions.MaxUploadBytes), a.MaxUploadBytes, b.MaxUploadBytes, v => JsonValue.Create(v)); Add(nameof(ServerOptions.ChunkSizeBytes), a.ChunkSizeBytes, b.ChunkSizeBytes, v => JsonValue.Create(v)); Add(nameof(ServerOptions.JobHistoryDays), a.JobHistoryDays, b.JobHistoryDays, v => JsonValue.Create(v)); Add(nameof(ServerOptions.TokenLifetimeDays), a.TokenLifetimeDays, b.TokenLifetimeDays, v => JsonValue.Create(v)); Add(nameof(ServerOptions.UploadRetentionHours), a.UploadRetentionHours, b.UploadRetentionHours, v => JsonValue.Create(v)); // Levels and the rotation are stored by name, as server.json reads them ("Debug", "Hourly"). Add(nameof(ServerOptions.LogLevel), Level(a.Logs.FileLevel), Level(b.Logs.FileLevel), v => JsonValue.Create(v.ToString())); Add(nameof(ServerOptions.ConsoleLogLevel), Level(a.Logs.ConsoleLevel), Level(b.Logs.ConsoleLevel), v => JsonValue.Create(v.ToString())); Add(nameof(ServerOptions.LogRetentionDays), a.Logs.RetentionDays, b.Logs.RetentionDays, v => JsonValue.Create(v)); Add(nameof(ServerOptions.LogMaxFileMb), a.Logs.MaxFileMb, b.Logs.MaxFileMb, v => JsonValue.Create(v)); Add(nameof(ServerOptions.LogMaxTotalMb), a.Logs.MaxTotalMb, b.Logs.MaxTotalMb, v => JsonValue.Create(v)); Add(nameof(ServerOptions.LogRotation), Rotation(a.Logs.Rotation), Rotation(b.Logs.Rotation), v => JsonValue.Create(v.ToString())); Add(nameof(ServerOptions.AuditRetentionDays), a.Logs.AuditRetentionDays, b.Logs.AuditRetentionDays, v => JsonValue.Create(v)); Add(nameof(ServerOptions.DiagnosticsLogMb), a.Logs.DiagnosticsLogMb, b.Logs.DiagnosticsLogMb, v => JsonValue.Create(v)); return changes; } }