RD-1341: Add helper converters (#217)

Author: sasaprodribaba

Sources/MapTilerSDK/Commands/Converters/ConvertGPX.swift

@@ -0,0 +1,29 @@
+//
+// Copyright (c) 2025, MapTiler
+// All rights reserved.
+// SPDX-License-Identifier: BSD 3-Clause
+//
+//  ConvertGPX.swift
+//  MapTilerSDK
+//
+
+import Foundation
+
+package struct ConvertGPX: MTValueCommand {
+    var gpxString: String
+
+    package func toJS() -> JSString {
+        let escaped = gpxString
+            .replacingOccurrences(of: "\\", with: "\\\\")
+            .replacingOccurrences(of: "'", with: "\\'")
+            .replacingOccurrences(of: "\n", with: "\\n")
+            .replacingOccurrences(of: "\r", with: "")
+
+        return """
+        (() => {
+            const res = \(MTBridge.sdkObject).gpx('\(escaped)');
+            return JSON.stringify(res);
+        })();
+        """
+    }
+}

Sources/MapTilerSDK/Commands/Converters/ConvertKML.swift

@@ -0,0 +1,29 @@
+//
+// Copyright (c) 2025, MapTiler
+// All rights reserved.
+// SPDX-License-Identifier: BSD 3-Clause
+//
+//  ConvertKML.swift
+//  MapTilerSDK
+//
+
+import Foundation
+
+package struct ConvertKML: MTValueCommand {
+    var kmlString: String
+
+    package func toJS() -> JSString {
+        let escaped = kmlString
+            .replacingOccurrences(of: "\\", with: "\\\\")
+            .replacingOccurrences(of: "'", with: "\\'")
+            .replacingOccurrences(of: "\n", with: "\\n")
+            .replacingOccurrences(of: "\r", with: "")
+
+        return """
+        (() => {
+            const res = \(MTBridge.sdkObject).kml('\(escaped)');
+            return JSON.stringify(res);
+        })();
+        """
+    }
+}

Sources/MapTilerSDK/Helpers/MTConverters.swift

@@ -0,0 +1,34 @@
+//
+// Copyright (c) 2025, MapTiler
+// All rights reserved.
+// SPDX-License-Identifier: BSD 3-Clause
+//
+//  MTConverters.swift
+//  MapTilerSDK
+//
+
+import Foundation
+
+public extension MTMapView {
+    /// Converts a GPX document string to a GeoJSON FeatureCollection JSON string.
+    /// - Parameter gpxString: Raw GPX XML content.
+    /// - Returns: A GeoJSON FeatureCollection encoded as a JSON string.
+    func convertGPXToGeoJSON(_ gpxString: String) async throws -> String {
+        let result = try await bridge.execute(ConvertGPX(gpxString: gpxString))
+        guard case .string(let json) = result else {
+            throw MTError.unsupportedReturnType(description: "Expected GeoJSON string from GPX conversion.")
+        }
+        return json
+    }
+
+    /// Converts a KML document string to a GeoJSON FeatureCollection JSON string.
+    /// - Parameter kmlString: Raw KML XML content.
+    /// - Returns: A GeoJSON FeatureCollection encoded as a JSON string.
+    func convertKMLToGeoJSON(_ kmlString: String) async throws -> String {
+        let result = try await bridge.execute(ConvertKML(kmlString: kmlString))
+        guard case .string(let json) = result else {
+            throw MTError.unsupportedReturnType(description: "Expected GeoJSON string from KML conversion.")
+        }
+        return json
+    }
+}