feat(data): storage-mode settings and remote nest repository

NestStorageSettings persists the file/database toggle and server URL at %APPDATA%\OpenNest\storage.json following the EngineSelectionSettings never-throwing pattern; missing config means File mode. NestRecord carries the shareable job metadata, INestRepository defines the backend contract, and RemoteNestRepository implements it against the nest server with multipart uploads (metadata JSON part + .nest file part).
2026-09-29 16:21:17 -04:00
parent ef2f9aa714
commit 10ed3d3a30
5 changed files with 538 additions and 0 deletions
@@ -0,0 +1,83 @@
+using System.Text.Json;
+
+namespace OpenNest.Data;
+
+/// <summary>Where the desktop app persists nests: local .nest files or the shared nest server.</summary>
+public enum NestStorageMode
+{
+    File,
+    Database,
+}
+
+/// <summary>
+/// Storage-mode toggle and nest-server address, stored at %APPDATA%\OpenNest\storage.json.
+/// Loading never throws; a missing or corrupt file means File mode so existing installs
+/// keep the original behavior until the operator opts in.
+/// </summary>
+public sealed class NestStorageSettings
+{
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        WriteIndented = true,
+        PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+        PropertyNameCaseInsensitive = true,
+    };
+
+    public NestStorageMode Mode { get; set; } = NestStorageMode.File;
+
+    /// <summary>Base URL of the nest server, e.g. http://barge.lan:8090. No trailing slash required.</summary>
+    public string ServerUrl { get; set; } = "";
+
+    /// <summary>True when Database mode is active and a server URL is configured.</summary>
+    public bool IsDatabaseMode =>
+        Mode == NestStorageMode.Database && !string.IsNullOrWhiteSpace(ServerUrl);
+
+    /// <summary>%APPDATA%\OpenNest\storage.json.</summary>
+    public static string DefaultPath => Path.Combine(
+        Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
+        "OpenNest", "storage.json");
+
+    public static NestStorageSettings Load(string path)
+    {
+        if (string.IsNullOrWhiteSpace(path) || !File.Exists(path))
+            return new();
+
+        try
+        {
+            var settings = JsonSerializer.Deserialize<NestStorageSettings>(
+                File.ReadAllText(path), JsonOptions) ?? new();
+            settings.ServerUrl = NormalizeUrl(settings.ServerUrl);
+            return settings;
+        }
+        catch (Exception ex) when (ex is JsonException or IOException or UnauthorizedAccessException)
+        {
+            return new();
+        }
+    }
+
+    /// <summary>Writes camelCase JSON, creating the parent directory and retrying IO collisions.</summary>
+    public void Save(string path)
+    {
+        var json = JsonSerializer.Serialize(
+            new NestStorageSettings { Mode = Mode, ServerUrl = NormalizeUrl(ServerUrl) },
+            JsonOptions);
+        var directory = Path.GetDirectoryName(Path.GetFullPath(path));
+
+        for (var attempt = 0; attempt < 3; attempt++)
+        {
+            try
+            {
+                if (!string.IsNullOrEmpty(directory))
+                    Directory.CreateDirectory(directory);
+                File.WriteAllText(path, json);
+                return;
+            }
+            catch (IOException) when (attempt < 2)
+            {
+                Thread.Sleep(100);
+            }
+        }
+    }
+
+    private static string NormalizeUrl(string? url) => (url ?? "").Trim().TrimEnd('/');
+}