Initial commit

srcs/RobotNet10/RobotApp/RobotNet10.RobotApp/SLAM/Cartographer/Helpers/MapPathHelper.cs

@@ -0,0 +1,73 @@
+namespace RobotNet10.RobotApp.SLAM.Cartographer.Helpers;
+
+/// <summary>
+/// Centralizes map directory path construction and legacy file name resolution.
+/// Eliminates duplicated Path.Combine + legacy fallback patterns across CartographerService.
+/// </summary>
+public static class MapPathHelper
+{
+    #region Path Construction
+
+    /// <summary>
+    /// Get the full path to a map directory, sanitizing the map name.
+    /// </summary>
+    public static string GetMapPath(string mapsDirectory, string mapName)
+    {
+        var sanitizedMapName = MapNameHelper.Sanitize(mapName);
+        return Path.Combine(Path.GetFullPath(mapsDirectory), sanitizedMapName);
+    }
+
+    #endregion
+
+    #region File Resolution
+
+    /// <summary>
+    /// Resolve metadata JSON path, trying map.json first then legacy metadata.json.
+    /// Returns null if neither exists.
+    /// </summary>
+    public static string? ResolveMetadataPath(string mapPath)
+    {
+        var metadataPath = Path.Combine(mapPath, "map.json");
+        if (File.Exists(metadataPath))
+            return metadataPath;
+
+        var legacyPath = Path.Combine(mapPath, "metadata.json");
+        if (File.Exists(legacyPath))
+            return legacyPath;
+
+        return null;
+    }
+
+    /// <summary>
+    /// Resolve pbstream path, trying map.pbstream first then any .pbstream file in the directory.
+    /// Returns null if none found.
+    /// </summary>
+    public static string? ResolvePbstreamPath(string mapPath)
+    {
+        var pbstreamPath = Path.Combine(mapPath, "map.pbstream");
+        if (File.Exists(pbstreamPath))
+            return pbstreamPath;
+
+        var pbstreamFiles = Directory.GetFiles(mapPath, "*.pbstream");
+        return pbstreamFiles.Length > 0 ? pbstreamFiles[0] : null;
+    }
+
+    /// <summary>
+    /// Resolve map image path (PNG or JPG).
+    /// Returns null if no image found.
+    /// </summary>
+    public static string? ResolveImagePath(string mapPath)
+    {
+        var pngPath = Path.Combine(mapPath, "map.png");
+        if (File.Exists(pngPath))
+            return pngPath;
+
+        var jpgPath = Path.Combine(mapPath, "map.jpg");
+        if (File.Exists(jpgPath))
+            return jpgPath;
+
+        return null;
+    }
+
+    #endregion
+}