ClawdDotNet/src/ClawdDotNet.Core/Backup/BackupModels.cs

using System.Text.Json.Serialization;

namespace ClawdDotNet.Core.Backup;

/// <summary>Wie mit Zugangsdaten in der Sicherung verfahren wird.</summary>
public enum SecretMode
{
    /// <summary>
    /// Zugangsdaten werden entfernt. Die Sicherung ist gefahrlos ablegbar, die
    /// Wiederherstellung aber unvollständig — Schlüssel und Passwörter müssen
    /// danach neu eingetragen werden.
    /// </summary>
    Exclude,

    /// <summary>
    /// Zugangsdaten werden mit einer Passphrase geschützt. Nur so überstehen sie
    /// einen Rechner- oder Benutzerwechsel.
    /// </summary>
    Passphrase,

    /// <summary>
    /// Die ganze Sicherung wird mit dem Lizenzschlüssel verschlüsselt
    /// (<see cref="LicenseBackupCipher"/>), die Zugangsdaten reisen mit.
    ///
    /// <para>Der Weg, den der Instanzmanager nimmt. Er übersteht einen Maschinenwechsel,
    /// ohne dass eine Passphrase gespeichert oder eingetippt werden müsste — der
    /// Lizenzschlüssel ist ohnehin da. Deshalb darf auch die tägliche Sicherung jetzt
    /// Zugangsdaten enthalten.</para>
    /// </summary>
    License
}

public sealed record BackupOptions
{
    public SecretMode Secrets { get; init; } = SecretMode.Exclude;

    /// <summary>Erforderlich bei <see cref="SecretMode.Passphrase"/>.</summary>
    public string? Passphrase { get; init; }

    /// <summary>Erforderlich bei <see cref="SecretMode.License"/>.</summary>
    public string? LicenseKey { get; init; }

    /// <summary>Protokolle sind groß und selten nötig.</summary>
    public bool IncludeLogs { get; init; }

    /// <summary>Chatverläufe gehören zum Arbeitsstand, können aber umfangreich sein.</summary>
    public bool IncludeChatHistory { get; init; } = true;
}

public sealed record RestoreOptions
{
    public string? Passphrase { get; init; }

    /// <summary>
    /// Für verschlüsselte Sicherungen: der Lizenzschlüssel der Installation, von der sie
    /// stammt. Passt er nicht, kommt <see cref="BackupKeyMismatchException"/>.
    /// </summary>
    public string? LicenseKey { get; init; }

    /// <summary>Nur prüfen und berichten, nichts schreiben.</summary>
    public bool DryRun { get; init; }

    /// <summary>Vorhandene Dateien im Ziel überschreiben.</summary>
    public bool Overwrite { get; init; }
}

public sealed record BackupEntry(
    [property: JsonPropertyName("path")] string Path,
    [property: JsonPropertyName("size")] long Size,
    [property: JsonPropertyName("sha256")] string Sha256);

public sealed record BackupManifest
{
    /// <summary>Erlaubt es späteren Fassungen, ältere Sicherungen zu erkennen.</summary>
    [JsonPropertyName("formatVersion")]
    public int FormatVersion { get; init; } = 1;

    [JsonPropertyName("createdAt")]
    public DateTime CreatedAt { get; init; }

    [JsonPropertyName("instanceId")]
    public string InstanceId { get; init; } = "";

    [JsonPropertyName("instanceName")]
    public string InstanceName { get; init; } = "";

    [JsonPropertyName("secrets")]
    public string Secrets { get; init; } = nameof(SecretMode.Exclude);

    /// <summary>Wie viele Zugangsdaten enthalten bzw. entfernt wurden.</summary>
    [JsonPropertyName("secretCount")]
    public int SecretCount { get; init; }

    [JsonPropertyName("files")]
    public List<BackupEntry> Files { get; init; } = new();

    /// <summary>
    /// Enthält die Sicherung Zugangsdaten, die beim Zurückspielen auf den Schlüssel der
    /// Zielmaschine umgeschlüsselt werden müssen?
    /// </summary>
    [JsonIgnore]
    public bool HasSecrets => Secrets is nameof(SecretMode.Passphrase) or nameof(SecretMode.License);
}

public sealed record BackupResult(string ZipPath, BackupManifest Manifest, long SizeBytes);

public sealed record RestoreResult(
    IReadOnlyList<string> Written,
    IReadOnlyList<string> Skipped,
    IReadOnlyList<string> WouldOverwrite)
{
    public bool HasConflicts => WouldOverwrite.Count > 0;
}

/// <summary>Nicht versiegelt: <see cref="BackupKeyMismatchException"/> ist ein Sonderfall davon.</summary>
public class BackupException(string message, Exception? inner = null)
    : Exception(message, inner);