feat(server): add KML and KMZ place import pipeline

server/tests/unit/services/kmlImportUtils.test.ts

@@ -0,0 +1,78 @@
+import { describe, it, expect } from 'vitest';
+import {
+  buildCategoryNameLookup,
+  decodeUtf8WithWarning,
+  extractKmlPlacemarkNodes,
+  parseKmlPointCoordinates,
+  parsePlacemarkNode,
+  resolveCategoryIdForFolder,
+  sanitizeKmlDescription,
+  stripXmlNamespaces,
+} from '../../../src/services/placeImport/kmlImportUtils';
+
+describe('kmlImportUtils', () => {
+  it('strips KML namespaces and prefixes', () => {
+    const xml = '<kml xmlns="http://www.opengis.net/kml/2.2"><kml:Document><kml:Placemark /></kml:Document></kml>';
+    const stripped = stripXmlNamespaces(xml);
+    expect(stripped).not.toContain('xmlns');
+    expect(stripped).toContain('<Document>');
+    expect(stripped).toContain('<Placemark');
+  });
+
+  it('sanitizes HTML descriptions with br to newline', () => {
+    const input = 'Line 1<br>Line <b>2</b> &amp; more';
+    const output = sanitizeKmlDescription(input);
+    expect(output).toBe('Line 1\nLine 2 & more');
+  });
+
+  it('parses KML coordinate order lng,lat,alt', () => {
+    const parsed = parseKmlPointCoordinates('13.4050,52.5200,15');
+    expect(parsed).toEqual({ lat: 52.52, lng: 13.405 });
+  });
+
+  it('extracts placemarks from nested folders', () => {
+    const root = {
+      Document: {
+        Folder: {
+          name: 'Parent',
+          Folder: {
+            name: 'Child',
+            Placemark: { name: 'Nested', Point: { coordinates: '13.4,52.5,0' } },
+          },
+        },
+      },
+    };
+
+    const nodes = extractKmlPlacemarkNodes(root);
+    expect(nodes).toHaveLength(1);
+    expect(nodes[0].folderName).toBe('Child');
+
+    const parsed = parsePlacemarkNode(nodes[0]);
+    expect(parsed.name).toBe('Nested');
+    expect(parsed.lat).toBe(52.5);
+    expect(parsed.lng).toBe(13.4);
+  });
+
+  it('builds exact case-insensitive category lookup', () => {
+    const lookup = buildCategoryNameLookup([
+      { id: 3, name: 'Museums' },
+      { id: 4, name: 'Parks' },
+    ]);
+
+    expect(resolveCategoryIdForFolder('museums', lookup)).toBe(3);
+    expect(resolveCategoryIdForFolder('Museum', lookup)).toBeNull();
+    expect(resolveCategoryIdForFolder('parks', lookup)).toBe(4);
+  });
+
+  it('returns warning for non-UTF8 payload', () => {
+    const buffer = Buffer.concat([
+      Buffer.from('<?xml version="1.0"?><kml><Document><Placemark><name>Caf'),
+      Buffer.from([0xe9]),
+      Buffer.from('</name></Placemark></Document></kml>'),
+    ]);
+
+    const decoded = decodeUtf8WithWarning(buffer);
+    expect(decoded.warning).toContain('not valid UTF-8');
+    expect(decoded.text).toContain('<kml>');
+  });
+});