feat(infra): add TagMapper with address mapping, value parsing, and quality mapping

infra/lmxfakeproxy/tests/LmxFakeProxy.Tests/TagMappingTests.cs

@@ -0,0 +1,84 @@
+using Xunit;
+
+namespace LmxFakeProxy.Tests;
+
+public class TagMappingTests
+{
+    [Fact]
+    public void ToOpcNodeId_PrependsPrefix()
+    {
+        var mapper = new TagMapper("ns=3;s=");
+        Assert.Equal("ns=3;s=Motor.Speed", mapper.ToOpcNodeId("Motor.Speed"));
+    }
+
+    [Fact]
+    public void ToOpcNodeId_CustomPrefix()
+    {
+        var mapper = new TagMapper("ns=2;s=MyFolder.");
+        Assert.Equal("ns=2;s=MyFolder.Pump.Pressure", mapper.ToOpcNodeId("Pump.Pressure"));
+    }
+
+    [Fact]
+    public void ToOpcNodeId_EmptyPrefix_PassesThrough()
+    {
+        var mapper = new TagMapper("");
+        Assert.Equal("Motor.Speed", mapper.ToOpcNodeId("Motor.Speed"));
+    }
+
+    [Fact]
+    public void ParseWriteValue_Double()
+    {
+        Assert.Equal(42.5, TagMapper.ParseWriteValue("42.5"));
+        Assert.IsType<double>(TagMapper.ParseWriteValue("42.5"));
+    }
+
+    [Fact]
+    public void ParseWriteValue_Bool()
+    {
+        Assert.Equal(true, TagMapper.ParseWriteValue("true"));
+        Assert.Equal(false, TagMapper.ParseWriteValue("False"));
+    }
+
+    [Fact]
+    public void ParseWriteValue_Uint()
+    {
+        // "100" parses as double first (double.TryParse succeeds for integers)
+        var result = TagMapper.ParseWriteValue("100");
+        Assert.IsType<double>(result);
+    }
+
+    [Fact]
+    public void ParseWriteValue_FallsBackToString()
+    {
+        Assert.Equal("hello", TagMapper.ParseWriteValue("hello"));
+        Assert.IsType<string>(TagMapper.ParseWriteValue("hello"));
+    }
+
+    [Fact]
+    public void MapStatusCode_Good()
+    {
+        Assert.Equal("Good", TagMapper.MapQuality(0));
+    }
+
+    [Fact]
+    public void MapStatusCode_Bad()
+    {
+        Assert.Equal("Bad", TagMapper.MapQuality(0x80000000));
+    }
+
+    [Fact]
+    public void MapStatusCode_Uncertain()
+    {
+        Assert.Equal("Uncertain", TagMapper.MapQuality(0x40000000));
+    }
+
+    [Fact]
+    public void ToVtqMessage_ConvertsCorrectly()
+    {
+        var vtq = TagMapper.ToVtqMessage("Motor.Speed", 42.5, DateTime.UtcNow, 0);
+        Assert.Equal("Motor.Speed", vtq.Tag);
+        Assert.Equal("42.5", vtq.Value);
+        Assert.Equal("Good", vtq.Quality);
+        Assert.True(vtq.TimestampUtcTicks > 0);
+    }
+}