namespace ClawdDotNet.Licensing;

/// <summary>
/// Wo der Lizenzschlüssel liegt — und wo die Adresse steht, gegen die geprüft wird.
///
/// <para><b>Eine Schnittstelle, weil es zwei Ablagen gibt</b> (#528, E-M3). Die Anwendung
/// führt den Schlüssel in <c>Settings.json</c>, der Instanzmanager in
/// <c>manager.json</c>. Der Torwächter selbst soll von beidem nichts wissen: Er prüft
/// Schlüssel, er verwaltet keine Dateien.</para>
///
/// <para>Nach E-M3 gehört die Lizenz auf Dauer dem Manager — eine Lizenz gilt der
/// Installation und erlaubt beliebig viele Instanzen. Bis eine Instanz feststellen kann,
/// ob ein Manager da ist, führen beide ihren eigenen Schlüssel; sonst entstünde
/// zwischendurch eine Fassung ganz ohne Durchsetzung.</para>
/// </summary>
public interface ILicenseStore
{
    /// <summary>Die Adresse des Deploymentcenters. Leer heißt: Vorgabe aus <see cref="LicenseInfo"/>.</summary>
    string ServerUrl { get; }

    /// <summary>Der hinterlegte Schlüssel. Der Torwächter schreibt ihn zurück, wenn ein neuer eingegeben wurde.</summary>
    string LicenseKey { get; set; }

    /// <summary>
    /// Schreibt den Schlüssel fest.
    ///
    /// <para>Darf werfen — der Aufrufer behandelt das als „gilt, ließ sich aber nicht
    /// sichern" und läuft weiter.</para>
    /// </summary>
    void Save();
}