namespace ClawdDotNet.Core.Storage;

/// <summary>
/// Legt Dateien so an, dass sie unter Unix von Anfang an nur dem Besitzer gehören (#575).
///
/// <para><b>Warum beim Anlegen und nicht hinterher.</b> .NET erzeugt neue Dateien mit
/// <c>0666 &amp; ~umask</c> — auf Ubuntu mit der Maske <c>0002</c> also <c>0664</c>. Ein
/// nachträgliches <see cref="AppPaths.RestrictToOwner"/> lässt ein Fenster offen und
/// wird an jeder neuen Schreibstelle vergessen: <c>InstanceSettings.json</c> ging auf der
/// Test-VM beim ersten Speichern von <c>0600</c> auf <c>0664</c>.</para>
///
/// <para>Unter Windows wirkungslos; dort regelt die Vererbung aus dem Profil die Rechte.</para>
/// </summary>
public static class OwnerOnlyFile
{
    private const UnixFileMode OwnerReadWrite = UnixFileMode.UserRead | UnixFileMode.UserWrite;

    /// <summary>Öffnungsangaben, die eine neu entstehende Datei auf <c>0600</c> setzen.</summary>
    public static FileStreamOptions Options(FileMode mode, FileAccess access, FileShare share)
    {
        var options = new FileStreamOptions { Mode = mode, Access = access, Share = share };

        if (!OperatingSystem.IsWindows())
            options.UnixCreateMode = OwnerReadWrite;

        return options;
    }

    /// <summary>
    /// Öffnet zum Anhängen. Eine vorhandene Datei behält ihre Rechte — nur was hier neu
    /// entsteht, gehört dem Besitzer allein.
    /// </summary>
    public static FileStream OpenAppend(string path)
        => new(path, Options(FileMode.Append, FileAccess.Write, FileShare.Read));
}